@pixodesk/svg-animator-core 1.0.34 → 1.0.35

package/dist/index.cjs

@@ -50,6 +50,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BASELINE_PLAYER_VERSION: () => BASELINE_PLAYER_VERSION,
   COLOUR_ATTR_NAMES: () => COLOUR_ATTR_NAMES,
   CSS_ONLY_STYLE_PROPS: () => CSS_ONLY_STYLE_PROPS,
   DEFAULT_DURATION_MS: () => DEFAULT_DURATION_MS,
@@ -58,18 +59,21 @@ __export(index_exports, {
   LOOP_JUMP_SHIFT_MS: () => LOOP_JUMP_SHIFT_MS,
   MISSING_GLYPH_CLASS_NAME: () => MISSING_GLYPH_CLASS_NAME,
   PCT_BASED_ATTR_NAMES: () => PCT_BASED_ATTR_NAMES,
+  PLAYER_WIRE_STEPS: () => PLAYER_WIRE_STEPS,
+  PLAYER_WIRE_VERSION: () => PLAYER_WIRE_VERSION,
   PX_ANIM_ATTR_NAME: () => PX_ANIM_ATTR_NAME,
   PX_ANIM_SRC_ATTR_NAME: () => PX_ANIM_SRC_ATTR_NAME,
+  PX_PLAYER_SCHEMA_VERSION: () => PX_PLAYER_SCHEMA_VERSION,
   PX_TRANSFORM_PART_KEYS: () => PX_TRANSFORM_PART_KEYS,
+  PX_UNKNOWN_KEY_ERROR: () => PX_UNKNOWN_KEY_ERROR,
   PxAnimatedSvgDocumentSchema: () => PxAnimatedSvgDocumentSchema,
   PxAnimationDefinitionSchema: () => PxAnimationDefinitionSchema,
   PxAnimatorConfigSchema: () => PxAnimatorConfigSchema,
-  PxAnimatorEngine: () => PxAnimatorEngine,
-  PxAnimatorMode: () => PxAnimatorMode,
   PxAttrValueSchema: () => PxAttrValueSchema,
   PxBezierPathSchema: () => PxBezierPathSchema,
   PxBindingSchema: () => PxBindingSchema,
   PxCloneEffectSchema: () => PxCloneEffectSchema,
+  PxCloneWithout: () => PxCloneWithout,
   PxDefsSchema: () => PxDefsSchema,
   PxEasingOrRefSchema: () => PxEasingOrRefSchema,
   PxEffectsSchema: () => PxEffectsSchema,
@@ -81,7 +85,8 @@ __export(index_exports, {
   PxGradientUnits: () => PxGradientUnits,
   PxKeyframeSchema: () => PxKeyframeSchema,
   PxKeyframeValueSchema: () => PxKeyframeValueSchema,
-  PxLoopExtend: () => PxLoopExtend,
+  PxLoopDirection: () => PxLoopDirection,
+  PxLoopRepeatAt: () => PxLoopRepeatAt,
   PxLoopSchema: () => PxLoopSchema,
   PxMaskedByEffectSchema: () => PxMaskedByEffectSchema,
   PxNodeBase: () => PxNodeBase,
@@ -98,6 +103,8 @@ __export(index_exports, {
   PxSvgNodeExtra: () => PxSvgNodeExtra,
   PxTextEffectSchema: () => PxTextEffectSchema,
   PxTextPathEffectSchema: () => PxTextPathEffectSchema,
+  PxTimelineEngine: () => PxTimelineEngine,
+  PxTimelineEngineExtra: () => PxTimelineEngineExtra,
   PxTimelinePinSchema: () => PxTimelinePinSchema,
   PxTimelineSchema: () => PxTimelineSchema,
   PxTransformByEffectSchema: () => PxTransformByEffectSchema,
@@ -108,22 +115,35 @@ __export(index_exports, {
   TEXT_ATTR: () => TEXT_ATTR,
   TEXT_CONTENT_ATTR: () => TEXT_CONTENT_ATTR,
   TRANSFORM_FN_NAMES: () => TRANSFORM_FN_NAMES,
+  WIRE_VERSION_KEY: () => WIRE_VERSION_KEY,
+  WireStepKind: () => WireStepKind,
+  WireVersionRelation: () => WireVersionRelation,
+  applyAnimatorConfig: () => applyAnimatorConfig,
   applyPlayerEffects: () => applyPlayerEffects,
+  applyWireSteps: () => applyWireSteps,
+  applyWireStepsDown: () => applyWireStepsDown,
   bezierToSvgPath: () => bezierToSvgPath,
   calcAnimationValues: () => calcAnimationValues,
   camelCaseToKebabWordIfNeeded: () => camelCaseToKebabWordIfNeeded,
   clamp: () => clamp,
   collectSampleTimes: () => collectSampleTimes,
+  compareWireVersion: () => compareWireVersion,
   composeTransformParts: () => composeTransformParts,
+  convertPlayerDocument: () => convertPlayerDocument,
   createBasicFrameLoopAnimator: () => createBasicFrameLoopAnimator,
   createPathSampler: () => createPathSampler,
   cubicBezier: () => cubicBezier,
   deepClone: () => deepClone,
   describeSchema: () => describeSchema,
+  diagnoseDocument: () => diagnoseDocument,
+  diffFieldUniverse: () => diffFieldUniverse,
   diffInEffect: () => diffInEffect,
+  downgradePlayerDocument: () => downgradePlayerDocument,
   evaluateMotionPathSegment: () => evaluateMotionPathSegment,
   extendedPathForBrowser: () => extendedPathForBrowser,
   flattenAnimatorTimeline: () => flattenAnimatorTimeline,
+  foldAnimatorConfigShortcuts: () => foldAnimatorConfigShortcuts,
+  formatWireVersion: () => formatWireVersion,
   generateNewIds: () => generateNewIds,
   generateUniqueId: () => generateUniqueId,
   getAnimatorConfig: () => getAnimatorConfig,
@@ -134,11 +154,17 @@ __export(index_exports, {
   getNormalizedProps: () => getNormalizedProps,
   interpolateBeziers: () => interpolateBeziers,
   interpolateValue: () => interpolateValue,
+  isNativeForced: () => isNativeForced,
   isPxElementFileFormat: () => isPxElementFileFormat,
   isPxElementFileFormatDeep: () => isPxElementFileFormatDeep,
   isScrollTimeline: () => isScrollTimeline,
   jsonElementFactory: () => jsonElementFactory,
   kebabToCamelCaseWord: () => kebabToCamelCaseWord,
+  kfEasing: () => kfEasing,
+  kfTangentIn: () => kfTangentIn,
+  kfTangentOut: () => kfTangentOut,
+  kfTime: () => kfTime,
+  kfValue: () => kfValue,
   layoutGlyphTextChars: () => layoutGlyphTextChars,
   materialiseAllInTree: () => materialiseAllInTree,
   materialiseAnimatedUseInstances: () => materialiseAnimatedUseInstances,
@@ -149,14 +175,23 @@ __export(index_exports, {
   materialiseInternalLoopsInTree: () => materialiseInternalLoopsInTree,
   materialiseMotionPathInPropAnim: () => materialiseMotionPathInPropAnim,
   materialiseMotionPathsInTree: () => materialiseMotionPathsInTree,
+  mayUseNativeScrollTimeline: () => mayUseNativeScrollTimeline,
+  mergeAnimatorConfig: () => mergeAnimatorConfig,
   mergeStaticTransformIntoAnimDef: () => mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline: () => nestAnimatorTimeline,
   parseTransformParts: () => parseTransformParts,
+  parseWireVersion: () => parseWireVersion,
+  planSchemaRelease: () => planSchemaRelease,
   propAnimIsMotionPath: () => propAnimIsMotionPath,
   px: () => px,
+  readWireVersion: () => readWireVersion,
+  releaseLogProblems: () => releaseLogProblems,
+  reportDocumentDiagnostics: () => reportDocumentDiagnostics,
   resolveStyle: () => resolveStyle,
+  resolveTimelineEngine: () => resolveTimelineEngine,
   reverseEasing: () => reverseEasing,
   sanitiseAttributeValue: () => sanitiseAttributeValue,
+  schemaFieldUniverse: () => schemaFieldUniverse,
   schemaKeys: () => schemaKeys,
   scrollOffsetProgress: () => scrollOffsetProgress,
   scrollPhaseInterval: () => scrollPhaseInterval,
@@ -167,14 +202,16 @@ __export(index_exports, {
   splitEasing: () => splitEasing,
   subdivideCubicBezier: () => subdivideCubicBezier,
   toRGBA: () => toRGBA,
+  validateDocument: () => validateDocument,
   validateNodeEffects: () => validateNodeEffects,
+  versionAdvice: () => versionAdvice,
   visualModelAt: () => visualModelAt
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/PxAnimatorUtil.ts
+// src/util/PxAnimatorUtil.ts
 function bezierToSvgPath(path, forceCurves = false) {
-  var _a, _b, _c, _d;
+  var _a2, _b, _c, _d;
   const v = path.v;
   const i = path.i;
   const o = path.o;
@@ -185,7 +222,7 @@ function bezierToSvgPath(path, forceCurves = false) {
   d.push("M" + v[0][0] + "," + v[0][1]);
   for (let idx = 1; idx < len; idx++) {
     const prevV = v[idx - 1];
-    const prevO = (_a = o == null ? void 0 : o[idx - 1]) != null ? _a : prevV;
+    const prevO = (_a2 = o == null ? void 0 : o[idx - 1]) != null ? _a2 : prevV;
     const currI = (_b = i == null ? void 0 : i[idx]) != null ? _b : v[idx];
     const currV = v[idx];
     const isLine = !forceCurves && (prevO[0] === prevV[0] && prevO[1] === prevV[1]) && (currI[0] === currV[0] && currI[1] === currV[1]);
@@ -236,7 +273,7 @@ function interpolateBeziers(paths1, paths2, progress) {
   return res;
 }
 function interpolateBezier(path1, path2, progress) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i;
   if (!path1 || !path2) return path1 || path2 || { v: [] };
   const t = Math.min(Math.max(progress, 0), 1);
   const len = Math.min(path1.v.length, path2.v.length);
@@ -247,7 +284,7 @@ function interpolateBezier(path1, path2, progress) {
     const v1 = path1.v[idx];
     const v2 = path2.v[idx];
     v.push(interpolateVec(v1, v2, t));
-    const i1 = (_b = (_a = path1.i) == null ? void 0 : _a[idx]) != null ? _b : v1;
+    const i1 = (_b = (_a2 = path1.i) == null ? void 0 : _a2[idx]) != null ? _b : v1;
     const i2 = (_d = (_c = path2.i) == null ? void 0 : _c[idx]) != null ? _d : v2;
     i.push(interpolateVec(i1, i2, t));
     const o1 = (_f = (_e = path1.o) == null ? void 0 : _e[idx]) != null ? _f : v1;
@@ -366,8 +403,8 @@ function toRGBA(color) {
   return color.length === 4 ? "rgba(" + r + "," + g + "," + b + "," + color[3] + ")" : "rgb(" + r + "," + g + "," + b + ")";
 }
 function parseRgba(s) {
-  var _a;
-  const inner = (_a = s.match(/rgba?\((.*)\)/)) == null ? void 0 : _a[1];
+  var _a2;
+  const inner = (_a2 = s.match(/rgba?\((.*)\)/)) == null ? void 0 : _a2[1];
   if (!inner) throw new Error("Invalid rgb/rgba format");
   const parts = inner.split(",").map((v) => +v.trim());
   return [parts[0] / 255, parts[1] / 255, parts[2] / 255, ...parts[3] !== void 0 ? [parts[3]] : []];
@@ -406,9 +443,9 @@ var COLOUR_ATTR_NAMES = /* @__PURE__ */ new Set(["color", "fill", "flood-color",
 var TRANSFORM_FN_NAMES = /* @__PURE__ */ new Set(["translate", "rotate", "scale", "skew"]);
 var PCT_BASED_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
 function composeTransformParts(parts, opts) {
-  var _a;
+  var _a2;
   if (!parts) return "";
-  const withUnits = (_a = opts == null ? void 0 : opts.withUnits) != null ? _a : true;
+  const withUnits = (_a2 = opts == null ? void 0 : opts.withUnits) != null ? _a2 : true;
   const segs = [];
   const t = parts.translate;
   const o = parts.origin;
@@ -426,7 +463,7 @@ function composeTransformParts(parts, opts) {
   return segs.join("");
 }
 function parseTransformParts(str2) {
-  var _a, _b;
+  var _a2, _b;
   if (!str2 || typeof str2 !== "string") return void 0;
   const out = {};
   const re = /([a-zA-Z]+)\s*\(([^)]*)\)/g;
@@ -442,7 +479,7 @@ function parseTransformParts(str2) {
     if (nums.some((n) => Number.isNaN(n))) return void 0;
     if (fn === "translate") {
       if (nums.length < 1 || nums.length > 2) return void 0;
-      out.translate = [nums[0], (_a = nums[1]) != null ? _a : 0];
+      out.translate = [nums[0], (_a2 = nums[1]) != null ? _a2 : 0];
     } else if (fn === "rotate") {
       if (nums.length !== 1) return void 0;
       out.rotate = nums[0];
@@ -620,7 +657,7 @@ function invertEasing(easing) {
   return cubicBezier(flipped);
 }
 
-// src/PxScrollMath.ts
+// src/playback/PxScrollMath.ts
 function isScrollTimeline(config) {
   return (config == null ? void 0 : config.timelineSource) === "scroll";
 }
@@ -648,8 +685,8 @@ function scrollPhaseInterval(phase, subjectSize, scrollportSize) {
 }
 var DEFAULT_PHASE = "cover";
 function resolveRangePointU(point, defaultFraction, subjectSize, scrollportSize) {
-  var _a;
-  const [u0, u1] = scrollPhaseInterval((_a = point == null ? void 0 : point.phase) != null ? _a : DEFAULT_PHASE, subjectSize, scrollportSize);
+  var _a2;
+  const [u0, u1] = scrollPhaseInterval((_a2 = point == null ? void 0 : point.phase) != null ? _a2 : DEFAULT_PHASE, subjectSize, scrollportSize);
   const fraction = typeof (point == null ? void 0 : point.fraction) === "number" ? point.fraction : defaultFraction;
   return u0 + fraction * (u1 - u0);
 }
@@ -661,9 +698,9 @@ function scrollViewProgress(subjectStart, subjectSize, scrollportSize, range) {
   return clamp((u - uStart) / (uEnd - uStart), 0, 1);
 }
 function scrollOffsetProgress(offset, maxOffset, range) {
-  var _a, _b;
+  var _a2, _b;
   const raw = maxOffset > 0 ? clamp(offset / maxOffset, 0, 1) : 1;
-  const start = typeof ((_a = range == null ? void 0 : range.start) == null ? void 0 : _a.fraction) === "number" ? range.start.fraction : 0;
+  const start = typeof ((_a2 = range == null ? void 0 : range.start) == null ? void 0 : _a2.fraction) === "number" ? range.start.fraction : 0;
   const end = typeof ((_b = range == null ? void 0 : range.end) == null ? void 0 : _b.fraction) === "number" ? range.end.fraction : 1;
   if (end <= start) return raw >= end ? 1 : 0;
   return clamp((raw - start) / (end - start), 0, 1);
@@ -676,7 +713,8 @@ function scrollResolveAxis(axis, writingMode) {
   return vertical ? "x" : "y";
 }
 
-// src/PxSchema.ts
+// src/schema/PxSchema.ts
+var PX_UNKNOWN_KEY_ERROR = "unexpected extra key";
 function pathStr(path) {
   if (!path.length) return ".";
   let result = "";
@@ -799,10 +837,10 @@ var Union = class extends Base {
     return this._default;
   }
   isValid(raw, ctx, path) {
-    var _a;
+    var _a2;
     const probe = ctx && { errors: [], warnings: [], strict: ctx.strict };
     if (this.schemas.some((s) => s.isValid(raw, probe, path ? [...path] : void 0))) return true;
-    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": no union member matched for value " + ((_a = JSON.stringify(raw)) != null ? _a : "").slice(0, 240));
+    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": no union member matched for value " + ((_a2 = JSON.stringify(raw)) != null ? _a2 : "").slice(0, 240));
     return false;
   }
   _canSanitize(raw) {
@@ -811,6 +849,7 @@ var Union = class extends Base {
 };
 var DiscriminatedUnion = class extends Base {
   constructor(_key, _schemas, defaultVal) {
+    var _a2;
     super();
     this._key = _key;
     this._schemas = _schemas;
@@ -820,18 +859,21 @@ var DiscriminatedUnion = class extends Base {
     this._map = /* @__PURE__ */ new Map();
     for (const s of _schemas) {
       const keySchema = s._shape[_key];
-      if (keySchema) this._map.set(keySchema._default, s);
+      if (!keySchema) continue;
+      const literal = (_a2 = keySchema.inner) != null ? _a2 : keySchema;
+      this._map.set(literal._default, s);
+      if (keySchema.inner) this._absentMember = s;
     }
   }
   _findSchema(raw) {
     if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return void 0;
     const val = raw[this._key];
-    if (val === void 0 || val === null) return void 0;
+    if (val === void 0 || val === null) return this._absentMember;
     return this._map.get(val);
   }
   sanitize(raw) {
-    var _a;
-    return ((_a = this._findSchema(raw)) != null ? _a : this._schemas[0]).sanitize(raw);
+    var _a2;
+    return ((_a2 = this._findSchema(raw)) != null ? _a2 : this._schemas[0]).sanitize(raw);
   }
   isValid(raw, ctx, path) {
     const schema = this._findSchema(raw);
@@ -860,7 +902,8 @@ var Obj = class extends Base {
     const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
     const out = {};
     for (const key of Object.keys(this._shape)) {
-      out[key] = this._shape[key].sanitize(src[key]);
+      const v = this._shape[key].sanitize(src[key]);
+      if (v !== void 0) out[key] = v;
     }
     return out;
   }
@@ -882,7 +925,7 @@ var Obj = class extends Base {
         if (key in this._shape) continue;
         if (obj[key] === void 0) continue;
         p.push(key);
-        ctx.errors.push(pathStr(p) + ": unexpected extra key");
+        ctx.errors.push(pathStr(p) + ": " + PX_UNKNOWN_KEY_ERROR);
         p.pop();
         ok = false;
       }
@@ -906,7 +949,8 @@ var OpenObj = class extends Base {
     const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
     const out = __spreadValues({}, src);
     for (const key of Object.keys(this._shape)) {
-      out[key] = this._shape[key].sanitize(src[key]);
+      const v = this._shape[key].sanitize(src[key]);
+      if (v !== void 0) out[key] = v;
     }
     if (this._openSchema) {
       for (const key of Object.keys(src)) {
@@ -1048,8 +1092,8 @@ var Lazy = class extends Base {
     this.resolved = null;
   }
   get schema() {
-    var _a;
-    return (_a = this.resolved) != null ? _a : this.resolved = this.fn();
+    var _a2;
+    return (_a2 = this.resolved) != null ? _a2 : this.resolved = this.fn();
   }
   sanitize(raw) {
     return this.schema.sanitize(raw);
@@ -1101,7 +1145,7 @@ function schemaKeys(schema) {
   );
 }
 function describeSchema(schema) {
-  var _a;
+  var _a2;
   const s = schema;
   switch (s._kind) {
     case "union":
@@ -1116,7 +1160,7 @@ function describeSchema(schema) {
   if ("_shape" in s) return { kind: "shape", shape: s._shape, openValue: s._openSchema };
   if ("item" in s) return { kind: "array", item: s.item };
   if ("inner" in s) return { kind: "optional", inner: s.inner };
-  if ("fn" in s) return { kind: "lazy", resolved: (_a = s.resolved) != null ? _a : s.resolved = s.fn() };
+  if ("fn" in s) return { kind: "lazy", resolved: (_a2 = s.resolved) != null ? _a2 : s.resolved = s.fn() };
   return { kind: "leaf" };
 }
 var px = {
@@ -1171,25 +1215,343 @@ var px = {
   lazy: (fn, defaultVal) => new Lazy(fn, defaultVal)
 };
 
-// src/PxAnimatorConstants.ts
+// src/version/PxSchemaVersion.ts
+var PX_PLAYER_SCHEMA_VERSION = "1.1";
+
+// src/version/PxWireVersion.ts
+var WIRE_VERSION_KEY = "version";
+var ANIMATOR_KEY = "animator";
+var META_KEY = "meta";
+var WireVersionRelation = /* @__PURE__ */ ((WireVersionRelation2) => {
+  WireVersionRelation2["unstamped"] = "unstamped";
+  WireVersionRelation2["same"] = "same";
+  WireVersionRelation2["older"] = "older";
+  WireVersionRelation2["newer"] = "newer";
+  WireVersionRelation2["otherGeneration"] = "otherGeneration";
+  return WireVersionRelation2;
+})(WireVersionRelation || {});
+var VERSION_RE = /^(\d+)\.(\d+)(?:\.(\d+))?$/;
+function parseWireVersion(raw) {
+  if (typeof raw !== "string") return void 0;
+  const m = VERSION_RE.exec(raw.trim());
+  if (!m) return void 0;
+  return { a: Number(m[1]), b: Number(m[2]), c: m[3] === void 0 ? 0 : Number(m[3]) };
+}
+function formatWireVersion(v) {
+  return v.a + "." + v.b + "." + v.c;
+}
+var _a;
+var PLAYER_WIRE_VERSION = (_a = parseWireVersion(PX_PLAYER_SCHEMA_VERSION)) != null ? _a : { a: 1, b: 1, c: 0 };
+function getAnimatorBlock(doc) {
+  if (!doc || typeof doc !== "object") return void 0;
+  const atRoot = readObjectProp(doc, ANIMATOR_KEY);
+  if (atRoot) return atRoot;
+  const meta = readObjectProp(doc, META_KEY);
+  return meta ? readObjectProp(meta, ANIMATOR_KEY) : void 0;
+}
+function readObjectProp(obj, key) {
+  const value = obj[key];
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function readWireVersion(doc) {
+  const animator = getAnimatorBlock(doc);
+  return animator ? parseWireVersion(animator[WIRE_VERSION_KEY]) : void 0;
+}
+function compareWireVersion(file, mine, readerReadsEditorPart) {
+  if (!file) return "unstamped" /* unstamped */;
+  if (file.a !== mine.a) return "otherGeneration" /* otherGeneration */;
+  if (file.b !== mine.b) return file.b > mine.b ? "newer" /* newer */ : "older" /* older */;
+  if (!readerReadsEditorPart || file.c === mine.c) return "same" /* same */;
+  return file.c > mine.c ? "newer" /* newer */ : "older" /* older */;
+}
+function versionAdvice(relation, file, mine, isPlayer) {
+  if (!file) return void 0;
+  const target = isPlayer ? "player" : "editor";
+  const gap = "written for schema " + formatWireVersion(file) + ", this " + target + " reads " + formatWireVersion(mine);
+  switch (relation) {
+    case "newer" /* newer */:
+      return "This file is " + gap + ". Update the " + target + " to open it fully.";
+    case "older" /* older */:
+      return "This file is " + gap + ". Saving it from this " + target + " rewrites it in the current format.";
+    case "otherGeneration" /* otherGeneration */:
+      return "This file is " + gap + " \u2014 a different format generation, which no conversion bridges. Open it in a " + target + " of that generation, or accept this document without the parts named above.";
+    default:
+      return void 0;
+  }
+}
+var WireStepKind = /* @__PURE__ */ ((WireStepKind2) => {
+  WireStepKind2["additive"] = "additive";
+  WireStepKind2["converted"] = "converted";
+  return WireStepKind2;
+})(WireStepKind || {});
+var BASELINE_PLAYER_VERSION = "1.1";
+var PLAYER_WIRE_STEPS = [];
+function applyWireSteps(doc, cfg) {
+  const from = readWireVersion(doc);
+  const relation = compareWireVersion(from, cfg.target, cfg.readerReadsEditorPart);
+  if (!from || relation !== "older" /* older */) {
+    return {
+      doc,
+      from,
+      relation,
+      applied: [],
+      advice: versionAdvice(relation, from, cfg.target, !cfg.readerReadsEditorPart)
+    };
+  }
+  const due = [];
+  for (const step of cfg.steps) {
+    const stepTo = parseWireVersion(step.to);
+    if (!stepTo) continue;
+    if (compareWireVersion(from, stepTo, cfg.readerReadsEditorPart) !== "older" /* older */) continue;
+    if (!step.up) continue;
+    due.push(step);
+  }
+  if (!due.length || !doc || typeof doc !== "object") return { doc, from, relation, applied: [] };
+  const target = clonePlain(doc);
+  const applied = [];
+  for (const step of due) {
+    try {
+      step.up(target);
+      applied.push(step);
+    } catch (e) {
+      break;
+    }
+  }
+  if (!applied.length) return { doc, from, relation, applied: [] };
+  stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
+  return { doc: target, from, relation, applied };
+}
+function convertPlayerDocument(doc) {
+  return applyWireSteps(doc, {
+    steps: PLAYER_WIRE_STEPS,
+    target: PLAYER_WIRE_VERSION,
+    readerReadsEditorPart: false
+  });
+}
+function clonePlain(value) {
+  const structured = globalThis.structuredClone;
+  return structured ? structured(value) : JSON.parse(JSON.stringify(value));
+}
+function stampVersion(doc, target, readerReadsEditorPart) {
+  const animator = getAnimatorBlock(doc);
+  if (!animator) return;
+  const previous = parseWireVersion(animator[WIRE_VERSION_KEY]);
+  animator[WIRE_VERSION_KEY] = formatWireVersion({
+    a: target.a,
+    b: target.b,
+    c: readerReadsEditorPart ? target.c : previous ? previous.c : 0
+  });
+}
+function applyWireStepsDown(doc, cfg) {
+  const from = readWireVersion(doc);
+  if (!from) {
+    return { ok: false, blocking: [], reason: "The document carries no version, so there is nothing to convert down from." };
+  }
+  const relation = compareWireVersion(from, cfg.target, cfg.readerReadsEditorPart);
+  if (relation === "otherGeneration" /* otherGeneration */) {
+    return {
+      ok: false,
+      blocking: [],
+      reason: "Schema " + formatWireVersion(from) + " and " + formatWireVersion(cfg.target) + " are different generations; no conversion bridges them."
+    };
+  }
+  if (relation !== "newer" /* newer */) return { ok: true, doc, applied: [] };
+  const toUndo = [];
+  for (const step of cfg.steps) {
+    const stepTo = parseWireVersion(step.to);
+    if (!stepTo) continue;
+    if (compareWireVersion(stepTo, cfg.target, cfg.readerReadsEditorPart) !== "newer" /* newer */) continue;
+    if (compareWireVersion(stepTo, from, cfg.readerReadsEditorPart) === "newer" /* newer */) continue;
+    toUndo.push(step);
+  }
+  toUndo.reverse();
+  const blocking = toUndo.filter((s) => s.kind === "converted" /* converted */ && !s.down);
+  if (blocking.length) {
+    return {
+      ok: false,
+      blocking,
+      reason: "Cannot convert down to " + formatWireVersion(cfg.target) + ": " + blocking.map((s) => s.from + " \u2192 " + s.to + " (" + s.reason + ")").join("; ") + " cannot be undone."
+    };
+  }
+  const target = clonePlain(doc);
+  const applied = [];
+  for (const step of toUndo) {
+    if (!step.down) continue;
+    try {
+      step.down(target);
+      applied.push(step);
+    } catch (e) {
+      return {
+        ok: false,
+        blocking: [step],
+        reason: "Undoing " + step.from + " \u2192 " + step.to + " failed: " + String(e)
+      };
+    }
+  }
+  stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
+  return { ok: true, doc: target, applied };
+}
+function downgradePlayerDocument(doc, target) {
+  return applyWireStepsDown(doc, { steps: PLAYER_WIRE_STEPS, target, readerReadsEditorPart: false });
+}
+
+// src/version/PxSchemaFieldUniverse.ts
+function schemaFieldUniverse(root) {
+  const fields = /* @__PURE__ */ new Set();
+  const enumerated = /* @__PURE__ */ new Set();
+  const queue = [{ schema: root, path: "" }];
+  while (queue.length) {
+    const { schema, path } = queue.shift();
+    const d = describeSchema(schema);
+    switch (d.kind) {
+      case "shape": {
+        if (enumerated.has(schema)) break;
+        enumerated.add(schema);
+        for (const key of Object.keys(d.shape)) {
+          const id = path ? path + "." + key : key;
+          fields.add(id);
+          queue.push({ schema: d.shape[key], path: id });
+        }
+        if (d.openValue) queue.push({ schema: d.openValue, path: path + "{*}" });
+        break;
+      }
+      case "optional":
+        queue.push({ schema: d.inner, path });
+        break;
+      case "array":
+        queue.push({ schema: d.item, path: path + "[]" });
+        break;
+      case "lazy":
+        queue.push({ schema: d.resolved, path });
+        break;
+      case "record":
+        queue.push({ schema: d.value, path: path + "{*}" });
+        break;
+      case "union":
+        d.members.forEach((member, i) => queue.push({ schema: member, path: path + "|" + i }));
+        break;
+      case "discriminatedUnion":
+        for (const member of d.members) queue.push({ schema: member, path: path + "|" + discriminantOf(member, d.key) });
+        break;
+      default:
+        break;
+    }
+  }
+  return [...fields].sort();
+}
+function discriminantOf(member, key) {
+  const d = describeSchema(member);
+  if (d.kind !== "shape") return "?";
+  const keySchema = d.shape[key];
+  if (keySchema === void 0) return "?";
+  const kd = describeSchema(keySchema);
+  return String((kd.kind === "optional" ? kd.inner : keySchema)._default);
+}
+
+// src/version/PxSchemaRelease.ts
+function diffFieldUniverse(previous, current) {
+  const prev = new Set(previous);
+  const cur = new Set(current);
+  return {
+    added: current.filter((k) => !prev.has(k)).sort(),
+    removed: previous.filter((k) => !cur.has(k)).sort()
+  };
+}
+function planSchemaRelease(p) {
+  const changed = p.added.length > 0 || p.removed.length > 0;
+  const last = parseWireVersion(p.lastReleased);
+  const declared = parseWireVersion(p.declared);
+  if (!last || !declared) return { changed, refuse: "Unparseable version: " + p.lastReleased + " / " + p.declared + "." };
+  const requiredVersion = last.a + "." + (last.b + 1);
+  if (!changed) {
+    if (declared.b === last.b && declared.a === last.a) return { changed };
+    const step2 = p.steps.find((s) => s.to === p.declared);
+    return step2 ? { changed, requiredVersion: p.declared } : { changed, refuse: "The version moved to " + p.declared + " with no key change and no step explaining it." };
+  }
+  const requiredKind = p.removed.length ? "converted" /* converted */ : "additive" /* additive */;
+  const summary = p.added.length + " key(s) added, " + p.removed.length + " removed";
+  if (declared.a !== last.a || declared.b !== last.b + 1) {
+    return {
+      changed,
+      requiredKind,
+      requiredVersion,
+      refuse: "The player schema changed (" + summary + ") but PX_PLAYER_SCHEMA_VERSION is " + p.declared + ". Set it to " + requiredVersion + " and add the PLAYER_WIRE_STEPS entry."
+    };
+  }
+  const step = p.steps.find((s) => s.to === p.declared);
+  if (!step) {
+    return { changed, requiredKind, requiredVersion, refuse: "No PLAYER_WIRE_STEPS entry reaches " + p.declared + "." };
+  }
+  if (requiredKind === "converted" /* converted */ && step.kind !== "converted" /* converted */) {
+    return {
+      changed,
+      requiredKind,
+      requiredVersion,
+      refuse: "Keys were REMOVED (" + p.removed.join(", ") + "), which is never additive \u2014 the " + p.declared + " step must be `converted`, with an up()."
+    };
+  }
+  return { changed, requiredKind, requiredVersion };
+}
+function releaseLogProblems(releases, steps, declared, baseline) {
+  const problems = [];
+  if (!releases.length) return ["The release log is empty."];
+  if (!releases[0].baseline || releases[0].version !== baseline) {
+    problems.push("The first release must be the baseline " + baseline + ".");
+  }
+  for (let i = 1; i < releases.length; i++) {
+    const prev = parseWireVersion(releases[i - 1].version);
+    const cur = parseWireVersion(releases[i].version);
+    if (!prev || !cur || cur.a !== prev.a || cur.b !== prev.b + 1) {
+      problems.push("Release " + releases[i].version + " does not follow " + releases[i - 1].version + " by one `b` step.");
+    }
+    if (releases[i].date < releases[i - 1].date) problems.push("Release " + releases[i].version + " is dated before its predecessor.");
+    const step = steps.find((s) => s.to === releases[i].version);
+    if (!step) problems.push("Release " + releases[i].version + " has no PLAYER_WIRE_STEPS entry.");
+    else if (releases[i].removed.length && step.kind !== "converted" /* converted */) {
+      problems.push("Release " + releases[i].version + " removed keys, but its step is not `converted`.");
+    }
+  }
+  const latest = releases[releases.length - 1].version;
+  if (latest !== declared) {
+    problems.push("PX_PLAYER_SCHEMA_VERSION is " + declared + " but the last release record is " + latest + " \u2014 a bump needs its changelog entry (run scripts/schema-release.mjs --apply).");
+  }
+  return problems;
+}
+
+// src/format/PxAnimatorConstants.ts
 var PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
 var PX_ANIM_ATTR_NAME = "_px_animator";
-var PxAnimatorMode = {
-  auto: "auto",
-  waapi: "waapi",
-  frames: "frames"
+var PX_TIMELINE_SHARED_KEYS = ["duration", "iterations", "engine", "frameRate"];
+var PX_TIME_ONLY_TIMELINE_KEYS = ["trigger", "delay", "fillMode", "direction"];
+var PxTimelineEngine = {
+  native: "native",
+  js: "js"
 };
-var PxAnimatorEngine = {
-  waapi: PxAnimatorMode.waapi,
-  frames: PxAnimatorMode.frames
+var PxTimelineEngineExtra = __spreadProps(__spreadValues({}, PxTimelineEngine), {
+  auto: "auto"
+});
+function resolveTimelineEngine(engine) {
+  return engine === PxTimelineEngineExtra.js ? PxTimelineEngine.js : PxTimelineEngine.native;
+}
+function isNativeForced(engine) {
+  return engine === PxTimelineEngineExtra.native;
+}
+function mayUseNativeScrollTimeline(engine) {
+  return engine !== PxTimelineEngineExtra.js;
+}
+var PxLoopRepeatAt = {
+  /** Segment from the START; the repetition runs BEFORE the first keyframe
+   *  (intro loops that play until the main timeline begins). */
+  start: "start",
+  /** DEFAULT — segment from the END; the repetition runs AFTER the last keyframe
+   *  (idle/outro loops that continue once the main timeline has finished). */
+  end: "end"
 };
-var PxLoopExtend = {
-  /** Segment from the START; the animation is extended BEFORE the first keyframe
-   *  (intro loops that run before the main timeline begins). */
-  before: "before",
-  /** DEFAULT — segment from the END; extended AFTER the last keyframe (idle/outro
-   *  loops that continue once the main timeline has finished). */
-  after: "after"
+var PxLoopDirection = {
+  /** DEFAULT — cycle: every repetition replays the segment the same way round. */
+  normal: "normal",
+  /** Ping-pong: repetitions alternate forward / backward. */
+  alternate: "alternate"
 };
 var PxMaskType = {
   luminance: "luminance",
@@ -1199,8 +1561,9 @@ var PxUnits = {
   userSpaceOnUse: "userSpaceOnUse",
   objectBoundingBox: "objectBoundingBox"
 };
-var PxCloneType = {
-  content: "content"
+var PxCloneWithout = {
+  translate: "translate"
+  // transform: 'transform',   // future: drop rotate/scale too (content only)
 };
 var PxPathOverflow = {
   clip: "clip",
@@ -1224,6 +1587,9 @@ var PxStrokeTrimSubPaths = {
 };
 var TEXT_ATTR = "text";
 var TEXT_CONTENT_ATTR = "textContent";
+var CLASS_ATTR = "class";
+var TRANSFORM_ATTR = "transform";
+var OFFSET_DISTANCE_ATTR = "offsetDistance";
 var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   "type",
   "children",
@@ -1234,7 +1600,18 @@ var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   TEXT_ATTR,
   TEXT_CONTENT_ATTR
 ]);
-var PX_TRANSFORM_PART_KEYS = ["translate", "rotate", "scale", "origin"];
+var TRANSFORM_PART = {
+  translate: "translate",
+  rotate: "rotate",
+  scale: "scale",
+  origin: "origin"
+};
+var PX_TRANSFORM_PART_KEYS = [
+  TRANSFORM_PART.translate,
+  TRANSFORM_PART.rotate,
+  TRANSFORM_PART.scale,
+  TRANSFORM_PART.origin
+];
 var PxGradientUnits = {
   userSpaceOnUse: "userSpaceOnUse",
   objectBoundingBox: "objectBoundingBox"
@@ -1252,11 +1629,11 @@ function isPxElementFileFormat(fileJson) {
   if (!(fileJson && typeof fileJson === "object" && !Array.isArray(fileJson))) {
     return false;
   }
-  return fileJson["type"] === "svg";
+  return fileJson.type === "svg";
 }
 function getAnimatorConfig(doc) {
-  var _a;
-  const cfg = (doc == null ? void 0 : doc.animator) || ((_a = doc == null ? void 0 : doc.meta) == null ? void 0 : _a.animator);
+  var _a2;
+  const cfg = (doc == null ? void 0 : doc.animator) || ((_a2 = doc == null ? void 0 : doc.meta) == null ? void 0 : _a2.animator);
   return cfg ? flattenAnimatorTimeline(cfg) : void 0;
 }
 var flattenMemo = /* @__PURE__ */ new WeakMap();
@@ -1265,14 +1642,15 @@ function flattenAnimatorTimeline(cfg) {
   if (timeline === void 0 || timeline === null || typeof timeline !== "object") return cfg;
   const memoised = flattenMemo.get(cfg);
   if (memoised) return memoised;
-  const _a = cfg, { timeline: _dropped } = _a, flat = __objRest(_a, ["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") {
     flat.timelineSource = "scroll";
     if (timeline.duration !== void 0) flat.duration = timeline.duration;
     if (timeline.iterations !== void 0) flat.iterations = timeline.iterations;
     const scroll = __spreadValues({}, flat.scroll || {});
     scroll.kind = timeline.type;
-    if (timeline.engine !== void 0) scroll.driver = timeline.engine;
     if (timeline.axis !== void 0) scroll.axis = timeline.axis;
     if (timeline.source !== void 0) scroll.source = timeline.source;
     if (timeline.subject !== void 0) scroll.subject = timeline.subject;
@@ -1290,21 +1668,24 @@ function flattenAnimatorTimeline(cfg) {
   } else {
     if (timeline.duration !== void 0) flat.duration = timeline.duration;
     if (timeline.trigger !== void 0) {
-      const _b = timeline.trigger, { onFinish } = _b, restTrigger = __objRest(_b, ["onFinish"]);
+      const _b = timeline.trigger, { finishAction } = _b, restTrigger = __objRest(_b, ["finishAction"]);
       if (Object.keys(restTrigger).length) flat.trigger = restTrigger;
-      if (onFinish !== void 0) flat.resetOnFinish = onFinish === "reset";
+      if (finishAction !== void 0) flat.resetOnFinish = finishAction === "reset";
     }
     if (timeline.delay !== void 0) flat.delay = timeline.delay;
     if (timeline.iterations !== void 0) flat.iterations = timeline.iterations;
     if (timeline.direction !== void 0) flat.direction = timeline.direction;
-    if (timeline.fill !== void 0) flat.fill = timeline.fill;
+    if (timeline.fillMode !== void 0) flat.fill = timeline.fillMode;
   }
   flattenMemo.set(cfg, flat);
   return flat;
 }
+function scrollKindOrDefault(kind) {
+  return kind === "scroll" ? "scroll" : "view";
+}
 function nestAnimatorTimeline(cfg) {
   if (!cfg || cfg.timeline !== void 0) return cfg;
-  const _a = cfg, {
+  const _a2 = cfg, {
     timelineSource,
     scroll,
     trigger,
@@ -1313,8 +1694,10 @@ function nestAnimatorTimeline(cfg) {
     direction,
     fill,
     resetOnFinish,
-    duration
-  } = _a, shared = __objRest(_a, [
+    duration,
+    engine,
+    frameRate
+  } = _a2, shared = __objRest(_a2, [
     "timelineSource",
     "scroll",
     "trigger",
@@ -1323,14 +1706,17 @@ function nestAnimatorTimeline(cfg) {
     "direction",
     "fill",
     "resetOnFinish",
-    "duration"
+    "duration",
+    "engine",
+    "frameRate"
   ]);
   if (timelineSource === "scroll") {
-    const timeline2 = { type: (scroll == null ? void 0 : scroll.kind) === "view" ? "view" : "scroll" };
+    const timeline2 = { type: scrollKindOrDefault(scroll == null ? void 0 : scroll.kind) };
+    if (engine !== void 0) timeline2.engine = engine;
+    if (frameRate !== void 0) timeline2.frameRate = frameRate;
     if (duration !== void 0) timeline2.duration = duration;
     if (typeof iterations === "number") timeline2.iterations = iterations;
     if (scroll) {
-      if (scroll.driver !== void 0) timeline2.engine = scroll.driver;
       if (scroll.axis !== void 0) timeline2.axis = scroll.axis;
       if (scroll.source !== void 0) timeline2.source = scroll.source;
       if (scroll.subject !== void 0) timeline2.subject = scroll.subject;
@@ -1345,28 +1731,30 @@ function nestAnimatorTimeline(cfg) {
     }
     return __spreadProps(__spreadValues({}, shared), { timeline: timeline2 });
   }
-  const timeline = { type: "clock" };
+  const timeline = {};
+  if (engine !== void 0) timeline.engine = engine;
+  if (frameRate !== void 0) timeline.frameRate = frameRate;
   if (duration !== void 0) timeline.duration = duration;
   if (trigger !== void 0 || resetOnFinish) {
     const t = __spreadValues({}, trigger || {});
-    if (resetOnFinish) t.onFinish = "reset";
+    if (resetOnFinish) t.finishAction = "reset";
     timeline.trigger = t;
   }
   if (delay !== void 0) timeline.delay = delay;
   if (iterations !== void 0) timeline.iterations = iterations;
   if (direction !== void 0) timeline.direction = direction;
-  if (fill !== void 0) timeline.fill = fill;
-  return Object.keys(timeline).length > 1 ? __spreadProps(__spreadValues({}, shared), { timeline }) : shared;
+  if (fill !== void 0) timeline.fillMode = fill;
+  return Object.keys(timeline).length > 0 ? __spreadProps(__spreadValues({}, shared), { timeline }) : shared;
 }
 function getDefs(doc) {
-  var _a;
+  var _a2;
   if (!doc) return void 0;
-  return (_a = getAnimatorConfig(doc)) == null ? void 0 : _a.definitions;
+  return (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.definitions;
 }
 function getBindings(doc) {
-  var _a;
+  var _a2;
   if (!doc) return void 0;
-  const animateById = (_a = getAnimatorConfig(doc)) == null ? void 0 : _a.animateById;
+  const animateById = (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.animateById;
   if (!animateById) return void 0;
   return Object.entries(animateById).map(([id, anim]) => ({ id: id.startsWith("#") ? id.slice(1) : id, animate: anim }));
 }
@@ -1374,7 +1762,7 @@ function getChildren(doc) {
   return doc == null ? void 0 : doc.children;
 }
 
-// src/PxAnimatorTypes.ts
+// src/format/PxAnimatorTypes.ts
 var PxEasingOrRefSchema = px.union([
   px.string(),
   px.tuple([px.number(), px.number(), px.number(), px.number()])
@@ -1406,16 +1794,32 @@ var PxKeyframeSchema = implementsInterface()(px.object({
   // (review §1.3): editor data lives under `meta`. The editor still carries it on
   // its internal COPY-PASTE payload, which never validates against this schema.)
 }));
+var anyKf = (kf) => kf;
+var kfTime = (kf) => {
+  var _a2, _b;
+  return (_b = (_a2 = anyKf(kf).time) != null ? _a2 : anyKf(kf).t) != null ? _b : 0;
+};
+var kfValue = (kf) => {
+  var _a2;
+  return (_a2 = anyKf(kf).value) != null ? _a2 : anyKf(kf).v;
+};
+var kfEasing = (kf) => {
+  var _a2;
+  return (_a2 = anyKf(kf).easing) != null ? _a2 : anyKf(kf).e;
+};
+var kfTangentIn = (kf) => anyKf(kf).tangentIn;
+var kfTangentOut = (kf) => anyKf(kf).tangentOut;
 var PxLoopSchema = implementsInterface()(px.object({
   segmentCount: px.number().optional(),
-  extend: px.enum([PxLoopExtend.before, PxLoopExtend.after]).optional(),
-  alternate: px.boolean().optional()
+  repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end]).optional(),
+  direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate]).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()
+  autoOrient: px.boolean().optional(),
+  alongPathMode: px.enum(["sampled", "offsetPath"]).optional()
 }));
 var PxTransformPartsSchema = implementsInterface()(px.object({
   translate: px.tuple([px.number(), px.number()]).optional(),
@@ -1442,10 +1846,9 @@ var PxTriggerSchema = implementsInterface()(px.object({
   startOn: px.enum(["load", "mouseOver", "click", "scrollIntoView", "programmatic"]).optional(),
   outAction: px.enum(["continue", "pause", "reset", "reverse"]).optional(),
   // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
-  // `fill`) or `'reset'` (snap back to the start state). The trigger-vocabulary home of
-  // the old top-level `resetOnFinish: boolean` (read-legacy) — review §2.3: both
-  // "what happens at the end" knobs now sit side by side and share one style of value.
-  onFinish: px.enum(["hold", "reset"]).optional(),
+  // `fill`) or `'reset'` (snap back to the start state). Pairs with `outAction` ("what
+  // happens when the trigger condition ends"); both end-of-life knobs now read alike.
+  finishAction: px.enum(["hold", "reset"]).optional(),
   scrollIntoViewThreshold: px.number().optional()
 }));
 var PxGlyphSchema = implementsInterface()(px.object({
@@ -1465,7 +1868,7 @@ var PxDefsSchema = implementsInterface()(px.object({
   // Review §2.6: the schema now matches the declared type — a style preset is a flat
   // record of string|number attribute values, nothing nested.
   styles: px.record(px.record(px.union([px.string(), px.number()]))).optional(),
-  glyphs: px.record(PxGlyphFontSchema).optional()
+  fonts: px.record(PxGlyphFontSchema).optional()
 }));
 var PX_SCROLL_PHASES = ["cover", "contain", "entry", "exit", "entry-crossing", "exit-crossing"];
 var PxScrollRangePointSchema = implementsInterface()(px.object({
@@ -1477,7 +1880,6 @@ var PxScrollRangeSchema = px.object({
   end: PxScrollRangePointSchema.optional()
 });
 var PxScrollSchema = implementsInterface()(px.object({
-  driver: px.enum(["custom", "native"]).optional(),
   kind: px.enum(["view", "scroll"]).optional(),
   axis: px.enum(["block", "inline", "x", "y"]).optional(),
   source: px.enum(["nearest", "root"]).optional(),
@@ -1490,21 +1892,26 @@ var PxScrollSchema = implementsInterface()(px.object({
   pinDistance: px.number().optional(),
   range: PxScrollRangeSchema.optional()
 }));
-var PxTimelinePinSchema = px.object({
+var PxTimelinePinSchema = implementsInterface()(px.object({
   align: px.enum(["top", "center", "bottom"]).optional(),
   top: px.number().optional(),
   distance: px.number().optional()
-});
-var PxClockTimelineSchema = px.object({
-  type: px.literal("clock"),
+}));
+var PxTimelineEngineSchema = px.enum([PxTimelineEngineExtra.auto, PxTimelineEngineExtra.native, PxTimelineEngineExtra.js]).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(),
   trigger: PxTriggerSchema.optional(),
   delay: px.number().optional(),
   iterations: px.union([px.number(), px.literal("infinite")]).optional(),
-  fill: px.enum(["forwards", "backwards", "both", "none"]).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(["forwards", "backwards", "both", "none"]).optional(),
   direction: px.enum(["normal", "reverse", "alternate", "alternate-reverse"]).optional()
-});
+}));
 var scrollishTimelineShape = {
   // §2.8: duration is a property of the TIMELINE — under scrubbing it is the keyframe
   // span the scroll range maps onto.
@@ -1512,7 +1919,8 @@ var scrollishTimelineShape = {
   // Finite repeat count IS meaningful when scrubbing — the scroll range maps onto
   // duration × iterations (rule D4; `'infinite'` cannot map to a range, so no literal here).
   iterations: px.number().optional(),
-  engine: px.enum(["custom", "native"]).optional(),
+  engine: PxTimelineEngineSchema,
+  frameRate: px.number().optional(),
   axis: px.enum(["block", "inline", "x", "y"]).optional(),
   source: px.enum(["nearest", "root"]).optional(),
   subject: px.string().optional(),
@@ -1522,23 +1930,29 @@ var scrollishTimelineShape = {
   pin: px.union([px.boolean(), PxTimelinePinSchema]).optional(),
   range: PxScrollRangeSchema.optional()
 };
-var PxScrollTimelineSchema = px.object(__spreadValues({ type: px.literal("scroll") }, scrollishTimelineShape));
-var PxViewTimelineSchema = px.object(__spreadValues({ type: px.literal("view") }, scrollishTimelineShape));
+var PxScrollTimelineSchema = implementsInterface()(
+  px.object(__spreadValues({ type: px.literal("scroll") }, scrollishTimelineShape))
+);
+var PxViewTimelineSchema = implementsInterface()(
+  px.object(__spreadValues({ type: px.literal("view") }, scrollishTimelineShape))
+);
 var PxTimelineSchema = px.discriminatedUnion("type", [
-  PxClockTimelineSchema,
+  PxTimeTimelineSchema,
+  // first = the member an absent `type` selects
   PxScrollTimelineSchema,
   PxViewTimelineSchema
 ]);
 var PxAnimatorConfigSchema = implementsInterface()(px.object({
-  mode: px.enum([PxAnimatorMode.auto, PxAnimatorMode.waapi, PxAnimatorMode.frames]).optional(),
-  // (`duration` lives INSIDE `timeline` on the wire — §2.8; the flat field below
-  // exists only on the runtime view, like the rest of the playback dynamics.)
-  frameRate: px.number().optional(),
+  // (`mode`, `duration` and `frameRate` live INSIDE `timeline` on the wire — §2.8; they exist
+  // at this level only on the runtime view, like the rest of the playback dynamics.)
   // THE spelling of "what advances progress" — clock / scroll / view (review §2.1).
   timeline: PxTimelineSchema.optional(),
   definitions: PxDefsSchema.optional(),
   animateById: px.record(PxElementAnimationSchema).optional(),
-  debugInstName: px.string().optional()
+  debugGlobalName: px.string().optional(),
+  // Declared HERE because this is a closed object: an undeclared key would be stripped by
+  // `sanitize` and flagged by strict validation on our own files.
+  version: px.string().optional()
 }));
 var PxBindingSchema = implementsInterface()(px.object({
   id: px.string(),
@@ -1587,7 +2001,7 @@ var PxRepeaterEffectSchema = implementsInterface()(px.object({
   origin: PxAnimatableVec2Schema.optional()
 }));
 var PxMaskedByEffectSchema = implementsInterface()(px.object({
-  sourceId: px.string().optional(),
+  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(),
@@ -1610,9 +2024,10 @@ var PxRetimeEffectSchema = implementsInterface()(px.object({
   timeCrop: px.tuple([px.number(), px.number()]).optional()
 }));
 var PxCloneEffectSchema = implementsInterface()(px.object({
-  // Contextual kind — the `type` convention, see `PxNodeBase.type`.
-  type: px.enum([PxCloneType.content]).optional(),
-  sourceId: px.string().optional(),
+  // Subtractive on purpose: the `<use>` can only point at one wrapper layer of the
+  // source, so the choices form a ladder — 'translate' now, maybe 'transform' later.
+  without: px.enum([PxCloneWithout.translate]).optional(),
+  source: px.string().optional(),
   retime: PxRetimeEffectSchema.optional()
 }));
 var PxGradientStopSchema = implementsInterface()(px.object({
@@ -1639,7 +2054,7 @@ var PxFillGradientEffectSchema = implementsInterface()(px.object({
 }));
 var PxStrokeGradientEffectSchema = PxFillGradientEffectSchema;
 var PxTextPathEffectSchema = implementsInterface()(px.object({
-  path: px.string(),
+  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(),
@@ -1679,16 +2094,33 @@ function validateNodeEffects(root, opts) {
   walk(root, "root");
   return warnings;
 }
+function validateDocument(doc) {
+  const ctx = { errors: [], warnings: [], strict: true };
+  const problems = PxAnimatedSvgDocumentSchema.isValid(doc, ctx, ["root"]) ? [] : [...ctx.errors];
+  if (doc && typeof doc === "object") {
+    for (const w of validateNodeEffects(doc, { strict: true })) {
+      if (!problems.includes(w)) problems.push(w);
+    }
+  }
+  return problems;
+}
 var PxNodeBase = px.openObject({
   // CONVENTION (SCHEMA-DESIGN R1 / issues N4): `type` is the ONE word for "what
   // kind of thing is this", discriminated by its CARRIER — here the node TAG
-  // (`rect`, `text`), and inside a sub-object that object's kind (`clone.type`,
+  // (`rect`, `text`), and inside a sub-object that object's kind (`fillGradient.type`,
   // `fillGradient.type`, editor `preset.type`). Each sits in its own object, so
   // the carrier disambiguates completely; synonyms (`cloneKind`, `presetShape`)
   // would add words that all mean "type" and still need the carrier to read.
   // Guarding a `type` SLOT against a wrong VALUE is the job of strict enums
   // (issues V3), never of distinct key names.
   type: px.string(),
+  // The escape hatch for elements that carry a REAL `type` attribute — `<feTurbulence
+  // type="fractalNoise">`, `<feFuncR type="table">`, `<feColorMatrix type="saturate">`.
+  // `type` is taken by the tag name, so the attribute travels here and the renderer puts
+  // it back (`PxAnimatorDOM.renderNode`, `PxRnRender`). Declared here — not merely
+  // documented — because a wire key that is not in a schema is invisible to the
+  // minifier's reserve list and gets renamed (MINIFICATION-BOUNDARY-PLAN.md §1.1).
+  domType: px.string().optional(),
   id: px.string().optional(),
   meta: px.any().optional(),
   // Player-effects bucket emitted by the Editor's lightweight design format.
@@ -1728,7 +2160,7 @@ function isPxElementFileFormatDeep(fileJson) {
   return { valid, errors: valid ? [] : ["Document failed schema validation"] };
 }
 
-// src/PxIdUtil.ts
+// src/util/PxIdUtil.ts
 var _idCounter = 0;
 function generateUniqueId() {
   const timestamp = Date.now().toString(36);
@@ -1747,7 +2179,7 @@ function deepClone(value) {
   return cloned;
 }
 function generateNewIds(doc) {
-  var _a, _b;
+  var _a2, _b;
   const cloned = deepClone(doc);
   const idMap = /* @__PURE__ */ new Map();
   const hashRefAttrs = /* @__PURE__ */ new Set(["href", "xlink:href"]);
@@ -1765,7 +2197,8 @@ function generateNewIds(doc) {
     "flood-color",
     "lighting-color"
   ]);
-  const directIdRefAttrs = /* @__PURE__ */ new Set(["sourceId", "targetId", "boundElementId"]);
+  const directIdRefAttrs = /* @__PURE__ */ new Set(["targetId", "boundElementId"]);
+  const isEffectSourceRef = (key, parentKey) => key === "source" && (parentKey === "maskedBy" || parentKey === "clone");
   function collectIds(node) {
     if (!node || typeof node !== "object") return;
     if (node.id && typeof node.id === "string") {
@@ -1782,7 +2215,7 @@ function generateNewIds(doc) {
       }
     }
   }
-  function updateRefs(node) {
+  function updateRefs(node, parentKey) {
     if (!node || typeof node !== "object") return;
     for (const [key, value] of Object.entries(node)) {
       if (key === "children") {
@@ -1802,7 +2235,7 @@ function generateNewIds(doc) {
           }
         } else if (urlRefAttrs.has(key)) {
           node[key] = replaceUrlRefs(value, idMap);
-        } else if (directIdRefAttrs.has(key)) {
+        } else if (directIdRefAttrs.has(key) || isEffectSourceRef(key, parentKey)) {
           const hasHash = value.startsWith("#");
           const newId = idMap.get(hasHash ? value.slice(1) : value);
           if (newId) {
@@ -1818,13 +2251,13 @@ function generateNewIds(doc) {
           }
         }
       } else if (typeof value === "object" && value !== null) {
-        updateRefs(value);
+        updateRefs(value, key);
       }
     }
   }
   collectIds(cloned);
   updateRefs(cloned);
-  const docAnimate = (_a = cloned.animator) == null ? void 0 : _a.animateById;
+  const docAnimate = (_a2 = cloned.animator) == null ? void 0 : _a2.animateById;
   if (docAnimate && typeof docAnimate === "object") {
     const updatedAnimate = {};
     for (const [key, anim] of Object.entries(docAnimate)) {
@@ -1844,7 +2277,7 @@ function replaceUrlRefs(value, idMap) {
   });
 }
 
-// src/PxNodeProps.ts
+// src/util/PxNodeProps.ts
 var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
   "script",
   "foreignobject"
@@ -1908,10 +2341,10 @@ function sanitiseAttributeValue(name, value) {
   return value;
 }
 function resolveStyle(style, defs) {
-  var _a;
+  var _a2;
   if (!style) return void 0;
   if (typeof style === "string") {
-    return (_a = defs == null ? void 0 : defs.styles) == null ? void 0 : _a[style];
+    return (_a2 = defs == null ? void 0 : defs.styles) == null ? void 0 : _a2[style];
   }
   return style;
 }
@@ -1926,14 +2359,14 @@ function getNormalizedProps(props) {
       propsCopy[key] = toRGBA(value);
     } else if (key === "transform" && value !== null && typeof value === "object" && !Array.isArray(value) && !value.keyframes) {
       const parts = value.value && typeof value.value === "object" ? value.value : value;
-      propsCopy["transform"] = composeTransformParts(parts, { withUnits: false });
+      propsCopy[TRANSFORM_ATTR] = composeTransformParts(parts, { withUnits: false });
     } else if (TRANSFORM_FN_NAMES.has(key)) {
       if (Array.isArray(value)) {
         if (key === "translate") value = value.map((v) => v + "px");
         value = value.join(",");
       }
       if (key === "rotate") value = value + "deg";
-      propsCopy["transform"] = key + "(" + value + ")";
+      propsCopy[TRANSFORM_ATTR] = key + "(" + value + ")";
     } else if (Array.isArray(value)) {
       propsCopy[key] = value.join(",");
     } else if (value !== void 0 && value !== null) {
@@ -1943,10 +2376,9 @@ function getNormalizedProps(props) {
   return propsCopy;
 }
 
-// src/PxMotionPath.ts
+// src/materialise/PxMotionPath.ts
 function getKfTranslate(kf) {
-  var _a;
-  const v = (_a = kf.value) != null ? _a : kf.v;
+  const v = kfValue(kf);
   if (!v) return void 0;
   if (Array.isArray(v) && v.length >= 2 && typeof v[0] === "number" && typeof v[1] === "number") {
     return [v[0], v[1]];
@@ -1956,31 +2388,27 @@ function getKfTranslate(kf) {
   return void 0;
 }
 function getKfTime(kf) {
-  var _a, _b;
-  return (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
+  return kfTime(kf);
 }
 function getKfEasing(kf) {
-  var _a;
-  return (_a = kf.easing) != null ? _a : kf.e;
+  return kfEasing(kf);
 }
 function propAnimIsMotionPath(anim) {
-  var _a, _b;
   const kfs = anim.keyframes;
   if (!Array.isArray(kfs)) return false;
   if (anim.autoOrient) return true;
   for (const kf of kfs) {
-    if (((_a = kf.tangentIn) != null ? _a : kf.ti) || ((_b = kf.tangentOut) != null ? _b : kf.to)) return true;
+    if (kfTangentIn(kf) || kfTangentOut(kf)) return true;
   }
   return false;
 }
 var _segmentCache = /* @__PURE__ */ new WeakMap();
 function getSegmentCache(prevKf, nextKf, prevPos, nextPos) {
-  var _a, _b;
   let byNext = _segmentCache.get(prevKf);
   const existing = byNext == null ? void 0 : byNext.get(nextKf);
   if (existing) return existing;
-  const to = (_a = prevKf.tangentOut) != null ? _a : prevKf.to;
-  const ti = (_b = nextKf.tangentIn) != null ? _b : nextKf.ti;
+  const to = kfTangentOut(prevKf);
+  const ti = kfTangentIn(nextKf);
   const P1 = [prevPos[0] + (to ? to[0] : 0), prevPos[1] + (to ? to[1] : 0)];
   const P2 = [nextPos[0] + (ti ? ti[0] : 0), nextPos[1] + (ti ? ti[1] : 0)];
   const lut = bezier2D_arcLengthLUT(prevPos, P1, P2, nextPos);
@@ -2030,12 +2458,12 @@ var DEFAULT_FLATNESS_TOL = 0.5;
 var DEFAULT_ROTATION_TOL = 5;
 var DEFAULT_MAX_SAMPLES = 32;
 function materialiseMotionPathInPropAnim(anim, opts) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   if (!propAnimIsMotionPath(anim)) return anim;
   const kfs = anim.keyframes;
   if (!Array.isArray(kfs) || kfs.length < 2) return anim;
   const autoOrient = !!anim.autoOrient;
-  const flatnessTol = (_a = opts == null ? void 0 : opts.flatnessTolerance) != null ? _a : DEFAULT_FLATNESS_TOL;
+  const flatnessTol = (_a2 = opts == null ? void 0 : opts.flatnessTolerance) != null ? _a2 : DEFAULT_FLATNESS_TOL;
   const rotationTol = (_b = opts == null ? void 0 : opts.rotationTolerance) != null ? _b : DEFAULT_ROTATION_TOL;
   const maxSamples = (_c = opts == null ? void 0 : opts.maxSamplesPerSegment) != null ? _c : DEFAULT_MAX_SAMPLES;
   const out = [];
@@ -2071,10 +2499,9 @@ function materialiseMotionPathInPropAnim(anim, opts) {
   return result;
 }
 function unwrapAutoOrientRotations(kfs) {
-  var _a;
   let prev;
   for (const kf of kfs) {
-    const v = (_a = kf.v) != null ? _a : kf.value;
+    const v = kfValue(kf);
     if (!v || typeof v.rotate !== "number") continue;
     if (prev === void 0) {
       prev = v.rotate;
@@ -2091,8 +2518,7 @@ function makeOutKf(time, value) {
   return { t: time, v: value };
 }
 function getKfValueParts(kf) {
-  var _a;
-  const v = (_a = kf.value) != null ? _a : kf.v;
+  const v = kfValue(kf);
   if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
   return v;
 }
@@ -2153,9 +2579,8 @@ function wrappedAngleDelta(a, b) {
   return d;
 }
 function insertSharpCornerStepKfIfNeeded(out, prevKf, nextKf, prevPos, nextPos, rotationTol) {
-  var _a;
   const lastKf = out[out.length - 1];
-  const lastV = (_a = lastKf.v) != null ? _a : lastKf.value;
+  const lastV = kfValue(lastKf);
   const prevExit = lastV == null ? void 0 : lastV.rotate;
   if (typeof prevExit !== "number") return;
   const boundaryV = getKfValueParts(prevKf);
@@ -2336,7 +2761,7 @@ function walkAndMaterialise(node, opts) {
   return cloned;
 }
 
-// src/PxDefinitions.ts
+// src/animation/PxDefinitions.ts
 var LOOP_JUMP_SHIFT_MS = 1;
 function deepEqualValue(a, b) {
   if (a === b) return true;
@@ -2468,21 +2893,21 @@ function normalizePathValue(value) {
   return value;
 }
 function resolveEasing(easing, defs) {
-  var _a;
+  var _a2;
   if (!easing) return void 0;
   if (Array.isArray(easing)) {
     return easing;
   }
-  if ((_a = defs == null ? void 0 : defs.easings) == null ? void 0 : _a[easing]) {
+  if ((_a2 = defs == null ? void 0 : defs.easings) == null ? void 0 : _a2[easing]) {
     return defs.easings[easing];
   }
   console.warn("Unknown easing name: " + easing);
   return void 0;
 }
 function resolveAnimation(animRef, defs) {
-  var _a;
+  var _a2;
   if (typeof animRef === "string") {
-    const resolved = (_a = defs == null ? void 0 : defs.animations) == null ? void 0 : _a[animRef];
+    const resolved = (_a2 = defs == null ? void 0 : defs.animations) == null ? void 0 : _a2[animRef];
     if (!resolved) {
       console.warn("Unknown animation name: " + animRef);
     }
@@ -2507,9 +2932,9 @@ function resolveElementAnimation(animate, defs) {
   return results;
 }
 function interpolateValue(propName, a, b, t) {
-  var _a, _b;
+  var _a2, _b;
   if (propName === "d") {
-    const aPaths = (_a = a == null ? void 0 : a.paths) != null ? _a : Array.isArray(a) ? a : [];
+    const aPaths = (_a2 = a == null ? void 0 : a.paths) != null ? _a2 : Array.isArray(a) ? a : [];
     const bPaths = (_b = b == null ? void 0 : b.paths) != null ? _b : Array.isArray(b) ? b : [];
     return { paths: interpolateBeziers(aPaths, bPaths, t) };
   }
@@ -2545,11 +2970,11 @@ function interpolateTransformParts(a, b, t) {
   return out;
 }
 function expandLoopKeyframes(propName, keyframes, loop, duration) {
-  var _a, _b, _c, _d, _e;
+  var _a2, _b, _c, _d, _e;
   const totalIntervals = keyframes.length - 1;
-  const segCount = clamp((_a = loop.segmentCount) != null ? _a : totalIntervals, 1, totalIntervals);
+  const segCount = clamp((_a2 = loop.segmentCount) != null ? _a2 : totalIntervals, 1, totalIntervals);
   let segKfs;
-  if (loop.extend === PxLoopExtend.before) {
+  if (loop.repeatAt === PxLoopRepeatAt.start) {
     segKfs = keyframes.slice(0, segCount + 1);
   } else {
     segKfs = keyframes.slice(totalIntervals - segCount);
@@ -2557,7 +2982,7 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
   const firstT = (_b = keyframes[0].t) != null ? _b : 0;
   const lastT = (_c = keyframes[keyframes.length - 1].t) != null ? _c : 0;
   let fillStart, fillEnd;
-  if (loop.extend === PxLoopExtend.before) {
+  if (loop.repeatAt === PxLoopRepeatAt.start) {
     fillStart = 0;
     fillEnd = firstT;
   } else {
@@ -2570,26 +2995,23 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
   const segEndT = (_e = segKfs[segKfs.length - 1].t) != null ? _e : 0;
   const segDuration = segEndT - segStartT;
   if (segDuration <= 0) return keyframes;
-  const template = segKfs.map((kf) => {
-    var _a2, _b2;
-    return {
-      relT: (kf.t - segStartT) / segDuration,
-      v: kf.v,
-      e: kf.e,
-      tangentIn: (_a2 = kf.tangentIn) != null ? _a2 : kf.ti,
-      tangentOut: (_b2 = kf.tangentOut) != null ? _b2 : kf.to
-    };
-  });
+  const template = segKfs.map((kf) => ({
+    relT: (kf.t - segStartT) / segDuration,
+    v: kf.v,
+    e: kf.e,
+    tangentIn: kfTangentIn(kf),
+    tangentOut: kfTangentOut(kf)
+  }));
   const fullReps = Math.floor(fillDuration / segDuration);
   const remainder = fillDuration - fullReps * segDuration;
   const partialFraction = remainder / segDuration;
   const looped = [];
-  const separateBoundary = loop.extend !== PxLoopExtend.before;
+  const separateBoundary = loop.repeatAt !== PxLoopRepeatAt.start;
   const originalTerminalKf = keyframes[keyframes.length - 1];
   let terminalEasingOverride;
   let hasTerminalEasingOverride = false;
   function appendRep(repStart, isReversed, partial) {
-    var _a2;
+    var _a3;
     let entries;
     if (isReversed) {
       entries = [];
@@ -2626,7 +3048,7 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
         return;
       }
       const prevKf = looped.length > 0 ? looped[looped.length - 1] : originalTerminalKf;
-      const isBoundary = separateBoundary && i === 0 && prevKf !== void 0 && Math.abs(((_a2 = prevKf.t) != null ? _a2 : 0) - (repStart + entry.relT * segDuration)) < 1e-9;
+      const isBoundary = separateBoundary && i === 0 && prevKf !== void 0 && Math.abs(((_a3 = prevKf.t) != null ? _a3 : 0) - (repStart + entry.relT * segDuration)) < 1e-9;
       if (isBoundary) {
         if (deepEqualValue(prevKf.v, entry.v)) {
           if (looped.length > 0) {
@@ -2692,30 +3114,30 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
       looped.push(pushed);
     }
   }
-  if (loop.extend === PxLoopExtend.before) {
+  if (loop.repeatAt === PxLoopRepeatAt.start) {
     if (partialFraction > 1e-9) {
-      const isReversed = !!loop.alternate && fullReps % 2 === 0;
+      const isReversed = loop.direction === PxLoopDirection.alternate && fullReps % 2 === 0;
       appendRepTail(fillStart, isReversed, partialFraction);
     }
     for (let rep = 0; rep < fullReps; rep++) {
       const distFromBoundary = fullReps - 1 - rep;
-      const isReversed = !!loop.alternate && distFromBoundary % 2 === 0;
+      const isReversed = loop.direction === PxLoopDirection.alternate && distFromBoundary % 2 === 0;
       const repStart = fillStart + remainder + rep * segDuration;
       appendRep(repStart, isReversed);
     }
   } else {
     for (let rep = 0; rep < fullReps; rep++) {
-      const isReversed = !!loop.alternate && rep % 2 === 0;
+      const isReversed = loop.direction === PxLoopDirection.alternate && rep % 2 === 0;
       const repStart = fillStart + rep * segDuration;
       appendRep(repStart, isReversed);
     }
     if (partialFraction > 1e-9) {
-      const isReversed = !!loop.alternate && fullReps % 2 === 0;
+      const isReversed = loop.direction === PxLoopDirection.alternate && fullReps % 2 === 0;
       const repStart = fillStart + fullReps * segDuration;
       appendRep(repStart, isReversed, partialFraction);
     }
   }
-  if (loop.extend === PxLoopExtend.before) {
+  if (loop.repeatAt === PxLoopRepeatAt.start) {
     return [...looped, ...keyframes];
   } else {
     if (hasTerminalEasingOverride && keyframes.length > 0) {
@@ -2727,34 +3149,34 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
   }
 }
 function normalizeKeyframes(propName, propAnim, duration, defs) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a2;
   const keyframes = propAnim.keyframes || [];
   const normalized = [];
   for (const kf of keyframes) {
-    const timePct = (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
-    let value = (_c = kf.value) != null ? _c : kf.v;
-    const easing = (_d = kf.easing) != null ? _d : kf.e;
+    const timePct = kfTime(kf);
+    let value = kfValue(kf);
+    const easing = kfEasing(kf);
     if (propName === "d") {
       value = normalizePathValue(value);
     }
     const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
     if (COLOUR_ATTR_NAMES.has(propNameKebab)) {
-      value = (_e = parseColor(value)) != null ? _e : value;
+      value = (_a2 = parseColor(value)) != null ? _a2 : value;
     }
     const normKf = {
       t: timePct,
       v: value,
       e: resolveEasing(easing, defs)
     };
-    const tIn = (_f = kf.tangentIn) != null ? _f : kf.ti;
-    const tOut = (_g = kf.tangentOut) != null ? _g : kf.to;
+    const tIn = kfTangentIn(kf);
+    const tOut = kfTangentOut(kf);
     if (tIn) normKf.tangentIn = tIn;
     if (tOut) normKf.tangentOut = tOut;
     normalized.push(normKf);
   }
   normalized.sort((a, b) => {
-    var _a2, _b2;
-    return ((_a2 = a.t) != null ? _a2 : 0) - ((_b2 = b.t) != null ? _b2 : 0);
+    var _a3, _b;
+    return ((_a3 = a.t) != null ? _a3 : 0) - ((_b = b.t) != null ? _b : 0);
   });
   const loopRaw = propAnim.loop;
   const loop = loopRaw === true ? {} : loopRaw || void 0;
@@ -2781,15 +3203,17 @@ function materialiseInternalLoopsInPropAnim(propName, propAnim, duration) {
   const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
   const isColour = COLOUR_ATTR_NAMES.has(propNameKebab);
   const kfs = rawKfs.map((kf) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    const t = (_a = kf.t) != null ? _a : kf.time;
-    let v = (_b = kf.v) != null ? _b : kf.value;
+    var _a2;
+    const t = kfTime(kf);
+    let v = kfValue(kf);
     if (propName === "d") v = normalizePathValue(v);
-    if (isColour) v = (_c = parseColor(v)) != null ? _c : v;
-    const e = (_d = kf.e) != null ? _d : kf.easing;
+    if (isColour) v = (_a2 = parseColor(v)) != null ? _a2 : v;
+    const e = kfEasing(kf);
     const out2 = { t, v, e };
-    if ((_e = kf.tangentIn) != null ? _e : kf.ti) out2.tangentIn = (_f = kf.tangentIn) != null ? _f : kf.ti;
-    if ((_g = kf.tangentOut) != null ? _g : kf.to) out2.tangentOut = (_h = kf.tangentOut) != null ? _h : kf.to;
+    const tIn = kfTangentIn(kf);
+    const tOut = kfTangentOut(kf);
+    if (tIn) out2.tangentIn = tIn;
+    if (tOut) out2.tangentOut = tOut;
     return out2;
   });
   const expanded = expandLoopKeyframes(propName, kfs, loop, duration);
@@ -2840,7 +3264,7 @@ function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
   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"];
+  const transformAnim = animDef[TRANSFORM_ATTR];
   if (transformAnim && typeof transformAnim === "object") {
     const anim = transformAnim;
     if (Array.isArray(anim.keyframes)) {
@@ -2865,7 +3289,7 @@ function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
   delete rest[ch];
   return __spreadProps(__spreadValues({}, rest), { transform: lifted });
 }
-function normalizeAnimationDefinition(animDef, duration, defs, engine = PxAnimatorEngine.waapi) {
+function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimelineEngine.native) {
   const normalized = {};
   for (const [propName, propAnim] of Object.entries(animDef)) {
     if (propName === "transform" && propAnim.alongPathMode === "offsetPath" && animDef["offsetDistance"] !== void 0) {
@@ -2876,12 +3300,12 @@ function normalizeAnimationDefinition(animDef, duration, defs, engine = PxAnimat
       const out = { keyframes: normalizedKfs };
       if (propAnim.autoOrient !== void 0) out.autoOrient = propAnim.autoOrient;
       if (propAnim.loop !== void 0) out.loop = propAnim.loop;
-      normalized[propName] = engine === PxAnimatorEngine.waapi && propName === "transform" ? materialiseMotionPathInPropAnim(out) : out;
+      normalized[propName] = engine === PxTimelineEngine.native && propName === "transform" ? materialiseMotionPathInPropAnim(out) : out;
     }
   }
   return normalized;
 }
-function getNormalisedBindings(doc, engine = PxAnimatorEngine.waapi) {
+function getNormalisedBindings(doc, engine = PxTimelineEngine.native) {
   const animatorConfig = getAnimatorConfig(doc) || {};
   const defs = getDefs(doc);
   const duration = animatorConfig.duration || 1e3;
@@ -2927,12 +3351,12 @@ function getNormalisedBindings(doc, engine = PxAnimatorEngine.waapi) {
   return bindings;
 }
 function getKeyframesPair(keyframes, progress) {
-  var _a, _b;
+  var _a2, _b;
   const last = keyframes.length - 1;
   let prevKf = keyframes[0];
   let nextKf = keyframes[last > 0 ? 1 : 0];
   for (let j = 0; j < last; j++) {
-    const aOff = (_a = keyframes[j].t) != null ? _a : 0;
+    const aOff = (_a2 = keyframes[j].t) != null ? _a2 : 0;
     const bOff = (_b = keyframes[j + 1].t) != null ? _b : 0;
     if (aOff <= progress && progress <= bOff) {
       prevKf = keyframes[j];
@@ -2947,13 +3371,13 @@ function getKeyframesPair(keyframes, progress) {
   return { prevKf, nextKf };
 }
 function calcPropertyValue(propName, propAnim, progress) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a2, _b, _c, _d;
   const keyframes = propAnim.keyframes || [];
   if (keyframes.length === 0) return null;
   const { prevKf, nextKf } = getKeyframesPair(keyframes, progress);
-  let localProgress = prevKf === nextKf ? 0 : remap(progress, (_a = prevKf.t) != null ? _a : 0, (_b = nextKf.t) != null ? _b : 0, 0, 1);
+  let localProgress = prevKf === nextKf ? 0 : remap(progress, (_a2 = prevKf.t) != null ? _a2 : 0, (_b = nextKf.t) != null ? _b : 0, 0, 1);
   localProgress = clamp(localProgress, 0, 1);
-  const easing = (_c = prevKf.e) != null ? _c : prevKf.easing;
+  const easing = kfEasing(prevKf);
   if (easing && Array.isArray(easing)) {
     try {
       localProgress = cubicBezier(easing)(localProgress);
@@ -2962,11 +3386,11 @@ function calcPropertyValue(propName, propAnim, progress) {
   }
   let cssAttrName = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
   let cssValue = null;
-  const prevV = (_d = prevKf == null ? void 0 : prevKf.v) != null ? _d : prevKf == null ? void 0 : prevKf.value;
-  const nextV = (_e = nextKf == null ? void 0 : nextKf.v) != null ? _e : nextKf == null ? void 0 : nextKf.value;
+  const prevV = prevKf == null ? void 0 : prevKf.v;
+  const nextV = nextKf == null ? void 0 : nextKf.v;
   if (cssAttrName === "d") {
-    const prevPaths = (_f = prevV == null ? void 0 : prevV.paths) != null ? _f : Array.isArray(prevV) ? prevV : [];
-    const nextPaths = (_g = nextV == null ? void 0 : nextV.paths) != null ? _g : Array.isArray(nextV) ? nextV : [];
+    const prevPaths = (_c = prevV == null ? void 0 : prevV.paths) != null ? _c : Array.isArray(prevV) ? prevV : [];
+    const nextPaths = (_d = nextV == null ? void 0 : nextV.paths) != null ? _d : Array.isArray(nextV) ? nextV : [];
     cssValue = interpolateBeziers(
       prevPaths,
       nextPaths,
@@ -3069,7 +3493,7 @@ function calcAnimationValues(animDef, progress) {
   return result;
 }
 
-// src/PxNodeCloneUtil.ts
+// src/util/PxNodeCloneUtil.ts
 function deepClonePxNode(value) {
   if (value === null || typeof value !== "object") return value;
   if (Array.isArray(value)) return value.map(deepClonePxNode);
@@ -3080,13 +3504,13 @@ function deepClonePxNode(value) {
 function regenerateIdsAndRewriteRefs(root, genId3) {
   const oldToNew = /* @__PURE__ */ new Map();
   const walkAssign = (n) => {
-    var _a;
+    var _a2;
     if (typeof n.id === "string") {
       const newId = genId3();
       oldToNew.set(n.id, newId);
       n.id = newId;
     }
-    (_a = n.children) == null ? void 0 : _a.forEach(walkAssign);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkAssign);
   };
   walkAssign(root);
   const rewriteUrl = (s) => s.replace(/url\(#([^)]+)\)/g, (m, oldId) => {
@@ -3094,7 +3518,7 @@ function regenerateIdsAndRewriteRefs(root, genId3) {
     return newId ? "url(#" + newId + ")" : m;
   });
   const walkRewrite = (n) => {
-    var _a;
+    var _a2;
     if (typeof n.href === "string" && n.href.startsWith("#")) {
       const newId = oldToNew.get(n.href.slice(1));
       if (newId) n.href = "#" + newId;
@@ -3106,7 +3530,7 @@ function regenerateIdsAndRewriteRefs(root, genId3) {
         n[k] = rewriteUrl(v);
       }
     }
-    (_a = n.children) == null ? void 0 : _a.forEach(walkRewrite);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkRewrite);
   };
   walkRewrite(root);
   return oldToNew;
@@ -3116,7 +3540,7 @@ function toFiniteNum(v) {
   return Number.isFinite(n) ? n : 0;
 }
 function applyUseOffsetToG(gNode) {
-  var _a;
+  var _a2;
   const x = toFiniteNum(gNode.x);
   const y = toFiniteNum(gNode.y);
   delete gNode.x;
@@ -3125,7 +3549,7 @@ function applyUseOffsetToG(gNode) {
   const offset = "translate(" + x + "," + y + ")";
   const carriesTransform = gNode.transform !== void 0 || gNode.animate !== void 0;
   if (carriesTransform) {
-    const inner = { type: "g", transform: offset, children: (_a = gNode.children) != null ? _a : [] };
+    const inner = { type: "g", transform: offset, children: (_a2 = gNode.children) != null ? _a2 : [] };
     gNode.children = [inner];
   } else {
     gNode.transform = offset;
@@ -3133,9 +3557,9 @@ function applyUseOffsetToG(gNode) {
   return gNode;
 }
 
-// src/PxAnimatorUseMaterialiser.ts
+// src/materialise/PxAnimatorUseMaterialiser.ts
 function materialiseAnimatedUseInstances(root) {
-  var _a;
+  var _a2;
   const idMap = buildIdMap(root);
   const animatedIds = computeAnimatedSubtreeIds(root, idMap);
   if (animatedIds.size === 0) return root;
@@ -3146,7 +3570,7 @@ function materialiseAnimatedUseInstances(root) {
   const walked = walkAndMaterialise2(root, idMap, animatedIds, genId3, defsCollector, rootViewport);
   if (defsCollector.length === 0) return walked;
   const defsNode = { type: "defs", children: defsCollector };
-  const newChildren = [...(_a = walked.children) != null ? _a : [], defsNode];
+  const newChildren = [...(_a2 = walked.children) != null ? _a2 : [], defsNode];
   return __spreadProps(__spreadValues({}, walked), { children: newChildren });
 }
 function readRootViewport(root) {
@@ -3168,9 +3592,9 @@ function numericAttr(v) {
 function buildIdMap(root) {
   const map = /* @__PURE__ */ new Map();
   const visit = (n) => {
-    var _a;
+    var _a2;
     if (typeof n.id === "string") map.set(n.id, n);
-    (_a = n.children) == null ? void 0 : _a.forEach(visit);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(visit);
   };
   visit(root);
   return map;
@@ -3217,11 +3641,11 @@ function stripHash(href) {
   return href.startsWith("#") ? href.slice(1) : href;
 }
 function materialiseOneUse(useNode, target, idMap, animatedIds, genId3, defsCollector, rootViewport) {
-  var _a, _b, _c, _d;
+  var _a2, _b, _c, _d;
   const clone2 = deepClonePxNode(target);
   regenerateIdsAndRewriteRefs(clone2, genId3);
   const symbolViewBox = clone2.type === "symbol" ? parseViewBox(clone2.viewBox) : void 0;
-  const useW = (_b = (_a = numericAttr(useNode.width)) != null ? _a : symbolViewBox == null ? void 0 : symbolViewBox[2]) != null ? _b : rootViewport[0];
+  const useW = (_b = (_a2 = numericAttr(useNode.width)) != null ? _a2 : symbolViewBox == null ? void 0 : symbolViewBox[2]) != null ? _b : rootViewport[0];
   const useH = (_d = (_c = numericAttr(useNode.height)) != null ? _c : symbolViewBox == null ? void 0 : symbolViewBox[3]) != null ? _d : rootViewport[1];
   const rewrittenClone = clone2.type === "symbol" ? rewriteSymbolRootToGroup(clone2, genId3, defsCollector, useW, useH) : clone2;
   const materialisedClone = walkAndMaterialise2(rewrittenClone, idMap, animatedIds, genId3, defsCollector, rootViewport);
@@ -3281,7 +3705,7 @@ function walkAndMaterialise2(node, idMap, animatedIds, genId3, defsCollector, ro
   return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
 }
 
-// src/effects/transformParts.ts
+// src/effects/shared/transformParts.ts
 function partsRecord(part, value, origin) {
   const rec = {};
   if (part === "translate" /* Translate */) rec.translate = value;
@@ -3292,25 +3716,25 @@ function partsRecord(part, value, origin) {
   return rec;
 }
 function readAnimatable(raw) {
-  var _a, _b, _c;
+  var _a2, _b;
   if (raw === void 0) return { kind: "absent" /* Absent */ };
   if (Array.isArray(raw)) return { kind: "static" /* Static */, value: raw };
   if (typeof raw === "object") {
     const obj = raw;
-    const kfs = (_a = obj.keyframes) != null ? _a : obj.kfs;
+    const kfs = obj.keyframes;
     if (kfs) {
       const out = { kind: "animated" /* Animated */, keyframes: kfs.map(normaliseKeyframe), autoOrient: obj.autoOrient, loop: obj.loop };
-      const base = (_b = obj.value) != null ? _b : obj.v;
+      const base = (_a2 = obj.value) != null ? _a2 : obj.v;
       if (base !== void 0 && out.kind === "animated" /* Animated */) out.base = base;
       return out;
     }
-    const staticValue = (_c = obj.value) != null ? _c : obj.v;
+    const staticValue = (_b = obj.value) != null ? _b : obj.v;
     if (staticValue !== void 0) return { kind: "static" /* Static */, value: staticValue };
   }
   return { kind: "static" /* Static */, value: raw };
 }
 function writeAnimatableChannel(node, attrName, read, opts) {
-  var _a, _b, _c, _d;
+  var _a2, _b, _c, _d;
   const toOut = (v) => (opts == null ? void 0 : opts.asString) && v !== void 0 && v !== null ? String(v) : v;
   if (read.kind === "absent" /* Absent */) return;
   if (read.kind === "static" /* Static */) {
@@ -3324,7 +3748,7 @@ function writeAnimatableChannel(node, attrName, read, opts) {
   if (read.autoOrient !== void 0) block.autoOrient = read.autoOrient;
   animate[attrName] = block;
   node.animate = animate;
-  const baseline = (_d = (_b = read.base) != null ? _b : (_a = read.keyframes[0]) == null ? void 0 : _a.value) != null ? _d : (_c = read.keyframes[0]) == null ? void 0 : _c.v;
+  const baseline = (_d = (_b = read.base) != null ? _b : (_a2 = read.keyframes[0]) == null ? void 0 : _a2.value) != null ? _d : (_c = read.keyframes[0]) == null ? void 0 : _c.v;
   if (baseline !== void 0) node[attrName] = toOut(baseline);
 }
 function normaliseKeyframe(kf) {
@@ -3342,12 +3766,12 @@ function normaliseKeyframe(kf) {
   return out;
 }
 function readStaticOrigin(raw, ctx) {
-  var _a;
+  var _a2;
   const o = readAnimatable(raw);
   if (o.kind === "absent" /* Absent */) return void 0;
   if (o.kind === "static" /* Static */) return o.value;
   ctx.warnings.push("transformBy.origin: animated origin approximated by its first keyframe");
-  return (_a = o.keyframes[0]) == null ? void 0 : _a.value;
+  return (_a2 = o.keyframes[0]) == null ? void 0 : _a2.value;
 }
 function keyframeWith(kf, value) {
   const out = { value };
@@ -3358,7 +3782,7 @@ function keyframeWith(kf, value) {
   return out;
 }
 
-// src/effects/transformationEffect.ts
+// src/effects/transform/transformationEffect.ts
 function applyTransformByEffect(node, fx, ctx) {
   if (!fx) return node;
   delete node.transform;
@@ -3449,7 +3873,7 @@ function wrapOrigin(inner, raw, invert) {
   return inner;
 }
 
-// src/effects/util.ts
+// src/effects/shared/util.ts
 function genId(ctx, prefix) {
   return "_lw_" + prefix + "_" + ctx.nextId++;
 }
@@ -3457,9 +3881,9 @@ function stripHash2(href) {
   return typeof href === "string" ? href.replace(/^#/, "") : void 0;
 }
 function indexById(node, map) {
-  var _a;
+  var _a2;
   if (typeof node.id === "string") map.set(node.id, node);
-  (_a = node.children) == null ? void 0 : _a.forEach((child) => indexById(child, map));
+  (_a2 = node.children) == null ? void 0 : _a2.forEach((child) => indexById(child, map));
 }
 function spliceDefs(root, defs) {
   if (!defs.length) return;
@@ -3471,11 +3895,11 @@ function regenerateIdsInClone(root, ctx) {
   return regenerateIdsAndRewriteRefs(root, () => genId(ctx, "retimed"));
 }
 
-// src/effects/contentRefSplit.ts
+// src/effects/reference/contentRefSplit.ts
 function identifyContentRefTargets(node, ctx, allocator) {
-  var _a, _b, _c;
-  if (node.type === "use" && ((_b = (_a = node.effects) == null ? void 0 : _a.clone) == null ? void 0 : _b.type) === "content") {
-    const sourceId = stripHash2(node.effects.clone.sourceId);
+  var _a2, _b, _c;
+  if (node.type === "use" && ((_b = (_a2 = node.effects) == null ? void 0 : _a2.clone) == null ? void 0 : _b.without) === "translate") {
+    const sourceId = stripHash2(node.effects.clone.source);
     if (typeof sourceId === "string" && sourceId && !ctx.contentRefInnerIds.has(sourceId)) {
       ctx.contentRefInnerIds.set(sourceId, allocator(sourceId));
     }
@@ -3500,10 +3924,10 @@ function splitForContentRef(node, transformBy, originalId, innerId, ctx) {
   return outerWrapper;
 }
 function liftBodyTranslate(node, transformBy) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   const out = {};
   let didLiftAnimate = false;
-  const animTr = (_a = node.animate) == null ? void 0 : _a.transform;
+  const animTr = (_a2 = node.animate) == null ? void 0 : _a2.transform;
   if (animTr && typeof animTr === "object" && Array.isArray(animTr.keyframes)) {
     const kfs = animTr.keyframes;
     const hasTranslate = kfs.some((kf) => kf.value && kf.value.translate);
@@ -3686,7 +4110,7 @@ function needsOriginOnOuter(translateAnim) {
   return false;
 }
 
-// src/effects/gradientEffect.ts
+// src/effects/paint/gradientEffect.ts
 function applyFillGradientEffect(node, fx, ctx) {
   return applyGradient(node, fx, ctx, "fill");
 }
@@ -3721,7 +4145,7 @@ function synthesiseGradientDef(fx, id, ctx) {
   return out;
 }
 function applyGeomVec(out, xAttr, yAttr, raw) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   const read = readAnimatable(raw);
   if (read.kind === "absent" /* Absent */) return;
   if (read.kind === "static" /* Static */) {
@@ -3740,7 +4164,7 @@ function applyGeomVec(out, xAttr, yAttr, raw) {
     if (read.loop !== void 0) block.loop = read.loop;
     return block;
   };
-  const animate = (_a = out.animate) != null ? _a : {};
+  const animate = (_a2 = out.animate) != null ? _a2 : {};
   animate[xAttr] = axisChannel(0);
   animate[yAttr] = axisChannel(1);
   out.animate = animate;
@@ -3756,7 +4180,7 @@ function applyGeomNumber(out, attrName, raw) {
   writeAnimatableChannel(out, attrName, read, { asString: true });
 }
 function buildStopChildren(stops, ctx) {
-  var _a, _b, _c, _d;
+  var _a2, _b;
   if (!stops) return [];
   const read = readAnimatable(stops);
   if (read.kind === "absent" /* Absent */) return [];
@@ -3766,14 +4190,14 @@ function buildStopChildren(stops, ctx) {
   const loopFromSource = read.loop;
   let stopCount = 0;
   for (const kf of kfs) {
-    const v = (_a = kf.value) != null ? _a : kf.v;
+    const v = kfValue(kf);
     if (Array.isArray(v) && v.length > stopCount) stopCount = v.length;
   }
   if (!stopCount) return [];
-  const firstKfValue = (_b = kfs[0].value) != null ? _b : kfs[0].v;
+  const firstKfValue = kfValue(kfs[0]);
   const baselineStops = [];
   for (let i = 0; i < stopCount; i++) {
-    const s = (_d = (_c = firstKfValue == null ? void 0 : firstKfValue[i]) != null ? _c : prevDefinedStop(kfs, 0, i)) != null ? _d : { offset: i / Math.max(1, stopCount - 1), color: "#000000" };
+    const s = (_b = (_a2 = firstKfValue == null ? void 0 : firstKfValue[i]) != null ? _a2 : prevDefinedStop(kfs, 0, i)) != null ? _b : { offset: i / Math.max(1, stopCount - 1), color: "#000000" };
     baselineStops.push({ offset: s.offset, color: s.color });
   }
   return baselineStops.map((bs, i) => animatedStopNode(bs, kfs, i, ctx, loopFromSource));
@@ -3786,16 +4210,16 @@ function staticStopNode(s) {
   };
 }
 function animatedStopNode(baseline, kfs, stopIdx, _ctx, loop) {
-  var _a, _b, _c, _d, _e;
+  var _a2;
   const colorKfs = [];
   const offsetKfs = [];
   let offsetVaries = false;
   for (const kf of kfs) {
-    const t = (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
-    const arr = (_c = kf.value) != null ? _c : kf.v;
-    const sliced = (_d = arr == null ? void 0 : arr[stopIdx]) != null ? _d : prevDefinedStop(kfs, kfs.indexOf(kf), stopIdx);
+    const t = kfTime(kf);
+    const arr = kfValue(kf);
+    const sliced = (_a2 = arr == null ? void 0 : arr[stopIdx]) != null ? _a2 : prevDefinedStop(kfs, kfs.indexOf(kf), stopIdx);
     if (!sliced) continue;
-    const easing = (_e = kf.easing) != null ? _e : kf.e;
+    const easing = kfEasing(kf);
     const colorOut = { time: t, value: sliced.color };
     if (easing !== void 0) colorOut.easing = easing;
     colorKfs.push(colorOut);
@@ -3822,13 +4246,12 @@ function animatedStopNode(baseline, kfs, stopIdx, _ctx, loop) {
   return stop;
 }
 function prevDefinedStop(kfs, fromIdx, stopIdx) {
-  var _a, _b;
   for (let i = fromIdx; i >= 0; i--) {
-    const arr = (_a = kfs[i].value) != null ? _a : kfs[i].v;
+    const arr = kfValue(kfs[i]);
     if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
   }
   for (let i = fromIdx + 1; i < kfs.length; i++) {
-    const arr = (_b = kfs[i].value) != null ? _b : kfs[i].v;
+    const arr = kfValue(kfs[i]);
     if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
   }
   return void 0;
@@ -3838,7 +4261,7 @@ function formatOffset(o) {
   return pct + "%";
 }
 
-// src/effects/clipPathEffect.ts
+// src/effects/clipping/clipPathEffect.ts
 function applyClipPathEffect(node, fx, ctx) {
   if (!(fx == null ? void 0 : fx.d)) return node;
   const clipId = genId(ctx, "clip");
@@ -3862,12 +4285,12 @@ function pathString(v) {
   return void 0;
 }
 
-// src/effects/maskedByEffect.ts
+// src/effects/clipping/maskedByEffect.ts
 function applyMaskedByEffect(node, fx, transformBy, ctx) {
   if (!fx) return node;
-  const sourceId = stripHash2(fx.sourceId);
+  const sourceId = stripHash2(fx.source);
   if (!sourceId) {
-    ctx.errors.push("maskedBy.sourceId missing \u2014 cannot build mask");
+    ctx.errors.push("maskedBy.source missing \u2014 cannot build mask");
     return node;
   }
   const maskId = genId(ctx, "mask");
@@ -3930,16 +4353,16 @@ function invertPartValue(part, value) {
   return [1 / value[0], 1 / value[1]];
 }
 function negatedSpatialTangents(kf) {
-  var _a, _b;
+  var _a2, _b;
   const out = {};
-  const to = (_a = kf.tangentOut) != null ? _a : kf.to;
+  const to = (_a2 = kf.tangentOut) != null ? _a2 : kf.to;
   const ti = (_b = kf.tangentIn) != null ? _b : kf.ti;
   if (Array.isArray(to)) out.tangentOut = [-to[0], -to[1]];
   if (Array.isArray(ti)) out.tangentIn = [-ti[0], -ti[1]];
   return out;
 }
 function wrapInverseAnimatedBodyTransform(inner, node, _ctx) {
-  var _a;
+  var _a2;
   const animate = node.animate && typeof node.animate === "object" && !Array.isArray(node.animate) ? node.animate : void 0;
   const animTr = animate == null ? void 0 : animate.transform;
   const kfs = animTr && typeof animTr === "object" && Array.isArray(animTr.keyframes) ? animTr.keyframes : void 0;
@@ -3948,7 +4371,7 @@ function wrapInverseAnimatedBodyTransform(inner, node, _ctx) {
   const rotateKfs = [];
   const scaleKfs = [];
   for (const kf of kfs) {
-    const v = ((_a = kf.value) != null ? _a : kf.v) || {};
+    const v = ((_a2 = kf.value) != null ? _a2 : kf.v) || {};
     const baseKf = keyframeWith(kf, void 0);
     if (Array.isArray(v.translate)) {
       translateKfs.push(__spreadProps(__spreadValues(__spreadValues({}, baseKf), negatedSpatialTangents(kf)), { value: { translate: [-v.translate[0], -v.translate[1]] } }));
@@ -4012,7 +4435,7 @@ function readTransformationFromBody(node) {
   return void 0;
 }
 function parseTransformStringToParts(s) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const re = /([a-zA-Z]+)\s*\(([^)]*)\)/g;
   let m;
   const ops = [];
@@ -4026,7 +4449,7 @@ function parseTransformStringToParts(s) {
     for (let j = ops.length - 2; j >= 0; j--) {
       const cand = ops[j];
       if (cand.name !== "translate") continue;
-      const ox = (_a = cand.args[0]) != null ? _a : 0;
+      const ox = (_a2 = cand.args[0]) != null ? _a2 : 0;
       const oy = (_b = cand.args[1]) != null ? _b : 0;
       const lx = (_c = last.args[0]) != null ? _c : 0;
       const ly = (_d = last.args[1]) != null ? _d : 0;
@@ -4141,8 +4564,8 @@ function interpKfs(kfs, t) {
 function collectMaskAncestorChains(root, ctx) {
   const interestingNodes = /* @__PURE__ */ new Set();
   const collectInterestingNodes = (n) => {
-    var _a, _b;
-    const maskSourceId = stripHash2((_b = (_a = n.effects) == null ? void 0 : _a.maskedBy) == null ? void 0 : _b.sourceId);
+    var _a2, _b;
+    const maskSourceId = stripHash2((_b = (_a2 = n.effects) == null ? void 0 : _a2.maskedBy) == null ? void 0 : _b.source);
     if (typeof maskSourceId === "string") {
       interestingNodes.add(n);
       const sourceNode = ctx.idMap.get(maskSourceId);
@@ -4163,7 +4586,7 @@ function collectMaskAncestorChains(root, ctx) {
   walk(root, []);
 }
 function extractTranslateOnly(node, ctx) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   const tr = node.transform;
   const animateBlock = node.animate && typeof node.animate === "object" && !Array.isArray(node.animate) ? node.animate.transform : void 0;
   if (tr === void 0 && !animateBlock) return void 0;
@@ -4171,7 +4594,7 @@ function extractTranslateOnly(node, ctx) {
   if (typeof tr === "string") {
     const parts = parseTranslateOnlyFromString(tr, ctx);
     if (parts) out.translate = parts;
-  } else if (tr && typeof tr === "object" && !tr.keyframes && !tr.kfs) {
+  } else if (tr && typeof tr === "object" && !tr.keyframes) {
     const wrapped = tr.value;
     const value = wrapped && typeof wrapped === "object" ? wrapped : tr;
     if (value && typeof value === "object" && Array.isArray(value.translate)) {
@@ -4185,7 +4608,7 @@ function extractTranslateOnly(node, ctx) {
     const kfs = animateBlock.keyframes;
     const translateKfs = [];
     for (const kf of kfs) {
-      const v = (_a = kf.value) != null ? _a : kf.v;
+      const v = (_a2 = kf.value) != null ? _a2 : kf.v;
       const t = (_c = (_b = kf.time) != null ? _b : kf.t) != null ? _c : 0;
       if (v && typeof v === "object" && Array.isArray(v.translate)) {
         translateKfs.push({ time: t, value: [v.translate[0] || 0, v.translate[1] || 0] });
@@ -4219,16 +4642,15 @@ function parseTranslateOnlyFromString(s, ctx) {
   return seen ? [x, y] : void 0;
 }
 
-// src/effects/refEffect.ts
-var CONTENT_SUBREF = "content";
+// src/effects/reference/refEffect.ts
 function applyRefHref(node, clone2, ctx) {
   if (!clone2) return;
-  const sourceId = stripHash2(clone2.sourceId);
+  const sourceId = stripHash2(clone2.source);
   if (!sourceId) {
-    if (clone2.type === CONTENT_SUBREF) ctx.errors.push("clone: content ref missing sourceId");
+    if (clone2.without === PxCloneWithout.translate) ctx.errors.push("clone: content ref missing `source`");
     return;
   }
-  const targetId = clone2.type === CONTENT_SUBREF ? ctx.contentRefInnerIds.get(sourceId) || sourceId : sourceId;
+  const targetId = clone2.without === PxCloneWithout.translate ? ctx.contentRefInnerIds.get(sourceId) || sourceId : sourceId;
   node.href = "#" + targetId;
 }
 function applyRefAndTransformationEffect(node, clone2, transformBy, ctx) {
@@ -4236,11 +4658,11 @@ function applyRefAndTransformationEffect(node, clone2, transformBy, ctx) {
   return applyTransformByEffect(node, transformBy, ctx);
 }
 
-// src/effects/repeaterEffect.ts
+// src/effects/transform/repeaterEffect.ts
 function applyRepeaterEffect(node, fx, ctx) {
-  var _a, _b;
+  var _a2, _b;
   if (!fx) return node;
-  const copies = (_a = fx.copies) != null ? _a : 1;
+  const copies = (_a2 = fx.copies) != null ? _a2 : 1;
   if (copies < 1) {
     ctx.errors.push("repeater.copies invalid: " + fx.copies);
     return node;
@@ -4307,11 +4729,11 @@ function synthesiseScale(raw, i) {
   return mapAnimatable(raw, scalePower, true);
 }
 
-// src/effects/retimeEffect.ts
+// src/effects/reference/retimeEffect.ts
 var RETIME_MATERIALISATION_MODE_INLINE_G = false;
 function asRetime(r) {
-  var _a, _b;
-  return { start: (_a = r.start) != null ? _a : 0, stretch: (_b = r.stretch) != null ? _b : 1 };
+  var _a2, _b;
+  return { start: (_a2 = r.start) != null ? _a2 : 0, stretch: (_b = r.stretch) != null ? _b : 1 };
 }
 var CROP_EDGE_MS = 1;
 function applyTimeCrop(useNode, crop, ctx) {
@@ -4339,12 +4761,12 @@ function concatRetime(child, parent) {
   };
 }
 function readCloneRetime(n) {
-  var _a, _b;
-  return (_b = (_a = n.effects) == null ? void 0 : _a.clone) == null ? void 0 : _b.retime;
+  var _a2, _b;
+  return (_b = (_a2 = n.effects) == null ? void 0 : _a2.clone) == null ? void 0 : _b.retime;
 }
 function clearCloneRetime(n) {
-  var _a;
-  const clone2 = (_a = n.effects) == null ? void 0 : _a.clone;
+  var _a2;
+  const clone2 = (_a2 = n.effects) == null ? void 0 : _a2.clone;
   if (!clone2) return;
   delete clone2.retime;
   if (Object.keys(clone2).length === 0) delete n.effects.clone;
@@ -4355,9 +4777,9 @@ function applyAllRetimeEffects(root, ctx) {
   indexById(root, ctx.idMap);
   const sites = [];
   const collect = (n) => {
-    var _a;
+    var _a2;
     if (readCloneRetime(n)) sites.push(n);
-    (_a = n.children) == null ? void 0 : _a.forEach(collect);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(collect);
   };
   collect(root);
   const reachCount = /* @__PURE__ */ new Map();
@@ -4365,7 +4787,7 @@ function applyAllRetimeEffects(root, ctx) {
     let count = 0;
     const visited = /* @__PURE__ */ new Set();
     const walk = (n) => {
-      var _a;
+      var _a2;
       if (!n) return;
       if (n !== site && readCloneRetime(n)) count++;
       if (n.type === "use" && n.href) {
@@ -4375,7 +4797,7 @@ function applyAllRetimeEffects(root, ctx) {
           walk(ctx.idMap.get(id));
         }
       }
-      (_a = n.children) == null ? void 0 : _a.forEach(walk);
+      (_a2 = n.children) == null ? void 0 : _a2.forEach(walk);
     };
     const rootId = stripHash2(site.href);
     if (rootId) {
@@ -4385,8 +4807,8 @@ function applyAllRetimeEffects(root, ctx) {
     reachCount.set(site, count);
   }
   sites.sort((a, b) => {
-    var _a, _b;
-    return ((_a = reachCount.get(b)) != null ? _a : 0) - ((_b = reachCount.get(a)) != null ? _b : 0);
+    var _a2, _b;
+    return ((_a2 = reachCount.get(b)) != null ? _a2 : 0) - ((_b = reachCount.get(a)) != null ? _b : 0);
   });
   for (const useNode of sites) {
     const retime = readCloneRetime(useNode);
@@ -4453,7 +4875,7 @@ function buildChainClone(targetId, accum, ctx, chain) {
 }
 function materialiseNestedRetimeUses(node, accum, ctx, chain, parentTargetId) {
   const visit = (n) => {
-    var _a;
+    var _a2;
     const retime = readCloneRetime(n);
     if (n.type === "use" && retime && n.href) {
       const subId = stripHash2(n.href);
@@ -4466,14 +4888,14 @@ function materialiseNestedRetimeUses(node, accum, ctx, chain, parentTargetId) {
       }
       clearCloneRetime(n);
     }
-    (_a = n.children) == null ? void 0 : _a.forEach(visit);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(visit);
   };
   visit(node);
 }
 function remapKeyframeTimes(node, start, stretch) {
-  var _a;
+  var _a2;
   remapKeyframeTimesOnly(node, start, stretch);
-  (_a = node.children) == null ? void 0 : _a.forEach((c) => remapKeyframeTimes(c, start, stretch));
+  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => remapKeyframeTimes(c, start, stretch));
 }
 function remapKeyframeTimesOnly(node, start, stretch) {
   const remap2 = (kfs) => {
@@ -4490,7 +4912,7 @@ function remapKeyframeTimesOnly(node, start, stretch) {
   }
 }
 
-// src/effects/pathSampler.ts
+// src/effects/text/pathSampler.ts
 var LUT_STEPS = 48;
 var CMD_RE = /[MmLlHhVvCcSsQqTtAaZz]/;
 function tokenize(d) {
@@ -4638,7 +5060,7 @@ function createPathSampler(d) {
   };
 }
 
-// src/effects/textPathEffect.ts
+// src/effects/text/textPathEffect.ts
 var EXTEND_MARGIN_FRAC = 0.15;
 function numRange(v) {
   const read = readAnimatable(v);
@@ -4652,8 +5074,8 @@ function numRange(v) {
 function estimateTextAdvance(node) {
   let chars = 0, maxFont = 16;
   const walk = (el) => {
-    var _a, _b;
-    const fs = parseFloat(String((_a = el.fontSize) != null ? _a : "")) || 0;
+    var _a2, _b;
+    const fs = parseFloat(String((_a2 = el.fontSize) != null ? _a2 : "")) || 0;
     if (fs) maxFont = Math.max(maxFont, fs);
     const t = (_b = el.text) != null ? _b : el.textContent;
     if (typeof t === "string") chars += t.length;
@@ -4677,14 +5099,14 @@ function shiftAnimatable(v, by) {
   return out;
 }
 function extendedPathForBrowser(pathD, opts) {
-  var _a;
+  var _a2;
   if (opts.pathOverflow === "clip") return { d: pathD, startShift: 0 };
   const sampler = createPathSampler(pathD);
   if (!sampler || sampler.closed || sampler.totalLength <= 0) return { d: pathD, startShift: 0 };
   const L = sampler.totalLength;
   const margin = EXTEND_MARGIN_FRAC * L;
   const so = numRange(opts.startOffset);
-  const runWidth = numRange(opts.textLength).max || ((_a = opts.advance) != null ? _a : 0);
+  const runWidth = numRange(opts.textLength).max || ((_a2 = opts.advance) != null ? _a2 : 0);
   const startOverflow = Math.max(0, -so.min);
   const endOverflow = Math.max(0, so.max + runWidth - L);
   const startExt = startOverflow > 0 ? startOverflow + margin : 0;
@@ -4705,10 +5127,10 @@ function extendedPathForBrowser(pathD, opts) {
   return { d, startShift: startExt };
 }
 function applyTextPathEffect(node, fx, ctx) {
-  var _a;
-  if (!fx || typeof fx.path !== "string" || !fx.path) return node;
+  var _a2;
+  if (!fx || typeof fx.pathData !== "string" || !fx.pathData) return node;
   const pathId = genId(ctx, "tpath");
-  const { d, startShift } = extendedPathForBrowser(fx.path, {
+  const { d, startShift } = extendedPathForBrowser(fx.pathData, {
     pathOverflow: fx.pathOverflow,
     startOffset: fx.startOffset,
     textLength: fx.textLength,
@@ -4718,7 +5140,7 @@ function applyTextPathEffect(node, fx, ctx) {
   const textPath = {
     type: "textPath",
     href: "#" + pathId,
-    children: (_a = node.children) != null ? _a : []
+    children: (_a2 = node.children) != null ? _a2 : []
   };
   if (fx.lengthAdjust !== void 0) textPath.lengthAdjust = fx.lengthAdjust;
   if (fx.method !== void 0) textPath.method = fx.method;
@@ -4733,7 +5155,7 @@ function applyAnimatableNumber(node, attrName, raw) {
   writeAnimatableChannel(node, attrName, readAnimatable(raw), { asString: true });
 }
 
-// src/effects/elementFactory.ts
+// src/effects/text/elementFactory.ts
 var jsonElementFactory = (type, props, children) => {
   const node = { type };
   for (const k in props) if (props[k] !== void 0) node[k] = props[k];
@@ -4742,7 +5164,7 @@ var jsonElementFactory = (type, props, children) => {
   return node;
 };
 
-// src/effects/glyphPathBake.ts
+// src/effects/text/glyphPathBake.ts
 function fmt(v, decimals) {
   return Math.round(v) === v ? "" + Math.round(v) : v.toFixed(decimals);
 }
@@ -4788,7 +5210,7 @@ function transformPathData(d, m, decimals = 2) {
   return out;
 }
 
-// src/effects/textGlyphsEffect.ts
+// src/effects/text/textGlyphsEffect.ts
 var DEFAULT_FONT_SIZE = 16;
 var TEXT_ATTR_KEYS = [
   "fontFamily",
@@ -4848,15 +5270,15 @@ function paintAnimateOf(node) {
   return out;
 }
 function resolveStyle2(node, parent) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const isTextRoot = node.type === "text";
   const nodeStyle = node.style;
   const own = (key) => {
-    var _a2;
-    return isTextRoot ? void 0 : (_a2 = node[key]) != null ? _a2 : nodeStyle == null ? void 0 : nodeStyle[key];
+    var _a3;
+    return isTextRoot ? void 0 : (_a3 = node[key]) != null ? _a3 : nodeStyle == null ? void 0 : nodeStyle[key];
   };
   const res = {
-    fontFamily: (_a = str(node.fontFamily)) != null ? _a : parent.fontFamily,
+    fontFamily: (_a2 = str(node.fontFamily)) != null ? _a2 : parent.fontFamily,
     fontSize: (_b = parseLen(node.fontSize)) != null ? _b : parent.fontSize,
     fill: (_c = node.fill) != null ? _c : parent.fill,
     stroke: (_d = node.stroke) != null ? _d : parent.stroke,
@@ -4873,10 +5295,10 @@ function resolveStyle2(node, parent) {
   return res;
 }
 function rootStyleOf(node) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   return {
     fontFamily: str(node.fontFamily),
-    fontSize: (_a = parseLen(node.fontSize)) != null ? _a : DEFAULT_FONT_SIZE,
+    fontSize: (_a2 = parseLen(node.fontSize)) != null ? _a2 : DEFAULT_FONT_SIZE,
     fill: node.fill,
     stroke: node.stroke,
     strokeWidth: node.strokeWidth,
@@ -4897,9 +5319,9 @@ function paintOf(s) {
   return p;
 }
 function glyphFontFor(s, glyphs, soleFont, warnings) {
-  var _a;
+  var _a2;
   const gf = s.fontFamily ? glyphs[s.fontFamily] : soleFont;
-  if (!gf) warnings == null ? void 0 : warnings.push('textGlyphs: no glyphs for font "' + ((_a = s.fontFamily) != null ? _a : "") + '"');
+  if (!gf) warnings == null ? void 0 : warnings.push('textGlyphs: no glyphs for font "' + ((_a2 = s.fontFamily) != null ? _a2 : "") + '"');
   return gf;
 }
 function soleFontOf(glyphs) {
@@ -4921,19 +5343,19 @@ function missingGlyphBoxEm(advanceEm, ascentEm) {
   return outer + "M" + ix0 + " " + iyb + "L" + ix0 + " " + iyt + "L" + ix1 + " " + iyt + "L" + ix1 + " " + iyb + "Z";
 }
 function materialiseGlyphTextHorizontal(node, opts) {
-  var _a, _b, _c, _d;
+  var _a2, _b, _c, _d;
   const { glyphs, create = jsonElementFactory, warnings } = opts;
   const soleFont = soleFontOf(glyphs);
-  const pen = { x: (_a = parseLen(node.x)) != null ? _a : 0, y: (_b = parseLen(node.y)) != null ? _b : 0 };
+  const pen = { x: (_a2 = parseLen(node.x)) != null ? _a2 : 0, y: (_b = parseLen(node.y)) != null ? _b : 0 };
   const placements = [];
   const lines = [{ start: pen.x, end: pen.x }];
   let line = 0;
   const renderChars = (content, s) => {
-    var _a2;
+    var _a3;
     const gf = glyphFontFor(s, glyphs, soleFont, warnings);
     const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
     const scale = s.fontSize / upm;
-    const ascentEm = (_a2 = gf == null ? void 0 : gf.ascent) != null ? _a2 : 0.9 * upm;
+    const ascentEm = (_a3 = gf == null ? void 0 : gf.ascent) != null ? _a3 : 0.9 * upm;
     const paint = paintOf(s);
     for (let i = 0; i < content.length; i++) {
       const ch = content.charAt(i);
@@ -4953,7 +5375,7 @@ function materialiseGlyphTextHorizontal(node, opts) {
     }
   };
   const walk = (el, parentStyle) => {
-    var _a2, _b2, _c2, _d2;
+    var _a3, _b2, _c2, _d2;
     const s = resolveStyle2(el, parentStyle);
     const x = parseLen(el.x);
     const y = parseLen(el.y);
@@ -4963,7 +5385,7 @@ function materialiseGlyphTextHorizontal(node, opts) {
       lines.push({ start: pen.x, end: pen.x });
     }
     if (y !== void 0) pen.y = y;
-    pen.x += (_a2 = parseLen(el.dx)) != null ? _a2 : 0;
+    pen.x += (_a3 = parseLen(el.dx)) != null ? _a3 : 0;
     pen.y += (_b2 = parseLen(el.dy)) != null ? _b2 : 0;
     const content = (_c2 = str(el[TEXT_CONTENT_ATTR])) != null ? _c2 : str(el[TEXT_ATTR]);
     if (content && !((_d2 = el.children) == null ? void 0 : _d2.length)) renderChars(content, s);
@@ -4984,8 +5406,8 @@ function materialiseGlyphTextHorizontal(node, opts) {
   return toGroup(node, buildPaths(placements, create, warnings), create);
 }
 function layoutGlyphTextChars(node, opts) {
-  var _a, _b, _c, _d, _e, _f;
-  if ((_a = opts.alongPath) == null ? void 0 : _a.pathD) return layoutGlyphTextCharsAlongPath(node, opts.alongPath.pathD, opts);
+  var _a2, _b, _c, _d, _e, _f;
+  if ((_a2 = opts.alongPath) == null ? void 0 : _a2.pathD) return layoutGlyphTextCharsAlongPath(node, opts.alongPath.pathD, opts);
   const { glyphs, warnings } = opts;
   const soleFont = soleFontOf(glyphs);
   const pen = { x: (_b = parseLen(node.x)) != null ? _b : 0, y: (_c = parseLen(node.y)) != null ? _c : 0 };
@@ -4993,11 +5415,11 @@ function layoutGlyphTextChars(node, opts) {
   const lines = [{ start: pen.x, end: pen.x }];
   let line = 0;
   const renderChars = (content, s) => {
-    var _a2;
+    var _a3;
     const gf = glyphFontFor(s, glyphs, soleFont, warnings);
     const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
     const scale = s.fontSize / upm;
-    const ascent = ((_a2 = gf == null ? void 0 : gf.ascent) != null ? _a2 : 0.9 * upm) * scale;
+    const ascent = ((_a3 = gf == null ? void 0 : gf.ascent) != null ? _a3 : 0.9 * upm) * scale;
     for (let i = 0; i < content.length; i++) {
       const ch = content.charAt(i);
       const g = gf == null ? void 0 : gf.glyphs[ch];
@@ -5008,7 +5430,7 @@ function layoutGlyphTextChars(node, opts) {
     }
   };
   const walk = (el, parentStyle) => {
-    var _a2, _b2, _c2, _d2;
+    var _a3, _b2, _c2, _d2;
     const s = resolveStyle2(el, parentStyle);
     const x = parseLen(el.x);
     const y = parseLen(el.y);
@@ -5018,7 +5440,7 @@ function layoutGlyphTextChars(node, opts) {
       lines.push({ start: pen.x, end: pen.x });
     }
     if (y !== void 0) pen.y = y;
-    pen.x += (_a2 = parseLen(el.dx)) != null ? _a2 : 0;
+    pen.x += (_a3 = parseLen(el.dx)) != null ? _a3 : 0;
     pen.y += (_b2 = parseLen(el.dy)) != null ? _b2 : 0;
     const content = (_c2 = str(el[TEXT_CONTENT_ATTR])) != null ? _c2 : str(el[TEXT_ATTR]);
     if (content && !((_d2 = el.children) == null ? void 0 : _d2.length)) renderChars(content, s);
@@ -5050,7 +5472,7 @@ function layoutGlyphTextChars(node, opts) {
   });
 }
 function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
-  var _a, _b;
+  var _a2, _b;
   const { glyphs, warnings, alongPath } = opts;
   const sampler = createPathSampler(pathD);
   if (!sampler) {
@@ -5061,9 +5483,9 @@ function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
   const chars = [];
   let adv = 0;
   const walk = (el, parentStyle) => {
-    var _a2, _b2, _c;
+    var _a3, _b2, _c;
     const s = resolveStyle2(el, parentStyle);
-    const content = (_a2 = str(el[TEXT_CONTENT_ATTR])) != null ? _a2 : str(el[TEXT_ATTR]);
+    const content = (_a3 = str(el[TEXT_CONTENT_ATTR])) != null ? _a3 : str(el[TEXT_ATTR]);
     if (content && !((_b2 = el.children) == null ? void 0 : _b2.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
@@ -5083,7 +5505,7 @@ function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
   walk(node, rootStyleOf(node));
   const width = adv;
   const tlr = readAnimatable(alongPath == null ? void 0 : alongPath.textLength);
-  const tlv = tlr.kind === "animated" /* Animated */ ? Number((_a = tlr.keyframes[0]) == null ? void 0 : _a.value) || 0 : tlr.kind === "static" /* Static */ ? Number(tlr.value) || 0 : 0;
+  const tlv = tlr.kind === "animated" /* Animated */ ? Number((_a2 = tlr.keyframes[0]) == null ? void 0 : _a2.value) || 0 : tlr.kind === "static" /* Static */ ? Number(tlr.value) || 0 : 0;
   const k = tlv > 0 && width > 0 ? tlv / width : 1;
   const so = readAnimatable(alongPath == null ? void 0 : alongPath.startOffset);
   const { along: alongOffset, perp } = alongPathNodeOffsets(node);
@@ -5115,9 +5537,9 @@ function collectAlongPathCells(node, glyphs, soleFont, warnings) {
   const cells = [];
   let adv = 0;
   const walk = (el, parentStyle) => {
-    var _a, _b, _c;
+    var _a2, _b, _c;
     const s = resolveStyle2(el, parentStyle);
-    const content = (_a = str(el[TEXT_CONTENT_ATTR])) != null ? _a : str(el[TEXT_ATTR]);
+    const content = (_a2 = str(el[TEXT_CONTENT_ATTR])) != null ? _a2 : str(el[TEXT_ATTR]);
     if (content && !((_b = el.children) == null ? void 0 : _b.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       if (gf) {
@@ -5154,9 +5576,9 @@ function alongAffine(sampler, dist, scale, widthEm, perp = 0) {
   return [scale * cos, scale * sin, -scale * sin, scale * cos, x - scale * cos * hw - perp * sin, y - scale * sin * hw + perp * cos];
 }
 function alongPathNodeOffsets(node) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   return {
-    along: ((_a = parseLen(node.x)) != null ? _a : 0) + ((_b = parseLen(node.dx)) != null ? _b : 0),
+    along: ((_a2 = parseLen(node.x)) != null ? _a2 : 0) + ((_b = parseLen(node.dx)) != null ? _b : 0),
     perp: (_c = parseLen(node.dy)) != null ? _c : 0
   };
 }
@@ -5196,7 +5618,7 @@ function materialiseGlyphTextAlongPath(node, pathD, startOffset, opts, textLengt
   return toGroup(node, buildPaths(placements, create, warnings), create);
 }
 function numTrackOf(raw) {
-  var _a;
+  var _a2;
   const r = readAnimatable(raw);
   if (r.kind === "animated" /* Animated */ && r.keyframes.length >= 2) {
     const kfs = [...r.keyframes].sort((k1, k2) => (Number(k1.time) || 0) - (Number(k2.time) || 0));
@@ -5219,7 +5641,7 @@ function numTrackOf(raw) {
       }
     };
   }
-  const v = r.kind === "animated" /* Animated */ ? Number((_a = r.keyframes[0]) == null ? void 0 : _a.value) || 0 : r.kind === "static" /* Static */ ? Number(r.value) || 0 : 0;
+  const v = r.kind === "animated" /* Animated */ ? Number((_a2 = r.keyframes[0]) == null ? void 0 : _a2.value) || 0 : r.kind === "static" /* Static */ ? Number(r.value) || 0 : 0;
   return { animated: false, times: [], at: () => v };
 }
 function mergeTrackTimes(a, b) {
@@ -5295,7 +5717,7 @@ function paintProps(paint) {
   return p;
 }
 function missingGlyphProps(isMissing) {
-  return isMissing ? { class: MISSING_GLYPH_CLASS_NAME } : {};
+  return isMissing ? { [CLASS_ATTR]: MISSING_GLYPH_CLASS_NAME } : {};
 }
 function buildPaths(placements, create, warnings) {
   if (!placements.length) {
@@ -5339,20 +5761,20 @@ function materialiseGlyphText(node, opts) {
 function applyTextGlyphsEffect(node, fx, ctx) {
   if (!(fx == null ? void 0 : fx.useGlyphs)) return node;
   if (!ctx.glyphs) {
-    ctx.warnings.push("textGlyphs: no definitions.glyphs \u2014 left as native <text>");
+    ctx.warnings.push("textGlyphs: no definitions.fonts \u2014 left as native <text>");
     return node;
   }
   return materialiseGlyphTextHorizontal(node, { glyphs: ctx.glyphs, warnings: ctx.warnings });
 }
 function applyTextGlyphsAlongPath(node, ctx, pathD, startOffset, textLength, pathOverflow) {
   if (!ctx.glyphs) {
-    ctx.warnings.push("textGlyphs: no definitions.glyphs");
+    ctx.warnings.push("textGlyphs: no definitions.fonts");
     return null;
   }
   return materialiseGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
 }
 
-// src/effects/strokeTrimEffect.ts
+// src/effects/stroke/strokeTrimEffect.ts
 function applyStrokeTrimEffect(node, strokeTrim, ctx) {
   if (!strokeTrim) return node;
   const combined = strokeTrim.subPaths === PxStrokeTrimSubPaths.combined;
@@ -5488,12 +5910,11 @@ function getOffsetIndexRange(minMaxOffset) {
   ];
 }
 function readScalarValues(r) {
-  var _a;
   if (r.kind === "absent" /* Absent */) return [];
   if (r.kind === "static" /* Static */) return [r.value];
   const out = [];
   for (const kf of r.keyframes) {
-    const v = (_a = kf.value) != null ? _a : kf.v;
+    const v = kfValue(kf);
     if (typeof v === "number") out.push(v);
   }
   return out;
@@ -5503,14 +5924,11 @@ function computeAnimAttr(read, map) {
   if (read.kind === "static" /* Static */) return { kind: "static" /* Static */, value: map(read.value) };
   return {
     kind: "animated" /* Animated */,
-    keyframes: read.keyframes.map((kf) => {
-      var _a, _b, _c, _d;
-      return {
-        time: (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0,
-        value: map((_c = kf.value) != null ? _c : kf.v),
-        easing: (_d = kf.easing) != null ? _d : kf.e
-      };
-    }),
+    keyframes: read.keyframes.map((kf) => ({
+      time: kfTime(kf),
+      value: map(kfValue(kf)),
+      easing: kfEasing(kf)
+    })),
     loop: read.loop
   };
 }
@@ -5520,7 +5938,6 @@ function applyAttr(node, attrName, attr) {
 }
 var OPACITY_STEP_MS = 10;
 function computeOpacityFromRange(rangeRead) {
-  var _a, _b, _c, _d, _e, _f;
   const hide = (v) => v[0] === v[1];
   if (rangeRead.kind === "absent" /* Absent */) return void 0;
   if (rangeRead.kind === "static" /* Static */) return hide(rangeRead.value) ? { kind: "static" /* Static */, value: 0 } : void 0;
@@ -5528,7 +5945,7 @@ function computeOpacityFromRange(rangeRead) {
   let anyHide = false;
   let allHide = true;
   for (const kf of kfs) {
-    if (hide((_a = kf.value) != null ? _a : kf.v)) anyHide = true;
+    if (hide(kfValue(kf))) anyHide = true;
     else allHide = false;
   }
   if (!anyHide) return void 0;
@@ -5538,10 +5955,10 @@ function computeOpacityFromRange(rangeRead) {
     const kf = kfs[i];
     const prevKf = i > 0 ? kfs[i - 1] : void 0;
     const nextKf = i < kfs.length - 1 ? kfs[i + 1] : void 0;
-    const t = (_c = (_b = kf.time) != null ? _b : kf.t) != null ? _c : 0;
-    const thisHide = hide((_d = kf.value) != null ? _d : kf.v);
-    const prevHide = prevKf ? thisHide && hide((_e = prevKf.value) != null ? _e : prevKf.v) : thisHide;
-    const nextHide = nextKf ? thisHide && hide((_f = nextKf.value) != null ? _f : nextKf.v) : thisHide;
+    const t = kfTime(kf);
+    const thisHide = hide(kfValue(kf));
+    const prevHide = prevKf ? thisHide && hide(kfValue(prevKf)) : thisHide;
+    const nextHide = nextKf ? thisHide && hide(kfValue(nextKf)) : thisHide;
     if (prevHide && !nextHide) {
       out.push({ time: t, value: 0 });
       out.push({ time: t + OPACITY_STEP_MS, value: 1 });
@@ -5556,14 +5973,11 @@ function computeOpacityFromRange(rangeRead) {
 function readRangeWithCrossings(raw) {
   const r = readAnimatable(raw);
   if (r.kind !== "animated" /* Animated */) return r;
-  const kfs = r.keyframes.map((kf) => {
-    var _a, _b, _c, _d;
-    return {
-      time: (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0,
-      value: (_c = kf.value) != null ? _c : kf.v,
-      easing: (_d = kf.easing) != null ? _d : kf.e
-    };
-  });
+  const kfs = r.keyframes.map((kf) => ({
+    time: kfTime(kf),
+    value: kfValue(kf),
+    easing: kfEasing(kf)
+  }));
   const hasReverse = kfs.some((kf) => kf.value[0] > kf.value[1]);
   if (!hasReverse) {
     return {
@@ -5660,20 +6074,20 @@ function pxBezierPathLength(path) {
   return total;
 }
 function segmentLength(path, from, to) {
-  var _a, _b, _c, _d;
+  var _a2, _b, _c, _d;
   const v = path.v;
   const p0 = v[from];
   const p3 = v[to];
-  const p1 = (_b = (_a = path.o) == null ? void 0 : _a[from]) != null ? _b : p0;
+  const p1 = (_b = (_a2 = path.o) == null ? void 0 : _a2[from]) != null ? _b : p0;
   const p2 = (_d = (_c = path.i) == null ? void 0 : _c[to]) != null ? _d : p3;
   const lut = bezier2D_arcLengthLUT(p0, p1, p2, p3);
   return lut.ds[lut.ds.length - 1];
 }
 var ARC_KAPPA = 0.5522847498307936;
 function shapeToPathD(node) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   if (node.type === "rect") {
-    const x = Number((_a = node.x) != null ? _a : 0), y = Number((_b = node.y) != null ? _b : 0);
+    const x = Number((_a2 = node.x) != null ? _a2 : 0), y = Number((_b = node.y) != null ? _b : 0);
     const w = Number((_c = node.width) != null ? _c : 0), h = Number((_d = node.height) != null ? _d : 0);
     return "M" + (x + w) + "," + y + "L" + (x + w) + "," + (y + h) + "L" + x + "," + (y + h) + "L" + x + "," + y + "L" + (x + w) + "," + y + "z";
   }
@@ -5691,7 +6105,7 @@ function shapeToPathD(node) {
 
 // src/effects/PlayerEffectsUtil.ts
 function applyPlayerEffects(root) {
-  var _a, _b;
+  var _a2, _b;
   const ctx = {
     defs: [],
     warnings: [],
@@ -5702,8 +6116,8 @@ function applyPlayerEffects(root) {
     maskAncestorChains: /* @__PURE__ */ new Map(),
     // Resolved engine: `frames` ONLY when explicitly set; auto/waapi/unset →
     // waapi (we're not 100% sure it's frames, and CSS/WAAPI need the inline form).
-    engine: ((_a = getAnimatorConfig(root)) == null ? void 0 : _a.mode) === PxAnimatorMode.frames ? PxAnimatorEngine.frames : PxAnimatorEngine.waapi,
-    glyphs: (_b = getDefs(root)) == null ? void 0 : _b.glyphs
+    engine: resolveTimelineEngine((_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.engine),
+    glyphs: (_b = getDefs(root)) == null ? void 0 : _b.fonts
   };
   const working = clone(root);
   indexById(working, ctx.idMap);
@@ -5726,7 +6140,7 @@ function applyPlayerEffects_exceptRetime(node, ctx) {
   let consumedByGlyphs = false;
   if (text == null ? void 0 : text.useGlyphs) {
     if (textPath) {
-      const pathD = typeof textPath.path === "string" ? textPath.path : void 0;
+      const pathD = typeof textPath.pathData === "string" ? textPath.pathData : void 0;
       const glyphed = applyTextGlyphsAlongPath(n, ctx, pathD, textPath.startOffset, textPath.textLength, textPath.pathOverflow);
       if (glyphed) {
         n = glyphed;
@@ -5759,27 +6173,7 @@ function applyPlayerEffects_retime(node, ctx) {
   return node;
 }
 
-// src/PxOffsetPathMaterialiser.ts
-var kfTime = (kf) => {
-  var _a, _b;
-  return (_b = (_a = kf.t) != null ? _a : kf.time) != null ? _b : 0;
-};
-var kfValue = (kf) => {
-  var _a;
-  return (_a = kf.v) != null ? _a : kf.value;
-};
-var kfEasing = (kf) => {
-  var _a;
-  return (_a = kf.e) != null ? _a : kf.easing;
-};
-var kfTangentIn = (kf) => {
-  var _a;
-  return (_a = kf.tangentIn) != null ? _a : kf.ti;
-};
-var kfTangentOut = (kf) => {
-  var _a;
-  return (_a = kf.tangentOut) != null ? _a : kf.to;
-};
+// src/materialise/PxOffsetPathMaterialiser.ts
 function cubicAt(p0, c1, c2, p1, t) {
   const u = 1 - t;
   const a = u * u * u, b = 3 * u * u * t, c = 3 * u * t * t, d = t * t * t;
@@ -5803,7 +6197,7 @@ var fmt2 = (n) => {
   return Object.is(r, -0) ? "0" : String(r);
 };
 function buildOffsetPath(propAnim) {
-  var _a, _b, _c;
+  var _a2, _b, _c;
   if (propAnim.alongPathMode !== "offsetPath") return void 0;
   const kfs = propAnim.keyframes;
   if (!kfs || kfs.length < 2) return void 0;
@@ -5816,7 +6210,7 @@ function buildOffsetPath(propAnim) {
     if (!tr || tr.length < 2) return void 0;
     const parts = Object.keys(v);
     if (parts.some((p) => p !== "translate" && p !== "origin")) return void 0;
-    const o = (_a = v == null ? void 0 : v.origin) != null ? _a : [0, 0];
+    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]]);
   }
@@ -5847,7 +6241,7 @@ function buildOffsetPath(propAnim) {
 }
 function materialiseOffsetPathsInTree(root) {
   const walk = (node) => {
-    var _a;
+    var _a2;
     let out = node;
     const anim = node.animate;
     const transform = anim == null ? void 0 : anim["transform"];
@@ -5855,16 +6249,16 @@ function materialiseOffsetPathsInTree(root) {
       const built = buildOffsetPath(transform);
       if (built) {
         const newAnimate = __spreadValues({}, anim);
-        delete newAnimate["transform"];
+        delete newAnimate[TRANSFORM_ATTR];
         const distance = { keyframes: built.distanceKfs };
         if (transform.loop !== void 0) distance.loop = transform.loop;
-        newAnimate["offsetDistance"] = distance;
+        newAnimate[OFFSET_DISTANCE_ATTR] = distance;
         const staticTr = node.transform;
         let newTransform = staticTr;
         if (staticTr && typeof staticTr === "object") {
           const t = __spreadValues({}, staticTr);
-          delete t["translate"];
-          delete t["origin"];
+          delete t[TRANSFORM_PART.translate];
+          delete t[TRANSFORM_PART.origin];
           newTransform = Object.keys(t).length ? t : void 0;
         }
         out = __spreadProps(__spreadValues({}, node), {
@@ -5880,7 +6274,7 @@ function materialiseOffsetPathsInTree(root) {
         else delete out.transform;
       }
     }
-    if ((_a = out.children) == null ? void 0 : _a.length) {
+    if ((_a2 = out.children) == null ? void 0 : _a2.length) {
       const children = out.children.map(walk);
       if (children.some((c, i) => c !== out.children[i])) out = __spreadProps(__spreadValues({}, out), { children });
     }
@@ -5889,14 +6283,14 @@ function materialiseOffsetPathsInTree(root) {
   return walk(root);
 }
 
-// src/PxAnimatorMaterialiseAll.ts
+// src/materialise/PxAnimatorMaterialiseAll.ts
 function materialiseAllInTree(doc, engine, opts) {
-  var _a, _b;
+  var _a2, _b;
   let root = applyPlayerEffects(doc).root;
   root = materialiseOffsetPathsInTree(root);
-  const duration = (_b = (_a = getAnimatorConfig(root)) == null ? void 0 : _a.duration) != null ? _b : DEFAULT_DURATION_MS;
+  const duration = (_b = (_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.duration) != null ? _b : DEFAULT_DURATION_MS;
   root = materialiseInternalLoopsInTree(root, duration);
-  if (engine === PxAnimatorEngine.waapi) {
+  if (engine === PxTimelineEngine.native) {
     root = materialiseMotionPathsInTree(root, opts == null ? void 0 : opts.motionPath);
     root = materialiseAnimatedUseInstances(root);
     root = pruneUnreferencedDefs(root);
@@ -5906,9 +6300,9 @@ function materialiseAllInTree(doc, engine, opts) {
 function pruneUnreferencedDefs(root) {
   const stripHash3 = (h) => h.startsWith("#") ? h.slice(1) : h;
   const walk = (n, fn) => {
-    var _a;
+    var _a2;
     fn(n);
-    (_a = n.children) == null ? void 0 : _a.forEach((c) => walk(c, fn));
+    (_a2 = n.children) == null ? void 0 : _a2.forEach((c) => walk(c, fn));
   };
   let changed = true;
   while (changed) {
@@ -5933,7 +6327,7 @@ function pruneUnreferencedDefs(root) {
   return root;
 }
 
-// src/PxFrameLoop.ts
+// src/playback/PxFrameLoop.ts
 function requestFrame(cb) {
   const g = globalThis;
   if (typeof g.requestAnimationFrame === "function") return g.requestAnimationFrame(cb);
@@ -5948,9 +6342,9 @@ function cancelFrame(handle) {
   g.clearTimeout(handle);
 }
 function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
-  var _a;
+  var _a2;
   const config = getAnimatorConfig(doc) || {};
-  const bindings = getNormalisedBindings(doc, PxAnimatorEngine.frames);
+  const bindings = getNormalisedBindings(doc, PxTimelineEngine.js);
   const _iterations = config.iterations;
   let iterations = 1;
   if (typeof _iterations === "number") iterations = _iterations || 1;
@@ -5959,7 +6353,7 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
   const duration = +(config.duration || 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 = (_a = config.fill) != null ? _a : "forwards";
+  const fill = (_a2 = config.fill) != null ? _a2 : "forwards";
   const fillsForwards = fill === "forwards" || fill === "both";
   const fillsBackwards = fill === "backwards" || fill === "both";
   let timerId = null;
@@ -6021,7 +6415,7 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
     }
   }
   const tick = () => {
-    var _a2, _b;
+    var _a3, _b;
     if (!adapter.isConnected()) {
       pauseAnim();
       return;
@@ -6037,7 +6431,7 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
       renderFrame(0);
       if (!finishCalled) {
         finishCalled = true;
-        (_a2 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a2.call(callbacks);
+        (_a3 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a3.call(callbacks);
       }
       return;
     }
@@ -6129,17 +6523,17 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
     }
   };
   const cancelAnim = () => {
-    var _a2;
+    var _a3;
     pauseAnim();
     timeBeforeLastStartMs = 0;
     lastStartedTs = 0;
     playing = false;
     finishCalled = false;
     renderFrame(timeBeforeLastStartMs);
-    (_a2 = callbacks == null ? void 0 : callbacks.onCancel) == null ? void 0 : _a2.call(callbacks);
+    (_a3 = callbacks == null ? void 0 : callbacks.onCancel) == null ? void 0 : _a3.call(callbacks);
   };
   const finishAnim = (callOnFinish = true) => {
-    var _a2;
+    var _a3;
     if (Number.isFinite(totalDuration)) {
       timeBeforeLastStartMs = totalDuration;
     } else {
@@ -6154,7 +6548,7 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
     renderFrame(fillsForwards ? timeBeforeLastStartMs : 0);
     if (callOnFinish && !finishCalled) {
       finishCalled = true;
-      (_a2 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a2.call(callbacks);
+      (_a3 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a3.call(callbacks);
     }
   };
   const api = {
@@ -6164,14 +6558,14 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
       return _isPlaying();
     },
     "play": () => {
-      var _a2;
+      var _a3;
       startAnim();
-      (_a2 = callbacks == null ? void 0 : callbacks.onPlay) == null ? void 0 : _a2.call(callbacks);
+      (_a3 = callbacks == null ? void 0 : callbacks.onPlay) == null ? void 0 : _a3.call(callbacks);
     },
     "pause": () => {
-      var _a2;
+      var _a3;
       pauseAnim();
-      (_a2 = callbacks == null ? void 0 : callbacks.onPause) == null ? void 0 : _a2.call(callbacks);
+      (_a3 = callbacks == null ? void 0 : callbacks.onPause) == null ? void 0 : _a3.call(callbacks);
     },
     "cancel": () => {
       cancelAnim();
@@ -6203,9 +6597,9 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
       renderFrame(getAnimCurrentTime());
     },
     "destroy": () => {
-      var _a2;
+      var _a3;
       api.cancel();
-      (_a2 = callbacks == null ? void 0 : callbacks.onRemove) == null ? void 0 : _a2.call(callbacks);
+      (_a3 = callbacks == null ? void 0 : callbacks.onRemove) == null ? void 0 : _a3.call(callbacks);
     }
   };
   return api;
@@ -6261,9 +6655,9 @@ function lerp(a, b, f) {
   return a + (b - a) * f;
 }
 function interpParts(kfs, t) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a2, _b, _c, _d, _e, _f, _g;
   if (!kfs.length) return {};
-  if (t <= ((_a = kfs[0].time) != null ? _a : 0)) return kfs[0].value || {};
+  if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value || {};
   if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value || {};
   let i = 0;
   while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
@@ -6294,10 +6688,10 @@ function nodeMatrix(node, t) {
   return IDENTITY;
 }
 function evalScalar(animated, staticVal, fallback, t) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a2, _b, _c, _d, _e, _f;
   if (animated && animated.keyframes && animated.keyframes.length) {
     const kfs = animated.keyframes;
-    if (t <= ((_a = kfs[0].time) != null ? _a : 0)) return kfs[0].value;
+    if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value;
     if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value;
     let i = 0;
     while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
@@ -6310,9 +6704,9 @@ function evalScalar(animated, staticVal, fallback, t) {
 var CONTAINER_TYPES = /* @__PURE__ */ new Set(["svg", "g", "symbol"]);
 var SKIP_TYPES = /* @__PURE__ */ new Set(["defs", "mask", "clipPath", "title"]);
 function buildIdMap2(node, map) {
-  var _a;
+  var _a2;
   if (typeof node.id === "string") map.set(node.id, node);
-  (_a = node.children) == null ? void 0 : _a.forEach((c) => buildIdMap2(c, map));
+  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => buildIdMap2(c, map));
 }
 function num(v) {
   return v === void 0 || v === null ? 0 : Number(v);
@@ -6321,7 +6715,7 @@ function round(n) {
   return Math.round(n * 100) / 100 + 0;
 }
 function geomKey(node) {
-  var _a;
+  var _a2;
   switch (node.type) {
     case "rect":
       return num(node.width) + "," + num(node.height) + "," + num(node.x) + "," + num(node.y);
@@ -6330,14 +6724,14 @@ function geomKey(node) {
     case "circle":
       return num(node.r) + "," + num(node.cx) + "," + num(node.cy);
     case "path":
-      return String((_a = node.d) != null ? _a : "");
+      return String((_a2 = node.d) != null ? _a2 : "");
     default:
       return "";
   }
 }
 function describePrimitive(node, m, t) {
-  var _a, _b, _c, _d, _e;
-  const fill = (_a = node.fill) != null ? _a : "";
+  var _a2, _b, _c, _d, _e;
+  const fill = (_a2 = node.fill) != null ? _a2 : "";
   const stroke = (_b = node.stroke) != null ? _b : "";
   const sw = (_d = (_c = node["stroke-width"]) != null ? _c : node.strokeWidth) != null ? _d : "";
   const opacity = round(evalScalar((_e = node.animate) == null ? void 0 : _e.opacity, node.opacity, 1, t));
@@ -6346,7 +6740,7 @@ function describePrimitive(node, m, t) {
   return node.type + "|" + geomKey(node) + "|[" + mat + "]|f:" + fill + "|s:" + stroke + "|sw:" + (num(sw) || "") + "|o:" + opacity + "|m:" + masked;
 }
 function flatten(node, parent, t, idMap, out) {
-  var _a;
+  var _a2;
   const type = node.type || "";
   if (SKIP_TYPES.has(type)) return;
   const m = mul(parent, nodeMatrix(node, t));
@@ -6359,33 +6753,33 @@ function flatten(node, parent, t, idMap, out) {
     return;
   }
   if (CONTAINER_TYPES.has(type)) {
-    (_a = node.children) == null ? void 0 : _a.forEach((c) => flatten(c, m, t, idMap, out));
+    (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => flatten(c, m, t, idMap, out));
     return;
   }
   out.push(describePrimitive(node, m, t));
 }
 function collectSampleTimes(node, into) {
-  var _a;
+  var _a2;
   into.add(0);
   const scanAnim = (anim) => {
-    var _a2;
+    var _a3;
     if (!anim || typeof anim !== "object") return;
     for (const key of Object.keys(anim)) {
-      const kfs = (_a2 = anim[key]) == null ? void 0 : _a2.keyframes;
+      const kfs = (_a3 = anim[key]) == null ? void 0 : _a3.keyframes;
       if (Array.isArray(kfs)) kfs.forEach((kf) => {
-        var _a3;
-        return into.add((_a3 = kf.time) != null ? _a3 : 0);
+        var _a4;
+        return into.add((_a4 = kf.time) != null ? _a4 : 0);
       });
     }
   };
   scanAnim(node.animate);
   if (node.transform && typeof node.transform === "object" && node.transform.keyframes) {
     node.transform.keyframes.forEach((kf) => {
-      var _a2;
-      return into.add((_a2 = kf.time) != null ? _a2 : 0);
+      var _a3;
+      return into.add((_a3 = kf.time) != null ? _a3 : 0);
     });
   }
-  (_a = node.children) == null ? void 0 : _a.forEach((c) => collectSampleTimes(c, into));
+  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => collectSampleTimes(c, into));
 }
 function visualModelAt(root, t) {
   const idMap = /* @__PURE__ */ new Map();
@@ -6419,8 +6813,196 @@ function subtractMultiset(a, b) {
   }
   return extra;
 }
+
+// src/playback/PxAnimatorConfigPatch.ts
+var FLAT_ONLY_KEYS = [
+  "timelineSource",
+  "scroll",
+  "trigger",
+  "delay",
+  "iterations",
+  "direction",
+  "fill",
+  "resetOnFinish",
+  "duration",
+  "mode",
+  "frameRate"
+];
+var CONTENT_KEYS = ["definitions", "animateById"];
+var isPlainObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+var timelineTypeOf = (t) => isPlainObject(t) && typeof t.type === "string" ? t.type : "time";
+var isScrollish = (type) => type === "scroll" || type === "view";
+function mergePlain(base, patch) {
+  const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+  for (const key of Object.keys(patch)) {
+    const value = patch[key];
+    if (value === null) {
+      delete out[key];
+      continue;
+    }
+    if (isPlainObject(value)) {
+      out[key] = mergePlain(out[key], value);
+      continue;
+    }
+    out[key] = value;
+  }
+  return out;
+}
+function mergeTimeline(base, patch, warn) {
+  const baseType = timelineTypeOf(base);
+  const patchNamesType = isPlainObject(patch) && typeof patch.type === "string";
+  const patchType = patchNamesType ? String(patch.type) : baseType;
+  let merged;
+  if (patchType !== baseType) {
+    const carried = {};
+    if (isPlainObject(base)) {
+      for (const k of PX_TIMELINE_SHARED_KEYS) {
+        if (base[k] !== void 0) carried[k] = base[k];
+      }
+    }
+    merged = mergePlain(carried, patch);
+  } else {
+    merged = mergePlain(base, patch);
+  }
+  if (isScrollish(patchType)) {
+    for (const k of PX_TIME_ONLY_TIMELINE_KEYS) {
+      if (merged[k] === void 0) continue;
+      warn("animator.timeline." + k + ": no slot on a '" + patchType + "' timeline \u2014 dropped");
+      delete merged[k];
+    }
+    if (merged.iterations === "infinite") {
+      warn("animator.timeline.iterations: 'infinite' cannot map onto a scroll range \u2014 dropped");
+      delete merged.iterations;
+    }
+  }
+  return merged;
+}
+function foldAnimatorConfigShortcuts(config, shortcuts) {
+  let base;
+  if (typeof config === "string") {
+    try {
+      base = JSON.parse(config);
+    } catch (e) {
+      console.warn("animator config: not valid JSON \u2014 ignored", e);
+      base = void 0;
+    }
+  } else {
+    base = config != null ? config : void 0;
+  }
+  const { duration, delay, iterations, startOn } = shortcuts;
+  if (duration === void 0 && delay === void 0 && iterations === void 0 && startOn === void 0) {
+    return base;
+  }
+  const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+  const timeline = __spreadValues({}, out.timeline);
+  if (duration !== void 0) timeline.duration = duration;
+  if (delay !== void 0) timeline.delay = delay;
+  if (iterations !== void 0) timeline.iterations = iterations;
+  if (startOn !== void 0) {
+    timeline.trigger = __spreadProps(__spreadValues({}, timeline.trigger), { startOn });
+  }
+  out.timeline = timeline;
+  return out;
+}
+function mergeAnimatorConfig(base, patch) {
+  const warnings = [];
+  const warn = (m) => warnings.push(m);
+  if (patch === null) return { config: void 0, warnings };
+  if (!isPlainObject(patch) || Object.keys(patch).length === 0) {
+    return { config: base, warnings };
+  }
+  const flatInBase = isPlainObject(base) ? FLAT_ONLY_KEYS.filter((k) => base[k] !== void 0) : [];
+  if (flatInBase.length) {
+    warn("animator: the base carries the flat runtime spelling (" + flatInBase.join(", ") + "); the patch merges the wire spelling only");
+  }
+  const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+  for (const key of Object.keys(patch)) {
+    const value = patch[key];
+    if (value === null) {
+      delete out[key];
+      continue;
+    }
+    if (key === "timeline") {
+      out.timeline = isPlainObject(value) ? mergeTimeline(out.timeline, value, warn) : value;
+      continue;
+    }
+    if (isPlainObject(value)) {
+      out[key] = mergePlain(out[key], value);
+      continue;
+    }
+    out[key] = value;
+  }
+  return { config: out, warnings };
+}
+function applyAnimatorConfig(doc, patch, opts) {
+  var _a2, _b;
+  const reset = !!(opts == null ? void 0 : opts.resetDefaults);
+  if (!doc || (patch === void 0 || !reset && (patch === null || !isPlainObject(patch) || !Object.keys(patch).length))) {
+    return { doc, warnings: [] };
+  }
+  const anyDoc = doc;
+  const atRoot = isPlainObject(anyDoc.animator);
+  const atMeta = !atRoot && isPlainObject((_a2 = anyDoc.meta) == null ? void 0 : _a2.animator);
+  const current = atRoot ? anyDoc.animator : atMeta ? anyDoc.meta.animator : void 0;
+  const warnings = [];
+  if (atRoot && isPlainObject((_b = anyDoc.meta) == null ? void 0 : _b.animator)) {
+    warnings.push("animator: doc.meta.animator is shadowed by doc.animator and was not patched");
+  }
+  let base = current;
+  if (reset) {
+    const kept = {};
+    for (const k of CONTENT_KEYS) {
+      if (isPlainObject(current) && current[k] !== void 0) kept[k] = current[k];
+    }
+    base = kept;
+  }
+  const merged = mergeAnimatorConfig(base, patch != null ? patch : {});
+  warnings.push(...merged.warnings);
+  if (merged.config === current) return { doc, warnings };
+  if (atMeta) {
+    return {
+      doc: __spreadProps(__spreadValues({}, anyDoc), { meta: __spreadProps(__spreadValues({}, anyDoc.meta), { animator: merged.config }) }),
+      warnings
+    };
+  }
+  return { doc: __spreadProps(__spreadValues({}, anyDoc), { animator: merged.config }), warnings };
+}
+
+// src/format/PxDocumentDiagnostic.ts
+var MAX_REPORTED = 6;
+var LEGACY_FLAT_KEYS = [
+  ...PX_TIMELINE_SHARED_KEYS,
+  ...PX_TIME_ONLY_TIMELINE_KEYS,
+  "fill",
+  "resetOnFinish",
+  "timelineSource",
+  "scroll"
+];
+var isLegacyFlatAnimatorKey = (w) => LEGACY_FLAT_KEYS.some((k) => w.indexOf("animator." + k + ":") >= 0);
+function diagnoseDocument(doc) {
+  let all;
+  try {
+    all = validateDocument(doc);
+  } catch (e) {
+    return { problems: [], legacy: [] };
+  }
+  const problems = [];
+  const legacy = [];
+  for (const w of all) (isLegacyFlatAnimatorKey(w) ? legacy : problems).push(w);
+  return { problems, legacy };
+}
+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."
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BASELINE_PLAYER_VERSION,
   COLOUR_ATTR_NAMES,
   CSS_ONLY_STYLE_PROPS,
   DEFAULT_DURATION_MS,
@@ -6429,18 +7011,21 @@ function subtractMultiset(a, b) {
   LOOP_JUMP_SHIFT_MS,
   MISSING_GLYPH_CLASS_NAME,
   PCT_BASED_ATTR_NAMES,
+  PLAYER_WIRE_STEPS,
+  PLAYER_WIRE_VERSION,
   PX_ANIM_ATTR_NAME,
   PX_ANIM_SRC_ATTR_NAME,
+  PX_PLAYER_SCHEMA_VERSION,
   PX_TRANSFORM_PART_KEYS,
+  PX_UNKNOWN_KEY_ERROR,
   PxAnimatedSvgDocumentSchema,
   PxAnimationDefinitionSchema,
   PxAnimatorConfigSchema,
-  PxAnimatorEngine,
-  PxAnimatorMode,
   PxAttrValueSchema,
   PxBezierPathSchema,
   PxBindingSchema,
   PxCloneEffectSchema,
+  PxCloneWithout,
   PxDefsSchema,
   PxEasingOrRefSchema,
   PxEffectsSchema,
@@ -6452,7 +7037,8 @@ function subtractMultiset(a, b) {
   PxGradientUnits,
   PxKeyframeSchema,
   PxKeyframeValueSchema,
-  PxLoopExtend,
+  PxLoopDirection,
+  PxLoopRepeatAt,
   PxLoopSchema,
   PxMaskedByEffectSchema,
   PxNodeBase,
@@ -6469,6 +7055,8 @@ function subtractMultiset(a, b) {
   PxSvgNodeExtra,
   PxTextEffectSchema,
   PxTextPathEffectSchema,
+  PxTimelineEngine,
+  PxTimelineEngineExtra,
   PxTimelinePinSchema,
   PxTimelineSchema,
   PxTransformByEffectSchema,
@@ -6479,22 +7067,35 @@ function subtractMultiset(a, b) {
   TEXT_ATTR,
   TEXT_CONTENT_ATTR,
   TRANSFORM_FN_NAMES,
+  WIRE_VERSION_KEY,
+  WireStepKind,
+  WireVersionRelation,
+  applyAnimatorConfig,
   applyPlayerEffects,
+  applyWireSteps,
+  applyWireStepsDown,
   bezierToSvgPath,
   calcAnimationValues,
   camelCaseToKebabWordIfNeeded,
   clamp,
   collectSampleTimes,
+  compareWireVersion,
   composeTransformParts,
+  convertPlayerDocument,
   createBasicFrameLoopAnimator,
   createPathSampler,
   cubicBezier,
   deepClone,
   describeSchema,
+  diagnoseDocument,
+  diffFieldUniverse,
   diffInEffect,
+  downgradePlayerDocument,
   evaluateMotionPathSegment,
   extendedPathForBrowser,
   flattenAnimatorTimeline,
+  foldAnimatorConfigShortcuts,
+  formatWireVersion,
   generateNewIds,
   generateUniqueId,
   getAnimatorConfig,
@@ -6505,11 +7106,17 @@ function subtractMultiset(a, b) {
   getNormalizedProps,
   interpolateBeziers,
   interpolateValue,
+  isNativeForced,
   isPxElementFileFormat,
   isPxElementFileFormatDeep,
   isScrollTimeline,
   jsonElementFactory,
   kebabToCamelCaseWord,
+  kfEasing,
+  kfTangentIn,
+  kfTangentOut,
+  kfTime,
+  kfValue,
   layoutGlyphTextChars,
   materialiseAllInTree,
   materialiseAnimatedUseInstances,
@@ -6520,14 +7127,23 @@ function subtractMultiset(a, b) {
   materialiseInternalLoopsInTree,
   materialiseMotionPathInPropAnim,
   materialiseMotionPathsInTree,
+  mayUseNativeScrollTimeline,
+  mergeAnimatorConfig,
   mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline,
   parseTransformParts,
+  parseWireVersion,
+  planSchemaRelease,
   propAnimIsMotionPath,
   px,
+  readWireVersion,
+  releaseLogProblems,
+  reportDocumentDiagnostics,
   resolveStyle,
+  resolveTimelineEngine,
   reverseEasing,
   sanitiseAttributeValue,
+  schemaFieldUniverse,
   schemaKeys,
   scrollOffsetProgress,
   scrollPhaseInterval,
@@ -6538,7 +7154,9 @@ function subtractMultiset(a, b) {
   splitEasing,
   subdivideCubicBezier,
   toRGBA,
+  validateDocument,
   validateNodeEffects,
+  versionAdvice,
   visualModelAt
 });
 //# sourceMappingURL=index.cjs.map