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
fix: structured decks animate slot groups, re-skin master atoms, and name their native-only slots
hugohe3529403b32b15
diff --git a/skills/ppt-master/references/native-data-interface.md b/skills/ppt-master/references/native-data-interface.mdindex 73a498a3..03c661bd 100644--- a/skills/ppt-master/references/native-data-interface.md+++ b/skills/ppt-master/references/native-data-interface.md@@ -34,7 +34,7 @@ python3 ${SKILL_DIR}/scripts/stamp_native_fallbacks.py "<svg-file-or-directory>"The hash is a synchronization receipt, not proof of semantic equivalence; never stamp stale JSON to satisfy validation.-**Hard rule — activation is the opt-in**: a marker only declares eligibility. Normal `svg_to_pptx.py` converts the fallback children into editable DrawingML shapes; `--native-charts-and-tables` emits the PowerPoint Chart/Table object and discards the fallback children, so everything the fallback shows lives in the payload — data, point emphasis, line/area treatment, spacing, chrome, and companion text — and the final checker's parity findings block that export until they do. A convertible marker stays even when a detail has no native field: it becomes companion text or an unmarked sibling object, never a simpler drawing.+**Hard rule — activation is the opt-in**: a marker only declares eligibility. Normal `svg_to_pptx.py` converts the fallback children into editable DrawingML shapes (a structured `chart` / `table` placeholder slot has no shape path and needs the flag); `--native-charts-and-tables` emits the PowerPoint Chart/Table object and discards the fallback children, so everything the fallback shows lives in the payload — data, point emphasis, line/area treatment, spacing, chrome, and companion text — and the final checker's parity findings block that export until they do. A convertible marker stays even when a detail has no native field: it becomes companion text or an unmarked sibling object, never a simpler drawing.| Replacement marker | Native output | Required metadata ||---|---|---|diff --git a/skills/ppt-master/scripts/svg_quality/checker.py b/skills/ppt-master/scripts/svg_quality/checker.pyindex 442c8f04..a3b38aeb 100644--- a/skills/ppt-master/scripts/svg_quality/checker.py+++ b/skills/ppt-master/scripts/svg_quality/checker.py@@ -1187,6 +1187,7 @@ class SVGQualityChecker:self._communication_traced_projects: set[Path] = set()self._pptx_structure_issues: List[Tuple[str, str]] = []self._has_incomplete_page_roster = False+ self._structured_native_slots: list[str] = []self._active_slide_count: int | None = None# Early/page stages see part of the roster, so a slide jump's upper# bound waits for the final gate.@@ -1459,6 +1460,7 @@ class SVGQualityChecker:project_path = Path(workspace).resolve()authoring_dir = project_path / 'authoring-svg-flat'self._has_incomplete_page_roster = False+ self._structured_native_slots: list[str] = []if not project_path.is_dir():print(f"[ERROR] Round-trip workspace does not exist: {project_path}")self.summary['errors'] += 1@@ -6790,6 +6792,7 @@ class SVGQualityChecker:"""dir_path = Path(directory)self._has_incomplete_page_roster = False+ self._structured_native_slots: list[str] = []self._undeclared_size_occurrences = Counter()self._undeclared_size_counts_ready = False@@ -7233,6 +7236,12 @@ class SVGQualityChecker:self._pptx_structure_issues.append(('error', str(exc)))return+ self._structured_native_slots = sorted({+ str(item.placeholder)+ for spec in specs+ for item in spec.placeholders+ if item.placeholder in {'chart', 'table'}+ })if complete_roster:actual_slides = {spec.slide_num for spec in specs}expected_slides = {diff --git a/skills/ppt-master/scripts/svg_quality/cli.py b/skills/ppt-master/scripts/svg_quality/cli.pyindex b7adb96d..41352e38 100644--- a/skills/ppt-master/scripts/svg_quality/cli.py+++ b/skills/ppt-master/scripts/svg_quality/cli.py@@ -281,6 +281,13 @@ def main() -> None:checker.check_directory(check_target, expected_format)if not roundtrip and stage == "final" and Path(target).is_dir():+ if checker._structured_native_slots:+ print(+ "[TIP] Structured "+ + "/".join(checker._structured_native_slots)+ + " placeholder slot(s) are filled by native objects: export "+ "with --native-charts-and-tables (the standard export refuses them)."+ )if checker._has_incomplete_page_roster:print("[TIP] This final-stage run found an incomplete page roster. "diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.pyindex 32958329..4dbbd3a9 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py@@ -71,7 +71,7 @@ from pptx_opc_validation import (from pptx_workspace import WorkspaceResourceSpecfrom pptx_ooxml.clone import clone_presentation_slidesfrom pptx_ooxml.package import prune_unreferenced_directory_parts-from language_tags import office_language_tag+from language_tags import language_uses_rtl, office_language_tagfrom hyperlink_contract import (HYPERLINK_REL_TYPE,trigger_shape_hyperlink_errors,@@ -3004,6 +3004,9 @@ def _unwrap_placeholder_carrier(state.shapes.pop(wrapper_id, None)if carrier_id:state.shapes[carrier_id] = carrier+ if wrapper_id and carrier_id:+ # An animation that names the slot group now targets its carrier.+ _rewrite_roundtrip_timing_shape_ids(state.root, {wrapper_id: carrier_id})return carrier@@ -3284,6 +3287,7 @@ def _move_template_static_shape(target_path: Path,target_rels_path: Path,slide_size_emu: tuple[int, int],+ public_slide_count: int | None = None,) -> str | None:shapes = [_template_shape_for_item(state, item) for state in states]if any(shape is None for shape in shapes):@@ -3306,12 +3310,21 @@ def _move_template_static_shape(f"{item.element_id!r} must compile to one exact p:bg payload")return background_xml+ # Internal Layout carriers compile unused prototypes as authored; their+ # copy of a master atom leaves with the carrier slide, so the published+ # pages alone decide the atom (a re-skinned rule must not be refused+ # because an unused prototype still carries the original paint).+ reference = [+ (state, shape)+ for state, shape in zip(states, resolved_shapes)+ if public_slide_count is None or state.spec.slide_num <= public_slide_count+ ] or list(zip(states, resolved_shapes))canonical = {_canonical_shape_xml(shape, state.rels)- for state, shape in zip(states, resolved_shapes)+ for state, shape in reference}if len(canonical) != 1:- slide_names = ", ".join(state.spec.svg_path.name for state in states)+ slide_names = ", ".join(state.spec.svg_path.name for state, _shape in reference)raise TemplateStructureError(f"Explicit structure element {item.element_id!r} differs across slides: "f"{slide_names}"@@ -3329,8 +3342,7 @@ def _move_template_static_shape("uses a relationship that cannot move to a template part")- prototype_state = states[0]- prototype_shape = resolved_shapes[0]+ prototype_state, prototype_shape = reference[0]target_shape = _copy_shape_relationships_to_part(prototype_shape,prototype_state.rels,@@ -3923,6 +3935,7 @@ def _apply_explicit_layout_structure(theme_font_spec: ThemeFontSpec | None,*,use_layout_placeholder_frames: bool = False,+ public_slide_count: int | None = None,verbose: bool = False,) -> tuple[dict[str, str | None],@@ -3962,6 +3975,7 @@ def _apply_explicit_layout_structure(master_path,master_rels_path,slide_size_emu,+ public_slide_count=public_slide_count,)if background_xml is not None:expected_backgrounds[master_part] = background_xml@@ -6004,12 +6018,23 @@ def _prerender_legacy_pngs(return results+def _rtl_text_levels(xml: str) -> str:+ """Flip template text-level defaults (``rtl="0"``) to right-to-left."""+ def flip(match: re.Match[str]) -> str:+ tag = match.group(0).replace('rtl="0"', 'rtl="1"')+ return tag.replace('algn="l"', 'algn="r"')++ return re.sub(r'<a:(?:lvl\dpPr|pPr)\b[^>]*\brtl="0"[^>]*>', flip, xml)++def _apply_template_text_language(extract_dir: Path, language: str) -> None:"""Retag base-template en-US default text with the deck language.Covers the presentation default text style (new text boxes) and master and- layout placeholders, so proofing follows the deck rather than en-US.+ layout placeholders, so proofing follows the deck rather than en-US; a+ right-to-left deck also gets right-to-left, right-aligned default levels."""+ rtl = language_uses_rtl(language)ppt_dir = extract_dir / "ppt"parts = [ppt_dir / "presentation.xml"]parts += sorted((ppt_dir / "slideMasters").glob("slideMaster*.xml"))@@ -6019,6 +6044,8 @@ def _apply_template_text_language(extract_dir: Path, language: str) -> None:continuexml = part.read_text(encoding="utf-8")updated = xml.replace('lang="en-US"', f'lang="{language}"')+ if rtl:+ updated = _rtl_text_levels(updated)if updated != xml:part.write_text(updated, encoding="utf-8")@@ -7971,6 +7998,7 @@ def create_pptx_with_native_svg(conversion_trace if conversion_trace is not None else structure_trace,active_theme_font_spec,use_layout_placeholder_frames=use_layout_placeholder_frames,+ public_slide_count=public_slide_count,verbose=verbose,)if source_theme_xml_by_master is not None:diff --git a/skills/ppt-master/templates/layouts/README.md b/skills/ppt-master/templates/layouts/README.mdindex 5322fe17..3a9b404d 100644--- a/skills/ppt-master/templates/layouts/README.md+++ b/skills/ppt-master/templates/layouts/README.md@@ -46,7 +46,7 @@ page_types: [cover, toc, chapter, content, ending]## Structured SVG and slot contract-Every SVG is a complete Slide preview under the contract of [`pptx-structure-interface.md`](../../references/pptx-structure-interface.md) §2; a typed `picture` / `chart` / `table` slot promises no inserted picture or native object — the generated Slide supplies content and native replacement stays an explicit export choice. Use canonical `{{PLACEHOLDER}}` names ([`template-designer.md`](../../references/template-designer.md#4-placeholder-reference-canonical-convention-overridable-per-template)) with a `placeholders:` frontmatter map for overrides. `standard` / `fidelity` author new SVGs and structure; `mirror` preserves source identities, parentage, assignments, placeholder facts, and supported visuals without synthesis; legacy contracts are never upgraded in place, and a flat directory shape alone is not a legacy signal.+Every SVG is a complete Slide preview under the contract of [`pptx-structure-interface.md`](../../references/pptx-structure-interface.md) §2; a typed `picture` slot promises no inserted picture, and a typed `chart` / `table` slot is filled by its native-replacement marker, so a deck that uses one exports only with `--native-charts-and-tables` — the generated Slide supplies the content. Use canonical `{{PLACEHOLDER}}` names ([`template-designer.md`](../../references/template-designer.md#4-placeholder-reference-canonical-convention-overridable-per-template)) with a `placeholders:` frontmatter map for overrides. `standard` / `fidelity` author new SVGs and structure; `mirror` preserves source identities, parentage, assignments, placeholder facts, and supported visuals without synthesis; legacy contracts are never upgraded in place, and a flat directory shape alone is not a legacy signal.## Workspace and creationdiff --git a/skills/ppt-master/templates/layouts/report_core/templates/design_spec.md b/skills/ppt-master/templates/layouts/report_core/templates/design_spec.mdindex 79a5b2c6..7e23e3dc 100644--- a/skills/ppt-master/templates/layouts/report_core/templates/design_spec.md+++ b/skills/ppt-master/templates/layouts/report_core/templates/design_spec.md@@ -60,7 +60,7 @@ decisions.| Tightened frame | Margins are 48 px and the title band is `48 88 1184 56` at 28 px, against a 64 px margin and 36 px title on a breathing general system. The content field runs y 176 to y 640 on every content page. || Rules before containers | Grouping is carried by hairlines wherever it can be: `agenda` separates its five rows with rules and Layout-owned `01`–`05` indices, and `appendix` uses a single column rule with no panel at all. Filled panels appear only where a region genuinely needs a distinct material plane. || Density ladder | Body text steps from 20 px on single-region pages, to 19 px in split panels, to 18 px in step and evidence regions, down to 15 px in `appendix`. Chrome text sits at 12 px. The ladder is what lets one system carry both a synthesis page and a reference page without changing frame. |-| Analytical page types | `kpi_row` places four metrics across the full 1184 px field, which this canvas width supports without compressing them. `matrix_2x2` adds four quadrant slots plus two axis-label slots for positioning arguments. `chart_insight` and `table_summary` declare typed `chart` / `table` slots whose authored groups remain complete SVG fallbacks; optional replacement metadata can materialize PowerPoint-native data objects only when that export path is requested. |+| Analytical page types | `kpi_row` places four metrics across the full 1184 px field, which this canvas width supports without compressing them. `matrix_2x2` adds four quadrant slots plus two axis-label slots for positioning arguments. `chart_insight` and `table_summary` declare typed `chart` / `table` slots whose authored groups remain complete SVG fallbacks; their replacement markers become PowerPoint-native data objects, so a deck that uses either layout exports with `--native-charts-and-tables`. || Text entry | General body and object slots begin at the upper-left. Centered alignment is reserved for KPI values, short process nodes, and the timeline takeaway. |## V. Page Rosterdiff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 9973053d..555916b3 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -353,7 +353,7 @@ python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>| Decision | Flag ||---|---|-| Explicit editable Chart/Table delivery decision | Append `--native-charts-and-tables` (markers, templates, semantic tables, and imported charts never activate it; formulas are always native) |+| Explicit editable Chart/Table delivery decision, or a structured `chart` / `table` placeholder slot | Append `--native-charts-and-tables` (markers, templates, semantic tables, and imported charts never activate it; formulas are always native) || Final checker reports oversized images | Append `--image-sizing display` || Preserved or produced `animations.json` | Keep the base command; the exporter reads the sidecar || Deck-wide motion setting | Append the resolved [`animations.md`](../references/animations.md) flags |