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

package/dist/delivery/seo.js

@@ -0,0 +1,46 @@
+// cairn-cms: the SEO head builder (public-delivery design, decision 6). Returns plain data so
+// the template renders it inside <svelte:head>. It covers the universal, mechanical tags;
+// og:image art and richer JSON-LD types stay a template or plugin concern.
+/** Build the head data for a page. */
+export function buildSeoMeta(input) {
+    const type = input.type ?? 'website';
+    const meta = [
+        { name: 'description', content: input.description },
+        { property: 'og:title', content: input.title },
+        { property: 'og:description', content: input.description },
+        { property: 'og:type', content: type },
+        { property: 'og:url', content: input.canonicalUrl },
+        { property: 'og:site_name', content: input.siteName },
+        { name: 'twitter:card', content: input.image ? 'summary_large_image' : 'summary' },
+    ];
+    if (input.image) {
+        meta.push({ property: 'og:image', content: input.image });
+        meta.push({ name: 'twitter:image', content: input.image });
+    }
+    const links = [{ rel: 'canonical', href: input.canonicalUrl }];
+    if (input.feeds?.rss) {
+        links.push({ rel: 'alternate', type: 'application/rss+xml', href: input.feeds.rss, title: input.siteName });
+    }
+    if (input.feeds?.json) {
+        links.push({ rel: 'alternate', type: 'application/feed+json', href: input.feeds.json, title: input.siteName });
+    }
+    const jsonLd = type === 'article'
+        ? {
+            '@context': 'https://schema.org',
+            '@type': 'Article',
+            headline: input.title,
+            description: input.description,
+            url: input.canonicalUrl,
+            ...(input.published ? { datePublished: input.published } : {}),
+            ...(input.modified ? { dateModified: input.modified } : {}),
+            ...(input.image ? { image: input.image } : {}),
+        }
+        : {
+            '@context': 'https://schema.org',
+            '@type': 'WebSite',
+            name: input.siteName,
+            description: input.description,
+            url: input.canonicalUrl,
+        };
+    return { title: input.title, meta, links, jsonLd };
+}

package/dist/delivery/sitemap.d.ts

@@ -0,0 +1,8 @@
+/** One sitemap URL. `lastmod` is a YYYY-MM-DD date. */
+export interface SitemapUrl {
+    loc: string;
+    lastmod?: string;
+}
+/** Build a sitemap XML document from a list of URLs. */
+export declare function buildSitemap(urls: SitemapUrl[]): string;
+//# sourceMappingURL=sitemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/sitemap.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAcvD"}

package/dist/delivery/sitemap.js

@@ -0,0 +1,21 @@
+// cairn-cms: sitemap builder (public-delivery design). Pure over a URL list; the caller
+// derives the list from the content index and the routable concepts.
+function escapeXml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Build a sitemap XML document from a list of URLs. */
+export function buildSitemap(urls) {
+    const entries = urls
+        .map((url) => {
+        const lastmod = url.lastmod ? `\n    <lastmod>${escapeXml(url.lastmod)}</lastmod>` : '';
+        return `  <url>\n    <loc>${escapeXml(url.loc)}</loc>${lastmod}\n  </url>`;
+    })
+        .join('\n');
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+        entries,
+        '</urlset>',
+        '',
+    ].join('\n');
+}

package/dist/index.d.ts

@@ -25,4 +25,17 @@ export { appCredentials } from './github/credentials.js';
 export type { GithubKeyEnv } from './github/credentials.js';
 export { parseSiteConfig, extractMenu, setMenu, validateNavTree, MAX_NAV_NODES, NavValidationError, SiteConfigError, } from './nav/site-config.js';
 export type { NavNode, SiteConfig } from './nav/site-config.js';
+export { permalink } from './content/permalink.js';
+export { createContentIndex, fromGlob } from './delivery/content-index.js';
+export type { RawFile, ContentSummary, ContentEntry, ContentIndex, } from './delivery/content-index.js';
+export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
+export type { FeedChannel, FeedItem } from './delivery/feeds.js';
+export { buildSitemap } from './delivery/sitemap.js';
+export type { SitemapUrl } from './delivery/sitemap.js';
+export { buildRobots } from './delivery/robots.js';
+export { buildSeoMeta } from './delivery/seo.js';
+export type { SeoInput, SeoMeta } from './delivery/seo.js';
+export { paginate } from './delivery/paginate.js';
+export type { Page } from './delivery/paginate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EACL,OAAO,EACP,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EACL,eAAe,EACf,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -19,3 +19,14 @@ export { treeUrl, markdownFilesIn, listMarkdown, contentsUrl, readRaw, fileSha,
 export { appCredentials } from './github/credentials.js';
 // Nav tree and site-config helpers (Plan 06).
 export { parseSiteConfig, extractMenu, setMenu, validateNavTree, MAX_NAV_NODES, NavValidationError, SiteConfigError, } from './nav/site-config.js';
+// Public content delivery (public-delivery design): the query index, syndication, and
+// discovery surface that sites read. Pure builders plus the one permalink resolver; the
+// SvelteKit loaders live under the /sveltekit subpath.
+export { permalink } from './content/permalink.js';
+export { createContentIndex, fromGlob } from './delivery/content-index.js';
+export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
+export { buildSitemap } from './delivery/sitemap.js';
+export { buildRobots } from './delivery/robots.js';
+export { buildSeoMeta } from './delivery/seo.js';
+export { paginate } from './delivery/paginate.js';

package/dist/sveltekit/index.d.ts

@@ -7,4 +7,6 @@ export { createNavRoutes } from './nav-routes.js';
 export type { NavLoadData, NavPageOption, NavRoutesDeps } from './nav-routes.js';
 export { healthLoad, type HealthData } from './health.js';
 export type { RequestContext, CookieJar, HandleInput } from './types.js';
+export { createPublicRoutes } from './public-routes.js';
+export type { PublicRoutesDeps, ListData as PublicListData, TagData, TagIndexData, EntryData, } from './public-routes.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sveltekit/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,QAAQ,IAAI,cAAc,EAC1B,OAAO,EACP,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/sveltekit/index.js

@@ -6,3 +6,4 @@ export { createEditorRoutes } from './editors-routes.js';
 export { createContentRoutes } from './content-routes.js';
 export { createNavRoutes } from './nav-routes.js';
 export { healthLoad } from './health.js';
+export { createPublicRoutes } from './public-routes.js';

package/dist/sveltekit/public-routes.d.ts

@@ -0,0 +1,51 @@
+import type { ContentIndex, ContentSummary, ContentEntry } from '../delivery/content-index.js';
+/** Injected dependencies for the public loaders. */
+export interface PublicRoutesDeps {
+    index: ContentIndex;
+    render: (md: string, opts?: {
+        stagger?: boolean;
+    }) => string | Promise<string>;
+    origin: string;
+}
+/** The archive and tag list data: summaries the template renders. */
+export interface ListData {
+    entries: ContentSummary[];
+}
+/** A single tag's data plus the tag it filtered on. */
+export interface TagData extends ListData {
+    tag: string;
+}
+/** The tag-index data: every tag with its count. */
+export interface TagIndexData {
+    tags: {
+        tag: string;
+        count: number;
+    }[];
+}
+/** One entry's data: the detail entry, its rendered html, and its canonical URL. */
+export interface EntryData {
+    entry: ContentEntry;
+    html: string;
+    canonicalUrl: string;
+    newer?: ContentSummary;
+    older?: ContentSummary;
+}
+/** Build the public loaders for one concept's index. */
+export declare function createPublicRoutes(deps: PublicRoutesDeps): {
+    archiveLoad: () => ListData;
+    tagIndexLoad: () => TagIndexData;
+    tagLoad: (event: {
+        params: {
+            tag: string;
+        };
+    }) => TagData;
+    entryLoad: (event: {
+        params: {
+            slug: string;
+        };
+    }) => Promise<EntryData>;
+    entries: () => {
+        slug: string;
+    }[];
+};
+//# sourceMappingURL=public-routes.d.ts.map

package/dist/sveltekit/public-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE/F,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;uBAI/B,QAAQ;wBAKP,YAAY;qBAKb;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO;uBAQ7B;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,SAAS,CAAC;mBAc7D;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;EAKvC"}

package/dist/sveltekit/public-routes.js

@@ -0,0 +1,44 @@
+// cairn-cms: public route loaders (public-delivery design, decision 6). A factory closes over
+// a concept's index, the runtime render, and the origin, and returns thin load functions plus
+// entries() for prerender. A site route file stays a one-line shim. The index is built in site
+// code from a glob, so it stays in the prerender graph and out of the runtime Worker.
+import { error } from '@sveltejs/kit';
+/** Build the public loaders for one concept's index. */
+export function createPublicRoutes(deps) {
+    const { index, render, origin } = deps;
+    /** The chronological archive: every non-draft summary, newest-first. */
+    function archiveLoad() {
+        return { entries: index.all() };
+    }
+    /** All tags with counts, for a tag index page. */
+    function tagIndexLoad() {
+        return { tags: index.allTags() };
+    }
+    /** One tag's entries, or a 404 when the tag has none. */
+    function tagLoad(event) {
+        const tag = event.params.tag;
+        const entries = index.byTag(tag);
+        if (entries.length === 0)
+            throw error(404, `No entries tagged "${tag}"`);
+        return { tag, entries };
+    }
+    /** One entry by slug, rendered through the site renderer, or a 404. */
+    async function entryLoad(event) {
+        const entry = index.byId(event.params.slug);
+        if (!entry)
+            throw error(404, `Not found: ${event.params.slug}`);
+        const { newer, older } = index.adjacent(entry.id);
+        return {
+            entry,
+            html: await render(entry.body, { stagger: true }),
+            canonicalUrl: origin + entry.permalink,
+            newer,
+            older,
+        };
+    }
+    /** Prerender enumeration: one `{ slug }` per non-draft entry. */
+    function entries() {
+        return index.all().map((entry) => ({ slug: entry.id }));
+    }
+    return { archiveLoad, tagIndexLoad, tagLoad, entryLoad, entries };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glw907/cairn-cms",
-  "version": "0.6.0-rc.1",
+  "version": "0.7.0",
   "description": "Embedded, magic-link, GitHub-committing CMS for SvelteKit/Cloudflare sites.",
   "type": "module",
   "sideEffects": [

package/src/lib/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/src/lib/content/compose.ts

@@ -29,7 +29,7 @@ export function composeRuntime(
     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/src/lib/content/concepts.ts

@@ -23,6 +23,11 @@ function defaultLabel(id: string): string {
   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: string): string {
+  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
@@ -41,6 +46,7 @@ export function normalizeConcepts(
       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/src/lib/content/permalink.ts

@@ -0,0 +1,40 @@
+// cairn-cms: the one permalink resolver (public-delivery design, decision 3). Feeds, the
+// sitemap, canonical links, list links, and the prerender entries() all call this, so an
+// entry has exactly one canonical URL. The date is read straight from the YYYY-MM-DD string,
+// so a permalink never shifts across a timezone.
+import type { ConceptDescriptor } from './types.js';
+
+function pad(n: number): string {
+  return String(n).padStart(2, '0');
+}
+
+function dateParts(date?: string): { year: string; month: string; day: string } | null {
+  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: ConceptDescriptor,
+  entry: { id: string; date?: string },
+): string {
+  return descriptor.permalink.replace(/:(\w+)/g, (_match, token: string) => {
+    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/src/lib/content/types.ts

@@ -3,7 +3,7 @@
 //
 // The adapter is the single seam the engine consumes (spec §8). A site supplies a
 // `CairnAdapter` at `src/lib/cairn.config.ts` declaring its backend repo, the content
-// concepts it enables, its magic-link sender, and a design-accurate `renderPreview`. The
+// concepts it enables, its magic-link sender, and a design-accurate `render`. The
 // engine never hard-codes a concept, directory, or field; it reads them here. Field
 // descriptors are plain data so a `load` function can hand them across the server-to-client
 // boundary to the editor form.
@@ -84,6 +84,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. */
@@ -135,8 +142,8 @@ 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;
@@ -166,6 +173,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;
 }
@@ -224,7 +233,8 @@ 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/src/lib/delivery/content-index.ts

@@ -0,0 +1,127 @@
+// 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';
+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 function fromGlob(record: Record<string, string>): RawFile[] {
+  return Object.entries(record).map(([path, raw]) => ({ path, raw }));
+}
+
+function basename(path: string): string {
+  const slash = path.lastIndexOf('/');
+  return slash >= 0 ? path.slice(slash + 1) : path;
+}
+
+function asString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value : undefined;
+}
+
+function asDate(value: unknown): string | undefined {
+  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: unknown): string[] {
+  return Array.isArray(value) ? value.map(String) : [];
+}
+
+/** Build a concept's index from its raw files and normalized descriptor. */
+export function createContentIndex(files: RawFile[], descriptor: ConceptDescriptor): ContentIndex {
+  const entries: ContentEntry[] = 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: ContentEntry): ContentSummary => {
+    const { frontmatter: _frontmatter, body: _body, ...summary } = entry;
+    return summary;
+  };
+  const visible = (list: ContentEntry[], includeDrafts?: boolean): ContentEntry[] =>
+    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<string, number>();
+      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/src/lib/delivery/excerpt.ts

@@ -0,0 +1,41 @@
+// 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: string): string {
+  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: string, opts: { description?: string; maxChars?: number } = {}): string {
+  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: string): number {
+  const text = toPlainText(body);
+  return text ? text.split(/\s+/).length : 0;
+}