@neatico/visual-core 0.14.2 → 0.14.26

package/dist/cjs/composition.js

@@ -6,18 +6,29 @@ exports.validateComposition = validateComposition;
 exports.COMPOSITION_PROMPT = `Also return composition:{version:1,root:node}. Design a hierarchy from the content, not a fixed template. A node is {type,weight?,tone?,role?,bind?,icon?,children?}. row and column contain 2-4 children; nest up to 5 levels, at most 40 nodes. Weight is relative space 0.5-4. Tone plain/card/contrast applies to groups. Text binds exactly one existing nonempty content field (title or headline, body, eyebrow, cta, value, attribution, items.0.title, items.0.description, etc); never bind notes. Include EVERY nonempty content field exactly once. Text role hero/heading/body/caption controls typography. Image is an optional original conceptual illustration, not invented evidence or a photo. Icon optionally uses idea/check/chart/people/shield/arrow. Divider separates related content. No coordinates, CSS, HTML, URLs or text in the tree. Use one strong hero, purposeful contrast, asymmetric columns, grouped evidence, and breathing room. Rows reflow for narrow formats. Different stories should have different trees, not just different colors.`;
 function compositionFields(value) {
     const fields = {};
-    for (const key of ['title', 'headline', 'body', 'eyebrow', 'cta', 'value', 'attribution'])
-        if (typeof value[key] === 'string' && value[key].trim())
+    for (const key of [
+        "title",
+        "headline",
+        "body",
+        "eyebrow",
+        "cta",
+        "value",
+        "attribution",
+    ])
+        if (typeof value[key] === "string" && value[key].trim())
             fields[key] = value[key];
     if (Array.isArray(value.items))
-        value.items.forEach((item, i) => { if (!item || typeof item !== 'object')
-            return; for (const key of ['title', 'description']) {
-            if (!Object.prototype.hasOwnProperty.call(item, key))
-                continue;
-            const v = item[key];
-            if (typeof v === 'string' && v.trim())
-                fields[`items.${i}.${key}`] = v;
-        } });
+        value.items.forEach((item, i) => {
+            if (!item || typeof item !== "object")
+                return;
+            for (const key of ["title", "description"]) {
+                if (!Object.prototype.hasOwnProperty.call(item, key))
+                    continue;
+                const v = item[key];
+                if (typeof v === "string" && v.trim())
+                    fields[`items.${i}.${key}`] = v;
+            }
+        });
     return fields;
 }
 function validateComposition(raw, fields) {
@@ -25,44 +36,59 @@ function validateComposition(raw, fields) {
     let count = 0, images = 0;
     const seen = new Set();
     if (!value || value.version !== 1)
-        throw new Error('Unsupported composition');
+        throw new Error("Unsupported composition");
     function visit(n, depth) {
-        if (!n || typeof n !== 'object' || ++count > 40 || depth > 5 || !['row', 'column', 'text', 'image', 'divider', 'icon'].includes(n.type))
-            throw new Error('Invalid composition node');
-        if (n.weight !== undefined && (!Number.isFinite(n.weight) || n.weight < .5 || n.weight > 4))
-            throw new Error('Invalid composition weight');
-        if (n.tone !== undefined && !['plain', 'card', 'contrast'].includes(n.tone))
-            throw new Error('Invalid composition tone');
-        const out = { type: n.type, weight: n.weight, tone: n.tone };
-        if (n.type === 'row' || n.type === 'column') {
-            if (!Array.isArray(n.children) || n.children.length < 2 || n.children.length > 4)
-                throw new Error('Invalid composition group');
-            out.children = n.children.map(c => visit(c, depth + 1));
+        if (!n ||
+            typeof n !== "object" ||
+            ++count > 40 ||
+            depth > 5 ||
+            !["row", "column", "text", "image", "divider", "icon"].includes(n.type))
+            throw new Error("Invalid composition node");
+        if (n.weight !== undefined &&
+            (!Number.isFinite(n.weight) || n.weight < 0.5 || n.weight > 4))
+            throw new Error("Invalid composition weight");
+        if (n.tone !== undefined && !["plain", "card", "contrast"].includes(n.tone))
+            throw new Error("Invalid composition tone");
+        const out = {
+            type: n.type,
+            weight: n.weight,
+            tone: n.tone,
+        };
+        if (n.type === "row" || n.type === "column") {
+            if (!Array.isArray(n.children) ||
+                n.children.length < 2 ||
+                n.children.length > 4)
+                throw new Error("Invalid composition group");
+            out.children = n.children.map((c) => visit(c, depth + 1));
         }
         else {
             if (n.children !== undefined)
-                throw new Error('Leaf cannot have children');
-            if (n.type === 'text') {
-                if (!n.bind || !Object.prototype.hasOwnProperty.call(fields, n.bind) || seen.has(n.bind))
-                    throw new Error('Invalid or duplicated binding');
-                if (n.role !== undefined && !['hero', 'heading', 'body', 'caption'].includes(n.role))
-                    throw new Error('Invalid text role');
+                throw new Error("Leaf cannot have children");
+            if (n.type === "text") {
+                if (!n.bind ||
+                    !Object.prototype.hasOwnProperty.call(fields, n.bind) ||
+                    seen.has(n.bind))
+                    throw new Error("Invalid or duplicated binding");
+                if (n.role !== undefined &&
+                    !["hero", "heading", "body", "caption"].includes(n.role))
+                    throw new Error("Invalid text role");
                 seen.add(n.bind);
                 out.bind = n.bind;
-                out.role = n.role || 'body';
+                out.role = n.role || "body";
             }
-            if (n.type === 'image' && ++images > 1)
-                throw new Error('Only one illustration per composition');
-            if (n.type === 'icon') {
-                if (!n.icon || !['idea', 'check', 'chart', 'people', 'shield', 'arrow'].includes(n.icon))
-                    throw new Error('Invalid icon');
+            if (n.type === "image" && ++images > 1)
+                throw new Error("Only one illustration per composition");
+            if (n.type === "icon") {
+                if (!n.icon ||
+                    !["idea", "check", "chart", "people", "shield", "arrow"].includes(n.icon))
+                    throw new Error("Invalid icon");
                 out.icon = n.icon;
             }
         }
         return out;
     }
     const root = visit(value.root, 0);
-    if (Object.keys(fields).some(key => !seen.has(key)))
-        throw new Error('Composition omits content');
+    if (Object.keys(fields).some((key) => !seen.has(key)))
+        throw new Error("Composition omits content");
     return { version: 1, root };
 }

package/dist/cjs/compositionScenes.js

@@ -2,50 +2,103 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AUTHORED_COMPOSITIONS = exports.COMPOSITION_SCENES = void 0;
 exports.sceneRecipePreference = sceneRecipePreference;
-const both = ['presentation', 'social'];
+const both = ["presentation", "social"];
 exports.COMPOSITION_SCENES = [
-    { id: 'brand-collection', kinds: ['features'], outputs: both },
-    { id: 'hero', kinds: ['paragraph'], outputs: both }, { id: 'chapter', kinds: ['paragraph'], outputs: ['presentation'] },
-    { id: 'statement', kinds: ['paragraph'], outputs: both }, { id: 'closing', kinds: ['paragraph'], outputs: both },
-    { id: 'product-launch', kinds: ['features'], outputs: both }, { id: 'feature-spotlight', kinds: ['features'], outputs: both },
-    { id: 'feature-overview', kinds: ['features'], outputs: both }, { id: 'benefits', kinds: ['features'], outputs: both },
-    { id: 'comparison', kinds: ['comparison'], outputs: both }, { id: 'before-after', kinds: ['comparison'], outputs: both },
-    { id: 'plan-options', kinds: ['comparison'], outputs: both }, { id: 'process', kinds: ['steps'], outputs: both },
-    { id: 'roadmap', kinds: ['steps'], outputs: both }, { id: 'tutorial', kinds: ['steps'], outputs: both },
-    { id: 'checklist', kinds: ['features'], outputs: both }, { id: 'metrics', kinds: ['chart'], outputs: both },
-    { id: 'trend', kinds: ['chart'], outputs: both }, { id: 'results', kinds: ['chart'], outputs: both },
-    { id: 'quotation', kinds: ['quote'], outputs: both }, { id: 'testimonial', kinds: ['quote'], outputs: both },
-    { id: 'code-example', kinds: ['code'], outputs: both }, { id: 'specifications', kinds: ['parameters'], outputs: both },
-    { id: 'pricing-details', kinds: ['parameters'], outputs: both }, { id: 'event-details', kinds: ['parameters'], outputs: both },
-    { id: 'recruitment-details', kinds: ['parameters'], outputs: both },
-    { id: 'product-demonstration', kinds: ['image'], outputs: both, requiresAsset: true },
-    { id: 'photograph', kinds: ['image'], outputs: both, requiresAsset: true },
-    ...['banner-hero', 'product-showcase', 'editorial-cover', 'image-campaign'].map(id => ({ id, kinds: ['image'], outputs: both, requiresAsset: true })),
+    { id: "menu-details", kinds: ["parameters"], outputs: both },
+    { id: "travel-details", kinds: ["parameters"], outputs: both },
+    { id: "offer-details", kinds: ["parameters"], outputs: both },
+    { id: "questions", kinds: ["features"], outputs: both },
+    { id: "case-study", kinds: ["features"], outputs: both },
+    { id: "brand-collection", kinds: ["features"], outputs: both },
+    { id: "hero", kinds: ["paragraph"], outputs: both },
+    { id: "chapter", kinds: ["paragraph"], outputs: ["presentation"] },
+    { id: "statement", kinds: ["paragraph"], outputs: both },
+    { id: "closing", kinds: ["paragraph"], outputs: both },
+    { id: "product-launch", kinds: ["features"], outputs: both },
+    { id: "feature-spotlight", kinds: ["features"], outputs: both },
+    { id: "feature-overview", kinds: ["features"], outputs: both },
+    { id: "benefits", kinds: ["features"], outputs: both },
+    { id: "comparison", kinds: ["comparison"], outputs: both },
+    { id: "before-after", kinds: ["comparison"], outputs: both },
+    { id: "plan-options", kinds: ["comparison"], outputs: both },
+    { id: "process", kinds: ["steps"], outputs: both },
+    { id: "roadmap", kinds: ["steps"], outputs: both },
+    { id: "tutorial", kinds: ["steps"], outputs: both },
+    { id: "checklist", kinds: ["features"], outputs: both },
+    { id: "metrics", kinds: ["chart"], outputs: both },
+    { id: "trend", kinds: ["chart"], outputs: both },
+    { id: "results", kinds: ["chart"], outputs: both },
+    { id: "quotation", kinds: ["quote"], outputs: both },
+    { id: "testimonial", kinds: ["quote"], outputs: both },
+    { id: "code-example", kinds: ["code"], outputs: both },
+    { id: "specifications", kinds: ["parameters"], outputs: both },
+    { id: "pricing-details", kinds: ["parameters"], outputs: both },
+    { id: "event-details", kinds: ["parameters"], outputs: both },
+    { id: "recruitment-details", kinds: ["parameters"], outputs: both },
+    {
+        id: "product-demonstration",
+        kinds: ["image"],
+        outputs: both,
+        requiresAsset: true,
+    },
+    { id: "photograph", kinds: ["image"], outputs: both, requiresAsset: true },
+    ...[
+        "banner-hero",
+        "product-showcase",
+        "editorial-cover",
+        "image-campaign",
+    ].map((id) => ({
+        id,
+        kinds: ["image"],
+        outputs: both,
+        requiresAsset: true,
+    })),
 ];
 exports.AUTHORED_COMPOSITIONS = [
-    { id: 'feature-focus', kind: 'features', min: 1, max: 1 },
-    { id: 'feature-bento', kind: 'features', min: 2, max: 6 },
-    { id: 'feature-index', kind: 'features', min: 2, max: 6 },
-    { id: 'steps-journey', kind: 'steps', min: 2, max: 6 },
-    { id: 'steps-ribbon', kind: 'steps', min: 2, max: 4 },
-    { id: 'comparison-panels', kind: 'comparison', min: 2, max: 3 },
-    { id: 'quote-editorial', kind: 'quote', min: 0, max: 0 },
-    { id: 'quote-poster', kind: 'quote', min: 0, max: 0 },
-    { id: 'code-editorial', kind: 'code', min: 0, max: 0 },
-    { id: 'parameter-ledger', kind: 'parameters', min: 1, max: 8 },
-    { id: 'parameter-cards', kind: 'parameters', min: 1, max: 4 },
+    { id: "feature-focus", kind: "features", min: 1, max: 1 },
+    { id: "feature-bento", kind: "features", min: 2, max: 6 },
+    { id: "feature-index", kind: "features", min: 2, max: 6 },
+    { id: "steps-journey", kind: "steps", min: 2, max: 6 },
+    { id: "steps-ribbon", kind: "steps", min: 2, max: 4 },
+    { id: "comparison-panels", kind: "comparison", min: 2, max: 3 },
+    { id: "quote-editorial", kind: "quote", min: 0, max: 0 },
+    { id: "quote-poster", kind: "quote", min: 0, max: 0 },
+    { id: "code-editorial", kind: "code", min: 0, max: 0 },
+    { id: "parameter-ledger", kind: "parameters", min: 1, max: 8 },
+    { id: "parameter-cards", kind: "parameters", min: 1, max: 4 },
 ];
 /** Soft art-direction preferences; capacity and measured quality always remain mandatory. */
 function sceneRecipePreference(scene, recipeId) {
     const preferred = {
-        'banner-hero': ['authored-image-banner'], 'product-showcase': ['authored-image-split'], 'editorial-cover': ['authored-image-editorial'], 'image-campaign': ['authored-image-campaign'],
-        hero: ['cover', 'semantic-hero-split'], chapter: ['section', 'semantic-hero-editorial'], statement: ['statement', 'semantic-hero-stack'], closing: ['closing'],
-        'product-launch': ['authored-feature-bento'], 'feature-spotlight': ['authored-feature-focus'], 'feature-overview': ['authored-feature-bento', 'three-column'], benefits: ['authored-feature-index'],
-        comparison: ['authored-comparison-panels'], 'before-after': ['before-after', 'semantic-comparison-split'], 'plan-options': ['authored-comparison-panels'],
-        process: ['authored-steps-ribbon'], roadmap: ['authored-steps-ribbon', 'roadmap'], tutorial: ['authored-steps-journey'], checklist: ['authored-feature-index', 'checklist'],
-        quotation: ['authored-quote-editorial'], testimonial: ['authored-quote-poster'],
-        'code-example': ['authored-code-editorial'], specifications: ['authored-parameter-ledger'],
-        'pricing-details': ['authored-parameter-cards'], 'event-details': ['authored-parameter-cards'], 'recruitment-details': ['authored-parameter-ledger'],
+        "banner-hero": ["authored-image-banner"],
+        "product-showcase": ["authored-image-split"],
+        "editorial-cover": ["authored-image-editorial"],
+        "image-campaign": ["authored-image-campaign"],
+        hero: ["cover", "semantic-hero-split"],
+        chapter: ["section", "semantic-hero-editorial"],
+        statement: ["statement", "semantic-hero-stack"],
+        closing: ["closing"],
+        "product-launch": ["authored-feature-bento"],
+        "feature-spotlight": ["authored-feature-focus"],
+        "feature-overview": ["authored-feature-bento", "three-column"],
+        benefits: ["authored-feature-index"],
+        comparison: ["authored-comparison-panels"],
+        "before-after": ["before-after", "semantic-comparison-split"],
+        "plan-options": ["authored-comparison-panels"],
+        process: ["authored-steps-ribbon"],
+        roadmap: ["authored-steps-ribbon", "roadmap"],
+        tutorial: ["authored-steps-journey"],
+        checklist: ["authored-feature-index", "checklist"],
+        quotation: ["authored-quote-editorial"],
+        testimonial: ["authored-quote-poster"],
+        "code-example": ["authored-code-editorial"],
+        specifications: ["authored-parameter-ledger"],
+        "pricing-details": ["authored-parameter-cards"],
+        "event-details": ["authored-parameter-cards"],
+        "recruitment-details": ["authored-parameter-ledger"],
     };
-    return scene && preferred[scene]?.some(id => recipeId === id || recipeId.startsWith(`${id}--`)) ? 6 : 0;
+    return scene &&
+        preferred[scene]?.some((id) => recipeId === id || recipeId.startsWith(`${id}--`))
+        ? 6
+        : 0;
 }