@caelo-cms/shared 0.2.2

package/dist/translation.js

@@ -0,0 +1,208 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * P10 — translation primitives shared between the AI prompt builder,
+ * the Mode 1 / Mode 2 op handlers, and the dashboard.
+ *
+ *   computeBlockDiff(source, variant) — block-level diff per
+ *     CMS_REQUIREMENTS §7.6: matches modules by (block_name, position),
+ *     returns typed `changed` / `added` / `removed` operations. Pure
+ *     function; the AI receives this as Mode 2 prompt context.
+ *
+ *   buildModeOnePrompt(...) / buildModeTwoPrompt(...) — assemble the
+ *     §7.6 sample-payload shapes with glossary + style guide injected.
+ *     Returns the prompt + a structured payload for unit-tests to
+ *     assert against.
+ */
+import { z } from "zod";
+/**
+ * Diff a source page's modules against a variant's modules. Match by
+ * (blockName, position) — the §7.5 contract is that translations
+ * share STRUCTURE with the source (block + position alignment) and
+ * differ only in CONTENT (html / alt / caption per locale). Anything
+ * mis-aligned is `added` (source has it, variant doesn't) or
+ * `removed` (variant has it, source doesn't).
+ *
+ * `changed` rows contain BOTH before + after so the AI prompt can
+ * show the structured diff per the §7.6 sample payload.
+ */
+export function computeBlockDiff(source, variant) {
+    const ops = [];
+    const variantBy = new Map();
+    for (const v of variant)
+        variantBy.set(`${v.blockName}|${v.position}`, v);
+    const sourceBy = new Map();
+    for (const s of source)
+        sourceBy.set(`${s.blockName}|${s.position}`, s);
+    for (const s of source) {
+        const key = `${s.blockName}|${s.position}`;
+        const v = variantBy.get(key);
+        if (!v) {
+            ops.push({ kind: "added", blockName: s.blockName, position: s.position, module: s });
+            continue;
+        }
+        if (s.html !== v.html || s.altText !== v.altText || s.caption !== v.caption) {
+            ops.push({
+                kind: "changed",
+                blockName: s.blockName,
+                position: s.position,
+                moduleId: v.moduleId,
+                before: v,
+                after: s,
+            });
+        }
+    }
+    for (const v of variant) {
+        const key = `${v.blockName}|${v.position}`;
+        if (!sourceBy.has(key)) {
+            ops.push({ kind: "removed", blockName: v.blockName, position: v.position, module: v });
+        }
+    }
+    return ops;
+}
+/**
+ * The AI returns this shape for both Mode 1 and Mode 2: one entry per
+ * source module slot, with the translated content fields. The handler
+ * matches entries back to the variant page's module rows by
+ * (blockName, position).
+ *
+ * Mode 1 returns one entry per source module.
+ * Mode 2 returns entries ONLY for changed blocks (preserves prior
+ *   translation on unchanged ones).
+ */
+export const translationResultModule = z
+    .object({
+    blockName: z.string().min(1),
+    position: z.number().int().min(0),
+    /** Translated module HTML body. */
+    html: z.string(),
+    altText: z.string().nullable().optional(),
+    caption: z.string().nullable().optional(),
+})
+    .strict();
+export const translationResultPayload = z
+    .object({
+    modules: z.array(translationResultModule),
+})
+    .strict();
+function renderGlossaryBlock(glossary) {
+    if (glossary.length === 0)
+        return "";
+    const lines = glossary.map((g) => g.context
+        ? `- "${g.sourceTerm}" → "${g.translation}" (${g.context})`
+        : `- "${g.sourceTerm}" → "${g.translation}"`);
+    return ["", "## Glossary (use these exact translations)", ...lines].join("\n");
+}
+function renderStyleGuideBlock(styleGuide) {
+    if (!styleGuide || styleGuide.trim().length === 0)
+        return "";
+    return ["", "## Style guide", styleGuide.trim()].join("\n");
+}
+function renderSourceModulesBlock(modules) {
+    const rendered = modules.map((m) => {
+        const parts = [
+            `### Module ${m.moduleSlug} (block=${m.blockName}, position=${m.position})`,
+            "HTML:",
+            "```html",
+            m.html,
+            "```",
+        ];
+        if (m.altText !== null)
+            parts.push(`alt: ${m.altText}`);
+        if (m.caption !== null)
+            parts.push(`caption: ${m.caption}`);
+        return parts.join("\n");
+    });
+    return rendered.join("\n\n");
+}
+export function buildModeOnePrompt(input) {
+    const targetLabel = input.targetLocaleDisplayName ?? input.targetLocale;
+    const system = [
+        "You are translating a web page from one locale to another.",
+        `Source locale: ${input.sourceLocale}.`,
+        `Target locale: ${input.targetLocale} (${targetLabel}).`,
+        "",
+        "STRUCTURAL LOCK — the page's module layout (block names + positions) is identical across locales. You may NOT add, remove, or reorder modules. Translate ONLY the content fields (html, alt, caption) of each existing module.",
+        "",
+        "Translate every module listed below into the target locale. Preserve every HTML tag, attribute, class, id, href, and inline style verbatim — only the human-readable text inside tags + the alt/caption fields are translated. Numbers, code samples, and untranslatable proper nouns stay as-is.",
+        "",
+        'Respond with a JSON object matching: {"modules": [{"blockName": str, "position": int, "html": str, "altText": str|null, "caption": str|null}, ...]}. Return ONE entry per source module — same blockName + position.',
+        renderGlossaryBlock(input.glossary),
+        renderStyleGuideBlock(input.styleGuide),
+    ]
+        .filter((s) => s.length > 0)
+        .join("\n");
+    const user = [
+        `# Source page modules (${input.sourceLocale} → ${input.targetLocale})`,
+        "",
+        renderSourceModulesBlock(input.sourceModules),
+    ].join("\n");
+    return { system, user };
+}
+export function buildModeTwoPrompt(input) {
+    const targetLabel = input.targetLocaleDisplayName ?? input.targetLocale;
+    const changed = input.diff.filter((d) => d.kind === "changed");
+    const added = input.diff.filter((d) => d.kind === "added");
+    const removed = input.diff.filter((d) => d.kind === "removed");
+    const system = [
+        "You are updating an existing translation of a web page after the source changed.",
+        `Source locale: ${input.sourceLocale}.`,
+        `Target locale: ${input.targetLocale} (${targetLabel}).`,
+        "",
+        "STRUCTURAL LOCK — the page's module layout (block names + positions) is identical across locales. You may NOT add, remove, or reorder modules. Translate ONLY the content fields (html, alt, caption) that have CHANGED on the source. Preserve the existing translation verbatim for unchanged modules.",
+        "",
+        "Numbers, code samples, and untranslatable proper nouns stay as-is. Preserve every HTML tag/attribute/class/id/href/inline style in the source verbatim.",
+        "",
+        'Respond with a JSON object matching: {"modules": [{"blockName": str, "position": int, "html": str, "altText": str|null, "caption": str|null}, ...]}. Return ONE entry per CHANGED module — do NOT include unchanged modules in the response.',
+        renderGlossaryBlock(input.glossary),
+        renderStyleGuideBlock(input.styleGuide),
+    ]
+        .filter((s) => s.length > 0)
+        .join("\n");
+    const userLines = [
+        `# Update translation: ${input.sourceLocale} → ${input.targetLocale}`,
+        "",
+        "## Current source (full, for context)",
+        "",
+        renderSourceModulesBlock(input.sourceModules),
+        "",
+        "## Existing translation (preserve unchanged modules verbatim)",
+        "",
+        renderSourceModulesBlock(input.variantModules),
+        "",
+        "## Structured diff",
+    ];
+    if (changed.length === 0 && added.length === 0 && removed.length === 0) {
+        userLines.push("(no changes detected — return an empty `modules` array)");
+    }
+    for (const c of changed) {
+        if (c.kind !== "changed")
+            continue;
+        userLines.push("");
+        userLines.push(`### CHANGED — block=${c.blockName} position=${c.position} module=${c.moduleId}`);
+        userLines.push("Before (existing translation):");
+        userLines.push("```html");
+        userLines.push(c.before.html);
+        userLines.push("```");
+        userLines.push("Source after (current source HTML to re-translate):");
+        userLines.push("```html");
+        userLines.push(c.after.html);
+        userLines.push("```");
+    }
+    for (const a of added) {
+        if (a.kind !== "added")
+            continue;
+        userLines.push("");
+        userLines.push(`### ADDED in source — block=${a.blockName} position=${a.position} (must translate)`);
+        userLines.push("```html");
+        userLines.push(a.module.html);
+        userLines.push("```");
+    }
+    for (const r of removed) {
+        if (r.kind !== "removed")
+            continue;
+        userLines.push("");
+        userLines.push(`### REMOVED from source — block=${r.blockName} position=${r.position} (drop from the translation)`);
+    }
+    return { system, user: userLines.join("\n") };
+}
+//# sourceMappingURL=translation.js.map

package/dist/translation.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,46 @@
+/**
+ * P17.0 — single source of truth for the Caelo version.
+ *
+ * Bumped via `bun run scripts/release.ts <new-version>` which:
+ *   1. Updates this constant + the root package.json `version`,
+ *   2. Re-signs every Tier-1 plugin manifest under packages/plugins/,
+ *   3. Builds + writes the release notes via `scripts/release-notes.ts`,
+ *   4. Tags the commit as `vX.Y.Z`,
+ *   5. Pushes — GitHub Actions takes over for the publish step.
+ *
+ * Read by:
+ *   - admin's /security index page (header badge + about-modal),
+ *   - cms-provision CLI's `version` subcommand,
+ *   - User-Agent header on plugin-host's outbound HTTP calls,
+ *   - Tier-1 manifest signing (the version is hashed into the
+ *     signature payload so a manifest from version 0.5.0 can't be
+ *     replayed as a 0.6.0 manifest).
+ *
+ * Format: SemVer 2.0.0. Pre-1.0 minor bumps are breaking; post-1.0
+ * follow standard SemVer.
+ */
+export declare const CAELO_VERSION = "0.2.2";
+/**
+ * Deprecated alias for back-compat — early P17 work spelled this
+ * `CALEO_VERSION` (typo of "Caelo"). New code should import
+ * `CAELO_VERSION`. Kept as a re-export so existing callers keep
+ * compiling; remove once external consumers have migrated.
+ *
+ * @deprecated use CAELO_VERSION
+ */
+export declare const CALEO_VERSION = "0.2.2";
+/**
+ * Parsed shape — major/minor/patch + optional pre-release tag.
+ * Stable interface for callers that need to feature-gate (rare —
+ * Caelo doesn't do feature flags, but version-gating a deprecation
+ * warning is a legitimate use).
+ */
+export interface CaeloVersion {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly preRelease: string | null;
+    readonly raw: string;
+}
+export declare function parseVersion(raw?: string): CaeloVersion;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,UAAgB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,YAAY,CAYtE"}

package/dist/version.js

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * P17.0 — single source of truth for the Caelo version.
+ *
+ * Bumped via `bun run scripts/release.ts <new-version>` which:
+ *   1. Updates this constant + the root package.json `version`,
+ *   2. Re-signs every Tier-1 plugin manifest under packages/plugins/,
+ *   3. Builds + writes the release notes via `scripts/release-notes.ts`,
+ *   4. Tags the commit as `vX.Y.Z`,
+ *   5. Pushes — GitHub Actions takes over for the publish step.
+ *
+ * Read by:
+ *   - admin's /security index page (header badge + about-modal),
+ *   - cms-provision CLI's `version` subcommand,
+ *   - User-Agent header on plugin-host's outbound HTTP calls,
+ *   - Tier-1 manifest signing (the version is hashed into the
+ *     signature payload so a manifest from version 0.5.0 can't be
+ *     replayed as a 0.6.0 manifest).
+ *
+ * Format: SemVer 2.0.0. Pre-1.0 minor bumps are breaking; post-1.0
+ * follow standard SemVer.
+ */
+export const CAELO_VERSION = "0.2.2";
+/**
+ * Deprecated alias for back-compat — early P17 work spelled this
+ * `CALEO_VERSION` (typo of "Caelo"). New code should import
+ * `CAELO_VERSION`. Kept as a re-export so existing callers keep
+ * compiling; remove once external consumers have migrated.
+ *
+ * @deprecated use CAELO_VERSION
+ */
+export const CALEO_VERSION = CAELO_VERSION;
+export function parseVersion(raw = CAELO_VERSION) {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/.exec(raw);
+    if (!m) {
+        throw new Error(`invalid Caelo version: ${raw}`);
+    }
+    return {
+        major: Number.parseInt(m[1] ?? "0", 10),
+        minor: Number.parseInt(m[2] ?? "0", 10),
+        patch: Number.parseInt(m[3] ?? "0", 10),
+        preRelease: m[4] ?? null,
+        raw,
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAgB3C,MAAM,UAAU,YAAY,CAAC,MAAc,aAAa;IACtD,MAAM,CAAC,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;QACvC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QACxB,GAAG;KACJ,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@caelo-cms/shared",
+  "version": "0.2.2",
+  "private": false,
+  "license": "MPL-2.0",
+  "description": "Shared Zod schemas + types + the two-pass HTML composer used by every Caelo CMS workspace package. Stable enough for plugin authors and embedders to depend on directly.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caelo-cms/caelo-cms.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/caelo-cms/caelo-cms#readme",
+  "bugs": "https://github.com/caelo-cms/caelo-cms/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "typecheck": "tsc -b",
+    "build": "tsc -b --force",
+    "prepublishOnly": "tsc -b --force"
+  },
+  "dependencies": {
+    "htmlparser2": "^12.0.0",
+    "zod": "4.3.6"
+  }
+}