pixi-effects 0.45.0 → 0.47.0

package/dist/{chunk-3IO5RWE4.cjs → chunk-I6VUQ2CR.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk3HZV3UHU_cjs = require('./chunk-3HZV3UHU.cjs');
-var chunkX62H3RBG_cjs = require('./chunk-X62H3RBG.cjs');
-var chunkO66JGPVV_cjs = require('./chunk-O66JGPVV.cjs');
+var chunkDKCMJILW_cjs = require('./chunk-DKCMJILW.cjs');
+var chunkLALEBV63_cjs = require('./chunk-LALEBV63.cjs');
+var chunk23SXKSUI_cjs = require('./chunk-23SXKSUI.cjs');
 var chunkJN7JHNZR_cjs = require('./chunk-JN7JHNZR.cjs');
 var chunk3SAS3ZE5_cjs = require('./chunk-3SAS3ZE5.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
@@ -109,7 +109,7 @@ async function mixdown(audios, totalDuration, sampleRate = 44100, pace) {
     if (pace) await pace(made / all);
     if (!buffer) continue;
     if (a.warp || a.sourceMap) {
-      const r = chunkO66JGPVV_cjs.resampleThrough(a, buffer.getChannelData(0), buffer.numberOfChannels > 1 ? buffer.getChannelData(1) : buffer.getChannelData(0), buffer.sampleRate, sampleRate, totalDuration);
+      const r = chunk23SXKSUI_cjs.resampleThrough(a, buffer.getChannelData(0), buffer.numberOfChannels > 1 ? buffer.getChannelData(1) : buffer.getChannelData(0), buffer.sampleRate, sampleRate, totalDuration);
       if (!r) continue;
       const out = ctx.createBuffer(2, r.L.length, sampleRate);
       out.getChannelData(0).set(r.L);
@@ -143,18 +143,86 @@ async function mixdown(audios, totalDuration, sampleRate = 44100, pace) {
 }
 var KNEE = 0.9;
 var LOUDNESS_CEILING_DB = -1;
+var MAX_LIMIT_DB = 10;
+function limitInto(source, out, gain, ceil, sampleRate) {
+  const n = source[0]?.length ?? 0;
+  const req = new Float32Array(n);
+  for (let i = 0; i < n; i++) {
+    let p = 0;
+    for (const c of source) {
+      const a = Math.abs(c[i]) * gain;
+      if (a > p) p = a;
+    }
+    req[i] = p > ceil ? ceil / p : 1;
+  }
+  const L = Math.max(1, Math.round(3e-3 * sampleRate));
+  const mn = new Float32Array(n), dq = new Int32Array(n);
+  let head = 0, tail = 0;
+  for (let i = n - 1; i >= 0; i--) {
+    while (tail > head && req[dq[tail - 1]] >= req[i]) tail--;
+    dq[tail++] = i;
+    while (dq[head] > i + L) head++;
+    mn[i] = req[dq[head]];
+  }
+  const release = 1 - Math.exp(-1 / (0.08 * sampleRate));
+  let run = 0, prev = 1, lowest = 1, lowestAt = 0;
+  const gains = new Float32Array(n);
+  for (let i = 0; i < n; i++) {
+    run += mn[i];
+    if (i > L) run -= mn[i - L - 1];
+    const avg = run / Math.min(i + 1, L + 1);
+    const g = Math.min(avg, prev + (1 - prev) * release);
+    gains[i] = g;
+    prev = g;
+    if (g < lowest) {
+      lowest = g;
+      lowestAt = i;
+    }
+  }
+  for (let ch = 0; ch < source.length; ch++) {
+    const s = source[ch], o = out[ch];
+    for (let i = 0; i < n; i++) {
+      const v = s[i] * gain * gains[i];
+      o[i] = v > ceil ? ceil : v < -ceil ? -ceil : v;
+    }
+  }
+  return { reductionDb: lowest < 1 ? -20 * Math.log10(lowest) : 0, at: lowestAt / sampleRate };
+}
 function normalizeMix(buffer, target) {
   const chans = [];
   for (let ch = 0; ch < buffer.numberOfChannels; ch++) chans.push(buffer.getChannelData(ch));
-  const m = chunkO66JGPVV_cjs.measureLoudness(chans, buffer.sampleRate, { truePeak: false });
+  const sr = buffer.sampleRate;
+  const m = chunk23SXKSUI_cjs.measureLoudness(chans, sr, { truePeak: false });
   if (m.integratedLufs === null) return { target, gainDb: 0, reachedLufs: null, limited: false };
+  const original = chans.map((c) => Float32Array.from(c));
   let gainDb = target - m.integratedLufs;
-  const room = LOUDNESS_CEILING_DB - m.samplePeakDb;
-  const limited = gainDb > room;
-  if (limited) gainDb = room;
-  const gain = 10 ** (gainDb / 20);
-  for (const d of chans) for (let i = 0; i < d.length; i++) d[i] = d[i] * gain;
-  return { target, gainDb: Math.round(gainDb * 10) / 10, reachedLufs: Math.round((m.integratedLufs + gainDb) * 10) / 10, limited };
+  let ceilDb = LOUDNESS_CEILING_DB;
+  let applied = { reductionDb: 0, at: 0 }, measured = m;
+  for (let round2 = 0; round2 < 8; round2++) {
+    const cap = MAX_LIMIT_DB + ceilDb - m.samplePeakDb;
+    if (gainDb > cap) gainDb = cap;
+    applied = limitInto(original, chans, 10 ** (gainDb / 20), 10 ** (ceilDb / 20), sr);
+    measured = chunk23SXKSUI_cjs.measureLoudness(chans, sr);
+    const overTp = measured.truePeakDb - LOUDNESS_CEILING_DB;
+    if (overTp > 0.02) {
+      ceilDb -= overTp + 0.02;
+      continue;
+    }
+    const deficit = target - measured.integratedLufs;
+    if (Math.abs(deficit) <= 0.15) break;
+    const next = Math.min(gainDb + deficit, cap);
+    if (Math.abs(next - gainDb) < 0.05) break;
+    gainDb = next;
+  }
+  const limited = measured.integratedLufs < target - 0.15;
+  const reduction = Math.round(applied.reductionDb * 10) / 10;
+  return {
+    target,
+    gainDb: Math.round(gainDb * 10) / 10,
+    reachedLufs: measured.integratedLufs,
+    limited,
+    ...reduction >= 0.1 ? { limiterDb: reduction, limiterAt: Math.round(applied.at * 100) / 100 } : {}
+  };
 }
 function limitMix(buffer, audios) {
   let peak = 0;
@@ -172,7 +240,7 @@ function limitMix(buffer, audios) {
   }
   const peakAt = peakIndex / buffer.sampleRate;
   if (peak > 1) {
-    const playing = audios.map((a) => ({ a, ...chunkO66JGPVV_cjs.playSpan(a, buffer.duration) })).filter((s) => s.start <= peakAt && peakAt < s.end).map((s) => s.a.layer ?? "an audio layer");
+    const playing = audios.map((a) => ({ a, ...chunk23SXKSUI_cjs.playSpan(a, buffer.duration) })).filter((s) => s.start <= peakAt && peakAt < s.end).map((s) => s.a.layer ?? "an audio layer");
     console.warn(
       `pixi-effects: the audio mix peaks at ${peak.toFixed(2)} (${(20 * Math.log10(peak)).toFixed(1)} dBFS) at ${peakAt.toFixed(2)}s, so it was limited (it would distort). Playing there: ${[...new Set(playing)].join(", ")}. Lower their volume.`
     );
@@ -1134,8 +1202,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunkX62H3RBG_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunkX62H3RBG_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkLALEBV63_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkLALEBV63_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));
@@ -1203,16 +1271,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 = chunkX62H3RBG_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkLALEBV63_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkX62H3RBG_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkLALEBV63_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 = chunkX62H3RBG_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkLALEBV63_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})`);
@@ -1272,7 +1340,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunk3HZV3UHU_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunkDKCMJILW_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1542,7 +1610,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 chunk3HZV3UHU_cjs.CompositionSequence) walk3(seq);
+    if (seq instanceof chunkDKCMJILW_cjs.CompositionSequence) walk3(seq);
   };
   const walk3 = (comp) => {
     for (const { seq } of comp.layers()) {
@@ -1594,8 +1662,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 = chunkX62H3RBG_cjs.parseSpring(kf.ease);
-      length = sp ? Math.round(chunkX62H3RBG_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
+      const sp = chunkLALEBV63_cjs.parseSpring(kf.ease);
+      length = sp ? Math.round(chunkLALEBV63_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
     }
     if (!(length > 0)) continue;
     const kat = kf.at ?? 0;
@@ -1634,7 +1702,7 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       const name = seq.spec.name;
       const label = name ?? `${seq.spec.type}#${i}`;
       const alpha = (t?.alpha ?? 1) * carriers.reduce((a, c) => a * (c.target?.alpha ?? 1), 1);
-      const alive = (threeD ? display.visible : t?.renderable ?? true) && carriers.every((c) => c.target?.renderable ?? true);
+      const alive = (threeD ? display.visible : (t?.renderable ?? true) && t?.visible !== false) && carriers.every((c) => c.target?.renderable ?? true);
       const visible = parentVisible && alive && alpha > 0;
       let bounds = null;
       if (!insideThreeD) {
@@ -1675,7 +1743,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 = chunk3HZV3UHU_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunkDKCMJILW_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 });
@@ -1684,7 +1752,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 chunk3HZV3UHU_cjs.CompositionSequence) walk3(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
+      if (seq instanceof chunkDKCMJILW_cjs.CompositionSequence) walk3(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
     });
   };
   walk3(root, "", false, true);
@@ -1814,7 +1882,22 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
     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 walk3 = (comp, prefix, parentVisible) => {
+  const hiddenSources = /* @__PURE__ */ new Map();
+  const forwards = [];
+  const rays = /* @__PURE__ */ new Map();
+  const rayOf = (seq, d, local, lb) => {
+    if (typeof seq.pickAt !== "function") return null;
+    if (!rays.has(seq)) rays.set(seq, seq.pickAt((local.x - lb.x) / lb.width, (local.y - lb.y) / lb.height));
+    return rays.get(seq);
+  };
+  const forwardThrough = (seq, d, path, local, lb) => {
+    const shows = seq.screenOf;
+    if (!shows || !inside(lb, local)) return;
+    const r = rayOf(seq, d, local, lb);
+    const shown = r?.uv ? shows.call(seq, r.material) : null;
+    if (r?.uv && shown) forwards.push({ source: shown.source, uv: r.uv, via: { path, object: String(r.object) }, order: orderOf(d) });
+  };
+  const walk3 = (comp, prefix, parentVisible, at = { x, y }, orderBase, via) => {
     comp.layers().forEach(({ seq, display, threeD, carriers, quad }, i) => {
       const d = display;
       if (!d) return;
@@ -1822,16 +1905,25 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
       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 alive = (threeD ? d.visible : (t?.renderable ?? true) && t?.visible !== false) && carriers.every((c) => c.target?.renderable ?? true);
       const visible = parentVisible && alive && alpha > 0;
-      if (!visible) return;
-      const isComposition = seq instanceof chunk3HZV3UHU_cjs.CompositionSequence;
+      if (!visible) {
+        if (seq instanceof chunkDKCMJILW_cjs.CompositionSequence && !threeD && parentVisible && alpha > 0 && t?.visible === false && (t?.renderable ?? true) && carriers.every((c) => c.target?.renderable ?? true)) hiddenSources.set(seq, path);
+        return;
+      }
+      const isComposition = seq instanceof chunkDKCMJILW_cjs.CompositionSequence;
       if (isComposition && !threeD) {
-        walk3(seq, path + "/", visible);
+        walk3(seq, path + "/", visible, at, orderBase, via);
         return;
       }
-      if (!wanted(name, path)) return;
-      const point = { x, y };
+      if (!wanted(name, path)) {
+        if (!threeD) {
+          const lp = d.toLocal(at);
+          forwardThrough(seq, d, path, lp, d.getLocalBounds());
+        }
+        return;
+      }
+      const point = at;
       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 };
@@ -1839,7 +1931,10 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
         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;
+          const isThree = typeof seq.pickAt === "function";
+          const ray = isThree ? rayOf(seq, d, local, lb) : void 0;
+          if (isThree) forwardThrough(seq, d, path, local, lb);
+          const three = ray ? { object: ray.object, point: ray.point, distance: ray.distance, object3d: ray.object3d } : isThree ? null : void 0;
           if (three) {
             const planeOf = seq.dragPlane;
             if (planeOf) {
@@ -1872,12 +1967,18 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
       }
       if (!hit) return;
       const maskTarget = seq.maskSequence?.target;
-      const maskSrc = chunk3HZV3UHU_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunkDKCMJILW_cjs.maskSourceOf(seq.spec.mask);
       if (maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert) && !inside(maskTarget.getBounds(), point)) return;
-      found.push({ hit, order: orderOf(d) });
+      found.push({ hit: via ? { ...hit, point: { x, y }, via } : hit, order: orderBase ? [...orderBase, ...orderOf(d)] : orderOf(d) });
     });
   };
   walk3(root, "", true);
+  for (const f of forwards) {
+    const path = hiddenSources.get(f.source);
+    if (path === void 0) continue;
+    const g = f.source.target.toGlobal({ x: f.uv.u * f.source.intrinsicWidth, y: (1 - f.uv.v) * f.source.intrinsicHeight });
+    walk3(f.source, path + "/", true, g, f.order, f.via);
+  }
   return found.sort((a, b) => above(a.order, b.order)).map((f) => f.hit);
 }
 var cache = /* @__PURE__ */ new WeakMap();
@@ -1910,7 +2011,7 @@ function walk(root, visit) {
     visit(seq);
     const mask = seq.maskSequence;
     if (mask) visit(mask);
-    if (seq instanceof chunk3HZV3UHU_cjs.CompositionSequence) walk(seq, visit);
+    if (seq instanceof chunkDKCMJILW_cjs.CompositionSequence) walk(seq, visit);
   }
 }
 function reusePoolOf(old) {
@@ -2011,7 +2112,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 = chunkX62H3RBG_cjs.spansMeta.get(seq.spec)?.preview;
+  const spans = chunkLALEBV63_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`;
@@ -2027,10 +2128,10 @@ function walk2(comp, parentStart, parentEnd, depth, prefix, rows, transitions, l
     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 + chunkX62H3RBG_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkLALEBV63_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 chunk3HZV3UHU_cjs.CompositionSequence;
+    const isComp = seq instanceof chunkDKCMJILW_cjs.CompositionSequence;
     if (isComp) {
       const label = seq.remapLabel();
       walk2(seq, label ? 0 : start, label ? seq.contentSpan : end, depth + 1, prefix + name + "/", inner, transitions, label ? `${name} ${label}` : local);
@@ -2189,7 +2290,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", ...chunkX62H3RBG_cjs.EXPRESSION_NAMES];
+var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkLALEBV63_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)) {
@@ -2733,8 +2834,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 = chunkX62H3RBG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkX62H3RBG_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkLALEBV63_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkLALEBV63_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2820,6 +2921,7 @@ var Movie = class {
       frameRate: this.frameRate,
       vars: numericVars(vars),
       ...gpuField,
+      ...this.app?.renderer ? { pixiRenderer: this.app.renderer } : {},
       ...reuse ? { reuse } : {},
       ...lp ? { onLayerBuilt: async () => {
         lp.tick();
@@ -2832,7 +2934,7 @@ var Movie = class {
       height: sizeWins ? height : spec.height ?? height,
       duration: spec.duration ?? this.duration
     } : void 0;
-    await chunkX62H3RBG_cjs.ensureFilterLibrary(seededComposition);
+    await chunkLALEBV63_cjs.ensureFilterLibrary(seededComposition);
     if (chunkJN7JHNZR_cjs.usesAdvancedBlend(seededComposition)) await chunkJN7JHNZR_cjs.enableAdvancedBlend(this.app.renderer);
     const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
     const rootSeqSpec = {
@@ -2843,7 +2945,7 @@ var Movie = class {
       ...userComposition
     };
     if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-    const sequence = new chunk3HZV3UHU_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+    const sequence = new chunkDKCMJILW_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
     lp?.begin("build", countLayers(rootSeqSpec));
     try {
       await sequence.build();
@@ -2981,8 +3083,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, reusePoolOf(this._rootSequence));
       alive();
-      const timeline = chunkX62H3RBG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkX62H3RBG_cjs.lengthen(timeline, this.duration);
+      const timeline = chunkLALEBV63_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkLALEBV63_cjs.lengthen(timeline, this.duration);
       sequence.bindTimeline(timeline);
       const hadSound = this.audioBuffer !== null;
       const audio = await this._mixSound(sequence, this._ensureAudioContext());
@@ -3389,7 +3491,7 @@ var Movie = class {
     chunkTWZNOUM7_cjs.warnUnknownOptions("movie.inspectAudio()", opts, ["window", "scenes"]);
     this._requireReady("inspectAudio");
     const scenes = opts.scenes ?? namedScenes(this.timelineData().rows);
-    return chunkO66JGPVV_cjs.analyzeAudio(this.audioBuffer, this._audioSources, this._mixStats, this.duration, { ...opts, scenes });
+    return chunk23SXKSUI_cjs.analyzeAudio(this.audioBuffer, this._audioSources, this._mixStats, this.duration, { ...opts, scenes });
   }
   /**
    * Draw the stage now. PixiJS's CullerPlugin only culls inside `app.render()` (the ticker), and we render
@@ -3751,7 +3853,7 @@ function countLayers(spec) {
     n += 1 + countLayers(s);
     const spans = s.spans;
     if (Array.isArray(spans)) n += spans.length;
-    const src = chunk3HZV3UHU_cjs.maskSourceOf(mask);
+    const src = chunkDKCMJILW_cjs.maskSourceOf(mask);
     if (src.kind === "inline") n += 1 + countLayers(src.spec);
   }
   return n;
@@ -3840,8 +3942,8 @@ function splitVertical(text, style, ts, right, top, align, by) {
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunkX62H3RBG_cjs.checkEase(name, "a preset");
-  return chunkX62H3RBG_cjs.parseEase(name);
+  chunkLALEBV63_cjs.checkEase(name, "a preset");
+  return chunkLALEBV63_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -3976,17 +4078,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 ?? chunkX62H3RBG_cjs.homeDistance(height, fov ?? chunkX62H3RBG_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkLALEBV63_cjs.homeDistance(height, fov ?? chunkLALEBV63_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)) * chunkX62H3RBG_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkLALEBV63_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 = chunkX62H3RBG_cjs.homeDistance(height, f);
+    const R = chunkLALEBV63_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -4041,7 +4143,7 @@ function particles(opts) {
   const round2 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkX62H3RBG_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkLALEBV63_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -4054,7 +4156,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 ? chunkX62H3RBG_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkLALEBV63_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -4063,7 +4165,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkX62H3RBG_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkLALEBV63_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -4125,7 +4227,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 chunkX62H3RBG_cjs.flattenSvgPath(d)) {
+  for (const line of chunkLALEBV63_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]);
@@ -4178,7 +4280,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 = chunkX62H3RBG_cjs.flattenSvgPath(d);
+  const lines = chunkLALEBV63_cjs.flattenSvgPath(d);
   const segments = [];
   let length = 0;
   for (const line of lines) {
@@ -4209,7 +4311,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 chunkX62H3RBG_cjs.trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
+      return chunkLALEBV63_cjs.trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
     }
   };
 }
@@ -4318,7 +4420,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkX62H3RBG_cjs.random(seed);
+    const r = chunkLALEBV63_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]];
@@ -4380,7 +4482,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkX62H3RBG_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkLALEBV63_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 });
@@ -4414,20 +4516,25 @@ function animateText(text, style, options) {
   const pieces = splitText(text, style, { by, x, y, align, ...vertical ? { vertical } : {} });
   if (pieces.length === 0) return [];
   const lineHeight = measureText("M", style).height;
-  const inTween = options.in === false ? null : resolveTween(options.in ?? "rise", "in");
-  const outTween = options.out === void 0 || options.out === false ? null : resolveTween(options.out, "out");
+  const given = (v) => v === false || v === "none" ? void 0 : v;
+  const inSpec = options.in === void 0 ? "rise" : given(options.in), outSpec = given(options.out);
+  const inTween = inSpec === void 0 ? null : resolveTween(inSpec, "in");
+  const outTween = outSpec === void 0 ? null : resolveTween(outSpec, "out");
   const delays = stagger(pieces.length, options.stagger ?? { each: 0.04 });
   const wave = Math.max(...delays);
-  const need = (inTween?.duration ?? 0) + (outTween?.duration ?? 0) + wave;
+  const outDelays = outTween?.stagger ? stagger(pieces.length, outTween.stagger) : delays;
+  const outWave = Math.max(...outDelays);
+  const lead = Math.max(...delays.map((d, i) => d - outDelays[i]));
+  const need = (inTween?.duration ?? 0) + (outTween ? outTween.duration + outWave + lead : wave);
   if (duration < need - 1e-9) {
     throw new Error(`animateText(): duration ${duration} is too short for this wave: the entrance${outTween ? ", the exit" : ""} and the stagger need at least ${+need.toFixed(3)} s`);
   }
   const end = at + duration;
   if (outTween?.at !== void 0) {
     if (outTween.at < at - 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} is before the layer starts (at ${at}): the exit starts with the piece; use out.at \u2265 ${at}`);
-    const latest = end - outTween.duration - wave;
-    if (outTween.at > latest + 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} leaves after the layer ends (the exit and the wave take ${+(outTween.duration + wave).toFixed(3)} s and the layer ends at ${+end.toFixed(3)} s): use out.at \u2264 ${+latest.toFixed(3)}, or a longer duration`);
-    if (inTween && outTween.at - at < inTween.duration - 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} is before the entrance has finished (it takes ${inTween.duration} s from at ${at}): use out.at \u2265 ${+(at + inTween.duration).toFixed(3)}`);
+    const latest = end - outTween.duration - outWave;
+    if (outTween.at > latest + 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} leaves after the layer ends (the exit and the wave take ${+(outTween.duration + outWave).toFixed(3)} s and the layer ends at ${+end.toFixed(3)} s): use out.at \u2264 ${+latest.toFixed(3)}, or a longer duration`);
+    if (inTween && outTween.at - at < inTween.duration + lead - 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} is before the entrance has finished (it takes ${inTween.duration} s from at ${at}): use out.at \u2265 ${+(at + inTween.duration + lead).toFixed(3)}`);
   }
   return pieces.map((p, i) => {
     const cx = p.cx ?? p.x + p.width / 2, cy = p.cy ?? p.y + lineHeight / 2;
@@ -4447,8 +4554,8 @@ function animateText(text, style, options) {
     }
     let idleEnd = len;
     if (outTween) {
-      const begin = outTween.at !== void 0 ? void 0 : outTween.duration + (wave - delays[i]);
-      const local = outTween.at !== void 0 ? Math.max(0, outTween.at - at) : -begin;
+      const begin = outTween.at !== void 0 ? void 0 : outTween.duration + (outWave - outDelays[i]);
+      const local = outTween.at !== void 0 ? Math.max(0, outTween.at + outDelays[i] - start) : -begin;
       idleEnd = outTween.at !== void 0 ? local : len - begin;
       keyframes.push({
         at: local,
@@ -4484,6 +4591,10 @@ function resolveTween(spec, which) {
   if (typeof spec === "object" && spec) {
     for (const key of Object.keys(spec)) {
       if (TWEEN_KEYS.includes(key)) continue;
+      if (key === "stagger") {
+        if (which === "in") console.warn("pixi-effects: animateText(): in.stagger is ignored: the entrance wave is the options' `stagger` (only `out` can have a wave of its own: out: { stagger: 0 } leaves all at once)");
+        continue;
+      }
       if (which === "out" && key === "at") {
         if (typeof spec.at !== "number" || !Number.isFinite(spec.at)) console.warn(`pixi-effects: animateText(): out.at must be a number of seconds (the composition second the exit starts at), got ${JSON.stringify(spec.at)}; ignored`);
         continue;
@@ -4495,7 +4606,7 @@ function resolveTween(spec, which) {
   }
   if (t.preset !== void 0 && !(t.preset in PRESETS)) {
     const guess = chunkTWZNOUM7_cjs.suggestName(String(t.preset), PRESET_NAMES);
-    throw new Error(`animateText(): ${which} "${t.preset}" is not a preset${guess ? `; did you mean "${guess}"?` : ""} (presets: ${PRESET_NAMES.map((n) => `"${n}"`).join(", ")})`);
+    throw new Error(`animateText(): ${which} "${t.preset}" is not a preset${guess ? `; did you mean "${guess}"?` : ""} (presets: ${PRESET_NAMES.map((n) => `"${n}"`).join(", ")}; for no ${which === "out" ? "exit: omit `out` or write out: false (the pieces stay until the layer ends)" : "entrance: in: false"})`);
   }
   const base = t.preset ? PRESETS[t.preset] : void 0;
   const from = { ...base?.from ?? {}, ...t.from ?? {} };
@@ -4504,11 +4615,14 @@ function resolveTween(spec, which) {
   for (const k of Object.keys(from)) {
     if (!known.has(k) && to[k] === void 0) throw new Error(`animateText(): ${which}.from has "${k}", which has no resting value; give ${which}.to: { ${k}: \u2026 }`);
   }
-  if (Object.keys(from).length === 0) throw new Error(`animateText(): ${which} needs a preset or a from`);
+  if (Object.keys(from).length === 0) {
+    throw new Error(`animateText(): ${which} needs a preset or a from${which === "out" && Object.keys(to).length ? ` \u2014 ${which} takes \`from\`: the state the piece leaves to (out: { from: { y: 18, alpha: 0 } }); \`to\` is only the resting value of a property that has none` : ""}`);
+  }
   let ease = t.ease ?? base?.ease ?? "power2.out";
   if (which === "out" && t.ease === void 0) ease = ease.replace(".out", ".in");
   const at = which === "out" && typeof t.at === "number" && Number.isFinite(t.at) ? t.at : void 0;
-  return { from, to: { ...to }, duration: t.duration ?? base?.duration ?? 0.5, ease, ...at !== void 0 ? { at } : {} };
+  const wave = which === "out" && t.stagger !== void 0 ? t.stagger === 0 ? { each: 0 } : t.stagger : void 0;
+  return { from, to: { ...to }, duration: t.duration ?? base?.duration ?? 0.5, ease, ...at !== void 0 ? { at } : {}, ...wave ? { stagger: wave } : {} };
 }
 
 // src/presets/react.ts
@@ -4673,7 +4787,7 @@ function computeEnvelope(audio, options = {}) {
       re[i] = k >= 0 && k < length ? mono[k] * win[i] : 0;
       im[i] = 0;
     }
-    chunkO66JGPVV_cjs.fft(re, im);
+    chunk23SXKSUI_cjs.fft(re, im);
     for (const n of names) {
       const [lo, hi] = bands[n];
       let p = 0;
@@ -4839,5 +4953,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-3IO5RWE4.cjs.map
-//# sourceMappingURL=chunk-3IO5RWE4.cjs.map
+//# sourceMappingURL=chunk-I6VUQ2CR.cjs.map
+//# sourceMappingURL=chunk-I6VUQ2CR.cjs.map