@flanksource/clicky-ui 0.3.1 → 0.3.3

package/dist/data/TimeseriesCoreBars.js.map

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesCoreBars.js","sources":["../../src/data/TimeseriesCoreBars.tsx"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport type { GaugeSeries } from \"./TimeseriesGauge\";\nimport type { TimeseriesResponse } from \"./TimeseriesPanel\";\nimport { deriveCoreBars } from \"./TimeseriesCoreBars.model\";\n\nexport type TimeseriesCoreBarsVariant = \"default\" | \"cell\";\nexport type TimeseriesCoreBarsOrientation = \"horizontal\" | \"vertical\";\n\nexport interface TimeseriesCoreBarsProps {\n  /** Common prefix; the value/max requests are `baseUrl + id`. */\n  baseUrl?: string;\n  /** The metric whose latest value (CPU millicores) fills the bars. */\n  value: GaugeSeries;\n  /**\n   * The CPU capacity. Either a `.limit`-style metric series (its latest value in\n   * millicores) or a fixed number of millicores. Determines the number of bars\n   * (one per core). When omitted or 0, the bar count falls back to the ceiling of\n   * the usage in cores so an unbounded reading still renders.\n   */\n  max?: GaugeSeries | number;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /** Look-back window passed as ?since=; defaults to \"1h\". */\n  range?: string;\n  /** Poll interval in ms; defaults to 5000. Pass 0 to disable polling. */\n  refreshMs?: number;\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?: TimeseriesCoreBarsVariant;\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  /** Bar direction. Vertical bars fill bottom-up; horizontal bars fill left-to-right. */\n  orientation?: TimeseriesCoreBarsOrientation;\n  /** Override the default fetch (e.g. to route through an app's API client). */\n  fetcher?: (url: string) => Promise<TimeseriesResponse>;\n  className?: string;\n}\n\nconst defaultFetcher = async (url: string): Promise<TimeseriesResponse> => {\n  const res = await fetch(url);\n  if (!res.ok) throw new Error(`metrics request failed: ${res.status}`);\n  return res.json();\n};\n\nfunction latestValue(resp: TimeseriesResponse | undefined): number | undefined {\n  const points = resp?.points;\n  if (!points || points.length === 0) return undefined;\n  return points[points.length - 1]?.value;\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 CoreBarsIcon({ 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 formatCores(cores: number): string {\n  return Number.isInteger(cores) ? String(cores) : cores.toFixed(1);\n}\n\n/**\n * TimeseriesCoreBars renders CPU utilisation as a row of vertical bars — one bar\n * per core (the ceiling of the CPU limit) — filled left to right by the latest\n * usage. The bar that straddles the usage boundary is partially filled (\"blocked\n * out\") to show the fractional core in use, and the trailing bars stay empty to\n * show headroom. Both usage and limit are read live from the timeseries store,\n * mirroring TimeseriesGauge's data plumbing; the bar colour crosses warning and\n * danger thresholds. A \"<used> / <cores>\" caption sits below with the icon+title.\n */\nexport function TimeseriesCoreBars({\n  baseUrl = \"\",\n  value,\n  max,\n  title,\n  icon,\n  range = \"1h\",\n  refreshMs = 5000,\n  thresholds = [75, 90],\n  variant = \"default\",\n  showLabel = true,\n  showValue = true,\n  orientation,\n  fetcher = defaultFetcher,\n  className,\n}: TimeseriesCoreBarsProps) {\n  const maxIsSeries = typeof max === \"object\";\n  const maxSeries = maxIsSeries ? max : undefined;\n  const ids = useMemo(() => {\n    const list = [value.id];\n    if (maxSeries) list.push(maxSeries.id);\n    return list;\n  }, [value.id, maxSeries]);\n\n  const results = useQueries({\n    queries: ids.map((id) => {\n      const u = new URL(baseUrl + id, window.location.origin);\n      if (range) u.searchParams.set(\"since\", range);\n      const requestUrl = u.pathname + u.search;\n      return {\n        queryKey: [\"timeseries\", requestUrl],\n        queryFn: () => fetcher(requestUrl),\n        refetchInterval: refreshMs > 0 ? refreshMs : false,\n        staleTime: 0,\n        retry: 0,\n      };\n    }),\n  });\n\n  const rawValue = latestValue(results[0]?.data);\n  const usage =\n    rawValue === undefined\n      ? undefined\n      : value.transform\n        ? value.transform(rawValue)\n        : rawValue;\n\n  let limit: number | undefined;\n  if (typeof max === \"number\") {\n    limit = max;\n  } else if (maxSeries) {\n    const rawMax = latestValue(results[1]?.data);\n    limit =\n      rawMax === undefined\n        ? undefined\n        : maxSeries.transform\n          ? maxSeries.transform(rawMax)\n          : rawMax;\n  }\n\n  const model = deriveCoreBars(usage, limit);\n  const tone = toneClass(model.pct, thresholds);\n  const caption = model.hasUsage\n    ? `${formatCores(model.usageCores)} / ${model.limitCores !== undefined ? formatCores(model.limitCores) : \"?\"} cores`\n    : \"—\";\n  const compactCaption = model.hasUsage\n    ? `${formatCores(model.usageCores)}/${model.limitCores !== undefined ? formatCores(model.limitCores) : \"?\"} cores`\n    : \"—\";\n  const titleText = `${title}: ${compactCaption}`;\n  const isCell = variant === \"cell\";\n  const resolvedOrientation = orientation ?? \"vertical\";\n  const isDense = model.coreCount > 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-core-count={model.coreCount}\n      data-core-density={isDense ? \"compact\" : \"default\"}\n    >\n      {model.bars.map((bar, i) => {\n        const corePct = 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={`core ${i + 1}: ${corePct}%`}\n            aria-label={!isCell ? `core ${i + 1}: ${corePct}%` : 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: `${corePct}%`, right: 0 }\n                  : { width: `${corePct}%`, 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 ? <CoreBarsIcon icon={icon} /> : null}\n        {showLabel ? <span className=\"min-w-0 truncate\">{title}</span> : null}\n      </span>\n    ) : null;\n\n  if (isCell) {\n    return (\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        title={titleText}\n        aria-label={hiddenAccessibleText}\n      >\n        {label}\n        {bars}\n        {valueNode}\n      </span>\n    );\n  }\n\n  return (\n    <div\n      className={cn(\"flex flex-col items-center gap-1\", className)}\n      title={hiddenAccessibleText}\n      aria-label={hiddenAccessibleText}\n    >\n      {bars}\n      {valueNode}\n      {label}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"TimeseriesCoreBars.js","sources":["../../src/data/TimeseriesCoreBars.tsx"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport type { GaugeSeries } from \"./TimeseriesGauge\";\nimport type { TimeseriesResponse } from \"./TimeseriesPanel\";\nimport { deriveCoreBars } from \"./TimeseriesCoreBars.model\";\nimport { GaugeHoverCard, type GaugeHoverRow } from \"./GaugeHoverCard\";\nimport { seriesStats } from \"./gauge-stats\";\n\nexport type TimeseriesCoreBarsVariant = \"default\" | \"cell\";\nexport type TimeseriesCoreBarsOrientation = \"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 CoreBarsUnit {\n  /** Raw value that fills one bar, in the domain of `value`/`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\nexport interface TimeseriesCoreBarsProps {\n  /** Common prefix; the value/max requests are `baseUrl + id`. */\n  baseUrl?: string;\n  /** The metric whose latest value (CPU millicores) fills the bars. */\n  value: GaugeSeries;\n  /**\n   * The capacity. Either a `.limit`-style metric series (its latest value) or a\n   * fixed number, in the same raw domain as `value`. 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?: GaugeSeries | number;\n  /** What one bar represents. Defaults to CPU cores (perBar 1000, label \"cores\"). */\n  unit?: CoreBarsUnit;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /** Look-back window passed as ?since=; defaults to \"1h\". */\n  range?: string;\n  /** Poll interval in ms; defaults to 5000. Pass 0 to disable polling. */\n  refreshMs?: number;\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?: TimeseriesCoreBarsVariant;\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?: TimeseriesCoreBarsOrientation;\n  /**\n   * Wrap the bars in a hover card summarising the metric (label + current / min /\n   * max / avg / capacity over the window). Defaults to true.\n   */\n  hoverCard?: boolean;\n  /** Override the default fetch (e.g. to route through an app's API client). */\n  fetcher?: (url: string) => Promise<TimeseriesResponse>;\n  className?: string;\n}\n\nconst defaultFetcher = async (url: string): Promise<TimeseriesResponse> => {\n  const res = await fetch(url);\n  if (!res.ok) throw new Error(`metrics request failed: ${res.status}`);\n  return res.json();\n};\n\nfunction latestValue(resp: TimeseriesResponse | undefined): number | undefined {\n  const points = resp?.points;\n  if (!points || points.length === 0) return undefined;\n  return points[points.length - 1]?.value;\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 CoreBarsIcon({ 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 formatCores(cores: number): string {\n  return Number.isInteger(cores) ? String(cores) : cores.toFixed(1);\n}\n\n/**\n * TimeseriesCoreBars renders CPU utilisation as a row of vertical bars — one bar\n * per core (the ceiling of the CPU limit) — filled left to right by the latest\n * usage. The bar that straddles the usage boundary is partially filled (\"blocked\n * out\") to show the fractional core in use, and the trailing bars stay empty to\n * show headroom. Both usage and limit are read live from the timeseries store,\n * mirroring TimeseriesGauge's data plumbing; the bar colour crosses warning and\n * danger thresholds. A \"<used> / <cores>\" caption sits below with the icon+title.\n */\nexport function TimeseriesCoreBars({\n  baseUrl = \"\",\n  value,\n  max,\n  unit,\n  title,\n  icon,\n  range = \"1h\",\n  refreshMs = 5000,\n  thresholds = [75, 90],\n  variant = \"default\",\n  showLabel = true,\n  showValue = true,\n  showCapacity = false,\n  orientation,\n  hoverCard = true,\n  fetcher = defaultFetcher,\n  className,\n}: TimeseriesCoreBarsProps) {\n  const perBar = unit?.perBar ?? 1000;\n  const unitLabel = unit?.label ?? \"cores\";\n  const barLabel = unit?.barLabel ?? \"core\";\n  const formatUnits = unit?.format ?? formatCores;\n  const maxIsSeries = typeof max === \"object\";\n  const maxSeries = maxIsSeries ? max : undefined;\n  const ids = useMemo(() => {\n    const list = [value.id];\n    if (maxSeries) list.push(maxSeries.id);\n    return list;\n  }, [value.id, maxSeries]);\n\n  const results = useQueries({\n    queries: ids.map((id) => {\n      const u = new URL(baseUrl + id, window.location.origin);\n      if (range) u.searchParams.set(\"since\", range);\n      const requestUrl = u.pathname + u.search;\n      return {\n        queryKey: [\"timeseries\", requestUrl],\n        queryFn: () => fetcher(requestUrl),\n        refetchInterval: refreshMs > 0 ? refreshMs : false,\n        staleTime: 0,\n        retry: 0,\n      };\n    }),\n  });\n\n  const rawValue = latestValue(results[0]?.data);\n  const usage =\n    rawValue === undefined\n      ? undefined\n      : value.transform\n        ? value.transform(rawValue)\n        : rawValue;\n\n  let limit: number | undefined;\n  if (typeof max === \"number\") {\n    limit = max;\n  } else if (maxSeries) {\n    const rawMax = latestValue(results[1]?.data);\n    limit =\n      rawMax === undefined\n        ? undefined\n        : maxSeries.transform\n          ? maxSeries.transform(rawMax)\n          : rawMax;\n  }\n\n  const model = deriveCoreBars(usage, limit, perBar);\n  const tone = toneClass(model.pct, thresholds);\n  const usageText = formatUnits(model.usageCores);\n  const capacityText =\n    model.limitCores !== undefined ? formatUnits(model.limitCores) : \"?\";\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: reduce the fetched points to current/min/max/avg in bar-units\n  // (raw value transformed, then divided by perBar) so they read in the same unit\n  // as the caption. A bounded reading colours the current row by its threshold.\n  const pctTone =\n    model.limitCores === 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 stats = seriesStats(results[0]?.data?.points, (v) =>\n    (value.transform ? value.transform(v) : v) / perBar,\n  );\n  const fmt = (n: number) => `${formatUnits(n)} ${unitLabel}`;\n  const hoverRows: GaugeHoverRow[] = model.hasUsage\n    ? [\n        { label: \"Current\", value: fmt(model.usageCores), ...(pctTone ? { tone: pctTone } : {}) },\n        ...(stats\n          ? [\n              { label: \"Min\", value: fmt(stats.min) },\n              { label: \"Max\", value: fmt(stats.max) },\n              { label: \"Avg\", value: fmt(stats.avg) },\n            ]\n          : []),\n        ...(model.limitCores !== undefined\n          ? [{ label: \"Capacity\", value: fmt(model.limitCores) }]\n          : []),\n      ]\n    : [];\n\n  const resolvedOrientation = orientation ?? \"vertical\";\n  const isDense = model.coreCount > 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-core-count={model.coreCount}\n      data-core-density={isDense ? \"compact\" : \"default\"}\n    >\n      {model.bars.map((bar, i) => {\n        const corePct = 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}: ${corePct}%`}\n            aria-label={!isCell ? `${barLabel} ${i + 1}: ${corePct}%` : 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: `${corePct}%`, right: 0 }\n                  : { width: `${corePct}%`, 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 ? <CoreBarsIcon 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  const footer = `over last ${range}`;\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={footer} 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={footer}\n      trigger={block}\n      className=\"w-full justify-center\"\n    />\n  ) : (\n    block\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/data/TimeseriesCoreBars.model.cjs

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const clamp01 = (n) => Math.min(1, Math.max(0, n));
-function deriveCoreBars(usageMilli, limitMilli) {
-  const hasUsage = usageMilli !== void 0;
-  const usageCores = (usageMilli ?? 0) / 1e3;
-  const hasLimit = limitMilli !== void 0 && limitMilli > 0;
-  const limitCores = hasLimit ? limitMilli / 1e3 : void 0;
+function deriveCoreBars(usage, limit, perBar = 1e3) {
+  const hasUsage = usage !== void 0;
+  const usageCores = (usage ?? 0) / perBar;
+  const hasLimit = limit !== void 0 && limit > 0;
+  const limitCores = hasLimit ? limit / perBar : void 0;
   const coreCount = Math.max(
     1,
     Math.ceil(hasLimit ? limitCores : usageCores)

package/dist/data/TimeseriesCoreBars.model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesCoreBars.model.cjs","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"sourcesContent":["export interface CoreBar {\n  /** Fraction of this core that is in use, in [0, 1]. */\n  fill: number;\n}\n\nexport interface CoreBarsModel {\n  /** Whether a usage reading was available. */\n  hasUsage: boolean;\n  /** Usage expressed in cores (millicores / 1000). */\n  usageCores: number;\n  /** Capacity in cores; undefined when no limit was resolved. */\n  limitCores?: number;\n  /** Number of bars rendered (one per core). */\n  coreCount: number;\n  /** Utilisation percentage of capacity; 0 when unbounded. */\n  pct: number;\n  /** Per-core fill fractions, left to right. */\n  bars: CoreBar[];\n}\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n));\n\n// deriveCoreBars turns the latest usage/limit millicore readings into a per-core\n// bar model: one bar per core (ceil of the limit), filled left to right by usage\n// so the bar straddling the usage boundary is partially filled and the remainder\n// stays empty. When the limit is missing or 0 the bar count falls back to the\n// ceiling of the usage so an unbounded reading still renders sensibly.\nexport function deriveCoreBars(\n  usageMilli: number | undefined,\n  limitMilli: number | undefined,\n): CoreBarsModel {\n  const hasUsage = usageMilli !== undefined;\n  const usageCores = (usageMilli ?? 0) / 1000;\n  const hasLimit = limitMilli !== undefined && limitMilli > 0;\n  const limitCores = hasLimit ? (limitMilli as number) / 1000 : undefined;\n\n  const coreCount = Math.max(\n    1,\n    Math.ceil(hasLimit ? (limitCores as number) : usageCores),\n  );\n  const pct = hasLimit\n    ? Math.min(100, Math.round((usageCores / (limitCores as number)) * 100))\n    : 0;\n\n  const bars: CoreBar[] = Array.from({ length: coreCount }, (_, i) => ({\n    fill: clamp01(usageCores - i),\n  }));\n\n  return {\n    hasUsage,\n    usageCores,\n    coreCount,\n    pct,\n    bars,\n    ...(limitCores !== undefined && { limitCores }),\n  };\n}\n"],"names":[],"mappings":";;AAoBA,MAAM,UAAU,CAAC,MAAsB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAO1D,SAAS,eACd,YACA,YACe;AACf,QAAM,WAAW,eAAe;AAChC,QAAM,cAAc,cAAc,KAAK;AACvC,QAAM,WAAW,eAAe,UAAa,aAAa;AAC1D,QAAM,aAAa,WAAY,aAAwB,MAAO;AAE9D,QAAM,YAAY,KAAK;AAAA,IACrB;AAAA,IACA,KAAK,KAAK,WAAY,aAAwB,UAAU;AAAA,EAAA;AAE1D,QAAM,MAAM,WACR,KAAK,IAAI,KAAK,KAAK,MAAO,aAAc,aAAyB,GAAG,CAAC,IACrE;AAEJ,QAAM,OAAkB,MAAM,KAAK,EAAE,QAAQ,UAAA,GAAa,CAAC,GAAG,OAAO;AAAA,IACnE,MAAM,QAAQ,aAAa,CAAC;AAAA,EAAA,EAC5B;AAEF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,eAAe,UAAa,EAAE,WAAA;AAAA,EAAW;AAEjD;;"}
+{"version":3,"file":"TimeseriesCoreBars.model.cjs","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"sourcesContent":["export interface CoreBar {\n  /** Fraction of this core that is in use, in [0, 1]. */\n  fill: number;\n}\n\nexport interface CoreBarsModel {\n  /** Whether a usage reading was available. */\n  hasUsage: boolean;\n  /** Usage expressed in bar-units (raw / perBar). */\n  usageCores: number;\n  /** Capacity in bar-units; undefined when no limit was resolved. */\n  limitCores?: number;\n  /** Number of bars rendered (one per bar-unit of capacity). */\n  coreCount: number;\n  /** Utilisation percentage of capacity; 0 when unbounded. */\n  pct: number;\n  /** Per-core fill fractions, left to right. */\n  bars: CoreBar[];\n}\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n));\n\n// deriveCoreBars turns the latest usage/limit readings into a per-bar model: one\n// bar per unit of capacity (ceil of the limit), filled left to right by usage so\n// the bar straddling the usage boundary is partially filled and the remainder\n// stays empty. When the limit is missing or 0 the bar count falls back to the\n// ceiling of the usage so an unbounded reading still renders sensibly. `perBar`\n// is the raw value that fills one bar (default 1000 = millicores per core); pass\n// e.g. 1 GiB to render one bar per gigabyte of memory.\nexport function deriveCoreBars(\n  usage: number | undefined,\n  limit: number | undefined,\n  perBar = 1000,\n): CoreBarsModel {\n  const hasUsage = usage !== undefined;\n  const usageCores = (usage ?? 0) / perBar;\n  const hasLimit = limit !== undefined && limit > 0;\n  const limitCores = hasLimit ? (limit as number) / perBar : undefined;\n\n  const coreCount = Math.max(\n    1,\n    Math.ceil(hasLimit ? (limitCores as number) : usageCores),\n  );\n  const pct = hasLimit\n    ? Math.min(100, Math.round((usageCores / (limitCores as number)) * 100))\n    : 0;\n\n  const bars: CoreBar[] = Array.from({ length: coreCount }, (_, i) => ({\n    fill: clamp01(usageCores - i),\n  }));\n\n  return {\n    hasUsage,\n    usageCores,\n    coreCount,\n    pct,\n    bars,\n    ...(limitCores !== undefined && { limitCores }),\n  };\n}\n"],"names":[],"mappings":";;AAoBA,MAAM,UAAU,CAAC,MAAsB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAS1D,SAAS,eACd,OACA,OACA,SAAS,KACM;AACf,QAAM,WAAW,UAAU;AAC3B,QAAM,cAAc,SAAS,KAAK;AAClC,QAAM,WAAW,UAAU,UAAa,QAAQ;AAChD,QAAM,aAAa,WAAY,QAAmB,SAAS;AAE3D,QAAM,YAAY,KAAK;AAAA,IACrB;AAAA,IACA,KAAK,KAAK,WAAY,aAAwB,UAAU;AAAA,EAAA;AAE1D,QAAM,MAAM,WACR,KAAK,IAAI,KAAK,KAAK,MAAO,aAAc,aAAyB,GAAG,CAAC,IACrE;AAEJ,QAAM,OAAkB,MAAM,KAAK,EAAE,QAAQ,UAAA,GAAa,CAAC,GAAG,OAAO;AAAA,IACnE,MAAM,QAAQ,aAAa,CAAC;AAAA,EAAA,EAC5B;AAEF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,eAAe,UAAa,EAAE,WAAA;AAAA,EAAW;AAEjD;;"}

package/dist/data/TimeseriesCoreBars.model.d.ts

@@ -5,16 +5,16 @@ export interface CoreBar {
 export interface CoreBarsModel {
     /** Whether a usage reading was available. */
     hasUsage: boolean;
-    /** Usage expressed in cores (millicores / 1000). */
+    /** Usage expressed in bar-units (raw / perBar). */
     usageCores: number;
-    /** Capacity in cores; undefined when no limit was resolved. */
+    /** Capacity in bar-units; undefined when no limit was resolved. */
     limitCores?: number;
-    /** Number of bars rendered (one per core). */
+    /** Number of bars rendered (one per bar-unit of capacity). */
     coreCount: number;
     /** Utilisation percentage of capacity; 0 when unbounded. */
     pct: number;
     /** Per-core fill fractions, left to right. */
     bars: CoreBar[];
 }
-export declare function deriveCoreBars(usageMilli: number | undefined, limitMilli: number | undefined): CoreBarsModel;
+export declare function deriveCoreBars(usage: number | undefined, limit: number | undefined, perBar?: number): CoreBarsModel;
 //# sourceMappingURL=TimeseriesCoreBars.model.d.ts.map

package/dist/data/TimeseriesCoreBars.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesCoreBars.model.d.ts","sourceRoot":"","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AASD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,aAAa,CA0Bf"}
+{"version":3,"file":"TimeseriesCoreBars.model.d.ts","sourceRoot":"","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAWD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,SAAO,GACZ,aAAa,CA0Bf"}

package/dist/data/TimeseriesCoreBars.model.js

@@ -1,9 +1,9 @@
 const clamp01 = (n) => Math.min(1, Math.max(0, n));
-function deriveCoreBars(usageMilli, limitMilli) {
-  const hasUsage = usageMilli !== void 0;
-  const usageCores = (usageMilli ?? 0) / 1e3;
-  const hasLimit = limitMilli !== void 0 && limitMilli > 0;
-  const limitCores = hasLimit ? limitMilli / 1e3 : void 0;
+function deriveCoreBars(usage, limit, perBar = 1e3) {
+  const hasUsage = usage !== void 0;
+  const usageCores = (usage ?? 0) / perBar;
+  const hasLimit = limit !== void 0 && limit > 0;
+  const limitCores = hasLimit ? limit / perBar : void 0;
   const coreCount = Math.max(
     1,
     Math.ceil(hasLimit ? limitCores : usageCores)

package/dist/data/TimeseriesCoreBars.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesCoreBars.model.js","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"sourcesContent":["export interface CoreBar {\n  /** Fraction of this core that is in use, in [0, 1]. */\n  fill: number;\n}\n\nexport interface CoreBarsModel {\n  /** Whether a usage reading was available. */\n  hasUsage: boolean;\n  /** Usage expressed in cores (millicores / 1000). */\n  usageCores: number;\n  /** Capacity in cores; undefined when no limit was resolved. */\n  limitCores?: number;\n  /** Number of bars rendered (one per core). */\n  coreCount: number;\n  /** Utilisation percentage of capacity; 0 when unbounded. */\n  pct: number;\n  /** Per-core fill fractions, left to right. */\n  bars: CoreBar[];\n}\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n));\n\n// deriveCoreBars turns the latest usage/limit millicore readings into a per-core\n// bar model: one bar per core (ceil of the limit), filled left to right by usage\n// so the bar straddling the usage boundary is partially filled and the remainder\n// stays empty. When the limit is missing or 0 the bar count falls back to the\n// ceiling of the usage so an unbounded reading still renders sensibly.\nexport function deriveCoreBars(\n  usageMilli: number | undefined,\n  limitMilli: number | undefined,\n): CoreBarsModel {\n  const hasUsage = usageMilli !== undefined;\n  const usageCores = (usageMilli ?? 0) / 1000;\n  const hasLimit = limitMilli !== undefined && limitMilli > 0;\n  const limitCores = hasLimit ? (limitMilli as number) / 1000 : undefined;\n\n  const coreCount = Math.max(\n    1,\n    Math.ceil(hasLimit ? (limitCores as number) : usageCores),\n  );\n  const pct = hasLimit\n    ? Math.min(100, Math.round((usageCores / (limitCores as number)) * 100))\n    : 0;\n\n  const bars: CoreBar[] = Array.from({ length: coreCount }, (_, i) => ({\n    fill: clamp01(usageCores - i),\n  }));\n\n  return {\n    hasUsage,\n    usageCores,\n    coreCount,\n    pct,\n    bars,\n    ...(limitCores !== undefined && { limitCores }),\n  };\n}\n"],"names":[],"mappings":"AAoBA,MAAM,UAAU,CAAC,MAAsB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAO1D,SAAS,eACd,YACA,YACe;AACf,QAAM,WAAW,eAAe;AAChC,QAAM,cAAc,cAAc,KAAK;AACvC,QAAM,WAAW,eAAe,UAAa,aAAa;AAC1D,QAAM,aAAa,WAAY,aAAwB,MAAO;AAE9D,QAAM,YAAY,KAAK;AAAA,IACrB;AAAA,IACA,KAAK,KAAK,WAAY,aAAwB,UAAU;AAAA,EAAA;AAE1D,QAAM,MAAM,WACR,KAAK,IAAI,KAAK,KAAK,MAAO,aAAc,aAAyB,GAAG,CAAC,IACrE;AAEJ,QAAM,OAAkB,MAAM,KAAK,EAAE,QAAQ,UAAA,GAAa,CAAC,GAAG,OAAO;AAAA,IACnE,MAAM,QAAQ,aAAa,CAAC;AAAA,EAAA,EAC5B;AAEF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,eAAe,UAAa,EAAE,WAAA;AAAA,EAAW;AAEjD;"}
+{"version":3,"file":"TimeseriesCoreBars.model.js","sources":["../../src/data/TimeseriesCoreBars.model.ts"],"sourcesContent":["export interface CoreBar {\n  /** Fraction of this core that is in use, in [0, 1]. */\n  fill: number;\n}\n\nexport interface CoreBarsModel {\n  /** Whether a usage reading was available. */\n  hasUsage: boolean;\n  /** Usage expressed in bar-units (raw / perBar). */\n  usageCores: number;\n  /** Capacity in bar-units; undefined when no limit was resolved. */\n  limitCores?: number;\n  /** Number of bars rendered (one per bar-unit of capacity). */\n  coreCount: number;\n  /** Utilisation percentage of capacity; 0 when unbounded. */\n  pct: number;\n  /** Per-core fill fractions, left to right. */\n  bars: CoreBar[];\n}\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n));\n\n// deriveCoreBars turns the latest usage/limit readings into a per-bar model: one\n// bar per unit of capacity (ceil of the limit), filled left to right by usage so\n// the bar straddling the usage boundary is partially filled and the remainder\n// stays empty. When the limit is missing or 0 the bar count falls back to the\n// ceiling of the usage so an unbounded reading still renders sensibly. `perBar`\n// is the raw value that fills one bar (default 1000 = millicores per core); pass\n// e.g. 1 GiB to render one bar per gigabyte of memory.\nexport function deriveCoreBars(\n  usage: number | undefined,\n  limit: number | undefined,\n  perBar = 1000,\n): CoreBarsModel {\n  const hasUsage = usage !== undefined;\n  const usageCores = (usage ?? 0) / perBar;\n  const hasLimit = limit !== undefined && limit > 0;\n  const limitCores = hasLimit ? (limit as number) / perBar : undefined;\n\n  const coreCount = Math.max(\n    1,\n    Math.ceil(hasLimit ? (limitCores as number) : usageCores),\n  );\n  const pct = hasLimit\n    ? Math.min(100, Math.round((usageCores / (limitCores as number)) * 100))\n    : 0;\n\n  const bars: CoreBar[] = Array.from({ length: coreCount }, (_, i) => ({\n    fill: clamp01(usageCores - i),\n  }));\n\n  return {\n    hasUsage,\n    usageCores,\n    coreCount,\n    pct,\n    bars,\n    ...(limitCores !== undefined && { limitCores }),\n  };\n}\n"],"names":[],"mappings":"AAoBA,MAAM,UAAU,CAAC,MAAsB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAS1D,SAAS,eACd,OACA,OACA,SAAS,KACM;AACf,QAAM,WAAW,UAAU;AAC3B,QAAM,cAAc,SAAS,KAAK;AAClC,QAAM,WAAW,UAAU,UAAa,QAAQ;AAChD,QAAM,aAAa,WAAY,QAAmB,SAAS;AAE3D,QAAM,YAAY,KAAK;AAAA,IACrB;AAAA,IACA,KAAK,KAAK,WAAY,aAAwB,UAAU;AAAA,EAAA;AAE1D,QAAM,MAAM,WACR,KAAK,IAAI,KAAK,KAAK,MAAO,aAAc,aAAyB,GAAG,CAAC,IACrE;AAEJ,QAAM,OAAkB,MAAM,KAAK,EAAE,QAAQ,UAAA,GAAa,CAAC,GAAG,OAAO;AAAA,IACnE,MAAM,QAAQ,aAAa,CAAC;AAAA,EAAA,EAC5B;AAEF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,eAAe,UAAa,EAAE,WAAA;AAAA,EAAW;AAEjD;"}

package/dist/data/TimeseriesGauge.cjs

@@ -8,6 +8,8 @@ const format = require("../lib/format.cjs");
 const Modal = require("../overlay/Modal.cjs");
 const Icon = require("./Icon.cjs");
 const TimeseriesPanel = require("./TimeseriesPanel.cjs");
+const GaugeHoverCard = require("./GaugeHoverCard.cjs");
+const gaugeStats = require("./gauge-stats.cjs");
 const UiFullscreen = require("../icons/components/UiFullscreen.cjs");
 const defaultFetcher = async (url) => {
   const res = await fetch(url);
@@ -22,6 +24,38 @@ function toneClass(pct, [warn, danger]) {
   if (pct >= warn) return "text-amber-500";
   return "text-emerald-500";
 }
+function toneBgClass(pct, [warn, danger]) {
+  if (pct >= danger) return "bg-red-500";
+  if (pct >= warn) return "bg-amber-500";
+  return "bg-emerald-500";
+}
+function GaugeArc({ pct, tone, strokeWidth }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("svg", { viewBox: "0 0 100 50", className: "h-full w-full overflow-visible", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("path", { d: GAUGE_PATH, fill: "none", stroke: "currentColor", strokeWidth, strokeLinecap: "round", className: "text-muted" }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "path",
+      {
+        d: GAUGE_PATH,
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth,
+        strokeLinecap: "round",
+        className: tone,
+        strokeDasharray: GAUGE_ARC,
+        strokeDashoffset: GAUGE_ARC * (1 - pct / 100)
+      }
+    )
+  ] });
+}
+function GaugeBar({ pct, toneBg, className }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { className: utils.cn("relative block overflow-hidden rounded-full bg-muted", className), "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsx(
+    "span",
+    {
+      className: utils.cn("absolute inset-y-0 left-0 rounded-full transition-all duration-300", toneBg),
+      style: { width: `${pct}%` }
+    }
+  ) });
+}
 function latestValue(resp) {
   var _a;
   const points = resp == null ? void 0 : resp.points;
@@ -47,11 +81,13 @@ function TimeseriesGauge({
   thresholds = [75, 90],
   centerDisplay = "value",
   variant = "default",
+  shape = "radial",
   showLabel = true,
+  hoverCard = true,
   fetcher = defaultFetcher,
   className
 }) {
-  var _a, _b;
+  var _a, _b, _c, _d;
   const [expanded, setExpanded] = react.useState(false);
   const maxIsSeries = typeof max === "object";
   const maxSeries = maxIsSeries ? max : void 0;
@@ -87,6 +123,7 @@ function TimeseriesGauge({
   const bounded = hasValue && limit !== void 0 && limit > 0;
   const pct = bounded ? Math.min(100, Math.round(usage / limit * 100)) : 0;
   const tone = toneClass(pct, thresholds);
+  const toneBg = toneBgClass(pct, thresholds);
   const readout = centerDisplay === "percent" ? bounded ? `${pct}%` : hasValue ? "n/a" : "—" : hasValue ? format.formatUnit(usage, unit) : "—";
   const titleText = `${title}: ${readout}`;
   const canExpand = expandable && variant === "default";
@@ -96,74 +133,63 @@ function TimeseriesGauge({
     if (maxSeries) s.push({ id: maxSeries.id, label: "max", ...maxSeries.transform ? { transform: maxSeries.transform } : {} });
     return s;
   }, [value.id, value.transform, maxSeries]);
+  const stats = gaugeStats.seriesStats((_d = (_c = results[0]) == null ? void 0 : _c.data) == null ? void 0 : _d.points, value.transform);
+  const fmt = (n) => format.formatUnit(n, unit);
+  const hoverRows = hasValue ? [
+    { label: "Current", value: fmt(usage), ...bounded ? { tone } : {} },
+    ...stats ? [
+      { label: "Min", value: fmt(stats.min) },
+      { label: "Max", value: fmt(stats.max) },
+      { label: "Avg", value: fmt(stats.avg) }
+    ] : [],
+    ...limit !== void 0 ? [{ label: "Capacity", value: fmt(limit) }] : []
+  ] : [];
+  const useHover = hoverCard && hoverRows.length > 0;
+  const footer = `over last ${range}`;
   if (variant === "cell") {
-    return /* @__PURE__ */ jsxRuntime.jsxs(
+    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
         ),
-        title: titleText,
-        "aria-label": !showLabel ? titleText : void 0,
+        ...useHover ? {} : { title: titleText },
+        "aria-label": useHover || !showLabel ? titleText : void 0,
+        "data-shape": shape,
         children: [
           icon ? /* @__PURE__ */ jsxRuntime.jsx(GaugeIcon, { icon }) : null,
           showLabel ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 truncate text-muted-foreground", children: title }) : null,
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative h-4 w-8 shrink-0", "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsxs("svg", { viewBox: "0 0 100 50", className: "h-full w-full overflow-visible", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(
-              "path",
-              {
-                d: GAUGE_PATH,
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: 10,
-                strokeLinecap: "round",
-                className: "text-muted"
-              }
-            ),
-            /* @__PURE__ */ jsxRuntime.jsx(
-              "path",
-              {
-                d: GAUGE_PATH,
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: 10,
-                strokeLinecap: "round",
-                className: tone,
-                strokeDasharray: GAUGE_ARC,
-                strokeDashoffset: GAUGE_ARC * (1 - pct / 100)
-              }
-            )
-          ] }) }),
+          shape === "linear" ? /* @__PURE__ */ jsxRuntime.jsx(GaugeBar, { pct, toneBg, className: "h-1.5 w-12 shrink-0" }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative h-4 w-8 shrink-0", "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsx(GaugeArc, { pct, tone, strokeWidth: 10 }) }),
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: utils.cn("shrink-0 font-semibold tabular-nums", readoutTone), children: readout })
         ]
       }
     );
+    return useHover ? /* @__PURE__ */ jsxRuntime.jsx(GaugeHoverCard.GaugeHoverCard, { title, rows: hoverRows, footer, trigger: cell }) : cell;
   }
-  return /* @__PURE__ */ jsxRuntime.jsxs(
+  const body = /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
       className: utils.cn("flex flex-col items-center gap-1", className),
-      title: !showLabel ? titleText : void 0,
-      "aria-label": !showLabel ? titleText : void 0,
+      ...useHover ? {} : { title: !showLabel ? titleText : void 0 },
+      "aria-label": useHover || !showLabel ? titleText : void 0,
+      "data-shape": shape,
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative h-10 w-20", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("svg", { viewBox: "0 0 100 50", className: "h-full w-full overflow-visible", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("path", { d: GAUGE_PATH, fill: "none", stroke: "currentColor", strokeWidth: 9, strokeLinecap: "round", className: "text-muted" }),
-            /* @__PURE__ */ jsxRuntime.jsx(
-              "path",
-              {
-                d: GAUGE_PATH,
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: 9,
-                strokeLinecap: "round",
-                className: tone,
-                strokeDasharray: GAUGE_ARC,
-                strokeDashoffset: GAUGE_ARC * (1 - pct / 100)
-              }
-            )
-          ] }),
+        shape === "linear" ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex w-full items-center gap-2", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(GaugeBar, { pct, toneBg, className: "h-2 w-full" }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0 text-sm font-semibold text-foreground", children: readout }),
+          canExpand && /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              "aria-label": "Expand chart",
+              onClick: () => setExpanded(true),
+              className: "shrink-0 text-muted-foreground hover:text-foreground",
+              children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiFullscreen.UiFullscreen, width: 12, height: 12 })
+            }
+          )
+        ] }) : /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative h-10 w-20", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(GaugeArc, { pct, tone, strokeWidth: 9 }),
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "absolute inset-x-0 bottom-0 text-center text-sm font-semibold text-foreground", children: readout }),
           canExpand && /* @__PURE__ */ jsxRuntime.jsx(
             "button",
@@ -179,24 +205,36 @@ function TimeseriesGauge({
         icon || showLabel ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-1 text-xs text-muted-foreground", children: [
           icon ? /* @__PURE__ */ jsxRuntime.jsx(GaugeIcon, { icon }) : null,
           showLabel ? /* @__PURE__ */ jsxRuntime.jsx("span", { children: title }) : null
-        ] }) : null,
-        canExpand && /* @__PURE__ */ jsxRuntime.jsx(Modal.Modal, { open: expanded, onClose: () => setExpanded(false), title, size: "xl", children: /* @__PURE__ */ jsxRuntime.jsx(
-          TimeseriesPanel.TimeseriesPanel,
-          {
-            title,
-            ...icon ? { icon } : {},
-            ...unit ? { unit } : {},
-            baseUrl,
-            series: chartSeries,
-            range,
-            refreshMs,
-            expandable: false,
-            fetcher
-          }
-        ) })
+        ] }) : null
       ]
     }
   );
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    useHover ? /* @__PURE__ */ jsxRuntime.jsx(
+      GaugeHoverCard.GaugeHoverCard,
+      {
+        title,
+        rows: hoverRows,
+        footer,
+        trigger: body,
+        className: "w-full justify-center"
+      }
+    ) : body,
+    canExpand && /* @__PURE__ */ jsxRuntime.jsx(Modal.Modal, { open: expanded, onClose: () => setExpanded(false), title, size: "xl", children: /* @__PURE__ */ jsxRuntime.jsx(
+      TimeseriesPanel.TimeseriesPanel,
+      {
+        title,
+        ...icon ? { icon } : {},
+        ...unit ? { unit } : {},
+        baseUrl,
+        series: chartSeries,
+        range,
+        refreshMs,
+        expandable: false,
+        fetcher
+      }
+    ) })
+  ] });
 }
 exports.TimeseriesGauge = TimeseriesGauge;
 //# sourceMappingURL=TimeseriesGauge.cjs.map

package/dist/data/TimeseriesGauge.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesGauge.cjs","sources":["../../src/data/TimeseriesGauge.tsx"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useMemo, useState } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { formatUnit } from \"../lib/format\";\nimport { Modal } from \"../overlay/Modal\";\nimport { UiFullscreen } from \"../icons\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport {\n  TimeseriesPanel,\n  type TimeseriesResponse,\n  type TimeseriesSeries,\n} from \"./TimeseriesPanel\";\n\n/** A metric series whose latest value drives the gauge fill or its maximum. */\nexport interface GaugeSeries {\n  /** Metric id appended to the gauge's baseUrl, e.g. \"k8s.statefulset.cycle.cpu.usage\". */\n  id: string;\n  /** Maps the latest value before display (e.g. unit scaling). Identity when omitted. */\n  transform?: (value: number) => number;\n}\n\nexport type TimeseriesGaugeVariant = \"default\" | \"cell\";\n\nexport interface TimeseriesGaugeProps {\n  /** Common prefix; the value/max requests are `baseUrl + id`. */\n  baseUrl?: string;\n  /** The metric whose latest value fills the gauge. */\n  value: GaugeSeries;\n  /**\n   * The gauge maximum. Either a metric series (its latest value, e.g. a `.limit`\n   * metric) or a fixed number. When omitted, or when the resolved max is 0, the\n   * gauge shows the raw value with no fill (an unbounded reading).\n   */\n  max?: GaugeSeries | number;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /** Grafana-style unit key for the readout (e.g. \"bytes\", \"percent\", \"short\", \"ms\"). */\n  unit?: string;\n  /** Look-back window for the expand chart, passed as ?since=; defaults to \"1h\". */\n  range?: string;\n  /** Poll interval in ms; defaults to 5000. Pass 0 to disable polling. */\n  refreshMs?: number;\n  /** Show an expand button that opens the value/max time-series chart in a modal. Default true. */\n  expandable?: boolean;\n  /**\n   * Utilisation thresholds (percent of max) at which the arc turns amber then\n   * red. Defaults to [75, 90].\n   */\n  thresholds?: [warning: number, danger: number];\n  /**\n   * What to print in the centre: the formatted value (default) or the\n   * utilisation percentage of max (e.g. CPU usage out of its millicore limit).\n   */\n  centerDisplay?: \"value\" | \"percent\";\n  /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */\n  variant?: TimeseriesGaugeVariant;\n  /** Show the title text. Icons and values remain visible when false. */\n  showLabel?: boolean;\n  /** Override the default fetch (e.g. to route through an app's API client). */\n  fetcher?: (url: string) => Promise<TimeseriesResponse>;\n  className?: string;\n}\n\nconst defaultFetcher = async (url: string): Promise<TimeseriesResponse> => {\n  const res = await fetch(url);\n  if (!res.ok) throw new Error(`metrics request failed: ${res.status}`);\n  return res.json();\n};\n\n// Half-gauge SVG geometry: a 100×50 viewBox semicircle (radius 40, centre 50,50)\n// swept 180°. The arc length is π·r; stroke-dashoffset reveals value/max of it.\nconst GAUGE_RADIUS = 40;\nconst GAUGE_ARC = Math.PI * GAUGE_RADIUS;\nconst GAUGE_PATH = `M 10 50 A ${GAUGE_RADIUS} ${GAUGE_RADIUS} 0 0 1 90 50`;\n\nfunction toneClass(pct: number, [warn, danger]: [number, number]): string {\n  if (pct >= danger) return \"text-red-500\";\n  if (pct >= warn) return \"text-amber-500\";\n  return \"text-emerald-500\";\n}\n\nfunction latestValue(resp: TimeseriesResponse | undefined): number | undefined {\n  const points = resp?.points;\n  if (!points || points.length === 0) return undefined;\n  return points[points.length - 1]?.value;\n}\n\nfunction GaugeIcon({ icon }: { icon: string | StaticIconComponent }) {\n  if (typeof icon === \"string\") {\n    return <Icon name={icon} width={14} height={14} className=\"text-muted-foreground\" />;\n  }\n  return <Icon icon={icon} width={14} height={14} className=\"text-muted-foreground\" />;\n}\n\n/**\n * TimeseriesGauge renders a half (180°) radial gauge whose fill is the latest\n * value of a metric over its maximum (a `.limit`-style metric or a fixed number),\n * both read live from the timeseries store. The centre shows the utilisation\n * percentage, with the value/max caption below; the arc colour crosses warning\n * and danger thresholds. An expand button opens the full value/max time-series\n * chart in a modal (a `TimeseriesPanel`), so the gauge gives the at-a-glance\n * reading and the chart the trend.\n */\nexport function TimeseriesGauge({\n  baseUrl = \"\",\n  value,\n  max,\n  title,\n  icon,\n  unit,\n  range = \"1h\",\n  refreshMs = 5000,\n  expandable = true,\n  thresholds = [75, 90],\n  centerDisplay = \"value\",\n  variant = \"default\",\n  showLabel = true,\n  fetcher = defaultFetcher,\n  className,\n}: TimeseriesGaugeProps) {\n  const [expanded, setExpanded] = useState(false);\n\n  const maxIsSeries = typeof max === \"object\";\n  const maxSeries = maxIsSeries ? max : undefined;\n  const ids = useMemo(() => {\n    const list = [value.id];\n    if (maxSeries) list.push(maxSeries.id);\n    return list;\n  }, [value.id, maxSeries]);\n\n  const results = useQueries({\n    queries: ids.map((id) => {\n      const u = new URL(baseUrl + id, window.location.origin);\n      if (range) u.searchParams.set(\"since\", range);\n      const requestUrl = u.pathname + u.search;\n      return {\n        queryKey: [\"timeseries\", requestUrl],\n        queryFn: () => fetcher(requestUrl),\n        refetchInterval: refreshMs > 0 ? refreshMs : false,\n        staleTime: 0,\n        retry: 0,\n      };\n    }),\n  });\n\n  const rawValue = latestValue(results[0]?.data);\n  const hasValue = rawValue !== undefined;\n  const usage = value.transform ? value.transform(rawValue ?? 0) : (rawValue ?? 0);\n\n  let limit: number | undefined;\n  if (typeof max === \"number\") {\n    limit = max;\n  } else if (maxSeries) {\n    const rawMax = latestValue(results[1]?.data);\n    limit = rawMax === undefined ? undefined : maxSeries.transform ? maxSeries.transform(rawMax) : rawMax;\n  }\n\n  const bounded = hasValue && limit !== undefined && limit > 0;\n  const pct = bounded ? Math.min(100, Math.round((usage / (limit as number)) * 100)) : 0;\n  const tone = toneClass(pct, thresholds);\n  const readout =\n    centerDisplay === \"percent\"\n      ? bounded\n        ? `${pct}%`\n        : hasValue\n          ? \"n/a\"\n          : \"—\"\n      : hasValue\n        ? formatUnit(usage, unit)\n        : \"—\";\n  const titleText = `${title}: ${readout}`;\n  const canExpand = expandable && variant === \"default\";\n  const readoutTone = bounded ? tone : \"text-foreground\";\n\n  const chartSeries: TimeseriesSeries[] = useMemo(() => {\n    const s: TimeseriesSeries[] = [{ id: value.id, label: \"value\", ...(value.transform ? { transform: value.transform } : {}) }];\n    if (maxSeries) s.push({ id: maxSeries.id, label: \"max\", ...(maxSeries.transform ? { transform: maxSeries.transform } : {}) });\n    return s;\n  }, [value.id, value.transform, maxSeries]);\n\n  if (variant === \"cell\") {\n    return (\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        title={titleText}\n        aria-label={!showLabel ? titleText : undefined}\n      >\n        {icon ? <GaugeIcon icon={icon} /> : null}\n        {showLabel ? <span className=\"min-w-0 truncate text-muted-foreground\">{title}</span> : null}\n        <span className=\"relative h-4 w-8 shrink-0\" aria-hidden=\"true\">\n          <svg viewBox=\"0 0 100 50\" className=\"h-full w-full overflow-visible\">\n            <path\n              d={GAUGE_PATH}\n              fill=\"none\"\n              stroke=\"currentColor\"\n              strokeWidth={10}\n              strokeLinecap=\"round\"\n              className=\"text-muted\"\n            />\n            <path\n              d={GAUGE_PATH}\n              fill=\"none\"\n              stroke=\"currentColor\"\n              strokeWidth={10}\n              strokeLinecap=\"round\"\n              className={tone}\n              strokeDasharray={GAUGE_ARC}\n              strokeDashoffset={GAUGE_ARC * (1 - pct / 100)}\n            />\n          </svg>\n        </span>\n        <span className={cn(\"shrink-0 font-semibold tabular-nums\", readoutTone)}>\n          {readout}\n        </span>\n      </span>\n    );\n  }\n\n  return (\n    <div\n      className={cn(\"flex flex-col items-center gap-1\", className)}\n      title={!showLabel ? titleText : undefined}\n      aria-label={!showLabel ? titleText : undefined}\n    >\n      <div className=\"relative h-10 w-20\">\n        <svg viewBox=\"0 0 100 50\" className=\"h-full w-full overflow-visible\">\n          <path d={GAUGE_PATH} fill=\"none\" stroke=\"currentColor\" strokeWidth={9} strokeLinecap=\"round\" className=\"text-muted\" />\n          <path\n            d={GAUGE_PATH}\n            fill=\"none\"\n            stroke=\"currentColor\"\n            strokeWidth={9}\n            strokeLinecap=\"round\"\n            className={tone}\n            strokeDasharray={GAUGE_ARC}\n            strokeDashoffset={GAUGE_ARC * (1 - pct / 100)}\n          />\n        </svg>\n        <span className=\"absolute inset-x-0 bottom-0 text-center text-sm font-semibold text-foreground\">\n          {readout}\n        </span>\n        {canExpand && (\n          <button\n            type=\"button\"\n            aria-label=\"Expand chart\"\n            onClick={() => setExpanded(true)}\n            className=\"absolute right-0 top-0 text-muted-foreground hover:text-foreground\"\n          >\n            <Icon icon={UiFullscreen} width={12} height={12} />\n          </button>\n        )}\n      </div>\n      {icon || showLabel ? (\n        <div className=\"flex items-center gap-1 text-xs text-muted-foreground\">\n          {icon ? <GaugeIcon icon={icon} /> : null}\n          {showLabel ? <span>{title}</span> : null}\n        </div>\n      ) : null}\n\n      {canExpand && (\n        <Modal open={expanded} onClose={() => setExpanded(false)} title={title} size=\"xl\">\n          <TimeseriesPanel\n            title={title}\n            {...(icon ? { icon } : {})}\n            {...(unit ? { unit } : {})}\n            baseUrl={baseUrl}\n            series={chartSeries}\n            range={range}\n            refreshMs={refreshMs}\n            expandable={false}\n            fetcher={fetcher}\n          />\n        </Modal>\n      )}\n    </div>\n  );\n}\n"],"names":["jsx","Icon","useState","useMemo","useQueries","formatUnit","jsxs","cn","UiFullscreen","Modal","TimeseriesPanel"],"mappings":"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"}
+{"version":3,"file":"TimeseriesGauge.cjs","sources":["../../src/data/TimeseriesGauge.tsx"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useMemo, useState } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { formatUnit } from \"../lib/format\";\nimport { Modal } from \"../overlay/Modal\";\nimport { UiFullscreen } from \"../icons\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport {\n  TimeseriesPanel,\n  type TimeseriesResponse,\n  type TimeseriesSeries,\n} from \"./TimeseriesPanel\";\nimport { GaugeHoverCard, type GaugeHoverRow } from \"./GaugeHoverCard\";\nimport { seriesStats } from \"./gauge-stats\";\n\n/** A metric series whose latest value drives the gauge fill or its maximum. */\nexport interface GaugeSeries {\n  /** Metric id appended to the gauge's baseUrl, e.g. \"k8s.statefulset.cycle.cpu.usage\". */\n  id: string;\n  /** Maps the latest value before display (e.g. unit scaling). Identity when omitted. */\n  transform?: (value: number) => number;\n}\n\nexport type TimeseriesGaugeVariant = \"default\" | \"cell\";\n/** Gauge fill geometry: a half-circle arc (default) or a horizontal progress bar. */\nexport type TimeseriesGaugeShape = \"radial\" | \"linear\";\n\nexport interface TimeseriesGaugeProps {\n  /** Common prefix; the value/max requests are `baseUrl + id`. */\n  baseUrl?: string;\n  /** The metric whose latest value fills the gauge. */\n  value: GaugeSeries;\n  /**\n   * The gauge maximum. Either a metric series (its latest value, e.g. a `.limit`\n   * metric) or a fixed number. When omitted, or when the resolved max is 0, the\n   * gauge shows the raw value with no fill (an unbounded reading).\n   */\n  max?: GaugeSeries | number;\n  title: string;\n  /** Iconify name or static icon component shown beside the label. */\n  icon?: string | StaticIconComponent;\n  /** Grafana-style unit key for the readout (e.g. \"bytes\", \"percent\", \"short\", \"ms\"). */\n  unit?: string;\n  /** Look-back window for the expand chart, passed as ?since=; defaults to \"1h\". */\n  range?: string;\n  /** Poll interval in ms; defaults to 5000. Pass 0 to disable polling. */\n  refreshMs?: number;\n  /** Show an expand button that opens the value/max time-series chart in a modal. Default true. */\n  expandable?: boolean;\n  /**\n   * Utilisation thresholds (percent of max) at which the arc turns amber then\n   * red. Defaults to [75, 90].\n   */\n  thresholds?: [warning: number, danger: number];\n  /**\n   * What to print in the centre: the formatted value (default) or the\n   * utilisation percentage of max (e.g. CPU usage out of its millicore limit).\n   */\n  centerDisplay?: \"value\" | \"percent\";\n  /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */\n  variant?: TimeseriesGaugeVariant;\n  /** Fill geometry: a radial half-gauge (default) or a horizontal progress bar. */\n  shape?: TimeseriesGaugeShape;\n  /** Show the title text. Icons and values remain visible when false. */\n  showLabel?: boolean;\n  /**\n   * Wrap the gauge in a hover card summarising the metric (label + current / min /\n   * max / avg / capacity over the window). Defaults to true.\n   */\n  hoverCard?: boolean;\n  /** Override the default fetch (e.g. to route through an app's API client). */\n  fetcher?: (url: string) => Promise<TimeseriesResponse>;\n  className?: string;\n}\n\nconst defaultFetcher = async (url: string): Promise<TimeseriesResponse> => {\n  const res = await fetch(url);\n  if (!res.ok) throw new Error(`metrics request failed: ${res.status}`);\n  return res.json();\n};\n\n// Half-gauge SVG geometry: a 100×50 viewBox semicircle (radius 40, centre 50,50)\n// swept 180°. The arc length is π·r; stroke-dashoffset reveals value/max of it.\nconst GAUGE_RADIUS = 40;\nconst GAUGE_ARC = Math.PI * GAUGE_RADIUS;\nconst GAUGE_PATH = `M 10 50 A ${GAUGE_RADIUS} ${GAUGE_RADIUS} 0 0 1 90 50`;\n\nfunction toneClass(pct: number, [warn, danger]: [number, number]): string {\n  if (pct >= danger) return \"text-red-500\";\n  if (pct >= warn) return \"text-amber-500\";\n  return \"text-emerald-500\";\n}\n\n// toneBgClass mirrors toneClass for the linear bar's fill, which needs a\n// background colour rather than the arc's stroke (currentColor) tone.\nfunction toneBgClass(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\n// GaugeArc is the half-circle SVG shared by the cell and default radial gauges;\n// only the stroke width differs between the two densities.\nfunction GaugeArc({ pct, tone, strokeWidth }: { pct: number; tone: string; strokeWidth: number }) {\n  return (\n    <svg viewBox=\"0 0 100 50\" className=\"h-full w-full overflow-visible\">\n      <path d={GAUGE_PATH} fill=\"none\" stroke=\"currentColor\" strokeWidth={strokeWidth} strokeLinecap=\"round\" className=\"text-muted\" />\n      <path\n        d={GAUGE_PATH}\n        fill=\"none\"\n        stroke=\"currentColor\"\n        strokeWidth={strokeWidth}\n        strokeLinecap=\"round\"\n        className={tone}\n        strokeDasharray={GAUGE_ARC}\n        strokeDashoffset={GAUGE_ARC * (1 - pct / 100)}\n      />\n    </svg>\n  );\n}\n\n// GaugeBar is the horizontal progress track shared by the cell and default linear\n// gauges; the caller sizes it via className (e.g. \"h-1.5 w-12\" or \"h-2 w-full\").\nfunction GaugeBar({ pct, toneBg, className }: { pct: number; toneBg: string; className?: string }) {\n  return (\n    <span className={cn(\"relative block overflow-hidden rounded-full bg-muted\", className)} aria-hidden=\"true\">\n      <span\n        className={cn(\"absolute inset-y-0 left-0 rounded-full transition-all duration-300\", toneBg)}\n        style={{ width: `${pct}%` }}\n      />\n    </span>\n  );\n}\n\nfunction latestValue(resp: TimeseriesResponse | undefined): number | undefined {\n  const points = resp?.points;\n  if (!points || points.length === 0) return undefined;\n  return points[points.length - 1]?.value;\n}\n\nfunction GaugeIcon({ icon }: { icon: string | StaticIconComponent }) {\n  if (typeof icon === \"string\") {\n    return <Icon name={icon} width={14} height={14} className=\"text-muted-foreground\" />;\n  }\n  return <Icon icon={icon} width={14} height={14} className=\"text-muted-foreground\" />;\n}\n\n/**\n * TimeseriesGauge renders a half (180°) radial gauge whose fill is the latest\n * value of a metric over its maximum (a `.limit`-style metric or a fixed number),\n * both read live from the timeseries store. The centre shows the utilisation\n * percentage, with the value/max caption below; the arc colour crosses warning\n * and danger thresholds. An expand button opens the full value/max time-series\n * chart in a modal (a `TimeseriesPanel`), so the gauge gives the at-a-glance\n * reading and the chart the trend.\n */\nexport function TimeseriesGauge({\n  baseUrl = \"\",\n  value,\n  max,\n  title,\n  icon,\n  unit,\n  range = \"1h\",\n  refreshMs = 5000,\n  expandable = true,\n  thresholds = [75, 90],\n  centerDisplay = \"value\",\n  variant = \"default\",\n  shape = \"radial\",\n  showLabel = true,\n  hoverCard = true,\n  fetcher = defaultFetcher,\n  className,\n}: TimeseriesGaugeProps) {\n  const [expanded, setExpanded] = useState(false);\n\n  const maxIsSeries = typeof max === \"object\";\n  const maxSeries = maxIsSeries ? max : undefined;\n  const ids = useMemo(() => {\n    const list = [value.id];\n    if (maxSeries) list.push(maxSeries.id);\n    return list;\n  }, [value.id, maxSeries]);\n\n  const results = useQueries({\n    queries: ids.map((id) => {\n      const u = new URL(baseUrl + id, window.location.origin);\n      if (range) u.searchParams.set(\"since\", range);\n      const requestUrl = u.pathname + u.search;\n      return {\n        queryKey: [\"timeseries\", requestUrl],\n        queryFn: () => fetcher(requestUrl),\n        refetchInterval: refreshMs > 0 ? refreshMs : false,\n        staleTime: 0,\n        retry: 0,\n      };\n    }),\n  });\n\n  const rawValue = latestValue(results[0]?.data);\n  const hasValue = rawValue !== undefined;\n  const usage = value.transform ? value.transform(rawValue ?? 0) : (rawValue ?? 0);\n\n  let limit: number | undefined;\n  if (typeof max === \"number\") {\n    limit = max;\n  } else if (maxSeries) {\n    const rawMax = latestValue(results[1]?.data);\n    limit = rawMax === undefined ? undefined : maxSeries.transform ? maxSeries.transform(rawMax) : rawMax;\n  }\n\n  const bounded = hasValue && limit !== undefined && limit > 0;\n  const pct = bounded ? Math.min(100, Math.round((usage / (limit as number)) * 100)) : 0;\n  const tone = toneClass(pct, thresholds);\n  const toneBg = toneBgClass(pct, thresholds);\n  const readout =\n    centerDisplay === \"percent\"\n      ? bounded\n        ? `${pct}%`\n        : hasValue\n          ? \"n/a\"\n          : \"—\"\n      : hasValue\n        ? formatUnit(usage, unit)\n        : \"—\";\n  const titleText = `${title}: ${readout}`;\n  const canExpand = expandable && variant === \"default\";\n  const readoutTone = bounded ? tone : \"text-foreground\";\n\n  const chartSeries: TimeseriesSeries[] = useMemo(() => {\n    const s: TimeseriesSeries[] = [{ id: value.id, label: \"value\", ...(value.transform ? { transform: value.transform } : {}) }];\n    if (maxSeries) s.push({ id: maxSeries.id, label: \"max\", ...(maxSeries.transform ? { transform: maxSeries.transform } : {}) });\n    return s;\n  }, [value.id, value.transform, maxSeries]);\n\n  // Hover card: reduce the value's points to current/min/max/avg (transformed to\n  // the display unit), plus the resolved capacity. The current row is tinted by\n  // its threshold tone when the reading is bounded.\n  const stats = seriesStats(results[0]?.data?.points, value.transform);\n  const fmt = (n: number) => formatUnit(n, unit);\n  const hoverRows: GaugeHoverRow[] = hasValue\n    ? [\n        { label: \"Current\", value: fmt(usage), ...(bounded ? { tone } : {}) },\n        ...(stats\n          ? [\n              { label: \"Min\", value: fmt(stats.min) },\n              { label: \"Max\", value: fmt(stats.max) },\n              { label: \"Avg\", value: fmt(stats.avg) },\n            ]\n          : []),\n        ...(limit !== undefined\n          ? [{ label: \"Capacity\", value: fmt(limit) }]\n          : []),\n      ]\n    : [];\n  const useHover = hoverCard && hoverRows.length > 0;\n  const footer = `over last ${range}`;\n\n  if (variant === \"cell\") {\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 || !showLabel ? titleText : undefined}\n        data-shape={shape}\n      >\n        {icon ? <GaugeIcon icon={icon} /> : null}\n        {showLabel ? <span className=\"min-w-0 truncate text-muted-foreground\">{title}</span> : null}\n        {shape === \"linear\" ? (\n          <GaugeBar pct={pct} toneBg={toneBg} className=\"h-1.5 w-12 shrink-0\" />\n        ) : (\n          <span className=\"relative h-4 w-8 shrink-0\" aria-hidden=\"true\">\n            <GaugeArc pct={pct} tone={tone} strokeWidth={10} />\n          </span>\n        )}\n        <span className={cn(\"shrink-0 font-semibold tabular-nums\", readoutTone)}>\n          {readout}\n        </span>\n      </span>\n    );\n    return useHover ? (\n      <GaugeHoverCard title={title} rows={hoverRows} footer={footer} trigger={cell} />\n    ) : (\n      cell\n    );\n  }\n\n  const body = (\n    <div\n      className={cn(\"flex flex-col items-center gap-1\", className)}\n      {...(useHover ? {} : { title: !showLabel ? titleText : undefined })}\n      aria-label={useHover || !showLabel ? titleText : undefined}\n      data-shape={shape}\n    >\n      {shape === \"linear\" ? (\n        <div className=\"flex w-full items-center gap-2\">\n          <GaugeBar pct={pct} toneBg={toneBg} className=\"h-2 w-full\" />\n          <span className=\"shrink-0 text-sm font-semibold text-foreground\">{readout}</span>\n          {canExpand && (\n            <button\n              type=\"button\"\n              aria-label=\"Expand chart\"\n              onClick={() => setExpanded(true)}\n              className=\"shrink-0 text-muted-foreground hover:text-foreground\"\n            >\n              <Icon icon={UiFullscreen} width={12} height={12} />\n            </button>\n          )}\n        </div>\n      ) : (\n        <div className=\"relative h-10 w-20\">\n          <GaugeArc pct={pct} tone={tone} strokeWidth={9} />\n          <span className=\"absolute inset-x-0 bottom-0 text-center text-sm font-semibold text-foreground\">\n            {readout}\n          </span>\n          {canExpand && (\n            <button\n              type=\"button\"\n              aria-label=\"Expand chart\"\n              onClick={() => setExpanded(true)}\n              className=\"absolute right-0 top-0 text-muted-foreground hover:text-foreground\"\n            >\n              <Icon icon={UiFullscreen} width={12} height={12} />\n            </button>\n          )}\n        </div>\n      )}\n      {icon || showLabel ? (\n        <div className=\"flex items-center gap-1 text-xs text-muted-foreground\">\n          {icon ? <GaugeIcon icon={icon} /> : null}\n          {showLabel ? <span>{title}</span> : null}\n        </div>\n      ) : null}\n    </div>\n  );\n\n  return (\n    <>\n      {useHover ? (\n        <GaugeHoverCard\n          title={title}\n          rows={hoverRows}\n          footer={footer}\n          trigger={body}\n          className=\"w-full justify-center\"\n        />\n      ) : (\n        body\n      )}\n      {canExpand && (\n        <Modal open={expanded} onClose={() => setExpanded(false)} title={title} size=\"xl\">\n          <TimeseriesPanel\n            title={title}\n            {...(icon ? { icon } : {})}\n            {...(unit ? { unit } : {})}\n            baseUrl={baseUrl}\n            series={chartSeries}\n            range={range}\n            refreshMs={refreshMs}\n            expandable={false}\n            fetcher={fetcher}\n          />\n        </Modal>\n      )}\n    </>\n  );\n}\n"],"names":["jsxs","jsx","cn","Icon","useState","useMemo","useQueries","formatUnit","seriesStats","GaugeHoverCard","UiFullscreen","Fragment","Modal","TimeseriesPanel"],"mappings":"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"}

package/dist/data/TimeseriesGauge.d.ts

@@ -8,6 +8,8 @@ export interface GaugeSeries {
     transform?: (value: number) => number;
 }
 export type TimeseriesGaugeVariant = "default" | "cell";
+/** Gauge fill geometry: a half-circle arc (default) or a horizontal progress bar. */
+export type TimeseriesGaugeShape = "radial" | "linear";
 export interface TimeseriesGaugeProps {
     /** Common prefix; the value/max requests are `baseUrl + id`. */
     baseUrl?: string;
@@ -42,8 +44,15 @@ export interface TimeseriesGaugeProps {
     centerDisplay?: "value" | "percent";
     /** Visual density/layout. `cell` is a compact inline form for table/grid cells. */
     variant?: TimeseriesGaugeVariant;
+    /** Fill geometry: a radial half-gauge (default) or a horizontal progress bar. */
+    shape?: TimeseriesGaugeShape;
     /** Show the title text. Icons and values remain visible when false. */
     showLabel?: boolean;
+    /**
+     * Wrap the gauge in a hover card summarising the metric (label + current / min /
+     * max / avg / capacity over the window). Defaults to true.
+     */
+    hoverCard?: boolean;
     /** Override the default fetch (e.g. to route through an app's API client). */
     fetcher?: (url: string) => Promise<TimeseriesResponse>;
     className?: string;
@@ -57,5 +66,5 @@ export interface TimeseriesGaugeProps {
  * chart in a modal (a `TimeseriesPanel`), so the gauge gives the at-a-glance
  * reading and the chart the trend.
  */
-export declare function TimeseriesGauge({ baseUrl, value, max, title, icon, unit, range, refreshMs, expandable, thresholds, centerDisplay, variant, showLabel, fetcher, className, }: TimeseriesGaugeProps): import("react/jsx-runtime").JSX.Element;
+export declare function TimeseriesGauge({ baseUrl, value, max, title, icon, unit, range, refreshMs, expandable, thresholds, centerDisplay, variant, shape, showLabel, hoverCard, fetcher, className, }: TimeseriesGaugeProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=TimeseriesGauge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TimeseriesGauge.d.ts","sourceRoot":"","sources":["../../src/data/TimeseriesGauge.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAQ,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,mFAAmF;IACnF,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAY,EACZ,KAAK,EACL,GAAG,EACH,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAY,EACZ,SAAgB,EAChB,UAAiB,EACjB,UAAqB,EACrB,aAAuB,EACvB,OAAmB,EACnB,SAAgB,EAChB,OAAwB,EACxB,SAAS,GACV,EAAE,oBAAoB,2CAgKtB"}
+{"version":3,"file":"TimeseriesGauge.d.ts","sourceRoot":"","sources":["../../src/data/TimeseriesGauge.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAQ,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,mBAAmB,CAAC;AAI3B,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAAC;AACxD,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,mFAAmF;IACnF,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iFAAiF;IACjF,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0ED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAY,EACZ,KAAK,EACL,GAAG,EACH,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAY,EACZ,SAAgB,EAChB,UAAiB,EACjB,UAAqB,EACrB,aAAuB,EACvB,OAAmB,EACnB,KAAgB,EAChB,SAAgB,EAChB,SAAgB,EAChB,OAAwB,EACxB,SAAS,GACV,EAAE,oBAAoB,2CAoMtB"}