@taloswork/ose-shared 0.1.3 → 0.1.5

package/skills/document/assets/fonts/fonts.json

@@ -1,218 +1,316 @@
 {
- "_comment": "Single source of truth for the skill's bundled font set. Consumed by bin-src/html2pptx.mjs (base64 @font-face injection at render) and by scripts/deck-skin-samples.mjs + scripts/deck-fidelity.mjs (served from disk via page.route). Add a face HERE, drop the .woff2 beside it, and every renderer picks it up — never inline a base64 @font-face into a skin.css.",
- "cjkUnicodeRange": "U+2E80-2EFF,U+3000-303F,U+3040-30FF,U+3200-4DBF,U+4E00-9FFF,U+F900-FAFF,U+FE30-FE4F,U+FF00-FFEF",
- "cjk": [
-  {
-   "file": "NotoSansSC.woff2",
-   "families": [
-    "PingFang SC",
-    "Hiragino Sans GB",
-    "Microsoft YaHei",
-    "Noto Sans SC",
-    "Noto Sans CJK SC",
-    "Source Han Sans SC",
-    "WenQuanYi Zen Hei"
-   ]
-  },
-  {
-   "file": "NotoSerifSC.woff2",
-   "families": [
-    "Songti SC",
-    "STSong",
-    "SimSun",
-    "Noto Serif SC",
-    "Noto Serif CJK SC",
-    "Source Han Serif SC"
-   ]
-  }
- ],
- "latin": [
-  {
-   "file": "Anton-Regular.woff2",
-   "families": [
-    "Anton"
-   ],
-   "note": "Ultra-condensed display face. cinereel + ivory-gold use it for --font-head and BAKE their titles, which is why it survives into the pptx. Also staged into the xhs skill by scripts/build-xhs-skills.mjs.",
-   "license": "SIL OFL 1.1 (Google Fonts)"
-  },
-  {
-   "file": "Inter-Regular.woff2",
-   "families": [
-    "Inter"
-   ],
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "Neutral UI grotesque. swiss-grid asks for it as its whole type system, ivory-gold as --font-body. Neither OS ships it, so before this entry even the backdrop/preview render fell back to Helvetica/Arial. Their native text still does — see _scope."
-  },
-  {
-   "file": "GochiHand-Regular.woff2",
-   "families": [
-    "Gochi Hand"
-   ],
-   "license": "Apache License 2.0 (Google Fonts)",
-   "note": "Handwriting face, hand-drawn's signature marker-pen heading. Latin-only, so a CJK deck barely shows it; and hand-drawn does NOT bake its titles, so the native text layer still resolves the stack's `cursive` keyword (LibreOffice → Snell Roundhand). Bundling fixes the backdrop/preview render only — see _scope."
-  },
-  {
-   "file": "BigShouldersDisplay-Bold.woff2",
-   "families": [
-    "Big Shoulders Display"
-   ],
-   "weight": "700",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "Ultra-condensed display face, narrower and more open-countered than Anton. cinereel's --font-head; picked to match the slidescarnival music-video template this skin is modelled on. Every rule that uses it is baked."
-  },
-  {
-   "file": "Jost-Regular.woff2",
-   "families": [
-    "Jost"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "Geometric sans, cinereel's --font-body. Body copy is NOT baked (it must stay editable/searchable), so the native pptx text layer still substitutes — this face governs the backdrop and previews. See deck-design.md § Fonts."
-  },
-  {
-   "file": "Jost-SemiBold.woff2",
-   "families": [
-    "Jost"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "The 600 companion, so bold body runs (.toc-title etc.) use a real semibold instead of a synthesised smear."
-  },
-  {
-   "file": "Fraunces-SemiBold.woff2",
-   "families": [
-    "Fraunces"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "anthropic 标题。有机人文衬线,替下与 black-gold/branding 共用的 Georgia。"
-  },
-  {
-   "file": "PublicSans-Regular.woff2",
-   "families": [
-    "Public Sans"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "anthropic 正文。"
-  },
-  {
-   "file": "Manrope-Regular.woff2",
-   "families": [
-    "Manrope"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "apple 正文。"
-  },
-  {
-   "file": "Manrope-Bold.woff2",
-   "families": [
-    "Manrope"
-   ],
-   "weight": "700",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "apple 标题。几何圆润无衬线,产品发布会的舞台感。"
-  },
-  {
-   "file": "BodoniModa-SemiBold.woff2",
-   "families": [
-    "Bodoni Moda"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "black-gold 标题。高反差 didone,金融年报/奢侈品的经典。"
-  },
-  {
-   "file": "Lora-Regular.woff2",
-   "families": [
-    "Lora"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "black-gold 正文衬线。"
-  },
-  {
-   "file": "CormorantGaramond-SemiBold.woff2",
-   "families": [
-    "Cormorant Garamond"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "branding 标题。低反差优雅 garalde,品牌手册/美妆。"
-  },
-  {
-   "file": "Karla-Regular.woff2",
-   "families": [
-    "Karla"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "branding + olive-gold 正文。带点个性的 grotesque。"
-  },
-  {
-   "file": "Sora-Regular.woff2",
-   "families": [
-    "Sora"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "cool 正文。"
-  },
-  {
-   "file": "Sora-SemiBold.woff2",
-   "families": [
-    "Sora"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "cool 标题。几何科技感,替下与 olive-gold 共用的 Avenir Next。"
-  },
-  {
-   "file": "IBMPlexSans-Regular.woff2",
-   "families": [
-    "IBM Plex Sans"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "mckinsey 正文。"
-  },
-  {
-   "file": "IBMPlexSans-SemiBold.woff2",
-   "families": [
-    "IBM Plex Sans"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "mckinsey 标题。企业/咨询语气,替下与 apple/mono 共用的 Helvetica Neue。"
-  },
-  {
-   "file": "Archivo-Regular.woff2",
-   "families": [
-    "Archivo"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "mono 正文。"
-  },
-  {
-   "file": "Archivo-SemiBold.woff2",
-   "families": [
-    "Archivo"
-   ],
-   "weight": "600",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "mono 标题。骨架清晰的中性 grotesque,极简报告。"
-  },
-  {
-   "file": "Marcellus-Regular.woff2",
-   "families": [
-    "Marcellus"
-   ],
-   "weight": "400",
-   "license": "SIL OFL 1.1 (Google Fonts)",
-   "note": "olive-gold 标题。古典罗马体大写,证书/招商的仪式感。"
-  }
- ],
- "_scope": "These faces are injected as @font-face and therefore apply to the BROWSER render only — the raster backdrop, any --talos-bake:1 text, --rasterize output and styles/_samples previews. They do NOT reach the NATIVE pptx text layer: there a run carries only a typeface NAME, and the consuming app (PowerPoint / LibreOffice) substitutes whatever it has. So bundling a face makes a skin's own rendering correct, but a native title still needs --talos-bake:1 (see cinereel) or an OOXML embed via bin/pptx-embed-fonts.cjs to survive into the deck the audience opens."
+  "_comment": "Single source of truth for the skill's bundled font set. Consumed by bin-src/html2pptx.mjs (base64 @font-face injection at render) and by scripts/deck-skin-samples.mjs + scripts/deck-fidelity.mjs (served from disk via page.route). Add a face HERE, drop the .woff2 beside it, and every renderer picks it up — never inline a base64 @font-face into a skin.css. `substitutesInvisibly: true` marks a neutral grotesque: it is NOT on any OS, so the native pptx text layer swaps it for Helvetica/Arial, but the swap differs by a hair and no reader would name it — such a face may lead a skin unbaked. A serif or display face is the opposite call: bake every rule that uses it, or the audience sees a different font (deck-layouts.test.ts enforces both directions, and gen-skin refuses a family that gets it wrong).",
+  "cjkUnicodeRange": "U+2E80-2EFF,U+3000-303F,U+3040-30FF,U+3200-4DBF,U+4E00-9FFF,U+F900-FAFF,U+FE30-FE4F,U+FF00-FFEF",
+  "cjk": [
+    {
+      "file": "NotoSansSC.woff2",
+      "families": [
+        "PingFang SC",
+        "Hiragino Sans GB",
+        "Microsoft YaHei",
+        "Noto Sans SC",
+        "Noto Sans CJK SC",
+        "Source Han Sans SC",
+        "WenQuanYi Zen Hei"
+      ]
+    },
+    {
+      "file": "NotoSerifSC.woff2",
+      "families": [
+        "Songti SC",
+        "STSong",
+        "SimSun",
+        "Noto Serif SC",
+        "Noto Serif CJK SC",
+        "Source Han Serif SC"
+      ]
+    }
+  ],
+  "latin": [
+    {
+      "file": "Anton-Regular.woff2",
+      "families": [
+        "Anton"
+      ],
+      "note": "Ultra-condensed display face. cinereel + ivory-gold use it for --font-head and BAKE their titles, which is why it survives into the pptx. Also staged into the xhs skill by scripts/build-xhs-skills.mjs.",
+      "license": "SIL OFL 1.1 (Google Fonts)"
+    },
+    {
+      "file": "Inter-Regular.woff2",
+      "families": [
+        "Inter"
+      ],
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "Neutral UI grotesque. swiss-grid asks for it as its whole type system, ivory-gold as --font-body. Neither OS ships it, so before this entry even the backdrop/preview render fell back to Helvetica/Arial. Their native text still does — see _scope.",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "GochiHand-Regular.woff2",
+      "families": [
+        "Gochi Hand"
+      ],
+      "license": "Apache License 2.0 (Google Fonts)",
+      "note": "Handwriting face, hand-drawn's signature marker-pen heading. Latin-only, so a CJK deck barely shows it; and hand-drawn does NOT bake its titles, so the native text layer still resolves the stack's `cursive` keyword (LibreOffice → Snell Roundhand). Bundling fixes the backdrop/preview render only — see _scope."
+    },
+    {
+      "file": "BigShouldersDisplay-Bold.woff2",
+      "families": [
+        "Big Shoulders Display"
+      ],
+      "weight": "700",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "Ultra-condensed display face, narrower and more open-countered than Anton. cinereel's --font-head; picked to match the slidescarnival music-video template this skin is modelled on. Every rule that uses it is baked."
+    },
+    {
+      "file": "Jost-Regular.woff2",
+      "families": [
+        "Jost"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "Geometric sans, cinereel's --font-body. Body copy is NOT baked (it must stay editable/searchable), so the native pptx text layer still substitutes — this face governs the backdrop and previews. See deck-design.md § Fonts.",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Jost-SemiBold.woff2",
+      "families": [
+        "Jost"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "The 600 companion, so bold body runs (.toc-title etc.) use a real semibold instead of a synthesised smear.",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Fraunces-SemiBold.woff2",
+      "families": [
+        "Fraunces"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "anthropic 标题。有机人文衬线,替下与 black-gold/branding 共用的 Georgia。"
+    },
+    {
+      "file": "PublicSans-Regular.woff2",
+      "families": [
+        "Public Sans"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "anthropic 正文。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Manrope-Regular.woff2",
+      "families": [
+        "Manrope"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "apple 正文。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Manrope-Bold.woff2",
+      "families": [
+        "Manrope"
+      ],
+      "weight": "700",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "apple 标题。几何圆润无衬线,产品发布会的舞台感。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "BodoniModa-SemiBold.woff2",
+      "families": [
+        "Bodoni Moda"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "black-gold 标题。高反差 didone,金融年报/奢侈品的经典。"
+    },
+    {
+      "file": "Lora-Regular.woff2",
+      "families": [
+        "Lora"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "black-gold 正文衬线。"
+    },
+    {
+      "file": "CormorantGaramond-SemiBold.woff2",
+      "families": [
+        "Cormorant Garamond"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "branding 标题。低反差优雅 garalde,品牌手册/美妆。"
+    },
+    {
+      "file": "Karla-Regular.woff2",
+      "families": [
+        "Karla"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "branding + olive-gold 正文。带点个性的 grotesque。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Sora-Regular.woff2",
+      "families": [
+        "Sora"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "cool 正文。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Sora-SemiBold.woff2",
+      "families": [
+        "Sora"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "cool 标题。几何科技感,替下与 olive-gold 共用的 Avenir Next。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "IBMPlexSans-Regular.woff2",
+      "families": [
+        "IBM Plex Sans"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "mckinsey 正文。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "IBMPlexSans-SemiBold.woff2",
+      "families": [
+        "IBM Plex Sans"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "mckinsey 标题。企业/咨询语气,替下与 apple/mono 共用的 Helvetica Neue。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Archivo-Regular.woff2",
+      "families": [
+        "Archivo"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "mono 正文。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Archivo-SemiBold.woff2",
+      "families": [
+        "Archivo"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "mono 标题。骨架清晰的中性 grotesque,极简报告。",
+      "substitutesInvisibly": true
+    },
+    {
+      "file": "Marcellus-Regular.woff2",
+      "families": [
+        "Marcellus"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "olive-gold 标题。古典罗马体大写,证书/招商的仪式感。"
+    },
+    {
+      "file": "SpaceGrotesk-500.woff2",
+      "families": [
+        "Space Grotesk"
+      ],
+      "weight": "500",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "substitutesInvisibly": true,
+      "note": "Neutral-with-a-quirk grotesque (flat-sided o, angled terminals). dark-glass 的 --font-head。落到 Helvetica 只丢那点怪味,不烤。"
+    },
+    {
+      "file": "Syne-700.woff2",
+      "families": [
+        "Syne"
+      ],
+      "weight": "700",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "Extended geometric display,字宽与字重都反常规 —— memphis 的招牌。展示体,必烤。"
+    },
+    {
+      "file": "DMSerifDisplay-400.woff2",
+      "families": [
+        "DM Serif Display"
+      ],
+      "weight": "400",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "High-contrast display serif,retro-press 的标题脸。展示衬线,必烤。"
+    },
+    {
+      "file": "Quicksand-600.woff2",
+      "families": [
+        "Quicksand"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "substitutesInvisibly": true,
+      "note": "Rounded geometric sans,pastel-saas 的柔和标题。圆角是它唯一的怪味,落到 Helvetica 不至于换风格,不烤。"
+    },
+    {
+      "file": "ChakraPetch-600.woff2",
+      "families": [
+        "Chakra Petch"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "Squared techno face,neon-grid 一类硬科技族的标题脸。展示体,必烤。"
+    },
+    {
+      "file": "Lexend-500.woff2",
+      "families": [
+        "Lexend"
+      ],
+      "weight": "500",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "substitutesInvisibly": true,
+      "note": "为可读性设计的中性无衬线(字宽略放)。campus-teal 的标题脸;落到 Helvetica 只丢那点从容,不烤。"
+    },
+    {
+      "file": "Nunito-700.woff2",
+      "families": [
+        "Nunito"
+      ],
+      "weight": "700",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "substitutesInvisibly": true,
+      "note": "圆角人文无衬线,clinic-care 的标题脸。圆角是它唯一的怪味,不至于换风格,不烤。"
+    },
+    {
+      "file": "PlayfairDisplay-600.woff2",
+      "families": [
+        "Playfair Display"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "高反差过渡期衬线,wedding-blush 的标题脸。展示衬线,必烤。"
+    },
+    {
+      "file": "ZillaSlab-600.woff2",
+      "families": [
+        "Zilla Slab"
+      ],
+      "weight": "600",
+      "license": "SIL OFL 1.1 (Google Fonts)",
+      "note": "板衬线,bistro-warm 的标题脸 —— 菜单/招牌的口吻。衬线,必烤。"
+    }
+  ],
+  "_scope": "These faces are injected as @font-face and therefore apply to the BROWSER render only — the raster backdrop, any --talos-bake:1 text, --rasterize output and styles/_samples previews. They do NOT reach the NATIVE pptx text layer: there a run carries only a typeface NAME, and the consuming app (PowerPoint / LibreOffice) substitutes whatever it has. So bundling a face makes a skin's own rendering correct, but a native title still needs --talos-bake:1 (see cinereel) or an OOXML embed via bin/pptx-embed-fonts.cjs to survive into the deck the audience opens."
 }

package/skills/document/bin/html2pptx.cjs

@@ -148066,15 +148066,17 @@ async function fontManifest() {
   }
   return _fontManifest;
 }
-async function faceCss(entries, range) {
+async function faceCss(entries, range, doc) {
   const { dir } = await fontManifest();
   const rules = [];
   for (const entry of entries ?? []) {
+    const families = doc ? (entry.families ?? []).filter((f) => doc.includes(f)) : entry.families ?? [];
+    if (!families.length) continue;
     const path = (0, import_node_path.join)(dir, entry.file);
     if (!(0, import_node_fs.existsSync)(path)) continue;
     const b64 = (await (0, import_promises.readFile)(path).catch(() => null))?.toString("base64");
     if (!b64) continue;
-    for (const family of entry.families ?? []) {
+    for (const family of families) {
       rules.push(
         `@font-face{font-family:'${family}';src:local('${family}'),url(data:font/woff2;base64,${b64}) format('woff2');${entry.weight ? `font-weight:${entry.weight};` : ""}${range ? `unicode-range:${range};` : ""}font-display:swap}`
       );
@@ -148083,10 +148085,10 @@ async function faceCss(entries, range) {
   return rules.join("");
 }
 var _cjkFontCss;
-async function cjkFontFaceCss() {
+async function cjkFontFaceCss(doc) {
   if (_cjkFontCss === void 0) {
     const m = await fontManifest();
-    _cjkFontCss = await faceCss(m.cjk, m.cjkUnicodeRange);
+    _cjkFontCss = await faceCss(m.cjk, m.cjkUnicodeRange, doc);
   }
   return _cjkFontCss;
 }
@@ -148317,7 +148319,7 @@ async function main() {
     if (skinChart1) rawInlined = rawInlined.replaceAll("__CHART1__", skinChart1);
   }
   const tw = await tailwindCss();
-  const cjk = !hasService && CJK_RE2.test(rawInlined) ? await cjkFontFaceCss() : "";
+  const cjk = !hasService && CJK_RE2.test(rawInlined) ? await cjkFontFaceCss(rawInlined + skinCss + themeCss + SKELETON_CSS) : "";
   const latin = await latinFontFaceCss(rawInlined + skinCss);
   const fontCss = cjk + latin;
   const html = injectHead(rawInlined, `${fontCss ? `<style>${fontCss}</style>` : ""}${tw ? `<style>${tw}</style>` : ""}<style>${themeCss}${SKELETON_CSS}${skinCss}</style>`);