@neatico/visual-core 0.14.3 → 0.14.26

package/dist/cjs/editorial.js

@@ -5,37 +5,93 @@ exports.needsEditorialPagination = needsEditorialPagination;
 exports.ensurePresentationBookends = ensurePresentationBookends;
 const content_js_1 = require("./content.js");
 /** Reading density, not just geometric fit. CJK occupies roughly twice Latin's width. */
-const readingUnits = (text) => Array.from(text).reduce((n, c) => n + (/\s/.test(c) ? 0.2 : /[\u2e80-\u9fff\uac00-\ud7af\u3040-\u30ff]/u.test(c) ? 1 : 0.52), 0);
+const readingUnits = (text) => Array.from(text).reduce((n, c) => n +
+    (/\s/.test(c)
+        ? 0.2
+        : /[\u2e80-\u9fff\uac00-\ud7af\u3040-\u30ff]/u.test(c)
+            ? 1
+            : 0.52), 0);
 exports.readingUnits = readingUnits;
 function needsEditorialPagination(page) {
-    if (page.scene === 'brand-collection')
+    if (page.scene === "brand-collection")
         return false;
-    const entries = page.blocks.flatMap(b => b.kind === 'features' || b.kind === 'steps' ? b.entries : []);
-    if (entries.length >= 3 && entries.some(e => (0, exports.readingUnits)(e.description) > 65))
+    const entries = page.blocks.flatMap((b) => b.kind === "features" || b.kind === "steps" ? b.entries : []);
+    if (entries.length >= 3 &&
+        entries.some((e) => (0, exports.readingUnits)(e.description) > 65))
         return true;
     const total = page.blocks.reduce((n, b) => n + (0, content_js_1.contentBlockText)(b).reduce((m, s) => m + (0, exports.readingUnits)(s), 0), 0);
-    return total > 250 || page.blocks.some(b => b.kind === 'paragraph' ? (0, exports.readingUnits)(b.text) > 165 : (b.kind === 'features' || b.kind === 'steps') && (b.entries.some(e => (0, exports.readingUnits)(e.description) > 135) || (b.entries.length >= 3 && b.entries.some(e => (0, exports.readingUnits)(e.description) > 65))));
+    return (total > 250 ||
+        page.blocks.some((b) => b.kind === "paragraph"
+            ? (0, exports.readingUnits)(b.text) > 165
+            : (b.kind === "features" || b.kind === "steps") &&
+                (b.entries.some((e) => (0, exports.readingUnits)(e.description) > 135) ||
+                    (b.entries.length >= 3 &&
+                        b.entries.some((e) => (0, exports.readingUnits)(e.description) > 65)))));
 }
-const endings = { zh: '感谢聆听', en: 'Thank you', de: 'Vielen Dank', es: 'Gracias', fr: 'Merci', ja: 'ご清聴ありがとうございました', pt: 'Obrigado' };
+const endings = {
+    zh: "感谢聆听",
+    en: "Thank you",
+    de: "Vielen Dank",
+    es: "Gracias",
+    fr: "Merci",
+    ja: "ご清聴ありがとうございました",
+    pt: "Obrigado",
+};
 /** Structural bookends contain no invented customer claims or calls to action. */
 function ensurePresentationBookends(plan) {
-    if (plan.kind !== 'presentation' || !plan.pages.length)
+    if (plan.kind !== "presentation" || !plan.pages.length)
         return plan;
-    const text = [plan.title, ...plan.pages.map(p => p.title)].join(' ');
-    const language = /[\u3040-\u30ff]/.test(text) ? 'ja' : /[\u3400-\u9fff]/.test(text) ? 'zh' : /\b(und|für|Einführung)\b/i.test(text) ? 'de' : /\b(pour|présentation|avec)\b/i.test(text) ? 'fr' : /\b(para|apresentação|com)\b/i.test(text) ? 'pt' : /\b(presentación|con|gracias)\b/i.test(text) ? 'es' : 'en';
-    const pages = plan.pages.map(p => ({ ...p, blocks: [...p.blocks] }));
-    const used = new Set(pages.flatMap(p => [p.id, ...p.blocks.map(b => b.id)]));
-    const id = (prefix) => { let s = prefix, i = 0; while (used.has(s))
-        s = `${prefix}-${++i}`; used.add(s); return s; };
-    const bookend = (purpose) => ({ id: id(`deck-${purpose}`), title: purpose === 'cover' ? plan.title : endings[language], purpose, scene: purpose === 'cover' ? 'hero' : 'closing', evidence: pages[0].evidence, blocks: [{ id: id(`deck-${purpose}-caption`), kind: 'paragraph', text: plan.title, evidence: pages[0].evidence }] });
-    if (pages[0].purpose !== 'cover')
-        pages.unshift(bookend('cover'));
+    const text = [plan.title, ...plan.pages.map((p) => p.title)].join(" ");
+    const language = /[\u3040-\u30ff]/.test(text)
+        ? "ja"
+        : /[\u3400-\u9fff]/.test(text)
+            ? "zh"
+            : /\b(und|für|Einführung)\b/i.test(text)
+                ? "de"
+                : /\b(pour|présentation|avec)\b/i.test(text)
+                    ? "fr"
+                    : /\b(para|apresentação|com)\b/i.test(text)
+                        ? "pt"
+                        : /\b(presentación|con|gracias)\b/i.test(text)
+                            ? "es"
+                            : "en";
+    const pages = plan.pages.map((p) => ({ ...p, blocks: [...p.blocks] }));
+    const used = new Set(pages.flatMap((p) => [p.id, ...p.blocks.map((b) => b.id)]));
+    const id = (prefix) => {
+        let s = prefix, i = 0;
+        while (used.has(s))
+            s = `${prefix}-${++i}`;
+        used.add(s);
+        return s;
+    };
+    const bookend = (purpose) => ({
+        id: id(`deck-${purpose}`),
+        title: purpose === "cover" ? plan.title : endings[language],
+        purpose,
+        scene: purpose === "cover" ? "hero" : "closing",
+        evidence: pages[0].evidence,
+        blocks: [
+            {
+                id: id(`deck-${purpose}-caption`),
+                kind: "paragraph",
+                text: plan.title,
+                evidence: pages[0].evidence,
+            },
+        ],
+    });
+    if (pages[0].purpose !== "cover")
+        pages.unshift(bookend("cover"));
     const last = pages[pages.length - 1];
     // Evidence and long explanations remain content slides, never masquerade as a closing.
-    if (last.purpose !== 'conclude' || last.scene === 'brand-collection' || last.blocks.some(b => b.kind !== 'paragraph') || last.blocks.reduce((n, b) => n + (0, content_js_1.contentBlockText)(b).join('').length, 0) > 120 || /行业认可|客户|customers|trusted by/i.test(last.title)) {
-        if (last.purpose === 'conclude')
-            last.purpose = 'evidence';
-        pages.push(bookend('conclude'));
+    if (last.purpose !== "conclude" ||
+        last.scene === "brand-collection" ||
+        last.blocks.some((b) => b.kind !== "paragraph") ||
+        last.blocks.reduce((n, b) => n + (0, content_js_1.contentBlockText)(b).join("").length, 0) >
+            120 ||
+        /行业认可|客户|customers|trusted by/i.test(last.title)) {
+        if (last.purpose === "conclude")
+            last.purpose = "evidence";
+        pages.push(bookend("conclude"));
     }
     return { ...plan, pages };
 }

package/dist/cjs/fontCatalog.js

@@ -4,39 +4,91 @@ exports.GOOGLE_FONT_CATALOG = void 0;
 exports.contentScript = contentScript;
 exports.recommendedFonts = recommendedFonts;
 exports.languageFont = languageFont;
-const entry = (family, category, scripts = ['latin'], weights = [400, 700]) => ({ family, category, scripts, weights });
+const entry = (family, category, scripts = ["latin"], weights = [400, 700]) => ({ family, category, scripts, weights });
 /** Curated Google Fonts families; request only their declared, supported weights. */
 exports.GOOGLE_FONT_CATALOG = [
-    ...['Inter', 'Roboto', 'Montserrat', 'Manrope', 'DM Sans', 'Lato', 'Open Sans', 'Source Sans 3', 'Work Sans', 'Nunito Sans', 'IBM Plex Sans'].map(f => entry(f, 'sans')),
-    ...['Lora', 'Merriweather', 'Libre Baskerville', 'Source Serif 4', 'Playfair Display', 'PT Serif'].map(f => entry(f, 'serif')),
-    ...['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']), entry('Noto Serif SC', 'serif', ['zh']), entry('ZCOOL XiaoWei', 'display', ['zh'], [400]), entry('Ma Shan Zheng', 'display', ['zh'], [400]),
-    entry('Noto Sans TC', 'sans', ['zh-Hant']), entry('Noto Serif TC', 'serif', ['zh-Hant']),
-    entry('Noto Sans JP', 'sans', ['ja']), entry('Noto Serif JP', 'serif', ['ja']), entry('M PLUS Rounded 1c', 'sans', ['ja']),
-    entry('Noto Sans KR', 'sans', ['ko']), entry('Noto Serif KR', 'serif', ['ko']),
-    entry('Noto Sans Arabic', 'sans', ['ar']), entry('Noto Sans Devanagari', 'sans', ['hi']),
+    ...[
+        "Inter",
+        "Roboto",
+        "Montserrat",
+        "Manrope",
+        "DM Sans",
+        "Lato",
+        "Open Sans",
+        "Source Sans 3",
+        "Work Sans",
+        "Nunito Sans",
+        "IBM Plex Sans",
+    ].map((f) => entry(f, "sans")),
+    ...[
+        "Lora",
+        "Merriweather",
+        "Libre Baskerville",
+        "Source Serif 4",
+        "Playfair Display",
+        "PT Serif",
+    ].map((f) => entry(f, "serif")),
+    ...["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"]),
+    entry("Noto Serif SC", "serif", ["zh"]),
+    entry("ZCOOL XiaoWei", "display", ["zh"], [400]),
+    entry("Ma Shan Zheng", "display", ["zh"], [400]),
+    entry("Noto Sans TC", "sans", ["zh-Hant"]),
+    entry("Noto Serif TC", "serif", ["zh-Hant"]),
+    entry("Noto Sans JP", "sans", ["ja"]),
+    entry("Noto Serif JP", "serif", ["ja"]),
+    entry("M PLUS Rounded 1c", "sans", ["ja"]),
+    entry("Noto Sans KR", "sans", ["ko"]),
+    entry("Noto Serif KR", "serif", ["ko"]),
+    entry("Noto Sans Arabic", "sans", ["ar"]),
+    entry("Noto Sans Devanagari", "sans", ["hi"]),
 ];
-function contentScript(text, locale = 'en') {
+function contentScript(text, locale = "en") {
     if (/[\u3040-\u30ff]/u.test(text))
-        return 'ja';
+        return "ja";
     if (/[\uac00-\ud7af]/u.test(text))
-        return 'ko';
+        return "ko";
     if (/[\u0600-\u06ff]/u.test(text))
-        return 'ar';
+        return "ar";
     if (/[\u0900-\u097f]/u.test(text))
-        return 'hi';
+        return "hi";
     if (/[\u3400-\u9fff]/u.test(text))
-        return /TW|HK|Hant/i.test(locale) ? 'zh-Hant' : 'zh';
+        return /^ja/i.test(locale)
+            ? "ja"
+            : /^ko/i.test(locale)
+                ? "ko"
+                : /TW|HK|Hant/i.test(locale)
+                    ? "zh-Hant"
+                    : "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 /TW|HK|Hant/i.test(locale) ? "zh-Hant" : "zh";
+    return /^(ja|ko|ar|hi)/.exec(locale)?.[1] || "latin";
 }
-function recommendedFonts(locale, text = '') { const script = contentScript(text, locale); return [...exports.GOOGLE_FONT_CATALOG].sort((a, b) => Number(b.scripts.includes(script)) - Number(a.scripts.includes(script))); }
-function languageFont(text, preferred, locale = 'en') {
+function recommendedFonts(locale, text = "") {
     const script = contentScript(text, locale);
-    if (script === 'latin')
+    return [...exports.GOOGLE_FONT_CATALOG].sort((a, b) => Number(b.scripts.includes(script)) - Number(a.scripts.includes(script)));
+}
+function languageFont(text, preferred, locale = "en") {
+    const script = contentScript(text, locale);
+    if (script === "latin")
+        return preferred;
+    const selected = exports.GOOGLE_FONT_CATALOG.find((font) => font.family === preferred);
+    if (selected?.scripts.includes(script))
+        return preferred;
+    if (!selected &&
+        ![
+            "Arial",
+            "Helvetica",
+            "Georgia",
+            "Times New Roman",
+            "Courier New",
+            "sans-serif",
+            "serif",
+            "monospace",
+        ].includes(preferred))
         return preferred;
-    const serif = /serif|Georgia|Lora|Baskerville|Merriweather|Playfair/i.test(preferred) && !/sans/i.test(preferred);
-    return exports.GOOGLE_FONT_CATALOG.find(f => f.scripts.includes(script) && f.category === (serif ? 'serif' : 'sans'))?.family || preferred;
+    const serif = /serif|Georgia|Lora|Baskerville|Merriweather|Playfair/i.test(preferred) &&
+        !/sans/i.test(preferred);
+    return (exports.GOOGLE_FONT_CATALOG.find((f) => f.scripts.includes(script) && f.category === (serif ? "serif" : "sans"))?.family || preferred);
 }

package/dist/cjs/layoutContracts.js

@@ -3,25 +3,71 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LAYOUT_CONTRACTS = void 0;
 exports.eligibleLayouts = eligibleLayouts;
 exports.layoutCandidates = layoutCandidates;
-const layouts_js_1 = require("./layouts.js");
 const socialLayouts_js_1 = require("./socialLayouts.js");
-const textOnly = new Set(['cover', 'section', 'statement', 'quote', 'closing', 'image-full', 'og-cover', 'gradient-cover', 'bold-diagonal-cover', 'split-cover', 'block-banner', 'video-cover', 'magazine-pull-quote']);
-const pair = new Set(['comparison', 'two-column', 'myth', 'problem-solution', 'before-after', 'split-bar-compare']);
+const textOnly = new Set([
+    "cover",
+    "section",
+    "statement",
+    "quote",
+    "closing",
+    "image-full",
+    "og-cover",
+    "gradient-cover",
+    "bold-diagonal-cover",
+    "split-cover",
+    "block-banner",
+    "video-cover",
+    "magazine-pull-quote",
+]);
+const pair = new Set([
+    "comparison",
+    "two-column",
+    "myth",
+    "problem-solution",
+    "before-after",
+    "split-bar-compare",
+]);
 /** Eligibility is a first filter, never a substitute for measured fit. */
 exports.LAYOUT_CONTRACTS = [
-    ...layouts_js_1.PRESENTATION_LAYOUT_IDS.map(id => ({ id, kind: 'presentation', semantic: pair.has(id) ? 'comparison' : textOnly.has(id) ? 'editorial' : id, minItems: pair.has(id) ? 2 : 0, maxItems: textOnly.has(id) ? 0 : pair.has(id) ? 2 : 4, minRatio: 16 / 9, maxRatio: 16 / 9, required: ['title'] })),
-    ...socialLayouts_js_1.SOCIAL_LAYOUT_CATALOG.map(({ id, scene }) => ({ id, kind: 'social', semantic: scene, minItems: pair.has(id) ? 2 : 0, maxItems: textOnly.has(id) ? 0 : pair.has(id) ? 2 : id === 'course-syllabus' ? 15 : 6, minRatio: .25, maxRatio: 4, required: ['headline', ...(['pricing', 'metric'].includes(scene) ? ['value'] : [])] })),
+    ...socialLayouts_js_1.SOCIAL_LAYOUT_CATALOG.map(({ id, scene }) => ({
+        id,
+        kind: "social",
+        semantic: scene,
+        minItems: pair.has(id) ? 2 : 0,
+        maxItems: textOnly.has(id) ? 0 : pair.has(id) ? 2 : 6,
+        minRatio: 0.25,
+        maxRatio: 4,
+        required: [
+            "headline",
+            ...(["pricing", "metric"].includes(scene) ? ["value"] : []),
+        ],
+    })),
 ];
 function eligibleLayouts(kind, content, ratio) {
     const count = Array.isArray(content.items) ? content.items.length : 0;
-    return exports.LAYOUT_CONTRACTS.filter(layout => layout.kind === kind && ratio >= layout.minRatio - 1e-6 && ratio <= layout.maxRatio + 1e-6 && count >= layout.minItems && count <= layout.maxItems && layout.required.every(key => typeof content[key] === 'string' && String(content[key]).trim()));
+    return exports.LAYOUT_CONTRACTS.filter((layout) => layout.kind === kind &&
+        ratio >= layout.minRatio - 1e-6 &&
+        ratio <= layout.maxRatio + 1e-6 &&
+        count >= layout.minItems &&
+        count <= layout.maxItems &&
+        layout.required.every((key) => typeof content[key] === "string" && String(content[key]).trim()));
 }
 /** Requested intent, same semantic scene, then general-purpose structures. */
 function layoutCandidates(kind, requested, content, ratio, limit = 8) {
     const eligible = eligibleLayouts(kind, content, ratio);
-    const selected = exports.LAYOUT_CONTRACTS.find(layout => layout.kind === kind && layout.id === requested);
-    const fallback = kind === 'presentation' ? ['cards', 'two-column', 'bullets', 'table', 'agenda', 'statement'] : ['report', 'checklist', 'steps', 'bento', 'editorial', 'story'];
-    const order = [requested, ...eligible.filter(layout => layout.semantic === (content.scene || selected?.semantic)).map(layout => layout.id), ...fallback];
-    const allowed = new Set(eligible.map(layout => layout.id));
-    return [...new Set(order)].filter(id => allowed.has(id)).slice(0, Math.max(1, Math.min(16, limit)));
+    const selected = exports.LAYOUT_CONTRACTS.find((layout) => layout.kind === kind && layout.id === requested);
+    const fallback = kind === "presentation"
+        ? ["cards", "two-column", "bullets", "table", "agenda", "statement"]
+        : ["report", "checklist", "steps", "bento", "editorial", "story"];
+    const order = [
+        requested,
+        ...eligible
+            .filter((layout) => layout.semantic === (content.scene || selected?.semantic))
+            .map((layout) => layout.id),
+        ...fallback,
+    ];
+    const allowed = new Set(eligible.map((layout) => layout.id));
+    return [...new Set(order)]
+        .filter((id) => allowed.has(id))
+        .slice(0, Math.max(1, Math.min(16, limit)));
 }

package/dist/cjs/layouts.js

@@ -1,103 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PRESENTATION_LAYOUT_IDS = void 0;
-/** Shared stable IDs for authored presentation renderers. */
+/** Content intents for structured presentations; not a separate renderer catalog. */
 exports.PRESENTATION_LAYOUT_IDS = [
     "cover",
-    "agenda",
     "section",
     "statement",
-    "bullets",
-    "two-column",
-    "comparison",
-    "three-column",
-    "process",
-    "timeline",
-    "metrics",
-    "quote",
-    "image-left",
-    "image-right",
-    "image-full",
-    "closing",
     "cards",
-    "checklist",
-    "roadmap",
-    "team",
-    "pricing",
-    "faq",
-    "swot",
-    "scorecard",
+    "process",
+    "comparison",
     "bar-chart",
-    "funnel",
+    "quote",
     "table",
-    "problem-solution",
-    "case-study",
-    "architecture",
-    "risk",
-    "action-plan",
-    "usage-breakdown",
-    "organization",
-    "editorial-quote",
-    "research-highlight",
-    "product-showcase",
-    "split-bar-compare",
-    "benchmark-bars",
-    "block-banner",
-    "progress-roadmap",
-    "fan-deck",
-    "contents-index",
-    "contents-chapters",
-    "contents-grid",
-    "definition-card",
-    "topic-branches",
-    "radial-mindmap",
-    "tips-card",
-    "code-snippet",
-    "series-carousel",
-    "reflection-card",
-    "video-cover",
-    "digest-card",
-    "chat-preview",
-    "recommendation-feed",
-    "before-after",
-    "course-syllabus",
-    "concept-explainer",
-    "persona-question",
-    "nutrient-symptom-grid",
-    "milestone-history",
-    "release-notes",
-    "product-listing",
-    "flash-sale",
-    "event-banner",
-    "startup-journey",
-    "vision-goals",
-    "tips-grid",
-    "experiment-report",
-    "leaderboard",
-    "win-journey",
-    "device-price-promo",
-    "mega-sale-typographic",
-    "illustration-process",
-    "glass-neon-sale",
-    "free-trial-hero",
-    "feature-chip-hero",
-    "event-speaker-card",
-    "corporate-hero",
-    "release-version-hero",
-    "og-cover",
-    "gradient-cover",
-    "bold-diagonal-cover",
-    "split-cover",
-    "article-feed-card",
-    "article-summary-card",
-    "paragraph-summary-card",
-    "summary-card-stack",
-    "article-repost-card",
-    "article-core-digest",
-    "product-thread-mockup",
-    "agent-notification",
-    "angled-ui-launch",
-    "repo-card",
-    "magazine-pull-quote",
-    "question-answer-quote"
+    "closing",
 ];

package/dist/cjs/pagination.js

@@ -5,7 +5,9 @@ exports.splitContent = splitContent;
 /** Split only at explicit word/sentence boundaries. Never cut identifiers,
  * decimal values, or unbroken URLs to force them onto a smaller canvas. */
 function splitCopy(copy) {
-    const breaks = [...copy.matchAll(/\s+|[。！？；]|[.!?;](?=\s|$)/gu)].map(match => match.index + match[0].length).filter(index => index > 0 && index < copy.length);
+    const breaks = [...copy.matchAll(/\s+|[。！？；]|[.!?;](?=\s|$)/gu)]
+        .map((match) => match.index + match[0].length)
+        .filter((index) => index > 0 && index < copy.length);
     if (!breaks.length)
         return;
     const at = breaks.sort((a, b) => Math.abs(a - copy.length / 2) - Math.abs(b - copy.length / 2))[0];
@@ -19,18 +21,27 @@ function splitContent(source) {
     const items = source.items || [];
     if (items.length > 1) {
         const middle = Math.ceil(items.length / 2);
-        return [{ ...base, items: items.slice(0, middle) }, { ...base, body: '', items: items.slice(middle) }];
+        return [
+            { ...base, items: items.slice(0, middle) },
+            { ...base, body: "", items: items.slice(middle) },
+        ];
     }
     if (items.length && source.body?.trim())
-        return [{ ...base, items: [] }, { ...base, body: '', items }];
+        return [
+            { ...base, items: [] },
+            { ...base, body: "", items },
+        ];
     if (source.body) {
         const parts = splitCopy(source.body);
         if (parts)
-            return parts.map(body => ({ ...base, body }));
+            return parts.map((body) => ({ ...base, body }));
     }
     if (items.length === 1) {
         const parts = splitCopy(items[0].description);
         if (parts)
-            return parts.map(description => ({ ...base, items: [{ ...items[0], description }] }));
+            return parts.map((description) => ({
+                ...base,
+                items: [{ ...items[0], description }],
+            }));
     }
 }