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(animations): require an explicit font for Change Font

hugohe3803916aa4969
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.md
index 3b4b7401..9600cc80 100644
--- a/skills/ppt-master/references/animations.md
+++ b/skills/ppt-master/references/animations.md
@@ -114,7 +114,8 @@ Rules:
| `direction` | Directional Fly/Crawl/Wipe/Peek/Strips/Split/Stretch/Zoom and related entrance/exit effects |
| `amount` | Wheel spokes (`1`, `2`, `3`, `4`, `8`), emphasis Spin degrees, or Transparency ratio |
| `color` | Color-capable emphasis effects; `#RRGGBB` or `theme:<scheme-color>` |
- | `font_name`, `size` | Change Font and Grow/Shrink |
+ | `font_name` | Change Font; required for `emphasis_change_font` |
+ | `size` | Grow/Shrink |
| `relative` | Motion paths (`true` = shape-relative, `false` = fixed slide path) |
- Any animation/group block may set `repeat_count` or `repeat_duration`
(mutually exclusive), `auto_reverse`, `rewind`, `accelerate`, `decelerate`,
diff --git a/skills/ppt-master/scripts/docs/pptx-animations.md b/skills/ppt-master/scripts/docs/pptx-animations.md
index a72149c6..bc89702d 100644
--- a/skills/ppt-master/scripts/docs/pptx-animations.md
+++ b/skills/ppt-master/scripts/docs/pptx-animations.md
@@ -36,7 +36,7 @@ One resolved animation-pane row contains these fields:
| Duration | Finite positive schedule duration; scalable native behavior trees preserve their internal timing ratios |
| Delay | Finite non-negative offset used by `after-previous` or as trigger-shape `TriggerDelayTime` |
| Order | Positive integer sidecar order; ties retain stable SVG order |
-| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name`, `relative`, or `size` values from PowerPoint `EffectParameters` |
+| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (required for Change Font), `relative`, or `size` values from PowerPoint `EffectParameters` |
| Timing options | Repeat count/span, auto-reverse, rewind, accelerate/decelerate, bounce-end ratio, and restart policy |
| Completion | Optional dim/hide behavior and packaged `.m4a`/`.mp3`/`.wav` sound |
diff --git a/skills/ppt-master/scripts/pptx_animation_presets.json b/skills/ppt-master/scripts/pptx_animation_presets.json
index 03d9d289..87489309 100644
--- a/skills/ppt-master/scripts/pptx_animation_presets.json
+++ b/skills/ppt-master/scripts/pptx_animation_presets.json
@@ -938,7 +938,7 @@
"effect_options": {
"font_name": {
"type": "string",
- "default": "??"
+ "required": true
}
}
},
diff --git a/skills/ppt-master/scripts/pptx_animations.py b/skills/ppt-master/scripts/pptx_animations.py
index 525565b9..8c5185bb 100644
--- a/skills/ppt-master/scripts/pptx_animations.py
+++ b/skills/ppt-master/scripts/pptx_animations.py
@@ -267,6 +267,17 @@ def _load_native_animations() -> dict[str, dict[str, Any]]:
f'native animation preset {key!r} option {option_name!r} '
'must be an object'
)
+ required = option_spec.get('required', False)
+ if not isinstance(required, bool):
+ raise RuntimeError(
+ f'native animation preset {key!r} option {option_name!r} '
+ 'required must be a boolean'
+ )
+ if required and 'default' in option_spec:
+ raise RuntimeError(
+ f'native animation preset {key!r} option {option_name!r} '
+ 'cannot define both required and default'
+ )
option_type = option_spec.get('type')
if option_type == 'enum':
values = option_spec.get('values')
@@ -518,6 +529,18 @@ def normalize_animation_effect_options(
f'animation effect {effect!r} does not support effect option(s): '
f'{unsupported}; supported options: {supported}'
)
+ missing_required = sorted(
+ name
+ for name, spec in option_specs.items()
+ if spec.get('required') and name not in options
+ )
+ if missing_required:
+ required_fields = ', '.join(
+ f'effect_options.{name}' for name in missing_required
+ )
+ raise ValueError(
+ f'animation effect {effect!r} requires {required_fields}'
+ )
normalized: dict[str, object] = {}
for name, value in options.items():
@@ -3445,11 +3468,17 @@ def get_animation_help() -> str:
def describe_animation_effect(effect: object) -> dict[str, Any]:
"""Return the author-facing option contract for one animation effect."""
- canonical, implied_options = normalize_animation_effect_request(
+ canonical = normalize_animation_effect(
effect,
allow_none=False,
allow_modes=False,
)
+ assert canonical is not None
+ implied_options = (
+ dict(ANIMATION_ALIAS_OPTIONS.get(effect, {}))
+ if isinstance(effect, str)
+ else {}
+ )
option_contract: dict[str, Any] = {}
for name, raw_spec in NATIVE_ANIMATIONS[canonical]['effectOptions'].items():
spec = {