Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { describe, expect, test } from 'vitest';
import {
focalYToObjectPosition,
parseFocalY,
pickCoverKey,
resolvePageCover,
resolvePageIcon,
} from './page-header-utils';
describe('resolvePageIcon', () => {
test('classifies a single emoji as emoji', () => {
expect(resolvePageIcon('📝')).toEqual({ kind: 'emoji', value: '📝' });
});
test('classifies a multi-codepoint emoji (skin tone) as emoji', () => {
expect(resolvePageIcon('👨💻').kind).toBe('emoji');
});
test('classifies a flag emoji (regional indicator pair) as emoji', () => {
expect(resolvePageIcon('🇺🇸').kind).toBe('emoji');
});
test('rejects emoji with ASCII letters mixed in', () => {
expect(resolvePageIcon('hi 📝')).toEqual({ kind: 'unsupported', value: '' });
});
test('rejects empty / whitespace-only input', () => {
expect(resolvePageIcon('').kind).toBe('unsupported');
expect(resolvePageIcon(' ').kind).toBe('unsupported');
});
test('rejects non-string input', () => {
expect(resolvePageIcon(null).kind).toBe('unsupported');
expect(resolvePageIcon(undefined).kind).toBe('unsupported');
expect(resolvePageIcon(42).kind).toBe('unsupported');
expect(resolvePageIcon({}).kind).toBe('unsupported');
});
test('rejects inputs over the length cap', () => {
expect(resolvePageIcon('a'.repeat(3000)).kind).toBe('unsupported');
});
test('classifies an https image URL as url', () => {
expect(resolvePageIcon('https://example.com/logo.png')).toEqual({
kind: 'url',
value: 'https://example.com/logo.png',
});
});
test('classifies an http image URL as url (still safe scheme)', () => {
expect(resolvePageIcon('http://example.com/logo.png').kind).toBe('url');
});
test('classifies a relative path with an image extension as path', () => {
const r = resolvePageIcon('assets/logo.png');
expect(r.kind).toBe('path');
expect(r.value).toContain('/api/asset?path=');
expect(r.value).toContain(encodeURIComponent('assets/logo.png'));
});
test('rejects javascript: URL (unsafe scheme)', () => {
expect(resolvePageIcon('javascript:alert(1).png').kind).toBe('unsupported');
});
test('rejects data: URL (not in safe-scheme allowlist)', () => {
expect(resolvePageIcon('data:image/png;base64,iVBORw0…').kind).toBe('unsupported');
});
test('rejects path traversal (leading ../)', () => {
expect(resolvePageIcon('../secrets/logo.png').kind).toBe('unsupported');
});
test('rejects path with embedded /..', () => {
expect(resolvePageIcon('assets/../secrets/logo.png').kind).toBe('unsupported');
});
test('rejects a path with non-image extension', () => {
expect(resolvePageIcon('docs/note.md').kind).toBe('unsupported');
expect(resolvePageIcon('archive.zip').kind).toBe('unsupported');
});
test('rejects a URL with non-image extension', () => {
expect(resolvePageIcon('https://example.com/doc.pdf').kind).toBe('unsupported');
});
test('strips query / hash from URL extension check (URL branch only)', () => {
expect(resolvePageIcon('https://example.com/image.png?v=2').kind).toBe('url');
expect(resolvePageIcon('https://example.com/image.png#anchor').kind).toBe('url');
});
test('rejects query / hash on the path branch (would 415 server-side)', () => {
expect(resolvePageIcon('assets/image.png?v=2').kind).toBe('unsupported');
expect(resolvePageIcon('assets/image.png#anchor').kind).toBe('unsupported');
});
test('tolerates a single leading slash (upload-pipeline shape)', () => {
const r = resolvePageIcon('/attachments/banner.png');
expect(r.kind).toBe('path');
expect(r.value).toContain('/api/asset?path=');
expect(r.value).toContain(encodeURIComponent('attachments/banner.png'));
expect(r.value).not.toContain(encodeURIComponent('/attachments/banner.png'));
});
test('rejects a double leading slash (network-relative URL)', () => {
expect(resolvePageIcon('//evil.com/logo.png').kind).toBe('unsupported');
});
test('rejects a non-Latin word that ASCII-only letter check would let through', () => {
expect(resolvePageIcon('привет').kind).toBe('unsupported');
expect(resolvePageIcon('γειά').kind).toBe('unsupported');
expect(resolvePageIcon('مرحبا').kind).toBe('unsupported');
});
test('accepts svg / avif / webp extensions', () => {
expect(resolvePageIcon('assets/icon.svg').kind).toBe('path');
expect(resolvePageIcon('assets/icon.avif').kind).toBe('path');
expect(resolvePageIcon('assets/icon.webp').kind).toBe('path');
});
});
describe('resolvePageCover', () => {
test('rejects emoji (covers require an image)', () => {
expect(resolvePageCover('🏔️').kind).toBe('unsupported');
});
test('classifies an https image URL as url', () => {
expect(resolvePageCover('https://example.com/banner.jpg').kind).toBe('url');
});
test('classifies a relative path with an image extension as path', () => {
const r = resolvePageCover('assets/banner.jpg');
expect(r.kind).toBe('path');
expect(r.value).toContain('/api/asset?path=');
});
test('rejects empty + whitespace-only', () => {
expect(resolvePageCover('').kind).toBe('unsupported');
expect(resolvePageCover(' ').kind).toBe('unsupported');
});
test('rejects non-string input', () => {
expect(resolvePageCover(null).kind).toBe('unsupported');
expect(resolvePageCover(42).kind).toBe('unsupported');
});
test('rejects unsafe schemes', () => {
expect(resolvePageCover('javascript:image.png').kind).toBe('unsupported');
});
test('rejects path traversal', () => {
expect(resolvePageCover('../../../etc/passwd.png').kind).toBe('unsupported');
});
test('rejects non-image extension', () => {
expect(resolvePageCover('archive.zip').kind).toBe('unsupported');
expect(resolvePageCover('docs/note.md').kind).toBe('unsupported');
});
test('rejects query / hash on the path branch (URL branch keeps working)', () => {
expect(resolvePageCover('assets/banner.jpg?v=2').kind).toBe('unsupported');
expect(resolvePageCover('https://example.com/banner.jpg#x').kind).toBe('url');
});
test('tolerates a single leading slash (upload-pipeline shape)', () => {
const r = resolvePageCover('/attachments/banner.png');
expect(r.kind).toBe('path');
expect(r.value).toContain(encodeURIComponent('attachments/banner.png'));
expect(r.value).not.toContain(encodeURIComponent('/attachments/banner.png'));
});
test('rejects a double leading slash (network-relative URL)', () => {
expect(resolvePageCover('//evil.com/banner.png').kind).toBe('unsupported');
});
test('unwraps an Obsidian wikilink to a project asset path', () => {
const r = resolvePageCover('[[Attachments/pic.png]]');
expect(r.kind).toBe('path');
expect(r.value).toContain(encodeURIComponent('Attachments/pic.png'));
});
test('unwraps a wikilink with a display alias (drops the alias)', () => {
const r = resolvePageCover('[[banners/hero.jpg|Hero image]]');
expect(r.kind).toBe('path');
expect(r.value).toContain(encodeURIComponent('banners/hero.jpg'));
});
test('unwraps a wikilink with an anchor (drops the anchor)', () => {
const r = resolvePageCover('[[banners/hero.png#top]]');
expect(r.kind).toBe('path');
expect(r.value).toContain(encodeURIComponent('banners/hero.png'));
});
test('a non-image wikilink still rejects', () => {
expect(resolvePageCover('[[notes/plain-text]]').kind).toBe('unsupported');
});
});
describe('parseFocalY', () => {
test('accepts a plain number in range', () => {
expect(parseFocalY(0)).toBe(0);
expect(parseFocalY(0.35)).toBe(0.35);
expect(parseFocalY(0.5)).toBe(0.5);
expect(parseFocalY(1)).toBe(1);
});
test('accepts a numeric string', () => {
expect(parseFocalY('0.35')).toBe(0.35);
expect(parseFocalY('1')).toBe(1);
});
test('clamps below 0 up to 0', () => {
expect(parseFocalY(-0.5)).toBe(0);
expect(parseFocalY('-1')).toBe(0);
});
test('clamps above 1 down to 1', () => {
expect(parseFocalY(1.5)).toBe(1);
expect(parseFocalY('42')).toBe(1);
});
test('rejects non-numeric input', () => {
expect(parseFocalY(null)).toBeNull();
expect(parseFocalY(undefined)).toBeNull();
expect(parseFocalY('top')).toBeNull();
expect(parseFocalY({})).toBeNull();
expect(parseFocalY([])).toBeNull();
expect(parseFocalY(Number.NaN)).toBeNull();
expect(parseFocalY(Number.POSITIVE_INFINITY)).toBeNull();
});
test('rejects empty / whitespace-only strings (not Number("") = 0)', () => {
expect(parseFocalY('')).toBeNull();
expect(parseFocalY(' ')).toBeNull();
expect(parseFocalY('\t\n')).toBeNull();
});
});
describe('focalYToObjectPosition', () => {
test('null → center (fallback)', () => {
expect(focalYToObjectPosition(null)).toBe('center');
});
test('0 → top', () => {
expect(focalYToObjectPosition(0)).toBe('center 0%');
});
test('0.5 → middle', () => {
expect(focalYToObjectPosition(0.5)).toBe('center 50%');
});
test('1 → bottom', () => {
expect(focalYToObjectPosition(1)).toBe('center 100%');
});
test('rounds to nearest whole percent', () => {
expect(focalYToObjectPosition(0.333)).toBe('center 33%');
expect(focalYToObjectPosition(0.666)).toBe('center 67%');
});
});
describe('pickCoverKey', () => {
test('picks banner when only banner is set', () => {
expect(pickCoverKey({ banner: 'https://example.com/x.png' })).toBe('banner');
});
test('picks cover when only cover is set', () => {
expect(pickCoverKey({ cover: 'https://example.com/x.png' })).toBe('cover');
});
test('prefers banner over cover when both resolve', () => {
expect(
pickCoverKey({
banner: 'https://example.com/a.png',
cover: 'https://example.com/b.png',
}),
).toBe('banner');
});
test('falls through to cover when banner is present but not image-shaped', () => {
expect(pickCoverKey({ banner: 'not-an-image', cover: 'https://example.com/x.png' })).toBe(
'cover',
);
});
test('falls through to cover when banner is empty string', () => {
expect(pickCoverKey({ banner: '', cover: 'https://example.com/x.png' })).toBe('cover');
});
test('falls through to cover when banner is a wikilink to a non-image', () => {
expect(pickCoverKey({ banner: '[[notes/plain]]', cover: 'https://example.com/x.png' })).toBe(
'cover',
);
});
test('returns null when neither key resolves', () => {
expect(pickCoverKey({})).toBeNull();
expect(pickCoverKey({ banner: 'x', cover: 'y' })).toBeNull();
expect(pickCoverKey({ banner: null, cover: null })).toBeNull();
});
test('an Obsidian-shaped wikilink banner is picked over a URL cover', () => {
expect(
pickCoverKey({
banner: '[[Attachments/hero.png]]',
cover: 'https://example.com/x.png',
}),
).toBe('banner');
});
});