@glw907/cairn-cms 0.6.0-rc.1 → 0.7.0

package/dist/components/EditPage.svelte

@@ -21,10 +21,10 @@ markdown editor and a live, design-accurate preview. The whole surface is one fo
     /** Carta preview plugins from the adapter, for the design-accurate preview. */
     preview?: unknown[];
     /** The site's design-accurate render pipeline; the preview pane sanitizes its output. */
-    renderPreview?: (md: string) => string | Promise<string>;
+    render?: (md: string, opts?: { stagger?: boolean }) => string | Promise<string>;
   }
 
-  let { data, registry, preview = [], renderPreview }: Props = $props();
+  let { data, registry, preview = [], render }: Props = $props();
 
   // `body` is local editor state seeded once from the prop; it diverges as the user types.
   // untrack() captures the initial value without subscribing to future prop changes.
@@ -48,15 +48,15 @@ markdown editor and a live, design-accurate preview. The whole surface is one fo
   // Render the design-accurate preview as the body changes, debounced, and sanitize before the DOM.
   // The sanitize is the one barrier between editor-authored markdown and the page (Carta is unsanitized).
   // previewRun is a plain counter (not reactive state) used as a latest-wins guard: if a slow earlier
-  // async renderPreview call resolves after a newer one has started, the stale result is discarded.
+  // async render call resolves after a newer one has started, the stale result is discarded.
   let previewRun = 0;
   $effect(() => {
-    if (!showPreview || !renderPreview) return;
+    if (!showPreview || !render) return;
     const md = body;
     const run = ++previewRun;
     const handle = setTimeout(async () => {
       try {
-        const html = await renderPreview(md);
+        const html = await render(md);
         const safe = await sanitizePreviewHtml(html);
         if (run === previewRun) previewHtml = safe;
       } catch {

package/dist/components/EditPage.svelte.d.ts

@@ -10,7 +10,9 @@ interface Props {
     /** Carta preview plugins from the adapter, for the design-accurate preview. */
     preview?: unknown[];
     /** The site's design-accurate render pipeline; the preview pane sanitizes its output. */
-    renderPreview?: (md: string) => string | Promise<string>;
+    render?: (md: string, opts?: {
+        stagger?: boolean;
+    }) => string | Promise<string>;
 }
 /**
  * The differentiated editor: the per-concept frontmatter form (from `data.fields`) beside the Carta

package/dist/components/EditPage.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditPage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/EditPage.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK7D,UAAU,KAAK;IACb,gEAAgE;IAChE,IAAI,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,yFAAyF;IACzF,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1D;AAqJH;;;;GAIG;AACH,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"EditPage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/EditPage.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK7D,UAAU,KAAK;IACb,gEAAgE;IAChE,IAAI,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,yFAAyF;IACzF,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjF;AAqJH;;;;GAIG;AACH,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/content/compose.js

@@ -22,7 +22,7 @@ export function composeRuntime(adapter, extensions = []) {
         concepts: normalizeConcepts(content),
         backend: adapter.backend,
         sender: adapter.sender,
-        renderPreview: adapter.renderPreview,
+        render: adapter.render,
         registry: adapter.registry,
         navMenu: adapter.navMenu,
         assets: adapter.assets,

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

@@ -1 +1 @@
-{"version":3,"file":"concepts.d.ts","sourceRoot":"","sources":["../../src/lib/content/concepts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAGjE,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,EAClD,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAmB,GAC/D,iBAAiB,EAAE,CAcrB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,SAAS,CAE/B"}
+{"version":3,"file":"concepts.d.ts","sourceRoot":"","sources":["../../src/lib/content/concepts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAGjE,CAAC;AAeF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,EAClD,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAmB,GAC/D,iBAAiB,EAAE,CAerB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,SAAS,CAE/B"}

package/dist/content/concepts.js

@@ -13,6 +13,10 @@ const DEFAULT_ROUTING = { routable: true, dated: false, inFeeds: false };
 function defaultLabel(id) {
     return id.charAt(0).toUpperCase() + id.slice(1);
 }
+/** The default permalink pattern: Pages live at the root, other concepts under their id. */
+function defaultPermalink(id) {
+    return id === 'pages' ? '/:slug' : `/${id}/:slug`;
+}
 /**
  * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each declared
  * key under `content` becomes one descriptor; an undeclared (`undefined`) concept is
@@ -29,6 +33,7 @@ export function normalizeConcepts(content, routing = CONCEPT_ROUTING) {
             label: config.label ?? defaultLabel(id),
             dir: config.dir,
             routing: routing[id] ?? DEFAULT_ROUTING,
+            permalink: config.permalink ?? defaultPermalink(id),
             fields: config.fields,
             validate: config.validate,
         });

package/dist/content/permalink.d.ts

@@ -0,0 +1,11 @@
+import type { ConceptDescriptor } from './types.js';
+/**
+ * Resolve an entry's canonical path from its concept's permalink pattern. Throws when the
+ * pattern uses a date token and the entry has no valid date, or when a token is unknown, so
+ * a misconfiguration fails at build rather than emitting a broken path.
+ */
+export declare function permalink(descriptor: ConceptDescriptor, entry: {
+    id: string;
+    date?: string;
+}): string;
+//# sourceMappingURL=permalink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permalink.d.ts","sourceRoot":"","sources":["../../src/lib/content/permalink.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWpD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAgBR"}

package/dist/content/permalink.js

@@ -0,0 +1,30 @@
+function pad(n) {
+    return String(n).padStart(2, '0');
+}
+function dateParts(date) {
+    const match = date?.match(/^(\d{4})-(\d{2})-(\d{2})/);
+    return match ? { year: match[1], month: match[2], day: match[3] } : null;
+}
+/**
+ * Resolve an entry's canonical path from its concept's permalink pattern. Throws when the
+ * pattern uses a date token and the entry has no valid date, or when a token is unknown, so
+ * a misconfiguration fails at build rather than emitting a broken path.
+ */
+export function permalink(descriptor, entry) {
+    return descriptor.permalink.replace(/:(\w+)/g, (_match, token) => {
+        if (token === 'slug')
+            return entry.id;
+        if (token === 'year' || token === 'month' || token === 'day') {
+            const parts = dateParts(entry.date);
+            if (!parts) {
+                throw new Error(`permalink: concept "${descriptor.id}" pattern uses :${token}, but entry "${entry.id}" has no valid date`);
+            }
+            if (token === 'year')
+                return parts.year;
+            if (token === 'month')
+                return pad(Number(parts.month));
+            return pad(Number(parts.day));
+        }
+        throw new Error(`permalink: unknown token :${token} in pattern "${descriptor.permalink}"`);
+    });
+}

package/dist/content/types.d.ts

@@ -68,6 +68,13 @@ export interface ConceptConfig {
     fields: FrontmatterField[];
     /** Validate submitted frontmatter before any commit. */
     validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
+    /**
+     * Public URL pattern for this concept, a `/`-prefixed string of literal segments and the
+     * tokens `:slug`, `:year`, `:month`, `:day`. `normalizeConcepts` fills a per-concept
+     * default when omitted (`/:slug` for Pages, `/<conceptId>/:slug` otherwise). The pattern
+     * must agree with the site's filesystem route directory.
+     */
+    permalink?: string;
 }
 /** The GitHub App backend a site reads from and commits to (spec §8). Plain data the GitHub engine (Plan 03) consumes. */
 export interface BackendConfig {
@@ -114,8 +121,10 @@ export interface CairnAdapter {
     };
     backend: BackendConfig;
     sender: SenderConfig;
-    /** Design-accurate preview: the same render pipeline the site ships. */
-    renderPreview(md: string): string | Promise<string>;
+    /** The site's one renderer: the editor preview and every public page call it (design decision 4). */
+    render(md: string, opts?: {
+        stagger?: boolean;
+    }): string | Promise<string>;
     /** Directive component registry; the renderer and the future palette derive from it (seam 3). */
     registry?: ComponentRegistry;
     navMenu?: NavMenuConfig;
@@ -143,6 +152,8 @@ export interface ConceptDescriptor {
     label: string;
     dir: string;
     routing: RoutingRule;
+    /** The resolved permalink pattern, defaulted by `normalizeConcepts`. */
+    permalink: string;
     fields: FrontmatterField[];
     validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
 }
@@ -197,7 +208,10 @@ export interface CairnRuntime {
     concepts: ConceptDescriptor[];
     backend: BackendConfig;
     sender: SenderConfig;
-    renderPreview(md: string): string | Promise<string>;
+    /** The site's one renderer: the editor preview and every public page call it (design decision 4). */
+    render(md: string, opts?: {
+        stagger?: boolean;
+    }): string | Promise<string>;
     registry?: ComponentRegistry;
     navMenu?: NavMenuConfig;
     assets?: AssetConfig;

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

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

package/dist/delivery/content-index.d.ts

@@ -0,0 +1,46 @@
+import type { ConceptDescriptor } from '../content/types.js';
+/** A raw content file before parsing: the glob key and the file's full markdown text. */
+export interface RawFile {
+    path: string;
+    raw: string;
+}
+/** The cheap, plain-data view of one entry, for lists, feeds, and the sitemap. */
+export interface ContentSummary {
+    id: string;
+    permalink: string;
+    title: string;
+    date?: string;
+    updated?: string;
+    tags: string[];
+    excerpt: string;
+    wordCount: number;
+    draft: boolean;
+}
+/** The detail view: a summary plus the frontmatter and the body to render. */
+export interface ContentEntry extends ContentSummary {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+/** The per-concept query surface. */
+export interface ContentIndex {
+    all(opts?: {
+        includeDrafts?: boolean;
+    }): ContentSummary[];
+    byId(id: string): ContentEntry | undefined;
+    byTag(tag: string, opts?: {
+        includeDrafts?: boolean;
+    }): ContentSummary[];
+    allTags(): {
+        tag: string;
+        count: number;
+    }[];
+    adjacent(id: string): {
+        newer?: ContentSummary;
+        older?: ContentSummary;
+    };
+}
+/** Map a Vite eager `?raw` glob record (`{ path: raw }`) to `RawFile[]`. */
+export declare function fromGlob(record: Record<string, string>): RawFile[];
+/** Build a concept's index from its raw files and normalized descriptor. */
+export declare function createContentIndex(files: RawFile[], descriptor: ConceptDescriptor): ContentIndex;
+//# sourceMappingURL=content-index.d.ts.map

package/dist/delivery/content-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/content-index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,EAAE,CAAC;IACzE,OAAO,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;CAC1E;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,EAAE,CAElE;AAqBD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,iBAAiB,GAAG,YAAY,CAyDhG"}

package/dist/delivery/content-index.js

@@ -0,0 +1,84 @@
+// cairn-cms: the per-concept content index (public-delivery design, decisions 1 and 5). It
+// takes raw files from a site's glob, parses them with the engine's own parseMarkdown, and
+// returns cheap plain-data summaries plus an on-demand detail lookup. It is concept-generic:
+// every operation reads the descriptor and its routing rule, never a hardcoded concept id.
+import { parseMarkdown } from '../content/frontmatter.js';
+import { idFromFilename } from '../content/ids.js';
+import { permalink } from '../content/permalink.js';
+import { deriveExcerpt, wordCount } from './excerpt.js';
+/** Map a Vite eager `?raw` glob record (`{ path: raw }`) to `RawFile[]`. */
+export function fromGlob(record) {
+    return Object.entries(record).map(([path, raw]) => ({ path, raw }));
+}
+function basename(path) {
+    const slash = path.lastIndexOf('/');
+    return slash >= 0 ? path.slice(slash + 1) : path;
+}
+function asString(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function asDate(value) {
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? undefined : value.toISOString().slice(0, 10);
+    if (typeof value === 'string')
+        return value.match(/^\d{4}-\d{2}-\d{2}/)?.[0];
+    return undefined;
+}
+function asTags(value) {
+    return Array.isArray(value) ? value.map(String) : [];
+}
+/** Build a concept's index from its raw files and normalized descriptor. */
+export function createContentIndex(files, descriptor) {
+    const entries = files.map((file) => {
+        const id = idFromFilename(basename(file.path));
+        const { frontmatter, body } = parseMarkdown(file.raw);
+        const date = asDate(frontmatter.date);
+        return {
+            id,
+            permalink: permalink(descriptor, { id, date }),
+            title: asString(frontmatter.title) ?? id,
+            date,
+            updated: asDate(frontmatter.updated),
+            tags: asTags(frontmatter.tags),
+            excerpt: deriveExcerpt(body, { description: asString(frontmatter.description) }),
+            wordCount: wordCount(body),
+            draft: frontmatter.draft === true,
+            frontmatter,
+            body,
+        };
+    });
+    // Dated concepts sort newest-first; undated concepts (Pages) sort by title.
+    const sorted = [...entries].sort((a, b) => descriptor.routing.dated ? (b.date ?? '').localeCompare(a.date ?? '') : a.title.localeCompare(b.title));
+    const summarize = (entry) => {
+        const { frontmatter: _frontmatter, body: _body, ...summary } = entry;
+        return summary;
+    };
+    const visible = (list, includeDrafts) => includeDrafts ? list : list.filter((entry) => !entry.draft);
+    return {
+        all: (opts = {}) => visible(sorted, opts.includeDrafts).map(summarize),
+        byId: (id) => entries.find((entry) => entry.id === id),
+        byTag: (tag, opts = {}) => visible(sorted, opts.includeDrafts)
+            .filter((entry) => entry.tags.includes(tag))
+            .map(summarize),
+        allTags: () => {
+            const counts = new Map();
+            for (const entry of sorted) {
+                if (entry.draft)
+                    continue;
+                for (const tag of entry.tags)
+                    counts.set(tag, (counts.get(tag) ?? 0) + 1);
+            }
+            return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => a.tag.localeCompare(b.tag));
+        },
+        adjacent: (id) => {
+            const list = visible(sorted, false);
+            const i = list.findIndex((entry) => entry.id === id);
+            if (i < 0)
+                return {};
+            return {
+                newer: i > 0 ? summarize(list[i - 1]) : undefined,
+                older: i < list.length - 1 ? summarize(list[i + 1]) : undefined,
+            };
+        },
+    };
+}

package/dist/delivery/excerpt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A plain-text excerpt. Returns a trimmed frontmatter `description` when present, else the
+ * stripped body cut at a word boundary near `maxChars` (default 200) with an ellipsis.
+ */
+export declare function deriveExcerpt(body: string, opts?: {
+    description?: string;
+    maxChars?: number;
+}): string;
+/** Count words in the stripped body. */
+export declare function wordCount(body: string): number;
+//# sourceMappingURL=excerpt.d.ts.map

package/dist/delivery/excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/excerpt.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAW1G;AAED,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/delivery/excerpt.js

@@ -0,0 +1,38 @@
+// cairn-cms: excerpt and word count for content summaries (public-delivery design, decision
+// 5). A light markdown strip keeps summaries cheap, so a list card, an og:description, and a
+// summary-mode feed read one derived excerpt without a full render.
+/** Reduce markdown to readable plain text: drop fenced code, images, and markup; unwrap inline
+ * code and links to their text; collapse whitespace. */
+function toPlainText(md) {
+    return md
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/`([^`]*)`/g, '$1')
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, ' ')
+        .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1')
+        .replace(/^\s{0,3}[#>]+\s*/gm, ' ')
+        .replace(/^\s{0,3}[-*+]\s+/gm, ' ')
+        .replace(/[*_~]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * A plain-text excerpt. Returns a trimmed frontmatter `description` when present, else the
+ * stripped body cut at a word boundary near `maxChars` (default 200) with an ellipsis.
+ */
+export function deriveExcerpt(body, opts = {}) {
+    const description = opts.description?.trim();
+    if (description)
+        return description;
+    const max = opts.maxChars ?? 200;
+    const text = toPlainText(body);
+    if (text.length <= max)
+        return text;
+    const cut = text.slice(0, max);
+    const lastSpace = cut.lastIndexOf(' ');
+    return `${(lastSpace > 0 ? cut.slice(0, lastSpace) : cut).trimEnd()}…`;
+}
+/** Count words in the stripped body. */
+export function wordCount(body) {
+    const text = toPlainText(body);
+    return text ? text.split(/\s+/).length : 0;
+}

package/dist/delivery/feeds.d.ts

@@ -0,0 +1,27 @@
+/** Feed channel metadata. URLs are absolute. */
+export interface FeedChannel {
+    title: string;
+    description: string;
+    siteUrl: string;
+    feedUrl: string;
+    language?: string;
+    author?: {
+        name: string;
+        email?: string;
+    };
+}
+/** One feed entry. `contentHtml` carries the rendered body for a full-content feed. */
+export interface FeedItem {
+    title: string;
+    url: string;
+    date: string;
+    updated?: string;
+    summary: string;
+    contentHtml?: string;
+    tags?: string[];
+}
+/** Build an RSS 2.0 document. */
+export declare function buildRssFeed(channel: FeedChannel, items: FeedItem[]): string;
+/** Build a JSON Feed 1.1 document. */
+export declare function buildJsonFeed(channel: FeedChannel, items: FeedItem[]): string;
+//# sourceMappingURL=feeds.d.ts.map

package/dist/delivery/feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/feeds.ts"],"names":[],"mappings":"AAKA,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAyBD,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAkC5E;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAwB7E"}

package/dist/delivery/feeds.js

@@ -0,0 +1,80 @@
+// cairn-cms: RSS and JSON Feed builders (public-delivery design). Pure functions over a
+// channel and a list of items, so they unit-test without a render or a network. The caller
+// (a template +server.ts shim) assembles items from the content index and passes absolute
+// URLs built from PUBLIC_ORIGIN.
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/** Make a string safe inside a CDATA section by splitting any `]]>` across two sections. */
+function cdataSafe(value) {
+    return value.replace(/]]>/g, ']]]]><![CDATA[>');
+}
+/** Format a YYYY-MM-DD (or ISO) string as an RFC-822 date in UTC, as RSS wants. */
+function rfc822(date) {
+    return new Date(`${date.slice(0, 10)}T00:00:00.000Z`).toUTCString();
+}
+/** Format a YYYY-MM-DD (or ISO) string as an ISO-8601 instant in UTC. */
+function iso(date) {
+    return new Date(`${date.slice(0, 10)}T00:00:00.000Z`).toISOString();
+}
+/** Build an RSS 2.0 document. */
+export function buildRssFeed(channel, items) {
+    const entries = items
+        .map((item) => {
+        const content = item.contentHtml ?? item.summary;
+        return [
+            '    <item>',
+            `      <title>${escapeXml(item.title)}</title>`,
+            `      <link>${escapeXml(item.url)}</link>`,
+            `      <guid isPermaLink="true">${escapeXml(item.url)}</guid>`,
+            `      <pubDate>${rfc822(item.date)}</pubDate>`,
+            `      <description>${escapeXml(item.summary)}</description>`,
+            // CDATA cannot contain `]]>`, so split that one sequence rather than escape the body.
+            `      <content:encoded><![CDATA[${cdataSafe(content)}]]></content:encoded>`,
+            '    </item>',
+        ].join('\n');
+    })
+        .join('\n');
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">',
+        '  <channel>',
+        `    <title>${escapeXml(channel.title)}</title>`,
+        `    <link>${escapeXml(channel.siteUrl)}</link>`,
+        `    <description>${escapeXml(channel.description)}</description>`,
+        channel.language ? `    <language>${escapeXml(channel.language)}</language>` : '',
+        `    <atom:link href="${escapeXml(channel.feedUrl)}" rel="self" type="application/rss+xml" />`,
+        entries,
+        '  </channel>',
+        '</rss>',
+        '',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/** Build a JSON Feed 1.1 document. */
+export function buildJsonFeed(channel, items) {
+    return JSON.stringify({
+        version: 'https://jsonfeed.org/version/1.1',
+        title: channel.title,
+        description: channel.description,
+        home_page_url: channel.siteUrl,
+        feed_url: channel.feedUrl,
+        ...(channel.language ? { language: channel.language } : {}),
+        ...(channel.author ? { authors: [channel.author] } : {}),
+        items: items.map((item) => ({
+            id: item.url,
+            url: item.url,
+            title: item.title,
+            summary: item.summary,
+            date_published: iso(item.date),
+            ...(item.updated ? { date_modified: iso(item.updated) } : {}),
+            ...(item.contentHtml ? { content_html: item.contentHtml } : { content_text: item.summary }),
+            ...(item.tags && item.tags.length ? { tags: item.tags } : {}),
+        })),
+    }, null, 2);
+}

package/dist/delivery/paginate.d.ts

@@ -0,0 +1,13 @@
+/** A page of items plus its navigation state. */
+export interface Page<T> {
+    items: T[];
+    page: number;
+    perPage: number;
+    total: number;
+    totalPages: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+}
+/** Slice `items` into the 1-based `page` of size `perPage`, clamping the page into bounds. */
+export declare function paginate<T>(items: T[], page: number, perPage: number): Page<T>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/delivery/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/paginate.ts"],"names":[],"mappings":"AAGA,iDAAiD;AACjD,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAgB9E"}

package/dist/delivery/paginate.js

@@ -0,0 +1,20 @@
+// cairn-cms: pagination helper (public-delivery design). Pure slice math; the template renders
+// the controls. An out-of-range page clamps into bounds.
+/** Slice `items` into the 1-based `page` of size `perPage`, clamping the page into bounds. */
+export function paginate(items, page, perPage) {
+    const total = items.length;
+    // A non-positive page size would make totalPages Infinity, so clamp it to one.
+    const size = Math.max(1, Math.floor(perPage) || 1);
+    const totalPages = Math.max(1, Math.ceil(total / size));
+    const current = Math.min(Math.max(1, Math.floor(page) || 1), totalPages);
+    const start = (current - 1) * size;
+    return {
+        items: items.slice(start, start + size),
+        page: current,
+        perPage: size,
+        total,
+        totalPages,
+        hasPrev: current > 1,
+        hasNext: current < totalPages,
+    };
+}

package/dist/delivery/robots.d.ts

@@ -0,0 +1,6 @@
+/** Build a robots.txt body. */
+export declare function buildRobots(opts: {
+    sitemapUrl: string;
+    disallow?: string[];
+}): string;
+//# sourceMappingURL=robots.d.ts.map

package/dist/delivery/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/robots.ts"],"names":[],"mappings":"AAGA,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAKrF"}

package/dist/delivery/robots.js

@@ -0,0 +1,10 @@
+// cairn-cms: robots.txt builder (public-delivery design). A permissive default that points
+// at the sitemap, with optional disallow rules.
+/** Build a robots.txt body. */
+export function buildRobots(opts) {
+    const lines = ['User-agent: *', 'Allow: /'];
+    for (const path of opts.disallow ?? [])
+        lines.push(`Disallow: ${path}`);
+    lines.push('', `Sitemap: ${opts.sitemapUrl}`, '');
+    return lines.join('\n');
+}

package/dist/delivery/seo.d.ts

@@ -0,0 +1,34 @@
+/** Inputs for the head. All URLs are absolute (built from PUBLIC_ORIGIN). */
+export interface SeoInput {
+    title: string;
+    description: string;
+    canonicalUrl: string;
+    siteName: string;
+    type?: 'website' | 'article';
+    published?: string;
+    modified?: string;
+    feeds?: {
+        rss?: string;
+        json?: string;
+    };
+    image?: string;
+}
+/** Plain-data head: a title, meta tags, link tags, and one JSON-LD object. */
+export interface SeoMeta {
+    title: string;
+    meta: {
+        name?: string;
+        property?: string;
+        content: string;
+    }[];
+    links: {
+        rel: string;
+        type?: string;
+        href: string;
+        title?: string;
+    }[];
+    jsonLd: Record<string, unknown>;
+}
+/** Build the head data for a page. */
+export declare function buildSeoMeta(input: SeoInput): SeoMeta;
+//# sourceMappingURL=seo.d.ts.map

package/dist/delivery/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/seo.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CA6CrD"}