@sarmal/core 0.19.0 → 0.20.0

package/dist/index.cjs

@@ -1444,6 +1444,55 @@ var curves = {
   lame,
 };
 
+// src/catmull-rom.ts
+var PERIOD = 2 * Math.PI;
+function catmullRom1D(p0, p1, p2, p3, u) {
+  const u2 = u * u;
+  const u3 = u2 * u;
+  return (
+    0.5 *
+    (2 * p1 +
+      (-p0 + p2) * u +
+      (2 * p0 - 5 * p1 + 4 * p2 - p3) * u2 +
+      (-p0 + 3 * p1 - 3 * p2 + p3) * u3)
+  );
+}
+function evaluateCatmullRom(points, t) {
+  const N = points.length;
+  if (N === 0) {
+    return { x: 0, y: 0 };
+  }
+  if (N === 1) {
+    return { x: points[0][0], y: points[0][1] };
+  }
+  t = ((t % PERIOD) + PERIOD) % PERIOD;
+  const segmentSize = PERIOD / N;
+  let i = Math.floor(t / segmentSize);
+  if (i >= N) {
+    i = N - 1;
+  }
+  let u = (t - i * segmentSize) / segmentSize;
+  u = Math.max(0, Math.min(1, u));
+  const p0 = points[(i - 1 + N) % N];
+  const p1 = points[i];
+  const p2 = points[(i + 1) % N];
+  const p3 = points[(i + 2) % N];
+  return {
+    x: catmullRom1D(p0[0], p1[0], p2[0], p3[0], u),
+    y: catmullRom1D(p0[1], p1[1], p2[1], p3[1], u),
+  };
+}
+function drawCurve(points) {
+  if (points.length < 3) {
+    throw new Error(`drawCurve requires at least 3 points, received ${points.length}.`);
+  }
+  return {
+    name: "custom",
+    fn: (t) => evaluateCatmullRom(points, t),
+    period: PERIOD,
+  };
+}
+
 // src/index.ts
 function createSarmal(canvas, curveDef, options) {
   const { trailLength, ...rendererOpts } = options ?? {};
@@ -1460,8 +1509,10 @@ exports.createSarmal = createSarmal;
 exports.createSarmalSVG = createSarmalSVG;
 exports.curves = curves;
 exports.deltoid = deltoid;
+exports.drawCurve = drawCurve;
 exports.epicycloid3 = epicycloid3;
 exports.epitrochoid7 = epitrochoid7;
+exports.evaluateCatmullRom = evaluateCatmullRom;
 exports.lame = lame;
 exports.lissajous32 = lissajous32;
 exports.lissajous43 = lissajous43;