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

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
 All notable changes to this project will be documented in this file.
+## [v0.20.1] - 2026-04-11
+
+- fix(content): add fallback title and description extraction from Markdown body (9bab321)
+
 ## [v0.20.0] - 2026-04-11
 
 - feat(content): implement file-based content layer with Markdown/JSON support (#1) (c6ef0f7)

package/commits.txt

@@ -1,2 +1 @@
-- feat(content): implement file-based content layer with Markdown/JSON support (#1) (c6ef0f7)
-- chore: update dependencies for @jasonshimmy/custom-elements-runtime and typescript-eslint (15095bc)
+- fix(content): add fallback title and description extraction from Markdown body (9bab321)

package/dist/plugin/content/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugin/content/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AA0J/C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,WAAW,CAGb;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAI5D"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugin/content/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AA6N/C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,WAAW,CAGb;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAI5D"}

package/dist/plugin/content/parser.js

@@ -40,6 +40,60 @@ function extractHeadings(tokens) {
     walk(tokens);
     return headings;
 }
+// ─── Fallback title / description extraction ─────────────────────────────────
+/**
+ * Converts a list of inline marked tokens to plain text by recursing into
+ * formatted tokens (strong, em, link, etc.) and collecting their leaf text.
+ * Used to derive readable fallback values from body content.
+ */
+function inlineToPlainText(tokens) {
+    let result = '';
+    for (const t of tokens) {
+        const children = t.tokens;
+        if (Array.isArray(children) && children.length > 0) {
+            result += inlineToPlainText(children);
+        }
+        else if (t.type === 'br') {
+            result += ' ';
+        }
+        else if ('text' in t && typeof t.text === 'string') {
+            result += t.text;
+        }
+    }
+    return result;
+}
+const DESCRIPTION_MAX_LEN = 160;
+/**
+ * Scans the top-level token list for a fallback `title` (first depth-1 heading)
+ * and `description` (first paragraph). Both are `undefined` when no matching
+ * token is found.
+ *
+ * These are applied only when the corresponding frontmatter field is absent, so
+ * frontmatter always wins.
+ */
+function extractFallbacks(tokens) {
+    let title;
+    let description;
+    for (const token of tokens) {
+        if (title === undefined && token.type === 'heading' && token.depth === 1) {
+            const text = inlineToPlainText(token.tokens ?? []).trim();
+            if (text)
+                title = text;
+        }
+        if (description === undefined && token.type === 'paragraph') {
+            const text = inlineToPlainText(token.tokens ?? []).trim();
+            if (text) {
+                description =
+                    text.length > DESCRIPTION_MAX_LEN
+                        ? text.slice(0, DESCRIPTION_MAX_LEN).trimEnd() + '…'
+                        : text;
+            }
+        }
+        if (title !== undefined && description !== undefined)
+            break;
+    }
+    return { title, description };
+}
 // ─── Custom renderer: add id to heading tags ─────────────────────────────────
 const renderer = new marked.Renderer();
 renderer.heading = function ({ tokens, depth }) {
@@ -105,6 +159,9 @@ function parseContentFileFromRaw(file, contentDir, raw) {
     const excerpt = excerptSource !== null
         ? marked.parse(excerptSource, { renderer })
         : undefined;
+    // Derive fallback title / description from body tokens when frontmatter
+    // does not provide them. Frontmatter always wins — these only fill gaps.
+    const fallbacks = extractFallbacks(tokens);
     const item = {
         ...frontmatter,
         _path,
@@ -113,6 +170,12 @@ function parseContentFileFromRaw(file, contentDir, raw) {
         body,
         toc,
     };
+    if (item.title === undefined && fallbacks.title !== undefined) {
+        item.title = fallbacks.title;
+    }
+    if (item.description === undefined && fallbacks.description !== undefined) {
+        item.description = fallbacks.description;
+    }
     if (excerpt !== undefined) {
         item.excerpt = excerpt;
     }

package/dist/plugin/content/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/plugin/content/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/plugin/content/parser.ts"],"names":[],"mappings":"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"}

package/docs/content.md

@@ -131,6 +131,23 @@ Recognized frontmatter keys:
 
 Any additional frontmatter keys are stored verbatim in the `ContentMeta` / `ContentItem` object.
 
+### Automatic title and description
+
+When `title` or `description` are absent from frontmatter, the parser derives them from the body:
+
+- **`title`** — plain text of the first depth-1 heading (`# …`). Only `h1` is considered; `h2`–`h6` are ignored.
+- **`description`** — plain text of the first paragraph, truncated to 160 characters (with `…` appended). Inline formatting is stripped.
+
+Frontmatter values always win — these fallbacks only fill the gaps. JSON files do not receive fallbacks (they have no Markdown body to parse from).
+
+```md
+# Hello World
+
+This becomes the description because no description key is in frontmatter.
+```
+
+Results in `title: 'Hello World'` and `description: 'This becomes the description because no description key is in frontmatter.'`.
+
 ### Date-prefixed filenames
 
 Filenames starting with `YYYY-MM-DD-` have the date prefix stripped when computing the content path:

package/e2e/cypress/e2e/content.cy.ts

@@ -2,10 +2,11 @@
  * Content layer e2e tests — exercises queryContent() and useContentSearch().
  *
  * Pages under test:
- *   /content-index  — queryContent().find()  (all content)
- *   /content-blog   — queryContent('/blog').find() (blog prefix, draft exclusion)
- *   /content-doc    — queryContent('/docs/getting-started').first() (body + TOC)
- *   /content-search — useContentSearch() (MiniSearch, client-side)
+ *   /content-index    — queryContent().find()  (all content)
+ *   /content-blog     — queryContent('/blog').find() (blog prefix, draft exclusion)
+ *   /content-doc      — queryContent('/docs/getting-started').first() (body + TOC)
+ *   /content-search   — useContentSearch() (MiniSearch, client-side)
+ *   /content-fallback — title/description derived from body when frontmatter omits them
  */
 
 const mode = Cypress.env('mode') as 'spa' | 'ssr' | 'ssg'
@@ -226,3 +227,65 @@ describe('Content search — useContentSearch()', () => {
     cy.get('[data-cy=content-search-result]').should('not.exist')
   })
 })
+
+// ─── /content-fallback ────────────────────────────────────────────────────────
+
+describe('Content fallback — title and description derived from body', () => {
+  // blog/no-frontmatter.md has no frontmatter at all.
+  // Expected derived values:
+  //   title       → "Derived From Body"      (first h1)
+  //   description → "This description is…"   (first paragraph, ≤160 chars)
+
+  if (mode !== 'spa') {
+    it('pre-renders the derived title in initial HTML (SSR/SSG)', () => {
+      cy.request('/content-fallback').then((response) => {
+        expect(response.body).to.include('Derived From Body')
+      })
+    })
+
+    it('pre-renders the derived description in initial HTML (SSR/SSG)', () => {
+      cy.request('/content-fallback').then((response) => {
+        expect(response.body).to.include('This description is derived from the first paragraph')
+      })
+    })
+  }
+
+  it('renders the derived title after hydration', () => {
+    cy.visit('/content-fallback')
+    cy.get('[data-cy=content-fallback-title]', { timeout: 8000 })
+      .should('contain', 'Derived From Body')
+  })
+
+  it('renders the derived description after hydration', () => {
+    cy.visit('/content-fallback')
+    cy.get('[data-cy=content-fallback-desc]', { timeout: 8000 })
+      .should('contain', 'This description is derived from the first paragraph')
+  })
+
+  it('document is found — fallback-missing element is absent', () => {
+    cy.visit('/content-fallback')
+    cy.get('[data-cy=content-fallback-heading]', { timeout: 8000 }).should('exist')
+    cy.get('[data-cy=content-fallback-missing]').should('not.exist')
+  })
+
+  it('derived item appears in queryContent find() results (content-index)', () => {
+    cy.visit('/content-index')
+    cy.get('[data-cy=content-item][data-path="/blog/no-frontmatter"]', { timeout: 8000 })
+      .should('exist')
+  })
+
+  it('derived title is shown in the content-index listing', () => {
+    cy.visit('/content-index')
+    cy.get('[data-cy=content-item][data-path="/blog/no-frontmatter"] [data-cy=content-item-title]', { timeout: 8000 })
+      .should('contain', 'Derived From Body')
+  })
+
+  it('derived item appears in search results when searching by derived title', () => {
+    cy.intercept('GET', '/_content/search-index.json').as('searchIndex')
+    cy.visit('/content-search')
+    cy.wait('@searchIndex')
+    setSearchQuery('Derived')
+    cy.get('[data-cy=content-search-result]', { timeout: 8000 })
+      .should('contain', 'Derived From Body')
+  })
+})

package/e2e/kitchen-sink/app/pages/content-fallback.ts

@@ -0,0 +1,36 @@
+/**
+ * Content fallback page — exercises title/description derivation from body
+ * when frontmatter does not supply them.
+ *
+ * Fetches /blog/no-frontmatter (no frontmatter at all) and renders its
+ * derived title and description so Cypress can assert both in all modes.
+ *
+ * Route: /content-fallback
+ */
+
+component('page-content-fallback', () => {
+  useHead({ title: 'Content Fallback — Kitchen Sink' })
+
+  const ssrData = usePageData<{ doc: ContentItem | null }>()
+  const doc = ref<ContentItem | null>(ssrData?.doc ?? null)
+
+  useOnConnected(async () => {
+    if (ssrData) return // already hydrated
+    doc.value = await queryContent('/blog/no-frontmatter').first()
+  })
+
+  return html`
+    <div>
+      <h1 data-cy="content-fallback-heading">Content Fallback</h1>
+      ${doc.value ? html`
+        <p data-cy="content-fallback-title">${doc.value.title}</p>
+        <p data-cy="content-fallback-desc">${doc.value.description}</p>
+      ` : html`<p data-cy="content-fallback-missing">Document not found.</p>`}
+    </div>
+  `
+})
+
+export const loader = async () => {
+  const doc = await queryContent('/blog/no-frontmatter').first()
+  return { doc }
+}

package/e2e/kitchen-sink/content/blog/no-frontmatter.md

@@ -0,0 +1,7 @@
+# Derived From Body
+
+This description is derived from the first paragraph because no frontmatter is present.
+
+## More Content
+
+Additional body content below the first paragraph.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasonshimmy/vite-plugin-cer-app",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "Nuxt-style meta-framework for @jasonshimmy/custom-elements-runtime",
   "type": "module",
   "keywords": [

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

@@ -1,4 +1,4 @@
-import { describe, it, expect, beforeAll } from 'vitest'
+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'
@@ -62,6 +62,62 @@ 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 {
@@ -237,3 +293,89 @@ describe('parseContentFile — date normalisation', () => {
     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 })
+})

package/src/plugin/content/parser.ts

@@ -48,6 +48,62 @@ function extractHeadings(tokens: Token[]): ContentHeading[] {
   return headings
 }
 
+// ─── Fallback title / description extraction ─────────────────────────────────
+
+/**
+ * Converts a list of inline marked tokens to plain text by recursing into
+ * formatted tokens (strong, em, link, etc.) and collecting their leaf text.
+ * Used to derive readable fallback values from body content.
+ */
+function inlineToPlainText(tokens: Token[]): string {
+  let result = ''
+  for (const t of tokens) {
+    const children = (t as { tokens?: Token[] }).tokens
+    if (Array.isArray(children) && children.length > 0) {
+      result += inlineToPlainText(children)
+    } else if (t.type === 'br') {
+      result += ' '
+    } else if ('text' in t && typeof (t as { text: string }).text === 'string') {
+      result += (t as { text: string }).text
+    }
+  }
+  return result
+}
+
+const DESCRIPTION_MAX_LEN = 160
+
+/**
+ * Scans the top-level token list for a fallback `title` (first depth-1 heading)
+ * and `description` (first paragraph). Both are `undefined` when no matching
+ * token is found.
+ *
+ * These are applied only when the corresponding frontmatter field is absent, so
+ * frontmatter always wins.
+ */
+function extractFallbacks(tokens: Token[]): { title?: string; description?: string } {
+  let title: string | undefined
+  let description: string | undefined
+
+  for (const token of tokens) {
+    if (title === undefined && token.type === 'heading' && token.depth === 1) {
+      const text = inlineToPlainText((token as { tokens: Token[] }).tokens ?? []).trim()
+      if (text) title = text
+    }
+    if (description === undefined && token.type === 'paragraph') {
+      const text = inlineToPlainText((token as { tokens: Token[] }).tokens ?? []).trim()
+      if (text) {
+        description =
+          text.length > DESCRIPTION_MAX_LEN
+            ? text.slice(0, DESCRIPTION_MAX_LEN).trimEnd() + '…'
+            : text
+      }
+    }
+    if (title !== undefined && description !== undefined) break
+  }
+
+  return { title, description }
+}
+
 // ─── Custom renderer: add id to heading tags ─────────────────────────────────
 
 const renderer = new marked.Renderer()
@@ -129,6 +185,10 @@ function parseContentFileFromRaw(
     ? (marked.parse(excerptSource, { renderer }) as string)
     : undefined
 
+  // Derive fallback title / description from body tokens when frontmatter
+  // does not provide them. Frontmatter always wins — these only fill gaps.
+  const fallbacks = extractFallbacks(tokens)
+
   const item: ContentItem = {
     ...frontmatter,
     _path,
@@ -138,6 +198,13 @@ function parseContentFileFromRaw(
     toc,
   }
 
+  if (item.title === undefined && fallbacks.title !== undefined) {
+    item.title = fallbacks.title
+  }
+  if (item.description === undefined && fallbacks.description !== undefined) {
+    item.description = fallbacks.description
+  }
+
   if (excerpt !== undefined) {
     item.excerpt = excerpt
   }