@flanksource/clicky-ui 0.2.4 → 0.2.6

package/dist/data/TimeseriesPanel.cjs

@@ -0,0 +1,324 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const reactQuery = require("@tanstack/react-query");
+const react = require("react");
+const recharts = require("recharts");
+const utils = require("../lib/utils.cjs");
+const color = require("../lib/color.cjs");
+const format = require("../lib/format.cjs");
+const Modal = require("../overlay/Modal.cjs");
+const ProgressBar = require("./ProgressBar.cjs");
+const Icon = require("./Icon.cjs");
+const TimeseriesPanel_axes = require("./TimeseriesPanel.axes.cjs");
+const UiFullscreen = require("../icons/components/UiFullscreen.cjs");
+const SERIES_PALETTE = [
+  "var(--chart-1, #3b82f6)",
+  "var(--chart-2, #ef4444)",
+  "var(--chart-3, #10b981)",
+  "var(--chart-4, #f59e0b)"
+];
+function paletteColor(index) {
+  return SERIES_PALETTE[index % SERIES_PALETTE.length] ?? SERIES_PALETTE[0];
+}
+function resolveSeries(props) {
+  const base = props.baseUrl ?? "";
+  const list = props.series ?? (props.url ? [{ id: props.url }] : []);
+  return list.map((s, i) => ({
+    key: s.id,
+    url: base + s.id,
+    label: s.label ?? s.id,
+    color: s.color ?? paletteColor(i),
+    ...s.unit ?? props.unit ? { unit: s.unit ?? props.unit } : {},
+    ...s.transform ? { transform: s.transform } : {},
+    ...s.current !== void 0 ? { current: s.current } : {}
+  }));
+}
+function resolveBreakdown(series, rows, total) {
+  const withValue = series.map((s) => ({ s, value: s.current ?? TimeseriesPanel_axes.latestOf(rows, s.key) ?? 0 }));
+  const denom = total ?? withValue.reduce((acc, w) => acc + w.value, 0);
+  const items = withValue.map(({ s, value }) => ({
+    key: s.key,
+    label: s.label,
+    color: s.color,
+    ...s.unit ? { unit: s.unit } : {},
+    value,
+    percent: denom > 0 ? Math.min(100, Math.max(0, value / denom * 100)) : 0
+  }));
+  return { items, total: denom };
+}
+const defaultFetcher = async (url) => {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`metrics request failed: ${res.status}`);
+  return res.json();
+};
+function formatClock(at) {
+  const date = new Date(at);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+}
+function mergeSeries(series, pointsBySeries) {
+  const rows = /* @__PURE__ */ new Map();
+  series.forEach((s, i) => {
+    for (const p of pointsBySeries[i] ?? []) {
+      const row = rows.get(p.at) ?? { at: p.at };
+      row[s.key] = s.transform ? s.transform(p.value) : p.value;
+      rows.set(p.at, row);
+    }
+  });
+  return [...rows.values()].sort((a, b) => a.at.localeCompare(b.at));
+}
+function TimeseriesPanel(props) {
+  var _a;
+  const {
+    title,
+    icon,
+    unit,
+    range = "1h",
+    refreshMs = 5e3,
+    height = 160,
+    variant = "area",
+    expandable = true,
+    total,
+    fetcher = defaultFetcher,
+    className
+  } = props;
+  const isBreakdown = variant === "breakdown";
+  const chartVariant = isBreakdown ? "area" : variant;
+  const expandVariant = props.expandVariant ?? chartVariant;
+  const [expanded, setExpanded] = react.useState(false);
+  const series = react.useMemo(() => resolveSeries(props), [props]);
+  const requestUrls = react.useMemo(
+    () => series.map((s) => {
+      const u = new URL(s.url, window.location.origin);
+      if (range) u.searchParams.set("since", range);
+      return u.pathname + u.search;
+    }),
+    [series, range]
+  );
+  const results = reactQuery.useQueries({
+    queries: requestUrls.map((requestUrl) => ({
+      queryKey: ["timeseries", requestUrl],
+      queryFn: () => fetcher(requestUrl),
+      refetchInterval: refreshMs > 0 ? refreshMs : false,
+      staleTime: 0,
+      retry: 0
+    }))
+  });
+  const isError = results.some((r) => r.isError);
+  const error = (_a = results.find((r) => r.isError)) == null ? void 0 : _a.error;
+  const isLoading = results.some((r) => r.isLoading) && results.every((r) => !r.data);
+  const pointsBySeries = results.map((r) => {
+    var _a2;
+    return (_a2 = r.data) == null ? void 0 : _a2.points;
+  });
+  const rows = react.useMemo(() => mergeSeries(series, pointsBySeries), [series, pointsBySeries]);
+  const hasMirrored = series.some((s) => s.transform);
+  const breakdown = react.useMemo(
+    () => isBreakdown ? resolveBreakdown(series, rows, total) : null,
+    [isBreakdown, series, rows, total]
+  );
+  const canExpand = expandable && rows.length >= 2;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: utils.cn("flex flex-col rounded-lg border border-border bg-card p-3", className), children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-2 text-xs text-muted-foreground", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "inline-flex min-w-0 items-center gap-1.5", children: [
+        icon ? /* @__PURE__ */ jsxRuntime.jsx(PanelIcon, { icon }) : null,
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate font-medium text-foreground", children: title })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "inline-flex shrink-0 items-center gap-1.5", children: [
+        breakdown ? /* @__PURE__ */ jsxRuntime.jsx(BreakdownReadout, { total: breakdown.total, unit, items: breakdown.items }) : /* @__PURE__ */ jsxRuntime.jsx(LatestReadout, { series, rows }),
+        canExpand ? /* @__PURE__ */ jsxRuntime.jsx(
+          "button",
+          {
+            type: "button",
+            "aria-label": "Expand chart",
+            onClick: () => setExpanded(true),
+            className: "text-muted-foreground transition-colors hover:text-foreground",
+            children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiFullscreen.UiFullscreen, width: 14, height: 14 })
+          }
+        ) : null
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mt-2", style: breakdown ? void 0 : { height }, children: breakdown ? /* @__PURE__ */ jsxRuntime.jsx(BreakdownView, { total: breakdown.total, unit, items: breakdown.items }) : isError ? /* @__PURE__ */ jsxRuntime.jsx(PanelMessage, { children: (error == null ? void 0 : error.message) ?? "Failed to load metric" }) : isLoading ? /* @__PURE__ */ jsxRuntime.jsx(PanelMessage, { children: "Loading…" }) : rows.length < 2 ? /* @__PURE__ */ jsxRuntime.jsx(PanelMessage, { children: "Collecting data…" }) : /* @__PURE__ */ jsxRuntime.jsx(Chart, { rows, series, variant: chartVariant, unit, showZeroLine: hasMirrored }) }),
+    !breakdown && !isError && !isLoading && rows.length >= 2 && series.length > 1 ? /* @__PURE__ */ jsxRuntime.jsx(ChartLegend, { series, rows }) : null,
+    canExpand ? /* @__PURE__ */ jsxRuntime.jsxs(Modal.Modal, { open: expanded, onClose: () => setExpanded(false), title, size: "xl", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("div", { style: { height: 360 }, children: /* @__PURE__ */ jsxRuntime.jsx(Chart, { rows, series, variant: expandVariant, unit, showZeroLine: hasMirrored }) }),
+      series.length > 1 ? /* @__PURE__ */ jsxRuntime.jsx(ChartLegend, { series, rows }) : null
+    ] }) : null
+  ] });
+}
+function LatestReadout({ series, rows }) {
+  const only = series.length === 1 ? series[0] : void 0;
+  if (!only) return null;
+  const v = TimeseriesPanel_axes.latestOf(rows, only.key);
+  if (v === void 0) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { className: "tabular-nums", children: format.formatUnit(Math.abs(v), only.unit) });
+}
+function ChartLegend({ series, rows }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "mt-1.5 flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted-foreground", children: series.map((s) => {
+    const v = TimeseriesPanel_axes.latestOf(rows, s.key);
+    return /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "inline-flex min-w-0 items-center gap-1.5", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          className: "h-2 w-2 shrink-0 rounded-full",
+          style: { backgroundColor: color.resolveCssColor(s.color) },
+          "aria-hidden": true
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-foreground", children: s.label }),
+      v !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "tabular-nums", children: format.formatUnit(Math.abs(v), s.unit) }) : null
+    ] }, s.key);
+  }) });
+}
+function BreakdownReadout({
+  total,
+  unit,
+  items
+}) {
+  const used = items.reduce((acc, it) => acc + it.value, 0);
+  const pct = total > 0 ? Math.min(100, used / total * 100) : 0;
+  return /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "font-mono tabular-nums", children: [
+    format.formatUnit(used, unit),
+    " / ",
+    format.formatUnit(total, unit),
+    " · ",
+    pct.toFixed(0),
+    "%"
+  ] });
+}
+function BreakdownView({
+  total,
+  unit,
+  items
+}) {
+  const segments = items.map((it) => ({
+    count: it.value,
+    color: it.color,
+    label: it.label
+  }));
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-2", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ProgressBar.ProgressBar, { segments, total: total > 0 ? total : 1, height: "h-3" }),
+    items.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "grid grid-cols-1 gap-y-1 text-xs", children: items.map((it) => /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          className: "h-2 w-2 shrink-0 rounded-full",
+          style: { backgroundColor: color.resolveCssColor(it.color) },
+          "aria-hidden": true
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 flex-1 truncate font-mono text-muted-foreground", children: it.label }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-mono tabular-nums text-foreground", children: format.formatUnit(it.value, it.unit ?? unit) }),
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "w-10 text-right font-mono tabular-nums text-muted-foreground", children: [
+        it.percent.toFixed(0),
+        "%"
+      ] })
+    ] }, it.key)) }) : null
+  ] });
+}
+function Chart({
+  rows,
+  series,
+  variant,
+  unit,
+  showZeroLine
+}) {
+  const stacked = variant === "stacked";
+  const seriesByKey = new Map(series.map((s) => [s.key, s]));
+  const strokeOf = (s) => color.resolveCssColor(s.color);
+  const { axes: yAxes, axisOfKey } = react.useMemo(() => TimeseriesPanel_axes.assignAxes(series), [series]);
+  const axisOf = (key) => axisOfKey.get(key) ?? "left";
+  const axes = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(recharts.CartesianGrid, { strokeOpacity: 0.12, vertical: false }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      recharts.XAxis,
+      {
+        dataKey: "at",
+        tickFormatter: formatClock,
+        tick: { fontSize: 10 },
+        stroke: "currentColor",
+        strokeOpacity: 0.35,
+        minTickGap: 32
+      }
+    ),
+    yAxes.map((ax) => /* @__PURE__ */ jsxRuntime.jsx(
+      recharts.YAxis,
+      {
+        yAxisId: ax.id,
+        orientation: ax.orientation,
+        tick: { fontSize: 10 },
+        stroke: "currentColor",
+        strokeOpacity: 0.35,
+        width: 40,
+        tickFormatter: (v) => format.formatUnit(Math.abs(v), ax.unit)
+      },
+      ax.id
+    )),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      recharts.Tooltip,
+      {
+        labelFormatter: (label) => formatClock(String(label)),
+        formatter: (value, name) => {
+          const s = seriesByKey.get(String(name));
+          return [format.formatUnit(Math.abs(Number(value) || 0), (s == null ? void 0 : s.unit) ?? unit), (s == null ? void 0 : s.label) ?? String(name)];
+        },
+        contentStyle: { fontSize: 12 }
+      }
+    ),
+    showZeroLine ? /* @__PURE__ */ jsxRuntime.jsx(recharts.ReferenceLine, { yAxisId: "left", y: 0, stroke: "currentColor", strokeOpacity: 0.35 }) : null
+  ] });
+  return /* @__PURE__ */ jsxRuntime.jsx(recharts.ResponsiveContainer, { width: "100%", height: "100%", children: variant === "line" ? /* @__PURE__ */ jsxRuntime.jsxs(recharts.LineChart, { data: rows, margin: { top: 4, right: 8, bottom: 0, left: 0 }, children: [
+    axes,
+    series.map((s) => /* @__PURE__ */ jsxRuntime.jsx(
+      recharts.Line,
+      {
+        yAxisId: axisOf(s.key),
+        type: "monotone",
+        dataKey: s.key,
+        name: s.key,
+        stroke: strokeOf(s),
+        strokeWidth: 2,
+        dot: false,
+        connectNulls: true,
+        isAnimationActive: false
+      },
+      s.key
+    ))
+  ] }) : /* @__PURE__ */ jsxRuntime.jsxs(recharts.AreaChart, { data: rows, margin: { top: 4, right: 8, bottom: 0, left: 0 }, children: [
+    axes,
+    series.map((s) => /* @__PURE__ */ jsxRuntime.jsx(
+      recharts.Area,
+      {
+        yAxisId: axisOf(s.key),
+        type: "monotone",
+        dataKey: s.key,
+        name: s.key,
+        stroke: strokeOf(s),
+        fill: strokeOf(s),
+        ...stacked ? { stackId: `stack-${axisOf(s.key)}` } : {},
+        fillOpacity: stacked ? 0.7 : 0.12,
+        strokeWidth: stacked ? 0 : 2,
+        connectNulls: true,
+        isAnimationActive: false
+      },
+      s.key
+    ))
+  ] }) });
+}
+function PanelMessage({ children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex h-full items-center justify-center text-xs text-muted-foreground", children });
+}
+function PanelIcon({ icon }) {
+  if (typeof icon === "string") {
+    return /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { name: icon, width: 16, height: 16, className: "text-muted-foreground" });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon, width: 16, height: 16, className: "text-muted-foreground" });
+}
+exports.assignAxes = TimeseriesPanel_axes.assignAxes;
+exports.latestOf = TimeseriesPanel_axes.latestOf;
+exports.TimeseriesPanel = TimeseriesPanel;
+exports.mergeSeries = mergeSeries;
+exports.resolveBreakdown = resolveBreakdown;
+exports.resolveSeries = resolveSeries;
+//# sourceMappingURL=TimeseriesPanel.cjs.map

package/dist/data/TimeseriesPanel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeseriesPanel.cjs","sources":["../../src/data/TimeseriesPanel.tsx"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useMemo, useState } from \"react\";\nimport {\n  Area,\n  AreaChart,\n  CartesianGrid,\n  Line,\n  LineChart,\n  ReferenceLine,\n  ResponsiveContainer,\n  Tooltip,\n  XAxis,\n  YAxis,\n} from \"recharts\";\nimport { cn } from \"../lib/utils\";\nimport { resolveCssColor } from \"../lib/color\";\nimport { formatUnit } from \"../lib/format\";\nimport { Modal } from \"../overlay/Modal\";\nimport { ProgressBar, type ProgressSegment } from \"./ProgressBar\";\nimport { UiFullscreen } from \"../icons\";\nimport { Icon, type StaticIconComponent } from \"./Icon\";\nimport { assignAxes, latestOf } from \"./TimeseriesPanel.axes\";\n\nexport { assignAxes, latestOf } from \"./TimeseriesPanel.axes\";\nexport type { AxisAssignment, AxisOrientation, AxisSpec } from \"./TimeseriesPanel.axes\";\n\nexport interface TimeseriesPoint {\n  at: string;\n  value: number;\n}\n\nexport interface TimeseriesResponse {\n  id: string;\n  points: TimeseriesPoint[];\n}\n\n/** One metric plotted on a panel. Its request URL is `baseUrl + id`. */\nexport interface TimeseriesSeries {\n  /** Metric id appended to the panel's baseUrl, e.g. \"sqlserver.iops.read\". */\n  id: string;\n  /** Tooltip/legend label; defaults to the id. */\n  label?: string;\n  /**\n   * Maps each point's value before plotting — e.g. writes pass `(v) => -v` to\n   * render below the zero axis. Identity when omitted.\n   */\n  transform?: (value: number) => number;\n  /**\n   * Stroke/fill override as a CSS color value (e.g. \"#10b981\", \"var(--chart-3)\")\n   * or a Tailwind color class (e.g. \"bg-emerald-500\"); Tailwind classes are\n   * resolved to a CSS value for the chart. Defaults cycle a small palette by index.\n   */\n  color?: string;\n  /**\n   * Grafana-style unit key for this series' readout/tooltip (e.g. \"percent\",\n   * \"short\"). Falls back to the panel-level `unit`. Lets one panel mix units\n   * (e.g. a percent series alongside a plain-count series).\n   */\n  unit?: string;\n  /**\n   * Instantaneous value for the `breakdown` variant — the size of this series'\n   * bar segment and its legend readout. When omitted, the breakdown falls back\n   * to the latest polled point. Ignored by the time-series variants.\n   */\n  current?: number;\n}\n\nexport interface TimeseriesPanelProps {\n  /**\n   * Single-metric endpoint returning a TimeseriesResponse,\n   * e.g. \"/api/v1/metrics/sqlserver.cpu\". Mutually exclusive with baseUrl/series.\n   */\n  url?: string;\n  /** Common prefix for a multi-series panel; each series requests `baseUrl + series.id`. */\n  baseUrl?: string;\n  /** Metrics to plot on one chart. Provide together with baseUrl. */\n  series?: TimeseriesSeries[];\n  title: string;\n  /** Iconify name or static icon component shown beside the title. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Default Grafana-style unit key for the panel (e.g. \"bytes\", \"percent\",\n   * \"ms\", \"short\"); each series may override it. Unknown strings are appended\n   * as a raw suffix (so \"%\" still works). Used for the readout, axis, and tooltip.\n   */\n  unit?: string;\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  /** Chart height in px; defaults to 160. */\n  height?: number;\n  /**\n   * \"area\" (overlaid, default), \"line\", \"stacked\" (areas sum vertically), or\n   * \"breakdown\" (an instantaneous stacked bar + legend; the expand modal still\n   * shows a time-series graph of the polled history).\n   */\n  variant?: \"area\" | \"line\" | \"stacked\" | \"breakdown\";\n  /**\n   * Chart variant rendered in the expand modal. Defaults to `variant` for the\n   * time-series variants and to \"area\" for `breakdown` (which has no inline chart).\n   */\n  expandVariant?: \"area\" | \"line\" | \"stacked\";\n  /**\n   * Denominator for the `breakdown` bar and per-segment percentages. Defaults to\n   * the sum of the series' `current` values when omitted.\n   */\n  total?: number;\n  /** Show a header button that opens the chart larger in a modal. Default true. */\n  expandable?: 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 SERIES_PALETTE = [\n  \"var(--chart-1, #3b82f6)\",\n  \"var(--chart-2, #ef4444)\",\n  \"var(--chart-3, #10b981)\",\n  \"var(--chart-4, #f59e0b)\",\n] as const;\n\nfunction paletteColor(index: number): string {\n  return SERIES_PALETTE[index % SERIES_PALETTE.length] ?? SERIES_PALETTE[0];\n}\n\n/** A series with its full request URL, resolved label, color, and unit. Exported for tests. */\nexport interface ResolvedSeries {\n  /** Stable key used as the merged-row field and recharts dataKey. */\n  key: string;\n  url: string;\n  label: string;\n  color: string;\n  /** Resolved Grafana unit key: the series' own unit, else the panel default. */\n  unit?: string;\n  transform?: (value: number) => number;\n  /** Instantaneous value used by the `breakdown` variant. */\n  current?: number;\n}\n\n/** Normalises the single-url and baseUrl+series forms to one list. Exported for tests. */\nexport function resolveSeries(props: TimeseriesPanelProps): ResolvedSeries[] {\n  const base = props.baseUrl ?? \"\";\n  const list = props.series ?? (props.url ? [{ id: props.url }] : []);\n  return list.map((s, i) => ({\n    key: s.id,\n    url: base + s.id,\n    label: s.label ?? s.id,\n    color: s.color ?? paletteColor(i),\n    ...(s.unit ?? props.unit ? { unit: s.unit ?? props.unit } : {}),\n    ...(s.transform ? { transform: s.transform } : {}),\n    ...(s.current !== undefined ? { current: s.current } : {}),\n  }));\n}\n\n/** One legend/bar row of the breakdown variant: resolved value, color, label, unit, percentage. */\nexport interface BreakdownItem {\n  key: string;\n  label: string;\n  color: string;\n  unit?: string;\n  value: number;\n  /** Share of `total`, clamped to 0..100. */\n  percent: number;\n}\n\n/**\n * Derives the breakdown bar segments and per-item percentages from the resolved\n * series' `current` values. `total` defaults to the sum of those values; the\n * percentage is each value's share of that denominator, clamped to 0..100.\n * Latest polled point fills in for a series with no explicit `current`. Pure —\n * exported for tests.\n */\nexport function resolveBreakdown(\n  series: ResolvedSeries[],\n  rows: MergedRow[],\n  total?: number,\n): { items: BreakdownItem[]; total: number } {\n  const withValue = series.map((s) => ({ s, value: s.current ?? latestOf(rows, s.key) ?? 0 }));\n  const denom = total ?? withValue.reduce((acc, w) => acc + w.value, 0);\n  const items = withValue.map(({ s, value }) => ({\n    key: s.key,\n    label: s.label,\n    color: s.color,\n    ...(s.unit ? { unit: s.unit } : {}),\n    value,\n    percent: denom > 0 ? Math.min(100, Math.max(0, (value / denom) * 100)) : 0,\n  }));\n  return { items, total: denom };\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 formatClock(at: string): string {\n  const date = new Date(at);\n  if (Number.isNaN(date.getTime())) return \"\";\n  return date.toLocaleTimeString([], { hour: \"2-digit\", minute: \"2-digit\" });\n}\n\n/**\n * One row of the merged chart data: the timestamp in `at` plus each series'\n * value under its key. Values are absent (undefined) where a series has no\n * point at that timestamp.\n */\nexport interface MergedRow {\n  at: string;\n  [seriesKey: string]: string | number | undefined;\n}\n\n/**\n * Joins per-series point lists into rows keyed by timestamp and applies each\n * series' transform. Timestamps present in any series produce a row; missing\n * values are left undefined so recharts gaps the line rather than drawing zero.\n */\nexport function mergeSeries(\n  series: ResolvedSeries[],\n  pointsBySeries: (TimeseriesPoint[] | undefined)[],\n): MergedRow[] {\n  const rows = new Map<string, MergedRow>();\n  series.forEach((s, i) => {\n    for (const p of pointsBySeries[i] ?? []) {\n      const row = rows.get(p.at) ?? { at: p.at };\n      row[s.key] = s.transform ? s.transform(p.value) : p.value;\n      rows.set(p.at, row);\n    }\n  });\n  return [...rows.values()].sort((a, b) => a.at.localeCompare(b.at));\n}\n\nexport function TimeseriesPanel(props: TimeseriesPanelProps) {\n  const {\n    title,\n    icon,\n    unit,\n    range = \"1h\",\n    refreshMs = 5000,\n    height = 160,\n    variant = \"area\",\n    expandable = true,\n    total,\n    fetcher = defaultFetcher,\n    className,\n  } = props;\n  const isBreakdown = variant === \"breakdown\";\n  // The inline chart (non-breakdown only) and the expand modal both need a\n  // time-series variant; breakdown has no inline chart and expands to \"area\".\n  const chartVariant: ChartVariant = isBreakdown ? \"area\" : variant;\n  const expandVariant = props.expandVariant ?? chartVariant;\n\n  const [expanded, setExpanded] = useState(false);\n\n  const series = useMemo(() => resolveSeries(props), [props]);\n  const requestUrls = useMemo(\n    () =>\n      series.map((s) => {\n        const u = new URL(s.url, window.location.origin);\n        if (range) u.searchParams.set(\"since\", range);\n        return u.pathname + u.search;\n      }),\n    [series, range],\n  );\n\n  const results = useQueries({\n    queries: requestUrls.map((requestUrl) => ({\n      queryKey: [\"timeseries\", requestUrl],\n      queryFn: () => fetcher(requestUrl),\n      refetchInterval: refreshMs > 0 ? refreshMs : false,\n      staleTime: 0,\n      retry: 0,\n    })),\n  });\n\n  const isError = results.some((r) => r.isError);\n  const error = results.find((r) => r.isError)?.error;\n  const isLoading = results.some((r) => r.isLoading) && results.every((r) => !r.data);\n  const pointsBySeries = results.map((r) => r.data?.points);\n  const rows = useMemo(() => mergeSeries(series, pointsBySeries), [series, pointsBySeries]);\n  const hasMirrored = series.some((s) => s.transform);\n  const breakdown = useMemo(\n    () => (isBreakdown ? resolveBreakdown(series, rows, total) : null),\n    [isBreakdown, series, rows, total],\n  );\n\n  // Breakdown renders instantly from `current`; the modal still needs polled\n  // history. Other variants gate on having ≥2 points to draw a line.\n  const canExpand = expandable && rows.length >= 2;\n\n  return (\n    <div className={cn(\"flex flex-col rounded-lg border border-border bg-card p-3\", className)}>\n      <div className=\"flex items-center justify-between gap-2 text-xs text-muted-foreground\">\n        <span className=\"inline-flex min-w-0 items-center gap-1.5\">\n          {icon ? <PanelIcon icon={icon} /> : null}\n          <span className=\"truncate font-medium text-foreground\">{title}</span>\n        </span>\n        <span className=\"inline-flex shrink-0 items-center gap-1.5\">\n          {breakdown ? (\n            <BreakdownReadout total={breakdown.total} unit={unit} items={breakdown.items} />\n          ) : (\n            <LatestReadout series={series} rows={rows} />\n          )}\n          {canExpand ? (\n            <button\n              type=\"button\"\n              aria-label=\"Expand chart\"\n              onClick={() => setExpanded(true)}\n              className=\"text-muted-foreground transition-colors hover:text-foreground\"\n            >\n              <Icon icon={UiFullscreen} width={14} height={14} />\n            </button>\n          ) : null}\n        </span>\n      </div>\n      <div className=\"mt-2\" style={breakdown ? undefined : { height }}>\n        {breakdown ? (\n          <BreakdownView total={breakdown.total} unit={unit} items={breakdown.items} />\n        ) : isError ? (\n          <PanelMessage>{(error as Error)?.message ?? \"Failed to load metric\"}</PanelMessage>\n        ) : isLoading ? (\n          <PanelMessage>Loading…</PanelMessage>\n        ) : rows.length < 2 ? (\n          <PanelMessage>Collecting data…</PanelMessage>\n        ) : (\n          <Chart rows={rows} series={series} variant={chartVariant} unit={unit} showZeroLine={hasMirrored} />\n        )}\n      </div>\n      {!breakdown && !isError && !isLoading && rows.length >= 2 && series.length > 1 ? (\n        <ChartLegend series={series} rows={rows} />\n      ) : null}\n      {canExpand ? (\n        <Modal open={expanded} onClose={() => setExpanded(false)} title={title} size=\"xl\">\n          <div style={{ height: 360 }}>\n            <Chart rows={rows} series={series} variant={expandVariant} unit={unit} showZeroLine={hasMirrored} />\n          </div>\n          {series.length > 1 ? <ChartLegend series={series} rows={rows} /> : null}\n        </Modal>\n      ) : null}\n    </div>\n  );\n}\n\n/**\n * Header readout for a single-series panel: the latest value, formatted with the\n * series' unit. Multi-series panels render the per-series values in {@link ChartLegend}\n * below the chart instead, so this returns null for them to avoid overlapping the title.\n */\nfunction LatestReadout({ series, rows }: { series: ResolvedSeries[]; rows: MergedRow[] }) {\n  const only = series.length === 1 ? series[0] : undefined;\n  if (!only) return null;\n  const v = latestOf(rows, only.key);\n  if (v === undefined) return null;\n  return <span className=\"tabular-nums\">{formatUnit(Math.abs(v), only.unit)}</span>;\n}\n\n/** Wrapping color-keyed legend for the time-series variants: dot + label + latest value. */\nfunction ChartLegend({ series, rows }: { series: ResolvedSeries[]; rows: MergedRow[] }) {\n  return (\n    <ul className=\"mt-1.5 flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted-foreground\">\n      {series.map((s) => {\n        const v = latestOf(rows, s.key);\n        return (\n          <li key={s.key} className=\"inline-flex min-w-0 items-center gap-1.5\">\n            <span\n              className=\"h-2 w-2 shrink-0 rounded-full\"\n              style={{ backgroundColor: resolveCssColor(s.color) }}\n              aria-hidden\n            />\n            <span className=\"truncate text-foreground\">{s.label}</span>\n            {v !== undefined ? (\n              <span className=\"tabular-nums\">{formatUnit(Math.abs(v), s.unit)}</span>\n            ) : null}\n          </li>\n        );\n      })}\n    </ul>\n  );\n}\n\n/** Breakdown header readout: `used / total · pct%`, where used is the sum of segments. */\nfunction BreakdownReadout({\n  total,\n  unit,\n  items,\n}: {\n  total: number;\n  unit: string | undefined;\n  items: BreakdownItem[];\n}) {\n  const used = items.reduce((acc, it) => acc + it.value, 0);\n  const pct = total > 0 ? Math.min(100, (used / total) * 100) : 0;\n  return (\n    <span className=\"font-mono tabular-nums\">\n      {formatUnit(used, unit)} / {formatUnit(total, unit)} · {pct.toFixed(0)}%\n    </span>\n  );\n}\n\n/** Instantaneous stacked bar + legend list. The expand button (in the panel header) opens the graph. */\nfunction BreakdownView({\n  total,\n  unit,\n  items,\n}: {\n  total: number;\n  unit: string | undefined;\n  items: BreakdownItem[];\n}) {\n  const segments: ProgressSegment[] = items.map((it) => ({\n    count: it.value,\n    color: it.color,\n    label: it.label,\n  }));\n  return (\n    <div className=\"flex flex-col gap-2\">\n      <ProgressBar segments={segments} total={total > 0 ? total : 1} height=\"h-3\" />\n      {items.length > 0 ? (\n        <ul className=\"grid grid-cols-1 gap-y-1 text-xs\">\n          {items.map((it) => (\n            <li key={it.key} className=\"flex items-center gap-2\">\n              <span\n                className=\"h-2 w-2 shrink-0 rounded-full\"\n                style={{ backgroundColor: resolveCssColor(it.color) }}\n                aria-hidden\n              />\n              <span className=\"min-w-0 flex-1 truncate font-mono text-muted-foreground\">\n                {it.label}\n              </span>\n              <span className=\"font-mono tabular-nums text-foreground\">\n                {formatUnit(it.value, it.unit ?? unit)}\n              </span>\n              <span className=\"w-10 text-right font-mono tabular-nums text-muted-foreground\">\n                {it.percent.toFixed(0)}%\n              </span>\n            </li>\n          ))}\n        </ul>\n      ) : null}\n    </div>\n  );\n}\n\ntype ChartVariant = \"area\" | \"line\" | \"stacked\";\n\nfunction Chart({\n  rows,\n  series,\n  variant,\n  unit,\n  showZeroLine,\n}: {\n  rows: MergedRow[];\n  series: ResolvedSeries[];\n  variant: ChartVariant;\n  unit: string | undefined;\n  showZeroLine: boolean;\n}) {\n  const stacked = variant === \"stacked\";\n  // Mirrored series carry negative values; show magnitudes on axis and tooltip.\n  const seriesByKey = new Map(series.map((s) => [s.key, s]));\n  // recharts needs a CSS color value; a series may carry a Tailwind class.\n  const strokeOf = (s: ResolvedSeries) => resolveCssColor(s.color);\n  // Distinct units map to a left and (when present) right axis; each series draws\n  // against the axis for its unit so mixed-unit panels keep independent scales.\n  const { axes: yAxes, axisOfKey } = useMemo(() => assignAxes(series), [series]);\n  const axisOf = (key: string): \"left\" | \"right\" => axisOfKey.get(key) ?? \"left\";\n  const axes = (\n    <>\n      <CartesianGrid strokeOpacity={0.12} vertical={false} />\n      <XAxis\n        dataKey=\"at\"\n        tickFormatter={formatClock}\n        tick={{ fontSize: 10 }}\n        stroke=\"currentColor\"\n        strokeOpacity={0.35}\n        minTickGap={32}\n      />\n      {yAxes.map((ax) => (\n        <YAxis\n          key={ax.id}\n          yAxisId={ax.id}\n          orientation={ax.orientation}\n          tick={{ fontSize: 10 }}\n          stroke=\"currentColor\"\n          strokeOpacity={0.35}\n          width={40}\n          tickFormatter={(v: number) => formatUnit(Math.abs(v), ax.unit)}\n        />\n      ))}\n      <Tooltip\n        labelFormatter={(label) => formatClock(String(label))}\n        formatter={(value, name) => {\n          const s = seriesByKey.get(String(name));\n          return [formatUnit(Math.abs(Number(value) || 0), s?.unit ?? unit), s?.label ?? String(name)];\n        }}\n        contentStyle={{ fontSize: 12 }}\n      />\n      {showZeroLine ? (\n        <ReferenceLine yAxisId=\"left\" y={0} stroke=\"currentColor\" strokeOpacity={0.35} />\n      ) : null}\n    </>\n  );\n\n  return (\n    <ResponsiveContainer width=\"100%\" height=\"100%\">\n      {variant === \"line\" ? (\n        <LineChart data={rows} margin={{ top: 4, right: 8, bottom: 0, left: 0 }}>\n          {axes}\n          {series.map((s) => (\n            <Line\n              key={s.key}\n              yAxisId={axisOf(s.key)}\n              type=\"monotone\"\n              dataKey={s.key}\n              name={s.key}\n              stroke={strokeOf(s)}\n              strokeWidth={2}\n              dot={false}\n              connectNulls\n              isAnimationActive={false}\n            />\n          ))}\n        </LineChart>\n      ) : (\n        <AreaChart data={rows} margin={{ top: 4, right: 8, bottom: 0, left: 0 }}>\n          {axes}\n          {series.map((s) => (\n            <Area\n              key={s.key}\n              yAxisId={axisOf(s.key)}\n              type=\"monotone\"\n              dataKey={s.key}\n              name={s.key}\n              stroke={strokeOf(s)}\n              fill={strokeOf(s)}\n              {...(stacked ? { stackId: `stack-${axisOf(s.key)}` } : {})}\n              fillOpacity={stacked ? 0.7 : 0.12}\n              strokeWidth={stacked ? 0 : 2}\n              connectNulls\n              isAnimationActive={false}\n            />\n          ))}\n        </AreaChart>\n      )}\n    </ResponsiveContainer>\n  );\n}\n\nfunction PanelMessage({ children }: { children: React.ReactNode }) {\n  return (\n    <div className=\"flex h-full items-center justify-center text-xs text-muted-foreground\">\n      {children}\n    </div>\n  );\n}\n\nfunction PanelIcon({ icon }: { icon: string | StaticIconComponent }) {\n  if (typeof icon === \"string\") {\n    return <Icon name={icon} width={16} height={16} className=\"text-muted-foreground\" />;\n  }\n  return <Icon icon={icon} width={16} height={16} className=\"text-muted-foreground\" />;\n}\n"],"names":["latestOf","useState","useMemo","useQueries","_a","cn","jsxs","jsx","Icon","UiFullscreen","Modal","formatUnit","resolveCssColor","ProgressBar","assignAxes","Fragment","CartesianGrid","XAxis","YAxis","Tooltip","ReferenceLine","ResponsiveContainer","LineChart","Line","AreaChart","Area"],"mappings":"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"}

package/dist/data/TimeseriesPanel.d.ts

@@ -0,0 +1,141 @@
+import { StaticIconComponent } from './Icon';
+export { assignAxes, latestOf } from './TimeseriesPanel.axes';
+export type { AxisAssignment, AxisOrientation, AxisSpec } from './TimeseriesPanel.axes';
+export interface TimeseriesPoint {
+    at: string;
+    value: number;
+}
+export interface TimeseriesResponse {
+    id: string;
+    points: TimeseriesPoint[];
+}
+/** One metric plotted on a panel. Its request URL is `baseUrl + id`. */
+export interface TimeseriesSeries {
+    /** Metric id appended to the panel's baseUrl, e.g. "sqlserver.iops.read". */
+    id: string;
+    /** Tooltip/legend label; defaults to the id. */
+    label?: string;
+    /**
+     * Maps each point's value before plotting — e.g. writes pass `(v) => -v` to
+     * render below the zero axis. Identity when omitted.
+     */
+    transform?: (value: number) => number;
+    /**
+     * Stroke/fill override as a CSS color value (e.g. "#10b981", "var(--chart-3)")
+     * or a Tailwind color class (e.g. "bg-emerald-500"); Tailwind classes are
+     * resolved to a CSS value for the chart. Defaults cycle a small palette by index.
+     */
+    color?: string;
+    /**
+     * Grafana-style unit key for this series' readout/tooltip (e.g. "percent",
+     * "short"). Falls back to the panel-level `unit`. Lets one panel mix units
+     * (e.g. a percent series alongside a plain-count series).
+     */
+    unit?: string;
+    /**
+     * Instantaneous value for the `breakdown` variant — the size of this series'
+     * bar segment and its legend readout. When omitted, the breakdown falls back
+     * to the latest polled point. Ignored by the time-series variants.
+     */
+    current?: number;
+}
+export interface TimeseriesPanelProps {
+    /**
+     * Single-metric endpoint returning a TimeseriesResponse,
+     * e.g. "/api/v1/metrics/sqlserver.cpu". Mutually exclusive with baseUrl/series.
+     */
+    url?: string;
+    /** Common prefix for a multi-series panel; each series requests `baseUrl + series.id`. */
+    baseUrl?: string;
+    /** Metrics to plot on one chart. Provide together with baseUrl. */
+    series?: TimeseriesSeries[];
+    title: string;
+    /** Iconify name or static icon component shown beside the title. */
+    icon?: string | StaticIconComponent;
+    /**
+     * Default Grafana-style unit key for the panel (e.g. "bytes", "percent",
+     * "ms", "short"); each series may override it. Unknown strings are appended
+     * as a raw suffix (so "%" still works). Used for the readout, axis, and tooltip.
+     */
+    unit?: string;
+    /** Look-back window passed as ?since=; defaults to "1h". */
+    range?: string;
+    /** Poll interval in ms; defaults to 5000. Pass 0 to disable polling. */
+    refreshMs?: number;
+    /** Chart height in px; defaults to 160. */
+    height?: number;
+    /**
+     * "area" (overlaid, default), "line", "stacked" (areas sum vertically), or
+     * "breakdown" (an instantaneous stacked bar + legend; the expand modal still
+     * shows a time-series graph of the polled history).
+     */
+    variant?: "area" | "line" | "stacked" | "breakdown";
+    /**
+     * Chart variant rendered in the expand modal. Defaults to `variant` for the
+     * time-series variants and to "area" for `breakdown` (which has no inline chart).
+     */
+    expandVariant?: "area" | "line" | "stacked";
+    /**
+     * Denominator for the `breakdown` bar and per-segment percentages. Defaults to
+     * the sum of the series' `current` values when omitted.
+     */
+    total?: number;
+    /** Show a header button that opens the chart larger in a modal. Default true. */
+    expandable?: boolean;
+    /** Override the default fetch (e.g. to route through an app's API client). */
+    fetcher?: (url: string) => Promise<TimeseriesResponse>;
+    className?: string;
+}
+/** A series with its full request URL, resolved label, color, and unit. Exported for tests. */
+export interface ResolvedSeries {
+    /** Stable key used as the merged-row field and recharts dataKey. */
+    key: string;
+    url: string;
+    label: string;
+    color: string;
+    /** Resolved Grafana unit key: the series' own unit, else the panel default. */
+    unit?: string;
+    transform?: (value: number) => number;
+    /** Instantaneous value used by the `breakdown` variant. */
+    current?: number;
+}
+/** Normalises the single-url and baseUrl+series forms to one list. Exported for tests. */
+export declare function resolveSeries(props: TimeseriesPanelProps): ResolvedSeries[];
+/** One legend/bar row of the breakdown variant: resolved value, color, label, unit, percentage. */
+export interface BreakdownItem {
+    key: string;
+    label: string;
+    color: string;
+    unit?: string;
+    value: number;
+    /** Share of `total`, clamped to 0..100. */
+    percent: number;
+}
+/**
+ * Derives the breakdown bar segments and per-item percentages from the resolved
+ * series' `current` values. `total` defaults to the sum of those values; the
+ * percentage is each value's share of that denominator, clamped to 0..100.
+ * Latest polled point fills in for a series with no explicit `current`. Pure —
+ * exported for tests.
+ */
+export declare function resolveBreakdown(series: ResolvedSeries[], rows: MergedRow[], total?: number): {
+    items: BreakdownItem[];
+    total: number;
+};
+/**
+ * One row of the merged chart data: the timestamp in `at` plus each series'
+ * value under its key. Values are absent (undefined) where a series has no
+ * point at that timestamp.
+ */
+export interface MergedRow {
+    at: string;
+    [seriesKey: string]: string | number | undefined;
+}
+/**
+ * Joins per-series point lists into rows keyed by timestamp and applies each
+ * series' transform. Timestamps present in any series produce a row; missing
+ * values are left undefined so recharts gaps the line rather than drawing zero.
+ */
+export declare function mergeSeries(series: ResolvedSeries[], pointsBySeries: (TimeseriesPoint[] | undefined)[]): MergedRow[];
+export declare function TimeseriesPanel(props: TimeseriesPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TimeseriesPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TimeseriesPanel.d.ts","sourceRoot":"","sources":["../../src/data/TimeseriesPanel.tsx"],"names":[],"mappings":"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"}