pixi-effects 0.36.0 → 0.37.0

package/dist/{chunk-CC7SUR7Q.cjs → chunk-E26M4NTL.cjs}

@@ -1,8 +1,9 @@
 'use strict';
 
-var chunkY5UWFH6Y_cjs = require('./chunk-Y5UWFH6Y.cjs');
-var chunkKJSEQVBV_cjs = require('./chunk-KJSEQVBV.cjs');
-var chunkNEUPEENI_cjs = require('./chunk-NEUPEENI.cjs');
+var chunkMJMOPWMK_cjs = require('./chunk-MJMOPWMK.cjs');
+var chunkQHIOOK5S_cjs = require('./chunk-QHIOOK5S.cjs');
+var chunkJN7JHNZR_cjs = require('./chunk-JN7JHNZR.cjs');
+var chunk3SAS3ZE5_cjs = require('./chunk-3SAS3ZE5.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 var pixi_js = require('pixi.js');
 var mediabunny = require('mediabunny');
@@ -519,8 +520,8 @@ function analyzeAudio(mix, sources, stats, movieDuration, opts = {}) {
   });
   if (buried.length > 0) {
     const worst = buried.reduce((a, b) => b.belowMixDb > a.belowMixDb ? b : a);
-    const names = new Set(buried.map((x) => x.layer + x.source));
-    scoreNotes.push(`${names.size === 1 ? "1 sound effect is" : `${names.size} sound effects are`} buried (${BURIED_DB} dB or more under the loudest sample of the mix around its loudest moment${buried.length > names.size ? `, ${buried.length} times in all` : ""}): the worst is ${worst.layer} (${worst.source}), its own peak ${worst.ownDb} dBFS at volume ${worst.topVolume} against ${worst.around} dBFS at ${worst.at} s, ${worst.belowMixDb} dB louder. If it is meant to be heard, raise its volume (an accent over music needs 2 to 3) or lower what plays there; every source's belowMixDb has its own number`);
+    const distinct = new Set(buried.map((x) => (x.layer === "an audio layer" ? `#${buried.indexOf(x)}` : x.layer) + x.source)).size;
+    scoreNotes.push(`${distinct === 1 ? "1 sound effect is" : `${distinct} sound effects are`} buried (${BURIED_DB} dB or more under the loudest sample of the mix around its loudest moment${buried.length > distinct ? `, ${buried.length} times in all` : ""}): the worst is ${worst.layer} (${worst.source}), its own peak ${worst.ownDb} dBFS at volume ${Math.round(worst.topVolume * 100) / 100} against ${worst.around} dBFS at ${worst.at} s, ${worst.belowMixDb} dB louder. If it is meant to be heard, raise its volume (an accent over music needs 2 to 3) or lower what plays there; every source's belowMixDb has its own number`);
   }
   const whole = measureLoudness(chans, sr);
   const silences = findSilences(chans, sr, { minLength: 1 });
@@ -695,12 +696,14 @@ async function reviewMovie(movie, opts = {}) {
     if (r.issues.length) perFrame.push({ frame, issues: r.issues });
   }
   const grouped = splitIssues(groupIssues(perFrame), !!opts.strict);
+  const canvas = movie.canvasReport();
+  for (const r of canvas) if (!r.ok) grouped.problems.push({ message: r.problem, count: 1, firstFrame: 0, lastFrame: 0, kind: "canvas" });
   const fonts = movie.inspectFonts();
   for (const f of fonts.failedUnused) grouped.review.push({ message: `web font "${f}" failed to load, but no text layer uses it (a broken or unused @font-face)`, count: 1, firstFrame: 0, lastFrame: 0 });
   for (const m of fonts.missing) {
     (opts.strict ? grouped.problems : grouped.review).push({ message: `layer "${m.layer}": none of the fonts "${m.family}" is available here (it is drawn in a fallback font)`, count: 1, firstFrame: 0, lastFrame: 0 });
   }
-  return { frames: frames.length, problems: grouped.problems, review: grouped.review, fonts, audio: movie.audioBuffer ? movie.inspectAudio() : null, at };
+  return { frames: frames.length, problems: grouped.problems, review: grouped.review, canvas, fonts, audio: movie.audioBuffer ? movie.inspectAudio() : null, at };
 }
 
 // src/core/onion.ts
@@ -1506,8 +1509,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunkKJSEQVBV_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunkKJSEQVBV_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkQHIOOK5S_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkQHIOOK5S_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));
@@ -1575,16 +1578,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 = chunkKJSEQVBV_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkQHIOOK5S_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkKJSEQVBV_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkQHIOOK5S_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 = chunkKJSEQVBV_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkQHIOOK5S_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})`);
@@ -1644,7 +1647,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunkY5UWFH6Y_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunkMJMOPWMK_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1899,6 +1902,34 @@ function rejectReservedNameCollision(filters, seqName) {
   }
 }
 
+// src/core/canvasCheck.ts
+var isCanvas = (s) => typeof s.checkDeterminism === "function";
+var describeDiff = (d) => `${d.t} s${d.pixels >= 0 ? ` (${d.pixels} channel values differ, by up to ${d.maxDiff} of 255)` : ""}`;
+function canvasReport(root) {
+  const out = [];
+  const visit = (seq) => {
+    if (isCanvas(seq)) {
+      const length = seq.duration ?? 0;
+      const moments = [0.15, 0.4, 0.65, 0.9].map((f) => Math.round(f * length * 1e3) / 1e3);
+      const { differs, drawMs, threw } = seq.checkDeterminism(moments);
+      const name = chunk3SAS3ZE5_cjs.describeLayer(seq.spec);
+      const problem = threw.length ? `${name} could not draw at ${threw.map((t) => `${t} s`).join(", ")} (its draw threw, or the layer failed to build): it shows a magenta checkerboard there; the warning above says why, so the layer cannot be called deterministic` : differs.length ? `${name} does not draw the same picture for the same time (checked at ${differs.map(describeDiff).join(", ")}; drawn in two orders after one draw that was thrown away): usually its draw uses Math.random, Date.now or state that outlives the call (a value it keeps from the last call), so playback, a seek and an export would not agree: use info.random() (seeded) and derive everything from t. If it uses none of these, look at the canvases it draws from: make sprites and masks with info.canvas(w, h) (not document.createElement) and draw them into the picture before the strokes that depend on them` : "";
+      out.push({ name: seq.spec.name ?? name, moments, drawMs, ok: !differs.length && !threw.length, problem });
+    }
+    if (seq instanceof chunkMJMOPWMK_cjs.CompositionSequence) walk2(seq);
+  };
+  const walk2 = (comp) => {
+    for (const { seq } of comp.layers()) {
+      visit(seq);
+      const mask = seq.maskSequence;
+      if (mask) visit(mask);
+    }
+  };
+  walk2(root);
+  return out;
+}
+var canvasProblems = (root) => canvasReport(root).filter((r) => !r.ok).map((r) => r.problem);
+
 // src/core/inspect.ts
 function chainOf(node) {
   const chain = [];
@@ -1937,8 +1968,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 = chunkKJSEQVBV_cjs.parseSpring(kf.ease);
-      length = sp ? Math.round(chunkKJSEQVBV_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
+      const sp = chunkQHIOOK5S_cjs.parseSpring(kf.ease);
+      length = sp ? Math.round(chunkQHIOOK5S_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
     }
     if (!(length > 0)) continue;
     const kat = kf.at ?? 0;
@@ -2012,7 +2043,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 = chunkY5UWFH6Y_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunkMJMOPWMK_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 });
@@ -2021,7 +2052,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 chunkY5UWFH6Y_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
+      if (seq instanceof chunkMJMOPWMK_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
     });
   };
   walk2(root, "", false, true);
@@ -2105,7 +2136,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 = chunkKJSEQVBV_cjs.spansMeta.get(seq.spec)?.preview;
+  const spans = chunkQHIOOK5S_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`;
@@ -2121,10 +2152,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 + chunkKJSEQVBV_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkQHIOOK5S_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 chunkY5UWFH6Y_cjs.CompositionSequence;
+    const isComp = seq instanceof chunkMJMOPWMK_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);
@@ -2283,7 +2314,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", ...chunkKJSEQVBV_cjs.EXPRESSION_NAMES];
+var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkQHIOOK5S_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)) {
@@ -2822,8 +2853,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 = chunkKJSEQVBV_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkKJSEQVBV_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkQHIOOK5S_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkQHIOOK5S_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2917,8 +2948,8 @@ var Movie = class {
       height: sizeWins ? height : spec.height ?? height,
       duration: spec.duration ?? this.duration
     } : void 0;
-    await chunkKJSEQVBV_cjs.ensureFilterLibrary(seededComposition);
-    if (chunkNEUPEENI_cjs.usesAdvancedBlend(seededComposition)) await chunkNEUPEENI_cjs.enableAdvancedBlend(this.app.renderer);
+    await chunkQHIOOK5S_cjs.ensureFilterLibrary(seededComposition);
+    if (chunkJN7JHNZR_cjs.usesAdvancedBlend(seededComposition)) await chunkJN7JHNZR_cjs.enableAdvancedBlend(this.app.renderer);
     const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
     const rootSeqSpec = {
       type: "composition",
@@ -2928,7 +2959,7 @@ var Movie = class {
       ...userComposition
     };
     if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-    const sequence = new chunkY5UWFH6Y_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+    const sequence = new chunkMJMOPWMK_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
     lp?.begin("build", countLayers(rootSeqSpec));
     try {
       await sequence.build();
@@ -3064,8 +3095,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 = chunkKJSEQVBV_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkKJSEQVBV_cjs.lengthen(timeline, this.duration);
+      const timeline = chunkQHIOOK5S_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkQHIOOK5S_cjs.lengthen(timeline, this.duration);
       sequence.bindTimeline(timeline);
       const hadSound = this.audioBuffer !== null;
       const audio = await this._mixSound(sequence, this._ensureAudioContext());
@@ -3362,6 +3393,16 @@ var Movie = class {
     await this.gotoFrame(f, true);
     return inspectScene(this._rootSequence, f, f / this.frameRate, { width: this.width, height: this.height }, opts);
   }
+  /** The canvas layers whose same frame is not the same picture (what `check` reports as a problem): one sentence each. */
+  canvasProblems() {
+    this._requireReady("canvasProblems");
+    return canvasProblems(this._rootSequence);
+  }
+  /** Every canvas layer as the determinism check saw it: the moments drawn, the usual time of a draw in ms, and whether the same time gave the same picture (`check` prints it even when all pass). */
+  canvasReport() {
+    this._requireReady("canvasReport");
+    return canvasReport(this._rootSequence);
+  }
   /**
    * Every layer as a row with absolute start / end / keyframe times (seconds), plus the transition windows. Runs of
    * similar layers (`pop-1` … `pop-12`) are one row with a `parts` span each. Read it, or draw it with `timelineChart()`.
@@ -3779,7 +3820,7 @@ function countLayers(spec) {
     n += 1 + countLayers(s);
     const spans = s.spans;
     if (Array.isArray(spans)) n += spans.length;
-    const src = chunkY5UWFH6Y_cjs.maskSourceOf(mask);
+    const src = chunkMJMOPWMK_cjs.maskSourceOf(mask);
     if (src.kind === "inline") n += 1 + countLayers(src.spec);
   }
   return n;
@@ -3868,8 +3909,8 @@ function splitVertical(text, style, ts, right, top, align, by) {
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunkKJSEQVBV_cjs.checkEase(name, "a preset");
-  return chunkKJSEQVBV_cjs.parseEase(name);
+  chunkQHIOOK5S_cjs.checkEase(name, "a preset");
+  return chunkQHIOOK5S_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -4004,17 +4045,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 ?? chunkKJSEQVBV_cjs.homeDistance(height, fov ?? chunkKJSEQVBV_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkQHIOOK5S_cjs.homeDistance(height, fov ?? chunkQHIOOK5S_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)) * chunkKJSEQVBV_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkQHIOOK5S_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 = chunkKJSEQVBV_cjs.homeDistance(height, f);
+    const R = chunkQHIOOK5S_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -4069,7 +4110,7 @@ function particles(opts) {
   const round2 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkKJSEQVBV_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkQHIOOK5S_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -4082,7 +4123,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 ? chunkKJSEQVBV_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkQHIOOK5S_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -4091,7 +4132,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkKJSEQVBV_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkQHIOOK5S_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -4153,7 +4194,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 chunkKJSEQVBV_cjs.flattenSvgPath(d)) {
+  for (const line of chunkQHIOOK5S_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]);
@@ -4203,6 +4244,45 @@ function followPath(opts) {
   return out;
 }
 
+// src/core/pathSample.ts
+function samplePath(d) {
+  if (typeof d !== "string" || d.trim() === "") throw new Error('samplePath(): d must be SVG path data, e.g. "M 40 300 C 200 20 400 20 560 300"');
+  const lines = chunkQHIOOK5S_cjs.flattenSvgPath(d);
+  const segments = [];
+  let length = 0;
+  for (const line of lines) {
+    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]);
+      if (len === 0) continue;
+      segments.push({ x0: p[i - 2], y0: p[i - 1], x1: p[i], y1: p[i + 1], start: length, len });
+      length += len;
+    }
+  }
+  if (!(length > 0)) throw new Error(`samplePath(): the path "${d}" has no length (it needs at least two different points)`);
+  const find = (s) => {
+    let lo = 0, hi = segments.length - 1;
+    while (lo < hi) {
+      const mid = lo + hi >> 1;
+      if (segments[mid].start + segments[mid].len < s) lo = mid + 1;
+      else hi = mid;
+    }
+    return segments[lo];
+  };
+  return {
+    length,
+    at(u) {
+      const s = Math.min(Math.max(Number.isFinite(u) ? u : 0, 0), 1) * length;
+      const g = find(s);
+      const t = Math.min(Math.max((s - g.start) / g.len, 0), 1);
+      return { x: g.x0 + (g.x1 - g.x0) * t, y: g.y0 + (g.y1 - g.y0) * t, angle: Math.atan2(g.y1 - g.y0, g.x1 - g.x0) };
+    },
+    trim(start = 0, end = 1) {
+      return chunkQHIOOK5S_cjs.trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
+    }
+  };
+}
+
 // src/presets/cameraPath.ts
 var KEYS4 = ["points", "at", "duration", "ease", "look", "lookAhead", "smooth", "from", "to", "frameRate"];
 var MAX_STEPS2 = 4e3;
@@ -4307,7 +4387,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkKJSEQVBV_cjs.random(seed);
+    const r = chunkQHIOOK5S_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]];
@@ -4369,7 +4449,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkKJSEQVBV_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkQHIOOK5S_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 });
@@ -4823,9 +4903,10 @@ exports.parseEase = parseEase2;
 exports.particles = particles;
 exports.react = react;
 exports.resolveLoader = resolveLoader;
+exports.samplePath = samplePath;
 exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-CC7SUR7Q.cjs.map
-//# sourceMappingURL=chunk-CC7SUR7Q.cjs.map
+//# sourceMappingURL=chunk-E26M4NTL.cjs.map
+//# sourceMappingURL=chunk-E26M4NTL.cjs.map