@jasonshimmy/vite-plugin-cer-app 0.19.3 → 0.20.1

package/src/__tests__/plugin/content/emitter.test.ts

@@ -0,0 +1,117 @@
+import { describe, it, expect } from 'vitest'
+import { contentPathToFile, emitContentFiles } from '../../../plugin/content/emitter.js'
+import { mkdtempSync, readFileSync, existsSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'pathe'
+import type { ContentItem } from '../../../types/content.js'
+
+// ─── contentPathToFile ────────────────────────────────────────────────────────
+
+describe('contentPathToFile', () => {
+  it('maps / to index.json', () => {
+    expect(contentPathToFile('/')).toBe('index.json')
+  })
+
+  it('maps /about to about.json', () => {
+    expect(contentPathToFile('/about')).toBe('about.json')
+  })
+
+  it('maps /blog/hello to blog/hello.json', () => {
+    expect(contentPathToFile('/blog/hello')).toBe('blog/hello.json')
+  })
+
+  it('maps /blog to blog.json', () => {
+    expect(contentPathToFile('/blog')).toBe('blog.json')
+  })
+
+  it('maps /docs/getting-started to docs/getting-started.json', () => {
+    expect(contentPathToFile('/docs/getting-started')).toBe('docs/getting-started.json')
+  })
+})
+
+// ─── emitContentFiles ─────────────────────────────────────────────────────────
+
+describe('emitContentFiles', () => {
+  const items: ContentItem[] = [
+    {
+      _path: '/',
+      _file: 'index.md',
+      _type: 'markdown',
+      title: 'Home',
+      description: 'Welcome',
+      body: '<h1>Home</h1>',
+      toc: [],
+    },
+    {
+      _path: '/blog/hello',
+      _file: 'blog/hello.md',
+      _type: 'markdown',
+      title: 'Hello',
+      description: 'First post',
+      date: '2026-04-03',
+      draft: false,
+      body: '<h1>Hello</h1>',
+      toc: [{ depth: 1, id: 'hello', text: 'Hello' }],
+      excerpt: '<p>Intro</p>',
+    },
+  ]
+
+  it('writes manifest.json with lean ContentMeta (no body/toc/excerpt/_file)', () => {
+    const outDir = mkdtempSync(join(tmpdir(), 'cer-emitter-'))
+    emitContentFiles(items, outDir, '{}')
+    const manifest = JSON.parse(readFileSync(join(outDir, '_content/manifest.json'), 'utf-8'))
+    expect(Array.isArray(manifest)).toBe(true)
+    expect(manifest).toHaveLength(2)
+    const root = manifest.find((m: { _path: string }) => m._path === '/')
+    expect(root.title).toBe('Home')
+    expect('body' in root).toBe(false)
+    expect('toc' in root).toBe(false)
+    expect('excerpt' in root).toBe(false)
+    expect('_file' in root).toBe(false)
+  })
+
+  it('writes search-index.json with provided content', () => {
+    const outDir = mkdtempSync(join(tmpdir(), 'cer-emitter-'))
+    emitContentFiles(items, outDir, '{"test":true}')
+    const idx = JSON.parse(readFileSync(join(outDir, '_content/search-index.json'), 'utf-8'))
+    expect(idx).toEqual({ test: true })
+  })
+
+  it('writes root document to _content/index.json', () => {
+    const outDir = mkdtempSync(join(tmpdir(), 'cer-emitter-'))
+    emitContentFiles(items, outDir, '{}')
+    expect(existsSync(join(outDir, '_content/index.json'))).toBe(true)
+    const doc = JSON.parse(readFileSync(join(outDir, '_content/index.json'), 'utf-8'))
+    expect(doc._path).toBe('/')
+    expect(doc.body).toBe('<h1>Home</h1>')
+  })
+
+  it('writes nested document to correct subdirectory', () => {
+    const outDir = mkdtempSync(join(tmpdir(), 'cer-emitter-'))
+    emitContentFiles(items, outDir, '{}')
+    const docPath = join(outDir, '_content/blog/hello.json')
+    expect(existsSync(docPath)).toBe(true)
+    const doc = JSON.parse(readFileSync(docPath, 'utf-8'))
+    expect(doc._path).toBe('/blog/hello')
+    expect(doc.toc).toEqual([{ depth: 1, id: 'hello', text: 'Hello' }])
+    expect(doc.excerpt).toBe('<p>Intro</p>')
+  })
+
+  it('coexisting blog.json and blog/ dir is allowed', () => {
+    const items2: ContentItem[] = [
+      ...items,
+      {
+        _path: '/blog',
+        _file: 'blog/index.md',
+        _type: 'markdown',
+        title: 'Blog',
+        body: '<p>Blog</p>',
+        toc: [],
+      },
+    ]
+    const outDir = mkdtempSync(join(tmpdir(), 'cer-emitter-'))
+    emitContentFiles(items2, outDir, '{}')
+    expect(existsSync(join(outDir, '_content/blog.json'))).toBe(true)
+    expect(existsSync(join(outDir, '_content/blog/hello.json'))).toBe(true)
+  })
+})

package/src/__tests__/plugin/content/loader.test.ts

@@ -0,0 +1,162 @@
+/**
+ * Tests for cerContent() plugin factory helpers:
+ *   - CONTENT_STORE_KEY constant
+ *   - resolveContentDir()
+ *   - loadContentStore()
+ *
+ * The Vite plugin hooks (buildStart, configureServer, closeBundle) are exercised
+ * by the e2e suite across all three build modes.
+ */
+import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'pathe'
+import {
+  CONTENT_STORE_KEY,
+  resolveContentDir,
+  loadContentStore,
+} from '../../../plugin/content/index.js'
+
+let tmpDir: string
+let contentDir: string
+
+beforeAll(() => {
+  tmpDir = mkdtempSync(join(tmpdir(), 'cer-content-loader-'))
+  contentDir = join(tmpDir, 'content')
+  mkdirSync(contentDir, { recursive: true })
+  mkdirSync(join(contentDir, 'blog'), { recursive: true })
+  mkdirSync(join(contentDir, 'data'), { recursive: true })
+
+  writeFileSync(join(contentDir, 'index.md'), '---\ntitle: Home\ndescription: Welcome\n---\n\n# Home\n')
+  writeFileSync(join(contentDir, 'about.md'), '---\ntitle: About\ndate: 2026-04-01\n---\n\n# About\n')
+  writeFileSync(
+    join(contentDir, 'blog', '2026-04-03-hello.md'),
+    '---\ntitle: Hello World\ndate: 2026-04-03\ndraft: false\n---\n\nHello post!',
+  )
+  writeFileSync(
+    join(contentDir, 'blog', 'secret.md'),
+    '---\ntitle: Secret Draft\ndraft: true\n---\n\nSecret!',
+  )
+  writeFileSync(join(contentDir, 'data', 'products.json'), JSON.stringify([{ id: 1 }]))
+})
+
+afterAll(() => {
+  rmSync(tmpDir, { recursive: true, force: true })
+})
+
+// ─── CONTENT_STORE_KEY ────────────────────────────────────────────────────────
+
+describe('CONTENT_STORE_KEY', () => {
+  it('equals __CER_CONTENT_STORE__', () => {
+    expect(CONTENT_STORE_KEY).toBe('__CER_CONTENT_STORE__')
+  })
+})
+
+// ─── resolveContentDir ────────────────────────────────────────────────────────
+
+describe('resolveContentDir', () => {
+  it('uses "content" when no config is supplied', () => {
+    expect(resolveContentDir('/root')).toBe('/root/content')
+  })
+
+  it('uses "content" when config.dir is undefined', () => {
+    expect(resolveContentDir('/root', {})).toBe('/root/content')
+  })
+
+  it('uses the configured dir when provided', () => {
+    expect(resolveContentDir('/root', { dir: 'docs' })).toBe('/root/docs')
+  })
+
+  it('resolves relative to the project root, not the app source dir', () => {
+    // content/ is a sibling of app/, not a child of it
+    expect(resolveContentDir('/workspace/my-project', { dir: 'posts' })).toBe(
+      '/workspace/my-project/posts',
+    )
+  })
+})
+
+// ─── loadContentStore ─────────────────────────────────────────────────────────
+
+describe('loadContentStore — nonexistent dir', () => {
+  it('returns empty array when contentDir does not exist', async () => {
+    const items = await loadContentStore('/path/does/not/exist', false, false)
+    expect(items).toEqual([])
+  })
+})
+
+describe('loadContentStore — dev mode (isProduction=false)', () => {
+  it('loads all files including drafts', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    const paths = items.map((i) => i._path).sort()
+    // Root, about, blog/hello, blog/secret, data/products
+    expect(paths).toContain('/')
+    expect(paths).toContain('/about')
+    expect(paths).toContain('/blog/hello')
+    expect(paths).toContain('/blog/secret')
+    expect(paths).toContain('/data/products')
+  })
+
+  it('includes draft items', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    const secret = items.find((i) => i._path === '/blog/secret')
+    expect(secret).toBeDefined()
+    expect(secret?.draft).toBe(true)
+  })
+
+  it('strips date prefix from slug', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    expect(items.find((i) => i._path === '/blog/hello')).toBeDefined()
+    expect(items.find((i) => i._path === '/blog/2026-04-03-hello')).toBeUndefined()
+  })
+
+  it('each item has required ContentItem fields', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    for (const item of items) {
+      expect(typeof item._path).toBe('string')
+      expect(typeof item._file).toBe('string')
+      expect(item._type === 'markdown' || item._type === 'json').toBe(true)
+      expect(typeof item.body).toBe('string')
+      expect(Array.isArray(item.toc)).toBe(true)
+    }
+  })
+
+  it('normalises date fields to strings (not Date objects)', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    const about = items.find((i) => i._path === '/about')
+    expect(about).toBeDefined()
+    expect(typeof about?.date).toBe('string')
+    expect(about?.date as string).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+  })
+})
+
+describe('loadContentStore — production mode (isProduction=true, isDraft=false)', () => {
+  it('excludes draft items', async () => {
+    const items = await loadContentStore(contentDir, false, true)
+    const secret = items.find((i) => i._path === '/blog/secret')
+    expect(secret).toBeUndefined()
+  })
+
+  it('includes non-draft items', async () => {
+    const items = await loadContentStore(contentDir, false, true)
+    expect(items.find((i) => i._path === '/blog/hello')).toBeDefined()
+    expect(items.find((i) => i._path === '/about')).toBeDefined()
+  })
+})
+
+describe('loadContentStore — production mode with drafts enabled (isDraft=true)', () => {
+  it('includes draft items when isDraft=true in production', async () => {
+    const items = await loadContentStore(contentDir, true, true)
+    const secret = items.find((i) => i._path === '/blog/secret')
+    expect(secret).toBeDefined()
+  })
+})
+
+describe('loadContentStore — JSON files', () => {
+  it('includes JSON files with _type json', async () => {
+    const items = await loadContentStore(contentDir, false, false)
+    const products = items.find((i) => i._path === '/data/products')
+    expect(products).toBeDefined()
+    expect(products?._type).toBe('json')
+    expect(JSON.parse(products?.body ?? '[]')).toEqual([{ id: 1 }])
+  })
+})

package/src/__tests__/plugin/content/parser.test.ts

@@ -0,0 +1,381 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'pathe'
+import { parseContentFile } from '../../../plugin/content/parser.js'
+import type { ContentFile } from '../../../plugin/content/scanner.js'
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+let tmpDir: string
+let contentDir: string
+
+beforeAll(() => {
+  tmpDir = mkdtempSync(join(tmpdir(), 'cer-content-parser-'))
+  contentDir = join(tmpDir, 'content')
+  mkdirSync(contentDir, { recursive: true })
+  mkdirSync(join(contentDir, 'blog'), { recursive: true })
+  mkdirSync(join(contentDir, 'data'), { recursive: true })
+
+  writeFileSync(join(contentDir, 'index.md'), `---
+title: Home
+description: Welcome home
+---
+
+# Home
+
+Body content.
+`)
+
+  writeFileSync(join(contentDir, 'about.md'), `---
+title: About
+date: 2026-04-01
+draft: false
+tags: [web]
+---
+
+# About
+
+## Section One
+
+Content here.
+`)
+
+  writeFileSync(join(contentDir, 'blog', 'hello.md'), `---
+title: Hello World
+description: My first post
+date: 2026-04-03
+---
+
+Intro paragraph.
+
+<!-- more -->
+
+Rest of the body.
+`)
+
+  writeFileSync(join(contentDir, 'blog', 'no-excerpt.md'), `---
+title: No Excerpt
+---
+
+Just content, no more marker.
+`)
+
+  writeFileSync(join(contentDir, 'data', 'products.json'), JSON.stringify([{ id: 1, name: 'Widget' }]))
+
+  // ── Fallback fixtures ────────────────────────────────────────────────────
+  // No frontmatter at all — title and description derived from body
+  writeFileSync(join(contentDir, 'no-frontmatter.md'), `# Derived Title
+
+First paragraph for description.
+
+Second paragraph.
+`)
+
+  // Frontmatter title only — description derived from body
+  writeFileSync(join(contentDir, 'title-only.md'), `---
+title: Explicit Title
+---
+
+Description will come from this paragraph.
+`)
+
+  // Frontmatter description only — title derived from h1
+  writeFileSync(join(contentDir, 'desc-only.md'), `---
+description: Explicit description
+---
+
+# Derived H1 Title
+
+Some paragraph.
+`)
+
+  // Both set in frontmatter — body values must NOT overwrite them
+  writeFileSync(join(contentDir, 'both-frontmatter.md'), `---
+title: FM Title
+description: FM Description
+---
+
+# Different H1
+
+Different paragraph.
+`)
+
+  // h1 with inline formatting — plain text only
+  writeFileSync(join(contentDir, 'formatted-h1.md'), `# Hello **World**
+
+Some intro.
+`)
+
+  // Long paragraph — description truncated to 160 chars + ellipsis
+  writeFileSync(join(contentDir, 'long-para.md'), `# Long
+
+${'A'.repeat(200)}
+`)
+
+  // No h1, only h2 — title fallback must remain undefined
+  writeFileSync(join(contentDir, 'no-h1.md'), `## Section Only
+
+A paragraph here.
+`)
+})
+
+function makeFile(filePath: string, ext: 'md' | 'json'): ContentFile {
+  return { filePath, ext }
+}
+
+// ─── Markdown parsing ─────────────────────────────────────────────────────────
+
+describe('parseContentFile — Markdown', () => {
+  it('returns correct _path for index.md', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'index.md'), 'md'), contentDir)
+    expect(item._path).toBe('/')
+  })
+
+  it('sets _type to markdown', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'index.md'), 'md'), contentDir)
+    expect(item._type).toBe('markdown')
+  })
+
+  it('sets _file relative to contentDir', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    expect(item._file).toBe('about.md')
+  })
+
+  it('extracts frontmatter fields', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    expect(item.title).toBe('About')
+    // gray-matter parses YAML date strings as Date objects; verify date truthy and correct type
+    expect(item.date).toBeTruthy()
+    expect(item.draft).toBe(false)
+    expect(item.tags).toEqual(['web'])
+  })
+
+  it('renders Markdown body to HTML', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'index.md'), 'md'), contentDir)
+    expect(item.body).toContain('<h1')
+    expect(item.body).toContain('Home')
+  })
+
+  it('extracts headings into toc', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    expect(Array.isArray(item.toc)).toBe(true)
+    const h1 = item.toc.find((h) => h.depth === 1)
+    const h2 = item.toc.find((h) => h.depth === 2)
+    expect(h1).toBeDefined()
+    expect(h2).toBeDefined()
+    expect(h2?.text).toBe('Section One')
+    expect(h2?.id).toBe('section-one')
+  })
+
+  it('adds id attributes to headings in body HTML', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    expect(item.body).toContain('id="section-one"')
+  })
+
+  it('toc id matches heading id attribute in body', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    for (const h of item.toc) {
+      expect(item.body).toContain(`id="${h.id}"`)
+    }
+  })
+
+  it('sets excerpt when <!-- more --> marker is present', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'blog', 'hello.md'), 'md'),
+      contentDir,
+    )
+    expect(item.excerpt).toBeDefined()
+    expect(item.excerpt).toContain('Intro paragraph')
+    expect(item.excerpt).not.toContain('Rest of the body')
+  })
+
+  it('excerpt is absent when no <!-- more --> marker', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'blog', 'no-excerpt.md'), 'md'),
+      contentDir,
+    )
+    expect(item.excerpt).toBeUndefined()
+  })
+
+  it('body contains full content including text after <!-- more -->', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'blog', 'hello.md'), 'md'),
+      contentDir,
+    )
+    expect(item.body).toContain('Intro paragraph')
+    expect(item.body).toContain('Rest of the body')
+    // The <!-- more --> marker itself must not appear in the rendered body HTML
+    expect(item.body).not.toContain('<!-- more -->')
+  })
+})
+
+// ─── JSON parsing ─────────────────────────────────────────────────────────────
+
+describe('parseContentFile — JSON', () => {
+  it('sets _type to json', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'data', 'products.json'), 'json'),
+      contentDir,
+    )
+    expect(item._type).toBe('json')
+  })
+
+  it('sets body to raw JSON string', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'data', 'products.json'), 'json'),
+      contentDir,
+    )
+    expect(JSON.parse(item.body)).toEqual([{ id: 1, name: 'Widget' }])
+  })
+
+  it('sets toc to empty array', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'data', 'products.json'), 'json'),
+      contentDir,
+    )
+    expect(item.toc).toEqual([])
+  })
+
+  it('sets correct _path for json file', () => {
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'data', 'products.json'), 'json'),
+      contentDir,
+    )
+    expect(item._path).toBe('/data/products')
+  })
+
+  it('throws a descriptive error for invalid JSON', () => {
+    const badFile = join(contentDir, 'data', 'bad.json')
+    writeFileSync(badFile, '{not valid json}')
+    expect(() =>
+      parseContentFile(makeFile(badFile, 'json'), contentDir),
+    ).toThrow(/Invalid JSON/)
+  })
+})
+
+// ─── toContentMeta ────────────────────────────────────────────────────────────
+
+describe('toContentMeta', () => {
+  it('strips _file, body, toc, excerpt from ContentItem', async () => {
+    const { toContentMeta } = await import('../../../plugin/content/parser.js')
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'blog', 'hello.md'), 'md'),
+      contentDir,
+    )
+    const meta = toContentMeta(item)
+    expect('_file' in meta).toBe(false)
+    expect('body' in meta).toBe(false)
+    expect('toc' in meta).toBe(false)
+    expect('excerpt' in meta).toBe(false)
+    expect(meta._path).toBe('/blog/hello')
+    expect(meta.title).toBe('Hello World')
+  })
+})
+
+// ─── Date normalisation ───────────────────────────────────────────────────────
+
+describe('parseContentFile — date normalisation', () => {
+  it('converts a gray-matter Date object to a YYYY-MM-DD string', () => {
+    // gray-matter parses `date: 2026-04-01` as a JS Date object.
+    // The parser must normalise it to a string so the in-memory server store and
+    // the client (after JSON round-trip) are consistent.
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    expect(typeof item.date).toBe('string')
+    expect(item.date as string).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+  })
+
+  it('normalised date string is comparable with other ISO date strings', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'about.md'), 'md'), contentDir)
+    const date = item.date as string
+    // Verify that where-predicate comparisons work correctly post-normalisation
+    expect(date >= '2026-01-01').toBe(true)
+    expect(date < '2027-01-01').toBe(true)
+  })
+})
+
+// ─── Fallback title / description ────────────────────────────────────────────
+
+describe('parseContentFile — fallback title from h1', () => {
+  it('derives title from h1 when frontmatter title is absent', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'no-frontmatter.md'), 'md'), contentDir)
+    expect(item.title).toBe('Derived Title')
+  })
+
+  it('frontmatter title is not overwritten when present', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'title-only.md'), 'md'), contentDir)
+    expect(item.title).toBe('Explicit Title')
+  })
+
+  it('derives title from h1 when only description is in frontmatter', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'desc-only.md'), 'md'), contentDir)
+    expect(item.title).toBe('Derived H1 Title')
+  })
+
+  it('frontmatter title wins over h1 when both set', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'both-frontmatter.md'), 'md'), contentDir)
+    expect(item.title).toBe('FM Title')
+  })
+
+  it('strips inline formatting — title is plain text', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'formatted-h1.md'), 'md'), contentDir)
+    expect(item.title).toBe('Hello World')
+  })
+
+  it('does not derive title from h2 — must be h1 only', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'no-h1.md'), 'md'), contentDir)
+    expect(item.title).toBeUndefined()
+  })
+})
+
+describe('parseContentFile — fallback description from first paragraph', () => {
+  it('derives description from first paragraph when frontmatter description is absent', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'no-frontmatter.md'), 'md'), contentDir)
+    expect(item.description).toBe('First paragraph for description.')
+  })
+
+  it('frontmatter description is not overwritten when present', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'desc-only.md'), 'md'), contentDir)
+    expect(item.description).toBe('Explicit description')
+  })
+
+  it('derives description from first paragraph when only title is in frontmatter', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'title-only.md'), 'md'), contentDir)
+    expect(item.description).toBe('Description will come from this paragraph.')
+  })
+
+  it('frontmatter description wins when both set', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'both-frontmatter.md'), 'md'), contentDir)
+    expect(item.description).toBe('FM Description')
+  })
+
+  it('truncates long paragraphs to 160 chars with ellipsis', () => {
+    const item = parseContentFile(makeFile(join(contentDir, 'long-para.md'), 'md'), contentDir)
+    expect(typeof item.description).toBe('string')
+    expect((item.description as string).length).toBeLessThanOrEqual(164) // 160 + '…' (3 bytes)
+    expect(item.description as string).toMatch(/…$/)
+  })
+
+  it('derived description is on ContentMeta (present in manifest)', async () => {
+    const { toContentMeta } = await import('../../../plugin/content/parser.js')
+    const item = parseContentFile(makeFile(join(contentDir, 'no-frontmatter.md'), 'md'), contentDir)
+    const meta = toContentMeta(item)
+    expect(meta.description).toBe('First paragraph for description.')
+  })
+})
+
+describe('parseContentFile — JSON fallback', () => {
+  it('does not apply title/description fallbacks to JSON files', () => {
+    // JSON files have no markdown body to extract from
+    const item = parseContentFile(
+      makeFile(join(contentDir, 'data', 'products.json'), 'json'),
+      contentDir,
+    )
+    expect(item.title).toBeUndefined()
+    expect(item.description).toBeUndefined()
+  })
+})
+
+afterAll(() => {
+  rmSync(tmpDir, { recursive: true, force: true })
+})