@sarmal/core 0.25.1 → 0.27.0

package/dist/index.cjs

@@ -74,21 +74,21 @@ function createEngine(curveDef, trailLength = 120) {
   }
   let curve = resolveCurve(curveDef);
   const trail = new CircularBuffer(trailLength);
-  let t = 0;
+  let phase = 0;
   let actualTime = 0;
   let userSpeedOverride = null;
   let morphCurveB = null;
   let _morphAlpha = null;
   let _morphStrategy = "normalized";
   let _speedTransition = null;
-  function sampleSkeleton(c, sampleT) {
+  function sampleSkeleton(c, samplePhase) {
     if (c.skeletonFn) {
-      return c.skeletonFn(sampleT);
+      return c.skeletonFn(samplePhase);
     }
     if (c.skeleton === "live") {
-      return c.fn(sampleT, actualTime, EMPTY_PARAMS);
+      return c.fn(samplePhase, actualTime, EMPTY_PARAMS);
     }
-    return c.fn(sampleT, 0, EMPTY_PARAMS);
+    return c.fn(samplePhase, 0, EMPTY_PARAMS);
   }
   return {
     tick(deltaTime) {
@@ -106,15 +106,16 @@ function createEngine(curveDef, trailLength = 120) {
       if (morphCurveB !== null && _morphAlpha !== null) {
         effectiveSpeed = lerp(effectiveSpeed, morphCurveB.speed, _morphAlpha);
       }
-      t = (t + effectiveSpeed * deltaTime) % curve.period;
+      phase = (phase + effectiveSpeed * deltaTime) % curve.period;
       actualTime += deltaTime;
       if (morphCurveB !== null && _morphAlpha !== null) {
-        const a = curve.fn(t, actualTime, EMPTY_PARAMS);
-        const tB = _morphStrategy === "normalized" ? (t / curve.period) * morphCurveB.period : t;
-        const b = morphCurveB.fn(tB, actualTime, EMPTY_PARAMS);
+        const a = curve.fn(phase, actualTime, EMPTY_PARAMS);
+        const phaseB =
+          _morphStrategy === "normalized" ? (phase / curve.period) * morphCurveB.period : phase;
+        const b = morphCurveB.fn(phaseB, actualTime, EMPTY_PARAMS);
         trail.push(a.x + (b.x - a.x) * _morphAlpha, a.y + (b.y - a.y) * _morphAlpha);
       } else {
-        const point = curve.fn(t, actualTime, EMPTY_PARAMS);
+        const point = curve.fn(phase, actualTime, EMPTY_PARAMS);
         trail.push(point.x, point.y);
       }
       return trail.toArray();
@@ -132,30 +133,30 @@ function createEngine(curveDef, trailLength = 120) {
       return _morphAlpha;
     },
     reset() {
-      t = 0;
+      phase = 0;
       actualTime = 0;
       trail.clear();
     },
-    jump(newT, { clearTrail = false } = {}) {
-      t = ((newT % curve.period) + curve.period) % curve.period;
+    jump(newPhase, { clearTrail = false } = {}) {
+      phase = ((newPhase % curve.period) + curve.period) % curve.period;
       if (clearTrail) {
         trail.clear();
       }
     },
-    seek(targetT, { wrap = false, step = curve.period / trailLength } = {}) {
+    seek(targetPhase, { wrap = false, step = curve.period / trailLength } = {}) {
       const advance = curve.speed * step;
-      const target = ((targetT % curve.period) + curve.period) % curve.period;
+      const target = ((targetPhase % curve.period) + curve.period) % curve.period;
       const targetTime = target / curve.speed;
-      t = target;
+      phase = target;
       actualTime = targetTime;
       trail.clear();
       const pointsFromStart = Math.floor(target / advance) + 1;
       const count = wrap ? trailLength : Math.min(trailLength, pointsFromStart);
       for (let i = count - 1; i >= 0; i--) {
-        const sampleT = target - i * advance;
-        const wrappedT = ((sampleT % curve.period) + curve.period) % curve.period;
-        const time = targetTime - i * step;
-        const point = curve.fn(wrappedT, time, EMPTY_PARAMS);
+        const samplePhase = target - i * advance;
+        const wrappedPhase = ((samplePhase % curve.period) + curve.period) % curve.period;
+        const elapsed = targetTime - i * step;
+        const point = curve.fn(wrappedPhase, elapsed, EMPTY_PARAMS);
         trail.push(point.x, point.y);
       }
     },
@@ -168,13 +169,13 @@ function createEngine(curveDef, trailLength = 120) {
         const frozenStrategy = _morphStrategy;
         curve = {
           ...frozenB,
-          fn: (sampleT, time, params) => {
-            const a = frozenA.fn(sampleT, time, params);
-            const tB =
+          fn: (samplePhase, elapsed, params) => {
+            const a = frozenA.fn(samplePhase, elapsed, params);
+            const phaseB =
               frozenStrategy === "normalized"
-                ? (sampleT / frozenA.period) * frozenB.period
-                : sampleT;
-            const b = frozenB.fn(tB, time, params);
+                ? (samplePhase / frozenA.period) * frozenB.period
+                : samplePhase;
+            const b = frozenB.fn(phaseB, elapsed, params);
             return {
               x: a.x + (b.x - a.x) * frozenAlpha,
               y: a.y + (b.y - a.y) * frozenAlpha,
@@ -192,7 +193,7 @@ function createEngine(curveDef, trailLength = 120) {
     completeMorph() {
       if (morphCurveB !== null) {
         if (_morphStrategy === "normalized" && curve.period !== morphCurveB.period) {
-          t = (t / curve.period) * morphCurveB.period;
+          phase = (phase / curve.period) * morphCurveB.period;
         }
         curve = morphCurveB;
       }
@@ -204,13 +205,13 @@ function createEngine(curveDef, trailLength = 120) {
       const points2 = new Array(steps);
       if (morphCurveB !== null && _morphAlpha !== null) {
         for (let i = 0; i < steps; i++) {
-          const sampleT = (i / (steps - 1)) * curve.period;
-          const a = sampleSkeleton(curve, sampleT);
-          const tB =
+          const samplePhase = (i / (steps - 1)) * curve.period;
+          const a = sampleSkeleton(curve, samplePhase);
+          const phaseB =
             _morphStrategy === "normalized"
-              ? (sampleT / curve.period) * morphCurveB.period
-              : sampleT;
-          const b = sampleSkeleton(morphCurveB, tB);
+              ? (samplePhase / curve.period) * morphCurveB.period
+              : samplePhase;
+          const b = sampleSkeleton(morphCurveB, phaseB);
           points2[i] = {
             x: a.x + (b.x - a.x) * _morphAlpha,
             y: a.y + (b.y - a.y) * _morphAlpha,
@@ -219,8 +220,8 @@ function createEngine(curveDef, trailLength = 120) {
         return points2;
       }
       for (let i = 0; i < steps; i++) {
-        const sampleT = (i / (steps - 1)) * curve.period;
-        points2[i] = sampleSkeleton(curve, sampleT);
+        const samplePhase = (i / (steps - 1)) * curve.period;
+        points2[i] = sampleSkeleton(curve, samplePhase);
       }
       return points2;
     },
@@ -762,8 +763,8 @@ function createRenderer(options) {
   if (!engine.isLiveSkeleton) {
     buildSkeletonCanvas();
   }
-  if (options.initialT !== void 0) {
-    engine.seek(options.initialT);
+  if (options.initialPhase !== void 0) {
+    engine.seek(options.initialPhase);
   }
   renderFrame(0);
   const shouldAutoStart = options.autoStart !== false;
@@ -897,8 +898,10 @@ function sampleCurveSkeleton(curveDef) {
   const samples = Math.ceil(period * 50);
   const pts = Array.from({ length: samples });
   for (let i = 0; i < samples; i++) {
-    const t = (i / (samples - 1)) * period;
-    pts[i] = curveDef.skeletonFn ? curveDef.skeletonFn(t) : curveDef.fn(t, 0, EMPTY_PARAMS2);
+    const phase = (i / (samples - 1)) * period;
+    pts[i] = curveDef.skeletonFn
+      ? curveDef.skeletonFn(phase)
+      : curveDef.fn(phase, 0, EMPTY_PARAMS2);
   }
   return pts;
 }
@@ -1109,8 +1112,8 @@ function createSVGRenderer(options) {
       animationId = requestAnimationFrame(loop);
     }
   }
-  if (options.initialT !== void 0) {
-    engine.seek(options.initialT);
+  if (options.initialPhase !== void 0) {
+    engine.seek(options.initialPhase);
   }
   renderFrame(0);
   const shouldAutoStart = options.autoStart !== false;
@@ -1266,7 +1269,7 @@ function catmullRom1D(p0, p1, p2, p3, u) {
       (-p0 + 3 * p1 - 3 * p2 + p3) * u3)
   );
 }
-function evaluateCatmullRom(points2, t) {
+function evaluateCatmullRom(points2, phase) {
   const N = points2.length;
   if (N === 0) {
     return { x: 0, y: 0 };
@@ -1274,13 +1277,13 @@ function evaluateCatmullRom(points2, t) {
   if (N === 1) {
     return { x: points2[0][0], y: points2[0][1] };
   }
-  t = ((t % PERIOD) + PERIOD) % PERIOD;
+  phase = ((phase % PERIOD) + PERIOD) % PERIOD;
   const segmentSize = PERIOD / N;
-  let i = Math.floor(t / segmentSize);
+  let i = Math.floor(phase / segmentSize);
   if (i >= N) {
     i = N - 1;
   }
-  let u = (t - i * segmentSize) / segmentSize;
+  let u = (phase - i * segmentSize) / segmentSize;
   u = Math.max(0, Math.min(1, u));
   const p0 = points2[(i - 1 + N) % N];
   const p1 = points2[i];
@@ -1310,7 +1313,7 @@ function drawCurve(points2, opts) {
   const pts = points2.map(([x, y]) => [x, y]);
   return {
     name: opts?.name ?? "drawn",
-    fn: (t) => evaluateCatmullRom(pts, t),
+    fn: (phase) => evaluateCatmullRom(pts, phase),
     period: PERIOD,
   };
 }
@@ -1346,9 +1349,9 @@ var artemis2 = {
 
 // src/curves/astroid.ts
 var TWO_PI2 = Math.PI * 2;
-function astroidFn(t, _time, _params) {
-  const c = Math.cos(t);
-  const s = Math.sin(t);
+function astroidFn(phase, _elapsed, _params) {
+  const c = Math.cos(phase);
+  const s = Math.sin(phase);
   return {
     x: c * c * c,
     y: s * s * s,
@@ -1363,10 +1366,10 @@ var astroid = {
 
 // src/curves/deltoid.ts
 var TWO_PI3 = Math.PI * 2;
-function deltoidFn(t, _time, _params) {
+function deltoidFn(phase, _elapsed, _params) {
   return {
-    x: 2 * Math.cos(t) + Math.cos(2 * t),
-    y: 2 * Math.sin(t) - Math.sin(2 * t),
+    x: 2 * Math.cos(phase) + Math.cos(2 * phase),
+    y: 2 * Math.sin(phase) - Math.sin(2 * phase),
   };
 }
 var deltoid = {
@@ -1378,10 +1381,10 @@ var deltoid = {
 
 // src/curves/epicycloid3.ts
 var TWO_PI4 = Math.PI * 2;
-function epicycloid3Fn(t, _time, _params) {
+function epicycloid3Fn(phase, _elapsed, _params) {
   return {
-    x: 4 * Math.cos(t) - Math.cos(4 * t),
-    y: 4 * Math.sin(t) - Math.sin(4 * t),
+    x: 4 * Math.cos(phase) - Math.cos(4 * phase),
+    y: 4 * Math.sin(phase) - Math.sin(4 * phase),
   };
 }
 var epicycloid3 = {
@@ -1393,18 +1396,18 @@ var epicycloid3 = {
 
 // src/curves/epitrochoid7.ts
 var TWO_PI5 = Math.PI * 2;
-function epitrochoid7Fn(t, _time, _params) {
-  const d = 1 + 0.55 * Math.sin(t * 0.5);
+function epitrochoid7Fn(phase, _elapsed, _params) {
+  const d = 1 + 0.55 * Math.sin(phase * 0.5);
   return {
-    x: 7 * Math.cos(t) - d * Math.cos(7 * t),
-    y: 7 * Math.sin(t) - d * Math.sin(7 * t),
+    x: 7 * Math.cos(phase) - d * Math.cos(7 * phase),
+    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase),
   };
 }
-function epitrochoid7SkeletonFn(t) {
+function epitrochoid7SkeletonFn(phase) {
   const d = 1.275;
   return {
-    x: 7 * Math.cos(t) - d * Math.cos(7 * t),
-    y: 7 * Math.sin(t) - d * Math.sin(7 * t),
+    x: 7 * Math.cos(phase) - d * Math.cos(7 * phase),
+    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase),
   };
 }
 var epitrochoid7 = {
@@ -1417,11 +1420,11 @@ var epitrochoid7 = {
 
 // src/curves/lissajous32.ts
 var TWO_PI6 = Math.PI * 2;
-function lissajous32Fn(t, time, _params) {
-  const phi = time * 0.45;
+function lissajous32Fn(phase, elapsed, _params) {
+  const phi = elapsed * 0.45;
   return {
-    x: Math.sin(3 * t + phi),
-    y: Math.sin(2 * t),
+    x: Math.sin(3 * phase + phi),
+    y: Math.sin(2 * phase),
   };
 }
 var lissajous32 = {
@@ -1434,11 +1437,11 @@ var lissajous32 = {
 
 // src/curves/lissajous43.ts
 var TWO_PI7 = Math.PI * 2;
-function lissajous43Fn(t, time, _params) {
-  const phi = time * 0.38;
+function lissajous43Fn(phase, elapsed, _params) {
+  const phi = elapsed * 0.38;
   return {
-    x: Math.sin(4 * t + phi),
-    y: Math.sin(3 * t),
+    x: Math.sin(4 * phase + phi),
+    y: Math.sin(3 * phase),
   };
 }
 var lissajous43 = {
@@ -1451,10 +1454,10 @@ var lissajous43 = {
 
 // src/curves/lame.ts
 var TWO_PI8 = Math.PI * 2;
-function lameFn(t, time, _params) {
-  const p = 1.75 + 1.25 * Math.sin(time * 0.48);
-  const c = Math.cos(t),
-    s = Math.sin(t);
+function lameFn(phase, elapsed, _params) {
+  const p = 1.75 + 1.25 * Math.sin(elapsed * 0.48);
+  const c = Math.cos(phase),
+    s = Math.sin(phase);
   return {
     x: Math.sign(c) * Math.pow(Math.abs(c), p),
     y: Math.sign(s) * Math.pow(Math.abs(s), p),
@@ -1470,11 +1473,11 @@ var lame = {
 
 // src/curves/rose3.ts
 var TWO_PI9 = Math.PI * 2;
-function rose3Fn(t, _time, _params) {
-  const r = Math.cos(3 * t);
+function rose3Fn(phase, _elapsed, _params) {
+  const r = Math.cos(3 * phase);
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var rose3 = {
@@ -1486,11 +1489,11 @@ var rose3 = {
 
 // src/curves/rose5.ts
 var TWO_PI10 = Math.PI * 2;
-function rose5Fn(t, _time, _params) {
-  const r = Math.cos(5 * t);
+function rose5Fn(phase, _elapsed, _params) {
+  const r = Math.cos(5 * phase);
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var rose5 = {
@@ -1502,11 +1505,11 @@ var rose5 = {
 
 // src/curves/rose52.ts
 var FOUR_PI = Math.PI * 4;
-function rose52Fn(t, _time, _params) {
-  const r = Math.cos((5 / 2) * t);
+function rose52Fn(phase, _elapsed, _params) {
+  const r = Math.cos((5 / 2) * phase);
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var rose52 = {
@@ -1518,14 +1521,14 @@ var rose52 = {
 
 // src/curves/star.ts
 var TWO_PI11 = Math.PI * 2;
-function starFn(t, _time, _params) {
+function starFn(phase, _elapsed, _params) {
   const r =
-    Math.abs(Math.cos((5 / 2) * t)) +
-    0.35 * Math.abs(Math.cos((15 / 2) * t)) +
-    0.15 * Math.abs(Math.cos((25 / 2) * t));
+    Math.abs(Math.cos((5 / 2) * phase)) +
+    0.35 * Math.abs(Math.cos((15 / 2) * phase)) +
+    0.15 * Math.abs(Math.cos((25 / 2) * phase));
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var star = {
@@ -1537,14 +1540,14 @@ var star = {
 
 // src/curves/star4.ts
 var TWO_PI12 = Math.PI * 2;
-function star4Fn(t, _time, _params) {
+function star4Fn(phase, _elapsed, _params) {
   const r =
-    Math.abs(Math.cos(2 * t)) +
-    0.35 * Math.abs(Math.cos(6 * t)) +
-    0.15 * Math.abs(Math.cos(10 * t));
+    Math.abs(Math.cos(2 * phase)) +
+    0.35 * Math.abs(Math.cos(6 * phase)) +
+    0.15 * Math.abs(Math.cos(10 * phase));
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var star4 = {
@@ -1556,14 +1559,14 @@ var star4 = {
 
 // src/curves/star7.ts
 var TWO_PI13 = Math.PI * 2;
-function star7Fn(t, _time, _params) {
+function star7Fn(phase, _elapsed, _params) {
   const r =
-    Math.abs(Math.cos((7 / 2) * t)) +
-    0.35 * Math.abs(Math.cos((21 / 2) * t)) +
-    0.15 * Math.abs(Math.cos((35 / 2) * t));
+    Math.abs(Math.cos((7 / 2) * phase)) +
+    0.35 * Math.abs(Math.cos((21 / 2) * phase)) +
+    0.15 * Math.abs(Math.cos((35 / 2) * phase));
   return {
-    x: r * Math.cos(t),
-    y: r * Math.sin(t),
+    x: r * Math.cos(phase),
+    y: r * Math.sin(phase),
   };
 }
 var star7 = {