@pixodesk/svg-animator-web 1.0.30 → 1.0.35

package/dist/{index.umd.js → pixodesk-svg-animator.umd.js}

@@ -54,16 +54,17 @@ var PixodeskAnimator = (() => {
     PX_ANIMATOR_DATA_KEY: () => PX_ANIMATOR_DATA_KEY,
     PX_ANIM_ATTR_NAME: () => PX_ANIM_ATTR_NAME,
     PX_ANIM_SRC_ATTR_NAME: () => PX_ANIM_SRC_ATTR_NAME,
-    PxAnimatorEngine: () => PxAnimatorEngine,
-    PxAnimatorMode: () => PxAnimatorMode,
+    PxTimelineEngine: () => PxTimelineEngine,
+    PxTimelineEngineExtra: () => PxTimelineEngineExtra,
     createAnimator: () => createAnimator,
     createAnimatorImpl: () => createAnimatorImpl,
     generateNewIds: () => generateNewIds,
     loadTagAnimators: () => loadTagAnimators,
-    setupAnimationTriggers: () => setupAnimationTriggers
+    setupAnimationTriggers: () => setupAnimationTriggers,
+    validateDocument: () => validateDocument
   });
 
-  // ../svg-animator-core/src/PxAnimatorUtil.ts
+  // ../svg-animator-core/src/util/PxAnimatorUtil.ts
   function bezierToSvgPath(path, forceCurves = false) {
     var _a, _b, _c, _d;
     const v = path.v;
@@ -316,6 +317,38 @@ var PixodeskAnimator = (() => {
     if (o) segs.push("translate(" + -o[0] + tu + "," + -o[1] + tu + ")");
     return segs.join("");
   }
+  function parseTransformParts(str2) {
+    var _a, _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], (_a = nums[1]) != null ? _a : 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]];
+      }
+    }
+    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) {
@@ -479,7 +512,7 @@ var PixodeskAnimator = (() => {
     return cubicBezier(flipped);
   }
 
-  // ../svg-animator-core/src/PxScrollMath.ts
+  // ../svg-animator-core/src/playback/PxScrollMath.ts
   function isScrollTimeline(config) {
     return (config == null ? void 0 : config.timelineSource) === "scroll";
   }
@@ -535,7 +568,8 @@ var PixodeskAnimator = (() => {
     return vertical ? "x" : "y";
   }
 
-  // ../svg-animator-core/src/PxSchema.ts
+  // ../svg-animator-core/src/schema/PxSchema.ts
+  var PX_UNKNOWN_KEY_ERROR = "unexpected extra key";
   function pathStr(path) {
     if (!path.length) return ".";
     let result = "";
@@ -647,6 +681,8 @@ var PixodeskAnimator = (() => {
     constructor(schemas, defaultVal) {
       super();
       this.schemas = schemas;
+      /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Union from Tuple. */
+      this._kind = "union";
       this._default = defaultVal != null ? defaultVal : schemas[0]._default;
     }
     sanitize(raw) {
@@ -668,20 +704,26 @@ var PixodeskAnimator = (() => {
   };
   var DiscriminatedUnion = class extends Base {
     constructor(_key, _schemas, defaultVal) {
+      var _a;
       super();
       this._key = _key;
       this._schemas = _schemas;
+      /** Structural tag read by {@link describeSchema}. */
+      this._kind = "discriminatedUnion";
       this._default = defaultVal != null ? defaultVal : _schemas[0]._default;
       this._map = /* @__PURE__ */ new Map();
       for (const s of _schemas) {
         const keySchema = s._shape[_key];
-        if (keySchema) this._map.set(keySchema._default, s);
+        if (!keySchema) continue;
+        const literal = (_a = keySchema.inner) != null ? _a : keySchema;
+        this._map.set(literal._default, s);
+        if (keySchema.inner) this._absentMember = s;
       }
     }
     _findSchema(raw) {
       if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return void 0;
       const val = raw[this._key];
-      if (val === void 0 || val === null) return void 0;
+      if (val === void 0 || val === null) return this._absentMember;
       return this._map.get(val);
     }
     sanitize(raw) {
@@ -715,7 +757,8 @@ var PixodeskAnimator = (() => {
       const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
       const out = {};
       for (const key of Object.keys(this._shape)) {
-        out[key] = this._shape[key].sanitize(src[key]);
+        const v = this._shape[key].sanitize(src[key]);
+        if (v !== void 0) out[key] = v;
       }
       return out;
     }
@@ -737,7 +780,7 @@ var PixodeskAnimator = (() => {
           if (key in this._shape) continue;
           if (obj[key] === void 0) continue;
           p.push(key);
-          ctx.errors.push(pathStr(p) + ": unexpected extra key");
+          ctx.errors.push(pathStr(p) + ": " + PX_UNKNOWN_KEY_ERROR);
           p.pop();
           ok = false;
         }
@@ -761,7 +804,8 @@ var PixodeskAnimator = (() => {
       const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
       const out = __spreadValues({}, src);
       for (const key of Object.keys(this._shape)) {
-        out[key] = this._shape[key].sanitize(src[key]);
+        const v = this._shape[key].sanitize(src[key]);
+        if (v !== void 0) out[key] = v;
       }
       if (this._openSchema) {
         for (const key of Object.keys(src)) {
@@ -833,6 +877,8 @@ var PixodeskAnimator = (() => {
     constructor(value) {
       super();
       this.value = value;
+      /** Structural tag read by {@link describeSchema}. */
+      this._kind = "record";
       this._default = {};
     }
     sanitize(raw) {
@@ -918,6 +964,8 @@ var PixodeskAnimator = (() => {
     constructor(schemas) {
       super();
       this.schemas = schemas;
+      /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Tuple from Union. */
+      this._kind = "tuple";
       this._default = schemas.map((s) => s._default);
     }
     sanitize(raw) {
@@ -998,25 +1046,40 @@ var PixodeskAnimator = (() => {
     lazy: (fn, defaultVal) => new Lazy(fn, defaultVal)
   };
 
-  // ../svg-animator-core/src/PxAnimatorConstants.ts
+  // ../svg-animator-core/src/format/PxAnimatorConstants.ts
   var PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
   var PX_ANIM_ATTR_NAME = "_px_animator";
-  var PxAnimatorMode = {
-    auto: "auto",
-    waapi: "waapi",
-    frames: "frames"
+  var PX_TIMELINE_SHARED_KEYS = ["duration", "iterations", "engine", "frameRate"];
+  var PX_TIME_ONLY_TIMELINE_KEYS = ["trigger", "delay", "fillMode", "direction"];
+  var PxTimelineEngine = {
+    native: "native",
+    js: "js"
   };
-  var PxAnimatorEngine = {
-    waapi: PxAnimatorMode.waapi,
-    frames: PxAnimatorMode.frames
+  var PxTimelineEngineExtra = __spreadProps(__spreadValues({}, PxTimelineEngine), {
+    auto: "auto"
+  });
+  function resolveTimelineEngine(engine) {
+    return engine === PxTimelineEngineExtra.js ? PxTimelineEngine.js : PxTimelineEngine.native;
+  }
+  function isNativeForced(engine) {
+    return engine === PxTimelineEngineExtra.native;
+  }
+  function mayUseNativeScrollTimeline(engine) {
+    return engine !== PxTimelineEngineExtra.js;
+  }
+  var PxLoopRepeatAt = {
+    /** Segment from the START; the repetition runs BEFORE the first keyframe
+     *  (intro loops that play until the main timeline begins). */
+    start: "start",
+    /** DEFAULT — segment from the END; the repetition runs AFTER the last keyframe
+     *  (idle/outro loops that continue once the main timeline has finished). */
+    end: "end"
   };
-  var PxLoopExtend = {
-    /** Segment from the START; the animation is extended BEFORE the first keyframe
-     *  (intro loops that run before the main timeline begins). */
-    before: "before",
-    /** DEFAULT — segment from the END; extended AFTER the last keyframe (idle/outro
-     *  loops that continue once the main timeline has finished). */
-    after: "after"
+  var PxLoopDirection = {
+    /** DEFAULT — cycle: every repetition replays the segment the same way round. */
+    normal: "normal",
+    /** Ping-pong: repetitions alternate forward / backward. */
+    alternate: "alternate"
   };
   var PxMaskType = {
     luminance: "luminance",
@@ -1026,8 +1089,9 @@ var PixodeskAnimator = (() => {
     userSpaceOnUse: "userSpaceOnUse",
     objectBoundingBox: "objectBoundingBox"
   };
-  var PxCloneType = {
-    content: "content"
+  var PxCloneWithout = {
+    translate: "translate"
+    // transform: 'transform',   // future: drop rotate/scale too (content only)
   };
   var PxPathOverflow = {
     clip: "clip",
@@ -1051,6 +1115,9 @@ var PixodeskAnimator = (() => {
   };
   var TEXT_ATTR = "text";
   var TEXT_CONTENT_ATTR = "textContent";
+  var CLASS_ATTR = "class";
+  var TRANSFORM_ATTR = "transform";
+  var OFFSET_DISTANCE_ATTR = "offsetDistance";
   var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
     "type",
     "children",
@@ -1061,6 +1128,18 @@ var PixodeskAnimator = (() => {
     TEXT_ATTR,
     TEXT_CONTENT_ATTR
   ]);
+  var TRANSFORM_PART = {
+    translate: "translate",
+    rotate: "rotate",
+    scale: "scale",
+    origin: "origin"
+  };
+  var PX_TRANSFORM_PART_KEYS = [
+    TRANSFORM_PART.translate,
+    TRANSFORM_PART.rotate,
+    TRANSFORM_PART.scale,
+    TRANSFORM_PART.origin
+  ];
   var PxGradientUnits = {
     userSpaceOnUse: "userSpaceOnUse",
     objectBoundingBox: "objectBoundingBox"
@@ -1078,11 +1157,56 @@ var PixodeskAnimator = (() => {
     if (!(fileJson && typeof fileJson === "object" && !Array.isArray(fileJson))) {
       return false;
     }
-    return fileJson["type"] === "svg";
+    return fileJson.type === "svg";
   }
   function getAnimatorConfig(doc) {
     var _a;
-    return (doc == null ? void 0 : doc.animator) || ((_a = doc == null ? void 0 : doc.meta) == null ? void 0 : _a.animator);
+    const cfg = (doc == null ? void 0 : doc.animator) || ((_a = doc == null ? void 0 : doc.meta) == null ? void 0 : _a.animator);
+    return cfg ? flattenAnimatorTimeline(cfg) : void 0;
+  }
+  var flattenMemo = /* @__PURE__ */ new WeakMap();
+  function flattenAnimatorTimeline(cfg) {
+    const timeline = cfg.timeline;
+    if (timeline === void 0 || timeline === null || typeof timeline !== "object") return cfg;
+    const memoised = flattenMemo.get(cfg);
+    if (memoised) return memoised;
+    const _a = cfg, { timeline: _dropped } = _a, flat = __objRest(_a, ["timeline"]);
+    if (timeline.engine !== void 0) flat.engine = timeline.engine;
+    if (timeline.frameRate !== void 0) flat.frameRate = timeline.frameRate;
+    if (timeline.type === "scroll" || timeline.type === "view") {
+      flat.timelineSource = "scroll";
+      if (timeline.duration !== void 0) flat.duration = timeline.duration;
+      if (timeline.iterations !== void 0) flat.iterations = timeline.iterations;
+      const scroll = __spreadValues({}, flat.scroll || {});
+      scroll.kind = timeline.type;
+      if (timeline.axis !== void 0) scroll.axis = timeline.axis;
+      if (timeline.source !== void 0) scroll.source = timeline.source;
+      if (timeline.subject !== void 0) scroll.subject = timeline.subject;
+      if (timeline.smoothing !== void 0) scroll.smoothing = timeline.smoothing;
+      if (timeline.range !== void 0) scroll.range = timeline.range;
+      const pin = timeline.pin;
+      if (typeof pin === "boolean") scroll.pin = pin;
+      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.distance !== void 0) scroll.pinDistance = pin.distance;
+      }
+      flat.scroll = scroll;
+    } else {
+      if (timeline.duration !== void 0) flat.duration = timeline.duration;
+      if (timeline.trigger !== void 0) {
+        const _b = timeline.trigger, { finishAction } = _b, restTrigger = __objRest(_b, ["finishAction"]);
+        if (Object.keys(restTrigger).length) flat.trigger = restTrigger;
+        if (finishAction !== void 0) flat.resetOnFinish = finishAction === "reset";
+      }
+      if (timeline.delay !== void 0) flat.delay = timeline.delay;
+      if (timeline.iterations !== void 0) flat.iterations = timeline.iterations;
+      if (timeline.direction !== void 0) flat.direction = timeline.direction;
+      if (timeline.fillMode !== void 0) flat.fill = timeline.fillMode;
+    }
+    flattenMemo.set(cfg, flat);
+    return flat;
   }
   function getDefs(doc) {
     var _a;
@@ -1094,10 +1218,10 @@ var PixodeskAnimator = (() => {
     if (!doc) return void 0;
     const animateById = (_a = getAnimatorConfig(doc)) == null ? void 0 : _a.animateById;
     if (!animateById) return void 0;
-    return Object.entries(animateById).map(([id, anim]) => ({ id, animate: anim }));
+    return Object.entries(animateById).map(([id, anim]) => ({ id: id.startsWith("#") ? id.slice(1) : id, animate: anim }));
   }
 
-  // ../svg-animator-core/src/PxAnimatorTypes.ts
+  // ../svg-animator-core/src/format/PxAnimatorTypes.ts
   var PxEasingOrRefSchema = px.union([
     px.string(),
     px.tuple([px.number(), px.number(), px.number(), px.number()])
@@ -1107,39 +1231,54 @@ var PixodeskAnimator = (() => {
     // e.g. for colors
     px.number(),
     px.array(px.number()),
-    px.lazy(() => PxTransformPartsSchema, {}),
+    // ORDER LAW: the key-discriminated object shapes (`{path}`, `{paths}`) come 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 `{}` —
+    // 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: [] }),
     // Gradient `stops` timeline — each kf value is the full stops-array snapshot.
-    px.lazy(() => px.array(PxGradientStopSchema), [])
+    px.lazy(() => px.array(PxGradientStopSchema), []),
+    px.lazy(() => PxTransformPartsSchema, {})
   ]));
   var PxKeyframeSchema = implementsInterface()(px.object({
     time: px.number().optional(),
-    t: px.number().optional(),
     value: PxKeyframeValueSchema.optional(),
-    v: PxKeyframeValueSchema.optional(),
     easing: PxEasingOrRefSchema.optional(),
-    e: PxEasingOrRefSchema.optional(),
     tangentOut: px.tuple([px.number(), px.number()]).optional(),
-    to: px.tuple([px.number(), px.number()]).optional(),
-    // short alias
-    tangentIn: px.tuple([px.number(), px.number()]).optional(),
-    ti: px.tuple([px.number(), px.number()]).optional(),
-    // short alias
-    selected: px.boolean().optional()
-    // editor-side UI state (Player ignores it)
+    tangentIn: px.tuple([px.number(), px.number()]).optional()
+    // (`selected` — editor timeline-selection UI state — was REMOVED from the wire
+    // (review §1.3): editor data lives under `meta`. The editor still carries it on
+    // its internal COPY-PASTE payload, which never validates against this schema.)
   }));
+  var anyKf = (kf) => kf;
+  var kfTime = (kf) => {
+    var _a, _b;
+    return (_b = (_a = anyKf(kf).time) != null ? _a : anyKf(kf).t) != null ? _b : 0;
+  };
+  var kfValue = (kf) => {
+    var _a;
+    return (_a = anyKf(kf).value) != null ? _a : anyKf(kf).v;
+  };
+  var kfEasing = (kf) => {
+    var _a;
+    return (_a = anyKf(kf).easing) != null ? _a : anyKf(kf).e;
+  };
+  var kfTangentIn = (kf) => anyKf(kf).tangentIn;
+  var kfTangentOut = (kf) => anyKf(kf).tangentOut;
   var PxLoopSchema = implementsInterface()(px.object({
     segmentCount: px.number().optional(),
-    extend: px.enum([PxLoopExtend.before, PxLoopExtend.after]).optional(),
-    alternate: px.boolean().optional()
+    repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end]).optional(),
+    direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate]).optional()
   }));
   var PxPropertyAnimationSchema = implementsInterface()(px.object({
     value: PxKeyframeValueSchema.optional(),
     keyframes: px.array(PxKeyframeSchema).optional(),
-    kfs: px.array(PxKeyframeSchema).optional(),
     loop: px.union([PxLoopSchema, px.boolean()]).optional(),
-    autoOrient: px.boolean().optional()
+    autoOrient: px.boolean().optional(),
+    alongPathMode: px.enum(["sampled", "offsetPath"]).optional()
   }));
   var PxTransformPartsSchema = implementsInterface()(px.object({
     translate: px.tuple([px.number(), px.number()]).optional(),
@@ -1165,6 +1304,10 @@ var PixodeskAnimator = (() => {
   var PxTriggerSchema = implementsInterface()(px.object({
     startOn: px.enum(["load", "mouseOver", "click", "scrollIntoView", "programmatic"]).optional(),
     outAction: px.enum(["continue", "pause", "reset", "reverse"]).optional(),
+    // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
+    // `fill`) or `'reset'` (snap back to the start state). Pairs with `outAction` ("what
+    // happens when the trigger condition ends"); both end-of-life knobs now read alike.
+    finishAction: px.enum(["hold", "reset"]).optional(),
     scrollIntoViewThreshold: px.number().optional()
   }));
   var PxGlyphSchema = implementsInterface()(px.object({
@@ -1172,8 +1315,8 @@ var PixodeskAnimator = (() => {
     d: px.string()
   }));
   var PxGlyphFontSchema = implementsInterface()(px.object({
-    fFamily: px.string(),
-    style: px.string(),
+    fontFamily: px.string(),
+    fontStyle: px.string(),
     ascent: px.number(),
     unitsPerEm: px.number(),
     glyphs: px.record(PxGlyphSchema)
@@ -1181,8 +1324,10 @@ var PixodeskAnimator = (() => {
   var PxDefsSchema = implementsInterface()(px.object({
     easings: px.record(px.tuple([px.number(), px.number(), px.number(), px.number()])).optional(),
     animations: px.record(PxAnimationDefinitionSchema).optional(),
-    styles: px.record(px.any()).optional(),
-    glyphs: px.record(PxGlyphFontSchema).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({
@@ -1194,7 +1339,6 @@ var PixodeskAnimator = (() => {
     end: PxScrollRangePointSchema.optional()
   });
   var PxScrollSchema = implementsInterface()(px.object({
-    driver: px.enum(["custom", "native"]).optional(),
     kind: px.enum(["view", "scroll"]).optional(),
     axis: px.enum(["block", "inline", "x", "y"]).optional(),
     source: px.enum(["nearest", "root"]).optional(),
@@ -1207,23 +1351,67 @@ var PixodeskAnimator = (() => {
     pinDistance: px.number().optional(),
     range: PxScrollRangeSchema.optional()
   }));
-  var PxAnimatorConfigSchema = implementsInterface()(px.object({
-    mode: px.enum([PxAnimatorMode.auto, PxAnimatorMode.waapi, PxAnimatorMode.frames]).optional(),
+  var PxTimelinePinSchema = implementsInterface()(px.object({
+    align: px.enum(["top", "center", "bottom"]).optional(),
+    top: px.number().optional(),
+    distance: px.number().optional()
+  }));
+  var PxTimelineEngineSchema = px.enum([PxTimelineEngineExtra.auto, PxTimelineEngineExtra.native, PxTimelineEngineExtra.js]).optional();
+  var PxTimeTimelineSchema = implementsInterface()(px.object({
+    type: px.literal("time").optional(),
+    engine: PxTimelineEngineSchema,
+    frameRate: px.number().optional(),
+    // §2.8: duration is a property of the TIMELINE — how long one pass takes.
     duration: px.number().optional(),
+    trigger: PxTriggerSchema.optional(),
     delay: px.number().optional(),
-    // LAW (SCHEMA-DESIGN R3, S10): the ONE sanctioned string-in-number union
-    // (CSS animation-iteration-count familiarity) — do not add more mixed unions.
     iterations: px.union([px.number(), px.literal("infinite")]).optional(),
-    fill: px.enum(["forwards", "backwards", "both", "none"]).optional(),
-    direction: px.enum(["normal", "reverse", "alternate", "alternate-reverse"]).optional(),
+    // `fillMode` on the wire (CSS `animation-fill-mode`; the runtime view calls it `fill`)
+    // — never `fill`, which is paint everywhere else in the format.
+    fillMode: px.enum(["forwards", "backwards", "both", "none"]).optional(),
+    direction: px.enum(["normal", "reverse", "alternate", "alternate-reverse"]).optional()
+  }));
+  var scrollishTimelineShape = {
+    // §2.8: duration is a property of the TIMELINE — under scrubbing it is the keyframe
+    // span the scroll range maps onto.
+    duration: px.number().optional(),
+    // Finite repeat count IS meaningful when scrubbing — the scroll range maps onto
+    // duration × iterations (rule D4; `'infinite'` cannot map to a range, so no literal here).
+    iterations: px.number().optional(),
+    engine: PxTimelineEngineSchema,
     frameRate: px.number().optional(),
-    trigger: PxTriggerSchema.optional(),
-    resetOnFinish: px.boolean().optional(),
+    axis: px.enum(["block", "inline", "x", "y"]).optional(),
+    source: px.enum(["nearest", "root"]).optional(),
+    subject: px.string().optional(),
+    // 'parent' | 'scroller' | any CSS selector
+    smoothing: px.number().optional(),
+    // ms
+    pin: px.union([px.boolean(), PxTimelinePinSchema]).optional(),
+    range: PxScrollRangeSchema.optional()
+  };
+  var PxScrollTimelineSchema = implementsInterface()(
+    px.object(__spreadValues({ type: px.literal("scroll") }, scrollishTimelineShape))
+  );
+  var PxViewTimelineSchema = implementsInterface()(
+    px.object(__spreadValues({ type: px.literal("view") }, scrollishTimelineShape))
+  );
+  var PxTimelineSchema = px.discriminatedUnion("type", [
+    PxTimeTimelineSchema,
+    // first = the member an absent `type` selects
+    PxScrollTimelineSchema,
+    PxViewTimelineSchema
+  ]);
+  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(),
-    timelineSource: px.string().optional(),
-    scroll: PxScrollSchema.optional(),
-    debugInstName: px.string().optional()
+    debugGlobalName: px.string().optional(),
+    // Declared HERE because this is a closed object: an undeclared key would be stripped by
+    // `sanitize` and flagged by strict validation on our own files.
+    version: px.string().optional()
   }));
   var PxBindingSchema = implementsInterface()(px.object({
     id: px.string(),
@@ -1241,18 +1429,18 @@ var PixodeskAnimator = (() => {
   ]);
   var PxAnimatableNumberSchema = px.union([
     px.number(),
-    px.object({ value: px.number() }),
-    PxPropertyAnimationSchema
+    PxPropertyAnimationSchema,
+    px.object({ value: px.number() })
   ]);
   var PxAnimatableVec2Schema = px.union([
     px.tuple([px.number(), px.number()]),
-    px.object({ value: px.tuple([px.number(), px.number()]) }),
-    PxPropertyAnimationSchema
+    PxPropertyAnimationSchema,
+    px.object({ value: px.tuple([px.number(), px.number()]) })
   ]);
   var PxAnimatableStringSchema = px.union([
     px.string(),
-    px.object({ value: px.string() }),
-    PxPropertyAnimationSchema
+    PxPropertyAnimationSchema,
+    px.object({ value: px.string() })
   ]);
   var PxTransformByEffectSchema = implementsInterface()(px.object({
     translate: PxAnimatableVec2Schema.optional(),
@@ -1272,7 +1460,7 @@ var PixodeskAnimator = (() => {
     origin: PxAnimatableVec2Schema.optional()
   }));
   var PxMaskedByEffectSchema = implementsInterface()(px.object({
-    sourceId: px.string().optional(),
+    source: px.string().optional(),
     maskType: px.enum([PxMaskType.luminance, PxMaskType.alpha]).optional(),
     maskUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
     maskContentUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
@@ -1282,8 +1470,7 @@ var PixodeskAnimator = (() => {
     height: px.number().optional()
   }));
   var PxClipPathEffectSchema = implementsInterface()(px.object({
-    d: PxAnimatableStringSchema.optional(),
-    animate: PxPropertyAnimationSchema.optional()
+    d: PxAnimatableStringSchema.optional()
   }));
   var PxStrokeTrimEffectSchema = implementsInterface()(px.object({
     offset: PxAnimatableNumberSchema.optional(),
@@ -1291,15 +1478,15 @@ var PixodeskAnimator = (() => {
     subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined]).optional()
   }));
   var PxRetimeEffectSchema = implementsInterface()(px.object({
-    sourceId: px.string().optional(),
     start: px.number().optional(),
     stretch: px.number().optional(),
     timeCrop: px.tuple([px.number(), px.number()]).optional()
   }));
   var PxCloneEffectSchema = implementsInterface()(px.object({
-    // Contextual kind — the `type` convention, see `PxNodeBase.type`.
-    type: px.enum([PxCloneType.content]).optional(),
-    sourceId: px.string().optional(),
+    // Subtractive on purpose: the `<use>` can only point at one wrapper layer of the
+    // source, so the choices form a ladder — 'translate' now, maybe 'transform' later.
+    without: px.enum([PxCloneWithout.translate]).optional(),
+    source: px.string().optional(),
     retime: PxRetimeEffectSchema.optional()
   }));
   var PxGradientStopSchema = implementsInterface()(px.object({
@@ -1314,11 +1501,11 @@ var PixodeskAnimator = (() => {
   var PxFillGradientEffectSchema = implementsInterface()(px.object({
     // Contextual kind — the `type` convention, see `PxNodeBase.type`.
     type: px.enum([PxGradientType.linear, PxGradientType.radial]),
-    p1: PxAnimatableVec2Schema.optional(),
-    p2: PxAnimatableVec2Schema.optional(),
-    c: PxAnimatableVec2Schema.optional(),
-    r: PxAnimatableNumberSchema.optional(),
-    fp: PxAnimatableVec2Schema.optional(),
+    start: PxAnimatableVec2Schema.optional(),
+    end: PxAnimatableVec2Schema.optional(),
+    center: PxAnimatableVec2Schema.optional(),
+    radius: PxAnimatableNumberSchema.optional(),
+    focal: PxAnimatableVec2Schema.optional(),
     stops: PxAnimatableGradientStopsSchema.optional(),
     gradientUnits: px.enum([PxGradientUnits.userSpaceOnUse, PxGradientUnits.objectBoundingBox]).optional(),
     spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat]).optional(),
@@ -1326,7 +1513,7 @@ var PixodeskAnimator = (() => {
   }));
   var PxStrokeGradientEffectSchema = PxFillGradientEffectSchema;
   var PxTextPathEffectSchema = implementsInterface()(px.object({
-    path: px.string(),
+    pathData: px.string(),
     pathOverflow: px.enum([PxPathOverflow.clip, PxPathOverflow.extend]).optional(),
     lengthAdjust: px.enum([PxLengthAdjust.spacing, PxLengthAdjust.spacingAndGlyphs]).optional(),
     method: px.enum([PxTextPathMethod.align, PxTextPathMethod.stretch]).optional(),
@@ -1366,16 +1553,33 @@ var PixodeskAnimator = (() => {
     walk(root, "root");
     return warnings;
   }
+  function validateDocument(doc) {
+    const ctx = { errors: [], warnings: [], strict: true };
+    const problems = PxAnimatedSvgDocumentSchema.isValid(doc, ctx, ["root"]) ? [] : [...ctx.errors];
+    if (doc && typeof doc === "object") {
+      for (const w of validateNodeEffects(doc, { strict: true })) {
+        if (!problems.includes(w)) problems.push(w);
+      }
+    }
+    return problems;
+  }
   var PxNodeBase = px.openObject({
     // CONVENTION (SCHEMA-DESIGN R1 / issues N4): `type` is the ONE word for "what
     // kind of thing is this", discriminated by its CARRIER — here the node TAG
-    // (`rect`, `text`), and inside a sub-object that object's kind (`clone.type`,
+    // (`rect`, `text`), and inside a sub-object that object's kind (`fillGradient.type`,
     // `fillGradient.type`, editor `preset.type`). Each sits in its own object, so
     // the carrier disambiguates completely; synonyms (`cloneKind`, `presetShape`)
     // would add words that all mean "type" and still need the carrier to read.
     // Guarding a `type` SLOT against a wrong VALUE is the job of strict enums
     // (issues V3), never of distinct key names.
     type: px.string(),
+    // The escape hatch for elements that carry a REAL `type` attribute — `<feTurbulence
+    // type="fractalNoise">`, `<feFuncR type="table">`, `<feColorMatrix type="saturate">`.
+    // `type` is taken by the tag name, so the attribute travels here and the renderer puts
+    // it back (`PxAnimatorDOM.renderNode`, `PxRnRender`). Declared here — not merely
+    // documented — because a wire key that is not in a schema is invisible to the
+    // minifier's reserve list and gets renamed (MINIFICATION-BOUNDARY-PLAN.md §1.1).
+    domType: px.string().optional(),
     id: px.string().optional(),
     meta: px.any().optional(),
     // Player-effects bucket emitted by the Editor's lightweight design format.
@@ -1411,7 +1615,7 @@ var PixodeskAnimator = (() => {
     c: px.boolean().optional()
   }));
 
-  // ../svg-animator-core/src/PxIdUtil.ts
+  // ../svg-animator-core/src/util/PxIdUtil.ts
   var _idCounter = 0;
   function generateUniqueId() {
     const timestamp = Date.now().toString(36);
@@ -1448,7 +1652,8 @@ var PixodeskAnimator = (() => {
       "flood-color",
       "lighting-color"
     ]);
-    const directIdRefAttrs = /* @__PURE__ */ new Set(["sourceId", "targetId", "boundElementId"]);
+    const directIdRefAttrs = /* @__PURE__ */ new Set(["targetId", "boundElementId"]);
+    const isEffectSourceRef = (key, parentKey) => key === "source" && (parentKey === "maskedBy" || parentKey === "clone");
     function collectIds(node) {
       if (!node || typeof node !== "object") return;
       if (node.id && typeof node.id === "string") {
@@ -1465,7 +1670,7 @@ var PixodeskAnimator = (() => {
         }
       }
     }
-    function updateRefs(node) {
+    function updateRefs(node, parentKey) {
       if (!node || typeof node !== "object") return;
       for (const [key, value] of Object.entries(node)) {
         if (key === "children") {
@@ -1485,7 +1690,7 @@ var PixodeskAnimator = (() => {
             }
           } else if (urlRefAttrs.has(key)) {
             node[key] = replaceUrlRefs(value, idMap);
-          } else if (directIdRefAttrs.has(key)) {
+          } else if (directIdRefAttrs.has(key) || isEffectSourceRef(key, parentKey)) {
             const hasHash = value.startsWith("#");
             const newId = idMap.get(hasHash ? value.slice(1) : value);
             if (newId) {
@@ -1501,7 +1706,7 @@ var PixodeskAnimator = (() => {
             }
           }
         } else if (typeof value === "object" && value !== null) {
-          updateRefs(value);
+          updateRefs(value, key);
         }
       }
     }
@@ -1510,9 +1715,11 @@ var PixodeskAnimator = (() => {
     const docAnimate = (_a = cloned.animator) == null ? void 0 : _a.animateById;
     if (docAnimate && typeof docAnimate === "object") {
       const updatedAnimate = {};
-      for (const [id, anim] of Object.entries(docAnimate)) {
+      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[newId] = anim;
+        updatedAnimate[hashed ? "#" + newId : newId] = anim;
       }
       cloned.animator = __spreadProps(__spreadValues({}, cloned.animator), { animateById: updatedAnimate });
     }
@@ -1525,7 +1732,7 @@ var PixodeskAnimator = (() => {
     });
   }
 
-  // ../svg-animator-core/src/PxNodeProps.ts
+  // ../svg-animator-core/src/util/PxNodeProps.ts
   var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
     "script",
     "foreignobject"
@@ -1605,16 +1812,16 @@ var PixodeskAnimator = (() => {
       let value = props[rawKey];
       if (COLOUR_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 && !value.kfs) {
+      } else if (key === "transform" && value !== null && typeof value === "object" && !Array.isArray(value) && !value.keyframes) {
         const parts = value.value && typeof value.value === "object" ? value.value : value;
-        propsCopy["transform"] = composeTransformParts(parts, { withUnits: false });
+        propsCopy[TRANSFORM_ATTR] = composeTransformParts(parts, { withUnits: false });
       } else if (TRANSFORM_FN_NAMES.has(key)) {
         if (Array.isArray(value)) {
           if (key === "translate") value = value.map((v) => v + "px");
           value = value.join(",");
         }
         if (key === "rotate") value = value + "deg";
-        propsCopy["transform"] = key + "(" + value + ")";
+        propsCopy[TRANSFORM_ATTR] = key + "(" + value + ")";
       } else if (Array.isArray(value)) {
         propsCopy[key] = value.join(",");
       } else if (value !== void 0 && value !== null) {
@@ -1624,10 +1831,9 @@ var PixodeskAnimator = (() => {
     return propsCopy;
   }
 
-  // ../svg-animator-core/src/PxMotionPath.ts
+  // ../svg-animator-core/src/materialise/PxMotionPath.ts
   function getKfTranslate(kf) {
-    var _a;
-    const v = (_a = kf.value) != null ? _a : kf.v;
+    const v = kfValue(kf);
     if (!v) return void 0;
     if (Array.isArray(v) && v.length >= 2 && typeof v[0] === "number" && typeof v[1] === "number") {
       return [v[0], v[1]];
@@ -1637,31 +1843,27 @@ var PixodeskAnimator = (() => {
     return void 0;
   }
   function getKfTime(kf) {
-    var _a, _b;
-    return (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
+    return kfTime(kf);
   }
   function getKfEasing(kf) {
-    var _a;
-    return (_a = kf.easing) != null ? _a : kf.e;
+    return kfEasing(kf);
   }
   function propAnimIsMotionPath(anim) {
-    var _a, _b, _c;
-    const kfs = (_a = anim.keyframes) != null ? _a : anim.kfs;
+    const kfs = anim.keyframes;
     if (!Array.isArray(kfs)) return false;
     if (anim.autoOrient) return true;
     for (const kf of kfs) {
-      if (((_b = kf.tangentIn) != null ? _b : kf.ti) || ((_c = kf.tangentOut) != null ? _c : kf.to)) return true;
+      if (kfTangentIn(kf) || kfTangentOut(kf)) return true;
     }
     return false;
   }
   var _segmentCache = /* @__PURE__ */ new WeakMap();
   function getSegmentCache(prevKf, nextKf, prevPos, nextPos) {
-    var _a, _b;
     let byNext = _segmentCache.get(prevKf);
     const existing = byNext == null ? void 0 : byNext.get(nextKf);
     if (existing) return existing;
-    const to = (_a = prevKf.tangentOut) != null ? _a : prevKf.to;
-    const ti = (_b = nextKf.tangentIn) != null ? _b : nextKf.ti;
+    const to = kfTangentOut(prevKf);
+    const ti = kfTangentIn(nextKf);
     const P1 = [prevPos[0] + (to ? to[0] : 0), prevPos[1] + (to ? to[1] : 0)];
     const P2 = [nextPos[0] + (ti ? ti[0] : 0), nextPos[1] + (ti ? ti[1] : 0)];
     const lut = bezier2D_arcLengthLUT(prevPos, P1, P2, nextPos);
@@ -1711,14 +1913,14 @@ var PixodeskAnimator = (() => {
   var DEFAULT_ROTATION_TOL = 5;
   var DEFAULT_MAX_SAMPLES = 32;
   function materialiseMotionPathInPropAnim(anim, opts) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     if (!propAnimIsMotionPath(anim)) return anim;
-    const kfs = (_a = anim.keyframes) != null ? _a : anim.kfs;
+    const kfs = anim.keyframes;
     if (!Array.isArray(kfs) || kfs.length < 2) return anim;
     const autoOrient = !!anim.autoOrient;
-    const flatnessTol = (_b = opts == null ? void 0 : opts.flatnessTolerance) != null ? _b : DEFAULT_FLATNESS_TOL;
-    const rotationTol = (_c = opts == null ? void 0 : opts.rotationTolerance) != null ? _c : DEFAULT_ROTATION_TOL;
-    const maxSamples = (_d = opts == null ? void 0 : opts.maxSamplesPerSegment) != null ? _d : DEFAULT_MAX_SAMPLES;
+    const flatnessTol = (_a = opts == null ? void 0 : opts.flatnessTolerance) != null ? _a : DEFAULT_FLATNESS_TOL;
+    const rotationTol = (_b = opts == null ? void 0 : opts.rotationTolerance) != null ? _b : DEFAULT_ROTATION_TOL;
+    const maxSamples = (_c = opts == null ? void 0 : opts.maxSamplesPerSegment) != null ? _c : DEFAULT_MAX_SAMPLES;
     const out = [];
     const firstPos = getKfTranslate(kfs[0]);
     if (!firstPos) return anim;
@@ -1747,15 +1949,14 @@ var PixodeskAnimator = (() => {
     const lastInE = getKfEasing(kfs[kfs.length - 1]);
     if (lastInE) out[out.length - 1].e = lastInE;
     if (autoOrient) unwrapAutoOrientRotations(out);
-    const result = { kfs: out };
+    const result = { keyframes: out };
     if (anim.loop !== void 0) result.loop = anim.loop;
     return result;
   }
   function unwrapAutoOrientRotations(kfs) {
-    var _a;
     let prev;
     for (const kf of kfs) {
-      const v = (_a = kf.v) != null ? _a : kf.value;
+      const v = kfValue(kf);
       if (!v || typeof v.rotate !== "number") continue;
       if (prev === void 0) {
         prev = v.rotate;
@@ -1772,8 +1973,7 @@ var PixodeskAnimator = (() => {
     return { t: time, v: value };
   }
   function getKfValueParts(kf) {
-    var _a;
-    const v = (_a = kf.value) != null ? _a : kf.v;
+    const v = kfValue(kf);
     if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
     return v;
   }
@@ -1834,9 +2034,8 @@ var PixodeskAnimator = (() => {
     return d;
   }
   function insertSharpCornerStepKfIfNeeded(out, prevKf, nextKf, prevPos, nextPos, rotationTol) {
-    var _a;
     const lastKf = out[out.length - 1];
-    const lastV = (_a = lastKf.v) != null ? _a : lastKf.value;
+    const lastV = kfValue(lastKf);
     const prevExit = lastV == null ? void 0 : lastV.rotate;
     if (typeof prevExit !== "number") return;
     const boundaryV = getKfValueParts(prevKf);
@@ -2017,7 +2216,7 @@ var PixodeskAnimator = (() => {
     return cloned;
   }
 
-  // ../svg-animator-core/src/PxDefinitions.ts
+  // ../svg-animator-core/src/animation/PxDefinitions.ts
   var LOOP_JUMP_SHIFT_MS = 1;
   function deepEqualValue(a, b) {
     if (a === b) return true;
@@ -2230,7 +2429,7 @@ var PixodeskAnimator = (() => {
     const totalIntervals = keyframes.length - 1;
     const segCount = clamp((_a = loop.segmentCount) != null ? _a : totalIntervals, 1, totalIntervals);
     let segKfs;
-    if (loop.extend === PxLoopExtend.before) {
+    if (loop.repeatAt === PxLoopRepeatAt.start) {
       segKfs = keyframes.slice(0, segCount + 1);
     } else {
       segKfs = keyframes.slice(totalIntervals - segCount);
@@ -2238,7 +2437,7 @@ var PixodeskAnimator = (() => {
     const firstT = (_b = keyframes[0].t) != null ? _b : 0;
     const lastT = (_c = keyframes[keyframes.length - 1].t) != null ? _c : 0;
     let fillStart, fillEnd;
-    if (loop.extend === PxLoopExtend.before) {
+    if (loop.repeatAt === PxLoopRepeatAt.start) {
       fillStart = 0;
       fillEnd = firstT;
     } else {
@@ -2251,21 +2450,18 @@ var PixodeskAnimator = (() => {
     const segEndT = (_e = segKfs[segKfs.length - 1].t) != null ? _e : 0;
     const segDuration = segEndT - segStartT;
     if (segDuration <= 0) return keyframes;
-    const template = segKfs.map((kf) => {
-      var _a2, _b2;
-      return {
-        relT: (kf.t - segStartT) / segDuration,
-        v: kf.v,
-        e: kf.e,
-        tangentIn: (_a2 = kf.tangentIn) != null ? _a2 : kf.ti,
-        tangentOut: (_b2 = kf.tangentOut) != null ? _b2 : kf.to
-      };
-    });
+    const template = segKfs.map((kf) => ({
+      relT: (kf.t - segStartT) / segDuration,
+      v: kf.v,
+      e: kf.e,
+      tangentIn: kfTangentIn(kf),
+      tangentOut: kfTangentOut(kf)
+    }));
     const fullReps = Math.floor(fillDuration / segDuration);
     const remainder = fillDuration - fullReps * segDuration;
     const partialFraction = remainder / segDuration;
     const looped = [];
-    const separateBoundary = loop.extend !== PxLoopExtend.before;
+    const separateBoundary = loop.repeatAt !== PxLoopRepeatAt.start;
     const originalTerminalKf = keyframes[keyframes.length - 1];
     let terminalEasingOverride;
     let hasTerminalEasingOverride = false;
@@ -2373,30 +2569,30 @@ var PixodeskAnimator = (() => {
         looped.push(pushed);
       }
     }
-    if (loop.extend === PxLoopExtend.before) {
+    if (loop.repeatAt === PxLoopRepeatAt.start) {
       if (partialFraction > 1e-9) {
-        const isReversed = !!loop.alternate && fullReps % 2 === 0;
+        const isReversed = loop.direction === PxLoopDirection.alternate && fullReps % 2 === 0;
         appendRepTail(fillStart, isReversed, partialFraction);
       }
       for (let rep = 0; rep < fullReps; rep++) {
         const distFromBoundary = fullReps - 1 - rep;
-        const isReversed = !!loop.alternate && distFromBoundary % 2 === 0;
+        const isReversed = loop.direction === PxLoopDirection.alternate && distFromBoundary % 2 === 0;
         const repStart = fillStart + remainder + rep * segDuration;
         appendRep(repStart, isReversed);
       }
     } else {
       for (let rep = 0; rep < fullReps; rep++) {
-        const isReversed = !!loop.alternate && rep % 2 === 0;
+        const isReversed = loop.direction === PxLoopDirection.alternate && rep % 2 === 0;
         const repStart = fillStart + rep * segDuration;
         appendRep(repStart, isReversed);
       }
       if (partialFraction > 1e-9) {
-        const isReversed = !!loop.alternate && fullReps % 2 === 0;
+        const isReversed = loop.direction === PxLoopDirection.alternate && fullReps % 2 === 0;
         const repStart = fillStart + fullReps * segDuration;
         appendRep(repStart, isReversed, partialFraction);
       }
     }
-    if (loop.extend === PxLoopExtend.before) {
+    if (loop.repeatAt === PxLoopRepeatAt.start) {
       return [...looped, ...keyframes];
     } else {
       if (hasTerminalEasingOverride && keyframes.length > 0) {
@@ -2408,34 +2604,34 @@ var PixodeskAnimator = (() => {
     }
   }
   function normalizeKeyframes(propName, propAnim, duration, defs) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    const keyframes = propAnim.keyframes || propAnim.kfs || [];
+    var _a;
+    const keyframes = propAnim.keyframes || [];
     const normalized = [];
     for (const kf of keyframes) {
-      const timePct = (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
-      let value = (_c = kf.value) != null ? _c : kf.v;
-      const easing = (_d = kf.easing) != null ? _d : kf.e;
+      const timePct = kfTime(kf);
+      let value = kfValue(kf);
+      const easing = kfEasing(kf);
       if (propName === "d") {
         value = normalizePathValue(value);
       }
       const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
       if (COLOUR_ATTR_NAMES.has(propNameKebab)) {
-        value = (_e = parseColor(value)) != null ? _e : value;
+        value = (_a = parseColor(value)) != null ? _a : value;
       }
       const normKf = {
         t: timePct,
         v: value,
         e: resolveEasing(easing, defs)
       };
-      const tIn = (_f = kf.tangentIn) != null ? _f : kf.ti;
-      const tOut = (_g = kf.tangentOut) != null ? _g : kf.to;
+      const tIn = kfTangentIn(kf);
+      const tOut = kfTangentOut(kf);
       if (tIn) normKf.tangentIn = tIn;
       if (tOut) normKf.tangentOut = tOut;
       normalized.push(normKf);
     }
     normalized.sort((a, b) => {
-      var _a2, _b2;
-      return ((_a2 = a.t) != null ? _a2 : 0) - ((_b2 = b.t) != null ? _b2 : 0);
+      var _a2, _b;
+      return ((_a2 = a.t) != null ? _a2 : 0) - ((_b = b.t) != null ? _b : 0);
     });
     const loopRaw = propAnim.loop;
     const loop = loopRaw === true ? {} : loopRaw || void 0;
@@ -2454,28 +2650,29 @@ var PixodeskAnimator = (() => {
     return merged;
   }
   function materialiseInternalLoopsInPropAnim(propName, propAnim, duration) {
-    var _a;
     const loopRaw = propAnim.loop;
     if (loopRaw === void 0 || loopRaw === null || loopRaw === false) return propAnim;
     const loop = loopRaw === true ? {} : loopRaw;
-    const rawKfs = (_a = propAnim.keyframes) != null ? _a : propAnim.kfs;
+    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 kfs = rawKfs.map((kf) => {
-      var _a2, _b, _c, _d, _e, _f, _g, _h;
-      const t = (_a2 = kf.t) != null ? _a2 : kf.time;
-      let v = (_b = kf.v) != null ? _b : kf.value;
+      var _a;
+      const t = kfTime(kf);
+      let v = kfValue(kf);
       if (propName === "d") v = normalizePathValue(v);
-      if (isColour) v = (_c = parseColor(v)) != null ? _c : v;
-      const e = (_d = kf.e) != null ? _d : kf.easing;
+      if (isColour) v = (_a = parseColor(v)) != null ? _a : v;
+      const e = kfEasing(kf);
       const out2 = { t, v, e };
-      if ((_e = kf.tangentIn) != null ? _e : kf.ti) out2.tangentIn = (_f = kf.tangentIn) != null ? _f : kf.ti;
-      if ((_g = kf.tangentOut) != null ? _g : kf.to) out2.tangentOut = (_h = kf.tangentOut) != null ? _h : kf.to;
+      const tIn = kfTangentIn(kf);
+      const tOut = kfTangentOut(kf);
+      if (tIn) out2.tangentIn = tIn;
+      if (tOut) out2.tangentOut = tOut;
       return out2;
     });
     const expanded = expandLoopKeyframes(propName, kfs, loop, duration);
-    const out = { kfs: expanded };
+    const out = { keyframes: expanded };
     if (propAnim.autoOrient !== void 0) out.autoOrient = propAnim.autoOrient;
     return out;
   }
@@ -2517,7 +2714,37 @@ var PixodeskAnimator = (() => {
   function generateElementId() {
     return "_px_el_" + ++_elementIdCounter;
   }
-  function normalizeAnimationDefinition(animDef, duration, defs, engine = PxAnimatorEngine.waapi) {
+  function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
+    if (!animDef) return animDef;
+    const staticParts = staticTransform && typeof staticTransform === "object" && !Array.isArray(staticTransform) ? staticTransform : parseTransformParts(staticTransform);
+    if (!staticParts || !Object.keys(staticParts).length) return animDef;
+    const mergeKfValue = (v) => v && typeof v === "object" && !Array.isArray(v) ? __spreadValues(__spreadValues({}, staticParts), v) : v;
+    const transformAnim = animDef[TRANSFORM_ATTR];
+    if (transformAnim && typeof transformAnim === "object") {
+      const anim = transformAnim;
+      if (Array.isArray(anim.keyframes)) {
+        const out = __spreadProps(__spreadValues({}, anim), {
+          keyframes: anim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: mergeKfValue(kf.value) }))
+        });
+        if (out.value !== void 0) out.value = mergeKfValue(out.value);
+        return __spreadProps(__spreadValues({}, animDef), { transform: out });
+      }
+      return animDef;
+    }
+    const channels = Object.keys(animDef).filter((k) => TRANSFORM_FN_NAMES.has(k));
+    if (channels.length !== 1) return animDef;
+    const ch = channels[0];
+    const chAnim = animDef[ch];
+    if (!chAnim || typeof chAnim !== "object" || !Array.isArray(chAnim.keyframes)) return animDef;
+    const lifted = __spreadProps(__spreadValues({}, chAnim), {
+      keyframes: chAnim.keyframes.map((kf) => __spreadProps(__spreadValues({}, kf), { value: __spreadProps(__spreadValues({}, staticParts), { [ch]: kf.value }) }))
+    });
+    if (lifted.value !== void 0) lifted.value = __spreadProps(__spreadValues({}, staticParts), { [ch]: lifted.value });
+    const rest = __spreadValues({}, animDef);
+    delete rest[ch];
+    return __spreadProps(__spreadValues({}, rest), { transform: lifted });
+  }
+  function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimelineEngine.native) {
     const normalized = {};
     for (const [propName, propAnim] of Object.entries(animDef)) {
       if (propName === "transform" && propAnim.alongPathMode === "offsetPath" && animDef["offsetDistance"] !== void 0) {
@@ -2525,24 +2752,24 @@ var PixodeskAnimator = (() => {
       }
       const normalizedKfs = normalizeKeyframes(propName, propAnim, duration, defs);
       if (normalizedKfs.length > 0) {
-        const out = { kfs: normalizedKfs };
+        const out = { keyframes: normalizedKfs };
         if (propAnim.autoOrient !== void 0) out.autoOrient = propAnim.autoOrient;
         if (propAnim.loop !== void 0) out.loop = propAnim.loop;
-        normalized[propName] = engine === PxAnimatorEngine.waapi && propName === "transform" ? materialiseMotionPathInPropAnim(out) : out;
+        normalized[propName] = engine === PxTimelineEngine.native && propName === "transform" ? materialiseMotionPathInPropAnim(out) : out;
       }
     }
     return normalized;
   }
-  function getNormalisedBindings(doc, engine = PxAnimatorEngine.waapi) {
+  function getNormalisedBindings(doc, engine = PxTimelineEngine.native) {
     const animatorConfig = getAnimatorConfig(doc) || {};
     const defs = getDefs(doc);
     const duration = animatorConfig.duration || 1e3;
     const bindings = [];
-    const processAnimation = (id, animate) => {
+    const processAnimation = (id, animate, staticTransform) => {
       if (!animate) return null;
       const animDefs = resolveElementAnimation(animate, defs);
       if (animDefs.length === 0) return null;
-      const merged = mergeAnimationDefinitions(animDefs);
+      const merged = mergeStaticTransformIntoAnimDef(mergeAnimationDefinitions(animDefs), staticTransform);
       const normalizedAnim = normalizeAnimationDefinition(merged, duration, defs, engine);
       if (Object.keys(normalizedAnim).length === 0) return null;
       return {
@@ -2562,7 +2789,7 @@ var PixodeskAnimator = (() => {
       if (inlineAnim && Object.keys(inlineAnim).length > 0) {
         const nodeId = node.id || generateElementId();
         node.id = nodeId;
-        const normalized = processAnimation(nodeId, inlineAnim);
+        const normalized = processAnimation(nodeId, inlineAnim, node.transform);
         if (normalized) bindings.push(normalized);
       }
       if (node.children) {
@@ -2599,13 +2826,13 @@ var PixodeskAnimator = (() => {
     return { prevKf, nextKf };
   }
   function calcPropertyValue(propName, propAnim, progress) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    const keyframes = propAnim.kfs || propAnim.keyframes || [];
+    var _a, _b, _c, _d;
+    const keyframes = propAnim.keyframes || [];
     if (keyframes.length === 0) return null;
     const { prevKf, nextKf } = getKeyframesPair(keyframes, progress);
     let localProgress = prevKf === nextKf ? 0 : remap(progress, (_a = prevKf.t) != null ? _a : 0, (_b = nextKf.t) != null ? _b : 0, 0, 1);
     localProgress = clamp(localProgress, 0, 1);
-    const easing = (_c = prevKf.e) != null ? _c : prevKf.easing;
+    const easing = kfEasing(prevKf);
     if (easing && Array.isArray(easing)) {
       try {
         localProgress = cubicBezier(easing)(localProgress);
@@ -2614,11 +2841,11 @@ var PixodeskAnimator = (() => {
     }
     let cssAttrName = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
     let cssValue = null;
-    const prevV = (_d = prevKf == null ? void 0 : prevKf.v) != null ? _d : prevKf == null ? void 0 : prevKf.value;
-    const nextV = (_e = nextKf == null ? void 0 : nextKf.v) != null ? _e : nextKf == null ? void 0 : nextKf.value;
+    const prevV = prevKf == null ? void 0 : prevKf.v;
+    const nextV = nextKf == null ? void 0 : nextKf.v;
     if (cssAttrName === "d") {
-      const prevPaths = (_f = prevV == null ? void 0 : prevV.paths) != null ? _f : Array.isArray(prevV) ? prevV : [];
-      const nextPaths = (_g = nextV == null ? void 0 : nextV.paths) != null ? _g : Array.isArray(nextV) ? nextV : [];
+      const prevPaths = (_c = prevV == null ? void 0 : prevV.paths) != null ? _c : Array.isArray(prevV) ? prevV : [];
+      const nextPaths = (_d = nextV == null ? void 0 : nextV.paths) != null ? _d : Array.isArray(nextV) ? nextV : [];
       cssValue = interpolateBeziers(
         prevPaths,
         nextPaths,
@@ -2721,7 +2948,7 @@ var PixodeskAnimator = (() => {
     return result;
   }
 
-  // ../svg-animator-core/src/PxNodeCloneUtil.ts
+  // ../svg-animator-core/src/util/PxNodeCloneUtil.ts
   function deepClonePxNode(value) {
     if (value === null || typeof value !== "object") return value;
     if (Array.isArray(value)) return value.map(deepClonePxNode);
@@ -2785,7 +3012,7 @@ var PixodeskAnimator = (() => {
     return gNode;
   }
 
-  // ../svg-animator-core/src/PxAnimatorUseMaterialiser.ts
+  // ../svg-animator-core/src/materialise/PxAnimatorUseMaterialiser.ts
   function materialiseAnimatedUseInstances(root) {
     var _a;
     const idMap = buildIdMap(root);
@@ -2933,7 +3160,7 @@ var PixodeskAnimator = (() => {
     return changed ? __spreadProps(__spreadValues({}, node), { children: newChildren }) : node;
   }
 
-  // ../svg-animator-core/src/effects/transformParts.ts
+  // ../svg-animator-core/src/effects/shared/transformParts.ts
   function partsRecord(part, value, origin) {
     const rec = {};
     if (part === "translate" /* Translate */) rec.translate = value;
@@ -2944,19 +3171,19 @@ var PixodeskAnimator = (() => {
     return rec;
   }
   function readAnimatable(raw) {
-    var _a, _b, _c;
+    var _a, _b;
     if (raw === void 0) return { kind: "absent" /* Absent */ };
     if (Array.isArray(raw)) return { kind: "static" /* Static */, value: raw };
     if (typeof raw === "object") {
       const obj = raw;
-      const kfs = (_a = obj.keyframes) != null ? _a : obj.kfs;
+      const kfs = obj.keyframes;
       if (kfs) {
         const out = { kind: "animated" /* Animated */, keyframes: kfs.map(normaliseKeyframe), autoOrient: obj.autoOrient, loop: obj.loop };
-        const base = (_b = obj.value) != null ? _b : obj.v;
+        const base = (_a = obj.value) != null ? _a : obj.v;
         if (base !== void 0 && out.kind === "animated" /* Animated */) out.base = base;
         return out;
       }
-      const staticValue = (_c = obj.value) != null ? _c : obj.v;
+      const staticValue = (_b = obj.value) != null ? _b : obj.v;
       if (staticValue !== void 0) return { kind: "static" /* Static */, value: staticValue };
     }
     return { kind: "static" /* Static */, value: raw };
@@ -3010,7 +3237,7 @@ var PixodeskAnimator = (() => {
     return out;
   }
 
-  // ../svg-animator-core/src/effects/transformationEffect.ts
+  // ../svg-animator-core/src/effects/transform/transformationEffect.ts
   function applyTransformByEffect(node, fx, ctx) {
     if (!fx) return node;
     delete node.transform;
@@ -3101,7 +3328,7 @@ var PixodeskAnimator = (() => {
     return inner;
   }
 
-  // ../svg-animator-core/src/effects/util.ts
+  // ../svg-animator-core/src/effects/shared/util.ts
   function genId(ctx, prefix) {
     return "_lw_" + prefix + "_" + ctx.nextId++;
   }
@@ -3123,11 +3350,11 @@ var PixodeskAnimator = (() => {
     return regenerateIdsAndRewriteRefs(root, () => genId(ctx, "retimed"));
   }
 
-  // ../svg-animator-core/src/effects/contentRefSplit.ts
+  // ../svg-animator-core/src/effects/reference/contentRefSplit.ts
   function identifyContentRefTargets(node, ctx, allocator) {
     var _a, _b, _c;
-    if (node.type === "use" && ((_b = (_a = node.effects) == null ? void 0 : _a.clone) == null ? void 0 : _b.type) === "content") {
-      const sourceId = stripHash2(node.effects.clone.sourceId);
+    if (node.type === "use" && ((_b = (_a = node.effects) == null ? void 0 : _a.clone) == null ? void 0 : _b.without) === "translate") {
+      const sourceId = stripHash2(node.effects.clone.source);
       if (typeof sourceId === "string" && sourceId && !ctx.contentRefInnerIds.has(sourceId)) {
         ctx.contentRefInnerIds.set(sourceId, allocator(sourceId));
       }
@@ -3224,7 +3451,7 @@ var PixodeskAnimator = (() => {
         if (split.rest) node.transform = split.rest;
         else delete node.transform;
       }
-    } else if (node.transform && typeof node.transform === "object" && !Array.isArray(node.transform) && !node.transform.keyframes && !node.transform.kfs) {
+    } else if (node.transform && typeof node.transform === "object" && !Array.isArray(node.transform) && !node.transform.keyframes) {
       const wrapped = node.transform.value;
       const isWrapped = !!(wrapped && typeof wrapped === "object");
       const value = isWrapped ? wrapped : node.transform;
@@ -3338,7 +3565,7 @@ var PixodeskAnimator = (() => {
     return false;
   }
 
-  // ../svg-animator-core/src/effects/gradientEffect.ts
+  // ../svg-animator-core/src/effects/paint/gradientEffect.ts
   function applyFillGradientEffect(node, fx, ctx) {
     return applyGradient(node, fx, ctx, "fill");
   }
@@ -3359,12 +3586,12 @@ var PixodeskAnimator = (() => {
       id
     };
     if (fx.type === PxGradientType.linear) {
-      applyGeomVec(out, "x1", "y1", fx.p1);
-      applyGeomVec(out, "x2", "y2", fx.p2);
+      applyGeomVec(out, "x1", "y1", fx.start);
+      applyGeomVec(out, "x2", "y2", fx.end);
     } else {
-      applyGeomVec(out, "cx", "cy", fx.c);
-      applyGeomNumber(out, "r", fx.r);
-      applyGeomVec(out, "fx", "fy", fx.fp);
+      applyGeomVec(out, "cx", "cy", fx.center);
+      applyGeomNumber(out, "r", fx.radius);
+      applyGeomVec(out, "fx", "fy", fx.focal);
     }
     if (fx.gradientUnits) out.gradientUnits = fx.gradientUnits;
     if (fx.spreadMethod) out.spreadMethod = fx.spreadMethod;
@@ -3408,7 +3635,7 @@ var PixodeskAnimator = (() => {
     writeAnimatableChannel(out, attrName, read, { asString: true });
   }
   function buildStopChildren(stops, ctx) {
-    var _a, _b, _c, _d;
+    var _a, _b;
     if (!stops) return [];
     const read = readAnimatable(stops);
     if (read.kind === "absent" /* Absent */) return [];
@@ -3418,14 +3645,14 @@ var PixodeskAnimator = (() => {
     const loopFromSource = read.loop;
     let stopCount = 0;
     for (const kf of kfs) {
-      const v = (_a = kf.value) != null ? _a : kf.v;
+      const v = kfValue(kf);
       if (Array.isArray(v) && v.length > stopCount) stopCount = v.length;
     }
     if (!stopCount) return [];
-    const firstKfValue = (_b = kfs[0].value) != null ? _b : kfs[0].v;
+    const firstKfValue = kfValue(kfs[0]);
     const baselineStops = [];
     for (let i = 0; i < stopCount; i++) {
-      const s = (_d = (_c = firstKfValue == null ? void 0 : firstKfValue[i]) != null ? _c : prevDefinedStop(kfs, 0, i)) != null ? _d : { offset: i / Math.max(1, stopCount - 1), color: "#000000" };
+      const s = (_b = (_a = firstKfValue == null ? void 0 : firstKfValue[i]) != null ? _a : prevDefinedStop(kfs, 0, i)) != null ? _b : { offset: i / Math.max(1, stopCount - 1), color: "#000000" };
       baselineStops.push({ offset: s.offset, color: s.color });
     }
     return baselineStops.map((bs, i) => animatedStopNode(bs, kfs, i, ctx, loopFromSource));
@@ -3438,16 +3665,16 @@ var PixodeskAnimator = (() => {
     };
   }
   function animatedStopNode(baseline, kfs, stopIdx, _ctx, loop) {
-    var _a, _b, _c, _d, _e;
+    var _a;
     const colorKfs = [];
     const offsetKfs = [];
     let offsetVaries = false;
     for (const kf of kfs) {
-      const t = (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0;
-      const arr = (_c = kf.value) != null ? _c : kf.v;
-      const sliced = (_d = arr == null ? void 0 : arr[stopIdx]) != null ? _d : prevDefinedStop(kfs, kfs.indexOf(kf), stopIdx);
+      const t = kfTime(kf);
+      const arr = kfValue(kf);
+      const sliced = (_a = arr == null ? void 0 : arr[stopIdx]) != null ? _a : prevDefinedStop(kfs, kfs.indexOf(kf), stopIdx);
       if (!sliced) continue;
-      const easing = (_e = kf.easing) != null ? _e : kf.e;
+      const easing = kfEasing(kf);
       const colorOut = { time: t, value: sliced.color };
       if (easing !== void 0) colorOut.easing = easing;
       colorKfs.push(colorOut);
@@ -3474,13 +3701,12 @@ var PixodeskAnimator = (() => {
     return stop;
   }
   function prevDefinedStop(kfs, fromIdx, stopIdx) {
-    var _a, _b;
     for (let i = fromIdx; i >= 0; i--) {
-      const arr = (_a = kfs[i].value) != null ? _a : kfs[i].v;
+      const arr = kfValue(kfs[i]);
       if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
     }
     for (let i = fromIdx + 1; i < kfs.length; i++) {
-      const arr = (_b = kfs[i].value) != null ? _b : kfs[i].v;
+      const arr = kfValue(kfs[i]);
       if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
     }
     return void 0;
@@ -3490,10 +3716,9 @@ var PixodeskAnimator = (() => {
     return pct + "%";
   }
 
-  // ../svg-animator-core/src/effects/clipPathEffect.ts
+  // ../svg-animator-core/src/effects/clipping/clipPathEffect.ts
   function applyClipPathEffect(node, fx, ctx) {
-    var _a, _b;
-    if (!fx || !fx.d && !fx.animate) return node;
+    if (!(fx == null ? void 0 : fx.d)) return node;
     const clipId = genId(ctx, "clip");
     const pathChild = { type: "path" };
     const read = readAnimatable(fx.d);
@@ -3505,11 +3730,6 @@ var PixodeskAnimator = (() => {
         if (pathChild.d !== void 0) pathChild.d = pathString(pathChild.d);
       }
     }
-    if (fx.animate && !((_a = pathChild.animate) == null ? void 0 : _a.d)) {
-      const animate = (_b = pathChild.animate) != null ? _b : {};
-      animate.d = fx.animate;
-      pathChild.animate = animate;
-    }
     ctx.defs.push({ type: "clipPath", id: clipId, children: [pathChild] });
     node.clipPath = "url(#" + clipId + ")";
     return node;
@@ -3520,12 +3740,12 @@ var PixodeskAnimator = (() => {
     return void 0;
   }
 
-  // ../svg-animator-core/src/effects/maskedByEffect.ts
+  // ../svg-animator-core/src/effects/clipping/maskedByEffect.ts
   function applyMaskedByEffect(node, fx, transformBy, ctx) {
     if (!fx) return node;
-    const sourceId = stripHash2(fx.sourceId);
+    const sourceId = stripHash2(fx.source);
     if (!sourceId) {
-      ctx.errors.push("maskedBy.sourceId missing \u2014 cannot build mask");
+      ctx.errors.push("maskedBy.source missing \u2014 cannot build mask");
       return node;
     }
     const maskId = genId(ctx, "mask");
@@ -3654,7 +3874,7 @@ var PixodeskAnimator = (() => {
       if (parts.origin) out.origin = parts.origin;
       return Object.keys(out).length ? out : void 0;
     }
-    if (node.transform && typeof node.transform === "object" && !node.transform.keyframes && !node.transform.kfs) {
+    if (node.transform && typeof node.transform === "object" && !node.transform.keyframes) {
       const wrapped = node.transform.value;
       const value = wrapped && typeof wrapped === "object" ? wrapped : node.transform;
       if (value && typeof value === "object") {
@@ -3800,7 +4020,7 @@ var PixodeskAnimator = (() => {
     const interestingNodes = /* @__PURE__ */ new Set();
     const collectInterestingNodes = (n) => {
       var _a, _b;
-      const maskSourceId = stripHash2((_b = (_a = n.effects) == null ? void 0 : _a.maskedBy) == null ? void 0 : _b.sourceId);
+      const maskSourceId = stripHash2((_b = (_a = n.effects) == null ? void 0 : _a.maskedBy) == null ? void 0 : _b.source);
       if (typeof maskSourceId === "string") {
         interestingNodes.add(n);
         const sourceNode = ctx.idMap.get(maskSourceId);
@@ -3829,7 +4049,7 @@ var PixodeskAnimator = (() => {
     if (typeof tr === "string") {
       const parts = parseTranslateOnlyFromString(tr, ctx);
       if (parts) out.translate = parts;
-    } else if (tr && typeof tr === "object" && !tr.keyframes && !tr.kfs) {
+    } else if (tr && typeof tr === "object" && !tr.keyframes) {
       const wrapped = tr.value;
       const value = wrapped && typeof wrapped === "object" ? wrapped : tr;
       if (value && typeof value === "object" && Array.isArray(value.translate)) {
@@ -3877,16 +4097,15 @@ var PixodeskAnimator = (() => {
     return seen ? [x, y] : void 0;
   }
 
-  // ../svg-animator-core/src/effects/refEffect.ts
-  var CONTENT_SUBREF = "content";
+  // ../svg-animator-core/src/effects/reference/refEffect.ts
   function applyRefHref(node, clone2, ctx) {
     if (!clone2) return;
-    const sourceId = stripHash2(clone2.sourceId);
+    const sourceId = stripHash2(clone2.source);
     if (!sourceId) {
-      if (clone2.type === CONTENT_SUBREF) ctx.errors.push("clone: content ref missing sourceId");
+      if (clone2.without === PxCloneWithout.translate) ctx.errors.push("clone: content ref missing `source`");
       return;
     }
-    const targetId = clone2.type === CONTENT_SUBREF ? ctx.contentRefInnerIds.get(sourceId) || sourceId : sourceId;
+    const targetId = clone2.without === PxCloneWithout.translate ? ctx.contentRefInnerIds.get(sourceId) || sourceId : sourceId;
     node.href = "#" + targetId;
   }
   function applyRefAndTransformationEffect(node, clone2, transformBy, ctx) {
@@ -3894,7 +4113,7 @@ var PixodeskAnimator = (() => {
     return applyTransformByEffect(node, transformBy, ctx);
   }
 
-  // ../svg-animator-core/src/effects/repeaterEffect.ts
+  // ../svg-animator-core/src/effects/transform/repeaterEffect.ts
   function applyRepeaterEffect(node, fx, ctx) {
     var _a, _b;
     if (!fx) return node;
@@ -3965,7 +4184,7 @@ var PixodeskAnimator = (() => {
     return mapAnimatable(raw, scalePower, true);
   }
 
-  // ../svg-animator-core/src/effects/retimeEffect.ts
+  // ../svg-animator-core/src/effects/reference/retimeEffect.ts
   var RETIME_MATERIALISATION_MODE_INLINE_G = false;
   function asRetime(r) {
     var _a, _b;
@@ -4148,7 +4367,7 @@ var PixodeskAnimator = (() => {
     }
   }
 
-  // ../svg-animator-core/src/effects/pathSampler.ts
+  // ../svg-animator-core/src/effects/text/pathSampler.ts
   var LUT_STEPS = 48;
   var CMD_RE = /[MmLlHhVvCcSsQqTtAaZz]/;
   function tokenize(d) {
@@ -4296,7 +4515,7 @@ var PixodeskAnimator = (() => {
     };
   }
 
-  // ../svg-animator-core/src/effects/textPathEffect.ts
+  // ../svg-animator-core/src/effects/text/textPathEffect.ts
   var EXTEND_MARGIN_FRAC = 0.15;
   function numRange(v) {
     const read = readAnimatable(v);
@@ -4364,9 +4583,9 @@ var PixodeskAnimator = (() => {
   }
   function applyTextPathEffect(node, fx, ctx) {
     var _a;
-    if (!fx || typeof fx.path !== "string" || !fx.path) return node;
+    if (!fx || typeof fx.pathData !== "string" || !fx.pathData) return node;
     const pathId = genId(ctx, "tpath");
-    const { d, startShift } = extendedPathForBrowser(fx.path, {
+    const { d, startShift } = extendedPathForBrowser(fx.pathData, {
       pathOverflow: fx.pathOverflow,
       startOffset: fx.startOffset,
       textLength: fx.textLength,
@@ -4391,7 +4610,7 @@ var PixodeskAnimator = (() => {
     writeAnimatableChannel(node, attrName, readAnimatable(raw), { asString: true });
   }
 
-  // ../svg-animator-core/src/effects/elementFactory.ts
+  // ../svg-animator-core/src/effects/text/elementFactory.ts
   var jsonElementFactory = (type, props, children) => {
     const node = { type };
     for (const k in props) if (props[k] !== void 0) node[k] = props[k];
@@ -4400,7 +4619,7 @@ var PixodeskAnimator = (() => {
     return node;
   };
 
-  // ../svg-animator-core/src/effects/glyphPathBake.ts
+  // ../svg-animator-core/src/effects/text/glyphPathBake.ts
   function fmt(v, decimals) {
     return Math.round(v) === v ? "" + Math.round(v) : v.toFixed(decimals);
   }
@@ -4446,7 +4665,7 @@ var PixodeskAnimator = (() => {
     return out;
   }
 
-  // ../svg-animator-core/src/effects/textGlyphsEffect.ts
+  // ../svg-animator-core/src/effects/text/textGlyphsEffect.ts
   var DEFAULT_FONT_SIZE = 16;
   var TEXT_ATTR_KEYS = [
     "fontFamily",
@@ -4825,7 +5044,7 @@ var PixodeskAnimator = (() => {
     return p;
   }
   function missingGlyphProps(isMissing) {
-    return isMissing ? { class: MISSING_GLYPH_CLASS_NAME } : {};
+    return isMissing ? { [CLASS_ATTR]: MISSING_GLYPH_CLASS_NAME } : {};
   }
   function buildPaths(placements, create, warnings) {
     if (!placements.length) {
@@ -4865,20 +5084,20 @@ var PixodeskAnimator = (() => {
   function applyTextGlyphsEffect(node, fx, ctx) {
     if (!(fx == null ? void 0 : fx.useGlyphs)) return node;
     if (!ctx.glyphs) {
-      ctx.warnings.push("textGlyphs: no definitions.glyphs \u2014 left as native <text>");
+      ctx.warnings.push("textGlyphs: no definitions.fonts \u2014 left as native <text>");
       return node;
     }
     return materialiseGlyphTextHorizontal(node, { glyphs: ctx.glyphs, warnings: ctx.warnings });
   }
   function applyTextGlyphsAlongPath(node, ctx, pathD, startOffset, textLength, pathOverflow) {
     if (!ctx.glyphs) {
-      ctx.warnings.push("textGlyphs: no definitions.glyphs");
+      ctx.warnings.push("textGlyphs: no definitions.fonts");
       return null;
     }
     return materialiseGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
   }
 
-  // ../svg-animator-core/src/effects/strokeTrimEffect.ts
+  // ../svg-animator-core/src/effects/stroke/strokeTrimEffect.ts
   function applyStrokeTrimEffect(node, strokeTrim, ctx) {
     if (!strokeTrim) return node;
     const combined = strokeTrim.subPaths === PxStrokeTrimSubPaths.combined;
@@ -5014,12 +5233,11 @@ var PixodeskAnimator = (() => {
     ];
   }
   function readScalarValues(r) {
-    var _a;
     if (r.kind === "absent" /* Absent */) return [];
     if (r.kind === "static" /* Static */) return [r.value];
     const out = [];
     for (const kf of r.keyframes) {
-      const v = (_a = kf.value) != null ? _a : kf.v;
+      const v = kfValue(kf);
       if (typeof v === "number") out.push(v);
     }
     return out;
@@ -5029,14 +5247,11 @@ var PixodeskAnimator = (() => {
     if (read.kind === "static" /* Static */) return { kind: "static" /* Static */, value: map(read.value) };
     return {
       kind: "animated" /* Animated */,
-      keyframes: read.keyframes.map((kf) => {
-        var _a, _b, _c, _d;
-        return {
-          time: (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0,
-          value: map((_c = kf.value) != null ? _c : kf.v),
-          easing: (_d = kf.easing) != null ? _d : kf.e
-        };
-      }),
+      keyframes: read.keyframes.map((kf) => ({
+        time: kfTime(kf),
+        value: map(kfValue(kf)),
+        easing: kfEasing(kf)
+      })),
       loop: read.loop
     };
   }
@@ -5046,7 +5261,6 @@ var PixodeskAnimator = (() => {
   }
   var OPACITY_STEP_MS = 10;
   function computeOpacityFromRange(rangeRead) {
-    var _a, _b, _c, _d, _e, _f;
     const hide = (v) => v[0] === v[1];
     if (rangeRead.kind === "absent" /* Absent */) return void 0;
     if (rangeRead.kind === "static" /* Static */) return hide(rangeRead.value) ? { kind: "static" /* Static */, value: 0 } : void 0;
@@ -5054,7 +5268,7 @@ var PixodeskAnimator = (() => {
     let anyHide = false;
     let allHide = true;
     for (const kf of kfs) {
-      if (hide((_a = kf.value) != null ? _a : kf.v)) anyHide = true;
+      if (hide(kfValue(kf))) anyHide = true;
       else allHide = false;
     }
     if (!anyHide) return void 0;
@@ -5064,10 +5278,10 @@ var PixodeskAnimator = (() => {
       const kf = kfs[i];
       const prevKf = i > 0 ? kfs[i - 1] : void 0;
       const nextKf = i < kfs.length - 1 ? kfs[i + 1] : void 0;
-      const t = (_c = (_b = kf.time) != null ? _b : kf.t) != null ? _c : 0;
-      const thisHide = hide((_d = kf.value) != null ? _d : kf.v);
-      const prevHide = prevKf ? thisHide && hide((_e = prevKf.value) != null ? _e : prevKf.v) : thisHide;
-      const nextHide = nextKf ? thisHide && hide((_f = nextKf.value) != null ? _f : nextKf.v) : thisHide;
+      const t = kfTime(kf);
+      const thisHide = hide(kfValue(kf));
+      const prevHide = prevKf ? thisHide && hide(kfValue(prevKf)) : thisHide;
+      const nextHide = nextKf ? thisHide && hide(kfValue(nextKf)) : thisHide;
       if (prevHide && !nextHide) {
         out.push({ time: t, value: 0 });
         out.push({ time: t + OPACITY_STEP_MS, value: 1 });
@@ -5082,14 +5296,11 @@ var PixodeskAnimator = (() => {
   function readRangeWithCrossings(raw) {
     const r = readAnimatable(raw);
     if (r.kind !== "animated" /* Animated */) return r;
-    const kfs = r.keyframes.map((kf) => {
-      var _a, _b, _c, _d;
-      return {
-        time: (_b = (_a = kf.time) != null ? _a : kf.t) != null ? _b : 0,
-        value: (_c = kf.value) != null ? _c : kf.v,
-        easing: (_d = kf.easing) != null ? _d : kf.e
-      };
-    });
+    const kfs = r.keyframes.map((kf) => ({
+      time: kfTime(kf),
+      value: kfValue(kf),
+      easing: kfEasing(kf)
+    }));
     const hasReverse = kfs.some((kf) => kf.value[0] > kf.value[1]);
     if (!hasReverse) {
       return {
@@ -5228,8 +5439,8 @@ var PixodeskAnimator = (() => {
       maskAncestorChains: /* @__PURE__ */ new Map(),
       // Resolved engine: `frames` ONLY when explicitly set; auto/waapi/unset →
       // waapi (we're not 100% sure it's frames, and CSS/WAAPI need the inline form).
-      engine: ((_a = getAnimatorConfig(root)) == null ? void 0 : _a.mode) === PxAnimatorMode.frames ? PxAnimatorEngine.frames : PxAnimatorEngine.waapi,
-      glyphs: (_b = getDefs(root)) == null ? void 0 : _b.glyphs
+      engine: resolveTimelineEngine((_a = getAnimatorConfig(root)) == null ? void 0 : _a.engine),
+      glyphs: (_b = getDefs(root)) == null ? void 0 : _b.fonts
     };
     const working = clone(root);
     indexById(working, ctx.idMap);
@@ -5252,7 +5463,7 @@ var PixodeskAnimator = (() => {
     let consumedByGlyphs = false;
     if (text == null ? void 0 : text.useGlyphs) {
       if (textPath) {
-        const pathD = typeof textPath.path === "string" ? textPath.path : void 0;
+        const pathD = typeof textPath.pathData === "string" ? textPath.pathData : void 0;
         const glyphed = applyTextGlyphsAlongPath(n, ctx, pathD, textPath.startOffset, textPath.textLength, textPath.pathOverflow);
         if (glyphed) {
           n = glyphed;
@@ -5285,27 +5496,7 @@ var PixodeskAnimator = (() => {
     return node;
   }
 
-  // ../svg-animator-core/src/PxOffsetPathMaterialiser.ts
-  var kfTime = (kf) => {
-    var _a, _b;
-    return (_b = (_a = kf.t) != null ? _a : kf.time) != null ? _b : 0;
-  };
-  var kfValue = (kf) => {
-    var _a;
-    return (_a = kf.v) != null ? _a : kf.value;
-  };
-  var kfEasing = (kf) => {
-    var _a;
-    return (_a = kf.e) != null ? _a : kf.easing;
-  };
-  var kfTangentIn = (kf) => {
-    var _a;
-    return (_a = kf.tangentIn) != null ? _a : kf.ti;
-  };
-  var kfTangentOut = (kf) => {
-    var _a;
-    return (_a = kf.tangentOut) != null ? _a : kf.to;
-  };
+  // ../svg-animator-core/src/materialise/PxOffsetPathMaterialiser.ts
   function cubicAt(p0, c1, c2, p1, t) {
     const u = 1 - t;
     const a = u * u * u, b = 3 * u * u * t, c = 3 * u * t * t, d = t * t * t;
@@ -5329,9 +5520,9 @@ var PixodeskAnimator = (() => {
     return Object.is(r, -0) ? "0" : String(r);
   };
   function buildOffsetPath(propAnim) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     if (propAnim.alongPathMode !== "offsetPath") return void 0;
-    const kfs = (_a = propAnim.keyframes) != null ? _a : propAnim.kfs;
+    const kfs = propAnim.keyframes;
     if (!kfs || kfs.length < 2) return void 0;
     const first = kfValue(kfs[0]);
     const anchor = (first == null ? void 0 : first.origin) && first.origin.length >= 2 ? [first.origin[0], first.origin[1]] : [0, 0];
@@ -5342,7 +5533,7 @@ var PixodeskAnimator = (() => {
       if (!tr || tr.length < 2) return void 0;
       const parts = Object.keys(v);
       if (parts.some((p) => p !== "translate" && p !== "origin")) return void 0;
-      const o = (_b = v == null ? void 0 : v.origin) != null ? _b : [0, 0];
+      const o = (_a = v == null ? void 0 : v.origin) != null ? _a : [0, 0];
       if (o[0] !== anchor[0] || o[1] !== anchor[1]) return void 0;
       points.push([tr[0] + anchor[0], tr[1] + anchor[1]]);
     }
@@ -5351,8 +5542,8 @@ var PixodeskAnimator = (() => {
     const segLens = [];
     for (let i = 0; i < points.length - 1; i++) {
       const p0 = points[i], p1 = points[i + 1];
-      const to = (_c = kfTangentOut(kfs[i])) != null ? _c : [0, 0];
-      const ti = (_d = kfTangentIn(kfs[i + 1])) != null ? _d : [0, 0];
+      const to = (_b = kfTangentOut(kfs[i])) != null ? _b : [0, 0];
+      const ti = (_c = kfTangentIn(kfs[i + 1])) != null ? _c : [0, 0];
       const c1 = [p0[0] + to[0], p0[1] + to[1]];
       const c2 = [p1[0] + ti[0], p1[1] + ti[1]];
       d += "C" + fmt2(c1[0]) + "," + fmt2(c1[1]) + "," + fmt2(c2[0]) + "," + fmt2(c2[1]) + "," + fmt2(p1[0]) + "," + fmt2(p1[1]);
@@ -5381,16 +5572,16 @@ var PixodeskAnimator = (() => {
         const built = buildOffsetPath(transform);
         if (built) {
           const newAnimate = __spreadValues({}, anim);
-          delete newAnimate["transform"];
+          delete newAnimate[TRANSFORM_ATTR];
           const distance = { keyframes: built.distanceKfs };
           if (transform.loop !== void 0) distance.loop = transform.loop;
-          newAnimate["offsetDistance"] = distance;
+          newAnimate[OFFSET_DISTANCE_ATTR] = distance;
           const staticTr = node.transform;
           let newTransform = staticTr;
           if (staticTr && typeof staticTr === "object") {
             const t = __spreadValues({}, staticTr);
-            delete t["translate"];
-            delete t["origin"];
+            delete t[TRANSFORM_PART.translate];
+            delete t[TRANSFORM_PART.origin];
             newTransform = Object.keys(t).length ? t : void 0;
           }
           out = __spreadProps(__spreadValues({}, node), {
@@ -5415,14 +5606,14 @@ var PixodeskAnimator = (() => {
     return walk(root);
   }
 
-  // ../svg-animator-core/src/PxAnimatorMaterialiseAll.ts
+  // ../svg-animator-core/src/materialise/PxAnimatorMaterialiseAll.ts
   function materialiseAllInTree(doc, engine, opts) {
     var _a, _b;
     let root = applyPlayerEffects(doc).root;
     root = materialiseOffsetPathsInTree(root);
     const duration = (_b = (_a = getAnimatorConfig(root)) == null ? void 0 : _a.duration) != null ? _b : DEFAULT_DURATION_MS;
     root = materialiseInternalLoopsInTree(root, duration);
-    if (engine === PxAnimatorEngine.waapi) {
+    if (engine === PxTimelineEngine.native) {
       root = materialiseMotionPathsInTree(root, opts == null ? void 0 : opts.motionPath);
       root = materialiseAnimatedUseInstances(root);
       root = pruneUnreferencedDefs(root);
@@ -5459,7 +5650,7 @@ var PixodeskAnimator = (() => {
     return root;
   }
 
-  // ../svg-animator-core/src/PxFrameLoop.ts
+  // ../svg-animator-core/src/playback/PxFrameLoop.ts
   function requestFrame(cb) {
     const g = globalThis;
     if (typeof g.requestAnimationFrame === "function") return g.requestAnimationFrame(cb);
@@ -5476,7 +5667,7 @@ var PixodeskAnimator = (() => {
   function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
     var _a;
     const config = getAnimatorConfig(doc) || {};
-    const bindings = getNormalisedBindings(doc, PxAnimatorEngine.frames);
+    const bindings = getNormalisedBindings(doc, PxTimelineEngine.js);
     const _iterations = config.iterations;
     let iterations = 1;
     if (typeof _iterations === "number") iterations = _iterations || 1;
@@ -5737,7 +5928,194 @@ var PixodeskAnimator = (() => {
     return api;
   }
 
-  // src/PxAnimatorTriggers.ts
+  // ../svg-animator-core/src/playback/PxAnimatorConfigPatch.ts
+  var FLAT_ONLY_KEYS = [
+    "timelineSource",
+    "scroll",
+    "trigger",
+    "delay",
+    "iterations",
+    "direction",
+    "fill",
+    "resetOnFinish",
+    "duration",
+    "mode",
+    "frameRate"
+  ];
+  var CONTENT_KEYS = ["definitions", "animateById"];
+  var isPlainObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+  var timelineTypeOf = (t) => isPlainObject(t) && typeof t.type === "string" ? t.type : "time";
+  var isScrollish = (type) => type === "scroll" || type === "view";
+  function mergePlain(base, patch) {
+    const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+    for (const key of Object.keys(patch)) {
+      const value = patch[key];
+      if (value === null) {
+        delete out[key];
+        continue;
+      }
+      if (isPlainObject(value)) {
+        out[key] = mergePlain(out[key], value);
+        continue;
+      }
+      out[key] = value;
+    }
+    return out;
+  }
+  function mergeTimeline(base, patch, warn) {
+    const baseType = timelineTypeOf(base);
+    const patchNamesType = isPlainObject(patch) && typeof patch.type === "string";
+    const patchType = patchNamesType ? String(patch.type) : baseType;
+    let merged;
+    if (patchType !== baseType) {
+      const carried = {};
+      if (isPlainObject(base)) {
+        for (const k of PX_TIMELINE_SHARED_KEYS) {
+          if (base[k] !== void 0) carried[k] = base[k];
+        }
+      }
+      merged = mergePlain(carried, patch);
+    } else {
+      merged = mergePlain(base, patch);
+    }
+    if (isScrollish(patchType)) {
+      for (const k of PX_TIME_ONLY_TIMELINE_KEYS) {
+        if (merged[k] === void 0) continue;
+        warn("animator.timeline." + k + ": no slot on a '" + patchType + "' timeline \u2014 dropped");
+        delete merged[k];
+      }
+      if (merged.iterations === "infinite") {
+        warn("animator.timeline.iterations: 'infinite' cannot map onto a scroll range \u2014 dropped");
+        delete merged.iterations;
+      }
+    }
+    return merged;
+  }
+  function foldAnimatorConfigShortcuts(config, shortcuts) {
+    let base;
+    if (typeof config === "string") {
+      try {
+        base = JSON.parse(config);
+      } catch (e) {
+        console.warn("animator config: not valid JSON \u2014 ignored", e);
+        base = void 0;
+      }
+    } else {
+      base = config != null ? config : void 0;
+    }
+    const { duration, delay, iterations, startOn } = shortcuts;
+    if (duration === void 0 && delay === void 0 && iterations === void 0 && startOn === void 0) {
+      return base;
+    }
+    const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+    const timeline = __spreadValues({}, out.timeline);
+    if (duration !== void 0) timeline.duration = duration;
+    if (delay !== void 0) timeline.delay = delay;
+    if (iterations !== void 0) timeline.iterations = iterations;
+    if (startOn !== void 0) {
+      timeline.trigger = __spreadProps(__spreadValues({}, timeline.trigger), { startOn });
+    }
+    out.timeline = timeline;
+    return out;
+  }
+  function mergeAnimatorConfig(base, patch) {
+    const warnings = [];
+    const warn = (m) => warnings.push(m);
+    if (patch === null) return { config: void 0, warnings };
+    if (!isPlainObject(patch) || Object.keys(patch).length === 0) {
+      return { config: base, warnings };
+    }
+    const flatInBase = isPlainObject(base) ? FLAT_ONLY_KEYS.filter((k) => base[k] !== void 0) : [];
+    if (flatInBase.length) {
+      warn("animator: the base carries the flat runtime spelling (" + flatInBase.join(", ") + "); the patch merges the wire spelling only");
+    }
+    const out = isPlainObject(base) ? __spreadValues({}, base) : {};
+    for (const key of Object.keys(patch)) {
+      const value = patch[key];
+      if (value === null) {
+        delete out[key];
+        continue;
+      }
+      if (key === "timeline") {
+        out.timeline = isPlainObject(value) ? mergeTimeline(out.timeline, value, warn) : value;
+        continue;
+      }
+      if (isPlainObject(value)) {
+        out[key] = mergePlain(out[key], value);
+        continue;
+      }
+      out[key] = value;
+    }
+    return { config: out, warnings };
+  }
+  function applyAnimatorConfig(doc, patch, opts) {
+    var _a, _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((_a = anyDoc.meta) == null ? void 0 : _a.animator);
+    const current = atRoot ? anyDoc.animator : atMeta ? anyDoc.meta.animator : void 0;
+    const warnings = [];
+    if (atRoot && isPlainObject((_b = anyDoc.meta) == null ? void 0 : _b.animator)) {
+      warnings.push("animator: doc.meta.animator is shadowed by doc.animator and was not patched");
+    }
+    let base = current;
+    if (reset) {
+      const kept = {};
+      for (const k of CONTENT_KEYS) {
+        if (isPlainObject(current) && current[k] !== void 0) kept[k] = current[k];
+      }
+      base = kept;
+    }
+    const merged = mergeAnimatorConfig(base, patch != null ? patch : {});
+    warnings.push(...merged.warnings);
+    if (merged.config === current) return { doc, warnings };
+    if (atMeta) {
+      return {
+        doc: __spreadProps(__spreadValues({}, anyDoc), { meta: __spreadProps(__spreadValues({}, anyDoc.meta), { animator: merged.config }) }),
+        warnings
+      };
+    }
+    return { doc: __spreadProps(__spreadValues({}, anyDoc), { animator: merged.config }), warnings };
+  }
+
+  // ../svg-animator-core/src/format/PxDocumentDiagnostic.ts
+  var MAX_REPORTED = 6;
+  var LEGACY_FLAT_KEYS = [
+    ...PX_TIMELINE_SHARED_KEYS,
+    ...PX_TIME_ONLY_TIMELINE_KEYS,
+    "fill",
+    "resetOnFinish",
+    "timelineSource",
+    "scroll"
+  ];
+  var isLegacyFlatAnimatorKey = (w) => LEGACY_FLAT_KEYS.some((k) => w.indexOf("animator." + k + ":") >= 0);
+  function diagnoseDocument(doc) {
+    let all;
+    try {
+      all = validateDocument(doc);
+    } catch (e) {
+      return { problems: [], legacy: [] };
+    }
+    const problems = [];
+    const legacy = [];
+    for (const w of all) (isLegacyFlatAnimatorKey(w) ? legacy : problems).push(w);
+    return { problems, legacy };
+  }
+  function reportDocumentDiagnostics(doc, where) {
+    const { problems } = diagnoseDocument(doc);
+    if (!problems.length) return;
+    const shown = problems.slice(0, MAX_REPORTED);
+    const more = problems.length - shown.length;
+    console.warn(
+      where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
+    );
+  }
+
+  // src/triggers/PxAnimatorTriggers.ts
   function setupAnimationTriggers(api, config) {
     const { startOn, outAction = "continue", scrollIntoViewThreshold = 0 } = config;
     const root = api.getRootElement();
@@ -5842,7 +6220,7 @@ var PixodeskAnimator = (() => {
     return api;
   }
 
-  // src/PxAnimatorFrameLoop.ts
+  // src/engines/PxAnimatorFrameLoop.ts
   function getSelector(id) {
     return "#" + id;
   }
@@ -5902,11 +6280,10 @@ var PixodeskAnimator = (() => {
     return adapter;
   }
 
-  // src/PxAnimatorWebApi.ts
+  // src/engines/PxAnimatorWebApi.ts
   function createCssKf(kf, t, propName, unsupportedSet) {
-    var _a, _b;
-    let value = (_a = kf.v) != null ? _a : kf.value;
-    const e = (_b = kf.e) != null ? _b : kf.easing;
+    let value = kfValue(kf);
+    const e = kfEasing(kf);
     const cssKf = {
       offset: t,
       easing: e && Array.isArray(e) ? "cubic-bezier(" + e.join(",") + ")" : void 0
@@ -5977,7 +6354,7 @@ var PixodeskAnimator = (() => {
     const result = /* @__PURE__ */ new Map();
     for (const [propName, propAnim] of Object.entries(animDef)) {
       const duration = config.duration || 1;
-      const clippedKeyframes = clipKeyframesToDuration(propName, propAnim.kfs || propAnim.keyframes || [], duration);
+      const clippedKeyframes = clipKeyframesToDuration(propName, propAnim.keyframes || [], duration);
       const cssKeyframes = [];
       for (let i = 0; i < clippedKeyframes.length; i++) {
         const kf = clippedKeyframes[i];
@@ -6011,7 +6388,7 @@ var PixodeskAnimator = (() => {
         console.warn("createFrameLoopAnimator: No root element provided");
       }
     }
-    const bindings = getNormalisedBindings(doc, PxAnimatorEngine.waapi);
+    const bindings = getNormalisedBindings(doc, PxTimelineEngine.native);
     const animations = [];
     const _iterations = config.iterations;
     let iterations;
@@ -6169,7 +6546,7 @@ var PixodeskAnimator = (() => {
     return api;
   }
 
-  // src/PxScrollDriver.ts
+  // src/scroll/PxScrollDriver.ts
   function nativeRangeOffset(point, defaultFraction, view) {
     var _a, _b, _c;
     const fraction = typeof (point == null ? void 0 : point.fraction) === "number" ? point.fraction : defaultFraction;
@@ -6183,7 +6560,7 @@ var PixodeskAnimator = (() => {
     const scroll = config.scroll || {};
     const kind = (_a = scroll.kind) != null ? _a : "view";
     if (scroll.smoothing) {
-      console.warn('scroll timeline: `smoothing` needs the built-in driver \u2014 ignoring `driver: "native"`');
+      console.warn("scroll timeline: `smoothing` needs the built-in driver \u2014 using the built-in driver instead of the browser timeline");
       return null;
     }
     const g = globalThis;
@@ -6200,7 +6577,7 @@ var PixodeskAnimator = (() => {
         timeline = new Ctor({ source, axis });
       }
     } catch (e) {
-      console.warn("scroll timeline: native timeline construction failed \u2014 falling back to the custom driver", e);
+      console.warn("scroll timeline: native timeline construction failed \u2014 falling back to the player measuring progress itself", e);
       return null;
     }
     return {
@@ -6419,7 +6796,7 @@ var PixodeskAnimator = (() => {
     };
   }
 
-  // src/PxAnimatorBind.ts
+  // src/engines/PxAnimatorBind.ts
   function finaliseAnimator(animatorConfig, callbacks, make) {
     let apiRef;
     let effectiveCallbacks = callbacks;
@@ -6434,8 +6811,8 @@ var PixodeskAnimator = (() => {
     }
     const res = make(effectiveCallbacks);
     apiRef = res;
-    if (animatorConfig.debugInstName) {
-      window[animatorConfig.debugInstName] = res;
+    if (animatorConfig.debugGlobalName) {
+      window[animatorConfig.debugGlobalName] = res;
     }
     return res;
   }
@@ -6443,10 +6820,10 @@ var PixodeskAnimator = (() => {
     const animatorConfig = getAnimatorConfig(doc) || {};
     if (isScrollTimeline(animatorConfig)) {
       return finaliseAnimator(animatorConfig, callbacks, (cb) => {
-        var _a, _b;
+        var _a;
         let unpin = () => {
         };
-        if (animatorConfig.mode !== PxAnimatorMode.frames && ((_a = animatorConfig.scroll) == null ? void 0 : _a.driver) === "native" && rootElement) {
+        if (mayUseNativeScrollTimeline(animatorConfig.engine) && rootElement) {
           unpin = applyScrollPin(rootElement, animatorConfig.scroll);
           const native = createNativeScrollTimeline(rootElement, animatorConfig);
           if (native) {
@@ -6454,7 +6831,7 @@ var PixodeskAnimator = (() => {
               doc,
               cb,
               rootElement,
-              animatorConfig.mode === PxAnimatorMode.waapi,
+              isNativeForced(animatorConfig.engine),
               native
             );
             if (api2) {
@@ -6470,8 +6847,8 @@ var PixodeskAnimator = (() => {
           unpin = () => {
           };
         }
-        const api = (animatorConfig.mode !== PxAnimatorMode.frames ? createWebApiAnimator(doc, cb, rootElement, animatorConfig.mode === PxAnimatorMode.waapi) : null) || createFrameLoopAnimator(doc, adapter, cb, rootElement);
-        const subject = ((_b = api.getRootElement) == null ? void 0 : _b.call(api)) || rootElement;
+        const api = (animatorConfig.engine !== PxTimelineEngineExtra.js ? createWebApiAnimator(doc, cb, rootElement, isNativeForced(animatorConfig.engine)) : null) || createFrameLoopAnimator(doc, adapter, cb, rootElement);
+        const subject = ((_a = api.getRootElement) == null ? void 0 : _a.call(api)) || rootElement;
         if (subject) {
           unpin = applyScrollPin(subject, animatorConfig.scroll);
           const totalMs = scrollTotalDurationMs(animatorConfig);
@@ -6495,20 +6872,19 @@ var PixodeskAnimator = (() => {
       });
     }
     return finaliseAnimator(animatorConfig, callbacks, (cb) => {
-      if (animatorConfig.mode === PxAnimatorMode.frames) {
+      if (animatorConfig.engine === PxTimelineEngineExtra.js) {
         return createFrameLoopAnimator(doc, adapter, cb, rootElement);
       }
       return createWebApiAnimator(
         doc,
         cb,
         rootElement,
-        animatorConfig.mode === PxAnimatorMode.waapi
-        // forcing waapi
+        isNativeForced(animatorConfig.engine)
       ) || createFrameLoopAnimator(doc, adapter, cb, rootElement);
     });
   }
 
-  // src/PxAnimatorDOM.ts
+  // src/dom/PxAnimatorDOM.ts
   var SVG_NS = "http://www.w3.org/2000/svg";
   function createElement(tagName, normalisedProps, style, children, textContent) {
     if (DISALLOWED_SVG_TAGS_LOWER.has(tagName.toLowerCase())) {
@@ -6566,18 +6942,24 @@ var PixodeskAnimator = (() => {
     return element;
   }
 
-  // src/PxAnimatorKeys.ts
+  // src/shared/PxAnimatorKeys.ts
   var PX_ANIMATOR_DATA_KEY = "data";
 
-  // src/PxAnimator.ts
+  // src/animator/PxAnimator.ts
   function createAnimatorFromConfig(doc, adapter, callbacks, rootElement) {
     return bindWithEngineChoice(doc, adapter, callbacks, rootElement);
   }
-  function createAnimatorImpl(doc, adapter, callbacks, containerElement) {
+  function createAnimatorImpl(doc, adapter, callbacks, containerElement, config, resetDocDefaults) {
     const effectsWarnings = validateNodeEffects(doc);
     for (const w of effectsWarnings) console.warn("[PxAnimator] effects shape warning:", w);
+    reportDocumentDiagnostics(doc, "[PxAnimator] createAnimator");
+    if (config !== void 0 || resetDocDefaults) {
+      const patched = applyAnimatorConfig(doc, config != null ? config : {}, { resetDefaults: !!resetDocDefaults });
+      for (const w of patched.warnings) console.warn("[PxAnimator] config override:", w);
+      doc = patched.doc;
+    }
     const animatorConfig = getAnimatorConfig(doc) || {};
-    const engine = animatorConfig.mode === PxAnimatorMode.frames ? PxAnimatorEngine.frames : PxAnimatorEngine.waapi;
+    const engine = resolveTimelineEngine(animatorConfig.engine);
     doc = materialiseAllInTree(doc, engine);
     let rootElement = null;
     if (containerElement) {
@@ -6590,10 +6972,24 @@ var PixodeskAnimator = (() => {
         }
       }
     }
-    return createAnimatorFromConfig(doc, adapter, callbacks, rootElement);
+    const api = createAnimatorFromConfig(doc, adapter, callbacks, rootElement);
+    if (containerElement && rootElement) {
+      const rendered = rootElement;
+      const destroyNative = api.destroy.bind(api);
+      api.destroy = () => {
+        destroyNative();
+        rendered.remove();
+      };
+    }
+    return api;
+  }
+  function resolveAnimatorConfigOption(options) {
+    const { config, duration, delay, iterations, startOn } = options;
+    return foldAnimatorConfigShortcuts(config, { duration, delay, iterations, startOn });
   }
   function createAnimator(options) {
-    const { src, data, adapter, callbacks, container } = options;
+    const { src, data, adapter, callbacks, container, resetDocDefaults } = options;
+    const config = resolveAnimatorConfigOption(options);
     if (data !== void 0 && src !== void 0) {
       throw new Error("createAnimator: provide either `src` or `data`, not both");
     }
@@ -6601,7 +6997,7 @@ var PixodeskAnimator = (() => {
       throw new Error("createAnimator: either `src` or `data` is required");
     }
     if (data !== void 0) {
-      return createAnimatorImpl(data, adapter, callbacks, container);
+      return createAnimatorImpl(data, adapter, callbacks, container, config, resetDocDefaults);
     }
     let animator = null;
     let pending = [];
@@ -6616,7 +7012,7 @@ var PixodeskAnimator = (() => {
     fetch(src).then((res) => res.json()).then((json) => {
       if (destroyed) return;
       if (isPxElementFileFormat(json)) {
-        animator = createAnimatorImpl(json, adapter, callbacks, container);
+        animator = createAnimatorImpl(json, adapter, callbacks, container, config, resetDocDefaults);
         const queued = pending;
         pending = null;
         queued == null ? void 0 : queued.forEach((call) => call(animator));
@@ -6676,4 +7072,4 @@ var PixodeskAnimator = (() => {
   }
   return __toCommonJS(index_player_exports);
 })();
-//# sourceMappingURL=index.umd.js.map
+//# sourceMappingURL=pixodesk-svg-animator.umd.js.map