@flanksource/clicky-ui 0.3.35 → 0.3.37

package/dist/rpc/SessionHeaderControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHeaderControls.js","sources":["../../src/rpc/SessionHeaderControls.tsx"],"sourcesContent":["import { useState, type ReactNode } from \"react\";\nimport { Button } from \"../components/button\";\nimport { Icon } from \"../data/Icon\";\nimport { UiClockCountdown, UiRestart, UiStop } from \"../icons\";\nimport { Modal } from \"../overlay/Modal\";\nimport {\n  formatSessionDuration,\n  sessionControls,\n  type SessionControls,\n} from \"./sessionHeaderModel\";\nimport { sessionParamsDurationMs, type SessionInfo } from \"./sessionTypes\";\nimport type { SessionAction } from \"./useSession\";\n\nexport type SessionConfirmRenderArgs = {\n  action: SessionAction;\n  session: SessionInfo;\n  /** The duration an extend or restart will send; absent for stop. */\n  durationMs?: number;\n  confirm: () => void;\n  cancel: () => void;\n};\n\nexport type SessionHeaderControlsProps = {\n  session: SessionInfo;\n  onStop: () => void;\n  onExtend: (durationMs: number) => void;\n  onRestart: (options: { durationMs: number }) => void;\n  mutating: boolean;\n  renderConfirm: ((args: SessionConfirmRenderArgs) => ReactNode) | undefined;\n  durationPresetsMs: readonly number[];\n  pendingAction: SessionAction | null;\n};\n\ntype PendingRequest = { action: SessionAction; durationMs?: number };\n\nconst ACTION_LABELS: Record<SessionAction, string> = {\n  stop: \"Stop\",\n  extend: \"Extend\",\n  restart: \"Restart\",\n};\n\nfunction offersAction(controls: SessionControls, action: SessionAction): boolean {\n  if (action === \"restart\") return controls.restart.visible;\n  return controls[action].visible && !controls[action].disabled;\n}\n\nexport function SessionHeaderControls({\n  session,\n  onStop,\n  onExtend,\n  onRestart,\n  mutating,\n  renderConfirm,\n  durationPresetsMs,\n  pendingAction,\n}: SessionHeaderControlsProps) {\n  const controls = sessionControls(session);\n  const [prompt, setPrompt] = useState<\"extend\" | \"restart\" | null>(null);\n  const [confirming, setConfirming] = useState<PendingRequest | null>(null);\n\n  // A prompt or confirmation opened for an action the session no longer offers\n  // (it turned terminal, or started stopping) would send a request the server\n  // refuses, so it closes the render the session changes.\n  if (prompt && !offersAction(controls, prompt)) setPrompt(null);\n  if (confirming && !offersAction(controls, confirming.action)) setConfirming(null);\n\n  const perform = ({ action, durationMs }: PendingRequest) => {\n    setConfirming(null);\n    if (action === \"stop\") return onStop();\n    if (durationMs === undefined) throw new Error(`session ${action} was requested without a duration`);\n    if (action === \"extend\") return onExtend(durationMs);\n    return onRestart({ durationMs });\n  };\n  const request = (next: PendingRequest) => (mutating ? setConfirming(next) : perform(next));\n\n  const onRestartClick = () => {\n    const durationMs = sessionParamsDurationMs(session);\n    if (durationMs === undefined) setPrompt(\"restart\");\n    else request({ action: \"restart\", durationMs });\n  };\n\n  if (!controls.stop.visible && !controls.extend.visible && !controls.restart.visible) return null;\n\n  return (\n    <div className=\"flex flex-col items-end gap-2\" data-slot=\"session-header-controls\">\n      <div className=\"flex flex-wrap items-center gap-2\">\n        {controls.extend.visible && (\n          <Button\n            size=\"sm\"\n            variant=\"outline\"\n            disabled={controls.extend.disabled}\n            loading={pendingAction === \"extend\"}\n            onClick={() => setPrompt(\"extend\")}\n          >\n            <Icon icon={UiClockCountdown} className=\"size-4\" />\n            Extend\n          </Button>\n        )}\n        {controls.stop.visible && (\n          <Button\n            size=\"sm\"\n            variant=\"destructive\"\n            disabled={controls.stop.disabled}\n            loading={pendingAction === \"stop\"}\n            onClick={() => request({ action: \"stop\" })}\n          >\n            <Icon icon={UiStop} className=\"size-4\" />\n            Stop\n          </Button>\n        )}\n        {controls.restart.visible && (\n          <Button\n            size=\"sm\"\n            variant=\"outline\"\n            loading={pendingAction === \"restart\"}\n            onClick={onRestartClick}\n          >\n            <Icon icon={UiRestart} className=\"size-4\" />\n            Restart\n          </Button>\n        )}\n      </div>\n      {prompt && (\n        <div\n          role=\"group\"\n          aria-label={`${ACTION_LABELS[prompt]} duration`}\n          className=\"flex flex-wrap items-center gap-1 rounded-md border border-border bg-muted/40 p-1 text-xs\"\n        >\n          <span className=\"px-1 text-muted-foreground\">\n            {prompt === \"extend\" ? \"Extend by\" : \"Run for\"}\n          </span>\n          {durationPresetsMs.map((durationMs) => (\n            <Button\n              key={durationMs}\n              size=\"sm\"\n              variant=\"ghost\"\n              onClick={() => {\n                setPrompt(null);\n                request({ action: prompt, durationMs });\n              }}\n            >\n              {formatSessionDuration(durationMs)}\n            </Button>\n          ))}\n          <Button size=\"sm\" variant=\"ghost\" onClick={() => setPrompt(null)}>\n            Cancel\n          </Button>\n        </div>\n      )}\n      {confirming &&\n        (renderConfirm ? (\n          renderConfirm({\n            action: confirming.action,\n            session,\n            ...(confirming.durationMs !== undefined ? { durationMs: confirming.durationMs } : {}),\n            confirm: () => perform(confirming),\n            cancel: () => setConfirming(null),\n          })\n        ) : (\n          <DefaultSessionConfirm\n            request={confirming}\n            onConfirm={() => perform(confirming)}\n            onCancel={() => setConfirming(null)}\n          />\n        ))}\n    </div>\n  );\n}\n\nfunction DefaultSessionConfirm({\n  request,\n  onConfirm,\n  onCancel,\n}: {\n  request: PendingRequest;\n  onConfirm: () => void;\n  onCancel: () => void;\n}) {\n  const label = ACTION_LABELS[request.action];\n  return (\n    <Modal\n      open\n      onClose={onCancel}\n      size=\"sm\"\n      title={`${label} this session?`}\n      footer={\n        <div className=\"flex justify-end gap-2\">\n          <Button size=\"sm\" variant=\"ghost\" onClick={onCancel}>\n            Cancel\n          </Button>\n          <Button size=\"sm\" variant=\"destructive\" onClick={onConfirm}>\n            {label}\n          </Button>\n        </div>\n      }\n    >\n      <p className=\"text-sm\">\n        This session changes the target's behaviour.\n        {request.durationMs !== undefined &&\n          (request.action === \"extend\"\n            ? ` Its deadline moves ${formatSessionDuration(request.durationMs)} later.`\n            : ` It will run for ${formatSessionDuration(request.durationMs)}.`)}\n      </p>\n    </Modal>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/SessionsCatalog.cjs

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const OperationCatalog = require("./OperationCatalog.cjs");
+const InlineError = require("./InlineError.cjs");
+const clickyMetadata = require("./clickyMetadata.cjs");
+const useOperations = require("./useOperations.cjs");
+const SESSIONS_SURFACE_KEY = "sessions";
+function undeclaredFilterKeys(listOperation, values) {
+  const declared = new Set((listOperation.operation.parameters ?? []).map((parameter) => parameter.name));
+  return Object.entries(values).flatMap(
+    ([prop, record]) => Object.keys(record ?? {}).filter((key) => !declared.has(key)).map((key) => `${prop} key "${key}"`)
+  );
+}
+function SessionsCatalog({
+  client,
+  renderLink,
+  surfaceKey = SESSIONS_SURFACE_KEY,
+  lockedValues,
+  initialValues,
+  getRowDetailHref,
+  urlState,
+  hiddenColumns,
+  title = "Sessions"
+}) {
+  const { operations } = useOperations.useOperations(client);
+  const listOperation = react.useMemo(
+    () => clickyMetadata.findSurfaceListOperation(operations, surfaceKey),
+    [operations, surfaceKey]
+  );
+  const undeclared = listOperation ? undeclaredFilterKeys(listOperation, { lockedValues, initialValues }) : [];
+  if (listOperation && undeclared.length > 0) {
+    const declared = (listOperation.operation.parameters ?? []).map((parameter) => parameter.name);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      InlineError.InlineError,
+      {
+        title: `${title}: filters the list operation does not declare`,
+        error: new Error(
+          `${undeclared.join(", ")} is not a parameter of ${listOperation.method.toUpperCase()} ${listOperation.path} (declared: ${declared.join(", ") || "none"})`
+        )
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    OperationCatalog.OperationCatalog,
+    {
+      definition: { key: surfaceKey, title, description: "Recorded query sessions" },
+      entities: [],
+      surfaceKey,
+      client,
+      renderLink,
+      selectionNoun: "sessions",
+      ...lockedValues ? { lockedValues } : {},
+      ...initialValues ? { initialValues } : {},
+      ...getRowDetailHref ? { getRowDetailHref } : {},
+      ...urlState !== void 0 ? { urlState } : {},
+      ...hiddenColumns ? { hiddenColumns } : {}
+    }
+  );
+}
+exports.SESSIONS_SURFACE_KEY = SESSIONS_SURFACE_KEY;
+exports.SessionsCatalog = SessionsCatalog;
+//# sourceMappingURL=SessionsCatalog.cjs.map

package/dist/rpc/SessionsCatalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionsCatalog.cjs","sources":["../../src/rpc/SessionsCatalog.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport { OperationCatalog, type OperationCatalogProps } from \"./OperationCatalog\";\nimport type { RenderLink } from \"./EndpointList\";\nimport { InlineError } from \"./InlineError\";\nimport { findSurfaceListOperation } from \"./clickyMetadata\";\nimport type { ResolvedOperation } from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\n\n/**\n * The x-clicky surface key commons-db's sessions list operation\n * (`GET /api/v1/sessions`, operationId `list-sessions`) is published under.\n * A host that mounts the sessions API under a different surface passes its\n * own key through `surfaceKey`.\n */\nexport const SESSIONS_SURFACE_KEY = \"sessions\";\n\nexport type SessionsCatalogProps = {\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  /** Surface the list operation is tagged with. Defaults to SESSIONS_SURFACE_KEY. */\n  surfaceKey?: string;\n  /**\n   * Filters the host pins, e.g. `{ profile: \"trace-capture/jvm_trace\",\n   * \"label.target\": \"cycle\" }` for one target's JVM traces. Sent on every list,\n   * lookup and export request; never editable, never in the URL. Every key must\n   * be a parameter the list operation declares: once the spec has loaded, an\n   * undeclared key renders an error in place of the table.\n   */\n  lockedValues?: Record<string, string>;\n  /**\n   * Editable starting filters, applied only where the URL is silent. Keys are\n   * checked against the list operation's parameters like `lockedValues`.\n   */\n  initialValues?: Record<string, string>;\n  /** Route of a session's page, given the row's id. */\n  getRowDetailHref?: (id: string) => string | undefined;\n  urlState?: OperationCatalogProps[\"urlState\"];\n  hiddenColumns?: string[];\n  /** Heading used in loading and export labels. Defaults to \"Sessions\". */\n  title?: string;\n};\n\n// OperationCatalog packs only the values a parameter list names, so an\n// undeclared pinned filter would vanish from the request and the table would\n// list every session while the host believed it was scoped.\nfunction undeclaredFilterKeys(\n  listOperation: ResolvedOperation,\n  values: { lockedValues: Record<string, string> | undefined; initialValues: Record<string, string> | undefined },\n): string[] {\n  const declared = new Set((listOperation.operation.parameters ?? []).map((parameter) => parameter.name));\n  return Object.entries(values).flatMap(([prop, record]) =>\n    Object.keys(record ?? {})\n      .filter((key) => !declared.has(key))\n      .map((key) => `${prop} key \"${key}\"`),\n  );\n}\n\nexport function SessionsCatalog({\n  client,\n  renderLink,\n  surfaceKey = SESSIONS_SURFACE_KEY,\n  lockedValues,\n  initialValues,\n  getRowDetailHref,\n  urlState,\n  hiddenColumns,\n  title = \"Sessions\",\n}: SessionsCatalogProps) {\n  const { operations } = useOperations(client);\n  const listOperation = useMemo(\n    () => findSurfaceListOperation(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const undeclared = listOperation ? undeclaredFilterKeys(listOperation, { lockedValues, initialValues }) : [];\n  if (listOperation && undeclared.length > 0) {\n    const declared = (listOperation.operation.parameters ?? []).map((parameter) => parameter.name);\n    return (\n      <InlineError\n        title={`${title}: filters the list operation does not declare`}\n        error={\n          new Error(\n            `${undeclared.join(\", \")} is not a parameter of ${listOperation.method.toUpperCase()} ${listOperation.path} (declared: ${declared.join(\", \") || \"none\"})`,\n          )\n        }\n      />\n    );\n  }\n\n  return (\n    <OperationCatalog\n      definition={{ key: surfaceKey, title, description: \"Recorded query sessions\" }}\n      entities={[]}\n      surfaceKey={surfaceKey}\n      client={client}\n      renderLink={renderLink}\n      selectionNoun=\"sessions\"\n      {...(lockedValues ? { lockedValues } : {})}\n      {...(initialValues ? { initialValues } : {})}\n      {...(getRowDetailHref ? { getRowDetailHref } : {})}\n      {...(urlState !== undefined ? { urlState } : {})}\n      {...(hiddenColumns ? { hiddenColumns } : {})}\n    />\n  );\n}\n"],"names":["useOperations","useMemo","findSurfaceListOperation","jsx","InlineError","OperationCatalog"],"mappings":";;;;;;;;AAcO,MAAM,uBAAuB;AA+BpC,SAAS,qBACP,eACA,QACU;AACV,QAAM,WAAW,IAAI,KAAK,cAAc,UAAU,cAAc,CAAA,GAAI,IAAI,CAAC,cAAc,UAAU,IAAI,CAAC;AACtG,SAAO,OAAO,QAAQ,MAAM,EAAE;AAAA,IAAQ,CAAC,CAAC,MAAM,MAAM,MAClD,OAAO,KAAK,UAAU,EAAE,EACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,CAAC,EAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,SAAS,GAAG,GAAG;AAAA,EAAA;AAE1C;AAEO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAyB;AACvB,QAAM,EAAE,WAAA,IAAeA,cAAAA,cAAc,MAAM;AAC3C,QAAM,gBAAgBC,MAAAA;AAAAA,IACpB,MAAMC,eAAAA,yBAAyB,YAAY,UAAU;AAAA,IACrD,CAAC,YAAY,UAAU;AAAA,EAAA;AAEzB,QAAM,aAAa,gBAAgB,qBAAqB,eAAe,EAAE,cAAc,cAAA,CAAe,IAAI,CAAA;AAC1G,MAAI,iBAAiB,WAAW,SAAS,GAAG;AAC1C,UAAM,YAAY,cAAc,UAAU,cAAc,IAAI,IAAI,CAAC,cAAc,UAAU,IAAI;AAC7F,WACEC,2BAAAA;AAAAA,MAACC,YAAAA;AAAAA,MAAA;AAAA,QACC,OAAO,GAAG,KAAK;AAAA,QACf,OACE,IAAI;AAAA,UACF,GAAG,WAAW,KAAK,IAAI,CAAC,0BAA0B,cAAc,OAAO,YAAA,CAAa,IAAI,cAAc,IAAI,eAAe,SAAS,KAAK,IAAI,KAAK,MAAM;AAAA,QAAA;AAAA,MACxJ;AAAA,IAAA;AAAA,EAIR;AAEA,SACED,2BAAAA;AAAAA,IAACE,iBAAAA;AAAAA,IAAA;AAAA,MACC,YAAY,EAAE,KAAK,YAAY,OAAO,aAAa,0BAAA;AAAA,MACnD,UAAU,CAAA;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA,eAAc;AAAA,MACb,GAAI,eAAe,EAAE,aAAA,IAAiB,CAAA;AAAA,MACtC,GAAI,gBAAgB,EAAE,cAAA,IAAkB,CAAA;AAAA,MACxC,GAAI,mBAAmB,EAAE,iBAAA,IAAqB,CAAA;AAAA,MAC9C,GAAI,aAAa,SAAY,EAAE,SAAA,IAAa,CAAA;AAAA,MAC5C,GAAI,gBAAgB,EAAE,kBAAkB,CAAA;AAAA,IAAC;AAAA,EAAA;AAGhD;;;"}

package/dist/rpc/SessionsCatalog.d.ts

@@ -0,0 +1,37 @@
+import { OperationCatalogProps } from './OperationCatalog';
+import { RenderLink } from './EndpointList';
+import { OperationsApiClient } from './useOperations';
+/**
+ * The x-clicky surface key commons-db's sessions list operation
+ * (`GET /api/v1/sessions`, operationId `list-sessions`) is published under.
+ * A host that mounts the sessions API under a different surface passes its
+ * own key through `surfaceKey`.
+ */
+export declare const SESSIONS_SURFACE_KEY = "sessions";
+export type SessionsCatalogProps = {
+    client: OperationsApiClient;
+    renderLink: RenderLink;
+    /** Surface the list operation is tagged with. Defaults to SESSIONS_SURFACE_KEY. */
+    surfaceKey?: string;
+    /**
+     * Filters the host pins, e.g. `{ profile: "trace-capture/jvm_trace",
+     * "label.target": "cycle" }` for one target's JVM traces. Sent on every list,
+     * lookup and export request; never editable, never in the URL. Every key must
+     * be a parameter the list operation declares: once the spec has loaded, an
+     * undeclared key renders an error in place of the table.
+     */
+    lockedValues?: Record<string, string>;
+    /**
+     * Editable starting filters, applied only where the URL is silent. Keys are
+     * checked against the list operation's parameters like `lockedValues`.
+     */
+    initialValues?: Record<string, string>;
+    /** Route of a session's page, given the row's id. */
+    getRowDetailHref?: (id: string) => string | undefined;
+    urlState?: OperationCatalogProps["urlState"];
+    hiddenColumns?: string[];
+    /** Heading used in loading and export labels. Defaults to "Sessions". */
+    title?: string;
+};
+export declare function SessionsCatalog({ client, renderLink, surfaceKey, lockedValues, initialValues, getRowDetailHref, urlState, hiddenColumns, title, }: SessionsCatalogProps): import("react").JSX.Element;
+//# sourceMappingURL=SessionsCatalog.d.ts.map

package/dist/rpc/SessionsCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionsCatalog.d.ts","sourceRoot":"","sources":["../../src/rpc/SessionsCatalog.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAiBF,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,UAAU,EACV,UAAiC,EACjC,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,KAAkB,GACnB,EAAE,oBAAoB,+BAoCtB"}

package/dist/rpc/SessionsCatalog.js

@@ -0,0 +1,64 @@
+import { jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { OperationCatalog } from "./OperationCatalog.js";
+import { InlineError } from "./InlineError.js";
+import { findSurfaceListOperation } from "./clickyMetadata.js";
+import { useOperations } from "./useOperations.js";
+const SESSIONS_SURFACE_KEY = "sessions";
+function undeclaredFilterKeys(listOperation, values) {
+  const declared = new Set((listOperation.operation.parameters ?? []).map((parameter) => parameter.name));
+  return Object.entries(values).flatMap(
+    ([prop, record]) => Object.keys(record ?? {}).filter((key) => !declared.has(key)).map((key) => `${prop} key "${key}"`)
+  );
+}
+function SessionsCatalog({
+  client,
+  renderLink,
+  surfaceKey = SESSIONS_SURFACE_KEY,
+  lockedValues,
+  initialValues,
+  getRowDetailHref,
+  urlState,
+  hiddenColumns,
+  title = "Sessions"
+}) {
+  const { operations } = useOperations(client);
+  const listOperation = useMemo(
+    () => findSurfaceListOperation(operations, surfaceKey),
+    [operations, surfaceKey]
+  );
+  const undeclared = listOperation ? undeclaredFilterKeys(listOperation, { lockedValues, initialValues }) : [];
+  if (listOperation && undeclared.length > 0) {
+    const declared = (listOperation.operation.parameters ?? []).map((parameter) => parameter.name);
+    return /* @__PURE__ */ jsx(
+      InlineError,
+      {
+        title: `${title}: filters the list operation does not declare`,
+        error: new Error(
+          `${undeclared.join(", ")} is not a parameter of ${listOperation.method.toUpperCase()} ${listOperation.path} (declared: ${declared.join(", ") || "none"})`
+        )
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    OperationCatalog,
+    {
+      definition: { key: surfaceKey, title, description: "Recorded query sessions" },
+      entities: [],
+      surfaceKey,
+      client,
+      renderLink,
+      selectionNoun: "sessions",
+      ...lockedValues ? { lockedValues } : {},
+      ...initialValues ? { initialValues } : {},
+      ...getRowDetailHref ? { getRowDetailHref } : {},
+      ...urlState !== void 0 ? { urlState } : {},
+      ...hiddenColumns ? { hiddenColumns } : {}
+    }
+  );
+}
+export {
+  SESSIONS_SURFACE_KEY,
+  SessionsCatalog
+};
+//# sourceMappingURL=SessionsCatalog.js.map

package/dist/rpc/SessionsCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionsCatalog.js","sources":["../../src/rpc/SessionsCatalog.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport { OperationCatalog, type OperationCatalogProps } from \"./OperationCatalog\";\nimport type { RenderLink } from \"./EndpointList\";\nimport { InlineError } from \"./InlineError\";\nimport { findSurfaceListOperation } from \"./clickyMetadata\";\nimport type { ResolvedOperation } from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\n\n/**\n * The x-clicky surface key commons-db's sessions list operation\n * (`GET /api/v1/sessions`, operationId `list-sessions`) is published under.\n * A host that mounts the sessions API under a different surface passes its\n * own key through `surfaceKey`.\n */\nexport const SESSIONS_SURFACE_KEY = \"sessions\";\n\nexport type SessionsCatalogProps = {\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  /** Surface the list operation is tagged with. Defaults to SESSIONS_SURFACE_KEY. */\n  surfaceKey?: string;\n  /**\n   * Filters the host pins, e.g. `{ profile: \"trace-capture/jvm_trace\",\n   * \"label.target\": \"cycle\" }` for one target's JVM traces. Sent on every list,\n   * lookup and export request; never editable, never in the URL. Every key must\n   * be a parameter the list operation declares: once the spec has loaded, an\n   * undeclared key renders an error in place of the table.\n   */\n  lockedValues?: Record<string, string>;\n  /**\n   * Editable starting filters, applied only where the URL is silent. Keys are\n   * checked against the list operation's parameters like `lockedValues`.\n   */\n  initialValues?: Record<string, string>;\n  /** Route of a session's page, given the row's id. */\n  getRowDetailHref?: (id: string) => string | undefined;\n  urlState?: OperationCatalogProps[\"urlState\"];\n  hiddenColumns?: string[];\n  /** Heading used in loading and export labels. Defaults to \"Sessions\". */\n  title?: string;\n};\n\n// OperationCatalog packs only the values a parameter list names, so an\n// undeclared pinned filter would vanish from the request and the table would\n// list every session while the host believed it was scoped.\nfunction undeclaredFilterKeys(\n  listOperation: ResolvedOperation,\n  values: { lockedValues: Record<string, string> | undefined; initialValues: Record<string, string> | undefined },\n): string[] {\n  const declared = new Set((listOperation.operation.parameters ?? []).map((parameter) => parameter.name));\n  return Object.entries(values).flatMap(([prop, record]) =>\n    Object.keys(record ?? {})\n      .filter((key) => !declared.has(key))\n      .map((key) => `${prop} key \"${key}\"`),\n  );\n}\n\nexport function SessionsCatalog({\n  client,\n  renderLink,\n  surfaceKey = SESSIONS_SURFACE_KEY,\n  lockedValues,\n  initialValues,\n  getRowDetailHref,\n  urlState,\n  hiddenColumns,\n  title = \"Sessions\",\n}: SessionsCatalogProps) {\n  const { operations } = useOperations(client);\n  const listOperation = useMemo(\n    () => findSurfaceListOperation(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const undeclared = listOperation ? undeclaredFilterKeys(listOperation, { lockedValues, initialValues }) : [];\n  if (listOperation && undeclared.length > 0) {\n    const declared = (listOperation.operation.parameters ?? []).map((parameter) => parameter.name);\n    return (\n      <InlineError\n        title={`${title}: filters the list operation does not declare`}\n        error={\n          new Error(\n            `${undeclared.join(\", \")} is not a parameter of ${listOperation.method.toUpperCase()} ${listOperation.path} (declared: ${declared.join(\", \") || \"none\"})`,\n          )\n        }\n      />\n    );\n  }\n\n  return (\n    <OperationCatalog\n      definition={{ key: surfaceKey, title, description: \"Recorded query sessions\" }}\n      entities={[]}\n      surfaceKey={surfaceKey}\n      client={client}\n      renderLink={renderLink}\n      selectionNoun=\"sessions\"\n      {...(lockedValues ? { lockedValues } : {})}\n      {...(initialValues ? { initialValues } : {})}\n      {...(getRowDetailHref ? { getRowDetailHref } : {})}\n      {...(urlState !== undefined ? { urlState } : {})}\n      {...(hiddenColumns ? { hiddenColumns } : {})}\n    />\n  );\n}\n"],"names":[],"mappings":";;;;;;AAcO,MAAM,uBAAuB;AA+BpC,SAAS,qBACP,eACA,QACU;AACV,QAAM,WAAW,IAAI,KAAK,cAAc,UAAU,cAAc,CAAA,GAAI,IAAI,CAAC,cAAc,UAAU,IAAI,CAAC;AACtG,SAAO,OAAO,QAAQ,MAAM,EAAE;AAAA,IAAQ,CAAC,CAAC,MAAM,MAAM,MAClD,OAAO,KAAK,UAAU,EAAE,EACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,CAAC,EAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,SAAS,GAAG,GAAG;AAAA,EAAA;AAE1C;AAEO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAyB;AACvB,QAAM,EAAE,WAAA,IAAe,cAAc,MAAM;AAC3C,QAAM,gBAAgB;AAAA,IACpB,MAAM,yBAAyB,YAAY,UAAU;AAAA,IACrD,CAAC,YAAY,UAAU;AAAA,EAAA;AAEzB,QAAM,aAAa,gBAAgB,qBAAqB,eAAe,EAAE,cAAc,cAAA,CAAe,IAAI,CAAA;AAC1G,MAAI,iBAAiB,WAAW,SAAS,GAAG;AAC1C,UAAM,YAAY,cAAc,UAAU,cAAc,IAAI,IAAI,CAAC,cAAc,UAAU,IAAI;AAC7F,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,OAAO,GAAG,KAAK;AAAA,QACf,OACE,IAAI;AAAA,UACF,GAAG,WAAW,KAAK,IAAI,CAAC,0BAA0B,cAAc,OAAO,YAAA,CAAa,IAAI,cAAc,IAAI,eAAe,SAAS,KAAK,IAAI,KAAK,MAAM;AAAA,QAAA;AAAA,MACxJ;AAAA,IAAA;AAAA,EAIR;AAEA,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,YAAY,EAAE,KAAK,YAAY,OAAO,aAAa,0BAAA;AAAA,MACnD,UAAU,CAAA;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA,eAAc;AAAA,MACb,GAAI,eAAe,EAAE,aAAA,IAAiB,CAAA;AAAA,MACtC,GAAI,gBAAgB,EAAE,cAAA,IAAkB,CAAA;AAAA,MACxC,GAAI,mBAAmB,EAAE,iBAAA,IAAqB,CAAA;AAAA,MAC9C,GAAI,aAAa,SAAY,EAAE,SAAA,IAAa,CAAA;AAAA,MAC5C,GAAI,gBAAgB,EAAE,kBAAkB,CAAA;AAAA,IAAC;AAAA,EAAA;AAGhD;"}

package/dist/rpc/executionPages.cjs

@@ -90,5 +90,8 @@ function mapFirstIn(nodes, fn) {
   }
   return void 0;
 }
+exports.documentOf = documentOf;
+exports.findFirstTable = findFirstTable;
+exports.mapFirstTable = mapFirstTable;
 exports.mergeExecutionPages = mergeExecutionPages;
 //# sourceMappingURL=executionPages.cjs.map

package/dist/rpc/executionPages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"executionPages.cjs","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\nfunction documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\nfunction findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nfunction mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":["parseClickyData"],"mappings":"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"}
+{"version":3,"file":"executionPages.cjs","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\n// Exported for operationCatalogFollow.ts, which reads the same response shape\n// to find the table it merges live rows into.\nexport function documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\n// Exported for operationCatalogFollow.ts, which merges live-streamed rows into\n// the same first table a cursor walk accumulates into — one traversal, reused\n// rather than re-implemented, so the two never disagree on which node is \"the\n// table\" a document's rows live in.\nexport function findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nexport function mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":["parseClickyData"],"mappings":"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"}

package/dist/rpc/executionPages.d.ts

@@ -1,3 +1,4 @@
+import { ClickyDocument, ClickyNode } from '../data/Clicky';
 import { ExecutionResponse } from './types';
 /**
  * mergeExecutionPages stacks a cursor walk into the one document the default
@@ -15,4 +16,16 @@ import { ExecutionResponse } from './types';
  * the table to rebuild rows nobody changed.
  */
 export declare function mergeExecutionPages(pages: readonly ExecutionResponse[]): ExecutionResponse | null;
+export declare function documentOf(response: ExecutionResponse): ClickyDocument | undefined;
+export declare function findFirstTable(node: ClickyNode): ClickyNode | undefined;
+/**
+ * Rebuilds `node` with its first table — depth-first, in document order —
+ * replaced by `fn`'s result. One traversal serves both finding a table and
+ * rewriting it, so the page a walk reads rows out of is by construction the
+ * page it writes them back into.
+ */
+export declare function mapFirstTable(node: ClickyNode, fn: (table: ClickyNode) => ClickyNode): {
+    node: ClickyNode;
+    found: boolean;
+};
 //# sourceMappingURL=executionPages.d.ts.map

package/dist/rpc/executionPages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executionPages.d.ts","sourceRoot":"","sources":["../../src/rpc/executionPages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,iBAAiB,GAAG,IAAI,CA0C1B"}
+{"version":3,"file":"executionPages.d.ts","sourceRoot":"","sources":["../../src/rpc/executionPages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAa,MAAM,gBAAgB,CAAC;AAE5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,iBAAiB,GAAG,IAAI,CA0C1B;AAOD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAKlF;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,GACpC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkCtC"}

package/dist/rpc/executionPages.js

@@ -89,6 +89,9 @@ function mapFirstIn(nodes, fn) {
   return void 0;
 }
 export {
+  documentOf,
+  findFirstTable,
+  mapFirstTable,
   mergeExecutionPages
 };
 //# sourceMappingURL=executionPages.js.map

package/dist/rpc/executionPages.js.map

@@ -1 +1 @@
-{"version":3,"file":"executionPages.js","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\nfunction documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\nfunction findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nfunction mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"executionPages.js","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\n// Exported for operationCatalogFollow.ts, which reads the same response shape\n// to find the table it merges live rows into.\nexport function documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\n// Exported for operationCatalogFollow.ts, which merges live-streamed rows into\n// the same first table a cursor walk accumulates into — one traversal, reused\n// rather than re-implemented, so the two never disagree on which node is \"the\n// table\" a document's rows live in.\nexport function findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nexport function mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/formMetadata.cjs

@@ -233,6 +233,45 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     const schema = param.schema;
     const lookupFilter = lookupFilters[param.name];
     const filterType = (shape == null ? void 0 : shape.type) ?? (lookupFilter == null ? void 0 : lookupFilter.type);
+    if (filterType === "number" && param.in === "query") {
+      const unit = (shape == null ? void 0 : shape.unit) ?? (lookupFilter == null ? void 0 : lookupFilter.unit);
+      emitFilters.push({
+        key: param.name,
+        kind: "number",
+        label,
+        disabled,
+        value: dataTableFilterValues.parseBoundsValue(value, (shape == null ? void 0 : shape.defaultOperator) ?? (lookupFilter == null ? void 0 : lookupFilter.defaultOperator)),
+        ...unit ? { unit } : {},
+        onChange: (next) => {
+          if (disabled) return;
+          setValues(
+            (current) => rewind({ ...current, [param.name]: dataTableFilterValues.serializeBoundsValue(next) })
+          );
+        }
+      });
+      continue;
+    }
+    if (filterType === "duration" && param.in === "query") {
+      const unit = durationStorageUnit((shape == null ? void 0 : shape.unit) ?? (lookupFilter == null ? void 0 : lookupFilter.unit));
+      emitFilters.push({
+        key: param.name,
+        kind: "duration",
+        label,
+        disabled,
+        unit,
+        value: dataTableFilterValues.parseDurationBoundsValue(value, unit, (shape == null ? void 0 : shape.defaultOperator) ?? (lookupFilter == null ? void 0 : lookupFilter.defaultOperator)),
+        onChange: (next) => {
+          if (disabled) return;
+          setValues(
+            (current) => rewind({
+              ...current,
+              [param.name]: dataTableFilterValues.serializeDurationBoundsValue(next, unit)
+            })
+          );
+        }
+      });
+      continue;
+    }
     if (filterType === "workload" && param.in === "query") {
       emitFilters.push({
         key: param.name,
@@ -506,6 +545,13 @@ function useDebouncedRecord(value, delayMs) {
   }, [delayMs, value]);
   return debounced;
 }
+function durationStorageUnit(unit) {
+  const resolved = unit || "ms";
+  if (resolved !== "ms" && resolved !== "s" && resolved !== "m" && resolved !== "h") {
+    throw new Error(`Unsupported duration storage unit ${resolved}`);
+  }
+  return resolved;
+}
 function positiveInt(value) {
   const parsed = parseInt(value ?? "", 10);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
@@ -530,11 +576,16 @@ function lookupOptionsToFieldOptions(filter) {
       });
     }
   }
-  return Array.from(merged.entries()).map(([value, meta]) => ({
-    value,
-    label: meta.label ?? value,
-    title: meta.title ?? value
-  }));
+  const counts = filter.counts;
+  return Array.from(merged.entries()).map(([value, meta]) => {
+    const count = counts == null ? void 0 : counts[value];
+    return {
+      value,
+      label: meta.label ?? value,
+      title: meta.title ?? value,
+      ...count !== void 0 ? { count } : {}
+    };
+  });
 }
 function workloadsFromLookup(filter, kinds) {
   var _a, _b;