@caelo-cms/shared 0.10.23 → 0.10.26

package/src/url.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: MPL-2.0
+
+/**
+ * Slug/URL primitives shared between the static generator, the preview
+ * op, and the admin UI (epic #380 #384 — successor of the deleted
+ * i18n.ts). URL shape beyond base + slug becomes a plugin contribution
+ * on the URL composition point (#390).
+ *
+ *   isHomeSlug / isDesignatedHomePage — the home-decision predicate.
+ *   trimSlashes / trimTrailingSlashes — linear-scan slug hygiene.
+ */
+
+/**
+ * Strip leading and trailing `/` characters with a single linear scan.
+ *
+ * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
+ * backtracks O(n²) on a long run of slashes that is not at end-of-string
+ * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
+ * linear and produces byte-identical output for every input.
+ */
+export function trimSlashes(s: string): string {
+  let start = 0;
+  let end = s.length;
+  while (start < end && s.charCodeAt(start) === 47 /* '/' */) start += 1;
+  while (end > start && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
+  return s.slice(start, end);
+}
+
+/**
+ * Strip only trailing `/` characters with a single linear scan — the
+ * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
+ * Used for base URLs, which carry a scheme and must keep their leading
+ * characters.
+ */
+export function trimTrailingSlashes(s: string): string {
+  let end = s.length;
+  while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
+  return s.slice(0, end);
+}
+
+/**
+ * The "magic slug" sentinel test: a page whose slug is empty, `home`,
+ * or `index` is the site root by convention even without an explicit
+ * `site_defaults.home_page_id` designation. Leading/trailing slashes
+ * are ignored so `/home/` reads the same as `home`.
+ */
+export function isHomeSlug(slug: string): boolean {
+  const s = trimSlashes(slug);
+  return s === "" || s === "home" || s === "index";
+}
+
+/**
+ * The single home-decision predicate every URL/output-path site must
+ * use so canonical, redirects, and the emitted file agree (0184
+ * explicit-homepage feature). A page is the site root when it IS the
+ * designated `site_defaults.home_page_id` OR carries a magic slug.
+ *
+ * @param pageId              The page being resolved.
+ * @param slug                That page's slug.
+ * @param designatedHomePageId  `site_defaults.home_page_id`
+ *                              (null/undefined when none designated).
+ */
+export function isDesignatedHomePage(
+  pageId: string,
+  slug: string,
+  designatedHomePageId: string | null | undefined,
+): boolean {
+  return (designatedHomePageId != null && pageId === designatedHomePageId) || isHomeSlug(slug);
+}

package/src/version.ts

@@ -22,7 +22,7 @@
  * follow standard SemVer.
  */
 
-export const CAELO_VERSION = "0.10.23";
+export const CAELO_VERSION = "0.10.26";
 
 /**
  * Deprecated alias for back-compat — early P17 work spelled this

package/dist/design-manifest.d.ts

@@ -1,36 +0,0 @@
-/**
- * issue #165 — the Design Manifest: a generated, versioned description
- * of THIS site's design system (epic #149, growth-time convergence).
- *
- * The operator requirement is asymmetric: pages of the SAME site share
- * one visual line, while different sites are free to look nothing
- * alike. A global stylesheet solves the first at the cost of the
- * second; the per-site manifest solves both — it captures what this
- * site's tokens/patterns MEAN so the AI converges toward its own
- * design, not a Caelo default.
- *
- * Written at Genesis materialisation (or curated later via chat);
- * rendered as the `## Design system` system-prompt block.
- */
-import { z } from "zod";
-export declare const designManifestPattern: z.ZodObject<{
-    name: z.ZodString;
-    moduleType: z.ZodOptional<z.ZodString>;
-    spec: z.ZodString;
-}, z.core.$strict>;
-export declare const designManifestSchema: z.ZodObject<{
-    tokenRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    typography: z.ZodOptional<z.ZodString>;
-    rhythm: z.ZodOptional<z.ZodString>;
-    patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        moduleType: z.ZodOptional<z.ZodString>;
-        spec: z.ZodString;
-    }, z.core.$strict>>>;
-    imagery: z.ZodOptional<z.ZodString>;
-    avoid: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type DesignManifest = z.infer<typeof designManifestSchema>;
-/** Render the `## Design system` prompt block. Null when empty. */
-export declare function formatDesignSystemBlock(manifest: DesignManifest | null): string | null;
-//# sourceMappingURL=design-manifest.d.ts.map

package/dist/design-manifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"design-manifest.d.ts","sourceRoot":"","sources":["../src/design-manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;kBASvB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAYtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA8CtF"}

package/dist/design-manifest.js

@@ -1,90 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-/**
- * issue #165 — the Design Manifest: a generated, versioned description
- * of THIS site's design system (epic #149, growth-time convergence).
- *
- * The operator requirement is asymmetric: pages of the SAME site share
- * one visual line, while different sites are free to look nothing
- * alike. A global stylesheet solves the first at the cost of the
- * second; the per-site manifest solves both — it captures what this
- * site's tokens/patterns MEAN so the AI converges toward its own
- * design, not a Caelo default.
- *
- * Written at Genesis materialisation (or curated later via chat);
- * rendered as the `## Design system` system-prompt block.
- */
-import { z } from "zod";
-export const designManifestPattern = z
-    .object({
-    /** Pattern name the AI reasons in ("hero", "card grid", "cta band"). */
-    name: z.string().min(1).max(80),
-    /** Stable module `type` implementing it — reuse target (#159 place mode). */
-    moduleType: z.string().max(64).optional(),
-    /** One-line spec: what makes this pattern THIS site's version of it. */
-    spec: z.string().min(1).max(500),
-})
-    .strict();
-export const designManifestSchema = z
-    .object({
-    /** `--color-primary` → "CTAs and links only" — usage semantics per var. */
-    tokenRoles: z.record(z.string().min(3).max(64), z.string().min(1).max(300)).optional(),
-    /** Scale ratio, casing, measure rules. */
-    typography: z.string().min(1).max(1000).optional(),
-    /** Section padding, container width, grid gaps. */
-    rhythm: z.string().min(1).max(1000).optional(),
-    patterns: z.array(designManifestPattern).max(24).optional(),
-    imagery: z.string().min(1).max(500).optional(),
-    avoid: z.string().min(1).max(500).optional(),
-})
-    .strict();
-/** Render the `## Design system` prompt block. Null when empty. */
-export function formatDesignSystemBlock(manifest) {
-    if (manifest === null)
-        return null;
-    const lines = [
-        "## Design system",
-        "",
-        "THIS site's own design language — derived from the chosen design. Every module you author or restyle conforms to it unless the operator explicitly asks to break the line. Reuse the pattern's module type (place mode) before minting lookalikes.",
-        "",
-    ];
-    let hasContent = false;
-    const roles = manifest.tokenRoles ?? {};
-    const roleEntries = Object.entries(roles);
-    if (roleEntries.length > 0) {
-        hasContent = true;
-        lines.push("Token roles:");
-        for (const [token, role] of roleEntries.slice(0, 24))
-            lines.push(`- \`${token}\` — ${role}`);
-        lines.push("");
-    }
-    if (manifest.typography) {
-        hasContent = true;
-        lines.push(`Typography: ${manifest.typography}`, "");
-    }
-    if (manifest.rhythm) {
-        hasContent = true;
-        lines.push(`Rhythm: ${manifest.rhythm}`, "");
-    }
-    if (manifest.patterns && manifest.patterns.length > 0) {
-        hasContent = true;
-        lines.push("Patterns:");
-        for (const p of manifest.patterns) {
-            lines.push(`- **${p.name}**${p.moduleType ? ` (module type \`${p.moduleType}\`)` : ""} — ${p.spec}`);
-        }
-        lines.push("");
-    }
-    if (manifest.imagery) {
-        hasContent = true;
-        lines.push(`Imagery: ${manifest.imagery}`, "");
-    }
-    if (manifest.avoid) {
-        hasContent = true;
-        lines.push(`Never: ${manifest.avoid}`, "");
-    }
-    if (!hasContent)
-        return null;
-    while (lines[lines.length - 1] === "")
-        lines.pop();
-    return lines.join("\n");
-}
-//# sourceMappingURL=design-manifest.js.map

package/dist/design-manifest.js.map

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

package/dist/i18n.d.ts

@@ -1,92 +0,0 @@
-/**
- * Strip leading and trailing `/` characters with a single linear scan.
- *
- * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
- * backtracks O(n²) on a long run of slashes that is not at end-of-string
- * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
- * linear and produces byte-identical output for every input.
- */
-export declare function trimSlashes(s: string): string;
-/**
- * Strip only trailing `/` characters with a single linear scan — the
- * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
- * Used for base URLs, which carry a scheme and must keep their leading
- * characters.
- */
-export declare function trimTrailingSlashes(s: string): string;
-export interface LocaleConfig {
-    code: string;
-    displayName: string;
-    urlStrategy: "none" | "subdirectory" | "subdomain" | "domain";
-    urlHost: string | null;
-    isDefault: boolean;
-}
-/**
- * The "magic slug" sentinel test: a page whose slug is empty, `home`,
- * or `index` is the locale root by convention even without an explicit
- * `locales.home_page_id` designation. Leading/trailing slashes are
- * ignored so `/home/` reads the same as `home`.
- */
-export declare function isHomeSlug(slug: string): boolean;
-/**
- * The single home-decision predicate every URL/output-path site must
- * use so canonical, hreflang, redirects, and the emitted file agree
- * (0184 explicit-homepage feature). A page is the locale root when it
- * IS the locale's designated `home_page_id` OR carries a magic slug.
- *
- * @param pageId            The page being resolved.
- * @param slug              That page's slug.
- * @param localeHomePageId  `locales.home_page_id` for the page's locale
- *                          (null/undefined when no page is designated).
- */
-export declare function pageIsLocaleHome(pageId: string, slug: string, localeHomePageId: string | null | undefined): boolean;
-/**
- * Build a public-facing URL for a (locale, slug) tuple. Pure function —
- * no DB access — so the static generator can call it for every page
- * without round-trips.
- *
- * @param locale       The target locale's full config row.
- * @param slug         Path component (e.g. "about", "blog/post-1"). No leading slash.
- * @param siteBaseUrl  Default base URL when the strategy is `none` or
- *                     `subdirectory` (e.g. "https://example.com").
- * @param pageUrlStyle Page emission style (see below).
- * @param isHomePage   Explicit homepage designation (0184 —
- *                     `locales.home_page_id`). When true this page IS the
- *                     locale root and resolves to `<base>/` regardless of
- *                     its own slug. The explicit flag WINS over the slug
- *                     sentinel below; the sentinel stays as a back-compat
- *                     fallback for callers that can't cheaply surface the
- *                     designation.
- * @returns Absolute URL, including scheme + host.
- */
-export declare function resolveLocaleUrl(locale: LocaleConfig, slug: string, siteBaseUrl: string, pageUrlStyle?: "directory" | "no-extension", isHomePage?: boolean): string;
-/**
- * Emit `<link rel="alternate" hreflang="…">` tags for every locale
- * that has a published variant of this page. The default locale also
- * gets an `x-default` entry per Google's i18n guidance.
- *
- * Returned as a single string suitable for splicing into <head>.
- */
-export declare function buildHreflangLinks(perLocaleUrls: ReadonlyArray<{
-    localeCode: string;
-    url: string;
-    isDefault: boolean;
-}>): string;
-/**
- * Canonical-JSON serializer + sha256 → hex. Stable across runs because
- * keys are sorted. The output is used for `pages.content_hash` so that
- * a Mode-2 translation can detect whether its source has changed.
- */
-export declare function computeContentHash(value: unknown): Promise<string>;
-export interface LocaleLintWarning {
-    code: string;
-    message: string;
-}
-/**
- * Cross-row config sanity checks. Run at:
- *   - propose-time (warnings stored on the proposal preview)
- *   - render-time (no fail-loudly per CLAUDE.md §2 since the renderer
- *     can still emit; surfaced in admin UI as banners)
- */
-export declare function lintLocaleConfig(locales: ReadonlyArray<LocaleConfig>, advancedUrlRouting: boolean): LocaleLintWarning[];
-//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC9D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAMnB,YAAY,GAAE,WAAW,GAAG,cAA4B,EACxD,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,CAyCR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,GACpF,MAAM,CAaR;AAUD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAWxE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,EACpC,kBAAkB,EAAE,OAAO,GAC1B,iBAAiB,EAAE,CAoCrB"}

package/dist/i18n.js

@@ -1,226 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-/**
- * P9 — i18n primitives shared between the static generator, the
- * preview op, and the admin UI:
- *
- *   computeContentHash(page, modules) — sha256 of canonical-JSON
- *     content. Drives `pages.content_hash` + the translation_status
- *     recompute path.
- *
- *   resolveLocaleUrl(locale, slug, siteBaseUrl, pageUrlStyle?, isHomePage?) —
- *     builds the public URL for a (locale, slug) tuple given the
- *     locale's url_strategy + url_host. `isHomePage` forces the locale
- *     root (0184 explicit designation). Used by:
- *       - hreflang emitter
- *       - sitemap.xml emitter (when extended for i18n)
- *       - language-selector module
- *
- *   buildHreflangLinks(currentLocale, perLocaleUrls, defaultLocaleCode) —
- *     emits the `<link rel="alternate" hreflang=...>` markup.
- *
- *   lintLocaleConfig(locales, advancedUrlRouting) — surfaces config
- *     warnings (mixed strategies, missing url_host for subdomain/
- *     domain, default locale using `none` alongside subdirectory
- *     siblings, advanced strategy chosen while toggle is off).
- */
-const TEXT_ENCODER = new TextEncoder();
-/**
- * Strip leading and trailing `/` characters with a single linear scan.
- *
- * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
- * backtracks O(n²) on a long run of slashes that is not at end-of-string
- * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
- * linear and produces byte-identical output for every input.
- */
-export function trimSlashes(s) {
-    let start = 0;
-    let end = s.length;
-    while (start < end && s.charCodeAt(start) === 47 /* '/' */)
-        start += 1;
-    while (end > start && s.charCodeAt(end - 1) === 47 /* '/' */)
-        end -= 1;
-    return s.slice(start, end);
-}
-/**
- * Strip only trailing `/` characters with a single linear scan — the
- * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
- * Used for base URLs, which carry a scheme and must keep their leading
- * characters.
- */
-export function trimTrailingSlashes(s) {
-    let end = s.length;
-    while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */)
-        end -= 1;
-    return s.slice(0, end);
-}
-/**
- * The "magic slug" sentinel test: a page whose slug is empty, `home`,
- * or `index` is the locale root by convention even without an explicit
- * `locales.home_page_id` designation. Leading/trailing slashes are
- * ignored so `/home/` reads the same as `home`.
- */
-export function isHomeSlug(slug) {
-    const s = trimSlashes(slug);
-    return s === "" || s === "home" || s === "index";
-}
-/**
- * The single home-decision predicate every URL/output-path site must
- * use so canonical, hreflang, redirects, and the emitted file agree
- * (0184 explicit-homepage feature). A page is the locale root when it
- * IS the locale's designated `home_page_id` OR carries a magic slug.
- *
- * @param pageId            The page being resolved.
- * @param slug              That page's slug.
- * @param localeHomePageId  `locales.home_page_id` for the page's locale
- *                          (null/undefined when no page is designated).
- */
-export function pageIsLocaleHome(pageId, slug, localeHomePageId) {
-    return (localeHomePageId != null && pageId === localeHomePageId) || isHomeSlug(slug);
-}
-/**
- * Build a public-facing URL for a (locale, slug) tuple. Pure function —
- * no DB access — so the static generator can call it for every page
- * without round-trips.
- *
- * @param locale       The target locale's full config row.
- * @param slug         Path component (e.g. "about", "blog/post-1"). No leading slash.
- * @param siteBaseUrl  Default base URL when the strategy is `none` or
- *                     `subdirectory` (e.g. "https://example.com").
- * @param pageUrlStyle Page emission style (see below).
- * @param isHomePage   Explicit homepage designation (0184 —
- *                     `locales.home_page_id`). When true this page IS the
- *                     locale root and resolves to `<base>/` regardless of
- *                     its own slug. The explicit flag WINS over the slug
- *                     sentinel below; the sentinel stays as a back-compat
- *                     fallback for callers that can't cheaply surface the
- *                     designation.
- * @returns Absolute URL, including scheme + host.
- */
-export function resolveLocaleUrl(locale, slug, siteBaseUrl, 
-// v0.2.85 — page emission style. 'directory' (default) builds
-// URLs ending in `/<slug>/`; 'no-extension' builds URLs ending
-// in `/<slug>` (no trailing slash) to match what the bucket
-// actually serves when pages are emitted as bare slugs. Home
-// page is always `<base>/` regardless of style.
-pageUrlStyle = "directory", isHomePage) {
-    const stripped = trimSlashes(slug);
-    // 0184 — the explicit designation wins; the slug sentinel
-    // (""/`home`/`index`) survives as a back-compat fallback so a page the
-    // AI never ran set_home_page on still resolves to the root. Shared
-    // `isHomeSlug` keeps this test identical across every home-decision site.
-    const isHome = isHomePage === true || isHomeSlug(stripped);
-    // tail: the path component appended after `<base>/` or `<base>/<locale>/`.
-    // 'directory' style: trailing slash for non-home so the URL points at
-    // the directory the bucket serves index.html from.
-    // 'no-extension' style: no trailing slash, no extension — the URL
-    // points at the bare-slug object the bucket serves directly.
-    const tail = isHome ? "" : pageUrlStyle === "no-extension" ? stripped : `${stripped}/`;
-    const base = trimTrailingSlashes(siteBaseUrl);
-    switch (locale.urlStrategy) {
-        case "none":
-            return tail ? `${base}/${tail}` : `${base}/`;
-        case "subdirectory":
-            // Default locale with strategy `subdirectory` still gets the prefix
-            // unless the migration set strategy=none for it. The decision is
-            // explicit per locale row, not implicit on isDefault.
-            return tail ? `${base}/${locale.code}/${tail}` : `${base}/${locale.code}/`;
-        case "subdomain": {
-            if (!locale.urlHost) {
-                throw new Error(`locale '${locale.code}' uses url_strategy='subdomain' without url_host — config invalid`);
-            }
-            const protocol = base.startsWith("http://") ? "http://" : "https://";
-            return tail ? `${protocol}${locale.urlHost}/${tail}` : `${protocol}${locale.urlHost}/`;
-        }
-        case "domain": {
-            if (!locale.urlHost) {
-                throw new Error(`locale '${locale.code}' uses url_strategy='domain' without url_host — config invalid`);
-            }
-            const protocol = base.startsWith("http://") ? "http://" : "https://";
-            return tail ? `${protocol}${locale.urlHost}/${tail}` : `${protocol}${locale.urlHost}/`;
-        }
-    }
-}
-/**
- * Emit `<link rel="alternate" hreflang="…">` tags for every locale
- * that has a published variant of this page. The default locale also
- * gets an `x-default` entry per Google's i18n guidance.
- *
- * Returned as a single string suitable for splicing into <head>.
- */
-export function buildHreflangLinks(perLocaleUrls) {
-    if (perLocaleUrls.length === 0)
-        return "";
-    const lines = [];
-    for (const v of perLocaleUrls) {
-        lines.push(`<link rel="alternate" hreflang="${escapeAttr(v.localeCode)}" href="${escapeAttr(v.url)}" />`);
-    }
-    const def = perLocaleUrls.find((v) => v.isDefault);
-    if (def) {
-        lines.push(`<link rel="alternate" hreflang="x-default" href="${escapeAttr(def.url)}" />`);
-    }
-    return lines.join("\n");
-}
-function escapeAttr(s) {
-    return s
-        .replace(/&/g, "&amp;")
-        .replace(/"/g, "&quot;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
-}
-/**
- * Canonical-JSON serializer + sha256 → hex. Stable across runs because
- * keys are sorted. The output is used for `pages.content_hash` so that
- * a Mode-2 translation can detect whether its source has changed.
- */
-export async function computeContentHash(value) {
-    const canonical = JSON.stringify(value, (_key, val) => {
-        if (val && typeof val === "object" && !Array.isArray(val)) {
-            const sorted = {};
-            for (const k of Object.keys(val).sort())
-                sorted[k] = val[k];
-            return sorted;
-        }
-        return val;
-    });
-    const digest = await crypto.subtle.digest("SHA-256", TEXT_ENCODER.encode(canonical));
-    return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
-}
-/**
- * Cross-row config sanity checks. Run at:
- *   - propose-time (warnings stored on the proposal preview)
- *   - render-time (no fail-loudly per CLAUDE.md §2 since the renderer
- *     can still emit; surfaced in admin UI as banners)
- */
-export function lintLocaleConfig(locales, advancedUrlRouting) {
-    const warnings = [];
-    const usingAdvanced = locales.some((l) => l.urlStrategy === "subdomain" || l.urlStrategy === "domain");
-    if (usingAdvanced && !advancedUrlRouting) {
-        warnings.push({
-            code: "advanced-routing-disabled",
-            message: "one or more locales use 'subdomain' or 'domain' strategy but Advanced URL Routing is disabled — enable it under /security/locales",
-        });
-    }
-    for (const l of locales) {
-        if ((l.urlStrategy === "subdomain" || l.urlStrategy === "domain") && !l.urlHost) {
-            warnings.push({
-                code: "missing-url-host",
-                message: `locale '${l.code}' uses url_strategy='${l.urlStrategy}' without url_host`,
-            });
-        }
-    }
-    // Default-locale 'none' alongside subdirectory siblings is a common
-    // mixed config; surface it so users know the default's URL stays bare
-    // while siblings get prefixed.
-    const def = locales.find((l) => l.isDefault);
-    const subdirSiblings = locales.filter((l) => !l.isDefault && l.urlStrategy === "subdirectory");
-    if (def && def.urlStrategy === "none" && subdirSiblings.length > 0) {
-        warnings.push({
-            code: "mixed-default-none-subdir",
-            message: `default locale '${def.code}' uses 'none' while ${subdirSiblings
-                .map((l) => l.code)
-                .join(", ")} use 'subdirectory' — this is valid but unusual; verify hreflang renders correctly`,
-        });
-    }
-    return warnings;
-}
-//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

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