pixi-effects 0.27.0 → 0.27.2

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkNDR2VQFV_cjs = require('./chunk-NDR2VQFV.cjs');
-var chunkRQMI7EJT_cjs = require('./chunk-RQMI7EJT.cjs');
+var chunkC7HJJ7MZ_cjs = require('./chunk-C7HJJ7MZ.cjs');
+var chunkYOV6MEXH_cjs = require('./chunk-YOV6MEXH.cjs');
 var chunkP4GY3Z4G_cjs = require('./chunk-P4GY3Z4G.cjs');
 var chunkZMAD3KJU_cjs = require('./chunk-ZMAD3KJU.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
@@ -145,16 +145,19 @@ function clockReach(a, total) {
 }
 
 // src/core/AudioMixer.ts
-async function mixdown(audios, totalDuration, sampleRate = 44100) {
+async function mixdown(audios, totalDuration, sampleRate = 44100, pace) {
   if (audios.length === 0) return null;
+  const weight = (a) => a.synth ? Math.max(1, a.end - a.start) : 0.2;
+  const all = audios.reduce((s, a) => s + weight(a), 0) + 0.5;
+  let made = 0;
   const ctx = new OfflineAudioContext(2, Math.ceil(sampleRate * totalDuration), sampleRate);
   const synthesised = /* @__PURE__ */ new Map();
-  const bufferOf = (a) => {
+  const bufferOf = async (a, inner) => {
     if (a.buffer) return a.buffer;
     if (!a.synth) return null;
     let buf = synthesised.get(a.synth.key);
     if (!buf) {
-      const [left, right] = a.synth.render(sampleRate);
+      const [left, right] = a.synth.renderAsync ? await a.synth.renderAsync(sampleRate, inner) : a.synth.render(sampleRate);
       buf = ctx.createBuffer(2, left.length, sampleRate);
       buf.getChannelData(0).set(left);
       buf.getChannelData(1).set(right);
@@ -163,7 +166,10 @@ async function mixdown(audios, totalDuration, sampleRate = 44100) {
     return buf;
   };
   for (const a of audios) {
-    const buffer = bufferOf(a);
+    const w = weight(a), base = made;
+    const buffer = await bufferOf(a, pace ? (f) => pace((base + w * f) / all) : void 0);
+    made += w;
+    if (pace) await pace(made / all);
     if (!buffer) continue;
     if (a.warp || a.sourceMap) {
       const r = resampleThrough(a, buffer.getChannelData(0), buffer.numberOfChannels > 1 ? buffer.getChannelData(1) : buffer.getChannelData(0), buffer.sampleRate, sampleRate, totalDuration);
@@ -1479,8 +1485,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunkRQMI7EJT_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunkRQMI7EJT_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkYOV6MEXH_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkYOV6MEXH_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));
@@ -1548,16 +1554,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 = chunkRQMI7EJT_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkYOV6MEXH_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkRQMI7EJT_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkYOV6MEXH_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 = chunkRQMI7EJT_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkYOV6MEXH_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})`);
@@ -1617,7 +1623,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunkNDR2VQFV_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunkC7HJJ7MZ_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1944,7 +1950,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 chunkNDR2VQFV_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, moving, zero);
+      if (seq instanceof chunkC7HJJ7MZ_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, moving, zero);
     });
   };
   walk2(root, "", false, true);
@@ -2005,10 +2011,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 + chunkRQMI7EJT_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkYOV6MEXH_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 chunkNDR2VQFV_cjs.CompositionSequence;
+    const isComp = seq instanceof chunkC7HJJ7MZ_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);
@@ -2407,6 +2413,7 @@ var LoadProgress = class {
   _onChange;
   _stage = null;
   _loaded = 0;
+  _part = 0;
   _total = 0;
   _high = 0;
   _started = 0;
@@ -2424,6 +2431,7 @@ var LoadProgress = class {
     this._closeTiming();
     this._stage = stage;
     this._loaded = 0;
+    this._part = 0;
     this._total = Math.max(0, total);
     this._started = this._now();
     this._emit();
@@ -2431,6 +2439,13 @@ var LoadProgress = class {
   tick(n = 1) {
     if (!this._stage) return;
     this._loaded = Math.min(this._total, this._loaded + n);
+    this._part = 0;
+    this._emit();
+  }
+  /** How much of the item being worked on is done (0..1), for an item that takes long: the number moves between two `tick`s. */
+  part(done) {
+    if (!this._stage) return;
+    this._part = Math.min(1, Math.max(0, done));
     this._emit();
   }
   /** Everything is done: 1, whatever stage it was in. */
@@ -2462,7 +2477,7 @@ var LoadProgress = class {
       if (s === stage) break;
       done += WEIGHT[s];
     }
-    const within = this._total > 0 ? this._loaded / this._total : 1;
+    const within = this._total > 0 ? Math.min(1, (this._loaded + this._part) / this._total) : 1;
     this._high = Math.min(1, Math.max(this._high, done + WEIGHT[stage] * within));
     this._onChange({ stage, loaded: this._loaded, total: this._total, progress: this._high });
   }
@@ -2656,8 +2671,8 @@ var Movie = class {
       this.stops = normalizeStops(options.composition?.stops, this.duration, this.frameRate);
       this._posterFrame = poster.frame;
       this.background = options.background ?? "#000000";
-      this.timeline = chunkRQMI7EJT_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkRQMI7EJT_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkYOV6MEXH_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkYOV6MEXH_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2716,7 +2731,7 @@ var Movie = class {
         height: options.composition.height ?? this.height,
         duration: options.composition.duration ?? this.duration
       } : void 0;
-      await chunkRQMI7EJT_cjs.ensureFilterLibrary(seededComposition);
+      await chunkYOV6MEXH_cjs.ensureFilterLibrary(seededComposition);
       const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
       const rootSeqSpec = {
         type: "composition",
@@ -2726,7 +2741,7 @@ var Movie = class {
         ...userComposition
       };
       if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-      const composition = new chunkNDR2VQFV_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+      const composition = new chunkC7HJJ7MZ_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
       lp.begin("build", countLayers(rootSeqSpec));
       await composition.build();
       this._rootSequence = composition;
@@ -2735,10 +2750,13 @@ var Movie = class {
       this._timeFilters = collectTimeFilters(composition);
       const audios = [];
       composition.collectAudio(audios, 0);
-      lp.begin("sound", audios.length);
+      lp.begin("sound", 1);
       if (audios.length > 0) {
-        this.audioBuffer = await mixdown(audios, this.duration, audioContext.sampleRate);
-        lp.tick(audios.length);
+        this.audioBuffer = await mixdown(audios, this.duration, audioContext.sampleRate, async (done) => {
+          lp.part(done);
+          await lp.yieldIfDue();
+        });
+        lp.tick();
         if (this.audioBuffer) this._mixStats = limitMix(this.audioBuffer, audios);
       }
       this._audioSources = audios;
@@ -3450,8 +3468,8 @@ function splitText(text, style = {}, opts = {}) {
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunkRQMI7EJT_cjs.checkEase(name, "a preset");
-  return chunkRQMI7EJT_cjs.parseEase(name);
+  chunkYOV6MEXH_cjs.checkEase(name, "a preset");
+  return chunkYOV6MEXH_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -3586,17 +3604,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 ?? chunkRQMI7EJT_cjs.homeDistance(height, fov ?? chunkRQMI7EJT_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkYOV6MEXH_cjs.homeDistance(height, fov ?? chunkYOV6MEXH_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)) * chunkRQMI7EJT_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkYOV6MEXH_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 = chunkRQMI7EJT_cjs.homeDistance(height, f);
+    const R = chunkYOV6MEXH_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -3651,7 +3669,7 @@ function particles(opts) {
   const round3 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkRQMI7EJT_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkYOV6MEXH_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -3664,7 +3682,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 ? chunkRQMI7EJT_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkYOV6MEXH_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -3673,7 +3691,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkRQMI7EJT_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkYOV6MEXH_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -3735,7 +3753,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 chunkRQMI7EJT_cjs.flattenSvgPath(d)) {
+  for (const line of chunkYOV6MEXH_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]);
@@ -3889,7 +3907,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkRQMI7EJT_cjs.random(seed);
+    const r = chunkYOV6MEXH_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]];
@@ -3951,7 +3969,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkRQMI7EJT_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkYOV6MEXH_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 });
@@ -4315,7 +4333,7 @@ async function audioEnvelope(source, options = {}) {
 
 // src/audio/musicEnvelope.ts
 async function musicEnvelope(music, options = {}) {
-  const { resolveMusic, renderMusic, musicLength, musicBeatTimes, TempoMap } = await import('./music-4O367SPR.cjs');
+  const { resolveMusic, renderMusic, musicLength, musicBeatTimes, TempoMap } = await import('./music-6MTHQEXS.cjs');
   const messages = [];
   const m = resolveMusic(music, "musicEnvelope()", (msg) => messages.push(msg));
   if (!m) throw new Error(`pixi-effects: musicEnvelope(): ${messages.join(" ") || "the music has nothing to play"}`);
@@ -4328,7 +4346,7 @@ async function musicEnvelope(music, options = {}) {
 
 // src/audio/musicBuffer.ts
 async function musicBuffer(music, options = {}) {
-  const { resolveMusic, renderMusic, musicLength } = await import('./music-4O367SPR.cjs');
+  const { resolveMusic, renderMusic, musicLength } = await import('./music-6MTHQEXS.cjs');
   const messages = [];
   const m = resolveMusic(music, "musicBuffer()", (msg) => messages.push(msg));
   if (!m) throw new Error(`pixi-effects: musicBuffer(): ${messages.join(" ") || "the music has nothing to play"}`);
@@ -4426,19 +4444,19 @@ function withFade(spec, opts) {
 
 Object.defineProperty(exports, "noise", {
   enumerable: true,
-  get: function () { return chunkRQMI7EJT_cjs.noise; }
+  get: function () { return chunkYOV6MEXH_cjs.noise; }
 });
 Object.defineProperty(exports, "rand", {
   enumerable: true,
-  get: function () { return chunkRQMI7EJT_cjs.rand; }
+  get: function () { return chunkYOV6MEXH_cjs.rand; }
 });
 Object.defineProperty(exports, "random", {
   enumerable: true,
-  get: function () { return chunkRQMI7EJT_cjs.random; }
+  get: function () { return chunkYOV6MEXH_cjs.random; }
 });
 Object.defineProperty(exports, "registerSequenceType", {
   enumerable: true,
-  get: function () { return chunkRQMI7EJT_cjs.registerSequenceType; }
+  get: function () { return chunkYOV6MEXH_cjs.registerSequenceType; }
 });
 exports.Movie = Movie;
 exports.animateText = animateText;