@pixodesk/svg-animator-core 1.0.40 → 1.0.41

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PxAnimatedSvgDocument, a as PxEngineCallbacks, b as PxAnimatorAPI, c as PxAnimatorConfig, d as PxStartOn, e as PxNode } from './internal-BZSJtt_h.cjs';
-export { B as BASELINE_PLAYER_VERSION, C as COLOR_ATTR_NAMES, f as CSS_ONLY_STYLE_PROPS, D as DEFAULT_DURATION_MS, g as DISALLOWED_SVG_TAGS_LOWER, G as GlyphCharBox, L as LOOP_JUMP_SHIFT_MS, M as MaterializeAllOptions, h as PCT_BASED_ATTR_NAMES, i as PLAYER_WIRE_STEPS, j as PLAYER_WIRE_VERSION, k as PX_ANIM_ATTR_NAME, l as PX_ANIM_SRC_ATTR_NAME, m as PX_TRANSFORM_PART_KEYS, n as PX_TRIGGER_DEFAULTS, o as PX_UNKNOWN_KEY_ERROR, p as PlayerConversionResult, q as PxAlongPathMode, r as PxAnimatable, s as PxAnimatedSvgDocumentSchema, t as PxAnimationDefinition, u as PxAnimatorCallbacks, v as PxAnimatorConfigSchema, w as PxAnimatorHandle, x as PxAnyKeyframe, y as PxAttrValueSchema, z as PxBasicAnimatorAPI, A as PxBezierPath, E as PxBezierPathSchema, F as PxBinding, H as PxClipPathEffectSchema, I as PxCloneEffectSchema, J as PxCloneWithout, K as PxControlMode, N as PxControlProps, O as PxCreateElement, Q as PxDefs, R as PxDefsSchema, S as PxDiagnostic, T as PxDiagnosticKind, U as PxDiagnostics, V as PxDiagnosticsConfig, W as PxEffects, X as PxEffectsSchema, Y as PxElementAnimation, Z as PxElementAnimationSchema, _ as PxFillGradientEffectSchema, $ as PxFillMode, a0 as PxFinishAction, a1 as PxGlyph, a2 as PxGlyphFont, a3 as PxGradientSpreadMethod, a4 as PxGradientStopSchema, a5 as PxGradientType, a6 as PxInfer, a7 as PxKeyframe, a8 as PxKeyframeSchema, a9 as PxKeyframeValueSchema, aa as PxLengthAdjust, ab as PxLoop, ac as PxLoopDirection, ad as PxLoopRepeatAt, ae as PxLoopSchema, af as PxMaskType, ag as PxMaskedByEffectSchema, ah as PxNodeBase, ai as PxNodeSchema, aj as PxNormalizedKeyframe, ak as PxNormalizedPropertyAnimation, al as PxOutAction, am as PxPathOverflow, an as PxPinAlign, ao as PxPlaybackDirection, ap as PxPropertyAnimation, aq as PxPropertyAnimationSchema, ar as PxRepeaterEffectSchema, as as PxRetimeEffectSchema, at as PxSchema, au as PxSchemaDesc, av as PxScroll, aw as PxScrollAxis, ax as PxScrollKind, ay as PxScrollPhase, az as PxScrollRangePoint, aA as PxScrollRangePointSchema, aB as PxScrollRangeSchema, aC as PxScrollSchema, aD as PxScrollSource, aE as PxStrokeTrimEffectSchema, aF as PxStrokeTrimSubPaths, aG as PxSvgNode, aH as PxSvgNodeExtra, aI as PxTextEffectSchema, aJ as PxTextPathEffectSchema, aK as PxTextPathMethod, aL as PxTextPathSpacing, aM as PxTimeline, aN as PxTimelineEngine, aO as PxTimelineEngineExtra, aP as PxTimelineSchema, aQ as PxTransformByEffectSchema, aR as PxTransformParts, aS as PxTransformPartsSchema, aT as PxTransformValue, aU as PxTransformValueSchema, aV as PxTrigger, aW as PxTriggerSchema, aX as PxUnits, aY as PxValidationContext, aZ as RemoveIndex, a_ as STYLE_ATTR_NAMES, a$ as TEXT_CONTENT_ATTR, b0 as TRANSFORM_FN_NAMES, b1 as Vec2, b2 as WIRE_VERSION_KEY, b3 as WireConversionConfig, b4 as WireStepKind, b5 as WireVersion, b6 as WireVersionRelation, b7 as WireVersionStep, b8 as applyWireSteps, b9 as bezierToSvgPath, ba as calcAnimationValues, bb as camelCaseToKebabWordIfNeeded, bc as clamp, bd as compareWireVersion, be as composeTransformParts, bf as controlModeTakesOverTrigger, bg as convertPlayerDocument, bh as createDiagnostics, bi as createPathSampler, bj as cubicBezier, bk as deepClone, bl as describeSchema, bm as diagnoseDocument, bn as diffFieldUniverse, bo as diffInEffect, bp as downgradePlayerDocument, bq as extendedPathForBrowser, br as flattenAnimatorTimeline, bs as formatWireVersion, bt as generateNewIds, bu as generateUniqueId, bv as getAnimatorConfig, bw as getBindings, bx as getChildren, by as getDefs, bz as getNormalizedBindings, bA as getNormalizedProps, bB as interpolateValue, bC as isNativeForced, bD as isPxElementFileFormat, bE as isPxElementFileFormatDeep, bF as isScrollTimeline, bG as kebabToCamelCaseWord, bH as kfEasing, bI as kfValue, bJ as layoutGlyphTextChars, bK as materializeAllInTree, bL as materializeGlyphText, bM as materializeGlyphTextAlongPath, bN as materializeMotionPathInPropAnim, bO as mayUseNativeScrollTimeline, bP as mergeStaticTransformIntoAnimDef, bQ as nestAnimatorTimeline, bR as parseWireVersion, bS as planSchemaRelease, bT as px, bU as readWireVersion, bV as releaseLogProblems, bW as reportDocumentDiagnostics, bX as resolveControlMode, bY as resolveTimelineEngine, bZ as resolveTrigger, b_ as reverseEasing, b$ as sanitizeAttributeValue, c0 as schemaFieldUniverse, c1 as schemaKeys, c2 as scrollOffsetProgress, c3 as scrollPhaseInterval, c4 as scrollResolveAxis, c5 as scrollTotalDurationMs, c6 as scrollViewProgress, c7 as splitEasing, c8 as subdivideCubicBezier, c9 as toRGBA, ca as validateDocument, cb as validateNodeEffects, cc as versionAdvice } from './internal-BZSJtt_h.cjs';
+import { P as PxAnimatedSvgDocument, a as PxEngineCallbacks, b as PxAnimatorApi, c as PxAnimatorConfig, d as PxStartOn, e as PxNode } from './PxDocumentDiagnostic-COGEjBbg.cjs';
+export { f as PX_TRANSFORM_PART_KEYS, g as PX_TRIGGER_DEFAULTS, h as PX_WIRE_BASELINE_VERSION, i as PX_WIRE_STEPS, j as PX_WIRE_VERSION, k as PX_WIRE_VERSION_KEY, l as PxAlongPathMode, m as PxAnimatedSvgDocumentSchema, n as PxAnimationDefinition, o as PxAnimatorCallbacks, p as PxAnimatorConfigSchema, q as PxAnimatorHandle, r as PxAttrValueSchema, s as PxBezierPath, t as PxBezierPathSchema, u as PxBinding, v as PxClipPathEffectSchema, w as PxCloneEffectSchema, x as PxCloneWithout, y as PxControlMode, z as PxControlProps, A as PxDefinitions, B as PxDefinitionsSchema, C as PxDiagnostic, D as PxDiagnosticKind, E as PxDiagnostics, F as PxDiagnosticsConfig, G as PxEffects, H as PxEffectsSchema, I as PxElementAnimation, J as PxElementAnimationSchema, K as PxFillGradientEffectSchema, L as PxFillMode, M as PxFinishAction, N as PxGlyph, O as PxGlyphFont, Q as PxGradientSpreadMethod, R as PxGradientStopSchema, S as PxGradientType, T as PxInfer, U as PxKeyframe, V as PxKeyframeSchema, W as PxKeyframeValueSchema, X as PxLengthAdjust, Y as PxLoop, Z as PxLoopDirection, _ as PxLoopRepeatAt, $ as PxLoopSchema, a0 as PxMaskType, a1 as PxMaskedByEffectSchema, a2 as PxNodeBaseSchema, a3 as PxNodeSchema, a4 as PxOutAction, a5 as PxPathOverflow, a6 as PxPinAlign, a7 as PxPlaybackApi, a8 as PxPlaybackDirection, a9 as PxPropertyAnimation, aa as PxPropertyAnimationSchema, ab as PxRemoveIndex, ac as PxRepeaterEffectSchema, ad as PxRetimeEffectSchema, ae as PxSchema, af as PxSchemaDesc, ag as PxScroll, ah as PxScrollAxis, ai as PxScrollKind, aj as PxScrollPhase, ak as PxScrollRangePoint, al as PxScrollRangePointSchema, am as PxScrollRangeSchema, an as PxScrollSchema, ao as PxScrollSource, ap as PxStrokeTrimEffectSchema, aq as PxStrokeTrimSubPaths, ar as PxSvgNode, as as PxSvgNodeRootSchema, at as PxTextEffectSchema, au as PxTextPathEffectSchema, av as PxTextPathMethod, aw as PxTextPathSpacing, ax as PxTimeline, ay as PxTimelineEngine, az as PxTimelineEngineSetting, aA as PxTimelineSchema, aB as PxTransformByEffectSchema, aC as PxTransformParts, aD as PxTransformPartsSchema, aE as PxTransformValue, aF as PxTransformValueSchema, aG as PxTrigger, aH as PxTriggerSchema, aI as PxUnits, aJ as PxValidationContext, aK as PxVec2, aL as PxWireConversionOptions, aM as PxWireConversionResult, aN as PxWireStepKind, aO as PxWireVersion, aP as PxWireVersionRelation, aQ as PxWireVersionStep, aR as applyWireSteps, aS as calcAnimationValues, aT as compareWireVersion, aU as controlModeTakesOverTrigger, aV as convertWireDocument, aW as describeSchema, aX as diagnoseDocument, aY as downgradeWireDocument, aZ as flattenAnimatorTimeline, a_ as formatWireVersion, a$ as generateNewIds, b0 as getAnimatorConfig, b1 as getBindings, b2 as getChildren, b3 as getDefinitions, b4 as isNativeForced, b5 as isPxDocument, b6 as isValidPxDocument, b7 as materializeAllInTree, b8 as mayUseNativeScrollTimeline, b9 as nestAnimatorTimeline, ba as normalizeBindings, bb as parseWireVersion, bc as px, bd as readWireVersion, be as resolveControlMode, bf as resolveTimelineEngine, bg as resolveTrigger, bh as schemaKeys, bi as toDomProps, bj as validateDocument, bk as validateNodeEffects, bl as wireVersionAdvice } from './PxDocumentDiagnostic-COGEjBbg.cjs';
 
 /**
  * THE PLAYER'S WIRE SCHEMA VERSION — the `a.b` of `svgRoot.animator.version`.
@@ -15,7 +15,7 @@ export { B as BASELINE_PLAYER_VERSION, C as COLOR_ATTR_NAMES, f as CSS_ONLY_STYL
  * and every format change invisible between releases.
  * @public @advanced
  */
-declare const PX_PLAYER_SCHEMA_VERSION = "1.1";
+declare const PX_WIRE_SCHEMA_VERSION = "1.1";
 
 /**
  * Platform adapter interface for abstracting platform-specific operations.
@@ -33,10 +33,10 @@ interface PxPlatformAdapter {
  *
  * @param adapter Platform adapter for DOM/environment operations.
  * @param callbacks Optional lifecycle callbacks.
- * @returns A PxAnimatorAPI instance.
+ * @returns A PxAnimatorApi instance.
  * @public @advanced
  */
-declare function createBasicFrameLoopAnimator(doc: PxAnimatedSvgDocument, adapter: PxPlatformAdapter, callbacks?: PxEngineCallbacks): PxAnimatorAPI;
+declare function createAdapterAnimator(doc: PxAnimatedSvgDocument, adapter: PxPlatformAdapter, callbacks?: PxEngineCallbacks): PxAnimatorApi;
 
 /** The one message every engine prints for a rejected rate. @public @advanced */
 declare const PX_RATE_REJECTED = "setPlaybackRate: rate must be finite and non-zero";
@@ -126,7 +126,7 @@ interface PxAnimatorConfigMergeResult {
 /** A deep-partial of the WIRE `timeline` block; `null` at any slot deletes it. @public */
 type PxTimelinePatch = Record<string, any> | null;
 /** The four flat shortcuts every surface offers for the keys people reach for most. @public */
-interface PxAnimatorConfigShortcuts {
+interface PxTimelineShortcuts {
     /** Shortcut for `timeline.duration` — one iteration, ms. Wins over the same key in `timeline`. */
     duration?: number;
     /** Shortcut for `timeline.delay` — the wait before the first iteration, ms. */
@@ -147,10 +147,10 @@ interface PxAnimatorConfigShortcuts {
  * from it, `createAnimator`'s options extend it.
  * @public
  */
-interface PxPlaybackOverrideProps extends PxAnimatorConfigShortcuts {
+interface PxPlaybackOverride extends PxTimelineShortcuts {
     /**
      * Per-instance override of the document's `animator.timeline` — the same shape as `timeline`
-     * in SCHEMA.md, deep-merged over what the document says, so one file can play twice on a page
+     * in docs/format/README.md, deep-merged over what the document says, so one file can play twice on a page
      * with different timing. `null` at any slot DELETES that key, restoring the default its
      * absence means. Also accepts a JSON STRING, which survives a build that mangles object keys.
      *
@@ -174,7 +174,7 @@ interface PxPlaybackOverrideProps extends PxAnimatorConfigShortcuts {
  * way an inline style beats a stylesheet. One implementation so every surface agrees.
  * @public
  */
-declare function foldTimelineOverride(timeline: PxTimelinePatch | string | undefined, shortcuts: PxAnimatorConfigShortcuts): PxAnimatorConfigPatch | undefined;
+declare function foldTimelineOverride(timeline: PxTimelinePatch | string | undefined, shortcuts: PxTimelineShortcuts): PxAnimatorConfigPatch | undefined;
 /**
  * Merge a patch over an animator config. PURE — neither argument is mutated, and the result is
  * always a NEW object, which also matters because `flattenAnimatorTimeline` memoises on config
@@ -186,14 +186,14 @@ declare function mergeAnimatorConfig(base: PxAnimatorConfig | undefined, patch:
  * Document level: resolves the two canonical addresses of the animator config and returns a NEW
  * document that shares every untouched subtree by reference.
  *
- * `resetDefaults` starts from the player's own defaults instead of the document's playback
+ * `resetTimeline` starts from the player's own defaults instead of the document's playback
  * settings — "play this file as if it said nothing about timing". The lookup tables are kept
  * either way: resetting `definitions`/`bindings` would leave an animation with nothing to
  * animate, which is never what a caller means.
  * @public
  */
-declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimatorConfigPatch, opts?: {
-    resetDefaults?: boolean;
+declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimatorConfigPatch, options?: {
+    resetTimeline?: boolean;
 }): {
     doc: PxAnimatedSvgDocument;
     warnings: Array<string>;
@@ -201,7 +201,7 @@ declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimat
 
 /**
  * Applier-runtime types: `ApplyContext` (per-run mutable state) and `ApplyResult`
- * (return shape of `applyPlayerEffects`).
+ * (return shape of `materializeNodeEffects`).
  *
  * The wire-shape types (`PxNode`, `PxEffects`, individual effect shapes,
  * `PxAnimatable<T>`, etc.) live in `../PxAnimatorTypes` — the single source
@@ -233,6 +233,6 @@ interface ApplyResult {
  * can target the inner layer.
  * @public @advanced
  */
-declare function applyPlayerEffects(root: PxNode): ApplyResult;
+declare function materializeNodeEffects(root: PxNode): ApplyResult;
 
-export { PX_PLAYER_SCHEMA_VERSION, PX_RATE_REJECTED, PxAnimatedSvgDocument, PxAnimatorAPI, PxAnimatorConfig, type PxAnimatorConfigMergeResult, type PxAnimatorConfigPatch, type PxAnimatorConfigShortcuts, PxEngineCallbacks, PxNode, type PxPlatformAdapter, type PxPlaybackOverrideProps, PxStartOn, type PxTimelinePatch, applyAnimatorConfig, applyPlayerEffects, clampSeekMs, createBasicFrameLoopAnimator, createRunClock, foldTimelineOverride, isValidPlaybackRate, mergeAnimatorConfig, progressSpanMs, progressToTimeMs, seekCeilingMs, timeToProgress };
+export { PX_RATE_REJECTED, PX_WIRE_SCHEMA_VERSION, PxAnimatedSvgDocument, PxAnimatorApi, PxAnimatorConfig, type PxAnimatorConfigMergeResult, type PxAnimatorConfigPatch, PxEngineCallbacks, PxNode, type PxPlatformAdapter, type PxPlaybackOverride, PxStartOn, type PxTimelinePatch, type PxTimelineShortcuts, applyAnimatorConfig, clampSeekMs, createAdapterAnimator, createRunClock, foldTimelineOverride, isValidPlaybackRate, materializeNodeEffects, mergeAnimatorConfig, progressSpanMs, progressToTimeMs, seekCeilingMs, timeToProgress };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PxAnimatedSvgDocument, a as PxEngineCallbacks, b as PxAnimatorAPI, c as PxAnimatorConfig, d as PxStartOn, e as PxNode } from './internal-BZSJtt_h.js';
-export { B as BASELINE_PLAYER_VERSION, C as COLOR_ATTR_NAMES, f as CSS_ONLY_STYLE_PROPS, D as DEFAULT_DURATION_MS, g as DISALLOWED_SVG_TAGS_LOWER, G as GlyphCharBox, L as LOOP_JUMP_SHIFT_MS, M as MaterializeAllOptions, h as PCT_BASED_ATTR_NAMES, i as PLAYER_WIRE_STEPS, j as PLAYER_WIRE_VERSION, k as PX_ANIM_ATTR_NAME, l as PX_ANIM_SRC_ATTR_NAME, m as PX_TRANSFORM_PART_KEYS, n as PX_TRIGGER_DEFAULTS, o as PX_UNKNOWN_KEY_ERROR, p as PlayerConversionResult, q as PxAlongPathMode, r as PxAnimatable, s as PxAnimatedSvgDocumentSchema, t as PxAnimationDefinition, u as PxAnimatorCallbacks, v as PxAnimatorConfigSchema, w as PxAnimatorHandle, x as PxAnyKeyframe, y as PxAttrValueSchema, z as PxBasicAnimatorAPI, A as PxBezierPath, E as PxBezierPathSchema, F as PxBinding, H as PxClipPathEffectSchema, I as PxCloneEffectSchema, J as PxCloneWithout, K as PxControlMode, N as PxControlProps, O as PxCreateElement, Q as PxDefs, R as PxDefsSchema, S as PxDiagnostic, T as PxDiagnosticKind, U as PxDiagnostics, V as PxDiagnosticsConfig, W as PxEffects, X as PxEffectsSchema, Y as PxElementAnimation, Z as PxElementAnimationSchema, _ as PxFillGradientEffectSchema, $ as PxFillMode, a0 as PxFinishAction, a1 as PxGlyph, a2 as PxGlyphFont, a3 as PxGradientSpreadMethod, a4 as PxGradientStopSchema, a5 as PxGradientType, a6 as PxInfer, a7 as PxKeyframe, a8 as PxKeyframeSchema, a9 as PxKeyframeValueSchema, aa as PxLengthAdjust, ab as PxLoop, ac as PxLoopDirection, ad as PxLoopRepeatAt, ae as PxLoopSchema, af as PxMaskType, ag as PxMaskedByEffectSchema, ah as PxNodeBase, ai as PxNodeSchema, aj as PxNormalizedKeyframe, ak as PxNormalizedPropertyAnimation, al as PxOutAction, am as PxPathOverflow, an as PxPinAlign, ao as PxPlaybackDirection, ap as PxPropertyAnimation, aq as PxPropertyAnimationSchema, ar as PxRepeaterEffectSchema, as as PxRetimeEffectSchema, at as PxSchema, au as PxSchemaDesc, av as PxScroll, aw as PxScrollAxis, ax as PxScrollKind, ay as PxScrollPhase, az as PxScrollRangePoint, aA as PxScrollRangePointSchema, aB as PxScrollRangeSchema, aC as PxScrollSchema, aD as PxScrollSource, aE as PxStrokeTrimEffectSchema, aF as PxStrokeTrimSubPaths, aG as PxSvgNode, aH as PxSvgNodeExtra, aI as PxTextEffectSchema, aJ as PxTextPathEffectSchema, aK as PxTextPathMethod, aL as PxTextPathSpacing, aM as PxTimeline, aN as PxTimelineEngine, aO as PxTimelineEngineExtra, aP as PxTimelineSchema, aQ as PxTransformByEffectSchema, aR as PxTransformParts, aS as PxTransformPartsSchema, aT as PxTransformValue, aU as PxTransformValueSchema, aV as PxTrigger, aW as PxTriggerSchema, aX as PxUnits, aY as PxValidationContext, aZ as RemoveIndex, a_ as STYLE_ATTR_NAMES, a$ as TEXT_CONTENT_ATTR, b0 as TRANSFORM_FN_NAMES, b1 as Vec2, b2 as WIRE_VERSION_KEY, b3 as WireConversionConfig, b4 as WireStepKind, b5 as WireVersion, b6 as WireVersionRelation, b7 as WireVersionStep, b8 as applyWireSteps, b9 as bezierToSvgPath, ba as calcAnimationValues, bb as camelCaseToKebabWordIfNeeded, bc as clamp, bd as compareWireVersion, be as composeTransformParts, bf as controlModeTakesOverTrigger, bg as convertPlayerDocument, bh as createDiagnostics, bi as createPathSampler, bj as cubicBezier, bk as deepClone, bl as describeSchema, bm as diagnoseDocument, bn as diffFieldUniverse, bo as diffInEffect, bp as downgradePlayerDocument, bq as extendedPathForBrowser, br as flattenAnimatorTimeline, bs as formatWireVersion, bt as generateNewIds, bu as generateUniqueId, bv as getAnimatorConfig, bw as getBindings, bx as getChildren, by as getDefs, bz as getNormalizedBindings, bA as getNormalizedProps, bB as interpolateValue, bC as isNativeForced, bD as isPxElementFileFormat, bE as isPxElementFileFormatDeep, bF as isScrollTimeline, bG as kebabToCamelCaseWord, bH as kfEasing, bI as kfValue, bJ as layoutGlyphTextChars, bK as materializeAllInTree, bL as materializeGlyphText, bM as materializeGlyphTextAlongPath, bN as materializeMotionPathInPropAnim, bO as mayUseNativeScrollTimeline, bP as mergeStaticTransformIntoAnimDef, bQ as nestAnimatorTimeline, bR as parseWireVersion, bS as planSchemaRelease, bT as px, bU as readWireVersion, bV as releaseLogProblems, bW as reportDocumentDiagnostics, bX as resolveControlMode, bY as resolveTimelineEngine, bZ as resolveTrigger, b_ as reverseEasing, b$ as sanitizeAttributeValue, c0 as schemaFieldUniverse, c1 as schemaKeys, c2 as scrollOffsetProgress, c3 as scrollPhaseInterval, c4 as scrollResolveAxis, c5 as scrollTotalDurationMs, c6 as scrollViewProgress, c7 as splitEasing, c8 as subdivideCubicBezier, c9 as toRGBA, ca as validateDocument, cb as validateNodeEffects, cc as versionAdvice } from './internal-BZSJtt_h.js';
+import { P as PxAnimatedSvgDocument, a as PxEngineCallbacks, b as PxAnimatorApi, c as PxAnimatorConfig, d as PxStartOn, e as PxNode } from './PxDocumentDiagnostic-COGEjBbg.js';
+export { f as PX_TRANSFORM_PART_KEYS, g as PX_TRIGGER_DEFAULTS, h as PX_WIRE_BASELINE_VERSION, i as PX_WIRE_STEPS, j as PX_WIRE_VERSION, k as PX_WIRE_VERSION_KEY, l as PxAlongPathMode, m as PxAnimatedSvgDocumentSchema, n as PxAnimationDefinition, o as PxAnimatorCallbacks, p as PxAnimatorConfigSchema, q as PxAnimatorHandle, r as PxAttrValueSchema, s as PxBezierPath, t as PxBezierPathSchema, u as PxBinding, v as PxClipPathEffectSchema, w as PxCloneEffectSchema, x as PxCloneWithout, y as PxControlMode, z as PxControlProps, A as PxDefinitions, B as PxDefinitionsSchema, C as PxDiagnostic, D as PxDiagnosticKind, E as PxDiagnostics, F as PxDiagnosticsConfig, G as PxEffects, H as PxEffectsSchema, I as PxElementAnimation, J as PxElementAnimationSchema, K as PxFillGradientEffectSchema, L as PxFillMode, M as PxFinishAction, N as PxGlyph, O as PxGlyphFont, Q as PxGradientSpreadMethod, R as PxGradientStopSchema, S as PxGradientType, T as PxInfer, U as PxKeyframe, V as PxKeyframeSchema, W as PxKeyframeValueSchema, X as PxLengthAdjust, Y as PxLoop, Z as PxLoopDirection, _ as PxLoopRepeatAt, $ as PxLoopSchema, a0 as PxMaskType, a1 as PxMaskedByEffectSchema, a2 as PxNodeBaseSchema, a3 as PxNodeSchema, a4 as PxOutAction, a5 as PxPathOverflow, a6 as PxPinAlign, a7 as PxPlaybackApi, a8 as PxPlaybackDirection, a9 as PxPropertyAnimation, aa as PxPropertyAnimationSchema, ab as PxRemoveIndex, ac as PxRepeaterEffectSchema, ad as PxRetimeEffectSchema, ae as PxSchema, af as PxSchemaDesc, ag as PxScroll, ah as PxScrollAxis, ai as PxScrollKind, aj as PxScrollPhase, ak as PxScrollRangePoint, al as PxScrollRangePointSchema, am as PxScrollRangeSchema, an as PxScrollSchema, ao as PxScrollSource, ap as PxStrokeTrimEffectSchema, aq as PxStrokeTrimSubPaths, ar as PxSvgNode, as as PxSvgNodeRootSchema, at as PxTextEffectSchema, au as PxTextPathEffectSchema, av as PxTextPathMethod, aw as PxTextPathSpacing, ax as PxTimeline, ay as PxTimelineEngine, az as PxTimelineEngineSetting, aA as PxTimelineSchema, aB as PxTransformByEffectSchema, aC as PxTransformParts, aD as PxTransformPartsSchema, aE as PxTransformValue, aF as PxTransformValueSchema, aG as PxTrigger, aH as PxTriggerSchema, aI as PxUnits, aJ as PxValidationContext, aK as PxVec2, aL as PxWireConversionOptions, aM as PxWireConversionResult, aN as PxWireStepKind, aO as PxWireVersion, aP as PxWireVersionRelation, aQ as PxWireVersionStep, aR as applyWireSteps, aS as calcAnimationValues, aT as compareWireVersion, aU as controlModeTakesOverTrigger, aV as convertWireDocument, aW as describeSchema, aX as diagnoseDocument, aY as downgradeWireDocument, aZ as flattenAnimatorTimeline, a_ as formatWireVersion, a$ as generateNewIds, b0 as getAnimatorConfig, b1 as getBindings, b2 as getChildren, b3 as getDefinitions, b4 as isNativeForced, b5 as isPxDocument, b6 as isValidPxDocument, b7 as materializeAllInTree, b8 as mayUseNativeScrollTimeline, b9 as nestAnimatorTimeline, ba as normalizeBindings, bb as parseWireVersion, bc as px, bd as readWireVersion, be as resolveControlMode, bf as resolveTimelineEngine, bg as resolveTrigger, bh as schemaKeys, bi as toDomProps, bj as validateDocument, bk as validateNodeEffects, bl as wireVersionAdvice } from './PxDocumentDiagnostic-COGEjBbg.js';
 
 /**
  * THE PLAYER'S WIRE SCHEMA VERSION — the `a.b` of `svgRoot.animator.version`.
@@ -15,7 +15,7 @@ export { B as BASELINE_PLAYER_VERSION, C as COLOR_ATTR_NAMES, f as CSS_ONLY_STYL
  * and every format change invisible between releases.
  * @public @advanced
  */
-declare const PX_PLAYER_SCHEMA_VERSION = "1.1";
+declare const PX_WIRE_SCHEMA_VERSION = "1.1";
 
 /**
  * Platform adapter interface for abstracting platform-specific operations.
@@ -33,10 +33,10 @@ interface PxPlatformAdapter {
  *
  * @param adapter Platform adapter for DOM/environment operations.
  * @param callbacks Optional lifecycle callbacks.
- * @returns A PxAnimatorAPI instance.
+ * @returns A PxAnimatorApi instance.
  * @public @advanced
  */
-declare function createBasicFrameLoopAnimator(doc: PxAnimatedSvgDocument, adapter: PxPlatformAdapter, callbacks?: PxEngineCallbacks): PxAnimatorAPI;
+declare function createAdapterAnimator(doc: PxAnimatedSvgDocument, adapter: PxPlatformAdapter, callbacks?: PxEngineCallbacks): PxAnimatorApi;
 
 /** The one message every engine prints for a rejected rate. @public @advanced */
 declare const PX_RATE_REJECTED = "setPlaybackRate: rate must be finite and non-zero";
@@ -126,7 +126,7 @@ interface PxAnimatorConfigMergeResult {
 /** A deep-partial of the WIRE `timeline` block; `null` at any slot deletes it. @public */
 type PxTimelinePatch = Record<string, any> | null;
 /** The four flat shortcuts every surface offers for the keys people reach for most. @public */
-interface PxAnimatorConfigShortcuts {
+interface PxTimelineShortcuts {
     /** Shortcut for `timeline.duration` — one iteration, ms. Wins over the same key in `timeline`. */
     duration?: number;
     /** Shortcut for `timeline.delay` — the wait before the first iteration, ms. */
@@ -147,10 +147,10 @@ interface PxAnimatorConfigShortcuts {
  * from it, `createAnimator`'s options extend it.
  * @public
  */
-interface PxPlaybackOverrideProps extends PxAnimatorConfigShortcuts {
+interface PxPlaybackOverride extends PxTimelineShortcuts {
     /**
      * Per-instance override of the document's `animator.timeline` — the same shape as `timeline`
-     * in SCHEMA.md, deep-merged over what the document says, so one file can play twice on a page
+     * in docs/format/README.md, deep-merged over what the document says, so one file can play twice on a page
      * with different timing. `null` at any slot DELETES that key, restoring the default its
      * absence means. Also accepts a JSON STRING, which survives a build that mangles object keys.
      *
@@ -174,7 +174,7 @@ interface PxPlaybackOverrideProps extends PxAnimatorConfigShortcuts {
  * way an inline style beats a stylesheet. One implementation so every surface agrees.
  * @public
  */
-declare function foldTimelineOverride(timeline: PxTimelinePatch | string | undefined, shortcuts: PxAnimatorConfigShortcuts): PxAnimatorConfigPatch | undefined;
+declare function foldTimelineOverride(timeline: PxTimelinePatch | string | undefined, shortcuts: PxTimelineShortcuts): PxAnimatorConfigPatch | undefined;
 /**
  * Merge a patch over an animator config. PURE — neither argument is mutated, and the result is
  * always a NEW object, which also matters because `flattenAnimatorTimeline` memoises on config
@@ -186,14 +186,14 @@ declare function mergeAnimatorConfig(base: PxAnimatorConfig | undefined, patch:
  * Document level: resolves the two canonical addresses of the animator config and returns a NEW
  * document that shares every untouched subtree by reference.
  *
- * `resetDefaults` starts from the player's own defaults instead of the document's playback
+ * `resetTimeline` starts from the player's own defaults instead of the document's playback
  * settings — "play this file as if it said nothing about timing". The lookup tables are kept
  * either way: resetting `definitions`/`bindings` would leave an animation with nothing to
  * animate, which is never what a caller means.
  * @public
  */
-declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimatorConfigPatch, opts?: {
-    resetDefaults?: boolean;
+declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimatorConfigPatch, options?: {
+    resetTimeline?: boolean;
 }): {
     doc: PxAnimatedSvgDocument;
     warnings: Array<string>;
@@ -201,7 +201,7 @@ declare function applyAnimatorConfig(doc: PxAnimatedSvgDocument, patch: PxAnimat
 
 /**
  * Applier-runtime types: `ApplyContext` (per-run mutable state) and `ApplyResult`
- * (return shape of `applyPlayerEffects`).
+ * (return shape of `materializeNodeEffects`).
  *
  * The wire-shape types (`PxNode`, `PxEffects`, individual effect shapes,
  * `PxAnimatable<T>`, etc.) live in `../PxAnimatorTypes` — the single source
@@ -233,6 +233,6 @@ interface ApplyResult {
  * can target the inner layer.
  * @public @advanced
  */
-declare function applyPlayerEffects(root: PxNode): ApplyResult;
+declare function materializeNodeEffects(root: PxNode): ApplyResult;
 
-export { PX_PLAYER_SCHEMA_VERSION, PX_RATE_REJECTED, PxAnimatedSvgDocument, PxAnimatorAPI, PxAnimatorConfig, type PxAnimatorConfigMergeResult, type PxAnimatorConfigPatch, type PxAnimatorConfigShortcuts, PxEngineCallbacks, PxNode, type PxPlatformAdapter, type PxPlaybackOverrideProps, PxStartOn, type PxTimelinePatch, applyAnimatorConfig, applyPlayerEffects, clampSeekMs, createBasicFrameLoopAnimator, createRunClock, foldTimelineOverride, isValidPlaybackRate, mergeAnimatorConfig, progressSpanMs, progressToTimeMs, seekCeilingMs, timeToProgress };
+export { PX_RATE_REJECTED, PX_WIRE_SCHEMA_VERSION, PxAnimatedSvgDocument, PxAnimatorApi, PxAnimatorConfig, type PxAnimatorConfigMergeResult, type PxAnimatorConfigPatch, PxEngineCallbacks, PxNode, type PxPlatformAdapter, type PxPlaybackOverride, PxStartOn, type PxTimelinePatch, type PxTimelineShortcuts, applyAnimatorConfig, clampSeekMs, createAdapterAnimator, createRunClock, foldTimelineOverride, isValidPlaybackRate, materializeNodeEffects, mergeAnimatorConfig, progressSpanMs, progressToTimeMs, seekCeilingMs, timeToProgress };