@jasonshimmy/vite-plugin-cer-app 0.19.2 → 0.20.0

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,239 @@
+import { describe, it, expect, beforeAll } 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' }]))
+})
+
+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)
+  })
+})

package/src/__tests__/plugin/content/path-utils.test.ts

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest'
+import { fileToContentPath } from '../../../plugin/content/path-utils.js'
+
+const DIR = '/project/app/content'
+
+// ─── fileToContentPath ────────────────────────────────────────────────────────
+
+describe('fileToContentPath', () => {
+  it('maps index.md to /', () => {
+    expect(fileToContentPath(`${DIR}/index.md`, DIR)).toBe('/')
+  })
+
+  it('maps about.md to /about', () => {
+    expect(fileToContentPath(`${DIR}/about.md`, DIR)).toBe('/about')
+  })
+
+  it('maps blog/index.md to /blog', () => {
+    expect(fileToContentPath(`${DIR}/blog/index.md`, DIR)).toBe('/blog')
+  })
+
+  it('maps blog/2026-04-03-hello.md to /blog/hello (strips date prefix)', () => {
+    expect(fileToContentPath(`${DIR}/blog/2026-04-03-hello.md`, DIR)).toBe('/blog/hello')
+  })
+
+  it('maps docs/getting-started.md to /docs/getting-started', () => {
+    expect(fileToContentPath(`${DIR}/docs/getting-started.md`, DIR)).toBe('/docs/getting-started')
+  })
+
+  it('maps data/products.json to /data/products', () => {
+    expect(fileToContentPath(`${DIR}/data/products.json`, DIR)).toBe('/data/products')
+  })
+
+  it('maps deeply nested file', () => {
+    expect(fileToContentPath(`${DIR}/a/b/c.md`, DIR)).toBe('/a/b/c')
+  })
+
+  it('does not strip date from non-last segments', () => {
+    expect(fileToContentPath(`${DIR}/2026-01-01-blog/hello.md`, DIR)).toBe('/2026-01-01-blog/hello')
+  })
+
+  it('handles .json extension', () => {
+    expect(fileToContentPath(`${DIR}/products.json`, DIR)).toBe('/products')
+  })
+
+  it('maps index-only path at root correctly', () => {
+    expect(fileToContentPath(`${DIR}/index.md`, DIR)).toBe('/')
+  })
+
+  it('strips date from root-level dated file', () => {
+    expect(fileToContentPath(`${DIR}/2026-04-03-hello.md`, DIR)).toBe('/hello')
+  })
+})
+

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

@@ -0,0 +1,119 @@
+import { describe, it, expect } from 'vitest'
+import { buildSearchIndex } from '../../../plugin/content/search.js'
+import MiniSearch from 'minisearch'
+import type { ContentItem } from '../../../types/content.js'
+
+const items: ContentItem[] = [
+  {
+    _path: '/blog/hello',
+    _file: 'blog/hello.md',
+    _type: 'markdown',
+    title: 'Hello World',
+    description: 'My first post about web components',
+    body: '<p>body</p>',
+    toc: [],
+  },
+  {
+    _path: '/docs/getting-started',
+    _file: 'docs/getting-started.md',
+    _type: 'markdown',
+    title: 'Getting Started',
+    description: 'How to get started quickly',
+    body: '<p>body</p>',
+    toc: [],
+  },
+  {
+    _path: '/about',
+    _file: 'about.md',
+    _type: 'markdown',
+    // No title — should be excluded from index
+    body: '<p>About</p>',
+    toc: [],
+  },
+]
+
+describe('buildSearchIndex', () => {
+  it('returns a JSON string', () => {
+    const result = buildSearchIndex(items)
+    expect(typeof result).toBe('string')
+    expect(() => JSON.parse(result)).not.toThrow()
+  })
+
+  it('serialised index can be loaded by MiniSearch', () => {
+    const serialised = buildSearchIndex(items)
+    expect(() =>
+      MiniSearch.loadJSON(serialised, {
+        fields: ['title', 'description'],
+        storeFields: ['_path', 'title', 'description'],
+        idField: '_path',
+      }),
+    ).not.toThrow()
+  })
+
+  it('search finds items by title', () => {
+    const serialised = buildSearchIndex(items)
+    const index = MiniSearch.loadJSON(serialised, {
+      fields: ['title', 'description'],
+      storeFields: ['_path', 'title', 'description'],
+      idField: '_path',
+    })
+    const results = index.search('Hello')
+    expect(results.some((r) => r._path === '/blog/hello')).toBe(true)
+  })
+
+  it('search finds items by description', () => {
+    const serialised = buildSearchIndex(items)
+    const index = MiniSearch.loadJSON(serialised, {
+      fields: ['title', 'description'],
+      storeFields: ['_path', 'title', 'description'],
+      idField: '_path',
+    })
+    const results = index.search('quickly')
+    expect(results.some((r) => r._path === '/docs/getting-started')).toBe(true)
+  })
+
+  it('items without title are excluded from index', () => {
+    const serialised = buildSearchIndex(items)
+    const index = MiniSearch.loadJSON(serialised, {
+      fields: ['title', 'description'],
+      storeFields: ['_path', 'title', 'description'],
+      idField: '_path',
+    })
+    // Search for something that only appears in /about body (not indexed)
+    const results = index.search('About')
+    expect(results.some((r) => r._path === '/about')).toBe(false)
+  })
+
+  it('stored fields include _path, title, description', () => {
+    const serialised = buildSearchIndex(items)
+    const index = MiniSearch.loadJSON(serialised, {
+      fields: ['title', 'description'],
+      storeFields: ['_path', 'title', 'description'],
+      idField: '_path',
+    })
+    const results = index.search('web')
+    expect(results.length).toBeGreaterThan(0)
+    const r = results[0] as { _path: string; title: string; description?: string }
+    expect(r._path).toBeDefined()
+    expect(r.title).toBeDefined()
+  })
+
+  it('returns empty index string when no items have titles', () => {
+    const noTitleItems: ContentItem[] = [
+      {
+        _path: '/about',
+        _file: 'about.md',
+        _type: 'markdown',
+        body: '<p>About</p>',
+        toc: [],
+      },
+    ]
+    const serialised = buildSearchIndex(noTitleItems)
+    const index = MiniSearch.loadJSON(serialised, {
+      fields: ['title', 'description'],
+      storeFields: ['_path', 'title', 'description'],
+      idField: '_path',
+    })
+    expect(index.documentCount).toBe(0)
+  })
+})

package/src/__tests__/plugin/dts-generator.test.ts

@@ -353,3 +353,42 @@ describe('writeAutoImportDts', () => {
     expect(writeFileSync).toHaveBeenCalledTimes(2)
   })
 })
+
+// ─── Content layer globals ────────────────────────────────────────────────────
+
+describe('generateAutoImportDts — content layer globals', () => {
+  it('declares queryContent as a global', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('queryContent')
+  })
+
+  it('declares useContentSearch as a global', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('useContentSearch')
+  })
+
+  it('declares ContentItem type in global scope', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('type ContentItem')
+  })
+
+  it('declares ContentMeta type in global scope', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('type ContentMeta')
+  })
+
+  it('declares ContentHeading type in global scope', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('type ContentHeading')
+  })
+
+  it('declares ContentSearchResult type in global scope', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('type ContentSearchResult')
+  })
+
+  it('declares __CER_APP_CONFIG__ global var', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain('__CER_APP_CONFIG__')
+  })
+})

package/src/__tests__/plugin/transforms/auto-import.test.ts

@@ -346,6 +346,20 @@ describe('autoImportTransform — framework composable injection', () => {
     const count = result.split(`from ${FRAMEWORK_PKG}`).length - 1
     expect(count).toBe(1)
   })
+
+  it('injects queryContent import when queryContent is used', () => {
+    const code = "component('page-blog', () => { queryContent('/blog').find().then(posts => {}); return html`` })"
+    const result = autoImportTransform(code, '/project/app/pages/blog.ts', opts)!
+    expect(result).toContain('queryContent')
+    expect(result).toContain(`from ${FRAMEWORK_PKG}`)
+  })
+
+  it('injects useContentSearch import when useContentSearch is used', () => {
+    const code = "component('site-search', () => { const { query, results } = useContentSearch(); return html`` })"
+    const result = autoImportTransform(code, '/project/app/components/site-search.ts', opts)!
+    expect(result).toContain('useContentSearch')
+    expect(result).toContain(`from ${FRAMEWORK_PKG}`)
+  })
 })
 
 describe('autoImportTransform — server/middleware/ directory', () => {