@glw907/cairn-cms 0.24.0 → 0.29.0

package/dist/content/links.d.ts

@@ -18,4 +18,3 @@ export declare function escapeLinkText(text: string): string;
 /** The cairn links a markdown body points at, in first-occurrence order, deduped by concept/id.
  *  Parses the body as mdast, so a token inside a code span or fence is never matched. */
 export declare function extractCairnLinks(body: string): CairnRef[];
-//# sourceMappingURL=links.d.ts.map

package/dist/content/manifest.d.ts

@@ -24,7 +24,9 @@ export interface LinkTarget {
     date?: string;
     draft: boolean;
 }
-/** Build one manifest entry from a content file. Drafts are included and flagged. */
+/** Build one manifest entry from a content file. Drafts are included and flagged. The id, date, and
+ *  permalink come from entryIdentity, the same source content-index uses, so a cairn: link resolves to
+ *  one URL whether the admin preview reads the manifest or the public build reads the content index. */
 export declare function manifestEntryFromFile(descriptor: ConceptDescriptor, file: {
     path: string;
     raw: string;
@@ -39,9 +41,26 @@ export declare function serializeManifest(manifest: Manifest): string;
  *  error. The build regenerates the manifest, so a real file is always canonical; this guards a
  *  hand-edited or truncated one. */
 export declare function parseManifest(raw: string): Manifest;
-/** Throw if the committed manifest drifts from what the corpus says. Both sides are compared in the
- *  canonical serialized form, so semantic equality never spuriously fails. The build calls this so a
- *  raw-git content edit, which leaves the committed manifest stale, fails the build loudly. */
+/** A changed entry and the fields that differ between the built and committed manifests. */
+export interface ManifestEntryDiff {
+    concept: string;
+    id: string;
+    fields: string[];
+}
+/** The drift between a freshly built manifest and the committed one, keyed by concept+id. */
+export interface ManifestDiff {
+    added: ManifestEntry[];
+    removed: ManifestEntry[];
+    changed: ManifestEntryDiff[];
+}
+/** Compare a built manifest against a committed one, keyed by concept+id (the same identity
+ *  upsertEntry and removeEntry use). A changed entry names the fields that differ. Pure, so it is
+ *  unit-tested apart from any build. */
+export declare function diffManifests(built: Manifest, committed: Manifest): ManifestDiff;
+/** Throw if the committed manifest drifts from what the corpus says. The canonical serialized form
+ *  is the fast-path equality guard, so semantic equality never spuriously fails. On a mismatch the
+ *  error names the added, removed, and changed entries, so a raw-git content edit that leaves the
+ *  committed manifest stale fails the build loudly with what drifted. */
 export declare function verifyManifest(built: Manifest, committedRaw: string): void;
 /** Replace the entry with the same concept and id, or add it. Order does not matter, since
  *  serializeManifest sorts. This is the save path's incremental patch. */
@@ -66,4 +85,3 @@ export declare function manifestLinkResolver(targets: {
     id: string;
     permalink: string;
 }[]): LinkResolve;
-//# sourceMappingURL=manifest.d.ts.map

package/dist/content/manifest.js

@@ -3,41 +3,21 @@
 // code reads the content graph without an N+1 GitHub crawl. The build regenerates and verifies
 // it; the save path patches one entry and commits it with the content in one commit. Each entry
 // carries its identity and its outbound cairn: edges, so the manifest is the link graph.
-import { idFromFilename, slugFromId } from './ids.js';
 import { parseMarkdown } from './frontmatter.js';
-import { permalink } from './permalink.js';
+import { entryIdentity, asString } from './identity.js';
 import { extractCairnLinks } from './links.js';
-function basename(path) {
-    const slash = path.lastIndexOf('/');
-    return slash >= 0 ? path.slice(slash + 1) : path;
-}
-/** Mirror content-index's frontmatter coercion: a present non-empty string, else undefined. */
-function asString(value) {
-    return typeof value === 'string' && value.trim() ? value : undefined;
-}
-/** Mirror content-index's date coercion: an unquoted YAML date is a JS Date, a string is sliced. */
-function asDate(value) {
-    if (value instanceof Date)
-        return Number.isNaN(value.getTime()) ? undefined : value.toISOString().slice(0, 10);
-    if (typeof value === 'string')
-        return value.match(/^\d{4}-\d{2}-\d{2}/)?.[0];
-    return undefined;
-}
-/** Build one manifest entry from a content file. Drafts are included and flagged. */
+/** Build one manifest entry from a content file. Drafts are included and flagged. The id, date, and
+ *  permalink come from entryIdentity, the same source content-index uses, so a cairn: link resolves to
+ *  one URL whether the admin preview reads the manifest or the public build reads the content index. */
 export function manifestEntryFromFile(descriptor, file) {
-    const id = idFromFilename(basename(file.path));
-    // Use the same slug rule content-index uses, so the manifest's permalink for an entry always
-    // equals content-index's permalink for it. A cairn link must resolve to one URL whether the
-    // admin preview reads the manifest or the public build reads the content index.
-    const slug = slugFromId(id, descriptor.routing.dated ? descriptor.datePrefix : null);
     const { frontmatter, body } = parseMarkdown(file.raw);
-    const date = asDate(frontmatter.date);
+    const { id, date, permalink } = entryIdentity(descriptor, file.path, frontmatter);
     return {
         id,
         concept: descriptor.id,
         title: asString(frontmatter.title) ?? id,
         date,
-        permalink: permalink(descriptor, { id, slug, date }),
+        permalink,
         draft: frontmatter.draft === true,
         links: extractCairnLinks(body),
     };
@@ -104,13 +84,56 @@ export function parseManifest(raw) {
     }
     return { version: 1, entries: obj.entries };
 }
-/** Throw if the committed manifest drifts from what the corpus says. Both sides are compared in the
- *  canonical serialized form, so semantic equality never spuriously fails. The build calls this so a
- *  raw-git content edit, which leaves the committed manifest stale, fails the build loudly. */
-export function verifyManifest(built, committedRaw) {
-    if (committedRaw !== serializeManifest(built)) {
-        throw new Error('content manifest is stale: the committed file does not match the corpus. Regenerate it (npm run cairn:manifest) and commit the result.');
+const keyOf = (e) => `${e.concept}/${e.id}`;
+/** Compare a built manifest against a committed one, keyed by concept+id (the same identity
+ *  upsertEntry and removeEntry use). A changed entry names the fields that differ. Pure, so it is
+ *  unit-tested apart from any build. */
+export function diffManifests(built, committed) {
+    const builtByKey = new Map(built.entries.map((e) => [keyOf(e), e]));
+    const committedByKey = new Map(committed.entries.map((e) => [keyOf(e), e]));
+    const added = built.entries.filter((e) => !committedByKey.has(keyOf(e)));
+    const removed = committed.entries.filter((e) => !builtByKey.has(keyOf(e)));
+    const changed = [];
+    for (const b of built.entries) {
+        const c = committedByKey.get(keyOf(b));
+        if (!c)
+            continue;
+        // ManifestEntry has no index signature, so read its keys through an unknown-cast record.
+        const br = b;
+        const cr = c;
+        const fields = [...new Set([...Object.keys(b), ...Object.keys(c)])].filter((k) => JSON.stringify(br[k]) !== JSON.stringify(cr[k]));
+        if (fields.length > 0)
+            changed.push({ concept: b.concept, id: b.id, fields });
     }
+    return { added, removed, changed };
+}
+/** Format a diff into a short human-readable block for a build error. */
+function formatDiff(d) {
+    const lines = [];
+    for (const e of d.added)
+        lines.push(`  + ${keyOf(e)}`);
+    for (const e of d.removed)
+        lines.push(`  - ${keyOf(e)}`);
+    for (const e of d.changed)
+        lines.push(`  ~ ${e.concept}/${e.id} (${e.fields.join(', ')})`);
+    return lines.join('\n');
+}
+/** Throw if the committed manifest drifts from what the corpus says. The canonical serialized form
+ *  is the fast-path equality guard, so semantic equality never spuriously fails. On a mismatch the
+ *  error names the added, removed, and changed entries, so a raw-git content edit that leaves the
+ *  committed manifest stale fails the build loudly with what drifted. */
+export function verifyManifest(built, committedRaw) {
+    const builtRaw = serializeManifest(built);
+    if (committedRaw === builtRaw)
+        return;
+    // Diff the canonical built form, not the raw one. serializeManifest sorts each entry's links, so a
+    // build whose links are in extraction order would otherwise report a false (links) drift for an
+    // entry whose link set is identical and only the order differs. Reuse the serialized form so both
+    // sides are canonical.
+    const diff = diffManifests(parseManifest(builtRaw), parseManifest(committedRaw));
+    throw new Error('content manifest is stale: the committed file does not match the corpus.\n' +
+        formatDiff(diff) +
+        '\nRegenerate it (npm run cairn:manifest) and commit the result.');
 }
 /** Replace the entry with the same concept and id, or add it. Order does not matter, since
  *  serializeManifest sorts. This is the save path's incremental patch. */

package/dist/content/permalink.d.ts

@@ -9,4 +9,3 @@ export declare function permalink(descriptor: ConceptDescriptor, entry: {
     slug: string;
     date?: string;
 }): string;
-//# sourceMappingURL=permalink.d.ts.map

package/dist/content/schema.d.ts

@@ -72,4 +72,3 @@ export interface DefineFieldsOptions<F extends readonly FrontmatterField[]> {
 /** Declare a concept's fields once. Returns the schema's faces derived from that one declaration. */
 export declare function defineFields<const F extends readonly FrontmatterField[]>(fields: F, options?: DefineFieldsOptions<F>): ConceptSchema<F>;
 export {};
-//# sourceMappingURL=schema.d.ts.map

package/dist/content/types.d.ts

@@ -270,4 +270,3 @@ export interface CairnRuntime {
     fieldTypes?: FieldTypeDef[];
 }
 export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/content/validate.d.ts

@@ -3,7 +3,10 @@ import type { FrontmatterField, ValidationResult } from './types.js';
  * Validate raw frontmatter against a field list. Required text and date fields must be
  * non-empty; required tag fields must be non-empty lists. A present boolean coerces to `true`
  * and an unchecked one is omitted; a present tag field coerces to a string array and an empty
- * one is omitted; an empty optional text or date field is omitted, so the normalized data
+ * one is omitted, so validated data carries no key for an absent tag field (`tags` or `freetags`).
+ * The delivery read model
+ * (`ContentSummary.tags`) fills that case with an empty array; the two layers differ on purpose.
+ * An empty optional text or date field is omitted, so the normalized data
  * carries only meaningful values and committed frontmatter stays minimal. Returns the
  * normalized data, or field-keyed errors when any required field is empty.
  *
@@ -12,4 +15,3 @@ import type { FrontmatterField, ValidationResult } from './types.js';
  * `Date` to `YYYY-MM-DD` so a valid parsed date is not mistaken for an empty one.
  */
 export declare function validateFields(fields: FrontmatterField[], frontmatter: Record<string, unknown>): ValidationResult;
-//# sourceMappingURL=validate.d.ts.map

package/dist/content/validate.js

@@ -3,7 +3,10 @@ import { dateInputValue, isCalendarDate } from './frontmatter.js';
  * Validate raw frontmatter against a field list. Required text and date fields must be
  * non-empty; required tag fields must be non-empty lists. A present boolean coerces to `true`
  * and an unchecked one is omitted; a present tag field coerces to a string array and an empty
- * one is omitted; an empty optional text or date field is omitted, so the normalized data
+ * one is omitted, so validated data carries no key for an absent tag field (`tags` or `freetags`).
+ * The delivery read model
+ * (`ContentSummary.tags`) fills that case with an empty array; the two layers differ on purpose.
+ * An empty optional text or date field is omitted, so the normalized data
  * carries only meaningful values and committed frontmatter stays minimal. Returns the
  * normalized data, or field-keyed errors when any required field is empty.
  *

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

@@ -12,4 +12,3 @@ type $$ComponentProps = {
 declare const CairnHead: import("svelte").Component<$$ComponentProps, {}, "">;
 type CairnHead = ReturnType<typeof CairnHead>;
 export default CairnHead;
-//# sourceMappingURL=CairnHead.svelte.d.ts.map

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

@@ -15,6 +15,10 @@ export interface ContentSummary {
     title: string;
     date?: string;
     updated?: string;
+    /** The entry's tags, always present as an array and empty when the file declares none. This is the
+     *  read-model normalization. It differs on purpose from the validated `frontmatter.tags`, which the
+     *  validator omits when empty, so a published file carries no `tags: []` noise. Read `tags` here for
+     *  a list; read `frontmatter.tags` only when you need the validated, possibly-absent value. */
     tags: string[];
     excerpt: string;
     wordCount: number;
@@ -61,4 +65,3 @@ export interface ContentIndex<F = Record<string, unknown>> {
 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<F = Record<string, unknown>>(files: RawFile[], descriptor: ConceptDescriptor): ContentIndex<F>;
-//# sourceMappingURL=content-index.d.ts.map

package/dist/delivery/content-index.js

@@ -3,47 +3,30 @@
 // returns cheap plain-data summaries plus an on-demand detail lookup. It is concept-generic:
 // every operation reads the descriptor and its routing rule, never a hardcoded concept id.
 import { parseMarkdown } from '../content/frontmatter.js';
-import { idFromFilename, slugFromId } from '../content/ids.js';
-import { permalink } from '../content/permalink.js';
+import { entryId, entryIdentity, asDate, asString, asTags } from '../content/identity.js';
 import { deriveExcerpt, wordCount } from './excerpt.js';
 /** Map a Vite eager `?raw` glob record (`{ path: raw }`) to `RawFile[]`. */
 export function fromGlob(record) {
     return Object.entries(record).map(([path, raw]) => ({ path, raw }));
 }
-function basename(path) {
-    const slash = path.lastIndexOf('/');
-    return slash >= 0 ? path.slice(slash + 1) : path;
-}
-function asString(value) {
-    return typeof value === 'string' && value.trim() ? value : undefined;
-}
-function asDate(value) {
-    if (value instanceof Date)
-        return Number.isNaN(value.getTime()) ? undefined : value.toISOString().slice(0, 10);
-    if (typeof value === 'string')
-        return value.match(/^\d{4}-\d{2}-\d{2}/)?.[0];
-    return undefined;
-}
-function asTags(value) {
-    return Array.isArray(value) ? value.map(String) : [];
-}
 /** Build a concept's index from its raw files and normalized descriptor. */
 export function createContentIndex(files, descriptor) {
     const problems = [];
     const entries = [];
     for (const file of files) {
-        const id = idFromFilename(basename(file.path));
-        const slug = slugFromId(id, descriptor.routing.dated ? descriptor.datePrefix : null);
         const { frontmatter: raw, body } = parseMarkdown(file.raw);
-        const date = asDate(raw.date);
+        const id = entryId(file.path);
         const draft = raw.draft === true;
-        // Validate once at build. A failure is recorded for the site gate and excluded from the typed
-        // read, so every readable entry's frontmatter is the validator's normalized output, never raw.
+        // Validate before resolving the permalink. A date-token permalink throws on an entry with no
+        // valid date; the validate gate records that as a content problem rather than aborting the whole
+        // index build, so one bad entry degrades to a skip, not a crash. A failure is also excluded from
+        // the typed read, so every readable entry's frontmatter is the validator's normalized output.
         const result = descriptor.validate(raw, body);
         if (!result.ok) {
             problems.push({ id, draft, errors: result.errors });
             continue;
         }
+        const { slug, date, permalink } = entryIdentity(descriptor, file.path, raw);
         const summaryFieldValues = {};
         for (const key of descriptor.summaryFields) {
             if (key in result.data)
@@ -53,7 +36,7 @@ export function createContentIndex(files, descriptor) {
             concept: descriptor.id,
             id,
             slug,
-            permalink: permalink(descriptor, { id, slug, date }),
+            permalink,
             title: asString(raw.title) ?? id,
             date,
             updated: asDate(raw.updated),

package/dist/delivery/data.d.ts

@@ -0,0 +1,23 @@
+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 { buildSiteManifest, buildLinkResolver } from './manifest.js';

package/dist/delivery/data.js

@@ -0,0 +1,18 @@
+// cairn-cms: the node-safe delivery data surface (@glw907/cairn-cms/delivery/data). The pure corpus
+// projections a SvelteKit site or a plain-Node tool reads, with no @sveltejs/kit and no .svelte in
+// the graph. The full ./delivery barrel re-exports this and adds the route loaders.
+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 { buildSiteManifest, buildLinkResolver } from './manifest.js';

package/dist/delivery/excerpt.d.ts

@@ -8,4 +8,3 @@ export declare function deriveExcerpt(body: string, opts?: {
 }): string;
 /** Count words in the stripped body. */
 export declare function wordCount(body: string): number;
-//# sourceMappingURL=excerpt.d.ts.map

package/dist/delivery/feeds.d.ts

@@ -24,4 +24,3 @@ export interface FeedItem {
 export declare function buildRssFeed(channel: FeedChannel, items: FeedItem[]): string;
 /** Build a JSON Feed 1.1 document. */
 export declare function buildJsonFeed(channel: FeedChannel, items: FeedItem[]): string;
-//# sourceMappingURL=feeds.d.ts.map

package/dist/delivery/head.d.ts

@@ -1,2 +1 @@
 export { default as CairnHead } from './CairnHead.svelte';
-//# sourceMappingURL=head.d.ts.map

package/dist/delivery/index.d.ts

@@ -1,26 +1,3 @@
-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 { buildSiteManifest, buildLinkResolver } from './manifest.js';
+export * from './data.js';
 export { createPublicRoutes } from '../sveltekit/public-routes.js';
 export type { PublicRoutesDeps, ListData, TagData, TagIndexData, EntryData, } from '../sveltekit/public-routes.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/delivery/index.js

@@ -1,21 +1,6 @@
-// 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 { buildSiteManifest, buildLinkResolver } from './manifest.js';
+// cairn-cms: the public delivery entry (@glw907/cairn-cms/delivery). The node-safe data surface
+// (re-exported from ./delivery/data) plus the SvelteKit catch-all route loaders. The head component
+// lives at ./delivery/head. Importing this pulls @sveltejs/kit through the route loaders, so a
+// plain-Node tool imports from ./delivery/data instead.
+export * from './data.js';
 export { createPublicRoutes } from '../sveltekit/public-routes.js';

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

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

package/dist/delivery/manifest.d.ts

@@ -10,4 +10,3 @@ export declare function buildSiteManifest<A extends CairnAdapter>(adapter: A, co
 /** A resolver backed by the site index, for the build. A miss throws, so a dangling cairn: token
  *  fails the prerender (the build backstop). The preview uses manifestLinkResolver, which marks. */
 export declare function buildLinkResolver(site: SiteIndex): LinkResolve;
-//# sourceMappingURL=manifest.d.ts.map

package/dist/delivery/paginate.d.ts

@@ -10,4 +10,3 @@ export interface Page<T> {
 }
 /** Slice `items` into the 1-based `page` of size `perPage`, clamping the page into bounds. */
 export declare function paginate<T>(items: T[], page: number, perPage: number): Page<T>;
-//# sourceMappingURL=paginate.d.ts.map

package/dist/delivery/responses.d.ts

@@ -11,4 +11,3 @@ export declare function robotsResponse(opts: {
     sitemapUrl: string;
     disallow?: string[];
 }): Response;
-//# sourceMappingURL=responses.d.ts.map

package/dist/delivery/robots.d.ts

@@ -3,4 +3,3 @@ export declare function buildRobots(opts: {
     sitemapUrl: string;
     disallow?: string[];
 }): string;
-//# sourceMappingURL=robots.d.ts.map

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

@@ -19,4 +19,3 @@ export declare function readSeoFields(frontmatter: Record<string, unknown>): Seo
  *  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.d.ts

@@ -35,4 +35,3 @@ export interface SeoMeta {
 }
 /** Build the head data for a page. */
 export declare function buildSeoMeta(input: SeoInput): SeoMeta;
-//# sourceMappingURL=seo.d.ts.map

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

@@ -2,4 +2,3 @@ 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.js

@@ -1,9 +1,8 @@
-// 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';
+// cairn-cms: the one-call descriptor helper. A delivery site needs the same per-concept descriptors
+// the admin runtime uses; this delegates to the shared resolveConcepts so the pairing is one path, not
+// tribal knowledge. The YAML URL policy stays the single source of truth.
+import { resolveConcepts } from '../content/concepts.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));
+    return resolveConcepts(adapter.content, siteConfig);
 }

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

@@ -31,4 +31,3 @@ export interface SiteIndex {
 export declare function createSiteIndex(concepts: ConceptIndex[], opts?: {
     validate?: boolean;
 }): SiteIndex;
-//# sourceMappingURL=site-index.d.ts.map

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

@@ -23,4 +23,3 @@ export type SiteIndexes<A extends CairnAdapter> = {
 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/sitemap.d.ts

@@ -5,4 +5,3 @@ export interface SitemapUrl {
 }
 /** Build a sitemap XML document from a list of URLs. */
 export declare function buildSitemap(urls: SitemapUrl[]): string;
-//# sourceMappingURL=sitemap.d.ts.map

package/dist/email.d.ts

@@ -24,4 +24,3 @@ export declare function buildMagicLinkMessage(input: {
 }): MagicLinkMessage;
 /** The production send: Cloudflare Email Sending through the EMAIL binding. */
 export declare const cloudflareSend: SendMagicLink;
-//# sourceMappingURL=email.d.ts.map

package/dist/env.d.ts

@@ -21,4 +21,3 @@ export declare function requireOrigin(env: {
 export declare function requireDb(env: {
     AUTH_DB?: D1Database;
 }): D1Database;
-//# sourceMappingURL=env.d.ts.map

package/dist/github/credentials.d.ts

@@ -9,4 +9,3 @@ export interface GithubKeyEnv {
  * installation) and the Worker's private-key secret. Throws when the secret is unset.
  */
 export declare function appCredentials(backend: Pick<BackendConfig, 'appId' | 'installationId'>, env: GithubKeyEnv): AppCredentials;
-//# sourceMappingURL=credentials.d.ts.map

package/dist/github/repo.d.ts

@@ -67,4 +67,3 @@ export declare function commitFiles(repo: RepoRef, changes: FileChange[], opts:
     author: CommitAuthor;
 }, token: string): Promise<string>;
 export {};
-//# sourceMappingURL=repo.d.ts.map

package/dist/github/signing.d.ts

@@ -26,4 +26,3 @@ export declare function signingSelfTest(appId: string, privateKeyB64: string): P
     ok: boolean;
     detail?: string;
 }>;
-//# sourceMappingURL=signing.d.ts.map

package/dist/github/types.d.ts

@@ -32,4 +32,3 @@ export declare class CommitConflictError extends Error {
     readonly path: string;
     constructor(path: string);
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { buildMagicLinkMessage, cloudflareSend } from './email.js';
 export type { CairnAdapter, ConceptConfig, FrontmatterField, TextField, TextareaField, DateField, BooleanField, TagsField, FreeTagsField, ValidationResult, BackendConfig, SenderConfig, NavMenuConfig, AssetConfig, RoutingRule, ConceptDescriptor, ConceptUrlPolicy, CairnExtension, CairnRuntime, AdminPanel, FieldTypeDef, } from './content/types.js';
 export { CONCEPT_ROUTING, normalizeConcepts, findConcept } from './content/concepts.js';
 export { composeRuntime } from './content/compose.js';
+export type { ComposeInput } from './content/compose.js';
 export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown, } from './content/frontmatter.js';
 export { defineFields } from './content/schema.js';
 export { defineAdapter } from './content/adapter.js';
@@ -13,8 +14,8 @@ export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, compose
 export type { DatePrefix } from './content/ids.js';
 export { parseCairnToken, extractCairnLinks, formatCairnToken, escapeLinkText } from './content/links.js';
 export type { CairnRef, LinkResolve } from './content/links.js';
-export { serializeManifest, parseManifest, emptyManifest, verifyManifest, upsertEntry, removeEntry, manifestEntryFromFile, manifestLinkResolver, inboundLinks, } from './content/manifest.js';
-export type { Manifest, ManifestEntry, LinkTarget, InboundLink } from './content/manifest.js';
+export { serializeManifest, parseManifest, emptyManifest, verifyManifest, diffManifests, upsertEntry, removeEntry, manifestEntryFromFile, manifestLinkResolver, inboundLinks, } from './content/manifest.js';
+export type { Manifest, ManifestEntry, ManifestDiff, ManifestEntryDiff, LinkTarget, InboundLink } from './content/manifest.js';
 export { defineRegistry, emptyValues } from './render/registry.js';
 export type { ComponentDef, ComponentRegistry, FieldType, AttributeField, SlotKind, SlotDef, ComponentValues, } from './render/registry.js';
 export { serializeComponent, parseComponent } from './render/component-grammar.js';
@@ -26,38 +27,11 @@ 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, cardShell, headRow, markFirstList, } from './render/rehype-dispatch.js';
+export { rehypeDispatch, iconSpan, cardShell, headRow } 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';
 export type { RepoRef, RepoFile, CommitAuthor, AppCredentials } from './github/types.js';
 export { CommitConflictError } from './github/types.js';
-export { appJwt, installationToken, signingSelfTest } from './github/signing.js';
-export { treeUrl, markdownFilesIn, listMarkdown, contentsUrl, readRaw, fileSha, commitFile, } from './github/repo.js';
-export { appCredentials } from './github/credentials.js';
-export type { GithubKeyEnv } from './github/credentials.js';
 export { parseSiteConfig, urlPolicyFrom, 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, 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';
-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 { 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';
-export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './delivery/responses.js';
-export { createPublicRoutes } from './sveltekit/public-routes.js';
-export type { PublicRoutesDeps, ListData, TagData, TagIndexData, EntryData } from './sveltekit/public-routes.js';
-//# sourceMappingURL=index.d.ts.map