@neatico/visual-core 0.14.3 → 0.14.64

package/dist/cjs/contentBrief.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContentBrief = createContentBrief;
+exports.validateContentBrief = validateContentBrief;
+function createContentBrief(source) {
+    if (!source ||
+        source.version !== 1 ||
+        typeof source.text !== "string" ||
+        !source.text.trim() ||
+        !Array.isArray(source.segments) ||
+        !source.segments.length)
+        throw new Error("CONTENT_BRIEF_INVALID");
+    const provenance = source.provenance;
+    if (provenance &&
+        (!["creative-draft", "user-revision"].includes(provenance.kind) ||
+            typeof provenance.original !== "string" ||
+            !provenance.original.trim() ||
+            typeof provenance.disclosure !== "string" ||
+            !provenance.disclosure.trim() ||
+            (provenance.originalMode !== undefined &&
+                (provenance.kind !== "user-revision" ||
+                    !["source-backed", "creative"].includes(provenance.originalMode))) ||
+            (provenance.illustrative !== undefined &&
+                (provenance.kind !== "user-revision" || typeof provenance.illustrative !== "boolean")) ||
+            (provenance.simulationAllowed !== undefined &&
+                typeof provenance.simulationAllowed !== "boolean") ||
+            (provenance.language !== undefined &&
+                (typeof provenance.language !== "string" ||
+                    !/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,3}$/.test(provenance.language)))))
+        throw new Error("CONTENT_BRIEF_INVALID");
+    const sourceIds = source.segments.map((segment) => segment.id);
+    if (sourceIds.some((id) => typeof id !== "string" || !id) ||
+        new Set(sourceIds).size !== sourceIds.length)
+        throw new Error("CONTENT_BRIEF_INVALID");
+    return validateContentBrief({
+        version: 1,
+        originalInput: provenance?.original || source.text,
+        ...(provenance?.kind === "user-revision" ? { revisedInput: source.text } : {}),
+        ...(provenance?.kind === "user-revision" && provenance.illustrative ? { revisedInputIllustrative: true } : {}),
+        mode: provenance?.kind === "user-revision" ? provenance.originalMode || "source-backed" : provenance ? "creative" : "source-backed",
+        ...(provenance?.language ? { language: provenance.language } : {}),
+        creativeAllowed: true,
+        simulationAllowed: true,
+        sourceIds,
+    });
+}
+function validateContentBrief(value) {
+    const brief = value;
+    if (!brief ||
+        brief.version !== 1 ||
+        typeof brief.originalInput !== "string" ||
+        !brief.originalInput.trim() ||
+        brief.originalInput.length > 20000 ||
+        (brief.revisedInput !== undefined &&
+            (typeof brief.revisedInput !== "string" || !brief.revisedInput.trim() || brief.revisedInput.length > 20000)) ||
+        (brief.revisedInputIllustrative !== undefined &&
+            (typeof brief.revisedInputIllustrative !== "boolean" || brief.revisedInput === undefined)) ||
+        !["source-backed", "creative"].includes(brief.mode) ||
+        typeof brief.creativeAllowed !== "boolean" ||
+        typeof brief.simulationAllowed !== "boolean" ||
+        (brief.simulationAllowed && !brief.creativeAllowed) ||
+        (brief.language !== undefined &&
+            (typeof brief.language !== "string" ||
+                !/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,3}$/.test(brief.language))) ||
+        !Array.isArray(brief.sourceIds) ||
+        !brief.sourceIds.length ||
+        brief.sourceIds.length > 1024 ||
+        new Set(brief.sourceIds).size !== brief.sourceIds.length ||
+        brief.sourceIds.some((id) => typeof id !== "string" || !id || id.length > 160))
+        throw new Error("CONTENT_BRIEF_INVALID");
+    return {
+        version: 1,
+        originalInput: brief.originalInput,
+        ...(brief.revisedInput !== undefined ? { revisedInput: brief.revisedInput } : {}),
+        ...(brief.revisedInputIllustrative !== undefined ? { revisedInputIllustrative: brief.revisedInputIllustrative } : {}),
+        mode: brief.mode,
+        ...(brief.language ? { language: brief.language } : {}),
+        creativeAllowed: brief.creativeAllowed,
+        simulationAllowed: brief.simulationAllowed,
+        sourceIds: [...brief.sourceIds],
+    };
+}

package/dist/cjs/designBlueprint.js

@@ -4,31 +4,106 @@ exports.DESIGN_SAMPLE_LOCALES = void 0;
 exports.validateDesignBlueprint = validateDesignBlueprint;
 exports.blueprintFitsContent = blueprintFitsContent;
 const content_js_1 = require("./content.js");
-exports.DESIGN_SAMPLE_LOCALES = ['en-US', 'zh-CH', 'ja-JP', 'de-DE', 'fr-FR', 'es-ES', 'pt-PT'];
+exports.DESIGN_SAMPLE_LOCALES = [
+    "en-US",
+    "zh-CH",
+    "ja-JP",
+    "de-DE",
+    "fr-FR",
+    "es-ES",
+    "pt-PT",
+];
 function validateDesignBlueprint(raw) {
     const v = raw;
-    if (!v || v.version !== 2 || typeof v.id !== 'string' || !/^[a-z][a-z0-9-]{0,79}$/.test(v.id))
-        throw new Error('DESIGN_BLUEPRINT_ID');
-    const kinds = ['paragraph', 'steps', 'features', 'comparison', 'code', 'parameters', 'quote', 'chart', 'image'];
-    if (!Array.isArray(v.kinds) || !v.kinds.length || v.kinds.length > 9 || v.kinds.some(k => !kinds.includes(k)))
-        throw new Error('DESIGN_BLUEPRINT_KINDS');
-    if (!v.labels || typeof v.labels !== 'object' || Array.isArray(v.labels) || typeof v.labels.en !== 'string' || !v.labels.en.trim() || Object.entries(v.labels).some(([key, value]) => !/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(key) || typeof value !== 'string' || !value.trim() || value.length > 120))
-        throw new Error('DESIGN_BLUEPRINT_LABELS');
-    if (!Array.isArray(v.ratios) || !v.ratios.length || v.ratios.length > 8 || v.ratios.some(n => !Number.isFinite(n) || n < .25 || n > 4))
-        throw new Error('DESIGN_BLUEPRINT_RATIOS');
-    const number = (n, min, max) => { if (typeof n !== 'number' || !Number.isFinite(n) || n < min || n > max)
-        throw new Error('DESIGN_BLUEPRINT_RANGE'); return n; };
+    if (!v ||
+        v.version !== 2 ||
+        typeof v.id !== "string" ||
+        !/^[a-z][a-z0-9-]{0,79}$/.test(v.id))
+        throw new Error("DESIGN_BLUEPRINT_ID");
+    const kinds = [
+        "paragraph",
+        "steps",
+        "features",
+        "comparison",
+        "code",
+        "parameters",
+        "quote",
+        "chart",
+        "image",
+    ];
+    if (!Array.isArray(v.kinds) ||
+        !v.kinds.length ||
+        v.kinds.length > 9 ||
+        v.kinds.some((k) => !kinds.includes(k)))
+        throw new Error("DESIGN_BLUEPRINT_KINDS");
+    if (!v.labels ||
+        typeof v.labels !== "object" ||
+        Array.isArray(v.labels) ||
+        typeof v.labels.en !== "string" ||
+        !v.labels.en.trim() ||
+        Object.entries(v.labels).some(([key, value]) => !/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(key) ||
+            typeof value !== "string" ||
+            !value.trim() ||
+            value.length > 120))
+        throw new Error("DESIGN_BLUEPRINT_LABELS");
+    if (!Array.isArray(v.ratios) ||
+        !v.ratios.length ||
+        v.ratios.length > 8 ||
+        v.ratios.some((n) => !Number.isFinite(n) || n < 0.25 || n > 4))
+        throw new Error("DESIGN_BLUEPRINT_RATIOS");
+    const number = (n, min, max) => {
+        if (typeof n !== "number" || !Number.isFinite(n) || n < min || n > max)
+            throw new Error("DESIGN_BLUEPRINT_RANGE");
+        return n;
+    };
     const c = v.capacity, l = v.layout;
     if (!c || !l)
-        throw new Error('DESIGN_BLUEPRINT_MISSING');
-    if (!['stack', 'split', 'editorial'].includes(l.mode) || !['none', 'panels', 'bands'].includes(l.surface) || !['none', 'rail', 'rule'].includes(l.accent))
-        throw new Error('DESIGN_BLUEPRINT_LAYOUT');
+        throw new Error("DESIGN_BLUEPRINT_MISSING");
+    if (!["stack", "split", "editorial"].includes(l.mode) ||
+        !["none", "panels", "bands"].includes(l.surface) ||
+        !["none", "rail", "rule"].includes(l.accent))
+        throw new Error("DESIGN_BLUEPRINT_LAYOUT");
     const maxEntries = number(c.maxEntries, 1, 20), maxBlocks = number(c.maxBlocks, 1, 8), columns = number(l.columns, 1, 4);
     if (![maxEntries, maxBlocks, columns].every(Number.isInteger))
-        throw new Error('DESIGN_BLUEPRINT_INTEGER');
-    return { version: 2, id: v.id, labels: { ...v.labels }, kinds: [...new Set(v.kinds)], ratios: [...new Set(v.ratios)], capacity: { maxCharacters: number(c.maxCharacters, 40, 20000), maxEntries, maxBlocks }, layout: { mode: l.mode, margin: number(l.margin, 32, 80), gap: number(l.gap, 12, 40), titleScale: number(l.titleScale, .8, 1.15), bodyScale: number(l.bodyScale, .9, 1.15), columns, surface: l.surface, accent: l.accent } };
+        throw new Error("DESIGN_BLUEPRINT_INTEGER");
+    return {
+        version: 2,
+        id: v.id,
+        labels: { ...v.labels },
+        kinds: [...new Set(v.kinds)],
+        ratios: [...new Set(v.ratios)],
+        capacity: {
+            maxCharacters: number(c.maxCharacters, 40, 20000),
+            maxEntries,
+            maxBlocks,
+        },
+        layout: {
+            mode: l.mode,
+            margin: number(l.margin, 32, 80),
+            gap: number(l.gap, 12, 40),
+            titleScale: number(l.titleScale, 0.8, 1.15),
+            bodyScale: number(l.bodyScale, 0.9, 1.15),
+            columns,
+            surface: l.surface,
+            accent: l.accent,
+        },
+    };
 }
 function blueprintFitsContent(blueprint, page, ratio) {
-    const entries = page.blocks.reduce((sum, b) => sum + ('entries' in b ? b.entries.length : 'columns' in b ? b.columns.length : 'rows' in b ? b.rows.length : 'values' in b ? b.values.length : 0), 0);
-    return blueprint.ratios.some(r => Math.abs(r - ratio) < .001) && page.blocks.length <= blueprint.capacity.maxBlocks && page.blocks.every(b => blueprint.kinds.includes(b.kind)) && page.blocks.flatMap(content_js_1.contentBlockText).join('').length <= blueprint.capacity.maxCharacters && entries <= blueprint.capacity.maxEntries;
+    const entries = page.blocks.reduce((sum, b) => sum +
+        ("entries" in b
+            ? b.entries.length
+            : "columns" in b
+                ? b.columns.length
+                : "rows" in b
+                    ? b.rows.length
+                    : "values" in b
+                        ? b.values.length
+                        : 0), 0);
+    return (blueprint.ratios.some((r) => Math.abs(r - ratio) < 0.001) &&
+        page.blocks.length <= blueprint.capacity.maxBlocks &&
+        page.blocks.every((b) => blueprint.kinds.includes(b.kind)) &&
+        page.blocks.flatMap(content_js_1.contentBlockText).join("").length <=
+            blueprint.capacity.maxCharacters &&
+        entries <= blueprint.capacity.maxEntries);
 }