@caelo-cms/shared 0.10.24 → 0.10.26

package/src/themes.ts

@@ -24,6 +24,7 @@
 
 import { z } from "zod";
 import { isUnsafeKey } from "./safe-keys.js";
+import { UnknownTokenName } from "./themes-errors.js";
 
 // ────────────────────────────────────────────────────────────────────
 // Primitives
@@ -117,6 +118,7 @@ export const themeTypographyComposite = z
       z
         .object({
           fontFamily: z.string().min(1).max(200).optional(),
+          fontStyle: z.enum(["normal", "italic"]).optional(),
           fontSize: dimensionValueString.optional(),
           fontWeight: fontWeightValue.optional(),
           lineHeight: z.union([z.number().positive(), dimensionValueString]).optional(),
@@ -728,11 +730,18 @@ function pluralise(category: string, n: number): string {
  * use this same logic — extracted so the dotted-path merge lives in
  * one place and v0.11.1's OKLCH auto-ramp can extend it without
  * forking.
+ *
+ * issue #430 — `$description` (the token's ROLE: what it is for and
+ * where it must not be used) is preserved across value-only edits and
+ * overwritten only when `descriptions` supplies a new one. Before this,
+ * every routine value edit silently erased the role, so recording a
+ * role at all was pointless: the next `set_theme_tokens` wiped it.
  */
 export function applyDtcgWrites(
   current: ThemeDocument,
   writes: Record<string, unknown>,
   types: Record<string, string>,
+  descriptions: Record<string, string> = {},
 ): ThemeDocument {
   const out: ThemeDocument = JSON.parse(JSON.stringify(current));
   for (const [path, value] of Object.entries(writes)) {
@@ -759,9 +768,53 @@ export function applyDtcgWrites(
         ...(value as Record<string, unknown>),
       };
     }
+    // Role precedence: an explicitly supplied description wins; otherwise
+    // the leaf keeps the one it already carries. Only a token that never
+    // had a role ends up without one.
+    const existingDescription =
+      existing && typeof existing === "object"
+        ? (existing as { $description?: unknown }).$description
+        : undefined;
+    const nextDescription =
+      descriptions[path] ??
+      (typeof existingDescription === "string" ? existingDescription : undefined);
+    const extensions =
+      existing && typeof existing === "object"
+        ? { ...((existing as { $extensions?: Record<string, unknown> }).$extensions ?? {}) }
+        : {};
+    const oldValue = (existing as { $value?: { fontFamily?: string } } | undefined)?.$value;
+    if (
+      path.startsWith("typography.") &&
+      nextValue &&
+      typeof nextValue === "object" &&
+      (nextValue as { fontFamily?: string }).fontFamily !== oldValue?.fontFamily
+    )
+      delete extensions["caelo.font"];
     setLeafAtPath(out, path, {
+      ...(Object.keys(extensions).length ? { $extensions: extensions } : {}),
       $value: nextValue,
       ...(inferredType ? { $type: inferredType } : {}),
+      ...(nextDescription !== undefined ? { $description: nextDescription } : {}),
+    });
+  }
+
+  // issue #430 — ROLE-ONLY paths: a description with no value in `writes`.
+  // The anchor-page design review annotates tokens whose values are already
+  // settled, so it must not have to restate them (a restated value is a
+  // chance to drift one). Patch the metadata, leave `$value` and `$type`
+  // exactly as they are.
+  for (const [path, description] of Object.entries(descriptions)) {
+    if (path in writes) continue;
+    const existing = readLeafAtPath(out, path);
+    if (!existing) {
+      // Annotating a token that does not exist is a mistake worth naming —
+      // silently minting a value-less leaf would produce a document the
+      // renderer can't emit (CLAUDE.md §2).
+      throw new UnknownTokenName(path, []);
+    }
+    setLeafAtPath(out, path, {
+      ...(existing as Record<string, unknown>),
+      $description: description,
     });
   }
   return out;

package/src/url.test.ts

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: MPL-2.0
+
+import { describe, expect, it } from "bun:test";
+import { isDesignatedHomePage, isHomeSlug } from "./url.js";
+
+describe("isHomeSlug", () => {
+  it("recognises the magic-slug sentinels regardless of surrounding slashes", () => {
+    for (const s of ["", "home", "index", "/", "/home/", "/index"]) {
+      expect(isHomeSlug(s)).toBe(true);
+    }
+  });
+
+  it("rejects ordinary slugs", () => {
+    for (const s of ["about", "homepage", "index2", "blog/home"]) {
+      expect(isHomeSlug(s)).toBe(false);
+    }
+  });
+});
+
+describe("isDesignatedHomePage (0184 shared predicate)", () => {
+  const PAGE = "11111111-1111-1111-1111-111111111111";
+  const OTHER = "22222222-2222-2222-2222-222222222222";
+
+  it("explicit designation wins regardless of slug", () => {
+    expect(isDesignatedHomePage(PAGE, "welcome", PAGE)).toBe(true);
+  });
+
+  it("magic slug is the fallback when no designation exists", () => {
+    expect(isDesignatedHomePage(PAGE, "home", null)).toBe(true);
+    expect(isDesignatedHomePage(PAGE, "home", undefined)).toBe(true);
+  });
+
+  it("a designation pointing at ANOTHER page does not claim this one", () => {
+    expect(isDesignatedHomePage(PAGE, "welcome", OTHER)).toBe(false);
+  });
+
+  it("plain page, no designation: not home", () => {
+    expect(isDesignatedHomePage(PAGE, "about", null)).toBe(false);
+  });
+});

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.24";
+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,42 +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;
-/**
- * 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;
-/**
- * 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>;
-//# 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":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;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;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAWxE"}

package/dist/i18n.js

@@ -1,85 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-/**
- * Slug/URL primitives shared between the static generator, the preview
- * op, and the admin UI. Epic #380 Phase A (#383): locale URL shaping
- * (resolveLocaleUrl, buildHreflangLinks) is deleted — URL shape beyond
- * base + slug becomes a plugin contribution on the URL composition
- * point (#390). What survives until the page-identity cut (#384):
- *
- *   isHomeSlug / pageIsLocaleHome — the home-decision predicate.
- *   computeContentHash — drives `pages.content_hash` (removed in #384).
- *   trimSlashes / trimTrailingSlashes — linear-scan slug hygiene.
- */
-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);
-}
-/**
- * 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("");
-}
-//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;GAUG;AAEH,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,OAAO,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS;QAAE,KAAK,IAAI,CAAC,CAAC;IACvE,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS;QAAE,GAAG,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,IAAI,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS;QAAE,GAAG,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,CAAC;AACnD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,IAAY,EACZ,gBAA2C;IAE3C,OAAO,CAAC,gBAAgB,IAAI,IAAI,IAAI,MAAM,KAAK,gBAAgB,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACpD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;YACzF,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1F,CAAC"}

package/src/design-manifest.ts

@@ -1,93 +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();
-export type DesignManifest = z.infer<typeof designManifestSchema>;
-
-/** Render the `## Design system` prompt block. Null when empty. */
-export function formatDesignSystemBlock(manifest: DesignManifest | null): string | null {
-  if (manifest === null) return null;
-  const lines: string[] = [
-    "## 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");
-}

package/src/i18n.test.ts

@@ -1,58 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-
-import { describe, expect, it } from "bun:test";
-import { computeContentHash, isHomeSlug, pageIsLocaleHome } from "./i18n.js";
-
-describe("isHomeSlug", () => {
-  it("recognises the magic-slug sentinels regardless of surrounding slashes", () => {
-    for (const s of ["", "home", "index", "/", "/home/", "/index"]) {
-      expect(isHomeSlug(s)).toBe(true);
-    }
-  });
-
-  it("treats any other slug as non-home", () => {
-    for (const s of ["about", "en", "blog/post", "homepage"]) {
-      expect(isHomeSlug(s)).toBe(false);
-    }
-  });
-});
-
-describe("pageIsLocaleHome (0184 shared predicate)", () => {
-  const PAGE = "11111111-1111-4111-8111-111111111111";
-  const OTHER = "22222222-2222-4222-8222-222222222222";
-
-  it("is true when the page IS the locale's designated home_page_id", () => {
-    expect(pageIsLocaleHome(PAGE, "en", PAGE)).toBe(true);
-  });
-
-  it("is true for a magic slug even with no designation", () => {
-    expect(pageIsLocaleHome(PAGE, "home", null)).toBe(true);
-    expect(pageIsLocaleHome(PAGE, "index", undefined)).toBe(true);
-  });
-
-  it("is false for a non-magic slug that isn't the designated page", () => {
-    expect(pageIsLocaleHome(PAGE, "en", OTHER)).toBe(false);
-    expect(pageIsLocaleHome(PAGE, "about", null)).toBe(false);
-  });
-});
-
-describe("computeContentHash", () => {
-  it("is stable across runs for the same input", async () => {
-    const a = await computeContentHash({ x: 1, y: [1, 2] });
-    const b = await computeContentHash({ x: 1, y: [1, 2] });
-    expect(a).toBe(b);
-    expect(a).toMatch(/^[0-9a-f]{64}$/);
-  });
-
-  it("is order-independent for object keys", async () => {
-    const a = await computeContentHash({ x: 1, y: 2 });
-    const b = await computeContentHash({ y: 2, x: 1 });
-    expect(a).toBe(b);
-  });
-
-  it("is order-dependent for arrays", async () => {
-    const a = await computeContentHash({ x: [1, 2] });
-    const b = await computeContentHash({ x: [2, 1] });
-    expect(a).not.toBe(b);
-  });
-});