@flanksource/clicky-ui 0.3.21 → 0.3.22

package/dist/data/clicky-export/ClickyExportDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClickyExportDialog.js","sources":["../../../src/data/clicky-export/ClickyExportDialog.tsx"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { Button } from \"../../components/button\";\nimport { Modal } from \"../../overlay/Modal\";\nimport { Icon, type StaticIconComponent } from \"../Icon\";\nimport { cn } from \"../../lib/utils\";\n\n/** One format the endpoint advertises, already resolved for display. */\nexport type ClickyExportFormatOption = {\n  /** Value handed back to `onDownload`. */\n  format: string;\n  label: string;\n  /** What the format is for. */\n  description?: string | undefined;\n  icon?: StaticIconComponent | undefined;\n  iconClassName?: string | undefined;\n};\n\n/** One result range the endpoint advertises. */\nexport type ClickyExportScopeOption = {\n  /** Value handed back to `onDownload`; undefined for a legacy endpoint. */\n  scope: string | undefined;\n  label: string;\n  /**\n   * What this range costs or caps — \"Limited to 1,000 rows\", \"Streams rows as\n   * they are read\". Per format, because a PDF's ceiling is not a CSV's.\n   */\n  note?: ((format: string) => string | undefined) | undefined;\n};\n\nexport type ClickyExportDialogProps = {\n  open: boolean;\n  onClose: () => void;\n  title?: string;\n  formats: ClickyExportFormatOption[];\n  scopes: ClickyExportScopeOption[];\n  /** Runs the export. Rejecting shows the reason without closing the dialog. */\n  onDownload: (request: {\n    format: string;\n    scope: string | undefined;\n  }) => Promise<void> | void;\n};\n\n/**\n * ClickyExportDialog picks a format and a range, then downloads.\n *\n * It exists because the same choice as a menu was 16 rows — every format times\n * every range — which pushed everything else in that menu out of reach and\n * still truncated the one thing worth reading: what each range costs.\n */\nexport function ClickyExportDialog({\n  open,\n  onClose,\n  title = \"Export\",\n  formats,\n  scopes,\n  onDownload,\n}: ClickyExportDialogProps) {\n  const [format, setFormat] = useState(formats[0]?.format);\n  const [scope, setScope] = useState(scopes[0]?.scope);\n  const [pending, setPending] = useState(false);\n  const [error, setError] = useState(\"\");\n\n  // Reopening starts from a clean slate: the error belongs to the attempt that\n  // produced it, not to the next one.\n  useEffect(() => {\n    if (open) setError(\"\");\n  }, [open]);\n\n  const activeScope = scopes.find((option) => option.scope === scope);\n\n  const download = async () => {\n    if (!format) return;\n    setPending(true);\n    setError(\"\");\n    try {\n      await onDownload({ format, scope });\n      onClose();\n    } catch (cause) {\n      setError(cause instanceof Error ? cause.message : \"The export failed\");\n    } finally {\n      setPending(false);\n    }\n  };\n\n  return (\n    <Modal\n      open={open}\n      onClose={onClose}\n      title={title}\n      size=\"lg\"\n      closeOnEsc\n      footer={\n        <div className=\"flex items-center justify-end gap-2\">\n          <Button variant=\"outline\" onClick={onClose} disabled={pending}>\n            Cancel\n          </Button>\n          <Button\n            onClick={() => void download()}\n            loading={pending}\n            disabled={!format}\n          >\n            Download\n          </Button>\n        </div>\n      }\n    >\n      <div className=\"space-y-4\">\n        {error && (\n          <div\n            role=\"alert\"\n            className=\"rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive\"\n          >\n            {error}\n          </div>\n        )}\n\n        {scopes.length > 1 ? (\n          <fieldset>\n            <legend className=\"mb-1.5 text-[11px] font-medium uppercase tracking-wide text-muted-foreground\">\n              Rows\n            </legend>\n            <div className=\"flex flex-wrap gap-2\">\n              {scopes.map((option) => (\n                <label\n                  key={option.scope ?? \"default\"}\n                  className={cn(\n                    \"cursor-pointer rounded-md border px-3 py-1.5 text-sm transition-colors\",\n                    option.scope === scope\n                      ? \"border-foreground/20 bg-accent text-accent-foreground\"\n                      : \"border-input hover:bg-accent hover:text-accent-foreground\",\n                  )}\n                >\n                  <input\n                    type=\"radio\"\n                    name=\"clicky-export-scope\"\n                    // Named explicitly: the input is visually hidden behind its\n                    // own styled label, so nothing else gives it a name.\n                    aria-label={option.label}\n                    className=\"sr-only\"\n                    checked={option.scope === scope}\n                    onChange={() => setScope(option.scope)}\n                  />\n                  {option.label}\n                </label>\n              ))}\n            </div>\n          </fieldset>\n        ) : (\n          scopes[0]?.label && (\n            <p className=\"text-sm text-muted-foreground\">{scopes[0].label}</p>\n          )\n        )}\n\n        <fieldset>\n          <legend className=\"mb-1.5 text-[11px] font-medium uppercase tracking-wide text-muted-foreground\">\n            Format\n          </legend>\n          <div className=\"grid gap-1 sm:grid-cols-2\">\n            {formats.map((option) => {\n              const note = activeScope?.note?.(option.format);\n              return (\n                <label\n                  key={option.format}\n                  className={cn(\n                    \"flex cursor-pointer items-start gap-2 rounded-md border px-3 py-2 text-left transition-colors\",\n                    option.format === format\n                      ? \"border-foreground/20 bg-accent text-accent-foreground\"\n                      : \"border-transparent hover:bg-accent hover:text-accent-foreground\",\n                  )}\n                >\n                  <input\n                    type=\"radio\"\n                    name=\"clicky-export-format\"\n                    aria-label={option.label}\n                    className=\"sr-only\"\n                    checked={option.format === format}\n                    onChange={() => setFormat(option.format)}\n                  />\n                  {option.icon && (\n                    <Icon\n                      icon={option.icon}\n                      className={cn(\n                        \"mt-0.5 shrink-0 text-sm\",\n                        option.iconClassName ?? \"text-muted-foreground\",\n                      )}\n                    />\n                  )}\n                  <span className=\"min-w-0\">\n                    <span className=\"block text-sm font-medium\">\n                      {option.label}\n                    </span>\n                    {option.description && (\n                      <span className=\"mt-0.5 block text-xs text-muted-foreground\">\n                        {option.description}\n                      </span>\n                    )}\n                    {note && (\n                      <span className=\"mt-0.5 block text-xs text-amber-700 [[data-theme=dark]_&]:text-amber-400\">\n                        {note}\n                      </span>\n                    )}\n                  </span>\n                </label>\n              );\n            })}\n          </div>\n        </fieldset>\n\n      </div>\n    </Modal>\n  );\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/data/clicky-export/index.d.ts

@@ -0,0 +1,3 @@
+export { ClickyExportDialog, type ClickyExportDialogProps, type ClickyExportFormatOption, type ClickyExportScopeOption, } from './ClickyExportDialog';
+export { useClickyExport, type UseClickyExportOptions, type UseClickyExportResult, } from './useClickyExport';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/clicky-export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/clicky-export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/data/clicky-export/useClickyExport.cjs

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const ClickyExportDialog = require("./ClickyExportDialog.cjs");
+const UiCloudDownload = require("../../icons/components/UiCloudDownload.cjs");
+function useClickyExport({
+  formats,
+  scopes,
+  onDownload,
+  label = "Export…",
+  title
+}) {
+  const [open, setOpen] = react.useState(false);
+  const close = react.useCallback(() => setOpen(false), []);
+  const available = formats.length > 0;
+  const action = react.useMemo(
+    () => available ? {
+      id: "export",
+      label,
+      icon: UiCloudDownload.UiCloudDownload,
+      section: "",
+      onSelect: () => setOpen(true)
+    } : void 0,
+    [available, label]
+  );
+  if (!available) return { action: void 0, dialog: null };
+  return {
+    action,
+    dialog: /* @__PURE__ */ jsxRuntime.jsx(
+      ClickyExportDialog.ClickyExportDialog,
+      {
+        open,
+        onClose: close,
+        formats,
+        scopes,
+        onDownload,
+        ...title ? { title } : {}
+      }
+    )
+  };
+}
+exports.useClickyExport = useClickyExport;
+//# sourceMappingURL=useClickyExport.cjs.map

package/dist/data/clicky-export/useClickyExport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickyExport.cjs","sources":["../../../src/data/clicky-export/useClickyExport.tsx"],"sourcesContent":["import { useCallback, useMemo, useState, type ReactNode } from \"react\";\nimport { UiCloudDownload } from \"../../icons\";\nimport type { DataTableMenuAction } from \"../DataTable\";\nimport {\n  ClickyExportDialog,\n  type ClickyExportFormatOption,\n  type ClickyExportScopeOption,\n} from \"./ClickyExportDialog\";\n\nexport type UseClickyExportOptions = {\n  formats: ClickyExportFormatOption[];\n  scopes: ClickyExportScopeOption[];\n  onDownload: (request: {\n    format: string;\n    scope: string | undefined;\n  }) => Promise<void> | void;\n  /** Menu row label. Defaults to \"Export…\". */\n  label?: string | undefined;\n  /** Dialog heading. Defaults to \"Export\". */\n  title?: string | undefined;\n};\n\nexport type UseClickyExportResult = {\n  /** \"Export…\" for the table's overflow menu; absent with nothing to export. */\n  action: DataTableMenuAction | undefined;\n  /** Render alongside the table — the dialog the action opens. */\n  dialog: ReactNode;\n};\n\n/**\n * useClickyExport puts a single \"Export…\" row in a table's overflow menu.\n *\n * One row rather than one per format-and-range: the choice belongs in a dialog\n * that has room to say what each range costs, and a menu whose formats outnumber\n * everything else in it is a menu whose other entries never get found.\n */\nexport function useClickyExport({\n  formats,\n  scopes,\n  onDownload,\n  label = \"Export…\",\n  title,\n}: UseClickyExportOptions): UseClickyExportResult {\n  const [open, setOpen] = useState(false);\n  const close = useCallback(() => setOpen(false), []);\n  const available = formats.length > 0;\n  const action = useMemo<DataTableMenuAction | undefined>(\n    () =>\n      available\n        ? {\n            id: \"export\",\n            label,\n            icon: UiCloudDownload,\n            section: \"\",\n            onSelect: () => setOpen(true),\n          }\n        : undefined,\n    [available, label],\n  );\n\n  if (!available) return { action: undefined, dialog: null };\n\n  return {\n    action,\n    dialog: (\n      <ClickyExportDialog\n        open={open}\n        onClose={close}\n        formats={formats}\n        scopes={scopes}\n        onDownload={onDownload}\n        {...(title ? { title } : {})}\n      />\n    ),\n  };\n}\n"],"names":["useState","useCallback","useMemo","UiCloudDownload","jsx","ClickyExportDialog"],"mappings":";;;;;;AAoCO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAkD;AAChD,QAAM,CAAC,MAAM,OAAO,IAAIA,MAAAA,SAAS,KAAK;AACtC,QAAM,QAAQC,MAAAA,YAAY,MAAM,QAAQ,KAAK,GAAG,CAAA,CAAE;AAClD,QAAM,YAAY,QAAQ,SAAS;AACnC,QAAM,SAASC,MAAAA;AAAAA,IACb,MACE,YACI;AAAA,MACE,IAAI;AAAA,MACJ;AAAA,MACA,MAAMC,gBAAAA;AAAAA,MACN,SAAS;AAAA,MACT,UAAU,MAAM,QAAQ,IAAI;AAAA,IAAA,IAE9B;AAAA,IACN,CAAC,WAAW,KAAK;AAAA,EAAA;AAGnB,MAAI,CAAC,UAAW,QAAO,EAAE,QAAQ,QAAW,QAAQ,KAAA;AAEpD,SAAO;AAAA,IACL;AAAA,IACA,QACEC,2BAAAA;AAAAA,MAACC,mBAAAA;AAAAA,MAAA;AAAA,QACC;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA;AAAA,QACA;AAAA,QACC,GAAI,QAAQ,EAAE,UAAU,CAAA;AAAA,MAAC;AAAA,IAAA;AAAA,EAC5B;AAGN;;"}

package/dist/data/clicky-export/useClickyExport.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+import { DataTableMenuAction } from '../DataTable';
+import { ClickyExportFormatOption, ClickyExportScopeOption } from './ClickyExportDialog';
+export type UseClickyExportOptions = {
+    formats: ClickyExportFormatOption[];
+    scopes: ClickyExportScopeOption[];
+    onDownload: (request: {
+        format: string;
+        scope: string | undefined;
+    }) => Promise<void> | void;
+    /** Menu row label. Defaults to "Export…". */
+    label?: string | undefined;
+    /** Dialog heading. Defaults to "Export". */
+    title?: string | undefined;
+};
+export type UseClickyExportResult = {
+    /** "Export…" for the table's overflow menu; absent with nothing to export. */
+    action: DataTableMenuAction | undefined;
+    /** Render alongside the table — the dialog the action opens. */
+    dialog: ReactNode;
+};
+/**
+ * useClickyExport puts a single "Export…" row in a table's overflow menu.
+ *
+ * One row rather than one per format-and-range: the choice belongs in a dialog
+ * that has room to say what each range costs, and a menu whose formats outnumber
+ * everything else in it is a menu whose other entries never get found.
+ */
+export declare function useClickyExport({ formats, scopes, onDownload, label, title, }: UseClickyExportOptions): UseClickyExportResult;
+//# sourceMappingURL=useClickyExport.d.ts.map

package/dist/data/clicky-export/useClickyExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickyExport.d.ts","sourceRoot":"","sources":["../../../src/data/clicky-export/useClickyExport.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,UAAU,EAAE,CAAC,OAAO,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,8EAA8E;IAC9E,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,gEAAgE;IAChE,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,MAAM,EACN,UAAU,EACV,KAAiB,EACjB,KAAK,GACN,EAAE,sBAAsB,GAAG,qBAAqB,CAiChD"}

package/dist/data/clicky-export/useClickyExport.js

@@ -0,0 +1,44 @@
+import { jsx } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from "react";
+import { ClickyExportDialog } from "./ClickyExportDialog.js";
+import { UiCloudDownload } from "../../icons/components/UiCloudDownload.js";
+function useClickyExport({
+  formats,
+  scopes,
+  onDownload,
+  label = "Export…",
+  title
+}) {
+  const [open, setOpen] = useState(false);
+  const close = useCallback(() => setOpen(false), []);
+  const available = formats.length > 0;
+  const action = useMemo(
+    () => available ? {
+      id: "export",
+      label,
+      icon: UiCloudDownload,
+      section: "",
+      onSelect: () => setOpen(true)
+    } : void 0,
+    [available, label]
+  );
+  if (!available) return { action: void 0, dialog: null };
+  return {
+    action,
+    dialog: /* @__PURE__ */ jsx(
+      ClickyExportDialog,
+      {
+        open,
+        onClose: close,
+        formats,
+        scopes,
+        onDownload,
+        ...title ? { title } : {}
+      }
+    )
+  };
+}
+export {
+  useClickyExport
+};
+//# sourceMappingURL=useClickyExport.js.map

package/dist/data/clicky-export/useClickyExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickyExport.js","sources":["../../../src/data/clicky-export/useClickyExport.tsx"],"sourcesContent":["import { useCallback, useMemo, useState, type ReactNode } from \"react\";\nimport { UiCloudDownload } from \"../../icons\";\nimport type { DataTableMenuAction } from \"../DataTable\";\nimport {\n  ClickyExportDialog,\n  type ClickyExportFormatOption,\n  type ClickyExportScopeOption,\n} from \"./ClickyExportDialog\";\n\nexport type UseClickyExportOptions = {\n  formats: ClickyExportFormatOption[];\n  scopes: ClickyExportScopeOption[];\n  onDownload: (request: {\n    format: string;\n    scope: string | undefined;\n  }) => Promise<void> | void;\n  /** Menu row label. Defaults to \"Export…\". */\n  label?: string | undefined;\n  /** Dialog heading. Defaults to \"Export\". */\n  title?: string | undefined;\n};\n\nexport type UseClickyExportResult = {\n  /** \"Export…\" for the table's overflow menu; absent with nothing to export. */\n  action: DataTableMenuAction | undefined;\n  /** Render alongside the table — the dialog the action opens. */\n  dialog: ReactNode;\n};\n\n/**\n * useClickyExport puts a single \"Export…\" row in a table's overflow menu.\n *\n * One row rather than one per format-and-range: the choice belongs in a dialog\n * that has room to say what each range costs, and a menu whose formats outnumber\n * everything else in it is a menu whose other entries never get found.\n */\nexport function useClickyExport({\n  formats,\n  scopes,\n  onDownload,\n  label = \"Export…\",\n  title,\n}: UseClickyExportOptions): UseClickyExportResult {\n  const [open, setOpen] = useState(false);\n  const close = useCallback(() => setOpen(false), []);\n  const available = formats.length > 0;\n  const action = useMemo<DataTableMenuAction | undefined>(\n    () =>\n      available\n        ? {\n            id: \"export\",\n            label,\n            icon: UiCloudDownload,\n            section: \"\",\n            onSelect: () => setOpen(true),\n          }\n        : undefined,\n    [available, label],\n  );\n\n  if (!available) return { action: undefined, dialog: null };\n\n  return {\n    action,\n    dialog: (\n      <ClickyExportDialog\n        open={open}\n        onClose={close}\n        formats={formats}\n        scopes={scopes}\n        onDownload={onDownload}\n        {...(title ? { title } : {})}\n      />\n    ),\n  };\n}\n"],"names":[],"mappings":";;;;AAoCO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAkD;AAChD,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,QAAQ,YAAY,MAAM,QAAQ,KAAK,GAAG,CAAA,CAAE;AAClD,QAAM,YAAY,QAAQ,SAAS;AACnC,QAAM,SAAS;AAAA,IACb,MACE,YACI;AAAA,MACE,IAAI;AAAA,MACJ;AAAA,MACA,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,MAAM,QAAQ,IAAI;AAAA,IAAA,IAE9B;AAAA,IACN,CAAC,WAAW,KAAK;AAAA,EAAA;AAGnB,MAAI,CAAC,UAAW,QAAO,EAAE,QAAQ,QAAW,QAAQ,KAAA;AAEpD,SAAO;AAAA,IACL;AAAA,IACA,QACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA;AAAA,QACA;AAAA,QACC,GAAI,QAAQ,EAAE,UAAU,CAAA;AAAA,MAAC;AAAA,IAAA;AAAA,EAC5B;AAGN;"}

package/dist/data/data-table-server-filters.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const filterBarUtils = require("../components/filter-bar-utils.cjs");
+const format = require("../lib/format.cjs");
 const dataTableFilterValues = require("./data-table-filter-values.cjs");
 const dataTableUtils = require("./data-table-utils.cjs");
 const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;
@@ -58,15 +59,21 @@ function buildFilter(args) {
   };
   switch (filter.kind) {
     case "time":
+    // A date range is the same two-edged control with the clock taken off it,
+    // so it shares every line below except timeEnabled.
+    case "date":
       return {
         ...shared,
         kind: "date-range",
         ...boundsToRange(dataTableFilterValues.parseBoundsValue(raw)),
         onApply: (from, to) => write(dataTableFilterValues.serializeBoundsValue({ min: from, max: to })),
         ...filter.presets !== void 0 ? { presets: filter.presets } : {},
-        timeEnabled: true
+        timeEnabled: filter.kind === "time"
       };
     case "range":
+    // A duration is a range that knows what its numbers mean, so it differs
+    // only in how the slider labels them.
+    case "duration":
       return {
         ...shared,
         kind: "number",
@@ -74,8 +81,14 @@ function buildFilter(args) {
         onChange: (next) => write(dataTableFilterValues.serializeBoundsValue(next)),
         ...filter.min !== void 0 ? { domainMin: filter.min } : {},
         ...filter.max !== void 0 ? { domainMax: filter.max } : {},
-        ...filter.step !== void 0 ? { step: filter.step } : {}
+        ...filter.step !== void 0 ? { step: filter.step } : {},
+        ...filter.kind === "duration" ? { formatValue: (value) => format.formatUnit(value, filter.unit || "ms") } : {}
       };
+    // An exact match has nothing to enumerate, which is what buildTermsFilter
+    // already falls back to for a selection that turned out to have no values.
+    // Declaring it says so up front rather than arriving there by exhaustion.
+    case "exact":
+      return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
     case "boolean":
       return {
         ...shared,

package/dist/data/data-table-server-filters.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-server-filters.cjs","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind = \"terms\" | \"range\" | \"time\" | \"boolean\" | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(\n  columns: DataTableServerColumn[],\n): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({ column, filterKey, label, filter, values, setValues, options }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) => updateFilterSelection(current, filterKey, serialized));\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined ? { description: filter.description } : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: true,\n      };\n    case \"range\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) => write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n      };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) => write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: { key: string; label: string; description?: string; disabled?: boolean },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to })),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): { from?: string; to?: string } {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined ? { title: `${label} · ${option.count.toLocaleString()}` } : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":["prettifyKey","applyFilterExtensions","updateFilterSelection","parseBoundsValue","serializeBoundsValue","parseMultiFilterValue","serializeMultiFilterValue"],"mappings":"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"}
+{"version":3,"file":"data-table-server-filters.cjs","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport { formatUnit } from \"../lib/format\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind =\n  | \"terms\"\n  /** Whole values like \"terms\", but typed rather than picked — an identifier\n   *  has no list worth offering. */\n  | \"exact\"\n  | \"range\"\n  /** A range over elapsed time, labelled in the column's own `unit`. */\n  | \"duration\"\n  | \"time\"\n  /** A range over whole days: \"time\" with the clock taken off it. */\n  | \"date\"\n  | \"boolean\"\n  | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** The unit a kind:\"duration\" bound is written in (\"ms\" or \"s\"), so the\n   *  control labels itself in the numbers the column is stored in. Absent\n   *  means milliseconds. */\n  unit?: string;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(\n  columns: DataTableServerColumn[],\n): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({ column, filterKey, label, filter, values, setValues, options }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) => updateFilterSelection(current, filterKey, serialized));\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined ? { description: filter.description } : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n    // A date range is the same two-edged control with the clock taken off it,\n    // so it shares every line below except timeEnabled.\n    case \"date\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: filter.kind === \"time\",\n      };\n    case \"range\":\n    // A duration is a range that knows what its numbers mean, so it differs\n    // only in how the slider labels them.\n    case \"duration\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) => write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n        ...(filter.kind === \"duration\"\n          ? { formatValue: (value: number) => formatUnit(value, filter.unit || \"ms\") }\n          : {}),\n      };\n    // An exact match has nothing to enumerate, which is what buildTermsFilter\n    // already falls back to for a selection that turned out to have no values.\n    // Declaring it says so up front rather than arriving there by exhaustion.\n    case \"exact\":\n      return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) => write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: { key: string; label: string; description?: string; disabled?: boolean },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to })),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): { from?: string; to?: string } {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined ? { title: `${label} · ${option.count.toLocaleString()}` } : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":["prettifyKey","applyFilterExtensions","updateFilterSelection","parseBoundsValue","serializeBoundsValue","formatUnit","parseMultiFilterValue","serializeMultiFilterValue"],"mappings":"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"}

package/dist/data/data-table-server-filters.d.ts

@@ -11,7 +11,14 @@ import { DataTableFilterSelection } from './data-table-filter-values';
  * source compiles the selection; nothing about how it does so crosses into the
  * browser.
  */
-export type DataTableFilterKind = "terms" | "range" | "time" | "boolean" | "text";
+export type DataTableFilterKind = "terms"
+/** Whole values like "terms", but typed rather than picked — an identifier
+ *  has no list worth offering. */
+ | "exact" | "range"
+/** A range over elapsed time, labelled in the column's own `unit`. */
+ | "duration" | "time"
+/** A range over whole days: "time" with the clock taken off it. */
+ | "date" | "boolean" | "text";
 export type DataTableFilterOption = {
     /** Value written into the selection. */
     value: string;
@@ -34,6 +41,10 @@ export type DataTableColumnFilter = {
     min?: number;
     max?: number;
     step?: number;
+    /** The unit a kind:"duration" bound is written in ("ms" or "s"), so the
+     *  control labels itself in the numbers the column is stored in. Absent
+     *  means milliseconds. */
+    unit?: string;
     /** Range presets for kind:"time". */
     presets?: FilterBarRangePreset[];
     /** Helper text shown in the filter popover. */

package/dist/data/data-table-server-filters.d.ts.map

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

package/dist/data/data-table-server-filters.js

@@ -1,4 +1,5 @@
 import { applyFilterExtensions } from "../components/filter-bar-utils.js";
+import { formatUnit } from "../lib/format.js";
 import { updateFilterSelection, serializeBoundsValue, parseBoundsValue, serializeMultiFilterValue, parseMultiFilterValue } from "./data-table-filter-values.js";
 import { prettifyKey } from "./data-table-utils.js";
 const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;
@@ -56,15 +57,21 @@ function buildFilter(args) {
   };
   switch (filter.kind) {
     case "time":
+    // A date range is the same two-edged control with the clock taken off it,
+    // so it shares every line below except timeEnabled.
+    case "date":
       return {
         ...shared,
         kind: "date-range",
         ...boundsToRange(parseBoundsValue(raw)),
         onApply: (from, to) => write(serializeBoundsValue({ min: from, max: to })),
         ...filter.presets !== void 0 ? { presets: filter.presets } : {},
-        timeEnabled: true
+        timeEnabled: filter.kind === "time"
       };
     case "range":
+    // A duration is a range that knows what its numbers mean, so it differs
+    // only in how the slider labels them.
+    case "duration":
       return {
         ...shared,
         kind: "number",
@@ -72,8 +79,14 @@ function buildFilter(args) {
         onChange: (next) => write(serializeBoundsValue(next)),
         ...filter.min !== void 0 ? { domainMin: filter.min } : {},
         ...filter.max !== void 0 ? { domainMax: filter.max } : {},
-        ...filter.step !== void 0 ? { step: filter.step } : {}
+        ...filter.step !== void 0 ? { step: filter.step } : {},
+        ...filter.kind === "duration" ? { formatValue: (value) => formatUnit(value, filter.unit || "ms") } : {}
       };
+    // An exact match has nothing to enumerate, which is what buildTermsFilter
+    // already falls back to for a selection that turned out to have no values.
+    // Declaring it says so up front rather than arriving there by exhaustion.
+    case "exact":
+      return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
     case "boolean":
       return {
         ...shared,

package/dist/data/data-table-server-filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-server-filters.js","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind = \"terms\" | \"range\" | \"time\" | \"boolean\" | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(\n  columns: DataTableServerColumn[],\n): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({ column, filterKey, label, filter, values, setValues, options }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) => updateFilterSelection(current, filterKey, serialized));\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined ? { description: filter.description } : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: true,\n      };\n    case \"range\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) => write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n      };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) => write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: { key: string; label: string; description?: string; disabled?: boolean },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to })),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): { from?: string; to?: string } {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined ? { title: `${label} · ${option.count.toLocaleString()}` } : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-table-server-filters.js","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport { formatUnit } from \"../lib/format\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind =\n  | \"terms\"\n  /** Whole values like \"terms\", but typed rather than picked — an identifier\n   *  has no list worth offering. */\n  | \"exact\"\n  | \"range\"\n  /** A range over elapsed time, labelled in the column's own `unit`. */\n  | \"duration\"\n  | \"time\"\n  /** A range over whole days: \"time\" with the clock taken off it. */\n  | \"date\"\n  | \"boolean\"\n  | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** The unit a kind:\"duration\" bound is written in (\"ms\" or \"s\"), so the\n   *  control labels itself in the numbers the column is stored in. Absent\n   *  means milliseconds. */\n  unit?: string;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(\n  columns: DataTableServerColumn[],\n): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({ column, filterKey, label, filter, values, setValues, options }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) => updateFilterSelection(current, filterKey, serialized));\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined ? { description: filter.description } : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n    // A date range is the same two-edged control with the clock taken off it,\n    // so it shares every line below except timeEnabled.\n    case \"date\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: filter.kind === \"time\",\n      };\n    case \"range\":\n    // A duration is a range that knows what its numbers mean, so it differs\n    // only in how the slider labels them.\n    case \"duration\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) => write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n        ...(filter.kind === \"duration\"\n          ? { formatValue: (value: number) => formatUnit(value, filter.unit || \"ms\") }\n          : {}),\n      };\n    // An exact match has nothing to enumerate, which is what buildTermsFilter\n    // already falls back to for a selection that turned out to have no values.\n    // Declaring it says so up front rather than arriving there by exhaustion.\n    case \"exact\":\n      return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) => write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: { key: string; label: string; description?: string; disabled?: boolean },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to })),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): { from?: string; to?: string } {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined ? { title: `${label} · ${option.count.toLocaleString()}` } : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/data/diagnostics/ErrorDetails.cjs

@@ -10,7 +10,8 @@ const UiCheck = require("../../icons/components/UiCheck.cjs");
 const UiChevronRight = require("../../icons/components/UiChevronRight.cjs");
 const UiMethod = require("../../icons/components/UiMethod.cjs");
 const UiDebugStepOver = require("../../icons/components/UiDebugStepOver.cjs");
-function ErrorDetails({ diagnostics, renderJsonContext }) {
+function ErrorDetails({ diagnostics, title = "Error", renderJsonContext }) {
+  var _a;
   const [copyState, setCopyState] = react.useState("idle");
   const scalarContext = diagnostics.context.filter(
     ([, value]) => !errorDiagnostics.parseInlineJsonContextValue(value)
@@ -23,15 +24,15 @@ function ErrorDetails({ diagnostics, renderJsonContext }) {
     (entry) => entry.data !== null
   );
   const copyDiagnostics = async (event) => {
-    var _a;
+    var _a2;
     event.preventDefault();
     event.stopPropagation();
-    if (!((_a = navigator.clipboard) == null ? void 0 : _a.writeText)) {
+    if (!((_a2 = navigator.clipboard) == null ? void 0 : _a2.writeText)) {
       setCopyState("failed");
       return;
     }
     try {
-      await navigator.clipboard.writeText(diagnosticReport(diagnostics));
+      await navigator.clipboard.writeText(diagnosticReport(diagnostics, title));
       setCopyState("copied");
     } catch {
       setCopyState("failed");
@@ -41,7 +42,7 @@ function ErrorDetails({ diagnostics, renderJsonContext }) {
     /* @__PURE__ */ jsxRuntime.jsxs("summary", { className: "flex cursor-pointer list-none items-start gap-2 p-3", children: [
       /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiWarningTriangle.UiWarningTriangle, className: "mt-0.5 shrink-0 text-destructive" }),
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "min-w-0 flex-1", children: [
-        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm font-semibold text-destructive", children: "Error" }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm font-semibold text-destructive", children: title }),
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mt-1 whitespace-pre-wrap text-sm text-destructive", children: diagnostics.message })
       ] }),
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex shrink-0 flex-col items-end gap-2 text-xs font-medium text-muted-foreground sm:flex-row sm:items-center sm:gap-3", children: [
@@ -94,6 +95,24 @@ function ErrorDetails({ diagnostics, renderJsonContext }) {
           )
         ) })
       ] }),
+      (_a = diagnostics.details) == null ? void 0 : _a.map((detail) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "min-w-0", children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-1.5 flex min-w-0 items-center justify-between gap-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-xs font-semibold uppercase tracking-wide text-muted-foreground", children: detail.label }),
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => copyText(detail.value),
+              className: "inline-flex items-center gap-1 text-xs font-medium text-muted-foreground hover:text-foreground",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiCopy.UiCopy }),
+                "copy"
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("pre", { className: "max-h-64 overflow-auto whitespace-pre-wrap break-all rounded-md bg-muted p-2 font-mono text-xs leading-5 text-foreground", children: detail.value })
+      ] }, detail.label)),
       diagnostics.stacktrace && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "min-w-0", children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-1.5 flex min-w-0 items-center justify-between gap-3", children: [
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-xs font-semibold uppercase tracking-wide text-muted-foreground", children: "Stack trace" }),
@@ -115,8 +134,8 @@ function ErrorDetails({ diagnostics, renderJsonContext }) {
     ] })
   ] });
 }
-function diagnosticReport(diagnostics) {
-  const lines = [`Error: ${diagnostics.message}`];
+function diagnosticReport(diagnostics, title) {
+  const lines = [`${title}: ${diagnostics.message}`];
   if (diagnostics.trace) lines.push(`Trace: ${diagnostics.trace}`);
   if (diagnostics.time) lines.push(`Time: ${diagnostics.time}`);
   if (diagnostics.context.length > 0) {
@@ -126,6 +145,9 @@ function diagnosticReport(diagnostics) {
       ...diagnostics.context.map(([label, value]) => `${label}: ${value}`)
     );
   }
+  for (const detail of diagnostics.details ?? []) {
+    lines.push("", `${detail.label}:`, detail.value);
+  }
   if (diagnostics.stacktrace) {
     lines.push("", "Stack trace:", diagnostics.stacktrace);
   }