@sarmal/core 0.27.0 → 0.28.1

package/dist/renderer-shared-OR--cv-t.d.ts

@@ -1,9 +1,9 @@
-import { P as Point } from "./types-zbxUgcmZ.js";
+import { P as Point } from './types-zbxUgcmZ.js';
 
 interface BoundaryResult {
-  scale: number;
-  offsetX: number;
-  offsetY: number;
+    scale: number;
+    offsetX: number;
+    offsetY: number;
 }
 /**
  * Computes how to map engine coordinates into a viewport of the given logical size.
@@ -14,36 +14,25 @@ interface BoundaryResult {
  * `minPaddingPx` defaults to `FIT_PADDING_MIN` (4px) for pixel-space callers.
  * Pass `0` when the logical space is itself a normalized viewBox (e.g. SVG export).
  */
-declare function computeBoundaries(
-  pts: Point[],
-  logicalWidth: number,
-  logicalHeight: number,
-  minPaddingPx?: number,
-): BoundaryResult | null;
+declare function computeBoundaries(pts: Point[], logicalWidth: number, logicalHeight: number, minPaddingPx?: number): BoundaryResult | null;
 /**
  * Can be passed directly to `trailColor`,
  *  or can be mixed/sliced before passing as a prop.
  */
 declare const palettes: {
-  readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
-  readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
-  readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
-  readonly ice: ["#1e3a8a", "#67e8f9"];
-  readonly fire: ["#7f1d1d", "#fbbf24"];
-  readonly forest: ["#14532d", "#86efac"];
+    readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
+    readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
+    readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
+    readonly ice: ["#1e3a8a", "#67e8f9"];
+    readonly fire: ["#7f1d1d", "#fbbf24"];
+    readonly forest: ["#14532d", "#86efac"];
 };
 type SarmalPalette = keyof typeof palettes;
 /** RGB color components */
 interface Rgb {
-  r: number;
-  g: number;
-  b: number;
+    r: number;
+    g: number;
+    b: number;
 }
 
-export {
-  type BoundaryResult as B,
-  type Rgb as R,
-  type SarmalPalette as S,
-  computeBoundaries as c,
-  palettes as p,
-};
+export { type BoundaryResult as B, type Rgb as R, type SarmalPalette as S, computeBoundaries as c, palettes as p };

package/dist/renderer-shared-jqw_Q1WO.d.cts

@@ -1,9 +1,9 @@
-import { P as Point } from "./types-zbxUgcmZ.cjs";
+import { P as Point } from './types-zbxUgcmZ.cjs';
 
 interface BoundaryResult {
-  scale: number;
-  offsetX: number;
-  offsetY: number;
+    scale: number;
+    offsetX: number;
+    offsetY: number;
 }
 /**
  * Computes how to map engine coordinates into a viewport of the given logical size.
@@ -14,36 +14,25 @@ interface BoundaryResult {
  * `minPaddingPx` defaults to `FIT_PADDING_MIN` (4px) for pixel-space callers.
  * Pass `0` when the logical space is itself a normalized viewBox (e.g. SVG export).
  */
-declare function computeBoundaries(
-  pts: Point[],
-  logicalWidth: number,
-  logicalHeight: number,
-  minPaddingPx?: number,
-): BoundaryResult | null;
+declare function computeBoundaries(pts: Point[], logicalWidth: number, logicalHeight: number, minPaddingPx?: number): BoundaryResult | null;
 /**
  * Can be passed directly to `trailColor`,
  *  or can be mixed/sliced before passing as a prop.
  */
 declare const palettes: {
-  readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
-  readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
-  readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
-  readonly ice: ["#1e3a8a", "#67e8f9"];
-  readonly fire: ["#7f1d1d", "#fbbf24"];
-  readonly forest: ["#14532d", "#86efac"];
+    readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
+    readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
+    readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
+    readonly ice: ["#1e3a8a", "#67e8f9"];
+    readonly fire: ["#7f1d1d", "#fbbf24"];
+    readonly forest: ["#14532d", "#86efac"];
 };
 type SarmalPalette = keyof typeof palettes;
 /** RGB color components */
 interface Rgb {
-  r: number;
-  g: number;
-  b: number;
+    r: number;
+    g: number;
+    b: number;
 }
 
-export {
-  type BoundaryResult as B,
-  type Rgb as R,
-  type SarmalPalette as S,
-  computeBoundaries as c,
-  palettes as p,
-};
+export { type BoundaryResult as B, type Rgb as R, type SarmalPalette as S, computeBoundaries as c, palettes as p };

package/dist/terminal.cjs

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 // src/engine.ts
 var TWO_PI = Math.PI * 2;
@@ -63,13 +63,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);
@@ -110,8 +110,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 {
@@ -138,14 +137,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;
@@ -154,7 +153,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);
@@ -171,16 +170,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;
@@ -193,7 +189,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;
       }
@@ -205,22 +201,19 @@ function createEngine(curveDef, trailLength = 120) {
       const points = 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);
           points[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 points;
       }
       for (let i = 0; i < steps; i++) {
-        const samplePhase = (i / (steps - 1)) * curve.period;
+        const samplePhase = i / (steps - 1) * curve.period;
         points[i] = sampleSkeleton(curve, samplePhase);
       }
       return points;
@@ -262,7 +255,7 @@ function createEngine(curveDef, trailLength = 120) {
         _speedTransition.reject(new Error("Speed transition cancelled"));
         _speedTransition = null;
       }
-    },
+    }
   };
 }
 
@@ -272,10 +265,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;
@@ -294,7 +284,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));
@@ -305,17 +295,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
@@ -329,12 +319,15 @@ var BRAILLE_BIT = [
   [1, 8],
   [2, 16],
   [4, 32],
-  [64, 128],
+  [64, 128]
 ];
 function brailleChar(bits) {
   return String.fromCodePoint(BRAILLE_BASE + (bits & 255));
 }
 function brailleBit(row, col) {
+  if (row < 0 || row >= BRAILLE_BIT.length || col < 0 || col >= (BRAILLE_BIT[0]?.length ?? 0)) {
+    return 0;
+  }
   return BRAILLE_BIT[row][col];
 }
 function dotToCell(dotCol, dotRow) {
@@ -342,7 +335,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() {
@@ -357,13 +350,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);
@@ -373,17 +363,18 @@ 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;
 }
 function dimColor(hex, brightness) {
+  const clamped = Math.max(0, Math.min(1, brightness));
   const c = hexToRgb(hex);
   return {
-    r: Math.round(c.r * brightness),
-    g: Math.round(c.g * brightness),
-    b: Math.round(c.b * brightness),
+    r: Math.max(0, Math.min(255, Math.round(c.r * clamped))),
+    g: Math.max(0, Math.min(255, Math.round(c.g * clamped))),
+    b: Math.max(0, Math.min(255, Math.round(c.b * clamped)))
   };
 }
 var AR = "\x1B[0m";
@@ -408,25 +399,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];
@@ -436,12 +420,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];
@@ -492,11 +471,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);
   }
@@ -504,7 +479,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;
@@ -523,7 +499,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;
@@ -553,7 +530,7 @@ function terminalSarmal(stream, curveDef, options) {
       offsetY,
       trailRgb,
       headRgb,
-      colorCap,
+      colorCap
     );
     if (firstFrame) {
       firstFrame = false;
@@ -590,4 +567,4 @@ exports.dotToCell = dotToCell;
 exports.rgbTo256 = rgbTo256;
 exports.terminalSarmal = terminalSarmal;
 //# sourceMappingURL=terminal.cjs.map
-//# sourceMappingURL=terminal.cjs.map
+//# sourceMappingURL=terminal.cjs.map