@caelo-cms/shared 0.10.24 → 0.10.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/dist/ai-tools.d.ts +23 -14
  2. package/dist/ai-tools.d.ts.map +1 -1
  3. package/dist/ai-tools.js +18 -16
  4. package/dist/ai-tools.js.map +1 -1
  5. package/dist/build-page.d.ts +0 -2
  6. package/dist/build-page.d.ts.map +1 -1
  7. package/dist/build-page.js +2 -3
  8. package/dist/build-page.js.map +1 -1
  9. package/dist/content.d.ts +0 -3
  10. package/dist/content.d.ts.map +1 -1
  11. package/dist/content.js +91 -7
  12. package/dist/content.js.map +1 -1
  13. package/dist/context.d.ts +6 -0
  14. package/dist/context.d.ts.map +1 -1
  15. package/dist/font-assets.d.ts +89 -0
  16. package/dist/font-assets.d.ts.map +1 -0
  17. package/dist/font-assets.js +61 -0
  18. package/dist/font-assets.js.map +1 -0
  19. package/dist/google-models.d.ts +19 -0
  20. package/dist/google-models.d.ts.map +1 -0
  21. package/dist/google-models.js +13 -0
  22. package/dist/google-models.js.map +1 -0
  23. package/dist/image-capabilities.d.ts +55 -0
  24. package/dist/image-capabilities.d.ts.map +1 -0
  25. package/dist/image-capabilities.js +39 -0
  26. package/dist/image-capabilities.js.map +1 -0
  27. package/dist/index.d.ts +5 -2
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +5 -2
  30. package/dist/index.js.map +1 -1
  31. package/dist/media.d.ts +29 -3
  32. package/dist/media.d.ts.map +1 -1
  33. package/dist/media.js +19 -5
  34. package/dist/media.js.map +1 -1
  35. package/dist/plugin-preview.d.ts +44 -0
  36. package/dist/plugin-preview.d.ts.map +1 -0
  37. package/dist/plugin-preview.js +69 -0
  38. package/dist/plugin-preview.js.map +1 -0
  39. package/dist/preview-compose.d.ts +26 -0
  40. package/dist/preview-compose.d.ts.map +1 -1
  41. package/dist/preview-compose.js +92 -46
  42. package/dist/preview-compose.js.map +1 -1
  43. package/dist/responsive-images.d.ts +6 -5
  44. package/dist/responsive-images.d.ts.map +1 -1
  45. package/dist/responsive-images.js +6 -5
  46. package/dist/responsive-images.js.map +1 -1
  47. package/dist/seo.d.ts +10 -14
  48. package/dist/seo.d.ts.map +1 -1
  49. package/dist/seo.js +11 -12
  50. package/dist/seo.js.map +1 -1
  51. package/dist/template-engine.d.ts +18 -0
  52. package/dist/template-engine.d.ts.map +1 -1
  53. package/dist/template-engine.js +39 -2
  54. package/dist/template-engine.js.map +1 -1
  55. package/dist/theme-importers/loose.js +1 -1
  56. package/dist/theme-importers/loose.js.map +1 -1
  57. package/dist/theme-normalize.d.ts +9 -0
  58. package/dist/theme-normalize.d.ts.map +1 -1
  59. package/dist/theme-normalize.js +65 -6
  60. package/dist/theme-normalize.js.map +1 -1
  61. package/dist/theme-render.d.ts +15 -0
  62. package/dist/theme-render.d.ts.map +1 -1
  63. package/dist/theme-render.js +39 -0
  64. package/dist/theme-render.js.map +1 -1
  65. package/dist/themes.d.ts +15 -1
  66. package/dist/themes.d.ts.map +1 -1
  67. package/dist/themes.js +48 -1
  68. package/dist/themes.js.map +1 -1
  69. package/dist/url.d.ts +45 -0
  70. package/dist/url.d.ts.map +1 -0
  71. package/dist/url.js +64 -0
  72. package/dist/url.js.map +1 -0
  73. package/dist/version.d.ts +2 -2
  74. package/dist/version.js +1 -1
  75. package/package.json +2 -2
  76. package/src/__tests__/redos-hardening.test.ts +1 -1
  77. package/src/ai-tools.ts +19 -16
  78. package/src/build-page.ts +3 -5
  79. package/src/content.test.ts +99 -17
  80. package/src/content.ts +95 -8
  81. package/src/context.ts +6 -0
  82. package/src/font-assets.ts +63 -0
  83. package/src/google-models.ts +13 -0
  84. package/src/image-capabilities.ts +91 -0
  85. package/src/index.ts +5 -2
  86. package/src/media.ts +23 -6
  87. package/src/plugin-preview.test.ts +79 -0
  88. package/src/plugin-preview.ts +81 -0
  89. package/src/preview-compose-deferrals.test.ts +144 -0
  90. package/src/preview-compose.test.ts +16 -0
  91. package/src/preview-compose.ts +125 -37
  92. package/src/responsive-images.ts +6 -5
  93. package/src/seo.test.ts +8 -8
  94. package/src/seo.ts +15 -23
  95. package/src/template-engine-data-lists.test.ts +90 -0
  96. package/src/template-engine.ts +72 -1
  97. package/src/theme-importers/loose.ts +1 -1
  98. package/src/theme-normalize.ts +70 -8
  99. package/src/theme-render.ts +36 -0
  100. package/src/theme-token-roles.test.ts +182 -0
  101. package/src/themes.ts +53 -0
  102. package/src/url.test.ts +40 -0
  103. package/src/url.ts +69 -0
  104. package/src/version.ts +1 -1
  105. package/dist/design-manifest.d.ts +0 -36
  106. package/dist/design-manifest.d.ts.map +0 -1
  107. package/dist/design-manifest.js +0 -90
  108. package/dist/design-manifest.js.map +0 -1
  109. package/dist/i18n.d.ts +0 -42
  110. package/dist/i18n.d.ts.map +0 -1
  111. package/dist/i18n.js +0 -85
  112. package/dist/i18n.js.map +0 -1
  113. package/src/design-manifest.ts +0 -93
  114. package/src/i18n.test.ts +0 -58
  115. package/src/i18n.ts +0 -91
package/src/url.ts ADDED
@@ -0,0 +1,69 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+
3
+ /**
4
+ * Slug/URL primitives shared between the static generator, the preview
5
+ * op, and the admin UI (epic #380 #384 — successor of the deleted
6
+ * i18n.ts). URL shape beyond base + slug becomes a plugin contribution
7
+ * on the URL composition point (#390).
8
+ *
9
+ * isHomeSlug / isDesignatedHomePage — the home-decision predicate.
10
+ * trimSlashes / trimTrailingSlashes — linear-scan slug hygiene.
11
+ */
12
+
13
+ /**
14
+ * Strip leading and trailing `/` characters with a single linear scan.
15
+ *
16
+ * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
17
+ * backtracks O(n²) on a long run of slashes that is not at end-of-string
18
+ * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
19
+ * linear and produces byte-identical output for every input.
20
+ */
21
+ export function trimSlashes(s: string): string {
22
+ let start = 0;
23
+ let end = s.length;
24
+ while (start < end && s.charCodeAt(start) === 47 /* '/' */) start += 1;
25
+ while (end > start && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
26
+ return s.slice(start, end);
27
+ }
28
+
29
+ /**
30
+ * Strip only trailing `/` characters with a single linear scan — the
31
+ * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
32
+ * Used for base URLs, which carry a scheme and must keep their leading
33
+ * characters.
34
+ */
35
+ export function trimTrailingSlashes(s: string): string {
36
+ let end = s.length;
37
+ while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
38
+ return s.slice(0, end);
39
+ }
40
+
41
+ /**
42
+ * The "magic slug" sentinel test: a page whose slug is empty, `home`,
43
+ * or `index` is the site root by convention even without an explicit
44
+ * `site_defaults.home_page_id` designation. Leading/trailing slashes
45
+ * are ignored so `/home/` reads the same as `home`.
46
+ */
47
+ export function isHomeSlug(slug: string): boolean {
48
+ const s = trimSlashes(slug);
49
+ return s === "" || s === "home" || s === "index";
50
+ }
51
+
52
+ /**
53
+ * The single home-decision predicate every URL/output-path site must
54
+ * use so canonical, redirects, and the emitted file agree (0184
55
+ * explicit-homepage feature). A page is the site root when it IS the
56
+ * designated `site_defaults.home_page_id` OR carries a magic slug.
57
+ *
58
+ * @param pageId The page being resolved.
59
+ * @param slug That page's slug.
60
+ * @param designatedHomePageId `site_defaults.home_page_id`
61
+ * (null/undefined when none designated).
62
+ */
63
+ export function isDesignatedHomePage(
64
+ pageId: string,
65
+ slug: string,
66
+ designatedHomePageId: string | null | undefined,
67
+ ): boolean {
68
+ return (designatedHomePageId != null && pageId === designatedHomePageId) || isHomeSlug(slug);
69
+ }
package/src/version.ts CHANGED
@@ -22,7 +22,7 @@
22
22
  * follow standard SemVer.
23
23
  */
24
24
 
25
- export const CAELO_VERSION = "0.10.24";
25
+ export const CAELO_VERSION = "0.10.27";
26
26
 
27
27
  /**
28
28
  * Deprecated alias for back-compat — early P17 work spelled this
@@ -1,36 +0,0 @@
1
- /**
2
- * issue #165 — the Design Manifest: a generated, versioned description
3
- * of THIS site's design system (epic #149, growth-time convergence).
4
- *
5
- * The operator requirement is asymmetric: pages of the SAME site share
6
- * one visual line, while different sites are free to look nothing
7
- * alike. A global stylesheet solves the first at the cost of the
8
- * second; the per-site manifest solves both — it captures what this
9
- * site's tokens/patterns MEAN so the AI converges toward its own
10
- * design, not a Caelo default.
11
- *
12
- * Written at Genesis materialisation (or curated later via chat);
13
- * rendered as the `## Design system` system-prompt block.
14
- */
15
- import { z } from "zod";
16
- export declare const designManifestPattern: z.ZodObject<{
17
- name: z.ZodString;
18
- moduleType: z.ZodOptional<z.ZodString>;
19
- spec: z.ZodString;
20
- }, z.core.$strict>;
21
- export declare const designManifestSchema: z.ZodObject<{
22
- tokenRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
23
- typography: z.ZodOptional<z.ZodString>;
24
- rhythm: z.ZodOptional<z.ZodString>;
25
- patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
26
- name: z.ZodString;
27
- moduleType: z.ZodOptional<z.ZodString>;
28
- spec: z.ZodString;
29
- }, z.core.$strict>>>;
30
- imagery: z.ZodOptional<z.ZodString>;
31
- avoid: z.ZodOptional<z.ZodString>;
32
- }, z.core.$strict>;
33
- export type DesignManifest = z.infer<typeof designManifestSchema>;
34
- /** Render the `## Design system` prompt block. Null when empty. */
35
- export declare function formatDesignSystemBlock(manifest: DesignManifest | null): string | null;
36
- //# sourceMappingURL=design-manifest.d.ts.map
@@ -1 +0,0 @@
1
- {"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"}
@@ -1,90 +0,0 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
- /**
3
- * issue #165 — the Design Manifest: a generated, versioned description
4
- * of THIS site's design system (epic #149, growth-time convergence).
5
- *
6
- * The operator requirement is asymmetric: pages of the SAME site share
7
- * one visual line, while different sites are free to look nothing
8
- * alike. A global stylesheet solves the first at the cost of the
9
- * second; the per-site manifest solves both — it captures what this
10
- * site's tokens/patterns MEAN so the AI converges toward its own
11
- * design, not a Caelo default.
12
- *
13
- * Written at Genesis materialisation (or curated later via chat);
14
- * rendered as the `## Design system` system-prompt block.
15
- */
16
- import { z } from "zod";
17
- export const designManifestPattern = z
18
- .object({
19
- /** Pattern name the AI reasons in ("hero", "card grid", "cta band"). */
20
- name: z.string().min(1).max(80),
21
- /** Stable module `type` implementing it — reuse target (#159 place mode). */
22
- moduleType: z.string().max(64).optional(),
23
- /** One-line spec: what makes this pattern THIS site's version of it. */
24
- spec: z.string().min(1).max(500),
25
- })
26
- .strict();
27
- export const designManifestSchema = z
28
- .object({
29
- /** `--color-primary` → "CTAs and links only" — usage semantics per var. */
30
- tokenRoles: z.record(z.string().min(3).max(64), z.string().min(1).max(300)).optional(),
31
- /** Scale ratio, casing, measure rules. */
32
- typography: z.string().min(1).max(1000).optional(),
33
- /** Section padding, container width, grid gaps. */
34
- rhythm: z.string().min(1).max(1000).optional(),
35
- patterns: z.array(designManifestPattern).max(24).optional(),
36
- imagery: z.string().min(1).max(500).optional(),
37
- avoid: z.string().min(1).max(500).optional(),
38
- })
39
- .strict();
40
- /** Render the `## Design system` prompt block. Null when empty. */
41
- export function formatDesignSystemBlock(manifest) {
42
- if (manifest === null)
43
- return null;
44
- const lines = [
45
- "## Design system",
46
- "",
47
- "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.",
48
- "",
49
- ];
50
- let hasContent = false;
51
- const roles = manifest.tokenRoles ?? {};
52
- const roleEntries = Object.entries(roles);
53
- if (roleEntries.length > 0) {
54
- hasContent = true;
55
- lines.push("Token roles:");
56
- for (const [token, role] of roleEntries.slice(0, 24))
57
- lines.push(`- \`${token}\` — ${role}`);
58
- lines.push("");
59
- }
60
- if (manifest.typography) {
61
- hasContent = true;
62
- lines.push(`Typography: ${manifest.typography}`, "");
63
- }
64
- if (manifest.rhythm) {
65
- hasContent = true;
66
- lines.push(`Rhythm: ${manifest.rhythm}`, "");
67
- }
68
- if (manifest.patterns && manifest.patterns.length > 0) {
69
- hasContent = true;
70
- lines.push("Patterns:");
71
- for (const p of manifest.patterns) {
72
- lines.push(`- **${p.name}**${p.moduleType ? ` (module type \`${p.moduleType}\`)` : ""} — ${p.spec}`);
73
- }
74
- lines.push("");
75
- }
76
- if (manifest.imagery) {
77
- hasContent = true;
78
- lines.push(`Imagery: ${manifest.imagery}`, "");
79
- }
80
- if (manifest.avoid) {
81
- hasContent = true;
82
- lines.push(`Never: ${manifest.avoid}`, "");
83
- }
84
- if (!hasContent)
85
- return null;
86
- while (lines[lines.length - 1] === "")
87
- lines.pop();
88
- return lines.join("\n");
89
- }
90
- //# sourceMappingURL=design-manifest.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"design-manifest.js","sourceRoot":"","sources":["../src/design-manifest.ts"],"names":[],"mappings":"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"}
package/dist/i18n.d.ts DELETED
@@ -1,42 +0,0 @@
1
- /**
2
- * Strip leading and trailing `/` characters with a single linear scan.
3
- *
4
- * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
5
- * backtracks O(n²) on a long run of slashes that is not at end-of-string
6
- * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
7
- * linear and produces byte-identical output for every input.
8
- */
9
- export declare function trimSlashes(s: string): string;
10
- /**
11
- * Strip only trailing `/` characters with a single linear scan — the
12
- * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
13
- * Used for base URLs, which carry a scheme and must keep their leading
14
- * characters.
15
- */
16
- export declare function trimTrailingSlashes(s: string): string;
17
- /**
18
- * The "magic slug" sentinel test: a page whose slug is empty, `home`,
19
- * or `index` is the locale root by convention even without an explicit
20
- * `locales.home_page_id` designation. Leading/trailing slashes are
21
- * ignored so `/home/` reads the same as `home`.
22
- */
23
- export declare function isHomeSlug(slug: string): boolean;
24
- /**
25
- * The single home-decision predicate every URL/output-path site must
26
- * use so canonical, hreflang, redirects, and the emitted file agree
27
- * (0184 explicit-homepage feature). A page is the locale root when it
28
- * IS the locale's designated `home_page_id` OR carries a magic slug.
29
- *
30
- * @param pageId The page being resolved.
31
- * @param slug That page's slug.
32
- * @param localeHomePageId `locales.home_page_id` for the page's locale
33
- * (null/undefined when no page is designated).
34
- */
35
- export declare function pageIsLocaleHome(pageId: string, slug: string, localeHomePageId: string | null | undefined): boolean;
36
- /**
37
- * Canonical-JSON serializer + sha256 → hex. Stable across runs because
38
- * keys are sorted. The output is used for `pages.content_hash` so that
39
- * a Mode-2 translation can detect whether its source has changed.
40
- */
41
- export declare function computeContentHash(value: unknown): Promise<string>;
42
- //# sourceMappingURL=i18n.d.ts.map
@@ -1 +0,0 @@
1
- {"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 DELETED
@@ -1,85 +0,0 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
- /**
3
- * Slug/URL primitives shared between the static generator, the preview
4
- * op, and the admin UI. Epic #380 Phase A (#383): locale URL shaping
5
- * (resolveLocaleUrl, buildHreflangLinks) is deleted — URL shape beyond
6
- * base + slug becomes a plugin contribution on the URL composition
7
- * point (#390). What survives until the page-identity cut (#384):
8
- *
9
- * isHomeSlug / pageIsLocaleHome — the home-decision predicate.
10
- * computeContentHash — drives `pages.content_hash` (removed in #384).
11
- * trimSlashes / trimTrailingSlashes — linear-scan slug hygiene.
12
- */
13
- const TEXT_ENCODER = new TextEncoder();
14
- /**
15
- * Strip leading and trailing `/` characters with a single linear scan.
16
- *
17
- * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
18
- * backtracks O(n²) on a long run of slashes that is not at end-of-string
19
- * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
20
- * linear and produces byte-identical output for every input.
21
- */
22
- export function trimSlashes(s) {
23
- let start = 0;
24
- let end = s.length;
25
- while (start < end && s.charCodeAt(start) === 47 /* '/' */)
26
- start += 1;
27
- while (end > start && s.charCodeAt(end - 1) === 47 /* '/' */)
28
- end -= 1;
29
- return s.slice(start, end);
30
- }
31
- /**
32
- * Strip only trailing `/` characters with a single linear scan — the
33
- * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
34
- * Used for base URLs, which carry a scheme and must keep their leading
35
- * characters.
36
- */
37
- export function trimTrailingSlashes(s) {
38
- let end = s.length;
39
- while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */)
40
- end -= 1;
41
- return s.slice(0, end);
42
- }
43
- /**
44
- * The "magic slug" sentinel test: a page whose slug is empty, `home`,
45
- * or `index` is the locale root by convention even without an explicit
46
- * `locales.home_page_id` designation. Leading/trailing slashes are
47
- * ignored so `/home/` reads the same as `home`.
48
- */
49
- export function isHomeSlug(slug) {
50
- const s = trimSlashes(slug);
51
- return s === "" || s === "home" || s === "index";
52
- }
53
- /**
54
- * The single home-decision predicate every URL/output-path site must
55
- * use so canonical, hreflang, redirects, and the emitted file agree
56
- * (0184 explicit-homepage feature). A page is the locale root when it
57
- * IS the locale's designated `home_page_id` OR carries a magic slug.
58
- *
59
- * @param pageId The page being resolved.
60
- * @param slug That page's slug.
61
- * @param localeHomePageId `locales.home_page_id` for the page's locale
62
- * (null/undefined when no page is designated).
63
- */
64
- export function pageIsLocaleHome(pageId, slug, localeHomePageId) {
65
- return (localeHomePageId != null && pageId === localeHomePageId) || isHomeSlug(slug);
66
- }
67
- /**
68
- * Canonical-JSON serializer + sha256 → hex. Stable across runs because
69
- * keys are sorted. The output is used for `pages.content_hash` so that
70
- * a Mode-2 translation can detect whether its source has changed.
71
- */
72
- export async function computeContentHash(value) {
73
- const canonical = JSON.stringify(value, (_key, val) => {
74
- if (val && typeof val === "object" && !Array.isArray(val)) {
75
- const sorted = {};
76
- for (const k of Object.keys(val).sort())
77
- sorted[k] = val[k];
78
- return sorted;
79
- }
80
- return val;
81
- });
82
- const digest = await crypto.subtle.digest("SHA-256", TEXT_ENCODER.encode(canonical));
83
- return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
84
- }
85
- //# sourceMappingURL=i18n.js.map
package/dist/i18n.js.map DELETED
@@ -1 +0,0 @@
1
- {"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"}
@@ -1,93 +0,0 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
-
3
- /**
4
- * issue #165 — the Design Manifest: a generated, versioned description
5
- * of THIS site's design system (epic #149, growth-time convergence).
6
- *
7
- * The operator requirement is asymmetric: pages of the SAME site share
8
- * one visual line, while different sites are free to look nothing
9
- * alike. A global stylesheet solves the first at the cost of the
10
- * second; the per-site manifest solves both — it captures what this
11
- * site's tokens/patterns MEAN so the AI converges toward its own
12
- * design, not a Caelo default.
13
- *
14
- * Written at Genesis materialisation (or curated later via chat);
15
- * rendered as the `## Design system` system-prompt block.
16
- */
17
-
18
- import { z } from "zod";
19
-
20
- export const designManifestPattern = z
21
- .object({
22
- /** Pattern name the AI reasons in ("hero", "card grid", "cta band"). */
23
- name: z.string().min(1).max(80),
24
- /** Stable module `type` implementing it — reuse target (#159 place mode). */
25
- moduleType: z.string().max(64).optional(),
26
- /** One-line spec: what makes this pattern THIS site's version of it. */
27
- spec: z.string().min(1).max(500),
28
- })
29
- .strict();
30
-
31
- export const designManifestSchema = z
32
- .object({
33
- /** `--color-primary` → "CTAs and links only" — usage semantics per var. */
34
- tokenRoles: z.record(z.string().min(3).max(64), z.string().min(1).max(300)).optional(),
35
- /** Scale ratio, casing, measure rules. */
36
- typography: z.string().min(1).max(1000).optional(),
37
- /** Section padding, container width, grid gaps. */
38
- rhythm: z.string().min(1).max(1000).optional(),
39
- patterns: z.array(designManifestPattern).max(24).optional(),
40
- imagery: z.string().min(1).max(500).optional(),
41
- avoid: z.string().min(1).max(500).optional(),
42
- })
43
- .strict();
44
- export type DesignManifest = z.infer<typeof designManifestSchema>;
45
-
46
- /** Render the `## Design system` prompt block. Null when empty. */
47
- export function formatDesignSystemBlock(manifest: DesignManifest | null): string | null {
48
- if (manifest === null) return null;
49
- const lines: string[] = [
50
- "## Design system",
51
- "",
52
- "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.",
53
- "",
54
- ];
55
- let hasContent = false;
56
- const roles = manifest.tokenRoles ?? {};
57
- const roleEntries = Object.entries(roles);
58
- if (roleEntries.length > 0) {
59
- hasContent = true;
60
- lines.push("Token roles:");
61
- for (const [token, role] of roleEntries.slice(0, 24)) lines.push(`- \`${token}\` — ${role}`);
62
- lines.push("");
63
- }
64
- if (manifest.typography) {
65
- hasContent = true;
66
- lines.push(`Typography: ${manifest.typography}`, "");
67
- }
68
- if (manifest.rhythm) {
69
- hasContent = true;
70
- lines.push(`Rhythm: ${manifest.rhythm}`, "");
71
- }
72
- if (manifest.patterns && manifest.patterns.length > 0) {
73
- hasContent = true;
74
- lines.push("Patterns:");
75
- for (const p of manifest.patterns) {
76
- lines.push(
77
- `- **${p.name}**${p.moduleType ? ` (module type \`${p.moduleType}\`)` : ""} — ${p.spec}`,
78
- );
79
- }
80
- lines.push("");
81
- }
82
- if (manifest.imagery) {
83
- hasContent = true;
84
- lines.push(`Imagery: ${manifest.imagery}`, "");
85
- }
86
- if (manifest.avoid) {
87
- hasContent = true;
88
- lines.push(`Never: ${manifest.avoid}`, "");
89
- }
90
- if (!hasContent) return null;
91
- while (lines[lines.length - 1] === "") lines.pop();
92
- return lines.join("\n");
93
- }
package/src/i18n.test.ts DELETED
@@ -1,58 +0,0 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
-
3
- import { describe, expect, it } from "bun:test";
4
- import { computeContentHash, isHomeSlug, pageIsLocaleHome } from "./i18n.js";
5
-
6
- describe("isHomeSlug", () => {
7
- it("recognises the magic-slug sentinels regardless of surrounding slashes", () => {
8
- for (const s of ["", "home", "index", "/", "/home/", "/index"]) {
9
- expect(isHomeSlug(s)).toBe(true);
10
- }
11
- });
12
-
13
- it("treats any other slug as non-home", () => {
14
- for (const s of ["about", "en", "blog/post", "homepage"]) {
15
- expect(isHomeSlug(s)).toBe(false);
16
- }
17
- });
18
- });
19
-
20
- describe("pageIsLocaleHome (0184 shared predicate)", () => {
21
- const PAGE = "11111111-1111-4111-8111-111111111111";
22
- const OTHER = "22222222-2222-4222-8222-222222222222";
23
-
24
- it("is true when the page IS the locale's designated home_page_id", () => {
25
- expect(pageIsLocaleHome(PAGE, "en", PAGE)).toBe(true);
26
- });
27
-
28
- it("is true for a magic slug even with no designation", () => {
29
- expect(pageIsLocaleHome(PAGE, "home", null)).toBe(true);
30
- expect(pageIsLocaleHome(PAGE, "index", undefined)).toBe(true);
31
- });
32
-
33
- it("is false for a non-magic slug that isn't the designated page", () => {
34
- expect(pageIsLocaleHome(PAGE, "en", OTHER)).toBe(false);
35
- expect(pageIsLocaleHome(PAGE, "about", null)).toBe(false);
36
- });
37
- });
38
-
39
- describe("computeContentHash", () => {
40
- it("is stable across runs for the same input", async () => {
41
- const a = await computeContentHash({ x: 1, y: [1, 2] });
42
- const b = await computeContentHash({ x: 1, y: [1, 2] });
43
- expect(a).toBe(b);
44
- expect(a).toMatch(/^[0-9a-f]{64}$/);
45
- });
46
-
47
- it("is order-independent for object keys", async () => {
48
- const a = await computeContentHash({ x: 1, y: 2 });
49
- const b = await computeContentHash({ y: 2, x: 1 });
50
- expect(a).toBe(b);
51
- });
52
-
53
- it("is order-dependent for arrays", async () => {
54
- const a = await computeContentHash({ x: [1, 2] });
55
- const b = await computeContentHash({ x: [2, 1] });
56
- expect(a).not.toBe(b);
57
- });
58
- });
package/src/i18n.ts DELETED
@@ -1,91 +0,0 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
-
3
- /**
4
- * Slug/URL primitives shared between the static generator, the preview
5
- * op, and the admin UI. Epic #380 Phase A (#383): locale URL shaping
6
- * (resolveLocaleUrl, buildHreflangLinks) is deleted — URL shape beyond
7
- * base + slug becomes a plugin contribution on the URL composition
8
- * point (#390). What survives until the page-identity cut (#384):
9
- *
10
- * isHomeSlug / pageIsLocaleHome — the home-decision predicate.
11
- * computeContentHash — drives `pages.content_hash` (removed in #384).
12
- * trimSlashes / trimTrailingSlashes — linear-scan slug hygiene.
13
- */
14
-
15
- const TEXT_ENCODER = new TextEncoder();
16
-
17
- /**
18
- * Strip leading and trailing `/` characters with a single linear scan.
19
- *
20
- * Replaces the regex `/^\/+|\/+$/g`, whose trailing-slash branch
21
- * backtracks O(n²) on a long run of slashes that is not at end-of-string
22
- * (CodeQL js/polynomial-redos). This char-index walk is unconditionally
23
- * linear and produces byte-identical output for every input.
24
- */
25
- export function trimSlashes(s: string): string {
26
- let start = 0;
27
- let end = s.length;
28
- while (start < end && s.charCodeAt(start) === 47 /* '/' */) start += 1;
29
- while (end > start && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
30
- return s.slice(start, end);
31
- }
32
-
33
- /**
34
- * Strip only trailing `/` characters with a single linear scan — the
35
- * non-backtracking replacement for `/\/+$/` (same ReDoS class as above).
36
- * Used for base URLs, which carry a scheme and must keep their leading
37
- * characters.
38
- */
39
- export function trimTrailingSlashes(s: string): string {
40
- let end = s.length;
41
- while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */) end -= 1;
42
- return s.slice(0, end);
43
- }
44
-
45
- /**
46
- * The "magic slug" sentinel test: a page whose slug is empty, `home`,
47
- * or `index` is the locale root by convention even without an explicit
48
- * `locales.home_page_id` designation. Leading/trailing slashes are
49
- * ignored so `/home/` reads the same as `home`.
50
- */
51
- export function isHomeSlug(slug: string): boolean {
52
- const s = trimSlashes(slug);
53
- return s === "" || s === "home" || s === "index";
54
- }
55
-
56
- /**
57
- * The single home-decision predicate every URL/output-path site must
58
- * use so canonical, hreflang, redirects, and the emitted file agree
59
- * (0184 explicit-homepage feature). A page is the locale root when it
60
- * IS the locale's designated `home_page_id` OR carries a magic slug.
61
- *
62
- * @param pageId The page being resolved.
63
- * @param slug That page's slug.
64
- * @param localeHomePageId `locales.home_page_id` for the page's locale
65
- * (null/undefined when no page is designated).
66
- */
67
- export function pageIsLocaleHome(
68
- pageId: string,
69
- slug: string,
70
- localeHomePageId: string | null | undefined,
71
- ): boolean {
72
- return (localeHomePageId != null && pageId === localeHomePageId) || isHomeSlug(slug);
73
- }
74
-
75
- /**
76
- * Canonical-JSON serializer + sha256 → hex. Stable across runs because
77
- * keys are sorted. The output is used for `pages.content_hash` so that
78
- * a Mode-2 translation can detect whether its source has changed.
79
- */
80
- export async function computeContentHash(value: unknown): Promise<string> {
81
- const canonical = JSON.stringify(value, (_key, val) => {
82
- if (val && typeof val === "object" && !Array.isArray(val)) {
83
- const sorted: Record<string, unknown> = {};
84
- for (const k of Object.keys(val).sort()) sorted[k] = (val as Record<string, unknown>)[k];
85
- return sorted;
86
- }
87
- return val;
88
- });
89
- const digest = await crypto.subtle.digest("SHA-256", TEXT_ENCODER.encode(canonical));
90
- return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
91
- }