@krantho/core 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cache-headers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Response headers for a page a CDN caches, and for an editor's preview.
+ *
+ * A cached page is fresh at the CDN for `s-maxage` and never in the browser
+ * (`max-age=0`), so a purge reaches every visitor. It carries the tags of every read that
+ * rendered it, within the strictest per-response tag limit across CDNs.
+ */
+/** The CDN in front of the site */
+export type CdnProvider = 'vercel' | 'cloudfront' | 'gcp';
+/** What `cdnCacheHeaders` needs to cache a page */
+export interface CdnCacheHeaderOptions {
+    /** Tags of every read that rendered the page */
+    tags: readonly string[];
+    provider: CdnProvider;
+    /** How long the CDN serves the page as fresh */
+    sMaxAgeSec: number;
+    /** How long after that the CDN serves it while it re-renders */
+    staleWhileRevalidateSec: number;
+    /** The response header the CloudFront distribution reads tags from */
+    tagHeader: string;
+}
+/**
+ * Fit a page's tags into a CDN's per-response limit. Duplicates are dropped;
+ * beyond the budget, document tags give way to their collection's tag (a
+ * change to any document in it then refreshes the page), then the rest is cut.
+ * `k:site` is always kept, so a site-wide change still reaches the page.
+ */
+export declare function pageTagBudget(tags: readonly string[], max?: number): string[];
+/**
+ * The headers that cache a page at the CDN, tagged for purging. Vercel and
+ * Cloud CDN read the CDN lifetime from their own header, beside a
+ * `Cache-Control` that keeps the page out of the browser. CloudFront reads
+ * lifetimes only from `Cache-Control`, so there the lifetime is `s-maxage` in
+ * `Cache-Control` itself — browsers ignore it and revalidate every visit.
+ */
+export declare function cdnCacheHeaders(options: CdnCacheHeaderOptions): Record<string, string>;
+/** The headers of an editor's preview: never stored, never indexed */
+export declare function previewHeaders(): Record<string, string>;
+//# sourceMappingURL=cache-headers.d.ts.map

package/dist/cache-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-headers.d.ts","sourceRoot":"","sources":["../src/cache-headers.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAA;AAEzD,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,QAAQ,EAAE,WAAW,CAAA;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,uBAAuB,EAAE,MAAM,CAAA;IAC/B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAA;CAClB;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,SAAqB,GAAG,MAAM,EAAE,CAOzF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYtF;AAED,sEAAsE;AACtE,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD"}

package/dist/cache-headers.js

@@ -0,0 +1,57 @@
+import { collectionTagOf, SITE_TAG } from './cache-tags.js';
+const DEFAULT_TAG_BUDGET = 50;
+/**
+ * Fit a page's tags into a CDN's per-response limit. Duplicates are dropped;
+ * beyond the budget, document tags give way to their collection's tag (a
+ * change to any document in it then refreshes the page), then the rest is cut.
+ * `k:site` is always kept, so a site-wide change still reaches the page.
+ */
+export function pageTagBudget(tags, max = DEFAULT_TAG_BUDGET) {
+    const unique = [...new Set(tags)];
+    if (unique.length <= max)
+        return unique;
+    const collapsed = [...new Set(unique.map((tag) => collectionTagOf(tag) ?? tag))];
+    if (collapsed.length <= max)
+        return collapsed;
+    if (!collapsed.includes(SITE_TAG))
+        return collapsed.slice(0, max);
+    return [SITE_TAG, ...collapsed.filter((tag) => tag !== SITE_TAG).slice(0, max - 1)];
+}
+/**
+ * The headers that cache a page at the CDN, tagged for purging. Vercel and
+ * Cloud CDN read the CDN lifetime from their own header, beside a
+ * `Cache-Control` that keeps the page out of the browser. CloudFront reads
+ * lifetimes only from `Cache-Control`, so there the lifetime is `s-maxage` in
+ * `Cache-Control` itself — browsers ignore it and revalidate every visit.
+ */
+export function cdnCacheHeaders(options) {
+    const lifetime = `s-maxage=${options.sMaxAgeSec}, stale-while-revalidate=${options.staleWhileRevalidateSec}`;
+    const headers = options.provider === 'cloudfront'
+        ? { 'Cache-Control': `public, max-age=0, ${lifetime}` }
+        : {
+            'Cache-Control': 'public, max-age=0, must-revalidate',
+            [cdnControlHeader(options.provider)]: `public, ${lifetime}`,
+        };
+    const tags = pageTagBudget(options.tags);
+    if (tags.length > 0)
+        headers[tagHeaderFor(options)] = tags.join(',');
+    return headers;
+}
+/** The headers of an editor's preview: never stored, never indexed */
+export function previewHeaders() {
+    return { 'Cache-Control': 'private, no-store', 'X-Robots-Tag': 'noindex' };
+}
+function cdnControlHeader(provider) {
+    return provider === 'vercel' ? 'Vercel-CDN-Cache-Control' : 'CDN-Cache-Control';
+}
+function tagHeaderFor(options) {
+    switch (options.provider) {
+        case 'vercel':
+            return 'Vercel-Cache-Tag';
+        case 'cloudfront':
+            return options.tagHeader;
+        case 'gcp':
+            return 'Cache-Tag';
+    }
+}
+//# sourceMappingURL=cache-headers.js.map

package/dist/cache-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-headers.js","sourceRoot":"","sources":["../src/cache-headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AA0B3D,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB,EAAE,GAAG,GAAG,kBAAkB;IAC7E,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACjC,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,MAAM,CAAA;IACvC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;IAChF,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,SAAS,CAAA;IAC7C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACjE,OAAO,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AACrF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAA8B;IAC5D,MAAM,QAAQ,GAAG,YAAY,OAAO,CAAC,UAAU,4BAA4B,OAAO,CAAC,uBAAuB,EAAE,CAAA;IAC5G,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,YAAY;QAC/B,CAAC,CAAC,EAAE,eAAe,EAAE,sBAAsB,QAAQ,EAAE,EAAE;QACvD,CAAC,CAAC;YACE,eAAe,EAAE,oCAAoC;YACrD,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,QAAQ,EAAE;SAC5D,CAAA;IACP,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACpE,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,SAAS,EAAE,CAAA;AAC5E,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA4C;IACpE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,mBAAmB,CAAA;AACjF,CAAC;AAED,SAAS,YAAY,CAAC,OAA8B;IAClD,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAA;QAC3B,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,SAAS,CAAA;QAC1B,KAAK,KAAK;YACR,OAAO,WAAW,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/cache-tags.d.ts

@@ -0,0 +1,88 @@
+import type { ContentChange } from './content-change.js';
+/**
+ * The cache tag vocabulary: what a page read registers, and what a change
+ * invalidates. A cached page carries the tags of every read that rendered it,
+ * so invalidating a tag refreshes exactly the pages that read it.
+ *
+ * Tags fit the strictest limits across cache targets: printable ASCII with no
+ * comma or space, lowercase (some CDNs match tags case-insensitively), at most
+ * 120 bytes (a longer tag is shortened with a hash).
+ */
+/** Carried by every read: a site-wide change refreshes every page */
+export declare const SITE_TAG = "k:site";
+/** How an invalidated page is refreshed */
+export type InvalidationMode = 
+/** The next request renders it fresh: for the document an editor just changed */
+'expire'
+/** The next request is served the old page while it re-renders: for broad changes */
+ | 'stale';
+/** Tags to invalidate, and how */
+export interface CacheInvalidation {
+    tags: readonly string[];
+    mode: InvalidationMode;
+}
+/** One document, in every locale */
+export declare function documentTag(collection: string, slug: string): string;
+/** A collection's membership: its lists, and every page that lists it */
+export declare function collectionTag(collection: string): string;
+/** One SEO configuration (`site`, `collection:<name>`, `route:<pattern>`); every configuration without one */
+export declare function seoTag(configId?: string): string;
+/** The tags a document read registers */
+export declare function documentReadTags(collection: string, slug: string): string[];
+/** The tags a collection list read registers */
+export declare function listReadTags(collection: string): string[];
+/** The tags an SEO configuration read registers */
+export declare function seoReadTags(configId: string): string[];
+/**
+ * The collection tag a document tag belongs to, or null for any other tag (or a
+ * document tag whose collection was cut by shortening)
+ */
+export declare function collectionTagOf(documentTagValue: string): string | null;
+/**
+ * The tags a page's JSON-LD reads: the document, which holds its own SEO in its
+ * versioned metadata, and the site, collection and URL-pattern configurations
+ * it is composed from
+ */
+export declare function jsonLdTags(collection: string, slug: string): string[];
+/**
+ * Where a collection's documents render as pages: a pattern holding `:slug`
+ * (`/deploy/:slug`), a fixed path every document of the collection renders at
+ * (a singleton such as a landing page, `/`), or `false` for a collection whose
+ * documents have no page of their own.
+ */
+export type CollectionPath = string | false;
+/** What `documentPath()` reads of a collection: its name, and the `path` it declares */
+export interface PageCollection {
+    readonly name: string;
+    readonly path?: CollectionPath | undefined;
+}
+/**
+ * A collection by name from a site's collections — or, for a name the site does
+ * not define, a collection with no declared `path`, which the default rule places.
+ */
+export declare function pageCollection(collections: Readonly<Record<string, PageCollection>>, name: string): PageCollection;
+/**
+ * Whether a collection's documents render as pages. Without a declared `path`,
+ * every collection does except `globals`.
+ */
+export declare function rendersPages(collection: PageCollection): boolean;
+/**
+ * The URL path a document is rendered at, or null when its collection has no
+ * pages. A collection's `path` decides: `:slug` is replaced by the slug, and the
+ * slug `index` renders at the pattern without its `/:slug` segment
+ * (`/docs/:slug` → `/docs`); a path without `:slug` is where every document of
+ * the collection renders. Without a `path`, `pages` render at the site root
+ * (`home` is `/`), `globals` have no page, and other collections render under
+ * their name.
+ */
+export declare function documentPath(collection: PageCollection, slug: string): string | null;
+/**
+ * Where a collection's pages live, for labelling the collection: null when it
+ * has no pages; a declared `path` without its `/:slug` segment (an empty
+ * remainder is `/`); without a `path`, `/` for `pages` and `/<name>` for any
+ * other collection.
+ */
+export declare function collectionBasePath(collection: PageCollection): string | null;
+/** What a change invalidates. A draft save and a media change leave rendered pages as they are. */
+export declare function invalidationsFor(change: ContentChange): CacheInvalidation[];
+//# sourceMappingURL=cache-tags.d.ts.map

package/dist/cache-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.d.ts","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;;;;GAQG;AAEH,qEAAqE;AACrE,eAAO,MAAM,QAAQ,WAAW,CAAA;AAEhC,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB;AAC1B,iFAAiF;AAC/E,QAAQ;AACV,qFAAqF;GACnF,OAAO,CAAA;AAEX,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAKD,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,8GAA8G;AAC9G,wBAAgB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3E;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvE;AAKD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CASrE;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAA;AAE3C,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAC3C;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACrD,IAAI,EAAE,MAAM,GACX,cAAc,CAEhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAK5E;AASD,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAyB3E"}

package/dist/cache-tags.js

@@ -0,0 +1,182 @@
+/**
+ * The cache tag vocabulary: what a page read registers, and what a change
+ * invalidates. A cached page carries the tags of every read that rendered it,
+ * so invalidating a tag refreshes exactly the pages that read it.
+ *
+ * Tags fit the strictest limits across cache targets: printable ASCII with no
+ * comma or space, lowercase (some CDNs match tags case-insensitively), at most
+ * 120 bytes (a longer tag is shortened with a hash).
+ */
+/** Carried by every read: a site-wide change refreshes every page */
+export const SITE_TAG = 'k:site';
+const MAX_TAG_LENGTH = 120;
+const DOCUMENT_TAG_PREFIX = 'k:d:';
+/** One document, in every locale */
+export function documentTag(collection, slug) {
+    return tag(`${DOCUMENT_TAG_PREFIX}${part(collection)}:${part(slug)}`);
+}
+/** A collection's membership: its lists, and every page that lists it */
+export function collectionTag(collection) {
+    return tag(`k:c:${part(collection)}`);
+}
+/** One SEO configuration (`site`, `collection:<name>`, `route:<pattern>`); every configuration without one */
+export function seoTag(configId) {
+    return configId === undefined ? 'k:seo' : tag(`k:seo:${part(configId)}`);
+}
+/** The tags a document read registers */
+export function documentReadTags(collection, slug) {
+    return [SITE_TAG, documentTag(collection, slug)];
+}
+/** The tags a collection list read registers */
+export function listReadTags(collection) {
+    return [SITE_TAG, collectionTag(collection)];
+}
+/** The tags an SEO configuration read registers */
+export function seoReadTags(configId) {
+    const tags = [SITE_TAG, seoTag(), seoTag(configId)];
+    if (configId.startsWith('doc:')) {
+        const identity = configId.slice(4);
+        const separator = identity.indexOf('/');
+        if (separator > 0 && separator < identity.length - 1) {
+            tags.push(documentTag(identity.slice(0, separator), identity.slice(separator + 1)));
+        }
+    }
+    return tags;
+}
+/**
+ * The collection tag a document tag belongs to, or null for any other tag (or a
+ * document tag whose collection was cut by shortening)
+ */
+export function collectionTagOf(documentTagValue) {
+    if (!documentTagValue.startsWith(DOCUMENT_TAG_PREFIX))
+        return null;
+    const end = documentTagValue.indexOf(':', DOCUMENT_TAG_PREFIX.length);
+    if (end === -1)
+        return null;
+    // The segment is already `part()`-encoded: the same one `collectionTag` builds
+    return tag(`k:c:${documentTagValue.slice(DOCUMENT_TAG_PREFIX.length, end)}`);
+}
+/** The tag every page's JSON-LD carries for the URL-pattern configurations: which patterns match is known only when the page composes */
+const ROUTE_CONFIGS_TAG = 'route';
+/**
+ * The tags a page's JSON-LD reads: the document, which holds its own SEO in its
+ * versioned metadata, and the site, collection and URL-pattern configurations
+ * it is composed from
+ */
+export function jsonLdTags(collection, slug) {
+    return [
+        SITE_TAG,
+        documentTag(collection, slug),
+        seoTag(),
+        seoTag('site'),
+        seoTag(`collection:${collection}`),
+        seoTag(ROUTE_CONFIGS_TAG),
+    ];
+}
+const SLUG_PARAM = ':slug';
+/**
+ * A collection by name from a site's collections — or, for a name the site does
+ * not define, a collection with no declared `path`, which the default rule places.
+ */
+export function pageCollection(collections, name) {
+    return collections[name] ?? { name };
+}
+/**
+ * Whether a collection's documents render as pages. Without a declared `path`,
+ * every collection does except `globals`.
+ */
+export function rendersPages(collection) {
+    if (collection.path !== undefined)
+        return collection.path !== false;
+    return collection.name !== 'globals';
+}
+/**
+ * The URL path a document is rendered at, or null when its collection has no
+ * pages. A collection's `path` decides: `:slug` is replaced by the slug, and the
+ * slug `index` renders at the pattern without its `/:slug` segment
+ * (`/docs/:slug` → `/docs`); a path without `:slug` is where every document of
+ * the collection renders. Without a `path`, `pages` render at the site root
+ * (`home` is `/`), `globals` have no page, and other collections render under
+ * their name.
+ */
+export function documentPath(collection, slug) {
+    if (!rendersPages(collection))
+        return null;
+    const { name, path } = collection;
+    if (typeof path === 'string')
+        return fillPath(path, slug);
+    if (name === 'pages')
+        return slug === 'home' ? '/' : `/${slug}`;
+    return `/${name}/${slug}`;
+}
+/**
+ * Where a collection's pages live, for labelling the collection: null when it
+ * has no pages; a declared `path` without its `/:slug` segment (an empty
+ * remainder is `/`); without a `path`, `/` for `pages` and `/<name>` for any
+ * other collection.
+ */
+export function collectionBasePath(collection) {
+    if (!rendersPages(collection))
+        return null;
+    const { name, path } = collection;
+    if (typeof path === 'string')
+        return path.replace(`/${SLUG_PARAM}`, '') || '/';
+    return name === 'pages' ? '/' : `/${name}`;
+}
+function fillPath(pattern, slug) {
+    if (!pattern.includes(SLUG_PARAM))
+        return pattern;
+    const segment = `/${SLUG_PARAM}`;
+    if (slug === 'index' && pattern.includes(segment))
+        return pattern.replace(segment, '') || '/';
+    return pattern.replaceAll(SLUG_PARAM, slug);
+}
+/** What a change invalidates. A draft save and a media change leave rendered pages as they are. */
+export function invalidationsFor(change) {
+    switch (change.kind) {
+        case 'document':
+            if (!change.live)
+                return [];
+            return [
+                // A global is on every page: refresh them as they are visited, not all on the next request
+                {
+                    tags: [documentTag(change.collection, change.slug)],
+                    mode: change.collection === 'globals' ? 'stale' : 'expire',
+                },
+                { tags: [collectionTag(change.collection)], mode: 'stale' },
+            ];
+        case 'seo':
+            if (change.configId === undefined)
+                return [{ tags: [seoTag()], mode: 'stale' }];
+            // A URL pattern can match any page: every page's JSON-LD refreshes as it is visited
+            if (change.configId.startsWith('route:')) {
+                return [{ tags: [seoTag(ROUTE_CONFIGS_TAG)], mode: 'stale' }];
+            }
+            return [{ tags: [seoTag(change.configId)], mode: 'stale' }];
+        case 'media':
+            // Pages embed a media URL, never the asset record; the file is served fresh
+            return [];
+        case 'site':
+            return [{ tags: [SITE_TAG], mode: 'stale' }];
+    }
+}
+/** A tag segment: lowercase, and percent-encoded outside unreserved ASCII. `Foo` and `foo` share a tag — at worst a page is refreshed needlessly. */
+function part(value) {
+    return encodeURIComponent(value.toLowerCase()).toLowerCase();
+}
+function tag(value) {
+    if (value.length <= MAX_TAG_LENGTH)
+        return value;
+    const hash = fnv1a(value);
+    return `${value.slice(0, MAX_TAG_LENGTH - hash.length - 1)}~${hash}`;
+}
+/** A short, stable hash (FNV-1a, 32-bit) — no platform crypto, so core stays portable */
+function fnv1a(value) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < value.length; i++) {
+        hash ^= value.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=cache-tags.js.map

package/dist/cache-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.js","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"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"}

package/dist/canonical-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * JSON with object keys sorted by code unit at every depth, so equal values
+ * serialize identically on every machine. Undefined object properties are
+ * left out, as JSON.stringify does; array order is part of the value.
+ */
+export declare function canonicalJson(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../src/canonical-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUpD"}

package/dist/canonical-json.js

@@ -0,0 +1,19 @@
+/**
+ * JSON with object keys sorted by code unit at every depth, so equal values
+ * serialize identically on every machine. Undefined object properties are
+ * left out, as JSON.stringify does; array order is part of the value.
+ */
+export function canonicalJson(value) {
+    if (value instanceof Date)
+        return JSON.stringify(value.toISOString());
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../src/canonical-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACrE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IAC1E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACzG,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;AACxC,CAAC"}

package/dist/composition/index.d.ts

@@ -0,0 +1,5 @@
+export { resolveParams } from './params.js';
+export type { ResolveContext } from './resolve.js';
+export { resolvePageContent } from './resolve.js';
+export type { CollectionItem, CollectionResult, ResolvedPageContent, SectionItem, SectionsResult, SlugResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAA"}

package/dist/composition/index.js

@@ -0,0 +1,3 @@
+export { resolveParams } from './params.js';
+export { resolvePageContent } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/composition/params.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve dynamic :param segments in a string using provided params.
+ *
+ * @example
+ * ```ts
+ * resolveParams('blog/:slug', { slug: 'my-post' })  // 'blog/my-post'
+ * resolveParams(':slug', { slug: 'hello' })          // 'hello'
+ * resolveParams('home', {})                          // 'home' (no params)
+ * ```
+ */
+export declare function resolveParams(template: string, params?: Record<string, string>): string;
+//# sourceMappingURL=params.d.ts.map

package/dist/composition/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/composition/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAYvF"}

package/dist/composition/params.js

@@ -0,0 +1,23 @@
+/**
+ * Resolve dynamic :param segments in a string using provided params.
+ *
+ * @example
+ * ```ts
+ * resolveParams('blog/:slug', { slug: 'my-post' })  // 'blog/my-post'
+ * resolveParams(':slug', { slug: 'hello' })          // 'hello'
+ * resolveParams('home', {})                          // 'home' (no params)
+ * ```
+ */
+export function resolveParams(template, params) {
+    if (!params || !template.includes(':')) {
+        return template;
+    }
+    return template.replace(/:(\w+)/g, (match, key) => {
+        const value = params[key];
+        if (value === undefined) {
+            throw new Error(`Missing param "${key}" for template "${template}"`);
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=params.js.map

package/dist/composition/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/composition/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAA+B;IAC7E,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAa,CAAC,CAAA;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,mBAAmB,QAAQ,GAAG,CAAC,CAAA;QACtE,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/composition/resolve.d.ts

@@ -0,0 +1,32 @@
+import type { ContentRef as DocumentRef, IPublishedContentLoader } from '../types.js';
+import type { ResolvedPageContent } from './types.js';
+interface SlugRef extends DocumentRef {
+    readonly type: 'slug';
+}
+interface SectionsRef extends DocumentRef {
+    readonly type: 'sections';
+    readonly names: readonly string[] | '*';
+}
+interface CollectionRef {
+    readonly type: 'collection';
+    readonly collection: string;
+    readonly locale?: string | undefined;
+    readonly options: {
+        sort?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        exclude?: string | undefined;
+    };
+}
+interface PageDefinition {
+    readonly route: string;
+    readonly content: Readonly<Record<string, SlugRef | SectionsRef | CollectionRef>>;
+}
+/** The server loader owns published reads, preview isolation and dependency tags. */
+export interface ResolveContext {
+    loader: IPublishedContentLoader;
+}
+/** Explicit collection identity prevents collisions; visitors only receive published revisions. */
+export declare function resolvePageContent(page: PageDefinition, context: ResolveContext, params?: Record<string, string>): Promise<ResolvedPageContent>;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/composition/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/composition/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,IAAI,WAAW,EACzB,uBAAuB,EAExB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAkB,mBAAmB,EAA8B,MAAM,YAAY,CAAA;AAEjG,UAAU,OAAQ,SAAQ,WAAW;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AACD,UAAU,WAAY,SAAQ,WAAW;IACvC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAA;CACxC;AACD,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE;QAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AACD,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC,CAAC,CAAA;CAClF;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAiBD,mGAAmG;AACnG,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwB9B"}

package/dist/composition/resolve.js

@@ -0,0 +1,61 @@
+import { renderContent } from '../content-engine.js';
+import { resolveParams } from './params.js';
+async function rendered(document) {
+    const { html, sections } = await renderContent(document.fields, document.body, {
+        atNotation: false,
+    });
+    return { fields: document.fields, metadata: document.metadata, html, sections };
+}
+function sectionsOf(content, names) {
+    return (names === '*' ? Object.keys(content.sections) : names).map((name) => ({
+        name,
+        title: name.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
+        html: content.sections[name] ?? '',
+    }));
+}
+/** Explicit collection identity prevents collisions; visitors only receive published revisions. */
+export async function resolvePageContent(page, context, params) {
+    const cache = new Map();
+    const load = (ref) => {
+        const resolved = { ...ref, slug: resolveParams(ref.slug, params) };
+        const key = JSON.stringify([resolved.collection, resolved.slug, resolved.locale]);
+        let promise = cache.get(key);
+        if (!promise) {
+            promise = context.loader
+                .getPublished(resolved)
+                .then((document) => (document ? rendered(document) : null));
+            cache.set(key, promise);
+        }
+        return promise;
+    };
+    const entries = await Promise.all(Object.entries(page.content).map(async ([key, ref]) => {
+        if (ref.type === 'collection')
+            return [key, await resolveCollection(ref, context.loader, params)];
+        const content = await load(ref);
+        if (!content)
+            return [key, null];
+        return [key, ref.type === 'sections' ? sectionsOf(content, ref.names) : content];
+    }));
+    return Object.fromEntries(entries);
+}
+async function resolveCollection(ref, loader, params) {
+    const exclude = ref.options.exclude ? resolveParams(ref.options.exclude, params) : undefined;
+    const documents = await loader.listPublished(ref.collection, ref.locale);
+    let items = await Promise.all(documents
+        .filter((document) => document.slug !== exclude)
+        .map(async (document) => ({
+        slug: document.slug,
+        ...(await rendered(document)),
+        excerpt: typeof document.fields['excerpt'] === 'string' ? document.fields['excerpt'] : undefined,
+    })));
+    if (ref.options.sort) {
+        const [field = 'slug', direction] = ref.options.sort.split(':');
+        items = items.sort((a, b) => {
+            const compare = String(a.fields[field] ?? a.slug).localeCompare(String(b.fields[field] ?? b.slug));
+            return direction === 'desc' ? -compare : compare;
+        });
+    }
+    const offset = ref.options.offset ?? 0;
+    return items.slice(offset, offset + (ref.options.limit ?? items.length));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/composition/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/composition/resolve.ts"],"names":[],"mappings":"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"}