@flanksource/clicky-ui 0.3.17 → 0.3.19

package/dist/layout/SplitPane.js.map

@@ -1 +1 @@
-{"version":3,"file":"SplitPane.js","sources":["../../src/layout/SplitPane.tsx"],"sourcesContent":["import { useCallback, useRef, useState, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\n\nexport type SplitPaneProps = {\n  /** Content rendered in the left pane. */\n  left: ReactNode;\n  /** Content rendered in the right pane. */\n  right: ReactNode;\n  /** Initial left-pane width as a percentage. */\n  defaultSplit?: number;\n  /** Minimum left-pane width as a percentage. */\n  minLeft?: number;\n  /** Minimum right-pane width as a percentage. */\n  minRight?: number;\n  /** Classes applied to the left pane. */\n  leftClass?: string;\n  /** Classes applied to the right pane. */\n  rightClass?: string;\n  /** Classes applied to the root split container. */\n  className?: string;\n};\n\nexport function SplitPane({\n  left,\n  right,\n  defaultSplit = 50,\n  minLeft = 20,\n  minRight = 20,\n  leftClass,\n  rightClass,\n  className,\n}: SplitPaneProps) {\n  const [split, setSplit] = useState(defaultSplit);\n  const dragging = useRef(false);\n  const container = useRef<HTMLDivElement>(null);\n\n  const onMouseDown = useCallback(\n    (e: React.MouseEvent) => {\n      e.preventDefault();\n      dragging.current = true;\n\n      const onMove = (ev: MouseEvent) => {\n        if (!dragging.current || !container.current) return;\n        const rect = container.current.getBoundingClientRect();\n        const pct = ((ev.clientX - rect.left) / rect.width) * 100;\n        setSplit(Math.max(minLeft, Math.min(100 - minRight, pct)));\n      };\n\n      const onUp = () => {\n        dragging.current = false;\n        document.removeEventListener(\"mousemove\", onMove);\n        document.removeEventListener(\"mouseup\", onUp);\n        document.body.style.cursor = \"\";\n        document.body.style.userSelect = \"\";\n      };\n\n      document.addEventListener(\"mousemove\", onMove);\n      document.addEventListener(\"mouseup\", onUp);\n      document.body.style.cursor = \"col-resize\";\n      document.body.style.userSelect = \"none\";\n    },\n    [minLeft, minRight],\n  );\n\n  return (\n    <div\n      ref={container}\n      className={cn(\"flex flex-1 overflow-hidden h-full\", className)}\n    >\n      <div\n        style={{ width: `${split}%` }}\n        className={cn(\"overflow-y-auto bg-background min-h-0\", leftClass)}\n      >\n        {left}\n      </div>\n      <div\n        role=\"separator\"\n        aria-orientation=\"vertical\"\n        className=\"w-1 bg-border hover:bg-primary cursor-col-resize shrink-0 transition-colors\"\n        onMouseDown={onMouseDown}\n      />\n      <div\n        style={{ width: `${100 - split}%` }}\n        className={cn(\"overflow-hidden bg-background min-h-0\", rightClass)}\n      >\n        {right}\n      </div>\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;AAsBO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf,UAAU;AAAA,EACV,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AACF,GAAmB;AACjB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,YAAY;AAC/C,QAAM,WAAW,OAAO,KAAK;AAC7B,QAAM,YAAY,OAAuB,IAAI;AAE7C,QAAM,cAAc;AAAA,IAClB,CAAC,MAAwB;AACvB,QAAE,eAAA;AACF,eAAS,UAAU;AAEnB,YAAM,SAAS,CAAC,OAAmB;AACjC,YAAI,CAAC,SAAS,WAAW,CAAC,UAAU,QAAS;AAC7C,cAAM,OAAO,UAAU,QAAQ,sBAAA;AAC/B,cAAM,OAAQ,GAAG,UAAU,KAAK,QAAQ,KAAK,QAAS;AACtD,iBAAS,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,UAAU,GAAG,CAAC,CAAC;AAAA,MAC3D;AAEA,YAAM,OAAO,MAAM;AACjB,iBAAS,UAAU;AACnB,iBAAS,oBAAoB,aAAa,MAAM;AAChD,iBAAS,oBAAoB,WAAW,IAAI;AAC5C,iBAAS,KAAK,MAAM,SAAS;AAC7B,iBAAS,KAAK,MAAM,aAAa;AAAA,MACnC;AAEA,eAAS,iBAAiB,aAAa,MAAM;AAC7C,eAAS,iBAAiB,WAAW,IAAI;AACzC,eAAS,KAAK,MAAM,SAAS;AAC7B,eAAS,KAAK,MAAM,aAAa;AAAA,IACnC;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,EAAA;AAGpB,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAK;AAAA,MACL,WAAW,GAAG,sCAAsC,SAAS;AAAA,MAE7D,UAAA;AAAA,QAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,OAAO,EAAE,OAAO,GAAG,KAAK,IAAA;AAAA,YACxB,WAAW,GAAG,yCAAyC,SAAS;AAAA,YAE/D,UAAA;AAAA,UAAA;AAAA,QAAA;AAAA,QAEH;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAK;AAAA,YACL,oBAAiB;AAAA,YACjB,WAAU;AAAA,YACV;AAAA,UAAA;AAAA,QAAA;AAAA,QAEF;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,OAAO,EAAE,OAAO,GAAG,MAAM,KAAK,IAAA;AAAA,YAC9B,WAAW,GAAG,yCAAyC,UAAU;AAAA,YAEhE,UAAA;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"SplitPane.js","sources":["../../src/layout/SplitPane.tsx"],"sourcesContent":["import {\n  useCallback,\n  useRef,\n  useState,\n  type CSSProperties,\n  type ReactNode,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\n\nexport type SplitPaneProps = {\n  /** Content rendered in the left pane. */\n  left: ReactNode;\n  /** Content rendered in the right pane. */\n  right: ReactNode;\n  /** Initial left-pane width as a percentage. */\n  defaultSplit?: number;\n  /** Minimum left-pane width as a percentage. */\n  minLeft?: number;\n  /** Minimum right-pane width as a percentage. */\n  minRight?: number;\n  /** Classes applied to the left pane. */\n  leftClass?: string;\n  /** Classes applied to the right pane. */\n  rightClass?: string;\n  /** Classes applied to the root split container. */\n  className?: string;\n  /** Stack the panes and hide the resize handle below the `md` breakpoint. */\n  stackOnMobile?: boolean;\n};\n\nexport function SplitPane({\n  left,\n  right,\n  defaultSplit = 50,\n  minLeft = 20,\n  minRight = 20,\n  leftClass,\n  rightClass,\n  className,\n  stackOnMobile = false,\n}: SplitPaneProps) {\n  const [split, setSplit] = useState(defaultSplit);\n  const dragging = useRef(false);\n  const container = useRef<HTMLDivElement>(null);\n\n  const onMouseDown = useCallback(\n    (e: React.MouseEvent) => {\n      e.preventDefault();\n      dragging.current = true;\n\n      const onMove = (ev: MouseEvent) => {\n        if (!dragging.current || !container.current) return;\n        const rect = container.current.getBoundingClientRect();\n        const pct = ((ev.clientX - rect.left) / rect.width) * 100;\n        setSplit(Math.max(minLeft, Math.min(100 - minRight, pct)));\n      };\n\n      const onUp = () => {\n        dragging.current = false;\n        document.removeEventListener(\"mousemove\", onMove);\n        document.removeEventListener(\"mouseup\", onUp);\n        document.body.style.cursor = \"\";\n        document.body.style.userSelect = \"\";\n      };\n\n      document.addEventListener(\"mousemove\", onMove);\n      document.addEventListener(\"mouseup\", onUp);\n      document.body.style.cursor = \"col-resize\";\n      document.body.style.userSelect = \"none\";\n    },\n    [minLeft, minRight],\n  );\n\n  return (\n    <div\n      ref={container}\n      className={cn(\n        \"flex h-full flex-1 overflow-hidden\",\n        stackOnMobile && \"flex-col md:flex-row\",\n        className,\n      )}\n    >\n      <div\n        style={\n          stackOnMobile\n            ? ({ \"--split-pane-width\": `${split}%` } as CSSProperties)\n            : { width: `${split}%` }\n        }\n        className={cn(\n          \"min-h-0 overflow-y-auto bg-background\",\n          stackOnMobile && \"w-full md:w-[var(--split-pane-width)]\",\n          leftClass,\n        )}\n      >\n        {left}\n      </div>\n      <div\n        role=\"separator\"\n        aria-orientation=\"vertical\"\n        className={cn(\n          \"w-1 shrink-0 cursor-col-resize bg-border transition-colors hover:bg-primary\",\n          stackOnMobile && \"hidden md:block\",\n        )}\n        onMouseDown={onMouseDown}\n      />\n      <div\n        style={\n          stackOnMobile\n            ? ({ \"--split-pane-width\": `${100 - split}%` } as CSSProperties)\n            : { width: `${100 - split}%` }\n        }\n        className={cn(\n          \"min-h-0 overflow-hidden bg-background\",\n          stackOnMobile && \"w-full md:w-[var(--split-pane-width)]\",\n          rightClass,\n        )}\n      >\n        {right}\n      </div>\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;AA8BO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf,UAAU;AAAA,EACV,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA,gBAAgB;AAClB,GAAmB;AACjB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,YAAY;AAC/C,QAAM,WAAW,OAAO,KAAK;AAC7B,QAAM,YAAY,OAAuB,IAAI;AAE7C,QAAM,cAAc;AAAA,IAClB,CAAC,MAAwB;AACvB,QAAE,eAAA;AACF,eAAS,UAAU;AAEnB,YAAM,SAAS,CAAC,OAAmB;AACjC,YAAI,CAAC,SAAS,WAAW,CAAC,UAAU,QAAS;AAC7C,cAAM,OAAO,UAAU,QAAQ,sBAAA;AAC/B,cAAM,OAAQ,GAAG,UAAU,KAAK,QAAQ,KAAK,QAAS;AACtD,iBAAS,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,UAAU,GAAG,CAAC,CAAC;AAAA,MAC3D;AAEA,YAAM,OAAO,MAAM;AACjB,iBAAS,UAAU;AACnB,iBAAS,oBAAoB,aAAa,MAAM;AAChD,iBAAS,oBAAoB,WAAW,IAAI;AAC5C,iBAAS,KAAK,MAAM,SAAS;AAC7B,iBAAS,KAAK,MAAM,aAAa;AAAA,MACnC;AAEA,eAAS,iBAAiB,aAAa,MAAM;AAC7C,eAAS,iBAAiB,WAAW,IAAI;AACzC,eAAS,KAAK,MAAM,SAAS;AAC7B,eAAS,KAAK,MAAM,aAAa;AAAA,IACnC;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,EAAA;AAGpB,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAK;AAAA,MACL,WAAW;AAAA,QACT;AAAA,QACA,iBAAiB;AAAA,QACjB;AAAA,MAAA;AAAA,MAGF,UAAA;AAAA,QAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,OACE,gBACK,EAAE,sBAAsB,GAAG,KAAK,IAAA,IACjC,EAAE,OAAO,GAAG,KAAK,IAAA;AAAA,YAEvB,WAAW;AAAA,cACT;AAAA,cACA,iBAAiB;AAAA,cACjB;AAAA,YAAA;AAAA,YAGD,UAAA;AAAA,UAAA;AAAA,QAAA;AAAA,QAEH;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAK;AAAA,YACL,oBAAiB;AAAA,YACjB,WAAW;AAAA,cACT;AAAA,cACA,iBAAiB;AAAA,YAAA;AAAA,YAEnB;AAAA,UAAA;AAAA,QAAA;AAAA,QAEF;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,OACE,gBACK,EAAE,sBAAsB,GAAG,MAAM,KAAK,IAAA,IACvC,EAAE,OAAO,GAAG,MAAM,KAAK,IAAA;AAAA,YAE7B,WAAW;AAAA,cACT;AAAA,cACA,iBAAiB;AAAA,cACjB;AAAA,YAAA;AAAA,YAGD,UAAA;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/lib/format.cjs

@@ -1,10 +1,89 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const LOCALE = "en-US";
+const CLICKY_COLUMN_FORMAT_OPTIONS = [
+  {
+    value: "date",
+    label: "Date/time",
+    description: "Render a date or timestamp."
+  },
+  {
+    value: "float",
+    label: "Number",
+    description: "Render a number with decimal precision."
+  },
+  {
+    value: "duration",
+    label: "Duration",
+    description: "Render a Go duration value."
+  },
+  {
+    value: "bytes",
+    label: "Bytes",
+    description: "Render a byte count with binary scaling."
+  },
+  {
+    value: "currency",
+    label: "Currency",
+    description: "Render a monetary amount."
+  }
+];
+const CLICKY_COLUMN_UNIT_OPTIONS = [
+  {
+    value: "none",
+    label: "Compact count",
+    description: "Use short SI count notation without a unit."
+  },
+  {
+    value: "short",
+    label: "Short number",
+    description: "Use short SI count notation such as 1.2K."
+  },
+  {
+    value: "percent",
+    label: "Percent (0-100)",
+    description: "Treat the source value as an existing percentage."
+  },
+  {
+    value: "percentunit",
+    label: "Percent (0-1)",
+    description: "Convert a fractional source value to a percentage."
+  },
+  {
+    value: "bytes",
+    label: "Bytes (IEC)",
+    description: "Scale byte values in powers of 1024."
+  },
+  {
+    value: "decbytes",
+    label: "Bytes (SI)",
+    description: "Scale byte values in powers of 1000."
+  },
+  {
+    value: "Bps",
+    label: "Bytes/sec",
+    description: "Render a byte rate in powers of 1024."
+  },
+  {
+    value: "binBps",
+    label: "Binary bytes/sec",
+    description: "Render a binary byte rate in powers of 1024."
+  },
+  {
+    value: "ms",
+    label: "Milliseconds",
+    description: "Treat the source duration as milliseconds."
+  },
+  {
+    value: "s",
+    label: "Seconds",
+    description: "Treat the source duration as seconds."
+  }
+];
 function intl(value, maxFractionDigits = 1) {
-  return new Intl.NumberFormat(LOCALE, { maximumFractionDigits: maxFractionDigits }).format(
-    Number.isFinite(value) ? value : 0
-  );
+  return new Intl.NumberFormat(LOCALE, {
+    maximumFractionDigits: maxFractionDigits
+  }).format(Number.isFinite(value) ? value : 0);
 }
 function trimZero(s) {
   return s.endsWith(".0") ? s.slice(0, -2) : s;
@@ -12,7 +91,8 @@ function trimZero(s) {
 const BYTE_UNITS = ["B", "KB", "MB", "GB", "TB", "PB"];
 function formatBytes(bytes, opts) {
   const suffix = (opts == null ? void 0 : opts.suffix) ?? "";
-  if (bytes === void 0 || !Number.isFinite(bytes) || bytes <= 0) return `0 B${suffix}`;
+  if (bytes === void 0 || !Number.isFinite(bytes) || bytes <= 0)
+    return `0 B${suffix}`;
   const base = (opts == null ? void 0 : opts.base) ?? 1024;
   let size = bytes;
   let unit = 0;
@@ -69,6 +149,8 @@ function formatUnit(value, unit) {
   if (fmt) return fmt(v);
   return `${intl(v)}${unit}`;
 }
+exports.CLICKY_COLUMN_FORMAT_OPTIONS = CLICKY_COLUMN_FORMAT_OPTIONS;
+exports.CLICKY_COLUMN_UNIT_OPTIONS = CLICKY_COLUMN_UNIT_OPTIONS;
 exports.formatBytes = formatBytes;
 exports.formatBytesPerSecond = formatBytesPerSecond;
 exports.formatDuration = formatDuration;

package/dist/lib/format.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.cjs","sources":["../../src/lib/format.ts"],"sourcesContent":["// Value formatters and a Grafana-style unit registry, shared by TimeseriesPanel\n// (and any other metric display). Pure — no React — so it is trivially testable.\n//\n// `formatUnit(value, unit)` dispatches on a Grafana unit identifier (e.g.\n// \"bytes\", \"Bps\", \"percent\", \"ms\", \"short\"). Unknown unit strings are treated as\n// a raw suffix appended to the formatted number, preserving callers that pass a\n// literal like \"%\" or \"req\".\n\nconst LOCALE = \"en-US\";\n\nfunction intl(value: number, maxFractionDigits = 1): string {\n  return new Intl.NumberFormat(LOCALE, { maximumFractionDigits: maxFractionDigits }).format(\n    Number.isFinite(value) ? value : 0,\n  );\n}\n\n/** Drops a trailing \".0\" so whole values read \"1 KB\" rather than \"1.0 KB\". */\nfunction trimZero(s: string): string {\n  return s.endsWith(\".0\") ? s.slice(0, -2) : s;\n}\n\nexport interface FormatBytesOptions {\n  /** 1024 (IEC, the default) or 1000 (SI/decimal). */\n  base?: 1000 | 1024;\n  /** Appended after the unit label, e.g. \"/s\" for a rate. */\n  suffix?: string;\n}\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\n\n/**\n * Human-readable byte size. 1024-based by default with B/KB/MB/GB/TB/PB labels,\n * matching the prior diagnostics formatter. Whole numbers and values >= 10 drop\n * the fraction; smaller fractional values keep one decimal.\n */\nexport function formatBytes(bytes?: number, opts?: FormatBytesOptions): string {\n  const suffix = opts?.suffix ?? \"\";\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes <= 0) return `0 B${suffix}`;\n  const base = opts?.base ?? 1024;\n  let size = bytes;\n  let unit = 0;\n  while (size >= base && unit < BYTE_UNITS.length - 1) {\n    size /= base;\n    unit++;\n  }\n  const rendered = size >= 10 || unit === 0 ? size.toFixed(0) : trimZero(size.toFixed(1));\n  return `${rendered} ${BYTE_UNITS[unit]}${suffix}`;\n}\n\n/** Byte rate, e.g. \"1.5 MB/s\". 1024-based. */\nexport function formatBytesPerSecond(bytes?: number): string {\n  return formatBytes(bytes, { suffix: \"/s\" });\n}\n\nconst SHORT_UNITS = [\"\", \"K\", \"M\", \"B\", \"T\"] as const;\n\n/** SI abbreviation: 999 -> \"999\", 1200 -> \"1.2K\", 3_400_000 -> \"3.4M\". */\nexport function formatShort(value?: number): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0\";\n  const sign = value < 0 ? \"-\" : \"\";\n  let n = Math.abs(value);\n  if (n < 1000) return `${sign}${intl(n)}`;\n  let unit = 0;\n  while (n >= 1000 && unit < SHORT_UNITS.length - 1) {\n    n /= 1000;\n    unit++;\n  }\n  const rendered = n >= 10 ? n.toFixed(0) : trimZero(n.toFixed(1));\n  return `${sign}${rendered}${SHORT_UNITS[unit]}`;\n}\n\n/**\n * Duration rendered from a millisecond (default) or second input. Picks ms / s /\n * min / h by magnitude: 850 -> \"850 ms\", 1500 -> \"1.5 s\", 90_000 -> \"1.5 min\".\n */\nexport function formatDuration(value?: number, opts?: { from?: \"ms\" | \"s\" }): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0 ms\";\n  const ms = opts?.from === \"s\" ? value * 1000 : value;\n  const abs = Math.abs(ms);\n  if (abs < 1000) return `${intl(ms, 0)} ms`;\n  if (abs < 60_000) return `${intl(ms / 1000)} s`;\n  if (abs < 3_600_000) return `${intl(ms / 60_000)} min`;\n  return `${intl(ms / 3_600_000)} h`;\n}\n\n// formatters keyed by Grafana unit identifier. Keys not present here fall through\n// to the raw-suffix path in formatUnit.\nconst UNIT_FORMATTERS: Record<string, (v: number) => string> = {\n  none: (v) => formatShort(v),\n  short: (v) => formatShort(v),\n  percent: (v) => `${intl(v)}%`,\n  percentunit: (v) => `${intl(v * 100)}%`,\n  \"%\": (v) => `${intl(v)}%`,\n  bytes: (v) => formatBytes(v, { base: 1024 }),\n  decbytes: (v) => formatBytes(v, { base: 1000 }),\n  Bps: (v) => formatBytesPerSecond(v),\n  binBps: (v) => formatBytesPerSecond(v),\n  ms: (v) => formatDuration(v, { from: \"ms\" }),\n  s: (v) => formatDuration(v, { from: \"s\" }),\n};\n\n/**\n * Formats a value for display per a Grafana-style unit key. Unknown units are\n * appended as a literal suffix (back-compat for callers passing \"%\", \"req\",\n * etc.); an absent unit yields the plain localized number.\n */\nexport function formatUnit(value: number, unit?: string): string {\n  const v = Number.isFinite(value) ? value : 0;\n  if (!unit) return intl(v);\n  const fmt = UNIT_FORMATTERS[unit];\n  if (fmt) return fmt(v);\n  return `${intl(v)}${unit}`;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"format.cjs","sources":["../../src/lib/format.ts"],"sourcesContent":["// Value formatters and a Grafana-style unit registry, shared by TimeseriesPanel\n// (and any other metric display). Pure — no React — so it is trivially testable.\n//\n// `formatUnit(value, unit)` dispatches on a Grafana unit identifier (e.g.\n// \"bytes\", \"Bps\", \"percent\", \"ms\", \"short\"). Unknown unit strings are treated as\n// a raw suffix appended to the formatted number, preserving callers that pass a\n// literal like \"%\" or \"req\".\n\nconst LOCALE = \"en-US\";\n\nexport type ClickyColumnOption = {\n  value: string;\n  label: string;\n  description: string;\n};\n\nexport const CLICKY_COLUMN_FORMAT_OPTIONS = [\n  {\n    value: \"date\",\n    label: \"Date/time\",\n    description: \"Render a date or timestamp.\",\n  },\n  {\n    value: \"float\",\n    label: \"Number\",\n    description: \"Render a number with decimal precision.\",\n  },\n  {\n    value: \"duration\",\n    label: \"Duration\",\n    description: \"Render a Go duration value.\",\n  },\n  {\n    value: \"bytes\",\n    label: \"Bytes\",\n    description: \"Render a byte count with binary scaling.\",\n  },\n  {\n    value: \"currency\",\n    label: \"Currency\",\n    description: \"Render a monetary amount.\",\n  },\n] as const satisfies readonly ClickyColumnOption[];\n\nexport const CLICKY_COLUMN_UNIT_OPTIONS = [\n  {\n    value: \"none\",\n    label: \"Compact count\",\n    description: \"Use short SI count notation without a unit.\",\n  },\n  {\n    value: \"short\",\n    label: \"Short number\",\n    description: \"Use short SI count notation such as 1.2K.\",\n  },\n  {\n    value: \"percent\",\n    label: \"Percent (0-100)\",\n    description: \"Treat the source value as an existing percentage.\",\n  },\n  {\n    value: \"percentunit\",\n    label: \"Percent (0-1)\",\n    description: \"Convert a fractional source value to a percentage.\",\n  },\n  {\n    value: \"bytes\",\n    label: \"Bytes (IEC)\",\n    description: \"Scale byte values in powers of 1024.\",\n  },\n  {\n    value: \"decbytes\",\n    label: \"Bytes (SI)\",\n    description: \"Scale byte values in powers of 1000.\",\n  },\n  {\n    value: \"Bps\",\n    label: \"Bytes/sec\",\n    description: \"Render a byte rate in powers of 1024.\",\n  },\n  {\n    value: \"binBps\",\n    label: \"Binary bytes/sec\",\n    description: \"Render a binary byte rate in powers of 1024.\",\n  },\n  {\n    value: \"ms\",\n    label: \"Milliseconds\",\n    description: \"Treat the source duration as milliseconds.\",\n  },\n  {\n    value: \"s\",\n    label: \"Seconds\",\n    description: \"Treat the source duration as seconds.\",\n  },\n] as const satisfies readonly ClickyColumnOption[];\n\nexport type ClickyColumnFormat =\n  (typeof CLICKY_COLUMN_FORMAT_OPTIONS)[number][\"value\"];\nexport type ClickyColumnUnit =\n  (typeof CLICKY_COLUMN_UNIT_OPTIONS)[number][\"value\"];\n\nfunction intl(value: number, maxFractionDigits = 1): string {\n  return new Intl.NumberFormat(LOCALE, {\n    maximumFractionDigits: maxFractionDigits,\n  }).format(Number.isFinite(value) ? value : 0);\n}\n\n/** Drops a trailing \".0\" so whole values read \"1 KB\" rather than \"1.0 KB\". */\nfunction trimZero(s: string): string {\n  return s.endsWith(\".0\") ? s.slice(0, -2) : s;\n}\n\nexport interface FormatBytesOptions {\n  /** 1024 (IEC, the default) or 1000 (SI/decimal). */\n  base?: 1000 | 1024;\n  /** Appended after the unit label, e.g. \"/s\" for a rate. */\n  suffix?: string;\n}\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\n\n/**\n * Human-readable byte size. 1024-based by default with B/KB/MB/GB/TB/PB labels,\n * matching the prior diagnostics formatter. Whole numbers and values >= 10 drop\n * the fraction; smaller fractional values keep one decimal.\n */\nexport function formatBytes(bytes?: number, opts?: FormatBytesOptions): string {\n  const suffix = opts?.suffix ?? \"\";\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes <= 0)\n    return `0 B${suffix}`;\n  const base = opts?.base ?? 1024;\n  let size = bytes;\n  let unit = 0;\n  while (size >= base && unit < BYTE_UNITS.length - 1) {\n    size /= base;\n    unit++;\n  }\n  const rendered =\n    size >= 10 || unit === 0 ? size.toFixed(0) : trimZero(size.toFixed(1));\n  return `${rendered} ${BYTE_UNITS[unit]}${suffix}`;\n}\n\n/** Byte rate, e.g. \"1.5 MB/s\". 1024-based. */\nexport function formatBytesPerSecond(bytes?: number): string {\n  return formatBytes(bytes, { suffix: \"/s\" });\n}\n\nconst SHORT_UNITS = [\"\", \"K\", \"M\", \"B\", \"T\"] as const;\n\n/** SI abbreviation: 999 -> \"999\", 1200 -> \"1.2K\", 3_400_000 -> \"3.4M\". */\nexport function formatShort(value?: number): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0\";\n  const sign = value < 0 ? \"-\" : \"\";\n  let n = Math.abs(value);\n  if (n < 1000) return `${sign}${intl(n)}`;\n  let unit = 0;\n  while (n >= 1000 && unit < SHORT_UNITS.length - 1) {\n    n /= 1000;\n    unit++;\n  }\n  const rendered = n >= 10 ? n.toFixed(0) : trimZero(n.toFixed(1));\n  return `${sign}${rendered}${SHORT_UNITS[unit]}`;\n}\n\n/**\n * Duration rendered from a millisecond (default) or second input. Picks ms / s /\n * min / h by magnitude: 850 -> \"850 ms\", 1500 -> \"1.5 s\", 90_000 -> \"1.5 min\".\n */\nexport function formatDuration(\n  value?: number,\n  opts?: { from?: \"ms\" | \"s\" },\n): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0 ms\";\n  const ms = opts?.from === \"s\" ? value * 1000 : value;\n  const abs = Math.abs(ms);\n  if (abs < 1000) return `${intl(ms, 0)} ms`;\n  if (abs < 60_000) return `${intl(ms / 1000)} s`;\n  if (abs < 3_600_000) return `${intl(ms / 60_000)} min`;\n  return `${intl(ms / 3_600_000)} h`;\n}\n\n// formatters keyed by Grafana unit identifier. Keys not present here fall through\n// to the raw-suffix path in formatUnit.\nconst UNIT_FORMATTERS: Record<string, (v: number) => string> = {\n  none: (v) => formatShort(v),\n  short: (v) => formatShort(v),\n  percent: (v) => `${intl(v)}%`,\n  percentunit: (v) => `${intl(v * 100)}%`,\n  \"%\": (v) => `${intl(v)}%`,\n  bytes: (v) => formatBytes(v, { base: 1024 }),\n  decbytes: (v) => formatBytes(v, { base: 1000 }),\n  Bps: (v) => formatBytesPerSecond(v),\n  binBps: (v) => formatBytesPerSecond(v),\n  ms: (v) => formatDuration(v, { from: \"ms\" }),\n  s: (v) => formatDuration(v, { from: \"s\" }),\n};\n\n/**\n * Formats a value for display per a Grafana-style unit key. Unknown units are\n * appended as a literal suffix (back-compat for callers passing \"%\", \"req\",\n * etc.); an absent unit yields the plain localized number.\n */\nexport function formatUnit(value: number, unit?: string): string {\n  const v = Number.isFinite(value) ? value : 0;\n  if (!unit) return intl(v);\n  const fmt = UNIT_FORMATTERS[unit];\n  if (fmt) return fmt(v);\n  return `${intl(v)}${unit}`;\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/format.d.ts

@@ -1,3 +1,72 @@
+export type ClickyColumnOption = {
+    value: string;
+    label: string;
+    description: string;
+};
+export declare const CLICKY_COLUMN_FORMAT_OPTIONS: readonly [{
+    readonly value: "date";
+    readonly label: "Date/time";
+    readonly description: "Render a date or timestamp.";
+}, {
+    readonly value: "float";
+    readonly label: "Number";
+    readonly description: "Render a number with decimal precision.";
+}, {
+    readonly value: "duration";
+    readonly label: "Duration";
+    readonly description: "Render a Go duration value.";
+}, {
+    readonly value: "bytes";
+    readonly label: "Bytes";
+    readonly description: "Render a byte count with binary scaling.";
+}, {
+    readonly value: "currency";
+    readonly label: "Currency";
+    readonly description: "Render a monetary amount.";
+}];
+export declare const CLICKY_COLUMN_UNIT_OPTIONS: readonly [{
+    readonly value: "none";
+    readonly label: "Compact count";
+    readonly description: "Use short SI count notation without a unit.";
+}, {
+    readonly value: "short";
+    readonly label: "Short number";
+    readonly description: "Use short SI count notation such as 1.2K.";
+}, {
+    readonly value: "percent";
+    readonly label: "Percent (0-100)";
+    readonly description: "Treat the source value as an existing percentage.";
+}, {
+    readonly value: "percentunit";
+    readonly label: "Percent (0-1)";
+    readonly description: "Convert a fractional source value to a percentage.";
+}, {
+    readonly value: "bytes";
+    readonly label: "Bytes (IEC)";
+    readonly description: "Scale byte values in powers of 1024.";
+}, {
+    readonly value: "decbytes";
+    readonly label: "Bytes (SI)";
+    readonly description: "Scale byte values in powers of 1000.";
+}, {
+    readonly value: "Bps";
+    readonly label: "Bytes/sec";
+    readonly description: "Render a byte rate in powers of 1024.";
+}, {
+    readonly value: "binBps";
+    readonly label: "Binary bytes/sec";
+    readonly description: "Render a binary byte rate in powers of 1024.";
+}, {
+    readonly value: "ms";
+    readonly label: "Milliseconds";
+    readonly description: "Treat the source duration as milliseconds.";
+}, {
+    readonly value: "s";
+    readonly label: "Seconds";
+    readonly description: "Treat the source duration as seconds.";
+}];
+export type ClickyColumnFormat = (typeof CLICKY_COLUMN_FORMAT_OPTIONS)[number]["value"];
+export type ClickyColumnUnit = (typeof CLICKY_COLUMN_UNIT_OPTIONS)[number]["value"];
 export interface FormatBytesOptions {
     /** 1024 (IEC, the default) or 1000 (SI/decimal). */
     base?: 1000 | 1024;

package/dist/lib/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAY7E;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAID,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,IAAI,GAAG,GAAG,CAAA;CAAE,GAAG,MAAM,CAQnF;AAkBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;EA0BS,CAAC;AAEnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDW,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAavD,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAc7E;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAID,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,IAAI,GAAG,GAAG,CAAA;CAAE,GAC3B,MAAM,CAQR;AAkBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/D"}

package/dist/lib/format.js

@@ -1,8 +1,87 @@
 const LOCALE = "en-US";
+const CLICKY_COLUMN_FORMAT_OPTIONS = [
+  {
+    value: "date",
+    label: "Date/time",
+    description: "Render a date or timestamp."
+  },
+  {
+    value: "float",
+    label: "Number",
+    description: "Render a number with decimal precision."
+  },
+  {
+    value: "duration",
+    label: "Duration",
+    description: "Render a Go duration value."
+  },
+  {
+    value: "bytes",
+    label: "Bytes",
+    description: "Render a byte count with binary scaling."
+  },
+  {
+    value: "currency",
+    label: "Currency",
+    description: "Render a monetary amount."
+  }
+];
+const CLICKY_COLUMN_UNIT_OPTIONS = [
+  {
+    value: "none",
+    label: "Compact count",
+    description: "Use short SI count notation without a unit."
+  },
+  {
+    value: "short",
+    label: "Short number",
+    description: "Use short SI count notation such as 1.2K."
+  },
+  {
+    value: "percent",
+    label: "Percent (0-100)",
+    description: "Treat the source value as an existing percentage."
+  },
+  {
+    value: "percentunit",
+    label: "Percent (0-1)",
+    description: "Convert a fractional source value to a percentage."
+  },
+  {
+    value: "bytes",
+    label: "Bytes (IEC)",
+    description: "Scale byte values in powers of 1024."
+  },
+  {
+    value: "decbytes",
+    label: "Bytes (SI)",
+    description: "Scale byte values in powers of 1000."
+  },
+  {
+    value: "Bps",
+    label: "Bytes/sec",
+    description: "Render a byte rate in powers of 1024."
+  },
+  {
+    value: "binBps",
+    label: "Binary bytes/sec",
+    description: "Render a binary byte rate in powers of 1024."
+  },
+  {
+    value: "ms",
+    label: "Milliseconds",
+    description: "Treat the source duration as milliseconds."
+  },
+  {
+    value: "s",
+    label: "Seconds",
+    description: "Treat the source duration as seconds."
+  }
+];
 function intl(value, maxFractionDigits = 1) {
-  return new Intl.NumberFormat(LOCALE, { maximumFractionDigits: maxFractionDigits }).format(
-    Number.isFinite(value) ? value : 0
-  );
+  return new Intl.NumberFormat(LOCALE, {
+    maximumFractionDigits: maxFractionDigits
+  }).format(Number.isFinite(value) ? value : 0);
 }
 function trimZero(s) {
   return s.endsWith(".0") ? s.slice(0, -2) : s;
@@ -10,7 +89,8 @@ function trimZero(s) {
 const BYTE_UNITS = ["B", "KB", "MB", "GB", "TB", "PB"];
 function formatBytes(bytes, opts) {
   const suffix = (opts == null ? void 0 : opts.suffix) ?? "";
-  if (bytes === void 0 || !Number.isFinite(bytes) || bytes <= 0) return `0 B${suffix}`;
+  if (bytes === void 0 || !Number.isFinite(bytes) || bytes <= 0)
+    return `0 B${suffix}`;
   const base = (opts == null ? void 0 : opts.base) ?? 1024;
   let size = bytes;
   let unit = 0;
@@ -68,6 +148,8 @@ function formatUnit(value, unit) {
   return `${intl(v)}${unit}`;
 }
 export {
+  CLICKY_COLUMN_FORMAT_OPTIONS,
+  CLICKY_COLUMN_UNIT_OPTIONS,
   formatBytes,
   formatBytesPerSecond,
   formatDuration,

package/dist/lib/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sources":["../../src/lib/format.ts"],"sourcesContent":["// Value formatters and a Grafana-style unit registry, shared by TimeseriesPanel\n// (and any other metric display). Pure — no React — so it is trivially testable.\n//\n// `formatUnit(value, unit)` dispatches on a Grafana unit identifier (e.g.\n// \"bytes\", \"Bps\", \"percent\", \"ms\", \"short\"). Unknown unit strings are treated as\n// a raw suffix appended to the formatted number, preserving callers that pass a\n// literal like \"%\" or \"req\".\n\nconst LOCALE = \"en-US\";\n\nfunction intl(value: number, maxFractionDigits = 1): string {\n  return new Intl.NumberFormat(LOCALE, { maximumFractionDigits: maxFractionDigits }).format(\n    Number.isFinite(value) ? value : 0,\n  );\n}\n\n/** Drops a trailing \".0\" so whole values read \"1 KB\" rather than \"1.0 KB\". */\nfunction trimZero(s: string): string {\n  return s.endsWith(\".0\") ? s.slice(0, -2) : s;\n}\n\nexport interface FormatBytesOptions {\n  /** 1024 (IEC, the default) or 1000 (SI/decimal). */\n  base?: 1000 | 1024;\n  /** Appended after the unit label, e.g. \"/s\" for a rate. */\n  suffix?: string;\n}\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\n\n/**\n * Human-readable byte size. 1024-based by default with B/KB/MB/GB/TB/PB labels,\n * matching the prior diagnostics formatter. Whole numbers and values >= 10 drop\n * the fraction; smaller fractional values keep one decimal.\n */\nexport function formatBytes(bytes?: number, opts?: FormatBytesOptions): string {\n  const suffix = opts?.suffix ?? \"\";\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes <= 0) return `0 B${suffix}`;\n  const base = opts?.base ?? 1024;\n  let size = bytes;\n  let unit = 0;\n  while (size >= base && unit < BYTE_UNITS.length - 1) {\n    size /= base;\n    unit++;\n  }\n  const rendered = size >= 10 || unit === 0 ? size.toFixed(0) : trimZero(size.toFixed(1));\n  return `${rendered} ${BYTE_UNITS[unit]}${suffix}`;\n}\n\n/** Byte rate, e.g. \"1.5 MB/s\". 1024-based. */\nexport function formatBytesPerSecond(bytes?: number): string {\n  return formatBytes(bytes, { suffix: \"/s\" });\n}\n\nconst SHORT_UNITS = [\"\", \"K\", \"M\", \"B\", \"T\"] as const;\n\n/** SI abbreviation: 999 -> \"999\", 1200 -> \"1.2K\", 3_400_000 -> \"3.4M\". */\nexport function formatShort(value?: number): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0\";\n  const sign = value < 0 ? \"-\" : \"\";\n  let n = Math.abs(value);\n  if (n < 1000) return `${sign}${intl(n)}`;\n  let unit = 0;\n  while (n >= 1000 && unit < SHORT_UNITS.length - 1) {\n    n /= 1000;\n    unit++;\n  }\n  const rendered = n >= 10 ? n.toFixed(0) : trimZero(n.toFixed(1));\n  return `${sign}${rendered}${SHORT_UNITS[unit]}`;\n}\n\n/**\n * Duration rendered from a millisecond (default) or second input. Picks ms / s /\n * min / h by magnitude: 850 -> \"850 ms\", 1500 -> \"1.5 s\", 90_000 -> \"1.5 min\".\n */\nexport function formatDuration(value?: number, opts?: { from?: \"ms\" | \"s\" }): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0 ms\";\n  const ms = opts?.from === \"s\" ? value * 1000 : value;\n  const abs = Math.abs(ms);\n  if (abs < 1000) return `${intl(ms, 0)} ms`;\n  if (abs < 60_000) return `${intl(ms / 1000)} s`;\n  if (abs < 3_600_000) return `${intl(ms / 60_000)} min`;\n  return `${intl(ms / 3_600_000)} h`;\n}\n\n// formatters keyed by Grafana unit identifier. Keys not present here fall through\n// to the raw-suffix path in formatUnit.\nconst UNIT_FORMATTERS: Record<string, (v: number) => string> = {\n  none: (v) => formatShort(v),\n  short: (v) => formatShort(v),\n  percent: (v) => `${intl(v)}%`,\n  percentunit: (v) => `${intl(v * 100)}%`,\n  \"%\": (v) => `${intl(v)}%`,\n  bytes: (v) => formatBytes(v, { base: 1024 }),\n  decbytes: (v) => formatBytes(v, { base: 1000 }),\n  Bps: (v) => formatBytesPerSecond(v),\n  binBps: (v) => formatBytesPerSecond(v),\n  ms: (v) => formatDuration(v, { from: \"ms\" }),\n  s: (v) => formatDuration(v, { from: \"s\" }),\n};\n\n/**\n * Formats a value for display per a Grafana-style unit key. Unknown units are\n * appended as a literal suffix (back-compat for callers passing \"%\", \"req\",\n * etc.); an absent unit yields the plain localized number.\n */\nexport function formatUnit(value: number, unit?: string): string {\n  const v = Number.isFinite(value) ? value : 0;\n  if (!unit) return intl(v);\n  const fmt = UNIT_FORMATTERS[unit];\n  if (fmt) return fmt(v);\n  return `${intl(v)}${unit}`;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"format.js","sources":["../../src/lib/format.ts"],"sourcesContent":["// Value formatters and a Grafana-style unit registry, shared by TimeseriesPanel\n// (and any other metric display). Pure — no React — so it is trivially testable.\n//\n// `formatUnit(value, unit)` dispatches on a Grafana unit identifier (e.g.\n// \"bytes\", \"Bps\", \"percent\", \"ms\", \"short\"). Unknown unit strings are treated as\n// a raw suffix appended to the formatted number, preserving callers that pass a\n// literal like \"%\" or \"req\".\n\nconst LOCALE = \"en-US\";\n\nexport type ClickyColumnOption = {\n  value: string;\n  label: string;\n  description: string;\n};\n\nexport const CLICKY_COLUMN_FORMAT_OPTIONS = [\n  {\n    value: \"date\",\n    label: \"Date/time\",\n    description: \"Render a date or timestamp.\",\n  },\n  {\n    value: \"float\",\n    label: \"Number\",\n    description: \"Render a number with decimal precision.\",\n  },\n  {\n    value: \"duration\",\n    label: \"Duration\",\n    description: \"Render a Go duration value.\",\n  },\n  {\n    value: \"bytes\",\n    label: \"Bytes\",\n    description: \"Render a byte count with binary scaling.\",\n  },\n  {\n    value: \"currency\",\n    label: \"Currency\",\n    description: \"Render a monetary amount.\",\n  },\n] as const satisfies readonly ClickyColumnOption[];\n\nexport const CLICKY_COLUMN_UNIT_OPTIONS = [\n  {\n    value: \"none\",\n    label: \"Compact count\",\n    description: \"Use short SI count notation without a unit.\",\n  },\n  {\n    value: \"short\",\n    label: \"Short number\",\n    description: \"Use short SI count notation such as 1.2K.\",\n  },\n  {\n    value: \"percent\",\n    label: \"Percent (0-100)\",\n    description: \"Treat the source value as an existing percentage.\",\n  },\n  {\n    value: \"percentunit\",\n    label: \"Percent (0-1)\",\n    description: \"Convert a fractional source value to a percentage.\",\n  },\n  {\n    value: \"bytes\",\n    label: \"Bytes (IEC)\",\n    description: \"Scale byte values in powers of 1024.\",\n  },\n  {\n    value: \"decbytes\",\n    label: \"Bytes (SI)\",\n    description: \"Scale byte values in powers of 1000.\",\n  },\n  {\n    value: \"Bps\",\n    label: \"Bytes/sec\",\n    description: \"Render a byte rate in powers of 1024.\",\n  },\n  {\n    value: \"binBps\",\n    label: \"Binary bytes/sec\",\n    description: \"Render a binary byte rate in powers of 1024.\",\n  },\n  {\n    value: \"ms\",\n    label: \"Milliseconds\",\n    description: \"Treat the source duration as milliseconds.\",\n  },\n  {\n    value: \"s\",\n    label: \"Seconds\",\n    description: \"Treat the source duration as seconds.\",\n  },\n] as const satisfies readonly ClickyColumnOption[];\n\nexport type ClickyColumnFormat =\n  (typeof CLICKY_COLUMN_FORMAT_OPTIONS)[number][\"value\"];\nexport type ClickyColumnUnit =\n  (typeof CLICKY_COLUMN_UNIT_OPTIONS)[number][\"value\"];\n\nfunction intl(value: number, maxFractionDigits = 1): string {\n  return new Intl.NumberFormat(LOCALE, {\n    maximumFractionDigits: maxFractionDigits,\n  }).format(Number.isFinite(value) ? value : 0);\n}\n\n/** Drops a trailing \".0\" so whole values read \"1 KB\" rather than \"1.0 KB\". */\nfunction trimZero(s: string): string {\n  return s.endsWith(\".0\") ? s.slice(0, -2) : s;\n}\n\nexport interface FormatBytesOptions {\n  /** 1024 (IEC, the default) or 1000 (SI/decimal). */\n  base?: 1000 | 1024;\n  /** Appended after the unit label, e.g. \"/s\" for a rate. */\n  suffix?: string;\n}\n\nconst BYTE_UNITS = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\n\n/**\n * Human-readable byte size. 1024-based by default with B/KB/MB/GB/TB/PB labels,\n * matching the prior diagnostics formatter. Whole numbers and values >= 10 drop\n * the fraction; smaller fractional values keep one decimal.\n */\nexport function formatBytes(bytes?: number, opts?: FormatBytesOptions): string {\n  const suffix = opts?.suffix ?? \"\";\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes <= 0)\n    return `0 B${suffix}`;\n  const base = opts?.base ?? 1024;\n  let size = bytes;\n  let unit = 0;\n  while (size >= base && unit < BYTE_UNITS.length - 1) {\n    size /= base;\n    unit++;\n  }\n  const rendered =\n    size >= 10 || unit === 0 ? size.toFixed(0) : trimZero(size.toFixed(1));\n  return `${rendered} ${BYTE_UNITS[unit]}${suffix}`;\n}\n\n/** Byte rate, e.g. \"1.5 MB/s\". 1024-based. */\nexport function formatBytesPerSecond(bytes?: number): string {\n  return formatBytes(bytes, { suffix: \"/s\" });\n}\n\nconst SHORT_UNITS = [\"\", \"K\", \"M\", \"B\", \"T\"] as const;\n\n/** SI abbreviation: 999 -> \"999\", 1200 -> \"1.2K\", 3_400_000 -> \"3.4M\". */\nexport function formatShort(value?: number): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0\";\n  const sign = value < 0 ? \"-\" : \"\";\n  let n = Math.abs(value);\n  if (n < 1000) return `${sign}${intl(n)}`;\n  let unit = 0;\n  while (n >= 1000 && unit < SHORT_UNITS.length - 1) {\n    n /= 1000;\n    unit++;\n  }\n  const rendered = n >= 10 ? n.toFixed(0) : trimZero(n.toFixed(1));\n  return `${sign}${rendered}${SHORT_UNITS[unit]}`;\n}\n\n/**\n * Duration rendered from a millisecond (default) or second input. Picks ms / s /\n * min / h by magnitude: 850 -> \"850 ms\", 1500 -> \"1.5 s\", 90_000 -> \"1.5 min\".\n */\nexport function formatDuration(\n  value?: number,\n  opts?: { from?: \"ms\" | \"s\" },\n): string {\n  if (value === undefined || !Number.isFinite(value)) return \"0 ms\";\n  const ms = opts?.from === \"s\" ? value * 1000 : value;\n  const abs = Math.abs(ms);\n  if (abs < 1000) return `${intl(ms, 0)} ms`;\n  if (abs < 60_000) return `${intl(ms / 1000)} s`;\n  if (abs < 3_600_000) return `${intl(ms / 60_000)} min`;\n  return `${intl(ms / 3_600_000)} h`;\n}\n\n// formatters keyed by Grafana unit identifier. Keys not present here fall through\n// to the raw-suffix path in formatUnit.\nconst UNIT_FORMATTERS: Record<string, (v: number) => string> = {\n  none: (v) => formatShort(v),\n  short: (v) => formatShort(v),\n  percent: (v) => `${intl(v)}%`,\n  percentunit: (v) => `${intl(v * 100)}%`,\n  \"%\": (v) => `${intl(v)}%`,\n  bytes: (v) => formatBytes(v, { base: 1024 }),\n  decbytes: (v) => formatBytes(v, { base: 1000 }),\n  Bps: (v) => formatBytesPerSecond(v),\n  binBps: (v) => formatBytesPerSecond(v),\n  ms: (v) => formatDuration(v, { from: \"ms\" }),\n  s: (v) => formatDuration(v, { from: \"s\" }),\n};\n\n/**\n * Formats a value for display per a Grafana-style unit key. Unknown units are\n * appended as a literal suffix (back-compat for callers passing \"%\", \"req\",\n * etc.); an absent unit yields the plain localized number.\n */\nexport function formatUnit(value: number, unit?: string): string {\n  const v = Number.isFinite(value) ? value : 0;\n  if (!unit) return intl(v);\n  const fmt = UNIT_FORMATTERS[unit];\n  if (fmt) return fmt(v);\n  return `${intl(v)}${unit}`;\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/path-tree.cjs

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PATH_SEPARATOR = "/";
+function splitPath(value, delimiters) {
+  if (!value) return [];
+  if (!delimiters) return [value];
+  const segments = [];
+  let current = "";
+  for (const character of value) {
+    if (delimiters.includes(character)) {
+      if (current) segments.push(current);
+      current = "";
+    } else {
+      current += character;
+    }
+  }
+  if (current) segments.push(current);
+  return segments;
+}
+function buildPathTree(items, getPath, options = {}) {
+  const roots = [];
+  const byKey = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const path = getPath(item);
+    if (path.length === 0) continue;
+    let siblings = roots;
+    let key = "";
+    let node;
+    path.forEach((segment, index) => {
+      key = key ? `${key}${PATH_SEPARATOR}${segment}` : segment;
+      let existing = byKey.get(key);
+      if (!existing) {
+        existing = {
+          key,
+          label: segment,
+          path: path.slice(0, index + 1),
+          items: [],
+          children: []
+        };
+        byKey.set(key, existing);
+        siblings.push(existing);
+      }
+      siblings = existing.children;
+      node = existing;
+    });
+    node == null ? void 0 : node.items.push(item);
+  }
+  if (options.compare) sortTree(roots, options.compare);
+  return roots;
+}
+function sortTree(nodes, compare) {
+  nodes.sort(compare);
+  for (const node of nodes) sortTree(node.children, compare);
+}
+function isPathTreeFolder(node) {
+  return node.items.length === 0;
+}
+function foldersFirst(left, right) {
+  const leftIsParent = left.children.length > 0;
+  const rightIsParent = right.children.length > 0;
+  if (leftIsParent !== rightIsParent) return leftIsParent ? -1 : 1;
+  return left.label.localeCompare(right.label);
+}
+exports.PATH_SEPARATOR = PATH_SEPARATOR;
+exports.buildPathTree = buildPathTree;
+exports.foldersFirst = foldersFirst;
+exports.isPathTreeFolder = isPathTreeFolder;
+exports.splitPath = splitPath;
+//# sourceMappingURL=path-tree.cjs.map

package/dist/lib/path-tree.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-tree.cjs","sources":["../../src/lib/path-tree.ts"],"sourcesContent":["// Turns a flat list of items that each carry a path into a tree, without\n// knowing anything about what the items are. Two independent surfaces need\n// exactly this shape — a session's changed-file list and a backend's\n// hierarchical nav surfaces — so the walker lives here rather than a third\n// time inside a component.\n\n/** The wire separator for a joined path. Matches clicky's entity.PathSeparator. */\nexport const PATH_SEPARATOR = \"/\";\n\nexport interface PathTreeNode<T> {\n  /** The joined path — stable across rebuilds, so it works as a React/Tree key. */\n  key: string;\n  /** The node's own last segment. */\n  label: string;\n  /** Every segment from the root down to and including this node. */\n  path: string[];\n  /**\n   * The items whose *full* path lands on this node. Empty means a pure folder\n   * — a node that exists only because something below it does. More than one\n   * means several items share a path (e.g. a file that was both read and\n   * written), which is why this is a list rather than a single value.\n   */\n  items: T[];\n  children: PathTreeNode<T>[];\n}\n\nexport interface BuildPathTreeOptions<T> {\n  /**\n   * Orders siblings at every level. Defaults to the order items were first\n   * seen, which preserves a already-sorted backend list as-is.\n   */\n  compare?: (left: PathTreeNode<T>, right: PathTreeNode<T>) => number;\n}\n\n/**\n * Splits `value` into path segments on any character in `delimiters`, dropping\n * empty segments so leading, trailing and repeated separators are harmless.\n *\n * Characters outside `delimiters` are never separators: with `delimiters=\".\"`,\n * `\"remote-debugger.sql-xevent\"` yields two segments, not four — a hyphen is an\n * ordinary name character.\n */\nexport function splitPath(value: string, delimiters: string): string[] {\n  if (!value) return [];\n  if (!delimiters) return [value];\n  const segments: string[] = [];\n  let current = \"\";\n  for (const character of value) {\n    if (delimiters.includes(character)) {\n      if (current) segments.push(current);\n      current = \"\";\n    } else {\n      current += character;\n    }\n  }\n  if (current) segments.push(current);\n  return segments;\n}\n\n/**\n * Builds a forest from items keyed by path.\n *\n * A node is created for every path prefix, and an item's full path *binds* to\n * whichever node it lands on — creating it if needed, reusing it if a\n * descendant already forced it into existence. That is what lets a node be both\n * a folder and a leaf: `[\"jms\"]` and `[\"jms\", \"incoming\"]` produce one `jms`\n * node that is simultaneously selectable and expandable.\n *\n * Items whose path is empty are skipped — they have no position in the tree.\n */\nexport function buildPathTree<T>(\n  items: readonly T[],\n  getPath: (item: T) => readonly string[],\n  options: BuildPathTreeOptions<T> = {},\n): PathTreeNode<T>[] {\n  const roots: PathTreeNode<T>[] = [];\n  const byKey = new Map<string, PathTreeNode<T>>();\n\n  for (const item of items) {\n    const path = getPath(item);\n    if (path.length === 0) continue;\n\n    let siblings = roots;\n    let key = \"\";\n    let node: PathTreeNode<T> | undefined;\n    path.forEach((segment, index) => {\n      key = key ? `${key}${PATH_SEPARATOR}${segment}` : segment;\n      let existing = byKey.get(key);\n      if (!existing) {\n        existing = {\n          key,\n          label: segment,\n          path: path.slice(0, index + 1),\n          items: [],\n          children: [],\n        };\n        byKey.set(key, existing);\n        siblings.push(existing);\n      }\n      siblings = existing.children;\n      node = existing;\n    });\n    node?.items.push(item);\n  }\n\n  if (options.compare) sortTree(roots, options.compare);\n  return roots;\n}\n\nfunction sortTree<T>(\n  nodes: PathTreeNode<T>[],\n  compare: (left: PathTreeNode<T>, right: PathTreeNode<T>) => number,\n): void {\n  nodes.sort(compare);\n  for (const node of nodes) sortTree(node.children, compare);\n}\n\n/** True when the node exists only to hold descendants — nothing binds to it. */\nexport function isPathTreeFolder<T>(node: PathTreeNode<T>): boolean {\n  return node.items.length === 0;\n}\n\n/**\n * A `compare` that puts nodes with children before plain leaves, then orders\n * each run alphabetically — the conventional file-explorer ordering.\n */\nexport function foldersFirst<T>(\n  left: PathTreeNode<T>,\n  right: PathTreeNode<T>,\n): number {\n  const leftIsParent = left.children.length > 0;\n  const rightIsParent = right.children.length > 0;\n  if (leftIsParent !== rightIsParent) return leftIsParent ? -1 : 1;\n  return left.label.localeCompare(right.label);\n}\n"],"names":[],"mappings":";;AAOO,MAAM,iBAAiB;AAmCvB,SAAS,UAAU,OAAe,YAA8B;AACrE,MAAI,CAAC,MAAO,QAAO,CAAA;AACnB,MAAI,CAAC,WAAY,QAAO,CAAC,KAAK;AAC9B,QAAM,WAAqB,CAAA;AAC3B,MAAI,UAAU;AACd,aAAW,aAAa,OAAO;AAC7B,QAAI,WAAW,SAAS,SAAS,GAAG;AAClC,UAAI,QAAS,UAAS,KAAK,OAAO;AAClC,gBAAU;AAAA,IACZ,OAAO;AACL,iBAAW;AAAA,IACb;AAAA,EACF;AACA,MAAI,QAAS,UAAS,KAAK,OAAO;AAClC,SAAO;AACT;AAaO,SAAS,cACd,OACA,SACA,UAAmC,CAAA,GAChB;AACnB,QAAM,QAA2B,CAAA;AACjC,QAAM,4BAAY,IAAA;AAElB,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,QAAQ,IAAI;AACzB,QAAI,KAAK,WAAW,EAAG;AAEvB,QAAI,WAAW;AACf,QAAI,MAAM;AACV,QAAI;AACJ,SAAK,QAAQ,CAAC,SAAS,UAAU;AAC/B,YAAM,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,OAAO,KAAK;AAClD,UAAI,WAAW,MAAM,IAAI,GAAG;AAC5B,UAAI,CAAC,UAAU;AACb,mBAAW;AAAA,UACT;AAAA,UACA,OAAO;AAAA,UACP,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC;AAAA,UAC7B,OAAO,CAAA;AAAA,UACP,UAAU,CAAA;AAAA,QAAC;AAEb,cAAM,IAAI,KAAK,QAAQ;AACvB,iBAAS,KAAK,QAAQ;AAAA,MACxB;AACA,iBAAW,SAAS;AACpB,aAAO;AAAA,IACT,CAAC;AACD,iCAAM,MAAM,KAAK;AAAA,EACnB;AAEA,MAAI,QAAQ,QAAS,UAAS,OAAO,QAAQ,OAAO;AACpD,SAAO;AACT;AAEA,SAAS,SACP,OACA,SACM;AACN,QAAM,KAAK,OAAO;AAClB,aAAW,QAAQ,MAAO,UAAS,KAAK,UAAU,OAAO;AAC3D;AAGO,SAAS,iBAAoB,MAAgC;AAClE,SAAO,KAAK,MAAM,WAAW;AAC/B;AAMO,SAAS,aACd,MACA,OACQ;AACR,QAAM,eAAe,KAAK,SAAS,SAAS;AAC5C,QAAM,gBAAgB,MAAM,SAAS,SAAS;AAC9C,MAAI,iBAAiB,cAAe,QAAO,eAAe,KAAK;AAC/D,SAAO,KAAK,MAAM,cAAc,MAAM,KAAK;AAC7C;;;;;;"}

package/dist/lib/path-tree.d.ts

@@ -0,0 +1,54 @@
+/** The wire separator for a joined path. Matches clicky's entity.PathSeparator. */
+export declare const PATH_SEPARATOR = "/";
+export interface PathTreeNode<T> {
+    /** The joined path — stable across rebuilds, so it works as a React/Tree key. */
+    key: string;
+    /** The node's own last segment. */
+    label: string;
+    /** Every segment from the root down to and including this node. */
+    path: string[];
+    /**
+     * The items whose *full* path lands on this node. Empty means a pure folder
+     * — a node that exists only because something below it does. More than one
+     * means several items share a path (e.g. a file that was both read and
+     * written), which is why this is a list rather than a single value.
+     */
+    items: T[];
+    children: PathTreeNode<T>[];
+}
+export interface BuildPathTreeOptions<T> {
+    /**
+     * Orders siblings at every level. Defaults to the order items were first
+     * seen, which preserves a already-sorted backend list as-is.
+     */
+    compare?: (left: PathTreeNode<T>, right: PathTreeNode<T>) => number;
+}
+/**
+ * Splits `value` into path segments on any character in `delimiters`, dropping
+ * empty segments so leading, trailing and repeated separators are harmless.
+ *
+ * Characters outside `delimiters` are never separators: with `delimiters="."`,
+ * `"remote-debugger.sql-xevent"` yields two segments, not four — a hyphen is an
+ * ordinary name character.
+ */
+export declare function splitPath(value: string, delimiters: string): string[];
+/**
+ * Builds a forest from items keyed by path.
+ *
+ * A node is created for every path prefix, and an item's full path *binds* to
+ * whichever node it lands on — creating it if needed, reusing it if a
+ * descendant already forced it into existence. That is what lets a node be both
+ * a folder and a leaf: `["jms"]` and `["jms", "incoming"]` produce one `jms`
+ * node that is simultaneously selectable and expandable.
+ *
+ * Items whose path is empty are skipped — they have no position in the tree.
+ */
+export declare function buildPathTree<T>(items: readonly T[], getPath: (item: T) => readonly string[], options?: BuildPathTreeOptions<T>): PathTreeNode<T>[];
+/** True when the node exists only to hold descendants — nothing binds to it. */
+export declare function isPathTreeFolder<T>(node: PathTreeNode<T>): boolean;
+/**
+ * A `compare` that puts nodes with children before plain leaves, then orders
+ * each run alphabetically — the conventional file-explorer ordering.
+ */
+export declare function foldersFirst<T>(left: PathTreeNode<T>, right: PathTreeNode<T>): number;
+//# sourceMappingURL=path-tree.d.ts.map

package/dist/lib/path-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-tree.d.ts","sourceRoot":"","sources":["../../src/lib/path-tree.ts"],"names":[],"mappings":"AAMA,mFAAmF;AACnF,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;;OAKG;IACH,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;CACrE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAerE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,EACvC,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,YAAY,CAAC,CAAC,CAAC,EAAE,CAiCnB;AAUD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GACrB,MAAM,CAKR"}

package/dist/lib/path-tree.js

@@ -0,0 +1,69 @@
+const PATH_SEPARATOR = "/";
+function splitPath(value, delimiters) {
+  if (!value) return [];
+  if (!delimiters) return [value];
+  const segments = [];
+  let current = "";
+  for (const character of value) {
+    if (delimiters.includes(character)) {
+      if (current) segments.push(current);
+      current = "";
+    } else {
+      current += character;
+    }
+  }
+  if (current) segments.push(current);
+  return segments;
+}
+function buildPathTree(items, getPath, options = {}) {
+  const roots = [];
+  const byKey = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const path = getPath(item);
+    if (path.length === 0) continue;
+    let siblings = roots;
+    let key = "";
+    let node;
+    path.forEach((segment, index) => {
+      key = key ? `${key}${PATH_SEPARATOR}${segment}` : segment;
+      let existing = byKey.get(key);
+      if (!existing) {
+        existing = {
+          key,
+          label: segment,
+          path: path.slice(0, index + 1),
+          items: [],
+          children: []
+        };
+        byKey.set(key, existing);
+        siblings.push(existing);
+      }
+      siblings = existing.children;
+      node = existing;
+    });
+    node == null ? void 0 : node.items.push(item);
+  }
+  if (options.compare) sortTree(roots, options.compare);
+  return roots;
+}
+function sortTree(nodes, compare) {
+  nodes.sort(compare);
+  for (const node of nodes) sortTree(node.children, compare);
+}
+function isPathTreeFolder(node) {
+  return node.items.length === 0;
+}
+function foldersFirst(left, right) {
+  const leftIsParent = left.children.length > 0;
+  const rightIsParent = right.children.length > 0;
+  if (leftIsParent !== rightIsParent) return leftIsParent ? -1 : 1;
+  return left.label.localeCompare(right.label);
+}
+export {
+  PATH_SEPARATOR,
+  buildPathTree,
+  foldersFirst,
+  isPathTreeFolder,
+  splitPath
+};
+//# sourceMappingURL=path-tree.js.map

package/dist/lib/path-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-tree.js","sources":["../../src/lib/path-tree.ts"],"sourcesContent":["// Turns a flat list of items that each carry a path into a tree, without\n// knowing anything about what the items are. Two independent surfaces need\n// exactly this shape — a session's changed-file list and a backend's\n// hierarchical nav surfaces — so the walker lives here rather than a third\n// time inside a component.\n\n/** The wire separator for a joined path. Matches clicky's entity.PathSeparator. */\nexport const PATH_SEPARATOR = \"/\";\n\nexport interface PathTreeNode<T> {\n  /** The joined path — stable across rebuilds, so it works as a React/Tree key. */\n  key: string;\n  /** The node's own last segment. */\n  label: string;\n  /** Every segment from the root down to and including this node. */\n  path: string[];\n  /**\n   * The items whose *full* path lands on this node. Empty means a pure folder\n   * — a node that exists only because something below it does. More than one\n   * means several items share a path (e.g. a file that was both read and\n   * written), which is why this is a list rather than a single value.\n   */\n  items: T[];\n  children: PathTreeNode<T>[];\n}\n\nexport interface BuildPathTreeOptions<T> {\n  /**\n   * Orders siblings at every level. Defaults to the order items were first\n   * seen, which preserves a already-sorted backend list as-is.\n   */\n  compare?: (left: PathTreeNode<T>, right: PathTreeNode<T>) => number;\n}\n\n/**\n * Splits `value` into path segments on any character in `delimiters`, dropping\n * empty segments so leading, trailing and repeated separators are harmless.\n *\n * Characters outside `delimiters` are never separators: with `delimiters=\".\"`,\n * `\"remote-debugger.sql-xevent\"` yields two segments, not four — a hyphen is an\n * ordinary name character.\n */\nexport function splitPath(value: string, delimiters: string): string[] {\n  if (!value) return [];\n  if (!delimiters) return [value];\n  const segments: string[] = [];\n  let current = \"\";\n  for (const character of value) {\n    if (delimiters.includes(character)) {\n      if (current) segments.push(current);\n      current = \"\";\n    } else {\n      current += character;\n    }\n  }\n  if (current) segments.push(current);\n  return segments;\n}\n\n/**\n * Builds a forest from items keyed by path.\n *\n * A node is created for every path prefix, and an item's full path *binds* to\n * whichever node it lands on — creating it if needed, reusing it if a\n * descendant already forced it into existence. That is what lets a node be both\n * a folder and a leaf: `[\"jms\"]` and `[\"jms\", \"incoming\"]` produce one `jms`\n * node that is simultaneously selectable and expandable.\n *\n * Items whose path is empty are skipped — they have no position in the tree.\n */\nexport function buildPathTree<T>(\n  items: readonly T[],\n  getPath: (item: T) => readonly string[],\n  options: BuildPathTreeOptions<T> = {},\n): PathTreeNode<T>[] {\n  const roots: PathTreeNode<T>[] = [];\n  const byKey = new Map<string, PathTreeNode<T>>();\n\n  for (const item of items) {\n    const path = getPath(item);\n    if (path.length === 0) continue;\n\n    let siblings = roots;\n    let key = \"\";\n    let node: PathTreeNode<T> | undefined;\n    path.forEach((segment, index) => {\n      key = key ? `${key}${PATH_SEPARATOR}${segment}` : segment;\n      let existing = byKey.get(key);\n      if (!existing) {\n        existing = {\n          key,\n          label: segment,\n          path: path.slice(0, index + 1),\n          items: [],\n          children: [],\n        };\n        byKey.set(key, existing);\n        siblings.push(existing);\n      }\n      siblings = existing.children;\n      node = existing;\n    });\n    node?.items.push(item);\n  }\n\n  if (options.compare) sortTree(roots, options.compare);\n  return roots;\n}\n\nfunction sortTree<T>(\n  nodes: PathTreeNode<T>[],\n  compare: (left: PathTreeNode<T>, right: PathTreeNode<T>) => number,\n): void {\n  nodes.sort(compare);\n  for (const node of nodes) sortTree(node.children, compare);\n}\n\n/** True when the node exists only to hold descendants — nothing binds to it. */\nexport function isPathTreeFolder<T>(node: PathTreeNode<T>): boolean {\n  return node.items.length === 0;\n}\n\n/**\n * A `compare` that puts nodes with children before plain leaves, then orders\n * each run alphabetically — the conventional file-explorer ordering.\n */\nexport function foldersFirst<T>(\n  left: PathTreeNode<T>,\n  right: PathTreeNode<T>,\n): number {\n  const leftIsParent = left.children.length > 0;\n  const rightIsParent = right.children.length > 0;\n  if (leftIsParent !== rightIsParent) return leftIsParent ? -1 : 1;\n  return left.label.localeCompare(right.label);\n}\n"],"names":[],"mappings":"AAOO,MAAM,iBAAiB;AAmCvB,SAAS,UAAU,OAAe,YAA8B;AACrE,MAAI,CAAC,MAAO,QAAO,CAAA;AACnB,MAAI,CAAC,WAAY,QAAO,CAAC,KAAK;AAC9B,QAAM,WAAqB,CAAA;AAC3B,MAAI,UAAU;AACd,aAAW,aAAa,OAAO;AAC7B,QAAI,WAAW,SAAS,SAAS,GAAG;AAClC,UAAI,QAAS,UAAS,KAAK,OAAO;AAClC,gBAAU;AAAA,IACZ,OAAO;AACL,iBAAW;AAAA,IACb;AAAA,EACF;AACA,MAAI,QAAS,UAAS,KAAK,OAAO;AAClC,SAAO;AACT;AAaO,SAAS,cACd,OACA,SACA,UAAmC,CAAA,GAChB;AACnB,QAAM,QAA2B,CAAA;AACjC,QAAM,4BAAY,IAAA;AAElB,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,QAAQ,IAAI;AACzB,QAAI,KAAK,WAAW,EAAG;AAEvB,QAAI,WAAW;AACf,QAAI,MAAM;AACV,QAAI;AACJ,SAAK,QAAQ,CAAC,SAAS,UAAU;AAC/B,YAAM,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,OAAO,KAAK;AAClD,UAAI,WAAW,MAAM,IAAI,GAAG;AAC5B,UAAI,CAAC,UAAU;AACb,mBAAW;AAAA,UACT;AAAA,UACA,OAAO;AAAA,UACP,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC;AAAA,UAC7B,OAAO,CAAA;AAAA,UACP,UAAU,CAAA;AAAA,QAAC;AAEb,cAAM,IAAI,KAAK,QAAQ;AACvB,iBAAS,KAAK,QAAQ;AAAA,MACxB;AACA,iBAAW,SAAS;AACpB,aAAO;AAAA,IACT,CAAC;AACD,iCAAM,MAAM,KAAK;AAAA,EACnB;AAEA,MAAI,QAAQ,QAAS,UAAS,OAAO,QAAQ,OAAO;AACpD,SAAO;AACT;AAEA,SAAS,SACP,OACA,SACM;AACN,QAAM,KAAK,OAAO;AAClB,aAAW,QAAQ,MAAO,UAAS,KAAK,UAAU,OAAO;AAC3D;AAGO,SAAS,iBAAoB,MAAgC;AAClE,SAAO,KAAK,MAAM,WAAW;AAC/B;AAMO,SAAS,aACd,MACA,OACQ;AACR,QAAM,eAAe,KAAK,SAAS,SAAS;AAC5C,QAAM,gBAAgB,MAAM,SAAS,SAAS;AAC9C,MAAI,iBAAiB,cAAe,QAAO,eAAe,KAAK;AAC/D,SAAO,KAAK,MAAM,cAAc,MAAM,KAAK;AAC7C;"}