@pixodesk/svg-animator-core 1.0.40 → 1.0.43

package/dist/{chunk-PAE3NF2U.js → chunk-BOTZI36B.js}

@@ -545,7 +545,7 @@ var px = {
    * The base can be the result of px.object() or px.openObject() — anything with a _shape property.
    *
    * @example
-   * const PxSvgNodeSchema = px.extendedObject(PxNodeBase, { width: px.number().optional() });
+   * const PxSvgNodeSchema = px.extendedObject(PxNodeBaseSchema, { width: px.number().optional() });
    */
   extendedObject: (base, extra) => new Obj(__spreadValues(__spreadValues({}, base._shape), extra)),
   /** Array whose unrecoverable items are filtered out. Default: []. */
@@ -563,20 +563,20 @@ var px = {
 };
 
 // src/version/PxSchemaVersion.ts
-var PX_PLAYER_SCHEMA_VERSION = "1.1";
+var PX_WIRE_SCHEMA_VERSION = "1.1";
 
 // src/version/PxWireVersion.ts
-var WIRE_VERSION_KEY = "version";
+var PX_WIRE_VERSION_KEY = "version";
 var ANIMATOR_KEY = "animator";
 var META_KEY = "meta";
-var WireVersionRelation = /* @__PURE__ */ ((WireVersionRelation2) => {
-  WireVersionRelation2["unstamped"] = "unstamped";
-  WireVersionRelation2["same"] = "same";
-  WireVersionRelation2["older"] = "older";
-  WireVersionRelation2["newer"] = "newer";
-  WireVersionRelation2["otherGeneration"] = "otherGeneration";
-  return WireVersionRelation2;
-})(WireVersionRelation || {});
+var PxWireVersionRelation = /* @__PURE__ */ ((PxWireVersionRelation2) => {
+  PxWireVersionRelation2["unstamped"] = "unstamped";
+  PxWireVersionRelation2["same"] = "same";
+  PxWireVersionRelation2["older"] = "older";
+  PxWireVersionRelation2["newer"] = "newer";
+  PxWireVersionRelation2["otherGeneration"] = "otherGeneration";
+  return PxWireVersionRelation2;
+})(PxWireVersionRelation || {});
 var VERSION_RE = /^(\d+)\.(\d+)(?:\.(\d+))?$/;
 function parseWireVersion(raw) {
   if (typeof raw !== "string") return void 0;
@@ -588,7 +588,7 @@ function formatWireVersion(v) {
   return v.a + "." + v.b + "." + v.c;
 }
 var _a;
-var PLAYER_WIRE_VERSION = (_a = parseWireVersion(PX_PLAYER_SCHEMA_VERSION)) != null ? _a : { a: 1, b: 1, c: 0 };
+var PX_WIRE_VERSION = (_a = parseWireVersion(PX_WIRE_SCHEMA_VERSION)) != null ? _a : { a: 1, b: 1, c: 0 };
 function getAnimatorBlock(doc) {
   if (!doc || typeof doc !== "object") return void 0;
   const atRoot = readObjectProp(doc, ANIMATOR_KEY);
@@ -602,7 +602,7 @@ function readObjectProp(obj, key) {
 }
 function readWireVersion(doc) {
   const animator = getAnimatorBlock(doc);
-  return animator ? parseWireVersion(animator[WIRE_VERSION_KEY]) : void 0;
+  return animator ? parseWireVersion(animator[PX_WIRE_VERSION_KEY]) : void 0;
 }
 function compareWireVersion(file, mine, readerReadsEditorPart) {
   if (!file) return "unstamped" /* unstamped */;
@@ -611,7 +611,7 @@ function compareWireVersion(file, mine, readerReadsEditorPart) {
   if (!readerReadsEditorPart || file.c === mine.c) return "same" /* same */;
   return file.c > mine.c ? "newer" /* newer */ : "older" /* older */;
 }
-function versionAdvice(relation, file, mine, isPlayer) {
+function wireVersionAdvice(relation, file, mine, isPlayer) {
   if (!file) return void 0;
   const target = isPlayer ? "player" : "editor";
   const gap = "written for schema " + formatWireVersion(file) + ", this " + target + " reads " + formatWireVersion(mine);
@@ -626,13 +626,13 @@ function versionAdvice(relation, file, mine, isPlayer) {
       return void 0;
   }
 }
-var WireStepKind = /* @__PURE__ */ ((WireStepKind2) => {
-  WireStepKind2["additive"] = "additive";
-  WireStepKind2["converted"] = "converted";
-  return WireStepKind2;
-})(WireStepKind || {});
-var BASELINE_PLAYER_VERSION = "1.1";
-var PLAYER_WIRE_STEPS = [];
+var PxWireStepKind = /* @__PURE__ */ ((PxWireStepKind2) => {
+  PxWireStepKind2["additive"] = "additive";
+  PxWireStepKind2["converted"] = "converted";
+  return PxWireStepKind2;
+})(PxWireStepKind || {});
+var PX_WIRE_BASELINE_VERSION = "1.1";
+var PX_WIRE_STEPS = [];
 function applyWireSteps(doc, cfg) {
   const from = readWireVersion(doc);
   const relation = compareWireVersion(from, cfg.target, cfg.readerReadsEditorPart);
@@ -642,7 +642,7 @@ function applyWireSteps(doc, cfg) {
       from,
       relation,
       applied: [],
-      advice: versionAdvice(relation, from, cfg.target, !cfg.readerReadsEditorPart)
+      advice: wireVersionAdvice(relation, from, cfg.target, !cfg.readerReadsEditorPart)
     };
   }
   const due = [];
@@ -668,10 +668,10 @@ function applyWireSteps(doc, cfg) {
   stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
   return { doc: target, from, relation, applied };
 }
-function convertPlayerDocument(doc) {
+function convertWireDocument(doc) {
   return applyWireSteps(doc, {
-    steps: PLAYER_WIRE_STEPS,
-    target: PLAYER_WIRE_VERSION,
+    steps: PX_WIRE_STEPS,
+    target: PX_WIRE_VERSION,
     readerReadsEditorPart: false
   });
 }
@@ -682,8 +682,8 @@ function clonePlain(value) {
 function stampVersion(doc, target, readerReadsEditorPart) {
   const animator = getAnimatorBlock(doc);
   if (!animator) return;
-  const previous = parseWireVersion(animator[WIRE_VERSION_KEY]);
-  animator[WIRE_VERSION_KEY] = formatWireVersion({
+  const previous = parseWireVersion(animator[PX_WIRE_VERSION_KEY]);
+  animator[PX_WIRE_VERSION_KEY] = formatWireVersion({
     a: target.a,
     b: target.b,
     c: readerReadsEditorPart ? target.c : previous ? previous.c : 0
@@ -738,8 +738,8 @@ function applyWireStepsDown(doc, cfg) {
   stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
   return { ok: true, doc: target, applied };
 }
-function downgradePlayerDocument(doc, target) {
-  return applyWireStepsDown(doc, { steps: PLAYER_WIRE_STEPS, target, readerReadsEditorPart: false });
+function downgradeWireDocument(doc, target) {
+  return applyWireStepsDown(doc, { steps: PX_WIRE_STEPS, target, readerReadsEditorPart: false });
 }
 
 // src/format/PxAnimatorConstants.ts
@@ -819,17 +819,17 @@ var PxTimelineEngine = {
   native: "native",
   js: "js"
 };
-var PxTimelineEngineExtra = __spreadProps(__spreadValues({}, PxTimelineEngine), {
+var PxTimelineEngineSetting = __spreadProps(__spreadValues({}, PxTimelineEngine), {
   auto: "auto"
 });
 function resolveTimelineEngine(engine) {
-  return engine === PxTimelineEngineExtra.js ? PxTimelineEngine.js : PxTimelineEngine.native;
+  return engine === PxTimelineEngineSetting.js ? PxTimelineEngine.js : PxTimelineEngine.native;
 }
 function isNativeForced(engine) {
-  return engine === PxTimelineEngineExtra.native;
+  return engine === PxTimelineEngineSetting.native;
 }
 function mayUseNativeScrollTimeline(engine) {
-  return engine !== PxTimelineEngineExtra.js;
+  return engine !== PxTimelineEngineSetting.js;
 }
 var PX_TRIGGER_DEFAULTS = {
   startOn: "load",
@@ -921,7 +921,7 @@ var PxStrokeTrimSubPaths = {
   separate: "separate",
   combined: "combined"
 };
-var TEXT_CONTENT_ATTR = "textContent";
+var PX_TEXT_CONTENT_ATTR = "textContent";
 var CLASS_ATTR = "class";
 var TRANSFORM_ATTR = "transform";
 var OFFSET_DISTANCE_ATTR = "offsetDistance";
@@ -932,7 +932,7 @@ var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   "meta",
   "animate",
   "effects",
-  TEXT_CONTENT_ATTR
+  PX_TEXT_CONTENT_ATTR
 ]);
 var TRANSFORM_PART = {
   translate: "translate",
@@ -955,11 +955,11 @@ var PxGradientType = {
   linear: "linear",
   radial: "radial"
 };
-function isPxElementFileFormat(fileJson) {
-  if (!(fileJson && typeof fileJson === "object" && !Array.isArray(fileJson))) {
+function isPxDocument(doc) {
+  if (!(doc && typeof doc === "object" && !Array.isArray(doc))) {
     return false;
   }
-  return fileJson.type === "svg";
+  return doc.type === "svg";
 }
 function getAnimatorConfig(doc) {
   var _a2;
@@ -1086,7 +1086,7 @@ function nestAnimatorTimeline(cfg) {
   if (fill !== void 0) timeline.fillMode = fill;
   return Object.keys(timeline).length > 0 ? __spreadProps(__spreadValues({}, shared), { timeline }) : shared;
 }
-function getDefs(doc) {
+function getDefinitions(doc) {
   var _a2;
   if (!doc) return void 0;
   return (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.definitions;
@@ -1132,20 +1132,20 @@ var PxKeyframeSchema = implementsInterface()(px.object({
   // its internal COPY-PASTE payload, which never validates against this schema.)
 }));
 var anyKf = (kf) => kf;
-var kfTime = (kf) => {
+var keyframeTime = (kf) => {
   var _a2, _b;
   return (_b = (_a2 = anyKf(kf).time) != null ? _a2 : anyKf(kf).t) != null ? _b : 0;
 };
-var kfValue = (kf) => {
+var keyframeValue = (kf) => {
   var _a2;
   return (_a2 = anyKf(kf).value) != null ? _a2 : anyKf(kf).v;
 };
-var kfEasing = (kf) => {
+var keyframeEasing = (kf) => {
   var _a2;
   return (_a2 = anyKf(kf).easing) != null ? _a2 : anyKf(kf).e;
 };
-var kfTangentIn = (kf) => anyKf(kf).tangentIn;
-var kfTangentOut = (kf) => anyKf(kf).tangentOut;
+var keyframeTangentIn = (kf) => anyKf(kf).tangentIn;
+var keyframeTangentOut = (kf) => anyKf(kf).tangentOut;
 var PxLoopSchema = implementsInterface()(px.object({
   segmentCount: px.number().optional(),
   repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end]).optional(),
@@ -1199,7 +1199,7 @@ var PxGlyphFontSchema = implementsInterface()(px.object({
   unitsPerEm: px.number(),
   glyphs: px.record(PxGlyphSchema)
 }));
-var PxDefsSchema = implementsInterface()(px.object({
+var PxDefinitionsSchema = implementsInterface()(px.object({
   easings: px.record(px.tuple([px.number(), px.number(), px.number(), px.number()])).optional(),
   animations: px.record(PxAnimationDefinitionSchema).optional(),
   fonts: px.record(PxGlyphFontSchema).optional()
@@ -1237,7 +1237,7 @@ var PxTimelinePinSchema = implementsInterface()(px.object({
   offset: px.number().optional(),
   distance: px.number().optional()
 }));
-var PxTimelineEngineSchema = px.enum([PxTimelineEngineExtra.auto, PxTimelineEngineExtra.native, PxTimelineEngineExtra.js]).optional();
+var PxTimelineEngineSchema = px.enum([PxTimelineEngineSetting.auto, PxTimelineEngineSetting.native, PxTimelineEngineSetting.js]).optional();
 var PxTimeTimelineSchema = implementsInterface()(px.object({
   type: px.literal("time").optional(),
   engine: PxTimelineEngineSchema,
@@ -1291,7 +1291,7 @@ var PxAnimatorConfigSchema = implementsInterface()(px.object({
   // 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(),
+  definitions: PxDefinitionsSchema.optional(),
   bindings: px.array(PxBindingSchema).optional(),
   debugGlobalName: px.string().optional(),
   // Declared HERE because this is a closed object: an undeclared key would be stripped by
@@ -1380,7 +1380,7 @@ var PxAnimatableGradientStopsSchema = px.union([
   PxPropertyAnimationSchema
 ]);
 var PxFillGradientEffectSchema = implementsInterface()(px.object({
-  // Contextual kind — the `type` convention, see `PxNodeBase.type`.
+  // Contextual kind — the `type` convention, see `PxNodeBaseSchema.type`.
   type: px.enum([PxGradientType.linear, PxGradientType.radial]),
   start: PxAnimatableVec2Schema.optional(),
   end: PxAnimatableVec2Schema.optional(),
@@ -1417,11 +1417,11 @@ var PxEffectsSchema = implementsInterface()(px.object({
   textPath: PxTextPathEffectSchema.optional(),
   text: PxTextEffectSchema.optional()
 }));
-function validateNodeEffects(root, opts) {
+function validateNodeEffects(root, options) {
   const warnings = [];
   const walk = (node, path) => {
     if (node && node.effects) {
-      const ctx = { errors: [], warnings: [], strict: !!(opts == null ? void 0 : opts.strict) };
+      const ctx = { errors: [], warnings: [], strict: !!(options == null ? void 0 : options.strict) };
       const ok = PxEffectsSchema.isValid(node.effects, ctx, [path + ".effects"]);
       if (!ok) {
         for (const err of ctx.errors) warnings.push(err);
@@ -1482,9 +1482,9 @@ function validateVersionStamp(doc) {
   if (parseWireVersion(version) !== void 0) return [];
   return ["root.animator.version: " + JSON.stringify(version) + ' is not a version stamp ("a.b" or "a.b.c") \u2014 it reads as unstamped'];
 }
-function validateDocument(doc, opts) {
+function validateDocument(doc, options) {
   var _a2;
-  const strict = (opts == null ? void 0 : opts.strict) !== false;
+  const strict = (options == null ? void 0 : options.strict) !== false;
   const ctx = { errors: [], warnings: [], strict };
   const problems = PxAnimatedSvgDocumentSchema.isValid(doc, ctx, ["root"]) ? [] : [...ctx.errors];
   if (doc && typeof doc === "object") {
@@ -1504,7 +1504,7 @@ function validateDocument(doc, opts) {
   }
   return problems;
 }
-var PxNodeBase = px.openObject({
+var PxNodeBaseSchema = px.openObject({
   // CONVENTION (SCHEMA-DESIGN R1 / issues N4): `type` is the ONE word for "what
   // kind of thing is this", discriminated by its CARRIER — here the node TAG
   // (`rect`, `text`), and inside a sub-object that object's kind (`fillGradient.type`,
@@ -1519,7 +1519,7 @@ var PxNodeBase = px.openObject({
   // `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).
+  // minifier's reserve list and gets renamed (dev-docs/plans/minification-boundary.md §1.1).
   domType: px.string().optional(),
   // Text content of a `<text>` / `<tspan>`. Declared, so a non-string value is a schema error
   // and the minifier reserves the key; `text` is NOT an alias for it and is not read anywhere.
@@ -1527,7 +1527,7 @@ var PxNodeBase = px.openObject({
   id: px.string().optional(),
   meta: px.any().optional(),
   // Player-effects bucket emitted by the Editor's lightweight design format.
-  // Consumed and removed by `applyPlayerEffects` before any other normalization
+  // Consumed and removed by `materializeNodeEffects` before any other normalization
   // (see `createAnimatorImpl`), so downstream code never sees it.
   effects: PxEffectsSchema.optional(),
   // `PxElementAnimation` (not just `PxAnimationDefinition`) — accepts
@@ -1536,10 +1536,10 @@ var PxNodeBase = px.openObject({
   animate: PxElementAnimationSchema.optional(),
   style: px.record(px.union([px.string(), px.number()])).optional()
 }, PxAttrValueSchema);
-var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBase._shape), {
+var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBaseSchema._shape), {
   children: px.lazy(() => px.array(PxNodeSchema), []).optional()
 }), PxAttrValueSchema);
-var PxSvgNodeExtra = px.object({
+var PxSvgNodeRootSchema = px.object({
   // `"100%"` and other SVG length strings are legal here — a number-only slot rejected
   // real documents (e.g. apple-store-look-14-main.json) at the root <svg>.
   width: px.union([px.number(), px.string()]).optional(),
@@ -1547,7 +1547,7 @@ var PxSvgNodeExtra = px.object({
   viewBox: px.string().optional(),
   animator: PxAnimatorConfigSchema.optional()
 });
-var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBase._shape), PxSvgNodeExtra._shape), {
+var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBaseSchema._shape), PxSvgNodeRootSchema._shape), {
   type: px.literal("svg"),
   // override string → literal to require 'svg'
   children: px.array(PxNodeSchema).optional()
@@ -1558,8 +1558,8 @@ var PxBezierPathSchema = implementsInterface()(px.object({
   o: px.array(px.array(px.number())).optional(),
   c: px.boolean().optional()
 }));
-function isPxElementFileFormatDeep(fileJson) {
-  const errors = validateDocument(fileJson, { strict: false });
+function isValidPxDocument(doc) {
+  const errors = validateDocument(doc, { strict: false });
   return { valid: errors.length === 0, errors };
 }
 
@@ -1910,9 +1910,9 @@ function parseColor(s) {
   }
   return void 0;
 }
-var COLOR_ATTR_NAMES = /* @__PURE__ */ new Set(["color", "fill", "flood-color", "lighting-color", "stop-color", "stroke"]);
-var TRANSFORM_FN_NAMES = /* @__PURE__ */ new Set(["translate", "rotate", "scale", "skew"]);
-var PCT_BASED_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
+var PX_COLOR_ATTR_NAMES = /* @__PURE__ */ new Set(["color", "fill", "flood-color", "lighting-color", "stop-color", "stroke"]);
+var PX_TRANSFORM_FN_NAMES = /* @__PURE__ */ new Set(["translate", "rotate", "scale", "skew"]);
+var PX_PCT_BASED_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
 function composeTransformParts(parts, opts) {
   var _a2;
   if (!parts) return "";
@@ -1965,8 +1965,8 @@ function parseTransformParts(str2) {
   if (str2.replace(/([a-zA-Z]+)\s*\(([^)]*)\)/g, "").replace(/[\s,]/g, "").length) return void 0;
   return Object.keys(out).length ? out : void 0;
 }
-var STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
-var DEFAULT_DURATION_MS = 1e3;
+var PX_STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
+var PX_DEFAULT_DURATION_MS = 1e3;
 function kebabToCamelCaseWord(kebab) {
   return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
 }
@@ -2129,7 +2129,7 @@ function invertEasing(easing) {
 }
 
 // src/util/PxNodeProps.ts
-var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
+var PX_DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
   "script",
   "foreignobject"
 ]);
@@ -2154,7 +2154,7 @@ var URL_VALUE_ATTRS_LOWER = /* @__PURE__ */ new Set([
   // marker-end="url(#…)"
 ]);
 var IMAGE_REF_ATTRS_LOWER = /* @__PURE__ */ new Set(["href", "xlink:href", "src"]);
-var CSS_ONLY_STYLE_PROPS = /* @__PURE__ */ new Set(["mixBlendMode", "isolation"]);
+var PX_CSS_ONLY_STYLE_PROPS = /* @__PURE__ */ new Set(["mixBlendMode", "isolation"]);
 var DATA_RASTER_IMAGE_RE = /^data:image\/(?:png|jpe?g|gif|webp|bmp);base64,/i;
 var DATA_SVG_IMAGE_RE = /^data:image\/svg\+xml(?:;[^,]*)?,/i;
 var DATA_IMAGE_BASE64_PAYLOAD_RE = /^data:image\/[^;,]*;base64,([A-Za-z0-9+/]{8})/i;
@@ -2191,19 +2191,19 @@ function sanitizeAttributeValue(name, value) {
   }
   return value;
 }
-function getNormalizedProps(props) {
+function toDomProps(props) {
   const propsCopy = {};
   for (const rawKey of Object.keys(props)) {
     const key = kebabToCamelCaseWord(rawKey);
     if (INTERNAL_ATTRS.has(key)) continue;
     if (key === "style") continue;
     let value = props[rawKey];
-    if (COLOR_ATTR_NAMES.has(key) && Array.isArray(value)) {
+    if (PX_COLOR_ATTR_NAMES.has(key) && Array.isArray(value)) {
       propsCopy[key] = toRGBA(value);
     } else if (key === "transform" && value !== null && typeof value === "object" && !Array.isArray(value) && !value.keyframes) {
       const parts = value.value && typeof value.value === "object" ? value.value : value;
       propsCopy[TRANSFORM_ATTR] = composeTransformParts(parts, { withUnits: false });
-    } else if (TRANSFORM_FN_NAMES.has(key)) {
+    } else if (PX_TRANSFORM_FN_NAMES.has(key)) {
       if (Array.isArray(value)) {
         if (key === "translate") value = value.map((v) => v + "px");
         value = value.join(",");
@@ -2221,7 +2221,7 @@ function getNormalizedProps(props) {
 
 // src/materialize/PxMotionPath.ts
 function getKfTranslate(kf) {
-  const v = kfValue(kf);
+  const v = keyframeValue(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]];
@@ -2231,17 +2231,17 @@ function getKfTranslate(kf) {
   return void 0;
 }
 function getKfTime(kf) {
-  return kfTime(kf);
+  return keyframeTime(kf);
 }
 function getKfEasing(kf) {
-  return kfEasing(kf);
+  return keyframeEasing(kf);
 }
 function propAnimIsMotionPath(anim) {
   const kfs = anim.keyframes;
   if (!Array.isArray(kfs)) return false;
   if (anim.autoOrient) return true;
   for (const kf of kfs) {
-    if (kfTangentIn(kf) || kfTangentOut(kf)) return true;
+    if (keyframeTangentIn(kf) || keyframeTangentOut(kf)) return true;
   }
   return false;
 }
@@ -2250,8 +2250,8 @@ function getSegmentCache(prevKf, nextKf, prevPos, nextPos) {
   let byNext = _segmentCache.get(prevKf);
   const existing = byNext == null ? void 0 : byNext.get(nextKf);
   if (existing) return existing;
-  const to = kfTangentOut(prevKf);
-  const ti = kfTangentIn(nextKf);
+  const to = keyframeTangentOut(prevKf);
+  const ti = keyframeTangentIn(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);
@@ -2344,7 +2344,7 @@ function materializeMotionPathInPropAnim(anim, opts) {
 function unwrapAutoOrientRotations(kfs) {
   let prev;
   for (const kf of kfs) {
-    const v = kfValue(kf);
+    const v = keyframeValue(kf);
     if (!v || typeof v.rotate !== "number") continue;
     if (prev === void 0) {
       prev = v.rotate;
@@ -2361,7 +2361,7 @@ function makeOutKf(time, value) {
   return { t: time, v: value };
 }
 function getKfValueParts(kf) {
-  const v = kfValue(kf);
+  const v = keyframeValue(kf);
   if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
   return v;
 }
@@ -2423,7 +2423,7 @@ function wrappedAngleDelta(a, b) {
 }
 function insertSharpCornerStepKfIfNeeded(out, prevKf, nextKf, prevPos, nextPos, rotationTol) {
   const lastKf = out[out.length - 1];
-  const lastV = kfValue(lastKf);
+  const lastV = keyframeValue(lastKf);
   const prevExit = lastV == null ? void 0 : lastV.rotate;
   if (typeof prevExit !== "number") return;
   const boundaryV = getKfValueParts(prevKf);
@@ -2605,7 +2605,7 @@ function walkAndMaterialize(node, opts) {
 }
 
 // src/animation/PxDefinitions.ts
-var LOOP_JUMP_SHIFT_MS = 1;
+var PX_LOOP_JUMP_SHIFT_MS = 1;
 function deepEqualValue(a, b) {
   if (a === b) return true;
   if (typeof a !== typeof b || a === null || b === null || typeof a !== "object") return false;
@@ -2781,7 +2781,7 @@ function interpolateValue(propName, a, b, t) {
     const bPaths = (_b = b == null ? void 0 : b.paths) != null ? _b : Array.isArray(b) ? b : [];
     return { paths: interpolateBeziers(aPaths, bPaths, t) };
   }
-  if (COLOR_ATTR_NAMES.has(propName)) {
+  if (PX_COLOR_ATTR_NAMES.has(propName)) {
     return interpolateColor(a || [0, 0, 0, 1], b || [0, 0, 0, 1], t);
   }
   if (propName === "transform" && typeof a === "object" && a !== null && !Array.isArray(a) && typeof b === "object" && b !== null && !Array.isArray(b)) {
@@ -2790,7 +2790,7 @@ function interpolateValue(propName, a, b, t) {
   if (propName === "rotate" && typeof a === "number" && typeof b === "number") {
     return interpolateNum(a, b, t);
   }
-  if (TRANSFORM_FN_NAMES.has(propName) || propName === "stroke-dasharray" || propName === "strokeDasharray") {
+  if (PX_TRANSFORM_FN_NAMES.has(propName) || propName === "stroke-dasharray" || propName === "strokeDasharray") {
     return interpolateVec(a || [], b || [], t);
   }
   return interpolateNum(+(a || 0), +(b || 0), t);
@@ -2842,8 +2842,8 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
     relT: (kf.t - segStartT) / segDuration,
     v: kf.v,
     e: kf.e,
-    tangentIn: kfTangentIn(kf),
-    tangentOut: kfTangentOut(kf)
+    tangentIn: keyframeTangentIn(kf),
+    tangentOut: keyframeTangentOut(kf)
   }));
   const fullReps = Math.floor(fillDuration / segDuration);
   const remainder = fillDuration - fullReps * segDuration;
@@ -2909,7 +2909,7 @@ function expandLoopKeyframes(propName, keyframes, loop, duration) {
         }
       }
       const pushed = {
-        t: repStart + entry.relT * segDuration + (isBoundary ? LOOP_JUMP_SHIFT_MS : 0),
+        t: repStart + entry.relT * segDuration + (isBoundary ? PX_LOOP_JUMP_SHIFT_MS : 0),
         v: entry.v,
         e: i < entries.length - 1 ? entry.e : void 0
       };
@@ -2996,14 +2996,14 @@ function normalizeKeyframes(propName, propAnim, duration, defs) {
   const keyframes = propAnim.keyframes || [];
   const normalized = [];
   for (const kf of keyframes) {
-    const timePct = kfTime(kf);
-    let value = kfValue(kf);
-    const easing = kfEasing(kf);
+    const timePct = keyframeTime(kf);
+    let value = keyframeValue(kf);
+    const easing = keyframeEasing(kf);
     if (propName === "d") {
       value = normalizePathValue(value);
     }
     const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
-    if (COLOR_ATTR_NAMES.has(propNameKebab)) {
+    if (PX_COLOR_ATTR_NAMES.has(propNameKebab)) {
       value = (_a2 = parseColor(value)) != null ? _a2 : value;
     }
     const normKf = {
@@ -3011,8 +3011,8 @@ function normalizeKeyframes(propName, propAnim, duration, defs) {
       v: value,
       e: resolveEasing(easing, defs)
     };
-    const tIn = kfTangentIn(kf);
-    const tOut = kfTangentOut(kf);
+    const tIn = keyframeTangentIn(kf);
+    const tOut = keyframeTangentOut(kf);
     if (tIn) normKf.tangentIn = tIn;
     if (tOut) normKf.tangentOut = tOut;
     normalized.push(normKf);
@@ -3044,17 +3044,17 @@ function materializeInternalLoopsInPropAnim(propName, propAnim, duration) {
   const rawKfs = propAnim.keyframes;
   if (!Array.isArray(rawKfs) || rawKfs.length < 2) return propAnim;
   const propNameKebab = isCamelCaseWord(propName) ? camelCaseToKebabWordIfNeeded(propName) : propName;
-  const isColor = COLOR_ATTR_NAMES.has(propNameKebab);
+  const isColor = PX_COLOR_ATTR_NAMES.has(propNameKebab);
   const kfs = rawKfs.map((kf) => {
     var _a2;
-    const t = kfTime(kf);
-    let v = kfValue(kf);
+    const t = keyframeTime(kf);
+    let v = keyframeValue(kf);
     if (propName === "d") v = normalizePathValue(v);
     if (isColor) v = (_a2 = parseColor(v)) != null ? _a2 : v;
-    const e = kfEasing(kf);
+    const e = keyframeEasing(kf);
     const out2 = { t, v, e };
-    const tIn = kfTangentIn(kf);
-    const tOut = kfTangentOut(kf);
+    const tIn = keyframeTangentIn(kf);
+    const tOut = keyframeTangentOut(kf);
     if (tIn) out2.tangentIn = tIn;
     if (tOut) out2.tangentOut = tOut;
     return out2;
@@ -3119,7 +3119,7 @@ function mergeStaticTransformIntoAnimDef(animDef, staticTransform) {
     }
     return animDef;
   }
-  const channels = Object.keys(animDef).filter((k) => TRANSFORM_FN_NAMES.has(k));
+  const channels = Object.keys(animDef).filter((k) => PX_TRANSFORM_FN_NAMES.has(k));
   if (channels.length !== 1) return animDef;
   const ch = channels[0];
   const chAnim = animDef[ch];
@@ -3148,9 +3148,9 @@ function normalizeAnimationDefinition(animDef, duration, defs, engine = PxTimeli
   }
   return normalized;
 }
-function getNormalizedBindings(doc, engine = PxTimelineEngine.native) {
+function normalizeBindings(doc, engine = PxTimelineEngine.native) {
   const animatorConfig = getAnimatorConfig(doc) || {};
-  const defs = getDefs(doc);
+  const defs = getDefinitions(doc);
   const duration = animatorConfig.duration || 1e3;
   const bindings = [];
   const processAnimation = (id, animDefs, staticTransform) => {
@@ -3220,7 +3220,7 @@ function calcPropertyValue(propName, propAnim, progress) {
   const { prevKf, nextKf } = getKeyframesPair(keyframes, progress);
   let localProgress = prevKf === nextKf ? 0 : remap(progress, (_a2 = prevKf.t) != null ? _a2 : 0, (_b = nextKf.t) != null ? _b : 0, 0, 1);
   localProgress = clamp(localProgress, 0, 1);
-  const easing = kfEasing(prevKf);
+  const easing = keyframeEasing(prevKf);
   if (easing && Array.isArray(easing)) {
     try {
       localProgress = cubicBezier(easing)(localProgress);
@@ -3239,7 +3239,7 @@ function calcPropertyValue(propName, propAnim, progress) {
       nextPaths,
       localProgress
     ).map((bz) => bezierToSvgPath(bz)).join("");
-  } else if (COLOR_ATTR_NAMES.has(cssAttrName)) {
+  } else if (PX_COLOR_ATTR_NAMES.has(cssAttrName)) {
     cssValue = toRGBA(interpolateColor(
       prevV || [0, 0, 0, 1],
       nextV || [0, 0, 0, 1],
@@ -3313,14 +3313,14 @@ function calcPropertyValue(propName, propAnim, progress) {
     cssValue = "scale(" + v.join(",") + ")";
     cssAttrName = "transform";
   } else {
-    const num2 = interpolateNum(
+    const num = interpolateNum(
       +(prevV || 0),
       +(nextV || 0),
       localProgress
     );
-    cssValue = num2;
+    cssValue = num;
   }
-  if (PCT_BASED_ATTR_NAMES.has(cssAttrName) && typeof cssValue === "number") {
+  if (PX_PCT_BASED_ATTR_NAMES.has(cssAttrName) && typeof cssValue === "number") {
     cssValue = cssValue * 100 + "%";
   }
   return { k: cssAttrName, v: cssValue === null ? "" : "" + cssValue };
@@ -3361,7 +3361,7 @@ function parseCubics(d) {
   let pcx = 0, pcy = 0;
   let pqx = 0, pqy = 0;
   let prevCmd = "";
-  const num2 = () => parseFloat(tokens[i++]);
+  const num = () => parseFloat(tokens[i++]);
   const push = (P1, P2, P3) => {
     const P0 = [cx, cy];
     const lut = bezier2D_arcLengthLUT(P0, P1, P2, P3, LUT_STEPS);
@@ -3390,7 +3390,7 @@ function parseCubics(d) {
       continue;
     }
     if (U === "M") {
-      const x = num2() + (rel ? cx : 0), y = num2() + (rel ? cy : 0);
+      const x = num() + (rel ? cx : 0), y = num() + (rel ? cy : 0);
       cx = x;
       cy = y;
       sx = x;
@@ -3399,29 +3399,29 @@ function parseCubics(d) {
       continue;
     }
     if (U === "L") {
-      pushLine(num2() + (rel ? cx : 0), num2() + (rel ? cy : 0));
+      pushLine(num() + (rel ? cx : 0), num() + (rel ? cy : 0));
     } else if (U === "H") {
-      pushLine(num2() + (rel ? cx : 0), cy);
+      pushLine(num() + (rel ? cx : 0), cy);
     } else if (U === "V") {
-      pushLine(cx, num2() + (rel ? cy : 0));
+      pushLine(cx, num() + (rel ? cy : 0));
     } else if (U === "C") {
-      const p1 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
-      const p2 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
-      const p3 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
+      const p1 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
+      const p2 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
+      const p3 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
       pcx = p2[0];
       pcy = p2[1];
       push(p1, p2, p3);
     } else if (U === "S") {
       const smooth = prevCmd.toUpperCase() === "C" || prevCmd.toUpperCase() === "S";
       const p1 = smooth ? [2 * cx - pcx, 2 * cy - pcy] : [cx, cy];
-      const p2 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
-      const p3 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
+      const p2 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
+      const p3 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
       pcx = p2[0];
       pcy = p2[1];
       push(p1, p2, p3);
     } else if (U === "Q") {
-      const qc = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
-      const p3 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
+      const qc = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
+      const p3 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
       pqx = qc[0];
       pqy = qc[1];
       const { P1, P2 } = quadToCubic([cx, cy], qc, p3);
@@ -3429,14 +3429,14 @@ function parseCubics(d) {
     } else if (U === "T") {
       const smooth = prevCmd.toUpperCase() === "Q" || prevCmd.toUpperCase() === "T";
       const qc = smooth ? [2 * cx - pqx, 2 * cy - pqy] : [cx, cy];
-      const p3 = [num2() + (rel ? cx : 0), num2() + (rel ? cy : 0)];
+      const p3 = [num() + (rel ? cx : 0), num() + (rel ? cy : 0)];
       pqx = qc[0];
       pqy = qc[1];
       const { P1, P2 } = quadToCubic([cx, cy], qc, p3);
       push(P1, P2, p3);
     } else if (U === "A") {
       i += 5;
-      pushLine(num2() + (rel ? cx : 0), num2() + (rel ? cy : 0));
+      pushLine(num() + (rel ? cx : 0), num() + (rel ? cy : 0));
     } else {
       i++;
       continue;
@@ -3775,20 +3775,20 @@ function transformPathData(d, m, decimals = 2) {
   while ((match = TOKEN_RE.exec(d)) !== null) tokens.push(match[0]);
   let out = "";
   let i = 0;
-  const num2 = () => parseFloat(tokens[i++]);
+  const num = () => parseFloat(tokens[i++]);
   while (i < tokens.length) {
     const cmd = tokens[i++];
     if (cmd === "M" || cmd === "L") {
-      const [x, y] = apply(m, num2(), num2());
+      const [x, y] = apply(m, num(), num());
       out += cmd + pack([x, y], decimals);
     } else if (cmd === "C") {
-      const [x1, y1] = apply(m, num2(), num2());
-      const [x2, y2] = apply(m, num2(), num2());
-      const [x, y] = apply(m, num2(), num2());
+      const [x1, y1] = apply(m, num(), num());
+      const [x2, y2] = apply(m, num(), num());
+      const [x, y] = apply(m, num(), num());
       out += "C" + pack([x1, y1, x2, y2, x, y], decimals);
     } else if (cmd === "Q") {
-      const [x1, y1] = apply(m, num2(), num2());
-      const [x, y] = apply(m, num2(), num2());
+      const [x1, y1] = apply(m, num(), num());
+      const [x, y] = apply(m, num(), num());
       out += "Q" + pack([x1, y1, x, y], decimals);
     } else if (cmd === "Z" || cmd === "z") {
       out += "Z";
@@ -3819,7 +3819,7 @@ var TEXT_ATTR_KEYS = [
   "stroke",
   "strokeWidth",
   "effects",
-  TEXT_CONTENT_ATTR,
+  PX_TEXT_CONTENT_ATTR,
   "xml:space"
 ];
 var PAINT_STATIC_KEYS = [
@@ -3973,13 +3973,13 @@ function materializeGlyphTextHorizontal(node, opts) {
     if (y !== void 0) pen.y = y;
     pen.x += (_a3 = parseLen(el.dx)) != null ? _a3 : 0;
     pen.y += (_b2 = parseLen(el.dy)) != null ? _b2 : 0;
-    const content = str(el[TEXT_CONTENT_ATTR]);
+    const content = str(el[PX_TEXT_CONTENT_ATTR]);
     if (content && !((_c2 = el.children) == null ? void 0 : _c2.length)) renderChars(content, s);
     if (el.children) for (const ch of el.children) walk(ch, s);
   };
   const rootStyle = rootStyleOf(node);
   if (node.children) for (const ch of node.children) walk(ch, rootStyle);
-  const rootContent = str(node[TEXT_CONTENT_ATTR]);
+  const rootContent = str(node[PX_TEXT_CONTENT_ATTR]);
   if (rootContent && !((_c = node.children) == null ? void 0 : _c.length)) renderChars(rootContent, rootStyle);
   const anchor = str(node.textAnchor);
   if (anchor === "middle" || anchor === "end") {
@@ -4028,7 +4028,7 @@ function layoutGlyphTextChars(node, opts) {
     if (y !== void 0) pen.y = y;
     pen.x += (_a3 = parseLen(el.dx)) != null ? _a3 : 0;
     pen.y += (_b2 = parseLen(el.dy)) != null ? _b2 : 0;
-    const content = str(el[TEXT_CONTENT_ATTR]);
+    const content = str(el[PX_TEXT_CONTENT_ATTR]);
     if (content && !((_c2 = el.children) == null ? void 0 : _c2.length)) renderChars(content, s);
     if (el.children) for (const ch of el.children) walk(ch, s);
   };
@@ -4043,7 +4043,7 @@ function layoutGlyphTextChars(node, opts) {
       boxes.push({ x: pen.x, y: pen.y, width: 0, ascent: ((_d = gf == null ? void 0 : gf.ascent) != null ? _d : 0.9 * upm) * (s.fontSize / upm), fontSize: s.fontSize, line });
     }
   }
-  const rootContent = str(node[TEXT_CONTENT_ATTR]);
+  const rootContent = str(node[PX_TEXT_CONTENT_ATTR]);
   if (rootContent && !((_e = node.children) == null ? void 0 : _e.length)) renderChars(rootContent, rootStyle);
   const anchor = str(node.textAnchor);
   if (anchor === "middle" || anchor === "end") {
@@ -4071,7 +4071,7 @@ function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
   const walk = (el, parentStyle) => {
     var _a3, _b2;
     const s = resolveStyle(el, parentStyle);
-    const content = str(el[TEXT_CONTENT_ATTR]);
+    const content = str(el[PX_TEXT_CONTENT_ATTR]);
     if (content && !((_a3 = el.children) == null ? void 0 : _a3.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
@@ -4125,7 +4125,7 @@ function collectAlongPathCells(node, glyphs, soleFont, warnings) {
   const walk = (el, parentStyle) => {
     var _a2, _b;
     const s = resolveStyle(el, parentStyle);
-    const content = str(el[TEXT_CONTENT_ATTR]);
+    const content = str(el[PX_TEXT_CONTENT_ATTR]);
     if (content && !((_a2 = el.children) == null ? void 0 : _a2.length)) {
       const gf = glyphFontFor(s, glyphs, soleFont, warnings);
       if (gf) {
@@ -4373,32 +4373,34 @@ var PxDiagnosticKind = {
   /** The player failed where it did not expect to — report it to us. */
   internal: "internal"
 };
-function asError(error) {
-  return typeof error === "string" ? new Error(error) : error;
+var DOCS_URL = "https://github.com/pixodesk/pixodesk-svg-animator/blob/main/docs/diagnostics.md";
+function codeLine(code) {
+  return "PX" + code + " " + DOCS_URL + "#px" + code;
+}
+function errorIn(data) {
+  return data.find((d) => d instanceof Error);
 }
 function createDiagnostics(config, prefix) {
   const tag = prefix ? prefix + " " : "";
   return {
-    warn: (kind, message, detail) => {
+    warn: (kind, code, ...data) => {
+      const message = codeLine(code);
       if (config == null ? void 0 : config.onWarn) {
-        config.onWarn({ kind, message, detail });
+        config.onWarn({ code, kind, data, message });
         return;
       }
       if (config == null ? void 0 : config.muteWarn) return;
-      const line = tag + kind + ": " + message;
-      if (detail === void 0) console.warn(line);
-      else console.warn(line, detail);
+      console.warn(tag + kind + " " + message, ...data);
     },
-    error: (kind, error, detail) => {
-      const err = asError(error);
+    error: (kind, code, ...data) => {
+      const message = codeLine(code);
+      const error = errorIn(data);
       if (config == null ? void 0 : config.onError) {
-        config.onError({ kind, message: err.message, error: err, detail });
+        config.onError({ code, kind, data, message, error });
         return;
       }
       if (config == null ? void 0 : config.muteError) return;
-      const line = tag + kind + ": " + err.message;
-      if (detail === void 0) console.error(line);
-      else console.error(line, detail);
+      console.error(tag + kind + " " + message, ...data);
     }
   };
 }
@@ -4422,394 +4424,6 @@ function reportDocumentDiagnostics(doc, where) {
   );
 }
 
-// src/effects/PlayerEffectsUtil.visualModel.ts
-var IDENTITY = [1, 0, 0, 1, 0, 0];
-function mul(m, n) {
-  return [
-    m[0] * n[0] + m[2] * n[1],
-    m[1] * n[0] + m[3] * n[1],
-    m[0] * n[2] + m[2] * n[3],
-    m[1] * n[2] + m[3] * n[3],
-    m[0] * n[4] + m[2] * n[5] + m[4],
-    m[1] * n[4] + m[3] * n[5] + m[5]
-  ];
-}
-var translateM = (x, y) => [1, 0, 0, 1, x, y];
-var scaleM = (sx, sy) => [sx, 0, 0, sy, 0, 0];
-function rotateM(deg) {
-  const r = deg * Math.PI / 180;
-  return [Math.cos(r), Math.sin(r), -Math.sin(r), Math.cos(r), 0, 0];
-}
-var skewXM = (deg) => [1, 0, Math.tan(deg * Math.PI / 180), 1, 0, 0];
-var skewYM = (deg) => [1, Math.tan(deg * Math.PI / 180), 0, 1, 0, 0];
-function parseTransformString(s) {
-  let m = IDENTITY;
-  const re = /(translate|rotate|scale|matrix|skewX|skewY)\(([^)]*)\)/g;
-  let hit;
-  while (hit = re.exec(s)) {
-    const fn = hit[1];
-    const a = hit[2].split(/[\s,]+/).filter(Boolean).map(Number);
-    if (fn === "translate") m = mul(m, translateM(a[0] || 0, a[1] || 0));
-    else if (fn === "scale") m = mul(m, scaleM(a[0], a.length > 1 ? a[1] : a[0]));
-    else if (fn === "rotate") m = mul(m, rotateM(a[0]));
-    else if (fn === "skewX") m = mul(m, skewXM(a[0]));
-    else if (fn === "skewY") m = mul(m, skewYM(a[0]));
-    else if (fn === "matrix") m = mul(m, [a[0], a[1], a[2], a[3], a[4], a[5]]);
-  }
-  return m;
-}
-function partsToMatrix(p) {
-  let m = IDENTITY;
-  if (p.translate) m = mul(m, translateM(p.translate[0], p.translate[1]));
-  const pivot = p.origin && (p.rotate !== void 0 || p.scale);
-  if (pivot) m = mul(m, translateM(p.origin[0], p.origin[1]));
-  if (p.rotate !== void 0) m = mul(m, rotateM(p.rotate));
-  if (p.scale) m = mul(m, scaleM(p.scale[0], p.scale[1]));
-  if (pivot) m = mul(m, translateM(-p.origin[0], -p.origin[1]));
-  return m;
-}
-function lerp(a, b, f) {
-  return a + (b - a) * f;
-}
-function interpParts(kfs, t) {
-  var _a2, _b, _c, _d, _e, _f, _g;
-  if (!kfs.length) return {};
-  if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value || {};
-  if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value || {};
-  let i = 0;
-  while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
-  const a = kfs[i], b = kfs[i + 1];
-  const f = (t - ((_d = a.time) != null ? _d : 0)) / (((_e = b.time) != null ? _e : 0) - ((_f = a.time) != null ? _f : 0) || 1);
-  const va = a.value || {}, vb = b.value || {};
-  const out = {};
-  if (va.translate && vb.translate) out.translate = [lerp(va.translate[0], vb.translate[0], f), lerp(va.translate[1], vb.translate[1], f)];
-  else out.translate = va.translate || vb.translate;
-  if (va.rotate !== void 0 && vb.rotate !== void 0) out.rotate = lerp(va.rotate, vb.rotate, f);
-  else out.rotate = (_g = va.rotate) != null ? _g : vb.rotate;
-  if (va.scale && vb.scale) out.scale = [lerp(va.scale[0], vb.scale[0], f), lerp(va.scale[1], vb.scale[1], f)];
-  else out.scale = va.scale || vb.scale;
-  out.origin = va.origin || vb.origin;
-  return out;
-}
-function evalTransformValue(v, t) {
-  if (v === void 0 || v === null) return IDENTITY;
-  if (typeof v === "string") return parseTransformString(v);
-  if (v.keyframes) return partsToMatrix(interpParts(v.keyframes, t));
-  if (v.value) return partsToMatrix(v.value);
-  if (typeof v === "object" && !Array.isArray(v)) return partsToMatrix(v);
-  return IDENTITY;
-}
-function nodeMatrix(node, t) {
-  if (node.animate && node.animate.transform) return evalTransformValue(node.animate.transform, t);
-  if (node.transform !== void 0) return evalTransformValue(node.transform, t);
-  return IDENTITY;
-}
-function evalScalar(animated, staticVal, fallback, t) {
-  var _a2, _b, _c, _d, _e, _f;
-  if (animated && animated.keyframes && animated.keyframes.length) {
-    const kfs = animated.keyframes;
-    if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value;
-    if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value;
-    let i = 0;
-    while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
-    const a = kfs[i], b = kfs[i + 1];
-    const f = (t - ((_d = a.time) != null ? _d : 0)) / (((_e = b.time) != null ? _e : 0) - ((_f = a.time) != null ? _f : 0) || 1);
-    return lerp(a.value, b.value, f);
-  }
-  return staticVal !== void 0 ? Number(staticVal) : fallback;
-}
-var CONTAINER_TYPES = /* @__PURE__ */ new Set(["svg", "g", "symbol"]);
-var SKIP_TYPES = /* @__PURE__ */ new Set(["defs", "mask", "clipPath", "title"]);
-function buildIdMap(node, map) {
-  var _a2;
-  if (typeof node.id === "string") map.set(node.id, node);
-  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => buildIdMap(c, map));
-}
-function num(v) {
-  return v === void 0 || v === null ? 0 : Number(v);
-}
-function round(n) {
-  return Math.round(n * 100) / 100 + 0;
-}
-function geomKey(node) {
-  var _a2;
-  switch (node.type) {
-    case "rect":
-      return num(node.width) + "," + num(node.height) + "," + num(node.x) + "," + num(node.y);
-    case "ellipse":
-      return num(node.rx) + "," + num(node.ry) + "," + num(node.cx) + "," + num(node.cy);
-    case "circle":
-      return num(node.r) + "," + num(node.cx) + "," + num(node.cy);
-    case "path":
-      return String((_a2 = node.d) != null ? _a2 : "");
-    default:
-      return "";
-  }
-}
-function describePrimitive(node, m, t) {
-  var _a2, _b, _c, _d, _e;
-  const fill = (_a2 = node.fill) != null ? _a2 : "";
-  const stroke = (_b = node.stroke) != null ? _b : "";
-  const sw = (_d = (_c = node["stroke-width"]) != null ? _c : node.strokeWidth) != null ? _d : "";
-  const opacity = round(evalScalar((_e = node.animate) == null ? void 0 : _e.opacity, node.opacity, 1, t));
-  const masked = node.mask ? 1 : 0;
-  const mat = m.map(round).join(",");
-  return node.type + "|" + geomKey(node) + "|[" + mat + "]|f:" + fill + "|s:" + stroke + "|sw:" + (num(sw) || "") + "|o:" + opacity + "|m:" + masked;
-}
-function flatten(node, parent, t, idMap, out) {
-  var _a2;
-  const type = node.type || "";
-  if (SKIP_TYPES.has(type)) return;
-  const m = mul(parent, nodeMatrix(node, t));
-  if (type === "use") {
-    const targetId = typeof node.href === "string" ? node.href.replace(/^#/, "") : "";
-    const target = idMap.get(targetId);
-    const useM = mul(m, translateM(num(node.x), num(node.y)));
-    if (target) flatten(target, useM, t, idMap, out);
-    else out.push("UNRESOLVED_USE:#" + targetId);
-    return;
-  }
-  if (CONTAINER_TYPES.has(type)) {
-    (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => flatten(c, m, t, idMap, out));
-    return;
-  }
-  out.push(describePrimitive(node, m, t));
-}
-function collectSampleTimes(node, into) {
-  var _a2;
-  into.add(0);
-  const scanAnim = (anim) => {
-    var _a3;
-    if (!anim || typeof anim !== "object") return;
-    for (const key of Object.keys(anim)) {
-      const kfs = (_a3 = anim[key]) == null ? void 0 : _a3.keyframes;
-      if (Array.isArray(kfs)) kfs.forEach((kf) => {
-        var _a4;
-        return into.add((_a4 = kf.time) != null ? _a4 : 0);
-      });
-    }
-  };
-  scanAnim(node.animate);
-  if (node.transform && typeof node.transform === "object" && node.transform.keyframes) {
-    node.transform.keyframes.forEach((kf) => {
-      var _a3;
-      return into.add((_a3 = kf.time) != null ? _a3 : 0);
-    });
-  }
-  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => collectSampleTimes(c, into));
-}
-function visualModelAt(root, t) {
-  const idMap = /* @__PURE__ */ new Map();
-  buildIdMap(root, idMap);
-  const out = [];
-  flatten(root, IDENTITY, t, idMap, out);
-  return out.sort();
-}
-function diffInEffect(a, b) {
-  const times = /* @__PURE__ */ new Set();
-  collectSampleTimes(a, times);
-  collectSampleTimes(b, times);
-  const diffs = [];
-  for (const t of Array.from(times).sort((x, y) => x - y)) {
-    const ma = visualModelAt(a, t);
-    const mb = visualModelAt(b, t);
-    const onlyInA = subtractMultiset(ma, mb);
-    const onlyInB = subtractMultiset(mb, ma);
-    if (onlyInA.length || onlyInB.length) diffs.push({ time: t, onlyInA, onlyInB });
-  }
-  return diffs;
-}
-function subtractMultiset(a, b) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const x of b) counts.set(x, (counts.get(x) || 0) + 1);
-  const extra = [];
-  for (const x of a) {
-    const c = counts.get(x) || 0;
-    if (c > 0) counts.set(x, c - 1);
-    else extra.push(x);
-  }
-  return extra;
-}
-
-// src/playback/PxScrollMath.ts
-function isScrollTimeline(config) {
-  return (config == null ? void 0 : config.timelineSource) === "scroll";
-}
-function scrollTotalDurationMs(config) {
-  const duration = typeof (config == null ? void 0 : config.duration) === "number" && config.duration > 0 ? config.duration : DEFAULT_DURATION_MS;
-  const iterations = typeof (config == null ? void 0 : config.iterations) === "number" && config.iterations > 0 ? config.iterations : 1;
-  return duration * iterations;
-}
-function scrollPhaseInterval(phase, subjectSize, scrollportSize) {
-  const s = subjectSize, vp = scrollportSize;
-  switch (phase) {
-    case "cover":
-      return [0, s + vp];
-    case "entry":
-      return [0, Math.min(s, vp)];
-    case "contain":
-      return [Math.min(s, vp), Math.max(s, vp)];
-    case "exit":
-      return [Math.max(s, vp), s + vp];
-    case "entry-crossing":
-      return [0, s];
-    case "exit-crossing":
-      return [vp, s + vp];
-  }
-}
-var DEFAULT_PHASE = "cover";
-function resolveRangePointU(point, defaultFraction, subjectSize, scrollportSize) {
-  var _a2;
-  const [u0, u1] = scrollPhaseInterval((_a2 = point == null ? void 0 : point.phase) != null ? _a2 : DEFAULT_PHASE, subjectSize, scrollportSize);
-  const fraction = typeof (point == null ? void 0 : point.fraction) === "number" ? point.fraction : defaultFraction;
-  return u0 + fraction * (u1 - u0);
-}
-function scrollViewProgress(subjectStart, subjectSize, scrollportSize, range) {
-  const u = scrollportSize - subjectStart;
-  const uStart = resolveRangePointU(range == null ? void 0 : range.start, 0, subjectSize, scrollportSize);
-  const uEnd = resolveRangePointU(range == null ? void 0 : range.end, 1, subjectSize, scrollportSize);
-  if (uEnd <= uStart) return u >= uEnd ? 1 : 0;
-  return clamp((u - uStart) / (uEnd - uStart), 0, 1);
-}
-function scrollOffsetProgress(offset, maxOffset, range) {
-  var _a2, _b;
-  const raw = maxOffset > 0 ? clamp(offset / maxOffset, 0, 1) : 1;
-  const start = typeof ((_a2 = range == null ? void 0 : range.start) == null ? void 0 : _a2.fraction) === "number" ? range.start.fraction : 0;
-  const end = typeof ((_b = range == null ? void 0 : range.end) == null ? void 0 : _b.fraction) === "number" ? range.end.fraction : 1;
-  if (end <= start) return raw >= end ? 1 : 0;
-  return clamp((raw - start) / (end - start), 0, 1);
-}
-function scrollResolveAxis(axis, writingMode) {
-  const a = axis != null ? axis : "block";
-  if (a === "x" || a === "y") return a;
-  const vertical = !!writingMode && writingMode.startsWith("vertical");
-  if (a === "inline") return vertical ? "y" : "x";
-  return vertical ? "x" : "y";
-}
-
-// src/version/PxSchemaFieldUniverse.ts
-function schemaFieldUniverse(root) {
-  const fields = /* @__PURE__ */ new Set();
-  const enumerated = /* @__PURE__ */ new Set();
-  const queue = [{ schema: root, path: "" }];
-  while (queue.length) {
-    const { schema, path } = queue.shift();
-    const d = describeSchema(schema);
-    switch (d.kind) {
-      case "shape": {
-        if (enumerated.has(schema)) break;
-        enumerated.add(schema);
-        for (const key of Object.keys(d.shape)) {
-          const id = path ? path + "." + key : key;
-          fields.add(id);
-          queue.push({ schema: d.shape[key], path: id });
-        }
-        if (d.openValue) queue.push({ schema: d.openValue, path: path + "{*}" });
-        break;
-      }
-      case "optional":
-        queue.push({ schema: d.inner, path });
-        break;
-      case "array":
-        queue.push({ schema: d.item, path: path + "[]" });
-        break;
-      case "lazy":
-        queue.push({ schema: d.resolved, path });
-        break;
-      case "record":
-        queue.push({ schema: d.value, path: path + "{*}" });
-        break;
-      case "union":
-        d.members.forEach((member, i) => queue.push({ schema: member, path: path + "|" + i }));
-        break;
-      case "discriminatedUnion":
-        for (const member of d.members) queue.push({ schema: member, path: path + "|" + discriminantOf(member, d.key) });
-        break;
-      default:
-        break;
-    }
-  }
-  return [...fields].sort();
-}
-function discriminantOf(member, key) {
-  const d = describeSchema(member);
-  if (d.kind !== "shape") return "?";
-  const keySchema = d.shape[key];
-  if (keySchema === void 0) return "?";
-  const kd = describeSchema(keySchema);
-  return String((kd.kind === "optional" ? kd.inner : keySchema)._default);
-}
-
-// src/version/PxSchemaRelease.ts
-function diffFieldUniverse(previous, current) {
-  const prev = new Set(previous);
-  const cur = new Set(current);
-  return {
-    added: current.filter((k) => !prev.has(k)).sort(),
-    removed: previous.filter((k) => !cur.has(k)).sort()
-  };
-}
-function planSchemaRelease(p) {
-  const changed = p.added.length > 0 || p.removed.length > 0;
-  const last = parseWireVersion(p.lastReleased);
-  const declared = parseWireVersion(p.declared);
-  if (!last || !declared) return { changed, refuse: "Unparseable version: " + p.lastReleased + " / " + p.declared + "." };
-  const requiredVersion = last.a + "." + (last.b + 1);
-  if (!changed) {
-    if (declared.b === last.b && declared.a === last.a) return { changed };
-    const step2 = p.steps.find((s) => s.to === p.declared);
-    return step2 ? { changed, requiredVersion: p.declared } : { changed, refuse: "The version moved to " + p.declared + " with no key change and no step explaining it." };
-  }
-  const requiredKind = p.removed.length ? "converted" /* converted */ : "additive" /* additive */;
-  const summary = p.added.length + " key(s) added, " + p.removed.length + " removed";
-  if (declared.a !== last.a || declared.b !== last.b + 1) {
-    return {
-      changed,
-      requiredKind,
-      requiredVersion,
-      refuse: "The player schema changed (" + summary + ") but PX_PLAYER_SCHEMA_VERSION is " + p.declared + ". Set it to " + requiredVersion + " and add the PLAYER_WIRE_STEPS entry."
-    };
-  }
-  const step = p.steps.find((s) => s.to === p.declared);
-  if (!step) {
-    return { changed, requiredKind, requiredVersion, refuse: "No PLAYER_WIRE_STEPS entry reaches " + p.declared + "." };
-  }
-  if (requiredKind === "converted" /* converted */ && step.kind !== "converted" /* converted */) {
-    return {
-      changed,
-      requiredKind,
-      requiredVersion,
-      refuse: "Keys were REMOVED (" + p.removed.join(", ") + "), which is never additive \u2014 the " + p.declared + " step must be `converted`, with an up()."
-    };
-  }
-  return { changed, requiredKind, requiredVersion };
-}
-function releaseLogProblems(releases, steps, declared, baseline) {
-  const problems = [];
-  if (!releases.length) return ["The release log is empty."];
-  if (!releases[0].baseline || releases[0].version !== baseline) {
-    problems.push("The first release must be the baseline " + baseline + ".");
-  }
-  for (let i = 1; i < releases.length; i++) {
-    const prev = parseWireVersion(releases[i - 1].version);
-    const cur = parseWireVersion(releases[i].version);
-    if (!prev || !cur || cur.a !== prev.a || cur.b !== prev.b + 1) {
-      problems.push("Release " + releases[i].version + " does not follow " + releases[i - 1].version + " by one `b` step.");
-    }
-    if (releases[i].date < releases[i - 1].date) problems.push("Release " + releases[i].version + " is dated before its predecessor.");
-    const step = steps.find((s) => s.to === releases[i].version);
-    if (!step) problems.push("Release " + releases[i].version + " has no PLAYER_WIRE_STEPS entry.");
-    else if (releases[i].removed.length && step.kind !== "converted" /* converted */) {
-      problems.push("Release " + releases[i].version + " removed keys, but its step is not `converted`.");
-    }
-  }
-  const latest = releases[releases.length - 1].version;
-  if (latest !== declared) {
-    problems.push("PX_PLAYER_SCHEMA_VERSION is " + declared + " but the last release record is " + latest + " \u2014 a bump needs its changelog entry (run scripts/schema-release.mjs --apply).");
-  }
-  return problems;
-}
-
 export {
   __spreadValues,
   __spreadProps,
@@ -4817,21 +4431,21 @@ export {
   schemaKeys,
   describeSchema,
   px,
-  PX_PLAYER_SCHEMA_VERSION,
-  WIRE_VERSION_KEY,
-  WireVersionRelation,
+  PX_WIRE_SCHEMA_VERSION,
+  PX_WIRE_VERSION_KEY,
+  PxWireVersionRelation,
   parseWireVersion,
   formatWireVersion,
-  PLAYER_WIRE_VERSION,
+  PX_WIRE_VERSION,
   readWireVersion,
   compareWireVersion,
-  versionAdvice,
-  WireStepKind,
-  BASELINE_PLAYER_VERSION,
-  PLAYER_WIRE_STEPS,
+  wireVersionAdvice,
+  PxWireStepKind,
+  PX_WIRE_BASELINE_VERSION,
+  PX_WIRE_STEPS,
   applyWireSteps,
-  convertPlayerDocument,
-  downgradePlayerDocument,
+  convertWireDocument,
+  downgradeWireDocument,
   PxFillMode,
   PxPlaybackDirection,
   PX_ANIM_SRC_ATTR_NAME,
@@ -4848,7 +4462,7 @@ export {
   PX_TIMELINE_SHARED_KEYS,
   PX_TIME_ONLY_TIMELINE_KEYS,
   PxTimelineEngine,
-  PxTimelineEngineExtra,
+  PxTimelineEngineSetting,
   resolveTimelineEngine,
   isNativeForced,
   mayUseNativeScrollTimeline,
@@ -4867,34 +4481,34 @@ export {
   PxTextPathMethod,
   PxTextPathSpacing,
   PxStrokeTrimSubPaths,
-  TEXT_CONTENT_ATTR,
+  PX_TEXT_CONTENT_ATTR,
   TRANSFORM_ATTR,
   OFFSET_DISTANCE_ATTR,
   TRANSFORM_PART,
   PX_TRANSFORM_PART_KEYS,
   PxGradientSpreadMethod,
   PxGradientType,
-  isPxElementFileFormat,
+  isPxDocument,
   getAnimatorConfig,
   flattenAnimatorTimeline,
   nestAnimatorTimeline,
-  getDefs,
+  getDefinitions,
   getBindings,
   getChildren,
   PxKeyframeValueSchema,
   PxKeyframeSchema,
-  kfTime,
-  kfValue,
-  kfEasing,
-  kfTangentIn,
-  kfTangentOut,
+  keyframeTime,
+  keyframeValue,
+  keyframeEasing,
+  keyframeTangentIn,
+  keyframeTangentOut,
   PxLoopSchema,
   PxPropertyAnimationSchema,
   PxTransformPartsSchema,
   PxTransformValueSchema,
   PxElementAnimationSchema,
   PxTriggerSchema,
-  PxDefsSchema,
+  PxDefinitionsSchema,
   PxScrollRangePointSchema,
   PxScrollRangeSchema,
   PxScrollSchema,
@@ -4915,12 +4529,12 @@ export {
   PxEffectsSchema,
   validateNodeEffects,
   validateDocument,
-  PxNodeBase,
+  PxNodeBaseSchema,
   PxNodeSchema,
-  PxSvgNodeExtra,
+  PxSvgNodeRootSchema,
   PxAnimatedSvgDocumentSchema,
   PxBezierPathSchema,
-  isPxElementFileFormatDeep,
+  isValidPxDocument,
   generateUniqueId,
   deepClone,
   generateNewIds,
@@ -4930,28 +4544,28 @@ export {
   splitEasing,
   reverseEasing,
   toRGBA,
-  COLOR_ATTR_NAMES,
-  TRANSFORM_FN_NAMES,
-  PCT_BASED_ATTR_NAMES,
+  PX_COLOR_ATTR_NAMES,
+  PX_TRANSFORM_FN_NAMES,
+  PX_PCT_BASED_ATTR_NAMES,
   composeTransformParts,
-  STYLE_ATTR_NAMES,
-  DEFAULT_DURATION_MS,
+  PX_STYLE_ATTR_NAMES,
+  PX_DEFAULT_DURATION_MS,
   kebabToCamelCaseWord,
   camelCaseToKebabWordIfNeeded,
   clamp,
   bezier2D_arcLengthLUT,
-  DISALLOWED_SVG_TAGS_LOWER,
-  CSS_ONLY_STYLE_PROPS,
+  PX_DISALLOWED_SVG_TAGS_LOWER,
+  PX_CSS_ONLY_STYLE_PROPS,
   sanitizeAttributeValue,
-  getNormalizedProps,
+  toDomProps,
   materializeMotionPathInPropAnim,
   materializeMotionPathsInTree,
-  LOOP_JUMP_SHIFT_MS,
+  PX_LOOP_JUMP_SHIFT_MS,
   parseSvgPathToBezier,
   interpolateValue,
   materializeInternalLoopsInTree,
   mergeStaticTransformIntoAnimDef,
-  getNormalizedBindings,
+  normalizeBindings,
   calcAnimationValues,
   partsRecord,
   readAnimatable,
@@ -4978,17 +4592,6 @@ export {
   PxDiagnosticKind,
   createDiagnostics,
   diagnoseDocument,
-  reportDocumentDiagnostics,
-  diffInEffect,
-  isScrollTimeline,
-  scrollTotalDurationMs,
-  scrollPhaseInterval,
-  scrollViewProgress,
-  scrollOffsetProgress,
-  scrollResolveAxis,
-  schemaFieldUniverse,
-  diffFieldUniverse,
-  planSchemaRelease,
-  releaseLogProblems
+  reportDocumentDiagnostics
 };
-//# sourceMappingURL=chunk-PAE3NF2U.js.map
+//# sourceMappingURL=chunk-BOTZI36B.js.map