AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(svg-authoring): clarify optional nested edit groups
hugohe3c7d8b05bedcf
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex e6811d68..3ece3e21 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -131,6 +131,7 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`- **Proximity**: group related elements with tight spacing; separate unrelated groups- **Element grouping (Mandatory)**: wrap each logical Slide-local body unit in a descriptive, page-unique top-level `<g id>`. Every visible direct root `<g>` declares root-coordinate `data-pptx-bounds="x y width height"`; frame/native coordinates do not replace it, and placeholder bounds also supply the slot frame. Nested groups need no bounds and any such values are ignored. Checker compares root bounds with the `viewBox` and recursively checks only estimable text against its root module: through `1px` is ignored, through `5%` warns, above `5%` fails per side. Images, shapes, paths, `<use>`, effects, and object frames remain geometrically free. Flat pages use ordinary groups; structured slots already qualify, while titles, direct Master/Layout atoms, and canvas-level static framing may remain root primitives. On flat pages, give a root background image or full-canvas scrim/decoration rectangle a stable `id` plus `data-pptx-role="background"` / `"decoration"`; never wrap it only to silence the advisory.+- **Reference — not a constraint**: top-level groups set semantic and automatic-animation granularity, but they may contain descriptive nested `<g>` edit groups when the page has meaningful internal subunits. Nested groups need no bounds and create no automatic animation step; use or omit them from the page's actual editing semantics, with no default pattern, depth, or quota.- **Default — size `data-pptx-bounds` as the intended module zone, not a glyph box (may skip when no text is estimable)**: make the zone as generous as the canvas and sibling layout allow, without overlapping another module zone. An untransformed line spans `y - 0.85 × font_size` to `y + 0.35 × font_size`; width uses the shared SVG-to-PPTX per-run estimate and safety headroom. If text does not fit, first expand a zone that has unused non-overlapping space; otherwise reflow or adapt. Larger bounds do not repair off-canvas text.- **Spec adherence**: follow color, layout, canvas format, and typography in the spec- **Template structure**: inherit the native visual framework only for `template_reuse_scope: mirror|layout`; `style` uses the flat routediff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.mdindex 3311b6b0..f2026642 100644--- a/skills/ppt-master/references/shared-standards-core.md+++ b/skills/ppt-master/references/shared-standards-core.md@@ -587,6 +587,14 @@ These forms are needed only when the stated PPT behavior matters:Wrap each logical Slide-local body unit in one descriptive top-level `<g id>`; group count follows the page's semantic units, and each group becomes one animation step when animation is enabled. Nested implementation groups may remain anonymous and need no bounds; any nested bounds are ignored. Flat pages use ordinary groups; structured slots already qualify, while titles, direct atomic Master/Layout elements, and canvas-level static framing—including background images and full-canvas scrim/decoration rectangles—may remain root primitives. On flat pages, give such static framing a stable `id` plus `data-pptx-role="background"` / `"decoration"`; never add a `<g>` solely to silence an ungrouped-element advisory.+**Reference — not a constraint**: A top-level semantic group may contain+descriptive nested `<g>` edit groups when its internal elements form useful+subunits, such as icon + title, value + label, or repeated information rows.+Nested groups carry no `data-pptx-bounds` and create no automatic animation+step; an unnecessary one-child wrapper may flatten. Choose whether and how+deeply to nest from the page's actual editing semantics—there is no default+nesting pattern, level, or quota.+**Structural atoms and slots are excluded automatically.** `data-pptx-layer` and `data-pptx-placeholder` semantics are read first; otherwise explicit `data-pptx-role` values (`background`, `decoration`, `header`, `footer`, `chrome`, `watermark`, `page-number`, `logo`) mark Slide-local static framing (§4.1, [`semantic-svg.md`](semantic-svg.md)). A normal slot group has exactly one direct compatible carrier; several drawing atoms require the explicit composite `object` proxy fallback. Native chart/table carrier groups retain their specialized [`native-data-interface.md`](./native-data-interface.md) contract.**What to group** (one `<g id>` per unit):@@ -610,7 +618,7 @@ separate parent content group; never put them inside the preset group itself.- One giant `<g>` around the whole slide (collapses to a single animation step).- Many ungrouped Slide-local `<rect>` / `<text>` / `<path>` atoms — they have no stable sidecar target and selection/editing degrades. Primitive fallback applies only when the root contains no top-level `<g>` at all; it is capped at 8 visible primitives.-- One group per icon / text line / mark (too many steps).+- One top-level group per icon / text line / mark (too many animation steps).- Anonymous top-level groups — every top-level semantic group needs a descriptive `id`.**Naming — required.** A descriptive, page-unique `id` on every top-level content `<g>` (`card-1`, `step-discover`, `header`, `footer`) is mandatory; it is the stable SVG-side animation and trace anchor. An anonymous top-level group still converts, but `animations.json` cannot reference it; an anonymous one-child implementation wrapper may also flatten. Primitive fallback is unrelated and applies only to roots with no top-level groups.@@ -620,8 +628,10 @@ separate parent content group; never put them inside the preset group itself.<!-- Shadow only if the card floats over a colored panel; on flat white, omit it. --><rect x="60" y="115" width="565" height="260" rx="20" fill="#FFFFFF" filter="url(#shadow)"/><use data-icon="chunk-filled/bolt" x="108" y="163" width="44" height="44" fill="#0071E3"/>- <text x="105" y="270" font-size="56" font-weight="bold" fill="#0071E3">10×</text>- <text x="250" y="270" font-size="30" font-weight="bold" fill="#1D1D1F">Faster</text>+ <g id="card-benefits-metric">+ <text x="105" y="270" font-size="56" font-weight="bold" fill="#0071E3">10×</text>+ <text x="250" y="270" font-size="30" font-weight="bold" fill="#1D1D1F">Faster</text>+ </g><text x="105" y="310" font-size="18" fill="#6E6E73">Reduce production time from days to hours.</text></g>```