@pixodesk/svg-animator-core 1.0.35 → 1.0.40

package/dist/index.cjs

@@ -51,68 +51,81 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BASELINE_PLAYER_VERSION: () => BASELINE_PLAYER_VERSION,
-  COLOUR_ATTR_NAMES: () => COLOUR_ATTR_NAMES,
+  COLOR_ATTR_NAMES: () => COLOR_ATTR_NAMES,
   CSS_ONLY_STYLE_PROPS: () => CSS_ONLY_STYLE_PROPS,
   DEFAULT_DURATION_MS: () => DEFAULT_DURATION_MS,
   DISALLOWED_SVG_TAGS_LOWER: () => DISALLOWED_SVG_TAGS_LOWER,
-  INTERNAL_ATTRS: () => INTERNAL_ATTRS,
   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_RATE_REJECTED: () => PX_RATE_REJECTED,
   PX_TRANSFORM_PART_KEYS: () => PX_TRANSFORM_PART_KEYS,
+  PX_TRIGGER_DEFAULTS: () => PX_TRIGGER_DEFAULTS,
   PX_UNKNOWN_KEY_ERROR: () => PX_UNKNOWN_KEY_ERROR,
+  PxAlongPathMode: () => PxAlongPathMode,
   PxAnimatedSvgDocumentSchema: () => PxAnimatedSvgDocumentSchema,
-  PxAnimationDefinitionSchema: () => PxAnimationDefinitionSchema,
   PxAnimatorConfigSchema: () => PxAnimatorConfigSchema,
   PxAttrValueSchema: () => PxAttrValueSchema,
   PxBezierPathSchema: () => PxBezierPathSchema,
-  PxBindingSchema: () => PxBindingSchema,
+  PxClipPathEffectSchema: () => PxClipPathEffectSchema,
   PxCloneEffectSchema: () => PxCloneEffectSchema,
   PxCloneWithout: () => PxCloneWithout,
+  PxControlMode: () => PxControlMode,
   PxDefsSchema: () => PxDefsSchema,
-  PxEasingOrRefSchema: () => PxEasingOrRefSchema,
+  PxDiagnosticKind: () => PxDiagnosticKind,
   PxEffectsSchema: () => PxEffectsSchema,
   PxElementAnimationSchema: () => PxElementAnimationSchema,
   PxFillGradientEffectSchema: () => PxFillGradientEffectSchema,
+  PxFillMode: () => PxFillMode,
+  PxFinishAction: () => PxFinishAction,
   PxGradientSpreadMethod: () => PxGradientSpreadMethod,
   PxGradientStopSchema: () => PxGradientStopSchema,
   PxGradientType: () => PxGradientType,
-  PxGradientUnits: () => PxGradientUnits,
   PxKeyframeSchema: () => PxKeyframeSchema,
   PxKeyframeValueSchema: () => PxKeyframeValueSchema,
+  PxLengthAdjust: () => PxLengthAdjust,
   PxLoopDirection: () => PxLoopDirection,
   PxLoopRepeatAt: () => PxLoopRepeatAt,
   PxLoopSchema: () => PxLoopSchema,
+  PxMaskType: () => PxMaskType,
   PxMaskedByEffectSchema: () => PxMaskedByEffectSchema,
   PxNodeBase: () => PxNodeBase,
   PxNodeSchema: () => PxNodeSchema,
+  PxOutAction: () => PxOutAction,
+  PxPathOverflow: () => PxPathOverflow,
+  PxPinAlign: () => PxPinAlign,
+  PxPlaybackDirection: () => PxPlaybackDirection,
   PxPropertyAnimationSchema: () => PxPropertyAnimationSchema,
   PxRepeaterEffectSchema: () => PxRepeaterEffectSchema,
   PxRetimeEffectSchema: () => PxRetimeEffectSchema,
+  PxScrollAxis: () => PxScrollAxis,
+  PxScrollKind: () => PxScrollKind,
+  PxScrollPhase: () => PxScrollPhase,
   PxScrollRangePointSchema: () => PxScrollRangePointSchema,
   PxScrollRangeSchema: () => PxScrollRangeSchema,
   PxScrollSchema: () => PxScrollSchema,
-  PxStrokeGradientEffectSchema: () => PxStrokeGradientEffectSchema,
+  PxScrollSource: () => PxScrollSource,
+  PxStartOn: () => PxStartOn,
   PxStrokeTrimEffectSchema: () => PxStrokeTrimEffectSchema,
   PxStrokeTrimSubPaths: () => PxStrokeTrimSubPaths,
   PxSvgNodeExtra: () => PxSvgNodeExtra,
   PxTextEffectSchema: () => PxTextEffectSchema,
   PxTextPathEffectSchema: () => PxTextPathEffectSchema,
+  PxTextPathMethod: () => PxTextPathMethod,
+  PxTextPathSpacing: () => PxTextPathSpacing,
   PxTimelineEngine: () => PxTimelineEngine,
   PxTimelineEngineExtra: () => PxTimelineEngineExtra,
-  PxTimelinePinSchema: () => PxTimelinePinSchema,
   PxTimelineSchema: () => PxTimelineSchema,
   PxTransformByEffectSchema: () => PxTransformByEffectSchema,
   PxTransformPartsSchema: () => PxTransformPartsSchema,
   PxTransformValueSchema: () => PxTransformValueSchema,
   PxTriggerSchema: () => PxTriggerSchema,
+  PxUnits: () => PxUnits,
   STYLE_ATTR_NAMES: () => STYLE_ATTR_NAMES,
-  TEXT_ATTR: () => TEXT_ATTR,
   TEXT_CONTENT_ATTR: () => TEXT_CONTENT_ATTR,
   TRANSFORM_FN_NAMES: () => TRANSFORM_FN_NAMES,
   WIRE_VERSION_KEY: () => WIRE_VERSION_KEY,
@@ -121,17 +134,19 @@ __export(index_exports, {
   applyAnimatorConfig: () => applyAnimatorConfig,
   applyPlayerEffects: () => applyPlayerEffects,
   applyWireSteps: () => applyWireSteps,
-  applyWireStepsDown: () => applyWireStepsDown,
   bezierToSvgPath: () => bezierToSvgPath,
   calcAnimationValues: () => calcAnimationValues,
   camelCaseToKebabWordIfNeeded: () => camelCaseToKebabWordIfNeeded,
   clamp: () => clamp,
-  collectSampleTimes: () => collectSampleTimes,
+  clampSeekMs: () => clampSeekMs,
   compareWireVersion: () => compareWireVersion,
   composeTransformParts: () => composeTransformParts,
+  controlModeTakesOverTrigger: () => controlModeTakesOverTrigger,
   convertPlayerDocument: () => convertPlayerDocument,
   createBasicFrameLoopAnimator: () => createBasicFrameLoopAnimator,
+  createDiagnostics: () => createDiagnostics,
   createPathSampler: () => createPathSampler,
+  createRunClock: () => createRunClock,
   cubicBezier: () => cubicBezier,
   deepClone: () => deepClone,
   describeSchema: () => describeSchema,
@@ -139,10 +154,9 @@ __export(index_exports, {
   diffFieldUniverse: () => diffFieldUniverse,
   diffInEffect: () => diffInEffect,
   downgradePlayerDocument: () => downgradePlayerDocument,
-  evaluateMotionPathSegment: () => evaluateMotionPathSegment,
   extendedPathForBrowser: () => extendedPathForBrowser,
   flattenAnimatorTimeline: () => flattenAnimatorTimeline,
-  foldAnimatorConfigShortcuts: () => foldAnimatorConfigShortcuts,
+  foldTimelineOverride: () => foldTimelineOverride,
   formatWireVersion: () => formatWireVersion,
   generateNewIds: () => generateNewIds,
   generateUniqueId: () => generateUniqueId,
@@ -150,47 +164,39 @@ __export(index_exports, {
   getBindings: () => getBindings,
   getChildren: () => getChildren,
   getDefs: () => getDefs,
-  getNormalisedBindings: () => getNormalisedBindings,
+  getNormalizedBindings: () => getNormalizedBindings,
   getNormalizedProps: () => getNormalizedProps,
-  interpolateBeziers: () => interpolateBeziers,
   interpolateValue: () => interpolateValue,
   isNativeForced: () => isNativeForced,
   isPxElementFileFormat: () => isPxElementFileFormat,
   isPxElementFileFormatDeep: () => isPxElementFileFormatDeep,
   isScrollTimeline: () => isScrollTimeline,
-  jsonElementFactory: () => jsonElementFactory,
+  isValidPlaybackRate: () => isValidPlaybackRate,
   kebabToCamelCaseWord: () => kebabToCamelCaseWord,
   kfEasing: () => kfEasing,
-  kfTangentIn: () => kfTangentIn,
-  kfTangentOut: () => kfTangentOut,
-  kfTime: () => kfTime,
   kfValue: () => kfValue,
   layoutGlyphTextChars: () => layoutGlyphTextChars,
-  materialiseAllInTree: () => materialiseAllInTree,
-  materialiseAnimatedUseInstances: () => materialiseAnimatedUseInstances,
-  materialiseGlyphText: () => materialiseGlyphText,
-  materialiseGlyphTextAlongPath: () => materialiseGlyphTextAlongPath,
-  materialiseGlyphTextHorizontal: () => materialiseGlyphTextHorizontal,
-  materialiseInternalLoopsInPropAnim: () => materialiseInternalLoopsInPropAnim,
-  materialiseInternalLoopsInTree: () => materialiseInternalLoopsInTree,
-  materialiseMotionPathInPropAnim: () => materialiseMotionPathInPropAnim,
-  materialiseMotionPathsInTree: () => materialiseMotionPathsInTree,
+  materializeAllInTree: () => materializeAllInTree,
+  materializeGlyphText: () => materializeGlyphText,
+  materializeGlyphTextAlongPath: () => materializeGlyphTextAlongPath,
+  materializeMotionPathInPropAnim: () => materializeMotionPathInPropAnim,
   mayUseNativeScrollTimeline: () => mayUseNativeScrollTimeline,
   mergeAnimatorConfig: () => mergeAnimatorConfig,
   mergeStaticTransformIntoAnimDef: () => mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline: () => nestAnimatorTimeline,
-  parseTransformParts: () => parseTransformParts,
   parseWireVersion: () => parseWireVersion,
   planSchemaRelease: () => planSchemaRelease,
-  propAnimIsMotionPath: () => propAnimIsMotionPath,
+  progressSpanMs: () => progressSpanMs,
+  progressToTimeMs: () => progressToTimeMs,
   px: () => px,
   readWireVersion: () => readWireVersion,
   releaseLogProblems: () => releaseLogProblems,
   reportDocumentDiagnostics: () => reportDocumentDiagnostics,
-  resolveStyle: () => resolveStyle,
+  resolveControlMode: () => resolveControlMode,
   resolveTimelineEngine: () => resolveTimelineEngine,
+  resolveTrigger: () => resolveTrigger,
   reverseEasing: () => reverseEasing,
-  sanitiseAttributeValue: () => sanitiseAttributeValue,
+  sanitizeAttributeValue: () => sanitizeAttributeValue,
   schemaFieldUniverse: () => schemaFieldUniverse,
   schemaKeys: () => schemaKeys,
   scrollOffsetProgress: () => scrollOffsetProgress,
@@ -198,608 +204,104 @@ __export(index_exports, {
   scrollResolveAxis: () => scrollResolveAxis,
   scrollTotalDurationMs: () => scrollTotalDurationMs,
   scrollViewProgress: () => scrollViewProgress,
-  shiftAnimatable: () => shiftAnimatable,
+  seekCeilingMs: () => seekCeilingMs,
   splitEasing: () => splitEasing,
   subdivideCubicBezier: () => subdivideCubicBezier,
+  timeToProgress: () => timeToProgress,
   toRGBA: () => toRGBA,
   validateDocument: () => validateDocument,
   validateNodeEffects: () => validateNodeEffects,
-  versionAdvice: () => versionAdvice,
-  visualModelAt: () => visualModelAt
+  versionAdvice: () => versionAdvice
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/util/PxAnimatorUtil.ts
-function bezierToSvgPath(path, forceCurves = false) {
-  var _a2, _b, _c, _d;
-  const v = path.v;
-  const i = path.i;
-  const o = path.o;
-  const c = path.c;
-  if (!v.length) return "";
-  const d = [];
-  const len = v.length;
-  d.push("M" + v[0][0] + "," + v[0][1]);
-  for (let idx = 1; idx < len; idx++) {
-    const prevV = v[idx - 1];
-    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]);
-    if (isLine) {
-      d.push("L" + currV[0] + "," + currV[1]);
-    } else {
-      d.push("C" + prevO[0] + "," + prevO[1] + "," + currI[0] + "," + currI[1] + "," + currV[0] + "," + currV[1]);
-    }
-  }
-  if (c && len > 0) {
-    const lastV = v[len - 1];
-    const lastO = (_c = o == null ? void 0 : o[len - 1]) != null ? _c : lastV;
-    const firstI = (_d = i == null ? void 0 : i[0]) != null ? _d : v[0];
-    const firstV = v[0];
-    const isLine = !forceCurves && (lastO[0] === lastV[0] && lastO[1] === lastV[1]) && (firstI[0] === firstV[0] && firstI[1] === firstV[1]);
-    if (!isLine) {
-      d.push("C" + lastO[0] + "," + lastO[1] + "," + firstI[0] + "," + firstI[1] + "," + firstV[0] + "," + firstV[1]);
-    }
-    d.push("z");
+// src/schema/PxSchema.ts
+var PX_UNKNOWN_KEY_ERROR = "unexpected extra key";
+function pathStr(path) {
+  if (!path.length) return ".";
+  let result = "";
+  for (const seg of path) {
+    if (seg.startsWith("[")) result += seg;
+    else result += (result ? "." : "") + seg;
   }
-  return d.join("");
-}
-function interpolateNum(a, b, t) {
-  return a + (b - a) * t;
+  return result;
 }
-function interpolateVec(a, b, t) {
-  const res = [];
-  const count = Math.max(a.length, b.length);
-  for (let i = 0; i < count; i++) {
-    res[i] = interpolateNum(a[i] || 0, b[i] || 0, t);
+var Base = class {
+  _canSanitize(raw) {
+    return this.isValid(raw);
   }
-  return res;
-}
-function interpolateColor(a, b, t) {
-  return [
-    interpolateNum(a[0] || 0, b[0] || 0, t),
-    interpolateNum(a[1] || 0, b[1] || 0, t),
-    interpolateNum(a[2] || 0, b[2] || 0, t),
-    interpolateNum(a[3] === void 0 ? 1 : a[3], b[3] === void 0 ? 1 : b[3], t)
-  ];
-}
-function interpolateBeziers(paths1, paths2, progress) {
-  const count = Math.max(paths1.length, paths2.length);
-  const res = [];
-  for (let i = 0; i < count; i++) {
-    res.push(interpolateBezier(paths1[i], paths2[i], progress));
+  optional() {
+    return new Optional(this);
   }
-  return res;
-}
-function interpolateBezier(path1, path2, progress) {
-  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);
-  const v = [];
-  const i = [];
-  const o = [];
-  for (let idx = 0; idx < len; idx++) {
-    const v1 = path1.v[idx];
-    const v2 = path2.v[idx];
-    v.push(interpolateVec(v1, v2, t));
-    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;
-    const o2 = (_h = (_g = path2.o) == null ? void 0 : _g[idx]) != null ? _h : v2;
-    o.push(interpolateVec(o1, o2, t));
+};
+var Optional = class extends Base {
+  constructor(inner) {
+    super();
+    this.inner = inner;
+    this._default = void 0;
   }
-  return { v, i: i.length ? i : void 0, o: o.length ? o : void 0, c: (_i = path1.c) != null ? _i : path2.c };
-}
-function remap(value, inMin, inMax, outMin, outMax) {
-  if (inMax === inMin) return outMin;
-  const t = (value - inMin) / (inMax - inMin);
-  return outMin + t * (outMax - outMin);
-}
-function solveCubicBezierX(p1x, p2x, x) {
-  if (x <= 0) return 0;
-  if (x >= 1) return 1;
-  const cx = 3 * p1x;
-  const bx = 3 * (p2x - p1x) - cx;
-  const ax = 1 - cx - bx;
-  function sampleX(t) {
-    return ((ax * t + bx) * t + cx) * t;
+  sanitize(raw) {
+    if (raw === void 0 || raw === null) return void 0;
+    return this.inner._canSanitize(raw) ? this.inner.sanitize(raw) : void 0;
   }
-  function sampleDX(t) {
-    return (3 * ax * t + 2 * bx) * t + cx;
+  isValid(raw, ctx, path) {
+    if (raw === void 0 || raw === null) return true;
+    return this.inner.isValid(raw, ctx, path);
   }
-  let t2 = x;
-  let t0 = 0;
-  let t1 = 1;
-  for (let i = 0; i < 8; i++) {
-    const x2 = sampleX(t2) - x;
-    if (Math.abs(x2) < 1e-6) return t2;
-    const d2 = sampleDX(t2);
-    if (Math.abs(d2) < 1e-6) break;
-    t2 -= x2 / d2;
+  _canSanitize(raw) {
+    return raw === void 0 || raw === null || this.inner._canSanitize(raw);
   }
-  t2 = x;
-  while (t0 < t1) {
-    const x2 = sampleX(t2);
-    if (Math.abs(x2 - x) < 1e-6) return t2;
-    if (x > x2) t0 = t2;
-    else t1 = t2;
-    t2 = (t1 + t0) / 2;
+};
+var Str = class extends Base {
+  constructor(_default = "") {
+    super();
+    this._default = _default;
   }
-  return t2;
-}
-function cubicBezier(easing) {
-  const [p1x, p1y, p2x, p2y] = easing;
-  const cy = 3 * p1y;
-  const by = 3 * (p2y - p1y) - cy;
-  const ay = 1 - cy - by;
-  function sampleCurveY(t) {
-    return ((ay * t + by) * t + cy) * t;
+  sanitize(raw) {
+    return typeof raw === "string" ? raw : this._default;
   }
-  return function(x) {
-    return sampleCurveY(solveCubicBezierX(p1x, p2x, x));
-  };
-}
-function lerp2(a, b, t) {
-  return [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
-}
-function subdivideCubicBezier(p0, p1, p2, p3, t) {
-  const q0 = lerp2(p0, p1, t);
-  const q1 = lerp2(p1, p2, t);
-  const q2 = lerp2(p2, p3, t);
-  const r0 = lerp2(q0, q1, t);
-  const r1 = lerp2(q1, q2, t);
-  const s = lerp2(r0, r1, t);
-  return {
-    left: [p0, q0, r0, s],
-    right: [s, r1, q2, p3]
-  };
-}
-function splitEasing(easing, xFraction) {
-  if (!easing) return { left: void 0, right: void 0 };
-  if (xFraction <= 0) return { left: void 0, right: easing };
-  if (xFraction >= 1) return { left: easing, right: void 0 };
-  const [x1, y1, x2, y2] = easing;
-  const t = solveCubicBezierX(x1, x2, xFraction);
-  const p0 = [0, 0];
-  const p1 = [x1, y1];
-  const p2 = [x2, y2];
-  const p3 = [1, 1];
-  const { left, right } = subdivideCubicBezier(p0, p1, p2, p3, t);
-  const sx = left[3][0];
-  const sy = left[3][1];
-  let leftEasing;
-  if (sx > 1e-9 && Math.abs(sy) > 1e-9) {
-    leftEasing = [
-      left[1][0] / sx,
-      left[1][1] / sy,
-      left[2][0] / sx,
-      left[2][1] / sy
-    ];
+  isValid(raw, ctx, path) {
+    if (typeof raw === "string") return true;
+    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected string, got " + typeof raw);
+    return false;
   }
-  let rightEasing;
-  const rx = 1 - sx;
-  const ry = 1 - sy;
-  if (rx > 1e-9 && Math.abs(ry) > 1e-9) {
-    rightEasing = [
-      (right[1][0] - sx) / rx,
-      (right[1][1] - sy) / ry,
-      (right[2][0] - sx) / rx,
-      (right[2][1] - sy) / ry
-    ];
+};
+var Num = class extends Base {
+  constructor(_default = 0) {
+    super();
+    this._default = _default;
   }
-  return { left: leftEasing, right: rightEasing };
-}
-function reverseEasing(easing) {
-  if (!easing) return void 0;
-  return [1 - easing[2], 1 - easing[3], 1 - easing[0], 1 - easing[1]];
-}
-function toRGBA(color) {
-  const r = Math.round(color[0] * 255);
-  const g = Math.round(color[1] * 255);
-  const b = Math.round(color[2] * 255);
-  return color.length === 4 ? "rgba(" + r + "," + g + "," + b + "," + color[3] + ")" : "rgb(" + r + "," + g + "," + b + ")";
-}
-function parseRgba(s) {
-  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]] : []];
-}
-function parseHex(s) {
-  const hex = s.slice(1);
-  const isShort = hex.length <= 4;
-  const r = isShort ? hex[0] + hex[0] : hex.slice(0, 2);
-  const g = isShort ? hex[1] + hex[1] : hex.slice(2, 4);
-  const b = isShort ? hex[2] + hex[2] : hex.slice(4, 6);
-  const a = hex.length === 4 ? hex[3] + hex[3] : hex.length === 8 ? hex.slice(6, 8) : null;
-  const result = [
-    parseInt(r, 16) / 255,
-    parseInt(g, 16) / 255,
-    parseInt(b, 16) / 255
-  ];
-  if (a !== null) {
-    result.push(parseInt(a, 16) / 255);
+  sanitize(raw) {
+    return typeof raw === "number" && isFinite(raw) ? raw : this._default;
   }
-  return result;
-}
-function parseColor(s) {
-  if (!s) return void 0;
-  if (Array.isArray(s)) return s;
-  if (typeof s !== "string") return void 0;
-  if (s.startsWith("#")) {
-    return parseHex(s);
-  } else if (s.startsWith("rgb")) {
-    return parseRgba(s);
-  } else {
-    console.warn("Unsupported color format: " + s);
+  isValid(raw, ctx, path) {
+    if (typeof raw === "number" && isFinite(raw)) return true;
+    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected finite number, got " + JSON.stringify(raw));
+    return false;
   }
-  return void 0;
-}
-var COLOUR_ATTR_NAMES = /* @__PURE__ */ new Set(["color", "fill", "flood-color", "lighting-color", "stop-color", "stroke"]);
-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 _a2;
-  if (!parts) return "";
-  const withUnits = (_a2 = opts == null ? void 0 : opts.withUnits) != null ? _a2 : true;
-  const segs = [];
-  const t = parts.translate;
-  const o = parts.origin;
-  const r = parts.rotate;
-  const k = parts.skew;
-  const s = parts.scale;
-  const tu = withUnits ? "px" : "";
-  const ru = withUnits ? "deg" : "";
-  if (t) segs.push("translate(" + t[0] + tu + "," + t[1] + tu + ")");
-  if (o) segs.push("translate(" + o[0] + tu + "," + o[1] + tu + ")");
-  if (r !== void 0 && r !== null) segs.push("rotate(" + r + ru + ")");
-  if (k !== void 0 && k !== null) segs.push("skewX(" + k + ru + ")");
-  if (s) segs.push("scale(" + s[0] + "," + s[1] + ")");
-  if (o) segs.push("translate(" + -o[0] + tu + "," + -o[1] + tu + ")");
-  return segs.join("");
-}
-function parseTransformParts(str2) {
-  var _a2, _b;
-  if (!str2 || typeof str2 !== "string") return void 0;
-  const out = {};
-  const re = /([a-zA-Z]+)\s*\(([^)]*)\)/g;
-  const order = ["translate", "rotate", "skewX", "scale"];
-  let lastIdx = -1;
-  let m;
-  while ((m = re.exec(str2)) !== null) {
-    const fn = m[1];
-    const idx = order.indexOf(fn);
-    if (idx < 0 || idx <= lastIdx) return void 0;
-    lastIdx = idx;
-    const nums = m[2].split(/[\s,]+/).filter(Boolean).map(Number);
-    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], (_a2 = nums[1]) != null ? _a2 : 0];
-    } else if (fn === "rotate") {
-      if (nums.length !== 1) return void 0;
-      out.rotate = nums[0];
-    } else if (fn === "skewX") {
-      if (nums.length !== 1) return void 0;
-      out.skew = nums[0];
-    } else {
-      if (nums.length < 1 || nums.length > 2) return void 0;
-      out.scale = [nums[0], (_b = nums[1]) != null ? _b : nums[0]];
-    }
+};
+var Bool = class extends Base {
+  constructor(_default = false) {
+    super();
+    this._default = _default;
   }
-  if (str2.replace(/([a-zA-Z]+)\s*\(([^)]*)\)/g, "").replace(/[\s,]/g, "").length) return void 0;
-  return Object.keys(out).length ? out : void 0;
-}
-var STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
-var DEFAULT_DURATION_MS = 1e3;
-function kebabToCamelCaseWord(kebab) {
-  return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
-}
-function isCamelCaseWord(word) {
-  return !word.includes("-") && /[a-z][A-Z]/.test(word);
-}
-var SVG_CAMEL_CASE_ATTRS = /* @__PURE__ */ new Set([
-  // Transform/positioning
-  "viewBox",
-  "preserveAspectRatio",
-  // Gradient
-  "gradientUnits",
-  "gradientTransform",
-  "spreadMethod",
-  // Pattern
-  "patternUnits",
-  "patternContentUnits",
-  "patternTransform",
-  // Clipping/masking
-  "clipPathUnits",
-  "maskUnits",
-  "maskContentUnits",
-  // Marker  (SVG spec keeps these camelCase, like viewBox)
-  "markerUnits",
-  "markerWidth",
-  "markerHeight",
-  "refX",
-  "refY",
-  // Text
-  "textLength",
-  "lengthAdjust",
-  "startOffset",
-  // Filter
-  "filterUnits",
-  "primitiveUnits",
-  "tableValues",
-  // feFuncR/G/B/A transfer table (type="table")
-  "stdDeviation",
-  "baseFrequency",
-  "numOctaves",
-  "surfaceScale",
-  "diffuseConstant",
-  "specularConstant",
-  "specularExponent",
-  "kernelMatrix",
-  "kernelUnitLength",
-  "edgeMode",
-  "preserveAlpha",
-  "targetX",
-  "targetY"
-  // // Animation
-  // 'attributeName',
-  // 'attributeType',
-  // 'calcMode',
-  // 'keyTimes',
-  // 'keySplines',
-  // 'repeatCount',
-  // 'repeatDur'    
-]);
-function camelCaseToKebabWordIfNeeded(camel) {
-  return SVG_CAMEL_CASE_ATTRS.has(camel) ? camel : camel.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
-}
-function clamp(value, min, max) {
-  return Math.max(min, Math.min(value, max));
-}
-function bezier2D_pointAt(P0, P1, P2, P3, t) {
-  if (t <= 0) return [P0[0], P0[1]];
-  if (t >= 1) return [P3[0], P3[1]];
-  const u = 1 - t;
-  const u2 = u * u;
-  const u3 = u2 * u;
-  const t2 = t * t;
-  const t3 = t2 * t;
-  const w0 = u3;
-  const w1 = 3 * t * u2;
-  const w2 = 3 * t2 * u;
-  const w3 = t3;
-  return [
-    w0 * P0[0] + w1 * P1[0] + w2 * P2[0] + w3 * P3[0],
-    w0 * P0[1] + w1 * P1[1] + w2 * P2[1] + w3 * P3[1]
-  ];
-}
-var BEZIER_T_NUDGE = 1e-4;
-function bezier2D_derivativeAt(P0, P1, P2, P3, t) {
-  const result = _bezier2D_derivativeAtRaw(P0, P1, P2, P3, t);
-  if (result[0] === 0 && result[1] === 0) {
-    const nudgedT = t < 0.5 ? t + BEZIER_T_NUDGE : t - BEZIER_T_NUDGE;
-    return _bezier2D_derivativeAtRaw(P0, P1, P2, P3, nudgedT);
+  sanitize(raw) {
+    return typeof raw === "boolean" ? raw : this._default;
   }
-  return result;
-}
-function _bezier2D_derivativeAtRaw(P0, P1, P2, P3, t) {
-  const u = 1 - t;
-  const a = 3 * u * u;
-  const b = 6 * t * u;
-  const c = 3 * t * t;
-  return [
-    a * (P1[0] - P0[0]) + b * (P2[0] - P1[0]) + c * (P3[0] - P2[0]),
-    a * (P1[1] - P0[1]) + b * (P2[1] - P1[1]) + c * (P3[1] - P2[1])
-  ];
-}
-function bezier2D_arcLengthLUT(P0, P1, P2, P3, steps = 100) {
-  const n = steps + 1;
-  const ts = new Float64Array(n);
-  const ds = new Float64Array(n);
-  let prev = bezier2D_pointAt(P0, P1, P2, P3, 0);
-  ts[0] = 0;
-  ds[0] = 0;
-  let cum = 0;
-  for (let i = 1; i < n; i++) {
-    const t = i / steps;
-    const cur = bezier2D_pointAt(P0, P1, P2, P3, t);
-    const dx = cur[0] - prev[0];
-    const dy = cur[1] - prev[1];
-    cum += Math.sqrt(dx * dx + dy * dy);
-    ts[i] = t;
-    ds[i] = cum;
-    prev = cur;
+  isValid(raw, ctx, path) {
+    if (typeof raw === "boolean") return true;
+    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected boolean, got " + typeof raw);
+    return false;
   }
-  return { ts, ds };
-}
-function bezier2D_tForDistance(lut, distance) {
-  const { ts, ds } = lut;
-  const last = ds.length - 1;
-  if (distance <= 0) return ts[0];
-  if (distance >= ds[last]) return ts[last];
-  let lo = 1;
-  let hi = last;
-  while (lo < hi) {
-    const mid = lo + hi >>> 1;
-    if (ds[mid] < distance) lo = mid + 1;
-    else hi = mid;
+};
+var Literal = class extends Base {
+  constructor(value) {
+    super();
+    this.value = value;
+    this._default = value;
   }
-  const dPrev = ds[hi - 1];
-  const dCur = ds[hi];
-  const span = dCur - dPrev;
-  const frac = span > 0 ? (distance - dPrev) / span : 0;
-  return ts[hi - 1] + frac * (ts[hi] - ts[hi - 1]);
-}
-function bezier2D_arcAtT(lut, t) {
-  const { ts, ds } = lut;
-  const last = ts.length - 1;
-  if (t <= ts[0]) return ds[0];
-  if (t >= ts[last]) return ds[last];
-  let lo = 1, hi = last;
-  while (lo < hi) {
-    const mid = lo + hi >>> 1;
-    if (ts[mid] < t) lo = mid + 1;
-    else hi = mid;
-  }
-  const tPrev = ts[hi - 1];
-  const span = ts[hi] - tPrev;
-  const frac = span > 0 ? (t - tPrev) / span : 0;
-  return ds[hi - 1] + frac * (ds[hi] - ds[hi - 1]);
-}
-function invertEasing(easing) {
-  if (!easing) return (y) => y;
-  const flipped = [easing[1], easing[0], easing[3], easing[2]];
-  return cubicBezier(flipped);
-}
-
-// src/playback/PxScrollMath.ts
-function isScrollTimeline(config) {
-  return (config == null ? void 0 : config.timelineSource) === "scroll";
-}
-function scrollTotalDurationMs(config) {
-  const duration = typeof (config == null ? void 0 : config.duration) === "number" && config.duration > 0 ? config.duration : DEFAULT_DURATION_MS;
-  const iterations = typeof (config == null ? void 0 : config.iterations) === "number" && config.iterations > 0 ? config.iterations : 1;
-  return duration * iterations;
-}
-function scrollPhaseInterval(phase, subjectSize, scrollportSize) {
-  const s = subjectSize, vp = scrollportSize;
-  switch (phase) {
-    case "cover":
-      return [0, s + vp];
-    case "entry":
-      return [0, Math.min(s, vp)];
-    case "contain":
-      return [Math.min(s, vp), Math.max(s, vp)];
-    case "exit":
-      return [Math.max(s, vp), s + vp];
-    case "entry-crossing":
-      return [0, s];
-    case "exit-crossing":
-      return [vp, s + vp];
-  }
-}
-var DEFAULT_PHASE = "cover";
-function resolveRangePointU(point, defaultFraction, 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);
-}
-function scrollViewProgress(subjectStart, subjectSize, scrollportSize, range) {
-  const u = scrollportSize - subjectStart;
-  const uStart = resolveRangePointU(range == null ? void 0 : range.start, 0, subjectSize, scrollportSize);
-  const uEnd = resolveRangePointU(range == null ? void 0 : range.end, 1, subjectSize, scrollportSize);
-  if (uEnd <= uStart) return u >= uEnd ? 1 : 0;
-  return clamp((u - uStart) / (uEnd - uStart), 0, 1);
-}
-function scrollOffsetProgress(offset, maxOffset, range) {
-  var _a2, _b;
-  const raw = maxOffset > 0 ? clamp(offset / maxOffset, 0, 1) : 1;
-  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);
-}
-function scrollResolveAxis(axis, writingMode) {
-  const a = axis != null ? axis : "block";
-  if (a === "x" || a === "y") return a;
-  const vertical = !!writingMode && writingMode.startsWith("vertical");
-  if (a === "inline") return vertical ? "y" : "x";
-  return vertical ? "x" : "y";
-}
-
-// src/schema/PxSchema.ts
-var PX_UNKNOWN_KEY_ERROR = "unexpected extra key";
-function pathStr(path) {
-  if (!path.length) return ".";
-  let result = "";
-  for (const seg of path) {
-    if (seg.startsWith("[")) result += seg;
-    else result += (result ? "." : "") + seg;
-  }
-  return result;
-}
-var Base = class {
-  _canSanitize(raw) {
-    return this.isValid(raw);
-  }
-  optional() {
-    return new Optional(this);
-  }
-};
-var Optional = class extends Base {
-  constructor(inner) {
-    super();
-    this.inner = inner;
-    this._default = void 0;
-  }
-  sanitize(raw) {
-    if (raw === void 0 || raw === null) return void 0;
-    return this.inner._canSanitize(raw) ? this.inner.sanitize(raw) : void 0;
-  }
-  isValid(raw, ctx, path) {
-    if (raw === void 0 || raw === null) return true;
-    return this.inner.isValid(raw, ctx, path);
-  }
-  _canSanitize(raw) {
-    return raw === void 0 || raw === null || this.inner._canSanitize(raw);
-  }
-};
-var Str = class extends Base {
-  constructor(_default = "") {
-    super();
-    this._default = _default;
-  }
-  sanitize(raw) {
-    return typeof raw === "string" ? raw : this._default;
-  }
-  isValid(raw, ctx, path) {
-    if (typeof raw === "string") return true;
-    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected string, got " + typeof raw);
-    return false;
-  }
-};
-var Num = class extends Base {
-  constructor(_default = 0) {
-    super();
-    this._default = _default;
-  }
-  sanitize(raw) {
-    return typeof raw === "number" && isFinite(raw) ? raw : this._default;
-  }
-  isValid(raw, ctx, path) {
-    if (typeof raw === "number" && isFinite(raw)) return true;
-    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected finite number, got " + JSON.stringify(raw));
-    return false;
-  }
-};
-var Bool = class extends Base {
-  constructor(_default = false) {
-    super();
-    this._default = _default;
-  }
-  sanitize(raw) {
-    return typeof raw === "boolean" ? raw : this._default;
-  }
-  isValid(raw, ctx, path) {
-    if (typeof raw === "boolean") return true;
-    ctx == null ? void 0 : ctx.errors.push(pathStr(path != null ? path : []) + ": expected boolean, got " + typeof raw);
-    return false;
-  }
-};
-var Literal = class extends Base {
-  constructor(value) {
-    super();
-    this.value = value;
-    this._default = value;
-  }
-  sanitize(raw) {
-    return raw === this.value ? this.value : this._default;
+  sanitize(raw) {
+    return raw === this.value ? this.value : this._default;
   }
   isValid(raw, ctx, path) {
     if (raw === this.value) return true;
@@ -822,6 +324,7 @@ var Enum = class extends Base {
     return false;
   }
 };
+var UNION_MEMBER_ERROR_LIMIT = 4;
 var Union = class extends Base {
   constructor(schemas, defaultVal) {
     super();
@@ -840,7 +343,35 @@ var Union = class extends Base {
     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 " + ((_a2 = JSON.stringify(raw)) != null ? _a2 : "").slice(0, 240));
+    if (!ctx) return false;
+    const base = pathStr(path != null ? path : []);
+    ctx.errors.push(base + ": no union member matched for value " + ((_a2 = JSON.stringify(raw)) != null ? _a2 : "").slice(0, 240));
+    let best;
+    let bestDepth = -1;
+    const leafExpectations = [];
+    for (const member of this.schemas) {
+      const sink = { errors: [], warnings: [], strict: ctx.strict };
+      member.isValid(raw, sink, path ? [...path] : void 0);
+      if (!sink.errors.length) continue;
+      const depth = Math.max(...sink.errors.map((e) => e.slice(0, e.indexOf(":")).length));
+      if (depth > bestDepth || depth === bestDepth && best && sink.errors.length < best.length) {
+        bestDepth = depth;
+        best = sink.errors;
+      }
+      if (depth <= base.length) {
+        for (const e of sink.errors) {
+          const m = /: expected (.+?), got /.exec(e);
+          if (m && !leafExpectations.includes(m[1])) leafExpectations.push(m[1]);
+        }
+      }
+    }
+    if (best && bestDepth > base.length) {
+      for (const e of best.slice(0, UNION_MEMBER_ERROR_LIMIT)) {
+        if (!ctx.errors.includes(e)) ctx.errors.push(e);
+      }
+    } else if (leafExpectations.length) {
+      ctx.errors.push(base + ": expected " + leafExpectations.join(" | "));
+    }
     return false;
   }
   _canSanitize(raw) {
@@ -1395,150 +926,139 @@ 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;
-    }
+// src/format/PxAnimatorConstants.ts
+var PxFillMode = {
+  forwards: "forwards",
+  backwards: "backwards",
+  both: "both",
+  none: "none"
+};
+var PxPlaybackDirection = {
+  normal: "normal",
+  reverse: "reverse",
+  alternate: "alternate",
+  alternateReverse: "alternate-reverse"
+};
+var PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
+var PX_ANIM_ATTR_NAME = "_px_animator";
+var PxStartOn = {
+  load: "load",
+  mouseOver: "mouseOver",
+  click: "click",
+  scrollIntoView: "scrollIntoView",
+  programmatic: "programmatic"
+};
+var PxOutAction = {
+  continue: "continue",
+  pause: "pause",
+  reset: "reset",
+  reverse: "reverse"
+};
+var PxFinishAction = {
+  hold: "hold",
+  reset: "reset"
+};
+var PxScrollKind = {
+  view: "view",
+  scroll: "scroll"
+};
+var PxScrollAxis = {
+  block: "block",
+  inline: "inline",
+  x: "x",
+  y: "y"
+};
+var PxScrollSource = {
+  nearest: "nearest",
+  root: "root"
+};
+var PxPinAlign = {
+  top: "top",
+  center: "center",
+  bottom: "bottom"
+};
+var PxScrollPhase = {
+  cover: "cover",
+  contain: "contain",
+  entry: "entry",
+  exit: "exit",
+  entryCrossing: "entry-crossing",
+  exitCrossing: "exit-crossing"
+};
+var PxAlongPathMode = {
+  sampled: "sampled",
+  offsetPath: "offsetPath"
+};
+var PX_TIMELINE_SHARED_KEYS = ["duration", "iterations", "engine", "frameRate"];
+var PX_TIME_ONLY_TIMELINE_KEYS = ["trigger", "delay", "fillMode", "direction"];
+var PX_FLAT_RUNTIME_VIEW_KEYS = [
+  ...PX_TIMELINE_SHARED_KEYS,
+  ...PX_TIME_ONLY_TIMELINE_KEYS,
+  "fill",
+  "resetOnFinish",
+  "timelineSource",
+  "scroll"
+];
+var PxTimelineEngine = {
+  native: "native",
+  js: "js"
+};
+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 PX_TRIGGER_DEFAULTS = {
+  startOn: "load",
+  outAction: "continue",
+  scrollIntoViewThreshold: 0
+};
+var PxControlMode = {
+  /** No control props — the document's trigger decides, and nothing is taken over. */
+  static: "static",
+  /** `progress` / `time` — the host scrubs; the component seeks and stays paused. */
+  fixedTime: "fixedTime",
+  /** `play` / `pause` — the host drives playback with booleans. */
+  play: "play",
+  /** `autoplay` — the document's own trigger starts it. */
+  autoplay: "autoplay"
+};
+function resolveControlMode(props) {
+  const hasFixedTime = props.progress !== void 0 || props.time !== void 0;
+  const hasPlayPause = props.play !== void 0 || props.pause !== void 0;
+  const hasAutoplay = !!props.autoplay;
+  const warnings = [];
+  const named = (a, b, winner) => a + " and " + b + " were both set \u2014 " + winner + " wins, " + (winner === a ? b : a) + " is ignored.";
+  if (hasFixedTime) {
+    if (hasPlayPause) warnings.push(named("progress/time", "play/pause", "progress/time"));
+    if (hasAutoplay) warnings.push(named("progress/time", "autoplay", "progress/time"));
+    return { mode: PxControlMode.fixedTime, warnings };
   }
-  return [...fields].sort();
+  if (hasPlayPause) {
+    if (hasAutoplay) warnings.push(named("play/pause", "autoplay", "play/pause"));
+    return { mode: PxControlMode.play, warnings };
+  }
+  if (hasAutoplay) return { mode: PxControlMode.autoplay, warnings };
+  return { mode: PxControlMode.static, warnings };
 }
-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);
+function controlModeTakesOverTrigger(mode) {
+  return mode !== PxControlMode.autoplay;
 }
-
-// src/version/PxSchemaRelease.ts
-function diffFieldUniverse(previous, current) {
-  const prev = new Set(previous);
-  const cur = new Set(current);
+function resolveTrigger(trigger) {
+  var _a2, _b, _c;
   return {
-    added: current.filter((k) => !prev.has(k)).sort(),
-    removed: previous.filter((k) => !cur.has(k)).sort()
+    startOn: (_a2 = trigger == null ? void 0 : trigger.startOn) != null ? _a2 : PX_TRIGGER_DEFAULTS.startOn,
+    outAction: (_b = trigger == null ? void 0 : trigger.outAction) != null ? _b : PX_TRIGGER_DEFAULTS.outAction,
+    scrollIntoViewThreshold: (_c = trigger == null ? void 0 : trigger.scrollIntoViewThreshold) != null ? _c : PX_TRIGGER_DEFAULTS.scrollIntoViewThreshold
   };
 }
-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 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 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). */
@@ -1585,7 +1105,6 @@ var PxStrokeTrimSubPaths = {
   separate: "separate",
   combined: "combined"
 };
-var TEXT_ATTR = "text";
 var TEXT_CONTENT_ATTR = "textContent";
 var CLASS_ATTR = "class";
 var TRANSFORM_ATTR = "transform";
@@ -1597,7 +1116,6 @@ var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   "meta",
   "animate",
   "effects",
-  TEXT_ATTR,
   TEXT_CONTENT_ATTR
 ]);
 var TRANSFORM_PART = {
@@ -1612,10 +1130,6 @@ var PX_TRANSFORM_PART_KEYS = [
   TRANSFORM_PART.scale,
   TRANSFORM_PART.origin
 ];
-var PxGradientUnits = {
-  userSpaceOnUse: "userSpaceOnUse",
-  objectBoundingBox: "objectBoundingBox"
-};
 var PxGradientSpreadMethod = {
   pad: "pad",
   reflect: "reflect",
@@ -1634,8 +1148,18 @@ function isPxElementFileFormat(fileJson) {
 function getAnimatorConfig(doc) {
   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;
-}
+  if (!cfg) return void 0;
+  const memoised = wireViewMemo.get(cfg);
+  if (memoised) return memoised;
+  const wire = cfg;
+  const stray = PX_FLAT_RUNTIME_VIEW_KEYS.filter((k) => wire[k] !== void 0);
+  const source = stray.length ? __spreadValues({}, wire) : cfg;
+  for (const k of stray) delete source[k];
+  const view = flattenAnimatorTimeline(source);
+  wireViewMemo.set(cfg, view);
+  return view;
+}
+var wireViewMemo = /* @__PURE__ */ new WeakMap();
 var flattenMemo = /* @__PURE__ */ new WeakMap();
 function flattenAnimatorTimeline(cfg) {
   const timeline = cfg.timeline;
@@ -1661,7 +1185,7 @@ function flattenAnimatorTimeline(cfg) {
     else if (pin && typeof pin === "object") {
       scroll.pin = true;
       if (pin.align !== void 0) scroll.pinAlign = pin.align;
-      if (pin.top !== void 0) scroll.pinTop = pin.top;
+      if (pin.offset !== void 0) scroll.pinOffset = pin.offset;
       if (pin.distance !== void 0) scroll.pinDistance = pin.distance;
     }
     flat.scroll = scroll;
@@ -1722,9 +1246,9 @@ function nestAnimatorTimeline(cfg) {
       if (scroll.subject !== void 0) timeline2.subject = scroll.subject;
       if (scroll.smoothing !== void 0) timeline2.smoothing = scroll.smoothing;
       if (scroll.range !== void 0) timeline2.range = scroll.range;
-      const hasPinParams = scroll.pinAlign !== void 0 || scroll.pinTop !== void 0 || scroll.pinDistance !== void 0;
+      const hasPinParams = scroll.pinAlign !== void 0 || scroll.pinOffset !== void 0 || scroll.pinDistance !== void 0;
       if (hasPinParams) {
-        timeline2.pin = __spreadValues(__spreadValues(__spreadValues({}, scroll.pinAlign !== void 0 ? { align: scroll.pinAlign } : {}), scroll.pinTop !== void 0 ? { top: scroll.pinTop } : {}), scroll.pinDistance !== void 0 ? { distance: scroll.pinDistance } : {});
+        timeline2.pin = __spreadValues(__spreadValues(__spreadValues({}, scroll.pinAlign !== void 0 ? { align: scroll.pinAlign } : {}), scroll.pinOffset !== void 0 ? { offset: scroll.pinOffset } : {}), scroll.pinDistance !== void 0 ? { distance: scroll.pinDistance } : {});
       } else if (scroll.pin !== void 0) {
         timeline2.pin = scroll.pin;
       }
@@ -1754,9 +1278,7 @@ function getDefs(doc) {
 function getBindings(doc) {
   var _a2;
   if (!doc) return void 0;
-  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 }));
+  return (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.bindings;
 }
 function getChildren(doc) {
   return doc == null ? void 0 : doc.children;
@@ -1772,14 +1294,13 @@ var PxKeyframeValueSchema = implementsInterface()(px.union([
   // e.g. for colors
   px.number(),
   px.array(px.number()),
-  // ORDER LAW: the key-discriminated object shapes (`{path}`, `{paths}`) come BEFORE the
+  // ORDER LAW: the key-discriminated object shape (`{pathData}`) comes BEFORE the
   // all-optional transform-parts record. In default (non-strict) mode that record accepts
   // ANY object (every key optional, unknown keys ignored), so listing it earlier made
-  // Union.sanitize route `{path}`/`{paths}` values into it and strip them to `{}` —
+  // Union.sanitize route `{pathData}` values into it and strip them to `{}` —
   // silent morph-data loss (repro: the editor's keyframeValueSanitize spec). Validity is
   // order-independent (`some()`); only sanitize routing depends on this order.
-  px.object({ path: px.string() }),
-  px.lazy(() => px.object({ paths: px.array(PxBezierPathSchema) }), { paths: [] }),
+  px.object({ pathData: px.string() }),
   // Gradient `stops` timeline — each kf value is the full stops-array snapshot.
   px.lazy(() => px.array(PxGradientStopSchema), []),
   px.lazy(() => PxTransformPartsSchema, {})
@@ -1819,7 +1340,7 @@ var PxPropertyAnimationSchema = implementsInterface()(px.object({
   keyframes: px.array(PxKeyframeSchema).optional(),
   loop: px.union([PxLoopSchema, px.boolean()]).optional(),
   autoOrient: px.boolean().optional(),
-  alongPathMode: px.enum(["sampled", "offsetPath"]).optional()
+  alongPathMode: px.enum([PxAlongPathMode.sampled, PxAlongPathMode.offsetPath]).optional()
 }));
 var PxTransformPartsSchema = implementsInterface()(px.object({
   translate: px.tuple([px.number(), px.number()]).optional(),
@@ -1843,17 +1364,17 @@ var PxElementAnimationSchema = implementsInterface()(px.union([
   PxAnimationDefinitionSchema
 ]));
 var PxTriggerSchema = implementsInterface()(px.object({
-  startOn: px.enum(["load", "mouseOver", "click", "scrollIntoView", "programmatic"]).optional(),
-  outAction: px.enum(["continue", "pause", "reset", "reverse"]).optional(),
+  startOn: px.enum([PxStartOn.load, PxStartOn.mouseOver, PxStartOn.click, PxStartOn.scrollIntoView, PxStartOn.programmatic], PX_TRIGGER_DEFAULTS.startOn).optional(),
+  outAction: px.enum([PxOutAction.continue, PxOutAction.pause, PxOutAction.reset, PxOutAction.reverse], PX_TRIGGER_DEFAULTS.outAction).optional(),
   // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
   // `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(),
+  finishAction: px.enum([PxFinishAction.hold, PxFinishAction.reset]).optional(),
   scrollIntoViewThreshold: px.number().optional()
 }));
 var PxGlyphSchema = implementsInterface()(px.object({
   width: px.number(),
-  d: px.string()
+  pathData: px.string()
 }));
 var PxGlyphFontSchema = implementsInterface()(px.object({
   fontFamily: px.string(),
@@ -1865,14 +1386,17 @@ var PxGlyphFontSchema = implementsInterface()(px.object({
 var PxDefsSchema = implementsInterface()(px.object({
   easings: px.record(px.tuple([px.number(), px.number(), px.number(), px.number()])).optional(),
   animations: px.record(PxAnimationDefinitionSchema).optional(),
-  // 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(),
   fonts: px.record(PxGlyphFontSchema).optional()
 }));
-var PX_SCROLL_PHASES = ["cover", "contain", "entry", "exit", "entry-crossing", "exit-crossing"];
 var PxScrollRangePointSchema = implementsInterface()(px.object({
-  phase: px.enum(PX_SCROLL_PHASES).optional(),
+  phase: px.enum([
+    PxScrollPhase.cover,
+    PxScrollPhase.contain,
+    PxScrollPhase.entry,
+    PxScrollPhase.exit,
+    PxScrollPhase.entryCrossing,
+    PxScrollPhase.exitCrossing
+  ]).optional(),
   fraction: px.number().optional()
 }));
 var PxScrollRangeSchema = px.object({
@@ -1880,21 +1404,21 @@ var PxScrollRangeSchema = px.object({
   end: PxScrollRangePointSchema.optional()
 });
 var PxScrollSchema = implementsInterface()(px.object({
-  kind: px.enum(["view", "scroll"]).optional(),
-  axis: px.enum(["block", "inline", "x", "y"]).optional(),
-  source: px.enum(["nearest", "root"]).optional(),
+  kind: px.enum([PxScrollKind.view, PxScrollKind.scroll]).optional(),
+  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
+  source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
   // Free-form: the two keywords `parent`/`scroller` plus any CSS selector.
   subject: px.string().optional(),
   smoothing: px.number().optional(),
   pin: px.boolean().optional(),
-  pinAlign: px.enum(["top", "center", "bottom"]).optional(),
-  pinTop: px.number().optional(),
+  pinAlign: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+  pinOffset: px.number().optional(),
   pinDistance: px.number().optional(),
   range: PxScrollRangeSchema.optional()
 }));
 var PxTimelinePinSchema = implementsInterface()(px.object({
-  align: px.enum(["top", "center", "bottom"]).optional(),
-  top: px.number().optional(),
+  align: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+  offset: px.number().optional(),
   distance: px.number().optional()
 }));
 var PxTimelineEngineSchema = px.enum([PxTimelineEngineExtra.auto, PxTimelineEngineExtra.native, PxTimelineEngineExtra.js]).optional();
@@ -1909,8 +1433,8 @@ var PxTimeTimelineSchema = implementsInterface()(px.object({
   iterations: px.union([px.number(), px.literal("infinite")]).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()
+  fillMode: px.enum([PxFillMode.forwards, PxFillMode.backwards, PxFillMode.both, PxFillMode.none]).optional(),
+  direction: px.enum([PxPlaybackDirection.normal, PxPlaybackDirection.reverse, PxPlaybackDirection.alternate, PxPlaybackDirection.alternateReverse]).optional()
 }));
 var scrollishTimelineShape = {
   // §2.8: duration is a property of the TIMELINE — under scrubbing it is the keyframe
@@ -1921,8 +1445,8 @@ var scrollishTimelineShape = {
   iterations: px.number().optional(),
   engine: PxTimelineEngineSchema,
   frameRate: px.number().optional(),
-  axis: px.enum(["block", "inline", "x", "y"]).optional(),
-  source: px.enum(["nearest", "root"]).optional(),
+  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
+  source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
   subject: px.string().optional(),
   // 'parent' | 'scroller' | any CSS selector
   smoothing: px.number().optional(),
@@ -1942,22 +1466,22 @@ var PxTimelineSchema = px.discriminatedUnion("type", [
   PxScrollTimelineSchema,
   PxViewTimelineSchema
 ]);
+var PxBindingSchema = implementsInterface()(px.object({
+  target: px.string(),
+  animateWith: px.array(px.string())
+}));
 var PxAnimatorConfigSchema = implementsInterface()(px.object({
   // (`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(),
+  bindings: px.array(PxBindingSchema).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(),
-  animate: PxElementAnimationSchema
-}));
 var PxAttrValueSchema = px.union([
   px.string(),
   px.number(),
@@ -2011,7 +1535,7 @@ var PxMaskedByEffectSchema = implementsInterface()(px.object({
   height: px.number().optional()
 }));
 var PxClipPathEffectSchema = implementsInterface()(px.object({
-  d: PxAnimatableStringSchema.optional()
+  pathData: PxAnimatableStringSchema.optional()
 }));
 var PxStrokeTrimEffectSchema = implementsInterface()(px.object({
   offset: PxAnimatableNumberSchema.optional(),
@@ -2048,7 +1572,7 @@ var PxFillGradientEffectSchema = implementsInterface()(px.object({
   radius: PxAnimatableNumberSchema.optional(),
   focal: PxAnimatableVec2Schema.optional(),
   stops: PxAnimatableGradientStopsSchema.optional(),
-  gradientUnits: px.enum([PxGradientUnits.userSpaceOnUse, PxGradientUnits.objectBoundingBox]).optional(),
+  gradientUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
   spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat]).optional(),
   gradientTransform: px.string().optional()
 }));
@@ -2094,187 +1618,698 @@ function validateNodeEffects(root, opts) {
   walk(root, "root");
   return warnings;
 }
-function validateDocument(doc) {
-  const ctx = { errors: [], warnings: [], strict: true };
+function validateGlyphFontRefs(root, fonts) {
+  if (!fonts || !Object.keys(fonts).length) return [];
+  const problems = [];
+  const walk = (node, path, inherited, inGlyphText) => {
+    var _a2, _b;
+    if (!node) return;
+    const own = typeof node.fontFamily === "string" ? node.fontFamily : void 0;
+    const family = own != null ? own : inherited;
+    const isGlyphText = inGlyphText || node.type === "text" && !!((_b = (_a2 = node.effects) == null ? void 0 : _a2.text) == null ? void 0 : _b.useGlyphs);
+    if (isGlyphText && own && !Object.prototype.hasOwnProperty.call(fonts, own)) {
+      const problem = path + ': glyph-mode text uses font-family "' + own + '", which has no entry in animator.definitions.fonts';
+      if (!problems.includes(problem)) problems.push(problem);
+    }
+    if (Array.isArray(node.children)) {
+      node.children.forEach((c, i) => walk(c, path + ".children[" + i + "]", family, isGlyphText));
+    }
+  };
+  walk(root, "root", void 0, false);
+  return problems;
+}
+function validateEasingRefs(root, easings) {
+  const problems = [];
+  const walk = (node, path) => {
+    if (Array.isArray(node)) {
+      node.forEach((item, i) => walk(item, path + "[" + i + "]"));
+      return;
+    }
+    if (!node || typeof node !== "object") return;
+    const easing = node.easing;
+    if (typeof easing === "string" && !(easings && Object.prototype.hasOwnProperty.call(easings, easing))) {
+      const problem = path + '.easing: "' + easing + '" names no entry in animator.definitions.easings \u2014 it will play linear';
+      if (!problems.includes(problem)) problems.push(problem);
+    }
+    for (const [key, value] of Object.entries(node)) {
+      if (key === "easing") continue;
+      if (value && typeof value === "object") walk(value, path + "." + key);
+    }
+  };
+  walk(root, "root");
+  return problems;
+}
+function validateVersionStamp(doc) {
+  var _a2;
+  const version = (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.version;
+  if (version === void 0) return [];
+  if (parseWireVersion(version) !== void 0) return [];
+  return ["root.animator.version: " + JSON.stringify(version) + ' is not a version stamp ("a.b" or "a.b.c") \u2014 it reads as unstamped'];
+}
+function validateDocument(doc, opts) {
+  var _a2;
+  const strict = (opts == null ? void 0 : opts.strict) !== false;
+  const ctx = { errors: [], warnings: [], strict };
   const problems = PxAnimatedSvgDocumentSchema.isValid(doc, ctx, ["root"]) ? [] : [...ctx.errors];
   if (doc && typeof doc === "object") {
-    for (const w of validateNodeEffects(doc, { strict: true })) {
+    for (const w of validateNodeEffects(doc, { strict })) {
+      if (!problems.includes(w)) problems.push(w);
+    }
+    const defs = (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.definitions;
+    for (const w of validateGlyphFontRefs(doc, defs == null ? void 0 : defs.fonts)) {
       if (!problems.includes(w)) problems.push(w);
     }
+    for (const w of validateEasingRefs(doc, defs == null ? void 0 : defs.easings)) {
+      if (!problems.includes(w)) problems.push(w);
+    }
+    for (const w of validateVersionStamp(doc)) {
+      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 (`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(),
+  // Text content of a `<text>` / `<tspan>`. Declared, so a non-string value is a schema error
+  // and the minifier reserves the key; `text` is NOT an alias for it and is not read anywhere.
+  textContent: px.string().optional(),
+  id: px.string().optional(),
+  meta: px.any().optional(),
+  // Player-effects bucket emitted by the Editor's lightweight design format.
+  // Consumed and removed by `applyPlayerEffects` before any other normalization
+  // (see `createAnimatorImpl`), so downstream code never sees it.
+  effects: PxEffectsSchema.optional(),
+  // `PxElementAnimation` (not just `PxAnimationDefinition`) — accepts
+  // string ref / array of refs / inline definition / mixed array; mirrors
+  // `node.animate` values and what `processNode` resolves at runtime.
+  animate: PxElementAnimationSchema.optional(),
+  style: px.record(px.union([px.string(), px.number()])).optional()
+}, PxAttrValueSchema);
+var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBase._shape), {
+  children: px.lazy(() => px.array(PxNodeSchema), []).optional()
+}), PxAttrValueSchema);
+var PxSvgNodeExtra = px.object({
+  // `"100%"` and other SVG length strings are legal here — a number-only slot rejected
+  // real documents (e.g. apple-store-look-14-main.json) at the root <svg>.
+  width: px.union([px.number(), px.string()]).optional(),
+  height: px.union([px.number(), px.string()]).optional(),
+  viewBox: px.string().optional(),
+  animator: PxAnimatorConfigSchema.optional()
+});
+var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBase._shape), PxSvgNodeExtra._shape), {
+  type: px.literal("svg"),
+  // override string → literal to require 'svg'
+  children: px.array(PxNodeSchema).optional()
+}), PxAttrValueSchema);
+var PxBezierPathSchema = implementsInterface()(px.object({
+  v: px.array(px.array(px.number())),
+  i: px.array(px.array(px.number())).optional(),
+  o: px.array(px.array(px.number())).optional(),
+  c: px.boolean().optional()
+}));
+function isPxElementFileFormatDeep(fileJson) {
+  const errors = validateDocument(fileJson, { strict: false });
+  return { valid: errors.length === 0, errors };
+}
+
+// src/util/PxIdUtil.ts
+var _idCounter = 0;
+function generateUniqueId() {
+  const timestamp = Date.now().toString(36);
+  const counter = (++_idCounter).toString(36);
+  const random = Math.random().toString(36).substring(2, 6);
+  return "_px_" + timestamp + counter + random;
+}
+function deepClone(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) return value.map((item) => deepClone(item));
+  const obj = value;
+  const cloned = {};
+  for (const key of Object.keys(obj)) {
+    cloned[key] = deepClone(obj[key]);
+  }
+  return cloned;
+}
+function generateNewIds(doc) {
+  var _a2;
+  const cloned = deepClone(doc);
+  const idMap = /* @__PURE__ */ new Map();
+  const hashRefAttrs = /* @__PURE__ */ new Set(["href", "xlink:href"]);
+  const urlRefAttrs = /* @__PURE__ */ new Set([
+    "fill",
+    "stroke",
+    "clip-path",
+    "clipPath",
+    "mask",
+    "marker",
+    "marker-start",
+    "marker-mid",
+    "marker-end",
+    "filter",
+    "flood-color",
+    "lighting-color"
+  ]);
+  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") {
+      const oldId = node.id;
+      const newId = generateUniqueId();
+      idMap.set(oldId, newId);
+      node.id = newId;
+    } else if (node.animate) {
+      node.id = generateUniqueId();
+    }
+    if (Array.isArray(node.children)) {
+      for (const child of node.children) {
+        collectIds(child);
+      }
+    }
+  }
+  function updateRefs(node, parentKey) {
+    if (!node || typeof node !== "object") return;
+    for (const [key, value] of Object.entries(node)) {
+      if (key === "children") {
+        if (Array.isArray(value)) {
+          for (const child of value) {
+            updateRefs(child);
+          }
+        }
+        continue;
+      }
+      if (typeof value === "string") {
+        if (hashRefAttrs.has(key) && value.startsWith("#")) {
+          const oldId = value.slice(1);
+          const newId = idMap.get(oldId);
+          if (newId) {
+            node[key] = "#" + newId;
+          }
+        } else if (urlRefAttrs.has(key)) {
+          node[key] = replaceUrlRefs(value, idMap);
+        } else if (directIdRefAttrs.has(key) || isEffectSourceRef(key, parentKey)) {
+          const hasHash = value.startsWith("#");
+          const newId = idMap.get(hasHash ? value.slice(1) : value);
+          if (newId) {
+            node[key] = hasHash ? "#" + newId : newId;
+          }
+        } else if (value.includes("url(#")) {
+          node[key] = replaceUrlRefs(value, idMap);
+        }
+      } else if (key === "style" && typeof value === "object" && value !== null) {
+        for (const [styleProp, styleValue] of Object.entries(value)) {
+          if (typeof styleValue === "string") {
+            value[styleProp] = replaceUrlRefs(styleValue, idMap);
+          }
+        }
+      } else if (typeof value === "object" && value !== null) {
+        updateRefs(value, key);
+      }
+    }
+  }
+  collectIds(cloned);
+  updateRefs(cloned);
+  const docBindings = (_a2 = cloned.animator) == null ? void 0 : _a2.bindings;
+  if (Array.isArray(docBindings)) {
+    const updatedBindings = docBindings.map((binding) => {
+      var _a3;
+      const hashed = binding.target.startsWith("#");
+      const id = hashed ? binding.target.slice(1) : binding.target;
+      const newId = (_a3 = idMap.get(id)) != null ? _a3 : id;
+      return __spreadProps(__spreadValues({}, binding), { target: hashed ? "#" + newId : newId });
+    });
+    cloned.animator = __spreadProps(__spreadValues({}, cloned.animator), { bindings: updatedBindings });
+  }
+  return cloned;
+}
+function replaceUrlRefs(value, idMap) {
+  return value.replace(/url\(#([^)]+)\)/g, (match, oldId) => {
+    const newId = idMap.get(oldId);
+    return newId ? "url(#" + newId + ")" : match;
+  });
+}
+
+// src/util/PxAnimatorUtil.ts
+function bezierToSvgPath(path, forceCurves = false) {
+  var _a2, _b, _c, _d;
+  const v = path.v;
+  const i = path.i;
+  const o = path.o;
+  const c = path.c;
+  if (!v.length) return "";
+  const d = [];
+  const len = v.length;
+  d.push("M" + v[0][0] + "," + v[0][1]);
+  for (let idx = 1; idx < len; idx++) {
+    const prevV = v[idx - 1];
+    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]);
+    if (isLine) {
+      d.push("L" + currV[0] + "," + currV[1]);
+    } else {
+      d.push("C" + prevO[0] + "," + prevO[1] + "," + currI[0] + "," + currI[1] + "," + currV[0] + "," + currV[1]);
+    }
+  }
+  if (c && len > 0) {
+    const lastV = v[len - 1];
+    const lastO = (_c = o == null ? void 0 : o[len - 1]) != null ? _c : lastV;
+    const firstI = (_d = i == null ? void 0 : i[0]) != null ? _d : v[0];
+    const firstV = v[0];
+    const isLine = !forceCurves && (lastO[0] === lastV[0] && lastO[1] === lastV[1]) && (firstI[0] === firstV[0] && firstI[1] === firstV[1]);
+    if (!isLine) {
+      d.push("C" + lastO[0] + "," + lastO[1] + "," + firstI[0] + "," + firstI[1] + "," + firstV[0] + "," + firstV[1]);
+    }
+    d.push("z");
+  }
+  return d.join("");
+}
+function interpolateNum(a, b, t) {
+  return a + (b - a) * t;
+}
+function interpolateVec(a, b, t) {
+  const res = [];
+  const count = Math.max(a.length, b.length);
+  for (let i = 0; i < count; i++) {
+    res[i] = interpolateNum(a[i] || 0, b[i] || 0, t);
+  }
+  return res;
+}
+function interpolateColor(a, b, t) {
+  return [
+    interpolateNum(a[0] || 0, b[0] || 0, t),
+    interpolateNum(a[1] || 0, b[1] || 0, t),
+    interpolateNum(a[2] || 0, b[2] || 0, t),
+    interpolateNum(a[3] === void 0 ? 1 : a[3], b[3] === void 0 ? 1 : b[3], t)
+  ];
+}
+function interpolateBeziers(paths1, paths2, progress) {
+  const count = Math.max(paths1.length, paths2.length);
+  const res = [];
+  for (let i = 0; i < count; i++) {
+    res.push(interpolateBezier(paths1[i], paths2[i], progress));
+  }
+  return res;
+}
+function interpolateBezier(path1, path2, progress) {
+  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);
+  const v = [];
+  const i = [];
+  const o = [];
+  for (let idx = 0; idx < len; idx++) {
+    const v1 = path1.v[idx];
+    const v2 = path2.v[idx];
+    v.push(interpolateVec(v1, v2, t));
+    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;
+    const o2 = (_h = (_g = path2.o) == null ? void 0 : _g[idx]) != null ? _h : v2;
+    o.push(interpolateVec(o1, o2, t));
+  }
+  return { v, i: i.length ? i : void 0, o: o.length ? o : void 0, c: (_i = path1.c) != null ? _i : path2.c };
+}
+function remap(value, inMin, inMax, outMin, outMax) {
+  if (inMax === inMin) return outMin;
+  const t = (value - inMin) / (inMax - inMin);
+  return outMin + t * (outMax - outMin);
+}
+function solveCubicBezierX(p1x, p2x, x) {
+  if (x <= 0) return 0;
+  if (x >= 1) return 1;
+  const cx = 3 * p1x;
+  const bx = 3 * (p2x - p1x) - cx;
+  const ax = 1 - cx - bx;
+  function sampleX(t) {
+    return ((ax * t + bx) * t + cx) * t;
+  }
+  function sampleDX(t) {
+    return (3 * ax * t + 2 * bx) * t + cx;
+  }
+  let t2 = x;
+  let t0 = 0;
+  let t1 = 1;
+  for (let i = 0; i < 8; i++) {
+    const x2 = sampleX(t2) - x;
+    if (Math.abs(x2) < 1e-6) return t2;
+    const d2 = sampleDX(t2);
+    if (Math.abs(d2) < 1e-6) break;
+    t2 -= x2 / d2;
+  }
+  t2 = x;
+  while (t0 < t1) {
+    const x2 = sampleX(t2);
+    if (Math.abs(x2 - x) < 1e-6) return t2;
+    if (x > x2) t0 = t2;
+    else t1 = t2;
+    t2 = (t1 + t0) / 2;
+  }
+  return t2;
+}
+function cubicBezier(easing) {
+  const [p1x, p1y, p2x, p2y] = easing;
+  const cy = 3 * p1y;
+  const by = 3 * (p2y - p1y) - cy;
+  const ay = 1 - cy - by;
+  function sampleCurveY(t) {
+    return ((ay * t + by) * t + cy) * t;
+  }
+  return function(x) {
+    return sampleCurveY(solveCubicBezierX(p1x, p2x, x));
+  };
+}
+function lerp2(a, b, t) {
+  return [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
+}
+function subdivideCubicBezier(p0, p1, p2, p3, t) {
+  const q0 = lerp2(p0, p1, t);
+  const q1 = lerp2(p1, p2, t);
+  const q2 = lerp2(p2, p3, t);
+  const r0 = lerp2(q0, q1, t);
+  const r1 = lerp2(q1, q2, t);
+  const s = lerp2(r0, r1, t);
+  return {
+    left: [p0, q0, r0, s],
+    right: [s, r1, q2, p3]
+  };
+}
+function splitEasing(easing, xFraction) {
+  if (!easing) return { left: void 0, right: void 0 };
+  if (xFraction <= 0) return { left: void 0, right: easing };
+  if (xFraction >= 1) return { left: easing, right: void 0 };
+  const [x1, y1, x2, y2] = easing;
+  const t = solveCubicBezierX(x1, x2, xFraction);
+  const p0 = [0, 0];
+  const p1 = [x1, y1];
+  const p2 = [x2, y2];
+  const p3 = [1, 1];
+  const { left, right } = subdivideCubicBezier(p0, p1, p2, p3, t);
+  const sx = left[3][0];
+  const sy = left[3][1];
+  let leftEasing;
+  if (sx > 1e-9 && Math.abs(sy) > 1e-9) {
+    leftEasing = [
+      left[1][0] / sx,
+      left[1][1] / sy,
+      left[2][0] / sx,
+      left[2][1] / sy
+    ];
+  }
+  let rightEasing;
+  const rx = 1 - sx;
+  const ry = 1 - sy;
+  if (rx > 1e-9 && Math.abs(ry) > 1e-9) {
+    rightEasing = [
+      (right[1][0] - sx) / rx,
+      (right[1][1] - sy) / ry,
+      (right[2][0] - sx) / rx,
+      (right[2][1] - sy) / ry
+    ];
+  }
+  return { left: leftEasing, right: rightEasing };
+}
+function reverseEasing(easing) {
+  if (!easing) return void 0;
+  return [1 - easing[2], 1 - easing[3], 1 - easing[0], 1 - easing[1]];
+}
+function toRGBA(color) {
+  const r = Math.round(color[0] * 255);
+  const g = Math.round(color[1] * 255);
+  const b = Math.round(color[2] * 255);
+  return color.length === 4 ? "rgba(" + r + "," + g + "," + b + "," + color[3] + ")" : "rgb(" + r + "," + g + "," + b + ")";
+}
+function parseRgba(s) {
+  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]] : []];
+}
+function parseHex(s) {
+  const hex = s.slice(1);
+  const isShort = hex.length <= 4;
+  const r = isShort ? hex[0] + hex[0] : hex.slice(0, 2);
+  const g = isShort ? hex[1] + hex[1] : hex.slice(2, 4);
+  const b = isShort ? hex[2] + hex[2] : hex.slice(4, 6);
+  const a = hex.length === 4 ? hex[3] + hex[3] : hex.length === 8 ? hex.slice(6, 8) : null;
+  const result = [
+    parseInt(r, 16) / 255,
+    parseInt(g, 16) / 255,
+    parseInt(b, 16) / 255
+  ];
+  if (a !== null) {
+    result.push(parseInt(a, 16) / 255);
+  }
+  return result;
+}
+function parseColor(s) {
+  if (!s) return void 0;
+  if (Array.isArray(s)) return s;
+  if (typeof s !== "string") return void 0;
+  if (s.startsWith("#")) {
+    return parseHex(s);
+  } else if (s.startsWith("rgb")) {
+    return parseRgba(s);
+  } else {
+    console.warn("Unsupported color format: " + s);
+  }
+  return void 0;
+}
+var COLOR_ATTR_NAMES = /* @__PURE__ */ new Set(["color", "fill", "flood-color", "lighting-color", "stop-color", "stroke"]);
+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 _a2;
+  if (!parts) return "";
+  const withUnits = (_a2 = opts == null ? void 0 : opts.withUnits) != null ? _a2 : true;
+  const segs = [];
+  const t = parts.translate;
+  const o = parts.origin;
+  const r = parts.rotate;
+  const k = parts.skew;
+  const s = parts.scale;
+  const tu = withUnits ? "px" : "";
+  const ru = withUnits ? "deg" : "";
+  if (t) segs.push("translate(" + t[0] + tu + "," + t[1] + tu + ")");
+  if (o) segs.push("translate(" + o[0] + tu + "," + o[1] + tu + ")");
+  if (r !== void 0 && r !== null) segs.push("rotate(" + r + ru + ")");
+  if (k !== void 0 && k !== null) segs.push("skewX(" + k + ru + ")");
+  if (s) segs.push("scale(" + s[0] + "," + s[1] + ")");
+  if (o) segs.push("translate(" + -o[0] + tu + "," + -o[1] + tu + ")");
+  return segs.join("");
+}
+function parseTransformParts(str2) {
+  var _a2, _b;
+  if (!str2 || typeof str2 !== "string") return void 0;
+  const out = {};
+  const re = /([a-zA-Z]+)\s*\(([^)]*)\)/g;
+  const order = ["translate", "rotate", "skewX", "scale"];
+  let lastIdx = -1;
+  let m;
+  while ((m = re.exec(str2)) !== null) {
+    const fn = m[1];
+    const idx = order.indexOf(fn);
+    if (idx < 0 || idx <= lastIdx) return void 0;
+    lastIdx = idx;
+    const nums = m[2].split(/[\s,]+/).filter(Boolean).map(Number);
+    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], (_a2 = nums[1]) != null ? _a2 : 0];
+    } else if (fn === "rotate") {
+      if (nums.length !== 1) return void 0;
+      out.rotate = nums[0];
+    } else if (fn === "skewX") {
+      if (nums.length !== 1) return void 0;
+      out.skew = nums[0];
+    } else {
+      if (nums.length < 1 || nums.length > 2) return void 0;
+      out.scale = [nums[0], (_b = nums[1]) != null ? _b : nums[0]];
+    }
   }
-  return problems;
+  if (str2.replace(/([a-zA-Z]+)\s*\(([^)]*)\)/g, "").replace(/[\s,]/g, "").length) return void 0;
+  return Object.keys(out).length ? out : void 0;
 }
-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 (`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.
-  // Consumed and removed by `applyPlayerEffects` before any other normalisation
-  // (see `createAnimatorImpl`), so downstream code never sees it.
-  effects: PxEffectsSchema.optional(),
-  // `PxElementAnimation` (not just `PxAnimationDefinition`) — accepts
-  // string ref / array of refs / inline definition / mixed array; mirrors
-  // `animator.animateById` map values and what `processNode` resolves at runtime.
-  animate: PxElementAnimationSchema.optional(),
-  style: px.union([px.string(), px.record(px.union([px.string(), px.number()]))]).optional()
-}, PxAttrValueSchema);
-var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBase._shape), {
-  children: px.lazy(() => px.array(PxNodeSchema), []).optional()
-}), PxAttrValueSchema);
-var PxSvgNodeExtra = px.object({
-  // `"100%"` and other SVG length strings are legal here — a number-only slot rejected
-  // real documents (e.g. apple-store-look-14-main.json) at the root <svg>.
-  width: px.union([px.number(), px.string()]).optional(),
-  height: px.union([px.number(), px.string()]).optional(),
-  viewBox: px.string().optional(),
-  animator: PxAnimatorConfigSchema.optional()
-});
-var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBase._shape), PxSvgNodeExtra._shape), {
-  type: px.literal("svg"),
-  // override string → literal to require 'svg'
-  children: px.array(PxNodeSchema).optional()
-}), PxAttrValueSchema);
-var PxBezierPathSchema = implementsInterface()(px.object({
-  v: px.array(px.array(px.number())),
-  i: px.array(px.array(px.number())).optional(),
-  o: px.array(px.array(px.number())).optional(),
-  c: px.boolean().optional()
-}));
-function isPxElementFileFormatDeep(fileJson) {
-  const valid = PxAnimatedSvgDocumentSchema.isValid(fileJson);
-  return { valid, errors: valid ? [] : ["Document failed schema validation"] };
+var STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
+var DEFAULT_DURATION_MS = 1e3;
+function kebabToCamelCaseWord(kebab) {
+  return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
 }
-
-// src/util/PxIdUtil.ts
-var _idCounter = 0;
-function generateUniqueId() {
-  const timestamp = Date.now().toString(36);
-  const counter = (++_idCounter).toString(36);
-  const random = Math.random().toString(36).substring(2, 6);
-  return "_px_" + timestamp + counter + random;
+function isCamelCaseWord(word) {
+  return !word.includes("-") && /[a-z][A-Z]/.test(word);
 }
-function deepClone(value) {
-  if (value === null || typeof value !== "object") return value;
-  if (Array.isArray(value)) return value.map((item) => deepClone(item));
-  const obj = value;
-  const cloned = {};
-  for (const key of Object.keys(obj)) {
-    cloned[key] = deepClone(obj[key]);
-  }
-  return cloned;
+var SVG_CAMEL_CASE_ATTRS = /* @__PURE__ */ new Set([
+  // Transform/positioning
+  "viewBox",
+  "preserveAspectRatio",
+  // Gradient
+  "gradientUnits",
+  "gradientTransform",
+  "spreadMethod",
+  // Pattern
+  "patternUnits",
+  "patternContentUnits",
+  "patternTransform",
+  // Clipping/masking
+  "clipPathUnits",
+  "maskUnits",
+  "maskContentUnits",
+  // Marker  (SVG spec keeps these camelCase, like viewBox)
+  "markerUnits",
+  "markerWidth",
+  "markerHeight",
+  "refX",
+  "refY",
+  // Text
+  "textLength",
+  "lengthAdjust",
+  "startOffset",
+  // Filter
+  "filterUnits",
+  "primitiveUnits",
+  "tableValues",
+  // feFuncR/G/B/A transfer table (type="table")
+  "stdDeviation",
+  "baseFrequency",
+  "numOctaves",
+  "surfaceScale",
+  "diffuseConstant",
+  "specularConstant",
+  "specularExponent",
+  "kernelMatrix",
+  "kernelUnitLength",
+  "edgeMode",
+  "preserveAlpha",
+  "targetX",
+  "targetY"
+  // // Animation
+  // 'attributeName',
+  // 'attributeType',
+  // 'calcMode',
+  // 'keyTimes',
+  // 'keySplines',
+  // 'repeatCount',
+  // 'repeatDur'    
+]);
+function camelCaseToKebabWordIfNeeded(camel) {
+  return SVG_CAMEL_CASE_ATTRS.has(camel) ? camel : camel.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
 }
-function generateNewIds(doc) {
-  var _a2, _b;
-  const cloned = deepClone(doc);
-  const idMap = /* @__PURE__ */ new Map();
-  const hashRefAttrs = /* @__PURE__ */ new Set(["href", "xlink:href"]);
-  const urlRefAttrs = /* @__PURE__ */ new Set([
-    "fill",
-    "stroke",
-    "clip-path",
-    "clipPath",
-    "mask",
-    "marker",
-    "marker-start",
-    "marker-mid",
-    "marker-end",
-    "filter",
-    "flood-color",
-    "lighting-color"
-  ]);
-  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") {
-      const oldId = node.id;
-      const newId = generateUniqueId();
-      idMap.set(oldId, newId);
-      node.id = newId;
-    } else if (node.animate) {
-      node.id = generateUniqueId();
-    }
-    if (Array.isArray(node.children)) {
-      for (const child of node.children) {
-        collectIds(child);
-      }
-    }
+function clamp(value, min, max) {
+  return Math.max(min, Math.min(value, max));
+}
+function bezier2D_pointAt(P0, P1, P2, P3, t) {
+  if (t <= 0) return [P0[0], P0[1]];
+  if (t >= 1) return [P3[0], P3[1]];
+  const u = 1 - t;
+  const u2 = u * u;
+  const u3 = u2 * u;
+  const t2 = t * t;
+  const t3 = t2 * t;
+  const w0 = u3;
+  const w1 = 3 * t * u2;
+  const w2 = 3 * t2 * u;
+  const w3 = t3;
+  return [
+    w0 * P0[0] + w1 * P1[0] + w2 * P2[0] + w3 * P3[0],
+    w0 * P0[1] + w1 * P1[1] + w2 * P2[1] + w3 * P3[1]
+  ];
+}
+var BEZIER_T_NUDGE = 1e-4;
+function bezier2D_derivativeAt(P0, P1, P2, P3, t) {
+  const result = _bezier2D_derivativeAtRaw(P0, P1, P2, P3, t);
+  if (result[0] === 0 && result[1] === 0) {
+    const nudgedT = t < 0.5 ? t + BEZIER_T_NUDGE : t - BEZIER_T_NUDGE;
+    return _bezier2D_derivativeAtRaw(P0, P1, P2, P3, nudgedT);
   }
-  function updateRefs(node, parentKey) {
-    if (!node || typeof node !== "object") return;
-    for (const [key, value] of Object.entries(node)) {
-      if (key === "children") {
-        if (Array.isArray(value)) {
-          for (const child of value) {
-            updateRefs(child);
-          }
-        }
-        continue;
-      }
-      if (typeof value === "string") {
-        if (hashRefAttrs.has(key) && value.startsWith("#")) {
-          const oldId = value.slice(1);
-          const newId = idMap.get(oldId);
-          if (newId) {
-            node[key] = "#" + newId;
-          }
-        } else if (urlRefAttrs.has(key)) {
-          node[key] = replaceUrlRefs(value, idMap);
-        } else if (directIdRefAttrs.has(key) || isEffectSourceRef(key, parentKey)) {
-          const hasHash = value.startsWith("#");
-          const newId = idMap.get(hasHash ? value.slice(1) : value);
-          if (newId) {
-            node[key] = hasHash ? "#" + newId : newId;
-          }
-        } else if (value.includes("url(#")) {
-          node[key] = replaceUrlRefs(value, idMap);
-        }
-      } else if (key === "style" && typeof value === "object" && value !== null) {
-        for (const [styleProp, styleValue] of Object.entries(value)) {
-          if (typeof styleValue === "string") {
-            value[styleProp] = replaceUrlRefs(styleValue, idMap);
-          }
-        }
-      } else if (typeof value === "object" && value !== null) {
-        updateRefs(value, key);
-      }
-    }
+  return result;
+}
+function _bezier2D_derivativeAtRaw(P0, P1, P2, P3, t) {
+  const u = 1 - t;
+  const a = 3 * u * u;
+  const b = 6 * t * u;
+  const c = 3 * t * t;
+  return [
+    a * (P1[0] - P0[0]) + b * (P2[0] - P1[0]) + c * (P3[0] - P2[0]),
+    a * (P1[1] - P0[1]) + b * (P2[1] - P1[1]) + c * (P3[1] - P2[1])
+  ];
+}
+function bezier2D_arcLengthLUT(P0, P1, P2, P3, steps = 100) {
+  const n = steps + 1;
+  const ts = new Float64Array(n);
+  const ds = new Float64Array(n);
+  let prev = bezier2D_pointAt(P0, P1, P2, P3, 0);
+  ts[0] = 0;
+  ds[0] = 0;
+  let cum = 0;
+  for (let i = 1; i < n; i++) {
+    const t = i / steps;
+    const cur = bezier2D_pointAt(P0, P1, P2, P3, t);
+    const dx = cur[0] - prev[0];
+    const dy = cur[1] - prev[1];
+    cum += Math.sqrt(dx * dx + dy * dy);
+    ts[i] = t;
+    ds[i] = cum;
+    prev = cur;
   }
-  collectIds(cloned);
-  updateRefs(cloned);
-  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)) {
-      const hashed = key.startsWith("#");
-      const id = hashed ? key.slice(1) : key;
-      const newId = (_b = idMap.get(id)) != null ? _b : id;
-      updatedAnimate[hashed ? "#" + newId : newId] = anim;
-    }
-    cloned.animator = __spreadProps(__spreadValues({}, cloned.animator), { animateById: updatedAnimate });
+  return { ts, ds };
+}
+function bezier2D_tForDistance(lut, distance) {
+  const { ts, ds } = lut;
+  const last = ds.length - 1;
+  if (distance <= 0) return ts[0];
+  if (distance >= ds[last]) return ts[last];
+  let lo = 1;
+  let hi = last;
+  while (lo < hi) {
+    const mid = lo + hi >>> 1;
+    if (ds[mid] < distance) lo = mid + 1;
+    else hi = mid;
   }
-  return cloned;
+  const dPrev = ds[hi - 1];
+  const dCur = ds[hi];
+  const span = dCur - dPrev;
+  const frac = span > 0 ? (distance - dPrev) / span : 0;
+  return ts[hi - 1] + frac * (ts[hi] - ts[hi - 1]);
 }
-function replaceUrlRefs(value, idMap) {
-  return value.replace(/url\(#([^)]+)\)/g, (match, oldId) => {
-    const newId = idMap.get(oldId);
-    return newId ? "url(#" + newId + ")" : match;
-  });
+function bezier2D_arcAtT(lut, t) {
+  const { ts, ds } = lut;
+  const last = ts.length - 1;
+  if (t <= ts[0]) return ds[0];
+  if (t >= ts[last]) return ds[last];
+  let lo = 1, hi = last;
+  while (lo < hi) {
+    const mid = lo + hi >>> 1;
+    if (ts[mid] < t) lo = mid + 1;
+    else hi = mid;
+  }
+  const tPrev = ts[hi - 1];
+  const span = ts[hi] - tPrev;
+  const frac = span > 0 ? (t - tPrev) / span : 0;
+  return ds[hi - 1] + frac * (ds[hi] - ds[hi - 1]);
+}
+function invertEasing(easing) {
+  if (!easing) return (y) => y;
+  const flipped = [easing[1], easing[0], easing[3], easing[2]];
+  return cubicBezier(flipped);
 }
 
 // src/util/PxNodeProps.ts
@@ -2316,7 +2351,7 @@ function isDangerousAttrName(nameLower) {
   if (nameLower.startsWith("on")) return true;
   return false;
 }
-function sanitiseAttributeValue(name, value) {
+function sanitizeAttributeValue(name, value) {
   const nameLower = name.toLowerCase();
   if (isDangerousAttrName(nameLower)) {
     console.warn("Attribute blocked (event handler / dangerous): ", nameLower);
@@ -2340,14 +2375,6 @@ function sanitiseAttributeValue(name, value) {
   }
   return value;
 }
-function resolveStyle(style, defs) {
-  var _a2;
-  if (!style) return void 0;
-  if (typeof style === "string") {
-    return (_a2 = defs == null ? void 0 : defs.styles) == null ? void 0 : _a2[style];
-  }
-  return style;
-}
 function getNormalizedProps(props) {
   const propsCopy = {};
   for (const rawKey of Object.keys(props)) {
@@ -2355,7 +2382,7 @@ function getNormalizedProps(props) {
     if (INTERNAL_ATTRS.has(key)) continue;
     if (key === "style") continue;
     let value = props[rawKey];
-    if (COLOUR_ATTR_NAMES.has(key) && Array.isArray(value)) {
+    if (COLOR_ATTR_NAMES.has(key) && Array.isArray(value)) {
       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;
@@ -2376,7 +2403,7 @@ function getNormalizedProps(props) {
   return propsCopy;
 }
 
-// src/materialise/PxMotionPath.ts
+// src/materialize/PxMotionPath.ts
 function getKfTranslate(kf) {
   const v = kfValue(kf);
   if (!v) return void 0;
@@ -2457,7 +2484,7 @@ function tFromArcFraction(lut, arcFrac) {
 var DEFAULT_FLATNESS_TOL = 0.5;
 var DEFAULT_ROTATION_TOL = 5;
 var DEFAULT_MAX_SAMPLES = 32;
-function materialiseMotionPathInPropAnim(anim, opts) {
+function materializeMotionPathInPropAnim(anim, opts) {
   var _a2, _b, _c;
   if (!propAnimIsMotionPath(anim)) return anim;
   const kfs = anim.keyframes;
@@ -2489,7 +2516,7 @@ function materialiseMotionPathInPropAnim(anim, opts) {
     if (autoOrient && i > 0) {
       insertSharpCornerStepKfIfNeeded(out, prevKf, nextKf, prevPos, nextPos, rotationTol);
     }
-    materialiseSegment(out, prevKf, nextKf, prevPos, nextPos, autoOrient, flatnessTol, rotationTol, maxSamples);
+    materializeSegment(out, prevKf, nextKf, prevPos, nextPos, autoOrient, flatnessTol, rotationTol, maxSamples);
   }
   const lastInE = getKfEasing(kfs[kfs.length - 1]);
   if (lastInE) out[out.length - 1].e = lastInE;
@@ -2603,7 +2630,7 @@ function insertSharpCornerStepKfIfNeeded(out, prevKf, nextKf, prevPos, nextPos,
   out.push(makeOutKf(stepTime, dupValue));
 }
 var CORNER_STEP_AFTER_BOUNDARY_MS = 0.05;
-function materialiseSegment(out, prevKf, nextKf, prevPos, nextPos, autoOrient, flatnessTol, rotationTol, maxSamples) {
+function materializeSegment(out, prevKf, nextKf, prevPos, nextPos, autoOrient, flatnessTol, rotationTol, maxSamples) {
   const seg = getSegmentCache(prevKf, nextKf, prevPos, nextPos);
   const prevTime = getKfTime(prevKf);
   const nextTime = getKfTime(nextKf);
@@ -2726,16 +2753,16 @@ function perpDist(q, pA, pB) {
   const cross = (q[0] - pA[0]) * dy - (q[1] - pA[1]) * dx;
   return Math.abs(cross) / Math.sqrt(len2);
 }
-function materialiseMotionPathsInTree(root, opts) {
-  const out = walkAndMaterialise(root, opts);
+function materializeMotionPathsInTree(root, opts) {
+  const out = walkAndMaterialize(root, opts);
   return out != null ? out : root;
 }
-function walkAndMaterialise(node, opts) {
+function walkAndMaterialize(node, opts) {
   let newChildren;
   if (node.children) {
     for (let i = 0; i < node.children.length; i++) {
       const ch = node.children[i];
-      const ret = walkAndMaterialise(ch, opts);
+      const ret = walkAndMaterialize(ch, opts);
       if (ret !== null) {
         if (!newChildren) newChildren = node.children.slice();
         newChildren[i] = ret;
@@ -2748,9 +2775,9 @@ function walkAndMaterialise(node, opts) {
     const animDef = animBucket;
     const transformAnim = animDef.transform;
     if (transformAnim && typeof transformAnim === "object" && propAnimIsMotionPath(transformAnim)) {
-      const materialised = materialiseMotionPathInPropAnim(transformAnim, opts);
-      if (materialised !== transformAnim) {
-        newAnimate = __spreadProps(__spreadValues({}, animDef), { transform: materialised });
+      const materialized = materializeMotionPathInPropAnim(transformAnim, opts);
+      if (materialized !== transformAnim) {
+        newAnimate = __spreadProps(__spreadValues({}, animDef), { transform: materialized });
       }
     }
   }
@@ -2853,8 +2880,8 @@ function isPathString(value) {
   return typeof value === "string" && extractPathData(value) !== void 0;
 }
 function normalizePathValue(value) {
-  if (value && typeof value === "object" && typeof value.path === "string") {
-    const d = extractPathData(value.path);
+  if (value && typeof value === "object" && typeof value.pathData === "string") {
+    const d = extractPathData(value.pathData);
     return d ? { paths: parseSvgPathToBezier(d) } : value;
   }
   if (value && typeof value === "object" && "paths" in value) {
@@ -2938,7 +2965,7 @@ function interpolateValue(propName, a, b, t) {
     const bPaths = (_b = b == null ? void 0 : b.paths) != null ? _b : Array.isArray(b) ? b : [];
     return { paths: interpolateBeziers(aPaths, bPaths, t) };
   }
-  if (COLOUR_ATTR_NAMES.has(propName)) {
+  if (COLOR_ATTR_NAMES.has(propName)) {
     return interpolateColor(a || [0, 0, 0, 1], b || [0, 0, 0, 1], t);
   }
   if (propName === "transform" && typeof a === "object" && a !== null && !Array.isArray(a) && typeof b === "object" && b !== null && !Array.isArray(b)) {
@@ -3160,7 +3187,7 @@ function normalizeKeyframes(propName, propAnim, duration, defs) {
       value = normalizePathValue(value);
     }
     const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
-    if (COLOUR_ATTR_NAMES.has(propNameKebab)) {
+    if (COLOR_ATTR_NAMES.has(propNameKebab)) {
       value = (_a2 = parseColor(value)) != null ? _a2 : value;
     }
     const normKf = {
@@ -3194,20 +3221,20 @@ function mergeAnimationDefinitions(animations) {
   }
   return merged;
 }
-function materialiseInternalLoopsInPropAnim(propName, propAnim, duration) {
+function materializeInternalLoopsInPropAnim(propName, propAnim, duration) {
   const loopRaw = propAnim.loop;
   if (loopRaw === void 0 || loopRaw === null || loopRaw === false) return propAnim;
   const loop = loopRaw === true ? {} : loopRaw;
   const rawKfs = propAnim.keyframes;
   if (!Array.isArray(rawKfs) || rawKfs.length < 2) return propAnim;
   const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
-  const isColour = COLOUR_ATTR_NAMES.has(propNameKebab);
+  const isColor = COLOR_ATTR_NAMES.has(propNameKebab);
   const kfs = rawKfs.map((kf) => {
     var _a2;
     const t = kfTime(kf);
     let v = kfValue(kf);
     if (propName === "d") v = normalizePathValue(v);
-    if (isColour) v = (_a2 = parseColor(v)) != null ? _a2 : v;
+    if (isColor) v = (_a2 = parseColor(v)) != null ? _a2 : v;
     const e = kfEasing(kf);
     const out2 = { t, v, e };
     const tIn = kfTangentIn(kf);
@@ -3221,15 +3248,15 @@ function materialiseInternalLoopsInPropAnim(propName, propAnim, duration) {
   if (propAnim.autoOrient !== void 0) out.autoOrient = propAnim.autoOrient;
   return out;
 }
-function materialiseInternalLoopsInTree(root, duration) {
-  const ret = walkAndMaterialiseLoops(root, duration);
+function materializeInternalLoopsInTree(root, duration) {
+  const ret = walkAndMaterializeLoops(root, duration);
   return ret != null ? ret : root;
 }
-function walkAndMaterialiseLoops(node, duration) {
+function walkAndMaterializeLoops(node, duration) {
   let newChildren;
   if (node.children) {
     for (let i = 0; i < node.children.length; i++) {
-      const ret = walkAndMaterialiseLoops(node.children[i], duration);
+      const ret = walkAndMaterializeLoops(node.children[i], duration);
       if (ret !== null) {
         if (!newChildren) newChildren = node.children.slice();
         newChildren[i] = ret;
@@ -3242,10 +3269,10 @@ function walkAndMaterialiseLoops(node, duration) {
     const animDef = animBucket;
     for (const propName of Object.keys(animDef)) {
       const propAnim = animDef[propName];
-      const materialised = materialiseInternalLoopsInPropAnim(propName, propAnim, duration);
-      if (materialised !== propAnim) {
+      const materialized = materializeInternalLoopsInPropAnim(propName, propAnim, duration);
+      if (materialized !== propAnim) {
         if (!newAnimate) newAnimate = __spreadValues({}, animDef);
-        newAnimate[propName] = materialised;
+        newAnimate[propName] = materialized;
       }
     }
   }
@@ -3300,19 +3327,17 @@ function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimeli
       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 === PxTimelineEngine.native && propName === "transform" ? materialiseMotionPathInPropAnim(out) : out;
+      normalized[propName] = engine === PxTimelineEngine.native && propName === "transform" ? materializeMotionPathInPropAnim(out) : out;
     }
   }
   return normalized;
 }
-function getNormalisedBindings(doc, engine = PxTimelineEngine.native) {
+function getNormalizedBindings(doc, engine = PxTimelineEngine.native) {
   const animatorConfig = getAnimatorConfig(doc) || {};
   const defs = getDefs(doc);
   const duration = animatorConfig.duration || 1e3;
   const bindings = [];
-  const processAnimation = (id, animate, staticTransform) => {
-    if (!animate) return null;
-    const animDefs = resolveElementAnimation(animate, defs);
+  const processAnimation = (id, animDefs, staticTransform) => {
     if (animDefs.length === 0) return null;
     const merged = mergeStaticTransformIntoAnimDef(mergeAnimationDefinitions(animDefs), staticTransform);
     const normalizedAnim = normalizeAnimationDefinition(merged, duration, defs, engine);
@@ -3325,7 +3350,9 @@ function getNormalisedBindings(doc, engine = PxTimelineEngine.native) {
   const docBindings = getBindings(doc);
   if (docBindings) {
     for (const binding of docBindings) {
-      const normalized = processAnimation(binding.id, binding.animate);
+      const id = binding.target.startsWith("#") ? binding.target.slice(1) : binding.target;
+      const animDefs = binding.animateWith.map((name) => resolveAnimation(name, defs)).filter((d) => !!d);
+      const normalized = processAnimation(id, animDefs);
       if (normalized) bindings.push(normalized);
     }
   }
@@ -3334,7 +3361,7 @@ function getNormalisedBindings(doc, engine = PxTimelineEngine.native) {
     if (inlineAnim && Object.keys(inlineAnim).length > 0) {
       const nodeId = node.id || generateElementId();
       node.id = nodeId;
-      const normalized = processAnimation(nodeId, inlineAnim, node.transform);
+      const normalized = processAnimation(nodeId, resolveElementAnimation(inlineAnim, defs), node.transform);
       if (normalized) bindings.push(normalized);
     }
     if (node.children) {
@@ -3396,7 +3423,7 @@ function calcPropertyValue(propName, propAnim, progress) {
       nextPaths,
       localProgress
     ).map((bz) => bezierToSvgPath(bz)).join("");
-  } else if (COLOUR_ATTR_NAMES.has(cssAttrName)) {
+  } else if (COLOR_ATTR_NAMES.has(cssAttrName)) {
     cssValue = toRGBA(interpolateColor(
       prevV || [0, 0, 0, 1],
       nextV || [0, 0, 0, 1],
@@ -3441,268 +3468,56 @@ function calcPropertyValue(propName, propAnim, progress) {
         );
         partsResult.translate = [sample.translate[0], sample.translate[1]];
         if (sample.rotateDeg !== void 0) partsResult.rotate = sample.rotateDeg;
-      }
-    }
-    cssValue = composeTransformParts(partsResult, { withUnits: false });
-    cssAttrName = "transform";
-  } else if (cssAttrName === "translate") {
-    const v = interpolateVec(
-      prevV || [0, 0],
-      nextV || [0, 0],
-      localProgress
-    );
-    cssValue = "translate(" + v.join(",") + ")";
-    cssAttrName = "transform";
-  } else if (cssAttrName === "rotate") {
-    const v = interpolateNum(
-      +(prevV || 0),
-      +(nextV || 0),
-      localProgress
-    );
-    cssValue = "rotate(" + v + ")";
-    cssAttrName = "transform";
-  } else if (cssAttrName === "scale") {
-    const v = interpolateVec(
-      prevV || [1, 1],
-      nextV || [1, 1],
-      localProgress
-    );
-    cssValue = "scale(" + v.join(",") + ")";
-    cssAttrName = "transform";
-  } else {
-    const num2 = interpolateNum(
-      +(prevV || 0),
-      +(nextV || 0),
-      localProgress
-    );
-    cssValue = num2;
-  }
-  if (PCT_BASED_ATTR_NAMES.has(cssAttrName) && typeof cssValue === "number") {
-    cssValue = cssValue * 100 + "%";
-  }
-  return { k: cssAttrName, v: cssValue === null ? "" : "" + cssValue };
-}
-function calcAnimationValues(animDef, progress) {
-  const result = {};
-  for (const [propName, propAnim] of Object.entries(animDef)) {
-    const computed = calcPropertyValue(propName, propAnim, progress);
-    if (computed) {
-      result[computed.k] = computed.v;
-    }
-  }
-  return result;
-}
-
-// src/util/PxNodeCloneUtil.ts
-function deepClonePxNode(value) {
-  if (value === null || typeof value !== "object") return value;
-  if (Array.isArray(value)) return value.map(deepClonePxNode);
-  const out = {};
-  for (const k of Object.keys(value)) out[k] = deepClonePxNode(value[k]);
-  return out;
-}
-function regenerateIdsAndRewriteRefs(root, genId3) {
-  const oldToNew = /* @__PURE__ */ new Map();
-  const walkAssign = (n) => {
-    var _a2;
-    if (typeof n.id === "string") {
-      const newId = genId3();
-      oldToNew.set(n.id, newId);
-      n.id = newId;
-    }
-    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkAssign);
-  };
-  walkAssign(root);
-  const rewriteUrl = (s) => s.replace(/url\(#([^)]+)\)/g, (m, oldId) => {
-    const newId = oldToNew.get(oldId);
-    return newId ? "url(#" + newId + ")" : m;
-  });
-  const walkRewrite = (n) => {
-    var _a2;
-    if (typeof n.href === "string" && n.href.startsWith("#")) {
-      const newId = oldToNew.get(n.href.slice(1));
-      if (newId) n.href = "#" + newId;
-    }
-    for (const k of Object.keys(n)) {
-      if (k === "children" || k === "effects" || k === "meta" || k === "animate" || k === "href" || k === "id") continue;
-      const v = n[k];
-      if (typeof v === "string" && v.indexOf("url(#") !== -1) {
-        n[k] = rewriteUrl(v);
-      }
-    }
-    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkRewrite);
-  };
-  walkRewrite(root);
-  return oldToNew;
-}
-function toFiniteNum(v) {
-  const n = typeof v === "number" ? v : typeof v === "string" ? parseFloat(v) : NaN;
-  return Number.isFinite(n) ? n : 0;
-}
-function applyUseOffsetToG(gNode) {
-  var _a2;
-  const x = toFiniteNum(gNode.x);
-  const y = toFiniteNum(gNode.y);
-  delete gNode.x;
-  delete gNode.y;
-  if (!x && !y) return 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: (_a2 = gNode.children) != null ? _a2 : [] };
-    gNode.children = [inner];
-  } else {
-    gNode.transform = offset;
-  }
-  return gNode;
-}
-
-// src/materialise/PxAnimatorUseMaterialiser.ts
-function materialiseAnimatedUseInstances(root) {
-  var _a2;
-  const idMap = buildIdMap(root);
-  const animatedIds = computeAnimatedSubtreeIds(root, idMap);
-  if (animatedIds.size === 0) return root;
-  let idCounter = 0;
-  const genId3 = () => "_lw_use_mat_" + ++idCounter;
-  const rootViewport = readRootViewport(root);
-  const defsCollector = [];
-  const walked = walkAndMaterialise2(root, idMap, animatedIds, genId3, defsCollector, rootViewport);
-  if (defsCollector.length === 0) return walked;
-  const defsNode = { type: "defs", children: defsCollector };
-  const newChildren = [...(_a2 = walked.children) != null ? _a2 : [], defsNode];
-  return __spreadProps(__spreadValues({}, walked), { children: newChildren });
-}
-function readRootViewport(root) {
-  const vb = parseViewBox(root.viewBox);
-  if (vb) return [vb[2], vb[3]];
-  const w = numericAttr(root.width);
-  const h = numericAttr(root.height);
-  if (w !== void 0 && h !== void 0) return [w, h];
-  return [1, 1];
-}
-function numericAttr(v) {
-  if (typeof v === "number") return v;
-  if (typeof v === "string") {
-    const n = parseFloat(v);
-    return Number.isFinite(n) ? n : void 0;
-  }
-  return void 0;
-}
-function buildIdMap(root) {
-  const map = /* @__PURE__ */ new Map();
-  const visit = (n) => {
-    var _a2;
-    if (typeof n.id === "string") map.set(n.id, n);
-    (_a2 = n.children) == null ? void 0 : _a2.forEach(visit);
-  };
-  visit(root);
-  return map;
-}
-function computeAnimatedSubtreeIds(root, idMap) {
-  const cache = /* @__PURE__ */ new WeakMap();
-  const result = /* @__PURE__ */ new Set();
-  const hasAnim = (n, visiting) => {
-    const cached = cache.get(n);
-    if (cached !== void 0) return cached;
-    if (visiting.has(n)) return false;
-    visiting.add(n);
-    let r = false;
-    if (n.animate && typeof n.animate === "object" && !Array.isArray(n.animate)) {
-      for (const _ in n.animate) {
-        r = true;
-        break;
-      }
-    }
-    if (!r && n.children) {
-      for (const ch of n.children) {
-        if (hasAnim(ch, visiting)) {
-          r = true;
-          break;
-        }
-      }
-    }
-    if (!r && n.type === "use" && typeof n.href === "string") {
-      const targetId = stripHash(n.href);
-      const target = targetId ? idMap.get(targetId) : void 0;
-      if (target) r = hasAnim(target, visiting);
-    }
-    visiting.delete(n);
-    cache.set(n, r);
-    return r;
-  };
-  for (const [id, node] of idMap) {
-    if (hasAnim(node, /* @__PURE__ */ new Set())) result.add(id);
+      }
+    }
+    cssValue = composeTransformParts(partsResult, { withUnits: false });
+    cssAttrName = "transform";
+  } else if (cssAttrName === "translate") {
+    const v = interpolateVec(
+      prevV || [0, 0],
+      nextV || [0, 0],
+      localProgress
+    );
+    cssValue = "translate(" + v.join(",") + ")";
+    cssAttrName = "transform";
+  } else if (cssAttrName === "rotate") {
+    const v = interpolateNum(
+      +(prevV || 0),
+      +(nextV || 0),
+      localProgress
+    );
+    cssValue = "rotate(" + v + ")";
+    cssAttrName = "transform";
+  } else if (cssAttrName === "scale") {
+    const v = interpolateVec(
+      prevV || [1, 1],
+      nextV || [1, 1],
+      localProgress
+    );
+    cssValue = "scale(" + v.join(",") + ")";
+    cssAttrName = "transform";
+  } else {
+    const num2 = interpolateNum(
+      +(prevV || 0),
+      +(nextV || 0),
+      localProgress
+    );
+    cssValue = num2;
   }
-  return result;
-}
-function stripHash(href) {
-  if (typeof href !== "string") return void 0;
-  return href.startsWith("#") ? href.slice(1) : href;
-}
-function materialiseOneUse(useNode, target, idMap, animatedIds, genId3, defsCollector, rootViewport) {
-  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 = (_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);
-  const newNode = __spreadProps(__spreadValues({}, useNode), { type: "g", children: [materialisedClone] });
-  delete newNode.href;
-  delete newNode.width;
-  delete newNode.height;
-  return applyUseOffsetToG(newNode);
-}
-function rewriteSymbolRootToGroup(symbolNode, genId3, defsCollector, useW, useH) {
-  const viewBox = parseViewBox(symbolNode.viewBox);
-  const g = __spreadProps(__spreadValues({}, symbolNode), { type: "g" });
-  delete g.viewBox;
-  delete g.preserveAspectRatio;
-  delete g.width;
-  delete g.height;
-  if (!viewBox) return g;
-  const [vbX, vbY, vbW, vbH] = viewBox;
-  const scale = vbW > 0 && vbH > 0 ? Math.min(useW / vbW, useH / vbH) : 1;
-  const xOff = (useW - vbW * scale) / 2;
-  const yOff = (useH - vbH * scale) / 2;
-  const parts = [];
-  if (xOff !== 0 || yOff !== 0) parts.push("translate(" + xOff + "," + yOff + ")");
-  if (scale !== 1) parts.push("scale(" + scale + ")");
-  if (vbX !== 0 || vbY !== 0) parts.push("translate(" + -vbX + "," + -vbY + ")");
-  if (parts.length) g.transform = parts.join("");
-  const clipId = genId3();
-  defsCollector.push({
-    type: "clipPath",
-    id: clipId,
-    children: [{ type: "rect", x: vbX, y: vbY, width: vbW, height: vbH }]
-  });
-  g.clipPath = "url(#" + clipId + ")";
-  return g;
-}
-function parseViewBox(v) {
-  if (typeof v !== "string") return void 0;
-  const parts = v.trim().split(/[\s,]+/).map(Number);
-  if (parts.length < 4 || parts.some((n) => !Number.isFinite(n))) return void 0;
-  return [parts[0], parts[1], parts[2], parts[3]];
+  if (PCT_BASED_ATTR_NAMES.has(cssAttrName) && typeof cssValue === "number") {
+    cssValue = cssValue * 100 + "%";
+  }
+  return { k: cssAttrName, v: cssValue === null ? "" : "" + cssValue };
 }
-function walkAndMaterialise2(node, idMap, animatedIds, genId3, defsCollector, rootViewport) {
-  if (node.type === "use" && typeof node.href === "string") {
-    const targetId = stripHash(node.href);
-    if (targetId && animatedIds.has(targetId)) {
-      const target = idMap.get(targetId);
-      if (target) return materialiseOneUse(node, target, idMap, animatedIds, genId3, defsCollector, rootViewport);
+function calcAnimationValues(animDef, progress) {
+  const result = {};
+  for (const [propName, propAnim] of Object.entries(animDef)) {
+    const computed = calcPropertyValue(propName, propAnim, progress);
+    if (computed) {
+      result[computed.k] = computed.v;
     }
   }
-  if (!node.children) return node;
-  let changed = false;
-  const newChildren = node.children.map((ch) => {
-    const m = walkAndMaterialise2(ch, idMap, animatedIds, genId3, defsCollector, rootViewport);
-    if (m !== ch) changed = true;
-    return m;
-  });
-  return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
+  return result;
 }
 
 // src/effects/shared/transformParts.ts
@@ -3723,7 +3538,7 @@ function readAnimatable(raw) {
     const obj = raw;
     const kfs = obj.keyframes;
     if (kfs) {
-      const out = { kind: "animated" /* Animated */, keyframes: kfs.map(normaliseKeyframe), autoOrient: obj.autoOrient, loop: obj.loop };
+      const out = { kind: "animated" /* Animated */, keyframes: kfs.map(normalizeKeyframe), autoOrient: obj.autoOrient, loop: obj.loop };
       const base = (_a2 = obj.value) != null ? _a2 : obj.v;
       if (base !== void 0 && out.kind === "animated" /* Animated */) out.base = base;
       return out;
@@ -3751,7 +3566,7 @@ function writeAnimatableChannel(node, attrName, read, opts) {
   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) {
+function normalizeKeyframe(kf) {
   if (!kf || typeof kf !== "object") return kf;
   const k = kf;
   if (k.t === void 0 && k.v === void 0 && k.e === void 0 && k.to === void 0 && k.ti === void 0) {
@@ -3873,11 +3688,75 @@ function wrapOrigin(inner, raw, invert) {
   return inner;
 }
 
+// src/util/PxNodeCloneUtil.ts
+function deepClonePxNode(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) return value.map(deepClonePxNode);
+  const out = {};
+  for (const k of Object.keys(value)) out[k] = deepClonePxNode(value[k]);
+  return out;
+}
+function regenerateIdsAndRewriteRefs(root, genId3) {
+  const oldToNew = /* @__PURE__ */ new Map();
+  const walkAssign = (n) => {
+    var _a2;
+    if (typeof n.id === "string") {
+      const newId = genId3();
+      oldToNew.set(n.id, newId);
+      n.id = newId;
+    }
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkAssign);
+  };
+  walkAssign(root);
+  const rewriteUrl = (s) => s.replace(/url\(#([^)]+)\)/g, (m, oldId) => {
+    const newId = oldToNew.get(oldId);
+    return newId ? "url(#" + newId + ")" : m;
+  });
+  const walkRewrite = (n) => {
+    var _a2;
+    if (typeof n.href === "string" && n.href.startsWith("#")) {
+      const newId = oldToNew.get(n.href.slice(1));
+      if (newId) n.href = "#" + newId;
+    }
+    for (const k of Object.keys(n)) {
+      if (k === "children" || k === "effects" || k === "meta" || k === "animate" || k === "href" || k === "id") continue;
+      const v = n[k];
+      if (typeof v === "string" && v.indexOf("url(#") !== -1) {
+        n[k] = rewriteUrl(v);
+      }
+    }
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(walkRewrite);
+  };
+  walkRewrite(root);
+  return oldToNew;
+}
+function toFiniteNum(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? parseFloat(v) : NaN;
+  return Number.isFinite(n) ? n : 0;
+}
+function applyUseOffsetToG(gNode) {
+  var _a2;
+  const x = toFiniteNum(gNode.x);
+  const y = toFiniteNum(gNode.y);
+  delete gNode.x;
+  delete gNode.y;
+  if (!x && !y) return 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: (_a2 = gNode.children) != null ? _a2 : [] };
+    gNode.children = [inner];
+  } else {
+    gNode.transform = offset;
+  }
+  return gNode;
+}
+
 // src/effects/shared/util.ts
 function genId(ctx, prefix) {
   return "_lw_" + prefix + "_" + ctx.nextId++;
 }
-function stripHash2(href) {
+function stripHash(href) {
   return typeof href === "string" ? href.replace(/^#/, "") : void 0;
 }
 function indexById(node, map) {
@@ -3899,7 +3778,7 @@ function regenerateIdsInClone(root, ctx) {
 function identifyContentRefTargets(node, ctx, allocator) {
   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);
+    const sourceId = stripHash(node.effects.clone.source);
     if (typeof sourceId === "string" && sourceId && !ctx.contentRefInnerIds.has(sourceId)) {
       ctx.contentRefInnerIds.set(sourceId, allocator(sourceId));
     }
@@ -4263,10 +4142,10 @@ function formatOffset(o) {
 
 // src/effects/clipping/clipPathEffect.ts
 function applyClipPathEffect(node, fx, ctx) {
-  if (!(fx == null ? void 0 : fx.d)) return node;
+  if (!(fx == null ? void 0 : fx.pathData)) return node;
   const clipId = genId(ctx, "clip");
   const pathChild = { type: "path" };
-  const read = readAnimatable(fx.d);
+  const read = readAnimatable(fx.pathData);
   if (read.kind !== "absent" /* Absent */) {
     if (read.kind === "static" /* Static */) {
       pathChild.d = pathString(read.value);
@@ -4281,14 +4160,14 @@ function applyClipPathEffect(node, fx, ctx) {
 }
 function pathString(v) {
   if (typeof v === "string") return v;
-  if (v && typeof v === "object" && typeof v.path === "string") return v.path;
+  if (v && typeof v === "object" && typeof v.pathData === "string") return v.pathData;
   return void 0;
 }
 
 // src/effects/clipping/maskedByEffect.ts
 function applyMaskedByEffect(node, fx, transformBy, ctx) {
   if (!fx) return node;
-  const sourceId = stripHash2(fx.source);
+  const sourceId = stripHash(fx.source);
   if (!sourceId) {
     ctx.errors.push("maskedBy.source missing \u2014 cannot build mask");
     return node;
@@ -4328,8 +4207,8 @@ function wrapInverseTransform(inner, fx, ctx) {
 }
 function wrapInversePart(inner, part, raw, origin, ctx) {
   if (raw === void 0) return inner;
-  const normalisedRaw = part === "scale" /* Scale */ && Array.isArray(raw) ? [raw[0] / 100, raw[1] / 100] : raw;
-  const v = readAnimatable(normalisedRaw);
+  const normalizedRaw = part === "scale" /* Scale */ && Array.isArray(raw) ? [raw[0] / 100, raw[1] / 100] : raw;
+  const v = readAnimatable(normalizedRaw);
   if (v.kind === "static" /* Static */) {
     return { type: "g", transform: { value: partsRecord(part, invertPartValue(part, v.value), origin) }, children: [inner] };
   }
@@ -4565,7 +4444,7 @@ function collectMaskAncestorChains(root, ctx) {
   const interestingNodes = /* @__PURE__ */ new Set();
   const collectInterestingNodes = (n) => {
     var _a2, _b;
-    const maskSourceId = stripHash2((_b = (_a2 = n.effects) == null ? void 0 : _a2.maskedBy) == null ? void 0 : _b.source);
+    const maskSourceId = stripHash((_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);
@@ -4645,7 +4524,7 @@ function parseTranslateOnlyFromString(s, ctx) {
 // src/effects/reference/refEffect.ts
 function applyRefHref(node, clone2, ctx) {
   if (!clone2) return;
-  const sourceId = stripHash2(clone2.source);
+  const sourceId = stripHash(clone2.source);
   if (!sourceId) {
     if (clone2.without === PxCloneWithout.translate) ctx.errors.push("clone: content ref missing `source`");
     return;
@@ -4730,7 +4609,7 @@ function synthesiseScale(raw, i) {
 }
 
 // src/effects/reference/retimeEffect.ts
-var RETIME_MATERIALISATION_MODE_INLINE_G = false;
+var RETIME_MATERIALIZATION_MODE_INLINE_G = false;
 function asRetime(r) {
   var _a2, _b;
   return { start: (_a2 = r.start) != null ? _a2 : 0, stretch: (_b = r.stretch) != null ? _b : 1 };
@@ -4791,7 +4670,7 @@ function applyAllRetimeEffects(root, ctx) {
       if (!n) return;
       if (n !== site && readCloneRetime(n)) count++;
       if (n.type === "use" && n.href) {
-        const id = stripHash2(n.href);
+        const id = stripHash(n.href);
         if (id && !visited.has(id)) {
           visited.add(id);
           walk(ctx.idMap.get(id));
@@ -4799,7 +4678,7 @@ function applyAllRetimeEffects(root, ctx) {
       }
       (_a2 = n.children) == null ? void 0 : _a2.forEach(walk);
     };
-    const rootId = stripHash2(site.href);
+    const rootId = stripHash(site.href);
     if (rootId) {
       visited.add(rootId);
       walk(ctx.idMap.get(rootId));
@@ -4815,19 +4694,19 @@ function applyAllRetimeEffects(root, ctx) {
     if (!retime) continue;
     const crop = retime.timeCrop;
     clearCloneRetime(useNode);
-    materialiseRetime(useNode, asRetime(retime), ctx);
+    materializeRetime(useNode, asRetime(retime), ctx);
     if (crop) applyTimeCrop(useNode, crop, ctx);
   }
 }
-function materialiseRetime(useNode, retime, ctx) {
-  const targetId = stripHash2(useNode.href);
+function materializeRetime(useNode, retime, ctx) {
+  const targetId = stripHash(useNode.href);
   if (!targetId) {
     ctx.errors.push("retime: <use> has no href to follow");
     return;
   }
   const chainRootId = buildChainClone(targetId, retime, ctx, /* @__PURE__ */ new Set());
   if (!chainRootId) return;
-  if (RETIME_MATERIALISATION_MODE_INLINE_G) {
+  if (RETIME_MATERIALIZATION_MODE_INLINE_G) {
     const cloneNode = ctx.idMap.get(chainRootId);
     useNode.type = "g";
     delete useNode.href;
@@ -4857,7 +4736,7 @@ function buildChainClone(targetId, accum, ctx, chain) {
   }
   clearCloneRetime(cloneNode);
   if (target.type === "use" && target.href) {
-    const subId = stripHash2(target.href);
+    const subId = stripHash(target.href);
     if (subId) {
       const innerRetime = readCloneRetime(target);
       const subAccum = innerRetime ? concatRetime(asRetime(innerRetime), accum) : accum;
@@ -4867,18 +4746,18 @@ function buildChainClone(targetId, accum, ctx, chain) {
       if (subId2) cloneNode.href = "#" + subId2;
     }
   } else {
-    materialiseNestedRetimeUses(cloneNode, accum, ctx, chain, targetId);
+    materializeNestedRetimeUses(cloneNode, accum, ctx, chain, targetId);
   }
   ctx.defs.push(cloneNode);
   if (typeof cloneNode.id === "string") ctx.idMap.set(cloneNode.id, cloneNode);
   return typeof cloneNode.id === "string" ? cloneNode.id : void 0;
 }
-function materialiseNestedRetimeUses(node, accum, ctx, chain, parentTargetId) {
+function materializeNestedRetimeUses(node, accum, ctx, chain, parentTargetId) {
   const visit = (n) => {
     var _a2;
     const retime = readCloneRetime(n);
     if (n.type === "use" && retime && n.href) {
-      const subId = stripHash2(n.href);
+      const subId = stripHash(n.href);
       if (subId) {
         const subAccum = concatRetime(asRetime(retime), accum);
         const subChain = new Set(chain);
@@ -5074,10 +4953,10 @@ function numRange(v) {
 function estimateTextAdvance(node) {
   let chars = 0, maxFont = 16;
   const walk = (el) => {
-    var _a2, _b;
+    var _a2;
     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;
+    const t = el.textContent;
     if (typeof t === "string") chars += t.length;
     if (el.children) for (const c of el.children) walk(c);
   };
@@ -5232,7 +5111,6 @@ var TEXT_ATTR_KEYS = [
   "stroke",
   "strokeWidth",
   "effects",
-  TEXT_ATTR,
   TEXT_CONTENT_ATTR,
   "xml:space"
 ];
@@ -5269,7 +5147,7 @@ function paintAnimateOf(node) {
   }
   return out;
 }
-function resolveStyle2(node, parent) {
+function resolveStyle(node, parent) {
   var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const isTextRoot = node.type === "text";
   const nodeStyle = node.style;
@@ -5342,8 +5220,8 @@ function missingGlyphBoxEm(advanceEm, ascentEm) {
   const ix0 = x0 + t, ix1 = x1 - t, iyb = -t, iyt = y1 + t;
   return outer + "M" + ix0 + " " + iyb + "L" + ix0 + " " + iyt + "L" + ix1 + " " + iyt + "L" + ix1 + " " + iyb + "Z";
 }
-function materialiseGlyphTextHorizontal(node, opts) {
-  var _a2, _b, _c, _d;
+function materializeGlyphTextHorizontal(node, opts) {
+  var _a2, _b, _c;
   const { glyphs, create = jsonElementFactory, warnings } = opts;
   const soleFont = soleFontOf(glyphs);
   const pen = { x: (_a2 = parseLen(node.x)) != null ? _a2 : 0, y: (_b = parseLen(node.y)) != null ? _b : 0 };
@@ -5360,8 +5238,8 @@ function materialiseGlyphTextHorizontal(node, opts) {
     for (let i = 0; i < content.length; i++) {
       const ch = content.charAt(i);
       const g = gf == null ? void 0 : gf.glyphs[ch];
-      if (g && g.d) {
-        placements.push({ glyphD: g.d, m: [scale, 0, 0, scale, pen.x, pen.y], paint, line, x: pen.x, y: pen.y, scale });
+      if (g && g.pathData) {
+        placements.push({ glyphD: g.pathData, m: [scale, 0, 0, scale, pen.x, pen.y], paint, line, x: pen.x, y: pen.y, scale });
         pen.x += g.width * scale;
       } else if (/\S/.test(ch)) {
         const advEm = g && g.width > 0 ? g.width : MISSING_GLYPH_ADVANCE_EM * upm;
@@ -5375,8 +5253,8 @@ function materialiseGlyphTextHorizontal(node, opts) {
     }
   };
   const walk = (el, parentStyle) => {
-    var _a3, _b2, _c2, _d2;
-    const s = resolveStyle2(el, parentStyle);
+    var _a3, _b2, _c2;
+    const s = resolveStyle(el, parentStyle);
     const x = parseLen(el.x);
     const y = parseLen(el.y);
     if (x !== void 0) {
@@ -5387,14 +5265,14 @@ function materialiseGlyphTextHorizontal(node, opts) {
     if (y !== void 0) pen.y = y;
     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);
+    const content = str(el[TEXT_CONTENT_ATTR]);
+    if (content && !((_c2 = el.children) == null ? void 0 : _c2.length)) renderChars(content, s);
     if (el.children) for (const ch of el.children) walk(ch, s);
   };
   const rootStyle = rootStyleOf(node);
   if (node.children) for (const ch of node.children) walk(ch, rootStyle);
-  const rootContent = (_c = str(node[TEXT_CONTENT_ATTR])) != null ? _c : str(node[TEXT_ATTR]);
-  if (rootContent && !((_d = node.children) == null ? void 0 : _d.length)) renderChars(rootContent, rootStyle);
+  const rootContent = str(node[TEXT_CONTENT_ATTR]);
+  if (rootContent && !((_c = node.children) == null ? void 0 : _c.length)) renderChars(rootContent, rootStyle);
   const anchor = str(node.textAnchor);
   if (anchor === "middle" || anchor === "end") {
     for (const p of placements) {
@@ -5406,7 +5284,7 @@ function materialiseGlyphTextHorizontal(node, opts) {
   return toGroup(node, buildPaths(placements, create, warnings), create);
 }
 function layoutGlyphTextChars(node, opts) {
-  var _a2, _b, _c, _d, _e, _f;
+  var _a2, _b, _c, _d, _e;
   if ((_a2 = opts.alongPath) == null ? void 0 : _a2.pathD) return layoutGlyphTextCharsAlongPath(node, opts.alongPath.pathD, opts);
   const { glyphs, warnings } = opts;
   const soleFont = soleFontOf(glyphs);
@@ -5430,8 +5308,8 @@ function layoutGlyphTextChars(node, opts) {
     }
   };
   const walk = (el, parentStyle) => {
-    var _a3, _b2, _c2, _d2;
-    const s = resolveStyle2(el, parentStyle);
+    var _a3, _b2, _c2;
+    const s = resolveStyle(el, parentStyle);
     const x = parseLen(el.x);
     const y = parseLen(el.y);
     if (x !== void 0) {
@@ -5442,8 +5320,8 @@ function layoutGlyphTextChars(node, opts) {
     if (y !== void 0) pen.y = y;
     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);
+    const content = str(el[TEXT_CONTENT_ATTR]);
+    if (content && !((_c2 = el.children) == null ? void 0 : _c2.length)) renderChars(content, s);
     if (el.children) for (const ch of el.children) walk(ch, s);
   };
   const rootStyle = rootStyleOf(node);
@@ -5451,14 +5329,14 @@ function layoutGlyphTextChars(node, opts) {
     const before = boxes.length;
     walk(ch, rootStyle);
     if (boxes.length === before) {
-      const s = resolveStyle2(ch, rootStyle);
+      const s = resolveStyle(ch, rootStyle);
       const gf = glyphFontFor(s, glyphs, soleFont);
       const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
       boxes.push({ x: pen.x, y: pen.y, width: 0, ascent: ((_d = gf == null ? void 0 : gf.ascent) != null ? _d : 0.9 * upm) * (s.fontSize / upm), fontSize: s.fontSize, line });
     }
   }
-  const rootContent = (_e = str(node[TEXT_CONTENT_ATTR])) != null ? _e : str(node[TEXT_ATTR]);
-  if (rootContent && !((_f = node.children) == null ? void 0 : _f.length)) renderChars(rootContent, rootStyle);
+  const rootContent = str(node[TEXT_CONTENT_ATTR]);
+  if (rootContent && !((_e = node.children) == null ? void 0 : _e.length)) renderChars(rootContent, rootStyle);
   const anchor = str(node.textAnchor);
   if (anchor === "middle" || anchor === "end") {
     for (const b of boxes) {
@@ -5466,8 +5344,8 @@ function layoutGlyphTextChars(node, opts) {
       b.x += anchor === "middle" ? -w / 2 : -w;
     }
   }
-  return boxes.map((_g) => {
-    var _h = _g, { line: _l } = _h, b = __objRest(_h, ["line"]);
+  return boxes.map((_f) => {
+    var _g = _f, { line: _l } = _g, b = __objRest(_g, ["line"]);
     return b;
   });
 }
@@ -5483,14 +5361,14 @@ function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
   const chars = [];
   let adv = 0;
   const walk = (el, parentStyle) => {
-    var _a3, _b2, _c;
-    const s = resolveStyle2(el, parentStyle);
-    const content = (_a3 = str(el[TEXT_CONTENT_ATTR])) != null ? _a3 : str(el[TEXT_ATTR]);
-    if (content && !((_b2 = el.children) == null ? void 0 : _b2.length)) {
+    var _a3, _b2;
+    const s = resolveStyle(el, parentStyle);
+    const content = str(el[TEXT_CONTENT_ATTR]);
+    if (content && !((_a3 = el.children) == null ? void 0 : _a3.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
       const scale = s.fontSize / upm;
-      const ascent = ((_c = gf == null ? void 0 : gf.ascent) != null ? _c : 0.9 * upm) * scale;
+      const ascent = ((_b2 = gf == null ? void 0 : gf.ascent) != null ? _b2 : 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];
@@ -5537,21 +5415,21 @@ function collectAlongPathCells(node, glyphs, soleFont, warnings) {
   const cells = [];
   let adv = 0;
   const walk = (el, parentStyle) => {
-    var _a2, _b, _c;
-    const s = resolveStyle2(el, parentStyle);
-    const content = (_a2 = str(el[TEXT_CONTENT_ATTR])) != null ? _a2 : str(el[TEXT_ATTR]);
-    if (content && !((_b = el.children) == null ? void 0 : _b.length)) {
+    var _a2, _b;
+    const s = resolveStyle(el, parentStyle);
+    const content = str(el[TEXT_CONTENT_ATTR]);
+    if (content && !((_a2 = el.children) == null ? void 0 : _a2.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       if (gf) {
         const scale = s.fontSize / gf.unitsPerEm;
-        const ascentEm = (_c = gf.ascent) != null ? _c : 0.9 * gf.unitsPerEm;
+        const ascentEm = (_b = gf.ascent) != null ? _b : 0.9 * gf.unitsPerEm;
         const paint = paintOf(s);
         for (let i = 0; i < content.length; i++) {
           const ch = content.charAt(i);
           const g = gf.glyphs[ch];
-          if (g && g.d) {
+          if (g && g.pathData) {
             const glyphAdv = g.width * scale;
-            cells.push({ glyphD: g.d, widthEm: g.width, scale, paint, midBase: adv + glyphAdv / 2 });
+            cells.push({ glyphD: g.pathData, widthEm: g.width, scale, paint, midBase: adv + glyphAdv / 2 });
             adv += glyphAdv;
           } else if (/\S/.test(ch)) {
             const wEm = g && g.width > 0 ? g.width : MISSING_GLYPH_ADVANCE_EM * gf.unitsPerEm;
@@ -5582,7 +5460,7 @@ function alongPathNodeOffsets(node) {
     perp: (_c = parseLen(node.dy)) != null ? _c : 0
   };
 }
-function materialiseGlyphTextAlongPath(node, pathD, startOffset, opts, textLength, pathOverflow) {
+function materializeGlyphTextAlongPath(node, pathD, startOffset, opts, textLength, pathOverflow) {
   const { glyphs, create = jsonElementFactory, warnings } = opts;
   const sampler = pathD ? createPathSampler(pathD) : null;
   if (!sampler) {
@@ -5661,8 +5539,8 @@ function buildAnimatedAlongPath(cells, sampler, distOf, times, loop, create, isC
   const onPath = (dist) => dist >= 0 && dist <= sampler.totalLength;
   const out = [];
   for (const c of cells) {
-    const centred = [c.scale, 0, 0, c.scale, -c.scale * (c.widthEm / 2), 0];
-    const d = transformPathData(c.glyphD, centred);
+    const centered = [c.scale, 0, 0, c.scale, -c.scale * (c.widthEm / 2), 0];
+    const d = transformPathData(c.glyphD, centered);
     const sampleKf = (dist, time) => {
       const { x, y, angle } = sampler.sampleAtDistance(dist);
       const cos = Math.cos(angle), sin = Math.sin(angle);
@@ -5754,9 +5632,9 @@ function toGroup(node, children, create) {
   }
   return create("g", gProps, children);
 }
-function materialiseGlyphText(node, opts) {
-  if (opts.alongPath) return materialiseGlyphTextAlongPath(node, opts.alongPath.pathD, opts.alongPath.startOffset, opts, opts.alongPath.textLength, opts.alongPath.pathOverflow);
-  return materialiseGlyphTextHorizontal(node, opts);
+function materializeGlyphText(node, opts) {
+  if (opts.alongPath) return materializeGlyphTextAlongPath(node, opts.alongPath.pathD, opts.alongPath.startOffset, opts, opts.alongPath.textLength, opts.alongPath.pathOverflow);
+  return materializeGlyphTextHorizontal(node, opts);
 }
 function applyTextGlyphsEffect(node, fx, ctx) {
   if (!(fx == null ? void 0 : fx.useGlyphs)) return node;
@@ -5764,14 +5642,14 @@ function applyTextGlyphsEffect(node, fx, ctx) {
     ctx.warnings.push("textGlyphs: no definitions.fonts \u2014 left as native <text>");
     return node;
   }
-  return materialiseGlyphTextHorizontal(node, { glyphs: ctx.glyphs, warnings: ctx.warnings });
+  return materializeGlyphTextHorizontal(node, { glyphs: ctx.glyphs, warnings: ctx.warnings });
 }
 function applyTextGlyphsAlongPath(node, ctx, pathD, startOffset, textLength, pathOverflow) {
   if (!ctx.glyphs) {
     ctx.warnings.push("textGlyphs: no definitions.fonts");
     return null;
   }
-  return materialiseGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
+  return materializeGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
 }
 
 // src/effects/stroke/strokeTrimEffect.ts
@@ -6173,7 +6051,7 @@ function applyPlayerEffects_retime(node, ctx) {
   return node;
 }
 
-// src/materialise/PxOffsetPathMaterialiser.ts
+// src/materialize/PxOffsetPathMaterializer.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;
@@ -6239,7 +6117,7 @@ function buildOffsetPath(propAnim) {
   }
   return { pathStr: d, distanceKfs, autoOrient: !!propAnim.autoOrient, anchor };
 }
-function materialiseOffsetPathsInTree(root) {
+function materializeOffsetPathsInTree(root) {
   const walk = (node) => {
     var _a2;
     let out = node;
@@ -6261,38 +6139,186 @@ function materialiseOffsetPathsInTree(root) {
           delete t[TRANSFORM_PART.origin];
           newTransform = Object.keys(t).length ? t : void 0;
         }
-        out = __spreadProps(__spreadValues({}, node), {
-          animate: newAnimate,
-          style: __spreadProps(__spreadValues({}, node.style), {
-            offsetPath: "path('" + built.pathStr + "')",
-            offsetAnchor: fmt2(built.anchor[0]) + "px " + fmt2(built.anchor[1]) + "px",
-            offsetRotate: built.autoOrient ? "auto" : "0deg",
-            offsetDistance: "0%"
-          })
-        });
-        if (newTransform !== void 0) out.transform = newTransform;
-        else delete out.transform;
+        out = __spreadProps(__spreadValues({}, node), {
+          animate: newAnimate,
+          style: __spreadProps(__spreadValues({}, node.style), {
+            offsetPath: "path('" + built.pathStr + "')",
+            offsetAnchor: fmt2(built.anchor[0]) + "px " + fmt2(built.anchor[1]) + "px",
+            offsetRotate: built.autoOrient ? "auto" : "0deg",
+            offsetDistance: "0%"
+          })
+        });
+        if (newTransform !== void 0) out.transform = newTransform;
+        else delete out.transform;
+      }
+    }
+    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 });
+    }
+    return out;
+  };
+  return walk(root);
+}
+
+// src/materialize/PxAnimatorUseMaterializer.ts
+function materializeAnimatedUseInstances(root) {
+  var _a2;
+  const idMap = buildIdMap(root);
+  const animatedIds = computeAnimatedSubtreeIds(root, idMap);
+  if (animatedIds.size === 0) return root;
+  let idCounter = 0;
+  const genId3 = () => "_lw_use_mat_" + ++idCounter;
+  const rootViewport = readRootViewport(root);
+  const defsCollector = [];
+  const walked = walkAndMaterialize2(root, idMap, animatedIds, genId3, defsCollector, rootViewport);
+  if (defsCollector.length === 0) return walked;
+  const defsNode = { type: "defs", children: defsCollector };
+  const newChildren = [...(_a2 = walked.children) != null ? _a2 : [], defsNode];
+  return __spreadProps(__spreadValues({}, walked), { children: newChildren });
+}
+function readRootViewport(root) {
+  const vb = parseViewBox(root.viewBox);
+  if (vb) return [vb[2], vb[3]];
+  const w = numericAttr(root.width);
+  const h = numericAttr(root.height);
+  if (w !== void 0 && h !== void 0) return [w, h];
+  return [1, 1];
+}
+function numericAttr(v) {
+  if (typeof v === "number") return v;
+  if (typeof v === "string") {
+    const n = parseFloat(v);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
+}
+function buildIdMap(root) {
+  const map = /* @__PURE__ */ new Map();
+  const visit = (n) => {
+    var _a2;
+    if (typeof n.id === "string") map.set(n.id, n);
+    (_a2 = n.children) == null ? void 0 : _a2.forEach(visit);
+  };
+  visit(root);
+  return map;
+}
+function computeAnimatedSubtreeIds(root, idMap) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  const result = /* @__PURE__ */ new Set();
+  const hasAnim = (n, visiting) => {
+    const cached = cache.get(n);
+    if (cached !== void 0) return cached;
+    if (visiting.has(n)) return false;
+    visiting.add(n);
+    let r = false;
+    if (n.animate && typeof n.animate === "object" && !Array.isArray(n.animate)) {
+      for (const _ in n.animate) {
+        r = true;
+        break;
+      }
+    }
+    if (!r && n.children) {
+      for (const ch of n.children) {
+        if (hasAnim(ch, visiting)) {
+          r = true;
+          break;
+        }
       }
     }
-    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 });
+    if (!r && n.type === "use" && typeof n.href === "string") {
+      const targetId = stripHash2(n.href);
+      const target = targetId ? idMap.get(targetId) : void 0;
+      if (target) r = hasAnim(target, visiting);
     }
-    return out;
+    visiting.delete(n);
+    cache.set(n, r);
+    return r;
   };
-  return walk(root);
+  for (const [id, node] of idMap) {
+    if (hasAnim(node, /* @__PURE__ */ new Set())) result.add(id);
+  }
+  return result;
+}
+function stripHash2(href) {
+  if (typeof href !== "string") return void 0;
+  return href.startsWith("#") ? href.slice(1) : href;
+}
+function materializeOneUse(useNode, target, idMap, animatedIds, genId3, defsCollector, rootViewport) {
+  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 = (_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 materializedClone = walkAndMaterialize2(rewrittenClone, idMap, animatedIds, genId3, defsCollector, rootViewport);
+  const newNode = __spreadProps(__spreadValues({}, useNode), { type: "g", children: [materializedClone] });
+  delete newNode.href;
+  delete newNode.width;
+  delete newNode.height;
+  return applyUseOffsetToG(newNode);
+}
+function rewriteSymbolRootToGroup(symbolNode, genId3, defsCollector, useW, useH) {
+  const viewBox = parseViewBox(symbolNode.viewBox);
+  const g = __spreadProps(__spreadValues({}, symbolNode), { type: "g" });
+  delete g.viewBox;
+  delete g.preserveAspectRatio;
+  delete g.width;
+  delete g.height;
+  if (!viewBox) return g;
+  const [vbX, vbY, vbW, vbH] = viewBox;
+  const scale = vbW > 0 && vbH > 0 ? Math.min(useW / vbW, useH / vbH) : 1;
+  const xOff = (useW - vbW * scale) / 2;
+  const yOff = (useH - vbH * scale) / 2;
+  const parts = [];
+  if (xOff !== 0 || yOff !== 0) parts.push("translate(" + xOff + "," + yOff + ")");
+  if (scale !== 1) parts.push("scale(" + scale + ")");
+  if (vbX !== 0 || vbY !== 0) parts.push("translate(" + -vbX + "," + -vbY + ")");
+  if (parts.length) g.transform = parts.join("");
+  const clipId = genId3();
+  defsCollector.push({
+    type: "clipPath",
+    id: clipId,
+    children: [{ type: "rect", x: vbX, y: vbY, width: vbW, height: vbH }]
+  });
+  g.clipPath = "url(#" + clipId + ")";
+  return g;
+}
+function parseViewBox(v) {
+  if (typeof v !== "string") return void 0;
+  const parts = v.trim().split(/[\s,]+/).map(Number);
+  if (parts.length < 4 || parts.some((n) => !Number.isFinite(n))) return void 0;
+  return [parts[0], parts[1], parts[2], parts[3]];
+}
+function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, rootViewport) {
+  if (node.type === "use" && typeof node.href === "string") {
+    const targetId = stripHash2(node.href);
+    if (targetId && animatedIds.has(targetId)) {
+      const target = idMap.get(targetId);
+      if (target) return materializeOneUse(node, target, idMap, animatedIds, genId3, defsCollector, rootViewport);
+    }
+  }
+  if (!node.children) return node;
+  let changed = false;
+  const newChildren = node.children.map((ch) => {
+    const m = walkAndMaterialize2(ch, idMap, animatedIds, genId3, defsCollector, rootViewport);
+    if (m !== ch) changed = true;
+    return m;
+  });
+  return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
 }
 
-// src/materialise/PxAnimatorMaterialiseAll.ts
-function materialiseAllInTree(doc, engine, opts) {
+// src/materialize/PxAnimatorMaterializeAll.ts
+function materializeAllInTree(doc, engine, opts) {
   var _a2, _b;
   let root = applyPlayerEffects(doc).root;
-  root = materialiseOffsetPathsInTree(root);
+  root = materializeOffsetPathsInTree(root);
   const duration = (_b = (_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.duration) != null ? _b : DEFAULT_DURATION_MS;
-  root = materialiseInternalLoopsInTree(root, duration);
+  root = materializeInternalLoopsInTree(root, duration);
   if (engine === PxTimelineEngine.native) {
-    root = materialiseMotionPathsInTree(root, opts == null ? void 0 : opts.motionPath);
-    root = materialiseAnimatedUseInstances(root);
+    root = materializeMotionPathsInTree(root, opts == null ? void 0 : opts.motionPath);
+    root = materializeAnimatedUseInstances(root);
     root = pruneUnreferencedDefs(root);
   }
   return root;
@@ -6327,6 +6353,66 @@ function pruneUnreferencedDefs(root) {
   return root;
 }
 
+// src/playback/PxPlaybackTime.ts
+var PX_RATE_REJECTED = "setPlaybackRate: rate must be finite and non-zero";
+function isValidPlaybackRate(rate) {
+  return Number.isFinite(rate) && rate !== 0;
+}
+function seekCeilingMs(durationMs, iterations) {
+  if (!(durationMs > 0)) return 0;
+  if (iterations === Infinity) return Infinity;
+  return durationMs * (iterations > 0 ? iterations : 1);
+}
+function progressSpanMs(durationMs, iterations) {
+  if (!(durationMs > 0)) return 0;
+  if (iterations === Infinity) return durationMs;
+  return durationMs * (iterations > 0 ? iterations : 1);
+}
+function clampSeekMs(timeMs, ceilingMs) {
+  if (Number.isNaN(timeMs) || timeMs < 0) return 0;
+  if (Number.isFinite(ceilingMs)) return timeMs > ceilingMs ? ceilingMs : timeMs;
+  return Number.isFinite(timeMs) ? timeMs : 0;
+}
+function timeToProgress(timeMs, durationMs, iterations) {
+  const span = progressSpanMs(durationMs, iterations);
+  if (!(span > 0) || !Number.isFinite(timeMs)) return 0;
+  if (timeMs <= 0) return 0;
+  if (iterations === Infinity) return timeMs % span / span;
+  return timeMs >= span ? 1 : timeMs / span;
+}
+function progressToTimeMs(progress, durationMs, iterations) {
+  const span = progressSpanMs(durationMs, iterations);
+  if (!(span > 0) || !Number.isFinite(progress)) return 0;
+  if (progress <= 0) return 0;
+  return progress >= 1 ? span : progress * span;
+}
+function createRunClock(ceilingMs, nowFn = Date.now) {
+  let baseMs = 0;
+  let startedAt = 0;
+  let running = false;
+  let rate = 1;
+  const value = () => running ? clampSeekMs(baseMs + (nowFn() - startedAt) * rate, ceilingMs) : clampSeekMs(baseMs, ceilingMs);
+  return {
+    now: value,
+    isRunning: () => running,
+    start: (r, atMs) => {
+      baseMs = clampSeekMs(atMs != null ? atMs : value(), ceilingMs);
+      rate = isValidPlaybackRate(r) ? r : 1;
+      startedAt = nowFn();
+      running = true;
+    },
+    stop: () => {
+      baseMs = value();
+      startedAt = 0;
+      running = false;
+    },
+    seek: (ms) => {
+      baseMs = clampSeekMs(ms, ceilingMs);
+      if (running) startedAt = nowFn();
+    }
+  };
+}
+
 // src/playback/PxFrameLoop.ts
 function requestFrame(cb) {
   const g = globalThis;
@@ -6344,7 +6430,7 @@ function cancelFrame(handle) {
 function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
   var _a2;
   const config = getAnimatorConfig(doc) || {};
-  const bindings = getNormalisedBindings(doc, PxTimelineEngine.js);
+  const bindings = getNormalizedBindings(doc, PxTimelineEngine.js);
   const _iterations = config.iterations;
   let iterations = 1;
   if (typeof _iterations === "number") iterations = _iterations || 1;
@@ -6521,88 +6607,305 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
     } else if (fillsBackwards) {
       renderFrame(0);
     }
-  };
-  const cancelAnim = () => {
-    var _a3;
-    pauseAnim();
-    timeBeforeLastStartMs = 0;
-    lastStartedTs = 0;
-    playing = false;
-    finishCalled = false;
-    renderFrame(timeBeforeLastStartMs);
-    (_a3 = callbacks == null ? void 0 : callbacks.onCancel) == null ? void 0 : _a3.call(callbacks);
-  };
-  const finishAnim = (callOnFinish = true) => {
-    var _a3;
-    if (Number.isFinite(totalDuration)) {
-      timeBeforeLastStartMs = totalDuration;
-    } else {
-      timeBeforeLastStartMs = getAnimCurrentTime();
+  };
+  const cancelAnim = () => {
+    var _a3;
+    pauseAnim();
+    timeBeforeLastStartMs = 0;
+    lastStartedTs = 0;
+    playing = false;
+    finishCalled = false;
+    renderFrame(timeBeforeLastStartMs);
+    (_a3 = callbacks == null ? void 0 : callbacks.onCancel) == null ? void 0 : _a3.call(callbacks);
+  };
+  const finishAnim = (callOnFinish = true) => {
+    var _a3;
+    if (Number.isFinite(totalDuration)) {
+      timeBeforeLastStartMs = totalDuration;
+    } else {
+      timeBeforeLastStartMs = getAnimCurrentTime();
+    }
+    lastStartedTs = 0;
+    playing = false;
+    if (timerId !== null) {
+      cancelFrame(timerId);
+      timerId = null;
+    }
+    renderFrame(fillsForwards ? timeBeforeLastStartMs : 0);
+    if (callOnFinish && !finishCalled) {
+      finishCalled = true;
+      (_a3 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a3.call(callbacks);
+    }
+  };
+  const api = {
+    "isReady": () => true,
+    "getRootElement": () => null,
+    "isPlaying": () => {
+      return _isPlaying();
+    },
+    "play": () => {
+      var _a3;
+      startAnim();
+      (_a3 = callbacks == null ? void 0 : callbacks.onPlay) == null ? void 0 : _a3.call(callbacks);
+    },
+    "pause": () => {
+      var _a3;
+      pauseAnim();
+      (_a3 = callbacks == null ? void 0 : callbacks.onPause) == null ? void 0 : _a3.call(callbacks);
+    },
+    "cancel": () => {
+      cancelAnim();
+    },
+    "finish": () => {
+      finishAnim(true);
+    },
+    "setPlaybackRate": (rate) => {
+      if (!isValidPlaybackRate(rate)) {
+        console.warn(PX_RATE_REJECTED);
+        return;
+      }
+      let current = getRawAnimTime();
+      if (Number.isFinite(totalDuration) && current > totalDuration) current = totalDuration;
+      if (rate < 0 !== playbackRate < 0) finishCalled = false;
+      playbackRate = rate;
+      timeBeforeLastStartMs = current;
+      if (playing) lastStartedTs = Date.now();
+    },
+    "getCurrentTime": () => {
+      return getAnimCurrentTime();
+    },
+    "setCurrentTime": (newTime) => {
+      newTime = clampSeekMs(newTime, totalDuration);
+      timeBeforeLastStartMs = newTime;
+      if (playing) lastStartedTs = Date.now();
+      if (!Number.isFinite(totalDuration) || newTime < totalDuration) finishCalled = false;
+      renderFrame(getAnimCurrentTime());
+    },
+    "getCurrentProgress": () => timeToProgress(getAnimCurrentTime(), duration, iterations),
+    "setCurrentProgress": (progress) => {
+      api.setCurrentTime(progressToTimeMs(progress, duration, iterations));
+    },
+    "destroy": () => {
+      var _a3;
+      api.cancel();
+      (_a3 = callbacks == null ? void 0 : callbacks.onRemove) == null ? void 0 : _a3.call(callbacks);
+    }
+  };
+  return api;
+}
+
+// src/playback/PxDiagnostics.ts
+var PxDiagnosticKind = {
+  /** The document is wrong — regenerate or repair the file. */
+  document: "document",
+  /** The page or app cannot provide what the document asks for — fix the mount. */
+  host: "host",
+  /** The platform cannot do it and the player degraded — usually nothing to fix. */
+  platform: "platform",
+  /** The call is wrong or self-contradictory — fix the options or props you passed. */
+  usage: "usage",
+  /** The player failed where it did not expect to — report it to us. */
+  internal: "internal"
+};
+function asError(error) {
+  return typeof error === "string" ? new Error(error) : error;
+}
+function createDiagnostics(config, prefix) {
+  const tag = prefix ? prefix + " " : "";
+  return {
+    warn: (kind, message, detail) => {
+      if (config == null ? void 0 : config.onWarn) {
+        config.onWarn({ kind, message, detail });
+        return;
+      }
+      if (config == null ? void 0 : config.muteWarn) return;
+      const line = tag + kind + ": " + message;
+      if (detail === void 0) console.warn(line);
+      else console.warn(line, detail);
+    },
+    error: (kind, error, detail) => {
+      const err = asError(error);
+      if (config == null ? void 0 : config.onError) {
+        config.onError({ kind, message: err.message, error: err, detail });
+        return;
+      }
+      if (config == null ? void 0 : config.muteError) return;
+      const line = tag + kind + ": " + err.message;
+      if (detail === void 0) console.error(line);
+      else console.error(line, detail);
+    }
+  };
+}
+
+// src/playback/PxAnimatorConfigPatch.ts
+var FLAT_ONLY_KEYS = [
+  "timelineSource",
+  "scroll",
+  "trigger",
+  "delay",
+  "iterations",
+  "direction",
+  "fill",
+  "resetOnFinish",
+  "duration",
+  "mode",
+  "frameRate"
+];
+var CONTENT_KEYS = ["definitions", "bindings"];
+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 foldTimelineOverride(timeline, shortcuts) {
+  let base;
+  if (typeof timeline === "string") {
+    try {
+      base = JSON.parse(timeline);
+    } catch (e) {
+      console.warn("timeline override: not valid JSON \u2014 ignored", e);
+      base = void 0;
+    }
+  } else {
+    base = timeline != null ? timeline : void 0;
+  }
+  const { duration, delay, iterations, startOn } = shortcuts;
+  if (duration === void 0 && delay === void 0 && iterations === void 0 && startOn === void 0) {
+    return base === void 0 ? void 0 : { timeline: base };
+  }
+  const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+  if (duration !== void 0) out.duration = duration;
+  if (delay !== void 0) out.delay = delay;
+  if (iterations !== void 0) out.iterations = iterations;
+  if (startOn !== void 0) {
+    out.trigger = __spreadProps(__spreadValues({}, out.trigger), { startOn });
+  }
+  return { timeline: 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;
     }
-    lastStartedTs = 0;
-    playing = false;
-    if (timerId !== null) {
-      cancelFrame(timerId);
-      timerId = null;
+    if (key === "timeline") {
+      out.timeline = isPlainObject(value) ? mergeTimeline(out.timeline, value, warn) : value;
+      continue;
     }
-    renderFrame(fillsForwards ? timeBeforeLastStartMs : 0);
-    if (callOnFinish && !finishCalled) {
-      finishCalled = true;
-      (_a3 = callbacks == null ? void 0 : callbacks.onFinish) == null ? void 0 : _a3.call(callbacks);
+    if (isPlainObject(value)) {
+      out[key] = mergePlain(out[key], value);
+      continue;
     }
-  };
-  const api = {
-    "isReady": () => true,
-    "getRootElement": () => null,
-    "isPlaying": () => {
-      return _isPlaying();
-    },
-    "play": () => {
-      var _a3;
-      startAnim();
-      (_a3 = callbacks == null ? void 0 : callbacks.onPlay) == null ? void 0 : _a3.call(callbacks);
-    },
-    "pause": () => {
-      var _a3;
-      pauseAnim();
-      (_a3 = callbacks == null ? void 0 : callbacks.onPause) == null ? void 0 : _a3.call(callbacks);
-    },
-    "cancel": () => {
-      cancelAnim();
-    },
-    "finish": () => {
-      finishAnim(true);
-    },
-    "setPlaybackRate": (rate) => {
-      if (!isFinite(rate) || rate === 0) {
-        console.warn("setPlaybackRate: rate must be finite and non-zero");
-        return;
-      }
-      let current = getRawAnimTime();
-      if (Number.isFinite(totalDuration) && current > totalDuration) current = totalDuration;
-      if (rate < 0 !== playbackRate < 0) finishCalled = false;
-      playbackRate = rate;
-      timeBeforeLastStartMs = current;
-      if (playing) lastStartedTs = Date.now();
-    },
-    "getCurrentTime": () => {
-      return getAnimCurrentTime();
-    },
-    "setCurrentTime": (newTime) => {
-      if (newTime < 0) newTime = 0;
-      if (Number.isFinite(totalDuration) && newTime > totalDuration) newTime = totalDuration;
-      timeBeforeLastStartMs = newTime;
-      if (playing) lastStartedTs = Date.now();
-      if (!Number.isFinite(totalDuration) || newTime < totalDuration) finishCalled = false;
-      renderFrame(getAnimCurrentTime());
-    },
-    "destroy": () => {
-      var _a3;
-      api.cancel();
-      (_a3 = callbacks == null ? void 0 : callbacks.onRemove) == null ? void 0 : _a3.call(callbacks);
+    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];
     }
-  };
-  return api;
+    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;
+function diagnoseDocument(doc) {
+  try {
+    return { problems: validateDocument(doc) };
+  } catch (e) {
+    return { problems: [] };
+  }
+}
+function reportDocumentDiagnostics(doc, where) {
+  const { problems } = diagnoseDocument(doc);
+  if (!problems.length) return;
+  const shown = problems.slice(0, MAX_REPORTED);
+  const more = problems.length - shown.length;
+  console.warn(
+    where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
+  );
 }
 
 // src/effects/PlayerEffectsUtil.visualModel.ts
@@ -6795,276 +7098,281 @@ function diffInEffect(a, b) {
   const diffs = [];
   for (const t of Array.from(times).sort((x, y) => x - y)) {
     const ma = visualModelAt(a, t);
-    const mb = visualModelAt(b, t);
-    const onlyInA = subtractMultiset(ma, mb);
-    const onlyInB = subtractMultiset(mb, ma);
-    if (onlyInA.length || onlyInB.length) diffs.push({ time: t, onlyInA, onlyInB });
-  }
-  return diffs;
-}
-function subtractMultiset(a, b) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const x of b) counts.set(x, (counts.get(x) || 0) + 1);
-  const extra = [];
-  for (const x of a) {
-    const c = counts.get(x) || 0;
-    if (c > 0) counts.set(x, c - 1);
-    else extra.push(x);
-  }
-  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 });
+    const mb = visualModelAt(b, t);
+    const onlyInA = subtractMultiset(ma, mb);
+    const onlyInB = subtractMultiset(mb, ma);
+    if (onlyInA.length || onlyInB.length) diffs.push({ time: t, onlyInA, onlyInB });
   }
-  out.timeline = timeline;
-  return out;
+  return diffs;
 }
-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 };
+function subtractMultiset(a, b) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const x of b) counts.set(x, (counts.get(x) || 0) + 1);
+  const extra = [];
+  for (const x of a) {
+    const c = counts.get(x) || 0;
+    if (c > 0) counts.set(x, c - 1);
+    else extra.push(x);
   }
-  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");
+  return extra;
+}
+
+// src/playback/PxScrollMath.ts
+function isScrollTimeline(config) {
+  return (config == null ? void 0 : config.timelineSource) === "scroll";
+}
+function scrollTotalDurationMs(config) {
+  const duration = typeof (config == null ? void 0 : config.duration) === "number" && config.duration > 0 ? config.duration : DEFAULT_DURATION_MS;
+  const iterations = typeof (config == null ? void 0 : config.iterations) === "number" && config.iterations > 0 ? config.iterations : 1;
+  return duration * iterations;
+}
+function scrollPhaseInterval(phase, subjectSize, scrollportSize) {
+  const s = subjectSize, vp = scrollportSize;
+  switch (phase) {
+    case "cover":
+      return [0, s + vp];
+    case "entry":
+      return [0, Math.min(s, vp)];
+    case "contain":
+      return [Math.min(s, vp), Math.max(s, vp)];
+    case "exit":
+      return [Math.max(s, vp), s + vp];
+    case "entry-crossing":
+      return [0, s];
+    case "exit-crossing":
+      return [vp, s + vp];
   }
-  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;
+}
+var DEFAULT_PHASE = "cover";
+function resolveRangePointU(point, defaultFraction, 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);
+}
+function scrollViewProgress(subjectStart, subjectSize, scrollportSize, range) {
+  const u = scrollportSize - subjectStart;
+  const uStart = resolveRangePointU(range == null ? void 0 : range.start, 0, subjectSize, scrollportSize);
+  const uEnd = resolveRangePointU(range == null ? void 0 : range.end, 1, subjectSize, scrollportSize);
+  if (uEnd <= uStart) return u >= uEnd ? 1 : 0;
+  return clamp((u - uStart) / (uEnd - uStart), 0, 1);
+}
+function scrollOffsetProgress(offset, maxOffset, range) {
+  var _a2, _b;
+  const raw = maxOffset > 0 ? clamp(offset / maxOffset, 0, 1) : 1;
+  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);
+}
+function scrollResolveAxis(axis, writingMode) {
+  const a = axis != null ? axis : "block";
+  if (a === "x" || a === "y") return a;
+  const vertical = !!writingMode && writingMode.startsWith("vertical");
+  if (a === "inline") return vertical ? "y" : "x";
+  return vertical ? "x" : "y";
+}
+
+// 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;
     }
-    out[key] = value;
   }
-  return { config: out, warnings };
+  return [...fields].sort();
 }
-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: [] };
+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 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");
+  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."
+    };
   }
-  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 step = p.steps.find((s) => s.to === p.declared);
+  if (!step) {
+    return { changed, requiredKind, requiredVersion, refuse: "No PLAYER_WIRE_STEPS entry reaches " + p.declared + "." };
   }
-  const merged = mergeAnimatorConfig(base, patch != null ? patch : {});
-  warnings.push(...merged.warnings);
-  if (merged.config === current) return { doc, warnings };
-  if (atMeta) {
+  if (requiredKind === "converted" /* converted */ && step.kind !== "converted" /* converted */) {
     return {
-      doc: __spreadProps(__spreadValues({}, anyDoc), { meta: __spreadProps(__spreadValues({}, anyDoc.meta), { animator: merged.config }) }),
-      warnings
+      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 { doc: __spreadProps(__spreadValues({}, anyDoc), { animator: merged.config }), warnings };
+  return { changed, requiredKind, requiredVersion };
 }
-
-// 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: [] };
-  }
+function releaseLogProblems(releases, steps, declared, baseline) {
   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."
-  );
+  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;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASELINE_PLAYER_VERSION,
-  COLOUR_ATTR_NAMES,
+  COLOR_ATTR_NAMES,
   CSS_ONLY_STYLE_PROPS,
   DEFAULT_DURATION_MS,
   DISALLOWED_SVG_TAGS_LOWER,
-  INTERNAL_ATTRS,
   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_RATE_REJECTED,
   PX_TRANSFORM_PART_KEYS,
+  PX_TRIGGER_DEFAULTS,
   PX_UNKNOWN_KEY_ERROR,
+  PxAlongPathMode,
   PxAnimatedSvgDocumentSchema,
-  PxAnimationDefinitionSchema,
   PxAnimatorConfigSchema,
   PxAttrValueSchema,
   PxBezierPathSchema,
-  PxBindingSchema,
+  PxClipPathEffectSchema,
   PxCloneEffectSchema,
   PxCloneWithout,
+  PxControlMode,
   PxDefsSchema,
-  PxEasingOrRefSchema,
+  PxDiagnosticKind,
   PxEffectsSchema,
   PxElementAnimationSchema,
   PxFillGradientEffectSchema,
+  PxFillMode,
+  PxFinishAction,
   PxGradientSpreadMethod,
   PxGradientStopSchema,
   PxGradientType,
-  PxGradientUnits,
   PxKeyframeSchema,
   PxKeyframeValueSchema,
+  PxLengthAdjust,
   PxLoopDirection,
   PxLoopRepeatAt,
   PxLoopSchema,
+  PxMaskType,
   PxMaskedByEffectSchema,
   PxNodeBase,
   PxNodeSchema,
+  PxOutAction,
+  PxPathOverflow,
+  PxPinAlign,
+  PxPlaybackDirection,
   PxPropertyAnimationSchema,
   PxRepeaterEffectSchema,
   PxRetimeEffectSchema,
+  PxScrollAxis,
+  PxScrollKind,
+  PxScrollPhase,
   PxScrollRangePointSchema,
   PxScrollRangeSchema,
   PxScrollSchema,
-  PxStrokeGradientEffectSchema,
+  PxScrollSource,
+  PxStartOn,
   PxStrokeTrimEffectSchema,
   PxStrokeTrimSubPaths,
   PxSvgNodeExtra,
   PxTextEffectSchema,
   PxTextPathEffectSchema,
+  PxTextPathMethod,
+  PxTextPathSpacing,
   PxTimelineEngine,
   PxTimelineEngineExtra,
-  PxTimelinePinSchema,
   PxTimelineSchema,
   PxTransformByEffectSchema,
   PxTransformPartsSchema,
   PxTransformValueSchema,
   PxTriggerSchema,
+  PxUnits,
   STYLE_ATTR_NAMES,
-  TEXT_ATTR,
   TEXT_CONTENT_ATTR,
   TRANSFORM_FN_NAMES,
   WIRE_VERSION_KEY,
@@ -7073,17 +7381,19 @@ function reportDocumentDiagnostics(doc, where) {
   applyAnimatorConfig,
   applyPlayerEffects,
   applyWireSteps,
-  applyWireStepsDown,
   bezierToSvgPath,
   calcAnimationValues,
   camelCaseToKebabWordIfNeeded,
   clamp,
-  collectSampleTimes,
+  clampSeekMs,
   compareWireVersion,
   composeTransformParts,
+  controlModeTakesOverTrigger,
   convertPlayerDocument,
   createBasicFrameLoopAnimator,
+  createDiagnostics,
   createPathSampler,
+  createRunClock,
   cubicBezier,
   deepClone,
   describeSchema,
@@ -7091,10 +7401,9 @@ function reportDocumentDiagnostics(doc, where) {
   diffFieldUniverse,
   diffInEffect,
   downgradePlayerDocument,
-  evaluateMotionPathSegment,
   extendedPathForBrowser,
   flattenAnimatorTimeline,
-  foldAnimatorConfigShortcuts,
+  foldTimelineOverride,
   formatWireVersion,
   generateNewIds,
   generateUniqueId,
@@ -7102,47 +7411,39 @@ function reportDocumentDiagnostics(doc, where) {
   getBindings,
   getChildren,
   getDefs,
-  getNormalisedBindings,
+  getNormalizedBindings,
   getNormalizedProps,
-  interpolateBeziers,
   interpolateValue,
   isNativeForced,
   isPxElementFileFormat,
   isPxElementFileFormatDeep,
   isScrollTimeline,
-  jsonElementFactory,
+  isValidPlaybackRate,
   kebabToCamelCaseWord,
   kfEasing,
-  kfTangentIn,
-  kfTangentOut,
-  kfTime,
   kfValue,
   layoutGlyphTextChars,
-  materialiseAllInTree,
-  materialiseAnimatedUseInstances,
-  materialiseGlyphText,
-  materialiseGlyphTextAlongPath,
-  materialiseGlyphTextHorizontal,
-  materialiseInternalLoopsInPropAnim,
-  materialiseInternalLoopsInTree,
-  materialiseMotionPathInPropAnim,
-  materialiseMotionPathsInTree,
+  materializeAllInTree,
+  materializeGlyphText,
+  materializeGlyphTextAlongPath,
+  materializeMotionPathInPropAnim,
   mayUseNativeScrollTimeline,
   mergeAnimatorConfig,
   mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline,
-  parseTransformParts,
   parseWireVersion,
   planSchemaRelease,
-  propAnimIsMotionPath,
+  progressSpanMs,
+  progressToTimeMs,
   px,
   readWireVersion,
   releaseLogProblems,
   reportDocumentDiagnostics,
-  resolveStyle,
+  resolveControlMode,
   resolveTimelineEngine,
+  resolveTrigger,
   reverseEasing,
-  sanitiseAttributeValue,
+  sanitizeAttributeValue,
   schemaFieldUniverse,
   schemaKeys,
   scrollOffsetProgress,
@@ -7150,13 +7451,13 @@ function reportDocumentDiagnostics(doc, where) {
   scrollResolveAxis,
   scrollTotalDurationMs,
   scrollViewProgress,
-  shiftAnimatable,
+  seekCeilingMs,
   splitEasing,
   subdivideCubicBezier,
+  timeToProgress,
   toRGBA,
   validateDocument,
   validateNodeEffects,
-  versionAdvice,
-  visualModelAt
+  versionAdvice
 });
 //# sourceMappingURL=index.cjs.map