@taloswork/ose-shared 0.1.5 → 0.1.7

package/skills/document/media-styles/illustrated.css

@@ -0,0 +1,2 @@
+:root{--cmp-media-radius:32px;--cmp-media-fit:contain;--cmp-media-filter:none;--cmp-media-shadow:none}
+.media-frame,.media-cutout{background:color-mix(in srgb,var(--accent) 10%,transparent);border:1px dashed var(--accent);padding:14px}

package/skills/document/media-styles/spatial-3d.css

@@ -0,0 +1,3 @@
+:root{--cmp-media-radius:28px;--cmp-media-fit:contain;--cmp-media-filter:saturate(1.08);--cmp-media-shadow:18px 28px 48px rgba(0,0,0,.24)}
+.media-cutout,.media-frame{transform:perspective(900px) rotateY(-7deg) rotateX(3deg);border:1px solid color-mix(in srgb,var(--accent) 45%,var(--hair));background:color-mix(in srgb,var(--accent) 8%,var(--slide-bg))}
+.media-cutout:after,.media-frame:after{content:"";position:absolute;inset:8%;border-radius:50%;background:var(--accent);filter:blur(42px);opacity:.16;z-index:-1}

package/skills/document/motion/mckinsey-photo.json

@@ -0,0 +1,22 @@
+{
+  "transition": {
+    "effect": "fade",
+    "durMs": 320
+  },
+  "entrance": {
+    "cover": [
+      {
+        "sel": ".overlay-title",
+        "anim": "fade-up",
+        "dur": 620
+      }
+    ],
+    "cards": [
+      {
+        "sel": ".card",
+        "anim": "appear",
+        "stagger": 90
+      }
+    ]
+  }
+}

package/skills/document/motion/prismatic-3d.json

@@ -0,0 +1,31 @@
+{
+  "transition": {
+    "effect": "push",
+    "dir": "l",
+    "durMs": 420
+  },
+  "entrance": {
+    "cover": [
+      {
+        "sel": ".cover-sub",
+        "anim": "fade-up",
+        "dur": 620,
+        "delay": 150
+      }
+    ],
+    "section": [
+      {
+        "sel": ".section-desc",
+        "anim": "fly-up",
+        "delay": 100
+      }
+    ],
+    "stat": [
+      {
+        "sel": ".stat-note",
+        "anim": "appear",
+        "delay": 220
+      }
+    ]
+  }
+}

package/skills/document/packs/README.md

@@ -1,9 +1,11 @@
-# packs —— 模板包（pack）
+# packs —— 旧版组合包（兼容保留）
 
-pack = 实现完整 class 契约的 `pack.css` **加上**一组包专属签名版式。
+V1 pack = `pack.css` **加上**一组包专属签名版式。这个耦合模型为旧 deck
+保留；新 deck 应把视觉 Theme 与 `layoutPack` 分开声明，见 `../theme-system.md`。
 
 因为 `pack.css` 实现了契约，共享 `layouts/` 的全部结构版式在包内天然可用；
-包自带的 `layouts/<id>.tpl` 与共享同名时**包内优先**（同名遮蔽）。
+旧 spec 未写 `layoutPack` 时，包自带的同名版式仍**包内优先**；新 spec 可用
+`layoutPack:"none"` 只取该包的视觉，或给另一个 style 显式配这个 layout pack。
 
 目录结构见 `docs/superpowers/specs/2026-09-01-ppt-tpl-prod-design.md` §5.3。
 
@@ -20,6 +22,8 @@ pack = 实现完整 class 契约的 `pack.css` **加上**一组包专属签名
 |---|---|---|---|
 | **board-brief** 董事会简报 | biz-premium | `cover`（顶部密级条 + 标题压到中轴以下，共享版靠留白撑气势）· `toc-agenda`（编号/议题/时长的表格式议程，共享版是卡片列表） | 四角角标 |
 | **press-room** 报刊头版 | editorial | `cover`（报头通栏 + 三分之二版大标题）· `section`（左栏轴 + 并列刊号，共享版是幽灵数字压在标题后）· `quote`（左侧巨型引号 + 右侧不对称引文，共享版是居中） | 顶部报头条 |
+| **prismatic-3d** 棱镜空间 | tech-future | `cover`（左侧超大标题 + 右侧空间棱面）· `section-image`（三角媒体舞台 + 偏轴章节）· `big-stat`（巨型数字 + 角面地平线） | 紫黑棱面 + `spatial-3d` 媒体 |
+| **mckinsey-photo** 咨询影像 | biz-premium | `cover` / `cover-image`（全幅企业照片 + 信息导轨）· `image-left`（55/45 图证分栏）· `numbered-brief`（渐变结论面板） | mckinsey 式咨询结构 + 照片叙事 |
 
 ## 新增一个包
 

package/skills/document/packs/mckinsey-photo/backdrop.html

@@ -0,0 +1,6 @@
+<!-- generated by scripts/ppt-tpl/gen-skin.mjs — signature: crop-marks -->
+<div style="position:absolute;inset:0;background:#FAFDFF"></div>
+<div style="position:absolute;left:44px;top:44px;border-left:1px solid var(--hair);border-top:1px solid var(--hair);width:26px;height:26px;pointer-events:none"></div>
+<div style="position:absolute;right:44px;top:44px;border-right:1px solid var(--hair);border-top:1px solid var(--hair);width:26px;height:26px;pointer-events:none"></div>
+<div style="position:absolute;left:44px;bottom:44px;border-left:1px solid var(--hair);border-bottom:1px solid var(--hair);width:26px;height:26px;pointer-events:none"></div>
+<div style="position:absolute;right:44px;bottom:44px;border-right:1px solid var(--hair);border-bottom:1px solid var(--hair);width:26px;height:26px;pointer-events:none"></div>

package/skills/document/packs/mckinsey-photo/layouts/cover-image.tpl

@@ -0,0 +1,5 @@
+<!-- packs/mckinsey-photo/layouts/cover-image — full-bleed corporate image with disciplined information rail. -->
+<section class="slide" data-layout="cover-image" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div class="media-frame" style="position:absolute;inset:0;border:0;border-radius:0;display:flex;align-items:center;justify-content:center;background:linear-gradient(120deg,var(--title),var(--c2))"><span class="surface-label" style="color:var(--slide-bg)">{{image_label|替换为全幅企业影像}}</span></div><div style="position:absolute;inset:0;background:linear-gradient(90deg,color-mix(in srgb,var(--title) 92%,transparent) 0%,color-mix(in srgb,var(--title) 72%,transparent) 46%,transparent 78%)"></div>
+<div class="eyebrow" style="position:absolute;left:76px;top:88px;color:var(--slide-bg);letter-spacing:.24em">{{eyebrow|EXECUTIVE PERSPECTIVE}}</div><h1 class="overlay-title" style="position:absolute;left:72px;top:186px;width:700px;font-size:calc(76px * var(--type-scale,1));line-height:1.04;color:var(--slide-bg)">{{title|让战略<br>看得见}}</h1><p class="overlay-sub" style="position:absolute;left:76px;top:424px;width:530px;font-size:calc(20px * var(--type-scale,1));line-height:1.55;color:color-mix(in srgb,var(--slide-bg) 82%,transparent)">{{subtitle|用真实场景承载结论，用咨询结构组织证据。}}</p>
+</section>

package/skills/document/packs/mckinsey-photo/layouts/cover.tpl

@@ -0,0 +1,5 @@
+<!-- packs/mckinsey-photo/layouts/cover — photo-led executive cover using the portable shared cover slots. -->
+<section class="slide" data-layout="cover" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div class="media-frame" aria-hidden="true" style="position:absolute;inset:0;border:0;border-radius:0;background:linear-gradient(120deg,var(--title),var(--c2))"></div><div aria-hidden="true" style="position:absolute;inset:0;background:linear-gradient(90deg,color-mix(in srgb,var(--title) 94%,transparent) 0%,color-mix(in srgb,var(--title) 70%,transparent) 48%,transparent 80%)"></div>
+<div class="eyebrow" style="position:absolute;left:76px;top:88px;color:var(--slide-bg);letter-spacing:.24em">{{eyebrow|EXECUTIVE PERSPECTIVE}}</div><h1 class="cover-title" style="position:absolute;left:72px;top:184px;width:700px;font-size:calc(76px * var(--type-scale,1));line-height:1.04;color:var(--slide-bg)">{{title|让战略<br>看得见}}</h1><p class="cover-sub" style="position:absolute;left:76px;top:424px;width:530px;font-size:calc(20px * var(--type-scale,1));line-height:1.55;color:color-mix(in srgb,var(--slide-bg) 82%,transparent)">{{subtitle|用真实场景承载结论，用咨询结构组织证据。}}</p>
+<div style="position:absolute;left:76px;bottom:52px;color:color-mix(in srgb,var(--slide-bg) 72%,transparent);font-size:calc(12px * var(--type-scale,1))">{{presenter|TALOS ADVISORY}}</div><div style="position:absolute;left:470px;bottom:52px;color:color-mix(in srgb,var(--slide-bg) 72%,transparent);font-size:calc(12px * var(--type-scale,1))">{{date|2026}}</div></section>

package/skills/document/packs/mckinsey-photo/layouts/image-left.tpl

@@ -0,0 +1,5 @@
+<!-- packs/mckinsey-photo/layouts/image-left — 55/45 split photo and evidence column. -->
+<section class="slide" data-layout="image-left" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div class="media-frame" style="position:absolute;left:0;top:0;width:676px;height:720px;border:0;border-radius:0;display:flex;align-items:center;justify-content:center;background:linear-gradient(145deg,var(--hair),color-mix(in srgb,var(--accent) 18%,var(--slide-bg)))"><span class="surface-label">{{image_label|替换为案例现场照片}}</span></div>
+<div style="position:absolute;left:676px;right:0;top:0;bottom:0;padding:76px 72px 64px 64px"><div class="eyebrow">{{eyebrow|CASE STUDY}}</div><h2 class="deck-title" style="font-size:calc(48px * var(--type-scale,1));line-height:1.08;margin-top:24px">{{title|从现场问题<br>走到业务结果}}</h2><div class="rule" style="height:1px;margin:34px 0 22px"></div><div class="card" style="padding:18px 20px;margin-bottom:14px"><b class="card-title">{{card1_title|背景}}</b><p class="card-body" style="margin-top:6px;line-height:1.5">{{card1_body|一句交代客户与业务语境。}}</p></div><div class="card" style="padding:18px 20px;margin-bottom:14px"><b class="card-title">{{card2_title|行动}}</b><p class="card-body" style="margin-top:6px;line-height:1.5">{{card2_body|一句说明关键方案与路径。}}</p></div><div class="card" style="padding:18px 20px"><b class="card-title">{{card3_title|结果}}</b><p class="card-body" style="margin-top:6px;line-height:1.5">{{card3_body|一句量化最终影响。}}</p></div></div>
+<div class="deck-footer" style="position:absolute;left:740px;bottom:28px">{{footer|CASE STUDY}}</div><div class="deck-pageno" style="position:absolute;right:72px;bottom:28px">{{pageno|02}}</div></section>

package/skills/document/packs/mckinsey-photo/layouts/numbered-brief.tpl

@@ -0,0 +1,5 @@
+<!-- packs/mckinsey-photo/layouts/numbered-brief — gradient evidence panel for executive summaries. -->
+<section class="slide" data-layout="numbered-brief" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div style="position:absolute;left:0;top:0;bottom:0;width:520px;padding:72px 64px;background:linear-gradient(150deg,var(--title),color-mix(in srgb,var(--accent) 54%,var(--title)));color:var(--slide-bg)"><div class="num-disc" style="width:56px;height:56px;display:flex;align-items:center;justify-content:center;font-weight:800">01</div><h2 class="deck-title" style="color:var(--slide-bg);font-size:calc(52px * var(--type-scale,1));line-height:1.08;margin-top:42px">{{title|管理层<br>先看结论}}</h2><p style="font-size:calc(17px * var(--type-scale,1));line-height:1.7;margin-top:34px;color:color-mix(in srgb,var(--slide-bg) 78%,transparent)">{{para1|把最重要的判断放进一个稳定、克制的色场。}}</p><div style="position:absolute;left:64px;right:64px;bottom:72px;border-left:3px solid var(--accent);padding-left:18px;font-size:calc(14px * var(--type-scale,1));line-height:1.55">{{quote|“影像提供语境，结构负责说服。”}}</div></div>
+<div style="position:absolute;left:588px;right:76px;top:86px"><div class="eyebrow">{{source_label|EXECUTIVE BRIEF}}</div><h3 class="num-item-title" style="font-size:calc(25px * var(--type-scale,1));margin-top:54px">{{right_title|三条必须带走的信息}}</h3><div style="margin-top:28px;display:grid;gap:18px"><div class="card" style="padding:20px 24px"><b class="card-title">{{item1_title|增长来自核心客户扩张}}</b></div><div class="card" style="padding:20px 24px"><b class="card-title">{{item2_title|交付周期缩短至六周}}</b></div><div class="card" style="padding:20px 24px"><b class="card-title">{{item3_title|组织能力已经可复制}}</b></div><div class="card" style="padding:20px 24px"><b class="card-title">{{item4_title|下一阶段聚焦规模化}}</b></div></div><p class="brief-quote-attr" style="margin-top:24px">{{source_note|来源：项目数据与客户访谈}}</p></div><div class="deck-pageno" style="position:absolute;right:76px;bottom:30px">{{pageno|03}}</div>
+</section>

package/skills/document/packs/mckinsey-photo/pack.css

@@ -0,0 +1,27 @@
+/* packs/mckinsey-photo — generated by scripts/ppt-tpl/gen-skin.mjs from ppt-tpl/families/mckinsey-photo/family.json.
+   手改会在下次生成时丢失：要改就改 family.json。 */
+:root{
+  --space-scale:0.88; --type-scale:0.95;
+  --accent:#1074A7; --c1:#1074A7; --c2:#645DD4; --c3:#C22B93; --c4:#D02841; --chart-1:#1074A7;
+  --title:#003044; --body:#375366; --muted:#687987; --foot:#687987;
+  --hair:#CFDCE6; --card-radius:4px;
+  --font-head:'IBM Plex Sans','Noto Sans SC',sans-serif;
+  --font-body:'IBM Plex Sans','Noto Sans SC',sans-serif;
+  --title-color:#003044; --body-color:#375366; --slide-bg:#FAFDFF; --font-heading:var(--font-head);
+}
+.slide{background:#FAFDFF;color:var(--body);font-family:var(--font-body)}
+.slide-backdrop{position:absolute;inset:0;background:#FAFDFF}
+.deck-header,.deck-footer,.deck-pageno{color:var(--muted)}
+.rule,.rule-foot{background:var(--hair)}
+.eyebrow{color:var(--accent);letter-spacing:.22em;font-weight:700}
+.accent-bar{background:var(--accent)}
+.deck-title,.cover-title,.section-title,.ending-title{color:var(--title);font-family:var(--font-head);font-weight:700}
+.cover-sub,.ending-sub,.section-desc{color:var(--muted)}
+.card{border-radius:var(--card-radius);background:transparent;border:1px solid var(--hair)}
+.card-idx{color:var(--muted)} .card-body{color:var(--body)} .card-title{color:var(--title)}
+.card-grid .card:nth-child(4n+1) .card-rail,.card-grid .card:nth-child(4n+1) .card-dot{background:var(--c1)}
+.card-grid .card:nth-child(4n+2) .card-rail,.card-grid .card:nth-child(4n+2) .card-dot{background:var(--c2)}
+.card-grid .card:nth-child(4n+3) .card-rail,.card-grid .card:nth-child(4n+3) .card-dot{background:var(--c3)}
+.card-grid .card:nth-child(4n+4) .card-rail,.card-grid .card:nth-child(4n+4) .card-dot{background:var(--c4)}
+.kpi-num,.stat-num{color:var(--title);font-family:var(--font-head)}
+.kpi-label,.stat-unit{color:var(--muted)} .stat-lead{color:var(--title)} .stat-note{color:var(--body)}

package/skills/document/packs/prismatic-3d/backdrop.html

@@ -0,0 +1,4 @@
+<!-- generated by scripts/ppt-tpl/gen-skin.mjs — signature: diagonal-band -->
+<div style="position:absolute;inset:0;background:#270E28"></div>
+<div style="position:absolute;right:-60px;top:-40px;width:260px;height:820px;background:var(--accent);opacity:.14;transform:rotate(18deg);pointer-events:none"></div>
+<div style="position:absolute;right:96px;top:-40px;width:2px;height:820px;background:var(--accent);opacity:.5;transform:rotate(18deg);pointer-events:none"></div>

package/skills/document/packs/prismatic-3d/layouts/big-stat.tpl

@@ -0,0 +1,6 @@
+<!-- packs/prismatic-3d/layouts/big-stat — oversized metric held by an angular horizon. -->
+<section class="slide" data-layout="big-stat" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div aria-hidden="true" style="position:absolute;right:-24px;bottom:-90px;width:720px;height:510px;background:linear-gradient(132deg,color-mix(in srgb,var(--c3) 72%,transparent),color-mix(in srgb,var(--accent) 24%,transparent));clip-path:polygon(26% 0,100% 18%,82% 100%,0 72%);opacity:.52"></div>
+<div class="eyebrow" style="position:absolute;left:82px;top:72px;letter-spacing:.32em">{{eyebrow|SIGNAL}}</div><h2 class="deck-title" style="position:absolute;left:78px;top:108px;width:640px;font-size:calc(52px * var(--type-scale,1));line-height:1.08">{{title|一个数字，建立全场判断}}</h2>
+<div class="stat-num" style="position:absolute;left:74px;top:276px;font-size:calc(230px * var(--type-scale,1));line-height:.78;letter-spacing:-5px;display:flex;align-items:baseline">{{stat|72}}<span class="stat-unit" style="font-size:calc(34px * var(--type-scale,1));font-weight:700;letter-spacing:0;margin-left:18px">{{unit|%}}</span></div>
+<div style="position:absolute;right:84px;top:246px;width:360px"><h3 class="stat-lead" style="font-size:calc(26px * var(--type-scale,1));line-height:1.3">{{lead|关键流程已经自动闭环}}</h3><p class="stat-note" style="font-size:calc(17px * var(--type-scale,1));line-height:1.65;margin-top:22px">{{note|把数据放回语境，让受众知道这个变化为何重要。}}</p></div><div class="deck-footer" style="position:absolute;left:82px;bottom:34px">{{footer|PRISMATIC 3D}}</div><div class="deck-pageno" style="position:absolute;right:82px;bottom:34px">{{pageno|03}}</div></section>

package/skills/document/packs/prismatic-3d/layouts/cover.tpl

@@ -0,0 +1,9 @@
+<!-- packs/prismatic-3d/layouts/cover — original faceted hero; uses only shared cover slots. -->
+<section class="slide" data-layout="cover" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div aria-hidden="true" style="position:absolute;right:-80px;top:-90px;width:590px;height:620px;background:linear-gradient(145deg,var(--c2),var(--accent));clip-path:polygon(48% 0,100% 22%,86% 80%,35% 100%,0 54%);opacity:.32;transform:rotate(8deg)"></div>
+<div aria-hidden="true" style="position:absolute;right:140px;top:120px;width:360px;height:360px;background:linear-gradient(145deg,var(--c3),var(--c1));clip-path:polygon(50% 0,100% 100%,0 72%);opacity:.74;filter:drop-shadow(26px 34px 40px color-mix(in srgb,var(--accent) 28%,transparent));transform:perspective(800px) rotateY(-18deg) rotateZ(7deg)"></div>
+<div class="eyebrow" style="position:absolute;left:82px;top:84px;font-size:calc(13px * var(--type-scale,1));letter-spacing:.34em">{{eyebrow|PRISMATIC / 01}}</div>
+<h1 class="cover-title" style="position:absolute;left:78px;top:172px;width:700px;font-size:calc(96px * var(--type-scale,1));line-height:.94;letter-spacing:-1px">{{title|空间智能<br>进入现实}}</h1>
+<p class="cover-sub" style="position:absolute;left:82px;top:444px;width:520px;font-size:calc(20px * var(--type-scale,1));line-height:1.55">{{subtitle|用清晰的结构讲述复杂技术、产品与未来趋势。}}</p>
+<div class="rule" style="position:absolute;left:82px;bottom:88px;width:520px;height:1px"></div><div class="deck-footer" style="position:absolute;left:82px;bottom:56px;font-size:calc(12px * var(--type-scale,1))">{{presenter|TALOS STUDIO}}</div><div class="deck-footer" style="position:absolute;left:470px;bottom:56px;font-size:calc(12px * var(--type-scale,1))">{{date|2026}}</div>
+</section>

package/skills/document/packs/prismatic-3d/layouts/section-image.tpl

@@ -0,0 +1,6 @@
+<!-- packs/prismatic-3d/layouts/section-image — triangular media stage + offset chapter title. -->
+<section class="slide" data-layout="section-image" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
+<div class="media-frame" style="position:absolute;left:-36px;top:72px;width:610px;height:576px;display:flex;align-items:center;justify-content:center;background:linear-gradient(145deg,color-mix(in srgb,var(--c2) 42%,var(--slide-bg)),color-mix(in srgb,var(--accent) 18%,var(--slide-bg)))"><span class="surface-label">{{image_label|替换为章节主视觉}}</span></div>
+<div class="section-ghost" style="position:absolute;right:72px;top:78px;font-size:calc(172px * var(--type-scale,1));line-height:1;font-family:var(--font-head);color:color-mix(in srgb,var(--accent) 18%,transparent)">{{index|01}}</div>
+<div class="eyebrow" style="position:absolute;left:660px;top:238px;font-size:calc(13px * var(--type-scale,1));letter-spacing:.32em">{{eyebrow|CHAPTER}}</div><h2 class="section-title" style="position:absolute;left:654px;right:76px;top:278px;font-size:calc(66px * var(--type-scale,1));line-height:1.02">{{title|构建空间<br>叙事}}</h2><p class="section-desc" style="position:absolute;left:660px;right:98px;top:454px;font-size:calc(18px * var(--type-scale,1));line-height:1.6">{{desc|让图像、数字和观点在同一条视觉轴线上展开。}}</p>
+<div class="deck-footer" style="position:absolute;left:660px;bottom:36px">{{footer|PRISMATIC 3D}}</div><div class="deck-pageno" style="position:absolute;right:80px;bottom:36px">{{pageno|02}}</div></section>

package/skills/document/packs/prismatic-3d/pack.css

@@ -0,0 +1,28 @@
+/* packs/prismatic-3d — generated by scripts/ppt-tpl/gen-skin.mjs from ppt-tpl/families/prismatic-3d/family.json.
+   手改会在下次生成时丢失：要改就改 family.json。 */
+:root{
+  --space-scale:0.98; --type-scale:1.06;
+  --accent:#E168CF; --c1:#E168CF; --c2:#8E88FA; --c3:#099DEE; --c4:#1FA3C4; --chart-1:#E168CF;
+  --title:#F8F1FA; --body:#C8BDCC; --muted:#938898; --foot:#938898;
+  --hair:#523A52; --card-radius:4px;
+  --font-head:'Big Shoulders Display','Noto Sans SC',sans-serif;
+  --font-body:'Manrope','Noto Sans SC',sans-serif;
+  --title-color:#F8F1FA; --body-color:#C8BDCC; --slide-bg:#270E28; --font-heading:var(--font-head);
+}
+.slide{background:#270E28;color:var(--body);font-family:var(--font-body)}
+.slide-backdrop{position:absolute;inset:0;background:#270E28}
+.deck-header,.deck-footer,.deck-pageno{color:var(--muted)}
+.rule,.rule-foot{background:var(--hair)}
+.eyebrow{color:var(--accent);letter-spacing:.22em;font-weight:700}
+.accent-bar{background:var(--accent)}
+.deck-title,.cover-title,.section-title,.ending-title{color:var(--title);font-family:var(--font-head);font-weight:700;--talos-bake:1}
+.cover-sub,.ending-sub,.section-desc{color:var(--muted)}
+.card{border-radius:var(--card-radius);background:transparent;border:1px solid var(--hair)}
+.card-idx{color:var(--muted)} .card-body{color:var(--body)} .card-title{color:var(--title)}
+.card-grid .card:nth-child(4n+1) .card-rail,.card-grid .card:nth-child(4n+1) .card-dot{background:var(--c1)}
+.card-grid .card:nth-child(4n+2) .card-rail,.card-grid .card:nth-child(4n+2) .card-dot{background:var(--c2)}
+.card-grid .card:nth-child(4n+3) .card-rail,.card-grid .card:nth-child(4n+3) .card-dot{background:var(--c3)}
+.card-grid .card:nth-child(4n+4) .card-rail,.card-grid .card:nth-child(4n+4) .card-dot{background:var(--c4)}
+.kpi-num,.stat-num{color:var(--title);font-family:var(--font-head);--talos-bake:1}
+.kpi-label,.stat-unit{color:var(--muted)} .stat-lead{color:var(--title)} .stat-note{color:var(--body)}
+.media-frame,.media-cutout{border-radius:0;clip-path:polygon(12% 0,100% 0,88% 100%,0 82%);border:1px solid var(--accent)}

package/skills/document/recipes/agency-pitch.json

@@ -0,0 +1,13 @@
+{
+  "id": "agency-pitch",
+  "name_cn": "服务提案",
+  "slides": [
+    {"intent":"cover","required":true},
+    {"intent":"problem","required":true},
+    {"intent":"solution","required":true},
+    {"intent":"customer-proof","required":true},
+    {"intent":"pricing","required":true},
+    {"intent":"team","required":false},
+    {"intent":"close","required":true}
+  ]
+}

package/skills/document/recipes/product-launch.json

@@ -0,0 +1,13 @@
+{
+  "id": "product-launch",
+  "name_cn": "产品发布",
+  "slides": [
+    {"intent":"cover","required":true},
+    {"intent":"problem","required":true},
+    {"intent":"solution","required":true},
+    {"intent":"product-demo","required":true},
+    {"intent":"customer-proof","required":false},
+    {"intent":"pricing","required":false},
+    {"intent":"close","required":true}
+  ]
+}

package/skills/document/recipes/startup-fundraising.json

@@ -0,0 +1,19 @@
+{
+  "id": "startup-fundraising",
+  "name_cn": "创业融资",
+  "slides": [
+    {"intent":"cover","required":true},
+    {"intent":"problem","required":true},
+    {"intent":"solution","required":true},
+    {"intent":"product-demo","required":true},
+    {"intent":"market-size","required":true},
+    {"intent":"traction","required":true},
+    {"intent":"business-model","required":true},
+    {"intent":"competition","required":true},
+    {"intent":"go-to-market","required":true},
+    {"intent":"financials","required":false},
+    {"intent":"team","required":true},
+    {"intent":"funding-ask","required":true},
+    {"intent":"close","required":true}
+  ]
+}

package/skills/document/styles/README.md

@@ -1,16 +1,23 @@
-# Skin catalog (styles) — pick ONE per deck
+# Legacy skin catalog + Theme V2 family paint
+
+`styles/` remains the stable V1 paint layer and public style-id backing store. Modern decks
+opt into the complete Theme V2 composition through `../theme-system.json`; the 13 entries
+in catalog collection `original-13` are frozen to V1 at commit `7306d8e5`. Do not move or
+rename these directories. See `../theme-system.md` for component/media/art-direction composition and
+the backward-compatibility contract.
 
 **族名单的真源是 `catalog.json`**（groups + entries），本文件是人读的说明；新增族
 两边都要更新。`verify-catalog.mjs` **不读本文件** —— 它比对的是 `catalog.json`
 与磁盘（样图/CSS/motion 是否存在、`styles/<id>` 目录有没有漏登记、oneliner 有没有
 超长），所以"目录建了但没登记"抓得住，"登记了但本 README 忘了写"抓不住，只能靠人。
 
-A **skin** = the paint (colors + fonts + design tokens) applied to structure-only
-`layouts/*.tpl` at render time via `--style <name>`. Pick ONE skin for the whole
-deck by vibe/scenario; never mix. Each skin fully defines the class contract, so any
-layout renders in any skin — see `layouts/README.md` for the current count and index.
+A V1 **skin** = family paint (colors + fonts + background + core tokens). Theme V2 keeps
+that asset intact and adds a component profile, media treatment and art direction. Pick one family
+for the whole deck; media treatment may be overridden without changing the family.
+
+Modern: `html2pptx deck.html out.pptx --style <name> --theme-v2 [--media-style <id>] [--backdrop <variant>]`
 
-`html2pptx deck.html out.pptx --style <name> [--backdrop <variant>]`
+Initial classic: `html2pptx deck.html out.pptx --style <name> [--backdrop <variant>]`
 
 ## The skins
 

package/skills/document/styles/_contract-defaults.css

@@ -26,7 +26,7 @@
      .cmp-col--rec 的 box-shadow（4/39 —— cinereel 与 magazine-ink 没写）。
    保留下来的 `.cmp-col--rec{border}` 实测 0/39：没写 border 的 swiss-grid 在自己的
    `.cmp-col` 规则里定了边（同特异性、位置在后），仍然赢过兜底。
-   改完必须重跑 `node scripts/deck-fidelity.mjs`（它现在会注入本文件，此前不注入，
+   改完必须重跑 `node scripts/deck/deck-fidelity.mjs`（它现在会注入本文件，此前不注入，
    所以这个文件曾经完全在像素闸门的视野之外），并按
    `.claude/skills/ppt-tpl-prod/SKILL.md`"改 _contract-defaults.css"一节做
    注入/不注入的对照渲染 —— deck-fidelity 的 32x18 签名对这类细微改动不够敏感。 */

package/skills/document/styles/dark-glass/backdrop.html

@@ -1,4 +1,8 @@
-<!-- generated by scripts/ppt-tpl/gen-skin.mjs — signature: corner-marks -->
+<!-- generated by scripts/ppt-tpl/gen-skin.mjs — signature: rail-dots -->
 <div style="position:absolute;inset:0;background:#1A252B"></div>
-<div style="position:absolute;left:56px;top:56px;border-left:2px solid var(--accent);border-top:2px solid var(--accent);width:34px;height:34px;pointer-events:none"></div>
-<div style="position:absolute;right:56px;bottom:56px;border-right:2px solid var(--accent);border-bottom:2px solid var(--accent);width:34px;height:34px;pointer-events:none"></div>
+<div style="position:absolute;left:68px;top:104px;bottom:92px;width:2px;background:var(--hair);pointer-events:none"></div>
+<div style="position:absolute;left:69px;top:150px;width:12px;height:12px;border-radius:50%;background:var(--accent);transform:translate(-50%,-50%);pointer-events:none"></div>
+<div style="position:absolute;left:69px;top:242px;width:8px;height:8px;border-radius:50%;background:var(--hair);transform:translate(-50%,-50%);pointer-events:none"></div>
+<div style="position:absolute;left:69px;top:334px;width:8px;height:8px;border-radius:50%;background:var(--hair);transform:translate(-50%,-50%);pointer-events:none"></div>
+<div style="position:absolute;left:69px;top:426px;width:8px;height:8px;border-radius:50%;background:var(--hair);transform:translate(-50%,-50%);pointer-events:none"></div>
+<div style="position:absolute;left:69px;top:518px;width:8px;height:8px;border-radius:50%;background:var(--hair);transform:translate(-50%,-50%);pointer-events:none"></div>

package/skills/document/styles/dark-glass/skin.css

@@ -25,3 +25,4 @@
 .card-grid .card:nth-child(4n+4) .card-rail,.card-grid .card:nth-child(4n+4) .card-dot{background:var(--c4)}
 .kpi-num,.stat-num{color:var(--title);font-family:var(--font-head)}
 .kpi-label,.stat-unit{color:var(--muted)} .stat-lead{color:var(--title)} .stat-note{color:var(--body)}
+.media-frame,.media-cutout{border-radius:50% 50% 0 0 / 62% 62% 0 0;border-bottom:6px solid var(--accent)}

package/skills/document/styles/portfolio-noir/skin.css

@@ -25,3 +25,6 @@
 .card-grid .card:nth-child(4n+4) .card-rail,.card-grid .card:nth-child(4n+4) .card-dot{background:var(--c4)}
 .kpi-num,.stat-num{color:var(--title);font-family:var(--font-head)}
 .kpi-label,.stat-unit{color:var(--muted)} .stat-lead{color:var(--title)} .stat-note{color:var(--body)}
+.badge,.tag{border-radius:7px 7px 7px 1px;background:var(--accent);border-color:var(--accent);color:var(--slide-bg)}
+.quote-card{position:relative;background:color-mix(in srgb,var(--accent) 12%,var(--slide-bg));border:1px solid var(--accent);overflow:visible}
+.quote-card:after{content:"";position:absolute;left:30px;bottom:-15px;border-top:15px solid var(--accent);border-right:18px solid transparent}

package/skills/document/theme-system.json

@@ -0,0 +1,68 @@
+{
+  "version": 2,
+  "componentBase": "components/base.css",
+  "artBase": "art-directions/base.css",
+  "componentProfiles": {
+    "clean": "components/profiles/clean.css",
+    "glass": "components/profiles/glass.css",
+    "editorial": "components/profiles/editorial.css",
+    "poster": "components/profiles/poster.css",
+    "organic": "components/profiles/organic.css",
+    "luxury": "components/profiles/luxury.css"
+  },
+  "mediaStyles": {
+    "clean-product": "media-styles/clean-product.css",
+    "device-stage": "media-styles/device-stage.css",
+    "editorial-photo": "media-styles/editorial-photo.css",
+    "cutout-collage": "media-styles/cutout-collage.css",
+    "illustrated": "media-styles/illustrated.css",
+    "cinematic": "media-styles/cinematic.css",
+    "spatial-3d": "media-styles/spatial-3d.css"
+  },
+  "artDirections": {
+    "geometric-pop": "art-directions/geometric-pop.css",
+    "gradient-mesh": "art-directions/gradient-mesh.css",
+    "editorial-cut": "art-directions/editorial-cut.css",
+    "collage-paper": "art-directions/collage-paper.css",
+    "illustrated-doodle": "art-directions/illustrated-doodle.css",
+    "cinematic-depth": "art-directions/cinematic-depth.css",
+    "luxury-ornament": "art-directions/luxury-ornament.css",
+    "technical-grid": "art-directions/technical-grid.css",
+    "maximalist-blocks": "art-directions/maximalist-blocks.css"
+  },
+  "bindings": {
+    "cool": {"componentProfile":"glass","mediaStyle":"device-stage","artDirection":"gradient-mesh"},
+    "neon-cyber": {"componentProfile":"glass","mediaStyle":"cinematic","artDirection":"cinematic-depth"},
+    "prismatic-3d": {"componentProfile":"glass","mediaStyle":"spatial-3d","artDirection":"cinematic-depth"},
+    "swiss-grid": {"componentProfile":"clean","mediaStyle":"clean-product","artDirection":"geometric-pop"},
+    "black-gold": {"componentProfile":"luxury","mediaStyle":"cinematic","artDirection":"luxury-ornament"},
+    "olive-gold": {"componentProfile":"luxury","mediaStyle":"editorial-photo","artDirection":"luxury-ornament"},
+    "mckinsey": {"componentProfile":"clean","mediaStyle":"clean-product","artDirection":"editorial-cut"},
+    "mckinsey-photo": {"componentProfile":"clean","mediaStyle":"editorial-photo","artDirection":"editorial-cut"},
+    "apple": {"componentProfile":"clean","mediaStyle":"device-stage","artDirection":"gradient-mesh"},
+    "mono": {"componentProfile":"clean","mediaStyle":"editorial-photo","artDirection":"editorial-cut"},
+    "ivory-gold": {"componentProfile":"luxury","mediaStyle":"editorial-photo","artDirection":"luxury-ornament"},
+    "magazine-ink": {"componentProfile":"editorial","mediaStyle":"editorial-photo","artDirection":"editorial-cut"},
+    "anthropic": {"componentProfile":"organic","mediaStyle":"illustrated","artDirection":"illustrated-doodle"},
+    "hand-drawn": {"componentProfile":"organic","mediaStyle":"illustrated","artDirection":"illustrated-doodle"},
+    "cinereel": {"componentProfile":"editorial","mediaStyle":"cinematic","artDirection":"cinematic-depth"},
+    "branding": {"componentProfile":"organic","mediaStyle":"editorial-photo","artDirection":"collage-paper"},
+    "dark-glass": {"componentProfile":"glass","mediaStyle":"device-stage","artDirection":"cinematic-depth"},
+    "grid-tech": {"componentProfile":"clean","mediaStyle":"device-stage","artDirection":"technical-grid"},
+    "pastel-saas": {"componentProfile":"organic","mediaStyle":"clean-product","artDirection":"gradient-mesh"},
+    "memphis": {"componentProfile":"poster","mediaStyle":"cutout-collage","artDirection":"maximalist-blocks"},
+    "retro-press": {"componentProfile":"editorial","mediaStyle":"cutout-collage","artDirection":"collage-paper"},
+    "bold-clash": {"componentProfile":"poster","mediaStyle":"cutout-collage","artDirection":"maximalist-blocks"},
+    "organic-earth": {"componentProfile":"organic","mediaStyle":"editorial-photo","artDirection":"illustrated-doodle"},
+    "press-room": {"componentProfile":"editorial","mediaStyle":"editorial-photo","artDirection":"editorial-cut"},
+    "board-brief": {"componentProfile":"clean","mediaStyle":"clean-product","artDirection":"technical-grid"},
+    "campus-teal": {"componentProfile":"organic","mediaStyle":"illustrated","artDirection":"illustrated-doodle"},
+    "clinic-care": {"componentProfile":"clean","mediaStyle":"clean-product","artDirection":"geometric-pop"},
+    "wedding-blush": {"componentProfile":"organic","mediaStyle":"editorial-photo","artDirection":"illustrated-doodle"},
+    "portfolio-noir": {"componentProfile":"luxury","mediaStyle":"editorial-photo","artDirection":"cinematic-depth"},
+    "bistro-warm": {"componentProfile":"organic","mediaStyle":"editorial-photo","artDirection":"collage-paper"},
+    "gov-brief": {"componentProfile":"clean","mediaStyle":"clean-product","artDirection":"technical-grid"},
+    "sport-arena": {"componentProfile":"poster","mediaStyle":"cinematic","artDirection":"maximalist-blocks"},
+    "legal-slate": {"componentProfile":"clean","mediaStyle":"editorial-photo","artDirection":"editorial-cut"}
+  }
+}

package/skills/document/theme-system.md

@@ -0,0 +1,101 @@
+# Theme V2 — composable deck design system
+
+Theme V2 separates five decisions that the old pack model coupled together:
+
+1. **Theme** (`style`) — palette, typography, background and family identity.
+2. **Component profile** — cards, metrics, pricing, quotes, tables, badges and data UI.
+3. **Media style** — product/device, editorial photo, collage, illustration or cinematic treatment.
+4. **Art direction** — large color fields, pattern language, decorative geometry and page atmosphere.
+5. **Layout + recipe** — content geometry per slide and narrative order per deck.
+
+`theme-system.json` binds every existing catalog id to one component profile, one
+default media style and one art direction. A deck can override only the media treatment;
+art direction remains part of the Theme identity and layout selection stays separate.
+
+Component profiles: `clean`, `glass`, `editorial`, `poster`, `organic`, `luxury`.
+They alter radius, border weight, depth, surface behavior, label typography and emphasis
+patterns across the full semantic component contract (cards, KPI, proof, pricing, quote,
+table, chart, workflow, funding and CTA).
+
+Media styles: `clean-product`, `device-stage`, `editorial-photo`, `cutout-collage`,
+`illustrated`, `cinematic`, `spatial-3d`. They can be changed independently for a deck or
+a bespoke page while the Theme's color, type, background and component grammar remain.
+
+Art directions: `geometric-pop`, `gradient-mesh`, `editorial-cut`, `collage-paper`,
+`illustrated-doodle`, `cinematic-depth`, `luxury-ornament`, `technical-grid`,
+`maximalist-blocks`. The renderer injects a decoration-only backdrop canvas for these
+profiles. Each uses the selected family's full `--c1`…`--c4` ramp rather than only its
+accent, so Theme differences include composition and motif—not merely hue.
+
+## Page scenes and deck rhythm
+
+`deck-build` maps each slide intent to one visual scene: `hero`, `content`, `data`,
+`media` or `closing`. The scene controls which art-direction motifs remain visible;
+`decorDensity` (`low`, `medium`, `high`) controls their combined intensity. With the
+default `decorRhythm:"auto"`, adjacent high-intensity pages are softened, long medium
+runs receive a low beat, and repeated scenes cycle deterministic motif variants.
+
+Authors normally provide only `intent`. Use a per-slide `scene` or `decorDensity` only
+for a deliberate override. Set top-level `decorRhythm:"steady"` to keep the intent
+profile's density unchanged. These fields require `themeVersion:2` and never select or
+rewrite a layout.
+
+```json
+{
+  "style": "cool",
+  "themeVersion": 2,
+  "decorRhythm": "auto",
+  "mediaStyle": "device-stage",
+  "layoutPack": "none",
+  "slides": [
+    {"intent":"problem", "layout":"pitch-problem", "slots":{}},
+    {"intent":"product-demo", "layout":"product-device", "slots":{}}
+  ]
+}
+```
+
+`deck-build` emits the matching render command:
+
+```sh
+html2pptx deck.html out.pptx --style cool --theme-v2 --media-style device-stage
+```
+
+## Compatibility
+
+- Existing `{style:"cool"}` specs and `html2pptx --style cool` calls remain V1 and
+  render exactly as before.
+- `catalog.json` collection `original-13` freezes the initial roster at commit
+  `7306d8e5` with `renderMode:"classic-v1"`. Those entries keep current bug/font/contrast
+  fixes but reject `themeVersion:2`, `--theme-v2`, media overrides, scene controls and
+  Theme V2-only layouts. Their samples and fidelity cover baselines are rendered in V1.
+- `themeVersion:2` adds component, media and art-direction layers; it does not change
+  the selected layout.
+- Existing `{style:"press-room"}` keeps the legacy implicit same-name layout pack.
+  New specs should state `layoutPack:"press-room"` or `layoutPack:"none"` explicitly.
+- `--theme <theme.json>` is a different legacy document recolor path and is not Theme V2.
+
+## Content-first layout selection
+
+Use `layouts/profiles.json`. Match `intent`, then check density, item capacity and media
+requirement before selecting a candidate. `deck-build` warns when a slide's explicit
+layout is outside the candidate list and errors on unknown intents. It never forces a
+layout merely because a visual Theme was selected.
+
+The ten layouts listed in `themeV2Layouts` use the new semantic component contract and
+therefore require `themeVersion:2`; `deck-build` rejects a V1 attempt before writing HTML.
+All pre-existing layouts remain valid in both V1 and V2.
+
+Pitch recipes live in `recipes/`. They describe narrative roles, not fixed visual pages,
+so the same fundraising story can render in a clean consulting Theme, neon product Theme
+or editorial Theme without changing its content contract.
+
+## Coverage and provenance
+
+The 18 pitch intents cover problem, solution, product, market, competition, business
+model, pricing, traction, go-to-market, economics, financials, proof, team, ask and close.
+The visual archetypes are clean-room abstractions informed by broad category patterns,
+including the SlidesCarnival pitch-deck index: geometric color fields, gradient/3D depth,
+editorial cropping, paper collage, illustration/doodles, ornament, grids and maximalist
+blocks. Do not copy third-party template assets or page geometry. SlidesCarnival templates
+are CC BY 4.0 and embedded photos may carry separate licenses; importing an actual template
+requires preserving attribution and asset credits.