Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { cleanup, render, screen } from '@testing-library/react';
import { afterEach, describe, expect, test } from 'vitest';
import { InternalDocPreviewCard } from './InternalDocPreviewCard';
import type { InternalDocPreview } from './internal-doc-preview.ts';
afterEach(cleanup);
const DAY_MS = 86_400_000;
function daysAgoIso(days: number): string {
return new Date(Date.now() - days * DAY_MS).toISOString();
}
const fullPreview: InternalDocPreview = {
docName: 'guides/install',
title: 'Install guide',
folderPath: 'guides',
lastEditedAt: daysAgoIso(3),
tags: ['setup', 'onboarding'],
backlinkCount: 2,
excerpt: 'Install the CLI and run ok start to boot the server.',
};
function slot(container: HTMLElement, name: string): HTMLElement | null {
return container.querySelector(`[data-slot="internal-doc-preview-${name}"]`);
}
describe('InternalDocPreviewCard — resolved doc fields', () => {
test('renders title, folder, tags, excerpt, backlink count, and edited time', () => {
const { container } = render(<InternalDocPreviewCard preview={fullPreview} />);
expect(screen.getByText('Install guide')).toBeTruthy();
expect(slot(container, 'folder')?.textContent).toContain('guides');
expect(screen.getByText('setup')).toBeTruthy();
expect(screen.getByText('onboarding')).toBeTruthy();
expect(slot(container, 'excerpt')?.textContent).toContain('Install the CLI');
const meta = slot(container, 'meta')?.textContent ?? '';
expect(meta).toContain('2 backlinks');
expect(meta).toContain('ago');
});
test('a single backlink uses the singular form', () => {
const { container } = render(
<InternalDocPreviewCard preview={{ ...fullPreview, backlinkCount: 1 }} />,
);
expect(slot(container, 'meta')?.textContent).toContain('1 backlink');
expect(slot(container, 'meta')?.textContent).not.toContain('1 backlinks');
});
});
describe('InternalDocPreviewCard — progressive omission', () => {
test('omits excerpt, tags, and backlink count while their reads are unresolved', () => {
const preview: InternalDocPreview = {
docName: 'guides/install',
title: 'Install guide',
folderPath: 'guides',
lastEditedAt: daysAgoIso(1),
};
const { container } = render(<InternalDocPreviewCard preview={preview} />);
expect(screen.getByText('Install guide')).toBeTruthy();
expect(slot(container, 'folder')).toBeTruthy();
expect(slot(container, 'tags')).toBeNull();
expect(slot(container, 'excerpt')).toBeNull();
expect(slot(container, 'empty')).toBeNull();
expect(slot(container, 'meta')?.textContent ?? '').not.toContain('backlink');
});
test('an empty body shows the "No excerpt" affordance, not an excerpt', () => {
const { container } = render(
<InternalDocPreviewCard preview={{ ...fullPreview, excerpt: '' }} />,
);
expect(slot(container, 'excerpt')).toBeNull();
expect(slot(container, 'empty')?.textContent).toContain('No excerpt');
});
test('an empty tags array omits the tags row', () => {
const { container } = render(<InternalDocPreviewCard preview={{ ...fullPreview, tags: [] }} />);
expect(slot(container, 'tags')).toBeNull();
});
test('a root-level doc (no folder) omits the folder row', () => {
const { container } = render(
<InternalDocPreviewCard preview={{ ...fullPreview, folderPath: null }} />,
);
expect(slot(container, 'folder')).toBeNull();
expect(screen.getByText('Install guide')).toBeTruthy();
});
});