@glw907/cairn-cms 0.6.0 → 0.8.0

package/dist/components/ConceptList.svelte

@@ -17,9 +17,14 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   let title = $state('');
   let slug = $state('');
   let slugEdited = $state(false);
+  // Default the date client-side so the SSR pass and hydration agree across UTC midnight.
+  let dateDefault = $state('');
+  $effect(() => {
+    dateDefault = new Date().toISOString().slice(0, 10);
+  });
 
   const derivedSlug = $derived(slugEdited ? slug : slugify(title));
-  const slugPlaceholder = $derived(data.dated ? '2026-05-my-entry' : 'about-us');
+  const slugPlaceholder = $derived(data.dated ? 'my-entry' : 'about-us');
 </script>
 
 <header class="mb-4 flex items-center justify-between">
@@ -58,14 +63,13 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   <h2 class="text-sm font-semibold">New entry</h2>
   <label class="flex flex-col gap-1">
     <span class="text-sm font-medium">Title</span>
-    <input class="input" name="title" aria-label="Title" bind:value={title} required />
+    <input class="input" name="title" bind:value={title} required />
   </label>
   <label class="flex flex-col gap-1">
     <span class="text-sm font-medium">Slug</span>
     <input
       class="input"
       name="slug"
-      aria-label="Slug"
       placeholder={slugPlaceholder}
       value={derivedSlug}
       oninput={(e) => { slugEdited = true; slug = e.currentTarget.value; }}
@@ -74,7 +78,7 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   {#if data.dated}
     <label class="flex flex-col gap-1">
       <span class="text-sm font-medium">Date</span>
-      <input class="input" type="date" name="date" aria-label="Date" />
+      <input class="input" type="date" name="date" value={dateDefault} />
     </label>
   {/if}
   <button type="submit" class="btn btn-primary self-start">Create</button>

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

@@ -1 +1 @@
-{"version":3,"file":"ConceptList.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ConceptList.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG7D,UAAU,KAAK;IACb,qFAAqF;IACrF,IAAI,EAAE,QAAQ,CAAC;CAChB;AAsEH;;;GAGG;AACH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ConceptList.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ConceptList.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG7D,UAAU,KAAK;IACb,qFAAqF;IACrF,IAAI,EAAE,QAAQ,CAAC;CAChB;AA2EH;;;GAGG;AACH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

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.d.ts

@@ -1,7 +1,7 @@
-import type { CairnAdapter, CairnExtension, CairnRuntime } from './types.js';
+import type { CairnAdapter, CairnExtension, CairnRuntime, ConceptUrlPolicy } from './types.js';
 /**
  * Fold an adapter and any extensions into the composed runtime (seam 2). Extension concepts
  * merge after the adapter's. The asset slot (seam 4) passes through untouched.
  */
-export declare function composeRuntime(adapter: CairnAdapter, extensions?: CairnExtension[]): CairnRuntime;
+export declare function composeRuntime(adapter: CairnAdapter, extensions?: CairnExtension[], urlPolicy?: Record<string, ConceptUrlPolicy | undefined>): CairnRuntime;
 //# sourceMappingURL=compose.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/lib/content/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,YAAY,EAAE,cAAc,EAAE,YAAY,EAA+B,MAAM,YAAY,CAAC;AAGtH;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,cAAc,EAAO,GAChC,YAAY,CAuBd"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/lib/content/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,YAAY,EAAE,cAAc,EAAE,YAAY,EAAiB,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAGxI;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,cAAc,EAAO,EACjC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAM,GAC3D,YAAY,CAuBd"}

package/dist/content/compose.js

@@ -3,7 +3,7 @@ import { normalizeConcepts } from './concepts.js';
  * Fold an adapter and any extensions into the composed runtime (seam 2). Extension concepts
  * merge after the adapter's. The asset slot (seam 4) passes through untouched.
  */
-export function composeRuntime(adapter, extensions = []) {
+export function composeRuntime(adapter, extensions = [], urlPolicy = {}) {
     const content = { ...adapter.content };
     const adminPanels = [];
     const fieldTypes = [];
@@ -19,10 +19,10 @@ export function composeRuntime(adapter, extensions = []) {
     }
     return {
         siteName: adapter.siteName,
-        concepts: normalizeConcepts(content),
+        concepts: normalizeConcepts(content, urlPolicy),
         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

@@ -1,4 +1,4 @@
-import type { ConceptConfig, ConceptDescriptor, RoutingRule } from './types.js';
+import type { ConceptConfig, ConceptDescriptor, ConceptUrlPolicy, RoutingRule } from './types.js';
 /**
  * Concept-fixed routing, keyed by concept id (spec §7.2). Posts are dated feed entries;
  * pages are plain navigable structure. Not in adapter config. A future Fragments adds one
@@ -6,12 +6,13 @@ import type { ConceptConfig, ConceptDescriptor, RoutingRule } from './types.js';
  */
 export declare const CONCEPT_ROUTING: Readonly<Record<string, RoutingRule>>;
 /**
- * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each declared
- * key under `content` becomes one descriptor; an undeclared (`undefined`) concept is
- * skipped. `routing` is injectable so a contract test can prove a new concept attaches
- * additively; production passes the default `CONCEPT_ROUTING`.
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). URL policy
+ * (`permalink`, `datePrefix`) comes from the YAML site-config, passed here as `urlPolicy` keyed by
+ * concept id; each value defaults when the YAML omits it (`/:slug` for Pages, `/<id>/:slug`
+ * otherwise; `datePrefix` defaults to `day`). `routing` is injectable so a contract test can prove
+ * a new concept attaches additively; production passes the default `CONCEPT_ROUTING`.
  */
-export declare function normalizeConcepts(content: Record<string, ConceptConfig | undefined>, routing?: Readonly<Record<string, RoutingRule>>): ConceptDescriptor[];
+export declare function normalizeConcepts(content: Record<string, ConceptConfig | undefined>, urlPolicy?: Record<string, ConceptUrlPolicy | undefined>, routing?: Readonly<Record<string, RoutingRule>>): ConceptDescriptor[];
 /** Look up a normalized concept by id, or undefined when the site does not enable it. */
 export declare function findConcept(concepts: ConceptDescriptor[], id: string): ConceptDescriptor | undefined;
 //# sourceMappingURL=concepts.d.ts.map

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,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElG;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAGjE,CAAC;AAeF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,EAClD,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAM,EAC5D,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAmB,GAC/D,iBAAiB,EAAE,CAiBrB;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,22 +13,30 @@ 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
- * skipped. `routing` is injectable so a contract test can prove a new concept attaches
- * additively; production passes the default `CONCEPT_ROUTING`.
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). URL policy
+ * (`permalink`, `datePrefix`) comes from the YAML site-config, passed here as `urlPolicy` keyed by
+ * concept id; each value defaults when the YAML omits it (`/:slug` for Pages, `/<id>/:slug`
+ * otherwise; `datePrefix` defaults to `day`). `routing` is injectable so a contract test can prove
+ * a new concept attaches additively; production passes the default `CONCEPT_ROUTING`.
  */
-export function normalizeConcepts(content, routing = CONCEPT_ROUTING) {
+export function normalizeConcepts(content, urlPolicy = {}, routing = CONCEPT_ROUTING) {
     const descriptors = [];
     for (const [id, config] of Object.entries(content)) {
         if (!config)
             continue;
+        const policy = urlPolicy[id] ?? {};
         descriptors.push({
             id,
             label: config.label ?? defaultLabel(id),
             dir: config.dir,
             routing: routing[id] ?? DEFAULT_ROUTING,
+            permalink: policy.permalink ?? defaultPermalink(id),
+            datePrefix: policy.datePrefix ?? 'day',
             fields: config.fields,
             validate: config.validate,
         });

package/dist/content/ids.d.ts

@@ -14,4 +14,18 @@ export declare function filenameFromId(id: string): string;
  * single hyphen; leading and trailing hyphens are trimmed.
  */
 export declare function slugify(title: string): string;
+/** Filename date-prefix granularity for a dated concept: the leading `YYYY[-MM[-DD]]-` on the stem. */
+export type DatePrefix = 'year' | 'month' | 'day';
+/**
+ * The URL slug for an id. A dated concept passes its `datePrefix` and the leading date prefix is
+ * stripped when present; a non-dated concept passes `null` and the id is returned verbatim. Only
+ * the leading prefix is removed, so a year-like tail (a post titled "2024 Recap") stays in the slug.
+ */
+export declare function slugFromId(id: string, datePrefix: DatePrefix | null): string;
+/**
+ * Compose a dated entry's id from a `YYYY-MM-DD` date, a date-free slug, and the concept's
+ * granularity: the date truncated to the granularity, a hyphen, then the slug. Throws on a
+ * malformed date so a bad create fails before touching git.
+ */
+export declare function composeDatedId(date: string, slug: string, datePrefix: DatePrefix): string;
 //# sourceMappingURL=ids.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/content/ids.ts"],"names":[],"mappings":"AAOA,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/content/ids.ts"],"names":[],"mappings":"AAOA,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,uGAAuG;AACvG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AASlD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAiBzF"}

package/dist/content/ids.js

@@ -31,3 +31,43 @@ export function slugify(title) {
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-+|-+$/g, '');
 }
+/** The leading date-prefix shape for each granularity. */
+const DATE_PREFIX_RE = {
+    year: /^\d{4}-/,
+    month: /^\d{4}-\d{2}-/,
+    day: /^\d{4}-\d{2}-\d{2}-/,
+};
+/**
+ * The URL slug for an id. A dated concept passes its `datePrefix` and the leading date prefix is
+ * stripped when present; a non-dated concept passes `null` and the id is returned verbatim. Only
+ * the leading prefix is removed, so a year-like tail (a post titled "2024 Recap") stays in the slug.
+ */
+export function slugFromId(id, datePrefix) {
+    if (!datePrefix)
+        return id;
+    return id.replace(DATE_PREFIX_RE[datePrefix], '');
+}
+/**
+ * Compose a dated entry's id from a `YYYY-MM-DD` date, a date-free slug, and the concept's
+ * granularity: the date truncated to the granularity, a hyphen, then the slug. Throws on a
+ * malformed date so a bad create fails before touching git.
+ */
+export function composeDatedId(date, slug, datePrefix) {
+    const m = date.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!m)
+        throw new Error(`composeDatedId: malformed date "${date}"`);
+    const [, year, month, day] = m;
+    let prefix;
+    switch (datePrefix) {
+        case 'year':
+            prefix = year;
+            break;
+        case 'month':
+            prefix = `${year}-${month}`;
+            break;
+        case 'day':
+            prefix = `${year}-${month}-${day}`;
+            break;
+    }
+    return `${prefix}-${slug}`;
+}

package/dist/content/permalink.d.ts

@@ -0,0 +1,12 @@
+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;
+    slug: 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,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,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.slug;
+        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

@@ -1,4 +1,5 @@
 import type { ComponentRegistry } from '../render/registry.js';
+import type { DatePrefix } from './ids.js';
 /** Common to every frontmatter field: the frontmatter key, the form label, and whether it is required. */
 interface FieldBase {
     /** Frontmatter key and form input name. */
@@ -69,6 +70,16 @@ export interface ConceptConfig {
     /** Validate submitted frontmatter before any commit. */
     validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
 }
+/**
+ * A concept's URL policy, set per concept in the YAML site-config (not the adapter). `permalink` is
+ * a `/`-prefixed pattern of literal segments and the tokens `:slug`, `:year`, `:month`, `:day`.
+ * `datePrefix` is the filename date-prefix granularity for a dated concept. Both default in
+ * `normalizeConcepts` when omitted.
+ */
+export interface ConceptUrlPolicy {
+    permalink?: string;
+    datePrefix?: DatePrefix;
+}
 /** The GitHub App backend a site reads from and commits to (spec §8). Plain data the GitHub engine (Plan 03) consumes. */
 export interface BackendConfig {
     owner: string;
@@ -114,8 +125,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 +156,10 @@ export interface ConceptDescriptor {
     label: string;
     dir: string;
     routing: RoutingRule;
+    /** The resolved permalink pattern, defaulted by `normalizeConcepts`. */
+    permalink: string;
+    /** Filename date-prefix granularity for a dated concept; resolved by `normalizeConcepts`. */
+    datePrefix: DatePrefix;
     fields: FrontmatterField[];
     validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
 }
@@ -197,7 +214,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,47 @@
+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;
+    slug: 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,IAAI,EAAE,MAAM,CAAC;IACb,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,CA2DhG"}

package/dist/delivery/content-index.js

@@ -0,0 +1,86 @@
+// 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, slugFromId } 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 slug = slugFromId(id, descriptor.routing.dated ? descriptor.datePrefix : null);
+        const { frontmatter, body } = parseMarkdown(file.raw);
+        const date = asDate(frontmatter.date);
+        return {
+            id,
+            slug,
+            permalink: permalink(descriptor, { id, slug, 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"}