@constela/core 0.20.0 → 0.21.0

package/dist/index.js

@@ -3542,6 +3542,73 @@ function getRadarGridPolygons(cx, cy, radius, sides, levels) {
   }
   return result;
 }
+function getActivityRingArcPath(cx, cy, radius, startAngle, endAngle) {
+  if (typeof cx !== "number" || typeof cy !== "number" || typeof radius !== "number" || typeof startAngle !== "number" || typeof endAngle !== "number") {
+    return "";
+  }
+  const angleDiff = endAngle - startAngle;
+  if (Math.abs(angleDiff) > 2 * Math.PI - 0.01) {
+    const midAngle = startAngle + angleDiff / 2;
+    const x12 = cx + radius * Math.cos(startAngle - Math.PI / 2);
+    const y12 = cy + radius * Math.sin(startAngle - Math.PI / 2);
+    const xMid = cx + radius * Math.cos(midAngle - Math.PI / 2);
+    const yMid = cy + radius * Math.sin(midAngle - Math.PI / 2);
+    const x22 = cx + radius * Math.cos(endAngle - Math.PI / 2);
+    const y22 = cy + radius * Math.sin(endAngle - Math.PI / 2);
+    const halfDiff = angleDiff / 2;
+    const largeArc1 = Math.abs(halfDiff) > Math.PI ? 1 : 0;
+    const largeArc2 = Math.abs(halfDiff) > Math.PI ? 1 : 0;
+    return `M${x12},${y12}A${radius},${radius} 0 ${largeArc1},1 ${xMid},${yMid}A${radius},${radius} 0 ${largeArc2},1 ${x22},${y22}`;
+  }
+  const x1 = cx + radius * Math.cos(startAngle - Math.PI / 2);
+  const y1 = cy + radius * Math.sin(startAngle - Math.PI / 2);
+  const x2 = cx + radius * Math.cos(endAngle - Math.PI / 2);
+  const y2 = cy + radius * Math.sin(endAngle - Math.PI / 2);
+  const largeArcFlag = Math.abs(angleDiff) > Math.PI ? 1 : 0;
+  return `M${x1},${y1}A${radius},${radius} 0 ${largeArcFlag},1 ${x2},${y2}`;
+}
+function getActivityRingLayout(data, valueKey, cx, cy, outerRadius, ringWidth, ringGap) {
+  if (!Array.isArray(data) || data.length === 0) {
+    return [];
+  }
+  if (typeof valueKey !== "string") {
+    return [];
+  }
+  if (typeof cx !== "number" || typeof cy !== "number" || typeof outerRadius !== "number" || typeof ringWidth !== "number" || typeof ringGap !== "number") {
+    return [];
+  }
+  const numOuterRadius = outerRadius;
+  const numRingWidth = ringWidth;
+  const numRingGap = ringGap;
+  const values = data.map((d) => {
+    const v = d[valueKey];
+    return typeof v === "number" ? v : 0;
+  });
+  const max = Math.max(...values);
+  if (max === 0) {
+    return data.map((_, i) => ({
+      radius: numOuterRadius - numRingWidth / 2 - i * (numRingWidth + numRingGap),
+      angle: 0,
+      maxAngle: 2 * Math.PI
+    }));
+  }
+  return data.map((_, i) => ({
+    radius: numOuterRadius - numRingWidth / 2 - i * (numRingWidth + numRingGap),
+    angle: (values[i] ?? 0) / max * 2 * Math.PI,
+    maxAngle: 2 * Math.PI
+  }));
+}
+function getChartDefaultColors(palette) {
+  const palettes = {
+    health: ["#FF3B30", "#FF9500", "#FFCC00", "#34C759", "#007AFF", "#5856D6", "#AF52DE"],
+    activity: ["#FA114F", "#A8FF04", "#00D4FF"],
+    vibrant: ["#FF2D55", "#FF9500", "#5AC8FA", "#007AFF", "#4CD964", "#FF3B30"]
+  };
+  if (typeof palette !== "string" || !(palette in palettes)) {
+    return palettes["health"];
+  }
+  return palettes[palette];
+}
 var GLOBAL_FUNCTIONS = {
   // Date helpers
   getCalendarDays: (year, month) => getCalendarDays(year, month),
@@ -3584,7 +3651,11 @@ var GLOBAL_FUNCTIONS = {
   getRoundedBarPath: (x, y, width, height, radius) => getRoundedBarPath(x, y, width, height, radius),
   getDonutArcPath: (cx, cy, outerR, innerR, startAngle, endAngle) => getDonutArcPath(cx, cy, outerR, innerR, startAngle, endAngle),
   getSliceLabelPosition: (cx, cy, radius, startAngle, endAngle) => getSliceLabelPosition(cx, cy, radius, startAngle, endAngle),
-  getRadarGridPolygons: (cx, cy, radius, sides, levels) => getRadarGridPolygons(cx, cy, radius, sides, levels)
+  getRadarGridPolygons: (cx, cy, radius, sides, levels) => getRadarGridPolygons(cx, cy, radius, sides, levels),
+  // Chart helpers - Activity Ring
+  getActivityRingArcPath: (cx, cy, radius, startAngle, endAngle) => getActivityRingArcPath(cx, cy, radius, startAngle, endAngle),
+  getActivityRingLayout: (data, valueKey, cx, cy, outerRadius, ringWidth, ringGap) => getActivityRingLayout(data, valueKey, cx, cy, outerRadius, ringWidth, ringGap),
+  getChartDefaultColors: (palette) => getChartDefaultColors(palette)
 };
 function callGlobalFunction(method, args) {
   const fn = GLOBAL_FUNCTIONS[method];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/core",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Core types, schema, and validator for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",