@caelo-cms/shared 0.10.23 → 0.10.26

package/dist/translation.d.ts

@@ -1,127 +0,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";
-export interface ModuleBlockSlot {
-    /** The block (e.g. "content", "header") this module sits in. */
-    blockName: string;
-    /** Position within the block. Blocks are ordered + 0-based. */
-    position: number;
-    /** Module id — locked across locales (translations share refs). */
-    moduleId: string;
-    /** Display name shown to the AI for context. */
-    moduleSlug: string;
-    /** The translatable fields of the module. P10 supports HTML body
-     * and three SEO-style metadata fields. Extend as new typed fields
-     * land (e.g. structured-content blocks in P12A). */
-    html: string;
-    altText: string | null;
-    caption: string | null;
-}
-export type BlockDiffOp = {
-    kind: "changed";
-    blockName: string;
-    position: number;
-    moduleId: string;
-    before: ModuleBlockSlot;
-    after: ModuleBlockSlot;
-} | {
-    kind: "added";
-    blockName: string;
-    position: number;
-    module: ModuleBlockSlot;
-} | {
-    kind: "removed";
-    blockName: string;
-    position: number;
-    module: ModuleBlockSlot;
-};
-/**
- * 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 declare function computeBlockDiff(source: readonly ModuleBlockSlot[], variant: readonly ModuleBlockSlot[]): BlockDiffOp[];
-export interface GlossaryEntry {
-    sourceTerm: string;
-    translation: string;
-    context: string | null;
-}
-export interface ModeOnePromptInput {
-    /** Source-locale code (e.g. 'en'). */
-    sourceLocale: string;
-    /** Target locale code (e.g. 'de-AT'). */
-    targetLocale: string;
-    /** Optional locale displayName for context (e.g. "German (Austria)"). */
-    targetLocaleDisplayName?: string;
-    /** Source-page modules. The AI translates each per (blockName, position). */
-    sourceModules: readonly ModuleBlockSlot[];
-    glossary: readonly GlossaryEntry[];
-    styleGuide: string | null;
-}
-export interface ModeTwoPromptInput {
-    sourceLocale: string;
-    targetLocale: string;
-    targetLocaleDisplayName?: string;
-    sourceModules: readonly ModuleBlockSlot[];
-    /** The CURRENT variant — passed in full so the AI keeps the prior
-     * translation quality on unchanged blocks. */
-    variantModules: readonly ModuleBlockSlot[];
-    /** Pre-computed diff (call computeBlockDiff first). */
-    diff: readonly BlockDiffOp[];
-    glossary: readonly GlossaryEntry[];
-    styleGuide: string | null;
-}
-/**
- * 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 declare const translationResultModule: z.ZodObject<{
-    blockName: z.ZodString;
-    position: z.ZodNumber;
-    html: z.ZodString;
-    altText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    caption: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strict>;
-export declare const translationResultPayload: z.ZodObject<{
-    modules: z.ZodArray<z.ZodObject<{
-        blockName: z.ZodString;
-        position: z.ZodNumber;
-        html: z.ZodString;
-        altText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        caption: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type TranslationResultPayload = z.infer<typeof translationResultPayload>;
-export declare function buildModeOnePrompt(input: ModeOnePromptInput): {
-    system: string;
-    user: string;
-};
-export declare function buildModeTwoPrompt(input: ModeTwoPromptInput): {
-    system: string;
-    user: string;
-};
-//# sourceMappingURL=translation.d.ts.map

package/dist/translation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../src/translation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB;;wDAEoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;CACxB,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,WAAW,EAAE,CAgCf;AAMD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C;kDAC8C;IAC9C,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,uDAAuD;IACvD,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;kBASzB,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;kBAI1B,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAiChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAuBA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAuEA"}

package/dist/translation.js

@@ -1,208 +0,0 @@
-// 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

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

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");
-}