pixi-effects 0.40.0 → 0.42.0

package/dist/{chunk-LEL7UNYQ.cjs → chunk-WVZLAIKK.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk27PYJ4JY_cjs = require('./chunk-27PYJ4JY.cjs');
-var chunk7EI2N7WO_cjs = require('./chunk-7EI2N7WO.cjs');
+var chunk3HZV3UHU_cjs = require('./chunk-3HZV3UHU.cjs');
+var chunkX62H3RBG_cjs = require('./chunk-X62H3RBG.cjs');
 var chunkLQDDDIC4_cjs = require('./chunk-LQDDDIC4.cjs');
 var chunkJN7JHNZR_cjs = require('./chunk-JN7JHNZR.cjs');
 var chunk3SAS3ZE5_cjs = require('./chunk-3SAS3ZE5.cjs');
@@ -1105,8 +1105,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunk7EI2N7WO_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunk7EI2N7WO_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkX62H3RBG_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkX62H3RBG_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
   const compW = out.width;
   const compH = out.height;
   const threeDByName = new Set(sequences.filter((s) => s.name && s.threeD).map((s) => s.name));
@@ -1174,16 +1174,16 @@ function expandTransitions(spec) {
     if (toUses > 1) {
       throw new Error(`pixi-effects: ${tag} sequence "${t.to}" is used as \`to\` in more than one transition`);
     }
-    const tStart = chunk7EI2N7WO_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkX62H3RBG_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunk7EI2N7WO_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkX62H3RBG_cjs.resolveAt(fromSeq.at, parentDuration);
     const fromEnd = fromStart + (fromSeq.duration ?? parentDuration);
     if (tStart < fromStart - EPS || tEnd > fromEnd + EPS) {
       throw new Error(`pixi-effects: ${tag} window [${tStart}, ${tEnd}] is not covered by \`from\` "${t.from}" (lives [${fromStart}, ${fromEnd}], so it ends at ${fromEnd})`);
     }
     const toSeq = toEntry.seq;
-    const toStart = chunk7EI2N7WO_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkX62H3RBG_cjs.resolveAt(toSeq.at, parentDuration);
     const toEnd = toStart + (toSeq.duration ?? parentDuration);
     if (tStart < toStart - EPS || tEnd > toEnd + EPS) {
       throw new Error(`pixi-effects: ${tag} window [${tStart}, ${tEnd}] is not covered by \`to\` "${t.to}" (lives [${toStart}, ${toEnd}], so it starts at ${toStart})`);
@@ -1243,7 +1243,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunk27PYJ4JY_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunk3HZV3UHU_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1513,7 +1513,7 @@ function canvasReport(root) {
       const problem = threw.length ? `${name} could not draw at ${threw.map((t) => `${t} s`).join(", ")} (its ${kind === "three" ? "update or render threw" : "draw threw"}, or the layer failed to build): ${kind === "three" ? "the warning above says why" : "it shows a magenta checkerboard there; the warning above says why"}, so the layer cannot be called deterministic` : differs.length ? `${name} does not draw the same picture for the same time (checked at ${differs.map(describeDiff).join(", ")}; drawn in two orders after one draw that was thrown away): ` + (kind === "three" ? "usually its update uses Math.random, Date.now, a clock, or state that builds up from call to call: a mixer advanced with mixer.update(dt) is one (pose a clip with mixer.setTime(t), or threeGltf(url).pose(t)), and so is a value moved by the time since the last call. A skinned model of your own (not loaded by threeGltf) that moves and casts a shadow does it too: three culls a skinned mesh by a bounding sphere that does not follow it, so set mesh.frustumCulled = false. Set every object from t, so playback, a seek and an export agree" : "usually its draw uses Math.random, Date.now or state that outlives the call (a value it keeps from the last call), so playback, a seek and an export would not agree: use info.random() (seeded) and derive everything from t. If it uses none of these, look at the canvases it draws from: make sprites and masks with info.canvas(w, h) (not document.createElement) and draw them into the picture before the strokes that depend on them") : "";
       out.push({ name: seq.spec.name ?? name, moments, drawMs, ok: !differs.length && !threw.length, problem, kind });
     }
-    if (seq instanceof chunk27PYJ4JY_cjs.CompositionSequence) walk2(seq);
+    if (seq instanceof chunk3HZV3UHU_cjs.CompositionSequence) walk2(seq);
   };
   const walk2 = (comp) => {
     for (const { seq } of comp.layers()) {
@@ -1565,8 +1565,8 @@ function motionOf(keyframes, local, lives, keys = (k) => GEOMETRY.has(k)) {
     let length = 0;
     if (typeof kf.duration === "number") length = kf.duration;
     else if (kf.duration === "auto") {
-      const sp = chunk7EI2N7WO_cjs.parseSpring(kf.ease);
-      length = sp ? Math.round(chunk7EI2N7WO_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
+      const sp = chunkX62H3RBG_cjs.parseSpring(kf.ease);
+      length = sp ? Math.round(chunkX62H3RBG_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
     }
     if (!(length > 0)) continue;
     const kat = kf.at ?? 0;
@@ -1645,7 +1645,7 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       if (motion.ever) hasMotion.add(info);
       let shown = bounds ? clip(bounds, view) : null;
       const maskTarget = seq.maskSequence?.target;
-      const maskSrc = chunk27PYJ4JY_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunk3HZV3UHU_cjs.maskSourceOf(seq.spec.mask);
       if (shown && maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert)) {
         const m = maskTarget.getBounds();
         shown = clip(shown, { x: m.x, y: m.y, width: m.width, height: m.height });
@@ -1654,7 +1654,7 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       const group = parentScene ?? (name !== void 0 && blending.has(name) ? name : void 0);
       if (group) scene.set(info, group);
       if (zero || seq.showsNothingYet) scaledToNothing.add(info);
-      if (seq instanceof chunk27PYJ4JY_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
+      if (seq instanceof chunk3HZV3UHU_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
     });
   };
   walk2(root, "", false, true);
@@ -1731,6 +1731,202 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
   return { frame, time, canvas, summary: { layers: layers.length, visible: layers.filter((l) => l.visible).length }, issues, layers: listed };
 }
 
+// src/core/pick.ts
+var scratch;
+var saidBlind = /* @__PURE__ */ new Set();
+var readResourceAlpha = (resource, x, y) => {
+  try {
+    if (scratch === void 0) {
+      const c = document.createElement("canvas");
+      c.width = c.height = 1;
+      scratch = c.getContext("2d", { willReadFrequently: true });
+    }
+    if (!scratch) return null;
+    scratch.clearRect(0, 0, 1, 1);
+    scratch.drawImage(resource, x, y, 1, 1, 0, 0, 1, 1);
+    return scratch.getImageData(0, 0, 1, 1).data[3] / 255;
+  } catch {
+    return null;
+  }
+};
+function pointInQuad(q, x, y) {
+  let pos = 0, neg = 0;
+  for (let i = 0; i < 4; i++) {
+    const ax = q[i * 2], ay = q[i * 2 + 1], bx = q[(i + 1) % 4 * 2], by = q[(i + 1) % 4 * 2 + 1];
+    const cross = (bx - ax) * (y - ay) - (by - ay) * (x - ax);
+    if (cross > 0) pos++;
+    else if (cross < 0) neg++;
+  }
+  return pos === 0 || neg === 0;
+}
+function orderOf(node) {
+  const key = [];
+  for (let n = node; n && n.parent; n = n.parent) {
+    key.unshift([n.zIndex ?? 0, Math.max(0, n.parent.children?.indexOf(n) ?? 0)]);
+  }
+  return key;
+}
+var above = (a, b) => {
+  for (let i = 0; i < Math.min(a.length, b.length); i++) {
+    if (a[i][0] !== b[i][0]) return b[i][0] - a[i][0];
+    if (a[i][1] !== b[i][1]) return b[i][1] - a[i][1];
+  }
+  return b.length - a.length;
+};
+function pickScene(root, x, y, opts = {}, deps = {}) {
+  if (opts.alpha !== void 0 && !(opts.alpha >= 0 && opts.alpha <= 1)) throw new Error(`pixi-effects: pick: alpha must be a number from 0 to 1 (a pixel at or below it is not a hit), got ${opts.alpha}`);
+  const readAlpha = deps.readAlpha ?? readResourceAlpha;
+  const found = [];
+  const names = (list, name, path) => list.some((e) => e === path || name !== void 0 && e === name || path.startsWith(e + "/") || path.split("/").slice(0, -1).includes(e));
+  const wanted = (name, path) => {
+    if (opts.ignore && names(opts.ignore, name, path)) return false;
+    if (opts.only && !names(opts.only, name, path)) return false;
+    return true;
+  };
+  const inside = (b, p) => p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;
+  const walk2 = (comp, prefix, parentVisible) => {
+    comp.layers().forEach(({ seq, display, threeD, carriers, quad }, i) => {
+      const d = display;
+      if (!d) return;
+      const t = seq.target;
+      const name = seq.spec.name;
+      const path = prefix + (name ?? `${seq.spec.type}#${i}`);
+      const alpha = (t?.alpha ?? 1) * carriers.reduce((a, c) => a * (c.target?.alpha ?? 1), 1);
+      const alive = (threeD ? d.visible : t?.renderable ?? true) && carriers.every((c) => c.target?.renderable ?? true);
+      const visible = parentVisible && alive && alpha > 0;
+      if (!visible) return;
+      const isComposition = seq instanceof chunk3HZV3UHU_cjs.CompositionSequence;
+      if (isComposition && !threeD) {
+        walk2(seq, path + "/", visible);
+        return;
+      }
+      if (!wanted(name, path)) return;
+      const point = { x, y };
+      let hit = null;
+      if (threeD) {
+        if (quad && pointInQuad(quad, d.toLocal(point).x, d.toLocal(point).y)) hit = { name, path, type: seq.spec.type, kind: "card", point };
+      } else {
+        const local = d.toLocal(point);
+        const lb = d.getLocalBounds();
+        if (inside(lb, local)) {
+          const three = typeof seq.pickAt === "function" ? seq.pickAt((local.x - lb.x) / lb.width, (local.y - lb.y) / lb.height) : void 0;
+          if (three) {
+            const planeOf = seq.dragPlane;
+            if (planeOf) {
+              three.grab = (plane = "screen") => {
+                const along = planeOf.call(seq, three.point, plane);
+                return { move: (cx, cy) => {
+                  const lp = d.toLocal({ x: cx, y: cy });
+                  const b = d.getLocalBounds();
+                  return along((lp.x - b.x) / b.width, (lp.y - b.y) / b.height);
+                } };
+              };
+            }
+            hit = { name, path, type: seq.spec.type, kind: "three", point, three };
+          } else if (three === void 0 && (typeof d.containsPoint !== "function" || d.containsPoint(local))) {
+            let opaque = true;
+            const tex = opts.alpha !== void 0 && seq.spec.type !== "shader" ? d.texture : void 0;
+            if (tex?.source?.resource) {
+              const res = tex.source.resolution ?? 1;
+              const a = readAlpha(tex.source.resource, (tex.frame.x + (local.x - lb.x) / lb.width * tex.frame.width) * res, (tex.frame.y + (local.y - lb.y) / lb.height * tex.frame.height) * res);
+              if (a === null) {
+                if (!saidBlind.has(path)) {
+                  saidBlind.add(path);
+                  console.warn(`pixi-effects: pick: the picture of layer "${path}" cannot be read for { alpha } (a picture from another origin: load it with crossorigin="anonymous" or from the same site), so the box counts as the picture`);
+                }
+              } else opaque = a > opts.alpha;
+            }
+            if (opaque) hit = { name, path, type: seq.spec.type, kind: "flat", point, local: { x: local.x - lb.x, y: local.y - lb.y } };
+          }
+        }
+      }
+      if (!hit) return;
+      const maskTarget = seq.maskSequence?.target;
+      const maskSrc = chunk3HZV3UHU_cjs.maskSourceOf(seq.spec.mask);
+      if (maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert) && !inside(maskTarget.getBounds(), point)) return;
+      found.push({ hit, order: orderOf(d) });
+    });
+  };
+  walk2(root, "", true);
+  return found.sort((a, b) => above(a.order, b.order)).map((f) => f.hit);
+}
+
+// src/core/hover.ts
+var keyOf = (h) => h ? `${h.path}${h.three ? `#${h.three.object}` : ""}` : null;
+function startHover(host, opts = {}) {
+  const { canvas } = host;
+  const request = host.requestFrame ?? ((fn) => requestAnimationFrame(fn));
+  const cancel = host.cancelFrame ?? ((id) => cancelAnimationFrame(id));
+  const cursor = opts.cursor === true ? "pointer" : opts.cursor || "";
+  const pickOpts = {};
+  if (opts.only) pickOpts.only = opts.only;
+  if (opts.ignore) pickOpts.ignore = opts.ignore;
+  let current = null;
+  let last = null;
+  let loop = null;
+  let said = false;
+  const call = (fn, hit) => {
+    if (!fn) return;
+    try {
+      fn(hit);
+    } catch (err) {
+      if (!said) {
+        said = true;
+        console.warn("pixi-effects: movie.hover: a handler threw (said once) \u2014", err);
+      }
+    }
+  };
+  const setCursor = (on) => {
+    if (cursor) canvas.style.cursor = on ? cursor : "";
+  };
+  const evaluate = () => {
+    if (!last) return;
+    const [x, y] = host.point(last);
+    const hit = host.pick(x, y, pickOpts);
+    if (keyOf(hit) === keyOf(current)) {
+      current = hit ?? current;
+      return;
+    }
+    const was = current;
+    current = hit;
+    if (was) call(opts.onLeave, was);
+    if (hit) call(opts.onEnter, hit);
+    setCursor(!!hit);
+  };
+  const tick = () => {
+    loop = null;
+    if (last) {
+      evaluate();
+      loop = request(tick);
+    }
+  };
+  const onMove = (event) => {
+    last = event;
+    evaluate();
+    if (loop === null) loop = request(tick);
+  };
+  const onLeave = () => {
+    last = null;
+    if (loop !== null) {
+      cancel(loop);
+      loop = null;
+    }
+    const was = current;
+    current = null;
+    if (was) call(opts.onLeave, was);
+    setCursor(false);
+  };
+  canvas.addEventListener("pointermove", onMove);
+  canvas.addEventListener("pointerdown", onMove);
+  canvas.addEventListener("pointerleave", onLeave);
+  return () => {
+    canvas.removeEventListener("pointermove", onMove);
+    canvas.removeEventListener("pointerdown", onMove);
+    canvas.removeEventListener("pointerleave", onLeave);
+    onLeave();
+  };
+}
+
 // src/core/timelineChart.ts
 var GROUP_MIN = 4;
 var MAX_KEYS = 200;
@@ -1738,7 +1934,7 @@ var round = (n) => Math.round(n * 1e6) / 1e6;
 var family = (name) => name.replace(/\d+/g, "#");
 function detailOf(seq) {
   const s = seq.spec;
-  const spans = chunk7EI2N7WO_cjs.spansMeta.get(seq.spec)?.preview;
+  const spans = chunkX62H3RBG_cjs.spansMeta.get(seq.spec)?.preview;
   if (spans) return spans.length > 60 ? spans.slice(0, 57) + "\u2026" : spans;
   if (typeof s.text === "string") return s.text.length > 60 ? s.text.slice(0, 57) + "\u2026" : s.text;
   if (typeof s.asset === "string") return `asset \u201C${s.asset}\u201D`;
@@ -1754,10 +1950,10 @@ function walk(comp, parentStart, parentEnd, depth, prefix, rows, transitions, lo
     const start = parentStart + (seq.at ?? 0);
     const end = Math.min(parentEnd, seq.duration !== void 0 ? start + seq.duration : parentEnd);
     const span = end - start;
-    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunk7EI2N7WO_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkX62H3RBG_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
     const row = { path: prefix + name, name, type: seq.spec.type, depth, start: round(start), end: round(end), keys, detail: detailOf(seq), ...local ? { local } : {} };
     const inner = [];
-    const isComp = seq instanceof chunk27PYJ4JY_cjs.CompositionSequence;
+    const isComp = seq instanceof chunk3HZV3UHU_cjs.CompositionSequence;
     if (isComp) {
       const label = seq.remapLabel();
       walk(seq, label ? 0 : start, label ? seq.contentSpan : end, depth + 1, prefix + name + "/", inner, transitions, label ? `${name} ${label}` : local);
@@ -1916,7 +2112,7 @@ function sheetLayout(n, columns, cellW, srcW, srcH, labelH) {
 }
 
 // src/core/vars.ts
-var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunk7EI2N7WO_cjs.EXPRESSION_NAMES];
+var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkX62H3RBG_cjs.EXPRESSION_NAMES];
 var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var isPlain = (v) => !!v && typeof v === "object" && (Object.getPrototypeOf(v) === Object.prototype || Object.getPrototypeOf(v) === null);
 function normalizeVars(raw, where, warn = (m) => console.warn(m)) {
@@ -2455,8 +2651,8 @@ var Movie = class {
       this.stops = normalizeStops(applyVars(options.composition, this._vars)?.stops, this.duration, this.frameRate);
       this._posterFrame = poster.frame;
       this.background = options.background ?? "#000000";
-      this.timeline = chunk7EI2N7WO_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunk7EI2N7WO_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkX62H3RBG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkX62H3RBG_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2550,7 +2746,7 @@ var Movie = class {
       height: sizeWins ? height : spec.height ?? height,
       duration: spec.duration ?? this.duration
     } : void 0;
-    await chunk7EI2N7WO_cjs.ensureFilterLibrary(seededComposition);
+    await chunkX62H3RBG_cjs.ensureFilterLibrary(seededComposition);
     if (chunkJN7JHNZR_cjs.usesAdvancedBlend(seededComposition)) await chunkJN7JHNZR_cjs.enableAdvancedBlend(this.app.renderer);
     const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
     const rootSeqSpec = {
@@ -2561,7 +2757,7 @@ var Movie = class {
       ...userComposition
     };
     if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-    const sequence = new chunk27PYJ4JY_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+    const sequence = new chunk3HZV3UHU_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
     lp?.begin("build", countLayers(rootSeqSpec));
     try {
       await sequence.build();
@@ -2697,8 +2893,8 @@ var Movie = class {
       if (!changed) return { reason, ms: 0, audio: "none", frame: this.currentFrame, playing: this.isPlaying, unchanged: true };
       sequence = await this._construct(composition, vars, width, height, void 0, this._resized || sizeChanged);
       alive();
-      const timeline = chunk7EI2N7WO_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunk7EI2N7WO_cjs.lengthen(timeline, this.duration);
+      const timeline = chunkX62H3RBG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkX62H3RBG_cjs.lengthen(timeline, this.duration);
       sequence.bindTimeline(timeline);
       const hadSound = this.audioBuffer !== null;
       const audio = await this._mixSound(sequence, this._ensureAudioContext());
@@ -2785,6 +2981,14 @@ var Movie = class {
     await this._goto(frame);
     this.emit("seeked", { frame: this.currentFrame, totalFrames: this.totalFrames });
   }
+  /**
+   * Draw the frame on screen again, quietly (no `seeking` / `seeked`). For a paused movie when something outside it that a layer reads has changed: a `three` layer whose `update` reads the page's own
+   * state (a dragged object's place) shows it after `await movie.redraw()`. A playing movie needs no call: the next frame draws it.
+   */
+  async redraw() {
+    this._requireReady("redraw");
+    await this._quietly(() => this.gotoFrame(this.currentFrame, true));
+  }
   /** Run `fn` with `seeking` / `seeked` silenced: the movie is moving its own playhead, not answering a seek. */
   async _quietly(fn) {
     this._quiet++;
@@ -2988,6 +3192,41 @@ var Movie = class {
    * Where every layer is drawn at `frame` (canvas pixels, visibility) plus `issues` — text that is off
    * the canvas, cut by an edge, empty, or overlapping other text. Seeks there and stays there.
    */
+  /**
+   * What is under the canvas point (x, y) (canvas pixels: the movie's own `width` x `height`; `canvasPoint(event)` makes them from a pointer event) at the frame on screen: the layer on
+   * top, or null. A flat layer is hit by its own shape, a `threeD` card by its projected quad, a `three` layer by a ray through its camera (`hit.three` has the object). It reads the
+   * frame as the last draw left it, so after `await movie.snapshot(frame)` or any seek it answers for that frame. `opts.only` / `opts.ignore`: layer names or paths.
+   */
+  pick(x, y, opts = {}) {
+    return this.pickAll(x, y, opts)[0] ?? null;
+  }
+  /** Every layer under the canvas point, the one on top first (see `pick`). */
+  pickAll(x, y, opts = {}) {
+    chunkTWZNOUM7_cjs.warnUnknownOptions("movie.pick()", opts, ["only", "ignore", "alpha"]);
+    this._requireReady("pick");
+    if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error(`pixi-effects: movie.pick(x, y) needs two numbers (canvas pixels), got ${x}, ${y}. For a pointer event: movie.pick(...movie.canvasPoint(event))`);
+    return pickScene(this._rootSequence, x, y, opts);
+  }
+  /**
+   * Which layer the pointer is over, as callbacks: `onEnter(hit)` when the layer (or, in a `three` layer, the object) under the pointer changes to another, `onLeave(hit)` for the one it
+   * left (also when the pointer leaves the picture). While the pointer rests inside, it is asked again on every frame, so a picture that moves under a still pointer is followed.
+   * `{ only, ignore }` as for `pick`; `cursor: true` (or a CSS cursor) shows it while something is hovered. Returns the function that stops it. A page-side tool: an exported video has no pointer.
+   */
+  hover(opts = {}) {
+    chunkTWZNOUM7_cjs.warnUnknownOptions("movie.hover()", opts, ["onEnter", "onLeave", "cursor", "only", "ignore"]);
+    this._requireReady("hover");
+    const canvas = this.app?.canvas;
+    if (!canvas) throw new Error("pixi-effects: movie.hover needs the movie's canvas");
+    return startHover({ canvas, pick: (x, y, o) => this.pick(x, y, o), point: (e) => this.canvasPoint(e) }, opts);
+  }
+  /** A pointer event's place in canvas pixels (the canvas may be shown larger or smaller than its own size): `movie.pick(...movie.canvasPoint(event))`. */
+  canvasPoint(event) {
+    this._requireReady("canvasPoint");
+    const canvas = this.app?.canvas;
+    if (!canvas) throw new Error("pixi-effects: movie.canvasPoint needs the movie's canvas");
+    const r = canvas.getBoundingClientRect();
+    return [(event.clientX - r.left) * this.width / (r.width || this.width), (event.clientY - r.top) * this.height / (r.height || this.height)];
+  }
   async inspect(frame = this.currentFrame, opts = { layers: "visible" }) {
     chunkTWZNOUM7_cjs.warnUnknownOptions("movie.inspect()", opts, ["layers"]);
     this._requireReady("inspect");
@@ -3422,7 +3661,7 @@ function countLayers(spec) {
     n += 1 + countLayers(s);
     const spans = s.spans;
     if (Array.isArray(spans)) n += spans.length;
-    const src = chunk27PYJ4JY_cjs.maskSourceOf(mask);
+    const src = chunk3HZV3UHU_cjs.maskSourceOf(mask);
     if (src.kind === "inline") n += 1 + countLayers(src.spec);
   }
   return n;
@@ -3511,8 +3750,8 @@ function splitVertical(text, style, ts, right, top, align, by) {
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunk7EI2N7WO_cjs.checkEase(name, "a preset");
-  return chunk7EI2N7WO_cjs.parseEase(name);
+  chunkX62H3RBG_cjs.checkEase(name, "a preset");
+  return chunkX62H3RBG_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -3647,17 +3886,17 @@ function orbit(opts) {
     throw new Error("pixi-effects: orbit() cannot combine `radius` with `dollyZoom` \u2014 the radius follows the animated fov");
   }
   const [cx, cy] = opts.center ?? [width / 2, height / 2];
-  const fixedR = opts.radius ?? chunk7EI2N7WO_cjs.homeDistance(height, fov ?? chunk7EI2N7WO_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkX62H3RBG_cjs.homeDistance(height, fov ?? chunkX62H3RBG_cjs.DEFAULT_FOV);
   const start = opts.start ?? -degrees / 2;
   const steps = Math.max(1, Math.round(duration * stepsPerSecond));
   const easeFn = parseEase2(ease);
   const dollyEase = dolly ? parseEase2(dolly.ease ?? ease) : null;
   const pos = (i) => {
     const p = i / steps;
-    const a = (start + degrees * easeFn(p)) * chunk7EI2N7WO_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkX62H3RBG_cjs.DEG;
     if (!dolly) return { x: cx + fixedR * Math.sin(a), z: fixedR * Math.cos(a) };
     const f = dolly.from + (dolly.to - dolly.from) * dollyEase(p);
-    const R = chunk7EI2N7WO_cjs.homeDistance(height, f);
+    const R = chunkX62H3RBG_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -3712,7 +3951,7 @@ function particles(opts) {
   const round2 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunk7EI2N7WO_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkX62H3RBG_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -3725,7 +3964,7 @@ function particles(opts) {
     const turn = spin ? pick(spin) : 0;
     const startAngle = spin ? r() * 360 : 0;
     const swayAmp = sway?.amp ?? 0, swayFreq = sway?.freq ?? 1;
-    const n0 = sway ? chunk7EI2N7WO_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkX62H3RBG_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -3734,7 +3973,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunk7EI2N7WO_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkX62H3RBG_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -3796,7 +4035,7 @@ function followPath(opts) {
   if (steps > MAX_STEPS) throw new Error(`followPath(): ${steps} samples is too many (max ${MAX_STEPS}); lower frameRate or duration`);
   const segments = [];
   let total = 0;
-  for (const line of chunk7EI2N7WO_cjs.flattenSvgPath(d)) {
+  for (const line of chunkX62H3RBG_cjs.flattenSvgPath(d)) {
     const p = line.closed ? [...line.pts, line.pts[0], line.pts[1]] : line.pts;
     for (let i = 2; i < p.length; i += 2) {
       const len = Math.hypot(p[i] - p[i - 2], p[i + 1] - p[i - 1]);
@@ -3849,7 +4088,7 @@ function followPath(opts) {
 // src/core/pathSample.ts
 function samplePath(d) {
   if (typeof d !== "string" || d.trim() === "") throw new Error('samplePath(): d must be SVG path data, e.g. "M 40 300 C 200 20 400 20 560 300"');
-  const lines = chunk7EI2N7WO_cjs.flattenSvgPath(d);
+  const lines = chunkX62H3RBG_cjs.flattenSvgPath(d);
   const segments = [];
   let length = 0;
   for (const line of lines) {
@@ -3880,7 +4119,7 @@ function samplePath(d) {
       return { x: g.x0 + (g.x1 - g.x0) * t, y: g.y0 + (g.y1 - g.y0) * t, angle: Math.atan2(g.y1 - g.y0, g.x1 - g.x0) };
     },
     trim(start = 0, end = 1) {
-      return chunk7EI2N7WO_cjs.trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
+      return chunkX62H3RBG_cjs.trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
     }
   };
 }
@@ -3989,7 +4228,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunk7EI2N7WO_cjs.random(seed);
+    const r = chunkX62H3RBG_cjs.random(seed);
     for (let i = n - 1; i > 0; i--) {
       const j = Math.floor(r() * (i + 1));
       [order[i], order[j]] = [order[j], order[i]];
@@ -4051,7 +4290,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunk7EI2N7WO_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkX62H3RBG_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
       to[n] = typeof p.around === "number" ? p.around + off : `(${p.around}) ${off < 0 ? "-" : "+"} ${Math.abs(off)}`;
     });
     out.push({ at: at + s * stepLen, to, duration: stepLen, ease });
@@ -4510,5 +4749,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-LEL7UNYQ.cjs.map
-//# sourceMappingURL=chunk-LEL7UNYQ.cjs.map
+//# sourceMappingURL=chunk-WVZLAIKK.cjs.map
+//# sourceMappingURL=chunk-WVZLAIKK.cjs.map