@neatico/visual-core 0.14.26 → 0.14.65

package/dist/cjs/designSystem.js

@@ -6,17 +6,91 @@ exports.canonicalRecipeId = canonicalRecipeId;
 exports.pageEntryCount = pageEntryCount;
 exports.designCandidates = designCandidates;
 exports.structureFingerprint = structureFingerprint;
+const exploreCollection_js_1 = require("./exploreCollection.js");
 const compositionScenes_js_1 = require("./compositionScenes.js");
 const socialLayouts_js_1 = require("./socialLayouts.js");
 const content_js_1 = require("./content.js");
 /** Complete, deterministic token sets; decorative geometry belongs to individual compositions. */
 exports.DESIGN_THEMES = [
+    ...exploreCollection_js_1.EXPLORE_THEMES,
     {
         id: "neatico",
         palette: { background: "#FAF9F6", surface: "#FFFFFF", ink: "#202124", muted: "#62646B", accent: "#F4CE36", line: "#E4E1D9" },
-        typography: { heading: "Inter", body: "Inter", code: "monospace", headingWeight: 700 },
+        typography: { heading: "Manrope", body: "Inter", code: "monospace", headingWeight: 700 },
         geometry: { radius: 12, spacing: 1, rule: "accent" },
     },
+    {
+        id: "archive",
+        palette: { background: "#F6F1E7", surface: "#FFFCF5", ink: "#19382E", muted: "#59665B", accent: "#C17A35", line: "#D7CEBC" },
+        typography: { heading: "Instrument Serif", body: "DM Sans", code: "JetBrains Mono", headingWeight: 400 },
+        geometry: { radius: 4, spacing: 1.1, rule: "hairline" },
+    },
+    {
+        "id": "bloom",
+        "palette": {
+            "background": "#FFF1F6",
+            "surface": "#FFFFFF",
+            "ink": "#341838",
+            "muted": "#70536D",
+            "accent": "#CC1D61",
+            "line": "#F3BED5"
+        },
+        "typography": {
+            "heading": "Montserrat",
+            "body": "Nunito Sans",
+            "code": "JetBrains Mono",
+            "headingWeight": 800
+        },
+        "geometry": {
+            "radius": 20,
+            "spacing": 1,
+            "rule": "accent"
+        }
+    },
+    {
+        "id": "splash",
+        "palette": {
+            "background": "#E9FAFF",
+            "surface": "#FFFFFF",
+            "ink": "#162E60",
+            "muted": "#4D637E",
+            "accent": "#2454E6",
+            "line": "#B8DEFA"
+        },
+        "typography": {
+            "heading": "Space Grotesk",
+            "body": "DM Sans",
+            "code": "JetBrains Mono",
+            "headingWeight": 700
+        },
+        "geometry": {
+            "radius": 20,
+            "spacing": 1,
+            "rule": "accent"
+        }
+    },
+    {
+        "id": "candy",
+        "palette": {
+            "background": "#F3EDFF",
+            "surface": "#FFFFFF",
+            "ink": "#35205C",
+            "muted": "#69557F",
+            "accent": "#7841D5",
+            "line": "#DCCAF6"
+        },
+        "typography": {
+            "heading": "Manrope",
+            "body": "Nunito Sans",
+            "code": "JetBrains Mono",
+            "headingWeight": 800
+        },
+        "geometry": {
+            "radius": 20,
+            "spacing": 1,
+            "rule": "accent"
+        }
+    },
     {
         id: "studio",
         palette: {
@@ -28,8 +102,8 @@ exports.DESIGN_THEMES = [
             line: "#D7DED3",
         },
         typography: {
-            heading: "Inter",
-            body: "Inter",
+            heading: "DM Sans",
+            body: "Source Sans 3",
             code: "monospace",
             headingWeight: 700,
         },
@@ -46,7 +120,7 @@ exports.DESIGN_THEMES = [
             line: "#3D526C",
         },
         typography: {
-            heading: "Inter",
+            heading: "Space Grotesk",
             body: "Inter",
             code: "monospace",
             headingWeight: 700,
@@ -65,7 +139,7 @@ exports.DESIGN_THEMES = [
         },
         typography: {
             heading: "Lora",
-            body: "Inter",
+            body: "Source Sans 3",
             code: "monospace",
             headingWeight: 700,
         },
@@ -82,8 +156,8 @@ exports.DESIGN_THEMES = [
             line: "#DAD5F2",
         },
         typography: {
-            heading: "Inter",
-            body: "Inter",
+            heading: "Space Grotesk",
+            body: "DM Sans",
             code: "monospace",
             headingWeight: 800,
         },
@@ -100,7 +174,7 @@ exports.DESIGN_THEMES = [
             line: "#B8A233",
         },
         typography: {
-            heading: "Inter",
+            heading: "Oswald",
             body: "Inter",
             code: "monospace",
             headingWeight: 800,
@@ -116,7 +190,7 @@ function designTheme(id) {
         plum: "electric",
     };
     return (exports.DESIGN_THEMES.find((theme) => theme.id === (alias[id] || id)) ||
-        exports.DESIGN_THEMES[0]);
+        exports.DESIGN_THEMES.find(theme => theme.id === "neatico"));
 }
 const family = (id, semantic) => {
     if (/code|terminal/.test(id))
@@ -298,6 +372,7 @@ function canonicalRecipeId(id, kind) {
 }
 /** Existing authored catalogs remain first-class candidates, rather than being discarded. */
 const ALL_DESIGN_RECIPES = [
+    ...exploreCollection_js_1.EXPLORE_RECIPES,
     ...["cover", "closing"].flatMap((role) => ["editorial", "panel", "split"].map((style) => ({
         id: `bookend-${role}-${style}`,
         kind: "presentation",
@@ -436,6 +511,7 @@ function designCandidates(page, context) {
     const available = page.blocks.some((b) => b.kind === "image" && b.status === "available");
     const exclude = new Set(context.excluded || []);
     const candidates = exports.DESIGN_RECIPES.filter((r) => r.kind === context.kind &&
+        (!r.id.startsWith("authored-explore-") || (context.ratio >= 1.4 && context.ratio <= 2 && (0, exploreCollection_js_1.exploreCompositionFits)(page, r.id))) &&
         r.automatic !== false &&
         (!r.scenes || Boolean(page.scene && r.scenes.includes(page.scene))) &&
         !(r.family.startsWith("hero") &&
@@ -463,6 +539,7 @@ function designCandidates(page, context) {
                 ? r.family.startsWith("steps") || r.family.startsWith("code")
                 : true;
         return ((r.id.startsWith("bookend-") ? 80 : 0) +
+            (r.id.startsWith("authored-explore-") ? 110 : 0) +
             (page.scene === "brand-collection" && r.id === "brand-collection-grid"
                 ? 80
                 : 0) +

package/dist/cjs/exploreCollection.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPLORE_RECIPES = exports.EXPLORE_LAYOUTS = exports.EXPLORE_THEMES = exports.DEFAULT_PRESENTATION_THEME = void 0;
+exports.exploreCompositionFits = exploreCompositionFits;
+exports.DEFAULT_PRESENTATION_THEME = "explore-teal";
+/** The proven Explore editorial colorways, plus eight complementary directions. */
+const colors = [
+    ["teal", "#214B4A", "#E1EEEB", "#F7FAF9", "#1C3533"],
+    ["slate", "#3F5477", "#E6EAF1", "#F9FAFC", "#1D283B"],
+    ["cobalt", "#2847A9", "#E5EBFC", "#F8FAFF", "#19294E"],
+    ["clay", "#9D4F32", "#F8E7DE", "#FFFAF6", "#3F2920"],
+    ["terracotta", "#AC3F25", "#FBE5DC", "#FFFAF5", "#3E241B"],
+    ["lavender", "#6A497B", "#EEE6F5", "#FCFAFD", "#34243D"],
+    ["petrol", "#315664", "#E2EDF1", "#F8FBFC", "#223E48"],
+    ["sand", "#6D5140", "#EFE4D8", "#FCFAF7", "#392C23"],
+    ["indigo", "#43387D", "#EAE5F6", "#FAF9FD", "#292444"],
+    ["olive", "#4F633A", "#E8EEDC", "#FBFCF8", "#2D3824"],
+    ["rose", "#9B3E61", "#F6E2EB", "#FFFAFC", "#402332"],
+    ["wine", "#7A3048", "#EFDEE5", "#FCF8FA", "#39202C"],
+    ["sunflower", "#8A5D12", "#F7EBC6", "#FFFDF5", "#392F1D"],
+    ["seafoam", "#216C62", "#DDF0E8", "#F7FCFA", "#193D36"],
+    ["graphite", "#D5B98C", "#30343A", "#1B1E23", "#F5F2EA"],
+    ["midnight", "#91B7DE", "#22344C", "#132236", "#F3F6FA"],
+    ["ice", "#27697B", "#DDEFF5", "#F8FCFE", "#193C49"],
+    ["copper", "#9A563B", "#F1E2D7", "#FCF9F5", "#3F2C23"],
+];
+exports.EXPLORE_THEMES = colors.map(([id, accent, surface, background, ink]) => ({
+    id: `explore-${id}`,
+    palette: { accent, surface, background, ink, muted: ink, line: surface },
+    typography: {
+        heading: "Playfair Display",
+        body: "Inter",
+        code: "JetBrains Mono",
+        headingWeight: 600,
+    },
+    geometry: { radius: 4, spacing: 1.1, rule: "hairline" },
+}));
+exports.EXPLORE_LAYOUTS = [
+    [
+        "cover",
+        "paragraph",
+        0,
+        0,
+        "Open with a spacious editorial headline, a short premise and an optional real photograph.",
+    ],
+    [
+        "overview",
+        "features",
+        2,
+        4,
+        "Orient readers with a numbered overview of parallel subjects.",
+    ],
+    [
+        "section",
+        "paragraph",
+        0,
+        0,
+        "Introduce one new section or central principle in a strong color field.",
+    ],
+    [
+        "pillars",
+        "features",
+        2,
+        3,
+        "Explain two or three equally important ideas in spacious editorial columns.",
+    ],
+    [
+        "focus",
+        "paragraph",
+        0,
+        0,
+        "Develop one idea in an asymmetric reading composition.",
+    ],
+    [
+        "workflow",
+        "steps",
+        2,
+        4,
+        "Show an ordered workflow with explicit actions and useful descriptions.",
+    ],
+    [
+        "timeline",
+        "steps",
+        2,
+        4,
+        "Present a short chronological sequence on a horizontal reading axis.",
+    ],
+    [
+        "comparison",
+        "comparison",
+        2,
+        2,
+        "Compare two supplied alternatives with corresponding points.",
+    ],
+    [
+        "worksheet",
+        "parameters",
+        2,
+        4,
+        "Explain named fields with their concrete values and instructions.",
+    ],
+    [
+        "photo-story",
+        "image",
+        0,
+        0,
+        "Use a real contextual photograph beside a concise explanation.",
+    ],
+    [
+        "quote",
+        "quote",
+        0,
+        0,
+        "Give an exact source statement room to breathe, retaining supplied attribution.",
+    ],
+    [
+        "chart",
+        "chart",
+        2,
+        6,
+        "Compare source-backed quantities in labeled bars with the original unit.",
+    ],
+    [
+        "ledger",
+        "parameters",
+        2,
+        5,
+        "Arrange named facts and explanations in a flat editorial ledger.",
+    ],
+    [
+        "faq",
+        "features",
+        2,
+        3,
+        "Answer a small set of meaningful questions with concise responses.",
+    ],
+    [
+        "action-plan",
+        "steps",
+        2,
+        3,
+        "Make the next few actions prominent, with descriptions that explain the work.",
+    ],
+    [
+        "closing",
+        "paragraph",
+        0,
+        0,
+        "Close with one clear takeaway and a concrete next action.",
+    ],
+];
+exports.EXPLORE_RECIPES = exports.EXPLORE_LAYOUTS.map(([id, kind, min, max]) => ({
+    id: `authored-explore-${id}`,
+    kind: "presentation",
+    renderer: "semantic",
+    automatic: true,
+    family: kind === "paragraph" ? `hero-explore-${id}` : kind,
+    minEntries: min,
+    maxEntries: max,
+    accepts: (["cover", "photo-story"].includes(id)
+        ? ["paragraph", "image"]
+        : [kind]),
+    requiresImage: id === "photo-story",
+}));
+function exploreCompositionFits(page, id) {
+    if (!id.startsWith("authored-explore-"))
+        return true;
+    const variant = id.slice("authored-explore-".length);
+    if (variant === "cover")
+        return page.purpose === "cover";
+    if (variant === "closing")
+        return page.purpose === "conclude";
+    if (["cover", "conclude"].includes(page.purpose))
+        return false;
+    if (variant === "section")
+        return (page.blocks.length === 1 &&
+            page.blocks[0].kind === "paragraph" &&
+            page.blocks[0].text.length <= 160);
+    return true;
+}

package/dist/cjs/fontCatalog.js

@@ -28,6 +28,7 @@ exports.GOOGLE_FONT_CATALOG = [
         "Playfair Display",
         "PT Serif",
     ].map((f) => entry(f, "serif")),
+    entry("Instrument Serif", "serif", ["latin"], [400]),
     ...["Space Grotesk", "Oswald", "Bebas Neue"].map((f) => entry(f, "display", ["latin"], f === "Bebas Neue" ? [400] : [400, 700])),
     ...["JetBrains Mono", "IBM Plex Mono", "Fira Code", "Source Code Pro"].map((f) => entry(f, "mono")),
     entry("Noto Sans SC", "sans", ["zh"]),
@@ -43,6 +44,9 @@ exports.GOOGLE_FONT_CATALOG = [
     entry("Noto Serif KR", "serif", ["ko"]),
     entry("Noto Sans Arabic", "sans", ["ar"]),
     entry("Noto Sans Devanagari", "sans", ["hi"]),
+    entry("Noto Serif Devanagari", "serif", ["hi"]),
+    entry("Noto Sans Thai", "sans", ["th"]),
+    entry("Noto Serif Thai", "serif", ["th"]),
 ];
 function contentScript(text, locale = "en") {
     if (/[\u3040-\u30ff]/u.test(text))
@@ -53,6 +57,8 @@ function contentScript(text, locale = "en") {
         return "ar";
     if (/[\u0900-\u097f]/u.test(text))
         return "hi";
+    if (/[\u0e00-\u0e7f]/u.test(text))
+        return "th";
     if (/[\u3400-\u9fff]/u.test(text))
         return /^ja/i.test(locale)
             ? "ja"
@@ -63,7 +69,7 @@ function contentScript(text, locale = "en") {
                     : "zh";
     if (/^zh/i.test(locale))
         return /TW|HK|Hant/i.test(locale) ? "zh-Hant" : "zh";
-    return /^(ja|ko|ar|hi)/.exec(locale)?.[1] || "latin";
+    return /^(ja|ko|ar|hi|th)/.exec(locale)?.[1] || "latin";
 }
 function recommendedFonts(locale, text = "") {
     const script = contentScript(text, locale);

package/dist/cjs/formalCompositions.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMAL_COMPOSITIONS = exports.FORMAL_REFERENCE_COMPOSITIONS = void 0;
+exports.applicableCompositions = applicableCompositions;
+const exploreCollection_js_1 = require("./exploreCollection.js");
+const compositionUseCases_js_1 = require("./compositionUseCases.js");
+const nativeSocialParameters_js_1 = require("./nativeSocialParameters.js");
+const designSystem_js_1 = require("./designSystem.js");
+const socialLayouts_js_1 = require("./socialLayouts.js");
+const recipeParameters_js_1 = require("./recipeParameters.js");
+const compositionNumbers_js_1 = require("./compositionNumbers.js");
+const both = ['presentation', 'social'];
+const semantic = (id, accepts, minEntries = 0, maxEntries = 12, requiresImage = false) => ({ id, renderer: 'semantic', kind: 'social', family: id, accepts, minEntries, maxEntries, requiresImage });
+function define(recipe, kinds, id, displayNumber, min = .25, max = 4) {
+    return { ...(0, recipeParameters_js_1.recipeParameterContract)(recipe, kinds), semanticDescription: exploreCollection_js_1.EXPLORE_LAYOUTS.find(item => recipe.id === `authored-explore-${item[0]}`)?.[4] || (0, compositionUseCases_js_1.compositionUseCase)(recipe.id), id, displayNumber, aspectRatios: { min, max }, recipe };
+}
+/** Structural reference contracts shared with the product's existing renderers.
+ * Colorways and historical aliases remain outside active discovery.
+ */
+exports.FORMAL_REFERENCE_COMPOSITIONS = [
+    { id: 'authored-reference-photo', reference: 1, layout: 'authored-photo-editorial', accepts: ['image', 'paragraph'] },
+    { id: 'authored-reference-manifesto', reference: 2, layout: 'authored-type-manifesto', accepts: ['paragraph'] },
+    { id: 'authored-reference-journey', reference: 3, layout: 'authored-editorial-flow', accepts: ['steps'] },
+    { id: 'authored-reference-vision', reference: 4, layout: 'authored-editorial-features', accepts: ['features'] },
+    { id: 'authored-reference-matrix', reference: 5, layout: 'authored-editorial-matrix', accepts: ['comparison', 'paragraph'] },
+    { id: 'authored-reference-diagonal', reference: 6, layout: 'authored-diagonal-cover', accepts: ['paragraph'] },
+    { id: 'authored-reference-list', reference: 8, layout: 'authored-editorial-index', accepts: ['features'] },
+    { id: 'authored-reference-story', reference: 11, layout: 'authored-visual-poster', accepts: ['image', 'paragraph', 'features'] },
+    { id: 'authored-reference-sustainable', reference: 13, layout: 'authored-editorial-metrics', accepts: ['parameters'] },
+    { id: 'authored-reference-code', reference: 14, layout: 'authored-code-panel', accepts: ['code'] },
+    { id: 'authored-reference-bars', reference: 18, layout: 'authored-editorial-bars', accepts: ['chart'] },
+    { id: 'authored-reference-share', reference: 19, layout: 'authored-editorial-donut', accepts: ['chart'] },
+    { id: 'authored-reference-opinion', reference: 20, layout: 'authored-editorial-quote', accepts: ['quote'] },
+    { id: 'authored-reference-comparison', reference: 22, layout: 'authored-editorial-comparison', accepts: ['comparison'] },
+    { id: 'authored-reference-faq', reference: 23, layout: 'authored-editorial-faq', accepts: ['features'] },
+    { id: 'authored-reference-trend', reference: 25, layout: 'authored-editorial-trend', accepts: ['chart'] },
+];
+const semanticRecipes = designSystem_js_1.DESIGN_RECIPES.filter(recipe => recipe.renderer === 'semantic');
+const uniqueSemantic = semanticRecipes.filter((recipe, index) => semanticRecipes.findIndex(other => other.id === recipe.id) === index);
+const campaignDefinitions = [
+    ['ledger-chart', ['parameters', 'chart'], 2, 6, false, true],
+    ['detail-sidebar', ['paragraph', 'parameters'], 1, 3, false, true],
+    ['technical-log', ['code', 'paragraph'], 0, 12, false, false],
+    ['architecture-stack', ['steps', 'paragraph'], 2, 4, false, false],
+    ['speaker-spotlight', ['quote', 'parameters'], 1, 6, true, false],
+    ['speaker-lineup', ['quote', 'parameters'], 1, 6, true, false],
+];
+const founderDefinitions = [
+    ['authored-mechanism-flow', ['features', 'steps', 'paragraph'], 2, 4],
+    ['authored-reference-capability-map', ['features', 'paragraph'], 2, 4],
+    ['authored-founder-timeline', ['steps', 'paragraph'], 2, 4],
+    ['authored-founder-comparison', ['comparison', 'paragraph'], 2, 2],
+];
+const articleKinds = ['features', 'process', 'comparison', 'summary', 'checklist', 'faq', 'chart'];
+const articleAccepts = { features: ['features', 'paragraph'], process: ['steps', 'paragraph'], comparison: ['comparison', 'paragraph'], summary: ['paragraph', 'features'], checklist: ['features', 'paragraph'], faq: ['features', 'paragraph'], chart: ['chart', 'paragraph'] };
+function article(id, kind, variant) {
+    const cover = kind === 'cover';
+    const recipe = semantic(id, cover ? ['paragraph', 'features', 'image'] : articleAccepts[kind], 0, kind === 'chart' ? 12 : 3);
+    const number = cover ? variant + 1 : kind === 'features' && variant >= 3 ? 22 + variant : kind === 'process' && variant === 3 ? 33 : 4 + articleKinds.indexOf(kind) * 3 + variant;
+    const definition = define(recipe, [cover ? 'article-cover' : 'article-illustration'], id, `A${String(number).padStart(3, '0')}`, .5, 2.4);
+    // A cover is a headline, a short deck and its authored hero. It is not a
+    // miniature article: the original source remains in the candidate pool.
+    const coverSchema = { type: 'object', additionalProperties: false, required: ['title', 'blocks'], properties: {
+            title: { type: 'string', minLength: 1, maxLength: 72, description: 'A concise editorial headline, preferably four to eight words.' },
+            blocks: { type: 'array', minItems: 1, maxItems: 1, items: { type: 'object', additionalProperties: false, required: ['id', 'kind', 'text', 'evidence'], properties: {
+                        id: { type: 'string', minLength: 1, maxLength: 80 }, kind: { const: 'paragraph' }, text: { type: 'string', minLength: 1, maxLength: 140, description: 'One concise supporting sentence. Summarize the topic; do not repeat the full article or enumerate every feature.' },
+                        evidence: { type: 'array', minItems: 1, maxItems: 32, items: { type: 'object', additionalProperties: false, required: ['sourceId'], properties: { sourceId: { type: 'string', maxLength: 160 }, quote: { type: 'string', maxLength: 2000 } } } },
+                    } } },
+        } };
+    // The optional hero preserves compatibility with saved paragraph-only pools.
+    // New requests can reference a real asset; missing assets retain native artwork.
+    const coverWithHero = { ...coverSchema, properties: { ...coverSchema.properties, blocks: { ...coverSchema.properties.blocks, maxItems: 2,
+                description: 'One supporting paragraph and, when imagery helps explain the topic, one image hero. Use an available asset ID or a missing image request; never invent a photo URL.',
+                items: [coverSchema.properties.blocks.items, { type: 'object', additionalProperties: false, required: ['id', 'kind', 'sourceId', 'alt', 'treatment', 'status', 'evidence'], properties: {
+                            id: { type: 'string', minLength: 1, maxLength: 80 }, kind: { const: 'image' }, sourceId: { type: 'string', maxLength: 160 },
+                            alt: { type: 'string', minLength: 1, maxLength: 300, description: 'A concise description of the image subject, grounded in the article topic.' },
+                            treatment: { enum: ['photograph', 'diagram', 'screenshot'] }, status: { enum: ['available', 'missing'] }, assetId: { type: 'string', maxLength: 200 },
+                            evidence: coverSchema.properties.blocks.items.properties.evidence,
+                        } }],
+            } } };
+    const illustrationSchema = JSON.parse(JSON.stringify(definition.parameterSchema));
+    if (!cover) {
+        const primaryKind = kind === 'summary' ? 'features' : articleAccepts[kind][0];
+        const blocks = illustrationSchema.properties.blocks;
+        const primary = blocks.items.find((block) => block.properties.kind.const === primaryKind);
+        blocks.items = [primary];
+        blocks.minItems = 1;
+        blocks.maxItems = 1;
+        if (kind === 'faq')
+            primary.properties.entries.items.properties.title.pattern = '^.+[?？]$';
+    }
+    const coverDirections = ['An editorial document sculpture with layered planes and a strong headline.', 'A connected constellation with a single focal object and an editorial headline.', 'An architectural archive silhouette balanced against expressive editorial typography.'];
+    return { ...definition, ...(cover ? { parameterSchema: coverWithHero, capacity: { minEntries: 0, maxEntries: 0, requiresImage: false }, semanticDescription: coverDirections[variant] } : { parameterSchema: illustrationSchema }), recipe: undefined, rendererKey: `article-${kind}:${variant}`,
+        semanticDescription: (0, compositionUseCases_js_1.compositionUseCase)(id) + (cover ? ' ' + coverDirections[variant] : '') };
+}
+/** Matches /dev/compositions/all: 161 default previews plus two landscape-only
+ * reference entries. Output capabilities overlap and must never be summed.
+ */
+exports.FORMAL_COMPOSITIONS = [
+    ...campaignDefinitions.map(([id, accepts, min, max, image, landscape], index) => define(semantic(`authored-reference-${id}`, accepts, min, max, image), landscape ? ['presentation'] : both, `new-reference:${id}`, `N${index + 1}`, landscape ? 1.4 : .25)),
+    define(semantic('authored-event-poster', ['parameters', 'paragraph'], 1, 6), ['social'], 'event:provider', 'E1'),
+    define(semantic('authored-image-triptych', ['paragraph', 'features', 'image'], 3, 3, true), ['social'], 'campaign:triptych', 'C1', .5, 2),
+    ...exports.FORMAL_REFERENCE_COMPOSITIONS.map(spec => define(semantic(spec.id, spec.accepts, 0, 12, spec.accepts.includes('image')), both, `reference:${spec.id}`, `R${String(spec.reference).padStart(2, '0')}`)),
+    ...socialLayouts_js_1.SOCIAL_LAYOUT_CATALOG.map(preset => {
+        const recipe = designSystem_js_1.DESIGN_RECIPES.find(item => item.id === preset.id && item.kind === 'social');
+        return { ...define({ ...recipe, renderer: 'catalog' }, ['social'], `social:${preset.id}`, compositionNumbers_js_1.SOCIAL_DISPLAY_NUMBERS[preset.id], .5, 2.4), ...(0, nativeSocialParameters_js_1.nativeSocialParameterContract)(preset.id) };
+    }),
+    ...uniqueSemantic.map(recipe => define(recipe, semanticRecipes.filter(other => other.id === recipe.id).map(other => other.kind), `semantic:${recipe.kind}:${recipe.id}`, recipe.id.startsWith("authored-explore-") ? `X${String(exploreCollection_js_1.EXPLORE_LAYOUTS.findIndex(item => recipe.id === `authored-explore-${item[0]}`) + 1).padStart(2, "0")}` : compositionNumbers_js_1.SEMANTIC_DISPLAY_NUMBERS[`semantic:${recipe.kind}:${recipe.id}`], recipe.id.startsWith("authored-explore-") ? 1.4 : .25, recipe.id.startsWith("authored-explore-") ? 2 : 4)),
+    ...founderDefinitions.map(([id, accepts, min, max], index) => define(semantic(id, accepts, min, max), ['social'], `semantic:social:${id}`, `F${index + 1}`, 1.3)),
+    ...[0, 1, 2].flatMap(variant => [article(`article-cover-${variant}`, 'cover', variant), ...articleKinds.map(kind => article(`article-${kind}-${variant}`, kind, variant))]),
+    ...[3, 4, 5, 6, 7, 8, 9, 10].map(variant => article(`article-features-${variant}`, 'features', variant)),
+    article('article-process-3', 'process', 3),
+];
+/** Only output, ratio, and explicit IDs are hard gates; semantic fit is scored. */
+function applicableCompositions(kind, ratio, id) {
+    if (!Number.isFinite(ratio) || ratio <= 0)
+        throw new Error('COMPOSITION_INVALID_RATIO');
+    if (id && !exports.FORMAL_COMPOSITIONS.some(item => item.id === id))
+        throw new Error('COMPOSITION_UNKNOWN_ID');
+    return exports.FORMAL_COMPOSITIONS.filter(item => item.supportedKinds.includes(kind) && ratio >= item.aspectRatios.min && ratio <= item.aspectRatios.max && (!id || item.id === id));
+}

package/dist/cjs/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOCIAL_DISPLAY_NUMBERS = exports.compositionParameterDefaults = void 0;
 __exportStar(require("./geometry.js"), exports);
 __exportStar(require("./text.js"), exports);
 __exportStar(require("./scenes.js"), exports);
@@ -29,3 +30,16 @@ __exportStar(require("./designBlueprint.js"), exports);
 __exportStar(require("./compositionScenes.js"), exports);
 __exportStar(require("./editorial.js"), exports);
 __exportStar(require("./fontCatalog.js"), exports);
+__exportStar(require("./candidateRanking.js"), exports);
+__exportStar(require("./styleManifest.js"), exports);
+__exportStar(require("./recipeParameters.js"), exports);
+__exportStar(require("./formalCompositions.js"), exports);
+__exportStar(require("./contentBrief.js"), exports);
+__exportStar(require("./nativeSocialParameters.js"), exports);
+__exportStar(require("./compositionUseCases.js"), exports);
+var parameterDefaults_js_1 = require("./parameterDefaults.js");
+Object.defineProperty(exports, "compositionParameterDefaults", { enumerable: true, get: function () { return parameterDefaults_js_1.compositionParameterDefaults; } });
+var compositionNumbers_js_1 = require("./compositionNumbers.js");
+Object.defineProperty(exports, "SOCIAL_DISPLAY_NUMBERS", { enumerable: true, get: function () { return compositionNumbers_js_1.SOCIAL_DISPLAY_NUMBERS; } });
+__exportStar(require("./textPresentation.js"), exports);
+__exportStar(require("./exploreCollection.js"), exports);