@glw907/cairn-cms 0.6.0 → 0.8.0

package/dist/delivery/feeds.js

@@ -0,0 +1,80 @@
+// cairn-cms: RSS and JSON Feed builders (public-delivery design). Pure functions over a
+// channel and a list of items, so they unit-test without a render or a network. The caller
+// (a template +server.ts shim) assembles items from the content index and passes absolute
+// URLs built from PUBLIC_ORIGIN.
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/** Make a string safe inside a CDATA section by splitting any `]]>` across two sections. */
+function cdataSafe(value) {
+    return value.replace(/]]>/g, ']]]]><![CDATA[>');
+}
+/** Format a YYYY-MM-DD (or ISO) string as an RFC-822 date in UTC, as RSS wants. */
+function rfc822(date) {
+    return new Date(`${date.slice(0, 10)}T00:00:00.000Z`).toUTCString();
+}
+/** Format a YYYY-MM-DD (or ISO) string as an ISO-8601 instant in UTC. */
+function iso(date) {
+    return new Date(`${date.slice(0, 10)}T00:00:00.000Z`).toISOString();
+}
+/** Build an RSS 2.0 document. */
+export function buildRssFeed(channel, items) {
+    const entries = items
+        .map((item) => {
+        const content = item.contentHtml ?? item.summary;
+        return [
+            '    <item>',
+            `      <title>${escapeXml(item.title)}</title>`,
+            `      <link>${escapeXml(item.url)}</link>`,
+            `      <guid isPermaLink="true">${escapeXml(item.url)}</guid>`,
+            `      <pubDate>${rfc822(item.date)}</pubDate>`,
+            `      <description>${escapeXml(item.summary)}</description>`,
+            // CDATA cannot contain `]]>`, so split that one sequence rather than escape the body.
+            `      <content:encoded><![CDATA[${cdataSafe(content)}]]></content:encoded>`,
+            '    </item>',
+        ].join('\n');
+    })
+        .join('\n');
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">',
+        '  <channel>',
+        `    <title>${escapeXml(channel.title)}</title>`,
+        `    <link>${escapeXml(channel.siteUrl)}</link>`,
+        `    <description>${escapeXml(channel.description)}</description>`,
+        channel.language ? `    <language>${escapeXml(channel.language)}</language>` : '',
+        `    <atom:link href="${escapeXml(channel.feedUrl)}" rel="self" type="application/rss+xml" />`,
+        entries,
+        '  </channel>',
+        '</rss>',
+        '',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/** Build a JSON Feed 1.1 document. */
+export function buildJsonFeed(channel, items) {
+    return JSON.stringify({
+        version: 'https://jsonfeed.org/version/1.1',
+        title: channel.title,
+        description: channel.description,
+        home_page_url: channel.siteUrl,
+        feed_url: channel.feedUrl,
+        ...(channel.language ? { language: channel.language } : {}),
+        ...(channel.author ? { authors: [channel.author] } : {}),
+        items: items.map((item) => ({
+            id: item.url,
+            url: item.url,
+            title: item.title,
+            summary: item.summary,
+            date_published: iso(item.date),
+            ...(item.updated ? { date_modified: iso(item.updated) } : {}),
+            ...(item.contentHtml ? { content_html: item.contentHtml } : { content_text: item.summary }),
+            ...(item.tags && item.tags.length ? { tags: item.tags } : {}),
+        })),
+    }, null, 2);
+}

package/dist/delivery/paginate.d.ts

@@ -0,0 +1,13 @@
+/** A page of items plus its navigation state. */
+export interface Page<T> {
+    items: T[];
+    page: number;
+    perPage: number;
+    total: number;
+    totalPages: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+}
+/** 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/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/paginate.ts"],"names":[],"mappings":"AAGA,iDAAiD;AACjD,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAgB9E"}

package/dist/delivery/paginate.js

@@ -0,0 +1,20 @@
+// cairn-cms: pagination helper (public-delivery design). Pure slice math; the template renders
+// the controls. An out-of-range page clamps into bounds.
+/** Slice `items` into the 1-based `page` of size `perPage`, clamping the page into bounds. */
+export function paginate(items, page, perPage) {
+    const total = items.length;
+    // A non-positive page size would make totalPages Infinity, so clamp it to one.
+    const size = Math.max(1, Math.floor(perPage) || 1);
+    const totalPages = Math.max(1, Math.ceil(total / size));
+    const current = Math.min(Math.max(1, Math.floor(page) || 1), totalPages);
+    const start = (current - 1) * size;
+    return {
+        items: items.slice(start, start + size),
+        page: current,
+        perPage: size,
+        total,
+        totalPages,
+        hasPrev: current > 1,
+        hasNext: current < totalPages,
+    };
+}

package/dist/delivery/robots.d.ts

@@ -0,0 +1,6 @@
+/** Build a robots.txt body. */
+export declare function buildRobots(opts: {
+    sitemapUrl: string;
+    disallow?: string[];
+}): string;
+//# sourceMappingURL=robots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/robots.ts"],"names":[],"mappings":"AAGA,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAKrF"}

package/dist/delivery/robots.js

@@ -0,0 +1,10 @@
+// cairn-cms: robots.txt builder (public-delivery design). A permissive default that points
+// at the sitemap, with optional disallow rules.
+/** Build a robots.txt body. */
+export function buildRobots(opts) {
+    const lines = ['User-agent: *', 'Allow: /'];
+    for (const path of opts.disallow ?? [])
+        lines.push(`Disallow: ${path}`);
+    lines.push('', `Sitemap: ${opts.sitemapUrl}`, '');
+    return lines.join('\n');
+}

package/dist/delivery/seo.d.ts

@@ -0,0 +1,34 @@
+/** Inputs for the head. All URLs are absolute (built from PUBLIC_ORIGIN). */
+export interface SeoInput {
+    title: string;
+    description: string;
+    canonicalUrl: string;
+    siteName: string;
+    type?: 'website' | 'article';
+    published?: string;
+    modified?: string;
+    feeds?: {
+        rss?: string;
+        json?: string;
+    };
+    image?: string;
+}
+/** Plain-data head: a title, meta tags, link tags, and one JSON-LD object. */
+export interface SeoMeta {
+    title: string;
+    meta: {
+        name?: string;
+        property?: string;
+        content: string;
+    }[];
+    links: {
+        rel: string;
+        type?: string;
+        href: string;
+        title?: string;
+    }[];
+    jsonLd: Record<string, unknown>;
+}
+/** Build the head data for a page. */
+export declare function buildSeoMeta(input: SeoInput): SeoMeta;
+//# sourceMappingURL=seo.d.ts.map

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

@@ -0,0 +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"}

package/dist/delivery/seo.js

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

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

@@ -0,0 +1,28 @@
+import type { ConceptDescriptor } from '../content/types.js';
+import type { ContentEntry, ContentIndex, ContentSummary } from './content-index.js';
+/** One concept's descriptor paired with its built index. */
+export interface ConceptIndex {
+    descriptor: ConceptDescriptor;
+    index: ContentIndex;
+}
+/** The cross-concept query surface a catch-all route and the sitemap read. */
+export interface SiteIndex {
+    /** Resolve a request path (with or without a trailing slash) to its entry, or undefined. */
+    byPermalink(path: string): ContentEntry | undefined;
+    /** Newer/older neighbors within the entry's own concept, for prev/next links. */
+    adjacent(entry: ContentSummary): {
+        newer?: ContentSummary;
+        older?: ContentSummary;
+    };
+    /** Every entry's path across concepts, leading slash stripped, for SvelteKit `[...path]` prerender. */
+    entries(): {
+        path: string;
+    }[];
+    /** One concept's index, for its archive, tag, and feed loaders. */
+    concept(id: string): ContentIndex | undefined;
+    /** 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;
+//# sourceMappingURL=site-index.d.ts.map

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

@@ -0,0 +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"}

package/dist/delivery/site-index.js

@@ -0,0 +1,38 @@
+/** Strip a trailing slash from a path, keeping the root "/" intact. */
+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) {
+    const byPath = new Map();
+    const byId = new Map();
+    for (const { descriptor, index } of concepts) {
+        byId.set(descriptor.id, index);
+        for (const summary of index.all()) {
+            const existing = byPath.get(summary.permalink);
+            if (existing) {
+                throw new Error(`site index: "${existing.id}" and "${summary.id}" both resolve to "${summary.permalink}"`);
+            }
+            byPath.set(summary.permalink, { index, id: summary.id });
+        }
+    }
+    return {
+        byPermalink(path) {
+            const hit = byPath.get(normalizePath(path));
+            return hit ? hit.index.byId(hit.id) : undefined;
+        },
+        adjacent(entry) {
+            const hit = byPath.get(entry.permalink);
+            return hit ? hit.index.adjacent(entry.id) : {};
+        },
+        entries() {
+            return [...byPath.keys()].map((p) => ({ path: p.replace(/^\//, '') }));
+        },
+        concept(id) {
+            return byId.get(id);
+        },
+        all() {
+            return concepts.flatMap(({ index }) => index.all());
+        },
+    };
+}

package/dist/delivery/sitemap.d.ts

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

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

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

package/dist/delivery/sitemap.js

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

package/dist/index.d.ts

@@ -2,12 +2,13 @@ export { requireOrigin } from './env.js';
 export type { Role, Editor, AuthEnv } from './auth/types.js';
 export type { AuthBranding, MagicLinkMessage, SendMagicLink } from './email.js';
 export { buildMagicLinkMessage, cloudflareSend } from './email.js';
-export type { CairnAdapter, ConceptConfig, FrontmatterField, TextField, TextareaField, DateField, BooleanField, TagsField, FreeTagsField, ValidationResult, BackendConfig, SenderConfig, NavMenuConfig, AssetConfig, RoutingRule, ConceptDescriptor, CairnExtension, CairnRuntime, AdminPanel, FieldTypeDef, } from './content/types.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 { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown, } from './content/frontmatter.js';
 export { validateFields } from './content/validate.js';
-export { isValidId, idFromFilename, filenameFromId, slugify } from './content/ids.js';
+export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, composeDatedId, } from './content/ids.js';
+export type { DatePrefix } from './content/ids.js';
 export { defineRegistry } from './render/registry.js';
 export type { ComponentDef, ComponentRegistry } from './render/registry.js';
 export { glyph } from './render/glyph.js';
@@ -23,6 +24,21 @@ 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, extractMenu, setMenu, validateNavTree, MAX_NAV_NODES, NavValidationError, SiteConfigError, } from './nav/site-config.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, } from './delivery/content-index.js';
+export { createSiteIndex } from './delivery/site-index.js';
+export type { SiteIndex, ConceptIndex } from './delivery/site-index.js';
+export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
+export type { FeedChannel, FeedItem } from './delivery/feeds.js';
+export { buildSitemap } from './delivery/sitemap.js';
+export type { SitemapUrl } from './delivery/sitemap.js';
+export { buildRobots } from './delivery/robots.js';
+export { buildSeoMeta } from './delivery/seo.js';
+export type { SeoInput, SeoMeta } from './delivery/seo.js';
+export { paginate } from './delivery/paginate.js';
+export type { Page } from './delivery/paginate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,7 +6,7 @@ export { CONCEPT_ROUTING, normalizeConcepts, findConcept } from './content/conce
 export { composeRuntime } from './content/compose.js';
 export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown, } from './content/frontmatter.js';
 export { validateFields } from './content/validate.js';
-export { isValidId, idFromFilename, filenameFromId, slugify } from './content/ids.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 } from './render/registry.js';
 export { glyph } from './render/glyph.js';
@@ -18,4 +18,16 @@ 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';
 // Nav tree and site-config helpers (Plan 06).
-export { parseSiteConfig, extractMenu, setMenu, validateNavTree, MAX_NAV_NODES, NavValidationError, SiteConfigError, } from './nav/site-config.js';
+export { parseSiteConfig, urlPolicyFrom, extractMenu, setMenu, validateNavTree, MAX_NAV_NODES, NavValidationError, SiteConfigError, } from './nav/site-config.js';
+// Public content delivery (public-delivery design): the query index, syndication, and
+// discovery surface that sites read. Pure builders plus the one permalink resolver; the
+// SvelteKit loaders live under the /sveltekit subpath.
+export { permalink } from './content/permalink.js';
+export { createContentIndex, fromGlob } from './delivery/content-index.js';
+export { createSiteIndex } from './delivery/site-index.js';
+export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
+export { buildSitemap } from './delivery/sitemap.js';
+export { buildRobots } from './delivery/robots.js';
+export { buildSeoMeta } from './delivery/seo.js';
+export { paginate } from './delivery/paginate.js';

package/dist/nav/site-config.d.ts

@@ -1,3 +1,4 @@
+import type { ConceptUrlPolicy } from '../content/types.js';
 /** One navigation node. An omitted or empty `url` is a label-only grouping header; no `children` is a leaf. */
 export interface NavNode {
     label: string;
@@ -31,6 +32,8 @@ export interface SiteConfig {
     locale?: string;
     /** Named navigation menus, each a NavNode[] (normalized by extractMenu). */
     menus?: Record<string, unknown>;
+    /** Per-concept URL policy: the permalink pattern and date-prefix granularity, keyed by concept id. */
+    content?: Record<string, ConceptUrlPolicy>;
     [key: string]: unknown;
 }
 export declare class SiteConfigError extends Error {
@@ -40,6 +43,8 @@ export declare class SiteConfigError extends Error {
 export declare function parseSiteConfig(raw: string): SiteConfig;
 /** Extract one named menu from a parsed config and validate it. Returns [] when the menu is absent. */
 export declare function extractMenu(config: SiteConfig, name: string, maxDepth: number): NavNode[];
+/** The per-concept URL policy from a parsed config, or an empty policy when the `content` key is absent. */
+export declare function urlPolicyFrom(config: SiteConfig): Record<string, ConceptUrlPolicy>;
 /**
  * Replace one named menu in the YAML site-config text and reserialize, preserving every other
  * top-level key (siteName, other menus, settings). Parses into a Document so the rest of the file

package/dist/nav/site-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-config.d.ts","sourceRoot":"","sources":["../../src/lib/nav/site-config.ts"],"names":[],"mappings":"AAMA,+GAA+G;AAC/G,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,+CAA+C;AAC/C,eAAO,MAAM,cAAc,OAAO,CAAC;AAKnC,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA6B3E;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAUvD;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAIzF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAO1E"}
+{"version":3,"file":"site-config.d.ts","sourceRoot":"","sources":["../../src/lib/nav/site-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,+GAA+G;AAC/G,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,+CAA+C;AAC/C,eAAO,MAAM,cAAc,OAAO,CAAC;AAKnC,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA6B3E;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAUvD;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAIzF;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAO1E"}

package/dist/nav/site-config.js

@@ -84,6 +84,10 @@ export function extractMenu(config, name, maxDepth) {
         return [];
     return validateNavTree(menu, maxDepth);
 }
+/** The per-concept URL policy from a parsed config, or an empty policy when the `content` key is absent. */
+export function urlPolicyFrom(config) {
+    return config.content ?? {};
+}
 /**
  * Replace one named menu in the YAML site-config text and reserialize, preserving every other
  * top-level key (siteName, other menus, settings). Parses into a Document so the rest of the file

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

@@ -1 +1 @@
-{"version":3,"file":"content-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/content-routes.ts"],"names":[],"mappings":"AAQA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7E,OAAO,KAAK,EAAE,YAAY,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAErD,wGAAwG;AACxG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yGAAyG;IACzG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,6FAA6F;AAC7F,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAgBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,GAAE,iBAAsB;wBAK1D,YAAY,KAAG,UAAU;yBAa1B,KAAK;sBAqBA,YAAY,KAAG,OAAO,CAAC,QAAQ,CAAC;0BAqB5B,YAAY,KAAG,OAAO,CAAC,KAAK,CAAC;sBA+BjC,YAAY,KAAG,OAAO,CAAC,QAAQ,CAAC;wBAgC9B,YAAY,KAAG,OAAO,CAAC,KAAK,CAAC;qBA5I5C,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC;EAqLnD"}
+{"version":3,"file":"content-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/content-routes.ts"],"names":[],"mappings":"AAQA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7E,OAAO,KAAK,EAAE,YAAY,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAErD,wGAAwG;AACxG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yGAAyG;IACzG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,6FAA6F;AAC7F,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAgBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,GAAE,iBAAsB;wBAK1D,YAAY,KAAG,UAAU;yBAa1B,KAAK;sBAqBA,YAAY,KAAG,OAAO,CAAC,QAAQ,CAAC;0BAqB5B,YAAY,KAAG,OAAO,CAAC,KAAK,CAAC;sBAyCjC,YAAY,KAAG,OAAO,CAAC,QAAQ,CAAC;wBAgC9B,YAAY,KAAG,OAAO,CAAC,KAAK,CAAC;qBAtJ5C,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC;EA+LnD"}

package/dist/sveltekit/content-routes.js

@@ -5,7 +5,7 @@
 import { redirect, error } from '@sveltejs/kit';
 import { findConcept } from '../content/concepts.js';
 import { frontmatterFromForm, parseMarkdown, dateInputValue, serializeMarkdown } from '../content/frontmatter.js';
-import { isValidId, slugify, filenameFromId } from '../content/ids.js';
+import { isValidId, slugify, filenameFromId, composeDatedId } from '../content/ids.js';
 import { appCredentials } from '../github/credentials.js';
 import { listMarkdown, readRaw, commitFile } from '../github/repo.js';
 import { installationToken } from '../github/signing.js';
@@ -82,22 +82,32 @@ export function createContentRoutes(runtime, deps = {}) {
             return { ...base, entries: [], error: 'Could not load this content type from GitHub.' };
         }
     }
-    /** Create a new entry: validate the slug, refuse to clobber, and redirect to the editor. */
+    /** Create a new entry: validate the slug, compose a dated id when the concept is dated, refuse to clobber. */
     async function createAction(event) {
         sessionOf(event);
         const concept = conceptOf(runtime, event.params);
         const form = await event.request.formData();
-        const raw = String(form.get('slug') ?? '').trim() || slugify(String(form.get('title') ?? ''));
+        const slug = String(form.get('slug') ?? '').trim() || slugify(String(form.get('title') ?? ''));
+        const date = String(form.get('date') ?? '').trim();
         const bounce = (msg) => {
             throw redirect(303, `/admin/${concept.id}?error=${encodeURIComponent(msg)}`);
         };
-        if (!isValidId(raw))
-            bounce('Enter a valid slug: lowercase letters, numbers, and hyphens.');
+        if (!isValidId(slug))
+            return bounce('Enter a valid slug: lowercase letters, numbers, and hyphens.');
+        let id = slug;
+        if (concept.routing.dated) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(date))
+                return bounce('Pick a date for this entry.');
+            if (/^\d{4}-/.test(slug)) {
+                return bounce('Leave the date out of the slug; set it in the date field.');
+            }
+            id = composeDatedId(date, slug, concept.datePrefix);
+        }
         const token = await mintToken(event.platform?.env ?? {});
-        const existing = await readRaw(runtime.backend, `${concept.dir}/${filenameFromId(raw)}`, token);
+        const existing = await readRaw(runtime.backend, `${concept.dir}/${filenameFromId(id)}`, token);
         if (existing !== null)
-            bounce('An entry with that slug already exists.');
-        throw redirect(303, `/admin/${concept.id}/${raw}?new=1`);
+            return bounce('An entry with that slug already exists.');
+        throw redirect(303, `/admin/${concept.id}/${id}?new=1`);
     }
     /** Coerce parsed frontmatter to the form-ready values the editor inputs expect. */
     function formValues(fields, frontmatter) {

package/dist/sveltekit/index.d.ts

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

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

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

package/dist/sveltekit/index.js

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"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"}