@flanksource/clicky-ui 0.3.4 → 0.3.6

package/dist/ai.cjs

@@ -1,14 +1,23 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const sessionCategories = require("./data/ai/session-categories.cjs");
 const ChatFab = require("./data/ai/ChatFab.cjs");
 const ChatWindow = require("./data/ai/ChatWindow.cjs");
 const ChatWindowManager = require("./data/ai/ChatWindowManager.cjs");
 const ContextBadges = require("./data/ai/ContextBadges.cjs");
 const ContextUsage = require("./data/chat/ContextUsage.cjs");
+const SessionViewer = require("./data/ai/SessionViewer.cjs");
 const ThreadPicker = require("./data/ai/ThreadPicker.cjs");
 const ToolPreferences = require("./data/ai/ToolPreferences.cjs");
+const SessionViewer_model = require("./data/ai/SessionViewer.model.cjs");
 const context = require("./data/ai/context.cjs");
 const chatWindowContext = require("./data/ai/chat-window-context.cjs");
+exports.CATEGORY_LABELS = sessionCategories.CATEGORY_LABELS;
+exports.classifyCommand = sessionCategories.classifyCommand;
+exports.classifyToolCategory = sessionCategories.classifyToolCategory;
+exports.collectSessionFilters = sessionCategories.collectSessionFilters;
+exports.eventCategory = sessionCategories.eventCategory;
+exports.isEventVisible = sessionCategories.isEventVisible;
 exports.ChatFab = ChatFab.ChatFab;
 exports.ChatWindow = ChatWindow.ChatWindow;
 exports.ChatWindowLayer = ChatWindow.ChatWindowLayer;
@@ -16,8 +25,14 @@ exports.ChatWindowManagerProvider = ChatWindowManager.ChatWindowManagerProvider;
 exports.ContextBadges = ContextBadges.ContextBadges;
 exports.ContextBadgesReadonly = ContextBadges.ContextBadgesReadonly;
 exports.ContextUsage = ContextUsage.ContextUsage;
+exports.SessionViewer = SessionViewer.SessionViewer;
 exports.ThreadPicker = ThreadPicker.ThreadPicker;
 exports.ToolPreferences = ToolPreferences.ToolPreferences;
+exports.getSessionAction = SessionViewer_model.getSessionAction;
+exports.normalizeSession = SessionViewer_model.normalizeSession;
+exports.splitMcpTool = SessionViewer_model.splitMcpTool;
+exports.summarizeSession = SessionViewer_model.summarizeSession;
+exports.summarizeToolInput = SessionViewer_model.summarizeToolInput;
 exports.makeContextId = context.makeContextId;
 exports.parseContextPrefix = context.parseContextPrefix;
 exports.serializeContext = context.serializeContext;

package/dist/ai.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"ai.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/ai.js

@@ -1,13 +1,17 @@
+import { CATEGORY_LABELS, classifyCommand, classifyToolCategory, collectSessionFilters, eventCategory, isEventVisible } from "./data/ai/session-categories.js";
 import { ChatFab } from "./data/ai/ChatFab.js";
 import { ChatWindow, ChatWindowLayer } from "./data/ai/ChatWindow.js";
 import { ChatWindowManagerProvider } from "./data/ai/ChatWindowManager.js";
 import { ContextBadges, ContextBadgesReadonly } from "./data/ai/ContextBadges.js";
 import { ContextUsage } from "./data/chat/ContextUsage.js";
+import { SessionViewer } from "./data/ai/SessionViewer.js";
 import { ThreadPicker } from "./data/ai/ThreadPicker.js";
 import { ToolPreferences } from "./data/ai/ToolPreferences.js";
+import { getSessionAction, normalizeSession, splitMcpTool, summarizeSession, summarizeToolInput } from "./data/ai/SessionViewer.model.js";
 import { makeContextId, parseContextPrefix, serializeContext } from "./data/ai/context.js";
 import { nextPromptId, useChatWindowManager } from "./data/ai/chat-window-context.js";
 export {
+  CATEGORY_LABELS,
   ChatFab,
   ChatWindow,
   ChatWindowLayer,
@@ -15,12 +19,23 @@ export {
   ContextBadges,
   ContextBadgesReadonly,
   ContextUsage,
+  SessionViewer,
   ThreadPicker,
   ToolPreferences,
+  classifyCommand,
+  classifyToolCategory,
+  collectSessionFilters,
+  eventCategory,
+  getSessionAction,
+  isEventVisible,
   makeContextId,
   nextPromptId,
+  normalizeSession,
   parseContextPrefix,
   serializeContext,
+  splitMcpTool,
+  summarizeSession,
+  summarizeToolInput,
   useChatWindowManager
 };
 //# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"ai.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/data/ProgressBars.cjs

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const utils = require("../lib/utils.cjs");
+const Icon = require("./Icon.cjs");
+const ProgressBars_model = require("./ProgressBars.model.cjs");
+const GaugeHoverCard = require("./GaugeHoverCard.cjs");
+function toneClass(pct, [warn, danger]) {
+  if (pct >= danger) return "bg-red-500";
+  if (pct >= warn) return "bg-amber-500";
+  return "bg-emerald-500";
+}
+function ProgressBarsIcon({ icon }) {
+  if (typeof icon === "string") {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      Icon.Icon,
+      {
+        name: icon,
+        width: 14,
+        height: 14,
+        className: "text-muted-foreground"
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    Icon.Icon,
+    {
+      icon,
+      width: 14,
+      height: 14,
+      className: "text-muted-foreground"
+    }
+  );
+}
+function defaultFormatUnits(units) {
+  return Number.isInteger(units) ? String(units) : units.toFixed(1);
+}
+function ProgressBars({
+  usage,
+  max,
+  unit,
+  title,
+  icon,
+  thresholds = [75, 90],
+  variant = "default",
+  showLabel = true,
+  showValue = true,
+  showCapacity = false,
+  orientation,
+  stats,
+  hoverCard = true,
+  hoverFooter,
+  className
+}) {
+  const perBar = (unit == null ? void 0 : unit.perBar) ?? 1e3;
+  const unitLabel = (unit == null ? void 0 : unit.label) ?? "cores";
+  const barLabel = (unit == null ? void 0 : unit.barLabel) ?? "core";
+  const formatUnits = (unit == null ? void 0 : unit.format) ?? defaultFormatUnits;
+  const model = ProgressBars_model.deriveProgressBars(usage, max, perBar);
+  const tone = toneClass(model.pct, thresholds);
+  const usageText = formatUnits(model.usageUnits);
+  const capacityText = model.limitUnits !== void 0 ? formatUnits(model.limitUnits) : "?";
+  const caption = !model.hasUsage ? "—" : showCapacity ? `${usageText} / ${capacityText} ${unitLabel}` : `${usageText} ${unitLabel}`;
+  const compactCaption = !model.hasUsage ? "—" : showCapacity ? `${usageText}/${capacityText} ${unitLabel}` : `${usageText} ${unitLabel}`;
+  const titleText = `${title}: ${compactCaption}`;
+  const isCell = variant === "cell";
+  const pctTone = model.limitUnits === void 0 ? void 0 : model.pct >= thresholds[1] ? "text-red-500" : model.pct >= thresholds[0] ? "text-amber-500" : "text-emerald-500";
+  const fmt = (n) => `${formatUnits(n)} ${unitLabel}`;
+  const hoverRows = model.hasUsage ? [
+    { label: "Current", value: fmt(model.usageUnits), ...pctTone ? { tone: pctTone } : {} },
+    ...stats ? [
+      { label: "Min", value: fmt(stats.min / perBar) },
+      { label: "Max", value: fmt(stats.max / perBar) },
+      { label: "Avg", value: fmt(stats.avg / perBar) }
+    ] : [],
+    ...model.limitUnits !== void 0 ? [{ label: "Capacity", value: fmt(model.limitUnits) }] : []
+  ] : [];
+  const resolvedOrientation = orientation ?? "vertical";
+  const isDense = model.barCount > 4;
+  const valueText = isCell ? compactCaption : caption;
+  const hiddenAccessibleText = !showLabel || !showValue ? titleText : void 0;
+  const bars = /* @__PURE__ */ jsxRuntime.jsx(
+    "span",
+    {
+      className: utils.cn(
+        "flex shrink-0",
+        resolvedOrientation === "vertical" ? utils.cn("items-end", isCell ? "h-4 gap-px" : "h-10 gap-0.5") : utils.cn(
+          "flex-col justify-center",
+          isCell ? "h-4 w-10 gap-px" : "h-10 w-16 gap-0.5"
+        )
+      ),
+      "aria-hidden": isCell ? "true" : void 0,
+      "data-orientation": resolvedOrientation,
+      "data-bar-count": model.barCount,
+      "data-bar-density": isDense ? "compact" : "default",
+      children: model.bars.map((bar, i) => {
+        const barPct = Math.round(bar.fill * 100);
+        return /* @__PURE__ */ jsxRuntime.jsx(
+          "span",
+          {
+            className: utils.cn(
+              "relative overflow-hidden bg-muted",
+              resolvedOrientation === "vertical" ? utils.cn(
+                "h-full",
+                isCell ? isDense ? "w-[3px] rounded-[2px]" : "w-1.5 rounded-[2px]" : isDense ? "w-1 rounded-sm" : "w-2 rounded-sm"
+              ) : utils.cn("min-h-px w-full flex-1 rounded-[2px]")
+            ),
+            title: `${barLabel} ${i + 1}: ${barPct}%`,
+            "aria-label": !isCell ? `${barLabel} ${i + 1}: ${barPct}%` : void 0,
+            "data-fill": bar.fill,
+            children: /* @__PURE__ */ jsxRuntime.jsx(
+              "span",
+              {
+                className: utils.cn(
+                  "absolute bottom-0 left-0 transition-all duration-300",
+                  tone
+                ),
+                style: resolvedOrientation === "vertical" ? { height: `${barPct}%`, right: 0 } : { width: `${barPct}%`, top: 0 }
+              }
+            )
+          },
+          i
+        );
+      })
+    }
+  );
+  const valueNode = showValue ? /* @__PURE__ */ jsxRuntime.jsx(
+    "span",
+    {
+      className: utils.cn(
+        "shrink-0 font-semibold tabular-nums text-foreground",
+        isCell ? null : "text-xs"
+      ),
+      children: valueText
+    }
+  ) : null;
+  const label = icon || showLabel ? /* @__PURE__ */ jsxRuntime.jsxs(
+    "span",
+    {
+      className: utils.cn(
+        "inline-flex min-w-0 items-center gap-1 text-xs text-muted-foreground"
+      ),
+      children: [
+        icon ? /* @__PURE__ */ jsxRuntime.jsx(ProgressBarsIcon, { icon }) : null,
+        showLabel ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 truncate", children: title }) : null
+      ]
+    }
+  ) : null;
+  const useHover = hoverCard && hoverRows.length > 0;
+  if (isCell) {
+    const cell = /* @__PURE__ */ jsxRuntime.jsxs(
+      "span",
+      {
+        className: utils.cn(
+          "inline-flex min-w-0 items-center gap-1.5 whitespace-nowrap align-middle text-xs",
+          className
+        ),
+        ...useHover ? {} : { title: titleText },
+        "aria-label": useHover ? titleText : hiddenAccessibleText,
+        children: [
+          label,
+          bars,
+          valueNode
+        ]
+      }
+    );
+    return useHover ? /* @__PURE__ */ jsxRuntime.jsx(GaugeHoverCard.GaugeHoverCard, { title, rows: hoverRows, footer: hoverFooter, trigger: cell }) : cell;
+  }
+  const block = /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: utils.cn("flex flex-col items-center gap-1", className),
+      ...useHover ? {} : { title: hiddenAccessibleText },
+      "aria-label": useHover ? titleText : hiddenAccessibleText,
+      children: [
+        bars,
+        valueNode,
+        label
+      ]
+    }
+  );
+  return useHover ? /* @__PURE__ */ jsxRuntime.jsx(
+    GaugeHoverCard.GaugeHoverCard,
+    {
+      title,
+      rows: hoverRows,
+      footer: hoverFooter,
+      trigger: block,
+      className: "w-full justify-center"
+    }
+  ) : block;
+}
+exports.ProgressBars = ProgressBars;
+//# sourceMappingURL=ProgressBars.cjs.map

package/dist/data/ProgressBars.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBars.cjs","sources":["../../src/data/ProgressBars.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport { deriveProgressBars } from \"./ProgressBars.model\";\nimport { GaugeHoverCard, type GaugeHoverRow } from \"./GaugeHoverCard\";\n\nexport type ProgressBarsVariant = \"default\" | \"cell\";\nexport type ProgressBarsOrientation = \"horizontal\" | \"vertical\";\n\n/**\n * Describes what one bar represents, letting the same component render CPU cores,\n * memory gigabytes, or any other quantised capacity. Defaults model CPU cores.\n */\nexport interface ProgressBarsUnit {\n  /** Raw value that fills one bar, in the domain of `usage`/`max`. Default 1000 (millicores → 1 core). */\n  perBar?: number;\n  /** Caption/tooltip suffix naming the unit, plural. Default \"cores\". */\n  label?: string;\n  /** Per-bar hover tooltip noun, singular. Default \"core\". */\n  barLabel?: string;\n  /** Format a bar-unit count for the caption. Default: integers as-is, else 1 decimal. */\n  format?: (units: number) => string;\n}\n\n/** Summary statistics for the hover card, in the same domain as `usage`/`max`. */\nexport interface ProgressBarsStats {\n  /** Smallest value over the window. */\n  min: number;\n  /** Largest value over the window. */\n  max: number;\n  /** Mean value over the window. */\n  avg: number;\n}\n\nexport interface ProgressBarsProps {\n  /** Usage that fills the bars, in the raw domain (e.g. CPU millicores). */\n  usage: number | undefined;\n  /**\n   * The capacity, in the same raw domain as `usage`. Determines the number of\n   * bars (one per `unit.perBar`). When omitted or 0, the bar count falls back to\n   * the ceiling of the usage so an unbounded reading still renders.\n   */\n  max?: number;\n  /** What one bar represents. Defaults to CPU cores (perBar 1000, label \"cores\"). */\n  unit?: ProgressBarsUnit;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Utilisation thresholds (percent of capacity) at which the fill turns amber\n   * then red. Defaults to [75, 90].\n   */\n  thresholds?: [warning: number, danger: number];\n  /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */\n  variant?: ProgressBarsVariant;\n  /** Show the title text. Icons and values remain visible unless separately hidden. */\n  showLabel?: boolean;\n  /** Show the value/capacity caption. Icons and bars remain visible when false. */\n  showValue?: boolean;\n  /**\n   * Include the capacity in the caption (\"2.3 / 4 cores\"). Defaults to false — the\n   * caption shows only the current value (\"2.3 cores\") since the bars already\n   * convey capacity. Set true to append the \"/ <capacity>\".\n   */\n  showCapacity?: boolean;\n  /** Bar direction. Vertical bars fill bottom-up; horizontal bars fill left-to-right. */\n  orientation?: ProgressBarsOrientation;\n  /**\n   * Summary stats for the hover card's Min/Max/Avg rows, in the SAME raw domain as\n   * `usage`/`max` (NOT divided by perBar). Pass null to omit those rows.\n   */\n  stats?: ProgressBarsStats | null;\n  /**\n   * Wrap the bars in a hover card summarising the metric (label + current / min /\n   * max / avg / capacity). Defaults to true.\n   */\n  hoverCard?: boolean;\n  /** Footer note in the hover card, e.g. the look-back window (\"over last 1h\"). */\n  hoverFooter?: ReactNode;\n  className?: string;\n}\n\nfunction toneClass(pct: number, [warn, danger]: [number, number]): string {\n  if (pct >= danger) return \"bg-red-500\";\n  if (pct >= warn) return \"bg-amber-500\";\n  return \"bg-emerald-500\";\n}\n\nfunction ProgressBarsIcon({ icon }: { icon: string | StaticIconComponent }) {\n  if (typeof icon === \"string\") {\n    return (\n      <Icon\n        name={icon}\n        width={14}\n        height={14}\n        className=\"text-muted-foreground\"\n      />\n    );\n  }\n  return (\n    <Icon\n      icon={icon}\n      width={14}\n      height={14}\n      className=\"text-muted-foreground\"\n    />\n  );\n}\n\nfunction defaultFormatUnits(units: number): string {\n  return Number.isInteger(units) ? String(units) : units.toFixed(1);\n}\n\n/**\n * ProgressBars renders quantised utilisation as a row of bars — one bar per unit\n * of capacity (the ceiling of the limit) — filled left to right by the usage. The\n * bar that straddles the usage boundary is partially filled (\"blocked out\") to\n * show the fractional unit in use, and the trailing bars stay empty to show\n * headroom; the bar colour crosses warning and danger thresholds. A \"<used> /\n * <capacity>\" caption sits below with the icon+title. It is purely presentational\n * — pass plain `usage`/`max` numbers (TimeseriesCoreBars wraps it with live data).\n */\nexport function ProgressBars({\n  usage,\n  max,\n  unit,\n  title,\n  icon,\n  thresholds = [75, 90],\n  variant = \"default\",\n  showLabel = true,\n  showValue = true,\n  showCapacity = false,\n  orientation,\n  stats,\n  hoverCard = true,\n  hoverFooter,\n  className,\n}: ProgressBarsProps) {\n  const perBar = unit?.perBar ?? 1000;\n  const unitLabel = unit?.label ?? \"cores\";\n  const barLabel = unit?.barLabel ?? \"core\";\n  const formatUnits = unit?.format ?? defaultFormatUnits;\n\n  const model = deriveProgressBars(usage, max, perBar);\n  const tone = toneClass(model.pct, thresholds);\n  const usageText = formatUnits(model.usageUnits);\n  const capacityText =\n    model.limitUnits !== undefined ? formatUnits(model.limitUnits) : \"?\";\n  const caption = !model.hasUsage\n    ? \"—\"\n    : showCapacity\n      ? `${usageText} / ${capacityText} ${unitLabel}`\n      : `${usageText} ${unitLabel}`;\n  const compactCaption = !model.hasUsage\n    ? \"—\"\n    : showCapacity\n      ? `${usageText}/${capacityText} ${unitLabel}`\n      : `${usageText} ${unitLabel}`;\n  const titleText = `${title}: ${compactCaption}`;\n  const isCell = variant === \"cell\";\n\n  // Hover card: surface current/min/max/avg/capacity in bar-units (stats are in\n  // the raw domain, so divide by perBar) so they read in the same unit as the\n  // caption. A bounded reading colours the current row by its threshold.\n  const pctTone =\n    model.limitUnits === undefined\n      ? undefined\n      : model.pct >= thresholds[1]\n        ? \"text-red-500\"\n        : model.pct >= thresholds[0]\n          ? \"text-amber-500\"\n          : \"text-emerald-500\";\n  const fmt = (n: number) => `${formatUnits(n)} ${unitLabel}`;\n  const hoverRows: GaugeHoverRow[] = model.hasUsage\n    ? [\n        { label: \"Current\", value: fmt(model.usageUnits), ...(pctTone ? { tone: pctTone } : {}) },\n        ...(stats\n          ? [\n              { label: \"Min\", value: fmt(stats.min / perBar) },\n              { label: \"Max\", value: fmt(stats.max / perBar) },\n              { label: \"Avg\", value: fmt(stats.avg / perBar) },\n            ]\n          : []),\n        ...(model.limitUnits !== undefined\n          ? [{ label: \"Capacity\", value: fmt(model.limitUnits) }]\n          : []),\n      ]\n    : [];\n\n  const resolvedOrientation = orientation ?? \"vertical\";\n  const isDense = model.barCount > 4;\n  const valueText = isCell ? compactCaption : caption;\n  const hiddenAccessibleText = !showLabel || !showValue ? titleText : undefined;\n  const bars = (\n    <span\n      className={cn(\n        \"flex shrink-0\",\n        resolvedOrientation === \"vertical\"\n          ? cn(\"items-end\", isCell ? \"h-4 gap-px\" : \"h-10 gap-0.5\")\n          : cn(\n              \"flex-col justify-center\",\n              isCell ? \"h-4 w-10 gap-px\" : \"h-10 w-16 gap-0.5\",\n            ),\n      )}\n      aria-hidden={isCell ? \"true\" : undefined}\n      data-orientation={resolvedOrientation}\n      data-bar-count={model.barCount}\n      data-bar-density={isDense ? \"compact\" : \"default\"}\n    >\n      {model.bars.map((bar, i) => {\n        const barPct = Math.round(bar.fill * 100);\n        return (\n          <span\n            key={i}\n            className={cn(\n              \"relative overflow-hidden bg-muted\",\n              resolvedOrientation === \"vertical\"\n                ? cn(\n                    \"h-full\",\n                    isCell\n                      ? isDense\n                        ? \"w-[3px] rounded-[2px]\"\n                        : \"w-1.5 rounded-[2px]\"\n                      : isDense\n                        ? \"w-1 rounded-sm\"\n                        : \"w-2 rounded-sm\",\n                  )\n                : cn(\"min-h-px w-full flex-1 rounded-[2px]\"),\n            )}\n            title={`${barLabel} ${i + 1}: ${barPct}%`}\n            aria-label={!isCell ? `${barLabel} ${i + 1}: ${barPct}%` : undefined}\n            data-fill={bar.fill}\n          >\n            <span\n              className={cn(\n                \"absolute bottom-0 left-0 transition-all duration-300\",\n                tone,\n              )}\n              style={\n                resolvedOrientation === \"vertical\"\n                  ? { height: `${barPct}%`, right: 0 }\n                  : { width: `${barPct}%`, top: 0 }\n              }\n            />\n          </span>\n        );\n      })}\n    </span>\n  );\n  const valueNode = showValue ? (\n    <span\n      className={cn(\n        \"shrink-0 font-semibold tabular-nums text-foreground\",\n        isCell ? null : \"text-xs\",\n      )}\n    >\n      {valueText}\n    </span>\n  ) : null;\n  const label =\n    icon || showLabel ? (\n      <span\n        className={cn(\n          \"inline-flex min-w-0 items-center gap-1 text-xs text-muted-foreground\",\n        )}\n      >\n        {icon ? <ProgressBarsIcon icon={icon} /> : null}\n        {showLabel ? <span className=\"min-w-0 truncate\">{title}</span> : null}\n      </span>\n    ) : null;\n\n  const useHover = hoverCard && hoverRows.length > 0;\n\n  if (isCell) {\n    const cell = (\n      <span\n        className={cn(\n          \"inline-flex min-w-0 items-center gap-1.5 whitespace-nowrap align-middle text-xs\",\n          className,\n        )}\n        {...(useHover ? {} : { title: titleText })}\n        aria-label={useHover ? titleText : hiddenAccessibleText}\n      >\n        {label}\n        {bars}\n        {valueNode}\n      </span>\n    );\n    return useHover ? (\n      <GaugeHoverCard title={title} rows={hoverRows} footer={hoverFooter} trigger={cell} />\n    ) : (\n      cell\n    );\n  }\n\n  const block = (\n    <div\n      className={cn(\"flex flex-col items-center gap-1\", className)}\n      {...(useHover ? {} : { title: hiddenAccessibleText })}\n      aria-label={useHover ? titleText : hiddenAccessibleText}\n    >\n      {bars}\n      {valueNode}\n      {label}\n    </div>\n  );\n  return useHover ? (\n    <GaugeHoverCard\n      title={title}\n      rows={hoverRows}\n      footer={hoverFooter}\n      trigger={block}\n      className=\"w-full justify-center\"\n    />\n  ) : (\n    block\n  );\n}\n"],"names":["jsx","Icon","deriveProgressBars","cn","jsxs","GaugeHoverCard"],"mappings":"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"}

package/dist/data/ProgressBars.d.ts

@@ -0,0 +1,85 @@
+import { ReactNode } from 'react';
+import { StaticIconComponent } from './Icon';
+export type ProgressBarsVariant = "default" | "cell";
+export type ProgressBarsOrientation = "horizontal" | "vertical";
+/**
+ * Describes what one bar represents, letting the same component render CPU cores,
+ * memory gigabytes, or any other quantised capacity. Defaults model CPU cores.
+ */
+export interface ProgressBarsUnit {
+    /** Raw value that fills one bar, in the domain of `usage`/`max`. Default 1000 (millicores → 1 core). */
+    perBar?: number;
+    /** Caption/tooltip suffix naming the unit, plural. Default "cores". */
+    label?: string;
+    /** Per-bar hover tooltip noun, singular. Default "core". */
+    barLabel?: string;
+    /** Format a bar-unit count for the caption. Default: integers as-is, else 1 decimal. */
+    format?: (units: number) => string;
+}
+/** Summary statistics for the hover card, in the same domain as `usage`/`max`. */
+export interface ProgressBarsStats {
+    /** Smallest value over the window. */
+    min: number;
+    /** Largest value over the window. */
+    max: number;
+    /** Mean value over the window. */
+    avg: number;
+}
+export interface ProgressBarsProps {
+    /** Usage that fills the bars, in the raw domain (e.g. CPU millicores). */
+    usage: number | undefined;
+    /**
+     * The capacity, in the same raw domain as `usage`. Determines the number of
+     * bars (one per `unit.perBar`). When omitted or 0, the bar count falls back to
+     * the ceiling of the usage so an unbounded reading still renders.
+     */
+    max?: number;
+    /** What one bar represents. Defaults to CPU cores (perBar 1000, label "cores"). */
+    unit?: ProgressBarsUnit;
+    title: string;
+    /** Iconify name or static icon component shown beside the label. */
+    icon?: string | StaticIconComponent;
+    /**
+     * Utilisation thresholds (percent of capacity) at which the fill turns amber
+     * then red. Defaults to [75, 90].
+     */
+    thresholds?: [warning: number, danger: number];
+    /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */
+    variant?: ProgressBarsVariant;
+    /** Show the title text. Icons and values remain visible unless separately hidden. */
+    showLabel?: boolean;
+    /** Show the value/capacity caption. Icons and bars remain visible when false. */
+    showValue?: boolean;
+    /**
+     * Include the capacity in the caption ("2.3 / 4 cores"). Defaults to false — the
+     * caption shows only the current value ("2.3 cores") since the bars already
+     * convey capacity. Set true to append the "/ <capacity>".
+     */
+    showCapacity?: boolean;
+    /** Bar direction. Vertical bars fill bottom-up; horizontal bars fill left-to-right. */
+    orientation?: ProgressBarsOrientation;
+    /**
+     * Summary stats for the hover card's Min/Max/Avg rows, in the SAME raw domain as
+     * `usage`/`max` (NOT divided by perBar). Pass null to omit those rows.
+     */
+    stats?: ProgressBarsStats | null;
+    /**
+     * Wrap the bars in a hover card summarising the metric (label + current / min /
+     * max / avg / capacity). Defaults to true.
+     */
+    hoverCard?: boolean;
+    /** Footer note in the hover card, e.g. the look-back window ("over last 1h"). */
+    hoverFooter?: ReactNode;
+    className?: string;
+}
+/**
+ * ProgressBars renders quantised utilisation as a row of bars — one bar per unit
+ * of capacity (the ceiling of the limit) — filled left to right by the usage. The
+ * bar that straddles the usage boundary is partially filled ("blocked out") to
+ * show the fractional unit in use, and the trailing bars stay empty to show
+ * headroom; the bar colour crosses warning and danger thresholds. A "<used> /
+ * <capacity>" caption sits below with the icon+title. It is purely presentational
+ * — pass plain `usage`/`max` numbers (TimeseriesCoreBars wraps it with live data).
+ */
+export declare function ProgressBars({ usage, max, unit, title, icon, thresholds, variant, showLabel, showValue, showCapacity, orientation, stats, hoverCard, hoverFooter, className, }: ProgressBarsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ProgressBars.d.ts.map

package/dist/data/ProgressBars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBars.d.ts","sourceRoot":"","sources":["../../src/data/ProgressBars.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAQ,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAIxD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,UAAU,CAAC;AAEhE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,mFAAmF;IACnF,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uFAAuF;IACvF,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,UAAqB,EACrB,OAAmB,EACnB,SAAgB,EAChB,SAAgB,EAChB,YAAoB,EACpB,WAAW,EACX,KAAK,EACL,SAAgB,EAChB,WAAW,EACX,SAAS,GACV,EAAE,iBAAiB,2CAoLnB"}

package/dist/data/ProgressBars.js

@@ -0,0 +1,194 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cn } from "../lib/utils.js";
+import { Icon } from "./Icon.js";
+import { deriveProgressBars } from "./ProgressBars.model.js";
+import { GaugeHoverCard } from "./GaugeHoverCard.js";
+function toneClass(pct, [warn, danger]) {
+  if (pct >= danger) return "bg-red-500";
+  if (pct >= warn) return "bg-amber-500";
+  return "bg-emerald-500";
+}
+function ProgressBarsIcon({ icon }) {
+  if (typeof icon === "string") {
+    return /* @__PURE__ */ jsx(
+      Icon,
+      {
+        name: icon,
+        width: 14,
+        height: 14,
+        className: "text-muted-foreground"
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    Icon,
+    {
+      icon,
+      width: 14,
+      height: 14,
+      className: "text-muted-foreground"
+    }
+  );
+}
+function defaultFormatUnits(units) {
+  return Number.isInteger(units) ? String(units) : units.toFixed(1);
+}
+function ProgressBars({
+  usage,
+  max,
+  unit,
+  title,
+  icon,
+  thresholds = [75, 90],
+  variant = "default",
+  showLabel = true,
+  showValue = true,
+  showCapacity = false,
+  orientation,
+  stats,
+  hoverCard = true,
+  hoverFooter,
+  className
+}) {
+  const perBar = (unit == null ? void 0 : unit.perBar) ?? 1e3;
+  const unitLabel = (unit == null ? void 0 : unit.label) ?? "cores";
+  const barLabel = (unit == null ? void 0 : unit.barLabel) ?? "core";
+  const formatUnits = (unit == null ? void 0 : unit.format) ?? defaultFormatUnits;
+  const model = deriveProgressBars(usage, max, perBar);
+  const tone = toneClass(model.pct, thresholds);
+  const usageText = formatUnits(model.usageUnits);
+  const capacityText = model.limitUnits !== void 0 ? formatUnits(model.limitUnits) : "?";
+  const caption = !model.hasUsage ? "—" : showCapacity ? `${usageText} / ${capacityText} ${unitLabel}` : `${usageText} ${unitLabel}`;
+  const compactCaption = !model.hasUsage ? "—" : showCapacity ? `${usageText}/${capacityText} ${unitLabel}` : `${usageText} ${unitLabel}`;
+  const titleText = `${title}: ${compactCaption}`;
+  const isCell = variant === "cell";
+  const pctTone = model.limitUnits === void 0 ? void 0 : model.pct >= thresholds[1] ? "text-red-500" : model.pct >= thresholds[0] ? "text-amber-500" : "text-emerald-500";
+  const fmt = (n) => `${formatUnits(n)} ${unitLabel}`;
+  const hoverRows = model.hasUsage ? [
+    { label: "Current", value: fmt(model.usageUnits), ...pctTone ? { tone: pctTone } : {} },
+    ...stats ? [
+      { label: "Min", value: fmt(stats.min / perBar) },
+      { label: "Max", value: fmt(stats.max / perBar) },
+      { label: "Avg", value: fmt(stats.avg / perBar) }
+    ] : [],
+    ...model.limitUnits !== void 0 ? [{ label: "Capacity", value: fmt(model.limitUnits) }] : []
+  ] : [];
+  const resolvedOrientation = orientation ?? "vertical";
+  const isDense = model.barCount > 4;
+  const valueText = isCell ? compactCaption : caption;
+  const hiddenAccessibleText = !showLabel || !showValue ? titleText : void 0;
+  const bars = /* @__PURE__ */ jsx(
+    "span",
+    {
+      className: cn(
+        "flex shrink-0",
+        resolvedOrientation === "vertical" ? cn("items-end", isCell ? "h-4 gap-px" : "h-10 gap-0.5") : cn(
+          "flex-col justify-center",
+          isCell ? "h-4 w-10 gap-px" : "h-10 w-16 gap-0.5"
+        )
+      ),
+      "aria-hidden": isCell ? "true" : void 0,
+      "data-orientation": resolvedOrientation,
+      "data-bar-count": model.barCount,
+      "data-bar-density": isDense ? "compact" : "default",
+      children: model.bars.map((bar, i) => {
+        const barPct = Math.round(bar.fill * 100);
+        return /* @__PURE__ */ jsx(
+          "span",
+          {
+            className: cn(
+              "relative overflow-hidden bg-muted",
+              resolvedOrientation === "vertical" ? cn(
+                "h-full",
+                isCell ? isDense ? "w-[3px] rounded-[2px]" : "w-1.5 rounded-[2px]" : isDense ? "w-1 rounded-sm" : "w-2 rounded-sm"
+              ) : cn("min-h-px w-full flex-1 rounded-[2px]")
+            ),
+            title: `${barLabel} ${i + 1}: ${barPct}%`,
+            "aria-label": !isCell ? `${barLabel} ${i + 1}: ${barPct}%` : void 0,
+            "data-fill": bar.fill,
+            children: /* @__PURE__ */ jsx(
+              "span",
+              {
+                className: cn(
+                  "absolute bottom-0 left-0 transition-all duration-300",
+                  tone
+                ),
+                style: resolvedOrientation === "vertical" ? { height: `${barPct}%`, right: 0 } : { width: `${barPct}%`, top: 0 }
+              }
+            )
+          },
+          i
+        );
+      })
+    }
+  );
+  const valueNode = showValue ? /* @__PURE__ */ jsx(
+    "span",
+    {
+      className: cn(
+        "shrink-0 font-semibold tabular-nums text-foreground",
+        isCell ? null : "text-xs"
+      ),
+      children: valueText
+    }
+  ) : null;
+  const label = icon || showLabel ? /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: cn(
+        "inline-flex min-w-0 items-center gap-1 text-xs text-muted-foreground"
+      ),
+      children: [
+        icon ? /* @__PURE__ */ jsx(ProgressBarsIcon, { icon }) : null,
+        showLabel ? /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate", children: title }) : null
+      ]
+    }
+  ) : null;
+  const useHover = hoverCard && hoverRows.length > 0;
+  if (isCell) {
+    const cell = /* @__PURE__ */ jsxs(
+      "span",
+      {
+        className: cn(
+          "inline-flex min-w-0 items-center gap-1.5 whitespace-nowrap align-middle text-xs",
+          className
+        ),
+        ...useHover ? {} : { title: titleText },
+        "aria-label": useHover ? titleText : hiddenAccessibleText,
+        children: [
+          label,
+          bars,
+          valueNode
+        ]
+      }
+    );
+    return useHover ? /* @__PURE__ */ jsx(GaugeHoverCard, { title, rows: hoverRows, footer: hoverFooter, trigger: cell }) : cell;
+  }
+  const block = /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn("flex flex-col items-center gap-1", className),
+      ...useHover ? {} : { title: hiddenAccessibleText },
+      "aria-label": useHover ? titleText : hiddenAccessibleText,
+      children: [
+        bars,
+        valueNode,
+        label
+      ]
+    }
+  );
+  return useHover ? /* @__PURE__ */ jsx(
+    GaugeHoverCard,
+    {
+      title,
+      rows: hoverRows,
+      footer: hoverFooter,
+      trigger: block,
+      className: "w-full justify-center"
+    }
+  ) : block;
+}
+export {
+  ProgressBars
+};
+//# sourceMappingURL=ProgressBars.js.map

package/dist/data/ProgressBars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBars.js","sources":["../../src/data/ProgressBars.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport { deriveProgressBars } from \"./ProgressBars.model\";\nimport { GaugeHoverCard, type GaugeHoverRow } from \"./GaugeHoverCard\";\n\nexport type ProgressBarsVariant = \"default\" | \"cell\";\nexport type ProgressBarsOrientation = \"horizontal\" | \"vertical\";\n\n/**\n * Describes what one bar represents, letting the same component render CPU cores,\n * memory gigabytes, or any other quantised capacity. Defaults model CPU cores.\n */\nexport interface ProgressBarsUnit {\n  /** Raw value that fills one bar, in the domain of `usage`/`max`. Default 1000 (millicores → 1 core). */\n  perBar?: number;\n  /** Caption/tooltip suffix naming the unit, plural. Default \"cores\". */\n  label?: string;\n  /** Per-bar hover tooltip noun, singular. Default \"core\". */\n  barLabel?: string;\n  /** Format a bar-unit count for the caption. Default: integers as-is, else 1 decimal. */\n  format?: (units: number) => string;\n}\n\n/** Summary statistics for the hover card, in the same domain as `usage`/`max`. */\nexport interface ProgressBarsStats {\n  /** Smallest value over the window. */\n  min: number;\n  /** Largest value over the window. */\n  max: number;\n  /** Mean value over the window. */\n  avg: number;\n}\n\nexport interface ProgressBarsProps {\n  /** Usage that fills the bars, in the raw domain (e.g. CPU millicores). */\n  usage: number | undefined;\n  /**\n   * The capacity, in the same raw domain as `usage`. Determines the number of\n   * bars (one per `unit.perBar`). When omitted or 0, the bar count falls back to\n   * the ceiling of the usage so an unbounded reading still renders.\n   */\n  max?: number;\n  /** What one bar represents. Defaults to CPU cores (perBar 1000, label \"cores\"). */\n  unit?: ProgressBarsUnit;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Utilisation thresholds (percent of capacity) at which the fill turns amber\n   * then red. Defaults to [75, 90].\n   */\n  thresholds?: [warning: number, danger: number];\n  /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */\n  variant?: ProgressBarsVariant;\n  /** Show the title text. Icons and values remain visible unless separately hidden. */\n  showLabel?: boolean;\n  /** Show the value/capacity caption. Icons and bars remain visible when false. */\n  showValue?: boolean;\n  /**\n   * Include the capacity in the caption (\"2.3 / 4 cores\"). Defaults to false — the\n   * caption shows only the current value (\"2.3 cores\") since the bars already\n   * convey capacity. Set true to append the \"/ <capacity>\".\n   */\n  showCapacity?: boolean;\n  /** Bar direction. Vertical bars fill bottom-up; horizontal bars fill left-to-right. */\n  orientation?: ProgressBarsOrientation;\n  /**\n   * Summary stats for the hover card's Min/Max/Avg rows, in the SAME raw domain as\n   * `usage`/`max` (NOT divided by perBar). Pass null to omit those rows.\n   */\n  stats?: ProgressBarsStats | null;\n  /**\n   * Wrap the bars in a hover card summarising the metric (label + current / min /\n   * max / avg / capacity). Defaults to true.\n   */\n  hoverCard?: boolean;\n  /** Footer note in the hover card, e.g. the look-back window (\"over last 1h\"). */\n  hoverFooter?: ReactNode;\n  className?: string;\n}\n\nfunction toneClass(pct: number, [warn, danger]: [number, number]): string {\n  if (pct >= danger) return \"bg-red-500\";\n  if (pct >= warn) return \"bg-amber-500\";\n  return \"bg-emerald-500\";\n}\n\nfunction ProgressBarsIcon({ icon }: { icon: string | StaticIconComponent }) {\n  if (typeof icon === \"string\") {\n    return (\n      <Icon\n        name={icon}\n        width={14}\n        height={14}\n        className=\"text-muted-foreground\"\n      />\n    );\n  }\n  return (\n    <Icon\n      icon={icon}\n      width={14}\n      height={14}\n      className=\"text-muted-foreground\"\n    />\n  );\n}\n\nfunction defaultFormatUnits(units: number): string {\n  return Number.isInteger(units) ? String(units) : units.toFixed(1);\n}\n\n/**\n * ProgressBars renders quantised utilisation as a row of bars — one bar per unit\n * of capacity (the ceiling of the limit) — filled left to right by the usage. The\n * bar that straddles the usage boundary is partially filled (\"blocked out\") to\n * show the fractional unit in use, and the trailing bars stay empty to show\n * headroom; the bar colour crosses warning and danger thresholds. A \"<used> /\n * <capacity>\" caption sits below with the icon+title. It is purely presentational\n * — pass plain `usage`/`max` numbers (TimeseriesCoreBars wraps it with live data).\n */\nexport function ProgressBars({\n  usage,\n  max,\n  unit,\n  title,\n  icon,\n  thresholds = [75, 90],\n  variant = \"default\",\n  showLabel = true,\n  showValue = true,\n  showCapacity = false,\n  orientation,\n  stats,\n  hoverCard = true,\n  hoverFooter,\n  className,\n}: ProgressBarsProps) {\n  const perBar = unit?.perBar ?? 1000;\n  const unitLabel = unit?.label ?? \"cores\";\n  const barLabel = unit?.barLabel ?? \"core\";\n  const formatUnits = unit?.format ?? defaultFormatUnits;\n\n  const model = deriveProgressBars(usage, max, perBar);\n  const tone = toneClass(model.pct, thresholds);\n  const usageText = formatUnits(model.usageUnits);\n  const capacityText =\n    model.limitUnits !== undefined ? formatUnits(model.limitUnits) : \"?\";\n  const caption = !model.hasUsage\n    ? \"—\"\n    : showCapacity\n      ? `${usageText} / ${capacityText} ${unitLabel}`\n      : `${usageText} ${unitLabel}`;\n  const compactCaption = !model.hasUsage\n    ? \"—\"\n    : showCapacity\n      ? `${usageText}/${capacityText} ${unitLabel}`\n      : `${usageText} ${unitLabel}`;\n  const titleText = `${title}: ${compactCaption}`;\n  const isCell = variant === \"cell\";\n\n  // Hover card: surface current/min/max/avg/capacity in bar-units (stats are in\n  // the raw domain, so divide by perBar) so they read in the same unit as the\n  // caption. A bounded reading colours the current row by its threshold.\n  const pctTone =\n    model.limitUnits === undefined\n      ? undefined\n      : model.pct >= thresholds[1]\n        ? \"text-red-500\"\n        : model.pct >= thresholds[0]\n          ? \"text-amber-500\"\n          : \"text-emerald-500\";\n  const fmt = (n: number) => `${formatUnits(n)} ${unitLabel}`;\n  const hoverRows: GaugeHoverRow[] = model.hasUsage\n    ? [\n        { label: \"Current\", value: fmt(model.usageUnits), ...(pctTone ? { tone: pctTone } : {}) },\n        ...(stats\n          ? [\n              { label: \"Min\", value: fmt(stats.min / perBar) },\n              { label: \"Max\", value: fmt(stats.max / perBar) },\n              { label: \"Avg\", value: fmt(stats.avg / perBar) },\n            ]\n          : []),\n        ...(model.limitUnits !== undefined\n          ? [{ label: \"Capacity\", value: fmt(model.limitUnits) }]\n          : []),\n      ]\n    : [];\n\n  const resolvedOrientation = orientation ?? \"vertical\";\n  const isDense = model.barCount > 4;\n  const valueText = isCell ? compactCaption : caption;\n  const hiddenAccessibleText = !showLabel || !showValue ? titleText : undefined;\n  const bars = (\n    <span\n      className={cn(\n        \"flex shrink-0\",\n        resolvedOrientation === \"vertical\"\n          ? cn(\"items-end\", isCell ? \"h-4 gap-px\" : \"h-10 gap-0.5\")\n          : cn(\n              \"flex-col justify-center\",\n              isCell ? \"h-4 w-10 gap-px\" : \"h-10 w-16 gap-0.5\",\n            ),\n      )}\n      aria-hidden={isCell ? \"true\" : undefined}\n      data-orientation={resolvedOrientation}\n      data-bar-count={model.barCount}\n      data-bar-density={isDense ? \"compact\" : \"default\"}\n    >\n      {model.bars.map((bar, i) => {\n        const barPct = Math.round(bar.fill * 100);\n        return (\n          <span\n            key={i}\n            className={cn(\n              \"relative overflow-hidden bg-muted\",\n              resolvedOrientation === \"vertical\"\n                ? cn(\n                    \"h-full\",\n                    isCell\n                      ? isDense\n                        ? \"w-[3px] rounded-[2px]\"\n                        : \"w-1.5 rounded-[2px]\"\n                      : isDense\n                        ? \"w-1 rounded-sm\"\n                        : \"w-2 rounded-sm\",\n                  )\n                : cn(\"min-h-px w-full flex-1 rounded-[2px]\"),\n            )}\n            title={`${barLabel} ${i + 1}: ${barPct}%`}\n            aria-label={!isCell ? `${barLabel} ${i + 1}: ${barPct}%` : undefined}\n            data-fill={bar.fill}\n          >\n            <span\n              className={cn(\n                \"absolute bottom-0 left-0 transition-all duration-300\",\n                tone,\n              )}\n              style={\n                resolvedOrientation === \"vertical\"\n                  ? { height: `${barPct}%`, right: 0 }\n                  : { width: `${barPct}%`, top: 0 }\n              }\n            />\n          </span>\n        );\n      })}\n    </span>\n  );\n  const valueNode = showValue ? (\n    <span\n      className={cn(\n        \"shrink-0 font-semibold tabular-nums text-foreground\",\n        isCell ? null : \"text-xs\",\n      )}\n    >\n      {valueText}\n    </span>\n  ) : null;\n  const label =\n    icon || showLabel ? (\n      <span\n        className={cn(\n          \"inline-flex min-w-0 items-center gap-1 text-xs text-muted-foreground\",\n        )}\n      >\n        {icon ? <ProgressBarsIcon icon={icon} /> : null}\n        {showLabel ? <span className=\"min-w-0 truncate\">{title}</span> : null}\n      </span>\n    ) : null;\n\n  const useHover = hoverCard && hoverRows.length > 0;\n\n  if (isCell) {\n    const cell = (\n      <span\n        className={cn(\n          \"inline-flex min-w-0 items-center gap-1.5 whitespace-nowrap align-middle text-xs\",\n          className,\n        )}\n        {...(useHover ? {} : { title: titleText })}\n        aria-label={useHover ? titleText : hiddenAccessibleText}\n      >\n        {label}\n        {bars}\n        {valueNode}\n      </span>\n    );\n    return useHover ? (\n      <GaugeHoverCard title={title} rows={hoverRows} footer={hoverFooter} trigger={cell} />\n    ) : (\n      cell\n    );\n  }\n\n  const block = (\n    <div\n      className={cn(\"flex flex-col items-center gap-1\", className)}\n      {...(useHover ? {} : { title: hiddenAccessibleText })}\n      aria-label={useHover ? titleText : hiddenAccessibleText}\n    >\n      {bars}\n      {valueNode}\n      {label}\n    </div>\n  );\n  return useHover ? (\n    <GaugeHoverCard\n      title={title}\n      rows={hoverRows}\n      footer={hoverFooter}\n      trigger={block}\n      className=\"w-full justify-center\"\n    />\n  ) : (\n    block\n  );\n}\n"],"names":[],"mappings":"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"}