@pixodesk/svg-animator-core 1.0.41 → 1.0.44

package/README.md

@@ -60,7 +60,7 @@ runtime crash on a non-browser platform.
 | **Text** | `materializeGlyphText`, `layoutGlyphTextChars`, `extendedPathForBrowser` |
 | **Node helpers** | `toDomProps`, `sanitizeAttributeValue`, `generateNewIds` |
 | **Playback engine** | `createAdapterAnimator` + the `PxPlatformAdapter` interface |
-| **Wire enums** | `PxTimelineEngine` / `PxTimelineEngineSetting`, `PxStartOn`, `PxOutAction`, `PxFinishAction`, `PxFillMode`, `PxPlaybackDirection`, `PxScrollKind`, `PxScrollAxis`, `PxScrollSource`, `PxScrollPhase`, `PxPinAlign`, `PxAlongPathMode`, `PxLoopRepeatAt`, `PxLoopDirection`, `PxStrokeTrimSubPaths`, `PxMaskType`, `PxCloneWithout`, `PxUnits`, `PxGradientType`, `PxGradientSpreadMethod`, `PxPathOverflow`, `PxLengthAdjust`, `PxTextPathMethod`, `PxTextPathSpacing` — every two-or-more-way wire selector is a named enum, not a bare string. Each is a const namespace AND the string type derived from it under the same name, so `PxStartOn.click` and `startOn?: PxStartOn` come from one import |
+| **Wire enums** | `PxTimelineEngine` / `PxTimelineEngineSetting`, `PxTriggerStart`, `PxOffScreenAction`, `PxMouseOutAction`, `PxFinishAction`, `PxFillMode`, `PxPlaybackDirection`, `PxScrollKind`, `PxScrollAxis`, `PxScrollSource`, `PxScrollPhase`, `PxPinAlign`, `PxAlongPathMode`, `PxLoopRepeatAt`, `PxLoopDirection`, `PxStrokeTrimSubPaths`, `PxMaskType`, `PxCloneWithout`, `PxUnits`, `PxGradientType`, `PxGradientSpreadMethod`, `PxPathOverflow`, `PxLengthAdjust`, `PxTextPathMethod`, `PxTextPathSpacing` — every two-or-more-way wire selector is a named enum, not a bare string. Each is a const namespace AND the string type derived from it under the same name, so `PxTriggerStart.click` and `start?: PxTriggerStart` come from one import |
 
 ### Validating a document
 

package/dist/{PxDocumentDiagnostic-COGEjBbg.d.cts → PxDocumentDiagnostic-n8yiyL0k.d.cts}

@@ -311,10 +311,10 @@ declare const PX_WIRE_BASELINE_VERSION = "1.1";
 /**
  * Every `b` step from {@link PX_WIRE_BASELINE_VERSION} to {@link PX_WIRE_SCHEMA_VERSION}.
  *
- * EMPTY IS CORRECT TODAY: 1.1 is the baseline and nothing has moved since. It exists now because
- * the guard spec keys off it — bump `PX_WIRE_SCHEMA_VERSION` without adding the matching step
- * and the suite fails naming the gap. That is the whole point: the last three renames shipped
- * because nothing forced anyone to say they had happened.
+ * One step so far: the 1.2 trigger block. The guard spec keys off this table — bump
+ * `PX_WIRE_SCHEMA_VERSION` without adding the matching step and the suite fails naming the gap.
+ * That is the whole point: the last three renames shipped because nothing forced anyone to say
+ * they had happened.
  * @public @advanced
  */
 declare const PX_WIRE_STEPS: ReadonlyArray<PxWireVersionStep>;
@@ -404,24 +404,36 @@ type PxPlaybackDirection = typeof PxPlaybackDirection[keyof typeof PxPlaybackDir
 declare const PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
 /** @internal */
 declare const PX_ANIM_ATTR_NAME = "_px_animator";
-/** `trigger.startOn` — what starts the animation. `programmatic` waits for `play()`. @public */
-declare const PxStartOn: {
+/** `trigger.start` — what starts the animation. `none` waits for `play()`.
+ *
+ *  There is no `scrollIntoView` member: visibility is not a trigger but a permission, and it is
+ *  governed by `offScreen` + `visibilityThreshold` whatever starts the animation. `start: 'load'`
+ *  behind the default gate is what `startOn: 'scrollIntoView'` used to mean. @public */
+declare const PxTriggerStart: {
     readonly load: "load";
     readonly mouseOver: "mouseOver";
     readonly click: "click";
-    readonly scrollIntoView: "scrollIntoView";
-    readonly programmatic: "programmatic";
+    readonly none: "none";
+};
+type PxTriggerStart = typeof PxTriggerStart[keyof typeof PxTriggerStart];
+/** `trigger.offScreen` — what happens while none of the graphic is on screen. No `reverse`:
+ *  nobody can watch an animation play backwards off screen. @public */
+declare const PxOffScreenAction: {
+    readonly pause: "pause";
+    readonly continue: "continue";
+    readonly reset: "reset";
 };
-type PxStartOn = typeof PxStartOn[keyof typeof PxStartOn];
-/** `trigger.outAction` — what happens when the trigger condition stops holding. @public */
-declare const PxOutAction: {
+type PxOffScreenAction = typeof PxOffScreenAction[keyof typeof PxOffScreenAction];
+/** `trigger.mouseOut` — what happens when the pointer leaves. Read only when
+ *  `start` is `mouseOver`. @public */
+declare const PxMouseOutAction: {
     readonly continue: "continue";
     readonly pause: "pause";
     readonly reset: "reset";
     readonly reverse: "reverse";
 };
-type PxOutAction = typeof PxOutAction[keyof typeof PxOutAction];
-/** `trigger.finishAction` — what happens after a NATURAL finish. @public */
+type PxMouseOutAction = typeof PxMouseOutAction[keyof typeof PxMouseOutAction];
+/** `trigger.finish` — what happens after a NATURAL finish. @public */
 declare const PxFinishAction: {
     readonly hold: "hold";
     readonly reset: "reset";
@@ -519,21 +531,27 @@ declare function mayUseNativeScrollTimeline(engine: PxTimelineEngineSetting | un
  * THE TRIGGER DEFAULTS — what a missing `trigger` field means. One table, declared by
  * `PxTriggerSchema` and applied by {@link resolveTrigger}, which every player calls (the web's
  * `setupAnimationTriggers`, the React Native component) — so a file behaves the same everywhere:
- *   - `startOn` 'load' — a document is designed to play
- *   - `outAction` 'continue' — leaving the trigger does not interrupt playback
- *   - `scrollIntoViewThreshold` 0 — any visible pixel counts
+ *   - `start` 'load' — a document is designed to play
+ *   - `offScreen` 'pause' — an animation nobody can see does not run
+ *   - `mouseOut` 'continue' — leaving the element does not interrupt playback
+ *   - `visibilityThreshold` 0.5 — half of it must be on screen before it may run
+ *   - `visibilityDebounce` 150 — and stay that way this long, so a fast scroll past starts nothing
  * @public @advanced
  */
 declare const PX_TRIGGER_DEFAULTS: {
-    readonly startOn: "load";
-    readonly outAction: "continue";
-    readonly scrollIntoViewThreshold: 0;
+    readonly start: "load";
+    readonly offScreen: "pause";
+    readonly mouseOut: "continue";
+    readonly visibilityThreshold: 0.5;
+    readonly visibilityDebounce: 150;
 };
 /** A trigger with every default filled in. @public @advanced */
 interface PxResolvedTrigger {
-    readonly startOn: NonNullable<PxTrigger['startOn']>;
-    readonly outAction: NonNullable<PxTrigger['outAction']>;
-    readonly scrollIntoViewThreshold: number;
+    readonly start: NonNullable<PxTrigger['start']>;
+    readonly offScreen: NonNullable<PxTrigger['offScreen']>;
+    readonly mouseOut: NonNullable<PxTrigger['mouseOut']>;
+    readonly visibilityThreshold: number;
+    readonly visibilityDebounce: number;
 }
 /** Which props drive playback. `apiRef` is deliberately NOT a mode: the handle is filled in
  *  every mode, so passing it alone leaves the document's own trigger in charge. * @public
@@ -568,7 +586,7 @@ interface PxControlProps {
     play?: boolean;
     /** Hold the current frame; set it back to `false` to resume. */
     pause?: boolean;
-    /** Start the way the document says — its own `startOn` / `outAction` trigger. */
+    /** Start the way the document says — its own `trigger` block. */
     autoplay?: boolean;
 }
 /** The chosen mode plus any conflict warnings — ready-made sentences, so three components
@@ -597,7 +615,7 @@ interface PxResolvedControlMode {
 declare function resolveControlMode(props: PxControlProps): PxResolvedControlMode;
 /**
  * True when the component must take the document's trigger over, by forcing
- * `startOn: 'programmatic'` into its config patch.
+ * `start: 'none'` into its config patch.
  *
  * Every mode except `autoplay` — INCLUDING `static`. A component given no control props at all
  * must not start on its own: `<PixodeskSvgAnimator doc={…} />` renders the first frame and waits.
@@ -605,7 +623,7 @@ declare function resolveControlMode(props: PxControlProps): PxResolvedControlMod
  * @public
  */
 declare function controlModeTakesOverTrigger(mode: PxControlMode): boolean;
-/** A document's trigger with the defaults filled in. (`finishAction` is not a start/stop decision:
+/** A document's trigger with the defaults filled in. (`finish` is not a start/stop decision:
  *  it reaches the engines as the runtime view's `resetOnFinish`.) * @public @advanced
  */
 declare function resolveTrigger(trigger: PxTrigger | undefined): PxResolvedTrigger;
@@ -753,6 +771,130 @@ declare function getBindings(doc: PxAnimatedSvgDocument): PxBinding[] | undefine
 /** @public @advanced */
 declare function getChildren(doc: PxAnimatedSvgDocument): PxNode[] | undefined;
 
+/**
+ * Every diagnostic a player can report, as a number a host can switch on.
+ *
+ * The words are not in the build: each code's description lives in the comment on its member and
+ * is compiled into `docs/diagnostics.md`, which every diagnostic's `message` links to.
+ * @public
+ */
+declare enum PxDiagnosticCode {
+    /**
+     * The player could not be built from this document — a document that passed validation but
+     * still broke the builder, or a bug in the player. Report it.
+     * @data the Error
+     */
+    buildFailed = 1001,
+    /**
+     * The file at `src` loaded, but it is not a Pixodesk animation document.
+     * @data the `src` URL
+     */
+    invalidDocumentAtSrc = 1002,
+    /**
+     * The page could not fetch `src`. The file may be perfect — this is the request failing.
+     * @data the `src` URL · the fetch error's message
+     */
+    loadFailed = 1003,
+    /**
+     * One element's animation could not be built, so that element stays static; the rest plays.
+     * @data the Error
+     */
+    animationBuildFailed = 1004,
+    /**
+     * An `effects` bucket does not match the schema, so that effect is ignored or degraded.
+     * @data the problem, with the node's path
+     */
+    effectsShape = 1101,
+    /**
+     * Part of the per-instance `timeline` override could not be applied — most often clock-only
+     * keys aimed at a scroll timeline.
+     * @data what could not be applied
+     */
+    timelineOverrideIgnored = 1102,
+    /**
+     * An SVG tag that can execute or load remote content was dropped from the rendered tree.
+     * @data the tag name
+     */
+    blockedTag = 1103,
+    /**
+     * The browser will not animate these attributes, so the document fell back to the frame loop.
+     * @data the attribute names
+     */
+    unsupportedAnimatedAttrs = 1104,
+    /** A bind-by-id document carries no `animator.bindings`, so nothing is animated. */
+    noBindings = 1105,
+    /**
+     * A binding names no element, or names animations that `definitions.animations` does not have.
+     * @data the binding
+     */
+    unresolvedBinding = 1106,
+    /** `setupAnimationTriggers` was given no root element, so no trigger was wired. */
+    triggersNoRoot = 1201,
+    /**
+     * The container selector matched nothing, so there is nothing to render into.
+     * @data the selector
+     */
+    noRootForSelector = 1202,
+    /** No container was given and the document's `id` matched no element already on the page. */
+    noRootElement = 1203,
+    /**
+     * A binding's selector matched no element, so that binding animates nothing.
+     * @data the selector
+     */
+    noElementsForSelector = 1206,
+    /**
+     * An attribute write found no element for this id — the rendered SVG was probably replaced.
+     * @data the id or selector
+     */
+    setAttributeNoElement = 1207,
+    /** `smoothing` needs the player's own driver, so the browser's scroll timeline was not used. */
+    scrollSmoothingNeedsOwnDriver = 1301,
+    /** The browser refused to build a native scroll timeline; the player measures progress itself. */
+    scrollNativeUnavailable = 1302,
+    /**
+     * `scroll.subject` is not a valid CSS selector, so the SVG itself is measured instead.
+     * @data the subject
+     */
+    scrollSubjectInvalid = 1303,
+    /**
+     * `scroll.subject` matched no element, so the SVG itself is measured instead.
+     * @data the subject
+     */
+    scrollSubjectNoMatch = 1304,
+    /** There is no root element to observe, so a scroll-driven animation stays on its first frame. */
+    scrollNoRootToObserve = 1305,
+    /** `animator.trigger` does not apply to a scroll timeline — the scrollbar is the playhead. */
+    scrollTriggerIgnored = 1306,
+    /** A playback rate of `0`, or a non-finite one, is rejected everywhere — use `pause()`. */
+    rateRejected = 1401,
+    /**
+     * Two control tiers were set at once. The higher one wins and the lower is ignored — see the
+     * control-mode rule.
+     * @data which props conflicted, and which won
+     */
+    controlPropsConflict = 1501,
+    /**
+     * The document could not be compiled into animation tracks, so `fallback` is shown.
+     * @data the Error
+     */
+    rnCompileFailed = 1601,
+    /**
+     * Rendering the compiled document threw, so `fallback` is shown.
+     * @data the Error
+     */
+    rnRenderFailed = 1602,
+    /**
+     * The error boundary caught a render failure below this component.
+     * @data the Error · the React component stack
+     */
+    rnBoundaryCaught = 1603,
+    /**
+     * `react-native-svg` cannot express part of this document, so it was left out or simplified.
+     * @data what was left out
+     */
+    rnUnsupported = 1604
+}
+
 /**
  * Who can do something about a diagnostic.
  *
@@ -773,18 +915,29 @@ declare const PxDiagnosticKind: {
     readonly internal: "internal";
 };
 type PxDiagnosticKind = typeof PxDiagnosticKind[keyof typeof PxDiagnosticKind];
-/** One thing a player has to say. @public */
+/**
+ * One thing a player has to say.
+ *
+ * The TEXT is not here, and is not in the bundle: `code` identifies the diagnostic and
+ * {@link https://github.com/pixodesk/pixodesk-svg-animator/blob/main/docs/diagnostics.md the
+ * codes page} carries the description. That is the trade this library makes — a smaller
+ * download, and a stable number you can switch on instead of matching a sentence that may be
+ * reworded. The specifics are in `data`.
+ * @public
+ */
 interface PxDiagnostic {
+    /** WHICH diagnostic this is — a permanent number; look it up on the codes page. */
+    readonly code: PxDiagnosticCode;
     /** Who can act on it — see {@link PxDiagnosticKind}. */
     readonly kind: PxDiagnosticKind;
-    /** Human-readable, and never carries the console prefix. */
-    readonly message: string;
     /**
-     * Whatever the site had to hand: the offending binding, the element map, the raw error —
-     * or, for a React Native render failure, `{ componentStack }`.
+     * What the site had to hand, in the order the code's `@data` lists: a selector, a URL, the
+     * offending binding, an inner problem. Everything a sentence would have interpolated.
      */
-    readonly detail?: unknown;
-    /** Present on errors: the Error that stopped the player. Its message is `message`. */
+    readonly data?: ReadonlyArray<unknown>;
+    /** The code and a link to its description — NOT the description itself, which is not shipped. */
+    readonly message: string;
+    /** Present on errors: the Error that stopped the player. */
     readonly error?: Error;
 }
 /**
@@ -799,15 +952,16 @@ interface PxDiagnosticsConfig {
     /**
      * IT PLAYS, but something was ignored, degraded or misspelled — an unknown easing, an
      * override that could not apply, an attribute the platform will not animate. Each
-     * diagnostic says WHO can act on it via `kind` (`document` / `host` / `platform` / `usage` /
-     * `internal`). Without this: `console.warn`.
+     * diagnostic says WHAT happened via `code` (a number — look it up on the codes page) and
+     * WHO can act on it via `kind` (`document` / `host` / `platform` / `usage` / `internal`);
+     * `data` carries the values the site had. Without this: `console.warn`.
      */
     onWarn?: (diagnostic: PxDiagnostic) => void;
     /**
      * THIS INSTANCE WILL NOT PLAY — the document failed to load, parse or build, or the render
      * threw: nothing rendered, `isReady()` false, the component's `fallback` shown. The player
      * stays inert rather than throwing at the caller. `diagnostic.error` is the Error; on React
-     * Native `diagnostic.detail` carries `{ componentStack }` when the error boundary caught it.
+     * Native `diagnostic.data` carries the component stack when the error boundary caught it.
      * Without this: `console.error`.
      */
     onError?: (diagnostic: PxDiagnostic) => void;
@@ -823,10 +977,13 @@ interface PxDiagnosticsConfig {
 }
 /** The reporting channel a player writes to. @public */
 interface PxDiagnostics {
-    /** Report something survivable — it plays. */
-    warn(kind: PxDiagnosticKind, message: string, detail?: unknown): void;
-    /** Report a failure that stopped this instance — it will not play. */
-    error(kind: PxDiagnosticKind, error: Error | string, detail?: unknown): void;
+    /** Report something survivable — it plays. `data` is whatever the code's `@data` names. */
+    warn(kind: PxDiagnosticKind, code: PxDiagnosticCode, ...data: Array<unknown>): void;
+    /**
+     * Report a failure that stopped this instance — it will not play. An `Error` anywhere in
+     * `data` becomes the diagnostic's `error`, so a site can pass it wherever it reads best.
+     */
+    error(kind: PxDiagnosticKind, code: PxDiagnosticCode, ...data: Array<unknown>): void;
 }
 /**
  * Builds the channel a player reports through.
@@ -1331,16 +1488,20 @@ declare const PxElementAnimationSchema: PxSchema<string | Record<string, {} & {
 type PxElementAnimation = PxInfer<typeof PxElementAnimationSchema>;
 /** @public @advanced */
 declare const PxTriggerSchema: PxSchema<{} & {
-    startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-    outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-    finishAction?: "reset" | "hold" | undefined;
-    scrollIntoViewThreshold?: number | undefined;
+    start?: "none" | "mouseOver" | "load" | "click" | undefined;
+    offScreen?: "continue" | "pause" | "reset" | undefined;
+    mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+    finish?: "reset" | "hold" | undefined;
+    visibilityThreshold?: number | undefined;
+    visibilityDebounce?: number | undefined;
 }, false> & {
     readonly _shape: {
-        startOn: PxSchema<"load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined, true>;
-        outAction: PxSchema<"reverse" | "continue" | "pause" | "reset" | undefined, true>;
-        finishAction: PxSchema<"reset" | "hold" | undefined, true>;
-        scrollIntoViewThreshold: PxSchema<number | undefined, true>;
+        start: PxSchema<"none" | "mouseOver" | "load" | "click" | undefined, true>;
+        offScreen: PxSchema<"continue" | "pause" | "reset" | undefined, true>;
+        mouseOut: PxSchema<"reverse" | "continue" | "pause" | "reset" | undefined, true>;
+        finish: PxSchema<"reset" | "hold" | undefined, true>;
+        visibilityThreshold: PxSchema<number | undefined, true>;
+        visibilityDebounce: PxSchema<number | undefined, true>;
     };
 };
 /** Defines when and how an animation should be triggered. @public */
@@ -1562,14 +1723,16 @@ declare const PxTimelineSchema: PxSchema<({} & {
     frameRate?: number | undefined;
     duration?: number | undefined;
     trigger?: ({} & {
-        startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-        outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-        finishAction?: "reset" | "hold" | undefined;
-        scrollIntoViewThreshold?: number | undefined;
+        start?: "none" | "mouseOver" | "load" | "click" | undefined;
+        offScreen?: "continue" | "pause" | "reset" | undefined;
+        mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+        finish?: "reset" | "hold" | undefined;
+        visibilityThreshold?: number | undefined;
+        visibilityDebounce?: number | undefined;
     }) | undefined;
     delay?: number | undefined;
     iterations?: number | "infinite" | undefined;
-    fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+    fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
     direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
 }) | ({
     type: "scroll";
@@ -1688,7 +1851,7 @@ interface _PxAnimatorConfig {
      *
      * The wire spells this as `timeline.type` ('time' — or absent — vs 'scroll'/'view');
      * `flattenAnimatorTimeline` folds it into this field for the engines.
-     * Distinct from `trigger.startOn`, which says what STARTS the animation: one
+     * Distinct from `trigger.start`, which says what STARTS the animation: one
      * names the beginning, this one names what moves the playhead afterwards.
      * Design: app `svgeditor/animation/scroll-timeline.design.md`.
      */
@@ -1749,14 +1912,16 @@ declare const PxAnimatorConfigSchema: PxSchema<{} & {
         frameRate?: number | undefined;
         duration?: number | undefined;
         trigger?: ({} & {
-            startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-            outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-            finishAction?: "reset" | "hold" | undefined;
-            scrollIntoViewThreshold?: number | undefined;
+            start?: "none" | "mouseOver" | "load" | "click" | undefined;
+            offScreen?: "continue" | "pause" | "reset" | undefined;
+            mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+            finish?: "reset" | "hold" | undefined;
+            visibilityThreshold?: number | undefined;
+            visibilityDebounce?: number | undefined;
         }) | undefined;
         delay?: number | undefined;
         iterations?: number | "infinite" | undefined;
-        fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+        fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
         direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
     }) | ({
         type: "scroll";
@@ -1871,14 +2036,16 @@ declare const PxAnimatorConfigSchema: PxSchema<{} & {
             frameRate?: number | undefined;
             duration?: number | undefined;
             trigger?: ({} & {
-                startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-                outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-                finishAction?: "reset" | "hold" | undefined;
-                scrollIntoViewThreshold?: number | undefined;
+                start?: "none" | "mouseOver" | "load" | "click" | undefined;
+                offScreen?: "continue" | "pause" | "reset" | undefined;
+                mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+                finish?: "reset" | "hold" | undefined;
+                visibilityThreshold?: number | undefined;
+                visibilityDebounce?: number | undefined;
             }) | undefined;
             delay?: number | undefined;
             iterations?: number | "infinite" | undefined;
-            fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+            fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
             direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
         }) | ({
             type: "scroll";
@@ -7949,14 +8116,16 @@ declare const PxSvgNodeRootSchema: PxSchema<{} & {
             frameRate?: number | undefined;
             duration?: number | undefined;
             trigger?: ({} & {
-                startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-                outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-                finishAction?: "reset" | "hold" | undefined;
-                scrollIntoViewThreshold?: number | undefined;
+                start?: "none" | "mouseOver" | "load" | "click" | undefined;
+                offScreen?: "continue" | "pause" | "reset" | undefined;
+                mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+                finish?: "reset" | "hold" | undefined;
+                visibilityThreshold?: number | undefined;
+                visibilityDebounce?: number | undefined;
             }) | undefined;
             delay?: number | undefined;
             iterations?: number | "infinite" | undefined;
-            fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+            fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
             direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
         }) | ({
             type: "scroll";
@@ -8076,14 +8245,16 @@ declare const PxSvgNodeRootSchema: PxSchema<{} & {
                 frameRate?: number | undefined;
                 duration?: number | undefined;
                 trigger?: ({} & {
-                    startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-                    outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-                    finishAction?: "reset" | "hold" | undefined;
-                    scrollIntoViewThreshold?: number | undefined;
+                    start?: "none" | "mouseOver" | "load" | "click" | undefined;
+                    offScreen?: "continue" | "pause" | "reset" | undefined;
+                    mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+                    finish?: "reset" | "hold" | undefined;
+                    visibilityThreshold?: number | undefined;
+                    visibilityDebounce?: number | undefined;
                 }) | undefined;
                 delay?: number | undefined;
                 iterations?: number | "infinite" | undefined;
-                fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+                fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
                 direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
             }) | ({
                 type: "scroll";
@@ -8229,14 +8400,16 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
             frameRate?: number | undefined;
             duration?: number | undefined;
             trigger?: ({} & {
-                startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-                outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-                finishAction?: "reset" | "hold" | undefined;
-                scrollIntoViewThreshold?: number | undefined;
+                start?: "none" | "mouseOver" | "load" | "click" | undefined;
+                offScreen?: "continue" | "pause" | "reset" | undefined;
+                mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+                finish?: "reset" | "hold" | undefined;
+                visibilityThreshold?: number | undefined;
+                visibilityDebounce?: number | undefined;
             }) | undefined;
             delay?: number | undefined;
             iterations?: number | "infinite" | undefined;
-            fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+            fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
             direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
         }) | ({
             type: "scroll";
@@ -9443,14 +9616,16 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
                 frameRate?: number | undefined;
                 duration?: number | undefined;
                 trigger?: ({} & {
-                    startOn?: "load" | "mouseOver" | "click" | "scrollIntoView" | "programmatic" | undefined;
-                    outAction?: "reverse" | "continue" | "pause" | "reset" | undefined;
-                    finishAction?: "reset" | "hold" | undefined;
-                    scrollIntoViewThreshold?: number | undefined;
+                    start?: "none" | "mouseOver" | "load" | "click" | undefined;
+                    offScreen?: "continue" | "pause" | "reset" | undefined;
+                    mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+                    finish?: "reset" | "hold" | undefined;
+                    visibilityThreshold?: number | undefined;
+                    visibilityDebounce?: number | undefined;
                 }) | undefined;
                 delay?: number | undefined;
                 iterations?: number | "infinite" | undefined;
-                fillMode?: "forwards" | "backwards" | "both" | "none" | undefined;
+                fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
                 direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
             }) | ({
                 type: "scroll";
@@ -10984,4 +11159,4 @@ declare function diagnoseDocument(doc: unknown): PxDocumentDiagnosis;
  */
 declare function reportDocumentDiagnostics(doc: unknown, where: string): void;
 
-export { PxLoopSchema as $, type PxDefinitions as A, PxDefinitionsSchema as B, type PxDiagnostic as C, PxDiagnosticKind as D, type PxDiagnostics as E, type PxDiagnosticsConfig as F, type PxEffects as G, PxEffectsSchema as H, type PxElementAnimation as I, PxElementAnimationSchema as J, PxFillGradientEffectSchema as K, PxFillMode as L, PxFinishAction as M, type PxGlyph as N, type PxGlyphFont as O, type PxAnimatedSvgDocument as P, PxGradientSpreadMethod as Q, PxGradientStopSchema as R, PxGradientType as S, type PxInfer as T, type PxKeyframe as U, PxKeyframeSchema as V, PxKeyframeValueSchema as W, PxLengthAdjust as X, type PxLoop as Y, PxLoopDirection as Z, PxLoopRepeatAt as _, type PxEngineCallbacks as a, generateNewIds as a$, PxMaskType as a0, PxMaskedByEffectSchema as a1, PxNodeBaseSchema as a2, PxNodeSchema as a3, PxOutAction as a4, PxPathOverflow as a5, PxPinAlign as a6, type PxPlaybackApi as a7, PxPlaybackDirection as a8, type PxPropertyAnimation as a9, PxTimelineSchema as aA, PxTransformByEffectSchema as aB, type PxTransformParts as aC, PxTransformPartsSchema as aD, type PxTransformValue as aE, PxTransformValueSchema as aF, type PxTrigger as aG, PxTriggerSchema as aH, PxUnits as aI, type PxValidationContext as aJ, type PxVec2 as aK, type PxWireConversionOptions as aL, type PxWireConversionResult as aM, PxWireStepKind as aN, type PxWireVersion as aO, PxWireVersionRelation as aP, type PxWireVersionStep as aQ, applyWireSteps as aR, calcAnimationValues as aS, compareWireVersion as aT, controlModeTakesOverTrigger as aU, convertWireDocument as aV, describeSchema as aW, diagnoseDocument as aX, downgradeWireDocument as aY, flattenAnimatorTimeline as aZ, formatWireVersion as a_, PxPropertyAnimationSchema as aa, type PxRemoveIndex as ab, PxRepeaterEffectSchema as ac, PxRetimeEffectSchema as ad, type PxSchema as ae, type PxSchemaDesc as af, type PxScroll as ag, PxScrollAxis as ah, PxScrollKind as ai, PxScrollPhase as aj, type PxScrollRangePoint as ak, PxScrollRangePointSchema as al, PxScrollRangeSchema as am, PxScrollSchema as an, PxScrollSource as ao, PxStrokeTrimEffectSchema as ap, PxStrokeTrimSubPaths as aq, type PxSvgNode as ar, PxSvgNodeRootSchema as as, PxTextEffectSchema as at, PxTextPathEffectSchema as au, PxTextPathMethod as av, PxTextPathSpacing as aw, type PxTimeline as ax, PxTimelineEngine as ay, PxTimelineEngineSetting as az, type PxAnimatorApi as b, getAnimatorConfig as b0, getBindings as b1, getChildren as b2, getDefinitions as b3, isNativeForced as b4, isPxDocument as b5, isValidPxDocument as b6, materializeAllInTree as b7, mayUseNativeScrollTimeline as b8, nestAnimatorTimeline as b9, generateUniqueId as bA, interpolateValue as bB, keyframeEasing as bC, keyframeValue as bD, materializeMotionPathInPropAnim as bE, mergeStaticTransformIntoAnimDef as bF, reportDocumentDiagnostics as bG, sanitizeAttributeValue as bH, normalizeBindings as ba, parseWireVersion as bb, px as bc, readWireVersion as bd, resolveControlMode as be, resolveTimelineEngine as bf, resolveTrigger as bg, schemaKeys as bh, toDomProps as bi, validateDocument as bj, validateNodeEffects as bk, wireVersionAdvice as bl, type PxAnimatable as bm, PX_ANIM_ATTR_NAME as bn, PX_ANIM_SRC_ATTR_NAME as bo, PX_CSS_ONLY_STYLE_PROPS as bp, PX_DISALLOWED_SVG_TAGS_LOWER as bq, PX_LOOP_JUMP_SHIFT_MS as br, PX_TEXT_CONTENT_ATTR as bs, PX_UNKNOWN_KEY_ERROR as bt, type PxAnyKeyframe as bu, type PxMaterializeAllOptions as bv, type PxNormalizedKeyframe as bw, type PxNormalizedPropertyAnimation as bx, createDiagnostics as by, deepClone as bz, type PxAnimatorConfig as c, PxStartOn as d, type PxNode as e, PX_TRANSFORM_PART_KEYS as f, PX_TRIGGER_DEFAULTS as g, PX_WIRE_BASELINE_VERSION as h, PX_WIRE_STEPS as i, PX_WIRE_VERSION as j, PX_WIRE_VERSION_KEY as k, PxAlongPathMode as l, PxAnimatedSvgDocumentSchema as m, type PxAnimationDefinition as n, type PxAnimatorCallbacks as o, PxAnimatorConfigSchema as p, type PxAnimatorHandle as q, PxAttrValueSchema as r, type PxBezierPath as s, PxBezierPathSchema as t, type PxBinding as u, PxClipPathEffectSchema as v, PxCloneEffectSchema as w, PxCloneWithout as x, PxControlMode as y, type PxControlProps as z };
+export { PxLoopRepeatAt as $, type PxDefinitions as A, PxDefinitionsSchema as B, type PxDiagnostic as C, PxDiagnosticCode as D, PxDiagnosticKind as E, type PxDiagnostics as F, type PxDiagnosticsConfig as G, type PxEffects as H, PxEffectsSchema as I, type PxElementAnimation as J, PxElementAnimationSchema as K, PxFillGradientEffectSchema as L, PxFillMode as M, PxFinishAction as N, type PxGlyph as O, type PxAnimatedSvgDocument as P, type PxGlyphFont as Q, PxGradientSpreadMethod as R, PxGradientStopSchema as S, PxGradientType as T, type PxInfer as U, type PxKeyframe as V, PxKeyframeSchema as W, PxKeyframeValueSchema as X, PxLengthAdjust as Y, type PxLoop as Z, PxLoopDirection as _, type PxEngineCallbacks as a, flattenAnimatorTimeline as a$, PxLoopSchema as a0, PxMaskType as a1, PxMaskedByEffectSchema as a2, PxMouseOutAction as a3, PxNodeBaseSchema as a4, PxNodeSchema as a5, PxOffScreenAction as a6, PxPathOverflow as a7, PxPinAlign as a8, type PxPlaybackApi as a9, PxTimelineEngine as aA, PxTimelineEngineSetting as aB, PxTimelineSchema as aC, PxTransformByEffectSchema as aD, type PxTransformParts as aE, PxTransformPartsSchema as aF, type PxTransformValue as aG, PxTransformValueSchema as aH, type PxTrigger as aI, PxTriggerSchema as aJ, PxUnits as aK, type PxValidationContext as aL, type PxVec2 as aM, type PxWireConversionOptions as aN, type PxWireConversionResult as aO, PxWireStepKind as aP, type PxWireVersion as aQ, PxWireVersionRelation as aR, type PxWireVersionStep as aS, applyWireSteps as aT, calcAnimationValues as aU, compareWireVersion as aV, controlModeTakesOverTrigger as aW, convertWireDocument as aX, describeSchema as aY, diagnoseDocument as aZ, downgradeWireDocument as a_, PxPlaybackDirection as aa, type PxPropertyAnimation as ab, PxPropertyAnimationSchema as ac, type PxRemoveIndex as ad, PxRepeaterEffectSchema as ae, PxRetimeEffectSchema as af, type PxSchema as ag, type PxSchemaDesc as ah, type PxScroll as ai, PxScrollAxis as aj, PxScrollKind as ak, PxScrollPhase as al, type PxScrollRangePoint as am, PxScrollRangePointSchema as an, PxScrollRangeSchema as ao, PxScrollSchema as ap, PxScrollSource as aq, PxStrokeTrimEffectSchema as ar, PxStrokeTrimSubPaths as as, type PxSvgNode as at, PxSvgNodeRootSchema as au, PxTextEffectSchema as av, PxTextPathEffectSchema as aw, PxTextPathMethod as ax, PxTextPathSpacing as ay, type PxTimeline as az, type PxAnimatorApi as b, formatWireVersion as b0, generateNewIds as b1, getAnimatorConfig as b2, getBindings as b3, getChildren as b4, getDefinitions as b5, isNativeForced as b6, isPxDocument as b7, isValidPxDocument as b8, materializeAllInTree as b9, createDiagnostics as bA, deepClone as bB, generateUniqueId as bC, interpolateValue as bD, keyframeEasing as bE, keyframeValue as bF, materializeMotionPathInPropAnim as bG, mergeStaticTransformIntoAnimDef as bH, reportDocumentDiagnostics as bI, sanitizeAttributeValue as bJ, mayUseNativeScrollTimeline as ba, nestAnimatorTimeline as bb, normalizeBindings as bc, parseWireVersion as bd, px as be, readWireVersion as bf, resolveControlMode as bg, resolveTimelineEngine as bh, resolveTrigger as bi, schemaKeys as bj, toDomProps as bk, validateDocument as bl, validateNodeEffects as bm, wireVersionAdvice as bn, type PxAnimatable as bo, PX_ANIM_ATTR_NAME as bp, PX_ANIM_SRC_ATTR_NAME as bq, PX_CSS_ONLY_STYLE_PROPS as br, PX_DISALLOWED_SVG_TAGS_LOWER as bs, PX_LOOP_JUMP_SHIFT_MS as bt, PX_TEXT_CONTENT_ATTR as bu, PX_UNKNOWN_KEY_ERROR as bv, type PxAnyKeyframe as bw, type PxMaterializeAllOptions as bx, type PxNormalizedKeyframe as by, type PxNormalizedPropertyAnimation as bz, type PxAnimatorConfig as c, PxTriggerStart as d, type PxNode as e, PX_TRANSFORM_PART_KEYS as f, PX_TRIGGER_DEFAULTS as g, PX_WIRE_BASELINE_VERSION as h, PX_WIRE_STEPS as i, PX_WIRE_VERSION as j, PX_WIRE_VERSION_KEY as k, PxAlongPathMode as l, PxAnimatedSvgDocumentSchema as m, type PxAnimationDefinition as n, type PxAnimatorCallbacks as o, PxAnimatorConfigSchema as p, type PxAnimatorHandle as q, PxAttrValueSchema as r, type PxBezierPath as s, PxBezierPathSchema as t, type PxBinding as u, PxClipPathEffectSchema as v, PxCloneEffectSchema as w, PxCloneWithout as x, PxControlMode as y, type PxControlProps as z };