@aotter/mantle-runtime 0.0.11-alpha.11

package/dist/domain/service/HtmlRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlRenderer.js","sourceRoot":"","sources":["../../../src/domain/service/HtmlRenderer.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAgB1C;qDACqD;AACrD,MAAM,UAAU,eAAe,CAAC,IAAqB;IACnD,MAAM,GAAG,GAA8B,IAAI,CAAC,SAAS,CAAC,gBAAgB,CACpE,IAAI,CAAC,KAAK,CAAC,UAAU,CACtB,CAAC;IACF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,CACL,CAAC,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QACjC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAC3D,CAAC;AACJ,CAAC;AAYD;mCACmC;AACnC,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,GAAG,GAA6B,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,CACL,CAAC,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QACjC,GAAG,CAAC;YACF,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/domain/service/LocaleNegotiator.d.ts

@@ -0,0 +1,29 @@
+import { toUrlLocale, type SiteConfig, type SiteDefaults } from "@aotter/mantle-spec";
+/**
+ * Locale + SiteConfig helpers used at request entry by every public
+ * router. Pure functions on existing spec types — no I/O, no env.
+ *
+ *   - `siteConfigFromDefaults` materializes a runtime `SiteConfig`
+ *     from a consumer's `SiteDefaults` (the author-time declaration).
+ *     Fills `canonicalLocale` from `locales[0]`, defaults missing
+ *     fields to empty string. Adapters that don't go through the
+ *     DB-backed `SiteConfigRepository` use this.
+ *
+ *   - `inferLocaleFromPath` reads the first URL path segment, matches
+ *     it case-insensitively against `site.locales`, and returns the
+ *     canonical locale (preserving the casing in `site.locales`) on
+ *     hit. On miss, returns `site.canonicalLocale` (or `"en"` if the
+ *     site has no locales configured — should never happen for a
+ *     localized site).
+ *
+ *   - `isKnownLocale` answers "is this URL segment a valid locale for
+ *     this site?" for adapters that need to 404 vs render-locale-home.
+ */
+export declare function siteConfigFromDefaults(defaults: SiteDefaults): SiteConfig;
+export declare function inferLocaleFromPath(path: string, site: SiteConfig): string;
+export declare function isKnownLocale(locale: string, site: SiteConfig): boolean;
+/** Canonical → URL form mirror of spec's `toUrlLocale`, re-exported
+ *  here so adapters can import locale helpers from one runtime path
+ *  without reaching into spec's domain. */
+export { toUrlLocale };
+//# sourceMappingURL=LocaleNegotiator.d.ts.map

package/dist/domain/service/LocaleNegotiator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleNegotiator.d.ts","sourceRoot":"","sources":["../../../src/domain/service/LocaleNegotiator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAYzE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAa1E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAKvE;AAED;;2CAE2C;AAC3C,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/domain/service/LocaleNegotiator.js

@@ -0,0 +1,62 @@
+import { URL_LOCALE, toUrlLocale, } from "@aotter/mantle-spec";
+/**
+ * Locale + SiteConfig helpers used at request entry by every public
+ * router. Pure functions on existing spec types — no I/O, no env.
+ *
+ *   - `siteConfigFromDefaults` materializes a runtime `SiteConfig`
+ *     from a consumer's `SiteDefaults` (the author-time declaration).
+ *     Fills `canonicalLocale` from `locales[0]`, defaults missing
+ *     fields to empty string. Adapters that don't go through the
+ *     DB-backed `SiteConfigRepository` use this.
+ *
+ *   - `inferLocaleFromPath` reads the first URL path segment, matches
+ *     it case-insensitively against `site.locales`, and returns the
+ *     canonical locale (preserving the casing in `site.locales`) on
+ *     hit. On miss, returns `site.canonicalLocale` (or `"en"` if the
+ *     site has no locales configured — should never happen for a
+ *     localized site).
+ *
+ *   - `isKnownLocale` answers "is this URL segment a valid locale for
+ *     this site?" for adapters that need to 404 vs render-locale-home.
+ */
+export function siteConfigFromDefaults(defaults) {
+    const locales = [...(defaults.locales ?? [])];
+    return {
+        brand: defaults.brand ?? "",
+        title: defaults.title ?? defaults.brand ?? "",
+        description: defaults.description ?? "",
+        origin: defaults.origin ?? "",
+        locales,
+        canonicalLocale: locales[0] ?? null,
+        faviconUrl: defaults.faviconUrl,
+        media: { purposes: [...(defaults.media?.purposes ?? [])] },
+    };
+}
+export function inferLocaleFromPath(path, site) {
+    const seg = path.split("/")[1] ?? "";
+    // URL_LOCALE rejects anything that doesn't fit `xx` / `xx-yy` (lowercase
+    // only), matching what the public router actually serves — so a
+    // request for `/llms.txt` doesn't accidentally tag itself with locale
+    // "llms.txt" even before the `site.locales` membership check.
+    if (seg && URL_LOCALE.test(seg.toLowerCase())) {
+        const segLower = seg.toLowerCase();
+        for (const l of site.locales) {
+            if (toUrlLocale(l) === segLower)
+                return l;
+        }
+    }
+    return site.canonicalLocale ?? site.locales[0] ?? "en";
+}
+export function isKnownLocale(locale, site) {
+    if (!locale)
+        return false;
+    const target = locale.toLowerCase();
+    if (!URL_LOCALE.test(target))
+        return false;
+    return site.locales.some((l) => toUrlLocale(l) === target);
+}
+/** Canonical → URL form mirror of spec's `toUrlLocale`, re-exported
+ *  here so adapters can import locale helpers from one runtime path
+ *  without reaching into spec's domain. */
+export { toUrlLocale };
+//# sourceMappingURL=LocaleNegotiator.js.map

package/dist/domain/service/LocaleNegotiator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleNegotiator.js","sourceRoot":"","sources":["../../../src/domain/service/LocaleNegotiator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,GAGZ,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAsB;IAC3D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE;QAC7C,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QAC7B,OAAO;QACP,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI;QACnC,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAgB;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,yEAAyE;IACzE,gEAAgE;IAChE,sEAAsE;IACtE,8DAA8D;IAC9D,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAgB;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;2CAE2C;AAC3C,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { Entry, SiteConfig } from "@aotter/mantle-spec";
+/**
+ * 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 a `content` (or `body`) field skip the `.md`
+ * mirror — see `getMarkdownBody` below for the dual-field rule.
+ *
+ * Pure transformation — no I/O. Lives in `domain/service/`.
+ */
+/**
+ * The canonical markdown source field. Spec-preferred name is
+ * `content`; the reference starter (and likely consumers cribbing
+ * from it) declares `body`. Both are markdown text under the hood;
+ * accept either everywhere a markdown payload is read so consumers
+ * don't have to choose. Single predicate so `serializeEntryAsMarkdown`,
+ * `serializeLlmsTxt`, and the article-signal heuristic stay in sync.
+ */
+export declare function getMarkdownBody(entry: Entry): string | null;
+export declare function hasMarkdownBody(entry: Entry): boolean;
+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: SiteConfig;
+    readonly locale: string;
+    readonly entriesByCollection: ReadonlyMap<string, readonly Entry[]>;
+}): string;
+//# sourceMappingURL=MarkdownSerializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSerializer.d.ts","sourceRoot":"","sources":["../../../src/domain/service/MarkdownSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAErD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAsBpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC;CACrE,GAAG,MAAM,CAsBT"}

package/dist/domain/service/MarkdownSerializer.js

@@ -0,0 +1,109 @@
+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 a `content` (or `body`) field skip the `.md`
+ * mirror — see `getMarkdownBody` below for the dual-field rule.
+ *
+ * Pure transformation — no I/O. Lives in `domain/service/`.
+ */
+/**
+ * The canonical markdown source field. Spec-preferred name is
+ * `content`; the reference starter (and likely consumers cribbing
+ * from it) declares `body`. Both are markdown text under the hood;
+ * accept either everywhere a markdown payload is read so consumers
+ * don't have to choose. Single predicate so `serializeEntryAsMarkdown`,
+ * `serializeLlmsTxt`, and the article-signal heuristic stay in sync.
+ */
+export function getMarkdownBody(entry) {
+    const data = entry.data;
+    if (typeof data["content"] === "string")
+        return data["content"];
+    if (typeof data["body"] === "string")
+        return data["body"];
+    return null;
+}
+export function hasMarkdownBody(entry) {
+    return getMarkdownBody(entry) !== null;
+}
+export function serializeEntryAsMarkdown(entry) {
+    const data = entry.data;
+    const content = getMarkdownBody(entry);
+    if (content == null)
+        return null;
+    const fm = [];
+    for (const k of ["title", "description", "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 = data["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 } = args;
+    const urlLocale = locale.toLowerCase();
+    let out = `# ${site.title}\n\n`;
+    if (site.description)
+        out += `> ${site.description}\n\n`;
+    if (locale)
+        out += `Locale: ${locale}\n\n`;
+    for (const [collection, entries] of entriesByCollection) {
+        if (entries.length === 0)
+            continue;
+        out += `## ${collection}\n\n`;
+        for (const e of entries) {
+            if (!hasMarkdownBody(e))
+                continue;
+            const data = e.data;
+            const title = data["title"] ?? e.id;
+            const slug = data["slug"] ?? e.id;
+            const desc = data["description"] ?? "";
+            const localePrefix = urlLocale ? `/${urlLocale}` : "";
+            const url = appendMarkdownExt(absoluteUrl(site.origin, `${localePrefix}/${collection}/${slug}`));
+            out += desc ? `- [${title}](${url}): ${desc}\n` : `- [${title}](${url})\n`;
+        }
+        out += "\n";
+    }
+    return out;
+}
+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/domain/service/MarkdownSerializer.js.map

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

package/dist/domain/service/McpToolNaming.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `Schema.metadata.name` → MCP per-collection tool name suffix.
+ * Lowercase + `kebab-` → `_snake`. Pure naming convention; the MCP
+ * tool catalog factory and the boot collision check both reference
+ * this so the rule lives in exactly one place.
+ *
+ * Lives in `domain/service/` (not `infrastructure/mcp/`) so the boot
+ * use case can call it without violating the usecase→infrastructure
+ * import rule.
+ */
+export declare function mcpToolNameSegment(collection: string): string;
+//# sourceMappingURL=McpToolNaming.d.ts.map

package/dist/domain/service/McpToolNaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolNaming.d.ts","sourceRoot":"","sources":["../../../src/domain/service/McpToolNaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/domain/service/McpToolNaming.js

@@ -0,0 +1,14 @@
+/**
+ * `Schema.metadata.name` → MCP per-collection tool name suffix.
+ * Lowercase + `kebab-` → `_snake`. Pure naming convention; the MCP
+ * tool catalog factory and the boot collision check both reference
+ * this so the rule lives in exactly one place.
+ *
+ * Lives in `domain/service/` (not `infrastructure/mcp/`) so the boot
+ * use case can call it without violating the usecase→infrastructure
+ * import rule.
+ */
+export function mcpToolNameSegment(collection) {
+    return collection.toLowerCase().replace(/-/g, "_");
+}
+//# sourceMappingURL=McpToolNaming.js.map

package/dist/domain/service/McpToolNaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolNaming.js","sourceRoot":"","sources":["../../../src/domain/service/McpToolNaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/domain/service/Pagination.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pagination clamps shared by the View REST surface (ADR-0012) and
+ * `ListEntriesUseCase`. Pure functions; no I/O.
+ *
+ * Defaults / cap are runtime-internal — manifests don't see them.
+ * `MAX_LIMIT` is the upper bound on what any caller can ask for in a
+ * single round-trip; `View.spec.limit` may further narrow this on a
+ * per-View basis (`clampShow` honours both).
+ */
+export declare const DEFAULT_LIMIT = 50;
+export declare const MAX_LIMIT = 500;
+export declare function clampLimit(limit: number | undefined): number;
+export declare function clampShow(show: number | undefined, viewLimit: number | undefined): number;
+export declare function clampPage(page: number | undefined): number;
+//# sourceMappingURL=Pagination.d.ts.map

package/dist/domain/service/Pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../src/domain/service/Pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIzF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1D"}

package/dist/domain/service/Pagination.js

@@ -0,0 +1,29 @@
+/**
+ * Pagination clamps shared by the View REST surface (ADR-0012) and
+ * `ListEntriesUseCase`. Pure functions; no I/O.
+ *
+ * Defaults / cap are runtime-internal — manifests don't see them.
+ * `MAX_LIMIT` is the upper bound on what any caller can ask for in a
+ * single round-trip; `View.spec.limit` may further narrow this on a
+ * per-View basis (`clampShow` honours both).
+ */
+export const DEFAULT_LIMIT = 50;
+export const MAX_LIMIT = 500;
+export function clampLimit(limit) {
+    if (typeof limit !== "number" || !Number.isFinite(limit) || limit <= 0) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.min(Math.floor(limit), MAX_LIMIT);
+}
+export function clampShow(show, viewLimit) {
+    const cap = clampLimit(viewLimit);
+    if (typeof show !== "number" || !Number.isFinite(show) || show <= 0)
+        return cap;
+    return Math.min(Math.floor(show), cap);
+}
+export function clampPage(page) {
+    if (typeof page !== "number" || !Number.isFinite(page) || page < 1)
+        return 1;
+    return Math.floor(page);
+}
+//# sourceMappingURL=Pagination.js.map

package/dist/domain/service/Pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.js","sourceRoot":"","sources":["../../../src/domain/service/Pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAwB,EAAE,SAA6B;IAC/E,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/domain/service/PathMatcher.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Match a request path against a Trigger path with OpenAPI-style
+ * `{param}` segments. Returns the extracted params on a match, or
+ * `null` if the segments don't line up.
+ *
+ *   matchPath("/api/contact", "/api/contact")       → {}
+ *   matchPath("/api/posts/{id}", "/api/posts/abc")  → { id: "abc" }
+ *   matchPath("/api/posts/{id}", "/api/posts")      → null
+ *   matchPath("/api/posts", "/api/posts/abc")       → null
+ *
+ * Pure path math — no I/O. Lives in `domain/service/` so adapters
+ * (HTTP layer) can call it without dragging an HTTP framework dep.
+ */
+export declare function matchPath(triggerPath: string, requestPath: string): Record<string, string> | null;
+//# sourceMappingURL=PathMatcher.d.ts.map

package/dist/domain/service/PathMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathMatcher.d.ts","sourceRoot":"","sources":["../../../src/domain/service/PathMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAwB/B"}

package/dist/domain/service/PathMatcher.js

@@ -0,0 +1,54 @@
+/**
+ * Match a request path against a Trigger path with OpenAPI-style
+ * `{param}` segments. Returns the extracted params on a match, or
+ * `null` if the segments don't line up.
+ *
+ *   matchPath("/api/contact", "/api/contact")       → {}
+ *   matchPath("/api/posts/{id}", "/api/posts/abc")  → { id: "abc" }
+ *   matchPath("/api/posts/{id}", "/api/posts")      → null
+ *   matchPath("/api/posts", "/api/posts/abc")       → null
+ *
+ * Pure path math — no I/O. Lives in `domain/service/` so adapters
+ * (HTTP layer) can call it without dragging an HTTP framework dep.
+ */
+export function matchPath(triggerPath, requestPath) {
+    // `/api/posts` and `/api/posts/` are the same resource; without
+    // normalization the trailing-slash side gains an empty segment and
+    // segment-count alone defeats the match.
+    const tParts = stripTrailingSlash(triggerPath).split("/");
+    const rParts = stripTrailingSlash(requestPath).split("/");
+    if (tParts.length !== rParts.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < tParts.length; i++) {
+        const t = tParts[i];
+        const r = rParts[i];
+        // decodeURIComponent throws URIError on malformed encoding
+        // (e.g. `%GG`); surface as a routing miss, not a 500.
+        const decoded = safeDecode(r);
+        if (decoded === null)
+            return null;
+        if (t.startsWith("{") && t.endsWith("}")) {
+            params[t.slice(1, -1)] = decoded;
+        }
+        else if (t !== decoded) {
+            // Decode literals too so `/api/by%2Dtag` matches trigger
+            // `/api/by-tag` (percent-encoded equivalent of the same byte).
+            return null;
+        }
+    }
+    return params;
+}
+function safeDecode(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return null;
+    }
+}
+// Preserve root "/" — only strip when length > 1.
+function stripTrailingSlash(p) {
+    return p.length > 1 && p.endsWith("/") ? p.slice(0, -1) : p;
+}
+//# sourceMappingURL=PathMatcher.js.map

package/dist/domain/service/PathMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathMatcher.js","sourceRoot":"","sources":["../../../src/domain/service/PathMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CACvB,WAAmB,EACnB,WAAmB;IAEnB,gEAAgE;IAChE,mEAAmE;IACnE,yCAAyC;IACzC,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,2DAA2D;QAC3D,sDAAsD;QACtD,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QACnC,CAAC;aAAM,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YACzB,yDAAyD;YACzD,+DAA+D;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/domain/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/domain/service/PreviewBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewBanner.d.ts","sourceRoot":"","sources":["../../../src/domain/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/domain/service/PreviewBanner.js

@@ -0,0 +1,37 @@
+/**
+ * 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>`;
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+//# sourceMappingURL=PreviewBanner.js.map

package/dist/domain/service/PreviewBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewBanner.js","sourceRoot":"","sources":["../../../src/domain/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;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,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/domain/service/PublicPathResolver.d.ts

@@ -0,0 +1,41 @@
+import { type Entry } from "@aotter/mantle-spec";
+/**
+ * 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/domain/service/PublicPathResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicPathResolver.d.ts","sourceRoot":"","sources":["../../../src/domain/service/PublicPathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;;;;;;;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"}

package/dist/domain/service/PublicPathResolver.js

@@ -0,0 +1,24 @@
+import { toUrlLocale } from "@aotter/mantle-spec";
+import { entrySlug } from "./PublishKeys.js";
+export function createPublicPathResolver(config) {
+    const routes = config.collectionRoutes;
+    return {
+        forEntry(entry) {
+            const route = routes[entry.collection];
+            if (!route || route.segment === null)
+                return null;
+            const slug = entrySlug({ id: entry.id, data: entry.data });
+            const locale = entry.locale ? toUrlLocale(entry.locale) : "";
+            const localePrefix = locale ? `/${locale}` : "";
+            if (route.homeSlug && slug === route.homeSlug) {
+                return localePrefix || "/";
+            }
+            const segment = route.segment;
+            return segment ? `${localePrefix}/${segment}/${slug}` : `${localePrefix}/${slug}`;
+        },
+        routeFor(collection) {
+            return routes[collection];
+        },
+    };
+}
+//# sourceMappingURL=PublicPathResolver.js.map

package/dist/domain/service/PublicPathResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicPathResolver.js","sourceRoot":"","sources":["../../../src/domain/service/PublicPathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA2C7C,MAAM,UAAU,wBAAwB,CACtC,MAAgC;IAEhC,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACvC,OAAO;QACL,QAAQ,CAAC,KAAY;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAClD,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC9C,OAAO,YAAY,IAAI,GAAG,CAAC;YAC7B,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,IAAI,EAAE,CAAC;QACpF,CAAC;QACD,QAAQ,CAAC,UAAkB;YACzB,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/domain/service/PublishKeys.d.ts

@@ -0,0 +1,42 @@
+import { type Entry } from "@aotter/mantle-spec";
+/**
+ * KV key derivation. Centralised so the publish pipeline (writer) and
+ * the public router (reader) agree on one shape; changing the layout
+ * is a single-file edit.
+ *
+ *   - `entry:html:{locale}/{collection}/{slug}` — pre-rendered HTML
+ *   - `entry:md:{locale}/{collection}/{slug}`   — markdown mirror
+ *   - `list:html:{locale}/{collection}`         — collection index
+ *   - `llms:{locale}`                            — /{locale}/llms.txt
+ *   - `llms:root`                                — /llms.txt (cross-locale aggregate)
+ *
+ * Non-localized entries use empty-string locale (`entry:html:/posts/abc`).
+ * The root /llms.txt uses the explicit `:root` suffix instead of an
+ * empty one because `wrangler kv bulk put` silently drops keys ending
+ * in `:` (caught in CI on commit 93c10ef).
+ *
+ * Pure path math — no I/O. Lives in `domain/service/` so any layer
+ * can call it without dragging an adapter dep.
+ */
+export declare function entrySlug(entry: {
+    id: string;
+    data: Record<string, unknown>;
+}): string;
+export declare function entryHtmlKey(entry: Entry): string;
+export declare function entryMarkdownKey(entry: Entry): string;
+export declare function listHtmlKey(collection: string, locale: string): string;
+export declare function llmsTxtKey(locale: string): string;
+export declare function entryPublicPath(entry: Entry): string;
+/**
+ * Build the entry HTML key from URL-side parts. The router has the
+ * (collection, locale, slug) tuple from path params; reconstructing
+ * a partial `Entry` just to call `entryHtmlKey` is bug-bait. Use
+ * this helper instead.
+ *
+ * Pass `locale = ""` for non-localized entries (matches publish
+ * pipeline semantic where non-localized entries write to
+ * `entry:html:/{collection}/{slug}`).
+ */
+export declare function entryHtmlKeyFromParts(collection: string, locale: string, slug: string): string;
+export declare function entryMarkdownKeyFromParts(collection: string, locale: string, slug: string): string;
+//# sourceMappingURL=PublishKeys.d.ts.map

package/dist/domain/service/PublishKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublishKeys.d.ts","sourceRoot":"","sources":["../../../src/domain/service/PublishKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,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,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIrD;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAGR"}