@sarmal/core 0.20.0 → 0.23.0

package/dist/index.d.cts

@@ -6,14 +6,14 @@ import {
   R as RendererOptions,
   P as Point,
   a as SarmalOptions,
-} from "./types-frtEoAq6.cjs";
+} from "./types-C0b4MPtI.cjs";
 export {
   J as JumpOptions,
   b as RuntimeRenderOptions,
   c as SeekOptions,
   T as TrailColor,
   d as TrailStyle,
-} from "./types-frtEoAq6.cjs";
+} from "./types-C0b4MPtI.cjs";
 export { CurveName, curves } from "./curves/index.cjs";
 export { artemis2 } from "./curves/artemis2.cjs";
 export { astroid } from "./curves/astroid.cjs";

package/dist/index.d.ts

@@ -6,14 +6,14 @@ import {
   R as RendererOptions,
   P as Point,
   a as SarmalOptions,
-} from "./types-frtEoAq6.js";
+} from "./types-C0b4MPtI.js";
 export {
   J as JumpOptions,
   b as RuntimeRenderOptions,
   c as SeekOptions,
   T as TrailColor,
   d as TrailStyle,
-} from "./types-frtEoAq6.js";
+} from "./types-C0b4MPtI.js";
 export { CurveName, curves } from "./curves/index.js";
 export { artemis2 } from "./curves/artemis2.js";
 export { astroid } from "./curves/astroid.js";

package/dist/index.js

@@ -426,6 +426,7 @@ var RENDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "headColor",
   "skeletonColor",
   "trailStyle",
+  "headRadius",
 ]);
 function validateRenderOptions(partial) {
   for (const key of Object.keys(partial)) {
@@ -445,6 +446,9 @@ function validateRenderOptions(partial) {
   if (partial.trailStyle !== void 0) {
     assertTrailStyle(partial.trailStyle);
   }
+  if (partial.headRadius !== void 0) {
+    assertHeadRadius(partial.headRadius);
+  }
 }
 function assertTrailColor(value) {
   if (typeof value === "string") {
@@ -502,6 +506,18 @@ function assertTrailStyle(value) {
     );
   }
 }
+function assertHeadRadius(value) {
+  if (typeof value !== "number") {
+    throw new TypeError(
+      `[sarmal] setRenderOptions: headRadius must be a number, got ${JSON.stringify(value)}`,
+    );
+  }
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new TypeError(
+      `[sarmal] setRenderOptions: headRadius must be a finite positive number, got ${value}`,
+    );
+  }
+}
 function resolveTrailMainColor(trailColor) {
   return typeof trailColor === "string" ? trailColor : trailColor[0];
 }
@@ -530,9 +546,9 @@ function warnIfTrailColorMismatch(trailColor, trailStyle) {
     );
   }
 }
-var getHeadDotRadius = (w, h) => Math.max(1, 3 * Math.sqrt(Math.min(w, h) / 160));
 
 // src/renderer.ts
+var getHeadDotRadius = (w, h) => Math.max(1, 3 * Math.sqrt(Math.min(w, h) / 160));
 var WHITE_HEX = "#ffffff";
 function hexToRgbComponents(hex) {
   const n = parseInt(hex.slice(1), 16);
@@ -569,6 +585,7 @@ function createRenderer(options) {
   setupCanvas();
   let logicalWidth = canvas.width / dpr;
   let logicalHeight = canvas.height / dpr;
+  let headRadius = options.headRadius ?? getHeadDotRadius(logicalWidth, logicalHeight);
   let skeleton = [];
   let skeletonCanvas = null;
   let trail = [];
@@ -685,7 +702,7 @@ function createRenderer(options) {
     }
     const x = head.x * scale + offsetX;
     const y = head.y * scale + offsetY;
-    const r = options.headRadius ?? getHeadDotRadius(logicalWidth, logicalHeight);
+    const r = headRadius;
     ctx.fillStyle = headColor;
     ctx.beginPath();
     ctx.arc(x, y, r, 0, Math.PI * 2);
@@ -814,6 +831,9 @@ function createRenderer(options) {
       if (partial.headColor !== void 0) {
         userHeadColor = partial.headColor;
       }
+      if (partial.headRadius !== void 0) {
+        headRadius = partial.headRadius;
+      }
       if (userHeadColor === null) {
         headColor = resolveHeadColor(trailColor, trailStyle);
       } else {
@@ -832,6 +852,8 @@ function createRenderer(options) {
 
 // src/renderer-svg.ts
 var EMPTY_PARAMS2 = {};
+var SVG_DEFAULT_HEAD_RADIUS = 0.5;
+var SKELETON_STROKE_WIDTH_PX = 1.5;
 var HIGH_TRAIL_LENGTH_THRESHOLD = 5e3;
 function pointsToPathString(pts, scale, offsetX, offsetY) {
   if (pts.length < 2) {
@@ -871,15 +893,21 @@ function createSVGRenderer(options) {
   let skeletonColor = options.skeletonColor ?? "#ffffff";
   let userHeadColor = options.headColor ?? null;
   let headColor = userHeadColor ?? resolveHeadColor(trailColor, trailStyle);
+  let headRadius;
   let trailSolid = resolveTrailMainColor(trailColor);
   let trailPalette = resolveTrailPalette(trailColor);
   const ariaLabel = options.ariaLabel ?? "Loading";
   warnIfTrailColorMismatch(trailColor, trailStyle);
   const viewSize = 100;
-  const headRadius = options.headRadius ?? 1.5;
-  const svgTrailMinWidth = 0.25;
-  const svgTrailMaxWidth = 1.25;
-  const svgSkeletonStrokeWidth = "0.75";
+  function getContainerPixelSize() {
+    const rect = container.getBoundingClientRect();
+    return rect.width && rect.height ? Math.min(rect.width, rect.height) : 200;
+  }
+  const containerPx = getContainerPixelSize();
+  const svgTrailMinWidth = (TRAIL_MIN_WIDTH * viewSize) / containerPx;
+  const svgTrailMaxWidth = (TRAIL_MAX_WIDTH * viewSize) / containerPx;
+  const svgSkeletonStrokeWidth = String((SKELETON_STROKE_WIDTH_PX * viewSize) / containerPx);
+  headRadius = options.headRadius ?? SVG_DEFAULT_HEAD_RADIUS;
   container.setAttribute("viewBox", `0 0 ${viewSize} ${viewSize}`);
   container.setAttribute("role", "img");
   container.setAttribute("aria-label", ariaLabel);
@@ -1152,6 +1180,10 @@ function createSVGRenderer(options) {
       if (partial.headColor !== void 0) {
         userHeadColor = partial.headColor;
       }
+      if (partial.headRadius !== void 0) {
+        headRadius = partial.headRadius;
+        headCircle.setAttribute("r", String(headRadius));
+      }
       if (userHeadColor === null) {
         headColor = resolveHeadColor(trailColor, trailStyle);
       } else {