pixi-effects 0.44.0 → 0.46.0

package/dist/{chunk-4MBTYREC.js → chunk-2E74SP63.js}

@@ -1,6 +1,6 @@
-import { CompositionSequence, maskSourceOf } from './chunk-ICI6ACHY.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-4QVQ5UJJ.js';
-import { analyzeAudio, fft, resampleThrough, playSpan } from './chunk-UHNSL2KJ.js';
+import { CompositionSequence, maskSourceOf } from './chunk-FPV3NPYC.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-DM2OLQOJ.js';
+import { analyzeAudio, fft, resampleThrough, measureLoudness, playSpan } from './chunk-K24FF4BT.js';
 import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-VNP7QCJE.js';
 import { describeLayer } from './chunk-32MMNDDN.js';
 import { warnUnknownOptions, suggestName } from './chunk-BXOCEZ4U.js';
@@ -140,6 +140,20 @@ async function mixdown(audios, totalDuration, sampleRate = 44100, pace) {
   return await ctx.startRendering();
 }
 var KNEE = 0.9;
+var LOUDNESS_CEILING_DB = -1;
+function normalizeMix(buffer, target) {
+  const chans = [];
+  for (let ch = 0; ch < buffer.numberOfChannels; ch++) chans.push(buffer.getChannelData(ch));
+  const m = measureLoudness(chans, buffer.sampleRate, { truePeak: false });
+  if (m.integratedLufs === null) return { target, gainDb: 0, reachedLufs: null, limited: false };
+  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 };
+}
 function limitMix(buffer, audios) {
   let peak = 0;
   let peakIndex = 0;
@@ -1618,7 +1632,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) {
@@ -1798,7 +1812,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;
@@ -1806,16 +1835,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;
+      if (!visible) {
+        if (seq instanceof 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 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 };
@@ -1823,7 +1861,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) {
@@ -1858,10 +1899,16 @@ function pickScene(root, x, y, opts = {}, deps = {}) {
       const maskTarget = seq.maskSequence?.target;
       const maskSrc = 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();
@@ -2617,6 +2664,7 @@ var Movie = class {
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
   _audioSources = [];
   _mixStats = null;
+  _loudness = null;
   on(event, fn) {
     (this._events[event] ??= []).push(fn);
     if (event === "ready" && this._initState === "ready") {
@@ -2691,7 +2739,11 @@ var Movie = class {
     return this._audioContext;
   }
   async init(options = {}) {
-    warnUnknownOptions("movie.init()", options, ["width", "height", "duration", "frameRate", "background", "canvas", "assets", "composition", "vars", "poster", "motionBlur", "loader", "loop"]);
+    warnUnknownOptions("movie.init()", options, ["width", "height", "duration", "frameRate", "background", "canvas", "assets", "composition", "vars", "poster", "motionBlur", "loader", "loop", "loudness"]);
+    if (options.loudness !== void 0 && options.loudness !== false && !(typeof options.loudness === "number" && Number.isFinite(options.loudness) && options.loudness <= 0 && options.loudness >= -70)) {
+      throw new Error(`pixi-effects: movie.init({ loudness }) is the loudness of the whole mix in LUFS: a number from -70 to 0 (-16 is usual for web video: loudness: -16), or false for no change; got ${JSON.stringify(options.loudness)}`);
+    }
+    this._loudness = options.loudness === void 0 || options.loudness === false ? null : options.loudness;
     this._initState = "pending";
     try {
       this.width = options.width ?? 1920;
@@ -2799,6 +2851,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();
@@ -2842,7 +2895,8 @@ var Movie = class {
       this._mixStats = null;
       this._mixCache.set(null, null);
     } else {
-      const key = mixKey(audios, this.duration, audioContext.sampleRate);
+      const baseKey = mixKey(audios, this.duration, audioContext.sampleRate);
+      const key = baseKey === null ? null : `${baseKey}|loudness:${this._loudness}`;
       const hit = this._mixCache.get(key);
       if (hit) {
         this.audioBuffer = hit.buffer;
@@ -2853,7 +2907,8 @@ var Movie = class {
           lp.part(done);
           await lp.yieldIfDue();
         } : void 0);
-        this._mixStats = this.audioBuffer ? limitMix(this.audioBuffer, audios) : null;
+        const loudness = this.audioBuffer && this._loudness !== null ? normalizeMix(this.audioBuffer, this._loudness) : void 0;
+        this._mixStats = this.audioBuffer ? { ...limitMix(this.audioBuffer, audios), ...loudness ? { loudness } : {} } : null;
         this._mixCache.set(key, this.audioBuffer, this._mixStats);
         status = "mixed";
       }
@@ -4793,5 +4848,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-4MBTYREC.js.map
-//# sourceMappingURL=chunk-4MBTYREC.js.map
+//# sourceMappingURL=chunk-2E74SP63.js.map
+//# sourceMappingURL=chunk-2E74SP63.js.map