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(gradients): define radial point-focus fidelity
hugohe360773c11dec3
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.mdindex a6babdb5..d6628345 100644--- a/docs/powerpoint-svg-mapping.md+++ b/docs/powerpoint-svg-mapping.md@@ -158,7 +158,7 @@ preset selection and authoring behavior are documented in| Solid fill | Canonical `fill="#RRGGBB"`, either a named lock anchor or contextual page paint | `a:solidFill`, with a theme token when an anchor role is exactly reusable | `Native-stable` | Compatible spellings may warn; malformed colors fail, while valid contextual colors are informational || Fill transparency | Opaque fill plus `fill-opacity` | Native alpha | `Native-stable` | Generated values are finite unitless numbers from 0 to 1 || Linear gradient fill | Registered `<linearGradient>` in `<defs>` | Native `a:gradFill` | `Native-normalized` | Stops, coordinates, transforms, and references must follow the closed contract |-| Radial gradient fill | Registered `<radialGradient>` | Centered circular DrawingML gradient | `Approximate` | Review focal/radius-sensitive designs |+| Radial gradient fill | Registered `<radialGradient>` | Point-focused circular DrawingML gradient | `Approximate`; effective focus round-trips while outer center/radius normalize | Review radius- or outer-center-sensitive designs || Pattern fill | Annotated project pattern definition | Native `a:pattFill` | `Native-normalized` | Only registered PowerPoint preset patterns are supported || No outline | `stroke="none"` or the registered absence of a line | `a:noFill` under `a:ln` | `Native-stable` | Do not simulate absence with zero-width ambiguous CSS || Solid outline | Registered `stroke` and width | Native `a:ln` | `Native-stable` | Width and paint must use canonical units/grammar |diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.mdindex 4cc0c955..de8e192b 100644--- a/docs/zh/powerpoint-svg-mapping.md+++ b/docs/zh/powerpoint-svg-mapping.md@@ -153,7 +153,7 @@ PowerPoint 意图| 纯色填充 | 已锁定规范 `fill="#RRGGBB"` | `a:solidFill`;当锁定角色可精确复用时使用 theme token | `Native-stable` | 兼容颜色拼法可产生 warning;格式错误或生成未锁定值失败 || 填充透明度 | 不透明 fill 加 `fill-opacity` | 原生 alpha | `Native-stable` | 生成值为 0 到 1 的有限无单位数 || 线性渐变填充 | `<defs>` 中已登记 `<linearGradient>` | 原生 `a:gradFill` | `Native-normalized` | stop、坐标、transform 与引用必须遵循封闭合同 |-| 径向渐变填充 | 已登记 `<radialGradient>` | 居中圆形 DrawingML 渐变 | `Approximate` | 对焦点/半径敏感的设计需复核 |+| 径向渐变填充 | 已登记 `<radialGradient>` | 可偏心单点焦点的圆形 DrawingML 渐变 | `Approximate`;有效焦点可往返,外圆中心与半径会归一化 | 对半径或外圆中心敏感的设计需复核 || 图案填充 | 带注解的项目 pattern 定义 | 原生 `a:pattFill` | `Native-normalized` | 仅支持已登记 PowerPoint 预设 pattern || 无轮廓 | `stroke="none"` 或已登记线缺省 | `a:ln` 内的 `a:noFill` | `Native-stable` | 不得用零线宽模糊 CSS 模拟缺省 || 实线轮廓 | 已登记 `stroke` 与宽度 | 原生 `a:ln` | `Native-stable` | 宽度与 paint 必须使用规范单位/语法 |diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex 809bbb4d..1e828f6c 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -134,8 +134,10 @@ closed parser checks. See| `<image>` | No gradient paint; use §6.5 overlays |Linear export preserves stops/alpha and reduces direction to an angle;-coincident endpoints are invalid. Radial export centers a circular-approximation, dropping `cx/cy/r/fx/fy`. Gradient strokes stay editable;+coincident endpoints are invalid. Radial export preserves the effective focus+(`fx/fy`, otherwise `cx/cy`) as a point-focused circle; its outer center and+radius normalize to `0.5`, so distinct outer `cx/cy` and `r` are dropped.+Gradient strokes stay editable;reverse import may keep the first stop only. Stop alpha multiplies element opacity.PPTX import normalizes gradients and reports degradation;`--strict` keeps the closed parser contract. See@@ -320,7 +322,7 @@ and converter share this parser.|---|---|---|| Directional scrim | Linear rect, darkest beside text | `0%: 0.88; 55%: 0.30; 100%: 0` || Bottom title fade | Vertical rect over lower image | black `0 → 0.72` |-| Vignette/spotlight | Centered radial rect (`cx=50%`, `cy=50%`, `r=70%`); native center only | black `0 → 0.58` |+| Vignette/spotlight | Radial rect; place the hotspot with `fx/fy` or `cx/cy`; outer center/radius remain approximate | black `0 → 0.58` || Brand wash | Directional existing brand-color gradient | `0.80 → 0.10` || Faux glass | Visible fields + diagonal linear panel (`0,0 → 1,1`) + highlight stroke; optional §6.4 elevation | white `0.38 → 0.12`; stroke about `0.55` |diff --git a/skills/ppt-master/scripts/docs/mask-gradient-smoke.md b/skills/ppt-master/scripts/docs/mask-gradient-smoke.mdindex 4f125065..3c388e98 100644--- a/skills/ppt-master/scripts/docs/mask-gradient-smoke.md+++ b/skills/ppt-master/scripts/docs/mask-gradient-smoke.md@@ -17,7 +17,7 @@ from xml.etree import ElementTree as ETscripts = Path("skills/ppt-master/scripts").resolve()sys.path.insert(0, str(scripts))-from pptx_to_svg.fill_to_svg import _angle_to_unit_endpoints+from pptx_to_svg.fill_to_svg import _angle_to_unit_endpoints, resolve_fillfrom svg_quality_checker import SVGQualityCheckerfrom svg_to_pptx.drawingml.converter import (SvgNativeConversionError,@@ -46,7 +46,7 @@ valid = svg(<stop offset="0" stop-color="#2563EB"/><stop offset="100%" stop-color="#F97316" stop-opacity="0.4"/></linearGradient>- <radialGradient id="radial" cx="0.5" cy="0.5" r="0.5">+ <radialGradient id="radial" cx="0.25" cy="0.7" r="0.8"><stop offset="0" stop-color="#FFFFFF"/><stop offset="1" stop-color="#0F172A"/></radialGradient>@@ -61,6 +61,26 @@ radial_xml = build_gradient_fill(radial)assert '<a:lin ang="0" scaled="1"/>' in linear_xmlassert '<a:alpha val="40000"/>' in linear_xmlassert '<a:path path="circle">' in radial_xml+assert (+ '<a:fillToRect l="25000" t="70000" r="75000" b="30000"/>'+ in radial_xml+)+radial.set("fx", "0.8")+radial.set("fy", "0.2")+focused_xml = build_gradient_fill(radial)+assert (+ '<a:fillToRect l="80000" t="20000" r="20000" b="80000"/>'+ in focused_xml+)+native_gradient = ET.fromstring(+ f'<root xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main">'+ f'{focused_xml}</root>'+)[0]+restored = resolve_fill(native_gradient, None)+assert 'cx="0.5" cy="0.5" r="0.5" fx="0.8" fy="0.2"' in restored.defs[0]+assert '<a:fillToRect l="80000" t="20000" r="20000" b="80000"/>' in (+ build_gradient_fill(ET.fromstring(restored.defs[0]))+)with tempfile.TemporaryDirectory(prefix="ppt-master-gradient-smoke-") as tmp:source = Path(tmp) / "gradient.svg"diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 32ee497d..3287d511 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -12,7 +12,7 @@"skills/ppt-master/templates/schemas/*.json"],"exclude": [],- "max_tokens": 395850+ "max_tokens": 396115},"file_budgets": {"AGENTS.md": 2400,@@ -25,7 +25,7 @@"skills/ppt-master/references/executor-notes.md": 900,"skills/ppt-master/references/shared-standards.md": 250,"skills/ppt-master/references/shared-standards-core.md": 11100,- "skills/ppt-master/references/svg-effects.md": 12253,+ "skills/ppt-master/references/svg-effects.md": 12277,"skills/ppt-master/references/native-data-interface.md": 6200,"skills/ppt-master/references/pptx-structure-interface.md": 4300,"skills/ppt-master/references/strategist.md": 14350,@@ -186,7 +186,7 @@"skills/ppt-master/references/svg-effects.md","skills/ppt-master/references/native-shape-authoring.md"],- "max_tokens": 53916+ "max_tokens": 53940},"route.generate.quick-generate.topic-research": {"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",@@ -196,7 +196,7 @@"stage.generate.topic-research"],"files": [],- "max_tokens": 55428+ "max_tokens": 55452},"route.generate.quick-generate.icon": {"description": "Quick Generate with project-local bundled icon selection and synchronization.",@@ -207,7 +207,7 @@"files": ["skills/ppt-master/templates/icons/README.md"],- "max_tokens": 55828+ "max_tokens": 55852},"route.generate.quick-generate.in-hand-image": {"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",@@ -217,7 +217,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 63972+ "max_tokens": 63996},"route.generate.quick-generate.formula": {"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",@@ -229,7 +229,7 @@"files": ["skills/ppt-master/scripts/docs/image.md"],- "max_tokens": 67158+ "max_tokens": 67182},"route.generate.quick-generate.ai-two-types": {"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",@@ -240,7 +240,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 87077+ "max_tokens": 87101},"route.generate.quick-generate.web-image": {"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",@@ -251,7 +251,7 @@"stage.generate.executor.web-image"],"files": [],- "max_tokens": 71725+ "max_tokens": 71749},"route.generate.planning-image": {"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed, including the compact layout math and vocabulary.",@@ -403,7 +403,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 105297+ "max_tokens": 105321},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -461,7 +461,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 112304+ "max_tokens": 112328},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -474,7 +474,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 129633+ "max_tokens": 129657},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -486,7 +486,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 112329+ "max_tokens": 112353},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -498,7 +498,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 122266+ "max_tokens": 122290},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -510,7 +510,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 122715+ "max_tokens": 122739},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -520,7 +520,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 106809+ "max_tokens": 106833},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with complete visual-construction authorities and representative multi-source custom mode/style execution.",@@ -622,7 +622,7 @@"skills/ppt-master/workflows/stages/resume-execute.md","skills/ppt-master/references/artifact-ownership.md"],- "max_tokens": 67653+ "max_tokens": 67677},"stage.generate.resume-execute-image": {"description": "Fresh-session resume when the locked resource plan contains image rows.",@@ -858,7 +858,7 @@"files": ["skills/ppt-master/references/svg-effects.md"],- "max_tokens": 12253+ "max_tokens": 12277}},"duplicates": {