pixi-effects 0.47.1 → 0.47.3

package/dist/{chunk-OVTTCX2E.js → chunk-6LA7W362.js}

@@ -1,8 +1,8 @@
-import { CompositionSequence, maskSourceOf } from './chunk-QMVK55LC.js';
-import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, trimPolylines, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-6MHJKCXO.js';
-import { analyzeAudio, fft, resampleThrough, measureLoudness, playSpan } from './chunk-7IDEWQPH.js';
-import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-UTDELFOU.js';
-import { describeLayer } from './chunk-NVKHUAHU.js';
+import { CompositionSequence, maskSourceOf } from './chunk-HX73PCVU.js';
+import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, trimPolylines, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-HGKXEPDJ.js';
+import { analyzeAudio, fft, resampleThrough, playSpan, measureLoudness } from './chunk-G4PXCV2B.js';
+import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-PC7DFDCV.js';
+import { describeLayer } from './chunk-JVO2W77G.js';
 import { warnUnknownOptions, suggestName } from './chunk-BXOCEZ4U.js';
 import { extensions, CullerPlugin, Application, Container, Rectangle, Culler, CanvasTextMetrics, TextStyle, Assets, ExtensionType, Filter, Texture, UniformGroup, GpuProgram, GlProgram, defaultFilterVert, Text, CanvasTextGenerator, CanvasPool } from 'pixi.js';
 import { Output, BufferTarget, CanvasSource, AudioBufferSource, Input, ALL_FORMATS, BlobSource, WavOutputFormat, Conversion, VideoSampleSink, OggOutputFormat, QUALITY_VERY_HIGH, QUALITY_HIGH, QUALITY_MEDIUM, QUALITY_LOW, QUALITY_VERY_LOW, MkvOutputFormat, WebMOutputFormat, MovOutputFormat, Mp4OutputFormat, canEncodeVideo, getFirstEncodableAudioCodec } from 'mediabunny';
@@ -144,81 +144,124 @@ 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++) {
+  const L = Math.max(1, Math.round(3e-3 * sampleRate));
+  const release = 1 - Math.exp(-1 / (0.08 * sampleRate));
+  const reqAt = (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);
+    return p > ceil ? ceil / p : 1;
+  };
+  const size = L + 2, dqIdx = new Int32Array(size), dqVal = new Float32Array(size);
+  let head = 0, count = 0, added = -1;
+  const ring = new Float32Array(L + 1);
+  let run = 0;
+  let prev = 1, lowest = 1, lowestAt = 0;
   for (let i = 0; i < n; i++) {
-    run += mn[i];
-    if (i > L) run -= mn[i - L - 1];
+    for (; added < Math.min(n - 1, i + L); ) {
+      added++;
+      const v = reqAt(added);
+      while (count > 0 && dqVal[(head + count - 1) % size] >= v) count--;
+      const at = (head + count) % size;
+      dqIdx[at] = added;
+      dqVal[at] = v;
+      count++;
+    }
+    while (dqIdx[head] < i) {
+      head = (head + 1) % size;
+      count--;
+    }
+    const mn = dqVal[head];
+    const slot = i % (L + 1);
+    if (i > L) run -= ring[slot];
+    ring[slot] = mn;
+    run += mn;
     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;
+    for (let ch = 0; ch < source.length; ch++) {
+      const v = source[ch][i] * gain * g;
+      out[ch][i] = v > ceil ? ceil : v < -ceil ? -ceil : v;
     }
   }
   return { reductionDb: lowest < 1 ? -20 * Math.log10(lowest) : 0, at: lowestAt / sampleRate };
 }
-function normalizeMix(buffer, target) {
+function cleanMix(buffer, audios) {
+  let count = 0, first = -1;
+  for (let ch = 0; ch < buffer.numberOfChannels; ch++) {
+    const d = buffer.getChannelData(ch);
+    for (let i = 0; i < d.length; i++) if (!Number.isFinite(d[i])) {
+      d[i] = 0;
+      count++;
+      if (first < 0 || i < first) first = i;
+    }
+  }
+  const firstAt = first < 0 ? 0 : first / buffer.sampleRate;
+  if (count > 0 && audios) {
+    const playing = audios.map((a) => ({ a, ...playSpan(a, buffer.duration) })).filter((s) => s.start <= firstAt && firstAt < s.end).map((s) => s.a.layer ?? "an audio layer");
+    console.warn(`pixi-effects: ${count} sample(s) of the audio mix were not numbers (NaN or Infinity), first at ${firstAt.toFixed(2)}s, and were made silent. Playing there: ${[...new Set(playing)].join(", ") || "nothing that is listed"}. A sound that produces these (a custom synth, a division by zero in a volume) is broken.`);
+  }
+  return { count, firstAt };
+}
+async function normalizeMix(buffer, target, between) {
   const chans = [];
   for (let ch = 0; ch < buffer.numberOfChannels; ch++) chans.push(buffer.getChannelData(ch));
   const sr = buffer.sampleRate;
+  const pause = async () => {
+    if (between) await between();
+  };
   const m = 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));
+  await pause();
   let gainDb = target - m.integratedLufs;
   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;
+  let applied = { reductionDb: 0, at: 0 };
+  let final = m, original = null, cap = Infinity;
+  if (gainDb + m.samplePeakDb <= ceilDb) {
+    const gain = 10 ** (gainDb / 20);
+    for (const d of chans) for (let i = 0; i < d.length; i++) d[i] = d[i] * gain;
+    await pause();
+    final = measureLoudness(chans, sr);
+  } else {
+    original = chans.map((c) => Float32Array.from(c));
+    cap = MAX_LIMIT_DB + ceilDb - m.samplePeakDb;
     if (gainDb > cap) gainDb = cap;
-    applied = limitInto(original, chans, 10 ** (gainDb / 20), 10 ** (ceilDb / 20), sr);
-    measured = measureLoudness(chans, sr);
-    const overTp = measured.truePeakDb - LOUDNESS_CEILING_DB;
-    if (overTp > 0.02) {
-      ceilDb -= overTp + 0.02;
-      continue;
+    for (let round2 = 0; round2 < 3; round2++) {
+      cap = MAX_LIMIT_DB + ceilDb - m.samplePeakDb;
+      if (gainDb > cap) gainDb = cap;
+      applied = limitInto(original, chans, 10 ** (gainDb / 20), 10 ** (ceilDb / 20), sr);
+      await pause();
+      final = measureLoudness(chans, sr);
+      await pause();
+      const overTp = final.truePeakDb - LOUDNESS_CEILING_DB;
+      const deficit = target - final.integratedLufs;
+      if (round2 === 2 || overTp <= 0.02 && Math.abs(deficit) <= 0.15) break;
+      if (overTp > 0.02) ceilDb -= overTp + 0.02;
+      const next = Math.min(gainDb + deficit, MAX_LIMIT_DB + ceilDb - m.samplePeakDb);
+      if (overTp <= 0.02 && Math.abs(next - gainDb) < 0.05) break;
+      gainDb = next;
     }
-    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;
+  let trimDb = 0;
+  if (final.truePeakDb > LOUDNESS_CEILING_DB) {
+    trimDb = final.truePeakDb - LOUDNESS_CEILING_DB + 0.01;
+    const k = 10 ** (-trimDb / 20);
+    for (const d of chans) for (let i = 0; i < d.length; i++) d[i] = d[i] * k;
+    final = { ...final, integratedLufs: final.integratedLufs === null ? null : final.integratedLufs - trimDb };
+  }
+  const reached = final.integratedLufs === null ? null : Math.round(final.integratedLufs * 10) / 10;
   const reduction = Math.round(applied.reductionDb * 10) / 10;
   return {
     target,
-    gainDb: Math.round(gainDb * 10) / 10,
-    reachedLufs: measured.integratedLufs,
-    limited,
+    gainDb: Math.round((gainDb - trimDb) * 10) / 10,
+    reachedLufs: reached,
+    limited: reached !== null && reached < target - 0.15,
     ...reduction >= 0.1 ? { limiterDb: reduction, limiterAt: Math.round(applied.at * 100) / 100 } : {}
   };
 }
@@ -1880,6 +1923,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 boxOf = (d, masked) => {
+    const v = d.bounds;
+    if (masked && v && Number.isFinite(v.minX) && Number.isFinite(v.maxX)) return { x: v.minX, y: v.minY, width: v.maxX - v.minX, height: v.maxY - v.minY };
+    return d.getLocalBounds();
+  };
+  const inMask = (maskTarget, p) => {
+    const c = maskTarget;
+    if (typeof c.containsPoint === "function") return c.containsPoint(c.toLocal(p));
+    const was = c.measurable;
+    c.measurable = true;
+    try {
+      return inside(c.getBounds(), p);
+    } finally {
+      c.measurable = was;
+    }
+  };
   const hiddenSources = /* @__PURE__ */ new Map();
   const forwards = [];
   const rays = /* @__PURE__ */ new Map();
@@ -1893,7 +1952,7 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
     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) });
+    if (r?.uv && shown) forwards.push({ source: shown.source, at: shown.at(r.uv.u, r.uv.v), 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) => {
@@ -1911,6 +1970,8 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
       }
       const isComposition = seq instanceof CompositionSequence;
       if (isComposition && !threeD) {
+        const gm = seq.maskSequence?.target, gs = maskSourceOf(seq.spec.mask);
+        if (gm && gs.kind === "inline" && !gs.invert && !inMask(gm, at)) return;
         walk3(seq, path + "/", visible, at, orderBase, via);
         return;
       }
@@ -1927,7 +1988,7 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
         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();
+        const lb = boxOf(d, !!seq.maskSequence);
         if (inside(lb, local)) {
           const isThree = typeof seq.pickAt === "function";
           const ray = isThree ? rayOf(seq, d, local, lb) : void 0;
@@ -1966,7 +2027,7 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
       if (!hit) return;
       const maskTarget = seq.maskSequence?.target;
       const maskSrc = maskSourceOf(seq.spec.mask);
-      if (maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert) && !inside(maskTarget.getBounds(), point)) return;
+      if (maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert) && !(maskSrc.kind === "inline" ? inMask(maskTarget, point) : inside(maskTarget.getBounds(), point))) return;
       found.push({ hit: via ? { ...hit, point: { x, y }, via } : hit, order: orderBase ? [...orderBase, ...orderOf(d)] : orderOf(d) });
     });
   };
@@ -1974,7 +2035,9 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
   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 });
+    const g = f.source.target.toGlobal({ x: f.at.x * f.source.intrinsicWidth, y: f.at.y * f.source.intrinsicHeight });
+    const sm = f.source.maskSequence?.target, ss = maskSourceOf(f.source.spec.mask);
+    if (sm && ss.kind === "inline" && !ss.invert && !inMask(sm, g)) continue;
     walk3(f.source, path + "/", true, g, f.order, f.via);
   }
   return found.sort((a, b) => above(a.order, b.order)).map((f) => f.hit);
@@ -2975,7 +3038,8 @@ var Movie = class {
           lp.part(done);
           await lp.yieldIfDue();
         } : void 0);
-        const loudness = this.audioBuffer && this._loudness !== null ? normalizeMix(this.audioBuffer, this._loudness) : void 0;
+        if (this.audioBuffer) cleanMix(this.audioBuffer, audios);
+        const loudness = this.audioBuffer && this._loudness !== null ? await normalizeMix(this.audioBuffer, this._loudness, lp ? () => lp.yieldIfDue() : void 0) : void 0;
         this._mixStats = this.audioBuffer ? { ...limitMix(this.audioBuffer, audios), ...loudness ? { loudness } : {} } : null;
         this._mixCache.set(key, this.audioBuffer, this._mixStats);
         status = "mixed";
@@ -3218,12 +3282,18 @@ var Movie = class {
     const collected = [];
     const clocks = /* @__PURE__ */ new Map();
     collectVideoSequences(this._rootSequence, collected, clocks);
-    await Promise.all(collected.map((v) => {
+    const wait = (v) => {
       if (v.selfTimed) return v.awaitFrameAt(t);
       const local = (clocks.get(v)?.() ?? t) - (v.absoluteStart ?? v.at);
       if (local < 0 || local > (v.duration ?? 0)) return Promise.resolve();
       return v.awaitFrameAt(local);
-    }));
+    };
+    const late = collected.filter((v) => v.showsLayers === true);
+    await Promise.all(collected.filter((v) => !late.includes(v)).map(wait));
+    if (late.length > 0) {
+      this._updateSpace(t);
+      await Promise.all(late.map(wait));
+    }
   }
   async snapshot(frame = this.currentFrame, opts = {}) {
     warnUnknownOptions("movie.snapshot()", opts, ["scale", "type", "quality", "as", "motionBlur"]);
@@ -3861,7 +3931,7 @@ var ALIGN = ["left", "center", "right"];
 var widthOf = (text, style) => CanvasTextMetrics.measureText(text, style).width;
 function measureText(text, style = {}) {
   const m = CanvasTextMetrics.measureText(text, new TextStyle(style));
-  return { width: m.width, height: m.height, lines: text.split("\n").length };
+  return { width: m.width, height: m.height, lines: m.lines?.length ?? text.split("\n").length };
 }
 function splitText(text, style = {}, opts = {}) {
   warnUnknownOptions("splitText()", opts, ["by", "x", "y", "align", "vertical"]);
@@ -4389,7 +4459,9 @@ function catmullRom(p0, p1, p2, p3, t) {
 // src/presets/stagger.ts
 var STAGGER_KEYS = ["each", "amount", "from", "grid", "ease", "seed"];
 var FROM_NAMES = ["start", "end", "center", "edges", "random"];
-function stagger(items, options = {}) {
+function stagger(items, spec = {}) {
+  if (typeof spec !== "number" && (typeof spec !== "object" || spec === null)) throw new Error(`stagger(): the second argument is { each, from, \u2026 } or a number of seconds between neighbours, got ${JSON.stringify(spec)}`);
+  const options = typeof spec === "number" ? { each: spec } : spec;
   const isCount = typeof items === "number";
   const n = isCount ? items : items.length;
   if (!Number.isInteger(n) || n < 0) throw new Error(`stagger(): count must be a whole number of items, got ${n}`);
@@ -4553,7 +4625,7 @@ function animateText(text, style, options) {
     let idleEnd = len;
     if (outTween) {
       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;
+      const local = outTween.at !== void 0 ? Math.max(0, outTween.at - at + (outDelays[i] - delays[i])) : -begin;
       idleEnd = outTween.at !== void 0 ? local : len - begin;
       keyframes.push({
         at: local,
@@ -4568,7 +4640,7 @@ function animateText(text, style, options) {
       for (const k of ["x", "y", "rotation", "scale"]) if (idle[k] !== void 0) props[k] = { around: rest[k], amp: idle[k] };
       const freq = idle.freq ?? 1;
       const from = inTween?.duration ?? 0;
-      if (Object.keys(props).length > 0 && idleEnd - from >= 1 / freq) {
+      if (Object.keys(props).length > 0 && idleEnd - from >= 1 / freq - 1e-9) {
         keyframes.push(...wiggle({ at: from, duration: idleEnd - from, freq, seed: (idle.seed ?? 0) * 1e3 + i, props }));
       }
     }
@@ -4619,7 +4691,7 @@ function resolveTween(spec, which) {
   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;
-  const wave = which === "out" && t.stagger !== void 0 ? t.stagger === 0 ? { each: 0 } : t.stagger : void 0;
+  const wave = which === "out" && t.stagger !== void 0 ? typeof t.stagger === "number" ? { each: t.stagger } : t.stagger : void 0;
   return { from, to: { ...to }, duration: t.duration ?? base?.duration ?? 0.5, ease, ...at !== void 0 ? { at } : {}, ...wave ? { stagger: wave } : {} };
 }
 
@@ -4928,5 +5000,5 @@ function withFade(spec, opts) {
 }
 
 export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, parseEase2 as parseEase, particles, react, resolveLoader, samplePath, splitText, stagger, wiggle, withFade };
-//# sourceMappingURL=chunk-OVTTCX2E.js.map
-//# sourceMappingURL=chunk-OVTTCX2E.js.map
+//# sourceMappingURL=chunk-6LA7W362.js.map
+//# sourceMappingURL=chunk-6LA7W362.js.map