pixi-effects 0.46.0 → 0.47.0

package/dist/{chunk-7M63Y6MO.cjs → chunk-I6VUQ2CR.cjs}

@@ -2,7 +2,7 @@
 
 var chunkDKCMJILW_cjs = require('./chunk-DKCMJILW.cjs');
 var chunkLALEBV63_cjs = require('./chunk-LALEBV63.cjs');
-var chunkO66JGPVV_cjs = require('./chunk-O66JGPVV.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.`
     );
@@ -3423,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
@@ -4448,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;
@@ -4481,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,
@@ -4518,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;
@@ -4529,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 ?? {} };
@@ -4538,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
@@ -4707,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;
@@ -4873,5 +4953,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-7M63Y6MO.cjs.map
-//# sourceMappingURL=chunk-7M63Y6MO.cjs.map
+//# sourceMappingURL=chunk-I6VUQ2CR.cjs.map
+//# sourceMappingURL=chunk-I6VUQ2CR.cjs.map