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

package/dist/runtime/composables/use-content-search.d.ts

@@ -0,0 +1,49 @@
+import type { ReactiveState } from '@jasonshimmy/custom-elements-runtime';
+import type { ContentSearchResult } from '../../types/content.js';
+/**
+ * Lazily loads the MiniSearch index from `/_content/search-index.json`.
+ * Returns the same Promise on repeated calls — the index is built at most once
+ * per session regardless of how many search components are mounted.
+ *
+ * @internal Exported for unit testing only.
+ */
+export declare function loadIndex(): Promise<unknown>;
+/** Resets the module-level singleton. Used in tests only. @internal */
+export declare function resetIndexSingleton(): void;
+export interface UseContentSearchReturn {
+    query: ReactiveState<string>;
+    results: ReactiveState<ContentSearchResult[]>;
+}
+/**
+ * Full-text content search composable.
+ *
+ * Loads a pre-built MiniSearch index lazily on first use by fetching
+ * `/_content/search-index.json`. Both MiniSearch and the index are loaded via
+ * dynamic import — neither is in the app bundle.
+ *
+ * Searches `title` and `description` fields. Results are empty until at least
+ * 2 characters are entered.
+ *
+ * **SSR note**: search is always client-side. In SSR mode the component renders
+ * with empty results and hydrates on mount.
+ *
+ * @example
+ * ```ts
+ * component('site-search', () => {
+ *   const { query, results } = useContentSearch()
+ *
+ *   return html`
+ *     <input type="search" :model="${query}" placeholder="Search…" />
+ *     ${when(results.value.length > 0, () => html`
+ *       <ul>
+ *         ${each(results.value, r => html`
+ *           <li><a :href="${r._path}">${r.title}</a></li>
+ *         `)}
+ *       </ul>
+ *     `)}
+ *   `
+ * })
+ * ```
+ */
+export declare function useContentSearch(): UseContentSearchReturn;
+//# sourceMappingURL=use-content-search.d.ts.map

package/dist/runtime/composables/use-content-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-content-search.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/use-content-search.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AASjE;;;;;;GAMG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAiBlD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5B,OAAO,EAAE,aAAa,CAAC,mBAAmB,EAAE,CAAC,CAAA;CAC9C;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAEzD"}

package/dist/runtime/composables/use-content-search.js

@@ -0,0 +1,101 @@
+import { createComposable, ref, useOnConnected, watch, } from '@jasonshimmy/custom-elements-runtime';
+import { contentSearchIndexUrl } from '../content/client.js';
+// ─── Module-level singleton ───────────────────────────────────────────────────
+// The MiniSearch instance is built lazily on first search from the manifest.
+// The same promise is reused across all mounted instances so we only build once.
+let _indexPromise = null;
+/**
+ * Lazily loads the MiniSearch index from `/_content/search-index.json`.
+ * Returns the same Promise on repeated calls — the index is built at most once
+ * per session regardless of how many search components are mounted.
+ *
+ * @internal Exported for unit testing only.
+ */
+export async function loadIndex() {
+    if (_indexPromise)
+        return _indexPromise;
+    _indexPromise = (async () => {
+        const [{ default: MiniSearch }, raw] = await Promise.all([
+            import('minisearch'),
+            fetch(contentSearchIndexUrl()).then((r) => {
+                if (!r.ok)
+                    throw new Error(`Failed to fetch search index: ${r.status}`);
+                return r.text();
+            }),
+        ]);
+        return MiniSearch.loadJSON(raw, {
+            fields: ['title', 'description'],
+            storeFields: ['_path', 'title', 'description'],
+            idField: '_path',
+        });
+    })();
+    return _indexPromise;
+}
+/** Resets the module-level singleton. Used in tests only. @internal */
+export function resetIndexSingleton() {
+    _indexPromise = null;
+}
+const _factory = createComposable(() => {
+    const query = ref('');
+    const results = ref([]);
+    // Pre-warm index on mount
+    useOnConnected(() => {
+        loadIndex().catch(() => { });
+    });
+    // Monotonic counter to discard stale async results
+    let _seq = 0;
+    watch(query, async (q) => {
+        const seq = ++_seq;
+        if (!q || q.length < 2) {
+            results.value = [];
+            return;
+        }
+        try {
+            const index = await loadIndex();
+            if (seq !== _seq)
+                return; // stale — a newer query is in flight
+            results.value = index.search(q, { prefix: true });
+        }
+        catch {
+            if (seq !== _seq)
+                return;
+            results.value = [];
+        }
+    });
+    return { query, results };
+});
+/**
+ * Full-text content search composable.
+ *
+ * Loads a pre-built MiniSearch index lazily on first use by fetching
+ * `/_content/search-index.json`. Both MiniSearch and the index are loaded via
+ * dynamic import — neither is in the app bundle.
+ *
+ * Searches `title` and `description` fields. Results are empty until at least
+ * 2 characters are entered.
+ *
+ * **SSR note**: search is always client-side. In SSR mode the component renders
+ * with empty results and hydrates on mount.
+ *
+ * @example
+ * ```ts
+ * component('site-search', () => {
+ *   const { query, results } = useContentSearch()
+ *
+ *   return html`
+ *     <input type="search" :model="${query}" placeholder="Search…" />
+ *     ${when(results.value.length > 0, () => html`
+ *       <ul>
+ *         ${each(results.value, r => html`
+ *           <li><a :href="${r._path}">${r.title}</a></li>
+ *         `)}
+ *       </ul>
+ *     `)}
+ *   `
+ * })
+ * ```
+ */
+export function useContentSearch() {
+    return _factory();
+}
+//# sourceMappingURL=use-content-search.js.map

package/dist/runtime/composables/use-content-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-content-search.js","sourceRoot":"","sources":["../../../src/runtime/composables/use-content-search.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,GAAG,EACH,cAAc,EACd,KAAK,GACN,MAAM,sCAAsC,CAAA;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,iFAAiF;AAEjF,6EAA6E;AAC7E,iFAAiF;AACjF,IAAI,aAAa,GAA4B,IAAI,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvD,MAAM,CAAC,YAAY,CAAC;YACpB,KAAK,CAAC,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxC,IAAI,CAAC,CAAC,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;gBACvE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;YACjB,CAAC,CAAC;SACH,CAAC,CAAA;QACF,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;YAChC,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC;YAC9C,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;IACJ,CAAC,CAAC,EAAE,CAAA;IACJ,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB;IACjC,aAAa,GAAG,IAAI,CAAA;AACtB,CAAC;AASD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAA2B,EAAE;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,CAAA;IACrB,MAAM,OAAO,GAAG,GAAG,CAAwB,EAAE,CAAC,CAAA;IAE9C,0BAA0B;IAC1B,cAAc,CAAC,GAAG,EAAE;QAClB,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAuC,CAAC,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,mDAAmD;IACnD,IAAI,IAAI,GAAG,CAAC,CAAA;IAEZ,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,EAAE,IAAI,CAAA;QAElB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,GAAG,EAAE,CAAA;YAClB,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,SAAS,EAA+E,CAAA;YAC5G,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM,CAAC,qCAAqC;YAC9D,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAA0B,CAAA;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,OAAO,CAAC,KAAK,GAAG,EAAE,CAAA;QACpB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,QAAQ,EAAE,CAAA;AACnB,CAAC"}

package/dist/runtime/composables/use-content.d.ts

@@ -0,0 +1,51 @@
+import type { ContentItem, ContentMeta } from '../../types/content.js';
+export declare class QueryBuilder {
+    private _prefix;
+    private _predicates;
+    private _sortField;
+    private _sortDir;
+    private _limit;
+    private _skip;
+    constructor(prefix?: string);
+    /** Filter results by a predicate. Receives a fully-typed `ContentMeta`. */
+    where(predicate: (doc: ContentMeta) => boolean): this;
+    /** Sort by a frontmatter field. Defaults to ascending order. */
+    sortBy(field: string, dir?: 'asc' | 'desc'): this;
+    /** Cap the result count. */
+    limit(n: number): this;
+    /** Skip the first `n` results (for pagination). */
+    skip(n: number): this;
+    /** Returns all matching `ContentMeta` items (no body loaded). */
+    find(): Promise<ContentMeta[]>;
+    /** Returns the count of matching documents (no body loaded). */
+    count(): Promise<number>;
+    /**
+     * Returns the full `ContentItem` (body + toc) for the first matching document.
+     * When a `_path` prefix is provided and no predicates/sort/pagination are set,
+     * this fetches the single document directly by path.
+     */
+    first(): Promise<ContentItem | null>;
+    private _applyFilters;
+}
+/**
+ * Content query composable.
+ *
+ * Returns a `QueryBuilder` scoped to the given `_path` prefix. Chain filter,
+ * sort, and pagination methods before calling a terminal method
+ * (`.find()`, `.first()`, or `.count()`).
+ *
+ * @example
+ * ```ts
+ * // Single document
+ * const doc = await queryContent('/blog/hello').first()
+ *
+ * // Listing — no body loaded
+ * const posts = await queryContent('/blog')
+ *   .where(doc => !doc.draft)
+ *   .sortBy('date', 'desc')
+ *   .limit(10)
+ *   .find()
+ * ```
+ */
+export declare function queryContent(path?: string): QueryBuilder;
+//# sourceMappingURL=use-content.d.ts.map

package/dist/runtime/composables/use-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-content.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/use-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAKtE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAoB;gBAErB,MAAM,CAAC,EAAE,MAAM;IAI3B,2EAA2E;IAC3E,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,IAAI;IAKrD,gEAAgE;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAMxD,4BAA4B;IAC5B,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,mDAAmD;IACnD,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrB,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKpC,gEAAgE;IAC1D,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAmB1C,OAAO,CAAC,aAAa;CA2CtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAExD"}

package/dist/runtime/composables/use-content.js

@@ -0,0 +1,127 @@
+import { ContentClient } from '../content/client.js';
+// ─── QueryBuilder ─────────────────────────────────────────────────────────────
+export class QueryBuilder {
+    _prefix;
+    _predicates = [];
+    _sortField;
+    _sortDir = 'asc';
+    _limit;
+    _skip;
+    constructor(prefix) {
+        this._prefix = prefix;
+    }
+    /** Filter results by a predicate. Receives a fully-typed `ContentMeta`. */
+    where(predicate) {
+        this._predicates.push(predicate);
+        return this;
+    }
+    /** Sort by a frontmatter field. Defaults to ascending order. */
+    sortBy(field, dir = 'asc') {
+        this._sortField = field;
+        this._sortDir = dir;
+        return this;
+    }
+    /** Cap the result count. */
+    limit(n) {
+        this._limit = n;
+        return this;
+    }
+    /** Skip the first `n` results (for pagination). */
+    skip(n) {
+        this._skip = n;
+        return this;
+    }
+    /** Returns all matching `ContentMeta` items (no body loaded). */
+    async find() {
+        const manifest = await ContentClient.getManifest();
+        return this._applyFilters(manifest);
+    }
+    /** Returns the count of matching documents (no body loaded). */
+    async count() {
+        const manifest = await ContentClient.getManifest();
+        return this._applyFilters(manifest).length;
+    }
+    /**
+     * Returns the full `ContentItem` (body + toc) for the first matching document.
+     * When a `_path` prefix is provided and no predicates/sort/pagination are set,
+     * this fetches the single document directly by path.
+     */
+    async first() {
+        // Fast path: no filters, no sort, no pagination — fetch directly by path
+        if (this._prefix !== undefined &&
+            this._predicates.length === 0 &&
+            this._sortField === undefined &&
+            this._limit === undefined &&
+            this._skip === undefined) {
+            return ContentClient.getItem(this._prefix);
+        }
+        // Slow path: apply filters on the manifest, then fetch the first match
+        const manifest = await ContentClient.getManifest();
+        const filtered = this._applyFilters(manifest);
+        if (filtered.length === 0)
+            return null;
+        return ContentClient.getItem(filtered[0]._path);
+    }
+    _applyFilters(items) {
+        let result = items;
+        // Prefix filter
+        if (this._prefix !== undefined) {
+            const p = this._prefix;
+            result = result.filter((doc) => doc._path === p || doc._path.startsWith(p + '/'));
+        }
+        // Where predicates
+        for (const pred of this._predicates) {
+            result = result.filter(pred);
+        }
+        // Sort
+        if (this._sortField !== undefined) {
+            const field = this._sortField;
+            const dir = this._sortDir;
+            result = [...result].sort((a, b) => {
+                const av = a[field];
+                const bv = b[field];
+                if (av === undefined && bv === undefined)
+                    return 0;
+                if (av === undefined)
+                    return 1;
+                if (bv === undefined)
+                    return -1;
+                const cmp = av < bv ? -1 : av > bv ? 1 : 0;
+                return dir === 'asc' ? cmp : -cmp;
+            });
+        }
+        // Skip
+        if (this._skip !== undefined) {
+            result = result.slice(this._skip);
+        }
+        // Limit
+        if (this._limit !== undefined) {
+            result = result.slice(0, this._limit);
+        }
+        return result;
+    }
+}
+/**
+ * Content query composable.
+ *
+ * Returns a `QueryBuilder` scoped to the given `_path` prefix. Chain filter,
+ * sort, and pagination methods before calling a terminal method
+ * (`.find()`, `.first()`, or `.count()`).
+ *
+ * @example
+ * ```ts
+ * // Single document
+ * const doc = await queryContent('/blog/hello').first()
+ *
+ * // Listing — no body loaded
+ * const posts = await queryContent('/blog')
+ *   .where(doc => !doc.draft)
+ *   .sortBy('date', 'desc')
+ *   .limit(10)
+ *   .find()
+ * ```
+ */
+export function queryContent(path) {
+    return new QueryBuilder(path);
+}
+//# sourceMappingURL=use-content.js.map

package/dist/runtime/composables/use-content.js.map

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

package/dist/runtime/content/client.d.ts

@@ -0,0 +1,20 @@
+import type { ContentItem, ContentMeta } from '../../types/content.js';
+/** Returns the full URL for the search index (includes router.base prefix). */
+export declare function contentSearchIndexUrl(): string;
+/**
+ * Low-level content data access layer. Used by `queryContent()`.
+ *
+ * Resolution strategy:
+ * - **Server (dev + SSG build-time)**: reads from `globalThis.__CER_CONTENT_STORE__`
+ *   populated by the `cerContent()` Vite plugin's `buildStart` hook.
+ * - **Server (production SSR runtime)**: `__CER_CONTENT_STORE__` is absent (no
+ *   Vite build process at runtime), so falls back to `node:fs` reads from
+ *   `dist/_content/`.
+ * - **Client (SPA / browser navigation)**: lazy-fetches `/_content/manifest.json`
+ *   once (cached) for listing; fetches `/_content/[path].json` per `.first()`.
+ */
+export declare const ContentClient: {
+    getManifest(): Promise<ContentMeta[]>;
+    getItem(path: string): Promise<ContentItem | null>;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/runtime/content/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/runtime/content/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AA0BtE,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAyBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;mBACH,OAAO,CAAC,WAAW,EAAE,CAAC;kBAiDvB,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CAmDzD,CAAA"}

package/dist/runtime/content/client.js

@@ -0,0 +1,163 @@
+// ─── Types ─────────────────────────────────────────────────────────────────────
+/** Reads `router.base` from `virtual:cer-app-config` at module initialisation. */
+let _base = '';
+try {
+    // Dynamic import is not viable for a module-level side effect, so we read from
+    // globalThis where the virtual module writes it during app bootstrap.
+    const g = globalThis;
+    const appConfig = g['__CER_APP_CONFIG__'];
+    _base = appConfig?.router?.base ?? '';
+    // Normalise: strip trailing slash, keep empty string for no base
+    if (_base === '/')
+        _base = '';
+}
+catch {
+    _base = '';
+}
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+function contentPathToJsonFile(path) {
+    if (path === '/')
+        return 'index.json';
+    return path.slice(1) + '.json';
+}
+/** Returns the full URL for the search index (includes router.base prefix). */
+export function contentSearchIndexUrl() {
+    return `${_base}/_content/search-index.json`;
+}
+// ─── Lazy manifest cache ──────────────────────────────────────────────────────
+let _manifestPromise = null;
+function fetchManifest() {
+    if (_manifestPromise)
+        return _manifestPromise;
+    _manifestPromise = fetch(`${_base}/_content/manifest.json`).then((r) => {
+        if (!r.ok)
+            throw new Error(`Failed to fetch content manifest: ${r.status}`);
+        return r.json();
+    });
+    return _manifestPromise;
+}
+// ─── Server-side production caches ───────────────────────────────────────────
+// In production SSR the Vite build process is not running, so __CER_CONTENT_STORE__
+// is absent.  We cache the manifest and per-document reads here to avoid repeated
+// disk I/O on every request — critical at 10k+ pages where manifest.json is ~2MB.
+let _ssrManifest = null;
+const _ssrItemCache = new Map();
+// ─── ContentClient ────────────────────────────────────────────────────────────
+/**
+ * Low-level content data access layer. Used by `queryContent()`.
+ *
+ * Resolution strategy:
+ * - **Server (dev + SSG build-time)**: reads from `globalThis.__CER_CONTENT_STORE__`
+ *   populated by the `cerContent()` Vite plugin's `buildStart` hook.
+ * - **Server (production SSR runtime)**: `__CER_CONTENT_STORE__` is absent (no
+ *   Vite build process at runtime), so falls back to `node:fs` reads from
+ *   `dist/_content/`.
+ * - **Client (SPA / browser navigation)**: lazy-fetches `/_content/manifest.json`
+ *   once (cached) for listing; fetches `/_content/[path].json` per `.first()`.
+ */
+export const ContentClient = {
+    async getManifest() {
+        const g = globalThis;
+        // Server: in-memory store (dev + SSG build-time rendering)
+        const store = g['__CER_CONTENT_STORE__'];
+        if (store) {
+            return store.map((item) => {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                const { _file, body, toc, excerpt, ...meta } = item;
+                return meta;
+            });
+        }
+        // Server: production SSR runtime — resolve content files from the app root.
+        // The preview CLI sets process.env.__CER_APP_ROOT__ to the project root before
+        // loading the server bundle. Content files are written to dist/server/_content/
+        // and dist/client/_content/ by cerContent's closeBundle hook.
+        // _ssrManifest is a module-level cache — populated once and reused for the
+        // lifetime of the process so manifest.json is only read and parsed once at scale.
+        if (typeof window === 'undefined' && typeof process !== 'undefined') {
+            if (_ssrManifest)
+                return _ssrManifest;
+            try {
+                const { readFileSync, existsSync } = await import('node:fs');
+                const { join } = await import('node:path');
+                const appRoot = process.env.__CER_APP_ROOT__ ?? process.cwd();
+                const candidates = [
+                    join(appRoot, 'dist', 'server', '_content', 'manifest.json'),
+                    join(appRoot, 'dist', 'client', '_content', 'manifest.json'),
+                    join(appRoot, 'dist', '_content', 'manifest.json'),
+                ];
+                for (const p of candidates) {
+                    if (!existsSync(p))
+                        continue;
+                    try {
+                        const raw = readFileSync(p, 'utf-8');
+                        _ssrManifest = JSON.parse(raw);
+                        return _ssrManifest;
+                    }
+                    catch { /* try next */ }
+                }
+                _ssrManifest = [];
+                return _ssrManifest;
+            }
+            catch {
+                return [];
+            }
+        }
+        // Client: fetch manifest (cached)
+        return fetchManifest();
+    },
+    async getItem(path) {
+        const g = globalThis;
+        // Server: in-memory store
+        const store = g['__CER_CONTENT_STORE__'];
+        if (store) {
+            return store.find((item) => item._path === path) ?? null;
+        }
+        // Server: production SSR runtime — see getManifest() for path resolution strategy.
+        // _ssrItemCache is a module-level Map so each document is read and parsed at
+        // most once per process lifetime, regardless of how many concurrent requests
+        // ask for the same path.
+        if (typeof window === 'undefined' && typeof process !== 'undefined') {
+            if (_ssrItemCache.has(path))
+                return _ssrItemCache.get(path) ?? null;
+            try {
+                const { readFileSync, existsSync } = await import('node:fs');
+                const { join } = await import('node:path');
+                const appRoot = process.env.__CER_APP_ROOT__ ?? process.cwd();
+                const jsonFile = contentPathToJsonFile(path);
+                const candidates = [
+                    join(appRoot, 'dist', 'server', '_content', jsonFile),
+                    join(appRoot, 'dist', 'client', '_content', jsonFile),
+                    join(appRoot, 'dist', '_content', jsonFile),
+                ];
+                for (const p of candidates) {
+                    if (!existsSync(p))
+                        continue;
+                    try {
+                        const raw = readFileSync(p, 'utf-8');
+                        const item = JSON.parse(raw);
+                        _ssrItemCache.set(path, item);
+                        return item;
+                    }
+                    catch { /* try next */ }
+                }
+                _ssrItemCache.set(path, null);
+                return null;
+            }
+            catch {
+                return null;
+            }
+        }
+        // Client: fetch individual document
+        const jsonFile = contentPathToJsonFile(path);
+        try {
+            const res = await fetch(`${_base}/_content/${jsonFile}`);
+            if (!res.ok)
+                return null;
+            return (await res.json());
+        }
+        catch {
+            return null;
+        }
+    },
+};
+//# sourceMappingURL=client.js.map

package/dist/runtime/content/client.js.map

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

package/dist/types/config.d.ts

@@ -204,6 +204,8 @@ export interface RuntimeConfig {
 export interface CerAppConfig {
     mode?: 'spa' | 'ssr' | 'ssg';
     srcDir?: string;
+    /** File-based content layer configuration. Reads from `content/` at the project root by default. */
+    content?: import('./content.js').CerContentConfig;
     /**
      * Internationalisation (i18n) routing configuration.
      * When set, the framework generates locale-aware URL routes and enables `useLocale()`.

package/dist/types/config.d.ts.map

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

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAwUA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AA0UA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/types/content.d.ts

@@ -0,0 +1,63 @@
+/** Heading extracted from Markdown during parsing. The `id` is slugified from the heading text and added as an HTML `id` attribute. */
+export interface ContentHeading {
+    depth: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Slugified heading text — matches the `id` attribute in the rendered body HTML. */
+    id: string;
+    /** Plain text of the heading. */
+    text: string;
+}
+/**
+ * Lean per-document metadata — returned by `.find()` and `.count()`.
+ * Kept small deliberately: no `body`, no `toc`, no `excerpt`.
+ * Use `description` for listing previews; set it in frontmatter.
+ */
+export interface ContentMeta {
+    /** URL path (e.g. `"/blog/hello"`). */
+    _path: string;
+    /** Source file type. */
+    _type: 'markdown' | 'json';
+    title?: string;
+    /** Use for listing previews — included in search index. */
+    description?: string;
+    date?: string;
+    draft?: boolean;
+    /** Any other frontmatter key. */
+    [key: string]: unknown;
+}
+/**
+ * Full document — returned by `.first()`.
+ * Superset of `ContentMeta`; includes `body`, `toc`, `_file`, and optional `excerpt`.
+ */
+export interface ContentItem extends ContentMeta {
+    /** Relative path from `content/` at the project root (e.g. `"blog/hello.md"`). */
+    _file: string;
+    /** Rendered HTML (Markdown) or the raw file contents (JSON files). */
+    body: string;
+    /** Extracted headings. Empty array for JSON files. */
+    toc: ContentHeading[];
+    /** HTML content before `<!-- more -->`. Absent when the marker is not present. */
+    excerpt?: string;
+}
+/**
+ * Search result item returned by `useContentSearch()`.
+ * Contains only the MiniSearch stored fields: `_path`, `title`, `description`.
+ */
+export interface ContentSearchResult {
+    _path: string;
+    title: string;
+    description?: string;
+}
+/** Content layer configuration. Controls the directory and draft behaviour. */
+export interface CerContentConfig {
+    /**
+     * Content directory relative to the project root. Defaults to `'content'`,
+     * which resolves to `{root}/content/` — at the same level as `app/`, `server/`, and `public/`.
+     */
+    dir?: string;
+    /**
+     * When `true`, draft items (`draft: true` in frontmatter) are included in
+     * production builds. Defaults to `false`.
+     */
+    drafts?: boolean;
+}
+//# sourceMappingURL=content.d.ts.map

package/dist/types/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA,uIAAuI;AACvI,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,wBAAwB;IACxB,KAAK,EAAE,UAAU,GAAG,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,iCAAiC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,GAAG,EAAE,cAAc,EAAE,CAAA;IACrB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB"}