@glw907/cairn-cms 0.10.0 → 0.11.0

package/dist/delivery/CairnHead.svelte

@@ -0,0 +1,36 @@
+<!--
+@component
+Renders a page's SEO head from a SeoMeta object into <svelte:head>: a title, meta tags, link
+tags, and one escaped JSON-LD script. The title renders from seo.title by default; title={false}
+lets the site own the <title>, and a string overrides it. It carries no CSS, so it pulls in no
+admin styles.
+-->
+<script lang="ts">
+  import type { SeoMeta } from './seo.js';
+  import { jsonLdScript } from './json-ld.js';
+
+  let {
+    /** The plain-data head to render. */
+    seo,
+    /** Title override: a string replaces seo.title, false lets the site own <title>. */
+    title,
+  }: { seo: SeoMeta; title?: string | false } = $props();
+  const titleText = $derived(title === undefined ? seo.title : title);
+</script>
+
+<svelte:head>
+  {#if titleText !== false}
+    <title>{titleText}</title>
+  {/if}
+  {#each seo.meta as m}
+    {#if m.name}
+      <meta name={m.name} content={m.content} />
+    {:else if m.property}
+      <meta property={m.property} content={m.content} />
+    {/if}
+  {/each}
+  {#each seo.links as l}
+    <link rel={l.rel} type={l.type} href={l.href} title={l.title} />
+  {/each}
+  {@html jsonLdScript(seo.jsonLd)}
+</svelte:head>

package/dist/delivery/CairnHead.svelte.d.ts

@@ -0,0 +1,15 @@
+import type { SeoMeta } from './seo.js';
+type $$ComponentProps = {
+    seo: SeoMeta;
+    title?: string | false;
+};
+/**
+ * Renders a page's SEO head from a SeoMeta object into <svelte:head>: a title, meta tags, link
+ * tags, and one escaped JSON-LD script. The title renders from seo.title by default; title={false}
+ * lets the site own the <title>, and a string overrides it. It carries no CSS, so it pulls in no
+ * admin styles.
+ */
+declare const CairnHead: import("svelte").Component<$$ComponentProps, {}, "">;
+type CairnHead = ReturnType<typeof CairnHead>;
+export default CairnHead;
+//# sourceMappingURL=CairnHead.svelte.d.ts.map

package/dist/delivery/CairnHead.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CairnHead.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/CairnHead.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGvC,KAAK,gBAAgB,GAAI;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAAC;AAkCnE;;;;;GAKG;AACH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

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

@@ -17,17 +17,19 @@ export interface ContentSummary {
     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>;
+/** The detail view: a summary plus the frontmatter and the body to render. The frontmatter
+ *  type defaults to `Record<string, unknown>`; the typed-reads pass infers it from the concept
+ *  fields. Generic now so that change does not break this signature. */
+export interface ContentEntry<F = Record<string, unknown>> extends ContentSummary {
+    frontmatter: F;
     body: string;
 }
 /** The per-concept query surface. */
-export interface ContentIndex {
+export interface ContentIndex<F = Record<string, unknown>> {
     all(opts?: {
         includeDrafts?: boolean;
     }): ContentSummary[];
-    byId(id: string): ContentEntry | undefined;
+    byId(id: string): ContentEntry<F> | undefined;
     byTag(tag: string, opts?: {
         includeDrafts?: boolean;
     }): ContentSummary[];
@@ -43,5 +45,5 @@ export interface ContentIndex {
 /** 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;
+export declare function createContentIndex<F = Record<string, unknown>>(files: RawFile[], descriptor: ConceptDescriptor): ContentIndex<F>;
 //# sourceMappingURL=content-index.d.ts.map

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

@@ -1 +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"}
+{"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;;wEAEwE;AACxE,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,cAAc;IAC/E,WAAW,EAAE,CAAC,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9C,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,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,OAAO,EAAE,EAChB,UAAU,EAAE,iBAAiB,GAC5B,YAAY,CAAC,CAAC,CAAC,CA2DjB"}

package/dist/delivery/content-index.js

@@ -45,7 +45,7 @@ export function createContentIndex(files, descriptor) {
             excerpt: deriveExcerpt(body, { description: asString(frontmatter.description) }),
             wordCount: wordCount(body),
             draft: frontmatter.draft === true,
-            frontmatter,
+            frontmatter: frontmatter,
             body,
         };
     });

package/dist/delivery/index.d.ts

@@ -0,0 +1,22 @@
+export { createContentIndex, fromGlob } from './content-index.js';
+export type { RawFile, ContentSummary, ContentEntry, ContentIndex } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export type { SiteIndex, ConceptIndex } from './site-index.js';
+export { siteDescriptors } from './site-descriptors.js';
+export { deriveExcerpt, wordCount } from './excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './feeds.js';
+export type { FeedChannel, FeedItem } from './feeds.js';
+export { buildSitemap } from './sitemap.js';
+export type { SitemapUrl } from './sitemap.js';
+export { buildRobots } from './robots.js';
+export { buildSeoMeta } from './seo.js';
+export type { SeoInput, SeoMeta } from './seo.js';
+export { paginate } from './paginate.js';
+export type { Page } from './paginate.js';
+export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './responses.js';
+export { jsonLdScript } from './json-ld.js';
+export { permalink } from '../content/permalink.js';
+export { createPublicRoutes } from '../sveltekit/public-routes.js';
+export type { PublicRoutesDeps, ListData, TagData, TagIndexData, EntryData, } from '../sveltekit/public-routes.js';
+export { default as CairnHead } from './CairnHead.svelte';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,SAAS,GACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/delivery/index.js

@@ -0,0 +1,19 @@
+// cairn-cms: the public delivery entry (@glw907/cairn-cms/delivery). The complete, canonical,
+// backend-free toolkit a SvelteKit site wires its public pages with: the content index and the
+// site resolver, the descriptor helper, the syndication and SEO builders, the endpoint response
+// helpers, the catch-all route loaders, and the head component. It imports nothing from auth,
+// github, or email, so importing it does not pull the server backend into a public bundle.
+export { createContentIndex, fromGlob } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export { siteDescriptors } from './site-descriptors.js';
+export { deriveExcerpt, wordCount } from './excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './feeds.js';
+export { buildSitemap } from './sitemap.js';
+export { buildRobots } from './robots.js';
+export { buildSeoMeta } from './seo.js';
+export { paginate } from './paginate.js';
+export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './responses.js';
+export { jsonLdScript } from './json-ld.js';
+export { permalink } from '../content/permalink.js';
+export { createPublicRoutes } from '../sveltekit/public-routes.js';
+export { default as CairnHead } from './CairnHead.svelte';

package/dist/delivery/json-ld.d.ts

@@ -0,0 +1,2 @@
+export declare function jsonLdScript(data: Record<string, unknown>): string;
+//# sourceMappingURL=json-ld.d.ts.map

package/dist/delivery/json-ld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/json-ld.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQlE"}

package/dist/delivery/json-ld.js

@@ -0,0 +1,16 @@
+// cairn-cms: serialize a JSON-LD object into a safe inline script string. JSON.stringify does
+// not escape <, >, or &, so a value containing "</script>" would close the element and inject
+// markup. Escaping the three characters to their JSON unicode forms keeps the structured data
+// identical for a parser while making the bytes unable to break out of the script element.
+// The line separator U+2028 and paragraph separator U+2029 get the same treatment: they are
+// legal inside a JSON string but unsafe in inline script text, where some parsers read them as
+// line terminators, so an author pasting one into frontmatter would corrupt the JSON-LD block.
+export function jsonLdScript(data) {
+    const json = JSON.stringify(data)
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+    return `<script type="application/ld+json">${json}</script>`;
+}

package/dist/delivery/responses.d.ts

@@ -0,0 +1,14 @@
+import { type FeedChannel, type FeedItem } from './feeds.js';
+import { type SitemapUrl } from './sitemap.js';
+/** An RSS 2.0 feed response. */
+export declare function rssResponse(channel: FeedChannel, items: FeedItem[]): Response;
+/** A JSON Feed 1.1 response. */
+export declare function jsonFeedResponse(channel: FeedChannel, items: FeedItem[]): Response;
+/** A sitemap response. */
+export declare function sitemapResponse(urls: SitemapUrl[]): Response;
+/** A robots.txt response. */
+export declare function robotsResponse(opts: {
+    sitemapUrl: string;
+    disallow?: string[];
+}): Response;
+//# sourceMappingURL=responses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/responses.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG7D,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAI7E;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAIlF;AAED,0BAA0B;AAC1B,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CAI5D;AAED,6BAA6B;AAC7B,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,QAAQ,CAI1F"}

package/dist/delivery/responses.js

@@ -0,0 +1,30 @@
+// cairn-cms: response helpers for the public delivery endpoints. Each wraps a builder in a
+// Response with the correct Content-Type, so a site's +server.ts GET is a single call. The
+// content type is the one detail every site otherwise copies and occasionally gets wrong.
+import { buildRssFeed, buildJsonFeed } from './feeds.js';
+import { buildSitemap } from './sitemap.js';
+import { buildRobots } from './robots.js';
+/** An RSS 2.0 feed response. */
+export function rssResponse(channel, items) {
+    return new Response(buildRssFeed(channel, items), {
+        headers: { 'Content-Type': 'application/rss+xml; charset=utf-8' },
+    });
+}
+/** A JSON Feed 1.1 response. */
+export function jsonFeedResponse(channel, items) {
+    return new Response(buildJsonFeed(channel, items), {
+        headers: { 'Content-Type': 'application/feed+json; charset=utf-8' },
+    });
+}
+/** A sitemap response. */
+export function sitemapResponse(urls) {
+    return new Response(buildSitemap(urls), {
+        headers: { 'Content-Type': 'application/xml; charset=utf-8' },
+    });
+}
+/** A robots.txt response. */
+export function robotsResponse(opts) {
+    return new Response(buildRobots(opts), {
+        headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+    });
+}

package/dist/delivery/seo.d.ts

@@ -12,6 +12,10 @@ export interface SeoInput {
         json?: string;
     };
     image?: string;
+    /** A robots meta directive, e.g. "noindex, nofollow". Omitted from the head when absent. */
+    robots?: string;
+    /** Author name, emitted as article:author for the article type. */
+    author?: string;
 }
 /** Plain-data head: a title, meta tags, link tags, and one JSON-LD object. */
 export interface SeoMeta {

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

@@ -1 +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"}
+{"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;IACf,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;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,CAsDrD"}

package/dist/delivery/seo.js

@@ -17,6 +17,17 @@ export function buildSeoMeta(input) {
         meta.push({ property: 'og:image', content: input.image });
         meta.push({ name: 'twitter:image', content: input.image });
     }
+    if (input.robots) {
+        meta.push({ name: 'robots', content: input.robots });
+    }
+    if (type === 'article') {
+        if (input.published)
+            meta.push({ property: 'article:published_time', content: input.published });
+        if (input.modified)
+            meta.push({ property: 'article:modified_time', content: input.modified });
+        if (input.author)
+            meta.push({ property: 'article:author', content: input.author });
+    }
     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 });

package/dist/delivery/site-descriptors.d.ts

@@ -0,0 +1,5 @@
+import type { CairnAdapter, ConceptDescriptor } from '../content/types.js';
+import type { SiteConfig } from '../nav/site-config.js';
+/** Per-concept descriptors for a site, from its adapter content and its parsed site config. */
+export declare function siteDescriptors(adapter: CairnAdapter, siteConfig: SiteConfig): ConceptDescriptor[];
+//# sourceMappingURL=site-descriptors.d.ts.map

package/dist/delivery/site-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-descriptors.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-descriptors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,iBAAiB,EAAE,CAElG"}

package/dist/delivery/site-descriptors.js

@@ -0,0 +1,9 @@
+// cairn-cms: the one-call descriptor helper. A delivery site needs the same per-concept
+// descriptors the admin runtime uses; this wraps the two calls that derive them so the
+// pairing is not tribal knowledge. The YAML URL policy stays the single source of truth.
+import { normalizeConcepts } from '../content/concepts.js';
+import { urlPolicyFrom } from '../nav/site-config.js';
+/** Per-concept descriptors for a site, from its adapter content and its parsed site config. */
+export function siteDescriptors(adapter, siteConfig) {
+    return normalizeConcepts(adapter.content, urlPolicyFrom(siteConfig));
+}

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

@@ -23,6 +23,12 @@ export interface SiteIndex {
     /** Every non-draft summary across concepts, for the site-wide sitemap. */
     all(): ContentSummary[];
 }
-/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
-export declare function createSiteIndex(concepts: ConceptIndex[]): SiteIndex;
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any entry whose frontmatter fails its concept's validator,
+ * so malformed content fails the build instead of shipping.
+ */
+export declare function createSiteIndex(concepts: ConceptIndex[], opts?: {
+    validate?: boolean;
+}): SiteIndex;
 //# sourceMappingURL=site-index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"site-index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErF,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACpF,uGAAuG;IACvG,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,0EAA0E;IAC1E,GAAG,IAAI,cAAc,EAAE,CAAC;CACzB;AAOD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,SAAS,CAkCnE"}
+{"version":3,"file":"site-index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErF,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACpF,uGAAuG;IACvG,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,0EAA0E;IAC1E,GAAG,IAAI,cAAc,EAAE,CAAC;CACzB;AA2BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,CAmCtG"}

package/dist/delivery/site-index.js

@@ -2,8 +2,34 @@
 function normalizePath(path) {
     return path.length > 1 ? path.replace(/\/+$/, '') : path;
 }
-/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
-export function createSiteIndex(concepts) {
+/** Validate every entry (drafts included) against its concept, aggregating failures. */
+function validateAll(concepts) {
+    const problems = [];
+    for (const { descriptor, index } of concepts) {
+        for (const summary of index.all({ includeDrafts: true })) {
+            const entry = index.byId(summary.id);
+            if (!entry)
+                continue;
+            const result = descriptor.validate(entry.frontmatter, entry.body);
+            if (!result.ok) {
+                for (const [field, message] of Object.entries(result.errors)) {
+                    problems.push(`${descriptor.dir}/${summary.id}: ${field}: ${message}`);
+                }
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`site index: ${problems.length} invalid frontmatter field(s):\n  ${problems.join('\n  ')}`);
+    }
+}
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any entry whose frontmatter fails its concept's validator,
+ * so malformed content fails the build instead of shipping.
+ */
+export function createSiteIndex(concepts, opts = {}) {
+    if (opts.validate !== false)
+        validateAll(concepts);
     const byPath = new Map();
     const byId = new Map();
     for (const { descriptor, index } of concepts) {

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

@@ -1,5 +1,6 @@
 import type { ContentSummary, ContentEntry } from '../delivery/content-index.js';
 import type { SiteIndex } from '../delivery/site-index.js';
+import type { SeoMeta } from '../delivery/seo.js';
 /** Injected dependencies for the public loaders. */
 export interface PublicRoutesDeps {
     site: SiteIndex;
@@ -7,6 +8,15 @@ export interface PublicRoutesDeps {
         stagger?: boolean;
     }) => string | Promise<string>;
     origin: string;
+    /** Site name for og:site_name and the SEO head. */
+    siteName: string;
+    /** Default description used when an entry has none. */
+    description: string;
+    /** Absolute feed URLs for the head's autodiscovery links. */
+    feeds?: {
+        rss?: string;
+        json?: string;
+    };
 }
 /** The archive and tag list data: summaries the template renders. */
 export interface ListData {
@@ -28,6 +38,7 @@ export interface EntryData {
     entry: ContentEntry;
     html: string;
     canonicalUrl: string;
+    seo: SeoMeta;
     newer?: ContentSummary;
     older?: ContentSummary;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,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,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;uBAWvB;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,SAAS,CAAC;6BAQjC,MAAM,KAAG,QAAQ;8BAKhB,MAAM,KAAG,YAAY;yBAK1B,MAAM,SAAS;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO;mBAO5D;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;EAKvC"}
+{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,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;IACf,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;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,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;uBAWvB;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,SAAS,CAAC;6BAoBjC,MAAM,KAAG,QAAQ;8BAKhB,MAAM,KAAG,YAAY;yBAK1B,MAAM,SAAS;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO;mBAO5D;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;EAKvC"}

package/dist/sveltekit/public-routes.js

@@ -4,9 +4,10 @@
 // and tag-index loaders stay concept-scoped, keyed by concept id. The index is built in site code
 // from globs, so it stays in the prerender graph and out of the runtime Worker.
 import { error } from '@sveltejs/kit';
+import { buildSeoMeta } from '../delivery/seo.js';
 /** Build the public loaders for a site's unified index. */
 export function createPublicRoutes(deps) {
-    const { site, render, origin } = deps;
+    const { site, render, origin, siteName, description, feeds } = deps;
     /** Resolve one concept's index by id, or a 404 (the route names an unconfigured concept). */
     function indexOf(conceptId) {
         const index = site.concept(conceptId);
@@ -20,7 +21,19 @@ export function createPublicRoutes(deps) {
         if (!entry)
             throw error(404, `Not found: ${event.url.pathname}`);
         const { newer, older } = site.adjacent(entry);
-        return { entry, html: await render(entry.body, { stagger: true }), canonicalUrl: origin + entry.permalink, newer, older };
+        const canonicalUrl = origin + entry.permalink;
+        // A dated entry is an article; an undated one (a page) is a website.
+        const seo = buildSeoMeta({
+            title: entry.title,
+            description: entry.frontmatter.description || entry.excerpt || description,
+            canonicalUrl,
+            siteName,
+            type: entry.date ? 'article' : 'website',
+            ...(entry.date ? { published: entry.date } : {}),
+            ...(entry.updated ? { modified: entry.updated } : {}),
+            feeds,
+        });
+        return { entry, html: await render(entry.body, { stagger: true }), canonicalUrl, seo, newer, older };
     }
     /** The chronological archive for one concept: every non-draft summary, newest-first. */
     function archiveLoad(conceptId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glw907/cairn-cms",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Embedded, magic-link, GitHub-committing CMS for SvelteKit/Cloudflare sites.",
   "type": "module",
   "sideEffects": [
@@ -48,6 +48,11 @@
       "svelte": "./dist/components/index.js",
       "default": "./dist/components/index.js"
     },
+    "./delivery": {
+      "types": "./dist/delivery/index.d.ts",
+      "svelte": "./dist/delivery/index.js",
+      "default": "./dist/delivery/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/src/lib/delivery/CairnHead.svelte

@@ -0,0 +1,36 @@
+<!--
+@component
+Renders a page's SEO head from a SeoMeta object into <svelte:head>: a title, meta tags, link
+tags, and one escaped JSON-LD script. The title renders from seo.title by default; title={false}
+lets the site own the <title>, and a string overrides it. It carries no CSS, so it pulls in no
+admin styles.
+-->
+<script lang="ts">
+  import type { SeoMeta } from './seo.js';
+  import { jsonLdScript } from './json-ld.js';
+
+  let {
+    /** The plain-data head to render. */
+    seo,
+    /** Title override: a string replaces seo.title, false lets the site own <title>. */
+    title,
+  }: { seo: SeoMeta; title?: string | false } = $props();
+  const titleText = $derived(title === undefined ? seo.title : title);
+</script>
+
+<svelte:head>
+  {#if titleText !== false}
+    <title>{titleText}</title>
+  {/if}
+  {#each seo.meta as m}
+    {#if m.name}
+      <meta name={m.name} content={m.content} />
+    {:else if m.property}
+      <meta property={m.property} content={m.content} />
+    {/if}
+  {/each}
+  {#each seo.links as l}
+    <link rel={l.rel} type={l.type} href={l.href} title={l.title} />
+  {/each}
+  {@html jsonLdScript(seo.jsonLd)}
+</svelte:head>

package/src/lib/delivery/content-index.ts

@@ -28,16 +28,18 @@ export interface ContentSummary {
   draft: boolean;
 }
 
-/** The detail view: a summary plus the frontmatter and the body to render. */
-export interface ContentEntry extends ContentSummary {
-  frontmatter: Record<string, unknown>;
+/** The detail view: a summary plus the frontmatter and the body to render. The frontmatter
+ *  type defaults to `Record<string, unknown>`; the typed-reads pass infers it from the concept
+ *  fields. Generic now so that change does not break this signature. */
+export interface ContentEntry<F = Record<string, unknown>> extends ContentSummary {
+  frontmatter: F;
   body: string;
 }
 
 /** The per-concept query surface. */
-export interface ContentIndex {
+export interface ContentIndex<F = Record<string, unknown>> {
   all(opts?: { includeDrafts?: boolean }): ContentSummary[];
-  byId(id: string): ContentEntry | undefined;
+  byId(id: string): ContentEntry<F> | undefined;
   byTag(tag: string, opts?: { includeDrafts?: boolean }): ContentSummary[];
   allTags(): { tag: string; count: number }[];
   adjacent(id: string): { newer?: ContentSummary; older?: ContentSummary };
@@ -68,8 +70,11 @@ function asTags(value: unknown): 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) => {
+export function createContentIndex<F = Record<string, unknown>>(
+  files: RawFile[],
+  descriptor: ConceptDescriptor,
+): ContentIndex<F> {
+  const entries: ContentEntry<F>[] = 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);
@@ -85,7 +90,7 @@ export function createContentIndex(files: RawFile[], descriptor: ConceptDescript
       excerpt: deriveExcerpt(body, { description: asString(frontmatter.description) }),
       wordCount: wordCount(body),
       draft: frontmatter.draft === true,
-      frontmatter,
+      frontmatter: frontmatter as F,
       body,
     };
   });
@@ -95,11 +100,11 @@ export function createContentIndex(files: RawFile[], descriptor: ConceptDescript
     descriptor.routing.dated ? (b.date ?? '').localeCompare(a.date ?? '') : a.title.localeCompare(b.title),
   );
 
-  const summarize = (entry: ContentEntry): ContentSummary => {
+  const summarize = (entry: ContentEntry<F>): ContentSummary => {
     const { frontmatter: _frontmatter, body: _body, ...summary } = entry;
     return summary;
   };
-  const visible = (list: ContentEntry[], includeDrafts?: boolean): ContentEntry[] =>
+  const visible = (list: ContentEntry<F>[], includeDrafts?: boolean): ContentEntry<F>[] =>
     includeDrafts ? list : list.filter((entry) => !entry.draft);
 
   return {

package/src/lib/delivery/index.ts

@@ -0,0 +1,32 @@
+// cairn-cms: the public delivery entry (@glw907/cairn-cms/delivery). The complete, canonical,
+// backend-free toolkit a SvelteKit site wires its public pages with: the content index and the
+// site resolver, the descriptor helper, the syndication and SEO builders, the endpoint response
+// helpers, the catch-all route loaders, and the head component. It imports nothing from auth,
+// github, or email, so importing it does not pull the server backend into a public bundle.
+export { createContentIndex, fromGlob } from './content-index.js';
+export type { RawFile, ContentSummary, ContentEntry, ContentIndex } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export type { SiteIndex, ConceptIndex } from './site-index.js';
+export { siteDescriptors } from './site-descriptors.js';
+export { deriveExcerpt, wordCount } from './excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './feeds.js';
+export type { FeedChannel, FeedItem } from './feeds.js';
+export { buildSitemap } from './sitemap.js';
+export type { SitemapUrl } from './sitemap.js';
+export { buildRobots } from './robots.js';
+export { buildSeoMeta } from './seo.js';
+export type { SeoInput, SeoMeta } from './seo.js';
+export { paginate } from './paginate.js';
+export type { Page } from './paginate.js';
+export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './responses.js';
+export { jsonLdScript } from './json-ld.js';
+export { permalink } from '../content/permalink.js';
+export { createPublicRoutes } from '../sveltekit/public-routes.js';
+export type {
+  PublicRoutesDeps,
+  ListData,
+  TagData,
+  TagIndexData,
+  EntryData,
+} from '../sveltekit/public-routes.js';
+export { default as CairnHead } from './CairnHead.svelte';

package/src/lib/delivery/json-ld.ts

@@ -0,0 +1,16 @@
+// cairn-cms: serialize a JSON-LD object into a safe inline script string. JSON.stringify does
+// not escape <, >, or &, so a value containing "</script>" would close the element and inject
+// markup. Escaping the three characters to their JSON unicode forms keeps the structured data
+// identical for a parser while making the bytes unable to break out of the script element.
+// The line separator U+2028 and paragraph separator U+2029 get the same treatment: they are
+// legal inside a JSON string but unsafe in inline script text, where some parsers read them as
+// line terminators, so an author pasting one into frontmatter would corrupt the JSON-LD block.
+export function jsonLdScript(data: Record<string, unknown>): string {
+  const json = JSON.stringify(data)
+    .replace(/</g, '\\u003c')
+    .replace(/>/g, '\\u003e')
+    .replace(/&/g, '\\u0026')
+    .replace(/\u2028/g, '\\u2028')
+    .replace(/\u2029/g, '\\u2029');
+  return `<script type="application/ld+json">${json}</script>`;
+}

package/src/lib/delivery/responses.ts

@@ -0,0 +1,34 @@
+// cairn-cms: response helpers for the public delivery endpoints. Each wraps a builder in a
+// Response with the correct Content-Type, so a site's +server.ts GET is a single call. The
+// content type is the one detail every site otherwise copies and occasionally gets wrong.
+import { buildRssFeed, buildJsonFeed, type FeedChannel, type FeedItem } from './feeds.js';
+import { buildSitemap, type SitemapUrl } from './sitemap.js';
+import { buildRobots } from './robots.js';
+
+/** An RSS 2.0 feed response. */
+export function rssResponse(channel: FeedChannel, items: FeedItem[]): Response {
+  return new Response(buildRssFeed(channel, items), {
+    headers: { 'Content-Type': 'application/rss+xml; charset=utf-8' },
+  });
+}
+
+/** A JSON Feed 1.1 response. */
+export function jsonFeedResponse(channel: FeedChannel, items: FeedItem[]): Response {
+  return new Response(buildJsonFeed(channel, items), {
+    headers: { 'Content-Type': 'application/feed+json; charset=utf-8' },
+  });
+}
+
+/** A sitemap response. */
+export function sitemapResponse(urls: SitemapUrl[]): Response {
+  return new Response(buildSitemap(urls), {
+    headers: { 'Content-Type': 'application/xml; charset=utf-8' },
+  });
+}
+
+/** A robots.txt response. */
+export function robotsResponse(opts: { sitemapUrl: string; disallow?: string[] }): Response {
+  return new Response(buildRobots(opts), {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  });
+}

package/src/lib/delivery/seo.ts

@@ -13,6 +13,10 @@ export interface SeoInput {
   modified?: string;
   feeds?: { rss?: string; json?: string };
   image?: string;
+  /** A robots meta directive, e.g. "noindex, nofollow". Omitted from the head when absent. */
+  robots?: string;
+  /** Author name, emitted as article:author for the article type. */
+  author?: string;
 }
 
 /** Plain-data head: a title, meta tags, link tags, and one JSON-LD object. */
@@ -40,6 +44,15 @@ export function buildSeoMeta(input: SeoInput): SeoMeta {
     meta.push({ name: 'twitter:image', content: input.image });
   }
 
+  if (input.robots) {
+    meta.push({ name: 'robots', content: input.robots });
+  }
+  if (type === 'article') {
+    if (input.published) meta.push({ property: 'article:published_time', content: input.published });
+    if (input.modified) meta.push({ property: 'article:modified_time', content: input.modified });
+    if (input.author) meta.push({ property: 'article:author', content: input.author });
+  }
+
   const links: SeoMeta['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 });

package/src/lib/delivery/site-descriptors.ts

@@ -0,0 +1,12 @@
+// cairn-cms: the one-call descriptor helper. A delivery site needs the same per-concept
+// descriptors the admin runtime uses; this wraps the two calls that derive them so the
+// pairing is not tribal knowledge. The YAML URL policy stays the single source of truth.
+import { normalizeConcepts } from '../content/concepts.js';
+import { urlPolicyFrom } from '../nav/site-config.js';
+import type { CairnAdapter, ConceptDescriptor } from '../content/types.js';
+import type { SiteConfig } from '../nav/site-config.js';
+
+/** Per-concept descriptors for a site, from its adapter content and its parsed site config. */
+export function siteDescriptors(adapter: CairnAdapter, siteConfig: SiteConfig): ConceptDescriptor[] {
+  return normalizeConcepts(adapter.content, urlPolicyFrom(siteConfig));
+}

package/src/lib/delivery/site-index.ts

@@ -30,8 +30,33 @@ function normalizePath(path: string): string {
   return path.length > 1 ? path.replace(/\/+$/, '') : path;
 }
 
-/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
-export function createSiteIndex(concepts: ConceptIndex[]): SiteIndex {
+/** Validate every entry (drafts included) against its concept, aggregating failures. */
+function validateAll(concepts: ConceptIndex[]): void {
+  const problems: string[] = [];
+  for (const { descriptor, index } of concepts) {
+    for (const summary of index.all({ includeDrafts: true })) {
+      const entry = index.byId(summary.id);
+      if (!entry) continue;
+      const result = descriptor.validate(entry.frontmatter, entry.body);
+      if (!result.ok) {
+        for (const [field, message] of Object.entries(result.errors)) {
+          problems.push(`${descriptor.dir}/${summary.id}: ${field}: ${message}`);
+        }
+      }
+    }
+  }
+  if (problems.length > 0) {
+    throw new Error(`site index: ${problems.length} invalid frontmatter field(s):\n  ${problems.join('\n  ')}`);
+  }
+}
+
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any entry whose frontmatter fails its concept's validator,
+ * so malformed content fails the build instead of shipping.
+ */
+export function createSiteIndex(concepts: ConceptIndex[], opts: { validate?: boolean } = {}): SiteIndex {
+  if (opts.validate !== false) validateAll(concepts);
   const byPath = new Map<string, { index: ContentIndex; id: string }>();
   const byId = new Map<string, ContentIndex>();
   for (const { descriptor, index } of concepts) {

package/src/lib/sveltekit/public-routes.ts

@@ -6,12 +6,20 @@
 import { error } from '@sveltejs/kit';
 import type { ContentSummary, ContentEntry } from '../delivery/content-index.js';
 import type { SiteIndex } from '../delivery/site-index.js';
+import { buildSeoMeta } from '../delivery/seo.js';
+import type { SeoMeta } from '../delivery/seo.js';
 
 /** Injected dependencies for the public loaders. */
 export interface PublicRoutesDeps {
   site: SiteIndex;
   render: (md: string, opts?: { stagger?: boolean }) => string | Promise<string>;
   origin: string;
+  /** Site name for og:site_name and the SEO head. */
+  siteName: string;
+  /** Default description used when an entry has none. */
+  description: string;
+  /** Absolute feed URLs for the head's autodiscovery links. */
+  feeds?: { rss?: string; json?: string };
 }
 
 /** The archive and tag list data: summaries the template renders. */
@@ -34,13 +42,14 @@ export interface EntryData {
   entry: ContentEntry;
   html: string;
   canonicalUrl: string;
+  seo: SeoMeta;
   newer?: ContentSummary;
   older?: ContentSummary;
 }
 
 /** Build the public loaders for a site's unified index. */
 export function createPublicRoutes(deps: PublicRoutesDeps) {
-  const { site, render, origin } = deps;
+  const { site, render, origin, siteName, description, feeds } = deps;
 
   /** Resolve one concept's index by id, or a 404 (the route names an unconfigured concept). */
   function indexOf(conceptId: string) {
@@ -54,7 +63,19 @@ export function createPublicRoutes(deps: PublicRoutesDeps) {
     const entry = site.byPermalink(event.url.pathname);
     if (!entry) throw error(404, `Not found: ${event.url.pathname}`);
     const { newer, older } = site.adjacent(entry);
-    return { entry, html: await render(entry.body, { stagger: true }), canonicalUrl: origin + entry.permalink, newer, older };
+    const canonicalUrl = origin + entry.permalink;
+    // A dated entry is an article; an undated one (a page) is a website.
+    const seo = buildSeoMeta({
+      title: entry.title,
+      description: (entry.frontmatter.description as string) || entry.excerpt || description,
+      canonicalUrl,
+      siteName,
+      type: entry.date ? 'article' : 'website',
+      ...(entry.date ? { published: entry.date } : {}),
+      ...(entry.updated ? { modified: entry.updated } : {}),
+      feeds,
+    });
+    return { entry, html: await render(entry.body, { stagger: true }), canonicalUrl, seo, newer, older };
   }
 
   /** The chronological archive for one concept: every non-draft summary, newest-first. */