@pixodesk/svg-animator-web 1.0.44 → 1.0.46

package/dist/pixodesk-svg-animator.umd.js

@@ -77,19 +77,31 @@ var PixodeskAnimator = (() => {
     return result;
   }
   var Base = class {
+    /** Structural schemas (objects, arrays, unions of objects…) pass `false`: they state no scalar default. */
+    constructor(_statesDefault) {
+      this._statesDefault = _statesDefault;
+    }
     _canSanitize(raw) {
       return this.isValid(raw);
     }
+    /** A REQUIRED field is never absent; its default is the repair value. */
+    absentDefault() {
+      return this._default;
+    }
     optional() {
       return new Optional(this);
     }
   };
   var Optional = class extends Base {
     constructor(inner) {
-      super();
+      super(inner._statesDefault);
       this.inner = inner;
       this._default = void 0;
     }
+    /** Absent means the inner schema's STATED default — or nothing at all when it states none. */
+    absentDefault() {
+      return this.inner._statesDefault ? this.inner._default : void 0;
+    }
     sanitize(raw) {
       if (raw === void 0 || raw === null) return void 0;
       return this.inner._canSanitize(raw) ? this.inner.sanitize(raw) : void 0;
@@ -103,8 +115,8 @@ var PixodeskAnimator = (() => {
     }
   };
   var Str = class extends Base {
-    constructor(_default = "") {
-      super();
+    constructor(_default, statesDefault) {
+      super(statesDefault);
       this._default = _default;
     }
     sanitize(raw) {
@@ -117,8 +129,8 @@ var PixodeskAnimator = (() => {
     }
   };
   var Num = class extends Base {
-    constructor(_default = 0) {
-      super();
+    constructor(_default, statesDefault) {
+      super(statesDefault);
       this._default = _default;
     }
     sanitize(raw) {
@@ -131,8 +143,8 @@ var PixodeskAnimator = (() => {
     }
   };
   var Bool = class extends Base {
-    constructor(_default = false) {
-      super();
+    constructor(_default, statesDefault) {
+      super(statesDefault);
       this._default = _default;
     }
     sanitize(raw) {
@@ -145,8 +157,9 @@ var PixodeskAnimator = (() => {
     }
   };
   var Literal = class extends Base {
+    /** A literal IS its own value: absent means it. */
     constructor(value) {
-      super();
+      super(true);
       this.value = value;
       this._default = value;
     }
@@ -160,8 +173,8 @@ var PixodeskAnimator = (() => {
     }
   };
   var Enum = class extends Base {
-    constructor(values, defaultVal) {
-      super();
+    constructor(values, defaultVal, statesDefault) {
+      super(statesDefault);
       this.values = values;
       this._default = defaultVal != null ? defaultVal : values[0];
     }
@@ -176,8 +189,8 @@ var PixodeskAnimator = (() => {
   };
   var UNION_MEMBER_ERROR_LIMIT = 4;
   var Union = class extends Base {
-    constructor(schemas, defaultVal) {
-      super();
+    constructor(schemas, defaultVal, statesDefault) {
+      super(statesDefault);
       this.schemas = schemas;
       /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Union from Tuple. */
       this._kind = "union";
@@ -231,7 +244,7 @@ var PixodeskAnimator = (() => {
   var DiscriminatedUnion = class extends Base {
     constructor(_key, _schemas, defaultVal) {
       var _a2;
-      super();
+      super(false);
       this._key = _key;
       this._schemas = _schemas;
       /** Structural tag read by {@link describeSchema}. */
@@ -271,13 +284,19 @@ var PixodeskAnimator = (() => {
       return schema ? schema._canSanitize(raw) : this._schemas[0]._canSanitize(raw);
     }
   };
+  function statedDefaults(shape) {
+    const out = {};
+    for (const key of Object.keys(shape)) if (shape[key]._statesDefault) out[key] = shape[key].absentDefault();
+    return Object.freeze(out);
+  }
   var Obj = class extends Base {
     constructor(_shape) {
-      super();
+      super(false);
       this._shape = _shape;
       const d = {};
       for (const key of Object.keys(_shape)) d[key] = _shape[key]._default;
       this._default = d;
+      this.defaults = statedDefaults(_shape);
     }
     sanitize(raw) {
       const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
@@ -319,12 +338,13 @@ var PixodeskAnimator = (() => {
   };
   var OpenObj = class extends Base {
     constructor(_shape, _openSchema) {
-      super();
+      super(false);
       this._shape = _shape;
       this._openSchema = _openSchema;
       const d = {};
       for (const key of Object.keys(_shape)) d[key] = _shape[key]._default;
       this._default = d;
+      this.defaults = statedDefaults(_shape);
     }
     sanitize(raw) {
       const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
@@ -369,7 +389,7 @@ var PixodeskAnimator = (() => {
   };
   var Arr = class extends Base {
     constructor(item) {
-      super();
+      super(false);
       this.item = item;
       this._default = [];
     }
@@ -401,7 +421,7 @@ var PixodeskAnimator = (() => {
   };
   var Rec = class extends Base {
     constructor(value) {
-      super();
+      super(false);
       this.value = value;
       /** Structural tag read by {@link describeSchema}. */
       this._kind = "record";
@@ -435,7 +455,7 @@ var PixodeskAnimator = (() => {
   };
   var Any = class extends Base {
     constructor() {
-      super(...arguments);
+      super(false);
       this._default = void 0;
     }
     sanitize(raw) {
@@ -450,7 +470,7 @@ var PixodeskAnimator = (() => {
   };
   var Defined = class extends Base {
     constructor() {
-      super(...arguments);
+      super(false);
       this._default = void 0;
     }
     sanitize(raw) {
@@ -467,7 +487,7 @@ var PixodeskAnimator = (() => {
   };
   var Lazy = class extends Base {
     constructor(fn, _default) {
-      super();
+      super(false);
       this.fn = fn;
       this._default = _default;
       this.resolved = null;
@@ -488,7 +508,7 @@ var PixodeskAnimator = (() => {
   };
   var Tuple = class extends Base {
     constructor(schemas) {
-      super();
+      super(false);
       this.schemas = schemas;
       /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Tuple from Union. */
       this._kind = "tuple";
@@ -520,22 +540,29 @@ var PixodeskAnimator = (() => {
   function implementsInterface() {
     return (schema) => schema;
   }
+  function string(defaultVal) {
+    return defaultVal === void 0 ? new Str("", false) : new Str(defaultVal, true);
+  }
+  function number(defaultVal) {
+    return defaultVal === void 0 ? new Num(0, false) : new Num(defaultVal, true);
+  }
+  function boolean(defaultVal) {
+    return defaultVal === void 0 ? new Bool(false, false) : new Bool(defaultVal, true);
+  }
+  function oneOf(values, defaultVal) {
+    return defaultVal === void 0 ? new Enum(values, void 0, false) : new Enum(values, defaultVal, true);
+  }
+  function unionOf(schemas, defaultVal) {
+    return defaultVal === void 0 ? new Union(schemas, void 0, false) : new Union(schemas, defaultVal, true);
+  }
   var px = {
-    /** Matches a string. Default: '' or provided value. */
-    string: (defaultVal = "") => new Str(defaultVal),
-    /** Matches a finite number. Default: 0 or provided value. */
-    number: (defaultVal = 0) => new Num(defaultVal),
-    /** Matches a boolean. Default: false or provided value. */
-    boolean: (defaultVal = false) => new Bool(defaultVal),
-    /** Matches one exact primitive value; its default is the value itself. */
+    string,
+    number,
+    boolean,
+    /** Matches one exact primitive value; absent means the value itself. */
     literal: (value) => new Literal(value),
-    /** Matches one of a fixed set of string/number values. Default: first value. */
-    enum: (values, defaultVal) => new Enum(values, defaultVal),
-    /**
-     * Returns the first schema whose isValid passes.
-     * TypeScript infers the union of all member types automatically.
-     */
-    union: (schemas, defaultVal) => new Union(schemas, defaultVal),
+    enum: oneOf,
+    union: unionOf,
     /**
      * Discriminated union — reads `raw[key]`, finds the member schema whose
      * literal at `key` matches, then delegates sanitize/isValid to that member.
@@ -543,7 +570,8 @@ var PixodeskAnimator = (() => {
      * TypeScript infers the union of all member types automatically.
      */
     discriminatedUnion: (key, schemas) => new DiscriminatedUnion(key, schemas),
-    /** Typed object — unknown keys are stripped. Required fields fall back to their default. */
+    /** Typed object — unknown keys are stripped. Required fields fall back to their default.
+     *  Its `defaults` say what each stated field means when a document leaves it out. */
     object: (shape) => new Obj(shape),
     /**
      * Open object — validates known keys; passes unknown keys through as-is,
@@ -684,8 +712,11 @@ var PixodeskAnimator = (() => {
     offScreen: "pause",
     mouseOut: "continue",
     visibilityThreshold: 0.5,
-    visibilityDebounce: 150
+    visibilityDebounce: 150,
+    finish: "hold"
   };
+  var PX_DEFAULT_DURATION_MS = 1e3;
+  var PX_DEFAULT_ITERATIONS = 1;
   function resolveTrigger(trigger) {
     var _a2, _b, _c, _d, _e;
     return {
@@ -900,15 +931,15 @@ var PixodeskAnimator = (() => {
   var keyframeTangentOut = (kf) => anyKf(kf).tangentOut;
   var PxLoopSchema = implementsInterface()(px.object({
     segmentCount: px.number().optional(),
-    repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end]).optional(),
-    direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate]).optional()
+    repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end], PxLoopRepeatAt.end).optional(),
+    direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate], PxLoopDirection.normal).optional()
   }));
   var PxPropertyAnimationSchema = implementsInterface()(px.object({
     value: PxKeyframeValueSchema.optional(),
     keyframes: px.array(PxKeyframeSchema).optional(),
     loop: px.union([PxLoopSchema, px.boolean()]).optional(),
     autoOrient: px.boolean().optional(),
-    alongPathMode: px.enum([PxAlongPathMode.sampled, PxAlongPathMode.offsetPath]).optional()
+    alongPathMode: px.enum([PxAlongPathMode.sampled, PxAlongPathMode.offsetPath], PxAlongPathMode.sampled).optional()
   }));
   var PxTransformPartsSchema = implementsInterface()(px.object({
     translate: px.tuple([px.number(), px.number()]).optional(),
@@ -938,9 +969,9 @@ var PixodeskAnimator = (() => {
     // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
     // `fill`) or `'reset'` (snap back to the start state). One of four occasion keys
     // (`start`, `offScreen`, `mouseOut`, `finish`), all named the same way.
-    finish: px.enum([PxFinishAction.hold, PxFinishAction.reset]).optional(),
-    visibilityThreshold: px.number().optional(),
-    visibilityDebounce: px.number().optional()
+    finish: px.enum([PxFinishAction.hold, PxFinishAction.reset], PX_TRIGGER_DEFAULTS.finish).optional(),
+    visibilityThreshold: px.number(PX_TRIGGER_DEFAULTS.visibilityThreshold).optional(),
+    visibilityDebounce: px.number(PX_TRIGGER_DEFAULTS.visibilityDebounce).optional()
   }));
   var PxGlyphSchema = implementsInterface()(px.object({
     width: px.number(),
@@ -966,7 +997,7 @@ var PixodeskAnimator = (() => {
       PxScrollPhase.exit,
       PxScrollPhase.entryCrossing,
       PxScrollPhase.exitCrossing
-    ]).optional(),
+    ], PxScrollPhase.cover).optional(),
     fraction: px.number().optional()
   }));
   var PxScrollRangeSchema = px.object({
@@ -974,37 +1005,37 @@ var PixodeskAnimator = (() => {
     end: PxScrollRangePointSchema.optional()
   });
   var PxScrollSchema = implementsInterface()(px.object({
-    kind: px.enum([PxScrollKind.view, PxScrollKind.scroll]).optional(),
-    axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
-    source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
+    kind: px.enum([PxScrollKind.view, PxScrollKind.scroll], PxScrollKind.view).optional(),
+    axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y], PxScrollAxis.block).optional(),
+    source: px.enum([PxScrollSource.nearest, PxScrollSource.root], PxScrollSource.nearest).optional(),
     // Free-form: the two keywords `parent`/`scroller` plus any CSS selector.
     subject: px.string().optional(),
     smoothing: px.number().optional(),
-    pin: px.boolean().optional(),
-    pinAlign: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+    pin: px.boolean(false).optional(),
+    pinAlign: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom], PxPinAlign.top).optional(),
     pinOffset: px.number().optional(),
     pinDistance: px.number().optional(),
     range: PxScrollRangeSchema.optional()
   }));
   var PxTimelinePinSchema = implementsInterface()(px.object({
-    align: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+    align: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom], PxPinAlign.top).optional(),
     offset: px.number().optional(),
     distance: px.number().optional()
   }));
-  var PxTimelineEngineSchema = px.enum([PxTimelineEngineSetting.auto, PxTimelineEngineSetting.native, PxTimelineEngineSetting.js]).optional();
+  var PxTimelineEngineSchema = px.enum([PxTimelineEngineSetting.auto, PxTimelineEngineSetting.native, PxTimelineEngineSetting.js], PxTimelineEngineSetting.auto).optional();
   var PxTimeTimelineSchema = implementsInterface()(px.object({
     type: px.literal("time").optional(),
     engine: PxTimelineEngineSchema,
     frameRate: px.number().optional(),
     // §2.8: duration is a property of the TIMELINE — how long one pass takes.
-    duration: px.number().optional(),
+    duration: px.number(PX_DEFAULT_DURATION_MS).optional(),
     trigger: PxTriggerSchema.optional(),
-    delay: px.number().optional(),
-    iterations: px.union([px.number(), px.literal("infinite")]).optional(),
+    delay: px.number(0).optional(),
+    iterations: px.union([px.number(PX_DEFAULT_ITERATIONS), px.literal("infinite")], PX_DEFAULT_ITERATIONS).optional(),
     // `fillMode` on the wire (CSS `animation-fill-mode`; the runtime view calls it `fill`)
     // — never `fill`, which is paint everywhere else in the format.
-    fillMode: px.enum([PxFillMode.forwards, PxFillMode.backwards, PxFillMode.both, PxFillMode.none]).optional(),
-    direction: px.enum([PxPlaybackDirection.normal, PxPlaybackDirection.reverse, PxPlaybackDirection.alternate, PxPlaybackDirection.alternateReverse]).optional()
+    fillMode: px.enum([PxFillMode.forwards, PxFillMode.backwards, PxFillMode.both, PxFillMode.none], PxFillMode.forwards).optional(),
+    direction: px.enum([PxPlaybackDirection.normal, PxPlaybackDirection.reverse, PxPlaybackDirection.alternate, PxPlaybackDirection.alternateReverse], PxPlaybackDirection.normal).optional()
   }));
   var scrollishTimelineShape = {
     // §2.8: duration is a property of the TIMELINE — under scrubbing it is the keyframe
@@ -1015,8 +1046,8 @@ var PixodeskAnimator = (() => {
     iterations: px.number().optional(),
     engine: PxTimelineEngineSchema,
     frameRate: px.number().optional(),
-    axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
-    source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
+    axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y], PxScrollAxis.block).optional(),
+    source: px.enum([PxScrollSource.nearest, PxScrollSource.root], PxScrollSource.nearest).optional(),
     subject: px.string().optional(),
     // 'parent' | 'scroller' | any CSS selector
     smoothing: px.number().optional(),
@@ -1096,9 +1127,10 @@ var PixodeskAnimator = (() => {
   }));
   var PxMaskedByEffectSchema = implementsInterface()(px.object({
     source: px.string().optional(),
-    maskType: px.enum([PxMaskType.luminance, PxMaskType.alpha]).optional(),
-    maskUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
-    maskContentUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
+    // SVG's own initial values — what a <mask> does when the attribute is not there.
+    maskType: px.enum([PxMaskType.luminance, PxMaskType.alpha], PxMaskType.luminance).optional(),
+    maskUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.objectBoundingBox).optional(),
+    maskContentUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.userSpaceOnUse).optional(),
     x: px.number().optional(),
     y: px.number().optional(),
     width: px.number().optional(),
@@ -1110,7 +1142,7 @@ var PixodeskAnimator = (() => {
   var PxStrokeTrimEffectSchema = implementsInterface()(px.object({
     offset: PxAnimatableNumberSchema.optional(),
     range: PxAnimatableVec2Schema.optional(),
-    subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined]).optional()
+    subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined], PxStrokeTrimSubPaths.separate).optional()
   }));
   var PxRetimeEffectSchema = implementsInterface()(px.object({
     start: px.number().optional(),
@@ -1142,17 +1174,20 @@ var PixodeskAnimator = (() => {
     radius: PxAnimatableNumberSchema.optional(),
     focal: PxAnimatableVec2Schema.optional(),
     stops: PxAnimatableGradientStopsSchema.optional(),
-    gradientUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
-    spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat]).optional(),
+    // SVG's own initial values — what a gradient does when the attribute is not there.
+    gradientUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.objectBoundingBox).optional(),
+    spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat], PxGradientSpreadMethod.pad).optional(),
     gradientTransform: px.string().optional()
   }));
   var PxStrokeGradientEffectSchema = PxFillGradientEffectSchema;
   var PxTextPathEffectSchema = implementsInterface()(px.object({
     pathData: px.string(),
-    pathOverflow: px.enum([PxPathOverflow.clip, PxPathOverflow.extend]).optional(),
-    lengthAdjust: px.enum([PxLengthAdjust.spacing, PxLengthAdjust.spacingAndGlyphs]).optional(),
-    method: px.enum([PxTextPathMethod.align, PxTextPathMethod.stretch]).optional(),
-    spacing: px.enum([PxTextPathSpacing.auto, PxTextPathSpacing.exact]).optional(),
+    // `extend` is what an omitted pathOverflow means (glyphs continue along the tangent); the
+    // other three are SVG's own initial values for the native <textPath> attributes.
+    pathOverflow: px.enum([PxPathOverflow.clip, PxPathOverflow.extend], PxPathOverflow.extend).optional(),
+    lengthAdjust: px.enum([PxLengthAdjust.spacing, PxLengthAdjust.spacingAndGlyphs], PxLengthAdjust.spacing).optional(),
+    method: px.enum([PxTextPathMethod.align, PxTextPathMethod.stretch], PxTextPathMethod.align).optional(),
+    spacing: px.enum([PxTextPathSpacing.auto, PxTextPathSpacing.exact], PxTextPathSpacing.exact).optional(),
     startOffset: PxAnimatableNumberSchema.optional(),
     textLength: PxAnimatableNumberSchema.optional()
   }));
@@ -1716,7 +1751,6 @@ var PixodeskAnimator = (() => {
     return Object.keys(out).length ? out : void 0;
   }
   var PX_STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
-  var PX_DEFAULT_DURATION_MS = 1e3;
   function kebabToCamelCaseWord(kebab) {
     return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
   }
@@ -1969,6 +2003,38 @@ var PixodeskAnimator = (() => {
     return propsCopy;
   }
 
+  // ../svg-animator-core/src/animation/PxStaticTransformMerge.ts
+  function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
+    if (!animDef) return animDef;
+    const staticParts = staticTransform && typeof staticTransform === "object" && !Array.isArray(staticTransform) ? staticTransform : parseTransformParts(staticTransform);
+    if (!staticParts || !Object.keys(staticParts).length) return animDef;
+    const mergeKfValue = (v) => v && typeof v === "object" && !Array.isArray(v) ? __spreadValues(__spreadValues({}, staticParts), v) : v;
+    const transformAnim = animDef[TRANSFORM_ATTR];
+    if (transformAnim && typeof transformAnim === "object") {
+      const anim = transformAnim;
+      if (Array.isArray(anim.keyframes)) {
+        const out = __spreadProps(__spreadValues({}, anim), {
+          keyframes: anim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: mergeKfValue(kf.value) }))
+        });
+        if (out.value !== void 0) out.value = mergeKfValue(out.value);
+        return __spreadProps(__spreadValues({}, animDef), { transform: out });
+      }
+      return animDef;
+    }
+    const channels = Object.keys(animDef).filter((k) => PX_TRANSFORM_FN_NAMES.has(k));
+    if (channels.length !== 1) return animDef;
+    const ch = channels[0];
+    const chAnim = animDef[ch];
+    if (!chAnim || typeof chAnim !== "object" || !Array.isArray(chAnim.keyframes)) return animDef;
+    const lifted = __spreadProps(__spreadValues({}, chAnim), {
+      keyframes: chAnim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: __spreadProps(__spreadValues({}, staticParts), { [ch]: kf.value }) }))
+    });
+    if (lifted.value !== void 0) lifted.value = __spreadProps(__spreadValues({}, staticParts), { [ch]: lifted.value });
+    const rest = __spreadValues({}, animDef);
+    delete rest[ch];
+    return __spreadProps(__spreadValues({}, rest), { transform: lifted });
+  }
+
   // ../svg-animator-core/src/materialize/PxMotionPath.ts
   function getKfTranslate(kf) {
     const v = keyframeValue(kf);
@@ -2338,7 +2404,7 @@ var PixodeskAnimator = (() => {
     let newAnimate;
     const animBucket = node.animate;
     if (animBucket && typeof animBucket === "object" && !Array.isArray(animBucket)) {
-      const animDef = animBucket;
+      const animDef = mergeStaticTransformIntoAnimDef(animBucket, node.transform);
       const transformAnim = animDef.transform;
       if (transformAnim && typeof transformAnim === "object" && propAnimIsMotionPath(transformAnim)) {
         const materialized = materializeMotionPathInPropAnim(transformAnim, opts);
@@ -2852,36 +2918,6 @@ var PixodeskAnimator = (() => {
   function generateElementId() {
     return "_px_el_" + ++_elementIdCounter;
   }
-  function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
-    if (!animDef) return animDef;
-    const staticParts = staticTransform && typeof staticTransform === "object" && !Array.isArray(staticTransform) ? staticTransform : parseTransformParts(staticTransform);
-    if (!staticParts || !Object.keys(staticParts).length) return animDef;
-    const mergeKfValue = (v) => v && typeof v === "object" && !Array.isArray(v) ? __spreadValues(__spreadValues({}, staticParts), v) : v;
-    const transformAnim = animDef[TRANSFORM_ATTR];
-    if (transformAnim && typeof transformAnim === "object") {
-      const anim = transformAnim;
-      if (Array.isArray(anim.keyframes)) {
-        const out = __spreadProps(__spreadValues({}, anim), {
-          keyframes: anim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: mergeKfValue(kf.value) }))
-        });
-        if (out.value !== void 0) out.value = mergeKfValue(out.value);
-        return __spreadProps(__spreadValues({}, animDef), { transform: out });
-      }
-      return animDef;
-    }
-    const channels = Object.keys(animDef).filter((k) => PX_TRANSFORM_FN_NAMES.has(k));
-    if (channels.length !== 1) return animDef;
-    const ch = channels[0];
-    const chAnim = animDef[ch];
-    if (!chAnim || typeof chAnim !== "object" || !Array.isArray(chAnim.keyframes)) return animDef;
-    const lifted = __spreadProps(__spreadValues({}, chAnim), {
-      keyframes: chAnim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: __spreadProps(__spreadValues({}, staticParts), { [ch]: kf.value }) }))
-    });
-    if (lifted.value !== void 0) lifted.value = __spreadProps(__spreadValues({}, staticParts), { [ch]: lifted.value });
-    const rest = __spreadValues({}, animDef);
-    delete rest[ch];
-    return __spreadProps(__spreadValues({}, rest), { transform: lifted });
-  }
   function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimelineEngine.native) {
     const normalized = {};
     for (const [propName, propAnim] of Object.entries(animDef)) {
@@ -2964,7 +3000,7 @@ var PixodeskAnimator = (() => {
     return { prevKf, nextKf };
   }
   function calcPropertyValue(propName, propAnim, progress) {
-    var _a2, _b, _c, _d;
+    var _a2, _b, _c, _d, _e;
     const keyframes = propAnim.keyframes || [];
     if (keyframes.length === 0) return null;
     const { prevKf, nextKf } = getKeyframesPair(keyframes, progress);
@@ -3033,7 +3069,7 @@ var PixodeskAnimator = (() => {
             !!propAnim.autoOrient
           );
           partsResult.translate = [sample.translate[0], sample.translate[1]];
-          if (sample.rotateDeg !== void 0) partsResult.rotate = sample.rotateDeg;
+          if (sample.rotateDeg !== void 0) partsResult.rotate = sample.rotateDeg + ((_e = partsResult.rotate) != null ? _e : 0);
         }
       }
       cssValue = composeTransformParts(partsResult, { withUnits: false });
@@ -5516,12 +5552,17 @@ var PixodeskAnimator = (() => {
     const first = keyframeValue(kfs[0]);
     const anchor = (first == null ? void 0 : first.origin) && first.origin.length >= 2 ? [first.origin[0], first.origin[1]] : [0, 0];
     const points = [];
+    let keyframesCarryRotate = false;
     for (const kf of kfs) {
       const v = keyframeValue(kf);
       const tr = v == null ? void 0 : v.translate;
       if (!tr || tr.length < 2) return void 0;
       const parts = Object.keys(v);
-      if (parts.some((p) => p !== "translate" && p !== "origin")) return void 0;
+      if (parts.some((p) => p !== TRANSFORM_PART.translate && p !== TRANSFORM_PART.origin && p !== TRANSFORM_PART.rotate)) return void 0;
+      if ((v == null ? void 0 : v.rotate) !== void 0) {
+        if (v.rotate !== 0) return void 0;
+        keyframesCarryRotate = true;
+      }
       const o = (_a2 = v == null ? void 0 : v.origin) != null ? _a2 : [0, 0];
       if (o[0] !== anchor[0] || o[1] !== anchor[1]) return void 0;
       points.push([tr[0] + anchor[0], tr[1] + anchor[1]]);
@@ -5549,7 +5590,7 @@ var PixodeskAnimator = (() => {
       if (e !== void 0) out.e = e;
       distanceKfs.push(out);
     }
-    return { pathStr: d, distanceKfs, autoOrient: !!propAnim.autoOrient, anchor };
+    return { pathStr: d, distanceKfs, autoOrient: !!propAnim.autoOrient, anchor, keyframesCarryRotate };
   }
   function materializeOffsetPathsInTree(root) {
     const walk = (node) => {
@@ -5571,6 +5612,7 @@ var PixodeskAnimator = (() => {
             const t = __spreadValues({}, staticTr);
             delete t[TRANSFORM_PART.translate];
             delete t[TRANSFORM_PART.origin];
+            if (built.keyframesCarryRotate) delete t[TRANSFORM_PART.rotate];
             newTransform = Object.keys(t).length ? t : void 0;
           }
           out = __spreadProps(__spreadValues({}, node), {
@@ -5743,6 +5785,103 @@ var PixodeskAnimator = (() => {
     return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
   }
 
+  // ../svg-animator-core/src/materialize/PxRestPose.ts
+  var TRANSFORM_CHANNEL = "transform";
+  var REVERSED_DIRECTIONS = /* @__PURE__ */ new Set(["reverse", "alternate-reverse"]);
+  var VERIFY_SAMPLE_FRACTIONS = [0, 0.25, 0.5, 0.75, 1];
+  var SCRATCH_ID_PREFIX = "__px_rest_";
+  function materializeRestPosesInTree(root, engine) {
+    var _a2, _b;
+    const out = deepClone(root);
+    const config = getAnimatorConfig(out) || {};
+    const duration = +(config.duration || PX_DEFAULT_DURATION_MS);
+    const firstFrameTime = REVERSED_DIRECTIONS.has(String(config.direction)) ? duration : 0;
+    const nodes = animatedNodes(out);
+    if (!nodes.size) return out;
+    const before = bindingsOf(out, engine);
+    const added = /* @__PURE__ */ new Map();
+    for (const [key, animate] of before) {
+      const node = nodes.get(key);
+      if (!node) continue;
+      const channels = Object.keys(animate);
+      for (const channel of channels) {
+        if (PX_TRANSFORM_FN_NAMES.has(channel)) continue;
+        if (!mayCarryRestPose(node, channel)) continue;
+        const value = firstFrameValue(animate, channel, firstFrameTime);
+        if (value === void 0) continue;
+        node[channel] = value;
+        added.set(key, [...(_a2 = added.get(key)) != null ? _a2 : [], channel]);
+      }
+      if (channels.some((channel) => PX_TRANSFORM_FN_NAMES.has(channel)) && mayCarryTransformRestPose(node)) {
+        const parts = firstFrameTransformParts(animate, firstFrameTime);
+        if (parts) {
+          node[TRANSFORM_CHANNEL] = parts;
+          added.set(key, [...(_b = added.get(key)) != null ? _b : [], TRANSFORM_CHANNEL]);
+        }
+      }
+    }
+    if (added.size) {
+      const after = bindingsOf(out, engine);
+      for (const [key, channels] of added) {
+        if (writesTheSameFrames(before.get(key), after.get(key), duration)) continue;
+        const node = nodes.get(key);
+        if (node) for (const channel of channels) delete node[channel];
+      }
+    }
+    return out;
+  }
+  function mayCarryRestPose(node, channel) {
+    if (node[channel] !== void 0) return false;
+    if (channel === TRANSFORM_CHANNEL) return mayCarryTransformRestPose(node);
+    return true;
+  }
+  function mayCarryTransformRestPose(node) {
+    if (node[TRANSFORM_CHANNEL] !== void 0) return false;
+    for (const part of PX_TRANSFORM_FN_NAMES) if (node[part] !== void 0) return false;
+    return true;
+  }
+  function firstFrameValue(animate, channel, timeMs) {
+    const values = Object.values(calcAnimationValues({ [channel]: animate[channel] }, timeMs));
+    return values.length === 1 && values[0] !== "" ? values[0] : void 0;
+  }
+  function firstFrameTransformParts(animate, timeMs) {
+    const family = {};
+    for (const channel of Object.keys(animate)) if (PX_TRANSFORM_FN_NAMES.has(channel)) family[channel] = animate[channel];
+    const written = calcAnimationValues(family, timeMs)[TRANSFORM_CHANNEL];
+    if (!written) return void 0;
+    const parts = parseTransformParts(written.replace(/(px|deg)\b/g, ""));
+    return parts && Object.keys(parts).length ? parts : void 0;
+  }
+  function writesTheSameFrames(a, b, durationMs) {
+    if (!a || !b) return a === b;
+    const frame = (animate, t) => JSON.stringify(calcAnimationValues(animate, t)).replace(/\s+/g, "");
+    return VERIFY_SAMPLE_FRACTIONS.every((fraction) => frame(a, fraction * durationMs) === frame(b, fraction * durationMs));
+  }
+  function bindingsOf(tree, engine) {
+    const scratch = deepClone(tree);
+    const keyById = /* @__PURE__ */ new Map();
+    for (const [key, node] of animatedNodes(scratch)) {
+      if (node.id === void 0) node.id = SCRATCH_ID_PREFIX + key;
+      keyById.set(String(node.id), key);
+    }
+    const out = /* @__PURE__ */ new Map();
+    for (const binding of normalizeBindings(scratch, engine)) {
+      const key = keyById.get(binding.id);
+      if (key !== void 0) out.set(key, binding.animate);
+    }
+    return out;
+  }
+  function animatedNodes(tree) {
+    const out = /* @__PURE__ */ new Map();
+    let counter = 0;
+    const visit = (node) => {
+      if (node.animate) out.set(String(counter++), node);
+      if (node.children) for (const child of node.children) visit(child);
+    };
+    if (tree.children) for (const child of tree.children) visit(child);
+    return out;
+  }
+
   // ../svg-animator-core/src/materialize/PxAnimatorMaterializeAll.ts
   function materializeAllInTree(doc, engine, options) {
     var _a2, _b;
@@ -5755,6 +5894,7 @@ var PixodeskAnimator = (() => {
       root = materializeAnimatedUseInstances(root);
       root = pruneUnreferencedDefs(root);
     }
+    root = materializeRestPosesInTree(root, engine);
     return root;
   }
   function pruneUnreferencedDefs(root) {
@@ -5841,13 +5981,13 @@ var PixodeskAnimator = (() => {
     const bindings = normalizeBindings(doc, PxTimelineEngine.js);
     const _iterations = config.iterations;
     let iterations = 1;
-    if (typeof _iterations === "number") iterations = _iterations || 1;
+    if (typeof _iterations === "number") iterations = _iterations || PX_DEFAULT_ITERATIONS;
     if (_iterations === "infinite") iterations = Infinity;
     if (iterations < 1) iterations = 1;
     const duration = +(config.duration || PX_DEFAULT_DURATION_MS);
-    const totalDuration = duration && iterations ? duration * (iterations === Infinity ? Infinity : iterations) : duration ? (iterations != null ? iterations : 1) * duration : 0;
-    const direction = config.direction || "normal";
-    const fill = (_a2 = config.fill) != null ? _a2 : "forwards";
+    const totalDuration = duration && iterations ? duration * (iterations === Infinity ? Infinity : iterations) : duration ? (iterations != null ? iterations : PX_DEFAULT_ITERATIONS) * duration : 0;
+    const direction = config.direction || PxTimeTimelineSchema.defaults.direction;
+    const fill = (_a2 = config.fill) != null ? _a2 : PxTimeTimelineSchema.defaults.fillMode;
     const fillsForwards = fill === "forwards" || fill === "both";
     const fillsBackwards = fill === "backwards" || fill === "both";
     let timerId = null;
@@ -6318,6 +6458,52 @@ var PixodeskAnimator = (() => {
     );
   }
 
+  // ../svg-animator-core/src/render/PxRenderTree.ts
+  var CLASS_NAME_KEY = "className";
+  var CLASS_ATTR2 = "class";
+  var DOM_TYPE_KEY = "domType";
+  var TYPE_ATTR = "type";
+  var DEFAULT_TAG = "g";
+  function renderPxTree(node, factory, diag) {
+    return node ? renderOne(node, factory, diag, true, 0) : null;
+  }
+  function renderOne(node, factory, diag, isRoot, index) {
+    const _a2 = node, { type, children, style } = _a2, props = __objRest(_a2, ["type", "children", "style"]);
+    const tag = type || DEFAULT_TAG;
+    if (PX_DISALLOWED_SVG_TAGS_LOWER.has(tag.toLowerCase())) {
+      (diag != null ? diag : createDiagnostics(void 0, "[PxAnimator]")).warn(PxDiagnosticKind.document, 1103 /* blockedTag */, tag);
+      return null;
+    }
+    const domType = props[DOM_TYPE_KEY];
+    if (domType !== void 0) delete props[DOM_TYPE_KEY];
+    const attrs = {};
+    let inlineStyle;
+    const domProps = toDomProps(props);
+    for (const propName of Object.keys(domProps)) {
+      const sanitized = sanitizeAttributeValue(propName, domProps[propName]);
+      if (sanitized === void 0) continue;
+      if (PX_CSS_ONLY_STYLE_PROPS.has(propName)) {
+        (inlineStyle != null ? inlineStyle : inlineStyle = {})[propName] = String(sanitized);
+        continue;
+      }
+      attrs[propName === CLASS_NAME_KEY ? CLASS_ATTR2 : camelCaseToKebabWordIfNeeded(propName)] = sanitized;
+    }
+    if (domType !== void 0) attrs[TYPE_ATTR] = String(domType);
+    if (style) {
+      for (const styleProp of Object.keys(style)) (inlineStyle != null ? inlineStyle : inlineStyle = {})[styleProp] = String(style[styleProp]);
+    }
+    const rendered = [];
+    if (children) {
+      children.forEach((child, i) => {
+        const el = renderOne(child, factory, diag, false, i);
+        if (el !== null) rendered.push(el);
+      });
+    }
+    const ownText = props[PX_TEXT_CONTENT_ATTR];
+    const text = !rendered.length && typeof ownText === "string" && ownText ? ownText : void 0;
+    return factory({ tag, attrs, style: inlineStyle, children: rendered, text, node, isRoot, index });
+  }
+
   // ../svg-animator-core/src/playback/PxScrollMath.ts
   function isScrollTimeline(config) {
     return (config == null ? void 0 : config.timelineSource) === "scroll";
@@ -6890,7 +7076,7 @@ var PixodeskAnimator = (() => {
       let seekPosition;
       if (config.delay && config.delay < 0 && config.duration) {
         const rawSeek = -config.delay;
-        seekPosition = iterations === Infinity ? rawSeek % config.duration : Math.min(rawSeek, config.duration * (iterations != null ? iterations : 1));
+        seekPosition = iterations === Infinity ? rawSeek % config.duration : Math.min(rawSeek, config.duration * (iterations != null ? iterations : PX_DEFAULT_ITERATIONS));
       }
       const effectOptions = {
         duration: config.duration,
@@ -6997,7 +7183,7 @@ var PixodeskAnimator = (() => {
       },
       "setCurrentTime": (time) => {
         var _a3;
-        const ceiling = seekCeilingMs((_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : 1);
+        const ceiling = seekCeilingMs((_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : PX_DEFAULT_ITERATIONS);
         const seek = ceiling > 0 ? clampSeekMs(time, ceiling) : Math.max(0, time);
         finishNotified = false;
         animations.forEach((a) => {
@@ -7007,11 +7193,11 @@ var PixodeskAnimator = (() => {
       "getCurrentProgress": () => {
         var _a3;
         const t = api.getCurrentTime();
-        return t === null ? null : timeToProgress(t, (_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : 1);
+        return t === null ? null : timeToProgress(t, (_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : PX_DEFAULT_ITERATIONS);
       },
       "setCurrentProgress": (progress) => {
         var _a3;
-        api.setCurrentTime(progressToTimeMs(progress, (_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : 1));
+        api.setCurrentTime(progressToTimeMs(progress, (_a3 = config.duration) != null ? _a3 : 0, iterations != null ? iterations : PX_DEFAULT_ITERATIONS));
       },
       "destroy": () => {
         var _a3;
@@ -7384,62 +7570,19 @@ var PixodeskAnimator = (() => {
 
   // src/dom/PxAnimatorDOM.ts
   var SVG_NS = "http://www.w3.org/2000/svg";
-  function createElement(tagName, normalizedProps, style, children, textContent, diag) {
-    if (PX_DISALLOWED_SVG_TAGS_LOWER.has(tagName.toLowerCase())) {
-      (diag != null ? diag : createDiagnostics(void 0, "[PxAnimator]")).warn(PxDiagnosticKind.document, 1103 /* blockedTag */, tagName);
-      return null;
-    }
-    const element = document.createElementNS(SVG_NS, tagName);
-    for (const propName in normalizedProps) {
-      const sanitized = sanitizeAttributeValue(propName, normalizedProps[propName]);
-      if (sanitized === void 0) continue;
-      if (PX_CSS_ONLY_STYLE_PROPS.has(propName)) {
-        element.style[propName] = String(sanitized);
-        continue;
-      }
-      element.setAttribute(camelCaseToKebabWordIfNeeded(propName), sanitized);
-    }
+  var createDomElement = ({ tag, attrs, style, children, text }) => {
+    const element = document.createElementNS(SVG_NS, tag);
+    for (const name of Object.keys(attrs)) element.setAttribute(name, attrs[name]);
     if (style) {
-      for (const styleProp in style) {
-        element.style[styleProp] = String(style[styleProp]);
-      }
-    }
-    if (children == null ? void 0 : children.length) {
-      for (const child of children) {
-        element.appendChild(child);
-      }
-    } else if (textContent) {
-      element.textContent = textContent;
-    }
-    return element;
-  }
-  function renderNode(node, defs, diag) {
-    if (!node) return null;
-    const _a2 = node, { type, children, style } = _a2, props = __objRest(_a2, ["type", "children", "style"]);
-    const domType = props.domType;
-    if (domType !== void 0) delete props.domType;
-    const nodeDefs = getDefinitions(node) || defs;
-    const resolvedStyle = style;
-    let childElements;
-    if (children) {
-      for (const ch of children) {
-        const child = renderNode(ch, nodeDefs, diag);
-        if (child) {
-          if (!childElements) childElements = [];
-          childElements.push(child);
-        }
-      }
+      const target = element.style;
+      for (const prop of Object.keys(style)) target[prop] = style[prop];
     }
-    const element = createElement(
-      type || "g",
-      toDomProps(props),
-      resolvedStyle,
-      childElements,
-      props[PX_TEXT_CONTENT_ATTR],
-      diag
-    );
-    if (element && domType !== void 0) element.setAttribute("type", domType);
+    for (const child of children) element.appendChild(child);
+    if (text !== void 0) element.textContent = text;
     return element;
+  };
+  function renderNode(node, _defs, diag) {
+    return renderPxTree(node, createDomElement, diag);
   }
 
   // src/shared/PxAnimatorKeys.ts
@@ -7449,7 +7592,7 @@ var PixodeskAnimator = (() => {
   function createAnimatorFromConfig(doc, adapter, callbacks, rootElement) {
     return bindWithEngineChoice(doc, adapter, callbacks, rootElement);
   }
-  function createAnimatorImpl(doc, adapter, callbacks, containerElement, patch, resetTimeline) {
+  function createAnimatorImpl(doc, adapter, callbacks, containerElement, patch, resetTimeline, providedRoot) {
     const diag = createDiagnostics(callbacks, "[PxAnimator]");
     const effectsWarnings = validateNodeEffects(doc);
     for (const w of effectsWarnings) diag.warn(PxDiagnosticKind.document, 1101 /* effectsShape */, w);
@@ -7473,6 +7616,7 @@ var PixodeskAnimator = (() => {
         }
       }
     }
+    if (!rootElement && providedRoot) rootElement = providedRoot;
     const api = createAnimatorFromConfig(doc, adapter, callbacks, rootElement);
     if (containerElement && rootElement) {
       const rendered = rootElement;
@@ -7485,7 +7629,7 @@ var PixodeskAnimator = (() => {
     return api;
   }
   function isInternalOptions(options) {
-    return "adapter" in options;
+    return "adapter" in options || "rootElement" in options;
   }
   function resolveTimelineOption(options) {
     const { timeline, duration, delay, iterations, start } = options;
@@ -7494,6 +7638,7 @@ var PixodeskAnimator = (() => {
   function createAnimator(options) {
     const { src, doc, container, resetTimeline } = options;
     const adapter = isInternalOptions(options) ? options.adapter : void 0;
+    const providedRoot = isInternalOptions(options) ? options.rootElement : void 0;
     const patch = resolveTimelineOption(options);
     let proxy;
     const callbacks = withRegistryEvents(toEngineCallbacks(options), () => proxy);
@@ -7526,7 +7671,7 @@ var PixodeskAnimator = (() => {
     };
     const build = (document2) => {
       try {
-        ready(createAnimatorImpl(document2, adapter, callbacks, container, patch, resetTimeline));
+        ready(createAnimatorImpl(document2, adapter, callbacks, container, patch, resetTimeline, providedRoot));
       } catch (e) {
         const err = asThrownError(e);
         failed(PxDiagnosticKind.internal, 1001 /* buildFailed */, err);