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(native-shapes): publish authored preset effect coverage
hugohe3b66f7b61978c
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.mdindex 3ec14821..51e09876 100644--- a/docs/powerpoint-svg-mapping.md+++ b/docs/powerpoint-svg-mapping.md@@ -98,7 +98,7 @@ Internal identifiers and PowerPoint display names are separate concerns: Master| Materialized Merge Shapes result | Ordinary `<path>` output from `shape_boolean_svg.py`; Fragment returns sibling paths | One `p:sp` with `a:custGeom` per returned path | `Native-normalized`; imports as final freeform geometry, not replayable operation history | Supported closed geometry or horizontal implicit-LTR direct text with an exact resolvable font face; text becomes glyph geometry, the first source owns style/order, and no clip, mask, or explicit fill rule is emitted || Polygon | `<polygon>` | Closed custom geometry | `Native-normalized` | Points must be finite and valid || Polyline | `<polyline>` | Open custom geometry | `Native-normalized` | Points use the same finite, registered grammar as other generated geometry |-| PowerPoint preset shape | Registry-generated compact `<g>` with preset intent/base paint and direct visible `<path>` children | One editable preset `p:sp` | Preset identity and adjustments can survive import/export | Quality check and export rerender the registry dynamically; canonical authoring has no hidden carrier, preview wrapper, or stored preview hash |+| PowerPoint preset shape | Registry-generated compact `<g>` with preset intent/base paint, an optional direct reference to one registered shadow/glow filter, and direct visible `<path>` children | One editable preset `p:sp`, with at most one native effect in `p:spPr/a:effectLst` | Preset identity and adjustments can survive import/export; the effect follows the shared fidelity row below | Quality check and export rerender the registry dynamically; authored-preset filter references are shape-only, and canonical authoring has no hidden carrier, preview wrapper, or stored preview hash || Imported preset shape | Expanded import/round-trip group with a hidden native carrier, visible preview evidence, and freshness metadata | Restored preset when the payload is valid and unchanged | `Native-stable` within the import contract | Unsupported presets remain explicit diagnostic fallbacks, not guessed geometry || Action button shape | Compact authored `actionButton*` preset group | Visual preset geometry only | Shape geometry can round-trip | No click action, navigation target, or hyperlink is created || Group | `<g>` | `p:grpSp`, or a documented flatten/collapse for a special carrier | Grouped content can reconstruct as `<g>` | Structural atoms and placeholder contracts override ordinary grouping |diff --git a/docs/roadmap.md b/docs/roadmap.mdindex b6959a3c..b9d5eb4d 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -61,7 +61,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| Grid, alignment, whitespace | Systematized | Shared composition contract plus composition-geometry vocabulary carried by each visual style || Palette | Systematized | Declared HEX values are the truth source for named semantic roles; reusable role anchors stay stable deck-wide, while contextual derivatives and sparse page-local accents remain available || Typography | Systematized | One deck-wide size anchor per structural role, with bounded `±2px` per-occurrence adjustment and a sparse non-structural Hero/Display exception |-| Visual effects | Systematized | Dedicated effects reference; native effects on authored preset shapes remain signal-driven |+| Visual effects | Systematized | Dedicated effects reference; one registered outer shadow or glow compiles to one editable native effect on supported basic objects and compact authored preset shapes || Reading path | Systematized | Entry, progression, hierarchy, and endpoint are planned and qualitatively reviewed per page |### Layer 3 — Behavior@@ -106,7 +106,6 @@ Actively underway or up next — no committed timeline.Candidates already evaluated as "worth doing when real demand shows", listed so the intent is public. None is a commitment.- **Keep closing the native-coverage gaps** recorded in the [mapping guide](./powerpoint-svg-mapping.md) — release after release, move more "SVG-only" cells toward native PowerPoint structure and behavior.-- **Effects on authored preset shapes** (e.g. a native drop-shadow) — waits for a precise preset-effect contract plus checker coverage; until then, a stock shape that needs a shadow conservatively stays ordinary SVG.- **Picture slide backgrounds as native background fill** — solid/gradient page backgrounds already export as PowerPoint-native slide backgrounds; the picture case is demand-driven.---diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.mdindex e27e5a29..3610971e 100644--- a/docs/zh/powerpoint-svg-mapping.md+++ b/docs/zh/powerpoint-svg-mapping.md@@ -98,7 +98,7 @@ PowerPoint 意图| 已物化的合并形状结果 | `shape_boolean_svg.py` 输出的普通 `<path>`;“拆分”返回多个同级 path | 每个返回 path 对应一个带 `a:custGeom` 的 `p:sp` | `Native-normalized`;回导为最终自由形状几何,不保留可重放的操作历史 | 接受受支持的闭合几何,或字体 face 可精确解析的隐式从左到右水平直接文本;文本会转为字形几何,第一个 source 决定样式与顺序,且不输出 clip、mask 或显式 fill rule || 多边形 | `<polygon>` | 闭合自定义几何 | `Native-normalized` | points 必须有限且合法 || 折线 | `<polyline>` | 开放自定义几何 | `Native-normalized` | points 使用与其他生成几何相同的有限、已登记语法 |-| PowerPoint 预设形状 | 由 registry 生成的 compact `<g>`,由该组承载 preset 意图与基础 paint,并直接包含可见 `<path>` 子元素 | 一个可编辑 preset `p:sp` | preset 身份与 adjustment 可以经导入/导出保留 | 质检与导出动态重渲染 registry;规范创作表达不含隐藏 carrier、preview wrapper 或已存储 preview hash |+| PowerPoint 预设形状 | 由 registry 生成的 compact `<g>`,承载 preset 意图与基础 paint,可选直接引用一个已登记的阴影/发光 filter,并直接包含可见 `<path>` 子元素 | 一个可编辑 preset `p:sp`,最多一个原生效果写入 `p:spPr/a:effectLst` | preset 身份与 adjustment 可以经导入/导出保留;效果遵循下方共享保真度行 | 质检与导出动态重渲染 registry;创作型 preset 的 filter 引用仅适用于 shape,规范创作表达不含隐藏 carrier、preview wrapper 或已存储 preview hash || 导入的预设形状 | 含隐藏原生 carrier、可见 preview 证据与新鲜度 metadata 的 expanded 导入/往返组 | payload 合法且未改变时重新接入 preset | 在导入合同内为 `Native-stable` | 不支持的 preset 保留为显式诊断 fallback,不猜测几何 || 动作按钮形状 | compact authored `actionButton*` preset 组 | 仅生成可见 preset 几何 | 形状几何可往返 | 不创建单击动作、导航目标或超链接 || 组 | `<g>` | `p:grpSp`,或对特殊 carrier 执行文档化的 flatten/collapse | 分组内容可重建为 `<g>` | 结构 atom 与 placeholder 合同优先于普通分组 |diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex c13b4dbf..3c746cfc 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -61,7 +61,7 @@| 网格、对齐、留白 | 系统化 | 共享构图合同,加由每种视觉风格各自承载的构图几何词汇 || 配色 | 系统化 | 声明的 HEX 是具名语义角色的真值来源;可复用角色锚点跨页保持稳定,仍可使用情境派生色与稀疏页内点缀 || 字体 | 系统化 | 每个结构角色一个跨页字号锚点,单次出现可在 `±2px` 内受限调整;稀疏非结构 Hero/Display 另有例外 |-| 视觉效果 | 系统化 | 有专属 effects reference;创作型预设形状上的原生效果仍属信号驱动 |+| 视觉效果 | 系统化 | 有专属 effects reference;一个已登记的外阴影或发光可在受支持的基础对象与 compact authored-preset 形状上编译为一个可编辑原生效果 || 阅读路径 | 系统化 | 入口、推进、层级与终点逐页规划并进行定性复核 |### 第三层 — 行为系统@@ -106,7 +106,6 @@已评估为「真实需求出现时值得做」的候选项,列出来是为了公开意图,均不构成承诺。- **持续收窄[映射指南](./powerpoint-svg-mapping.md)记录的原生覆盖缺口** — 逐版本把更多「仅 SVG」的格子推向 PowerPoint 原生结构与行为。-- **创作型预设形状的效果支持**(如原生阴影)— 等形成精确的 preset-effect 契约并补齐 checker 覆盖再做;在此之前,需要阴影的库存形状保守留普通 SVG。- **图片页面背景提升为原生背景填充** — 纯色 / 渐变页面背景已导出为 PowerPoint 原生底色;图片背景按需求驱动。---