@sarmal/core 0.35.1 → 0.36.0

package/dist/curves/index.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 export { artemis2 } from './artemis2.js';
 export { astroid } from './astroid.js';
 export { deltoid } from './deltoid.js';

package/dist/curves/lame.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Lamé curve (superellipse) with time-varying exponent

package/dist/curves/lame.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Lamé curve (superellipse) with time-varying exponent

package/dist/curves/lissajous32.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Lissajous curve with frequency ratio 3:2

package/dist/curves/lissajous32.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Lissajous curve with frequency ratio 3:2

package/dist/curves/lissajous43.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Lissajous curve with frequency ratio 4:3

package/dist/curves/lissajous43.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Lissajous curve with frequency ratio 4:3

package/dist/curves/rose3.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Rose curve with 3 petals

package/dist/curves/rose3.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Rose curve with 3 petals

package/dist/curves/rose5.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Rose curve with 5 petals

package/dist/curves/rose5.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Rose curve with 5 petals

package/dist/curves/rose52.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * Rose curve with n=5/2 that traces 5 petals over two full revolutions

package/dist/curves/rose52.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * Rose curve with n=5/2 that traces 5 petals over two full revolutions

package/dist/curves/star.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * 5-pointed star based on Fourier harmonics.

package/dist/curves/star.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * 5-pointed star based on Fourier harmonics.

package/dist/curves/star4.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * 4-pointed star based on Fourier harmonics.

package/dist/curves/star4.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * 4-pointed star based on Fourier harmonics.

package/dist/curves/star7.d.cts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.cjs';
+import { C as CurveDef } from '../types-CCgSK31t.cjs';
 
 /**
  * 7-pointed star based on Fourier harmonics.

package/dist/curves/star7.d.ts

@@ -1,4 +1,4 @@
-import { C as CurveDef } from '../types-_f27GDkU.js';
+import { C as CurveDef } from '../types-CCgSK31t.js';
 
 /**
  * 7-pointed star based on Fourier harmonics.

package/dist/index.cjs

@@ -322,7 +322,9 @@ function computeTrailQuad(trail, i, trailCount, toX, toY, minWidth = TRAIL_MIN_W
   };
 }
 function computeBoundaries(pts, logicalWidth, logicalHeight, minPaddingPx = FIT_PADDING_MIN) {
-  if (pts.length === 0) return null;
+  if (pts.length === 0) {
+    return null;
+  }
   const first = pts[0];
   let minX = first.x, maxX = first.x, minY = first.y, maxY = first.y;
   for (const p of pts) {
@@ -520,7 +522,11 @@ function getPaletteColor(palette, position, timeOffset = 0) {
   return lerpOklab(c1, c2, t);
 }
 var TRAIL_STYLES = ["default", "gradient-static", "gradient-animated"];
-var BASE_RENDER_OPTION_KEYS = /* @__PURE__ */ new Set(["trailColor", "trailStyle"]);
+var BASE_RENDER_OPTION_KEYS = /* @__PURE__ */ new Set([
+  "trailColor",
+  "trailStyle",
+  "skeletonColor"
+]);
 var RENDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "trailColor",
   "headColor",
@@ -541,6 +547,9 @@ function validateBaseRenderOptions(partial) {
   if (partial.trailStyle !== void 0) {
     assertTrailStyle(partial.trailStyle);
   }
+  if (partial.skeletonColor !== void 0) {
+    assertSkeletonColor(partial.skeletonColor);
+  }
 }
 function validateRenderOptions(partial) {
   for (const key of Object.keys(partial)) {
@@ -1426,6 +1435,7 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
     trailLength: trailLengthOpt,
     trailColor: initialColor = "#ffffff",
     trailStyle: initialTrailStyle = "default",
+    skeletonColor: skeletonColorOpt = "#ffffff",
     autoStart = true,
     pauseOnHidden: pauseOnHiddenOpt = true,
     initialPhase
@@ -1456,6 +1466,8 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
   let pixelMaskCoverages = new Float32Array(0);
   let bgImageData = null;
   let frameImageData = null;
+  let skeletonColorOklab = null;
+  const skeletonDotGrid = new Uint8Array(cols * rows);
   let animationId = null;
   let lastTime = 0;
   let pausedByVisibility = false;
@@ -1540,6 +1552,53 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
       colorRgb = colorToRgb(color);
     }
   }
+  function applySkeletonColor(color) {
+    skeletonColorOklab = color === "transparent" ? null : parseColorToOklab(color);
+  }
+  function computeSkeletonGrid(skel) {
+    skeletonDotGrid.fill(0);
+    const count = skel.length;
+    for (let i = 0; i < count; i++) {
+      const pt = skel[i];
+      const [c, r] = mapPt(pt.x, pt.y);
+      skeletonDotGrid[r * cols + c] = 1;
+      if (i < count - 1) {
+        const next = skel[i + 1];
+        const [nc, nr] = mapPt(next.x, next.y);
+        const steps = Math.ceil(Math.max(Math.abs(nc - c), Math.abs(nr - r))) * 2;
+        for (let s = 1; s < steps; s++) {
+          const t = s / steps;
+          const ix = pt.x + (next.x - pt.x) * t;
+          const iy = pt.y + (next.y - pt.y) * t;
+          const [ic, ir] = mapPt(ix, iy);
+          skeletonDotGrid[ir * cols + ic] = 1;
+        }
+      }
+    }
+  }
+  function writeSkeletonPixels(data) {
+    if (skeletonColorOklab === null) {
+      return;
+    }
+    const { r, g, b } = oklabToRgb(skeletonColorOklab);
+    const skelBaseAlpha = DEFAULT_SKELETON_OPACITY * 255;
+    const n = cols * rows;
+    for (let dotIdx = 0; dotIdx < n; dotIdx++) {
+      if (!skeletonDotGrid[dotIdx]) {
+        continue;
+      }
+      const start = pixelMaskStarts[dotIdx];
+      const len = pixelMaskLengths[dotIdx];
+      for (let k = 0; k < len; k++) {
+        const px = pixelMaskIndices[start + k];
+        const coverage = pixelMaskCoverages[start + k];
+        data[px] = r;
+        data[px + 1] = g;
+        data[px + 2] = b;
+        data[px + 3] = Math.round(skelBaseAlpha * coverage);
+      }
+    }
+  }
   function calculateBoundaries(skel) {
     const b = computeBoundaries(skel, W, H);
     if (b) {
@@ -1592,6 +1651,7 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
     }
     frameImageData.data.set(bgImageData.data);
     const { data } = frameImageData;
+    writeSkeletonPixels(data);
     const timeOffset = currentTrailStyle === "gradient-animated" ? animTime / ANIM_PERIOD : 0;
     const n = cols * rows;
     for (let dotIdx = 0; dotIdx < n; dotIdx++) {
@@ -1635,8 +1695,10 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
         completeMorphNow();
         calculateBoundaries(engine.getSarmalSkeleton());
       }
+      computeSkeletonGrid(engine.getSarmalSkeleton());
     } else if (engine.isLiveSkeleton) {
       calculateBoundaries(engine.getSarmalSkeleton());
+      computeSkeletonGrid(engine.getSarmalSkeleton());
     }
     if (currentTrailStyle === "gradient-animated") {
       animTime += deltaTime;
@@ -1650,10 +1712,12 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
     renderFrame(deltaTime);
     animationId = requestAnimationFrame(loop);
   }
-  validateBaseRenderOptions({ trailColor: initialColor });
+  validateBaseRenderOptions({ trailColor: initialColor, skeletonColor: skeletonColorOpt });
   applyColor(initialColor);
+  applySkeletonColor(skeletonColorOpt);
   calculateBoundaries(engine.getSarmalSkeleton());
   computePixelMask();
+  computeSkeletonGrid(engine.getSarmalSkeleton());
   frameImageData = new ImageData(W, H);
   buildBgImageData();
   if (initialPhase !== void 0) {
@@ -1663,13 +1727,17 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
   const instance = {
     /** Starts the animation loop. Does nothing if already running. */
     play() {
-      if (animationId !== null) return;
+      if (animationId !== null) {
+        return;
+      }
       lastTime = performance.now();
       loop();
     },
     /** Pauses the animation loop. Preserves current trail state. */
     pause() {
-      if (animationId === null) return;
+      if (animationId === null) {
+        return;
+      }
       cancelAnimationFrame(animationId);
       animationId = null;
       engine.cancelSpeedTransition();
@@ -1713,8 +1781,8 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
     /**
      * Updates render options on a live instance without stopping the animation.
      *
-     * Supported: `trailColor` and `trailStyle`.
-     * ! Unsupported fields (`headColor`, `skeletonColor`, `headRadius`, `trailWidth`) throw.
+     * Supported: `trailColor`, `trailStyle`, and `skeletonColor`.
+     * ! Unsupported fields (`headColor`, `headRadius`, `trailWidth`) throw.
      * ! Validation fails the entire call if any field is invalid, leaving options unchanged.
      */
     setRenderOptions(partial) {
@@ -1724,6 +1792,9 @@ function createSarmalDotMatrix(canvas, curveDef, options) {
         applyColor(partial.trailColor);
         needsRebuildBg = true;
       }
+      if (partial.skeletonColor !== void 0) {
+        applySkeletonColor(partial.skeletonColor);
+      }
       if (partial.trailStyle !== void 0) {
         currentTrailStyle = partial.trailStyle;
         if (currentTrailStyle === "default") {