@pixodesk/svg-animator-core 1.0.45 → 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;
 }
@@ -6126,9 +6161,10 @@ function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, ro
 // 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;
+  var _a2, _b;
   const out = deepClone(root);
   const config = getAnimatorConfig(out) || {};
   const duration = +(config.duration || PX_DEFAULT_DURATION_MS);
@@ -6140,18 +6176,27 @@ function materializeRestPosesInTree(root, engine) {
   for (const [key, animate] of before) {
     const node = nodes.get(key);
     if (!node) continue;
-    for (const channel of Object.keys(animate)) {
+    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 (JSON.stringify(after.get(key)) === JSON.stringify(before.get(key))) continue;
+      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];
     }
@@ -6160,16 +6205,31 @@ function materializeRestPosesInTree(root, engine) {
 }
 function mayCarryRestPose(node, channel) {
   if (node[channel] !== void 0) return false;
-  if (PX_TRANSFORM_FN_NAMES.has(channel)) return false;
-  if (channel === TRANSFORM_CHANNEL) {
-    for (const part of PX_TRANSFORM_FN_NAMES) if (node[part] !== 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();
@@ -6320,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;
@@ -6849,6 +6909,7 @@ function diagnoseDocument(doc) {
   PxTextPathEffectSchema,
   PxTextPathMethod,
   PxTextPathSpacing,
+  PxTimeTimelineSchema,
   PxTimelineEngine,
   PxTimelineEngineSetting,
   PxTimelineSchema,