@pixodesk/svg-animator-web 1.0.40 → 1.0.43

package/dist/pixodesk-svg-animator.umd.js

@@ -55,7 +55,7 @@ var PixodeskAnimator = (() => {
     PX_ANIM_ATTR_NAME: () => PX_ANIM_ATTR_NAME,
     PX_ANIM_SRC_ATTR_NAME: () => PX_ANIM_SRC_ATTR_NAME,
     PxTimelineEngine: () => PxTimelineEngine,
-    PxTimelineEngineExtra: () => PxTimelineEngineExtra,
+    PxTimelineEngineSetting: () => PxTimelineEngineSetting,
     createAnimator: () => createAnimator,
     generateNewIds: () => generateNewIds,
     loadTagAnimators: () => loadTagAnimators,
@@ -553,7 +553,7 @@ var PixodeskAnimator = (() => {
      * 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: []. */
@@ -571,7 +571,7 @@ var PixodeskAnimator = (() => {
   };
 
   // ../svg-animator-core/src/version/PxSchemaVersion.ts
-  var PX_PLAYER_SCHEMA_VERSION = "1.1";
+  var PX_WIRE_SCHEMA_VERSION = "1.1";
 
   // ../svg-animator-core/src/version/PxWireVersion.ts
   var VERSION_RE = /^(\d+)\.(\d+)(?:\.(\d+))?$/;
@@ -582,7 +582,7 @@ var PixodeskAnimator = (() => {
     return { a: Number(m[1]), b: Number(m[2]), c: m[3] === void 0 ? 0 : Number(m[3]) };
   }
   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 };
 
   // ../svg-animator-core/src/format/PxAnimatorConstants.ts
   var PxFillMode = {
@@ -661,17 +661,17 @@ var PixodeskAnimator = (() => {
     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",
@@ -732,7 +732,7 @@ var PixodeskAnimator = (() => {
     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";
@@ -743,7 +743,7 @@ var PixodeskAnimator = (() => {
     "meta",
     "animate",
     "effects",
-    TEXT_CONTENT_ATTR
+    PX_TEXT_CONTENT_ATTR
   ]);
   var TRANSFORM_PART = {
     translate: "translate",
@@ -766,11 +766,11 @@ var PixodeskAnimator = (() => {
     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;
@@ -831,7 +831,7 @@ var PixodeskAnimator = (() => {
     flattenMemo.set(cfg, flat);
     return flat;
   }
-  function getDefs(doc) {
+  function getDefinitions(doc) {
     var _a2;
     if (!doc) return void 0;
     return (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.definitions;
@@ -874,20 +874,20 @@ var PixodeskAnimator = (() => {
     // 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(),
@@ -941,7 +941,7 @@ var PixodeskAnimator = (() => {
     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()
@@ -979,7 +979,7 @@ var PixodeskAnimator = (() => {
     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,
@@ -1033,7 +1033,7 @@ var PixodeskAnimator = (() => {
     // 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
@@ -1122,7 +1122,7 @@ var PixodeskAnimator = (() => {
     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(),
@@ -1159,11 +1159,11 @@ var PixodeskAnimator = (() => {
     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);
@@ -1224,9 +1224,9 @@ var PixodeskAnimator = (() => {
     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") {
@@ -1246,7 +1246,7 @@ var PixodeskAnimator = (() => {
     }
     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`,
@@ -1261,7 +1261,7 @@ var PixodeskAnimator = (() => {
     // `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.
@@ -1269,7 +1269,7 @@ var PixodeskAnimator = (() => {
     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
@@ -1278,10 +1278,10 @@ var PixodeskAnimator = (() => {
     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(),
@@ -1289,7 +1289,7 @@ var PixodeskAnimator = (() => {
     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()
@@ -1648,9 +1648,9 @@ var PixodeskAnimator = (() => {
     }
     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 "";
@@ -1703,8 +1703,8 @@ var PixodeskAnimator = (() => {
     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;
   }
@@ -1867,7 +1867,7 @@ var PixodeskAnimator = (() => {
   }
 
   // ../svg-animator-core/src/util/PxNodeProps.ts
-  var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
+  var PX_DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
     "script",
     "foreignobject"
   ]);
@@ -1892,7 +1892,7 @@ var PixodeskAnimator = (() => {
     // 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;
@@ -1929,19 +1929,19 @@ var PixodeskAnimator = (() => {
     }
     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(",");
@@ -1959,7 +1959,7 @@ var PixodeskAnimator = (() => {
 
   // ../svg-animator-core/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]];
@@ -1969,17 +1969,17 @@ var PixodeskAnimator = (() => {
     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;
   }
@@ -1988,8 +1988,8 @@ var PixodeskAnimator = (() => {
     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);
@@ -2082,7 +2082,7 @@ var PixodeskAnimator = (() => {
   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;
@@ -2099,7 +2099,7 @@ var PixodeskAnimator = (() => {
     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;
   }
@@ -2161,7 +2161,7 @@ var PixodeskAnimator = (() => {
   }
   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);
@@ -2343,7 +2343,7 @@ var PixodeskAnimator = (() => {
   }
 
   // ../svg-animator-core/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;
@@ -2519,7 +2519,7 @@ var PixodeskAnimator = (() => {
       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)) {
@@ -2528,7 +2528,7 @@ var PixodeskAnimator = (() => {
     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);
@@ -2580,8 +2580,8 @@ var PixodeskAnimator = (() => {
       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;
@@ -2647,7 +2647,7 @@ var PixodeskAnimator = (() => {
           }
         }
         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
         };
@@ -2734,14 +2734,14 @@ var PixodeskAnimator = (() => {
     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 = {
@@ -2749,8 +2749,8 @@ var PixodeskAnimator = (() => {
         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);
@@ -2782,17 +2782,17 @@ var PixodeskAnimator = (() => {
     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;
@@ -2857,7 +2857,7 @@ var PixodeskAnimator = (() => {
       }
       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];
@@ -2886,9 +2886,9 @@ var PixodeskAnimator = (() => {
     }
     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) => {
@@ -2958,7 +2958,7 @@ var PixodeskAnimator = (() => {
     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);
@@ -2977,7 +2977,7 @@ var PixodeskAnimator = (() => {
         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],
@@ -3058,7 +3058,7 @@ var PixodeskAnimator = (() => {
       );
       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 };
@@ -3623,11 +3623,11 @@ var PixodeskAnimator = (() => {
     const loopFromSource = read.loop;
     let stopCount = 0;
     for (const kf of kfs) {
-      const v = kfValue(kf);
+      const v = keyframeValue(kf);
       if (Array.isArray(v) && v.length > stopCount) stopCount = v.length;
     }
     if (!stopCount) return [];
-    const firstKfValue = kfValue(kfs[0]);
+    const firstKfValue = keyframeValue(kfs[0]);
     const baselineStops = [];
     for (let i = 0; i < stopCount; i++) {
       const s = (_b = (_a2 = firstKfValue == null ? void 0 : firstKfValue[i]) != null ? _a2 : prevDefinedStop(kfs, 0, i)) != null ? _b : { offset: i / Math.max(1, stopCount - 1), color: "#000000" };
@@ -3648,11 +3648,11 @@ var PixodeskAnimator = (() => {
     const offsetKfs = [];
     let offsetVaries = false;
     for (const kf of kfs) {
-      const t = kfTime(kf);
-      const arr = kfValue(kf);
+      const t = keyframeTime(kf);
+      const arr = keyframeValue(kf);
       const sliced = (_a2 = arr == null ? void 0 : arr[stopIdx]) != null ? _a2 : prevDefinedStop(kfs, kfs.indexOf(kf), stopIdx);
       if (!sliced) continue;
-      const easing = kfEasing(kf);
+      const easing = keyframeEasing(kf);
       const colorOut = { time: t, value: sliced.color };
       if (easing !== void 0) colorOut.easing = easing;
       colorKfs.push(colorOut);
@@ -3680,11 +3680,11 @@ var PixodeskAnimator = (() => {
   }
   function prevDefinedStop(kfs, fromIdx, stopIdx) {
     for (let i = fromIdx; i >= 0; i--) {
-      const arr = kfValue(kfs[i]);
+      const arr = keyframeValue(kfs[i]);
       if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
     }
     for (let i = fromIdx + 1; i < kfs.length; i++) {
-      const arr = kfValue(kfs[i]);
+      const arr = keyframeValue(kfs[i]);
       if (arr == null ? void 0 : arr[stopIdx]) return arr[stopIdx];
     }
     return void 0;
@@ -4665,7 +4665,7 @@ var PixodeskAnimator = (() => {
     "stroke",
     "strokeWidth",
     "effects",
-    TEXT_CONTENT_ATTR,
+    PX_TEXT_CONTENT_ATTR,
     "xml:space"
   ];
   var PAINT_STATIC_KEYS = [
@@ -4819,13 +4819,13 @@ var PixodeskAnimator = (() => {
       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") {
@@ -4843,7 +4843,7 @@ var PixodeskAnimator = (() => {
     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) {
@@ -5214,7 +5214,7 @@ var PixodeskAnimator = (() => {
     if (r.kind === "static" /* Static */) return [r.value];
     const out = [];
     for (const kf of r.keyframes) {
-      const v = kfValue(kf);
+      const v = keyframeValue(kf);
       if (typeof v === "number") out.push(v);
     }
     return out;
@@ -5225,9 +5225,9 @@ var PixodeskAnimator = (() => {
     return {
       kind: "animated" /* Animated */,
       keyframes: read.keyframes.map((kf) => ({
-        time: kfTime(kf),
-        value: map(kfValue(kf)),
-        easing: kfEasing(kf)
+        time: keyframeTime(kf),
+        value: map(keyframeValue(kf)),
+        easing: keyframeEasing(kf)
       })),
       loop: read.loop
     };
@@ -5245,7 +5245,7 @@ var PixodeskAnimator = (() => {
     let anyHide = false;
     let allHide = true;
     for (const kf of kfs) {
-      if (hide(kfValue(kf))) anyHide = true;
+      if (hide(keyframeValue(kf))) anyHide = true;
       else allHide = false;
     }
     if (!anyHide) return void 0;
@@ -5255,10 +5255,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 = kfTime(kf);
-      const thisHide = hide(kfValue(kf));
-      const prevHide = prevKf ? thisHide && hide(kfValue(prevKf)) : thisHide;
-      const nextHide = nextKf ? thisHide && hide(kfValue(nextKf)) : thisHide;
+      const t = keyframeTime(kf);
+      const thisHide = hide(keyframeValue(kf));
+      const prevHide = prevKf ? thisHide && hide(keyframeValue(prevKf)) : thisHide;
+      const nextHide = nextKf ? thisHide && hide(keyframeValue(nextKf)) : thisHide;
       if (prevHide && !nextHide) {
         out.push({ time: t, value: 0 });
         out.push({ time: t + OPACITY_STEP_MS, value: 1 });
@@ -5274,9 +5274,9 @@ var PixodeskAnimator = (() => {
     const r = readAnimatable(raw);
     if (r.kind !== "animated" /* Animated */) return r;
     const kfs = r.keyframes.map((kf) => ({
-      time: kfTime(kf),
-      value: kfValue(kf),
-      easing: kfEasing(kf)
+      time: keyframeTime(kf),
+      value: keyframeValue(kf),
+      easing: keyframeEasing(kf)
     }));
     const hasReverse = kfs.some((kf) => kf.value[0] > kf.value[1]);
     if (!hasReverse) {
@@ -5404,7 +5404,7 @@ var PixodeskAnimator = (() => {
   }
 
   // ../svg-animator-core/src/effects/PlayerEffectsUtil.ts
-  function applyPlayerEffects(root) {
+  function materializeNodeEffects(root) {
     var _a2, _b;
     const ctx = {
       defs: [],
@@ -5417,7 +5417,7 @@ var PixodeskAnimator = (() => {
       // 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: resolveTimelineEngine((_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.engine),
-      glyphs: (_b = getDefs(root)) == null ? void 0 : _b.fonts
+      glyphs: (_b = getDefinitions(root)) == null ? void 0 : _b.fonts
     };
     const working = clone(root);
     indexById(working, ctx.idMap);
@@ -5501,11 +5501,11 @@ var PixodeskAnimator = (() => {
     if (propAnim.alongPathMode !== "offsetPath") return void 0;
     const kfs = propAnim.keyframes;
     if (!kfs || kfs.length < 2) return void 0;
-    const first = kfValue(kfs[0]);
+    const first = keyframeValue(kfs[0]);
     const anchor = (first == null ? void 0 : first.origin) && first.origin.length >= 2 ? [first.origin[0], first.origin[1]] : [0, 0];
     const points = [];
     for (const kf of kfs) {
-      const v = kfValue(kf);
+      const v = keyframeValue(kf);
       const tr = v == null ? void 0 : v.translate;
       if (!tr || tr.length < 2) return void 0;
       const parts = Object.keys(v);
@@ -5514,13 +5514,13 @@ var PixodeskAnimator = (() => {
       if (o[0] !== anchor[0] || o[1] !== anchor[1]) return void 0;
       points.push([tr[0] + anchor[0], tr[1] + anchor[1]]);
     }
-    if (!kfs.some((kf) => kfTangentIn(kf) || kfTangentOut(kf))) return void 0;
+    if (!kfs.some((kf) => keyframeTangentIn(kf) || keyframeTangentOut(kf))) return void 0;
     let d = "M" + fmt2(points[0][0]) + "," + fmt2(points[0][1]);
     const segLens = [];
     for (let i = 0; i < points.length - 1; i++) {
       const p0 = points[i], p1 = points[i + 1];
-      const to = (_b = kfTangentOut(kfs[i])) != null ? _b : [0, 0];
-      const ti = (_c = kfTangentIn(kfs[i + 1])) != null ? _c : [0, 0];
+      const to = (_b = keyframeTangentOut(kfs[i])) != null ? _b : [0, 0];
+      const ti = (_c = keyframeTangentIn(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]);
@@ -5532,8 +5532,8 @@ var PixodeskAnimator = (() => {
     let cum = 0;
     for (let i = 0; i < kfs.length; i++) {
       if (i > 0) cum += segLens[i - 1];
-      const out = { t: kfTime(kfs[i]), v: cum / total };
-      const e = kfEasing(kfs[i]);
+      const out = { t: keyframeTime(kfs[i]), v: cum / total };
+      const e = keyframeEasing(kfs[i]);
       if (e !== void 0) out.e = e;
       distanceKfs.push(out);
     }
@@ -5732,14 +5732,14 @@ var PixodeskAnimator = (() => {
   }
 
   // ../svg-animator-core/src/materialize/PxAnimatorMaterializeAll.ts
-  function materializeAllInTree(doc, engine, opts) {
+  function materializeAllInTree(doc, engine, options) {
     var _a2, _b;
-    let root = applyPlayerEffects(doc).root;
+    let root = materializeNodeEffects(doc).root;
     root = materializeOffsetPathsInTree(root);
-    const duration = (_b = (_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.duration) != null ? _b : DEFAULT_DURATION_MS;
+    const duration = (_b = (_a2 = getAnimatorConfig(root)) == null ? void 0 : _a2.duration) != null ? _b : PX_DEFAULT_DURATION_MS;
     root = materializeInternalLoopsInTree(root, duration);
     if (engine === PxTimelineEngine.native) {
-      root = materializeMotionPathsInTree(root, opts == null ? void 0 : opts.motionPath);
+      root = materializeMotionPathsInTree(root, options == null ? void 0 : options.motionPath);
       root = materializeAnimatedUseInstances(root);
       root = pruneUnreferencedDefs(root);
     }
@@ -5823,16 +5823,16 @@ var PixodeskAnimator = (() => {
     }
     g.clearTimeout(handle);
   }
-  function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
+  function createAdapterAnimator(doc, adapter, callbacks) {
     var _a2;
     const config = getAnimatorConfig(doc) || {};
-    const bindings = getNormalizedBindings(doc, PxTimelineEngine.js);
+    const bindings = normalizeBindings(doc, PxTimelineEngine.js);
     const _iterations = config.iterations;
     let iterations = 1;
     if (typeof _iterations === "number") iterations = _iterations || 1;
     if (_iterations === "infinite") iterations = Infinity;
     if (iterations < 1) iterations = 1;
-    const duration = +(config.duration || DEFAULT_DURATION_MS);
+    const duration = +(config.duration || PX_DEFAULT_DURATION_MS);
     const totalDuration = duration && iterations ? duration * (iterations === Infinity ? Infinity : iterations) : duration ? (iterations != null ? iterations : 1) * duration : 0;
     const direction = config.direction || "normal";
     const fill = (_a2 = config.fill) != null ? _a2 : "forwards";
@@ -6103,32 +6103,34 @@ var PixodeskAnimator = (() => {
     /** 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);
       }
     };
   }
@@ -6251,9 +6253,9 @@ var PixodeskAnimator = (() => {
     }
     return { config: out, warnings };
   }
-  function applyAnimatorConfig(doc, patch, opts) {
+  function applyAnimatorConfig(doc, patch, options) {
     var _a2, _b;
-    const reset = !!(opts == null ? void 0 : opts.resetDefaults);
+    const reset = !!(options == null ? void 0 : options.resetTimeline);
     if (!doc || (patch === void 0 || !reset && (patch === null || !isPlainObject(patch) || !Object.keys(patch).length))) {
       return { doc, warnings: [] };
     }
@@ -6309,7 +6311,7 @@ var PixodeskAnimator = (() => {
     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 duration = typeof (config == null ? void 0 : config.duration) === "number" && config.duration > 0 ? config.duration : PX_DEFAULT_DURATION_MS;
     const iterations = typeof (config == null ? void 0 : config.iterations) === "number" && config.iterations > 0 ? config.iterations : 1;
     return duration * iterations;
   }
@@ -6384,16 +6386,16 @@ var PixodeskAnimator = (() => {
   }
 
   // src/triggers/PxAnimatorTriggers.ts
-  function setupAnimationTriggers(api, config, diag) {
+  function setupAnimationTriggers(api, trigger, diag) {
     const report = diag != null ? diag : createDiagnostics(void 0, "[PxAnimator]");
     const cleanups = [];
     const dispose = () => {
       for (const undo of cleanups.splice(0)) undo();
     };
-    const { startOn, outAction, scrollIntoViewThreshold } = resolveTrigger(config);
+    const { startOn, outAction, scrollIntoViewThreshold } = resolveTrigger(trigger);
     const root = api.getRootElement();
     if (!root) {
-      report.warn(PxDiagnosticKind.host, "setupAnimationTriggers: No root element found for animation.");
+      report.warn(PxDiagnosticKind.host, 1201 /* triggersNoRoot */);
       return dispose;
     }
     let reversed = false;
@@ -6512,12 +6514,12 @@ var PixodeskAnimator = (() => {
       if (doc.id) {
         const rootSelector = getSelector(doc.id);
         rootElement = document.querySelector(rootSelector);
-        if (!rootElement) diag.warn(PxDiagnosticKind.host, "createFrameLoopAnimator: No root element found for selector: " + rootSelector);
+        if (!rootElement) diag.warn(PxDiagnosticKind.host, 1202 /* noRootForSelector */, rootSelector);
       } else {
-        diag.warn(PxDiagnosticKind.host, "createFrameLoopAnimator: No root element provided");
+        diag.warn(PxDiagnosticKind.host, 1203 /* noRootElement */);
       }
     }
-    const basicApi = createBasicFrameLoopAnimator(
+    const basicApi = createAdapterAnimator(
       doc,
       adapter || createDomAdapter(rootElement, diag),
       callbacks
@@ -6526,7 +6528,7 @@ var PixodeskAnimator = (() => {
       "getRootElement": () => rootElement || null
     });
     if (isScrollTimeline(config)) {
-      if (config.trigger) diag.warn(PxDiagnosticKind.usage, "scroll timeline: `animator.trigger` is ignored (triggers do not apply to scroll-driven playback)");
+      if (config.trigger) diag.warn(PxDiagnosticKind.usage, 1306 /* scrollTriggerIgnored */);
     } else {
       const detachTriggers = setupAnimationTriggers(api, (_a2 = config.trigger) != null ? _a2 : {}, diag);
       const destroyEngine = api.destroy.bind(api);
@@ -6551,13 +6553,13 @@ var PixodeskAnimator = (() => {
         const elements = (rootElement == null ? void 0 : rootElement.querySelectorAll(selector)) || document.querySelectorAll(selector);
         if (elements.length === 0 && !warnedSelectors.has(selector)) {
           warnedSelectors.add(selector);
-          report.warn(PxDiagnosticKind.host, 'setAttribute: No elements found for selector "' + selector + '"');
+          report.warn(PxDiagnosticKind.host, 1207 /* setAttributeNoElement */, selector);
         }
         for (let i = 0; i < elements.length; i++) {
           const element = elements[i];
           const effectiveAttrName = attrName === "transform" && element.tagName === "pattern" ? "patternTransform" : attrName;
           element.setAttribute(effectiveAttrName, value);
-          if (STYLE_ATTR_NAMES.has(attrName)) {
+          if (PX_STYLE_ATTR_NAMES.has(attrName)) {
             element.style[attrName] = value;
           }
         }
@@ -6568,20 +6570,20 @@ var PixodeskAnimator = (() => {
 
   // src/engines/PxAnimatorWebApi.ts
   function createCssKf(kf, t, propName, unsupportedSet) {
-    let value = kfValue(kf);
-    const e = kfEasing(kf);
+    let value = keyframeValue(kf);
+    const e = keyframeEasing(kf);
     const cssKf = {
       offset: t,
       easing: e && Array.isArray(e) ? "cubic-bezier(" + e.join(",") + ")" : void 0
     };
     let cssValue;
     let cssKey = propName;
-    if (COLOR_ATTR_NAMES.has(propName) && Array.isArray(value)) {
+    if (PX_COLOR_ATTR_NAMES.has(propName) && Array.isArray(value)) {
       cssValue = toRGBA(value);
     } else if (propName === "transform" && value !== null && typeof value === "object" && !Array.isArray(value)) {
       cssValue = composeTransformParts(value, { withUnits: true });
       cssKey = "transform";
-    } else if (TRANSFORM_FN_NAMES.has(propName)) {
+    } else if (PX_TRANSFORM_FN_NAMES.has(propName)) {
       if (Array.isArray(value)) {
         if (propName === "translate") value = value.map((v) => v + "px");
         value = value.join(",");
@@ -6592,7 +6594,7 @@ var PixodeskAnimator = (() => {
     } else if (propName === "d") {
       const paths = value && typeof value === "object" && Array.isArray(value.paths) ? value.paths : [];
       cssValue = 'path("' + paths.map((bz) => bezierToSvgPath(bz, true)).join("") + '")';
-    } else if (PCT_BASED_ATTR_NAMES.has(propName) && typeof value === "number") {
+    } else if (PX_PCT_BASED_ATTR_NAMES.has(propName) && typeof value === "number") {
       cssValue = value * 100 + "%";
     } else {
       cssValue = "" + value;
@@ -6670,12 +6672,12 @@ var PixodeskAnimator = (() => {
       if (doc.id) {
         const rootSelector = getSelector(doc.id);
         rootElement = document.querySelector(rootSelector);
-        if (!rootElement) diag.warn(PxDiagnosticKind.host, "createWebApiAnimator: No root element found for selector: " + rootSelector);
+        if (!rootElement) diag.warn(PxDiagnosticKind.host, 1202 /* noRootForSelector */, rootSelector);
       } else {
-        diag.warn(PxDiagnosticKind.host, "createWebApiAnimator: No root element provided");
+        diag.warn(PxDiagnosticKind.host, 1203 /* noRootElement */);
       }
     }
-    const bindings = getNormalizedBindings(doc, PxTimelineEngine.native);
+    const bindings = normalizeBindings(doc, PxTimelineEngine.native);
     const animations = [];
     const _iterations = config.iterations;
     let iterations;
@@ -6685,18 +6687,18 @@ var PixodeskAnimator = (() => {
     let finishNotified = false;
     let removeCalled = false;
     if (!(bindings == null ? void 0 : bindings.length)) {
-      diag.warn(PxDiagnosticKind.document, "createWebApiAnimator: No animation bindings defined");
+      diag.warn(PxDiagnosticKind.document, 1105 /* noBindings */);
     }
     for (const binding of bindings || []) {
       const animDef = binding.animate;
       if (!animDef || typeof animDef !== "object" || Array.isArray(animDef)) {
-        diag.warn(PxDiagnosticKind.document, "createWebApiAnimator: Empty or unresolved binding", binding);
+        diag.warn(PxDiagnosticKind.document, 1106 /* unresolvedBinding */, binding);
         continue;
       }
       const selector = getSelector(binding.id);
       const elements = (rootElement == null ? void 0 : rootElement.querySelectorAll(selector)) || document.querySelectorAll(selector);
       if (elements.length === 0) {
-        diag.warn(PxDiagnosticKind.host, 'createWebApiAnimator: No elements found for selector "' + selector + '"');
+        diag.warn(PxDiagnosticKind.host, 1206 /* noElementsForSelector */, selector);
       }
       const keyframesMap = convertToWebApiKeyframes(animDef, unsupportedSet, config);
       const positiveDelay = config.delay && config.delay > 0 ? config.delay : void 0;
@@ -6745,14 +6747,14 @@ var PixodeskAnimator = (() => {
               }
               animations.push(anim);
             } catch (e) {
-              diag.warn(PxDiagnosticKind.internal, "createWebApiAnimator: could not build the animation", e);
+              diag.warn(PxDiagnosticKind.internal, 1004 /* animationBuildFailed */, e);
             }
           }
         }
       }
     }
     if (!forceEvenIfHasUnsupportedAttrs && unsupportedSet.size) {
-      diag.warn(PxDiagnosticKind.platform, "Unsupported CSS attrs: " + [...unsupportedSet].join(", "));
+      diag.warn(PxDiagnosticKind.platform, 1104 /* unsupportedAnimatedAttrs */, [...unsupportedSet].join(", "));
       return null;
     }
     const api = {
@@ -6797,7 +6799,7 @@ var PixodeskAnimator = (() => {
       },
       "setPlaybackRate": (rate) => {
         if (!isValidPlaybackRate(rate)) {
-          diag.warn(PxDiagnosticKind.usage, PX_RATE_REJECTED);
+          diag.warn(PxDiagnosticKind.usage, 1401 /* rateRejected */);
           return api;
         }
         animations.forEach((a) => a.playbackRate = rate);
@@ -6837,7 +6839,7 @@ var PixodeskAnimator = (() => {
       }
     };
     if (config.timelineSource === "scroll") {
-      if (config.trigger) diag.warn(PxDiagnosticKind.usage, "scroll timeline: `animator.trigger` is ignored (triggers do not apply to scroll-driven playback)");
+      if (config.trigger) diag.warn(PxDiagnosticKind.usage, 1306 /* scrollTriggerIgnored */);
     } else {
       const detachTriggers = setupAnimationTriggers(api, (_b = config.trigger) != null ? _b : {}, diag);
       const destroyEngine = api.destroy.bind(api);
@@ -6867,7 +6869,7 @@ var PixodeskAnimator = (() => {
     const scroll = config.scroll || {};
     const kind = (_a2 = scroll.kind) != null ? _a2 : "view";
     if (scroll.smoothing) {
-      report.warn(PxDiagnosticKind.platform, "scroll timeline: `smoothing` needs the built-in driver \u2014 using the built-in driver instead of the browser timeline");
+      report.warn(PxDiagnosticKind.platform, 1301 /* scrollSmoothingNeedsOwnDriver */);
       return null;
     }
     const g = globalThis;
@@ -6884,7 +6886,7 @@ var PixodeskAnimator = (() => {
         timeline = new Ctor({ source, axis });
       }
     } catch (e) {
-      report.warn(PxDiagnosticKind.platform, "scroll timeline: native timeline construction failed \u2014 falling back to the player measuring progress itself", e);
+      report.warn(PxDiagnosticKind.platform, 1302 /* scrollNativeUnavailable */, e);
       return null;
     }
     return {
@@ -6931,11 +6933,11 @@ var PixodeskAnimator = (() => {
     try {
       found = document.querySelector(spec);
     } catch (e) {
-      report.warn(PxDiagnosticKind.document, 'scroll timeline: subject "' + spec + '" is not a valid selector \u2014 measuring the SVG itself');
+      report.warn(PxDiagnosticKind.document, 1303 /* scrollSubjectInvalid */, spec);
       return svgRoot;
     }
     if (!found) {
-      report.warn(PxDiagnosticKind.host, 'scroll timeline: subject "' + spec + '" matched no element \u2014 measuring the SVG itself');
+      report.warn(PxDiagnosticKind.host, 1304 /* scrollSubjectNoMatch */, spec);
       return svgRoot;
     }
     return found;
@@ -7157,7 +7159,7 @@ var PixodeskAnimator = (() => {
           unpin = () => {
           };
         }
-        const api = (animatorConfig.engine !== PxTimelineEngineExtra.js ? createWebApiAnimator(doc, cb, rootElement, isNativeForced(animatorConfig.engine)) : null) || createFrameLoopAnimator(doc, adapter, cb, rootElement);
+        const api = (animatorConfig.engine !== PxTimelineEngineSetting.js ? createWebApiAnimator(doc, cb, rootElement, isNativeForced(animatorConfig.engine)) : null) || createFrameLoopAnimator(doc, adapter, cb, rootElement);
         const subject = ((_a2 = api.getRootElement) == null ? void 0 : _a2.call(api)) || rootElement;
         if (subject) {
           unpin = applyScrollPin(subject, animatorConfig.scroll);
@@ -7177,13 +7179,13 @@ var PixodeskAnimator = (() => {
             };
           }
         } else {
-          diag.warn(PxDiagnosticKind.host, "scroll timeline: no root element to observe \u2014 animation will stay at frame 0");
+          diag.warn(PxDiagnosticKind.host, 1305 /* scrollNoRootToObserve */);
         }
         return api;
       });
     }
     return finaliseAnimator(animatorConfig, callbacks, (cb) => {
-      if (animatorConfig.engine === PxTimelineEngineExtra.js) {
+      if (animatorConfig.engine === PxTimelineEngineSetting.js) {
         return createFrameLoopAnimator(doc, adapter, cb, rootElement);
       }
       return createWebApiAnimator(
@@ -7198,15 +7200,15 @@ var PixodeskAnimator = (() => {
   // src/dom/PxAnimatorDOM.ts
   var SVG_NS = "http://www.w3.org/2000/svg";
   function createElement(tagName, normalizedProps, style, children, textContent, diag) {
-    if (DISALLOWED_SVG_TAGS_LOWER.has(tagName.toLowerCase())) {
-      (diag != null ? diag : createDiagnostics(void 0, "[PxAnimator]")).warn(PxDiagnosticKind.document, "SVG tag blocked (dangerous): " + tagName);
+    if (PX_DISALLOWED_SVG_TAGS_LOWER.has(tagName.toLowerCase())) {
+      (diag != null ? diag : createDiagnostics(void 0, "[PxAnimator]")).warn(PxDiagnosticKind.document, 1103 /* blockedTag */, tagName);
       return null;
     }
     const element = document.createElementNS(SVG_NS, tagName);
     for (const propName in normalizedProps) {
       const sanitized = sanitizeAttributeValue(propName, normalizedProps[propName]);
       if (sanitized === void 0) continue;
-      if (CSS_ONLY_STYLE_PROPS.has(propName)) {
+      if (PX_CSS_ONLY_STYLE_PROPS.has(propName)) {
         element.style[propName] = String(sanitized);
         continue;
       }
@@ -7231,7 +7233,7 @@ var PixodeskAnimator = (() => {
     const _a2 = node, { type, children, style } = _a2, props = __objRest(_a2, ["type", "children", "style"]);
     const domType = props.domType;
     if (domType !== void 0) delete props.domType;
-    const nodeDefs = getDefs(node) || defs;
+    const nodeDefs = getDefinitions(node) || defs;
     const resolvedStyle = style;
     let childElements;
     if (children) {
@@ -7245,10 +7247,10 @@ var PixodeskAnimator = (() => {
     }
     const element = createElement(
       type || "g",
-      getNormalizedProps(props),
+      toDomProps(props),
       resolvedStyle,
       childElements,
-      props[TEXT_CONTENT_ATTR],
+      props[PX_TEXT_CONTENT_ATTR],
       diag
     );
     if (element && domType !== void 0) element.setAttribute("type", domType);
@@ -7265,11 +7267,11 @@ var PixodeskAnimator = (() => {
   function createAnimatorImpl(doc, adapter, callbacks, containerElement, patch, resetTimeline) {
     const diag = createDiagnostics(callbacks, "[PxAnimator]");
     const effectsWarnings = validateNodeEffects(doc);
-    for (const w of effectsWarnings) diag.warn(PxDiagnosticKind.document, "effects shape: " + w);
+    for (const w of effectsWarnings) diag.warn(PxDiagnosticKind.document, 1101 /* effectsShape */, w);
     reportDocumentDiagnostics(doc, "[PxAnimator] createAnimator");
     if (patch !== void 0 || resetTimeline) {
-      const patched = applyAnimatorConfig(doc, patch != null ? patch : {}, { resetDefaults: !!resetTimeline });
-      for (const w of patched.warnings) diag.warn(PxDiagnosticKind.usage, "timeline override: " + w);
+      const patched = applyAnimatorConfig(doc, patch != null ? patch : {}, { resetTimeline: !!resetTimeline });
+      for (const w of patched.warnings) diag.warn(PxDiagnosticKind.usage, 1102 /* timelineOverrideIgnored */, w);
       doc = patched.doc;
     }
     const animatorConfig = getAnimatorConfig(doc) || {};
@@ -7332,16 +7334,16 @@ var PixodeskAnimator = (() => {
       pending = null;
       queued == null ? void 0 : queued.forEach((call) => call(api));
     };
-    const failed = (kind, message, detail) => {
+    const failed = (kind, code, ...data) => {
       pending = null;
-      diag.error(kind, message, detail);
+      diag.error(kind, code, ...data);
     };
     const build = (document2) => {
       try {
         ready(createAnimatorImpl(document2, adapter, callbacks, container, patch, resetTimeline));
       } catch (e) {
         const err = asThrownError(e);
-        failed(PxDiagnosticKind.internal, "createAnimator: could not build the player \u2014 " + err.message, err);
+        failed(PxDiagnosticKind.internal, 1001 /* buildFailed */, err);
       }
     };
     if (doc !== void 0) {
@@ -7349,11 +7351,11 @@ var PixodeskAnimator = (() => {
     } else {
       fetch(src).then((res) => res.json()).then((json) => {
         if (destroyed) return;
-        if (isPxElementFileFormat(json)) build(json);
-        else failed(PxDiagnosticKind.document, 'createAnimator: invalid animation document format at "' + src + '"');
+        if (isPxDocument(json)) build(json);
+        else failed(PxDiagnosticKind.document, 1002 /* invalidDocumentAtSrc */, src);
       }).catch((err) => {
         var _a2;
-        failed(PxDiagnosticKind.host, 'createAnimator: failed to load "' + src + '" \u2014 ' + ((_a2 = err == null ? void 0 : err.message) != null ? _a2 : String(err)));
+        failed(PxDiagnosticKind.host, 1003 /* loadFailed */, src, (_a2 = err == null ? void 0 : err.message) != null ? _a2 : String(err));
       });
     }
     return {