@pixodesk/svg-animator-web 1.0.44 → 1.0.46

package/dist/index.cjs

@@ -20,18 +20,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -71,7 +59,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// ../svg-animator-core/dist/chunk-EFQLDGFY.js
+// ../svg-animator-core/dist/chunk-37OFJ3RX.js
 var __defProp2 = Object.defineProperty;
 var __defProps2 = Object.defineProperties;
 var __getOwnPropDescs2 = Object.getOwnPropertyDescriptors;
@@ -92,7 +80,7 @@ var __spreadValues2 = (a, b) => {
   return a;
 };
 var __spreadProps2 = (a, b) => __defProps2(a, __getOwnPropDescs2(b));
-var __objRest2 = (source, exclude) => {
+var __objRest = (source, exclude) => {
   var target = {};
   for (var prop in source)
     if (__hasOwnProp2.call(source, prop) && exclude.indexOf(prop) < 0)
@@ -115,19 +103,31 @@ function pathStr(path) {
   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;
@@ -141,8 +141,8 @@ var Optional = class extends Base {
   }
 };
 var Str = class extends Base {
-  constructor(_default = "") {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -155,8 +155,8 @@ var Str = class extends Base {
   }
 };
 var Num = class extends Base {
-  constructor(_default = 0) {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -169,8 +169,8 @@ var Num = class extends Base {
   }
 };
 var Bool = class extends Base {
-  constructor(_default = false) {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -183,8 +183,9 @@ var Bool = class extends Base {
   }
 };
 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;
   }
@@ -198,8 +199,8 @@ var Literal = class extends Base {
   }
 };
 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];
   }
@@ -214,8 +215,8 @@ var Enum = class extends Base {
 };
 var UNION_MEMBER_ERROR_LIMIT = 4;
 var Union = class extends Base {
-  constructor(schemas, defaultVal) {
-    super();
+  constructor(schemas, defaultVal, statesDefault) {
+    super(statesDefault);
     this.schemas = schemas;
     this._kind = "union";
     this._default = defaultVal != null ? defaultVal : schemas[0]._default;
@@ -268,7 +269,7 @@ var Union = class extends Base {
 var DiscriminatedUnion = class extends Base {
   constructor(_key, _schemas, defaultVal) {
     var _a2;
-    super();
+    super(false);
     this._key = _key;
     this._schemas = _schemas;
     this._kind = "discriminatedUnion";
@@ -307,13 +308,19 @@ var DiscriminatedUnion = class extends Base {
     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 : {};
@@ -355,12 +362,13 @@ var Obj = class extends Base {
 };
 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 : {};
@@ -405,7 +413,7 @@ var OpenObj = class extends Base {
 };
 var Arr = class extends Base {
   constructor(item) {
-    super();
+    super(false);
     this.item = item;
     this._default = [];
   }
@@ -437,7 +445,7 @@ var Arr = class extends Base {
 };
 var Rec = class extends Base {
   constructor(value) {
-    super();
+    super(false);
     this.value = value;
     this._kind = "record";
     this._default = {};
@@ -470,7 +478,7 @@ var Rec = class extends Base {
 };
 var Any = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -485,7 +493,7 @@ var Any = class extends Base {
 };
 var Defined = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -502,7 +510,7 @@ var Defined = class extends Base {
 };
 var Lazy = class extends Base {
   constructor(fn, _default) {
-    super();
+    super(false);
     this.fn = fn;
     this._default = _default;
     this.resolved = null;
@@ -523,7 +531,7 @@ var Lazy = class extends Base {
 };
 var Tuple = class extends Base {
   constructor(schemas) {
-    super();
+    super(false);
     this.schemas = schemas;
     this._kind = "tuple";
     this._default = schemas.map((s) => s._default);
@@ -554,22 +562,29 @@ var Tuple = class extends Base {
 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.
@@ -577,7 +592,8 @@ var px = {
    * 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,
@@ -712,8 +728,11 @@ var PX_TRIGGER_DEFAULTS = {
   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 {
@@ -831,7 +850,7 @@ function flattenAnimatorTimeline(cfg) {
   if (timeline === void 0 || timeline === null || typeof timeline !== "object") return cfg;
   const memoised = flattenMemo.get(cfg);
   if (memoised) return memoised;
-  const _a2 = cfg, { timeline: _dropped } = _a2, flat = __objRest2(_a2, ["timeline"]);
+  const _a2 = cfg, { timeline: _dropped } = _a2, flat = __objRest(_a2, ["timeline"]);
   if (timeline.engine !== void 0) flat.engine = timeline.engine;
   if (timeline.frameRate !== void 0) flat.frameRate = timeline.frameRate;
   if (timeline.type === "scroll" || timeline.type === "view") {
@@ -857,7 +876,7 @@ function flattenAnimatorTimeline(cfg) {
   } else {
     if (timeline.duration !== void 0) flat.duration = timeline.duration;
     if (timeline.trigger !== void 0) {
-      const _b = timeline.trigger, { finish } = _b, restTrigger = __objRest2(_b, ["finish"]);
+      const _b = timeline.trigger, { finish } = _b, restTrigger = __objRest(_b, ["finish"]);
       if (Object.keys(restTrigger).length) flat.trigger = restTrigger;
       if (finish !== void 0) flat.resetOnFinish = finish === "reset";
     }
@@ -926,15 +945,15 @@ var keyframeTangentIn = (kf) => anyKf(kf).tangentIn;
 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(),
@@ -964,9 +983,9 @@ var PxTriggerSchema = implementsInterface()(px.object({
   // 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(),
@@ -992,7 +1011,7 @@ var PxScrollRangePointSchema = implementsInterface()(px.object({
     PxScrollPhase.exit,
     PxScrollPhase.entryCrossing,
     PxScrollPhase.exitCrossing
-  ]).optional(),
+  ], PxScrollPhase.cover).optional(),
   fraction: px.number().optional()
 }));
 var PxScrollRangeSchema = px.object({
@@ -1000,37 +1019,37 @@ var PxScrollRangeSchema = px.object({
   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
@@ -1041,8 +1060,8 @@ var scrollishTimelineShape = {
   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(),
@@ -1122,9 +1141,10 @@ var PxRepeaterEffectSchema = implementsInterface()(px.object({
 }));
 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(),
@@ -1136,7 +1156,7 @@ var PxClipPathEffectSchema = implementsInterface()(px.object({
 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(),
@@ -1168,17 +1188,20 @@ var PxFillGradientEffectSchema = implementsInterface()(px.object({
   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()
 }));
@@ -1738,7 +1761,6 @@ function parseTransformParts(str2) {
   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;
 }
@@ -1988,6 +2010,36 @@ function toDomProps(props) {
   }
   return propsCopy;
 }
+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) ? __spreadValues2(__spreadValues2({}, staticParts), v) : v;
+  const transformAnim = animDef[TRANSFORM_ATTR];
+  if (transformAnim && typeof transformAnim === "object") {
+    const anim = transformAnim;
+    if (Array.isArray(anim.keyframes)) {
+      const out = __spreadProps2(__spreadValues2({}, anim), {
+        keyframes: anim.keyframes.map((kf) => __spreadProps2(__spreadValues2({}, kf), { value: mergeKfValue(kf.value) }))
+      });
+      if (out.value !== void 0) out.value = mergeKfValue(out.value);
+      return __spreadProps2(__spreadValues2({}, 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 = __spreadProps2(__spreadValues2({}, chAnim), {
+    keyframes: chAnim.keyframes.map((kf) => __spreadProps2(__spreadValues2({}, kf), { value: __spreadProps2(__spreadValues2({}, staticParts), { [ch]: kf.value }) }))
+  });
+  if (lifted.value !== void 0) lifted.value = __spreadProps2(__spreadValues2({}, staticParts), { [ch]: lifted.value });
+  const rest = __spreadValues2({}, animDef);
+  delete rest[ch];
+  return __spreadProps2(__spreadValues2({}, rest), { transform: lifted });
+}
 function getKfTranslate(kf) {
   const v = keyframeValue(kf);
   if (!v) return void 0;
@@ -2356,7 +2408,7 @@ function walkAndMaterialize(node, opts) {
   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);
@@ -2868,36 +2920,6 @@ var _elementIdCounter = 0;
 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) ? __spreadValues2(__spreadValues2({}, staticParts), v) : v;
-  const transformAnim = animDef[TRANSFORM_ATTR];
-  if (transformAnim && typeof transformAnim === "object") {
-    const anim = transformAnim;
-    if (Array.isArray(anim.keyframes)) {
-      const out = __spreadProps2(__spreadValues2({}, anim), {
-        keyframes: anim.keyframes.map((kf) => __spreadProps2(__spreadValues2({}, kf), { value: mergeKfValue(kf.value) }))
-      });
-      if (out.value !== void 0) out.value = mergeKfValue(out.value);
-      return __spreadProps2(__spreadValues2({}, 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 = __spreadProps2(__spreadValues2({}, chAnim), {
-    keyframes: chAnim.keyframes.map((kf) => __spreadProps2(__spreadValues2({}, kf), { value: __spreadProps2(__spreadValues2({}, staticParts), { [ch]: kf.value }) }))
-  });
-  if (lifted.value !== void 0) lifted.value = __spreadProps2(__spreadValues2({}, staticParts), { [ch]: lifted.value });
-  const rest = __spreadValues2({}, animDef);
-  delete rest[ch];
-  return __spreadProps2(__spreadValues2({}, rest), { transform: lifted });
-}
 function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimelineEngine.native) {
   const normalized = {};
   for (const [propName, propAnim] of Object.entries(animDef)) {
@@ -2980,7 +3002,7 @@ function getKeyframesPair(keyframes, progress) {
   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);
@@ -3049,7 +3071,7 @@ function calcPropertyValue(propName, propAnim, progress) {
           !!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 });
@@ -3332,12 +3354,12 @@ function deepClonePxNode(value) {
   for (const k of Object.keys(value)) out[k] = deepClonePxNode(value[k]);
   return out;
 }
-function regenerateIdsAndRewriteRefs(root, genId2) {
+function regenerateIdsAndRewriteRefs(root, genId3) {
   const oldToNew = /* @__PURE__ */ new Map();
   const walkAssign = (n) => {
     var _a2;
     if (typeof n.id === "string") {
-      const newId = genId2();
+      const newId = genId3();
       oldToNew.set(n.id, newId);
       n.id = newId;
     }
@@ -3986,68 +4008,6 @@ function applyTextGlyphsAlongPath(node, ctx, pathD, startOffset, textLength, pat
   }
   return materializeGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
 }
-var PxDiagnosticKind = {
-  /** The document is wrong — regenerate or repair the file. */
-  document: "document",
-  /** The page or app cannot provide what the document asks for — fix the mount. */
-  host: "host",
-  /** The platform cannot do it and the player degraded — usually nothing to fix. */
-  platform: "platform",
-  /** The call is wrong or self-contradictory — fix the options or props you passed. */
-  usage: "usage",
-  /** The player failed where it did not expect to — report it to us. */
-  internal: "internal"
-};
-var DOCS_URL = "https://github.com/pixodesk/pixodesk-svg-animator/blob/main/docs/diagnostics.md";
-function codeLine(code) {
-  return "PX" + code + " " + DOCS_URL + "#px" + code;
-}
-function errorIn(data) {
-  return data.find((d) => d instanceof Error);
-}
-function createDiagnostics(config, prefix) {
-  const tag = prefix ? prefix + " " : "";
-  return {
-    warn: (kind, code, ...data) => {
-      const message = codeLine(code);
-      if (config == null ? void 0 : config.onWarn) {
-        config.onWarn({ code, kind, data, message });
-        return;
-      }
-      if (config == null ? void 0 : config.muteWarn) return;
-      console.warn(tag + kind + " " + message, ...data);
-    },
-    error: (kind, code, ...data) => {
-      const message = codeLine(code);
-      const error = errorIn(data);
-      if (config == null ? void 0 : config.onError) {
-        config.onError({ code, kind, data, message, error });
-        return;
-      }
-      if (config == null ? void 0 : config.muteError) return;
-      console.error(tag + kind + " " + message, ...data);
-    }
-  };
-}
-var MAX_REPORTED = 6;
-function diagnoseDocument(doc) {
-  try {
-    return { problems: validateDocument(doc) };
-  } catch (e) {
-    return { problems: [] };
-  }
-}
-function reportDocumentDiagnostics(doc, where) {
-  const { problems } = diagnoseDocument(doc);
-  if (!problems.length) return;
-  const shown = problems.slice(0, MAX_REPORTED);
-  const more = problems.length - shown.length;
-  console.warn(
-    where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
-  );
-}
-
-// ../svg-animator-core/dist/index.js
 function applyTransformByEffect(node, fx, ctx) {
   if (!fx) return node;
   delete node.transform;
@@ -5565,12 +5525,17 @@ function buildOffsetPath(propAnim) {
   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]]);
@@ -5598,7 +5563,7 @@ function buildOffsetPath(propAnim) {
     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) => {
@@ -5620,6 +5585,7 @@ function materializeOffsetPathsInTree(root) {
           const t = __spreadValues2({}, 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 = __spreadProps2(__spreadValues2({}, node), {
@@ -5789,6 +5755,101 @@ function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, ro
   });
   return changed ? __spreadProps2(__spreadValues2({}, node), { children: newChildren }) : node;
 }
+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;
+}
 function materializeAllInTree(doc, engine, options) {
   var _a2, _b;
   let root = materializeNodeEffects(doc).root;
@@ -5800,6 +5861,7 @@ function materializeAllInTree(doc, engine, options) {
     root = materializeAnimatedUseInstances(root);
     root = pruneUnreferencedDefs(root);
   }
+  root = materializeRestPosesInTree(root, engine);
   return root;
 }
 function pruneUnreferencedDefs(root) {
@@ -5831,6 +5893,98 @@ function pruneUnreferencedDefs(root) {
   }
   return root;
 }
+var PxDiagnosticCode = /* @__PURE__ */ ((PxDiagnosticCode2) => {
+  PxDiagnosticCode2[PxDiagnosticCode2["buildFailed"] = 1001] = "buildFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["invalidDocumentAtSrc"] = 1002] = "invalidDocumentAtSrc";
+  PxDiagnosticCode2[PxDiagnosticCode2["loadFailed"] = 1003] = "loadFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["animationBuildFailed"] = 1004] = "animationBuildFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["effectsShape"] = 1101] = "effectsShape";
+  PxDiagnosticCode2[PxDiagnosticCode2["timelineOverrideIgnored"] = 1102] = "timelineOverrideIgnored";
+  PxDiagnosticCode2[PxDiagnosticCode2["blockedTag"] = 1103] = "blockedTag";
+  PxDiagnosticCode2[PxDiagnosticCode2["unsupportedAnimatedAttrs"] = 1104] = "unsupportedAnimatedAttrs";
+  PxDiagnosticCode2[PxDiagnosticCode2["noBindings"] = 1105] = "noBindings";
+  PxDiagnosticCode2[PxDiagnosticCode2["unresolvedBinding"] = 1106] = "unresolvedBinding";
+  PxDiagnosticCode2[PxDiagnosticCode2["triggersNoRoot"] = 1201] = "triggersNoRoot";
+  PxDiagnosticCode2[PxDiagnosticCode2["noRootForSelector"] = 1202] = "noRootForSelector";
+  PxDiagnosticCode2[PxDiagnosticCode2["noRootElement"] = 1203] = "noRootElement";
+  PxDiagnosticCode2[PxDiagnosticCode2["noElementsForSelector"] = 1206] = "noElementsForSelector";
+  PxDiagnosticCode2[PxDiagnosticCode2["setAttributeNoElement"] = 1207] = "setAttributeNoElement";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSmoothingNeedsOwnDriver"] = 1301] = "scrollSmoothingNeedsOwnDriver";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollNativeUnavailable"] = 1302] = "scrollNativeUnavailable";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectInvalid"] = 1303] = "scrollSubjectInvalid";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectNoMatch"] = 1304] = "scrollSubjectNoMatch";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollNoRootToObserve"] = 1305] = "scrollNoRootToObserve";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollTriggerIgnored"] = 1306] = "scrollTriggerIgnored";
+  PxDiagnosticCode2[PxDiagnosticCode2["rateRejected"] = 1401] = "rateRejected";
+  PxDiagnosticCode2[PxDiagnosticCode2["controlPropsConflict"] = 1501] = "controlPropsConflict";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnCompileFailed"] = 1601] = "rnCompileFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnRenderFailed"] = 1602] = "rnRenderFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnBoundaryCaught"] = 1603] = "rnBoundaryCaught";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnUnsupported"] = 1604] = "rnUnsupported";
+  return PxDiagnosticCode2;
+})(PxDiagnosticCode || {});
+var PxDiagnosticKind = {
+  /** The document is wrong — regenerate or repair the file. */
+  document: "document",
+  /** The page or app cannot provide what the document asks for — fix the mount. */
+  host: "host",
+  /** The platform cannot do it and the player degraded — usually nothing to fix. */
+  platform: "platform",
+  /** The call is wrong or self-contradictory — fix the options or props you passed. */
+  usage: "usage",
+  /** The player failed where it did not expect to — report it to us. */
+  internal: "internal"
+};
+var DOCS_URL = "https://github.com/pixodesk/pixodesk-svg-animator/blob/main/docs/diagnostics.md";
+function codeLine(code) {
+  return "PX" + code + " " + DOCS_URL + "#px" + code;
+}
+function errorIn(data) {
+  return data.find((d) => d instanceof Error);
+}
+function createDiagnostics(config, prefix) {
+  const tag = prefix ? prefix + " " : "";
+  return {
+    warn: (kind, code, ...data) => {
+      const message = codeLine(code);
+      if (config == null ? void 0 : config.onWarn) {
+        config.onWarn({ code, kind, data, message });
+        return;
+      }
+      if (config == null ? void 0 : config.muteWarn) return;
+      console.warn(tag + kind + " " + message, ...data);
+    },
+    error: (kind, code, ...data) => {
+      const message = codeLine(code);
+      const error = errorIn(data);
+      if (config == null ? void 0 : config.onError) {
+        config.onError({ code, kind, data, message, error });
+        return;
+      }
+      if (config == null ? void 0 : config.muteError) return;
+      console.error(tag + kind + " " + message, ...data);
+    }
+  };
+}
+var MAX_REPORTED = 6;
+function diagnoseDocument(doc) {
+  try {
+    return { problems: validateDocument(doc) };
+  } catch (e) {
+    return { problems: [] };
+  }
+}
+function reportDocumentDiagnostics(doc, where) {
+  const { problems } = diagnoseDocument(doc);
+  if (!problems.length) return;
+  const shown = problems.slice(0, MAX_REPORTED);
+  const more = problems.length - shown.length;
+  console.warn(
+    where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
+  );
+}
+
+// ../svg-animator-core/dist/index.js
 var PX_RATE_REJECTED = "setPlaybackRate: rate must be finite and non-zero";
 function isValidPlaybackRate(rate) {
   return Number.isFinite(rate) && rate !== 0;
@@ -5882,13 +6036,13 @@ function createAdapterAnimator(doc, adapter, callbacks) {
   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;
@@ -6142,36 +6296,6 @@ function createAdapterAnimator(doc, adapter, callbacks) {
   };
   return api;
 }
-var PxDiagnosticCode = /* @__PURE__ */ ((PxDiagnosticCode2) => {
-  PxDiagnosticCode2[PxDiagnosticCode2["buildFailed"] = 1001] = "buildFailed";
-  PxDiagnosticCode2[PxDiagnosticCode2["invalidDocumentAtSrc"] = 1002] = "invalidDocumentAtSrc";
-  PxDiagnosticCode2[PxDiagnosticCode2["loadFailed"] = 1003] = "loadFailed";
-  PxDiagnosticCode2[PxDiagnosticCode2["animationBuildFailed"] = 1004] = "animationBuildFailed";
-  PxDiagnosticCode2[PxDiagnosticCode2["effectsShape"] = 1101] = "effectsShape";
-  PxDiagnosticCode2[PxDiagnosticCode2["timelineOverrideIgnored"] = 1102] = "timelineOverrideIgnored";
-  PxDiagnosticCode2[PxDiagnosticCode2["blockedTag"] = 1103] = "blockedTag";
-  PxDiagnosticCode2[PxDiagnosticCode2["unsupportedAnimatedAttrs"] = 1104] = "unsupportedAnimatedAttrs";
-  PxDiagnosticCode2[PxDiagnosticCode2["noBindings"] = 1105] = "noBindings";
-  PxDiagnosticCode2[PxDiagnosticCode2["unresolvedBinding"] = 1106] = "unresolvedBinding";
-  PxDiagnosticCode2[PxDiagnosticCode2["triggersNoRoot"] = 1201] = "triggersNoRoot";
-  PxDiagnosticCode2[PxDiagnosticCode2["noRootForSelector"] = 1202] = "noRootForSelector";
-  PxDiagnosticCode2[PxDiagnosticCode2["noRootElement"] = 1203] = "noRootElement";
-  PxDiagnosticCode2[PxDiagnosticCode2["noElementsForSelector"] = 1206] = "noElementsForSelector";
-  PxDiagnosticCode2[PxDiagnosticCode2["setAttributeNoElement"] = 1207] = "setAttributeNoElement";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollSmoothingNeedsOwnDriver"] = 1301] = "scrollSmoothingNeedsOwnDriver";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollNativeUnavailable"] = 1302] = "scrollNativeUnavailable";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectInvalid"] = 1303] = "scrollSubjectInvalid";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectNoMatch"] = 1304] = "scrollSubjectNoMatch";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollNoRootToObserve"] = 1305] = "scrollNoRootToObserve";
-  PxDiagnosticCode2[PxDiagnosticCode2["scrollTriggerIgnored"] = 1306] = "scrollTriggerIgnored";
-  PxDiagnosticCode2[PxDiagnosticCode2["rateRejected"] = 1401] = "rateRejected";
-  PxDiagnosticCode2[PxDiagnosticCode2["controlPropsConflict"] = 1501] = "controlPropsConflict";
-  PxDiagnosticCode2[PxDiagnosticCode2["rnCompileFailed"] = 1601] = "rnCompileFailed";
-  PxDiagnosticCode2[PxDiagnosticCode2["rnRenderFailed"] = 1602] = "rnRenderFailed";
-  PxDiagnosticCode2[PxDiagnosticCode2["rnBoundaryCaught"] = 1603] = "rnBoundaryCaught";
-  PxDiagnosticCode2[PxDiagnosticCode2["rnUnsupported"] = 1604] = "rnUnsupported";
-  return PxDiagnosticCode2;
-})(PxDiagnosticCode || {});
 var FLAT_ONLY_KEYS = [
   "timelineSource",
   "scroll",
@@ -6324,6 +6448,50 @@ function applyAnimatorConfig(doc, patch, options) {
 }
 
 // ../svg-animator-core/dist/internal.js
+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, 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 });
+}
 function isScrollTimeline(config) {
   return (config == null ? void 0 : config.timelineSource) === "scroll";
 }
@@ -6895,7 +7063,7 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     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,
@@ -7002,7 +7170,7 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     },
     "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) => {
@@ -7012,11 +7180,11 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     "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;
@@ -7389,69 +7557,26 @@ function bindWithEngineChoice(doc, adapter, callbacks, rootElement) {
 
 // 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, PxDiagnosticCode.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/animator/PxAnimator.ts
 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, PxDiagnosticCode.effectsShape, w);
@@ -7475,6 +7600,7 @@ function createAnimatorImpl(doc, adapter, callbacks, containerElement, patch, re
       }
     }
   }
+  if (!rootElement && providedRoot) rootElement = providedRoot;
   const api = createAnimatorFromConfig(doc, adapter, callbacks, rootElement);
   if (containerElement && rootElement) {
     const rendered = rootElement;
@@ -7487,7 +7613,7 @@ function createAnimatorImpl(doc, adapter, callbacks, containerElement, patch, re
   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;
@@ -7496,6 +7622,7 @@ function resolveTimelineOption(options) {
 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);
@@ -7528,7 +7655,7 @@ function createAnimator(options) {
   };
   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, PxDiagnosticCode.buildFailed, err);