@glw907/cairn-cms 0.10.0 → 0.14.0

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,25 @@ 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;
 }
+/** One entry's validation failure, recorded at build for the site aggregator's gate. */
+export interface ContentProblem {
+    id: string;
+    draft: boolean;
+    errors: Record<string, 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[];
@@ -39,9 +47,11 @@ export interface ContentIndex {
         newer?: ContentSummary;
         older?: ContentSummary;
     };
+    /** Per-entry validation failures recorded at build, for the site-level build gate. */
+    problems(): ContentProblem[];
 }
 /** 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,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;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;IACzE,sFAAsF;IACtF,QAAQ,IAAI,cAAc,EAAE,CAAC;CAC9B;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,CAmEjB"}

package/dist/delivery/content-index.js

@@ -29,23 +29,31 @@ function asTags(value) {
 }
 /** Build a concept's index from its raw files and normalized descriptor. */
 export function createContentIndex(files, descriptor) {
+    const problems = [];
     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);
+        const { frontmatter: raw, body } = parseMarkdown(file.raw);
+        const date = asDate(raw.date);
+        const draft = raw.draft === true;
+        // Validate once at build. The cheap summary stays raw-derived and robust; the typed detail
+        // frontmatter carries the normalized data on success, the raw frontmatter on failure. A
+        // failure is recorded, not thrown, so the query surface does not explode on construction.
+        const result = descriptor.validate(raw, body);
+        if (!result.ok)
+            problems.push({ id, draft, errors: result.errors });
         return {
             id,
             slug,
             permalink: permalink(descriptor, { id, slug, date }),
-            title: asString(frontmatter.title) ?? id,
+            title: asString(raw.title) ?? id,
             date,
-            updated: asDate(frontmatter.updated),
-            tags: asTags(frontmatter.tags),
-            excerpt: deriveExcerpt(body, { description: asString(frontmatter.description) }),
+            updated: asDate(raw.updated),
+            tags: asTags(raw.tags),
+            excerpt: deriveExcerpt(body, { description: asString(raw.description) }),
             wordCount: wordCount(body),
-            draft: frontmatter.draft === true,
-            frontmatter,
+            draft,
+            frontmatter: (result.ok ? result.data : raw),
             body,
         };
     });
@@ -82,5 +90,6 @@ export function createContentIndex(files, descriptor) {
                 older: i < list.length - 1 ? summarize(list[i + 1]) : undefined,
             };
         },
+        problems: () => problems,
     };
 }

package/dist/delivery/index.d.ts

@@ -0,0 +1,26 @@
+export { createContentIndex, fromGlob } from './content-index.js';
+export type { RawFile, ContentSummary, ContentEntry, ContentIndex, ContentProblem } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export type { SiteIndex, ConceptIndex } from './site-index.js';
+export { createSiteIndexes } from './site-indexes.js';
+export type { SiteIndexes, SiteGlobs } from './site-indexes.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 { readSeoFields, resolveImageUrl } from './seo-fields.js';
+export type { SeoFields } from './seo-fields.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,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,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,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,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,21 @@
+// 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 { createSiteIndexes } from './site-indexes.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 { readSeoFields, resolveImageUrl } from './seo-fields.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-fields.d.ts

@@ -0,0 +1,22 @@
+/** The head fields a concept can carry in frontmatter. Each is optional and omitted when absent.
+ *  `author` is article-scoped downstream: the head builder emits `article:author` only for a dated
+ *  entry, so an `author` on an undated Page is read here but not rendered. */
+export interface SeoFields {
+    description?: string;
+    image?: string;
+    robots?: string;
+    author?: string;
+}
+/** Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
+ *  trimmed, and omits an absent, empty, or non-string value. Trimming the stored value keeps a stray
+ *  `robots: "  noindex  "` from reaching the head tag with surrounding whitespace. The field must be
+ *  declared in the concept's schema to survive the validate-once read; an undeclared key is not on the
+ *  normalized frontmatter. */
+export declare function readSeoFields(frontmatter: Record<string, unknown>): SeoFields;
+/** Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
+ *  protocol-relative URL passes through; a root-relative path anchors to the origin; a malformed
+ *  string returns undefined rather than throwing at build. The sites use a bare-domain origin, so a
+ *  bare path also anchors to the origin root; against a sub-path origin it would resolve relative to
+ *  that path, per the WHATWG URL rules. */
+export declare function resolveImageUrl(image: string, origin: string): string | undefined;
+//# sourceMappingURL=seo-fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-fields.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/seo-fields.ts"],"names":[],"mappings":"AAKA;;8EAE8E;AAC9E,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;8BAI8B;AAC9B,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAO7E;AAED;;;;2CAI2C;AAC3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjF"}

package/dist/delivery/seo-fields.js

@@ -0,0 +1,32 @@
+// cairn-cms: the SEO head fields read at the cross-concept boundary (schema-source-of-truth design,
+// Plan 3). The catch-all route resolves any concept by request path, so the entry's frontmatter is
+// typed Record<string, unknown>; this reads the known head fields by name and coerces. Kept apart
+// from seo.ts (the head builder) so reading frontmatter and building the head stay distinct concerns.
+const KEYS = ['description', 'image', 'robots', 'author'];
+/** Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
+ *  trimmed, and omits an absent, empty, or non-string value. Trimming the stored value keeps a stray
+ *  `robots: "  noindex  "` from reaching the head tag with surrounding whitespace. The field must be
+ *  declared in the concept's schema to survive the validate-once read; an undeclared key is not on the
+ *  normalized frontmatter. */
+export function readSeoFields(frontmatter) {
+    const fields = {};
+    for (const key of KEYS) {
+        const value = frontmatter[key];
+        if (typeof value === 'string' && value.trim() !== '')
+            fields[key] = value.trim();
+    }
+    return fields;
+}
+/** Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
+ *  protocol-relative URL passes through; a root-relative path anchors to the origin; a malformed
+ *  string returns undefined rather than throwing at build. The sites use a bare-domain origin, so a
+ *  bare path also anchors to the origin root; against a sub-path origin it would resolve relative to
+ *  that path, per the WHATWG URL rules. */
+export function resolveImageUrl(image, origin) {
+    try {
+        return new URL(image, origin).href;
+    }
+    catch {
+        return undefined;
+    }
+}

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 non-draft 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;AAqBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,CAwCtG"}

package/dist/delivery/site-index.js

@@ -2,8 +2,32 @@
 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) {
+/** Collect non-draft validation failures across concepts from each index's recorded verdicts. */
+function siteProblems(concepts) {
+    const problems = [];
+    for (const { descriptor, index } of concepts) {
+        for (const problem of index.problems()) {
+            if (problem.draft)
+                continue; // a half-finished draft never ships, so it does not fail the build
+            for (const [field, message] of Object.entries(problem.errors)) {
+                problems.push(`${descriptor.dir}/${problem.id}: ${field}: ${message}`);
+            }
+        }
+    }
+    return problems;
+}
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any non-draft 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) {
+        const problems = siteProblems(concepts);
+        if (problems.length > 0) {
+            throw new Error(`site index: ${problems.length} invalid frontmatter field(s):\n  ${problems.join('\n  ')}`);
+        }
+    }
     const byPath = new Map();
     const byId = new Map();
     for (const { descriptor, index } of concepts) {

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

@@ -0,0 +1,26 @@
+import type { CairnAdapter, ConceptConfig } from '../content/types.js';
+import type { Infer } from '../content/schema.js';
+import type { SiteConfig } from '../nav/site-config.js';
+import type { ContentIndex } from './content-index.js';
+import type { SiteIndex } from './site-index.js';
+/** A per-concept raw glob record (`{ path: raw }`) keyed by concept id, from `import.meta.glob`. */
+export type SiteGlobs<A extends CairnAdapter> = {
+    [K in keyof A['content']]?: Record<string, string>;
+};
+/** The typed per-concept indexes plus the cross-concept `site` resolver. A concept literally named
+ *  `site` is not supported, since `site` is the reserved resolver key. */
+export type SiteIndexes<A extends CairnAdapter> = {
+    [K in keyof A['content']]: ContentIndex<NonNullable<A['content'][K]> extends ConceptConfig<infer S> ? Infer<S> : Record<string, unknown>>;
+} & {
+    readonly site: SiteIndex;
+};
+/**
+ * Build typed per-concept indexes and a site resolver from one adapter. Pass the per-concept raw
+ * globs as `{ posts: import.meta.glob('...?raw', { eager: true }), ... }`; Vite needs the literal
+ * glob at the call site, so the engine cannot glob on the site's behalf. `validate: false` opts out
+ * of the build gate, exactly as on `createSiteIndex`.
+ */
+export declare function createSiteIndexes<const A extends CairnAdapter>(adapter: A, config: SiteConfig, globs: SiteGlobs<A>, opts?: {
+    validate?: boolean;
+}): SiteIndexes<A>;
+//# sourceMappingURL=site-indexes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"site-indexes.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-indexes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/D,oGAAoG;AACpG,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CACnD,CAAC;AAEF;0EAC0E;AAC1E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI;KAC/C,CAAC,IAAI,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,YAAY,CACrC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACjG;CACF,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC5D,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,WAAW,CAAC,CAAC,CAAC,CAYhB"}

package/dist/delivery/site-indexes.js

@@ -0,0 +1,22 @@
+import { siteDescriptors } from './site-descriptors.js';
+import { createContentIndex, fromGlob } from './content-index.js';
+import { createSiteIndex } from './site-index.js';
+/**
+ * Build typed per-concept indexes and a site resolver from one adapter. Pass the per-concept raw
+ * globs as `{ posts: import.meta.glob('...?raw', { eager: true }), ... }`; Vite needs the literal
+ * glob at the call site, so the engine cannot glob on the site's behalf. `validate: false` opts out
+ * of the build gate, exactly as on `createSiteIndex`.
+ */
+export function createSiteIndexes(adapter, config, globs, opts = {}) {
+    const descriptors = siteDescriptors(adapter, config);
+    const byConcept = {};
+    const conceptIndexes = [];
+    for (const descriptor of descriptors) {
+        const record = globs[descriptor.id] ?? {};
+        const index = createContentIndex(fromGlob(record), descriptor);
+        byConcept[descriptor.id] = index;
+        conceptIndexes.push({ descriptor, index });
+    }
+    const site = createSiteIndex(conceptIndexes, opts);
+    return { ...byConcept, site };
+}

package/dist/index.d.ts

@@ -6,7 +6,9 @@ export type { CairnAdapter, ConceptConfig, FrontmatterField, TextField, Textarea
 export { CONCEPT_ROUTING, normalizeConcepts, findConcept } from './content/concepts.js';
 export { composeRuntime } from './content/compose.js';
 export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown, } from './content/frontmatter.js';
-export { validateFields } from './content/validate.js';
+export { defineFields } from './content/schema.js';
+export { defineAdapter } from './content/adapter.js';
+export type { ConceptSchema, Infer, InferFields, DefineFieldsOptions, StandardInput, StandardSchemaV1 } from './content/schema.js';
 export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, composeDatedId, } from './content/ids.js';
 export type { DatePrefix } from './content/ids.js';
 export { defineRegistry, emptyValues } from './render/registry.js';
@@ -20,7 +22,7 @@ export type { ReferenceOptions } from './render/component-reference.js';
 export { glyph } from './render/glyph.js';
 export type { IconSet } from './render/glyph.js';
 export { remarkDirectiveStamp } from './render/remark-directives.js';
-export { rehypeDispatch, isElement, strProp, iconSpan, splitHead, cardShell, markFirstList, } from './render/rehype-dispatch.js';
+export { rehypeDispatch, isElement, strProp, iconSpan, cardShell, markFirstList, } from './render/rehype-dispatch.js';
 export type { MakeIcon } from './render/rehype-dispatch.js';
 export { createRenderer } from './render/pipeline.js';
 export type { RendererOptions } from './render/pipeline.js';
@@ -34,9 +36,11 @@ export { parseSiteConfig, urlPolicyFrom, extractMenu, setMenu, validateNavTree,
 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 type { RawFile, ContentSummary, ContentEntry, ContentIndex, ContentProblem, } from './delivery/content-index.js';
 export { createSiteIndex } from './delivery/site-index.js';
 export type { SiteIndex, ConceptIndex } from './delivery/site-index.js';
+export { createSiteIndexes } from './delivery/site-indexes.js';
+export type { SiteIndexes, SiteGlobs } from './delivery/site-indexes.js';
 export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
 export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
 export type { FeedChannel, FeedItem } from './delivery/feeds.js';
@@ -45,6 +49,8 @@ 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 { readSeoFields, resolveImageUrl } from './delivery/seo-fields.js';
+export type { SeoFields } from './delivery/seo-fields.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,7 +5,8 @@ export { buildMagicLinkMessage, cloudflareSend } from './email.js';
 export { CONCEPT_ROUTING, normalizeConcepts, findConcept } from './content/concepts.js';
 export { composeRuntime } from './content/compose.js';
 export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown, } from './content/frontmatter.js';
-export { validateFields } from './content/validate.js';
+export { defineFields } from './content/schema.js';
+export { defineAdapter } from './content/adapter.js';
 export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, composeDatedId, } from './content/ids.js';
 // Render engine (Plan 04): generic directive pipeline; sites own the component registry.
 export { defineRegistry, emptyValues } from './render/registry.js';
@@ -15,7 +16,7 @@ export { buildComponentInsert } from './render/component-insert.js';
 export { generateComponentReference } from './render/component-reference.js';
 export { glyph } from './render/glyph.js';
 export { remarkDirectiveStamp } from './render/remark-directives.js';
-export { rehypeDispatch, isElement, strProp, iconSpan, splitHead, cardShell, markFirstList, } from './render/rehype-dispatch.js';
+export { rehypeDispatch, isElement, strProp, iconSpan, cardShell, markFirstList, } from './render/rehype-dispatch.js';
 export { createRenderer } from './render/pipeline.js';
 export { CommitConflictError } from './github/types.js';
 export { appJwt, installationToken, signingSelfTest } from './github/signing.js';
@@ -29,9 +30,11 @@ export { parseSiteConfig, urlPolicyFrom, extractMenu, setMenu, validateNavTree,
 export { permalink } from './content/permalink.js';
 export { createContentIndex, fromGlob } from './delivery/content-index.js';
 export { createSiteIndex } from './delivery/site-index.js';
+export { createSiteIndexes } from './delivery/site-indexes.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 { readSeoFields, resolveImageUrl } from './delivery/seo-fields.js';
 export { paginate } from './delivery/paginate.js';

package/dist/render/component-grammar.d.ts

@@ -7,4 +7,11 @@ export declare function parseComponent(markdown: string, def: ComponentDef): Pro
 /** The raw attribute keys present on the component's opening directive, read from the parsed tree
  *  (quote-aware, unlike a regex over the source). Used by validation to flag unknown keys. */
 export declare function parseRawAttributeKeys(markdown: string, def: ComponentDef): string[];
+/** Parse the component once and derive both the guided-form values and the raw attribute keys.
+ *  Validation needs both, so this seam spares it the double parse that calling
+ *  {@link parseComponent} and {@link parseRawAttributeKeys} separately would cost. */
+export declare function parseComponentWithRawKeys(markdown: string, def: ComponentDef): Promise<{
+    values: ComponentValues;
+    rawKeys: string[];
+}>;
 //# sourceMappingURL=component-grammar.d.ts.map

package/dist/render/component-grammar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-grammar.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-grammar.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAW,MAAM,eAAe,CAAC;AA8B5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA2BrF;AAwBD;;wCAEwC;AACxC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAqClG;AAED;8FAC8F;AAC9F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAMnF"}
+{"version":3,"file":"component-grammar.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-grammar.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAW,MAAM,eAAe,CAAC;AA8B5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA2BrF;AA4ED;;wCAEwC;AACxC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAElG;AAED;8FAC8F;AAC9F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAEnF;AAED;;sFAEsF;AACtF,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAGzD"}