@pixodesk/svg-animator-core 1.0.40 → 1.0.43

package/dist/index.cjs

@@ -50,22 +50,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  BASELINE_PLAYER_VERSION: () => BASELINE_PLAYER_VERSION,
-  COLOR_ATTR_NAMES: () => COLOR_ATTR_NAMES,
-  CSS_ONLY_STYLE_PROPS: () => CSS_ONLY_STYLE_PROPS,
-  DEFAULT_DURATION_MS: () => DEFAULT_DURATION_MS,
-  DISALLOWED_SVG_TAGS_LOWER: () => DISALLOWED_SVG_TAGS_LOWER,
-  LOOP_JUMP_SHIFT_MS: () => LOOP_JUMP_SHIFT_MS,
-  PCT_BASED_ATTR_NAMES: () => PCT_BASED_ATTR_NAMES,
-  PLAYER_WIRE_STEPS: () => PLAYER_WIRE_STEPS,
-  PLAYER_WIRE_VERSION: () => PLAYER_WIRE_VERSION,
-  PX_ANIM_ATTR_NAME: () => PX_ANIM_ATTR_NAME,
-  PX_ANIM_SRC_ATTR_NAME: () => PX_ANIM_SRC_ATTR_NAME,
-  PX_PLAYER_SCHEMA_VERSION: () => PX_PLAYER_SCHEMA_VERSION,
   PX_RATE_REJECTED: () => PX_RATE_REJECTED,
   PX_TRANSFORM_PART_KEYS: () => PX_TRANSFORM_PART_KEYS,
   PX_TRIGGER_DEFAULTS: () => PX_TRIGGER_DEFAULTS,
-  PX_UNKNOWN_KEY_ERROR: () => PX_UNKNOWN_KEY_ERROR,
+  PX_WIRE_BASELINE_VERSION: () => PX_WIRE_BASELINE_VERSION,
+  PX_WIRE_SCHEMA_VERSION: () => PX_WIRE_SCHEMA_VERSION,
+  PX_WIRE_STEPS: () => PX_WIRE_STEPS,
+  PX_WIRE_VERSION: () => PX_WIRE_VERSION,
+  PX_WIRE_VERSION_KEY: () => PX_WIRE_VERSION_KEY,
   PxAlongPathMode: () => PxAlongPathMode,
   PxAnimatedSvgDocumentSchema: () => PxAnimatedSvgDocumentSchema,
   PxAnimatorConfigSchema: () => PxAnimatorConfigSchema,
@@ -75,7 +67,8 @@ __export(index_exports, {
   PxCloneEffectSchema: () => PxCloneEffectSchema,
   PxCloneWithout: () => PxCloneWithout,
   PxControlMode: () => PxControlMode,
-  PxDefsSchema: () => PxDefsSchema,
+  PxDefinitionsSchema: () => PxDefinitionsSchema,
+  PxDiagnosticCode: () => PxDiagnosticCode,
   PxDiagnosticKind: () => PxDiagnosticKind,
   PxEffectsSchema: () => PxEffectsSchema,
   PxElementAnimationSchema: () => PxElementAnimationSchema,
@@ -93,7 +86,7 @@ __export(index_exports, {
   PxLoopSchema: () => PxLoopSchema,
   PxMaskType: () => PxMaskType,
   PxMaskedByEffectSchema: () => PxMaskedByEffectSchema,
-  PxNodeBase: () => PxNodeBase,
+  PxNodeBaseSchema: () => PxNodeBaseSchema,
   PxNodeSchema: () => PxNodeSchema,
   PxOutAction: () => PxOutAction,
   PxPathOverflow: () => PxPathOverflow,
@@ -112,106 +105,66 @@ __export(index_exports, {
   PxStartOn: () => PxStartOn,
   PxStrokeTrimEffectSchema: () => PxStrokeTrimEffectSchema,
   PxStrokeTrimSubPaths: () => PxStrokeTrimSubPaths,
-  PxSvgNodeExtra: () => PxSvgNodeExtra,
+  PxSvgNodeRootSchema: () => PxSvgNodeRootSchema,
   PxTextEffectSchema: () => PxTextEffectSchema,
   PxTextPathEffectSchema: () => PxTextPathEffectSchema,
   PxTextPathMethod: () => PxTextPathMethod,
   PxTextPathSpacing: () => PxTextPathSpacing,
   PxTimelineEngine: () => PxTimelineEngine,
-  PxTimelineEngineExtra: () => PxTimelineEngineExtra,
+  PxTimelineEngineSetting: () => PxTimelineEngineSetting,
   PxTimelineSchema: () => PxTimelineSchema,
   PxTransformByEffectSchema: () => PxTransformByEffectSchema,
   PxTransformPartsSchema: () => PxTransformPartsSchema,
   PxTransformValueSchema: () => PxTransformValueSchema,
   PxTriggerSchema: () => PxTriggerSchema,
   PxUnits: () => PxUnits,
-  STYLE_ATTR_NAMES: () => STYLE_ATTR_NAMES,
-  TEXT_CONTENT_ATTR: () => TEXT_CONTENT_ATTR,
-  TRANSFORM_FN_NAMES: () => TRANSFORM_FN_NAMES,
-  WIRE_VERSION_KEY: () => WIRE_VERSION_KEY,
-  WireStepKind: () => WireStepKind,
-  WireVersionRelation: () => WireVersionRelation,
+  PxWireStepKind: () => PxWireStepKind,
+  PxWireVersionRelation: () => PxWireVersionRelation,
   applyAnimatorConfig: () => applyAnimatorConfig,
-  applyPlayerEffects: () => applyPlayerEffects,
   applyWireSteps: () => applyWireSteps,
-  bezierToSvgPath: () => bezierToSvgPath,
   calcAnimationValues: () => calcAnimationValues,
-  camelCaseToKebabWordIfNeeded: () => camelCaseToKebabWordIfNeeded,
-  clamp: () => clamp,
   clampSeekMs: () => clampSeekMs,
   compareWireVersion: () => compareWireVersion,
-  composeTransformParts: () => composeTransformParts,
   controlModeTakesOverTrigger: () => controlModeTakesOverTrigger,
-  convertPlayerDocument: () => convertPlayerDocument,
-  createBasicFrameLoopAnimator: () => createBasicFrameLoopAnimator,
-  createDiagnostics: () => createDiagnostics,
-  createPathSampler: () => createPathSampler,
+  convertWireDocument: () => convertWireDocument,
+  createAdapterAnimator: () => createAdapterAnimator,
   createRunClock: () => createRunClock,
-  cubicBezier: () => cubicBezier,
-  deepClone: () => deepClone,
   describeSchema: () => describeSchema,
   diagnoseDocument: () => diagnoseDocument,
-  diffFieldUniverse: () => diffFieldUniverse,
-  diffInEffect: () => diffInEffect,
-  downgradePlayerDocument: () => downgradePlayerDocument,
-  extendedPathForBrowser: () => extendedPathForBrowser,
+  downgradeWireDocument: () => downgradeWireDocument,
   flattenAnimatorTimeline: () => flattenAnimatorTimeline,
   foldTimelineOverride: () => foldTimelineOverride,
   formatWireVersion: () => formatWireVersion,
   generateNewIds: () => generateNewIds,
-  generateUniqueId: () => generateUniqueId,
   getAnimatorConfig: () => getAnimatorConfig,
   getBindings: () => getBindings,
   getChildren: () => getChildren,
-  getDefs: () => getDefs,
-  getNormalizedBindings: () => getNormalizedBindings,
-  getNormalizedProps: () => getNormalizedProps,
-  interpolateValue: () => interpolateValue,
+  getDefinitions: () => getDefinitions,
   isNativeForced: () => isNativeForced,
-  isPxElementFileFormat: () => isPxElementFileFormat,
-  isPxElementFileFormatDeep: () => isPxElementFileFormatDeep,
-  isScrollTimeline: () => isScrollTimeline,
+  isPxDocument: () => isPxDocument,
   isValidPlaybackRate: () => isValidPlaybackRate,
-  kebabToCamelCaseWord: () => kebabToCamelCaseWord,
-  kfEasing: () => kfEasing,
-  kfValue: () => kfValue,
-  layoutGlyphTextChars: () => layoutGlyphTextChars,
+  isValidPxDocument: () => isValidPxDocument,
   materializeAllInTree: () => materializeAllInTree,
-  materializeGlyphText: () => materializeGlyphText,
-  materializeGlyphTextAlongPath: () => materializeGlyphTextAlongPath,
-  materializeMotionPathInPropAnim: () => materializeMotionPathInPropAnim,
+  materializeNodeEffects: () => materializeNodeEffects,
   mayUseNativeScrollTimeline: () => mayUseNativeScrollTimeline,
   mergeAnimatorConfig: () => mergeAnimatorConfig,
-  mergeStaticTransformIntoAnimDef: () => mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline: () => nestAnimatorTimeline,
+  normalizeBindings: () => normalizeBindings,
   parseWireVersion: () => parseWireVersion,
-  planSchemaRelease: () => planSchemaRelease,
   progressSpanMs: () => progressSpanMs,
   progressToTimeMs: () => progressToTimeMs,
   px: () => px,
   readWireVersion: () => readWireVersion,
-  releaseLogProblems: () => releaseLogProblems,
-  reportDocumentDiagnostics: () => reportDocumentDiagnostics,
   resolveControlMode: () => resolveControlMode,
   resolveTimelineEngine: () => resolveTimelineEngine,
   resolveTrigger: () => resolveTrigger,
-  reverseEasing: () => reverseEasing,
-  sanitizeAttributeValue: () => sanitizeAttributeValue,
-  schemaFieldUniverse: () => schemaFieldUniverse,
   schemaKeys: () => schemaKeys,
-  scrollOffsetProgress: () => scrollOffsetProgress,
-  scrollPhaseInterval: () => scrollPhaseInterval,
-  scrollResolveAxis: () => scrollResolveAxis,
-  scrollTotalDurationMs: () => scrollTotalDurationMs,
-  scrollViewProgress: () => scrollViewProgress,
   seekCeilingMs: () => seekCeilingMs,
-  splitEasing: () => splitEasing,
-  subdivideCubicBezier: () => subdivideCubicBezier,
   timeToProgress: () => timeToProgress,
-  toRGBA: () => toRGBA,
+  toDomProps: () => toDomProps,
   validateDocument: () => validateDocument,
   validateNodeEffects: () => validateNodeEffects,
-  versionAdvice: () => versionAdvice
+  wireVersionAdvice: () => wireVersionAdvice
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -729,7 +682,7 @@ var px = {
    * The base can be the result of px.object() or px.openObject() — anything with a _shape property.
    *
    * @example
-   * const PxSvgNodeSchema = px.extendedObject(PxNodeBase, { width: px.number().optional() });
+   * const PxSvgNodeSchema = px.extendedObject(PxNodeBaseSchema, { width: px.number().optional() });
    */
   extendedObject: (base, extra) => new Obj(__spreadValues(__spreadValues({}, base._shape), extra)),
   /** Array whose unrecoverable items are filtered out. Default: []. */
@@ -747,20 +700,20 @@ var px = {
 };
 
 // src/version/PxSchemaVersion.ts
-var PX_PLAYER_SCHEMA_VERSION = "1.1";
+var PX_WIRE_SCHEMA_VERSION = "1.1";
 
 // src/version/PxWireVersion.ts
-var WIRE_VERSION_KEY = "version";
+var PX_WIRE_VERSION_KEY = "version";
 var ANIMATOR_KEY = "animator";
 var META_KEY = "meta";
-var WireVersionRelation = /* @__PURE__ */ ((WireVersionRelation2) => {
-  WireVersionRelation2["unstamped"] = "unstamped";
-  WireVersionRelation2["same"] = "same";
-  WireVersionRelation2["older"] = "older";
-  WireVersionRelation2["newer"] = "newer";
-  WireVersionRelation2["otherGeneration"] = "otherGeneration";
-  return WireVersionRelation2;
-})(WireVersionRelation || {});
+var PxWireVersionRelation = /* @__PURE__ */ ((PxWireVersionRelation2) => {
+  PxWireVersionRelation2["unstamped"] = "unstamped";
+  PxWireVersionRelation2["same"] = "same";
+  PxWireVersionRelation2["older"] = "older";
+  PxWireVersionRelation2["newer"] = "newer";
+  PxWireVersionRelation2["otherGeneration"] = "otherGeneration";
+  return PxWireVersionRelation2;
+})(PxWireVersionRelation || {});
 var VERSION_RE = /^(\d+)\.(\d+)(?:\.(\d+))?$/;
 function parseWireVersion(raw) {
   if (typeof raw !== "string") return void 0;
@@ -772,7 +725,7 @@ function formatWireVersion(v) {
   return v.a + "." + v.b + "." + v.c;
 }
 var _a;
-var PLAYER_WIRE_VERSION = (_a = parseWireVersion(PX_PLAYER_SCHEMA_VERSION)) != null ? _a : { a: 1, b: 1, c: 0 };
+var PX_WIRE_VERSION = (_a = parseWireVersion(PX_WIRE_SCHEMA_VERSION)) != null ? _a : { a: 1, b: 1, c: 0 };
 function getAnimatorBlock(doc) {
   if (!doc || typeof doc !== "object") return void 0;
   const atRoot = readObjectProp(doc, ANIMATOR_KEY);
@@ -786,7 +739,7 @@ function readObjectProp(obj, key) {
 }
 function readWireVersion(doc) {
   const animator = getAnimatorBlock(doc);
-  return animator ? parseWireVersion(animator[WIRE_VERSION_KEY]) : void 0;
+  return animator ? parseWireVersion(animator[PX_WIRE_VERSION_KEY]) : void 0;
 }
 function compareWireVersion(file, mine, readerReadsEditorPart) {
   if (!file) return "unstamped" /* unstamped */;
@@ -795,7 +748,7 @@ function compareWireVersion(file, mine, readerReadsEditorPart) {
   if (!readerReadsEditorPart || file.c === mine.c) return "same" /* same */;
   return file.c > mine.c ? "newer" /* newer */ : "older" /* older */;
 }
-function versionAdvice(relation, file, mine, isPlayer) {
+function wireVersionAdvice(relation, file, mine, isPlayer) {
   if (!file) return void 0;
   const target = isPlayer ? "player" : "editor";
   const gap = "written for schema " + formatWireVersion(file) + ", this " + target + " reads " + formatWireVersion(mine);
@@ -810,13 +763,13 @@ function versionAdvice(relation, file, mine, isPlayer) {
       return void 0;
   }
 }
-var WireStepKind = /* @__PURE__ */ ((WireStepKind2) => {
-  WireStepKind2["additive"] = "additive";
-  WireStepKind2["converted"] = "converted";
-  return WireStepKind2;
-})(WireStepKind || {});
-var BASELINE_PLAYER_VERSION = "1.1";
-var PLAYER_WIRE_STEPS = [];
+var PxWireStepKind = /* @__PURE__ */ ((PxWireStepKind2) => {
+  PxWireStepKind2["additive"] = "additive";
+  PxWireStepKind2["converted"] = "converted";
+  return PxWireStepKind2;
+})(PxWireStepKind || {});
+var PX_WIRE_BASELINE_VERSION = "1.1";
+var PX_WIRE_STEPS = [];
 function applyWireSteps(doc, cfg) {
   const from = readWireVersion(doc);
   const relation = compareWireVersion(from, cfg.target, cfg.readerReadsEditorPart);
@@ -826,7 +779,7 @@ function applyWireSteps(doc, cfg) {
       from,
       relation,
       applied: [],
-      advice: versionAdvice(relation, from, cfg.target, !cfg.readerReadsEditorPart)
+      advice: wireVersionAdvice(relation, from, cfg.target, !cfg.readerReadsEditorPart)
     };
   }
   const due = [];
@@ -852,10 +805,10 @@ function applyWireSteps(doc, cfg) {
   stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
   return { doc: target, from, relation, applied };
 }
-function convertPlayerDocument(doc) {
+function convertWireDocument(doc) {
   return applyWireSteps(doc, {
-    steps: PLAYER_WIRE_STEPS,
-    target: PLAYER_WIRE_VERSION,
+    steps: PX_WIRE_STEPS,
+    target: PX_WIRE_VERSION,
     readerReadsEditorPart: false
   });
 }
@@ -866,8 +819,8 @@ function clonePlain(value) {
 function stampVersion(doc, target, readerReadsEditorPart) {
   const animator = getAnimatorBlock(doc);
   if (!animator) return;
-  const previous = parseWireVersion(animator[WIRE_VERSION_KEY]);
-  animator[WIRE_VERSION_KEY] = formatWireVersion({
+  const previous = parseWireVersion(animator[PX_WIRE_VERSION_KEY]);
+  animator[PX_WIRE_VERSION_KEY] = formatWireVersion({
     a: target.a,
     b: target.b,
     c: readerReadsEditorPart ? target.c : previous ? previous.c : 0
@@ -922,8 +875,8 @@ function applyWireStepsDown(doc, cfg) {
   stampVersion(target, cfg.target, cfg.readerReadsEditorPart);
   return { ok: true, doc: target, applied };
 }
-function downgradePlayerDocument(doc, target) {
-  return applyWireStepsDown(doc, { steps: PLAYER_WIRE_STEPS, target, readerReadsEditorPart: false });
+function downgradeWireDocument(doc, target) {
+  return applyWireStepsDown(doc, { steps: PX_WIRE_STEPS, target, readerReadsEditorPart: false });
 }
 
 // src/format/PxAnimatorConstants.ts
@@ -939,8 +892,6 @@ var PxPlaybackDirection = {
   alternate: "alternate",
   alternateReverse: "alternate-reverse"
 };
-var PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
-var PX_ANIM_ATTR_NAME = "_px_animator";
 var PxStartOn = {
   load: "load",
   mouseOver: "mouseOver",
@@ -1003,17 +954,17 @@ var PxTimelineEngine = {
   native: "native",
   js: "js"
 };
-var PxTimelineEngineExtra = __spreadProps(__spreadValues({}, PxTimelineEngine), {
+var PxTimelineEngineSetting = __spreadProps(__spreadValues({}, PxTimelineEngine), {
   auto: "auto"
 });
 function resolveTimelineEngine(engine) {
-  return engine === PxTimelineEngineExtra.js ? PxTimelineEngine.js : PxTimelineEngine.native;
+  return engine === PxTimelineEngineSetting.js ? PxTimelineEngine.js : PxTimelineEngine.native;
 }
 function isNativeForced(engine) {
-  return engine === PxTimelineEngineExtra.native;
+  return engine === PxTimelineEngineSetting.native;
 }
 function mayUseNativeScrollTimeline(engine) {
-  return engine !== PxTimelineEngineExtra.js;
+  return engine !== PxTimelineEngineSetting.js;
 }
 var PX_TRIGGER_DEFAULTS = {
   startOn: "load",
@@ -1105,7 +1056,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";
@@ -1116,7 +1067,7 @@ var INTERNAL_ATTRS = /* @__PURE__ */ new Set([
   "meta",
   "animate",
   "effects",
-  TEXT_CONTENT_ATTR
+  PX_TEXT_CONTENT_ATTR
 ]);
 var TRANSFORM_PART = {
   translate: "translate",
@@ -1139,11 +1090,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;
@@ -1270,7 +1221,7 @@ function nestAnimatorTimeline(cfg) {
   if (fill !== void 0) timeline.fillMode = fill;
   return Object.keys(timeline).length > 0 ? __spreadProps(__spreadValues({}, shared), { timeline }) : shared;
 }
-function getDefs(doc) {
+function getDefinitions(doc) {
   var _a2;
   if (!doc) return void 0;
   return (_a2 = getAnimatorConfig(doc)) == null ? void 0 : _a2.definitions;
@@ -1316,20 +1267,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(),
@@ -1383,7 +1334,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()
@@ -1421,7 +1372,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,
@@ -1475,7 +1426,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
@@ -1564,7 +1515,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(),
@@ -1601,11 +1552,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);
@@ -1666,9 +1617,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") {
@@ -1688,7 +1639,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`,
@@ -1703,7 +1654,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.
@@ -1711,7 +1662,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
@@ -1720,10 +1671,10 @@ var PxNodeBase = px.openObject({
   animate: PxElementAnimationSchema.optional(),
   style: px.record(px.union([px.string(), px.number()])).optional()
 }, PxAttrValueSchema);
-var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBase._shape), {
+var PxNodeSchema = px.openObject(__spreadProps(__spreadValues({}, PxNodeBaseSchema._shape), {
   children: px.lazy(() => px.array(PxNodeSchema), []).optional()
 }), PxAttrValueSchema);
-var PxSvgNodeExtra = px.object({
+var PxSvgNodeRootSchema = px.object({
   // `"100%"` and other SVG length strings are legal here — a number-only slot rejected
   // real documents (e.g. apple-store-look-14-main.json) at the root <svg>.
   width: px.union([px.number(), px.string()]).optional(),
@@ -1731,7 +1682,7 @@ var PxSvgNodeExtra = px.object({
   viewBox: px.string().optional(),
   animator: PxAnimatorConfigSchema.optional()
 });
-var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBase._shape), PxSvgNodeExtra._shape), {
+var PxAnimatedSvgDocumentSchema = px.openObject(__spreadProps(__spreadValues(__spreadValues({}, PxNodeBaseSchema._shape), PxSvgNodeRootSchema._shape), {
   type: px.literal("svg"),
   // override string → literal to require 'svg'
   children: px.array(PxNodeSchema).optional()
@@ -1742,8 +1693,8 @@ var PxBezierPathSchema = implementsInterface()(px.object({
   o: px.array(px.array(px.number())).optional(),
   c: px.boolean().optional()
 }));
-function isPxElementFileFormatDeep(fileJson) {
-  const errors = validateDocument(fileJson, { strict: false });
+function isValidPxDocument(doc) {
+  const errors = validateDocument(doc, { strict: false });
   return { valid: errors.length === 0, errors };
 }
 
@@ -2094,9 +2045,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 "";
@@ -2149,8 +2100,7 @@ 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_DEFAULT_DURATION_MS = 1e3;
 function kebabToCamelCaseWord(kebab) {
   return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
 }
@@ -2313,81 +2263,19 @@ function invertEasing(easing) {
 }
 
 // src/util/PxNodeProps.ts
-var DISALLOWED_SVG_TAGS_LOWER = /* @__PURE__ */ new Set([
-  "script",
-  "foreignobject"
-]);
-var URL_VALUE_ATTRS_LOWER = /* @__PURE__ */ new Set([
-  "href",
-  // <use>, <image>
-  "xlink:href",
-  // legacy <use>
-  "src",
-  // <image>
-  "filter",
-  // url(#filterId)
-  "clippath",
-  // clip-path="url(#…)"
-  "mask",
-  // url(#maskId)
-  "markerstart",
-  // marker-start="url(#…)"
-  "markermid",
-  // marker-mid="url(#…)"
-  "markerend"
-  // 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 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;
-var BASE64_RASTER_MAGICS = ["iVBORw0K", "/9j/", "R0lGOD", "UklGR", "Qk"];
-function isContentSniffedRasterImage(str2) {
-  const m = DATA_IMAGE_BASE64_PAYLOAD_RE.exec(str2);
-  return !!m && BASE64_RASTER_MAGICS.some((magic) => m[1].startsWith(magic));
-}
-function isDangerousAttrName(nameLower) {
-  if (nameLower.startsWith("on")) return true;
-  return false;
-}
-function sanitizeAttributeValue(name, value) {
-  const nameLower = name.toLowerCase();
-  if (isDangerousAttrName(nameLower)) {
-    console.warn("Attribute blocked (event handler / dangerous): ", nameLower);
-    return void 0;
-  }
-  if (nameLower === "fill" || nameLower === "stroke" || nameLower === "stopcolor") {
-    const str2 = String(value);
-    if (str2.includes("url(") && !/^url\(#[^)]+\)$/.test(str2)) {
-      console.warn('Attribute "' + nameLower + '" blocked: url() must be internal url(#id), got:', value);
-      return void 0;
-    }
-    return value;
-  }
-  if (URL_VALUE_ATTRS_LOWER.has(nameLower)) {
-    const str2 = String(value);
-    if (str2.startsWith("#")) return value;
-    if (/^url\(#[^)]+\)$/.test(str2)) return value;
-    if (IMAGE_REF_ATTRS_LOWER.has(nameLower) && (DATA_RASTER_IMAGE_RE.test(str2) || DATA_SVG_IMAGE_RE.test(str2) || isContentSniffedRasterImage(str2))) return value;
-    console.warn('Attribute "' + nameLower + '" blocked: must be #id, url(#id), or data:image/\u2026 URI, got:', value);
-    return void 0;
-  }
-  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(",");
@@ -2405,7 +2293,7 @@ function getNormalizedProps(props) {
 
 // src/materialize/PxMotionPath.ts
 function getKfTranslate(kf) {
-  const v = kfValue(kf);
+  const v = keyframeValue(kf);
   if (!v) return void 0;
   if (Array.isArray(v) && v.length >= 2 && typeof v[0] === "number" && typeof v[1] === "number") {
     return [v[0], v[1]];
@@ -2415,17 +2303,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;
 }
@@ -2434,8 +2322,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);
@@ -2528,7 +2416,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;
@@ -2545,7 +2433,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;
 }
@@ -2607,7 +2495,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);
@@ -2789,7 +2677,7 @@ function walkAndMaterialize(node, opts) {
 }
 
 // src/animation/PxDefinitions.ts
-var LOOP_JUMP_SHIFT_MS = 1;
+var PX_LOOP_JUMP_SHIFT_MS = 1;
 function deepEqualValue(a, b) {
   if (a === b) return true;
   if (typeof a !== typeof b || a === null || b === null || typeof a !== "object") return false;
@@ -2965,7 +2853,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)) {
@@ -2974,7 +2862,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);
@@ -3026,8 +2914,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;
@@ -3093,7 +2981,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
       };
@@ -3180,14 +3068,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 = {
@@ -3195,8 +3083,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);
@@ -3228,17 +3116,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;
@@ -3303,7 +3191,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];
@@ -3332,9 +3220,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) => {
@@ -3404,7 +3292,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);
@@ -3423,7 +3311,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],
@@ -3497,14 +3385,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 };
@@ -4069,11 +3957,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" };
@@ -4094,11 +3982,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);
@@ -4126,11 +4014,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;
@@ -4816,7 +4704,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);
@@ -4845,7 +4733,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;
@@ -4854,29 +4742,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);
@@ -4884,14 +4772,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;
@@ -5067,20 +4955,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";
@@ -5111,7 +4999,7 @@ var TEXT_ATTR_KEYS = [
   "stroke",
   "strokeWidth",
   "effects",
-  TEXT_CONTENT_ATTR,
+  PX_TEXT_CONTENT_ATTR,
   "xml:space"
 ];
 var PAINT_STATIC_KEYS = [
@@ -5265,13 +5153,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") {
@@ -5283,141 +5171,13 @@ function materializeGlyphTextHorizontal(node, opts) {
   }
   return toGroup(node, buildPaths(placements, create, warnings), create);
 }
-function layoutGlyphTextChars(node, opts) {
-  var _a2, _b, _c, _d, _e;
-  if ((_a2 = opts.alongPath) == null ? void 0 : _a2.pathD) return layoutGlyphTextCharsAlongPath(node, opts.alongPath.pathD, opts);
-  const { glyphs, warnings } = opts;
-  const soleFont = soleFontOf(glyphs);
-  const pen = { x: (_b = parseLen(node.x)) != null ? _b : 0, y: (_c = parseLen(node.y)) != null ? _c : 0 };
-  const boxes = [];
-  const lines = [{ start: pen.x, end: pen.x }];
-  let line = 0;
-  const renderChars = (content, s) => {
-    var _a3;
-    const gf = glyphFontFor(s, glyphs, soleFont, warnings);
-    const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
-    const scale = s.fontSize / upm;
-    const ascent = ((_a3 = gf == null ? void 0 : gf.ascent) != null ? _a3 : 0.9 * upm) * scale;
-    for (let i = 0; i < content.length; i++) {
-      const ch = content.charAt(i);
-      const g = gf == null ? void 0 : gf.glyphs[ch];
-      const advance = (g ? g.width : 0) * scale + s.letterSpacing + (ch === " " ? s.wordSpacing : 0);
-      boxes.push({ x: pen.x, y: pen.y, width: advance, ascent, fontSize: s.fontSize, line });
-      pen.x += advance;
-      lines[line].end = pen.x;
-    }
-  };
-  const walk = (el, parentStyle) => {
-    var _a3, _b2, _c2;
-    const s = resolveStyle(el, parentStyle);
-    const x = parseLen(el.x);
-    const y = parseLen(el.y);
-    if (x !== void 0) {
-      pen.x = x;
-      line = lines.length;
-      lines.push({ start: pen.x, end: pen.x });
-    }
-    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]);
-    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) {
-    const before = boxes.length;
-    walk(ch, rootStyle);
-    if (boxes.length === before) {
-      const s = resolveStyle(ch, rootStyle);
-      const gf = glyphFontFor(s, glyphs, soleFont);
-      const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
-      boxes.push({ x: pen.x, y: pen.y, width: 0, ascent: ((_d = gf == null ? void 0 : gf.ascent) != null ? _d : 0.9 * upm) * (s.fontSize / upm), fontSize: s.fontSize, line });
-    }
-  }
-  const rootContent = str(node[TEXT_CONTENT_ATTR]);
-  if (rootContent && !((_e = node.children) == null ? void 0 : _e.length)) renderChars(rootContent, rootStyle);
-  const anchor = str(node.textAnchor);
-  if (anchor === "middle" || anchor === "end") {
-    for (const b of boxes) {
-      const w = lines[b.line].end - lines[b.line].start;
-      b.x += anchor === "middle" ? -w / 2 : -w;
-    }
-  }
-  return boxes.map((_f) => {
-    var _g = _f, { line: _l } = _g, b = __objRest(_g, ["line"]);
-    return b;
-  });
-}
-function layoutGlyphTextCharsAlongPath(node, pathD, opts) {
-  var _a2, _b;
-  const { glyphs, warnings, alongPath } = opts;
-  const sampler = createPathSampler(pathD);
-  if (!sampler) {
-    warnings == null ? void 0 : warnings.push("textGlyphs: unparsable along-path geometry (caret)");
-    return [];
-  }
-  const soleFont = soleFontOf(glyphs);
-  const chars = [];
-  let adv = 0;
-  const walk = (el, parentStyle) => {
-    var _a3, _b2;
-    const s = resolveStyle(el, parentStyle);
-    const content = str(el[TEXT_CONTENT_ATTR]);
-    if (content && !((_a3 = el.children) == null ? void 0 : _a3.length)) {
-      const gf = glyphFontFor(s, glyphs, soleFont, warnings);
-      const upm = (gf == null ? void 0 : gf.unitsPerEm) || 1e3;
-      const scale = s.fontSize / upm;
-      const ascent = ((_b2 = gf == null ? void 0 : gf.ascent) != null ? _b2 : 0.9 * upm) * scale;
-      for (let i = 0; i < content.length; i++) {
-        const ch = content.charAt(i);
-        const g = gf == null ? void 0 : gf.glyphs[ch];
-        const glyphW = (g ? g.width : 0) * scale;
-        const advance = glyphW + s.letterSpacing + (ch === " " ? s.wordSpacing : 0);
-        chars.push({ advStart: adv, advEnd: adv + advance, glyphW, ascent, fontSize: s.fontSize });
-        adv += advance;
-      }
-    }
-    if (el.children) for (const ch of el.children) walk(ch, s);
-  };
-  walk(node, rootStyleOf(node));
-  const width = adv;
-  const tlr = readAnimatable(alongPath == null ? void 0 : alongPath.textLength);
-  const tlv = tlr.kind === "animated" /* Animated */ ? Number((_a2 = tlr.keyframes[0]) == null ? void 0 : _a2.value) || 0 : tlr.kind === "static" /* Static */ ? Number(tlr.value) || 0 : 0;
-  const k = tlv > 0 && width > 0 ? tlv / width : 1;
-  const so = readAnimatable(alongPath == null ? void 0 : alongPath.startOffset);
-  const { along: alongOffset, perp } = alongPathNodeOffsets(node);
-  const base = alongOffset + (so.kind === "animated" /* Animated */ ? Number((_b = so.keyframes[0]) == null ? void 0 : _b.value) || 0 : so.kind === "static" /* Static */ ? Number(so.value) || 0 : 0);
-  const withPerp = (p) => ({
-    x: p.x - perp * Math.sin(p.angle),
-    y: p.y + perp * Math.cos(p.angle),
-    angle: p.angle
-  });
-  return chars.map((c) => {
-    const dStart = base + c.advStart * k;
-    const dEnd = base + c.advEnd * k;
-    const p0 = withPerp(sampler.sampleAtDistance(dStart));
-    const p1 = withPerp(sampler.sampleAtDistance(dEnd));
-    const glyphMid = sampler.sampleAtDistance(base + (c.advStart + c.glyphW / 2) * k);
-    return {
-      x: p0.x,
-      y: p0.y,
-      width: c.advEnd - c.advStart,
-      ascent: c.ascent,
-      fontSize: c.fontSize,
-      endX: p1.x,
-      endY: p1.y,
-      rotation: glyphMid.angle * 180 / Math.PI
-    };
-  });
-}
 function collectAlongPathCells(node, glyphs, soleFont, warnings) {
   const cells = [];
   let adv = 0;
   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) {
@@ -5632,10 +5392,6 @@ function toGroup(node, children, create) {
   }
   return create("g", gProps, children);
 }
-function materializeGlyphText(node, opts) {
-  if (opts.alongPath) return materializeGlyphTextAlongPath(node, opts.alongPath.pathD, opts.alongPath.startOffset, opts, opts.alongPath.textLength, opts.alongPath.pathOverflow);
-  return materializeGlyphTextHorizontal(node, opts);
-}
 function applyTextGlyphsEffect(node, fx, ctx) {
   if (!(fx == null ? void 0 : fx.useGlyphs)) return node;
   if (!ctx.glyphs) {
@@ -5792,7 +5548,7 @@ function readScalarValues(r) {
   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;
@@ -5803,9 +5559,9 @@ function computeAnimAttr(read, map) {
   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
   };
@@ -5823,7 +5579,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;
@@ -5833,10 +5589,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 });
@@ -5852,9 +5608,9 @@ function readRangeWithCrossings(raw) {
   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) {
@@ -5982,7 +5738,7 @@ function shapeToPathD(node) {
 }
 
 // src/effects/PlayerEffectsUtil.ts
-function applyPlayerEffects(root) {
+function materializeNodeEffects(root) {
   var _a2, _b;
   const ctx = {
     defs: [],
@@ -5995,7 +5751,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);
@@ -6079,11 +5835,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);
@@ -6092,13 +5848,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]);
@@ -6110,8 +5866,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);
   }
@@ -6310,14 +6066,14 @@ function walkAndMaterialize2(node, idMap, animatedIds, genId3, defsCollector, ro
 }
 
 // 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);
   }
@@ -6427,16 +6183,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";
@@ -6694,6 +6450,38 @@ function createBasicFrameLoopAnimator(doc, adapter, callbacks) {
   return api;
 }
 
+// src/playback/PxDiagnosticCode.ts
+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 || {});
+
 // src/playback/PxDiagnostics.ts
 var PxDiagnosticKind = {
   /** The document is wrong — regenerate or repair the file. */
@@ -6707,35 +6495,6 @@ 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;
-}
-function createDiagnostics(config, prefix) {
-  const tag = prefix ? prefix + " " : "";
-  return {
-    warn: (kind, message, detail) => {
-      if (config == null ? void 0 : config.onWarn) {
-        config.onWarn({ kind, message, detail });
-        return;
-      }
-      if (config == null ? void 0 : config.muteWarn) return;
-      const line = tag + kind + ": " + message;
-      if (detail === void 0) console.warn(line);
-      else console.warn(line, detail);
-    },
-    error: (kind, error, detail) => {
-      const err = asError(error);
-      if (config == null ? void 0 : config.onError) {
-        config.onError({ kind, message: err.message, error: err, detail });
-        return;
-      }
-      if (config == null ? void 0 : config.muteError) return;
-      const line = tag + kind + ": " + err.message;
-      if (detail === void 0) console.error(line);
-      else console.error(line, detail);
-    }
-  };
-}
 
 // src/playback/PxAnimatorConfigPatch.ts
 var FLAT_ONLY_KEYS = [
@@ -6855,9 +6614,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: [] };
   }
@@ -6890,7 +6649,6 @@ function applyAnimatorConfig(doc, patch, opts) {
 }
 
 // src/format/PxDocumentDiagnostic.ts
-var MAX_REPORTED = 6;
 function diagnoseDocument(doc) {
   try {
     return { problems: validateDocument(doc) };
@@ -6898,421 +6656,16 @@ function diagnoseDocument(doc) {
     return { problems: [] };
   }
 }
-function reportDocumentDiagnostics(doc, where) {
-  const { problems } = diagnoseDocument(doc);
-  if (!problems.length) return;
-  const shown = problems.slice(0, MAX_REPORTED);
-  const more = problems.length - shown.length;
-  console.warn(
-    where + ": this document does not match the animation schema in " + problems.length + " place" + (problems.length === 1 ? "" : "s") + ".\n" + shown.map((p) => "  - " + p).join("\n") + (more > 0 ? "\n  \u2026 and " + more + " more" : "") + "\n\nIf you did not author these keys, the usual cause is a build that MANGLES PROPERTY NAMES. An animation document is data loaded at runtime, so renaming the property reads inside the player stops them matching the keys in the JSON, and the animation silently does nothing. Feed the published reserved-name list to your minifier \u2014 @pixodesk/svg-animator-web/mangle-reserved.json \u2014 see docs/library/minification.md."
-  );
-}
-
-// src/effects/PlayerEffectsUtil.visualModel.ts
-var IDENTITY = [1, 0, 0, 1, 0, 0];
-function mul(m, n) {
-  return [
-    m[0] * n[0] + m[2] * n[1],
-    m[1] * n[0] + m[3] * n[1],
-    m[0] * n[2] + m[2] * n[3],
-    m[1] * n[2] + m[3] * n[3],
-    m[0] * n[4] + m[2] * n[5] + m[4],
-    m[1] * n[4] + m[3] * n[5] + m[5]
-  ];
-}
-var translateM = (x, y) => [1, 0, 0, 1, x, y];
-var scaleM = (sx, sy) => [sx, 0, 0, sy, 0, 0];
-function rotateM(deg) {
-  const r = deg * Math.PI / 180;
-  return [Math.cos(r), Math.sin(r), -Math.sin(r), Math.cos(r), 0, 0];
-}
-var skewXM = (deg) => [1, 0, Math.tan(deg * Math.PI / 180), 1, 0, 0];
-var skewYM = (deg) => [1, Math.tan(deg * Math.PI / 180), 0, 1, 0, 0];
-function parseTransformString(s) {
-  let m = IDENTITY;
-  const re = /(translate|rotate|scale|matrix|skewX|skewY)\(([^)]*)\)/g;
-  let hit;
-  while (hit = re.exec(s)) {
-    const fn = hit[1];
-    const a = hit[2].split(/[\s,]+/).filter(Boolean).map(Number);
-    if (fn === "translate") m = mul(m, translateM(a[0] || 0, a[1] || 0));
-    else if (fn === "scale") m = mul(m, scaleM(a[0], a.length > 1 ? a[1] : a[0]));
-    else if (fn === "rotate") m = mul(m, rotateM(a[0]));
-    else if (fn === "skewX") m = mul(m, skewXM(a[0]));
-    else if (fn === "skewY") m = mul(m, skewYM(a[0]));
-    else if (fn === "matrix") m = mul(m, [a[0], a[1], a[2], a[3], a[4], a[5]]);
-  }
-  return m;
-}
-function partsToMatrix(p) {
-  let m = IDENTITY;
-  if (p.translate) m = mul(m, translateM(p.translate[0], p.translate[1]));
-  const pivot = p.origin && (p.rotate !== void 0 || p.scale);
-  if (pivot) m = mul(m, translateM(p.origin[0], p.origin[1]));
-  if (p.rotate !== void 0) m = mul(m, rotateM(p.rotate));
-  if (p.scale) m = mul(m, scaleM(p.scale[0], p.scale[1]));
-  if (pivot) m = mul(m, translateM(-p.origin[0], -p.origin[1]));
-  return m;
-}
-function lerp(a, b, f) {
-  return a + (b - a) * f;
-}
-function interpParts(kfs, t) {
-  var _a2, _b, _c, _d, _e, _f, _g;
-  if (!kfs.length) return {};
-  if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value || {};
-  if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value || {};
-  let i = 0;
-  while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
-  const a = kfs[i], b = kfs[i + 1];
-  const f = (t - ((_d = a.time) != null ? _d : 0)) / (((_e = b.time) != null ? _e : 0) - ((_f = a.time) != null ? _f : 0) || 1);
-  const va = a.value || {}, vb = b.value || {};
-  const out = {};
-  if (va.translate && vb.translate) out.translate = [lerp(va.translate[0], vb.translate[0], f), lerp(va.translate[1], vb.translate[1], f)];
-  else out.translate = va.translate || vb.translate;
-  if (va.rotate !== void 0 && vb.rotate !== void 0) out.rotate = lerp(va.rotate, vb.rotate, f);
-  else out.rotate = (_g = va.rotate) != null ? _g : vb.rotate;
-  if (va.scale && vb.scale) out.scale = [lerp(va.scale[0], vb.scale[0], f), lerp(va.scale[1], vb.scale[1], f)];
-  else out.scale = va.scale || vb.scale;
-  out.origin = va.origin || vb.origin;
-  return out;
-}
-function evalTransformValue(v, t) {
-  if (v === void 0 || v === null) return IDENTITY;
-  if (typeof v === "string") return parseTransformString(v);
-  if (v.keyframes) return partsToMatrix(interpParts(v.keyframes, t));
-  if (v.value) return partsToMatrix(v.value);
-  if (typeof v === "object" && !Array.isArray(v)) return partsToMatrix(v);
-  return IDENTITY;
-}
-function nodeMatrix(node, t) {
-  if (node.animate && node.animate.transform) return evalTransformValue(node.animate.transform, t);
-  if (node.transform !== void 0) return evalTransformValue(node.transform, t);
-  return IDENTITY;
-}
-function evalScalar(animated, staticVal, fallback, t) {
-  var _a2, _b, _c, _d, _e, _f;
-  if (animated && animated.keyframes && animated.keyframes.length) {
-    const kfs = animated.keyframes;
-    if (t <= ((_a2 = kfs[0].time) != null ? _a2 : 0)) return kfs[0].value;
-    if (t >= ((_b = kfs[kfs.length - 1].time) != null ? _b : 0)) return kfs[kfs.length - 1].value;
-    let i = 0;
-    while (i < kfs.length - 1 && ((_c = kfs[i + 1].time) != null ? _c : 0) < t) i++;
-    const a = kfs[i], b = kfs[i + 1];
-    const f = (t - ((_d = a.time) != null ? _d : 0)) / (((_e = b.time) != null ? _e : 0) - ((_f = a.time) != null ? _f : 0) || 1);
-    return lerp(a.value, b.value, f);
-  }
-  return staticVal !== void 0 ? Number(staticVal) : fallback;
-}
-var CONTAINER_TYPES = /* @__PURE__ */ new Set(["svg", "g", "symbol"]);
-var SKIP_TYPES = /* @__PURE__ */ new Set(["defs", "mask", "clipPath", "title"]);
-function buildIdMap2(node, map) {
-  var _a2;
-  if (typeof node.id === "string") map.set(node.id, node);
-  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => buildIdMap2(c, map));
-}
-function num(v) {
-  return v === void 0 || v === null ? 0 : Number(v);
-}
-function round(n) {
-  return Math.round(n * 100) / 100 + 0;
-}
-function geomKey(node) {
-  var _a2;
-  switch (node.type) {
-    case "rect":
-      return num(node.width) + "," + num(node.height) + "," + num(node.x) + "," + num(node.y);
-    case "ellipse":
-      return num(node.rx) + "," + num(node.ry) + "," + num(node.cx) + "," + num(node.cy);
-    case "circle":
-      return num(node.r) + "," + num(node.cx) + "," + num(node.cy);
-    case "path":
-      return String((_a2 = node.d) != null ? _a2 : "");
-    default:
-      return "";
-  }
-}
-function describePrimitive(node, m, t) {
-  var _a2, _b, _c, _d, _e;
-  const fill = (_a2 = node.fill) != null ? _a2 : "";
-  const stroke = (_b = node.stroke) != null ? _b : "";
-  const sw = (_d = (_c = node["stroke-width"]) != null ? _c : node.strokeWidth) != null ? _d : "";
-  const opacity = round(evalScalar((_e = node.animate) == null ? void 0 : _e.opacity, node.opacity, 1, t));
-  const masked = node.mask ? 1 : 0;
-  const mat = m.map(round).join(",");
-  return node.type + "|" + geomKey(node) + "|[" + mat + "]|f:" + fill + "|s:" + stroke + "|sw:" + (num(sw) || "") + "|o:" + opacity + "|m:" + masked;
-}
-function flatten(node, parent, t, idMap, out) {
-  var _a2;
-  const type = node.type || "";
-  if (SKIP_TYPES.has(type)) return;
-  const m = mul(parent, nodeMatrix(node, t));
-  if (type === "use") {
-    const targetId = typeof node.href === "string" ? node.href.replace(/^#/, "") : "";
-    const target = idMap.get(targetId);
-    const useM = mul(m, translateM(num(node.x), num(node.y)));
-    if (target) flatten(target, useM, t, idMap, out);
-    else out.push("UNRESOLVED_USE:#" + targetId);
-    return;
-  }
-  if (CONTAINER_TYPES.has(type)) {
-    (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => flatten(c, m, t, idMap, out));
-    return;
-  }
-  out.push(describePrimitive(node, m, t));
-}
-function collectSampleTimes(node, into) {
-  var _a2;
-  into.add(0);
-  const scanAnim = (anim) => {
-    var _a3;
-    if (!anim || typeof anim !== "object") return;
-    for (const key of Object.keys(anim)) {
-      const kfs = (_a3 = anim[key]) == null ? void 0 : _a3.keyframes;
-      if (Array.isArray(kfs)) kfs.forEach((kf) => {
-        var _a4;
-        return into.add((_a4 = kf.time) != null ? _a4 : 0);
-      });
-    }
-  };
-  scanAnim(node.animate);
-  if (node.transform && typeof node.transform === "object" && node.transform.keyframes) {
-    node.transform.keyframes.forEach((kf) => {
-      var _a3;
-      return into.add((_a3 = kf.time) != null ? _a3 : 0);
-    });
-  }
-  (_a2 = node.children) == null ? void 0 : _a2.forEach((c) => collectSampleTimes(c, into));
-}
-function visualModelAt(root, t) {
-  const idMap = /* @__PURE__ */ new Map();
-  buildIdMap2(root, idMap);
-  const out = [];
-  flatten(root, IDENTITY, t, idMap, out);
-  return out.sort();
-}
-function diffInEffect(a, b) {
-  const times = /* @__PURE__ */ new Set();
-  collectSampleTimes(a, times);
-  collectSampleTimes(b, times);
-  const diffs = [];
-  for (const t of Array.from(times).sort((x, y) => x - y)) {
-    const ma = visualModelAt(a, t);
-    const mb = visualModelAt(b, t);
-    const onlyInA = subtractMultiset(ma, mb);
-    const onlyInB = subtractMultiset(mb, ma);
-    if (onlyInA.length || onlyInB.length) diffs.push({ time: t, onlyInA, onlyInB });
-  }
-  return diffs;
-}
-function subtractMultiset(a, b) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const x of b) counts.set(x, (counts.get(x) || 0) + 1);
-  const extra = [];
-  for (const x of a) {
-    const c = counts.get(x) || 0;
-    if (c > 0) counts.set(x, c - 1);
-    else extra.push(x);
-  }
-  return extra;
-}
-
-// src/playback/PxScrollMath.ts
-function isScrollTimeline(config) {
-  return (config == null ? void 0 : config.timelineSource) === "scroll";
-}
-function scrollTotalDurationMs(config) {
-  const duration = typeof (config == null ? void 0 : config.duration) === "number" && config.duration > 0 ? config.duration : DEFAULT_DURATION_MS;
-  const iterations = typeof (config == null ? void 0 : config.iterations) === "number" && config.iterations > 0 ? config.iterations : 1;
-  return duration * iterations;
-}
-function scrollPhaseInterval(phase, subjectSize, scrollportSize) {
-  const s = subjectSize, vp = scrollportSize;
-  switch (phase) {
-    case "cover":
-      return [0, s + vp];
-    case "entry":
-      return [0, Math.min(s, vp)];
-    case "contain":
-      return [Math.min(s, vp), Math.max(s, vp)];
-    case "exit":
-      return [Math.max(s, vp), s + vp];
-    case "entry-crossing":
-      return [0, s];
-    case "exit-crossing":
-      return [vp, s + vp];
-  }
-}
-var DEFAULT_PHASE = "cover";
-function resolveRangePointU(point, defaultFraction, subjectSize, scrollportSize) {
-  var _a2;
-  const [u0, u1] = scrollPhaseInterval((_a2 = point == null ? void 0 : point.phase) != null ? _a2 : DEFAULT_PHASE, subjectSize, scrollportSize);
-  const fraction = typeof (point == null ? void 0 : point.fraction) === "number" ? point.fraction : defaultFraction;
-  return u0 + fraction * (u1 - u0);
-}
-function scrollViewProgress(subjectStart, subjectSize, scrollportSize, range) {
-  const u = scrollportSize - subjectStart;
-  const uStart = resolveRangePointU(range == null ? void 0 : range.start, 0, subjectSize, scrollportSize);
-  const uEnd = resolveRangePointU(range == null ? void 0 : range.end, 1, subjectSize, scrollportSize);
-  if (uEnd <= uStart) return u >= uEnd ? 1 : 0;
-  return clamp((u - uStart) / (uEnd - uStart), 0, 1);
-}
-function scrollOffsetProgress(offset, maxOffset, range) {
-  var _a2, _b;
-  const raw = maxOffset > 0 ? clamp(offset / maxOffset, 0, 1) : 1;
-  const start = typeof ((_a2 = range == null ? void 0 : range.start) == null ? void 0 : _a2.fraction) === "number" ? range.start.fraction : 0;
-  const end = typeof ((_b = range == null ? void 0 : range.end) == null ? void 0 : _b.fraction) === "number" ? range.end.fraction : 1;
-  if (end <= start) return raw >= end ? 1 : 0;
-  return clamp((raw - start) / (end - start), 0, 1);
-}
-function scrollResolveAxis(axis, writingMode) {
-  const a = axis != null ? axis : "block";
-  if (a === "x" || a === "y") return a;
-  const vertical = !!writingMode && writingMode.startsWith("vertical");
-  if (a === "inline") return vertical ? "y" : "x";
-  return vertical ? "x" : "y";
-}
-
-// src/version/PxSchemaFieldUniverse.ts
-function schemaFieldUniverse(root) {
-  const fields = /* @__PURE__ */ new Set();
-  const enumerated = /* @__PURE__ */ new Set();
-  const queue = [{ schema: root, path: "" }];
-  while (queue.length) {
-    const { schema, path } = queue.shift();
-    const d = describeSchema(schema);
-    switch (d.kind) {
-      case "shape": {
-        if (enumerated.has(schema)) break;
-        enumerated.add(schema);
-        for (const key of Object.keys(d.shape)) {
-          const id = path ? path + "." + key : key;
-          fields.add(id);
-          queue.push({ schema: d.shape[key], path: id });
-        }
-        if (d.openValue) queue.push({ schema: d.openValue, path: path + "{*}" });
-        break;
-      }
-      case "optional":
-        queue.push({ schema: d.inner, path });
-        break;
-      case "array":
-        queue.push({ schema: d.item, path: path + "[]" });
-        break;
-      case "lazy":
-        queue.push({ schema: d.resolved, path });
-        break;
-      case "record":
-        queue.push({ schema: d.value, path: path + "{*}" });
-        break;
-      case "union":
-        d.members.forEach((member, i) => queue.push({ schema: member, path: path + "|" + i }));
-        break;
-      case "discriminatedUnion":
-        for (const member of d.members) queue.push({ schema: member, path: path + "|" + discriminantOf(member, d.key) });
-        break;
-      default:
-        break;
-    }
-  }
-  return [...fields].sort();
-}
-function discriminantOf(member, key) {
-  const d = describeSchema(member);
-  if (d.kind !== "shape") return "?";
-  const keySchema = d.shape[key];
-  if (keySchema === void 0) return "?";
-  const kd = describeSchema(keySchema);
-  return String((kd.kind === "optional" ? kd.inner : keySchema)._default);
-}
-
-// src/version/PxSchemaRelease.ts
-function diffFieldUniverse(previous, current) {
-  const prev = new Set(previous);
-  const cur = new Set(current);
-  return {
-    added: current.filter((k) => !prev.has(k)).sort(),
-    removed: previous.filter((k) => !cur.has(k)).sort()
-  };
-}
-function planSchemaRelease(p) {
-  const changed = p.added.length > 0 || p.removed.length > 0;
-  const last = parseWireVersion(p.lastReleased);
-  const declared = parseWireVersion(p.declared);
-  if (!last || !declared) return { changed, refuse: "Unparseable version: " + p.lastReleased + " / " + p.declared + "." };
-  const requiredVersion = last.a + "." + (last.b + 1);
-  if (!changed) {
-    if (declared.b === last.b && declared.a === last.a) return { changed };
-    const step2 = p.steps.find((s) => s.to === p.declared);
-    return step2 ? { changed, requiredVersion: p.declared } : { changed, refuse: "The version moved to " + p.declared + " with no key change and no step explaining it." };
-  }
-  const requiredKind = p.removed.length ? "converted" /* converted */ : "additive" /* additive */;
-  const summary = p.added.length + " key(s) added, " + p.removed.length + " removed";
-  if (declared.a !== last.a || declared.b !== last.b + 1) {
-    return {
-      changed,
-      requiredKind,
-      requiredVersion,
-      refuse: "The player schema changed (" + summary + ") but PX_PLAYER_SCHEMA_VERSION is " + p.declared + ". Set it to " + requiredVersion + " and add the PLAYER_WIRE_STEPS entry."
-    };
-  }
-  const step = p.steps.find((s) => s.to === p.declared);
-  if (!step) {
-    return { changed, requiredKind, requiredVersion, refuse: "No PLAYER_WIRE_STEPS entry reaches " + p.declared + "." };
-  }
-  if (requiredKind === "converted" /* converted */ && step.kind !== "converted" /* converted */) {
-    return {
-      changed,
-      requiredKind,
-      requiredVersion,
-      refuse: "Keys were REMOVED (" + p.removed.join(", ") + "), which is never additive \u2014 the " + p.declared + " step must be `converted`, with an up()."
-    };
-  }
-  return { changed, requiredKind, requiredVersion };
-}
-function releaseLogProblems(releases, steps, declared, baseline) {
-  const problems = [];
-  if (!releases.length) return ["The release log is empty."];
-  if (!releases[0].baseline || releases[0].version !== baseline) {
-    problems.push("The first release must be the baseline " + baseline + ".");
-  }
-  for (let i = 1; i < releases.length; i++) {
-    const prev = parseWireVersion(releases[i - 1].version);
-    const cur = parseWireVersion(releases[i].version);
-    if (!prev || !cur || cur.a !== prev.a || cur.b !== prev.b + 1) {
-      problems.push("Release " + releases[i].version + " does not follow " + releases[i - 1].version + " by one `b` step.");
-    }
-    if (releases[i].date < releases[i - 1].date) problems.push("Release " + releases[i].version + " is dated before its predecessor.");
-    const step = steps.find((s) => s.to === releases[i].version);
-    if (!step) problems.push("Release " + releases[i].version + " has no PLAYER_WIRE_STEPS entry.");
-    else if (releases[i].removed.length && step.kind !== "converted" /* converted */) {
-      problems.push("Release " + releases[i].version + " removed keys, but its step is not `converted`.");
-    }
-  }
-  const latest = releases[releases.length - 1].version;
-  if (latest !== declared) {
-    problems.push("PX_PLAYER_SCHEMA_VERSION is " + declared + " but the last release record is " + latest + " \u2014 a bump needs its changelog entry (run scripts/schema-release.mjs --apply).");
-  }
-  return problems;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BASELINE_PLAYER_VERSION,
-  COLOR_ATTR_NAMES,
-  CSS_ONLY_STYLE_PROPS,
-  DEFAULT_DURATION_MS,
-  DISALLOWED_SVG_TAGS_LOWER,
-  LOOP_JUMP_SHIFT_MS,
-  PCT_BASED_ATTR_NAMES,
-  PLAYER_WIRE_STEPS,
-  PLAYER_WIRE_VERSION,
-  PX_ANIM_ATTR_NAME,
-  PX_ANIM_SRC_ATTR_NAME,
-  PX_PLAYER_SCHEMA_VERSION,
   PX_RATE_REJECTED,
   PX_TRANSFORM_PART_KEYS,
   PX_TRIGGER_DEFAULTS,
-  PX_UNKNOWN_KEY_ERROR,
+  PX_WIRE_BASELINE_VERSION,
+  PX_WIRE_SCHEMA_VERSION,
+  PX_WIRE_STEPS,
+  PX_WIRE_VERSION,
+  PX_WIRE_VERSION_KEY,
   PxAlongPathMode,
   PxAnimatedSvgDocumentSchema,
   PxAnimatorConfigSchema,
@@ -7322,7 +6675,8 @@ function releaseLogProblems(releases, steps, declared, baseline) {
   PxCloneEffectSchema,
   PxCloneWithout,
   PxControlMode,
-  PxDefsSchema,
+  PxDefinitionsSchema,
+  PxDiagnosticCode,
   PxDiagnosticKind,
   PxEffectsSchema,
   PxElementAnimationSchema,
@@ -7340,7 +6694,7 @@ function releaseLogProblems(releases, steps, declared, baseline) {
   PxLoopSchema,
   PxMaskType,
   PxMaskedByEffectSchema,
-  PxNodeBase,
+  PxNodeBaseSchema,
   PxNodeSchema,
   PxOutAction,
   PxPathOverflow,
@@ -7359,105 +6713,65 @@ function releaseLogProblems(releases, steps, declared, baseline) {
   PxStartOn,
   PxStrokeTrimEffectSchema,
   PxStrokeTrimSubPaths,
-  PxSvgNodeExtra,
+  PxSvgNodeRootSchema,
   PxTextEffectSchema,
   PxTextPathEffectSchema,
   PxTextPathMethod,
   PxTextPathSpacing,
   PxTimelineEngine,
-  PxTimelineEngineExtra,
+  PxTimelineEngineSetting,
   PxTimelineSchema,
   PxTransformByEffectSchema,
   PxTransformPartsSchema,
   PxTransformValueSchema,
   PxTriggerSchema,
   PxUnits,
-  STYLE_ATTR_NAMES,
-  TEXT_CONTENT_ATTR,
-  TRANSFORM_FN_NAMES,
-  WIRE_VERSION_KEY,
-  WireStepKind,
-  WireVersionRelation,
+  PxWireStepKind,
+  PxWireVersionRelation,
   applyAnimatorConfig,
-  applyPlayerEffects,
   applyWireSteps,
-  bezierToSvgPath,
   calcAnimationValues,
-  camelCaseToKebabWordIfNeeded,
-  clamp,
   clampSeekMs,
   compareWireVersion,
-  composeTransformParts,
   controlModeTakesOverTrigger,
-  convertPlayerDocument,
-  createBasicFrameLoopAnimator,
-  createDiagnostics,
-  createPathSampler,
+  convertWireDocument,
+  createAdapterAnimator,
   createRunClock,
-  cubicBezier,
-  deepClone,
   describeSchema,
   diagnoseDocument,
-  diffFieldUniverse,
-  diffInEffect,
-  downgradePlayerDocument,
-  extendedPathForBrowser,
+  downgradeWireDocument,
   flattenAnimatorTimeline,
   foldTimelineOverride,
   formatWireVersion,
   generateNewIds,
-  generateUniqueId,
   getAnimatorConfig,
   getBindings,
   getChildren,
-  getDefs,
-  getNormalizedBindings,
-  getNormalizedProps,
-  interpolateValue,
+  getDefinitions,
   isNativeForced,
-  isPxElementFileFormat,
-  isPxElementFileFormatDeep,
-  isScrollTimeline,
+  isPxDocument,
   isValidPlaybackRate,
-  kebabToCamelCaseWord,
-  kfEasing,
-  kfValue,
-  layoutGlyphTextChars,
+  isValidPxDocument,
   materializeAllInTree,
-  materializeGlyphText,
-  materializeGlyphTextAlongPath,
-  materializeMotionPathInPropAnim,
+  materializeNodeEffects,
   mayUseNativeScrollTimeline,
   mergeAnimatorConfig,
-  mergeStaticTransformIntoAnimDef,
   nestAnimatorTimeline,
+  normalizeBindings,
   parseWireVersion,
-  planSchemaRelease,
   progressSpanMs,
   progressToTimeMs,
   px,
   readWireVersion,
-  releaseLogProblems,
-  reportDocumentDiagnostics,
   resolveControlMode,
   resolveTimelineEngine,
   resolveTrigger,
-  reverseEasing,
-  sanitizeAttributeValue,
-  schemaFieldUniverse,
   schemaKeys,
-  scrollOffsetProgress,
-  scrollPhaseInterval,
-  scrollResolveAxis,
-  scrollTotalDurationMs,
-  scrollViewProgress,
   seekCeilingMs,
-  splitEasing,
-  subdivideCubicBezier,
   timeToProgress,
-  toRGBA,
+  toDomProps,
   validateDocument,
   validateNodeEffects,
-  versionAdvice
+  wireVersionAdvice
 });
 //# sourceMappingURL=index.cjs.map