@pixodesk/svg-animator-core 1.0.41 → 1.0.44

package/dist/{chunk-L6GJ6Y2M.js → chunk-EFQLDGFY.js}

@@ -563,7 +563,7 @@ var px = {
 };
 
 // src/version/PxSchemaVersion.ts
-var PX_WIRE_SCHEMA_VERSION = "1.1";
+var PX_WIRE_SCHEMA_VERSION = "1.2";
 
 // src/version/PxWireVersion.ts
 var PX_WIRE_VERSION_KEY = "version";
@@ -632,7 +632,46 @@ var PxWireStepKind = /* @__PURE__ */ ((PxWireStepKind2) => {
   return PxWireStepKind2;
 })(PxWireStepKind || {});
 var PX_WIRE_BASELINE_VERSION = "1.1";
-var PX_WIRE_STEPS = [];
+var PX_WIRE_STEPS = [
+  {
+    from: "1.1",
+    to: "1.2",
+    reason: "The trigger block became two axes: `start` says what STARTS an animation, `offScreen` + `visibilityThreshold` + `visibilityDebounce` say whether it may RUN. `scrollIntoView` is no longer a start value \u2014 it is what `start: 'load'` behind the default gate already means \u2014 and `outAction` split into `offScreen` (scroll) and `mouseOut` (hover), because one field meant three things.",
+    kind: "converted" /* converted */,
+    up: upTriggerTwoAxes
+    // No `down`: 1.2 can express combinations 1.1 could not ("start on click AND pause when
+    // scrolled away"), so the mapping is not invertible.
+  }
+];
+function upTriggerTwoAxes(doc) {
+  const animator = doc["animator"];
+  if (!animator || typeof animator !== "object") return;
+  const timeline = animator["timeline"];
+  const holder = timeline && typeof timeline === "object" ? timeline : animator;
+  const trigger = holder["trigger"];
+  if (!trigger || typeof trigger !== "object") return;
+  const t = trigger;
+  const startOn = t["startOn"];
+  const outAction = t["outAction"];
+  delete t["startOn"];
+  delete t["outAction"];
+  if (startOn === "scrollIntoView") {
+    if (outAction !== void 0) t["offScreen"] = outAction;
+  } else {
+    if (startOn === "programmatic") t["start"] = "none";
+    else if (startOn !== void 0) t["start"] = startOn;
+    if (startOn === "mouseOver" && outAction !== void 0) t["mouseOut"] = outAction;
+    if (t["offScreen"] === void 0) t["offScreen"] = "continue";
+  }
+  if (t["scrollIntoViewThreshold"] !== void 0) {
+    t["visibilityThreshold"] = t["scrollIntoViewThreshold"];
+    delete t["scrollIntoViewThreshold"];
+  }
+  if (t["finishAction"] !== void 0) {
+    t["finish"] = t["finishAction"];
+    delete t["finishAction"];
+  }
+}
 function applyWireSteps(doc, cfg) {
   const from = readWireVersion(doc);
   const relation = compareWireVersion(from, cfg.target, cfg.readerReadsEditorPart);
@@ -757,14 +796,18 @@ var PxPlaybackDirection = {
 };
 var PX_ANIM_SRC_ATTR_NAME = "data-px-animation-src";
 var PX_ANIM_ATTR_NAME = "_px_animator";
-var PxStartOn = {
+var PxTriggerStart = {
   load: "load",
   mouseOver: "mouseOver",
   click: "click",
-  scrollIntoView: "scrollIntoView",
-  programmatic: "programmatic"
+  none: "none"
 };
-var PxOutAction = {
+var PxOffScreenAction = {
+  pause: "pause",
+  continue: "continue",
+  reset: "reset"
+};
+var PxMouseOutAction = {
   continue: "continue",
   pause: "pause",
   reset: "reset",
@@ -832,9 +875,11 @@ function mayUseNativeScrollTimeline(engine) {
   return engine !== PxTimelineEngineSetting.js;
 }
 var PX_TRIGGER_DEFAULTS = {
-  startOn: "load",
-  outAction: "continue",
-  scrollIntoViewThreshold: 0
+  start: "load",
+  offScreen: "pause",
+  mouseOut: "continue",
+  visibilityThreshold: 0.5,
+  visibilityDebounce: 150
 };
 var PxControlMode = {
   /** No control props — the document's trigger decides, and nothing is taken over. */
@@ -868,11 +913,13 @@ function controlModeTakesOverTrigger(mode) {
   return mode !== PxControlMode.autoplay;
 }
 function resolveTrigger(trigger) {
-  var _a2, _b, _c;
+  var _a2, _b, _c, _d, _e;
   return {
-    startOn: (_a2 = trigger == null ? void 0 : trigger.startOn) != null ? _a2 : PX_TRIGGER_DEFAULTS.startOn,
-    outAction: (_b = trigger == null ? void 0 : trigger.outAction) != null ? _b : PX_TRIGGER_DEFAULTS.outAction,
-    scrollIntoViewThreshold: (_c = trigger == null ? void 0 : trigger.scrollIntoViewThreshold) != null ? _c : PX_TRIGGER_DEFAULTS.scrollIntoViewThreshold
+    start: (_a2 = trigger == null ? void 0 : trigger.start) != null ? _a2 : PX_TRIGGER_DEFAULTS.start,
+    offScreen: (_b = trigger == null ? void 0 : trigger.offScreen) != null ? _b : PX_TRIGGER_DEFAULTS.offScreen,
+    mouseOut: (_c = trigger == null ? void 0 : trigger.mouseOut) != null ? _c : PX_TRIGGER_DEFAULTS.mouseOut,
+    visibilityThreshold: (_d = trigger == null ? void 0 : trigger.visibilityThreshold) != null ? _d : PX_TRIGGER_DEFAULTS.visibilityThreshold,
+    visibilityDebounce: (_e = trigger == null ? void 0 : trigger.visibilityDebounce) != null ? _e : PX_TRIGGER_DEFAULTS.visibilityDebounce
   };
 }
 var PxLoopRepeatAt = {
@@ -1008,9 +1055,9 @@ function flattenAnimatorTimeline(cfg) {
   } else {
     if (timeline.duration !== void 0) flat.duration = timeline.duration;
     if (timeline.trigger !== void 0) {
-      const _b = timeline.trigger, { finishAction } = _b, restTrigger = __objRest(_b, ["finishAction"]);
+      const _b = timeline.trigger, { finish } = _b, restTrigger = __objRest(_b, ["finish"]);
       if (Object.keys(restTrigger).length) flat.trigger = restTrigger;
-      if (finishAction !== void 0) flat.resetOnFinish = finishAction === "reset";
+      if (finish !== void 0) flat.resetOnFinish = finish === "reset";
     }
     if (timeline.delay !== void 0) flat.delay = timeline.delay;
     if (timeline.iterations !== void 0) flat.iterations = timeline.iterations;
@@ -1077,7 +1124,7 @@ function nestAnimatorTimeline(cfg) {
   if (duration !== void 0) timeline.duration = duration;
   if (trigger !== void 0 || resetOnFinish) {
     const t = __spreadValues({}, trigger || {});
-    if (resetOnFinish) t.finishAction = "reset";
+    if (resetOnFinish) t.finish = "reset";
     timeline.trigger = t;
   }
   if (delay !== void 0) timeline.delay = delay;
@@ -1180,13 +1227,15 @@ var PxElementAnimationSchema = implementsInterface()(px.union([
   PxAnimationDefinitionSchema
 ]));
 var PxTriggerSchema = implementsInterface()(px.object({
-  startOn: px.enum([PxStartOn.load, PxStartOn.mouseOver, PxStartOn.click, PxStartOn.scrollIntoView, PxStartOn.programmatic], PX_TRIGGER_DEFAULTS.startOn).optional(),
-  outAction: px.enum([PxOutAction.continue, PxOutAction.pause, PxOutAction.reset, PxOutAction.reverse], PX_TRIGGER_DEFAULTS.outAction).optional(),
+  start: px.enum([PxTriggerStart.load, PxTriggerStart.mouseOver, PxTriggerStart.click, PxTriggerStart.none], PX_TRIGGER_DEFAULTS.start).optional(),
+  offScreen: px.enum([PxOffScreenAction.pause, PxOffScreenAction.continue, PxOffScreenAction.reset], PX_TRIGGER_DEFAULTS.offScreen).optional(),
+  mouseOut: px.enum([PxMouseOutAction.continue, PxMouseOutAction.pause, PxMouseOutAction.reset, PxMouseOutAction.reverse], PX_TRIGGER_DEFAULTS.mouseOut).optional(),
   // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
-  // `fill`) or `'reset'` (snap back to the start state). Pairs with `outAction` ("what
-  // happens when the trigger condition ends"); both end-of-life knobs now read alike.
-  finishAction: px.enum([PxFinishAction.hold, PxFinishAction.reset]).optional(),
-  scrollIntoViewThreshold: px.number().optional()
+  // `fill`) or `'reset'` (snap back to the start state). One of four occasion keys
+  // (`start`, `offScreen`, `mouseOut`, `finish`), all named the same way.
+  finish: px.enum([PxFinishAction.hold, PxFinishAction.reset]).optional(),
+  visibilityThreshold: px.number().optional(),
+  visibilityDebounce: px.number().optional()
 }));
 var PxGlyphSchema = implementsInterface()(px.object({
   width: px.number(),
@@ -4373,32 +4422,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);
     }
   };
 }
@@ -4448,8 +4499,9 @@ export {
   PxPlaybackDirection,
   PX_ANIM_SRC_ATTR_NAME,
   PX_ANIM_ATTR_NAME,
-  PxStartOn,
-  PxOutAction,
+  PxTriggerStart,
+  PxOffScreenAction,
+  PxMouseOutAction,
   PxFinishAction,
   PxScrollKind,
   PxScrollAxis,
@@ -4592,4 +4644,4 @@ export {
   diagnoseDocument,
   reportDocumentDiagnostics
 };
-//# sourceMappingURL=chunk-L6GJ6Y2M.js.map
+//# sourceMappingURL=chunk-EFQLDGFY.js.map