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(technical-design): document baseline native structure
hugohe3cb35d4cff771
diff --git a/docs/technical-design.md b/docs/technical-design.mdindex d205e97b..fd810399 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -427,6 +427,10 @@ These direct routes share some analysis primitives with the main pipeline, espec**Why compatibility fallback belongs to the SVG snapshot path, not native shapes.** Native PPTX export translates supported SVG elements into DrawingML shapes and explicitly disables PNG+SVG compatibility mode in native-shapes mode. The PNG fallback is used only by the legacy SVG-image path (`--svg-snapshot` / `--only legacy`) when a renderer is available, because that path embeds SVG media that older Office builds may not display. Legacy compatibility is therefore an optional snapshot deliverable, not a fallback bundled inside the primary editable native deck.+**Why the default native deck has a baseline master, not inferred templates.** `svg_to_pptx.py` keeps the actual blank slide layout relationship from the base package and defaults to `--pptx-structure baseline`. Baseline promotes only low-risk shared structure: identical slide backgrounds, plus repeated top-level SVG chrome groups whose ids clearly say `logo`, `footer`, `header`, `watermark`, `chrome`, `pageNumber`, or `slideNumber` and whose generated OOXML is identical across slides sharing the same master. Image relationships for promoted chrome are copied to the slide master. This gives ordinary decks real master/layout structure without guessing reusable layouts or placeholders from visual similarity.++**Why native-object round-trip uses markers, not automatic object replacement.** PPTX intake can emit visible SVG fallback plus `data-pptx-native` metadata for supported tables and classic chart cache data. The default export still consumes the fallback as regular DrawingML shapes; only `--native-objects` activates editable PowerPoint tables/charts. Unsupported cases such as merged tables, ChartEx, 3D charts, combo charts, or cache-missing charts keep the preview and carry an explicit unsupported status instead of pretending to round-trip.+---## Animation & Transition Model