@pixodesk/svg-animator-web 1.0.43 → 1.0.45

package/README.md

@@ -92,7 +92,7 @@ animator.destroy();             // cleanup
 | `resetTimeline` | `boolean` | ignore the document's own timeline and start from the player's default timeline, with `timeline` on top |
 | `duration` · `delay` | `number`        | Shortcuts for `timeline.duration` / `.delay` (ms) | <!-- px names=duration,delay -->
 | `iterations` | `number \| 'infinite'`   | Shortcut for `timeline.iterations` |
-| `startOn`   | `PxStartOn`               | Shortcut for `timeline.trigger.startOn` |
+| `start`     | `PxTriggerStart`          | Shortcut for `timeline.trigger.start` |
 
 The document plays the way it was designed with no configuration at all; `timeline` is for when
 one page needs it to play differently — the same file mounted twice at two speeds, or a file
@@ -102,7 +102,7 @@ that autostarts everywhere except inside your own transport UI:
 const animator = createAnimator({
   src: '/animation.json',
   container: '#box',
-  timeline: { iterations: 'infinite', trigger: { startOn: 'programmatic' } },
+  timeline: { iterations: 'infinite', trigger: { start: 'none' } },
 });
 animator.play();
 ```

package/dist/{PxAnimator-yjuSFhQw.d.cts → PxAnimator-BS-SZULN.d.cts}

@@ -38,6 +38,16 @@ interface PxAnimatorOptions extends PxPlaybackOverride, PxAnimatorCallbacks {
 interface PxInternalAnimatorOptions extends PxAnimatorOptions {
     /** A custom render target for the frame-loop engine (`PxPlatformAdapter`). */
     adapter?: PxPlatformAdapter;
+    /**
+     * The root `<svg>` the CALLER rendered, when it renders the document itself (the React and
+     * Vue components). Triggers attach to it — pointer listeners, the visibility gate — and
+     * without one they are not wired at all, so even a `load` trigger never fires.
+     *
+     * Otherwise the engines look the root up as `#` + the document's root id, which finds
+     * nothing for the common document whose root `<svg>` has no id. The component already holds
+     * the element, so it hands it over rather than have it guessed.
+     */
+    rootElement?: Element;
 }
 /**
  * Creates an animator instance to control SVG animations.

package/dist/{PxAnimator-yjuSFhQw.d.ts → PxAnimator-BS-SZULN.d.ts}

@@ -38,6 +38,16 @@ interface PxAnimatorOptions extends PxPlaybackOverride, PxAnimatorCallbacks {
 interface PxInternalAnimatorOptions extends PxAnimatorOptions {
     /** A custom render target for the frame-loop engine (`PxPlatformAdapter`). */
     adapter?: PxPlatformAdapter;
+    /**
+     * The root `<svg>` the CALLER rendered, when it renders the document itself (the React and
+     * Vue components). Triggers attach to it — pointer listeners, the visibility gate — and
+     * without one they are not wired at all, so even a `load` trigger never fires.
+     *
+     * Otherwise the engines look the root up as `#` + the document's root id, which finds
+     * nothing for the common document whose root `<svg>` has no id. The component already holds
+     * the element, so it hands it over rather than have it guessed.
+     */
+    rootElement?: Element;
 }
 /**
  * Creates an animator instance to control SVG animations.