@neatico/visual-core 0.14.3 → 0.14.64

package/dist/candidateRanking.d.ts

@@ -0,0 +1,31 @@
+/** Versioned scoring shared by generation, recommendation previews, and exports. */
+export declare const CANDIDATE_RANKING_VERSION: 1;
+export type CandidateState = "pending" | "ready" | "degraded" | "failed";
+export type ParameterSource = "user-fact" | "derived" | "creative" | "simulated";
+export interface ParameterAssessment {
+    field: string;
+    score: number;
+    sourceType: ParameterSource;
+    evidenceRef?: string[];
+    requiresExampleLabel?: boolean;
+}
+export interface CandidateScores {
+    semantic: number;
+    layout: number;
+    fidelity: number;
+}
+export interface RankedCandidate {
+    compositionId: string;
+    slotId: string;
+    state: CandidateState;
+    scores: CandidateScores;
+}
+/** Registry importance is normalized: adding fields never adds points by itself.
+ * Optional omitted fields must be excluded by the caller; missing required fields
+ * fail schema validation before ranking and cannot be repaired with a low score.
+ */
+export declare function weightedParameterScore(assessments: readonly ParameterAssessment[], importance: Readonly<Record<string, number>>): number;
+/** Initial experimental weights; only measured, usable candidates are ranked. */
+export declare function candidateScore(scores: CandidateScores): number;
+/** Stable ties do not depend on arrival order, locale, or batch registration order. */
+export declare function rankCandidates<T extends RankedCandidate>(candidates: readonly T[]): T[];

package/dist/candidateRanking.js

@@ -0,0 +1,55 @@
+/** Versioned scoring shared by generation, recommendation previews, and exports. */
+export const CANDIDATE_RANKING_VERSION = 1;
+const score = (value) => {
+    if (!Number.isFinite(value) || value < 0 || value > 100)
+        throw new Error("CANDIDATE_INVALID_SCORE");
+    return value;
+};
+/** Registry importance is normalized: adding fields never adds points by itself.
+ * Optional omitted fields must be excluded by the caller; missing required fields
+ * fail schema validation before ranking and cannot be repaired with a low score.
+ */
+export function weightedParameterScore(assessments, importance) {
+    let weighted = 0, total = 0;
+    const seen = new Set();
+    for (const assessment of assessments) {
+        const weight = Object.prototype.hasOwnProperty.call(importance, assessment.field)
+            ? importance[assessment.field]
+            : undefined;
+        if (seen.has(assessment.field) ||
+            weight === undefined ||
+            !Number.isFinite(weight) ||
+            weight <= 0)
+            throw new Error("CANDIDATE_INVALID_ASSESSMENT");
+        seen.add(assessment.field);
+        weighted += score(assessment.score) * weight;
+        total += weight;
+    }
+    if (!total)
+        throw new Error("CANDIDATE_MISSING_ASSESSMENT");
+    return weighted / total;
+}
+/** Initial experimental weights; only measured, usable candidates are ranked. */
+export function candidateScore(scores) {
+    return (Math.round((0.5 * score(scores.semantic) +
+        0.3 * score(scores.layout) +
+        0.2 * score(scores.fidelity)) *
+        1000) / 1000);
+}
+/** Stable ties do not depend on arrival order, locale, or batch registration order. */
+export function rankCandidates(candidates) {
+    const identities = new Set();
+    for (const candidate of candidates) {
+        const key = JSON.stringify([candidate.slotId, candidate.compositionId]);
+        if (!candidate.slotId || !candidate.compositionId || identities.has(key))
+            throw new Error("CANDIDATE_DUPLICATE_ID");
+        identities.add(key);
+    }
+    const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+    return candidates
+        .filter((candidate) => candidate.state === "ready" || candidate.state === "degraded")
+        .slice()
+        .sort((a, b) => candidateScore(b.scores) - candidateScore(a.scores) ||
+        compare(a.slotId, b.slotId) ||
+        compare(a.compositionId, b.compositionId));
+}

package/dist/cjs/candidateRanking.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CANDIDATE_RANKING_VERSION = void 0;
+exports.weightedParameterScore = weightedParameterScore;
+exports.candidateScore = candidateScore;
+exports.rankCandidates = rankCandidates;
+/** Versioned scoring shared by generation, recommendation previews, and exports. */
+exports.CANDIDATE_RANKING_VERSION = 1;
+const score = (value) => {
+    if (!Number.isFinite(value) || value < 0 || value > 100)
+        throw new Error("CANDIDATE_INVALID_SCORE");
+    return value;
+};
+/** Registry importance is normalized: adding fields never adds points by itself.
+ * Optional omitted fields must be excluded by the caller; missing required fields
+ * fail schema validation before ranking and cannot be repaired with a low score.
+ */
+function weightedParameterScore(assessments, importance) {
+    let weighted = 0, total = 0;
+    const seen = new Set();
+    for (const assessment of assessments) {
+        const weight = Object.prototype.hasOwnProperty.call(importance, assessment.field)
+            ? importance[assessment.field]
+            : undefined;
+        if (seen.has(assessment.field) ||
+            weight === undefined ||
+            !Number.isFinite(weight) ||
+            weight <= 0)
+            throw new Error("CANDIDATE_INVALID_ASSESSMENT");
+        seen.add(assessment.field);
+        weighted += score(assessment.score) * weight;
+        total += weight;
+    }
+    if (!total)
+        throw new Error("CANDIDATE_MISSING_ASSESSMENT");
+    return weighted / total;
+}
+/** Initial experimental weights; only measured, usable candidates are ranked. */
+function candidateScore(scores) {
+    return (Math.round((0.5 * score(scores.semantic) +
+        0.3 * score(scores.layout) +
+        0.2 * score(scores.fidelity)) *
+        1000) / 1000);
+}
+/** Stable ties do not depend on arrival order, locale, or batch registration order. */
+function rankCandidates(candidates) {
+    const identities = new Set();
+    for (const candidate of candidates) {
+        const key = JSON.stringify([candidate.slotId, candidate.compositionId]);
+        if (!candidate.slotId || !candidate.compositionId || identities.has(key))
+            throw new Error("CANDIDATE_DUPLICATE_ID");
+        identities.add(key);
+    }
+    const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+    return candidates
+        .filter((candidate) => candidate.state === "ready" || candidate.state === "degraded")
+        .slice()
+        .sort((a, b) => candidateScore(b.scores) - candidateScore(a.scores) ||
+        compare(a.slotId, b.slotId) ||
+        compare(a.compositionId, b.compositionId));
+}

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/compositionNumbers.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOCIAL_DISPLAY_NUMBERS = exports.SEMANTIC_DISPLAY_NUMBERS = void 0;
+/** Stable public display numbers, independent of runtime registration order. */
+exports.SEMANTIC_DISPLAY_NUMBERS = {
+    "semantic:presentation:bookend-cover-editorial": "M001",
+    "semantic:presentation:bookend-cover-panel": "M002",
+    "semantic:presentation:bookend-cover-split": "M003",
+    "semantic:presentation:bookend-closing-editorial": "M004",
+    "semantic:presentation:bookend-closing-panel": "M005",
+    "semantic:presentation:bookend-closing-split": "M006",
+    "semantic:presentation:brand-collection-grid": "M007",
+    "semantic:social:time-notice": "M099",
+    "semantic:social:ticket": "M100",
+    "semantic:social:webinar": "M101",
+    "semantic:social:pricing": "M102",
+    "semantic:social:offer": "M103",
+    "semantic:social:hiring": "M104",
+    "semantic:social:community": "M105",
+    "semantic:social:menu": "M106",
+    "semantic:social:itinerary": "M107",
+    "semantic:social:schedule": "M108",
+    "semantic:presentation:authored-plan-cards": "M109",
+    "semantic:presentation:authored-image-banner": "M009",
+    "semantic:presentation:authored-image-split": "M010",
+    "semantic:presentation:authored-image-editorial": "M011",
+    "semantic:presentation:authored-image-campaign": "M012",
+    "semantic:presentation:authored-image-inset": "M013",
+    "semantic:presentation:authored-prose-inset": "M014",
+    "semantic:presentation:authored-feature-focus": "M015",
+    "semantic:presentation:authored-feature-bento": "M016",
+    "semantic:presentation:authored-feature-index": "M017",
+    "semantic:presentation:authored-steps-journey": "M018",
+    "semantic:presentation:authored-steps-ribbon": "M019",
+    "semantic:presentation:authored-comparison-panels": "M020",
+    "semantic:presentation:authored-quote-editorial": "M021",
+    "semantic:presentation:authored-quote-poster": "M022",
+    "semantic:presentation:authored-code-editorial": "M023",
+    "semantic:presentation:authored-parameter-ledger": "M024",
+    "semantic:presentation:authored-parameter-cards": "M025",
+    "semantic:presentation:semantic-code-split": "M026",
+    "semantic:presentation:semantic-parameters-split": "M029",
+    "semantic:presentation:semantic-parameters-stack": "M030",
+    "semantic:presentation:semantic-steps-split": "M032",
+    "semantic:presentation:semantic-steps-stack": "M033",
+    "semantic:presentation:semantic-steps-editorial": "M034",
+    "semantic:presentation:semantic-comparison-split": "M035",
+    "semantic:presentation:semantic-features-split": "M038",
+    "semantic:presentation:semantic-features-stack": "M039",
+    "semantic:presentation:semantic-features-editorial": "M040",
+    "semantic:presentation:semantic-quote-split": "M041",
+    "semantic:presentation:semantic-chart-split": "M044",
+    "semantic:presentation:semantic-chart-stack": "M045",
+    "semantic:presentation:semantic-prose-split": "M050",
+    "semantic:presentation:semantic-prose-stack": "M051",
+    "semantic:presentation:semantic-prose-editorial": "M052",
+    "semantic:presentation:semantic-mixed-stack": "M053",
+    "semantic:social:semantic-hero-editorial": "M094"
+};
+/** Social numbers follow the established formal gallery, not registration order. */
+exports.SOCIAL_DISPLAY_NUMBERS = {
+    "note-question": "S001",
+    "note-marker": "S002",
+    "note-editorial": "S003",
+    "note-checklist": "S004",
+    "note-photo": "S005",
+    "note-news": "S006",
+    "chat-messenger": "S007",
+    "chat-imessage": "S008",
+    "chat-telegram": "S009",
+    "chat-workplace": "S010",
+    "time-notice": "S011",
+    "news-focus": "S012",
+    "usage-breakdown": "S013",
+    "organization": "S014",
+    "editorial-quote": "S015",
+    "research-highlight": "S016",
+    "product-showcase": "S017",
+    "manifesto": "S018",
+    "launch": "S019",
+    "bento": "S020",
+    "spotlight": "S021",
+    "ticket": "S022",
+    "webinar": "S023",
+    "quote": "S024",
+    "testimonial": "S025",
+    "metric": "S026",
+    "report": "S027",
+    "checklist": "S028",
+    "steps": "S029",
+    "comparison": "S030",
+    "myth": "S031",
+    "pricing": "S032",
+    "offer": "S033",
+    "editorial": "S034",
+    "story": "S035",
+    "hiring": "S036",
+    "team": "S037",
+    "course": "S038",
+    "case-study": "S039",
+    "notice": "S040",
+    "community": "S041",
+    "menu": "S042",
+    "specification": "S043",
+    "itinerary": "S044",
+    "schedule": "S045",
+    "safety": "S046",
+    "faq": "S047",
+    "split-bar-compare": "S048",
+    "benchmark-bars": "S049"
+};

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