@pixodesk/svg-animator-web 1.0.40 → 1.0.43

package/dist/index.cjs

@@ -49,28 +49,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  PX_ANIMATOR_DOC_KEY: () => PX_ANIMATOR_DOC_KEY,
   PxAnimatorConfigSchema: () => PxAnimatorConfigSchema,
-  PxDefsSchema: () => PxDefsSchema,
+  PxDefinitionsSchema: () => PxDefinitionsSchema,
   PxDiagnosticKind: () => PxDiagnosticKind,
-  PxNodeBase: () => PxNodeBase,
+  PxNodeBaseSchema: () => PxNodeBaseSchema,
   PxScrollSchema: () => PxScrollSchema,
-  PxSvgNodeExtra: () => PxSvgNodeExtra,
-  PxTimelineEngineExtra: () => PxTimelineEngineExtra,
+  PxSvgNodeRootSchema: () => PxSvgNodeRootSchema,
+  PxTimelineEngineSetting: () => PxTimelineEngineSetting,
   PxTriggerSchema: () => PxTriggerSchema,
+  createAdapterAnimator: () => createAdapterAnimator,
   createAnimator: () => createAnimator,
-  createBasicFrameLoopAnimator: () => createBasicFrameLoopAnimator,
   generateNewIds: () => generateNewIds,
-  getNormalizedProps: () => getNormalizedProps,
   loadTagAnimators: () => loadTagAnimators,
   px: () => px,
   renderNode: () => renderNode,
   setupAnimationTriggers: () => setupAnimationTriggers,
+  toDomProps: () => toDomProps,
   validateDocument: () => validateDocument
 });
 module.exports = __toCommonJS(index_exports);
 
-// ../svg-animator-core/dist/chunk-PAE3NF2U.js
+// ../svg-animator-core/dist/chunk-BOTZI36B.js
 var __defProp2 = Object.defineProperty;
 var __defProps2 = Object.defineProperties;
 var __getOwnPropDescs2 = Object.getOwnPropertyDescriptors;
@@ -588,7 +587,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(__spreadValues2(__spreadValues2({}, base._shape), extra)),
   /** Array whose unrecoverable items are filtered out. Default: []. */
@@ -604,7 +603,7 @@ var px = {
   /** Defers schema creation — required for recursive types. Must supply a default value. */
   lazy: (fn, defaultVal) => new Lazy(fn, defaultVal)
 };
-var PX_PLAYER_SCHEMA_VERSION = "1.1";
+var PX_WIRE_SCHEMA_VERSION = "1.1";
 var VERSION_RE = /^(\d+)\.(\d+)(?:\.(\d+))?$/;
 function parseWireVersion(raw) {
   if (typeof raw !== "string") return void 0;
@@ -613,7 +612,7 @@ function parseWireVersion(raw) {
   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 };
 var PxFillMode = {
   forwards: "forwards",
   backwards: "backwards",
@@ -690,17 +689,17 @@ var PxTimelineEngine = {
   native: "native",
   js: "js"
 };
-var PxTimelineEngineExtra = __spreadProps2(__spreadValues2({}, PxTimelineEngine), {
+var PxTimelineEngineSetting = __spreadProps2(__spreadValues2({}, 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",
@@ -761,7 +760,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";
@@ -772,7 +771,7 @@ var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   "meta",
   "animate",
   "effects",
-  TEXT_CONTENT_ATTR
+  PX_TEXT_CONTENT_ATTR
 ]);
 var TRANSFORM_PART = {
   translate: "translate",
@@ -795,11 +794,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;
@@ -860,7 +859,7 @@ function flattenAnimatorTimeline(cfg) {
   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;
@@ -901,20 +900,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(),
@@ -968,7 +967,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()
@@ -1006,7 +1005,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,
@@ -1060,7 +1059,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
@@ -1149,7 +1148,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(),
@@ -1186,11 +1185,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);
@@ -1251,9 +1250,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") {
@@ -1273,7 +1272,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`,
@@ -1288,7 +1287,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.
@@ -1296,7 +1295,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
@@ -1305,10 +1304,10 @@ var PxNodeBase = px.openObject({
   animate: PxElementAnimationSchema.optional(),
   style: px.record(px.union([px.string(), px.number()])).optional()
 }, PxAttrValueSchema);
-var PxNodeSchema = px.openObject(__spreadProps2(__spreadValues2({}, PxNodeBase._shape), {
+var PxNodeSchema = px.openObject(__spreadProps2(__spreadValues2({}, 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(),
@@ -1316,7 +1315,7 @@ var PxSvgNodeExtra = px.object({
   viewBox: px.string().optional(),
   animator: PxAnimatorConfigSchema.optional()
 });
-var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps2(__spreadValues2(__spreadValues2({}, PxNodeBase._shape), PxSvgNodeExtra._shape), {
+var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps2(__spreadValues2(__spreadValues2({}, PxNodeBaseSchema._shape), PxSvgNodeRootSchema._shape), {
   type: px.literal("svg"),
   // override string → literal to require 'svg'
   children: px.array(PxNodeSchema).optional()
@@ -1671,9 +1670,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 "";
@@ -1726,8 +1725,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;
 }
@@ -1888,7 +1887,7 @@ function invertEasing(easing) {
   const flipped = [easing[1], easing[0], easing[3], easing[2]];
   return cubicBezier(flipped);
 }
-var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
+var PX_DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
   "script",
   "foreignobject"
 ]);
@@ -1913,7 +1912,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;
@@ -1950,19 +1949,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(",");
@@ -1978,7 +1977,7 @@ function getNormalizedProps(props) {
   return propsCopy;
 }
 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]];
@@ -1988,17 +1987,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;
 }
@@ -2007,8 +2006,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);
@@ -2101,7 +2100,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;
@@ -2118,7 +2117,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;
 }
@@ -2180,7 +2179,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);
@@ -2360,7 +2359,7 @@ function walkAndMaterialize(node, opts) {
   if (newAnimate) cloned.animate = newAnimate;
   return cloned;
 }
-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;
@@ -2536,7 +2535,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)) {
@@ -2545,7 +2544,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);
@@ -2597,8 +2596,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;
@@ -2664,7 +2663,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
       };
@@ -2751,14 +2750,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 = {
@@ -2766,8 +2765,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);
@@ -2799,17 +2798,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;
@@ -2874,7 +2873,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];
@@ -2903,9 +2902,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) => {
@@ -2975,7 +2974,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);
@@ -2994,7 +2993,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],
@@ -3068,14 +3067,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 };
@@ -3114,7 +3113,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);
@@ -3143,7 +3142,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;
@@ -3152,29 +3151,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);
@@ -3182,14 +3181,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;
@@ -3519,20 +3518,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";
@@ -3561,7 +3560,7 @@ var TEXT_ATTR_KEYS = [
   "stroke",
   "strokeWidth",
   "effects",
-  TEXT_CONTENT_ATTR,
+  PX_TEXT_CONTENT_ATTR,
   "xml:space"
 ];
 var PAINT_STATIC_KEYS = [
@@ -3715,13 +3714,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") {
@@ -3739,7 +3738,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) {
@@ -3987,32 +3986,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);
     }
   };
 }
@@ -4033,60 +4034,6 @@ function reportDocumentDiagnostics(doc, where) {
     where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
   );
 }
-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";
-}
 
 // ../svg-animator-core/dist/index.js
 function applyTransformByEffect(node, fx, ctx) {
@@ -4470,11 +4417,11 @@ function buildStopChildren(stops, ctx) {
   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" };
@@ -4495,11 +4442,11 @@ function animatedStopNode(baseline, kfs, stopIdx, _ctx, loop) {
   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);
@@ -4527,11 +4474,11 @@ function animatedStopNode(baseline, kfs, stopIdx, _ctx, loop) {
 }
 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;
@@ -5320,7 +5267,7 @@ function readScalarValues(r) {
   if (r.kind === "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;
@@ -5331,9 +5278,9 @@ function computeAnimAttr(read, map) {
   return {
     kind: "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
   };
@@ -5351,7 +5298,7 @@ function computeOpacityFromRange(rangeRead) {
   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;
@@ -5361,10 +5308,10 @@ function computeOpacityFromRange(rangeRead) {
     const kf = kfs[i];
     const prevKf = i > 0 ? kfs[i - 1] : void 0;
     const nextKf = i < kfs.length - 1 ? kfs[i + 1] : void 0;
-    const t = 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 });
@@ -5380,9 +5327,9 @@ function readRangeWithCrossings(raw) {
   const r = readAnimatable(raw);
   if (r.kind !== "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) {
@@ -5508,7 +5455,7 @@ function shapeToPathD(node) {
   }
   return void 0;
 }
-function applyPlayerEffects(root) {
+function materializeNodeEffects(root) {
   var _a2, _b;
   const ctx = {
     defs: [],
@@ -5521,7 +5468,7 @@ function applyPlayerEffects(root) {
     // 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);
@@ -5603,11 +5550,11 @@ function buildOffsetPath(propAnim) {
   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);
@@ -5616,13 +5563,13 @@ function buildOffsetPath(propAnim) {
     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]);
@@ -5634,8 +5581,8 @@ function buildOffsetPath(propAnim) {
   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);
   }
@@ -5830,14 +5777,14 @@ function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, ro
   });
   return changed ? __spreadProps2(__spreadValues2({}, node), { children: newChildren }) : node;
 }
-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);
   }
@@ -5917,16 +5864,16 @@ function cancelFrame(handle) {
   }
   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";
@@ -6183,6 +6130,36 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
   };
   return api;
 }
+var PxDiagnosticCode = /* @__PURE__ */ ((PxDiagnosticCode2) => {
+  PxDiagnosticCode2[PxDiagnosticCode2["buildFailed"] = 1001] = "buildFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["invalidDocumentAtSrc"] = 1002] = "invalidDocumentAtSrc";
+  PxDiagnosticCode2[PxDiagnosticCode2["loadFailed"] = 1003] = "loadFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["animationBuildFailed"] = 1004] = "animationBuildFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["effectsShape"] = 1101] = "effectsShape";
+  PxDiagnosticCode2[PxDiagnosticCode2["timelineOverrideIgnored"] = 1102] = "timelineOverrideIgnored";
+  PxDiagnosticCode2[PxDiagnosticCode2["blockedTag"] = 1103] = "blockedTag";
+  PxDiagnosticCode2[PxDiagnosticCode2["unsupportedAnimatedAttrs"] = 1104] = "unsupportedAnimatedAttrs";
+  PxDiagnosticCode2[PxDiagnosticCode2["noBindings"] = 1105] = "noBindings";
+  PxDiagnosticCode2[PxDiagnosticCode2["unresolvedBinding"] = 1106] = "unresolvedBinding";
+  PxDiagnosticCode2[PxDiagnosticCode2["triggersNoRoot"] = 1201] = "triggersNoRoot";
+  PxDiagnosticCode2[PxDiagnosticCode2["noRootForSelector"] = 1202] = "noRootForSelector";
+  PxDiagnosticCode2[PxDiagnosticCode2["noRootElement"] = 1203] = "noRootElement";
+  PxDiagnosticCode2[PxDiagnosticCode2["noElementsForSelector"] = 1206] = "noElementsForSelector";
+  PxDiagnosticCode2[PxDiagnosticCode2["setAttributeNoElement"] = 1207] = "setAttributeNoElement";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSmoothingNeedsOwnDriver"] = 1301] = "scrollSmoothingNeedsOwnDriver";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollNativeUnavailable"] = 1302] = "scrollNativeUnavailable";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectInvalid"] = 1303] = "scrollSubjectInvalid";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollSubjectNoMatch"] = 1304] = "scrollSubjectNoMatch";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollNoRootToObserve"] = 1305] = "scrollNoRootToObserve";
+  PxDiagnosticCode2[PxDiagnosticCode2["scrollTriggerIgnored"] = 1306] = "scrollTriggerIgnored";
+  PxDiagnosticCode2[PxDiagnosticCode2["rateRejected"] = 1401] = "rateRejected";
+  PxDiagnosticCode2[PxDiagnosticCode2["controlPropsConflict"] = 1501] = "controlPropsConflict";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnCompileFailed"] = 1601] = "rnCompileFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnRenderFailed"] = 1602] = "rnRenderFailed";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnBoundaryCaught"] = 1603] = "rnBoundaryCaught";
+  PxDiagnosticCode2[PxDiagnosticCode2["rnUnsupported"] = 1604] = "rnUnsupported";
+  return PxDiagnosticCode2;
+})(PxDiagnosticCode || {});
 var FLAT_ONLY_KEYS = [
   "timelineSource",
   "scroll",
@@ -6300,9 +6277,9 @@ function mergeAnimatorConfig(base, patch) {
   }
   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: [] };
   }
@@ -6334,6 +6311,62 @@ function applyAnimatorConfig(doc, patch, opts) {
   return { doc: __spreadProps2(__spreadValues2({}, anyDoc), { animator: merged.config }), warnings };
 }
 
+// ../svg-animator-core/dist/internal.js
+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 : PX_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/shared/PxAnimatorCallbacks.ts
 function toEngineCallbacks(inline) {
   const { onPlay, onPause, onCancel, onFinish, onRemove, onStop, onWarn, onError, muteWarn, muteError } = inline != null ? inline : {};
@@ -6358,16 +6391,16 @@ function asThrownError(e) {
 }
 
 // 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, PxDiagnosticCode.triggersNoRoot);
     return dispose;
   }
   let reversed = false;
@@ -6486,12 +6519,12 @@ function createFrameLoopAnimator(doc, adapter, callbacks, rootElement) {
     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, PxDiagnosticCode.noRootForSelector, rootSelector);
     } else {
-      diag.warn(PxDiagnosticKind.host, "createFrameLoopAnimator: No root element provided");
+      diag.warn(PxDiagnosticKind.host, PxDiagnosticCode.noRootElement);
     }
   }
-  const basicApi = createBasicFrameLoopAnimator(
+  const basicApi = createAdapterAnimator(
     doc,
     adapter || createDomAdapter(rootElement, diag),
     callbacks
@@ -6500,7 +6533,7 @@ function createFrameLoopAnimator(doc, adapter, callbacks, rootElement) {
     "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, PxDiagnosticCode.scrollTriggerIgnored);
   } else {
     const detachTriggers = setupAnimationTriggers(api, (_a2 = config.trigger) != null ? _a2 : {}, diag);
     const destroyEngine = api.destroy.bind(api);
@@ -6525,13 +6558,13 @@ function createDomAdapter(rootElement, diag) {
       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, PxDiagnosticCode.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;
         }
       }
@@ -6542,20 +6575,20 @@ function createDomAdapter(rootElement, diag) {
 
 // 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(",");
@@ -6566,7 +6599,7 @@ function createCssKf(kf, t, propName, unsupportedSet) {
   } 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;
@@ -6644,12 +6677,12 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     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, PxDiagnosticCode.noRootForSelector, rootSelector);
     } else {
-      diag.warn(PxDiagnosticKind.host, "createWebApiAnimator: No root element provided");
+      diag.warn(PxDiagnosticKind.host, PxDiagnosticCode.noRootElement);
     }
   }
-  const bindings = getNormalizedBindings(doc, PxTimelineEngine.native);
+  const bindings = normalizeBindings(doc, PxTimelineEngine.native);
   const animations = [];
   const _iterations = config.iterations;
   let iterations;
@@ -6659,18 +6692,18 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
   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, PxDiagnosticCode.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, PxDiagnosticCode.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, PxDiagnosticCode.noElementsForSelector, selector);
     }
     const keyframesMap = convertToWebApiKeyframes(animDef, unsupportedSet, config);
     const positiveDelay = config.delay && config.delay > 0 ? config.delay : void 0;
@@ -6719,14 +6752,14 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
             }
             animations.push(anim);
           } catch (e) {
-            diag.warn(PxDiagnosticKind.internal, "createWebApiAnimator: could not build the animation", e);
+            diag.warn(PxDiagnosticKind.internal, PxDiagnosticCode.animationBuildFailed, e);
           }
         }
       }
     }
   }
   if (!forceEvenIfHasUnsupportedAttrs && unsupportedSet.size) {
-    diag.warn(PxDiagnosticKind.platform, "Unsupported CSS attrs: " + [...unsupportedSet].join(", "));
+    diag.warn(PxDiagnosticKind.platform, PxDiagnosticCode.unsupportedAnimatedAttrs, [...unsupportedSet].join(", "));
     return null;
   }
   const api = {
@@ -6771,7 +6804,7 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     },
     "setPlaybackRate": (rate) => {
       if (!isValidPlaybackRate(rate)) {
-        diag.warn(PxDiagnosticKind.usage, PX_RATE_REJECTED);
+        diag.warn(PxDiagnosticKind.usage, PxDiagnosticCode.rateRejected);
         return api;
       }
       animations.forEach((a) => a.playbackRate = rate);
@@ -6811,7 +6844,7 @@ function createWebApiAnimator(doc, callbacks, rootElement, forceEvenIfHasUnsuppo
     }
   };
   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, PxDiagnosticCode.scrollTriggerIgnored);
   } else {
     const detachTriggers = setupAnimationTriggers(api, (_b = config.trigger) != null ? _b : {}, diag);
     const destroyEngine = api.destroy.bind(api);
@@ -6841,7 +6874,7 @@ function createNativeScrollTimeline(subject, config, diag) {
   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, PxDiagnosticCode.scrollSmoothingNeedsOwnDriver);
     return null;
   }
   const g = globalThis;
@@ -6858,7 +6891,7 @@ function createNativeScrollTimeline(subject, config, diag) {
       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, PxDiagnosticCode.scrollNativeUnavailable, e);
     return null;
   }
   return {
@@ -6905,11 +6938,11 @@ function resolveScrollSubject(svgRoot, subject, diag) {
   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, PxDiagnosticCode.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, PxDiagnosticCode.scrollSubjectNoMatch, spec);
     return svgRoot;
   }
   return found;
@@ -7131,7 +7164,7 @@ function bindWithEngineChoice(doc, adapter, callbacks, rootElement) {
         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);
@@ -7151,13 +7184,13 @@ function bindWithEngineChoice(doc, adapter, callbacks, rootElement) {
           };
         }
       } else {
-        diag.warn(PxDiagnosticKind.host, "scroll timeline: no root element to observe \u2014 animation will stay at frame 0");
+        diag.warn(PxDiagnosticKind.host, PxDiagnosticCode.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(
@@ -7172,15 +7205,15 @@ function bindWithEngineChoice(doc, adapter, callbacks, rootElement) {
 // 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, PxDiagnosticCode.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;
     }
@@ -7205,7 +7238,7 @@ function renderNode(node, defs, diag) {
   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) {
@@ -7219,19 +7252,16 @@ function renderNode(node, defs, diag) {
   }
   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);
   return element;
 }
 
-// src/shared/PxAnimatorKeys.ts
-var PX_ANIMATOR_DOC_KEY = "doc";
-
 // src/animator/PxAnimator.ts
 function createAnimatorFromConfig(doc, adapter, callbacks, rootElement) {
   return bindWithEngineChoice(doc, adapter, callbacks, rootElement);
@@ -7239,11 +7269,11 @@ function createAnimatorFromConfig(doc, adapter, callbacks, rootElement) {
 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, PxDiagnosticCode.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, PxDiagnosticCode.timelineOverrideIgnored, w);
     doc = patched.doc;
   }
   const animatorConfig = getAnimatorConfig(doc) || {};
@@ -7306,16 +7336,16 @@ function createAnimator(options) {
     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, PxDiagnosticCode.buildFailed, err);
     }
   };
   if (doc !== void 0) {
@@ -7323,11 +7353,11 @@ function createAnimator(options) {
   } 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, PxDiagnosticCode.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, PxDiagnosticCode.loadFailed, src, (_a2 = err == null ? void 0 : err.message) != null ? _a2 : String(err));
     });
   }
   return {
@@ -7378,23 +7408,22 @@ function loadTagAnimators(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  PX_ANIMATOR_DOC_KEY,
   PxAnimatorConfigSchema,
-  PxDefsSchema,
+  PxDefinitionsSchema,
   PxDiagnosticKind,
-  PxNodeBase,
+  PxNodeBaseSchema,
   PxScrollSchema,
-  PxSvgNodeExtra,
-  PxTimelineEngineExtra,
+  PxSvgNodeRootSchema,
+  PxTimelineEngineSetting,
   PxTriggerSchema,
+  createAdapterAnimator,
   createAnimator,
-  createBasicFrameLoopAnimator,
   generateNewIds,
-  getNormalizedProps,
   loadTagAnimators,
   px,
   renderNode,
   setupAnimationTriggers,
+  toDomProps,
   validateDocument
 });
 //# sourceMappingURL=index.cjs.map