@sarmal/core 0.27.0 → 0.28.0

package/dist/cli.js

@@ -62,13 +62,13 @@ function resolveCurve(curveDef) {
     period,
     speed,
     skeleton: curveDef.skeleton,
-    skeletonFn: curveDef.skeletonFn,
+    skeletonFn: curveDef.skeletonFn
   };
 }
 function createEngine(curveDef, trailLength = 120) {
   if (!Number.isFinite(trailLength) || trailLength <= 0) {
     throw new RangeError(
-      `[sarmal] trailLength must be a positive finite number, got ${trailLength}`,
+      `[sarmal] trailLength must be a positive finite number, got ${trailLength}`
     );
   }
   let curve = resolveCurve(curveDef);
@@ -109,8 +109,7 @@ function createEngine(curveDef, trailLength = 120) {
       actualTime += deltaTime;
       if (morphCurveB !== null && _morphAlpha !== null) {
         const a = curve.fn(phase, actualTime, EMPTY_PARAMS);
-        const phaseB =
-          _morphStrategy === "normalized" ? (phase / curve.period) * morphCurveB.period : phase;
+        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 {
@@ -137,14 +136,14 @@ function createEngine(curveDef, trailLength = 120) {
       trail.clear();
     },
     jump(newPhase, { clearTrail = false } = {}) {
-      phase = ((newPhase % curve.period) + curve.period) % curve.period;
+      phase = (newPhase % curve.period + curve.period) % curve.period;
       if (clearTrail) {
         trail.clear();
       }
     },
     seek(targetPhase, { wrap = false, step = curve.period / trailLength } = {}) {
       const advance = curve.speed * step;
-      const target = ((targetPhase % curve.period) + curve.period) % curve.period;
+      const target = (targetPhase % curve.period + curve.period) % curve.period;
       const targetTime = target / curve.speed;
       phase = target;
       actualTime = targetTime;
@@ -153,7 +152,7 @@ function createEngine(curveDef, trailLength = 120) {
       const count = wrap ? trailLength : Math.min(trailLength, pointsFromStart);
       for (let i = count - 1; i >= 0; i--) {
         const samplePhase = target - i * advance;
-        const wrappedPhase = ((samplePhase % curve.period) + curve.period) % curve.period;
+        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);
@@ -170,16 +169,13 @@ function createEngine(curveDef, trailLength = 120) {
           ...frozenB,
           fn: (samplePhase, elapsed, params) => {
             const a = frozenA.fn(samplePhase, elapsed, params);
-            const phaseB =
-              frozenStrategy === "normalized"
-                ? (samplePhase / frozenA.period) * frozenB.period
-                : samplePhase;
+            const phaseB = frozenStrategy === "normalized" ? 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,
+              y: a.y + (b.y - a.y) * frozenAlpha
             };
-          },
+          }
         };
       }
       _morphStrategy = strategy;
@@ -192,7 +188,7 @@ function createEngine(curveDef, trailLength = 120) {
     completeMorph() {
       if (morphCurveB !== null) {
         if (_morphStrategy === "normalized" && curve.period !== morphCurveB.period) {
-          phase = (phase / curve.period) * morphCurveB.period;
+          phase = phase / curve.period * morphCurveB.period;
         }
         curve = morphCurveB;
       }
@@ -204,22 +200,19 @@ function createEngine(curveDef, trailLength = 120) {
       const points2 = new Array(steps);
       if (morphCurveB !== null && _morphAlpha !== null) {
         for (let i = 0; i < steps; i++) {
-          const samplePhase = (i / (steps - 1)) * curve.period;
+          const samplePhase = i / (steps - 1) * curve.period;
           const a = sampleSkeleton(curve, samplePhase);
-          const phaseB =
-            _morphStrategy === "normalized"
-              ? (samplePhase / curve.period) * morphCurveB.period
-              : samplePhase;
+          const phaseB = _morphStrategy === "normalized" ? 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,
+            y: a.y + (b.y - a.y) * _morphAlpha
           };
         }
         return points2;
       }
       for (let i = 0; i < steps; i++) {
-        const samplePhase = (i / (steps - 1)) * curve.period;
+        const samplePhase = i / (steps - 1) * curve.period;
         points2[i] = sampleSkeleton(curve, samplePhase);
       }
       return points2;
@@ -261,7 +254,7 @@ function createEngine(curveDef, trailLength = 120) {
         _speedTransition.reject(new Error("Speed transition cancelled"));
         _speedTransition = null;
       }
-    },
+    }
   };
 }
 
@@ -271,10 +264,7 @@ var FIT_PADDING_MIN = 4;
 function computeBoundaries(pts, logicalWidth, logicalHeight, minPaddingPx = FIT_PADDING_MIN) {
   if (pts.length === 0) return null;
   const first = pts[0];
-  let minX = first.x,
-    maxX = first.x,
-    minY = first.y,
-    maxY = first.y;
+  let minX = first.x, maxX = first.x, minY = first.y, maxY = first.y;
   for (const p of pts) {
     if (p.x < minX) {
       minX = p.x;
@@ -293,7 +283,7 @@ function computeBoundaries(pts, logicalWidth, logicalHeight, minPaddingPx = FIT_
   const h = maxY - minY;
   if (w === 0 && h === 0) {
     throw new Error(
-      "[sarmal] Degenerate curve: all skeleton points are identical. Check that your curve fn returns distinct points for different values of t.",
+      "[sarmal] Degenerate curve: all skeleton points are identical. Check that your curve fn returns distinct points for different values of t."
     );
   }
   const scaleXProportional = logicalWidth / (w * (1 + FIT_PADDING * 2));
@@ -304,17 +294,17 @@ function computeBoundaries(pts, logicalWidth, logicalHeight, minPaddingPx = FIT_
     scaleXProportional,
     scaleYProportional,
     scaleXMinPadding,
-    scaleYMinPadding,
+    scaleYMinPadding
   );
   return {
     scale,
     offsetX: (logicalWidth - w * scale) / 2 - minX * scale,
-    offsetY: (logicalHeight - h * scale) / 2 - minY * scale,
+    offsetY: (logicalHeight - h * scale) / 2 - minY * scale
   };
 }
 function hexToRgb(hex) {
   const n = parseInt(hex.slice(1), 16);
-  return { r: n >> 16, g: (n >> 8) & 255, b: n & 255 };
+  return { r: n >> 16, g: n >> 8 & 255, b: n & 255 };
 }
 
 // src/terminal.ts
@@ -328,7 +318,7 @@ var BRAILLE_BIT = [
   [1, 8],
   [2, 16],
   [4, 32],
-  [64, 128],
+  [64, 128]
 ];
 function brailleChar(bits) {
   return String.fromCodePoint(BRAILLE_BASE + (bits & 255));
@@ -338,7 +328,7 @@ function dotToCell(dotCol, dotRow) {
     charCol: Math.floor(dotCol / 2),
     charRow: Math.floor(dotRow / 4),
     dotColInCell: dotCol % 2,
-    dotRowInCell: dotRow % 4,
+    dotRowInCell: dotRow % 4
   };
 }
 function detectColor() {
@@ -353,13 +343,10 @@ function detectColor() {
   if (term.includes("truecolor") || term.includes("24bit")) {
     return "truecolor";
   }
-  if (colorterm !== "") {
-    return "256-color";
-  }
-  if (term !== "" && term !== "linux" && term !== "dumb") {
-    return "256-color";
+  if (term === "" || term === "linux" || term === "dumb") {
+    return "monochrome";
   }
-  return "monochrome";
+  return "256-color";
 }
 function rgbTo256(r, g, b) {
   const avg = Math.round((r + g + b) / 3);
@@ -369,9 +356,9 @@ function rgbTo256(r, g, b) {
     }
     return 232 + Math.min(23, Math.round((avg - 8) / 10));
   }
-  const ri = Math.round((r / 255) * 5);
-  const gi = Math.round((g / 255) * 5);
-  const bi = Math.round((b / 255) * 5);
+  const ri = Math.round(r / 255 * 5);
+  const gi = Math.round(g / 255 * 5);
+  const bi = Math.round(b / 255 * 5);
   return 16 + 36 * ri + 6 * gi + bi;
 }
 var AR = "\x1B[0m";
@@ -396,25 +383,18 @@ function snapCol(col, max) {
 function applyBoundary(x, y, scale, offsetX, offsetY) {
   return {
     screenX: x * scale + offsetX,
-    screenY: y * scale + offsetY,
+    screenY: y * scale + offsetY
   };
 }
-function renderFrame(
-  trail,
-  trailCount,
-  charWidth,
-  charHeight,
-  scale,
-  offsetX,
-  offsetY,
-  trailRgb,
-  headRgb,
-  colorCap,
-) {
+function renderFrame(trail, trailCount, charWidth, charHeight, scale, offsetX, offsetY, trailRgb, headRgb, colorCap) {
   const dotWidth = charWidth * 2;
   const dotHeight = charHeight * 4;
-  const grid = Array.from({ length: charHeight }, () =>
-    Array.from({ length: charWidth }, () => ({ bits: 0, brightness: 0, isHead: false })),
+  const grid = Array.from(
+    { length: charHeight },
+    () => Array.from(
+      { length: charWidth },
+      () => ({ bits: 0, brightness: 0, isHead: false })
+    )
   );
   for (let i = 0; i < trailCount; i++) {
     const pt = trail[i];
@@ -424,12 +404,7 @@ function renderFrame(
     const dotCol = snapCol(screenX, dotWidth);
     const dotRow = snapCol(screenY, dotHeight);
     const cell = dotToCell(dotCol, dotRow);
-    if (
-      cell.charRow < 0 ||
-      cell.charRow >= charHeight ||
-      cell.charCol < 0 ||
-      cell.charCol >= charWidth
-    ) {
+    if (cell.charRow < 0 || cell.charRow >= charHeight || cell.charCol < 0 || cell.charCol >= charWidth) {
       continue;
     }
     const c = grid[cell.charRow][cell.charCol];
@@ -480,11 +455,7 @@ function renderMonochromeFrame(grid, charWidth, charHeight) {
         line += " ";
         continue;
       }
-      if (cell.isHead) {
-        line += "\u28FF";
-      } else {
-        line += brailleChar(cell.bits);
-      }
+      line += brailleChar(cell.bits);
     }
     lines.push(line);
   }
@@ -492,7 +463,8 @@ function renderMonochromeFrame(grid, charWidth, charHeight) {
 }
 function terminalSarmal(stream, curveDef, options) {
   if (!stream.isTTY) {
-    return () => {};
+    return () => {
+    };
   }
   const size = options?.size ?? DEFAULT_SIZE;
   const fps = options?.fps ?? DEFAULT_FPS;
@@ -511,7 +483,8 @@ function terminalSarmal(stream, curveDef, options) {
   const skeleton = engine.getSarmalSkeleton();
   const b = computeBoundaries(skeleton, charWidth * 2, charHeight * 4, 1);
   if (!b) {
-    return () => {};
+    return () => {
+    };
   }
   const { scale, offsetX, offsetY } = b;
   let running = true;
@@ -541,7 +514,7 @@ function terminalSarmal(stream, curveDef, options) {
       offsetY,
       trailRgb,
       headRgb,
-      colorCap,
+      colorCap
     );
     if (firstFrame) {
       firstFrame = false;
@@ -575,13 +548,7 @@ 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)
-  );
+  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(points2, phase) {
   const N = points2.length;
@@ -591,7 +558,7 @@ function evaluateCatmullRom(points2, phase) {
   if (N === 1) {
     return { x: points2[0][0], y: points2[0][1] };
   }
-  phase = ((phase % PERIOD) + PERIOD) % PERIOD;
+  phase = (phase % PERIOD + PERIOD) % PERIOD;
   const segmentSize = PERIOD / N;
   let i = Math.floor(phase / segmentSize);
   if (i >= N) {
@@ -605,7 +572,7 @@ function evaluateCatmullRom(points2, phase) {
   const p3 = points2[(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),
+    y: catmullRom1D(p0[1], p1[1], p2[1], p3[1], u)
   };
 }
 function drawCurve(points2, opts) {
@@ -615,20 +582,20 @@ function drawCurve(points2, opts) {
   const first = points2[0];
   if (points2.every((p) => p[0] === first[0] && p[1] === first[1])) {
     console.warn(
-      "[sarmal].drawCurve: all control points are identical. The curve will be a single point.",
+      "[sarmal].drawCurve: all control points are identical. The curve will be a single point."
     );
   }
   const maxAbs = points2.reduce((m, p) => Math.max(m, Math.abs(p[0]), Math.abs(p[1])), 0);
   if (maxAbs > 2) {
     console.warn(
-      `[sarmal].drawCurve: control points extend to \xB1${maxAbs.toFixed(1)}, which may render off-screen. Coordinates should be in [-1, 1].`,
+      `[sarmal].drawCurve: control points extend to \xB1${maxAbs.toFixed(1)}, which may render off-screen. Coordinates should be in [-1, 1].`
     );
   }
   const pts = points2.map(([x, y]) => [x, y]);
   return {
     name: opts?.name ?? "drawn",
     fn: (phase) => evaluateCatmullRom(pts, phase),
-    period: PERIOD,
+    period: PERIOD
   };
 }
 
@@ -654,11 +621,11 @@ var points = [
   [-0.69, -0.84],
   [-0.87, -0.66],
   [-0.9, -0.47],
-  [-0.76, -0.35],
+  [-0.76, -0.35]
 ];
 var artemis2 = {
   ...drawCurve(points, { name: "Artemis II" }),
-  speed: 0.7,
+  speed: 0.7
 };
 
 // src/curves/astroid.ts
@@ -668,14 +635,14 @@ function astroidFn(phase, _elapsed, _params) {
   const s = Math.sin(phase);
   return {
     x: c * c * c,
-    y: s * s * s,
+    y: s * s * s
   };
 }
 var astroid = {
   name: "Astroid",
   fn: astroidFn,
   period: TWO_PI2,
-  speed: 1.1,
+  speed: 1.1
 };
 
 // src/curves/deltoid.ts
@@ -683,14 +650,14 @@ var TWO_PI3 = Math.PI * 2;
 function deltoidFn(phase, _elapsed, _params) {
   return {
     x: 2 * Math.cos(phase) + Math.cos(2 * phase),
-    y: 2 * Math.sin(phase) - Math.sin(2 * phase),
+    y: 2 * Math.sin(phase) - Math.sin(2 * phase)
   };
 }
 var deltoid = {
   name: "Deltoid",
   fn: deltoidFn,
   period: TWO_PI3,
-  speed: 0.9,
+  speed: 0.9
 };
 
 // src/curves/epicycloid3.ts
@@ -698,14 +665,14 @@ var TWO_PI4 = Math.PI * 2;
 function epicycloid3Fn(phase, _elapsed, _params) {
   return {
     x: 4 * Math.cos(phase) - Math.cos(4 * phase),
-    y: 4 * Math.sin(phase) - Math.sin(4 * phase),
+    y: 4 * Math.sin(phase) - Math.sin(4 * phase)
   };
 }
 var epicycloid3 = {
   name: "Epicycloid (n=3)",
   fn: epicycloid3Fn,
   period: TWO_PI4,
-  speed: 0.75,
+  speed: 0.75
 };
 
 // src/curves/epitrochoid7.ts
@@ -714,14 +681,14 @@ function epitrochoid7Fn(phase, _elapsed, _params) {
   const d = 1 + 0.55 * Math.sin(phase * 0.5);
   return {
     x: 7 * Math.cos(phase) - d * Math.cos(7 * phase),
-    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase),
+    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase)
   };
 }
 function epitrochoid7SkeletonFn(phase) {
   const d = 1.275;
   return {
     x: 7 * Math.cos(phase) - d * Math.cos(7 * phase),
-    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase),
+    y: 7 * Math.sin(phase) - d * Math.sin(7 * phase)
   };
 }
 var epitrochoid7 = {
@@ -729,7 +696,7 @@ var epitrochoid7 = {
   fn: epitrochoid7Fn,
   period: TWO_PI5,
   speed: 1.4,
-  skeletonFn: epitrochoid7SkeletonFn,
+  skeletonFn: epitrochoid7SkeletonFn
 };
 
 // src/curves/lissajous32.ts
@@ -738,7 +705,7 @@ function lissajous32Fn(phase, elapsed, _params) {
   const phi = elapsed * 0.45;
   return {
     x: Math.sin(3 * phase + phi),
-    y: Math.sin(2 * phase),
+    y: Math.sin(2 * phase)
   };
 }
 var lissajous32 = {
@@ -746,7 +713,7 @@ var lissajous32 = {
   fn: lissajous32Fn,
   period: TWO_PI6,
   speed: 2,
-  skeleton: "live",
+  skeleton: "live"
 };
 
 // src/curves/lissajous43.ts
@@ -755,7 +722,7 @@ function lissajous43Fn(phase, elapsed, _params) {
   const phi = elapsed * 0.38;
   return {
     x: Math.sin(4 * phase + phi),
-    y: Math.sin(3 * phase),
+    y: Math.sin(3 * phase)
   };
 }
 var lissajous43 = {
@@ -763,18 +730,17 @@ var lissajous43 = {
   fn: lissajous43Fn,
   period: TWO_PI7,
   speed: 1.8,
-  skeleton: "live",
+  skeleton: "live"
 };
 
 // src/curves/lame.ts
 var TWO_PI8 = Math.PI * 2;
 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);
+  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),
+    y: Math.sign(s) * Math.pow(Math.abs(s), p)
   };
 }
 var lame = {
@@ -782,7 +748,7 @@ var lame = {
   fn: lameFn,
   period: TWO_PI8,
   speed: 1,
-  skeleton: "live",
+  skeleton: "live"
 };
 
 // src/curves/rose3.ts
@@ -791,14 +757,14 @@ function rose3Fn(phase, _elapsed, _params) {
   const r = Math.cos(3 * phase);
   return {
     x: r * Math.cos(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var rose3 = {
   name: "Rose (n=3)",
   fn: rose3Fn,
   period: TWO_PI9,
-  speed: 1.15,
+  speed: 1.15
 };
 
 // src/curves/rose5.ts
@@ -807,87 +773,78 @@ function rose5Fn(phase, _elapsed, _params) {
   const r = Math.cos(5 * phase);
   return {
     x: r * Math.cos(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var rose5 = {
   name: "Rose (n=5)",
   fn: rose5Fn,
   period: TWO_PI10,
-  speed: 1,
+  speed: 1
 };
 
 // src/curves/rose52.ts
 var FOUR_PI = Math.PI * 4;
 function rose52Fn(phase, _elapsed, _params) {
-  const r = Math.cos((5 / 2) * phase);
+  const r = Math.cos(5 / 2 * phase);
   return {
     x: r * Math.cos(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var rose52 = {
   name: "Rose (n=5/2)",
   fn: rose52Fn,
   period: FOUR_PI,
-  speed: 0.8,
+  speed: 0.8
 };
 
 // src/curves/star.ts
 var TWO_PI11 = Math.PI * 2;
 function starFn(phase, _elapsed, _params) {
-  const r =
-    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));
+  const r = 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(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var star = {
   name: "Star",
   fn: starFn,
   period: TWO_PI11,
-  speed: 1,
+  speed: 1
 };
 
 // src/curves/star4.ts
 var TWO_PI12 = Math.PI * 2;
 function star4Fn(phase, _elapsed, _params) {
-  const r =
-    Math.abs(Math.cos(2 * phase)) +
-    0.35 * Math.abs(Math.cos(6 * phase)) +
-    0.15 * Math.abs(Math.cos(10 * phase));
+  const r = 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(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var star4 = {
   name: "Star (4-arm)",
   fn: star4Fn,
   period: TWO_PI12,
-  speed: 1,
+  speed: 1
 };
 
 // src/curves/star7.ts
 var TWO_PI13 = Math.PI * 2;
 function star7Fn(phase, _elapsed, _params) {
-  const r =
-    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));
+  const r = 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(phase),
-    y: r * Math.sin(phase),
+    y: r * Math.sin(phase)
   };
 }
 var star7 = {
   name: "Star (7-arm)",
   fn: star7Fn,
   period: TWO_PI13,
-  speed: 1,
+  speed: 1
 };
 
 // src/curves/index.ts
@@ -905,7 +862,7 @@ var curves = {
   lissajous32,
   lissajous43,
   epicycloid3,
-  lame,
+  lame
 };
 
 // src/cli.ts
@@ -915,7 +872,7 @@ function usage() {
       "Usage: npx @sarmal/core [options]",
       "",
       "Options:",
-      "  --name <id>    Curve name (e.g. deltoid, rose3). Random if omitted.",
+      "  --curve <id>   Curve name (e.g. deltoid, rose3). Random if omitted.",
       "  --fps <num>    Frame rate (default: 30).",
       "  --speed <num>  Animation speed multiplier (default: curve default).",
       "  --size <num>   Spinner width in characters (default: 16).",
@@ -925,10 +882,10 @@ function usage() {
       "",
       "Examples:",
       "  npx @sarmal/core",
-      "  npx @sarmal/core --name deltoid --verbose",
-      "  npx @sarmal/core --name rose3 --fps 15 --speed 3",
-      "",
-    ].join("\n") + "\n",
+      "  npx @sarmal/core --curve deltoid --verbose",
+      "  npx @sarmal/core --curve rose3 --fps 15 --speed 3",
+      ""
+    ].join("\n") + "\n"
   );
 }
 function matchArg(argv, i, flag) {
@@ -942,7 +899,7 @@ function matchArg(argv, i, flag) {
 }
 function main() {
   const args = process.argv.slice(2);
-  let name;
+  let curveName;
   let verbose = false;
   let fps;
   let speed;
@@ -951,8 +908,8 @@ function main() {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     switch (arg) {
-      case "--name": {
-        name = matchArg(args, i, "--name");
+      case "--curve": {
+        curveName = matchArg(args, i, "--curve");
         i++;
         break;
       }
@@ -1018,14 +975,15 @@ function main() {
   }
   const allCurves = Object.values(curves);
   let curve = allCurves[Math.floor(Math.random() * allCurves.length)];
-  if (name) {
-    const lower = name.toLowerCase();
-    const key = Object.keys(curves).find((k) => k.toLowerCase() === lower);
+  if (curveName) {
+    const availableCurves = Object.keys(curves);
+    const lower = curveName.toLowerCase();
+    const key = availableCurves.find((k) => k.toLowerCase() === lower);
     const found = key ? curves[key] : void 0;
     if (!found) {
       process.stderr.write(
-        `[sarmal] Unknown curve: "${name}". Available: ${Object.keys(curves).join(", ")}
-`,
+        `[sarmal] Unknown curve: "${curveName}". Available: ${availableCurves.join(", ")}
+`
       );
       process.exit(1);
     }
@@ -1037,12 +995,12 @@ function main() {
 `);
   }
   terminalSarmal(process.stdout, curve, {
-    ...(fps !== void 0 ? { fps } : {}),
-    ...(speed !== void 0 ? { speed } : {}),
-    ...(size !== void 0 ? { size } : {}),
-    ...(color !== void 0 ? { trailColor: color } : {}),
+    ...fps !== void 0 ? { fps } : {},
+    ...speed !== void 0 ? { speed } : {},
+    ...size !== void 0 ? { size } : {},
+    ...color !== void 0 ? { trailColor: color } : {}
   });
 }
 main();
 //# sourceMappingURL=cli.js.map
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map