dsh-ppt 0.21.0 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.en.md +18 -17
  3. package/README.md +16 -15
  4. package/docs/COACHING.md +14 -13
  5. package/docs/DATA.md +8 -8
  6. package/docs/REFERENCE.en.md +17 -19
  7. package/docs/REFERENCE.zh.md +16 -18
  8. package/docs/USAGE.en.md +107 -60
  9. package/docs/USAGE.md +115 -84
  10. package/docs/VALIDATION.md +2 -0
  11. package/docs/VISUAL.md +27 -20
  12. package/docs/WORKBENCH.md +17 -6
  13. package/docs/assets/intro/screen-en.webp +0 -0
  14. package/docs/assets/intro/screen-zh.webp +0 -0
  15. package/lib/client.js +941 -132
  16. package/lib/coaching.d.ts +1 -1
  17. package/lib/coaching.js +25 -12
  18. package/lib/config.d.ts +2 -0
  19. package/lib/config.js +30 -2
  20. package/lib/execution.d.ts +2 -1
  21. package/lib/execution.js +21 -1
  22. package/lib/tools.d.ts +1 -1
  23. package/lib/tools.js +151 -24
  24. package/lib/types.d.ts +108 -8
  25. package/lib/visual.d.ts +3 -1
  26. package/lib/visual.js +40 -13
  27. package/lib/workbench-language.js +45 -9
  28. package/lib/workbench.d.ts +5 -0
  29. package/lib/workbench.js +485 -9
  30. package/package.json +9 -4
  31. package/skills/dsh-ppt/SKILL.md +56 -54
  32. package/skills/dsh-ppt/package.json +1 -1
  33. package/skills/dsh-ppt/references/advanced.md +122 -41
  34. package/skills/dsh-ppt/references/copywriting.md +63 -41
  35. package/skills/dsh-ppt/references/data.md +83 -36
  36. package/skills/dsh-ppt/references/syntax.md +157 -28
  37. package/skills/dsh-ppt/references/themes.md +90 -41
  38. package/skills/dsh-ppt/references/troubleshooting.md +21 -16
  39. package/skills/dsh-ppt/scripts/build-deck.mjs +67 -28
  40. package/skills/dsh-ppt/scripts/deck-absorb.mjs +1029 -0
  41. package/skills/dsh-ppt/scripts/deck-advanced.mjs +406 -99
  42. package/skills/dsh-ppt/scripts/deck-core.mjs +568 -717
  43. package/skills/dsh-ppt/scripts/deck-data-view.mjs +30 -11
  44. package/skills/dsh-ppt/scripts/deck-data.mjs +35 -5
  45. package/skills/dsh-ppt/scripts/deck-director.mjs +1717 -0
  46. package/skills/dsh-ppt/scripts/deck-layouts.mjs +4557 -0
  47. package/skills/dsh-ppt/scripts/deck-media.mjs +1408 -86
  48. package/skills/dsh-ppt/scripts/deck-themes.mjs +1503 -0
  49. package/skills/dsh-ppt/scripts/deck-visual.mjs +133 -31
package/docs/USAGE.en.md CHANGED
@@ -4,27 +4,35 @@
4
4
 
5
5
  ## Current improvements
6
6
 
7
- Save workbench edits, then choose Download delivery ZIP. Individual downloads remain available. The ZIP excludes configuration, secrets and other workspace files; each file is limited to 64 MiB and the total to 128 MiB.
7
+ - **Zero-taste-burden Auto-Director, 6 Chrome Skeletons & Deep `.pptx` Absorption**: `ppt_create` defaults to `theme: "auto"` to match topic, audience, and master chrome skeleton automatically (standalone CLI keeps `data` by default for backward compatibility unless `--theme auto` is passed). `ppt_absorb` and `referencePptx` (with `cloneStructure: true` / `--clone-structure`) resolve OOXML `lumMod`/`tint`/`shade` color modifiers, CJK/Latin fonts, master logos, skeleton geometry (`extractedSkeleton`, `recommendedChrome`), and slide-by-slide layout sequences (`slideSkeleton[]`) locally with WCAG ≥4.5:1 contrast sanitization.
8
+ - **18 built-in themes, 6 Master Chrome Skeletons, 24 canonical layouts & 16 industry blueprints**: 12 daylight-first themes for bright rooms/print and 6 dark themes for keynotes/screens, mapped to 6 structurally distinct chrome skeletons (`consulting-classic`, `keynote-spatial`, `editorial-folio`, `saas-bento`, `academic-minimal`, `gov-ceremonial`); adds 5 native editable pro diagrams (`gantt`, `architecture`, `harvey`, `tam`, `org`) plus `flywheel` process variant, `tableStyle` (`consulting | booktabs | minimal | banded | harvey`), per-slide `chrome`, `columns`, `takeaway` bars, and `source` footnotes; native editable OOXML charts span 13 publication-grade kinds including vector `waterfall` bridges.
9
+ - **Style Studio & visual workbench**: Switch across 18 themes and **6 Master Chrome Skeletons (`brand.chromeStyle`)**, drag-and-drop a `.pptx` (`≤10 MiB`, parsed in memory with zero host path reads) to inspect `recommendedChrome`, `extractedSkeleton`, and `slideSkeleton`, switch across all 24 slide archetypes & per-slide `chrome`, edit Gantt timelines & Harvey matrices, append starter slides (`+ New slide`), compare HTML ↔ PPTX side-by-side, inspect full-width Vision QA before/after diffs (up to 24 slides, 12 lossless actions), and run storyline/action-title coaching (up to 8 findings across 7 audience personas).
10
+ - **Artifact integrity & safe delivery bundles**: Every build records HTML/PPTX digests so external Office edits are never silently overwritten; save a copy (`saveAs: true`) when needed. Save workbench edits, then download either the **Share bundle ZIP** or **Project bundle ZIP** (each file ≤64 MiB, total ≤128 MiB; excludes config, secrets, and unrelated workspace files).
8
11
 
9
12
  ## Capabilities
10
13
 
11
14
  | Capability | Description |
12
15
  | --- | --- |
13
- | `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
14
- | `ppt_themes` tool | Lists the 5 built-in themes and their best use cases; pass `preview: true` with `outputDir` to write a side-by-side gallery plus one SVG palette card per theme |
15
- | 11 layouts | cover / section / bullets / statement / quote / table / closing / image / image-left / image-right / chart |
16
- | Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
17
- | Motion | On by default: HTML slide-in transitions + staggered bullet entrances; native PPTX fade transitions + click-to-reveal bullets. `motion: 'off'` / `--motion off` for a fully static deck |
18
- | Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
19
- | `dsh-ppt` skill | A complete six-step SOP registered into DSH |
20
- | Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
21
- | Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
16
+ | `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and accepts `referencePptx` + `cloneStructure: true` for deep palette, chrome & skeleton cloning |
17
+ | `ppt_absorb` tool | Read-only local extraction of OOXML modified palette colors, fonts, aspect ratio, chrome geometry (`extractedSkeleton`, `recommendedChrome`), slide sequence (`slideSkeleton[]`), and optional logo from a reference `.pptx` |
18
+ | `ppt_themes` tool | Lists all 18 built-in themes (12 daylight + 6 dark) paired with 6 chrome skeletons; pass `preview: true` with `outputDir` to generate a side-by-side HTML gallery and SVG palette cards |
19
+ | 24 layouts & diagrams | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` / `gantt` / `architecture` / `harvey` / `tam` / `org` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus `waterfall`, `gallery`, and `flywheel` aliases) |
20
+ | 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `highlight` focal emphasis |
21
+ | `ppt_templates` | 16 scenario blueprints: `weekly`, `defense`, `project`, `pitch`, `consulting`, `keynote`, `gov-report`, `workshop`, `architecture-review`, `financial-earnings`, `medical-case`, `postmortem`, `marketing-campaign`, `promotion-review`, `legal-compliance`, `creative-lookbook` |
22
+ | `ppt_edit` / `ppt_undo` | Edit selected slides, switch deck `theme` / `brand` / `referencePptx`, append/duplicate/remove/reorder slides with 20-step undo and revision guards |
23
+ | `ppt_check` | Read-only layout & aesthetic density check (including action-title, bullet overload, and monotony hints) plus optional render-receipt verification |
24
+ | `ppt_render` | Optional official LibreOffice Kit PNG / PDF page rendering with missing-font diagnostics |
25
+ | `ppt_data` | Optional source lineage updates and what-if simulation with diff preview before saving; see [data guide](DATA.md#english) |
26
+ | Visual review & repair | Optional rendered-PPTX inspection (up to 24 original slides) with 12 lossless repair actions and re-render verification; see [visual guide](VISUAL.md#english) |
27
+ | Coaching & rehearsal | Optional storyline (SCQA / Pyramid / Action Titles), expression, logic & evidence pre-review (up to 8 findings) and 7-persona Q&A rehearsal; see [coaching guide](COACHING.md#english) |
28
+ | Speaker notes & motion | `<!-- note: ... -->` or `notes` field synced to HTML presenter view (`V`/`S`) and native PPTX notes; motion on by default (`motion: 'off'` / `--motion off` for static) |
29
+ | `dsh-ppt` skill & CLI | Full Auto-Director SOP registered in DSH, or copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for standalone cross-harness builds |
22
30
 
23
31
  Example:
24
32
 
25
- > Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
33
+ > Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", and automatically pick an executive-ready daylight theme.
26
34
  >
27
- > Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
35
+ > Match the palette and fonts of `assets/company-template.pptx`, and turn `docs/quarterly-review.md` into an editable PPTX with KPI cards, a waterfall chart, and booktabs tables.
28
36
 
29
37
  ## Installation
30
38
 
@@ -32,7 +40,7 @@ Example:
32
40
  dsh plugin --profile web add dsh-ppt
33
41
  ```
34
42
 
35
- On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load eight tools and the skill. Ask naturally to include screenshots/charts, edit only slide three, or undo the last edit; users do not need to write JSON. Optional `ppt_data` previews and confirms source/assumption changes; see the [data guide](DATA.md#english).
43
+ On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load all nine tools and the `dsh-ppt` skill. Ask naturally to match a reference template, include screenshots/charts, switch slide 3 to a 3-pillar card layout, or undo the last edit; users never need to hand-write JSON.
36
44
 
37
45
  ## Uninstall
38
46
 
@@ -47,60 +55,66 @@ Then restart the web service. To clean up fully, also remove the plugin entry fr
47
55
  ### Inside DSH (recommended)
48
56
 
49
57
  ```
50
- 1. ppt_themes { preview: true, outputDir: "dist" } # themes + gallery
58
+ 1. ppt_themes { preview: true, outputDir: "dist" } # inspect 18 themes + gallery
51
59
  2. ppt_create {
52
- title: "Fewer Meetings",
53
- content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
54
- theme: "data",
60
+ title: "Q3 Operations Review & Next Steps",
61
+ content: "# Executive Summary\n> [!TAKEAWAY] First-response time dropped to 8s while net retention rose +4.2 pts\n\n::: kpi\n- 8s | First response | -64% QoQ\n- 98.5% | SLA attainment | +4.2 pts\n:::",
62
+ theme: "auto",
55
63
  lang: "en"
56
64
  }
57
- 3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
65
+ 3. Open the returned HTML path in a browser, edit the PPTX in PowerPoint / WPS / Keynote, or refine in the Presentations workbench
58
66
  ```
59
67
 
60
68
  ### Any harness (standalone SKILL.md)
61
69
 
62
- Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
70
+ Copy `skills/dsh-ppt/` to any Agent Skills directory, run `npm install --ignore-scripts` inside it, then:
63
71
 
64
72
  ```bash
65
73
  node <skill-dir>/scripts/build-deck.mjs \
66
74
  --title "Product Launch" \
67
75
  --content deck.md \
68
- --theme data \
76
+ --theme auto \
69
77
  --lang en \
70
78
  --out dist/deck
71
79
  ```
72
80
 
73
- Artifacts:
81
+ The standalone CLI also supports `--absorb ref.pptx`, `--reference-pptx ref.pptx`, `--clone-structure`, and `--chrome consulting-classic` (when `--theme` is omitted on the bare CLI, `data` remains the backward-compatible default).
74
82
 
75
- Existing artifacts are not overwritten by default: if any member of the trio already exists, the whole set receives a shared `-1`, `-2`, ... suffix. Replacement requires explicit `overwrite: true` (or `--overwrite` in the CLI).
83
+ Artifacts (existing files are never overwritten by default; colliding sets receive `-1`, `-2`, ... suffixes unless `overwrite: true` or `--overwrite` is passed):
76
84
 
77
85
  | File | Purpose |
78
86
  | --- | --- |
79
- | `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with real current/next previews, thumbnail strip, notes, timer, progress, pause, font size, blank screen), S notes, G thumbnail overview, F fullscreen, P print, ? shortcuts, Esc close |
80
- | `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
81
- | `*.json` | Structured manifest (version, theme, language, slides) |
87
+ | `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with current/next previews, thumbnail strip, notes, timer, progress, pause, font size, blank screen), S notes, G thumbnail overview, D what-if data panel, F fullscreen, P print, ? shortcuts, Esc close |
88
+ | `*.pptx` | Editable 16:9 presentation with native shapes, structured cards, tables, embedded images, and native editable OOXML charts + workbooks |
89
+ | `*.json` | Structured project manifest (schemaVersion, theme, brand, assets, stable slide IDs, up to 20 undo steps, quality report) |
82
90
 
83
- ## Images, charts, editing and review
91
+ ## Workbench, structured layouts, charts and review
84
92
 
85
- ### Lightweight Settings editor (0.8.0)
93
+ ### Presentations Workbench & Style Studio
86
94
 
87
- Open Settings → Presentations and choose a project registered by `ppt_create`, `ppt_edit` or `ppt_check`. Select a page to edit text, bullets and speaker notes; clicking text in the HTML preview focuses its field. Upload PNG/JPEG images, reorder, duplicate or delete slides and undo changes. Copies preserve images, charts and notes. The last slide cannot be deleted; the limit is 120 slides. Save or cancel pending edits before changing slide structure. Saving regenerates HTML, PPTX and JSON together.
95
+ Open the native sidebar **Presentations** workbench (or **Settings → Presentations**) and select a project registered by `ppt_create`, `ppt_edit` or `ppt_check`:
88
96
 
89
- Save or cancel pending changes before switching pages, reordering, downloading or rendering. A stale revision cannot overwrite another writer's changes. Use “Load latest, keep my input”, review overlapping fields, then explicitly save. The HTML preview and actual PPTX rendering are separate; edits invalidate previous renders. Review every rendered page and font diagnostics before downloading the latest files. The editor works with this plugin's own JSON projects; it does not import arbitrary external PPTX files, and ordinary generation/editing does not need the optional renderer.
97
+ - **Content inspector & 1-click archetype switching**: Slide cards in the left rail show layout badges and per-slide quality status dots, plus **+ New slide** starter archetypes (including Gantt, Architecture, Harvey, TAM, Org), reorder, duplicate, delete (keeping 1–120 slides), and undo. At the top of the inspector, switch across all 24 archetypes, variants, per-slide `chrome` skeletons, and density modes (`compact | balanced | airy`) with lossless draft projection across bullets, structured `items` (including Gantt `start`/`span`, `columns`, `role`, `conversion`), and `rows`; edit KPI/card fields, switch `tableStyle` (`consulting | booktabs | minimal | banded | harvey`), and edit `takeaway` callouts and `source` footnotes.
98
+ - **Style Studio**: Browse Daylight (12) vs Dark (6) themes with live palette swatches and scenario tags, switch across **6 Master Chrome Skeletons** (`brand.chromeStyle`), apply a new deck theme in 1 click, customize brand colors/fonts/footer/PNG-or-JPEG logo, or drag-and-drop a `.pptx` (`≤10 MiB`, decoded in memory with zero host path reads) to preview `recommendedChrome`, `extractedSkeleton`, `slideSkeleton`, and apply its extracted palette and recommended theme.
99
+ - **Side-by-side split & clickable findings**: Toggle between HTML preview, rendered PPTX PNGs, and **HTML + PPTX side-by-side** comparison; click any quality finding row to jump straight to that slide.
100
+ - **Concurrency & asset safety**: Saving regenerates HTML, PPTX, and JSON atomically. Stale revisions return HTTP 409 so another writer's edits are never overwritten; choose “Load latest, keep my input” to reconcile before saving. Uploaded PNG/JPEG images are capped at 5 MiB each (switching slides or cancelling aborts in-flight reads). The workbench edits this plugin's own JSON projects and does not import arbitrary external PPTX slides for text editing.
90
101
 
91
- The additional tools are `ppt_templates`, `ppt_edit`, `ppt_undo`, `ppt_check`, and `ppt_render`. New layouts are `image`, `image-left`, `image-right` and `chart`, alongside the seven existing layouts.
102
+ ### Structured slides, media and charts
92
103
 
93
- An image slide accepts `image: {src, alt, fit: "contain"|"cover", caption}`. Use local PNG/JPEG paths relative to session cwd or matching data URIs. Assets are embedded in all outputs and undo works after original files move. Limits: 5 MiB / 32 megapixels per image, 32 MiB total project assets. Remote links and SVG are not automatically downloaded or converted.
104
+ Structured `slides` support all 24 canonical layouts & pro diagrams:
94
105
 
95
- A chart accepts `chart: {kind:"column"|"bar"|"line"|"pie", categories, series:[{name,values}], unit, caption}` or `rows` with a category/series header. Values must be finite with matching lengths. Pie requires one nonnegative series with a positive total. HTML uses accessible SVG and data tables; PPTX contains native charts and embedded editable workbooks.
106
+ - **Structured cards / KPI / comparison / matrix / process / Gantt / architecture / TAM / org**: Supply up to 8 `items` (`{ tag, title, text, value, unit, delta, start, span, milestone, role, conversion, status, bullets }`), Gantt `columns: ["Q1","Q2","Q3","Q4"]`, plus optional `chrome`, `takeaway`, and `source`.
107
+ - **Harvey-ball matrix & tables** (`harvey | table`): Supports `tableStyle: "consulting" | "booktabs" | "minimal" | "banded" | "harvey"`; `harvey` renders crisp Harvey-ball / check indicators for `●`, `◕`, `◑`, `◔`, `○`, `✓`, `✗`.
108
+ - **Image slides** (`image | image-left | image-right`): Accept `image: { src, alt, fit: "contain" | "cover", caption }` using local PNG/JPEG paths relative to session cwd or matching data URIs. Assets are embedded in all outputs (limits: 5 MiB / 32 megapixels per image, 32 MiB total project assets; remote URLs and SVGs are not fetched or converted).
109
+ - **Native chart slides** (`chart | chart-split`): Accept `chart: { kind, categories, series: [{ name, values }], unit, highlight, caption }` or `rows` with headers across all 13 chart kinds (`column`, `bar`, `stacked-column`, `stacked-bar`, `percent-column`, `percent-bar`, `line`, `area`, `pie`, `doughnut`, `scatter`, `combo`, `waterfall`). Values must be finite with matching lengths; `pie`/`doughnut` require one nonnegative series with a positive sum. HTML renders accessible SVG + screen-reader tables; PPTX embeds native editable charts and workbooks.
96
110
 
97
- `brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo` and `footer`. Colors are `#RRGGBB`; select a font available on the recipient computer. `template` is `weekly|defense|project|pitch` and does not overwrite a supplied narrative.
111
+ `brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo`, `footer`, and `chromeStyle` (`#RRGGBB` colors; choose recipient-safe fonts). `template` supports all 16 industry blueprints (`weekly | defense | project | pitch | consulting | keynote | gov-report | workshop | architecture-review | financial-earnings | medical-case | postmortem | marketing-campaign | promotion-review | legal-compliance | creative-lookbook`) without overwriting supplied narratives.
98
112
 
99
- Edit example: `{deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"A clearer conclusion",bullets:["Evidence","Next action"]}}]}`. Use `ppt_check` to obtain stable IDs and the revision; `ppt_undo` restores the latest edit including assets/brand. Keeps up to 20 edits and rejects stale revisions. The artifact trio is regenerated atomically with rollback on commit failure.
113
+ Edit & structure examples:
114
+ - Content + theme update: `{ deckPath: "report.json", expectedRevision: 0, theme: "consulting", edits: [{ slide: 3, patch: { layout: "kpi", title: "All core SLA targets exceeded plan", takeaway: "Net retention improved +4.2 pts QoQ" } }] }`
115
+ - Structural edit: `{ deckPath: "report.json", expectedRevision: 0, duplicate: [2], remove: [4], append: [{ layout: "callout", title: "Immediate next actions" }] }` (keeps 1–120 slides, up to 20 undo steps, atomic trio commit with rollback on failure).
100
116
 
101
- Structure example: `{deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`. References use the original 1-based slide numbers or stable IDs. Copies follow the source slide with new IDs; existing slides keep theirs. A slide cannot be copied and removed in the same request. Keep 1–120 slides. Text edits, reordering and structural changes can share one undo step.
102
-
103
- `deliveryStatus: draft` means unfilled slots; `ready-for-review` means review can start. Static estimates, rendering and visual inspection are recorded separately. Generation/rendering never automatically certifies visual quality. Inspect HTML and every page image before delivery.
117
+ `deliveryStatus: draft` indicates unfilled template slots; `ready-for-review` means review can start. Static estimates, rendering, and visual inspection are recorded separately—always inspect HTML and rendered page images before final delivery.
104
118
 
105
119
  ## Optional PNG/PDF renderer
106
120
 
@@ -116,31 +130,64 @@ The exact optional peer is not a mandatory engine download for ordinary consumer
116
130
 
117
131
  This repository's pnpm overrides are not inherited by consumers. If an installed renderer's audit reports `fflate@0.8.2`, set `overrides: { "@deepseek-ai/libreoffice-kit": { "fflate": "0.8.3" } }` in the consumer's root package.json (npm), or `overrides: { "@deepseek-ai/libreoffice-kit>fflate": "0.8.3" }` in its root pnpm-workspace.yaml, then reinstall. The plugin also validates PPTX/ZIP64 bounds before rendering; that check does not replace updating the underlying dependency.
118
132
 
119
- CLI supports `--slides @slides.json`, `--brand @brand.json`, `--template weekly`, `--edit report.json --edits @edits.json --revision 0`, `--undo report.json --revision 1`, `--check report.json`, and `--render report.pptx --format both`. Explicit receipt validation uses `--check report.json --render-receipt path/to/render-receipt.json`; failure returns a nonzero exit code.
133
+ CLI supports `--slides @slides.json`, `--brand @brand.json`, `--reference-pptx ref.pptx`, `--absorb ref.pptx`, `--template consulting`, `--edit report.json --edits @edits.json --revision 0`, `--undo report.json --revision 1`, `--check report.json`, and `--render report.pptx --format both`. Explicit receipt validation uses `--check report.json --render-receipt path/to/render-receipt.json`; failure returns a nonzero exit code.
134
+
135
+ For standalone usage copy the entire skill directory and run `npm install --ignore-scripts` there. Plain text remains usable without Office Kit; image/chart/logo/footer PPTX export needs Office Kit 0.21.0. `dsh-ppt/deck-advanced` exports `buildDeckAsync`, `editDeck`, `undoDeck`, `checkDeckAsync`, `renderDeck`, and `absorbPptx`. The legacy synchronous `deck-core` API supports plain text and explicitly rejects unsupported media inputs.
136
+
137
+ ## Built-in themes (18 palettes) & 6 Chrome Skeletons
138
+
139
+ ### 6 Master Chrome Skeletons (`chromeStyle`)
120
140
 
121
- For standalone usage copy the entire skill directory and run `npm install --ignore-scripts` there. Plain text remains usable without Office Kit; image/chart/logo/footer PPTX export needs Office Kit 0.21.0. `dsh-ppt/deck-advanced` exports `buildDeckAsync`, `editDeck`, `undoDeck`, `checkDeckAsync` and `renderDeck`. The legacy synchronous `deck-core` API supports plain text and explicitly rejects unsupported media inputs.
141
+ | ID | Name | Structural geometry | Default themes |
142
+ | --- | --- | --- | --- |
143
+ | `consulting-classic` | Consulting Classic | 0px sharp cards, left vertical accent rule, top-right section tracker, 0.75pt header rule | `consulting`, `cobalt-cream`, `financial-ft` |
144
+ | `keynote-spatial` | Keynote Spatial | Divider-free header, airy margins, 16pt borderless surface cards, minimal takeaway caption | `keynote-light`, `bold` |
145
+ | `editorial-folio` | Editorial Folio | Full-width top running folio, page number top-right, 0px borders, display serif numerals | `editorial-forest`, `cartesian`, `velvet`, `luxury-noir` |
146
+ | `saas-bento` | SaaS Bento | 10pt rounded `surface1` cards with hairline stroke, primary accent focus, monospace pills | `linear-dark`, `swiss`, `data`, `soft` |
147
+ | `academic-minimal` | Academic Beamer | Full-width Beamer tinted header band (`13.333"`) + 3-zone academic footer status bar | `academic`, `course-sage`, `medical-clean` |
148
+ | `gov-ceremonial` | Gov Ceremonial | Double-rule header (`1.5pt` + `0.5pt`), bracketed chapter tag, symmetric warm-paper cards | `exec-jilan`, `exec-palace` |
149
+
150
+ ### Daylight themes (12 — recommended for bright rooms, print, consulting, medical, academic & executive reviews)
122
151
 
123
- ## Theme palette
152
+ | ID | Name | Mood | Best for |
153
+ | --- | --- | --- | --- |
154
+ | `consulting` | Strategy Navy (`auto` business default) | Authoritative / crisp | Management consulting, strategy reviews, board & operations decks |
155
+ | `cobalt-cream` | Blue Professional | Paper-warm / modern | Product proposals, B2B pitches, research & technical briefs |
156
+ | `exec-jilan` | Imperial Slate | Poised / institutional | Enterprise briefings, public-sector reviews, formal alignments |
157
+ | `exec-palace` | Palace Vermilion | Ceremonial / dignified | Institutional summaries, annual reviews, keynote ceremonies |
158
+ | `academic` | ETH & Nature | Clean / scholarly | Thesis defenses, grant proposals, research seminars |
159
+ | `editorial-forest` | Editorial Forest | Thoughtful / narrative | Industry whitepapers, ESG reports, research essays |
160
+ | `cartesian` | Cartesian Stone | Minimal / geometric | Architecture reviews, engineering postmortems, methodology decks |
161
+ | `course-sage` | Workshop Sage | Calm / legible | Workshops, lectures, training handouts |
162
+ | `soft` | Soft Signal | Warm / human | Brand stories, enablement, team talks |
163
+ | `keynote-light` | Cupertino Spatial | Pure / airy | Product keynotes, flagship launches, Apple-inspired briefs |
164
+ | `financial-ft` | FT Salmon | Editorial / financial | Earnings releases, investor briefings, macro research |
165
+ | `medical-clean` | Clinical Teal | Crisp / clinical | Clinical case reviews, biotech/pharma R&D, healthcare boards |
166
+
167
+ ### Dark themes (6 — recommended for keynotes, dark venues, luxury curation & technical demos)
124
168
 
125
169
  | ID | Name | Mood | Best for |
126
170
  | --- | --- | --- | --- |
127
- | `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
128
- | `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
129
- | `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
130
- | `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
131
- | `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
171
+ | `data` | Data Drift (CLI fallback default) | Futuristic / immersive | AI launches, live telemetry, technical showcases |
172
+ | `swiss` | Swiss Pulse | Precise / rational | Data reports, SaaS products, developer tools |
173
+ | `velvet` | Velvet Standard | Premium / restrained | Investor pitches, luxury brand briefings |
174
+ | `bold` | Maximalist Type | Loud / kinetic | Keynotes, big announcements, event openers |
175
+ | `linear-dark` | Obsidian Keynote | Sharp / modern | Modern software launches, startup pitch decks |
176
+ | `luxury-noir` | Atelier Noir | Opulent / editorial | Creative lookbooks, luxury curation, flagship showcases |
132
177
 
133
- Themes are derived from [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) `visual-styles.md`. Full palettes: `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for a side-by-side gallery and SVG palette cards.
178
+ Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for an 18-theme side-by-side HTML gallery and SVG palette cards.
134
179
 
135
180
  ## Markdown input rules
136
181
 
137
182
  - The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
138
- - Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
139
- - Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
140
- - A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
141
- - Long tables paginate automatically with repeated headers and up to 8 data rows per page. Notes stay on the first page. Tables support 8 columns and 60 characters per cell; oversized input returns an actionable error. Short rows are padded consistently in all artifacts.
183
+ - Each `## section` becomes a slide: standard lists, quotes, and tables are recognized automatically, alongside fenced semantic directives:
184
+ - `::: kpi`, `::: cards`, `::: comparison`, `::: matrix`, `::: process`, `::: callout`, `::: agenda`, `::: gantt`, `::: architecture`, `::: harvey`, `::: tam`, `::: org` → parsed directly into structured cards, pro diagrams, or Harvey-ball matrices.
185
+ - `> [!TAKEAWAY] Single-sentence conclusion` → extracted into the slide's bottom `takeaway` callout bar.
186
+ - `<!-- source: ... -->` / `<!-- 来源: ... -->` → extracted as `source` footnote; `<!-- note: ... -->` → extracted as speaker `notes`.
187
+ - Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide; a single sentence produces a complete 3-slide structure (cover → statement → closing).
188
+ - Long tables paginate automatically with repeated headers and up to 8 data rows per page (`notes` stay on the first page; `tableStyle` supports `consulting | booktabs | minimal | banded | harvey`). Short rows are padded consistently across all artifacts.
142
189
  - `maxSlides` counts pages after expansion. Exceeding it fails before writing files; raise the limit (up to 120) or split the deck. Middle slides are never silently discarded.
143
- - For precise control, use structured `slides` (`cover | section | bullets | statement | quote | table | closing`), with `rows` for tables and `notes` for speaker notes.
190
+ - For exact per-slide control, pass structured `slides` using any of the 24 `layout` values, `chrome`, `columns`, `items`, `rows`, `chart`, `image`, `takeaway`, `source`, and `notes`.
144
191
 
145
192
  ## Configuration
146
193
 
@@ -151,7 +198,7 @@ No required configuration. Optional:
151
198
  config:
152
199
  outputDir: E:\decks # optional; defaults to the session working directory
153
200
  maxSlides: 40 # optional; default 60 (3–120)
154
- defaultTheme: data # optional; used when ppt_create has no theme
201
+ defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the 18 theme IDs)
155
202
  defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
156
203
  ```
157
204
 
@@ -168,26 +215,26 @@ Relative paths and configured output directories resolve per session cwd without
168
215
  ## Engineering quality
169
216
 
170
217
  - Tools and the skill share an asynchronous generator. The legacy synchronous plain-text API remains available.
171
- - Images and native charts use MIT-licensed `@office-kit/pptx@0.21.0`; optional rendering is loaded on demand.
172
- - Unit tests cover registration contracts, JSON Schema, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
218
+ - Images and native charts use MIT-licensed `@office-kit/pptx@0.21.0`; reference `.pptx` absorption uses safe local `fflate` + OOXML parsing with ZIP-bomb and path-traversal guards; optional rendering is loaded on demand.
219
+ - Unit tests cover registration contracts, JSON Schema, 18 themes, 6 chrome skeletons & auto-direction, 24 layouts & pro diagrams, 16 industry blueprints, 13 chart kinds, deep `.pptx` absorption (`cloneStructure`), artifact generation, PPTX part integrity, workbench security bounds, and the CLI.
173
220
  - No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
174
221
 
175
222
  ## Development
176
223
 
177
224
  ```sh
178
225
  pnpm install
179
- pnpm run build # tsc → lib/
180
- pnpm test # build + node --test (registration/config/engine/CLI)
226
+ pnpm run build # tsc + client workbench bundle → lib/
227
+ pnpm test # build + node --test (registration/config/engine/charts/absorb/workbench/CLI)
181
228
  pnpm run smoke:cli # bare CLI smoke test, generates .smoke-deck
182
229
  ```
183
230
 
184
231
  ## Known limitations
185
232
 
186
- - The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
187
- - A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
188
- - `bilingual` only localizes the player UI; it does not translate content.
233
+ - PPTX slides use positioned native shapes, tables, charts, and text boxes: text and chart workbooks are editable in PowerPoint / WPS / Keynote, without complex master-placeholder inheritance chains.
234
+ - `ppt_absorb` and `referencePptx` (including `cloneStructure`) extract colors, fonts, slide aspect ratio, chrome geometry, and slide layout skeletons; they do not copy third-party slide copy verbatim.
235
+ - `bilingual` localizes the player and workbench UI; it does not translate authored slide content.
189
236
  - Selected-page editing supports this plugin's JSON project, not arbitrary external PPTX editing.
190
- - Text fit checks are static estimates; inspect actual rendered output for clipping and font substitution.
237
+ - Static checks estimate text fit and visual density; inspect rendered page images for exact font substitution and clipping.
191
238
 
192
239
  ## License
193
240