@sliiu/present-themes 0.0.0-stage → 0.1.1

package/dist/cjs/fonts/inject.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_FONT_POOL = void 0;
+exports.isFontInjected = isFontInjected;
+exports.injectFontCss = injectFontCss;
+exports.findFontPreset = findFontPreset;
+const core_1 = require("@sliiu/present-core");
+// 浏览器内字体注入工具：把 Google Fonts CSS 链接以 idempotent 方式塞进 <head>，
+// 让 SVG / Canvas / DOM 渲染时都能正确解析到指定 fontFamily。
+//
+// 用于：
+//   - stock-fonts MCP：用户主动选字体（fonts_apply）
+//   - theme generator：AI 生成主题时一并把题字 / 正文 family 注入
+//
+// 设计：
+//   - 缓存已注入的 family，防止 N 次 apply 同一字体重复添加 <link>。
+//   - preconnect 只插入一次（fonts.googleapis.com + fonts.gstatic.com）。
+//   - 不依赖任何外部资源；离线 / CDN 不可达时 link 失败不会阻塞渲染，会回退到
+//     font 栈中的下一个备选。
+const INJECTED_FAMILIES = new Set();
+function isFontInjected(family) {
+    return INJECTED_FAMILIES.has(family);
+}
+/**
+ * 注入一份 Google Fonts CSS（或任意公开 CSS）到当前 document。
+ *
+ * @param cssUrl  Google Fonts CSS v2 url（如 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap'）
+ *                也可以是任何指向 @font-face 规则的 CSS url。
+ * @param family  CSS font-family 名（用于 dedup 缓存 + DOM 标记）。
+ */
+function injectFontCss(cssUrl, family) {
+    if (typeof document === "undefined")
+        return;
+    const existing = document.querySelector(`link[data-mcp-font="${family}"]`);
+    if (existing) {
+        if (existing.getAttribute("href") !== cssUrl)
+            existing.href = cssUrl;
+        INJECTED_FAMILIES.add(family);
+        return;
+    }
+    if (INJECTED_FAMILIES.has(family))
+        return;
+    if (!document.querySelector('link[data-mcp-font-preconnect]')) {
+        const pre1 = document.createElement("link");
+        pre1.rel = "preconnect";
+        pre1.href = "https://fonts.googleapis.com";
+        pre1.dataset.mcpFontPreconnect = "1";
+        document.head.appendChild(pre1);
+        const pre2 = document.createElement("link");
+        pre2.rel = "preconnect";
+        pre2.href = "https://fonts.gstatic.com";
+        pre2.crossOrigin = "anonymous";
+        pre2.dataset.mcpFontPreconnect = "1";
+        document.head.appendChild(pre2);
+    }
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = cssUrl;
+    link.dataset.mcpFont = family;
+    document.head.appendChild(link);
+    INJECTED_FAMILIES.add(family);
+}
+// 字体栈 fallback：CJK 兼容 + 系统兜底。
+const CJK_FALLBACK = ', "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC"';
+exports.THEME_FONT_POOL = [
+    // ---- 拉丁 sans-serif ----
+    { family: "Inter", category: "sans-serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Inter:wght@200;300;400;500;600;700&display=swap",
+        stack: `"Inter", -apple-system, BlinkMacSystemFont${CJK_FALLBACK}, sans-serif`,
+        tags: ["modern", "ui", "neutral", "tech", "clean"] },
+    { family: "Manrope", category: "sans-serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700;800&display=swap",
+        stack: `"Manrope", -apple-system${CJK_FALLBACK}, sans-serif`,
+        tags: ["modern", "elegant", "startup"] },
+    { family: "Space Grotesk", category: "sans-serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&display=swap",
+        stack: `"Space Grotesk", -apple-system${CJK_FALLBACK}, sans-serif`,
+        tags: ["modern", "tech", "geometric", "futuristic"] },
+    { family: "DM Sans", category: "sans-serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&display=swap",
+        stack: `"DM Sans"${CJK_FALLBACK}, sans-serif`,
+        tags: ["modern", "warm", "friendly"] },
+    { family: "Plus Jakarta Sans", category: "sans-serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap",
+        stack: `"Plus Jakarta Sans"${CJK_FALLBACK}, sans-serif`,
+        tags: ["modern", "balanced", "saas"] },
+    // ---- 拉丁 display / headline ----
+    { family: "Sora", category: "display", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Sora:wght@400;600;800&display=swap",
+        stack: `"Sora"${CJK_FALLBACK}, sans-serif`,
+        tags: ["headline", "tech", "modern", "bold"] },
+    { family: "Bricolage Grotesque", category: "display", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,400;12..96,600;12..96,800&display=swap",
+        stack: `"Bricolage Grotesque"${CJK_FALLBACK}, sans-serif`,
+        tags: ["editorial", "expressive", "headline"] },
+    { family: "Unbounded", category: "display", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Unbounded:wght@400;600;800&display=swap",
+        stack: `"Unbounded"${CJK_FALLBACK}, sans-serif`,
+        tags: ["futuristic", "rounded", "luxury", "headline"] },
+    // ---- 拉丁 serif ----
+    { family: "Playfair Display", category: "serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,400;0,700;0,800;0,900;1,400&display=swap",
+        stack: `"Playfair Display"${CJK_FALLBACK}, serif`,
+        tags: ["elegant", "editorial", "luxury", "headline"] },
+    { family: "Fraunces", category: "serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,400;9..144,700;9..144,900&display=swap",
+        stack: `"Fraunces"${CJK_FALLBACK}, serif`,
+        tags: ["editorial", "warm", "expressive"] },
+    { family: "Newsreader", category: "serif", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Newsreader:opsz,wght@6..72,400;6..72,600&display=swap",
+        stack: `"Newsreader"${CJK_FALLBACK}, serif`,
+        tags: ["reading", "magazine", "warm"] },
+    // ---- 等宽 ----
+    { family: "JetBrains Mono", category: "monospace", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap",
+        stack: `"JetBrains Mono", "Menlo", "Consolas", monospace`,
+        tags: ["code", "monospace", "developer"] },
+    { family: "IBM Plex Mono", category: "monospace", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&display=swap",
+        stack: `"IBM Plex Mono", "Menlo", "Consolas", monospace`,
+        tags: ["code", "monospace", "editorial", "meta"] },
+    { family: "Space Mono", category: "monospace", language: "latin",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&display=swap",
+        stack: `"Space Mono", "Menlo", monospace`,
+        tags: ["code", "retro", "tech"] },
+    // ---- 中文 sans ----
+    { family: "Noto Sans SC", category: "sans-serif", language: "cjk",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;700&display=swap",
+        stack: `"Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif`,
+        tags: ["中文", "黑体", "简体", "正式", "现代"] },
+    // ---- 中文 serif ----
+    { family: "Noto Serif SC", category: "serif", language: "cjk",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;700;800;900&display=swap",
+        stack: `"Noto Serif SC", "Songti SC", "SimSun", serif`,
+        tags: ["中文", "宋体", "简体", "正式", "经典"] },
+    // ---- 中文显示 / 标题 ----
+    { family: "ZCOOL XiaoWei", category: "display", language: "cjk",
+        cssUrl: "https://fonts.googleapis.com/css2?family=ZCOOL+XiaoWei&display=swap",
+        stack: `"ZCOOL XiaoWei", "Songti SC", serif`,
+        tags: ["中文", "宋体", "手写", "标题", "文艺"] },
+    { family: "ZCOOL KuaiLe", category: "display", language: "cjk",
+        cssUrl: "https://fonts.googleapis.com/css2?family=ZCOOL+KuaiLe&display=swap",
+        stack: `"ZCOOL KuaiLe"${CJK_FALLBACK}, sans-serif`,
+        tags: ["中文", "可爱", "标题", "活泼"] },
+    { family: "Ma Shan Zheng", category: "handwriting", language: "cjk",
+        cssUrl: "https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap",
+        stack: `"Ma Shan Zheng", "Songti SC", serif`,
+        tags: ["中文", "书法", "毛笔", "手写", "传统"] },
+];
+/** 按 family 找 preset；找不到返回 null，调用方应回退到默认栈。 */
+function findFontPreset(family) {
+    const exact = exports.THEME_FONT_POOL.find((p) => p.family === family || p.stack === family);
+    if (exact)
+        return exact;
+    const primary = (0, core_1.canonicalTypeface)(family) ?? (0, core_1.firstNamedTypeface)(family);
+    if (!primary)
+        return null;
+    const lower = primary.toLowerCase();
+    return exports.THEME_FONT_POOL.find((p) => p.family.toLowerCase() === lower) ?? null;
+}

package/dist/cjs/gallery-order.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_GALLERY_ORDER = void 0;
+/** Design / Console 主题画廊展示顺序（与 template-store 内置模板顺序一致）。 */
+exports.THEME_GALLERY_ORDER = [
+    "dark",
+    "tech",
+    "terminal",
+    "creative",
+    "luxe",
+    "business",
+    "editorial",
+    "warm",
+    "pastel",
+    "academic",
+    "ink",
+    "nature",
+    "minimal",
+];

package/dist/cjs/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplyThemeCmd = exports.ApplyCustomThemeCmd = exports.themeSpecFromThemeDef = exports.stripSlideThemeDecorations = exports.resolveLayoutTypeForSlide = exports.findLayoutRefByType = exports.buildMastersFromThemeDef = exports.buildCoreThemeFromSpec = exports.injectFontCss = exports.findFontPreset = exports.THEME_FONT_POOL = exports.buildDecorationShapesShared = exports.realizeGeneratedTheme = exports.injectThemeFonts = exports.getTheme = exports.GeneratedThemeSpecSchema = exports.THEME_FONT_FAMILIES = exports.THEME_STYLE_SEEDS = exports.THEME_OUTLINE_HINTS = exports.THEME_IDS = exports.THEMES = exports.THEME_GALLERY_ORDER = exports.BUILTIN_THEME_IDS = void 0;
+var builtin_ids_1 = require("./builtin-ids");
+Object.defineProperty(exports, "BUILTIN_THEME_IDS", { enumerable: true, get: function () { return builtin_ids_1.BUILTIN_THEME_IDS; } });
+var gallery_order_1 = require("./gallery-order");
+Object.defineProperty(exports, "THEME_GALLERY_ORDER", { enumerable: true, get: function () { return gallery_order_1.THEME_GALLERY_ORDER; } });
+var themes_1 = require("./themes");
+Object.defineProperty(exports, "THEMES", { enumerable: true, get: function () { return themes_1.THEMES; } });
+Object.defineProperty(exports, "THEME_IDS", { enumerable: true, get: function () { return themes_1.THEME_IDS; } });
+Object.defineProperty(exports, "THEME_OUTLINE_HINTS", { enumerable: true, get: function () { return themes_1.THEME_OUTLINE_HINTS; } });
+Object.defineProperty(exports, "THEME_STYLE_SEEDS", { enumerable: true, get: function () { return themes_1.THEME_STYLE_SEEDS; } });
+Object.defineProperty(exports, "THEME_FONT_FAMILIES", { enumerable: true, get: function () { return themes_1.THEME_FONT_FAMILIES; } });
+Object.defineProperty(exports, "GeneratedThemeSpecSchema", { enumerable: true, get: function () { return themes_1.GeneratedThemeSpecSchema; } });
+Object.defineProperty(exports, "getTheme", { enumerable: true, get: function () { return themes_1.getTheme; } });
+Object.defineProperty(exports, "injectThemeFonts", { enumerable: true, get: function () { return themes_1.injectThemeFonts; } });
+Object.defineProperty(exports, "realizeGeneratedTheme", { enumerable: true, get: function () { return themes_1.realizeGeneratedTheme; } });
+var decorations_1 = require("./decorations");
+Object.defineProperty(exports, "buildDecorationShapesShared", { enumerable: true, get: function () { return decorations_1.buildDecorationShapesShared; } });
+var inject_1 = require("./fonts/inject");
+Object.defineProperty(exports, "THEME_FONT_POOL", { enumerable: true, get: function () { return inject_1.THEME_FONT_POOL; } });
+Object.defineProperty(exports, "findFontPreset", { enumerable: true, get: function () { return inject_1.findFontPreset; } });
+Object.defineProperty(exports, "injectFontCss", { enumerable: true, get: function () { return inject_1.injectFontCss; } });
+var template_masters_1 = require("./template-masters");
+Object.defineProperty(exports, "buildCoreThemeFromSpec", { enumerable: true, get: function () { return template_masters_1.buildCoreThemeFromSpec; } });
+Object.defineProperty(exports, "buildMastersFromThemeDef", { enumerable: true, get: function () { return template_masters_1.buildMastersFromThemeDef; } });
+Object.defineProperty(exports, "findLayoutRefByType", { enumerable: true, get: function () { return template_masters_1.findLayoutRefByType; } });
+Object.defineProperty(exports, "resolveLayoutTypeForSlide", { enumerable: true, get: function () { return template_masters_1.resolveLayoutTypeForSlide; } });
+Object.defineProperty(exports, "stripSlideThemeDecorations", { enumerable: true, get: function () { return template_masters_1.stripSlideThemeDecorations; } });
+Object.defineProperty(exports, "themeSpecFromThemeDef", { enumerable: true, get: function () { return template_masters_1.themeSpecFromThemeDef; } });
+var theme_commands_1 = require("./theme-commands");
+Object.defineProperty(exports, "ApplyCustomThemeCmd", { enumerable: true, get: function () { return theme_commands_1.ApplyCustomThemeCmd; } });
+Object.defineProperty(exports, "ApplyThemeCmd", { enumerable: true, get: function () { return theme_commands_1.ApplyThemeCmd; } });

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/qa/color.js

@@ -0,0 +1,98 @@
+"use strict";
+// 共享颜色 / 对比度工具（WCAG 2.x relative luminance + contrast ratio）。
+//
+// 抽出来给两处复用，避免颜色数学各写一份漂移：
+//   - qa/validate.ts：生成后 per-slide 文字对比度修复
+//   - themes.ts realizeGeneratedTheme：AI 主题 palette 源头对比度兜底（#5）
+//
+// 兜底文字色与 ppt-visual-design.md / ppt-design-rules.mdc §7 保持一致。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WCAG_BODY_TEXT_CONTRAST = exports.WCAG_LARGE_TEXT_CONTRAST = exports.SAFE_TEXT_LIGHT = exports.SAFE_TEXT_DARK = void 0;
+exports.parseHex = parseHex;
+exports.toHex = toHex;
+exports.relativeLuminance = relativeLuminance;
+exports.contrastRatio = contrastRatio;
+exports.readableTextColor = readableTextColor;
+exports.mixRgb = mixRgb;
+exports.ensureContrast = ensureContrast;
+/** 解析 #rgb / #rrggbb（大小写均可）。无法解析返回 null。 */
+function parseHex(input) {
+    if (!input)
+        return null;
+    let s = input.trim();
+    if (s.startsWith("#"))
+        s = s.slice(1);
+    if (s.length === 3) {
+        s = s
+            .split("")
+            .map((c) => c + c)
+            .join("");
+    }
+    if (s.length !== 6 || /[^0-9a-fA-F]/.test(s))
+        return null;
+    return {
+        r: parseInt(s.slice(0, 2), 16),
+        g: parseInt(s.slice(2, 4), 16),
+        b: parseInt(s.slice(4, 6), 16),
+    };
+}
+/** Rgb → #rrggbb（小写）。 */
+function toHex(rgb) {
+    const h = (n) => Math.max(0, Math.min(255, Math.round(n)))
+        .toString(16)
+        .padStart(2, "0");
+    return `#${h(rgb.r)}${h(rgb.g)}${h(rgb.b)}`;
+}
+function srgbChannel(c) {
+    const cs = c / 255;
+    return cs <= 0.03928 ? cs / 12.92 : Math.pow((cs + 0.055) / 1.055, 2.4);
+}
+/** WCAG 相对亮度 0..1。 */
+function relativeLuminance(rgb) {
+    return 0.2126 * srgbChannel(rgb.r) + 0.7152 * srgbChannel(rgb.g) + 0.0722 * srgbChannel(rgb.b);
+}
+/** WCAG 对比度 1..21。 */
+function contrastRatio(a, b) {
+    const la = relativeLuminance(a);
+    const lb = relativeLuminance(b);
+    const hi = Math.max(la, lb);
+    const lo = Math.min(la, lb);
+    return (hi + 0.05) / (lo + 0.05);
+}
+// 规范里的两个兜底文字色（与 ppt-visual-design.md / ppt-design-rules.mdc 一致）。
+exports.SAFE_TEXT_DARK = "#0f172a"; // 用于亮底
+exports.SAFE_TEXT_LIGHT = "#f8fafc"; // 用于暗底
+// WCAG AA 对比度阈值（单一事实源）：
+//   - 大字（标题 / 大数字）≥3.0；正文 ≥4.5。
+// validate.ts 的默认阈值、art-director 的 recolor 门槛、art-director rubric 文案都引用这两个常量，
+// 保证"生成时兜底"和"验收时打分"用同一把尺。
+exports.WCAG_LARGE_TEXT_CONTRAST = 3.0;
+exports.WCAG_BODY_TEXT_CONTRAST = 4.5;
+/** 根据底色亮度选一个高对比度的兜底文字色。 */
+function readableTextColor(bg) {
+    return relativeLuminance(bg) > 0.5 ? exports.SAFE_TEXT_DARK : exports.SAFE_TEXT_LIGHT;
+}
+/** 线性插值两色，t=0 → a，t=1 → b。 */
+function mixRgb(a, b, t) {
+    const k = Math.max(0, Math.min(1, t));
+    return {
+        r: a.r + (b.r - a.r) * k,
+        g: a.g + (b.g - a.g) * k,
+        b: a.b + (b.b - a.b) * k,
+    };
+}
+/**
+ * 把 `color` 朝 `target` 方向逐步靠拢，直到相对 `bg` 的对比度 ≥ `min`。
+ * 用于把「对底色太浅」的次要文字色拉到达标，同时尽量保留原色调（小步逼近）。
+ * 若走到 target 仍不达标（几乎不可能，target 应是高对比色），返回 target。
+ */
+function ensureContrast(color, bg, target, min) {
+    if (contrastRatio(color, bg) >= min)
+        return color;
+    for (let t = 0.15; t < 1; t += 0.15) {
+        const c = mixRgb(color, target, t);
+        if (contrastRatio(c, bg) >= min)
+            return c;
+    }
+    return target;
+}