@flanksource/clicky-ui 0.3.40 → 0.3.42

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;AAQ9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxD,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,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAyI5E;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,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA2E/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;AAQ9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQxD,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,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAgJ5E;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,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA+E/E"}

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

@@ -1,7 +1,8 @@
-import { useState, useEffect, useMemo } from "react";
+import { useState, useRef, useEffect, useMemo } from "react";
 import { allGroupsTerminal } from "../data/TaskSnapshot.js";
 import { withTaskStreams, applyTaskOutputDelta, emptyTaskStreams } from "../data/task-streams.js";
 import { taskQueryKeys } from "../data/task-query-keys.js";
+import { useEventSourceFactory } from "./event-source.js";
 const DEFAULT_BASE = "/api/v1";
 const DEFAULT_POLL_MS = 2e3;
 function streamUrl(base, query) {
@@ -27,6 +28,9 @@ function useTaskRun(options = {}) {
   const [streamsById, setStreamsById] = useState({});
   const [status, setStatus] = useState("idle");
   const [isComplete, setIsComplete] = useState(false);
+  const eventSourceFactory = useEventSourceFactory();
+  const eventSourceFactoryRef = useRef(eventSourceFactory);
+  eventSourceFactoryRef.current = eventSourceFactory;
   useEffect(() => {
     const runIds = runIdsKey ? runIdsKey.split(",") : [];
     setStateKey(subscriptionKey);
@@ -90,7 +94,7 @@ function useTaskRun(options = {}) {
         if (timer) clearTimeout(timer);
       };
     }
-    const es = new EventSource(streamUrl(basePath, query));
+    const es = eventSourceFactoryRef.current(streamUrl(basePath, query));
     setStatus("connecting");
     es.onopen = () => setStatus("connected");
     es.addEventListener("task", (e) => {
@@ -135,6 +139,9 @@ function useTaskRuns(options = {}) {
   } = options;
   const [received, setReceived] = useState({ key: null, runs: [] });
   const [status, setStatus] = useState("idle");
+  const eventSourceFactory = useEventSourceFactory();
+  const eventSourceFactoryRef = useRef(eventSourceFactory);
+  eventSourceFactoryRef.current = eventSourceFactory;
   useEffect(() => {
     if (!enabled) return;
     const params = new URLSearchParams();
@@ -170,7 +177,7 @@ function useTaskRuns(options = {}) {
         if (timer) clearTimeout(timer);
       };
     }
-    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : ""}`);
+    const es = eventSourceFactoryRef.current(`${basePath}/tasks/runs/stream${query ? `?${query}` : ""}`);
     setStatus("connecting");
     es.onopen = () => setStatus("connected");
     es.addEventListener("runs", (e) => {

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, useMemo, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport {\n  applyTaskOutputDelta,\n  emptyTaskStreams,\n  type TaskOutputDelta,\n  type TaskStreams,\n  withTaskStreams,\n} from \"../data/task-streams\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\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 ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (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    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n  // State is reset in an effect, so the first render after the subscription\n  // changes still holds the previous run's snapshots and completion; stateKey\n  // hides them until the reset lands.\n  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? \"\", basePath, enabled]);\n  const [stateKey, setStateKey] = useState(subscriptionKey);\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  // Streams are held beside the snapshots, never inside them: a task frame\n  // replaces its snapshot wholesale and would take the accumulated output with\n  // it. See ../data/task-streams.\n  const [streamsById, setStreamsById] = useState<Record<string, TaskStreams>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    setStateKey(subscriptionKey);\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStreamsById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setStreamsById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\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.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Deltas are applied whether or not the task frame has landed yet: the\n    // stream is keyed by task id on its own, so output that arrives first is\n    // held rather than dropped.\n    const mergeOutput = (delta: TaskOutputDelta) => {\n      setStreamsById((prev) => ({\n        ...prev,\n        [delta.id]: applyTaskOutputDelta(prev[delta.id] ?? emptyTaskStreams, delta),\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 responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) 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(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as TaskOutputDelta);\n      } catch {\n        setStatus(\"invalid task output data\");\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  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  const current = stateKey === subscriptionKey;\n  // The streams are merged back in only here, at the boundary. The polling\n  // fallback never populates them — its JSON snapshots already carry the full\n  // output — so this is a no-op on that transport.\n  const snapshots = useMemo(\n    () => current\n      ? Object.values(byId).map((snapshot) => withTaskStreams(snapshot, streamsById[snapshot.id]))\n      : [],\n    [current, byId, streamsById],\n  );\n\n  return { snapshots, status: current ? status : \"idle\", isComplete: current && 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\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\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  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\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    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\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) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) 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(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\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: received.runs, status, runsKey: received.key };\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, useMemo, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport {\n  applyTaskOutputDelta,\n  emptyTaskStreams,\n  type TaskOutputDelta,\n  type TaskStreams,\n  withTaskStreams,\n} from \"../data/task-streams\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\nimport { useEventSourceFactory } from \"./event-source\";\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 ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (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    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n  // State is reset in an effect, so the first render after the subscription\n  // changes still holds the previous run's snapshots and completion; stateKey\n  // hides them until the reset lands.\n  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? \"\", basePath, enabled]);\n  const [stateKey, setStateKey] = useState(subscriptionKey);\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  // Streams are held beside the snapshots, never inside them: a task frame\n  // replaces its snapshot wholesale and would take the accumulated output with\n  // it. See ../data/task-streams.\n  const [streamsById, setStreamsById] = useState<Record<string, TaskStreams>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  // Read through a ref so a host's inline `value={(url) => ...}` factory prop\n  // does not restart the subscription every render — only the effect's own\n  // deps below do that.\n  const eventSourceFactory = useEventSourceFactory();\n  const eventSourceFactoryRef = useRef(eventSourceFactory);\n  eventSourceFactoryRef.current = eventSourceFactory;\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    setStateKey(subscriptionKey);\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStreamsById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setStreamsById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\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.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Deltas are applied whether or not the task frame has landed yet: the\n    // stream is keyed by task id on its own, so output that arrives first is\n    // held rather than dropped.\n    const mergeOutput = (delta: TaskOutputDelta) => {\n      setStreamsById((prev) => ({\n        ...prev,\n        [delta.id]: applyTaskOutputDelta(prev[delta.id] ?? emptyTaskStreams, delta),\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 responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) 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 = eventSourceFactoryRef.current(streamUrl(basePath, query));\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as TaskOutputDelta);\n      } catch {\n        setStatus(\"invalid task output data\");\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  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  const current = stateKey === subscriptionKey;\n  // The streams are merged back in only here, at the boundary. The polling\n  // fallback never populates them — its JSON snapshots already carry the full\n  // output — so this is a no-op on that transport.\n  const snapshots = useMemo(\n    () => current\n      ? Object.values(byId).map((snapshot) => withTaskStreams(snapshot, streamsById[snapshot.id]))\n      : [],\n    [current, byId, streamsById],\n  );\n\n  return { snapshots, status: current ? status : \"idle\", isComplete: current && 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\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\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  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\n  const [status, setStatus] = useState(\"idle\");\n\n  const eventSourceFactory = useEventSourceFactory();\n  const eventSourceFactoryRef = useRef(eventSourceFactory);\n  eventSourceFactoryRef.current = eventSourceFactory;\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    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\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) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) 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 = eventSourceFactoryRef.current(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\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: received.runs, status, runsKey: received.key };\n}\n"],"names":[],"mappings":"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"}

package/dist/hooks.cjs

@@ -8,6 +8,8 @@ const useDensity = require("./hooks/use-density.cjs");
 const densityProvider = require("./hooks/density-provider.cjs");
 const useSort = require("./hooks/use-sort.cjs");
 const useHistoryRoute = require("./hooks/use-history-route.cjs");
+const eventSource = require("./hooks/event-source.cjs");
+const eventSourceProvider = require("./hooks/event-source-provider.cjs");
 const useTaskRun = require("./hooks/use-task-run.cjs");
 const usePrompts = require("./hooks/use-prompts.cjs");
 const useHotkey = require("./hooks/use-hotkey.cjs");
@@ -27,6 +29,8 @@ exports.DensityProvider = densityProvider.DensityProvider;
 exports.DensityValueProvider = densityProvider.DensityValueProvider;
 exports.useSort = useSort.useSort;
 exports.useHistoryRoute = useHistoryRoute.useHistoryRoute;
+exports.useEventSourceFactory = eventSource.useEventSourceFactory;
+exports.EventSourceProvider = eventSourceProvider.EventSourceProvider;
 exports.useTaskRun = useTaskRun.useTaskRun;
 exports.useTaskRuns = useTaskRun.useTaskRuns;
 exports.answerPrompt = usePrompts.answerPrompt;

package/dist/hooks.cjs.map

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

package/dist/hooks.d.ts

@@ -6,6 +6,8 @@ export { useDensity, useDensityValue, type Density } from './hooks/use-density.j
 export { DensityProvider, DensityValueProvider, type DensityProviderProps, } from './hooks/density-provider.js';
 export { useSort, type SortDir, type SortState, type UseSortOptions, type UseSortReturn, } from './hooks/use-sort.js';
 export { useHistoryRoute, type UseHistoryRouteOptions } from './hooks/use-history-route.js';
+export { useEventSourceFactory, type EventSourceFactory, type EventSourceLike, } from './hooks/event-source.js';
+export { EventSourceProvider, type EventSourceProviderProps, } from './hooks/event-source-provider.js';
 export { useTaskRun, useTaskRuns, type UseTaskRunOptions, type UseTaskRunResult, type UseTaskRunsOptions, type UseTaskRunsResult, type TaskTransportOptions, } from './hooks/use-task-run.js';
 export { usePrompts, answerPrompt, type PromptSnapshot, type PromptFilter, type UsePromptsOptions, type UsePromptsResult, } from './hooks/use-prompts.js';
 export { useHotkey, parseHotkey, formatHotkey, type UseHotkeyOptions, type ParsedHotkey, } from './hooks/use-hotkey.js';

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,KAAK,EACV,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EACL,UAAU,EACV,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,KAAK,EACV,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,EACV,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/hooks.js

@@ -6,6 +6,8 @@ import { useDensity, useDensityValue } from "./hooks/use-density.js";
 import { DensityProvider, DensityValueProvider } from "./hooks/density-provider.js";
 import { useSort } from "./hooks/use-sort.js";
 import { useHistoryRoute } from "./hooks/use-history-route.js";
+import { useEventSourceFactory } from "./hooks/event-source.js";
+import { EventSourceProvider } from "./hooks/event-source-provider.js";
 import { useTaskRun, useTaskRuns } from "./hooks/use-task-run.js";
 import { answerPrompt, usePrompts } from "./hooks/use-prompts.js";
 import { formatHotkey, parseHotkey, useHotkey } from "./hooks/use-hotkey.js";
@@ -14,6 +16,7 @@ import { isNearTop, isPinnedToBottom } from "./data/ai/use-session-scroll.js";
 export {
   DensityProvider,
   DensityValueProvider,
+  EventSourceProvider,
   ThemeProvider,
   answerPrompt,
   appendTailEvent,
@@ -29,6 +32,7 @@ export {
   useContainerWiderThan,
   useDensity,
   useDensityValue,
+  useEventSourceFactory,
   useHistoryRoute,
   useHotkey,
   useLogTail,

package/dist/hooks.js.map

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

package/dist/icons/programmingCatalog.cjs

@@ -269,9 +269,9 @@ const programmingIconCatalog = [
   { id: "programming-field-value1", componentName: "UiVariable1", label: "Field Value1", family: "Code symbols and members", concept: "Variable", variation: "Field Value1", tone: "identity", source: "jb-download-unverified:field-value1", headerVerified: false, icon: UiVariable1.UiVariable1, darkIcon: UiVariable1.UiVariable1Dark },
   { id: "programming-file-format", componentName: "UiFileFormat", label: "File Format", family: "Code symbols and members", concept: "File Format", variation: "File Format", tone: "identity", source: "jb-download:file-format", headerVerified: true, icon: UiFileFormat.UiFileFormat, darkIcon: UiFileFormat.UiFileFormatDark },
   { id: "programming-flame", componentName: "UiProfile1", label: "Flame", family: "Debugging and profiling", concept: "Profile and trace", variation: "Flame", tone: "identity", source: "jb-download-unverified:flame", headerVerified: false, icon: UiProfile1.UiProfile1, darkIcon: UiProfile1.UiProfile1Dark },
-  { id: "programming-force-run-to-cursor", componentName: "UiStep1", label: "Force Run To Cursor", family: "Code symbols and members", concept: "Debugger step", variation: "Force Run To Cursor", tone: "identity", source: "jb-download:force-run-to-cursor", headerVerified: true, icon: UiStep1.UiStep1, darkIcon: UiStep1.UiStep1Dark },
-  { id: "programming-force-step-into", componentName: "UiStep2", label: "Force Step Into", family: "Debugging and profiling", concept: "Debugger step", variation: "Force Step Into", tone: "action", source: "jb-download:force-step-into", headerVerified: true, icon: UiStep2.UiStep2, darkIcon: UiStep2.UiStep2Dark },
-  { id: "programming-force-step-over", componentName: "UiStep3", label: "Force Step Over", family: "Debugging and profiling", concept: "Debugger step", variation: "Force Step Over", tone: "action", source: "jb-download:force-step-over", headerVerified: true, icon: UiStep3.UiStep3, darkIcon: UiStep3.UiStep3Dark },
+  { id: "programming-force-run-to-cursor", componentName: "UiStep1", label: "Force Run To Cursor", family: "Debugging and profiling", concept: "Run to cursor", variation: "Force Run To Cursor", tone: "identity", source: "jb-download:force-run-to-cursor", headerVerified: true, icon: UiStep1.UiStep1, darkIcon: UiStep1.UiStep1Dark },
+  { id: "programming-force-step-into", componentName: "UiStep2", label: "Force Step Into", family: "Debugging and profiling", concept: "Step into", variation: "Force Step Into", tone: "action", source: "jb-download:force-step-into", headerVerified: true, icon: UiStep2.UiStep2, darkIcon: UiStep2.UiStep2Dark },
+  { id: "programming-force-step-over", componentName: "UiStep3", label: "Force Step Over", family: "Debugging and profiling", concept: "Step over", variation: "Force Step Over", tone: "action", source: "jb-download:force-step-over", headerVerified: true, icon: UiStep3.UiStep3, darkIcon: UiStep3.UiStep3Dark },
   { id: "programming-foreign-server", componentName: "UiForeignServer", label: "Foreign Server", family: "Database and data", concept: "Foreign Server", variation: "Foreign Server", tone: "identity", source: "jb-download:foreign-server", headerVerified: true, icon: UiForeignServer.UiForeignServer, darkIcon: UiForeignServer.UiForeignServerDark },
   { id: "programming-foreign-table", componentName: "UiTable1", label: "Foreign Table", family: "Database and data", concept: "Table and view", variation: "Foreign Table", tone: "identity", source: "jb-download:foreign-table", headerVerified: true, icon: UiTable1.UiTable1, darkIcon: UiTable1.UiTable1Dark },
   { id: "programming-freemarker", componentName: "UiFreemarker", label: "Freemarker", family: "Frameworks and platforms", concept: "Freemarker", variation: "Freemarker", tone: "identity", source: "jb-download:freemarker", headerVerified: true, icon: UiFreemarker.UiFreemarker, darkIcon: UiFreemarker.UiFreemarkerDark },
@@ -279,10 +279,10 @@ const programmingIconCatalog = [
   { id: "programming-function-run", componentName: "UiFunction2", label: "Function Run", family: "Code symbols and members", concept: "Function", variation: "Function Run", tone: "identity", source: "jb-download:function-run", headerVerified: true, icon: UiFunction2.UiFunction2, darkIcon: UiFunction2.UiFunction2Dark },
   { id: "programming-go-to-table", componentName: "UiTable2", label: "Go To Table", family: "Database and data", concept: "Table and view", variation: "Go To Table", tone: "action", source: "jb-download:go-to-table", headerVerified: true, icon: UiTable2.UiTable2, darkIcon: UiTable2.UiTable2Dark },
   { id: "programming-grey-key", componentName: "UiGreyKey", label: "Grey Key", family: "Database and data", concept: "Grey Key", variation: "Grey Key", tone: "identity", source: "jb-download:grey-key", headerVerified: true, icon: UiGreyKey.UiGreyKey, darkIcon: UiGreyKey.UiGreyKeyDark },
-  { id: "programming-group-by-method", componentName: "UiMethod3", label: "Group By Method", family: "Navigation and organization", concept: "Method", variation: "Group By Method", tone: "identity", source: "jb-download:group-by-method", headerVerified: true, icon: UiMethod3.UiMethod3, darkIcon: UiMethod3.UiMethod3Dark },
-  { id: "programming-group-by-module-group", componentName: "UiGroupByModuleGroup", label: "Group By Module Group", family: "Navigation and organization", concept: "Group By Module Group", variation: "Group By Module Group", tone: "identity", source: "jb-download:group-by-module-group", headerVerified: true, icon: UiGroupByModuleGroup.UiGroupByModuleGroup, darkIcon: UiGroupByModuleGroup.UiGroupByModuleGroupDark },
-  { id: "programming-group-by-package", componentName: "UiGroupByPackage", label: "Group By Package", family: "Navigation and organization", concept: "Group By Package", variation: "Group By Package", tone: "identity", source: "jb-download:group-by-package", headerVerified: true, icon: UiGroupByPackage.UiGroupByPackage, darkIcon: UiGroupByPackage.UiGroupByPackageDark },
-  { id: "programming-group-by-test-production", componentName: "UiGroupByTestProduction", label: "Group By Test Production", family: "Navigation and organization", concept: "Group By Test Production", variation: "Group By Test Production", tone: "identity", source: "jb-download:group-by-test-production", headerVerified: true, icon: UiGroupByTestProduction.UiGroupByTestProduction, darkIcon: UiGroupByTestProduction.UiGroupByTestProductionDark },
+  { id: "programming-group-by-method", componentName: "UiMethod3", label: "Group By Method", family: "Navigation and organization", concept: "Grouping", variation: "Group By Method", tone: "identity", source: "jb-download:group-by-method", headerVerified: true, icon: UiMethod3.UiMethod3, darkIcon: UiMethod3.UiMethod3Dark },
+  { id: "programming-group-by-module-group", componentName: "UiGroupByModuleGroup", label: "Group By Module Group", family: "Navigation and organization", concept: "Grouping", variation: "Group By Module Group", tone: "identity", source: "jb-download:group-by-module-group", headerVerified: true, icon: UiGroupByModuleGroup.UiGroupByModuleGroup, darkIcon: UiGroupByModuleGroup.UiGroupByModuleGroupDark },
+  { id: "programming-group-by-package", componentName: "UiGroupByPackage", label: "Group By Package", family: "Navigation and organization", concept: "Grouping", variation: "Group By Package", tone: "identity", source: "jb-download:group-by-package", headerVerified: true, icon: UiGroupByPackage.UiGroupByPackage, darkIcon: UiGroupByPackage.UiGroupByPackageDark },
+  { id: "programming-group-by-test-production", componentName: "UiGroupByTestProduction", label: "Group By Test Production", family: "Navigation and organization", concept: "Grouping", variation: "Group By Test Production", tone: "identity", source: "jb-download:group-by-test-production", headerVerified: true, icon: UiGroupByTestProduction.UiGroupByTestProduction, darkIcon: UiGroupByTestProduction.UiGroupByTestProductionDark },
   { id: "programming-gvariable", componentName: "UiVariable2", label: "Gvariable", family: "Code symbols and members", concept: "Variable", variation: "Gvariable", tone: "identity", source: "jb-download:gvariable", headerVerified: true, icon: UiVariable2.UiVariable2, darkIcon: UiVariable2.UiVariable2Dark },
   { id: "programming-hibernate", componentName: "UiHibernate", label: "Hibernate", family: "Frameworks and platforms", concept: "Hibernate", variation: "Hibernate", tone: "identity", source: "jb-download:hibernate", headerVerified: true, icon: UiHibernate.UiHibernate, darkIcon: UiHibernate.UiHibernateDark },
   { id: "programming-hibernate-event", componentName: "UiHibernateEvent", label: "Hibernate Event", family: "Frameworks and platforms", concept: "Hibernate Event", variation: "Hibernate Event", tone: "identity", source: "jb-download-unverified:hibernate-event", headerVerified: false, icon: UiHibernateEvent.UiHibernateEvent, darkIcon: UiHibernateEvent.UiHibernateEventDark },
@@ -291,7 +291,7 @@ const programmingIconCatalog = [
   { id: "programming-index-alt-1", componentName: "UiIndex4", label: "Index", family: "Database and data", concept: "Index", variation: "Alternative 1", tone: "identity", source: "jb-download:index-alt-1", headerVerified: true, icon: UiIndex4.UiIndex4, darkIcon: UiIndex4.UiIndex4Dark },
   { id: "programming-index", componentName: "UiIndex", label: "Index", family: "Database and data", concept: "Index", variation: "Index", tone: "identity", source: "jb-download:index", headerVerified: true, icon: UiIndex.UiIndex, darkIcon: UiIndex.UiIndexDark },
   { id: "programming-index-fun", componentName: "UiFunction4", label: "Index Fun", family: "Database and data", concept: "Function", variation: "Index Fun", tone: "identity", source: "jb-download:index-fun", headerVerified: true, icon: UiFunction4.UiFunction4, darkIcon: UiFunction4.UiFunction4Dark },
-  { id: "programming-index-unique", componentName: "UiIndex5", label: "Index Unique", family: "Database and data", concept: "Index", variation: "Index Unique", tone: "identity", source: "jb-download:index-unique", headerVerified: true, icon: UiIndex5.UiIndex5, darkIcon: UiIndex5.UiIndex5Dark },
+  { id: "programming-index-unique", componentName: "UiIndex5", label: "Index Unique", family: "Database and data", concept: "Unique index", variation: "Index Unique", tone: "identity", source: "jb-download:index-unique", headerVerified: true, icon: UiIndex5.UiIndex5, darkIcon: UiIndex5.UiIndex5Dark },
   { id: "programming-inspections-grammar", componentName: "UiInspectionsGrammar", label: "Inspections Grammar", family: "Code symbols and members", concept: "Inspections Grammar", variation: "Inspections Grammar", tone: "identity", source: "jb-download:inspections-grammar", headerVerified: true, icon: UiInspectionsGrammar.UiInspectionsGrammar, darkIcon: UiInspectionsGrammar.UiInspectionsGrammarDark },
   { id: "programming-interceptor-class", componentName: "UiMethod4", label: "Interceptor Class", family: "Code symbols and members", concept: "Method", variation: "Interceptor Class", tone: "identity", source: "jb-download:interceptor-class", headerVerified: true, icon: UiMethod4.UiMethod4, darkIcon: UiMethod4.UiMethod4Dark },
   { id: "programming-interceptor-method", componentName: "UiMethod5", label: "Interceptor Method", family: "Code symbols and members", concept: "Method", variation: "Interceptor Method", tone: "identity", source: "jb-download:interceptor-method", headerVerified: true, icon: UiMethod5.UiMethod5, darkIcon: UiMethod5.UiMethod5Dark },
@@ -307,7 +307,7 @@ const programmingIconCatalog = [
   { id: "programming-method-reference", componentName: "UiMethod8", label: "Method Reference", family: "Code symbols and members", concept: "Method", variation: "Method Reference", tone: "identity", source: "jb-download:method-reference", headerVerified: true, icon: UiMethod8.UiMethod8, darkIcon: UiMethod8.UiMethod8Dark },
   { id: "programming-models", componentName: "UiModels", label: "Models", family: "Frameworks and platforms", concept: "Models", variation: "Models", tone: "identity", source: "jb-download:models", headerVerified: true, icon: UiModels.UiModels, darkIcon: UiModels.UiModelsDark },
   { id: "programming-module", componentName: "UiModule1", label: "Module", family: "Navigation and organization", concept: "Module", variation: "Module", tone: "identity", source: "jb-download:module", headerVerified: true, icon: UiModule1.UiModule1, darkIcon: UiModule1.UiModule1Dark },
-  { id: "programming-multi-launch", componentName: "UiRun1", label: "Multi Launch", family: "Execution and status", concept: "Run control", variation: "Multi Launch", tone: "identity", source: "jb-download:multi-launch", headerVerified: true, icon: UiRun1.UiRun1, darkIcon: UiRun1.UiRun1Dark },
+  { id: "programming-multi-launch", componentName: "UiRun1", label: "Multi Launch", family: "Execution and status", concept: "Run", variation: "Multi Launch", tone: "identity", source: "jb-download:multi-launch", headerVerified: true, icon: UiRun1.UiRun1, darkIcon: UiRun1.UiRun1Dark },
   { id: "programming-name", componentName: "UiName", label: "Name", family: "Code symbols and members", concept: "Name", variation: "Name", tone: "identity", source: "jb-download-unverified:name", headerVerified: false, icon: UiName.UiName, darkIcon: UiName.UiNameDark },
   { id: "programming-object-type-attribute", componentName: "UiField4", label: "Object Type Attribute", family: "Code symbols and members", concept: "Field and parameter", variation: "Object Type Attribute", tone: "identity", source: "jb-download:object-type-attribute", headerVerified: true, icon: UiField4.UiField4, darkIcon: UiField4.UiField4Dark },
   { id: "programming-open-block", componentName: "UiOpenBlock", label: "Open Block", family: "Navigation and organization", concept: "Open Block", variation: "Open Block", tone: "identity", source: "jb-download:open-block", headerVerified: true, icon: UiOpenBlock.UiOpenBlock, darkIcon: UiOpenBlock.UiOpenBlockDark },
@@ -323,7 +323,7 @@ const programmingIconCatalog = [
   { id: "programming-pointcut", componentName: "UiPointcut", label: "Pointcut", family: "Frameworks and platforms", concept: "Pointcut", variation: "Pointcut", tone: "identity", source: "jb-download:pointcut", headerVerified: true, icon: UiPointcut.UiPointcut, darkIcon: UiPointcut.UiPointcutDark },
   { id: "programming-preview-changes", componentName: "UiTable5", label: "Preview Changes", family: "Database and data", concept: "Table and view", variation: "Preview Changes", tone: "identity", source: "jb-download:preview-changes", headerVerified: true, icon: UiTable5.UiTable5, darkIcon: UiTable5.UiTable5Dark },
   { id: "programming-procedure", componentName: "UiProcedure", label: "Procedure", family: "Database and data", concept: "Procedure", variation: "Procedure", tone: "identity", source: "jb-download:procedure", headerVerified: true, icon: UiProcedure.UiProcedure, darkIcon: UiProcedure.UiProcedureDark },
-  { id: "programming-procedure-run", componentName: "UiRun2", label: "Procedure Run", family: "Execution and status", concept: "Run control", variation: "Procedure Run", tone: "action", source: "jb-download:procedure-run", headerVerified: true, icon: UiRun2.UiRun2, darkIcon: UiRun2.UiRun2Dark },
+  { id: "programming-procedure-run", componentName: "UiRun2", label: "Procedure Run", family: "Execution and status", concept: "Run", variation: "Procedure Run", tone: "action", source: "jb-download:procedure-run", headerVerified: true, icon: UiRun2.UiRun2, darkIcon: UiRun2.UiRun2Dark },
   { id: "programming-profile", componentName: "UiProfile", label: "Profile", family: "Debugging and profiling", concept: "Profile and trace", variation: "Profile", tone: "identity", source: "jb-download:profile", headerVerified: true, icon: UiProfile.UiProfile, darkIcon: UiProfile.UiProfileDark },
   { id: "programming-profile-cpu", componentName: "UiProfile2", label: "Profile CPU", family: "Debugging and profiling", concept: "Profile and trace", variation: "Profile CPU", tone: "identity", source: "jb-download:profile-cpu", headerVerified: true, icon: UiProfile2.UiProfile2, darkIcon: UiProfile2.UiProfile2Dark },
   { id: "programming-profile-memory", componentName: "UiProfile3", label: "Profile Memory", family: "Debugging and profiling", concept: "Profile and trace", variation: "Profile Memory", tone: "identity", source: "jb-download:profile-memory", headerVerified: true, icon: UiProfile3.UiProfile3, darkIcon: UiProfile3.UiProfile3Dark },
@@ -340,22 +340,22 @@ const programmingIconCatalog = [
   { id: "programming-rename-index", componentName: "UiIndex6", label: "Rename Index", family: "Database and data", concept: "Index", variation: "Rename Index", tone: "action", source: "jb-download:rename-index", headerVerified: true, icon: UiIndex6.UiIndex6, darkIcon: UiIndex6.UiIndex6Dark },
   { id: "programming-rename-sequence", componentName: "UiSequence2", label: "Rename Sequence", family: "Database and data", concept: "Sequence", variation: "Rename Sequence", tone: "action", source: "jb-download:rename-sequence", headerVerified: true, icon: UiSequence2.UiSequence2, darkIcon: UiSequence2.UiSequence2Dark },
   { id: "programming-rename-table", componentName: "UiTable7", label: "Rename Table", family: "Database and data", concept: "Table and view", variation: "Rename Table", tone: "action", source: "jb-download:rename-table", headerVerified: true, icon: UiTable7.UiTable7, darkIcon: UiTable7.UiTable7Dark },
-  { id: "programming-rerun-alt-1", componentName: "UiRun3", label: "Rerun", family: "Execution and status", concept: "Run control", variation: "Alternative 1", tone: "action", source: "jb-download:rerun-alt-1", headerVerified: true, icon: UiRun3.UiRun3, darkIcon: UiRun3.UiRun3Dark },
-  { id: "programming-rerun", componentName: "UiRun4", label: "Rerun", family: "Execution and status", concept: "Run control", variation: "Rerun", tone: "action", source: "jb-download:rerun", headerVerified: true, icon: UiRun4.UiRun4, darkIcon: UiRun4.UiRun4Dark },
-  { id: "programming-rerun-automatically", componentName: "UiRun5", label: "Rerun Automatically", family: "Execution and status", concept: "Run control", variation: "Rerun Automatically", tone: "action", source: "jb-download:rerun-automatically", headerVerified: true, icon: UiRun5.UiRun5, darkIcon: UiRun5.UiRun5Dark },
-  { id: "programming-restart-debug", componentName: "UiRun6", label: "Restart Debug", family: "Debugging and profiling", concept: "Run control", variation: "Restart Debug", tone: "action", source: "jb-download:restart-debug", headerVerified: true, icon: UiRun6.UiRun6, darkIcon: UiRun6.UiRun6Dark },
-  { id: "programming-restart-stop", componentName: "UiRun7", label: "Restart Stop", family: "Execution and status", concept: "Run control", variation: "Restart Stop", tone: "action", source: "jb-download:restart-stop", headerVerified: true, icon: UiRun7.UiRun7, darkIcon: UiRun7.UiRun7Dark },
+  { id: "programming-rerun-alt-1", componentName: "UiRun3", label: "Rerun", family: "Execution and status", concept: "Rerun", variation: "Alternate rerun", tone: "action", source: "jb-download:rerun-alt-1", headerVerified: true, icon: UiRun3.UiRun3, darkIcon: UiRun3.UiRun3Dark },
+  { id: "programming-rerun", componentName: "UiRun4", label: "Rerun", family: "Execution and status", concept: "Rerun", variation: "Rerun", tone: "action", source: "jb-download:rerun", headerVerified: true, icon: UiRun4.UiRun4, darkIcon: UiRun4.UiRun4Dark },
+  { id: "programming-rerun-automatically", componentName: "UiRun5", label: "Rerun Automatically", family: "Execution and status", concept: "Rerun", variation: "Rerun Automatically", tone: "action", source: "jb-download:rerun-automatically", headerVerified: true, icon: UiRun5.UiRun5, darkIcon: UiRun5.UiRun5Dark },
+  { id: "programming-restart-debug", componentName: "UiRun6", label: "Restart Debug", family: "Execution and status", concept: "Restart", variation: "Restart Debug", tone: "action", source: "jb-download:restart-debug", headerVerified: true, icon: UiRun6.UiRun6, darkIcon: UiRun6.UiRun6Dark },
+  { id: "programming-restart-stop", componentName: "UiRun7", label: "Restart Stop", family: "Execution and status", concept: "Restart", variation: "Restart Stop", tone: "action", source: "jb-download:restart-stop", headerVerified: true, icon: UiRun7.UiRun7, darkIcon: UiRun7.UiRun7Dark },
   { id: "programming-return-value", componentName: "UiVariable3", label: "Return Value", family: "Code symbols and members", concept: "Variable", variation: "Return Value", tone: "identity", source: "jb-download-unverified:return-value", headerVerified: false, icon: UiVariable3.UiVariable3, darkIcon: UiVariable3.UiVariable3Dark },
   { id: "programming-role", componentName: "UiRole", label: "Role", family: "Database and data", concept: "Role", variation: "Role", tone: "identity", source: "jb-download:role", headerVerified: true, icon: UiRole.UiRole, darkIcon: UiRole.UiRoleDark },
   { id: "programming-rollback", componentName: "UiRollback", label: "Rollback", family: "Database and data", concept: "Rollback", variation: "Rollback", tone: "identity", source: "jb-download:rollback", headerVerified: true, icon: UiRollback.UiRollback, darkIcon: UiRollback.UiRollbackDark },
   { id: "programming-routine", componentName: "UiRoutine", label: "Routine", family: "Database and data", concept: "Routine", variation: "Routine", tone: "identity", source: "jb-download:routine", headerVerified: true, icon: UiRoutine.UiRoutine, darkIcon: UiRoutine.UiRoutineDark },
-  { id: "programming-run", componentName: "UiRun", label: "Run", family: "Execution and status", concept: "Run control", variation: "Run", tone: "action", source: "jb-download:run", headerVerified: true, icon: UiRun.UiRun, darkIcon: UiRun.UiRunDark },
-  { id: "programming-run-all", componentName: "UiRun8", label: "Run All", family: "Execution and status", concept: "Run control", variation: "Run All", tone: "action", source: "jb-download:run-all", headerVerified: true, icon: UiRun8.UiRun8, darkIcon: UiRun8.UiRun8Dark },
-  { id: "programming-run-cursor", componentName: "UiStep4", label: "Run Cursor", family: "Execution and status", concept: "Debugger step", variation: "Run Cursor", tone: "action", source: "jb-download-unverified:run-cursor", headerVerified: false, icon: UiStep4.UiStep4, darkIcon: UiStep4.UiStep4Dark },
-  { id: "programming-run-database-script", componentName: "UiRun9", label: "Run Database Script", family: "Execution and status", concept: "Run control", variation: "Run Database Script", tone: "action", source: "jb-download:run-database-script", headerVerified: true, icon: UiRun9.UiRun9, darkIcon: UiRun9.UiRun9Dark },
-  { id: "programming-run-error", componentName: "UiRun10", label: "Run Error", family: "Execution and status", concept: "Run control", variation: "Run Error", tone: "danger", source: "jb-download:run-error", headerVerified: true, icon: UiRun10.UiRun10, darkIcon: UiRun10.UiRun10Dark },
-  { id: "programming-run-in-queue", componentName: "UiRun11", label: "Run In Queue", family: "Execution and status", concept: "Run control", variation: "Run In Queue", tone: "action", source: "jb-download-unverified:run-in-queue", headerVerified: false, icon: UiRun11.UiRun11, darkIcon: UiRun11.UiRun11Dark },
-  { id: "programming-run-success", componentName: "UiRun12", label: "Run Success", family: "Execution and status", concept: "Run control", variation: "Run Success", tone: "success", source: "jb-download:run-success", headerVerified: true, icon: UiRun12.UiRun12, darkIcon: UiRun12.UiRun12Dark },
+  { id: "programming-run", componentName: "UiRun", label: "Run", family: "Execution and status", concept: "Run", variation: "Run", tone: "action", source: "jb-download:run", headerVerified: true, icon: UiRun.UiRun, darkIcon: UiRun.UiRunDark },
+  { id: "programming-run-all", componentName: "UiRun8", label: "Run All", family: "Execution and status", concept: "Run", variation: "Run All", tone: "action", source: "jb-download:run-all", headerVerified: true, icon: UiRun8.UiRun8, darkIcon: UiRun8.UiRun8Dark },
+  { id: "programming-run-cursor", componentName: "UiStep4", label: "Run Cursor", family: "Debugging and profiling", concept: "Run to cursor", variation: "Run Cursor", tone: "action", source: "jb-download-unverified:run-cursor", headerVerified: false, icon: UiStep4.UiStep4, darkIcon: UiStep4.UiStep4Dark },
+  { id: "programming-run-database-script", componentName: "UiRun9", label: "Run Database Script", family: "Execution and status", concept: "Run", variation: "Run Database Script", tone: "action", source: "jb-download:run-database-script", headerVerified: true, icon: UiRun9.UiRun9, darkIcon: UiRun9.UiRun9Dark },
+  { id: "programming-run-error", componentName: "UiRun10", label: "Run Error", family: "Execution and status", concept: "Run outcome", variation: "Run Error", tone: "danger", source: "jb-download:run-error", headerVerified: true, icon: UiRun10.UiRun10, darkIcon: UiRun10.UiRun10Dark },
+  { id: "programming-run-in-queue", componentName: "UiRun11", label: "Run In Queue", family: "Execution and status", concept: "Run", variation: "Run In Queue", tone: "action", source: "jb-download-unverified:run-in-queue", headerVerified: false, icon: UiRun11.UiRun11, darkIcon: UiRun11.UiRun11Dark },
+  { id: "programming-run-success", componentName: "UiRun12", label: "Run Success", family: "Execution and status", concept: "Run outcome", variation: "Run Success", tone: "success", source: "jb-download:run-success", headerVerified: true, icon: UiRun12.UiRun12, darkIcon: UiRun12.UiRun12Dark },
   { id: "programming-security-role", componentName: "UiSecurityRole", label: "Security Role", family: "Database and data", concept: "Security Role", variation: "Security Role", tone: "identity", source: "jb-download:security-role", headerVerified: true, icon: UiSecurityRole.UiSecurityRole, darkIcon: UiSecurityRole.UiSecurityRoleDark },
   { id: "programming-sequence-alt-1", componentName: "UiSequence3", label: "Sequence", family: "Database and data", concept: "Sequence", variation: "Alternative 1", tone: "identity", source: "jb-download:sequence-alt-1", headerVerified: true, icon: UiSequence3.UiSequence3, darkIcon: UiSequence3.UiSequence3Dark },
   { id: "programming-sequence-alt-2", componentName: "UiSequence4", label: "Sequence", family: "Database and data", concept: "Sequence", variation: "Alternative 2", tone: "identity", source: "jb-download:sequence-alt-2", headerVerified: true, icon: UiSequence4.UiSequence4, darkIcon: UiSequence4.UiSequence4Dark },
@@ -365,21 +365,21 @@ const programmingIconCatalog = [
   { id: "programming-show-current-frame", componentName: "UiShowCurrentFrame", label: "Show Current Frame", family: "Debugging and profiling", concept: "Show Current Frame", variation: "Show Current Frame", tone: "identity", source: "jb-download:show-current-frame", headerVerified: true, icon: UiShowCurrentFrame.UiShowCurrentFrame, darkIcon: UiShowCurrentFrame.UiShowCurrentFrameDark },
   { id: "programming-show-members", componentName: "UiShowMembers", label: "Show Members", family: "Navigation and organization", concept: "Show Members", variation: "Show Members", tone: "identity", source: "jb-download:show-members", headerVerified: true, icon: UiShowMembers.UiShowMembers, darkIcon: UiShowMembers.UiShowMembersDark },
   { id: "programming-show-to-implement", componentName: "UiShowToImplement", label: "Show To Implement", family: "Navigation and organization", concept: "Show To Implement", variation: "Show To Implement", tone: "identity", source: "jb-download-unverified:show-to-implement", headerVerified: false, icon: UiShowToImplement.UiShowToImplement, darkIcon: UiShowToImplement.UiShowToImplementDark },
-  { id: "programming-smart-step-into", componentName: "UiStep5", label: "Smart Step Into", family: "Debugging and profiling", concept: "Debugger step", variation: "Smart Step Into", tone: "action", source: "jb-download:smart-step-into", headerVerified: true, icon: UiStep5.UiStep5, darkIcon: UiStep5.UiStep5Dark },
-  { id: "programming-sort-alphabetically", componentName: "UiSortAlphabetically", label: "Sort Alphabetically", family: "Navigation and organization", concept: "Sort Alphabetically", variation: "Sort Alphabetically", tone: "identity", source: "jb-download:sort-alphabetically", headerVerified: true, icon: UiSortAlphabetically.UiSortAlphabetically, darkIcon: UiSortAlphabetically.UiSortAlphabeticallyDark },
-  { id: "programming-sort-by-type", componentName: "UiSortByType", label: "Sort By Type", family: "Navigation and organization", concept: "Sort By Type", variation: "Sort By Type", tone: "identity", source: "jb-download:sort-by-type", headerVerified: true, icon: UiSortByType.UiSortByType, darkIcon: UiSortByType.UiSortByTypeDark },
-  { id: "programming-sort-by-usage", componentName: "UiSortByUsage", label: "Sort By Usage", family: "Navigation and organization", concept: "Sort By Usage", variation: "Sort By Usage", tone: "identity", source: "jb-download:sort-by-usage", headerVerified: true, icon: UiSortByUsage.UiSortByUsage, darkIcon: UiSortByUsage.UiSortByUsageDark },
-  { id: "programming-sort-by-visibility", componentName: "UiSortByVisibility", label: "Sort By Visibility", family: "Navigation and organization", concept: "Sort By Visibility", variation: "Sort By Visibility", tone: "identity", source: "jb-download:sort-by-visibility", headerVerified: true, icon: UiSortByVisibility.UiSortByVisibility, darkIcon: UiSortByVisibility.UiSortByVisibilityDark },
+  { id: "programming-smart-step-into", componentName: "UiStep5", label: "Smart Step Into", family: "Debugging and profiling", concept: "Step into", variation: "Smart Step Into", tone: "action", source: "jb-download:smart-step-into", headerVerified: true, icon: UiStep5.UiStep5, darkIcon: UiStep5.UiStep5Dark },
+  { id: "programming-sort-alphabetically", componentName: "UiSortAlphabetically", label: "Sort Alphabetically", family: "Navigation and organization", concept: "Sorting", variation: "Sort Alphabetically", tone: "identity", source: "jb-download:sort-alphabetically", headerVerified: true, icon: UiSortAlphabetically.UiSortAlphabetically, darkIcon: UiSortAlphabetically.UiSortAlphabeticallyDark },
+  { id: "programming-sort-by-type", componentName: "UiSortByType", label: "Sort By Type", family: "Navigation and organization", concept: "Sorting", variation: "Sort By Type", tone: "identity", source: "jb-download:sort-by-type", headerVerified: true, icon: UiSortByType.UiSortByType, darkIcon: UiSortByType.UiSortByTypeDark },
+  { id: "programming-sort-by-usage", componentName: "UiSortByUsage", label: "Sort By Usage", family: "Navigation and organization", concept: "Sorting", variation: "Sort By Usage", tone: "identity", source: "jb-download:sort-by-usage", headerVerified: true, icon: UiSortByUsage.UiSortByUsage, darkIcon: UiSortByUsage.UiSortByUsageDark },
+  { id: "programming-sort-by-visibility", componentName: "UiSortByVisibility", label: "Sort By Visibility", family: "Navigation and organization", concept: "Sorting", variation: "Sort By Visibility", tone: "identity", source: "jb-download:sort-by-visibility", headerVerified: true, icon: UiSortByVisibility.UiSortByVisibility, darkIcon: UiSortByVisibility.UiSortByVisibilityDark },
   { id: "programming-spring-boot", componentName: "UiSpringBoot", label: "Spring Boot", family: "Frameworks and platforms", concept: "Spring Boot", variation: "Spring Boot", tone: "identity", source: "jb-download:spring-boot", headerVerified: true, icon: UiSpringBoot.UiSpringBoot, darkIcon: UiSpringBoot.UiSpringBootDark },
   { id: "programming-start-timer", componentName: "UiStartTimer", label: "Start Timer", family: "Execution and status", concept: "Start Timer", variation: "Start Timer", tone: "action", source: "jb-download:start-timer", headerVerified: true, icon: UiStartTimer.UiStartTimer, darkIcon: UiStartTimer.UiStartTimerDark },
   { id: "programming-static", componentName: "UiStatic", label: "Static", family: "Code symbols and members", concept: "Static", variation: "Static", tone: "identity", source: "jb-download:static", headerVerified: true, icon: UiStatic.UiStatic, darkIcon: UiStatic.UiStaticDark },
-  { id: "programming-step-into", componentName: "UiStep", label: "Step Into", family: "Debugging and profiling", concept: "Debugger step", variation: "Step Into", tone: "action", source: "jb-download:step-into", headerVerified: true, icon: UiStep.UiStep, darkIcon: UiStep.UiStepDark },
-  { id: "programming-step-into-my-code", componentName: "UiStep6", label: "Step Into My Code", family: "Debugging and profiling", concept: "Debugger step", variation: "Step Into My Code", tone: "action", source: "jb-download:step-into-my-code", headerVerified: true, icon: UiStep6.UiStep6, darkIcon: UiStep6.UiStep6Dark },
-  { id: "programming-step-out", componentName: "UiStep7", label: "Step Out", family: "Debugging and profiling", concept: "Debugger step", variation: "Step Out", tone: "action", source: "jb-download:step-out", headerVerified: true, icon: UiStep7.UiStep7, darkIcon: UiStep7.UiStep7Dark },
-  { id: "programming-step-out-code-block", componentName: "UiStep8", label: "Step Out Code Block", family: "Debugging and profiling", concept: "Debugger step", variation: "Step Out Code Block", tone: "action", source: "jb-download:step-out-code-block", headerVerified: true, icon: UiStep8.UiStep8, darkIcon: UiStep8.UiStep8Dark },
-  { id: "programming-step-over", componentName: "UiStep9", label: "Step Over", family: "Debugging and profiling", concept: "Debugger step", variation: "Step Over", tone: "action", source: "jb-download:step-over", headerVerified: true, icon: UiStep9.UiStep9, darkIcon: UiStep9.UiStep9Dark },
-  { id: "programming-stop", componentName: "UiRun13", label: "Stop", family: "Execution and status", concept: "Run control", variation: "Stop", tone: "danger", source: "jb-download:stop", headerVerified: true, icon: UiRun13.UiRun13, darkIcon: UiRun13.UiRun13Dark },
-  { id: "programming-stop-timer", componentName: "UiRun14", label: "Stop Timer", family: "Execution and status", concept: "Run control", variation: "Stop Timer", tone: "danger", source: "jb-download:stop-timer", headerVerified: true, icon: UiRun14.UiRun14, darkIcon: UiRun14.UiRun14Dark },
+  { id: "programming-step-into", componentName: "UiStep", label: "Step Into", family: "Debugging and profiling", concept: "Step into", variation: "Step Into", tone: "action", source: "jb-download:step-into", headerVerified: true, icon: UiStep.UiStep, darkIcon: UiStep.UiStepDark },
+  { id: "programming-step-into-my-code", componentName: "UiStep6", label: "Step Into My Code", family: "Debugging and profiling", concept: "Step into", variation: "Step Into My Code", tone: "action", source: "jb-download:step-into-my-code", headerVerified: true, icon: UiStep6.UiStep6, darkIcon: UiStep6.UiStep6Dark },
+  { id: "programming-step-out", componentName: "UiStep7", label: "Step Out", family: "Debugging and profiling", concept: "Step out", variation: "Step Out", tone: "action", source: "jb-download:step-out", headerVerified: true, icon: UiStep7.UiStep7, darkIcon: UiStep7.UiStep7Dark },
+  { id: "programming-step-out-code-block", componentName: "UiStep8", label: "Step Out Code Block", family: "Debugging and profiling", concept: "Step out", variation: "Step Out Code Block", tone: "action", source: "jb-download:step-out-code-block", headerVerified: true, icon: UiStep8.UiStep8, darkIcon: UiStep8.UiStep8Dark },
+  { id: "programming-step-over", componentName: "UiStep9", label: "Step Over", family: "Debugging and profiling", concept: "Step over", variation: "Step Over", tone: "action", source: "jb-download:step-over", headerVerified: true, icon: UiStep9.UiStep9, darkIcon: UiStep9.UiStep9Dark },
+  { id: "programming-stop", componentName: "UiRun13", label: "Stop", family: "Execution and status", concept: "Stop", variation: "Stop", tone: "danger", source: "jb-download:stop", headerVerified: true, icon: UiRun13.UiRun13, darkIcon: UiRun13.UiRun13Dark },
+  { id: "programming-stop-timer", componentName: "UiRun14", label: "Stop Timer", family: "Execution and status", concept: "Stop", variation: "Stop Timer", tone: "danger", source: "jb-download:stop-timer", headerVerified: true, icon: UiRun14.UiRun14, darkIcon: UiRun14.UiRun14Dark },
   { id: "programming-stream", componentName: "UiStream", label: "Stream", family: "Database and data", concept: "Stream", variation: "Stream", tone: "identity", source: "jb-download:stream", headerVerified: true, icon: UiStream.UiStream, darkIcon: UiStream.UiStreamDark },
   { id: "programming-stream-key", componentName: "UiStreamKey", label: "Stream Key", family: "Database and data", concept: "Stream Key", variation: "Stream Key", tone: "identity", source: "jb-download:stream-key", headerVerified: true, icon: UiStreamKey.UiStreamKey, darkIcon: UiStreamKey.UiStreamKeyDark },
   { id: "programming-submit-db", componentName: "UiSubmitDB", label: "Submit DB", family: "Database and data", concept: "Submit DB", variation: "Submit DB", tone: "action", source: "jb-download:submit-db", headerVerified: true, icon: UiSubmitDB.UiSubmitDB, darkIcon: UiSubmitDB.UiSubmitDBDark },