@taloswork/ose-shared 0.1.1 → 0.1.3

package/skills/document/bin/pptx-clone.cjs

@@ -9818,10 +9818,10 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/pptx-clone.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/pptx-clone.js
+// packages/core/dist/document/pptx-clone.js
 var import_jszip = __toESM(require_lib3(), 1);
 
-// packages/core/dist/fs/ooxml-util.js
+// packages/core/dist/document/ooxml-util.js
 function escXml(s) {
   return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[c]);
 }
@@ -9936,7 +9936,7 @@ function replaceTextAcrossRuns(xml, find, replacement, opts) {
   return { xml: rewritten, count };
 }
 
-// packages/core/dist/fs/pptx-clone.js
+// packages/core/dist/document/pptx-clone.js
 var SLIDE_CT = "application/vnd.openxmlformats-officedocument.presentationml.slide+xml";
 var SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
 var EMU_PER_PT = 12700;

package/skills/document/bin/pptx-embed-fonts.cjs

@@ -9818,7 +9818,7 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/pptx-embed-fonts.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/pptx-fonts.js
+// packages/core/dist/document/pptx-fonts.js
 var import_jszip = __toESM(require_lib3(), 1);
 var FONT_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
 function escXml(s) {

package/skills/document/bin/pptx-set-image.cjs

@@ -9819,10 +9819,10 @@ var require_lib3 = __commonJS({
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
 
-// packages/core/dist/fs/pptx-set-image.js
+// packages/core/dist/document/pptx-set-image.js
 var import_jszip = __toESM(require_lib3(), 1);
 
-// packages/core/dist/fs/ooxml-util.js
+// packages/core/dist/document/ooxml-util.js
 function elementRe(tag) {
   const t = tag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return new RegExp(`<${t}\\b[^>]*(?:/>|>[\\s\\S]*?</${t}>)`, "g");
@@ -9835,7 +9835,7 @@ function findElement(xml, tag, test) {
   return void 0;
 }
 
-// packages/core/dist/fs/pptx-set-image.js
+// packages/core/dist/document/pptx-set-image.js
 var CONTENT_TYPE = {
   png: "image/png",
   jpg: "image/jpeg",

package/skills/document/bin/pptx-slide.cjs

@@ -9818,7 +9818,7 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/pptx-slide.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/pptx-slide.js
+// packages/core/dist/document/pptx-slide.js
 var import_jszip = __toESM(require_lib3(), 1);
 var SLIDE_CT = "application/vnd.openxmlformats-officedocument.presentationml.slide+xml";
 var SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
@@ -9923,10 +9923,10 @@ async function reorderPptxSlides(bytes, order) {
   return { bytes: new Uint8Array(out2), order: [...order] };
 }
 
-// packages/core/dist/fs/pptx-clone.js
+// packages/core/dist/document/pptx-clone.js
 var import_jszip2 = __toESM(require_lib3(), 1);
 
-// packages/core/dist/fs/ooxml-util.js
+// packages/core/dist/document/ooxml-util.js
 function escXml(s) {
   return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[c]);
 }
@@ -10041,7 +10041,7 @@ function replaceTextAcrossRuns(xml, find, replacement, opts) {
   return { xml: rewritten, count };
 }
 
-// packages/core/dist/fs/pptx-clone.js
+// packages/core/dist/document/pptx-clone.js
 var SLIDE_CT2 = "application/vnd.openxmlformats-officedocument.presentationml.slide+xml";
 var SLIDE_REL_TYPE2 = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
 var EMU_PER_PT = 12700;

package/skills/document/bin/pptx-theme.cjs

@@ -9818,7 +9818,7 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/pptx-theme.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/pptx-theme.js
+// packages/core/dist/document/pptx-theme.js
 var import_jszip = __toESM(require_lib3(), 1);
 var SYS_CLR = { windowText: "000000", window: "FFFFFF" };
 function schemeColor(clrScheme, slot) {

package/skills/document/bin/pptx-tokenize.cjs

@@ -9818,10 +9818,10 @@ var require_lib3 = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/pptx-tokenize.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/pptx-tokenize.js
+// packages/core/dist/document/pptx-tokenize.js
 var import_jszip = __toESM(require_lib3(), 1);
 
-// packages/core/dist/fs/ooxml-util.js
+// packages/core/dist/document/ooxml-util.js
 function unescXml(s) {
   return s.replace(/&(amp|lt|gt|quot|apos|#x?[0-9a-fA-F]+);/g, (whole, code) => {
     switch (code) {
@@ -9863,7 +9863,7 @@ function visualWidth(text) {
   return w;
 }
 
-// packages/core/dist/fs/pptx-tokenize.js
+// packages/core/dist/document/pptx-tokenize.js
 var RE = {
   slide: /^ppt\/slides\/slide(\d+)\.xml$/,
   sp: /<p:sp\b[^>]*>[\s\S]*?<\/p:sp>/g,

package/skills/document/bin/xlsx-query.cjs

@@ -33251,7 +33251,7 @@ var require_xlsx = __commonJS({
 // apps/admin/data/skills.lib/document/bin-src/xlsx-query.mjs
 var import_promises = require("node:fs/promises");
 
-// packages/core/dist/fs/xlsx-query.js
+// packages/core/dist/document/xlsx-query.js
 var XLSX = __toESM(require_xlsx(), 1);
 function parseWorkbook(buffer) {
   const data = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);

package/skills/document/bin/xlsx-recalc.cjs

@@ -81588,7 +81588,7 @@ var require_tiny_emitter = __commonJS({
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
 
-// packages/core/dist/fs/xlsx-recalc.js
+// packages/core/dist/document/xlsx-recalc.js
 var import_exceljs = __toESM(require_excel(), 1);
 
 // node_modules/hyperformula/es/parser/ColumnAddress.mjs
@@ -111706,7 +111706,7 @@ for (const pluginName of Object.getOwnPropertyNames(plugin_exports)) {
   }
 }
 
-// packages/core/dist/fs/xlsx-recalc.js
+// packages/core/dist/document/xlsx-recalc.js
 function toPrimitive(v) {
   if (v == null)
     return { value: null };

package/skills/document/catalog.json

@@ -0,0 +1,25 @@
+{
+  "groups": [
+    { "id": "tech-future",  "name_cn": "科技未来", "sample": "styles/_samples/_groups/tech-future.webp",  "scenarios": ["科技", "发布会", "产品", "pitch"] },
+    { "id": "biz-premium",  "name_cn": "商务高端", "sample": "styles/_samples/_groups/biz-premium.webp",  "scenarios": ["金融", "年报", "路演", "招商", "董事会"] },
+    { "id": "minimal",      "name_cn": "极简设计", "sample": "styles/_samples/_groups/minimal.webp",      "scenarios": ["极简", "设计", "作品集"] },
+    { "id": "editorial",    "name_cn": "编辑人文", "sample": "styles/_samples/_groups/editorial.webp",    "scenarios": ["人文", "行业观察", "杂志感", "研究分享"] },
+    { "id": "creative",     "name_cn": "创意手作", "sample": "styles/_samples/_groups/creative.webp",     "scenarios": ["创意", "教学", "工作坊", "头脑风暴"] },
+    { "id": "natural",      "name_cn": "自然温和", "sample": "styles/_samples/_groups/natural.webp",      "scenarios": ["品牌手册", "可持续", "美妆", "零售"] }
+  ],
+  "entries": [
+    { "id": "cool",          "kind": "skin", "group": "tech-future", "name_cn": "酷炫深色",   "oneliner": "深蓝辉光 · 科技发布", "scenarios": ["科技", "发布", "pitch", "主题演讲"],            "mode": "dark",  "sample": "styles/_samples/cool.webp" },
+    { "id": "swiss-grid",    "kind": "skin", "group": "tech-future", "name_cn": "瑞士国际",   "oneliner": "克莱因蓝白 · 瑞士国际", "scenarios": ["科技产品", "数据汇报", "设计", "年度总结"],   "mode": "light", "sample": "styles/_samples/swiss-grid.webp" },
+    { "id": "black-gold",    "kind": "skin", "group": "biz-premium", "name_cn": "黑金",       "oneliner": "纯黑金辉 · 高端商务", "scenarios": ["金融", "年报", "路演", "奢侈品"],              "mode": "dark",  "sample": "styles/_samples/black-gold.webp" },
+    { "id": "olive-gold",    "kind": "skin", "group": "biz-premium", "name_cn": "橄榄金",     "oneliner": "橄榄亮金 · 高端招商", "scenarios": ["高端", "证书", "招商", "品牌"],                "mode": "dark",  "sample": "styles/_samples/olive-gold.webp" },
+    { "id": "mckinsey",      "kind": "skin", "group": "biz-premium", "name_cn": "白底咨询",   "oneliner": "白底藏青 · 咨询评审", "scenarios": ["咨询", "战略汇报", "评审", "董事会"],          "mode": "light", "sample": "styles/_samples/mckinsey.webp" },
+    { "id": "apple",         "kind": "skin", "group": "minimal",     "name_cn": "纯黑极简",   "oneliner": "纯黑极简 · 产品发布", "scenarios": ["产品发布", "主题演讲", "极简演示"],            "mode": "dark",  "sample": "styles/_samples/apple.webp" },
+    { "id": "mono",          "kind": "skin", "group": "minimal",     "name_cn": "纯白黑灰",   "oneliner": "纯白黑灰 · 极简设计", "scenarios": ["极简", "高端", "设计", "单色报告"],            "mode": "light", "sample": "styles/_samples/mono.webp" },
+    { "id": "ivory-gold",    "kind": "skin", "group": "minimal",     "name_cn": "奶油青铜",   "oneliner": "奶油青铜 · 奢华极简", "scenarios": ["奢华极简", "品牌手册", "路演", "高端零售"],    "mode": "light", "sample": "styles/_samples/ivory-gold.webp" },
+    { "id": "magazine-ink",  "kind": "skin", "group": "editorial",   "name_cn": "杂志墨",     "oneliner": "瓷白靛蓝 · 杂志人文", "scenarios": ["人文分享", "行业观察", "商业发布"],            "mode": "light", "sample": "styles/_samples/magazine-ink.webp" },
+    { "id": "anthropic",     "kind": "skin", "group": "editorial",   "name_cn": "奶油珊瑚",   "oneliner": "奶油珊瑚 · AI 研究",  "scenarios": ["AI", "产品", "研究分享", "人文品牌"],          "mode": "light", "sample": "styles/_samples/anthropic.webp" },
+    { "id": "hand-drawn",    "kind": "skin", "group": "creative",    "name_cn": "纸感手绘",   "oneliner": "纸感手绘 · 创意教学", "scenarios": ["创意", "头脑风暴", "教学", "工作坊"],          "mode": "light", "sample": "styles/_samples/hand-drawn.webp" },
+    { "id": "cinereel",      "kind": "skin", "group": "creative",    "name_cn": "黑白胶片",   "oneliner": "黑白胶片 · 影视创意", "scenarios": ["影视", "创意作品集", "音乐", "传媒"],          "mode": "dark",  "sample": "styles/_samples/cinereel.webp" },
+    { "id": "branding",      "kind": "skin", "group": "natural",     "name_cn": "暖米绿意",   "oneliner": "暖米绿意 · 品牌手册", "scenarios": ["品牌手册", "可持续", "美妆", "零售", "极简"], "mode": "light", "sample": "styles/_samples/branding.webp" }
+  ]
+}

package/skills/document/deck-design.md

@@ -281,6 +281,197 @@ The shipped `layouts/*.tpl` are this recipe applied as structure-only slides —
 paste the nearest one and paint it with a skin (`--style`) rather than rebuilding
 the stack by hand; each already carries the 8 layers correctly wired.
 
+**动画优先由族的 motion 预设派发**（`motion/<id>.json`，`catalog.json` 里该 entry 的
+`motion` 字段指到它；`deck-build` 填槽时按每页 layout 的 role 自动注入
+`data-anim*`/`data-transition*`）。手写 `data-anim`/`data-transition` 仍然优先 ——
+`deck-build` 只在元素还没有该属性时才注入，用于特例覆盖派发结果。没有 motion 预设
+的族（当前 13 个 skin 在 P0 都没有）保持这一段以下描述的默认行为：不写
+`data-anim` 就没有任何动画。
+
+## Motion — entrance animation + slide transitions
+
+### Entrance animation (`data-anim`) — opt-in, hero pages only
+
+html2pptx emits **native PowerPoint entrance animations** (a real `<p:timing>`
+build sequence — not a video, not a GIF). Mark an element with `data-anim` and it
+becomes one build step; the deck then plays like a keynote instead of appearing
+all at once.
+
+**Off unless you ask for it.** No `data-anim` anywhere → no `<p:timing>` → byte-
+identical output to before. Reach for it when the scenario is a **stage** —
+发布会 / 路演 / pitch / 主题演讲 — and skip it for 内审 / 报告 / 讲义 decks that
+people read rather than watch.
+
+#### The attribute contract
+
+| attribute | value | default |
+|---|---|---|
+| `data-anim` | `fade` · `fade-up` · `float` · `appear` · `fly-up` · `fly-down` · `fly-left` · `fly-right` | — (required) |
+| `data-anim-seq` | number — build order within the slide | `0`, then paint order |
+| `data-anim-start` | `after` (chain) · `with` (simultaneous) · `onclick` | `after` |
+| `data-anim-delay` | ms before this step | `0` first step, `200` after |
+| `data-anim-dur` | ms the effect runs | `500` |
+
+`fade-up` and `float` are the same gentle 5%-rise fade — the house default.
+`fly-*` travels 30% of the slide and is loud; spend it once, on a cover. `appear`
+is a hard cut with no fade (use for a punchline that should snap in).
+
+Put the attribute on a **container** and the text inside inherits it — the walker
+resolves each text run to its nearest `[data-anim]` ancestor, so one attribute on
+a `.card` animates the whole card as a unit. That is almost always what you want:
+animate BLOCKS, not individual words.
+
+#### Playback model
+
+The first step fires when the presenter advances to the slide's build; every later
+step chains **after-previous**, so its `data-anim-delay` reads as the stagger
+between items. One click plays the whole page — you never click per element.
+
+#### Hard constraints (silent failure if ignored)
+
+- **Only native shapes animate.** Anything baked into the raster backdrop is one
+  flat image and cannot be a step. That includes every `--talos-bake:1` title —
+  **`cinereel` and `ivory-gold` bake ALL their title classes**, so on those two
+  skins a `data-anim` on `.cover-title`/`.section-title` is silently dropped.
+  Animate the eyebrow, body, cards and image instead, or pick another skin.
+  **Same rule for a motion preset's `entrance.<role>[].sel`** — `deck-build` writes
+  `data-anim*` onto whatever the selector matches by class, so a preset step aimed
+  at a title class on a bake-everything skin drops just as silently; a family's
+  `motion/<id>.json` has to know its own skin's `--talos-bake` list.
+- **`background-clip:text` is baked too** (layer 8 above) — same silent drop.
+- **PDF flattens everything.** `doc-convert` / LibreOffice / Gotenberg ignore
+  `<p:timing>`; the animation exists only in the .pptx opened in PowerPoint,
+  Keynote or Impress. Never promise animation on a PDF deliverable.
+- **Charts and images animate**, as whole objects — a `data-chart` cannot animate
+  series-by-series.
+
+#### Recipes (paste onto the layout you already picked)
+
+**Cover** — one statement, one beat:
+
+```html
+<h1 class="cover-title" data-anim="fade-up" data-anim-seq="1" data-anim-dur="700">…</h1>
+<div class="cover-sub" data-anim="fade-up" data-anim-seq="2" data-anim-delay="120">…</div>
+```
+
+**Section divider** — the number lands, then the title:
+
+```html
+<div class="section-ghost" data-anim="fade" data-anim-seq="1">03</div>
+<h2 class="section-title" data-anim="fly-up" data-anim-seq="2" data-anim-delay="150">…</h2>
+```
+
+**Card grid / TOC** — stagger the blocks, never the words. One attribute per card,
+`seq` in reading order, a short even delay:
+
+```html
+<div class="card" data-anim="fade-up" data-anim-seq="1">…</div>
+<div class="card" data-anim="fade-up" data-anim-seq="2" data-anim-delay="140">…</div>
+<div class="card" data-anim="fade-up" data-anim-seq="3" data-anim-delay="140">…</div>
+```
+
+**Big stat** — the label sets up, the number pays off:
+
+```html
+<div class="stat-lead" data-anim="fade" data-anim-seq="1">…</div>
+<div class="stat-num" data-anim="appear" data-anim-seq="2" data-anim-delay="260">…</div>
+```
+
+#### Discipline
+
+- **≤4 steps per slide.** A build with eight steps is a slide with too much on it.
+- **Hero pages only** — cover, section, big-stat, ending, and at most one content
+  page per chapter. A deck where *every* page builds is exhausting to present.
+- **Never animate the chrome** (header/footer/page number/hairline) — the frame is
+  supposed to be constant; animating it makes the deck feel unstable.
+- **Keep durations short** (500–700ms). Anything slower reads as lag on a projector.
+
+### Slide transitions (`data-transition`)
+
+Where `data-anim` builds content WITHIN a slide, `data-transition` sets how the deck
+moves BETWEEN slides. Put it on the `<section class="slide">` — it describes the move
+**into** that slide.
+
+| attribute | value | default |
+|---|---|---|
+| `data-transition` | `cut` · `fade` · `dissolve` · `wedge` · `wipe` · `push` · `cover` · `zoom` · `split` · `morph` · `none` | — (required) |
+| `data-transition-dir` | `l` · `r` · `u` · `d` (wipe/push/cover) · `in` · `out` (zoom/split) | per-effect default |
+| `data-transition-dur` | ms | the `med` speed bucket |
+
+```html
+<section class="slide" data-transition="fade" data-transition-dur="600">…</section>
+<section class="slide" data-transition="push" data-transition-dir="u">…</section>
+```
+
+**`morph` is the one that makes a deck look produced** — PowerPoint tweens shapes that
+persist across two slides instead of cutting. Two caveats before you reach for it:
+it needs **PowerPoint 2016+** (older consumers get the fade fallback we emit), and in
+hybrid mode most of each slide is a single baked backdrop image, so morph has little
+to tween — it reads as a soft cross-dissolve unless the two slides share **native**
+shapes (text/charts) in similar positions. Use it between slides that genuinely
+continue one another (a title that moves, a stat that grows); elsewhere `fade` is more
+honest and costs nothing.
+
+**Pick one transition for the deck and stay with it** — a different effect per slide is
+the single loudest "amateur deck" signal. `fade` for almost everything; `push` or
+`cover` when chapters should feel like turning a page; `cut` (or nothing) for dense
+analytical decks where motion is noise; `morph` for the two or three slides that
+actually continue each other.
+
+Same two constraints as animation: **PDF export flattens transitions** (they exist only
+in the .pptx opened in PowerPoint/Keynote/Impress), and an unknown name degrades to
+`fade` rather than failing.
+
+## Type & space scale — how a skin sets its own rhythm
+
+Every `font-size` and page gutter in `layouts/*.tpl` is written as a scalable value:
+
+```html
+font-size:calc(23px * var(--type-scale,1))    left:calc(96px * var(--space-scale,1))
+```
+
+A skin sets `--space-scale` / `--type-scale` in its `:root` and the whole deck retimes —
+**without touching a single layout**, and keeping each layout's internal hierarchy intact
+(everything scales together). Both default to `1`, so a skin that ignores them renders
+exactly as before. The shipped range runs from `mckinsey` at `0.86` (board-pack density)
+to `apple` at `1.22` (keynote-stage air).
+
+Two rules:
+
+- **Hand-authoring a bespoke slide?** Write your sizes the same way
+  (`calc(48px * var(--type-scale,1))`) or that one slide will ignore the skin's rhythm
+  and sit at a different density than the rest of the deck.
+- **Changed a scale? Re-run `deck-qa`.** Scaling reflows text; push it too far and content
+  runs off-canvas or collides. That is a mechanical check — never eyeball it.
+
+## Fonts — bundled faces reach the render, not the native text layer
+
+`assets/fonts/fonts.json` is the single source of truth for the skill's font set.
+`html2pptx` base64-injects every face from it at render; `scripts/deck-skin-samples.mjs`
+and `scripts/deck-fidelity.mjs` serve the same files from disk. **Add a face there and
+drop the `.woff2` beside it — never inline a base64 `@font-face` into a `skin.css`.**
+
+The part that trips people up: an injected `@font-face` styles the **browser** render —
+the raster backdrop, any `--talos-bake:1` text, `--rasterize` output, and the skin
+preview cards. It does **not** reach the **native pptx text layer**. There a run carries
+only a typeface *name*, and PowerPoint / Keynote / LibreOffice substitute whatever they
+have installed. So a skin can name a face, we can bundle it, and the audience still sees
+a substitute.
+
+Three ways a non-system face actually survives into the delivered deck:
+
+1. **Bake it** (`--talos-bake:1` on the class) — what `cinereel` and `ivory-gold` do for
+   their Anton titles. Guaranteed correct; the text becomes part of the backdrop image,
+   so it is no longer editable, searchable, `deck-qa`-checkable, or animatable.
+2. **Embed it** — `bin/pptx-embed-fonts.cjs` writes an OOXML font embed. Needs a TTF
+   (we bundle woff2), and is only sane for small Latin faces, never CJK.
+3. **Ask for a system face** — Helvetica Neue / Georgia / Arial and the CJK families are
+   everywhere; that is why most skins lead with them.
+
+A face that is bundled but neither baked nor embedded is *still worth bundling* (the
+backdrop and the picker previews come out right), just don't assume the native text
+followed. `hand-drawn`'s Gochi Hand heading is exactly that case today.
+
 ## Running a script (PptxGenJS via doc-run — NOT for decks)
 
 > **This section is reference for NON-deck freeform PptxGenJS only** (bespoke

package/skills/document/layouts/README.md

@@ -108,6 +108,7 @@ Each slide carries `data-layout="<id>"` (drives the diversity lint + traceabilit
 | `map-quad` | content · data | dot-matrix world map + 4 FIXED corner % callouts | medium (4) | diagram (map) | 全球分布(四角固定;条目数可变用 `map-distribution`) |
 | `toc-agenda` | toc | single-column agenda | 5–7 items | text-only | 议程(单列,vs 双列 `toc`) |
 | `toc-panel` | toc | left title + dark side panel (rows) | 3–5 entries | text-only | 目录(左标题+右深色面板) |
+| `toc-editorial` | toc | 2×2 numbered briefs + oversized side title | 4 chapters | text-only | 目录(杂志/影视感,右侧巨型标题) |
 | `stats-chart` | content · data | title + paragraph + panel bar chart | dense | diagram (bar) | 统计页(深色面板横向条形图) |
 | `blocks-2x2` | content | 2x2 blocks grid | medium (4) | text-only | 2×2 区块网格 |
 | `editorial-panel` | content | editorial panel layout | medium | text-only | 编辑面板版式 |
@@ -155,3 +156,34 @@ deck.html 时逐页决定要不要加这个类,skin 只需在自己的 `--slide-
 Adding a **skin** = one `styles/<name>/skin.css` defining the above; all layouts get
 it. Adding a **layout** = one `layouts/<id>.tpl` (structure-only, tagged here); all
 skins render it.
+
+## 反向通道 —— 包内版式如何进入共享库
+
+一个 `packs/<id>/` 可以带自己的专属版式（`packs/<id>/layouts/<id>.tpl`，与共享同名
+即遮蔽）。当包里做出来的某一页被证明**不是**包专属的装饰、而是别的族/包也会用得上
+的结构时，把它提升进这个共享库，而不是让每个包各自重复发明。
+
+**准入判据**（spec §7.3）：**剥掉所有颜色与 `font-family` 之后，它仍表达一个共享库
+没有的结构。** 是 → 提升；否（结构其实通用，专属感全靠色彩/字体/图形语汇撑）→ 留在
+包内，不要提升。
+
+跑 `node scripts/ppt-tpl/promote-layout.mjs <packId> <layoutId>`。它只机械校验"可
+提升"的必要条件（零硬编码色、不带私有 `font-family`、只用契约内 class、规范的
+1280×720 单 `section` + `data-layout`、至少一个可填槽位、`layouts/README.md` 表头
+格式没变）——**是不是结构性创新仍需人来判**，脚本不代劳。任一条不满足就拒绝写入
+（不移动文件），并逐条报出缺什么。
+
+校验通过后脚本会：把 `.tpl` 移到 `layouts/`、重跑 `scripts/gen-slots.mjs` 重生成
+`slots.json`、在本文件的 Catalog 表格里插入一行占位（`role`/`structure`/`density`/
+`has-image`/`pick when` 均为 `TODO`，附 `promoted from packs/<packId>`）。写入中途
+任何一步失败都会整体回滚（删掉刚写的 `.tpl`，`slots.json`/本文件复原），不会留下
+半成品。
+
+提升不是终点，脚本打印的四步收尾都要做：补全本文件里那一行的全部 `TODO`、从
+`packs/<packId>/layouts/` 删掉原文件（否则同名遮蔽会让包永远看不到共享版本、也
+永远吃不到后续对共享版式的修复）、`node scripts/deck-skin-samples.mjs && node
+scripts/deck-fidelity.mjs` 确认它在所有皮肤下都成立、再跑
+`TALOS_TEST_SCOPE=unit npx vitest run tests/unit/deck-layouts.test.ts`。
+
+新版式若用到契约外的 class，先扩 `styles/_contract-defaults.css`（本脚本不代劳）——
+但只有 **≥3 个族/包各自独立地需要同一个新原语**时才扩，避免契约被单个包的口味撑肥。

package/skills/document/layouts/banner-columns.tpl

@@ -1,22 +1,22 @@
 <!-- layouts/banner-columns — structure-only (paint via skin). 通栏 banner 大写标题 + 下方 3 栏项目符号文本(使用说明/须知/多方案并列). 深色皮肤(black-gold/cool)下呈"浅带+描金标题+浅字"参考观感;浅色皮肤下呈"实色带+白标题". data-layout drives P1/P2/P3 + dedup. -->
 <section class="slide" data-layout="banner-columns" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
 <!-- ===== TOP BANNER ===== -->
-<div class="banner" style="position:absolute;left:0;right:0;top:32px;height:150px;display:flex;align-items:center;justify-content:center;padding:0 56px"><div class="banner-title" style="font-size:58px;font-weight:800;letter-spacing:.01em;text-transform:uppercase;line-height:1;text-align:center">{{banner|How to use this presentation}}</div></div>
+<div class="banner" style="position:absolute;left:0;right:0;top:32px;height:150px;display:flex;align-items:center;justify-content:center;padding:0 56px"><div class="banner-title" style="font-size:calc(58px * var(--type-scale,1));font-weight:800;letter-spacing:.01em;text-transform:uppercase;line-height:1;text-align:center">{{banner|How to use this presentation}}</div></div>
 <!-- ===== 3 COLUMNS ===== -->
 <div style="position:absolute;left:56px;right:56px;top:250px;bottom:44px;display:grid;grid-template-columns:1fr 1fr 1fr;gap:44px">
   <div class="col">
-    <div class="col-title" style="text-align:center;font-size:24px;font-weight:700;margin-bottom:28px">{{col1_title|分栏标题一}}</div>
-    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:15px;line-height:1.7;text-align:justify">{{b1|一段说明文字,两三行,替换为真实内容。可以写操作步骤或注意事项。}}</p></div>
-    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:15px;line-height:1.7;text-align:justify">{{b2|<span style="text-decoration:underline">备选:</span> 第二条说明,延展一句,替换为真实内容,收束到要点。}}</p></div>
+    <div class="col-title" style="text-align:center;font-size:calc(24px * var(--type-scale,1));font-weight:700;margin-bottom:28px">{{col1_title|分栏标题一}}</div>
+    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;text-align:justify">{{b1|一段说明文字,两三行,替换为真实内容。可以写操作步骤或注意事项。}}</p></div>
+    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;text-align:justify">{{b2|<span style="text-decoration:underline">备选:</span> 第二条说明,延展一句,替换为真实内容,收束到要点。}}</p></div>
   </div>
   <div class="col">
-    <div class="col-title" style="text-align:center;font-size:24px;font-weight:700;margin-bottom:28px">{{col2_title|分栏标题二}}</div>
-    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:15px;line-height:1.7;text-align:justify">{{b3|一段说明文字,两三行,替换为真实内容。}}</p></div>
-    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:15px;line-height:1.7;text-align:justify">{{b4|<span style="text-decoration:underline">备选:</span> 第二条说明,延展一句,替换为真实内容。}}</p></div>
+    <div class="col-title" style="text-align:center;font-size:calc(24px * var(--type-scale,1));font-weight:700;margin-bottom:28px">{{col2_title|分栏标题二}}</div>
+    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;text-align:justify">{{b3|一段说明文字,两三行,替换为真实内容。}}</p></div>
+    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;text-align:justify">{{b4|<span style="text-decoration:underline">备选:</span> 第二条说明,延展一句,替换为真实内容。}}</p></div>
   </div>
   <div class="col">
-    <div class="col-title" style="text-align:center;font-size:24px;font-weight:700;margin-bottom:28px">{{col3_title|分栏标题三}}</div>
-    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:15px;line-height:1.7;text-align:justify">{{b5|一段说明文字,两三行,替换为真实内容。}}</p></div>
+    <div class="col-title" style="text-align:center;font-size:calc(24px * var(--type-scale,1));font-weight:700;margin-bottom:28px">{{col3_title|分栏标题三}}</div>
+    <div class="col-item" style="display:flex;gap:11px;margin-bottom:20px"><span class="col-bullet" style="width:5px;height:5px;border-radius:50%;flex:none;margin-top:9px;display:inline-block"></span><p class="col-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;text-align:justify">{{b5|一段说明文字,两三行,替换为真实内容。}}</p></div>
   </div>
 </div>
 </section>

package/skills/document/layouts/bento.tpl

@@ -1,4 +1,4 @@
 <!-- layouts/bento — structure-only variant (paint via skin). -->
-<section class="slide" data-layout="bento" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div><div class="eyebrow-row" style="position:absolute;left:96px;top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:13px;letter-spacing:.28em">{{eyebrow|AT A GLANCE}}</span></div><h2 class="deck-title" style="position:absolute;left:92px;top:158px;font-size:48px;letter-spacing:-.4px">{{title|总览}}</h2>
- <div class="card-grid" style="position:absolute;left:96px;right:96px;top:270px;bottom:70px;display:grid;grid-template-columns:1.6fr 1fr 1fr;grid-template-rows:1fr 1fr;gap:18px"><div class="card" style="grid-row:1 / span 2;position:relative;padding:34px;display:flex;flex-direction:column;justify-content:space-between"><span class="card-rail" style="position:absolute;left:0;top:34px;width:3px;height:44px;border-radius:2px"></span><div class="card-title" style="font-size:23px;font-weight:700">{{big_title|核心指标}}</div><div><div class="kpi-num" style="font-size:88px;font-weight:800;line-height:1">{{big_num|38}}<span class="stat-unit" style="font-size:34px">{{big_unit|B}}</span></div><p class="card-body" style="font-size:15px;margin-top:10px">{{big_body|一句说明,替换为真实内容。}}</p></div></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:19px;font-weight:700">{{card1_title|要点 01}}</div><p class="card-body" style="font-size:14px;line-height:1.55;margin-top:8px">{{card1_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:19px;font-weight:700">{{card2_title|要点 02}}</div><p class="card-body" style="font-size:14px;line-height:1.55;margin-top:8px">{{card2_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:19px;font-weight:700">{{card3_title|要点 03}}</div><p class="card-body" style="font-size:14px;line-height:1.55;margin-top:8px">{{card3_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:19px;font-weight:700">{{card4_title|要点 04}}</div><p class="card-body" style="font-size:14px;line-height:1.55;margin-top:8px">{{card4_body|一句说明。}}</p></div></div>
-<div class="rule rule-foot" style="position:absolute;left:96px;right:96px;bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:96px;bottom:17px;font-size:12px;letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:96px;bottom:17px;font-size:12px">{{pageno|01}}</div></section>
+<section class="slide" data-layout="bento" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div><div class="eyebrow-row" style="position:absolute;left:calc(96px * var(--space-scale,1));top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:calc(13px * var(--type-scale,1));letter-spacing:.28em">{{eyebrow|AT A GLANCE}}</span></div><h2 class="deck-title" style="position:absolute;left:calc(92px * var(--space-scale,1));top:158px;font-size:calc(48px * var(--type-scale,1));letter-spacing:-.4px">{{title|总览}}</h2>
+ <div class="card-grid" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));top:270px;bottom:70px;display:grid;grid-template-columns:1.6fr 1fr 1fr;grid-template-rows:1fr 1fr;gap:18px"><div class="card" style="grid-row:1 / span 2;position:relative;padding:34px;display:flex;flex-direction:column;justify-content:space-between"><span class="card-rail" style="position:absolute;left:0;top:34px;width:3px;height:44px;border-radius:2px"></span><div class="card-title" style="font-size:calc(23px * var(--type-scale,1));font-weight:700">{{big_title|核心指标}}</div><div><div class="kpi-num" style="font-size:calc(88px * var(--type-scale,1));font-weight:800;line-height:1">{{big_num|38}}<span class="stat-unit" style="font-size:calc(34px * var(--type-scale,1))">{{big_unit|B}}</span></div><p class="card-body" style="font-size:calc(15px * var(--type-scale,1));margin-top:10px">{{big_body|一句说明,替换为真实内容。}}</p></div></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:calc(19px * var(--type-scale,1));font-weight:700">{{card1_title|要点 01}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.55;margin-top:8px">{{card1_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:calc(19px * var(--type-scale,1));font-weight:700">{{card2_title|要点 02}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.55;margin-top:8px">{{card2_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:calc(19px * var(--type-scale,1));font-weight:700">{{card3_title|要点 03}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.55;margin-top:8px">{{card3_body|一句说明。}}</p></div><div class="card" style="position:relative;padding:26px"><span class="card-rail" style="position:absolute;left:0;top:26px;width:3px;height:34px;border-radius:2px"></span><div class="card-title" style="font-size:calc(19px * var(--type-scale,1));font-weight:700">{{card4_title|要点 04}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.55;margin-top:8px">{{card4_body|一句说明。}}</p></div></div>
+<div class="rule rule-foot" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1));letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1))">{{pageno|01}}</div></section>

package/skills/document/layouts/big-stat.tpl

@@ -1,4 +1,4 @@
 <!-- layouts/big-stat — structure-only (paint via styles/<skin>/skin.css). data-layout drives P1/P2/P3 + dedup. -->
-<section class="slide" data-layout="big-stat" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div><div class="eyebrow-row" style="position:absolute;left:96px;top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:13px;letter-spacing:.28em">{{eyebrow|KEY METRIC}}</span></div><h2 class="deck-title" style="position:absolute;left:92px;top:158px;font-size:48px;letter-spacing:-.4px">{{title|}}</h2>
- <div class="stat-num" style="position:absolute;left:90px;top:196px;font-weight:800;line-height:1;font-size:216px;letter-spacing:-2px">{{stat|585}}<span class="stat-unit" style="font-size:64px">{{unit| 单位}}</span></div><div class="stat-lead" style="position:absolute;left:100px;top:492px;font-size:30px;font-weight:600">{{lead|一句结论,数字说明了什么}}</div><p class="stat-note" style="position:absolute;left:100px;top:556px;width:900px;font-size:17px;line-height:1.6">{{note|一句支撑说明,给上下文与来源。}}</p>
-<div class="rule rule-foot" style="position:absolute;left:96px;right:96px;bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:96px;bottom:17px;font-size:12px;letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:96px;bottom:17px;font-size:12px">{{pageno|01}}</div></section>
+<section class="slide" data-layout="big-stat" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div><div class="eyebrow-row" style="position:absolute;left:calc(96px * var(--space-scale,1));top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:calc(13px * var(--type-scale,1));letter-spacing:.28em">{{eyebrow|KEY METRIC}}</span></div><h2 class="deck-title" style="position:absolute;left:calc(92px * var(--space-scale,1));top:158px;font-size:calc(48px * var(--type-scale,1));letter-spacing:-.4px">{{title|}}</h2>
+ <div class="stat-num" style="position:absolute;left:90px;top:196px;font-weight:800;line-height:1;font-size:calc(216px * var(--type-scale,1));letter-spacing:-2px">{{stat|585}}<span class="stat-unit" style="font-size:calc(64px * var(--type-scale,1))">{{unit| 单位}}</span></div><div class="stat-lead" style="position:absolute;left:100px;top:492px;font-size:calc(30px * var(--type-scale,1));font-weight:600">{{lead|一句结论,数字说明了什么}}</div><p class="stat-note" style="position:absolute;left:100px;top:556px;width:900px;font-size:calc(17px * var(--type-scale,1));line-height:1.6">{{note|一句支撑说明,给上下文与来源。}}</p>
+<div class="rule rule-foot" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1));letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1))">{{pageno|01}}</div></section>

package/skills/document/layouts/blocks-2x2.tpl

@@ -2,18 +2,18 @@
 <section class="slide" data-layout="blocks-2x2" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
 
 
-<div class="eyebrow-row" style="position:absolute;left:96px;top:124px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:13px;letter-spacing:.28em">{{eyebrow|PRINCIPLES}}</span></div>
-<h2 class="deck-title" style="position:absolute;left:92px;top:146px;font-size:42px;letter-spacing:-.4px">{{title|章节主标题}}</h2>
-<p class="card-body" style="position:absolute;left:96px;right:96px;top:214px;font-size:16px;line-height:1.7">{{intro|一段引子说明,两三行,交代这一章的核心观点与背景,替换为真实内容。承接标题,引出下面四个要点。}}</p>
-<div class="card-grid" style="position:absolute;left:96px;right:96px;top:296px;display:grid;grid-template-columns:1fr 1fr;gap:20px">
-  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:34px;font-weight:800;line-height:1">01</span><div class="card-title" style="font-size:22px;font-weight:700;margin-top:6px">{{block1_title|要点一标题}}</div><p class="card-body" style="font-size:14px;line-height:1.5;margin-top:6px">{{block1_body|一句说明,替换为真实内容。}}</p></div>
-  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:34px;font-weight:800;line-height:1">02</span><div class="card-title" style="font-size:22px;font-weight:700;margin-top:6px">{{block2_title|要点二标题}}</div><p class="card-body" style="font-size:14px;line-height:1.5;margin-top:6px">{{block2_body|一句说明,替换为真实内容。}}</p></div>
-  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:34px;font-weight:800;line-height:1">03</span><div class="card-title" style="font-size:22px;font-weight:700;margin-top:6px">{{block3_title|要点三标题}}</div><p class="card-body" style="font-size:14px;line-height:1.5;margin-top:6px">{{block3_body|一句说明,替换为真实内容。}}</p></div>
-  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:34px;font-weight:800;line-height:1">04</span><div class="card-title" style="font-size:22px;font-weight:700;margin-top:6px">{{block4_title|要点四标题}}</div><p class="card-body" style="font-size:14px;line-height:1.5;margin-top:6px">{{block4_body|一句说明,替换为真实内容。}}</p></div>
+<div class="eyebrow-row" style="position:absolute;left:calc(96px * var(--space-scale,1));top:124px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:calc(13px * var(--type-scale,1));letter-spacing:.28em">{{eyebrow|PRINCIPLES}}</span></div>
+<h2 class="deck-title" style="position:absolute;left:calc(92px * var(--space-scale,1));top:146px;font-size:calc(42px * var(--type-scale,1));letter-spacing:-.4px">{{title|章节主标题}}</h2>
+<p class="card-body" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));top:214px;font-size:calc(16px * var(--type-scale,1));line-height:1.7">{{intro|一段引子说明,两三行,交代这一章的核心观点与背景,替换为真实内容。承接标题,引出下面四个要点。}}</p>
+<div class="card-grid" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));top:296px;display:grid;grid-template-columns:1fr 1fr;gap:20px">
+  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:calc(34px * var(--type-scale,1));font-weight:800;line-height:1">01</span><div class="card-title" style="font-size:calc(22px * var(--type-scale,1));font-weight:700;margin-top:6px">{{block1_title|要点一标题}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.5;margin-top:6px">{{block1_body|一句说明,替换为真实内容。}}</p></div>
+  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:calc(34px * var(--type-scale,1));font-weight:800;line-height:1">02</span><div class="card-title" style="font-size:calc(22px * var(--type-scale,1));font-weight:700;margin-top:6px">{{block2_title|要点二标题}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.5;margin-top:6px">{{block2_body|一句说明,替换为真实内容。}}</p></div>
+  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:calc(34px * var(--type-scale,1));font-weight:800;line-height:1">03</span><div class="card-title" style="font-size:calc(22px * var(--type-scale,1));font-weight:700;margin-top:6px">{{block3_title|要点三标题}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.5;margin-top:6px">{{block3_body|一句说明,替换为真实内容。}}</p></div>
+  <div class="card" style="position:relative;padding:26px 30px;height:118px"><span class="card-rail" style="position:absolute;left:0;top:24px;width:3px;height:40px;border-radius:2px"></span><span class="card-idx" style="font-size:calc(34px * var(--type-scale,1));font-weight:800;line-height:1">04</span><div class="card-title" style="font-size:calc(22px * var(--type-scale,1));font-weight:700;margin-top:6px">{{block4_title|要点四标题}}</div><p class="card-body" style="font-size:calc(14px * var(--type-scale,1));line-height:1.5;margin-top:6px">{{block4_body|一句说明,替换为真实内容。}}</p></div>
 </div>
-<div style="position:absolute;left:96px;right:96px;bottom:76px;display:flex;gap:18px">
-  <div class="quote-bar" style="flex:1.7;padding:18px 24px;border-radius:var(--card-radius)"><div class="quote-txt" style="font-size:17px;font-weight:700">{{quote|"一句金句,点睛这一章。"}}</div><div class="quote-attr" style="font-size:13px;margin-top:4px">{{quote_attr|— 出处 / 作者}}</div></div>
-  <div class="footnote" style="flex:1;padding:16px 20px;border-radius:var(--card-radius)"><span class="footnote-label" style="font-size:12px;font-weight:700">参考资料:</span><span class="footnote-body" style="font-size:12px"> {{refs|来源一;来源二}}</span></div>
+<div style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));bottom:76px;display:flex;gap:18px">
+  <div class="quote-bar" style="flex:1.7;padding:18px 24px;border-radius:var(--card-radius)"><div class="quote-txt" style="font-size:calc(17px * var(--type-scale,1));font-weight:700">{{quote|"一句金句,点睛这一章。"}}</div><div class="quote-attr" style="font-size:calc(13px * var(--type-scale,1));margin-top:4px">{{quote_attr|— 出处 / 作者}}</div></div>
+  <div class="footnote" style="flex:1;padding:16px 20px;border-radius:var(--card-radius)"><span class="footnote-label" style="font-size:calc(12px * var(--type-scale,1));font-weight:700">参考资料:</span><span class="footnote-body" style="font-size:calc(12px * var(--type-scale,1))"> {{refs|来源一;来源二}}</span></div>
 </div>
-<div class="rule rule-foot" style="position:absolute;left:96px;right:96px;bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:96px;bottom:17px;font-size:12px;letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:96px;bottom:17px;font-size:12px">{{pageno|01}}</div>
+<div class="rule rule-foot" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1));letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1))">{{pageno|01}}</div>
 </section>

package/skills/document/layouts/brand-values.tpl

@@ -1,9 +1,9 @@
 <!-- layouts/brand-values — structure-only (paint via skin). 品牌手册"品牌主张":每张卡 编号圆({{_nn}}) + 准则标题 + 说明. rows.values{name,body} — 3 张最佳,2–4 张自适应. 复用既有 class(.surface/.step-circle/.step-title/.step-body). data-layout drives P1/P2/P3 + dedup. -->
 <section class="slide" data-layout="brand-values" style="position:relative;width:1280px;height:720px;overflow:hidden"><div class="slide-backdrop"></div>
-<div class="eyebrow-row" style="position:absolute;left:96px;top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:13px;letter-spacing:.28em">{{eyebrow|BRAND VALUES}}</span></div>
-<h2 class="deck-title" style="position:absolute;left:92px;top:158px;font-size:48px;letter-spacing:-.4px">{{title|品牌主张}}</h2>
-<div class="steps" style="position:absolute;left:96px;right:96px;top:280px;bottom:96px;display:flex;gap:28px">
-  {{#values}}<div class="step surface" style="flex:1;padding:34px 32px;display:flex;flex-direction:column"><div class="step-circle" style="width:64px;height:64px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:26px;font-weight:700;line-height:1">{{_nn|01}}</div><div class="step-title" style="font-size:22px;font-weight:700;font-family:var(--font-head);margin-top:22px">{{name|占位准则 · Value}}</div><p class="step-body" style="font-size:15px;line-height:1.7;margin-top:10px">{{body|一句准则说明,表达品牌的核心态度,替换为真实内容。}}</p></div>{{/values}}
+<div class="eyebrow-row" style="position:absolute;left:calc(96px * var(--space-scale,1));top:132px;display:flex;align-items:center;gap:14px"><span class="accent-bar" style="width:30px;height:1px;display:inline-block"></span><span class="eyebrow" style="font-size:calc(13px * var(--type-scale,1));letter-spacing:.28em">{{eyebrow|BRAND VALUES}}</span></div>
+<h2 class="deck-title" style="position:absolute;left:calc(92px * var(--space-scale,1));top:158px;font-size:calc(48px * var(--type-scale,1));letter-spacing:-.4px">{{title|品牌主张}}</h2>
+<div class="steps" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));top:280px;bottom:96px;display:flex;gap:28px">
+  {{#values}}<div class="step surface" style="flex:1;padding:34px 32px;display:flex;flex-direction:column"><div class="step-circle" style="width:64px;height:64px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:calc(26px * var(--type-scale,1));font-weight:700;line-height:1">{{_nn|01}}</div><div class="step-title" style="font-size:calc(22px * var(--type-scale,1));font-weight:700;font-family:var(--font-head);margin-top:22px">{{name|占位准则 · Value}}</div><p class="step-body" style="font-size:calc(15px * var(--type-scale,1));line-height:1.7;margin-top:10px">{{body|一句准则说明,表达品牌的核心态度,替换为真实内容。}}</p></div>{{/values}}
 </div>
-<div class="rule rule-foot" style="position:absolute;left:96px;right:96px;bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:96px;bottom:17px;font-size:12px;letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:96px;bottom:17px;font-size:12px">{{pageno|01}}</div>
+<div class="rule rule-foot" style="position:absolute;left:calc(96px * var(--space-scale,1));right:calc(96px * var(--space-scale,1));bottom:40px;height:1px"></div><div class="deck-footer" style="position:absolute;left:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1));letter-spacing:.1em">{{footer|报告标题 / 章节}}</div><div class="deck-pageno" style="position:absolute;right:calc(96px * var(--space-scale,1));bottom:17px;font-size:calc(12px * var(--type-scale,1))">{{pageno|01}}</div>
 </section>