@aotter/mantle-web 0.1.0-alpha.10

package/dist/model/TemplateRegistry.d.ts

@@ -0,0 +1,50 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { SeoMeta } from "./SeoMeta.js";
+import type { WebSiteConfig } from "./WebSiteConfig.js";
+import type { MediaAsset } from "@aotter/mantle-runtime";
+/**
+ * Render-pipeline types + consumer-supplied template registry.
+ *
+ * The runtime stays string-typed — templates return complete HTML
+ * body strings (no doctype prefix; the HTML renderer adds it) so
+ * the runtime carries no JSX dependency. Consumers using JSX in
+ * their public surface (Hono + hono/jsx) call their JSX → string
+ * function before the template returns.
+ *
+ * Schemas without a registered entry/list template skip HTML.
+ * Their agent mirrors are emitted only when a public path resolves
+ * and the entry has serializable content.
+ *
+ * `seo` is populated when the renderer is given a composed SeoMeta
+ * block — templates render `<SeoTags seo={seo} />` (or read fields
+ * directly) when present. Renderers that skip composition leave
+ * `seo` undefined so opt-out templates don't break.
+ *
+ * Lives in `domain/model/` because runtime render use cases and
+ * consumer-supplied templates both reference it.
+ */
+export interface EntryContext {
+    readonly entry: Entry;
+    readonly site: WebSiteConfig;
+    readonly mediaAssets?: ReadonlyMap<string, MediaAsset>;
+    readonly seo?: SeoMeta;
+}
+export interface ListContext {
+    readonly collection: string;
+    readonly locale: string;
+    readonly entries: readonly Entry[];
+    readonly site: WebSiteConfig;
+    readonly mediaAssets?: ReadonlyMap<string, MediaAsset>;
+    readonly seo?: SeoMeta;
+}
+export type EntryTemplate = (ctx: EntryContext) => string;
+export type ListTemplate = (ctx: ListContext) => string;
+export declare class TemplateRegistry {
+    private readonly entries;
+    private readonly lists;
+    registerEntryTemplate(collection: string, t: EntryTemplate): void;
+    registerListTemplate(collection: string, t: ListTemplate): void;
+    getEntryTemplate(collection: string): EntryTemplate | undefined;
+    getListTemplate(collection: string): ListTemplate | undefined;
+}
+//# sourceMappingURL=TemplateRegistry.d.ts.map

package/dist/model/TemplateRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateRegistry.d.ts","sourceRoot":"","sources":["../../src/model/TemplateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC;AAExD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAEzD,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI;IAIjE,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI;IAI/D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAG9D"}

package/dist/model/TemplateRegistry.js

@@ -0,0 +1,17 @@
+export class TemplateRegistry {
+    entries = new Map();
+    lists = new Map();
+    registerEntryTemplate(collection, t) {
+        this.entries.set(collection, t);
+    }
+    registerListTemplate(collection, t) {
+        this.lists.set(collection, t);
+    }
+    getEntryTemplate(collection) {
+        return this.entries.get(collection);
+    }
+    getListTemplate(collection) {
+        return this.lists.get(collection);
+    }
+}
+//# sourceMappingURL=TemplateRegistry.js.map

package/dist/model/TemplateRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateRegistry.js","sourceRoot":"","sources":["../../src/model/TemplateRegistry.ts"],"names":[],"mappings":"AA6CA,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC3C,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEzD,qBAAqB,CAAC,UAAkB,EAAE,CAAgB;QACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,oBAAoB,CAAC,UAAkB,EAAE,CAAe;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,gBAAgB,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/model/WebSiteConfig.d.ts

@@ -0,0 +1,4 @@
+import type { SiteConfig } from "@aotter/mantle-spec";
+/** Site fields consumed by public document composition. */
+export type WebSiteConfig = Pick<SiteConfig, "title" | "description" | "origin" | "locales" | "canonicalLocale" | "brand" | "icons" | "ga4MeasurementId" | "facebookPixelId">;
+//# sourceMappingURL=WebSiteConfig.d.ts.map

package/dist/model/WebSiteConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSiteConfig.d.ts","sourceRoot":"","sources":["../../src/model/WebSiteConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,UAAU,EACR,OAAO,GACP,aAAa,GACb,QAAQ,GACR,SAAS,GACT,iBAAiB,GACjB,OAAO,GACP,OAAO,GACP,kBAAkB,GAClB,iBAAiB,CACpB,CAAC"}

package/dist/model/WebSiteConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WebSiteConfig.js.map

package/dist/model/WebSiteConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSiteConfig.js","sourceRoot":"","sources":["../../src/model/WebSiteConfig.ts"],"names":[],"mappings":""}

package/dist/service/AbsoluteUrl.d.ts

@@ -0,0 +1,6 @@
+export declare function absoluteUrl(origin: string, path: string): string;
+/** Append `.md` before any query string / hash. Used by the SEO
+ *  composer + sitemap to derive markdown-mirror URLs without
+ *  mangling query params. */
+export declare function appendMarkdownExt(absoluteOrPath: string): string;
+//# sourceMappingURL=AbsoluteUrl.d.ts.map

package/dist/service/AbsoluteUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbsoluteUrl.d.ts","sourceRoot":"","sources":["../../src/service/AbsoluteUrl.ts"],"names":[],"mappings":"AAcA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;6BAE6B;AAC7B,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/dist/service/AbsoluteUrl.js

@@ -0,0 +1,33 @@
+/**
+ * Absolutize a path against a `SiteConfig.origin`. Single chokepoint
+ * so trailing-slash handling is consistent across every URL the SDK
+ * emits — sitemap, llms.txt mirrors, SEO canonical, hreflang siblings.
+ *
+ * Two divergent strip behaviors used to live across the codebase
+ * (`/\/$/` vs `/\/+$/`); both flow through here now.
+ *
+ * Empty `origin` returns the path unchanged — useful for tests and
+ * for templates that intentionally emit relative URLs. Already-
+ * absolute `path` (http(s)://...) returns unchanged.
+ */
+const TRAILING_SLASHES = /\/+$/;
+export function absoluteUrl(origin, path) {
+    if (!origin)
+        return path;
+    if (path.startsWith("http://") || path.startsWith("https://"))
+        return path;
+    const cleanOrigin = origin.replace(TRAILING_SLASHES, "");
+    if (!path)
+        return cleanOrigin;
+    return `${cleanOrigin}${path.startsWith("/") ? "" : "/"}${path}`;
+}
+/** Append `.md` before any query string / hash. Used by the SEO
+ *  composer + sitemap to derive markdown-mirror URLs without
+ *  mangling query params. */
+export function appendMarkdownExt(absoluteOrPath) {
+    const match = /^([^?#]*)(.*)$/.exec(absoluteOrPath);
+    if (!match)
+        return `${absoluteOrPath}.md`;
+    return `${match[1]}.md${match[2]}`;
+}
+//# sourceMappingURL=AbsoluteUrl.js.map

package/dist/service/AbsoluteUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbsoluteUrl.js","sourceRoot":"","sources":["../../src/service/AbsoluteUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAY;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,WAAW,CAAC;IAC9B,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;AACnE,CAAC;AAED;;6BAE6B;AAC7B,MAAM,UAAU,iBAAiB,CAAC,cAAsB;IACtD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,cAAc,KAAK,CAAC;IAC1C,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC"}

package/dist/service/HtmlEscaping.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeHtml(value: string): string;
+//# sourceMappingURL=HtmlEscaping.d.ts.map

package/dist/service/HtmlEscaping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlEscaping.d.ts","sourceRoot":"","sources":["../../src/service/HtmlEscaping.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD"}

package/dist/service/HtmlEscaping.js

@@ -0,0 +1,9 @@
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+//# sourceMappingURL=HtmlEscaping.js.map

package/dist/service/HtmlEscaping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlEscaping.js","sourceRoot":"","sources":["../../src/service/HtmlEscaping.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/service/HtmlRenderer.d.ts

@@ -0,0 +1,39 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { TemplateRegistry } from "../model/TemplateRegistry.js";
+import type { SeoMeta } from "../model/SeoMeta.js";
+import type { WebSiteConfig } from "../model/WebSiteConfig.js";
+import type { MediaAsset } from "@aotter/mantle-runtime";
+export interface RenderEntryArgs {
+    readonly entry: Entry;
+    readonly site: WebSiteConfig;
+    readonly templates: TemplateRegistry;
+    /** Defaults to `<!doctype html>`. Pipelines that want the
+     *  upper-case `<!DOCTYPE html>\n` shape pass it explicitly. */
+    readonly doctype?: string;
+    readonly mediaAssets?: ReadonlyMap<string, MediaAsset>;
+    /** Optional pre-composed SEO/AEO block. Threaded into the
+     *  `EntryContext.seo` field so templates can emit `<SeoTags
+     *  seo={seo}/>` inside `<head>`. Renderers that skip composition
+     *  leave it undefined — opt-out templates keep working. */
+    readonly seo?: SeoMeta;
+}
+/** Returns the full HTML doc (doctype + body) or `null` if no entry
+ *  template is registered for `entry.collection`. */
+export declare function renderEntryHtml(args: RenderEntryArgs): string | null;
+export interface RenderListArgs {
+    readonly collection: string;
+    readonly locale: string;
+    readonly entries: ReadonlyArray<Entry>;
+    readonly site: WebSiteConfig;
+    readonly templates: TemplateRegistry;
+    readonly doctype?: string;
+    readonly mediaAssets?: ReadonlyMap<string, MediaAsset>;
+    readonly seo?: SeoMeta;
+}
+/** Returns the full HTML doc or `null` if no list template is
+ *  registered for `collection`. */
+export declare function renderListHtml(args: RenderListArgs): string | null;
+export declare function renderTrackingTagsHtml(site: WebSiteConfig): string;
+export declare function normalizeGa4MeasurementId(value: string | undefined): string | null;
+export declare function normalizeFacebookPixelId(value: string | undefined): string | null;
+//# sourceMappingURL=HtmlRenderer.d.ts.map

package/dist/service/HtmlRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlRenderer.d.ts","sourceRoot":"","sources":["../../src/service/HtmlRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC;mEAC+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD;;;+DAG2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;qDACqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAepE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;mCACmC;AACnC,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAelE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAalE;AAYD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGjF"}

package/dist/service/HtmlRenderer.js

@@ -0,0 +1,73 @@
+/**
+ * Pure render functions over the consumer-supplied template registry.
+ * Request-time public and preview renderers share this template lookup
+ * and doctype concatenation so the contract stays single-sourced
+ * — adding a doctype mode, an OG-meta wrapper, or a per-collection
+ * pre/post hook is one edit. No I/O; no DB; no env access.
+ */
+const DEFAULT_DOCTYPE = "<!doctype html>";
+/** Returns the full HTML doc (doctype + body) or `null` if no entry
+ *  template is registered for `entry.collection`. */
+export function renderEntryHtml(args) {
+    const tpl = args.templates.getEntryTemplate(args.entry.collection);
+    if (!tpl)
+        return null;
+    return injectTrackingTags((args.doctype ?? DEFAULT_DOCTYPE) +
+        tpl({
+            entry: args.entry,
+            site: args.site,
+            mediaAssets: args.mediaAssets,
+            seo: args.seo,
+        }), args.site);
+}
+/** Returns the full HTML doc or `null` if no list template is
+ *  registered for `collection`. */
+export function renderListHtml(args) {
+    const tpl = args.templates.getListTemplate(args.collection);
+    if (!tpl)
+        return null;
+    return injectTrackingTags((args.doctype ?? DEFAULT_DOCTYPE) +
+        tpl({
+            collection: args.collection,
+            locale: args.locale,
+            entries: args.entries,
+            site: args.site,
+            mediaAssets: args.mediaAssets,
+            seo: args.seo,
+        }), args.site);
+}
+export function renderTrackingTagsHtml(site) {
+    const ga4Id = normalizeGa4MeasurementId(site.ga4MeasurementId);
+    const pixelId = normalizeFacebookPixelId(site.facebookPixelId);
+    const parts = [];
+    if (ga4Id) {
+        parts.push(`<script async src="https://www.googletagmanager.com/gtag/js?id=${ga4Id}"></script>`);
+        parts.push(`<script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','${ga4Id}');</script>`);
+    }
+    if (pixelId) {
+        parts.push(`<script>!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?n.callMethod.apply(n,arguments):n.queue.push(arguments);};if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s);}(window,document,'script','https://connect.facebook.net/en_US/fbevents.js');fbq('init','${pixelId}');fbq('track','PageView');</script>`);
+        parts.push(`<noscript><img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=${pixelId}&ev=PageView&noscript=1"/></noscript>`);
+    }
+    return parts.length > 0 ? `\n${parts.join("\n")}\n` : "";
+}
+function injectTrackingTags(html, site) {
+    const tags = renderTrackingTagsHtml(site);
+    if (!tags)
+        return html;
+    const headClose = /<\/head>/i;
+    if (headClose.test(html))
+        return html.replace(headClose, `${tags}</head>`);
+    const bodyOpen = /<body[^>]*>/i;
+    if (bodyOpen.test(html))
+        return html.replace(bodyOpen, (match) => `${match}${tags}`);
+    return `${tags}${html}`;
+}
+export function normalizeGa4MeasurementId(value) {
+    const trimmed = value?.trim().toUpperCase() ?? "";
+    return /^G-[A-Z0-9]{4,32}$/.test(trimmed) ? trimmed : null;
+}
+export function normalizeFacebookPixelId(value) {
+    const trimmed = value?.trim() ?? "";
+    return /^[0-9]{5,32}$/.test(trimmed) ? trimmed : null;
+}
+//# sourceMappingURL=HtmlRenderer.js.map

package/dist/service/HtmlRenderer.js.map

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

package/dist/service/MarkdownSerializer.d.ts

@@ -0,0 +1,46 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { WebSiteConfig } from "../model/WebSiteConfig.js";
+/**
+ * Built-in markdown serializer. Fixed format, applied to every entry
+ * whose Schema produces a `content` field. Intentionally not user-
+ * customizable — agents that consume `.md` mirrors and `/llms.txt`
+ * benefit from a predictable site-wide shape.
+ *
+ *   ---
+ *   title: ...
+ *   description: ...
+ *   slug: ...
+ *   locale: ...
+ *   publishedAt: ...
+ *   ---
+ *
+ *   # <title>
+ *
+ *   > <description>
+ *
+ *   <content>
+ *
+ * Entries without serializable public content skip the `.md` mirror.
+ *
+ * Pure transformation — no I/O. Lives in `domain/service/`.
+ */
+/**
+ * `content`/`body` win, then structured sections, then a non-empty
+ * description/summary. One predicate keeps mirrors and metadata in sync.
+ */
+export declare function getMarkdownBody(entry: Entry): string | null;
+export declare function hasMarkdownBody(entry: Entry): boolean;
+export declare function getEntryDescription(entry: Entry): string | null;
+export declare function serializeEntryAsMarkdown(entry: Entry): string | null;
+/**
+ * Per-locale `/llms.txt` index. One section per collection, one bullet
+ * per entry. The shape follows the llms.txt convention (Howard, 2024-11)
+ * so agent consumers can rely on a stable structure.
+ */
+export declare function serializeLlmsTxt(args: {
+    readonly site: WebSiteConfig;
+    readonly locale: string;
+    readonly entriesByCollection: ReadonlyMap<string, readonly Entry[]>;
+    readonly pathFor: (entry: Entry) => string | null;
+}): string | null;
+//# sourceMappingURL=MarkdownSerializer.d.ts.map

package/dist/service/MarkdownSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSerializer.d.ts","sourceRoot":"","sources":["../../src/service/MarkdownSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAS3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAErD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAuBpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,CAAC;CACnD,GAAG,MAAM,GAAG,IAAI,CAsBhB"}

package/dist/service/MarkdownSerializer.js

@@ -0,0 +1,154 @@
+import { absoluteUrl, appendMarkdownExt } from "./AbsoluteUrl.js";
+/**
+ * Built-in markdown serializer. Fixed format, applied to every entry
+ * whose Schema produces a `content` field. Intentionally not user-
+ * customizable — agents that consume `.md` mirrors and `/llms.txt`
+ * benefit from a predictable site-wide shape.
+ *
+ *   ---
+ *   title: ...
+ *   description: ...
+ *   slug: ...
+ *   locale: ...
+ *   publishedAt: ...
+ *   ---
+ *
+ *   # <title>
+ *
+ *   > <description>
+ *
+ *   <content>
+ *
+ * Entries without serializable public content skip the `.md` mirror.
+ *
+ * Pure transformation — no I/O. Lives in `domain/service/`.
+ */
+/**
+ * `content`/`body` win, then structured sections, then a non-empty
+ * description/summary. One predicate keeps mirrors and metadata in sync.
+ */
+export function getMarkdownBody(entry) {
+    const data = entry.data;
+    for (const key of ["content", "body"]) {
+        const value = nonEmptyString(data[key]);
+        if (value)
+            return value;
+    }
+    const sections = serializeSections(data["sections"]);
+    if (sections)
+        return sections;
+    return getEntryDescription(entry);
+}
+export function hasMarkdownBody(entry) {
+    return getMarkdownBody(entry) !== null;
+}
+export function getEntryDescription(entry) {
+    return nonEmptyString(entry.data["description"])
+        ?? nonEmptyString(entry.data["summary"]);
+}
+export function serializeEntryAsMarkdown(entry) {
+    const data = entry.data;
+    const content = getMarkdownBody(entry);
+    if (content == null)
+        return null;
+    const fm = [];
+    for (const k of ["title", "slug", "locale", "publishedAt"]) {
+        const v = k === "locale" ? entry.locale : data[k];
+        if (typeof v === "string" && v.length > 0)
+            fm.push([k, v]);
+    }
+    const title = data["title"] ?? entry.id;
+    const description = getEntryDescription(entry);
+    if (description)
+        fm.splice(1, 0, ["description", description]);
+    let out = "---\n";
+    for (const [k, v] of fm)
+        out += `${k}: ${yamlScalar(v)}\n`;
+    out += "---\n\n";
+    out += `# ${title}\n\n`;
+    if (description)
+        out += `> ${description}\n\n`;
+    out += content;
+    if (!content.endsWith("\n"))
+        out += "\n";
+    return out;
+}
+/**
+ * Per-locale `/llms.txt` index. One section per collection, one bullet
+ * per entry. The shape follows the llms.txt convention (Howard, 2024-11)
+ * so agent consumers can rely on a stable structure.
+ */
+export function serializeLlmsTxt(args) {
+    const { site, locale, entriesByCollection, pathFor } = args;
+    const sections = [];
+    for (const [collection, entries] of entriesByCollection) {
+        const bullets = [];
+        for (const e of entries) {
+            if (!hasMarkdownBody(e))
+                continue;
+            const data = e.data;
+            const title = data["title"] ?? e.id;
+            const path = pathFor(e);
+            if (!path)
+                continue;
+            const desc = getEntryDescription(e) ?? "";
+            const url = appendMarkdownExt(absoluteUrl(site.origin, path));
+            bullets.push(desc ? `- [${title}](${url}): ${desc}` : `- [${title}](${url})`);
+        }
+        if (bullets.length > 0)
+            sections.push(`## ${collection}\n\n${bullets.join("\n")}`);
+    }
+    if (sections.length === 0)
+        return null;
+    let out = `# ${site.title}\n\n`;
+    if (site.description)
+        out += `> ${site.description}\n\n`;
+    if (locale)
+        out += `Locale: ${locale}\n\n`;
+    return `${out}${sections.join("\n\n")}\n`;
+}
+function serializeSections(value) {
+    if (!Array.isArray(value))
+        return null;
+    const sections = value.map(serializeSection).filter((section) => section.length > 0);
+    return sections.length > 0 ? sections.join("\n\n") : null;
+}
+function serializeSection(value) {
+    if (!isRecord(value))
+        return "";
+    const heading = nonEmptyString(value["title"]);
+    const lines = heading ? [`## ${heading}`] : [];
+    for (const key of ["eyebrow", "body", "description", "quote", "value"]) {
+        const text = nonEmptyString(value[key]);
+        if (text && text !== heading)
+            lines.push(text);
+    }
+    if (Array.isArray(value["items"])) {
+        for (const item of value["items"]) {
+            if (!isRecord(item))
+                continue;
+            const title = nonEmptyString(item["title"]);
+            const body = nonEmptyString(item["body"])
+                ?? nonEmptyString(item["description"])
+                ?? nonEmptyString(item["quote"]);
+            if (title && body)
+                lines.push(`- **${title}:** ${body}`);
+            else if (title ?? body)
+                lines.push(`- ${title ?? body}`);
+        }
+    }
+    return lines.join("\n\n");
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function yamlScalar(s) {
+    if (/^[A-Za-z0-9._/-][\w. /:-]*$/.test(s) && !/^(true|false|null|yes|no|on|off)$/i.test(s)) {
+        return s;
+    }
+    return JSON.stringify(s);
+}
+//# sourceMappingURL=MarkdownSerializer.js.map

package/dist/service/MarkdownSerializer.js.map

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

package/dist/service/PreviewBanner.d.ts

@@ -0,0 +1,10 @@
+export declare function injectPreviewBanner(html: string, banner: string): string;
+/**
+ * Build the SDK's default preview banner markup. Both `status` and
+ * `slug` are HTML-escaped — `status` is a closed enum so escaping is
+ * defense-in-depth, but `slug` is caller-supplied and a slug
+ * containing `<script>` would otherwise inject script into the
+ * preview surface.
+ */
+export declare function defaultPreviewBanner(status: string, slug: string): string;
+//# sourceMappingURL=PreviewBanner.d.ts.map

package/dist/service/PreviewBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewBanner.d.ts","sourceRoot":"","sources":["../../src/service/PreviewBanner.ts"],"names":[],"mappings":"AAgBA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/service/PreviewBanner.js

@@ -0,0 +1,30 @@
+/**
+ * Inject a preview banner just inside the rendered `<body>`. Used by
+ * the request-time `?preview=1` route so authors can see in-progress
+ * drafts with a visible "this isn't published" mark.
+ *
+ * The injection looks for the first `<body...>` opening tag and
+ * appends `banner` immediately after it. Documents without a body tag
+ * (fragments, partial templates) fall through unchanged — the caller
+ * already validated the renderer produced a full HTML document, so a
+ * missing body is a contract violation, not user input.
+ *
+ * Pure string transformation. Lives in `domain/service/` so the
+ * regex (and any future DOM-safer replacement) stays in one place.
+ */
+const BODY_OPEN = /<body([^>]*)>/;
+export function injectPreviewBanner(html, banner) {
+    return html.replace(BODY_OPEN, `<body$1>${banner}`);
+}
+/**
+ * Build the SDK's default preview banner markup. Both `status` and
+ * `slug` are HTML-escaped — `status` is a closed enum so escaping is
+ * defense-in-depth, but `slug` is caller-supplied and a slug
+ * containing `<script>` would otherwise inject script into the
+ * preview surface.
+ */
+export function defaultPreviewBanner(status, slug) {
+    return `<div class="preview-banner">Preview · ${escapeHtml(status)} · ${escapeHtml(slug)}</div>`;
+}
+import { escapeHtml } from "./HtmlEscaping.js";
+//# sourceMappingURL=PreviewBanner.js.map

package/dist/service/PreviewBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewBanner.js","sourceRoot":"","sources":["../../src/service/PreviewBanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAc;IAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,IAAY;IAC/D,OAAO,yCAAyC,UAAU,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;AACnG,CAAC;AACD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/service/PublicPathResolver.d.ts

@@ -0,0 +1,46 @@
+import { type Entry } from "@aotter/mantle-spec";
+export declare function entrySlug(entry: {
+    id: string;
+    data: Record<string, unknown>;
+}): string;
+export declare function entryPublicPath(entry: Entry): string;
+/**
+ * Resolves a public URL path for an entry, given the consumer's
+ * collection→URL configuration. One source of truth for both the
+ * router (URL → collection/slug lookup) and outbound URL emission
+ * (sitemap, hreflang siblings, SEO canonical).
+ *
+ * The resolver's `forEntry` returns `null` when:
+ *   - the entry's collection has no public URL (e.g. parent `posts`
+ *     surfaces only via `post-translations` children)
+ *   - the entry has no slug AND no canonical id-based URL pattern is
+ *     configured for the collection
+ *
+ * Pure path math — no I/O. Lives in `domain/service/`.
+ */
+export interface CollectionRoute {
+    /** URL segment for entries of this collection.
+     *
+     *   - non-empty string: `/{locale}/{segment}/{slug}` (e.g. `posts`)
+     *   - empty string:     `/{locale}/{slug}` (entries directly under locale)
+     *   - null:             collection has no public URL
+     */
+    readonly segment: string | null;
+    /** When the entry's slug equals this value, collapse the URL to
+     *  `/{locale}` (no trailing segment + slug). Used for home pages
+     *  that live in a translations collection. */
+    readonly homeSlug?: string;
+}
+export interface PublicPathResolverConfig {
+    readonly collectionRoutes: Readonly<Record<string, CollectionRoute>>;
+}
+export interface PublicPathResolver {
+    /** Returns `/{locale}/{segment}/{slug}` style path, or `null` if the
+     *  entry has no public URL under this configuration. */
+    forEntry(entry: Entry): string | null;
+    /** Returns the configured route for `collection`, or `undefined` if
+     *  the collection isn't mapped. */
+    routeFor(collection: string): CollectionRoute | undefined;
+}
+export declare function createPublicPathResolver(config: PublicPathResolverConfig): PublicPathResolver;
+//# sourceMappingURL=PublicPathResolver.d.ts.map

package/dist/service/PublicPathResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicPathResolver.d.ts","sourceRoot":"","sources":["../../src/service/PublicPathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE9D,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,CAMtF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIpD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;kDAE8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,kBAAkB;IACjC;4DACwD;IACxD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC;uCACmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,kBAAkB,CAmBpB"}