@sarmal/core 0.31.0 → 0.34.0

package/README.md

@@ -46,8 +46,8 @@ import { createSarmal, rose3 } from "@sarmal/core";
 const canvas = document.getElementById("my-canvas");
 const sarmal = createSarmal(canvas, rose3, {
   trailLength: 30,
-  strokeStyle: "#00ffaa",
-  lineWidth: 2,
+  trailColor: "#00ffaa",
+  trailWidth: 2,
 });
 
 sarmal.start();

package/dist/auto-init.cjs

@@ -513,7 +513,8 @@ var RENDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "headColor",
   "skeletonColor",
   "trailStyle",
-  "headRadius"
+  "headRadius",
+  "trailWidth"
 ]);
 function validateRenderOptions(partial) {
   for (const key of Object.keys(partial)) {
@@ -536,6 +537,9 @@ function validateRenderOptions(partial) {
   if (partial.headRadius !== void 0) {
     assertHeadRadius(partial.headRadius);
   }
+  if (partial.trailWidth !== void 0) {
+    assertTrailWidth(partial.trailWidth);
+  }
 }
 function assertTrailColor(value) {
   if (typeof value === "string") {
@@ -605,6 +609,18 @@ function assertHeadRadius(value) {
     );
   }
 }
+function assertTrailWidth(value) {
+  if (typeof value !== "number") {
+    throw new TypeError(
+      `[sarmal] setRenderOptions: trailWidth must be a number, got ${JSON.stringify(value)}`
+    );
+  }
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new TypeError(
+      `[sarmal] setRenderOptions: trailWidth must be a finite positive number, got ${value}`
+    );
+  }
+}
 function resolveTrailMainColor(trailColor) {
   return typeof trailColor === "string" ? trailColor : trailColor[0];
 }
@@ -673,7 +689,14 @@ function createRenderer(options) {
   setupCanvas();
   let logicalWidth = canvas.width / dpr;
   let logicalHeight = canvas.height / dpr;
+  if (options.headRadius !== void 0) {
+    validateRenderOptions({ headRadius: options.headRadius });
+  }
+  if (options.trailWidth !== void 0) {
+    validateRenderOptions({ trailWidth: options.trailWidth });
+  }
   let headRadius = options.headRadius ?? getHeadDotRadius(logicalWidth, logicalHeight);
+  let trailWidth = options.trailWidth ?? 1;
   let skeleton = [];
   let skeletonCanvas = null;
   let trail = [];
@@ -767,7 +790,9 @@ function createRenderer(options) {
         i,
         trailCount,
         toX,
-        toY
+        toY,
+        TRAIL_MIN_WIDTH * trailWidth,
+        TRAIL_MAX_WIDTH * trailWidth
       );
       if (trailStyle === "default") {
         ctx.fillStyle = `rgba(${trailSolidRgb},${opacity})`;
@@ -925,6 +950,9 @@ function createRenderer(options) {
       if (partial.headRadius !== void 0) {
         headRadius = partial.headRadius;
       }
+      if (partial.trailWidth !== void 0) {
+        trailWidth = partial.trailWidth;
+      }
       if (userHeadColor === null) {
         headColor = resolveHeadColor(trailColor, trailStyle);
       } else {
@@ -1023,7 +1051,14 @@ function createSVGRenderer(options) {
   const svgTrailMinWidth = TRAIL_MIN_WIDTH * viewSize / containerPx;
   const svgTrailMaxWidth = TRAIL_MAX_WIDTH * viewSize / containerPx;
   const svgSkeletonStrokeWidth = String(SKELETON_STROKE_WIDTH_PX * viewSize / containerPx);
+  if (options.headRadius !== void 0) {
+    validateRenderOptions({ headRadius: options.headRadius });
+  }
+  if (options.trailWidth !== void 0) {
+    validateRenderOptions({ trailWidth: options.trailWidth });
+  }
   headRadius = options.headRadius ?? SVG_DEFAULT_HEAD_RADIUS;
+  let trailWidth = options.trailWidth ?? 1;
   container.setAttribute("viewBox", `0 0 ${viewSize} ${viewSize}`);
   container.setAttribute("role", "img");
   container.setAttribute("aria-label", ariaLabel);
@@ -1118,8 +1153,8 @@ function createSVGRenderer(options) {
         trailCount,
         px,
         py,
-        svgTrailMinWidth,
-        svgTrailMaxWidth
+        svgTrailMinWidth * trailWidth,
+        svgTrailMaxWidth * trailWidth
       );
       const d = `M${l0x.toFixed(2)} ${l0y.toFixed(2)} L${l1x.toFixed(2)} ${l1y.toFixed(2)} L${r1x.toFixed(2)} ${r1y.toFixed(2)} L${r0x.toFixed(2)} ${r0y.toFixed(2)} Z`;
       trailPaths[i].setAttribute("d", d);
@@ -1311,6 +1346,9 @@ function createSVGRenderer(options) {
         headRadius = partial.headRadius;
         headCircle.setAttribute("r", String(headRadius));
       }
+      if (partial.trailWidth !== void 0) {
+        trailWidth = partial.trailWidth;
+      }
       if (userHeadColor === null) {
         headColor = resolveHeadColor(trailColor, trailStyle);
       } else {