@neatico/visual-core 0.14.26 → 0.14.65

package/dist/contentBrief.js

@@ -0,0 +1,78 @@
+export 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,
+    });
+}
+export 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/designSystem.js

@@ -1,14 +1,88 @@
+import { EXPLORE_THEMES, EXPLORE_RECIPES, exploreCompositionFits } from './exploreCollection.js';
 import { AUTHORED_COMPOSITIONS, sceneRecipePreference, } from "./compositionScenes.js";
 import { SOCIAL_LAYOUT_CATALOG } from "./socialLayouts.js";
 import { contentBlockText, } from "./content.js";
 /** Complete, deterministic token sets; decorative geometry belongs to individual compositions. */
 export const DESIGN_THEMES = [
+    ...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: {
@@ -20,8 +94,8 @@ export const DESIGN_THEMES = [
             line: "#D7DED3",
         },
         typography: {
-            heading: "Inter",
-            body: "Inter",
+            heading: "DM Sans",
+            body: "Source Sans 3",
             code: "monospace",
             headingWeight: 700,
         },
@@ -38,7 +112,7 @@ export const DESIGN_THEMES = [
             line: "#3D526C",
         },
         typography: {
-            heading: "Inter",
+            heading: "Space Grotesk",
             body: "Inter",
             code: "monospace",
             headingWeight: 700,
@@ -57,7 +131,7 @@ export const DESIGN_THEMES = [
         },
         typography: {
             heading: "Lora",
-            body: "Inter",
+            body: "Source Sans 3",
             code: "monospace",
             headingWeight: 700,
         },
@@ -74,8 +148,8 @@ export const DESIGN_THEMES = [
             line: "#DAD5F2",
         },
         typography: {
-            heading: "Inter",
-            body: "Inter",
+            heading: "Space Grotesk",
+            body: "DM Sans",
             code: "monospace",
             headingWeight: 800,
         },
@@ -92,7 +166,7 @@ export const DESIGN_THEMES = [
             line: "#B8A233",
         },
         typography: {
-            heading: "Inter",
+            heading: "Oswald",
             body: "Inter",
             code: "monospace",
             headingWeight: 800,
@@ -108,7 +182,7 @@ export function designTheme(id) {
         plum: "electric",
     };
     return (DESIGN_THEMES.find((theme) => theme.id === (alias[id] || id)) ||
-        DESIGN_THEMES[0]);
+        DESIGN_THEMES.find(theme => theme.id === "neatico"));
 }
 const family = (id, semantic) => {
     if (/code|terminal/.test(id))
@@ -290,6 +364,7 @@ export function canonicalRecipeId(id, kind) {
 }
 /** Existing authored catalogs remain first-class candidates, rather than being discarded. */
 const ALL_DESIGN_RECIPES = [
+    ...EXPLORE_RECIPES,
     ...["cover", "closing"].flatMap((role) => ["editorial", "panel", "split"].map((style) => ({
         id: `bookend-${role}-${style}`,
         kind: "presentation",
@@ -428,6 +503,7 @@ export function designCandidates(page, context) {
     const available = page.blocks.some((b) => b.kind === "image" && b.status === "available");
     const exclude = new Set(context.excluded || []);
     const candidates = DESIGN_RECIPES.filter((r) => r.kind === context.kind &&
+        (!r.id.startsWith("authored-explore-") || (context.ratio >= 1.4 && context.ratio <= 2 && exploreCompositionFits(page, r.id))) &&
         r.automatic !== false &&
         (!r.scenes || Boolean(page.scene && r.scenes.includes(page.scene))) &&
         !(r.family.startsWith("hero") &&
@@ -455,6 +531,7 @@ export 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/exploreCollection.d.ts

@@ -0,0 +1,7 @@
+import type { DesignRecipe, DesignTheme } from "./designSystem.js";
+import type { ContentPage } from "./content.js";
+export declare const DEFAULT_PRESENTATION_THEME = "explore-teal";
+export declare const EXPLORE_THEMES: readonly DesignTheme[];
+export declare const EXPLORE_LAYOUTS: readonly [readonly ["cover", "paragraph", 0, 0, "Open with a spacious editorial headline, a short premise and an optional real photograph."], readonly ["overview", "features", 2, 4, "Orient readers with a numbered overview of parallel subjects."], readonly ["section", "paragraph", 0, 0, "Introduce one new section or central principle in a strong color field."], readonly ["pillars", "features", 2, 3, "Explain two or three equally important ideas in spacious editorial columns."], readonly ["focus", "paragraph", 0, 0, "Develop one idea in an asymmetric reading composition."], readonly ["workflow", "steps", 2, 4, "Show an ordered workflow with explicit actions and useful descriptions."], readonly ["timeline", "steps", 2, 4, "Present a short chronological sequence on a horizontal reading axis."], readonly ["comparison", "comparison", 2, 2, "Compare two supplied alternatives with corresponding points."], readonly ["worksheet", "parameters", 2, 4, "Explain named fields with their concrete values and instructions."], readonly ["photo-story", "image", 0, 0, "Use a real contextual photograph beside a concise explanation."], readonly ["quote", "quote", 0, 0, "Give an exact source statement room to breathe, retaining supplied attribution."], readonly ["chart", "chart", 2, 6, "Compare source-backed quantities in labeled bars with the original unit."], readonly ["ledger", "parameters", 2, 5, "Arrange named facts and explanations in a flat editorial ledger."], readonly ["faq", "features", 2, 3, "Answer a small set of meaningful questions with concise responses."], readonly ["action-plan", "steps", 2, 3, "Make the next few actions prominent, with descriptions that explain the work."], readonly ["closing", "paragraph", 0, 0, "Close with one clear takeaway and a concrete next action."]];
+export declare const EXPLORE_RECIPES: readonly DesignRecipe[];
+export declare function exploreCompositionFits(page: ContentPage, id: string): boolean;

package/dist/exploreCollection.js

@@ -0,0 +1,176 @@
+export const 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"],
+];
+export const 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" },
+}));
+export const 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.",
+    ],
+];
+export const EXPLORE_RECIPES = 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",
+}));
+export 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/fontCatalog.js

@@ -22,6 +22,7 @@ export const 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"]),
@@ -37,6 +38,9 @@ export const 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"]),
 ];
 export function contentScript(text, locale = "en") {
     if (/[\u3040-\u30ff]/u.test(text))
@@ -47,6 +51,8 @@ export 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"
@@ -57,7 +63,7 @@ export 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";
 }
 export function recommendedFonts(locale, text = "") {
     const script = contentScript(text, locale);

package/dist/formalCompositions.d.ts

@@ -0,0 +1,26 @@
+import { type DesignRecipe } from './designSystem.js';
+import { type RecipeParameterContract, type CompositionKind } from './recipeParameters.js';
+import type { SemanticKind } from './content.js';
+export interface FormalComposition extends RecipeParameterContract {
+    displayNumber: string;
+    aspectRatios: {
+        min: number;
+        max: number;
+    };
+    recipe?: DesignRecipe;
+}
+/** Structural reference contracts shared with the product's existing renderers.
+ * Colorways and historical aliases remain outside active discovery.
+ */
+export declare const FORMAL_REFERENCE_COMPOSITIONS: readonly {
+    id: string;
+    reference: number;
+    layout: string;
+    accepts: readonly SemanticKind[];
+}[];
+/** Matches /dev/compositions/all: 161 default previews plus two landscape-only
+ * reference entries. Output capabilities overlap and must never be summed.
+ */
+export declare const FORMAL_COMPOSITIONS: readonly FormalComposition[];
+/** Only output, ratio, and explicit IDs are hard gates; semantic fit is scored. */
+export declare function applicableCompositions(kind: CompositionKind, ratio: number, id?: string): FormalComposition[];

package/dist/formalCompositions.js

@@ -0,0 +1,117 @@
+import { EXPLORE_LAYOUTS } from './exploreCollection.js';
+import { compositionUseCase } from './compositionUseCases.js';
+import { nativeSocialParameterContract } from './nativeSocialParameters.js';
+import { DESIGN_RECIPES } from './designSystem.js';
+import { SOCIAL_LAYOUT_CATALOG } from './socialLayouts.js';
+import { recipeParameterContract } from './recipeParameters.js';
+import { SEMANTIC_DISPLAY_NUMBERS, SOCIAL_DISPLAY_NUMBERS } from './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 { ...recipeParameterContract(recipe, kinds), semanticDescription: EXPLORE_LAYOUTS.find(item => recipe.id === `authored-explore-${item[0]}`)?.[4] || 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.
+ */
+export const 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 = 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: 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.
+ */
+export const 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),
+    ...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')}`)),
+    ...SOCIAL_LAYOUT_CATALOG.map(preset => {
+        const recipe = DESIGN_RECIPES.find(item => item.id === preset.id && item.kind === 'social');
+        return { ...define({ ...recipe, renderer: 'catalog' }, ['social'], `social:${preset.id}`, SOCIAL_DISPLAY_NUMBERS[preset.id], .5, 2.4), ...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(EXPLORE_LAYOUTS.findIndex(item => recipe.id === `authored-explore-${item[0]}`) + 1).padStart(2, "0")}` : 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. */
+export function applicableCompositions(kind, ratio, id) {
+    if (!Number.isFinite(ratio) || ratio <= 0)
+        throw new Error('COMPOSITION_INVALID_RATIO');
+    if (id && !FORMAL_COMPOSITIONS.some(item => item.id === id))
+        throw new Error('COMPOSITION_UNKNOWN_ID');
+    return FORMAL_COMPOSITIONS.filter(item => item.supportedKinds.includes(kind) && ratio >= item.aspectRatios.min && ratio <= item.aspectRatios.max && (!id || item.id === id));
+}

package/dist/index.d.ts

@@ -13,3 +13,14 @@ export * from "./designBlueprint.js";
 export * from './compositionScenes.js';
 export * from './editorial.js';
 export * from './fontCatalog.js';
+export * from './candidateRanking.js';
+export * from './styleManifest.js';
+export * from './recipeParameters.js';
+export * from './formalCompositions.js';
+export * from './contentBrief.js';
+export * from "./nativeSocialParameters.js";
+export * from "./compositionUseCases.js";
+export { compositionParameterDefaults } from './parameterDefaults.js';
+export { SOCIAL_DISPLAY_NUMBERS } from './compositionNumbers.js';
+export * from './textPresentation.js';
+export * from './exploreCollection.js';

package/dist/index.js

@@ -13,3 +13,14 @@ export * from "./designBlueprint.js";
 export * from './compositionScenes.js';
 export * from './editorial.js';
 export * from './fontCatalog.js';
+export * from './candidateRanking.js';
+export * from './styleManifest.js';
+export * from './recipeParameters.js';
+export * from './formalCompositions.js';
+export * from './contentBrief.js';
+export * from "./nativeSocialParameters.js";
+export * from "./compositionUseCases.js";
+export { compositionParameterDefaults } from './parameterDefaults.js';
+export { SOCIAL_DISPLAY_NUMBERS } from './compositionNumbers.js';
+export * from './textPresentation.js';
+export * from './exploreCollection.js';