pixi-effects 0.33.0 → 0.35.0

package/dist/{chunk-LD4VKNPQ.cjs → chunk-7TTCPHAV.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkSBBXKPBP_cjs = require('./chunk-SBBXKPBP.cjs');
-var chunkBVMZUPDU_cjs = require('./chunk-BVMZUPDU.cjs');
+var chunk5IJENZOG_cjs = require('./chunk-5IJENZOG.cjs');
+var chunkLEECUCTG_cjs = require('./chunk-LEECUCTG.cjs');
 var chunkIMQJVRMT_cjs = require('./chunk-IMQJVRMT.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 var pixi_js = require('pixi.js');
@@ -1490,8 +1490,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunkBVMZUPDU_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunkBVMZUPDU_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkLEECUCTG_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkLEECUCTG_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));
@@ -1559,16 +1559,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 = chunkBVMZUPDU_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkLEECUCTG_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkBVMZUPDU_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkLEECUCTG_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 = chunkBVMZUPDU_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkLEECUCTG_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})`);
@@ -1628,7 +1628,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunkSBBXKPBP_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunk5IJENZOG_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1907,8 +1907,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 = chunkBVMZUPDU_cjs.parseSpring(kf.ease);
-      length = sp ? Math.round(chunkBVMZUPDU_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
+      const sp = chunkLEECUCTG_cjs.parseSpring(kf.ease);
+      length = sp ? Math.round(chunkLEECUCTG_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
     }
     if (!(length > 0)) continue;
     const kat = kf.at ?? 0;
@@ -1974,7 +1974,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 = chunkSBBXKPBP_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunk5IJENZOG_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 });
@@ -1983,7 +1983,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 chunkSBBXKPBP_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero);
+      if (seq instanceof chunk5IJENZOG_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero);
     });
   };
   walk2(root, "", false, true);
@@ -2031,7 +2031,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 = chunkBVMZUPDU_cjs.spansMeta.get(seq.spec)?.preview;
+  const spans = chunkLEECUCTG_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`;
@@ -2047,10 +2047,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 + chunkBVMZUPDU_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkLEECUCTG_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 chunkSBBXKPBP_cjs.CompositionSequence;
+    const isComp = seq instanceof chunk5IJENZOG_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);
@@ -2209,7 +2209,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", ...chunkBVMZUPDU_cjs.EXPRESSION_NAMES];
+var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkLEECUCTG_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)) {
@@ -2645,6 +2645,10 @@ var Movie = class {
   _silent = 0;
   /** render() / peek() in flight: a rebuild does not swap the composition under them. */
   _busy = 0;
+  /** > 0 while the movie is moving its scene to another moment (a seek, a motion-blurred frame, the poster): a thumbnail does not start then. */
+  _moving = 0;
+  /** The thumbnail being drawn, if any: a seek waits for it (it has the scene on another moment for a few microtasks). */
+  _thumbRun = null;
   _idleWaiters = [];
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
   _audioSources = [];
@@ -2692,6 +2696,7 @@ var Movie = class {
     if (this._posterFrame === null || !this.timeline) return;
     const back = this.currentFrame;
     this.currentFrame = this._posterFrame;
+    this._moving++;
     try {
       this.timeline.time(this._timeOf(this._posterFrame));
       await this._awaitVideoFrames();
@@ -2699,6 +2704,7 @@ var Movie = class {
       this._renderNow();
     } finally {
       this.currentFrame = back;
+      this._moving--;
     }
     this._atPoster = true;
   }
@@ -2742,8 +2748,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 = chunkBVMZUPDU_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkBVMZUPDU_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkLEECUCTG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkLEECUCTG_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2837,7 +2843,7 @@ var Movie = class {
       height: sizeWins ? height : spec.height ?? height,
       duration: spec.duration ?? this.duration
     } : void 0;
-    await chunkBVMZUPDU_cjs.ensureFilterLibrary(seededComposition);
+    await chunkLEECUCTG_cjs.ensureFilterLibrary(seededComposition);
     if (chunkIMQJVRMT_cjs.usesAdvancedBlend(seededComposition)) await chunkIMQJVRMT_cjs.enableAdvancedBlend(this.app.renderer);
     const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
     const rootSeqSpec = {
@@ -2848,7 +2854,7 @@ var Movie = class {
       ...userComposition
     };
     if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-    const sequence = new chunkSBBXKPBP_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+    const sequence = new chunk5IJENZOG_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
     lp?.begin("build", countLayers(rootSeqSpec));
     try {
       await sequence.build();
@@ -2984,8 +2990,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);
       alive();
-      const timeline = chunkBVMZUPDU_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkBVMZUPDU_cjs.lengthen(timeline, this.duration);
+      const timeline = chunkLEECUCTG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkLEECUCTG_cjs.lengthen(timeline, this.duration);
       sequence.bindTimeline(timeline);
       const hadSound = this.audioBuffer !== null;
       const audio = await this._mixSound(sequence, this._ensureAudioContext());
@@ -3085,12 +3091,18 @@ var Movie = class {
     this.emit("error", { where, message: error instanceof Error ? error.message : String(error), error });
   }
   async _goto(frame) {
-    this._atPoster = false;
-    this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
-    this.timeline.time(this._timeOf(this.currentFrame));
-    await this._awaitVideoFrames();
-    this._updateSpace();
-    this._renderNow();
+    if (this._thumbRun) await this._thumbRun;
+    this._moving++;
+    try {
+      this._atPoster = false;
+      this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
+      this.timeline.time(this._timeOf(this.currentFrame));
+      await this._awaitVideoFrames();
+      this._updateSpace();
+      this._renderNow();
+    } finally {
+      this._moving--;
+    }
     this.emit("frame", { frame: this.currentFrame, totalFrames: this.totalFrames });
   }
   /**
@@ -3138,6 +3150,69 @@ var Movie = class {
     if (o.as === "imageData") return out.getContext("2d").getImageData(0, 0, out.width, out.height);
     return encodeCanvas(out, o.type, o.as, o.quality);
   }
+  /**
+   * Why `thumbnail()` is off for this movie: `'variables'` (it declares `vars`: the picture depends on them and changes when they do) or `'video'` (a video
+   * layer: its frame must be waited for, which would seek the playing video). `null`: it works.
+   */
+  get thumbnailsOff() {
+    if (this._declared.size > 0) return "variables";
+    if (!this._rootSequence) return null;
+    const found = [];
+    collectVideoSequences(this._rootSequence, found);
+    return found.some((v) => v.spec?.type === "video") ? "video" : null;
+  }
+  /**
+   * A small picture of any frame, drawn WITHOUT moving the playhead or changing what is on the canvas, so it can be made while the movie plays or is
+   * paused (a seek-bar preview). The scene is put on that moment, drawn, copied, and put back, all within the microtasks of one task: the browser never
+   * shows the in-between. Gives `null` when it cannot be made right now: the movie has thumbnails off (see `thumbnailsOff`), is moving somewhere else
+   * (a seek, a render, a peek), or is another thumbnail's turn. It is the picture `snapshot()` gives at that size (without motion blur).
+   */
+  async thumbnail(frame, opts = {}) {
+    chunkTWZNOUM7_cjs.warnUnknownOptions("movie.thumbnail()", opts, ["width", "scale"]);
+    this._requireReady("thumbnail");
+    if (opts.width !== void 0 && !(opts.width > 0 && opts.width <= this.width * 4)) throw new Error(`pixi-effects: movie.thumbnail(): width must be above 0 and at most ${this.width * 4} px, got ${opts.width}`);
+    if (opts.scale !== void 0 && !(opts.scale > 0 && opts.scale <= 4)) throw new Error(`pixi-effects: movie.thumbnail(): scale must be above 0 and at most 4, got ${opts.scale}`);
+    if (this.thumbnailsOff || this._moving > 0 || this._busy > 0 || this._thumbRun) return null;
+    const w = Math.max(1, Math.round(opts.width ?? (opts.scale !== void 0 ? this.width * opts.scale : 160)));
+    const h = Math.max(1, Math.round(w * this.height / this.width));
+    let done;
+    this._thumbRun = new Promise((r) => {
+      done = r;
+    });
+    try {
+      return await this._drawThumbnail(clampFrame(frame, this.totalFrames), w, h);
+    } finally {
+      this._thumbRun = null;
+      done();
+    }
+  }
+  async _drawThumbnail(frame, w, h) {
+    const stage = this.app.canvas;
+    const out = document.createElement("canvas");
+    out.width = w;
+    out.height = h;
+    const keep = this.timeline.time();
+    const t = this._timeOf(frame);
+    this._nominalTime = t;
+    try {
+      this.timeline.time(t);
+      await this._awaitVideoFrames(t);
+      this._updateSpace(t);
+      this._renderNow();
+      out.getContext("2d").drawImage(stage, 0, 0, w, h);
+    } finally {
+      this._nominalTime = keep;
+      try {
+        this.timeline.time(keep);
+        await this._awaitVideoFrames(keep);
+        this._updateSpace(keep);
+        this._renderNow();
+      } finally {
+        this._nominalTime = null;
+      }
+    }
+    return out;
+  }
   async onionSkin(opts = {}) {
     chunkTWZNOUM7_cjs.warnUnknownOptions("movie.onionSkin()", opts, ["from", "to", "count", "scale", "as", "motionBlur"]);
     this._requireReady("onionSkin");
@@ -3316,9 +3391,11 @@ var Movie = class {
   async _exposeFrame(frame, mb, target, settle) {
     const g = target.getContext("2d");
     const stage = this.app.canvas;
+    if (this._thumbRun) await this._thumbRun;
     this._atPoster = false;
     const times = blurTimes(frame, this.frameRate, mb, Math.max(0, this.duration - END_MARGIN));
     this._nominalTime = this._timeOf(Math.max(0, Math.min(frame, this.totalFrames)));
+    this._moving++;
     try {
       for (let k = 0; k < times.length; k++) {
         const t = times[k];
@@ -3332,6 +3409,7 @@ var Movie = class {
       }
     } finally {
       this._nominalTime = null;
+      this._moving--;
     }
     g.globalAlpha = 1;
     if (settle) await this._goto(frame);
@@ -3627,7 +3705,7 @@ function countLayers(spec) {
     n += 1 + countLayers(s);
     const spans = s.spans;
     if (Array.isArray(spans)) n += spans.length;
-    const src = chunkSBBXKPBP_cjs.maskSourceOf(mask);
+    const src = chunk5IJENZOG_cjs.maskSourceOf(mask);
     if (src.kind === "inline") n += 1 + countLayers(src.spec);
   }
   return n;
@@ -3685,8 +3763,8 @@ function splitText(text, style = {}, opts = {}) {
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunkBVMZUPDU_cjs.checkEase(name, "a preset");
-  return chunkBVMZUPDU_cjs.parseEase(name);
+  chunkLEECUCTG_cjs.checkEase(name, "a preset");
+  return chunkLEECUCTG_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -3821,17 +3899,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 ?? chunkBVMZUPDU_cjs.homeDistance(height, fov ?? chunkBVMZUPDU_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkLEECUCTG_cjs.homeDistance(height, fov ?? chunkLEECUCTG_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)) * chunkBVMZUPDU_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkLEECUCTG_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 = chunkBVMZUPDU_cjs.homeDistance(height, f);
+    const R = chunkLEECUCTG_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -3886,7 +3964,7 @@ function particles(opts) {
   const round2 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkBVMZUPDU_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkLEECUCTG_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -3899,7 +3977,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 ? chunkBVMZUPDU_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkLEECUCTG_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -3908,7 +3986,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkBVMZUPDU_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkLEECUCTG_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -3970,7 +4048,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 chunkBVMZUPDU_cjs.flattenSvgPath(d)) {
+  for (const line of chunkLEECUCTG_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]);
@@ -4124,7 +4202,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkBVMZUPDU_cjs.random(seed);
+    const r = chunkLEECUCTG_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]];
@@ -4186,7 +4264,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkBVMZUPDU_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkLEECUCTG_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 });
@@ -4644,5 +4722,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-LD4VKNPQ.cjs.map
-//# sourceMappingURL=chunk-LD4VKNPQ.cjs.map
+//# sourceMappingURL=chunk-7TTCPHAV.cjs.map
+//# sourceMappingURL=chunk-7TTCPHAV.cjs.map