pixi-effects 0.18.0 → 0.19.0

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkJW67MDHQ_cjs = require('./chunk-JW67MDHQ.cjs');
-var chunkANO5R2E6_cjs = require('./chunk-ANO5R2E6.cjs');
+var chunkCTZRFSVU_cjs = require('./chunk-CTZRFSVU.cjs');
+var chunkVTBT6NNE_cjs = require('./chunk-VTBT6NNE.cjs');
 var chunkUQBGW5DO_cjs = require('./chunk-UQBGW5DO.cjs');
 var PIXI = require('pixi.js');
 var gsap = require('gsap');
@@ -489,6 +489,14 @@ function namedScenes(rows) {
   return rows.filter((r) => r.depth === 0 && r.type === "composition" && !/[#×]/.test(r.name) && r.end - r.start >= 1).map((r) => ({ name: r.name, start: r.start, end: r.end }));
 }
 
+// src/core/timeFilters.ts
+function collectTimeFilters(seq, out = []) {
+  for (const f of seq.filters ?? []) if (typeof f.setTime === "function") out.push(f);
+  if (seq.maskSequence) collectTimeFilters(seq.maskSequence, out);
+  for (const child of seq._children ?? []) collectTimeFilters(child, out);
+  return out;
+}
+
 // src/core/review.ts
 function sampleFrames({ totalFrames, frameRate, scenes = [], step = 0.25, cap = 240 }) {
   const last = totalFrames;
@@ -1225,16 +1233,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 = chunkANO5R2E6_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkVTBT6NNE_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkANO5R2E6_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkVTBT6NNE_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 = chunkANO5R2E6_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkVTBT6NNE_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})`);
@@ -1574,9 +1582,9 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
         onCanvas = inter === 0 && area > 0 ? "none" : inter >= area - 1e-6 ? "full" : "partial";
         if (area === 0) onCanvas = "none";
       }
-      const keys = chunkANO5R2E6_cjs.collectPropKeys(seq.spec);
+      const keys = chunkVTBT6NNE_cjs.collectPropKeys(seq.spec);
       const carried = carriers.some((c) => {
-        const k = chunkANO5R2E6_cjs.collectPropKeys(c.spec);
+        const k = chunkVTBT6NNE_cjs.collectPropKeys(c.spec);
         return (c.spec.keyframes ?? []).length > 0 && (k.has("x") || k.has("y") || k.has("rotation") || k.has("scale"));
       });
       const moving = parentMoving || carried || (seq.spec.keyframes ?? []).length > 0 && (keys.has("x") || keys.has("y"));
@@ -1597,7 +1605,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 chunkJW67MDHQ_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, moving, zero);
+      if (seq instanceof chunkCTZRFSVU_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, moving, zero);
     });
   };
   walk2(root, "", false, true);
@@ -1658,10 +1666,10 @@ function walk(comp, parentStart, parentEnd, depth, prefix, rows, transitions) {
     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 + chunkANO5R2E6_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkVTBT6NNE_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) };
     const inner = [];
-    const isComp = seq instanceof chunkJW67MDHQ_cjs.CompositionSequence;
+    const isComp = seq instanceof chunkCTZRFSVU_cjs.CompositionSequence;
     if (isComp) walk(seq, start, end, depth + 1, prefix + name + "/", inner, transitions);
     entries.push({ row, inner, groupable: !isComp });
   });
@@ -2094,6 +2102,15 @@ var Movie = class {
   background = "#000000";
   _audioContext = null;
   _rootSequence = null;
+  /** The filters that take the time of the frame they draw (`grain`), collected once after the build. */
+  _timeFilters = [];
+  /** While a motion-blurred frame is exposed: the frame's own time, so all its sub-frames share one grain frame (and not the playhead's). */
+  _nominalTime = null;
+  _feedTimeFilters() {
+    if (!this._timeFilters.length) return;
+    const t = this._nominalTime ?? this._timeOf(this.currentFrame);
+    for (const f of this._timeFilters) f.setTime(t);
+  }
   _rootContainer = null;
   _raf = null;
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
@@ -2210,7 +2227,7 @@ var Movie = class {
         height: options.composition.height ?? this.height,
         duration: options.composition.duration ?? this.duration
       } : void 0;
-      await chunkANO5R2E6_cjs.ensureFilterLibrary(seededComposition);
+      await chunkVTBT6NNE_cjs.ensureFilterLibrary(seededComposition);
       const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
       const rootSeqSpec = {
         type: "composition",
@@ -2220,11 +2237,12 @@ var Movie = class {
         ...userComposition
       };
       if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-      const composition = new chunkJW67MDHQ_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+      const composition = new chunkCTZRFSVU_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
       await composition.build();
       this._rootSequence = composition;
       if (composition.target) root.addChild(composition.target);
       composition.bindTimeline(this.timeline);
+      this._timeFilters = collectTimeFilters(composition);
       const audios = [];
       composition.collectAudio(audios, 0);
       if (audios.length > 0) {
@@ -2562,6 +2580,7 @@ var Movie = class {
     if (!app?.renderer) return;
     if (!this._synced) this._rootSequence?.syncFrame();
     this._synced = false;
+    this._feedTimeFilters();
     PIXI.Culler.shared.cull(app.stage, app.renderer.screen, false);
     app.renderer.render({ container: app.stage });
   }
@@ -2578,6 +2597,7 @@ var Movie = class {
    * the frame before (after a jump seek, a card whose children were animated showed a stale picture).
    */
   _updateSpace(t = this._timeOf(this.currentFrame)) {
+    this._feedTimeFilters();
     if (!this._rootSequence || !this.app) return;
     this._rootSequence.syncFrame();
     this._synced = true;
@@ -2596,15 +2616,20 @@ var Movie = class {
     const stage = this.app.canvas;
     this._atPoster = false;
     const times = blurTimes(frame, this.frameRate, mb, Math.max(0, this.duration - END_MARGIN));
-    for (let k = 0; k < times.length; k++) {
-      const t = times[k];
-      this.timeline.time(t);
-      await this._awaitVideoFrames(t);
-      this._updateSpace(t);
-      this._renderNow();
-      if (k === 0) g.clearRect(0, 0, target.width, target.height);
-      g.globalAlpha = 1 / (k + 1);
-      g.drawImage(stage, 0, 0, target.width, target.height);
+    this._nominalTime = this._timeOf(Math.max(0, Math.min(frame, this.totalFrames)));
+    try {
+      for (let k = 0; k < times.length; k++) {
+        const t = times[k];
+        this.timeline.time(t);
+        await this._awaitVideoFrames(t);
+        this._updateSpace(t);
+        this._renderNow();
+        if (k === 0) g.clearRect(0, 0, target.width, target.height);
+        g.globalAlpha = 1 / (k + 1);
+        g.drawImage(stage, 0, 0, target.width, target.height);
+      }
+    } finally {
+      this._nominalTime = null;
     }
     g.globalAlpha = 1;
     if (settle) await this._goto(frame);
@@ -2826,6 +2851,7 @@ var Movie = class {
   }
   async destroy() {
     safeRun(() => this.pause());
+    this._timeFilters = [];
     safeRun(() => this._rootSequence?.destroy());
     this._rootSequence = null;
     safeRun(() => this.timeline?.kill());
@@ -3027,7 +3053,7 @@ function clamp(v, lo, hi) {
   return Math.max(lo, Math.min(hi, v));
 }
 function parseEase(name) {
-  chunkANO5R2E6_cjs.checkEase(name, "a preset");
+  chunkVTBT6NNE_cjs.checkEase(name, "a preset");
   return gsap.gsap.parseEase(name);
 }
 
@@ -3050,17 +3076,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 ?? chunkANO5R2E6_cjs.homeDistance(height, fov ?? chunkANO5R2E6_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkVTBT6NNE_cjs.homeDistance(height, fov ?? chunkVTBT6NNE_cjs.DEFAULT_FOV);
   const start = opts.start ?? -degrees / 2;
   const steps = Math.max(1, Math.round(duration * stepsPerSecond));
   const easeFn = parseEase(ease);
   const dollyEase = dolly ? parseEase(dolly.ease ?? ease) : null;
   const pos = (i) => {
     const p = i / steps;
-    const a = (start + degrees * easeFn(p)) * chunkANO5R2E6_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkVTBT6NNE_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 = chunkANO5R2E6_cjs.homeDistance(height, f);
+    const R = chunkVTBT6NNE_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -3115,7 +3141,7 @@ function particles(opts) {
   const round3 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkANO5R2E6_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkVTBT6NNE_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -3128,7 +3154,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 ? chunkANO5R2E6_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkVTBT6NNE_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -3137,7 +3163,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkANO5R2E6_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkVTBT6NNE_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -3199,7 +3225,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 chunkANO5R2E6_cjs.flattenSvgPath(d)) {
+  for (const line of chunkVTBT6NNE_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]);
@@ -3344,7 +3370,8 @@ function stagger(items, options = {}) {
   const max = dist2.reduce((m, d) => Math.max(m, d), 0);
   const total = amount !== void 0 ? amount : (each ?? 0.1) * max;
   const shape = parseEase(ease);
-  const delays = dist2.map((d) => max === 0 ? 0 : Math.round(total * shape(d / max) * 1e6) / 1e6);
+  const clamp01 = (v) => Math.min(1, Math.max(0, v));
+  const delays = dist2.map((d) => max === 0 ? 0 : Math.round(total * clamp01(shape(d / max)) * 1e6) / 1e6);
   if (isCount) return delays;
   return items.map((layer, i) => ({ ...layer, at: Math.round(((layer.at ?? 0) + delays[i]) * 1e6) / 1e6 }));
 }
@@ -3352,7 +3379,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkANO5R2E6_cjs.random(seed);
+    const r = chunkVTBT6NNE_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]];
@@ -3414,7 +3441,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkANO5R2E6_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkVTBT6NNE_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 });
@@ -3423,6 +3450,8 @@ function wiggle(opts) {
 }
 
 // src/presets/animateText.ts
+var TWEEN_KEYS = ["preset", "from", "to", "duration", "ease"];
+var TIME_KEYS = ["at", "delay", "start", "begin", "time"];
 var KEYS5 = ["by", "x", "y", "align", "name", "at", "duration", "in", "out", "stagger", "idle", "styleFor"];
 var PRESETS = {
   rise: { from: { y: 40, alpha: 0 }, duration: 0.5, ease: "back.out(2)" },
@@ -3506,6 +3535,14 @@ function animateText(text, style, options) {
 }
 function resolveTween(spec, which) {
   const t = typeof spec === "string" ? { preset: spec } : spec;
+  if (typeof spec === "object" && spec) {
+    for (const key of Object.keys(spec)) {
+      if (TWEEN_KEYS.includes(key)) continue;
+      if (TIME_KEYS.includes(key)) {
+        console.warn(`pixi-effects: animateText(): ${which}.${key} ("${key}") is ignored: ${which === "out" ? "an out leaves from the END of the layer (at + duration), so to make the text gone at a time T set duration to T \u2212 at" : "the entrance starts when the piece starts (the options' at, plus the stagger)"}`);
+      } else chunkUQBGW5DO_cjs.warnUnknownOptions(`animateText() ${which}`, { [key]: 1 }, TWEEN_KEYS);
+    }
+  }
   if (t.preset !== void 0 && !(t.preset in PRESETS)) {
     const guess = chunkUQBGW5DO_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(", ")})`);
@@ -3879,19 +3916,19 @@ function withFade(spec, opts) {
 
 Object.defineProperty(exports, "noise", {
   enumerable: true,
-  get: function () { return chunkANO5R2E6_cjs.noise; }
+  get: function () { return chunkVTBT6NNE_cjs.noise; }
 });
 Object.defineProperty(exports, "rand", {
   enumerable: true,
-  get: function () { return chunkANO5R2E6_cjs.rand; }
+  get: function () { return chunkVTBT6NNE_cjs.rand; }
 });
 Object.defineProperty(exports, "random", {
   enumerable: true,
-  get: function () { return chunkANO5R2E6_cjs.random; }
+  get: function () { return chunkVTBT6NNE_cjs.random; }
 });
 Object.defineProperty(exports, "registerSequenceType", {
   enumerable: true,
-  get: function () { return chunkANO5R2E6_cjs.registerSequenceType; }
+  get: function () { return chunkVTBT6NNE_cjs.registerSequenceType; }
 });
 exports.Movie = Movie;
 exports.animateText = animateText;