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(scripts): unlisted animated groups follow the nearest listed order instead of their SVG index

hugohe3c55ad4fe71ea
diff --git a/skills/ppt-master/scripts/docs/pptx-animations.md b/skills/ppt-master/scripts/docs/pptx-animations.md
index 78cddd56..87f1f2d7 100644
--- a/skills/ppt-master/scripts/docs/pptx-animations.md
+++ b/skills/ppt-master/scripts/docs/pptx-animations.md
@@ -41,7 +41,7 @@ One resolved row contains these fields:
| Trigger shape | Optional different top-level group; maps to PowerPoint `On Click of` |
| Duration | Finite positive schedule duration; scalable native behavior trees preserve their internal timing ratios |
| Delay | Finite non-negative row offset; shape-trigger rows use it as `TriggerDelayTime` |
-| Order | Positive integer sidecar order; ties retain stable SVG group order, then `effects[]` index |
+| Order | Positive integer sidecar order; ties retain stable SVG group order, then `effects[]` index; a group with no sidecar `order` follows the nearest listed group before it in SVG order (and precedes every listed group when none precedes it), so a headline above the numbered body enters first |
| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (one installed PowerPoint face, required for Change Font; not a CSS list), `relative`, or `size` values from PowerPoint `EffectParameters` |
| Timing options | Repeat count/span, auto-reverse, rewind, accelerate/decelerate, bounce-end ratio, and restart policy |
| Completion / cue | Optional dim/hide behavior and packaged `.m4a`/`.mp3`/`.wav` sound |
@@ -301,7 +301,7 @@ animation-to-video contract.
| `groups.<id>.effects[]` | Non-empty ordered array for a multi-duty lifecycle; every row names `effect`; cannot coexist with legacy single-effect fields in the same group |
| `groups.<id>.effect` | Backward-compatible single-row form; old short names are read-only compatibility inputs |
| `effects[].trigger` / legacy `trigger` | Row-specific Start mode; omitted values inherit `animation.trigger` |
-| `order` | Page-wide order for ordinary rows; ties keep SVG group order, then `effects[]` index; `trigger_shape` rows keep relative order in separate interactive sequences; SVG layer order never changes |
+| `order` | Page-wide order for ordinary rows; ties keep SVG group order, then `effects[]` index; an unlisted animated group inherits the order of the nearest listed group above it in SVG order (0 before the first); `trigger_shape` rows keep relative order in separate interactive sequences; SVG layer order never changes |
| `delay` | Row-specific seconds added to the resolved Start or shape trigger |
| `duration` | Per-row schedule duration; scalable native trees keep internal ratios, while `entrance_appear` and instantaneous presets keep their authored duration and use the value for `after-previous` spacing |
| `effect_options` | Effect-specific parameters (`direction`, `amount`, `color`, `font_name`, `relative`, `size`) limited to what the selected effect supports (`pptx_animations.py --describe <effect>`); requires an explicit canonical `effect` in the same block or row; `font_name` is one target-installed face |
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 27071695..ede8abfb 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
@@ -5547,6 +5547,26 @@ def _build_sequence_targets(
svg_id: sid for sid, svg_id in anim_targets
}
ordered: list[tuple[int, int, int, str, str, dict[str, Any]]] = []
+ # A group without a sidecar ``order`` follows the nearest listed group
+ # before it in SVG order (0 before the first one). Numbering unlisted
+ # groups by raw SVG index collided with explicit orders: a headline at
+ # index 2 landed behind the body block the author had numbered 1 and 2.
+ inherited_orders: list[int] = []
+ current_order = 0
+ for _sid, svg_id in anim_targets:
+ group_value = groups_cfg.get(svg_id, {})
+ explicit = [
+ cfg.get('order')
+ for _path, cfg in (
+ animation_group_effect_entries(group_value, path='')
+ if isinstance(group_value, dict) else []
+ )
+ if isinstance(cfg.get('order'), int)
+ and not isinstance(cfg.get('order'), bool)
+ ]
+ if explicit:
+ current_order = max(current_order, max(explicit))
+ inherited_orders.append(current_order)
for idx, (sid, svg_id) in enumerate(anim_targets):
group_value = groups_cfg.get(svg_id, {})
if not isinstance(group_value, dict):
@@ -5576,8 +5596,8 @@ def _build_sequence_targets(
if animation is None and normalized_effect is None:
continue
order_value = effect_cfg.get('order')
- order = order_value if order_value is not None else idx + 1
- if (
+ order = order_value if order_value is not None else inherited_orders[idx]
+ if order_value is not None and (
isinstance(order, bool)
or not isinstance(order, int)
or order <= 0