Skip to content

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.md
index 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.py
index 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.py
index 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.py
index 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 WorkspaceResourceSpec
from pptx_ooxml.clone import clone_presentation_slides
from pptx_ooxml.package import prune_unreferenced_directory_parts
-from language_tags import office_language_tag
+from language_tags import language_uses_rtl, office_language_tag
from 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:
continue
xml = 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.md
index 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 creation
diff --git a/skills/ppt-master/templates/layouts/report_core/templates/design_spec.md b/skills/ppt-master/templates/layouts/report_core/templates/design_spec.md
index 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 Roster
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index 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 |