@flanksource/clicky-ui 0.2.16 → 0.2.18

package/dist/data/version-info.cjs

@@ -15,9 +15,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "815fc3b", ""),
-    tag: read(() => "clicky-ui@0.2.15", ""),
-    date: read(() => "2026-06-11T10:01:07.060Z", ""),
+    commit: read(() => "cd413ec", ""),
+    tag: read(() => "clicky-ui@0.2.16", ""),
+    date: read(() => "2026-06-14T20:30:58.296Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };

package/dist/data/version-info.js

@@ -13,9 +13,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "815fc3b", ""),
-    tag: read(() => "clicky-ui@0.2.15", ""),
-    date: read(() => "2026-06-11T10:00:55.956Z", ""),
+    commit: read(() => "cd413ec", ""),
+    tag: read(() => "clicky-ui@0.2.16", ""),
+    date: read(() => "2026-06-14T20:30:46.600Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };

package/dist/data.cjs

@@ -330,6 +330,7 @@ const UiWrench = require("./icons/components/UiWrench.cjs");
 const UiZap = require("./icons/components/UiZap.cjs");
 const UiZoomIn = require("./icons/components/UiZoomIn.cjs");
 const UiZoomOut = require("./icons/components/UiZoomOut.cjs");
+const routePath = require("./data/test-runner/routePath.cjs");
 const api = require("./data/cache-browser/api.cjs");
 const changeIconAliases = require("./icons/changeIconAliases.cjs");
 const status = require("./data/test-runner/status.cjs");
@@ -947,6 +948,9 @@ exports.UiZoomIn = UiZoomIn.UiZoomIn;
 exports.UiZoomInFilled = UiZoomIn.UiZoomInFilled;
 exports.UiZoomOut = UiZoomOut.UiZoomOut;
 exports.UiZoomOutFilled = UiZoomOut.UiZoomOutFilled;
+exports.annotateRoutePaths = routePath.annotateRoutePaths;
+exports.findNodeByRoutePath = routePath.findNodeByRoutePath;
+exports.slugify = routePath.slugify;
 exports.cacheQueryKeys = api.cacheQueryKeys;
 exports.createCacheClient = api.createCacheClient;
 exports.changeIconAliases = changeIconAliases.changeIconAliases;

package/dist/data.cjs.map

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

package/dist/data.js

@@ -328,6 +328,7 @@ import { UiWrench, UiWrenchFilled } from "./icons/components/UiWrench.js";
 import { UiZap, UiZapFilled } from "./icons/components/UiZap.js";
 import { UiZoomIn, UiZoomInFilled } from "./icons/components/UiZoomIn.js";
 import { UiZoomOut, UiZoomOutFilled } from "./icons/components/UiZoomOut.js";
+import { annotateRoutePaths, findNodeByRoutePath, slugify } from "./data/test-runner/routePath.js";
 import { cacheQueryKeys, createCacheClient } from "./data/cache-browser/api.js";
 import { changeIconAliases, getChangeIcon } from "./icons/changeIconAliases.js";
 import { collapseSingleChildChains, collectFrameworks, filterTests, formatCount, formatTestDuration, hasFailed, hasPending, humanizeName, statusIconFor, statusToneFor, sum, sumNonTaskTests, testStatus, totalDuration } from "./data/test-runner/status.js";
@@ -893,6 +894,7 @@ export {
   UiZoomOutFilled,
   Version,
   allGroupsTerminal,
+  annotateRoutePaths,
   badgeVariants,
   bucketTasks,
   cacheQueryKeys,
@@ -915,6 +917,7 @@ export {
   emptyTestFilters,
   encodeFilterState,
   filterTests,
+  findNodeByRoutePath,
   findProcessByPID,
   formatCount,
   formatDateTimeRelative,
@@ -955,6 +958,7 @@ export {
   resolveSeries,
   segment,
   setFallbackIconProvider,
+  slugify,
   splitTagToken,
   statusIconFor,
   statusToneFor,

package/dist/data.js.map

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

package/dist/hooks/use-task-run.cjs

@@ -97,39 +97,52 @@ function useTaskRuns(options = {}) {
     labels,
     basePath = DEFAULT_BASE,
     enabled = true,
-    pollMs = DEFAULT_POLL_MS
+    pollMs = DEFAULT_POLL_MS,
+    forcePoll = false
   } = options;
   const [runs, setRuns] = react.useState([]);
   const [status, setStatus] = react.useState("idle");
   react.useEffect(() => {
     if (!enabled) return;
-    let stopped = false;
-    let timer;
     const params = new URLSearchParams();
     if (kind) params.set("kind", kind);
     if (statusFilter) params.set("status", statusFilter);
     for (const [k, v] of Object.entries(labels ?? {})) params.append("label", `${k}=${v}`);
     const query = params.toString();
-    const tick = async () => {
-      try {
-        const res = await fetch(`${basePath}/tasks${query ? `?${query}` : ""}`, {
-          headers: { Accept: "application/json" }
-        });
-        if (res.ok) {
-          setRuns(await res.json());
-          setStatus("ok");
+    if (forcePoll || !hasEventSource()) {
+      let stopped = false;
+      let timer;
+      const tick = async () => {
+        try {
+          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : ""}`, {
+            headers: { Accept: "application/json" }
+          });
+          if (res.ok) {
+            setRuns(await res.json());
+            setStatus("polling");
+          }
+        } catch {
+          setStatus("connection lost — retrying");
         }
+        if (!stopped) timer = setTimeout(tick, pollMs);
+      };
+      void tick();
+      return () => {
+        stopped = true;
+        if (timer) clearTimeout(timer);
+      };
+    }
+    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : ""}`);
+    setStatus("connected");
+    es.addEventListener("runs", (e) => {
+      try {
+        setRuns(JSON.parse(e.data));
       } catch {
-        setStatus("connection lost — retrying");
       }
-      if (!stopped) timer = setTimeout(tick, pollMs);
-    };
-    void tick();
-    return () => {
-      stopped = true;
-      if (timer) clearTimeout(timer);
-    };
-  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs]);
+    });
+    es.onerror = () => setStatus("connection lost — retrying");
+    return () => es.close();
+  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);
   return { runs, status };
 }
 exports.useTaskRun = useTaskRun;

package/dist/hooks/use-task-run.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.cjs","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [id, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view by polling the\n// runs endpoint. The listing has no completion terminal of its own, so it polls\n// on an interval (cheap GET) regardless of transport.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n  } = options;\n\n  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n\n    const tick = async () => {\n      try {\n        const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n          headers: { Accept: \"application/json\" },\n        });\n        if (res.ok) {\n          setRuns((await res.json()) as TaskRunMeta[]);\n          setStatus(\"ok\");\n        }\n      } catch {\n        setStatus(\"connection lost — retrying\");\n      }\n      if (!stopped) timer = setTimeout(tick, pollMs);\n    };\n    void tick();\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs]);\n\n  return { runs, status };\n}\n"],"names":["useState","useRef","useEffect","allGroupsTerminal"],"mappings":"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"}
+{"version":3,"file":"use-task-run.cjs","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [id, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            setRuns((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        setRuns(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs, status };\n}\n"],"names":["useState","useRef","useEffect","allGroupsTerminal"],"mappings":"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"}

package/dist/hooks/use-task-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.d.ts","sourceRoot":"","sources":["../../src/hooks/use-task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAO9B,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAaD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA0F5E;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA8C/E"}
+{"version":3,"file":"use-task-run.d.ts","sourceRoot":"","sources":["../../src/hooks/use-task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAO9B,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAaD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA0F5E;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA+D/E"}

package/dist/hooks/use-task-run.js

@@ -95,39 +95,52 @@ function useTaskRuns(options = {}) {
     labels,
     basePath = DEFAULT_BASE,
     enabled = true,
-    pollMs = DEFAULT_POLL_MS
+    pollMs = DEFAULT_POLL_MS,
+    forcePoll = false
   } = options;
   const [runs, setRuns] = useState([]);
   const [status, setStatus] = useState("idle");
   useEffect(() => {
     if (!enabled) return;
-    let stopped = false;
-    let timer;
     const params = new URLSearchParams();
     if (kind) params.set("kind", kind);
     if (statusFilter) params.set("status", statusFilter);
     for (const [k, v] of Object.entries(labels ?? {})) params.append("label", `${k}=${v}`);
     const query = params.toString();
-    const tick = async () => {
-      try {
-        const res = await fetch(`${basePath}/tasks${query ? `?${query}` : ""}`, {
-          headers: { Accept: "application/json" }
-        });
-        if (res.ok) {
-          setRuns(await res.json());
-          setStatus("ok");
+    if (forcePoll || !hasEventSource()) {
+      let stopped = false;
+      let timer;
+      const tick = async () => {
+        try {
+          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : ""}`, {
+            headers: { Accept: "application/json" }
+          });
+          if (res.ok) {
+            setRuns(await res.json());
+            setStatus("polling");
+          }
+        } catch {
+          setStatus("connection lost — retrying");
         }
+        if (!stopped) timer = setTimeout(tick, pollMs);
+      };
+      void tick();
+      return () => {
+        stopped = true;
+        if (timer) clearTimeout(timer);
+      };
+    }
+    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : ""}`);
+    setStatus("connected");
+    es.addEventListener("runs", (e) => {
+      try {
+        setRuns(JSON.parse(e.data));
       } catch {
-        setStatus("connection lost — retrying");
       }
-      if (!stopped) timer = setTimeout(tick, pollMs);
-    };
-    void tick();
-    return () => {
-      stopped = true;
-      if (timer) clearTimeout(timer);
-    };
-  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs]);
+    });
+    es.onerror = () => setStatus("connection lost — retrying");
+    return () => es.close();
+  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);
   return { runs, status };
 }
 export {

package/dist/hooks/use-task-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.js","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [id, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view by polling the\n// runs endpoint. The listing has no completion terminal of its own, so it polls\n// on an interval (cheap GET) regardless of transport.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n  } = options;\n\n  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n\n    const tick = async () => {\n      try {\n        const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n          headers: { Accept: \"application/json\" },\n        });\n        if (res.ok) {\n          setRuns((await res.json()) as TaskRunMeta[]);\n          setStatus(\"ok\");\n        }\n      } catch {\n        setStatus(\"connection lost — retrying\");\n      }\n      if (!stopped) timer = setTimeout(tick, pollMs);\n    };\n    void tick();\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs]);\n\n  return { runs, status };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-task-run.js","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [id, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            setRuns((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        setRuns(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs, status };\n}\n"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -393,6 +393,7 @@ const UiWrench = require("./icons/components/UiWrench.cjs");
 const UiZap = require("./icons/components/UiZap.cjs");
 const UiZoomIn = require("./icons/components/UiZoomIn.cjs");
 const UiZoomOut = require("./icons/components/UiZoomOut.cjs");
+const routePath = require("./data/test-runner/routePath.cjs");
 const api = require("./data/cache-browser/api.cjs");
 const changeIconAliases = require("./icons/changeIconAliases.cjs");
 const status = require("./data/test-runner/status.cjs");
@@ -436,6 +437,7 @@ exports.DateTimePicker = DateTimePicker.DateTimePicker;
 exports.TimeRange = TimeRange.TimeRange;
 exports.RangeSlider = RangeSlider.RangeSlider;
 exports.FilterBar = FilterBar.FilterBar;
+exports.TriStateMultiSelect = FilterBar.TriStateMultiSelect;
 exports.applyFilterExtensions = FilterBar.applyFilterExtensions;
 exports.MultiSelect = MultiSelect.MultiSelect;
 exports.Select = select.Select;
@@ -1106,6 +1108,9 @@ exports.UiZoomIn = UiZoomIn.UiZoomIn;
 exports.UiZoomInFilled = UiZoomIn.UiZoomInFilled;
 exports.UiZoomOut = UiZoomOut.UiZoomOut;
 exports.UiZoomOutFilled = UiZoomOut.UiZoomOutFilled;
+exports.annotateRoutePaths = routePath.annotateRoutePaths;
+exports.findNodeByRoutePath = routePath.findNodeByRoutePath;
+exports.slugify = routePath.slugify;
 exports.cacheQueryKeys = api.cacheQueryKeys;
 exports.createCacheClient = api.createCacheClient;
 exports.changeIconAliases = changeIconAliases.changeIconAliases;

package/dist/index.cjs.map

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

package/dist/index.js

@@ -21,7 +21,7 @@ import { DatePicker } from "./components/DatePicker.js";
 import { DateTimePicker } from "./components/DateTimePicker.js";
 import { TimeRange } from "./components/TimeRange.js";
 import { RangeSlider } from "./components/RangeSlider.js";
-import { FilterBar, applyFilterExtensions } from "./components/FilterBar.js";
+import { FilterBar, TriStateMultiSelect, applyFilterExtensions } from "./components/FilterBar.js";
 import { MultiSelect } from "./components/MultiSelect.js";
 import { Select } from "./components/select.js";
 import { Combobox } from "./components/Combobox.js";
@@ -391,6 +391,7 @@ import { UiWrench, UiWrenchFilled } from "./icons/components/UiWrench.js";
 import { UiZap, UiZapFilled } from "./icons/components/UiZap.js";
 import { UiZoomIn, UiZoomInFilled } from "./icons/components/UiZoomIn.js";
 import { UiZoomOut, UiZoomOutFilled } from "./icons/components/UiZoomOut.js";
+import { annotateRoutePaths, findNodeByRoutePath, slugify } from "./data/test-runner/routePath.js";
 import { cacheQueryKeys, createCacheClient } from "./data/cache-browser/api.js";
 import { changeIconAliases, getChangeIcon } from "./icons/changeIconAliases.js";
 import { collapseSingleChildChains, collectFrameworks, filterTests, formatCount, formatTestDuration, hasFailed, hasPending, humanizeName, statusIconFor, statusToneFor, sum, sumNonTaskTests, testStatus, totalDuration } from "./data/test-runner/status.js";
@@ -517,6 +518,7 @@ export {
   TreeGroupHeader,
   TreeNode,
   TreePickerField,
+  TriStateMultiSelect,
   UiActivity,
   UiAdd,
   UiAddFilled,
@@ -1010,6 +1012,7 @@ export {
   Version,
   WorkloadPicker,
   allGroupsTerminal,
+  annotateRoutePaths,
   applyFilterExtensions,
   badgeVariants,
   bucketTasks,
@@ -1040,6 +1043,7 @@ export {
   filterTests,
   findDetailEndpoint,
   findListEndpoint,
+  findNodeByRoutePath,
   findProcessByPID,
   fnv1a32,
   formatBytes,
@@ -1098,6 +1102,7 @@ export {
   resolveSize,
   segment,
   setFallbackIconProvider,
+  slugify,
   splitTagToken,
   statusIconFor,
   statusToneFor,

package/dist/index.js.map

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