@pixodesk/svg-animator-core 1.0.44 → 1.0.46

package/dist/index.cjs

@@ -110,6 +110,7 @@ __export(index_exports, {
   PxTextPathEffectSchema: () => PxTextPathEffectSchema,
   PxTextPathMethod: () => PxTextPathMethod,
   PxTextPathSpacing: () => PxTextPathSpacing,
+  PxTimeTimelineSchema: () => PxTimeTimelineSchema,
   PxTimelineEngine: () => PxTimelineEngine,
   PxTimelineEngineSetting: () => PxTimelineEngineSetting,
   PxTimelineSchema: () => PxTimelineSchema,
@@ -181,19 +182,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;
@@ -207,8 +220,8 @@ var Optional = class extends Base {
   }
 };
 var Str = class extends Base {
-  constructor(_default = "") {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -221,8 +234,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) {
@@ -235,8 +248,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) {
@@ -249,8 +262,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;
   }
@@ -264,8 +278,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];
   }
@@ -280,8 +294,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;
     /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Union from Tuple. */
     this._kind = "union";
@@ -335,7 +349,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;
     /** Structural tag read by {@link describeSchema}. */
@@ -375,13 +389,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 : {};
@@ -423,12 +443,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 : {};
@@ -473,7 +494,7 @@ var OpenObj = class extends Base {
 };
 var Arr = class extends Base {
   constructor(item) {
-    super();
+    super(false);
     this.item = item;
     this._default = [];
   }
@@ -505,7 +526,7 @@ var Arr = class extends Base {
 };
 var Rec = class extends Base {
   constructor(value) {
-    super();
+    super(false);
     this.value = value;
     /** Structural tag read by {@link describeSchema}. */
     this._kind = "record";
@@ -539,7 +560,7 @@ var Rec = class extends Base {
 };
 var Any = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -554,7 +575,7 @@ var Any = class extends Base {
 };
 var Defined = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -571,7 +592,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;
@@ -592,7 +613,7 @@ var Lazy = class extends Base {
 };
 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";
@@ -648,22 +669,29 @@ function describeSchema(schema) {
   if ("fn" in s) return { kind: "lazy", resolved: (_a2 = s.resolved) != null ? _a2 : s.resolved = s.fn() };
   return { kind: "leaf" };
 }
+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.
@@ -671,7 +699,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,
@@ -1015,8 +1044,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;
 var PxControlMode = {
   /** No control props — the document's trigger decides, and nothing is taken over. */
   static: "static",
@@ -1331,15 +1363,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(),
@@ -1369,9 +1401,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(),
@@ -1397,7 +1429,7 @@ var PxScrollRangePointSchema = implementsInterface()(px.object({
     PxScrollPhase.exit,
     PxScrollPhase.entryCrossing,
     PxScrollPhase.exitCrossing
-  ]).optional(),
+  ], PxScrollPhase.cover).optional(),
   fraction: px.number().optional()
 }));
 var PxScrollRangeSchema = px.object({
@@ -1405,37 +1437,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
@@ -1446,8 +1478,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(),
@@ -1527,9 +1559,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(),
@@ -1541,7 +1574,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(),
@@ -1573,17 +1606,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()
 }));
@@ -2150,7 +2186,6 @@ function parseTransformParts(str2) {
   if (str2.replace(/([a-zA-Z]+)\s*\(([^)]*)\)/g, "").replace(/[\s,]/g, "").length) return void 0;
   return Object.keys(out).length ? out : void 0;
 }
-var PX_DEFAULT_DURATION_MS = 1e3;
 function kebabToCamelCaseWord(kebab) {
   return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
 }
@@ -2341,6 +2376,38 @@ function toDomProps(props) {
   return propsCopy;
 }
 
+// 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 });
+}
+
 // src/materialize/PxMotionPath.ts
 function getKfTranslate(kf) {
   const v = keyframeValue(kf);
@@ -2710,7 +2777,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);
@@ -3224,36 +3291,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) ? __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)) {
@@ -3336,7 +3373,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);
@@ -3405,7 +3442,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 });
@@ -5888,12 +5925,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]]);
@@ -5921,7 +5963,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) => {
@@ -5943,6 +5985,7 @@ function materializeOffsetPathsInTree(root) {
           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), {
@@ -6115,6 +6158,103 @@ function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, ro
   return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
 }
 
+// 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;
+}
+
 // src/materialize/PxAnimatorMaterializeAll.ts
 function materializeAllInTree(doc, engine, options) {
   var _a2, _b;
@@ -6127,6 +6267,7 @@ function materializeAllInTree(doc, engine, options) {
     root = materializeAnimatedUseInstances(root);
     root = pruneUnreferencedDefs(root);
   }
+  root = materializeRestPosesInTree(root, engine);
   return root;
 }
 function pruneUnreferencedDefs(root) {
@@ -6239,13 +6380,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;
@@ -6768,6 +6909,7 @@ function diagnoseDocument(doc) {
   PxTextPathEffectSchema,
   PxTextPathMethod,
   PxTextPathSpacing,
+  PxTimeTimelineSchema,
   PxTimelineEngine,
   PxTimelineEngineSetting,
   PxTimelineSchema,