@flanksource/clicky-ui 0.3.21 → 0.3.23

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/code-highlight.cjs

@@ -42,7 +42,6 @@ const SUPPORTED_LANGS = [
 const SUPPORTED_THEMES = ["github-light", "github-dark"];
 const DEFAULT_THEME = "github-light";
 let highlighterLoad = null;
-let transformersLoad = null;
 function loadHighlighter() {
   highlighterLoad ?? (highlighterLoad = (async () => {
     const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([
@@ -75,10 +74,6 @@ function loadHighlighter() {
   })());
   return highlighterLoad;
 }
-function loadShikiTransformers() {
-  transformersLoad ?? (transformersLoad = import("@shikijs/transformers"));
-  return transformersLoad;
-}
 function languageFromPath(path) {
   if (!path) return void 0;
   const basename = path.slice(path.lastIndexOf("/") + 1);
@@ -141,5 +136,4 @@ async function highlightToLines(source, opts) {
 exports.highlightCode = highlightCode;
 exports.highlightToLines = highlightToLines;
 exports.languageFromPath = languageFromPath;
-exports.loadShikiTransformers = loadShikiTransformers;
 //# sourceMappingURL=code-highlight.cjs.map

package/dist/data/code-highlight.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"code-highlight.cjs","sources":["../../src/data/code-highlight.ts"],"sourcesContent":["// Lazy-loaded wrapper around a Shiki *core* highlighter pre-registered with a\n// fixed language + theme set. The default `shiki` entry point bundles every\n// grammar/theme as separate dynamic imports — Vite then code-splits each into\n// its own chunk (~280 langs + 50 themes), even when only a handful are ever\n// used. Switching to `shiki/core` and registering a curated subset cuts the\n// app dist by ~6M and ~300 chunks.\n//\n// Languages are picked from what the renderer actually emits (Clicky code\n// blocks + Java stack traces). Anything outside the list silently falls back\n// to plain text — same behavior as before, just without paying for grammars\n// nobody asked for.\n\nimport type { HighlighterCore, ThemeRegistrationAny } from \"shiki/core\";\n\ntype ShikiTransformersModule = typeof import(\"@shikijs/transformers\");\ntype ShikiTransformer = NonNullable<\n  Parameters<HighlighterCore[\"codeToHtml\"]>[1][\"transformers\"]\n>[number];\n\nconst SUPPORTED_LANGS = [\n  \"java\",\n  \"go\",\n  \"python\",\n  \"javascript\",\n  \"typescript\",\n  \"tsx\",\n  \"jsx\",\n  \"json\",\n  \"yaml\",\n  \"bash\",\n  \"shell\",\n  \"sql\",\n  \"xml\",\n  \"html\",\n  \"css\",\n] as const;\n\ntype SupportedLang = (typeof SUPPORTED_LANGS)[number];\n\nconst SUPPORTED_THEMES = [\"github-light\", \"github-dark\"] as const;\ntype SupportedTheme = (typeof SUPPORTED_THEMES)[number];\nconst DEFAULT_THEME: SupportedTheme = \"github-light\";\n\nlet highlighterLoad: Promise<HighlighterCore> | null = null;\nlet transformersLoad: Promise<ShikiTransformersModule> | null = null;\n\nfunction loadHighlighter(): Promise<HighlighterCore> {\n  highlighterLoad ??= (async () => {\n    const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([\n      import(\"shiki/core\"),\n      import(\"shiki/engine/oniguruma\"),\n    ]);\n    return createHighlighterCore({\n      themes: [\n        import(\"@shikijs/themes/github-light\") as Promise<{ default: ThemeRegistrationAny }>,\n        import(\"@shikijs/themes/github-dark\") as Promise<{ default: ThemeRegistrationAny }>,\n      ],\n      langs: [\n        import(\"@shikijs/langs/java\"),\n        import(\"@shikijs/langs/go\"),\n        import(\"@shikijs/langs/python\"),\n        import(\"@shikijs/langs/javascript\"),\n        import(\"@shikijs/langs/typescript\"),\n        import(\"@shikijs/langs/tsx\"),\n        import(\"@shikijs/langs/jsx\"),\n        import(\"@shikijs/langs/json\"),\n        import(\"@shikijs/langs/yaml\"),\n        import(\"@shikijs/langs/bash\"),\n        import(\"@shikijs/langs/sql\"),\n        import(\"@shikijs/langs/xml\"),\n        import(\"@shikijs/langs/html\"),\n        import(\"@shikijs/langs/css\"),\n      ],\n      engine: createOnigurumaEngine(import(\"shiki/wasm\")),\n    });\n  })();\n  return highlighterLoad;\n}\n\nexport function loadShikiTransformers(): Promise<ShikiTransformersModule> {\n  transformersLoad ??= import(\"@shikijs/transformers\");\n  return transformersLoad;\n}\n\nexport type HighlightOptions = {\n  lang: string;\n  theme?: string;\n  transformers?: ShikiTransformer[];\n};\n\n// Derive a highlighter language hint from a file path's extension (e.g.\n// \"src/app.tsx\" → \"tsx\"). Returns undefined for extensionless paths and dotfiles;\n// `resolveLang` then maps aliases and drops anything unsupported.\nexport function languageFromPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const basename = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = basename.lastIndexOf(\".\");\n  if (dot <= 0) return undefined;\n  return basename.slice(dot + 1).toLowerCase();\n}\n\nfunction resolveLang(input: string): SupportedLang | null {\n  const lang = input.toLowerCase();\n  if ((SUPPORTED_LANGS as readonly string[]).includes(lang)) return lang as SupportedLang;\n  if (lang === \"shell\" || lang === \"sh\" || lang === \"zsh\") return \"bash\";\n  if (lang === \"ts\") return \"typescript\";\n  if (lang === \"js\") return \"javascript\";\n  if (lang === \"py\") return \"python\";\n  if (lang === \"yml\") return \"yaml\";\n  return null;\n}\n\nfunction resolveTheme(input: string | undefined): SupportedTheme {\n  if (input && (SUPPORTED_THEMES as readonly string[]).includes(input)) {\n    return input as SupportedTheme;\n  }\n  return DEFAULT_THEME;\n}\n\nexport async function highlightCode(\n  source: string,\n  opts: HighlightOptions,\n): Promise<string | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    return highlighter.codeToHtml(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n      ...(opts.transformers ? { transformers: opts.transformers } : {}),\n    });\n  } catch {\n    return null;\n  }\n}\n\n// A single highlighted token: its text, an optional hex `color`, and Shiki's\n// `fontStyle` bitmask (1=italic, 2=bold, 4=underline).\nexport type HighlightedToken = { content: string; color?: string; fontStyle?: number };\nexport type HighlightedLine = HighlightedToken[];\n\n// Tokenize `source` into per-line themed tokens for `CodeDiff`, which paints its\n// own diff gutters/rows rather than embedding Shiki's `<pre>` HTML. Returns null\n// on empty source, an unsupported language, or a highlighter failure — the caller\n// then renders plain text (same graceful degradation as `highlightCode`).\nexport async function highlightToLines(\n  source: string,\n  opts: HighlightOptions,\n): Promise<HighlightedLine[] | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    const { tokens } = highlighter.codeToTokens(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n    });\n    return tokens.map((line) =>\n      line.map((token) => ({\n        content: token.content,\n        ...(token.color ? { color: token.color } : {}),\n        ...(token.fontStyle ? { fontStyle: token.fontStyle } : {}),\n      })),\n    );\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"code-highlight.cjs","sources":["../../src/data/code-highlight.ts"],"sourcesContent":["// Lazy-loaded wrapper around a Shiki *core* highlighter pre-registered with a\n// fixed language + theme set. The default `shiki` entry point bundles every\n// grammar/theme as separate dynamic imports — Vite then code-splits each into\n// its own chunk (~280 langs + 50 themes), even when only a handful are ever\n// used. Switching to `shiki/core` and registering a curated subset cuts the\n// app dist by ~6M and ~300 chunks.\n//\n// Languages are picked from what the renderer actually emits (Clicky code\n// blocks + Java stack traces). Anything outside the list silently falls back\n// to plain text — same behavior as before, just without paying for grammars\n// nobody asked for.\n\nimport type { HighlighterCore, ThemeRegistrationAny } from \"shiki/core\";\n\ntype ShikiTransformer = NonNullable<\n  Parameters<HighlighterCore[\"codeToHtml\"]>[1][\"transformers\"]\n>[number];\n\nconst SUPPORTED_LANGS = [\n  \"java\",\n  \"go\",\n  \"python\",\n  \"javascript\",\n  \"typescript\",\n  \"tsx\",\n  \"jsx\",\n  \"json\",\n  \"yaml\",\n  \"bash\",\n  \"shell\",\n  \"sql\",\n  \"xml\",\n  \"html\",\n  \"css\",\n] as const;\n\ntype SupportedLang = (typeof SUPPORTED_LANGS)[number];\n\nconst SUPPORTED_THEMES = [\"github-light\", \"github-dark\"] as const;\ntype SupportedTheme = (typeof SUPPORTED_THEMES)[number];\nconst DEFAULT_THEME: SupportedTheme = \"github-light\";\n\nlet highlighterLoad: Promise<HighlighterCore> | null = null;\n\nfunction loadHighlighter(): Promise<HighlighterCore> {\n  highlighterLoad ??= (async () => {\n    const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([\n      import(\"shiki/core\"),\n      import(\"shiki/engine/oniguruma\"),\n    ]);\n    return createHighlighterCore({\n      themes: [\n        import(\"@shikijs/themes/github-light\") as Promise<{ default: ThemeRegistrationAny }>,\n        import(\"@shikijs/themes/github-dark\") as Promise<{ default: ThemeRegistrationAny }>,\n      ],\n      langs: [\n        import(\"@shikijs/langs/java\"),\n        import(\"@shikijs/langs/go\"),\n        import(\"@shikijs/langs/python\"),\n        import(\"@shikijs/langs/javascript\"),\n        import(\"@shikijs/langs/typescript\"),\n        import(\"@shikijs/langs/tsx\"),\n        import(\"@shikijs/langs/jsx\"),\n        import(\"@shikijs/langs/json\"),\n        import(\"@shikijs/langs/yaml\"),\n        import(\"@shikijs/langs/bash\"),\n        import(\"@shikijs/langs/sql\"),\n        import(\"@shikijs/langs/xml\"),\n        import(\"@shikijs/langs/html\"),\n        import(\"@shikijs/langs/css\"),\n      ],\n      engine: createOnigurumaEngine(import(\"shiki/wasm\")),\n    });\n  })();\n  return highlighterLoad;\n}\n\nexport type HighlightOptions = {\n  /** Highlighter language. Undefined when the caller has none, in which case\n   *  both entry points return null and the caller renders plain text — better\n   *  than guessing a grammar and mis-colouring the source. */\n  lang: string | undefined;\n  theme?: string;\n  transformers?: ShikiTransformer[];\n};\n\n// Derive a highlighter language hint from a file path's extension (e.g.\n// \"src/app.tsx\" → \"tsx\"). Returns undefined for extensionless paths and dotfiles;\n// `resolveLang` then maps aliases and drops anything unsupported.\nexport function languageFromPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const basename = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = basename.lastIndexOf(\".\");\n  if (dot <= 0) return undefined;\n  return basename.slice(dot + 1).toLowerCase();\n}\n\nfunction resolveLang(input: string): SupportedLang | null {\n  const lang = input.toLowerCase();\n  if ((SUPPORTED_LANGS as readonly string[]).includes(lang)) return lang as SupportedLang;\n  if (lang === \"shell\" || lang === \"sh\" || lang === \"zsh\") return \"bash\";\n  if (lang === \"ts\") return \"typescript\";\n  if (lang === \"js\") return \"javascript\";\n  if (lang === \"py\") return \"python\";\n  if (lang === \"yml\") return \"yaml\";\n  return null;\n}\n\nfunction resolveTheme(input: string | undefined): SupportedTheme {\n  if (input && (SUPPORTED_THEMES as readonly string[]).includes(input)) {\n    return input as SupportedTheme;\n  }\n  return DEFAULT_THEME;\n}\n\nexport async function highlightCode(\n  source: string,\n  opts: HighlightOptions,\n): Promise<string | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    return highlighter.codeToHtml(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n      ...(opts.transformers ? { transformers: opts.transformers } : {}),\n    });\n  } catch {\n    return null;\n  }\n}\n\n// A single highlighted token: its text, an optional hex `color`, and Shiki's\n// `fontStyle` bitmask (1=italic, 2=bold, 4=underline).\nexport type HighlightedToken = { content: string; color?: string; fontStyle?: number };\nexport type HighlightedLine = HighlightedToken[];\n\n// Tokenize `source` into per-line themed tokens for the renderers that paint\n// their own gutters/rows rather than embedding Shiki's `<pre>` HTML — `CodeDiff`\n// (add/remove markers) and `FrameSourceWindow` (absolute, possibly\n// non-contiguous, source line numbers). Returns null on empty source, an\n// unsupported language, or a highlighter failure — the caller then renders plain\n// text (same graceful degradation as `highlightCode`).\nexport async function highlightToLines(\n  source: string,\n  opts: HighlightOptions,\n): Promise<HighlightedLine[] | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    const { tokens } = highlighter.codeToTokens(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n    });\n    return tokens.map((line) =>\n      line.map((token) => ({\n        content: token.content,\n        ...(token.color ? { color: token.color } : {}),\n        ...(token.fontStyle ? { fontStyle: token.fontStyle } : {}),\n      })),\n    );\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/data/code-highlight.d.ts

@@ -1,9 +1,10 @@
 import { HighlighterCore } from 'shiki/core';
-type ShikiTransformersModule = typeof import("@shikijs/transformers");
 type ShikiTransformer = NonNullable<Parameters<HighlighterCore["codeToHtml"]>[1]["transformers"]>[number];
-export declare function loadShikiTransformers(): Promise<ShikiTransformersModule>;
 export type HighlightOptions = {
-    lang: string;
+    /** Highlighter language. Undefined when the caller has none, in which case
+     *  both entry points return null and the caller renders plain text — better
+     *  than guessing a grammar and mis-colouring the source. */
+    lang: string | undefined;
     theme?: string;
     transformers?: ShikiTransformer[];
 };

package/dist/data/code-highlight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-highlight.d.ts","sourceRoot":"","sources":["../../src/data/code-highlight.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,YAAY,CAAC;AAExE,KAAK,uBAAuB,GAAG,cAAc,uBAAuB,CAAC,CAAC;AACtE,KAAK,gBAAgB,GAAG,WAAW,CACjC,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAC7D,CAAC,MAAM,CAAC,CAAC;AA8DV,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAGxE;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,CAAC;AAKF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM7E;AAoBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAID,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvF,MAAM,MAAM,eAAe,GAAG,gBAAgB,EAAE,CAAC;AAMjD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAoBnC"}
+{"version":3,"file":"code-highlight.d.ts","sourceRoot":"","sources":["../../src/data/code-highlight.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,YAAY,CAAC;AAExE,KAAK,gBAAgB,GAAG,WAAW,CACjC,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAC7D,CAAC,MAAM,CAAC,CAAC;AA6DV,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;gEAE4D;IAC5D,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,CAAC;AAKF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM7E;AAoBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAID,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvF,MAAM,MAAM,eAAe,GAAG,gBAAgB,EAAE,CAAC;AAQjD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAoBnC"}

package/dist/data/code-highlight.js

@@ -18,7 +18,6 @@ const SUPPORTED_LANGS = [
 const SUPPORTED_THEMES = ["github-light", "github-dark"];
 const DEFAULT_THEME = "github-light";
 let highlighterLoad = null;
-let transformersLoad = null;
 function loadHighlighter() {
   highlighterLoad ?? (highlighterLoad = (async () => {
     const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([
@@ -51,10 +50,6 @@ function loadHighlighter() {
   })());
   return highlighterLoad;
 }
-function loadShikiTransformers() {
-  transformersLoad ?? (transformersLoad = import("@shikijs/transformers"));
-  return transformersLoad;
-}
 function languageFromPath(path) {
   if (!path) return void 0;
   const basename = path.slice(path.lastIndexOf("/") + 1);
@@ -117,7 +112,6 @@ async function highlightToLines(source, opts) {
 export {
   highlightCode,
   highlightToLines,
-  languageFromPath,
-  loadShikiTransformers
+  languageFromPath
 };
 //# sourceMappingURL=code-highlight.js.map

package/dist/data/code-highlight.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-highlight.js","sources":["../../src/data/code-highlight.ts"],"sourcesContent":["// Lazy-loaded wrapper around a Shiki *core* highlighter pre-registered with a\n// fixed language + theme set. The default `shiki` entry point bundles every\n// grammar/theme as separate dynamic imports — Vite then code-splits each into\n// its own chunk (~280 langs + 50 themes), even when only a handful are ever\n// used. Switching to `shiki/core` and registering a curated subset cuts the\n// app dist by ~6M and ~300 chunks.\n//\n// Languages are picked from what the renderer actually emits (Clicky code\n// blocks + Java stack traces). Anything outside the list silently falls back\n// to plain text — same behavior as before, just without paying for grammars\n// nobody asked for.\n\nimport type { HighlighterCore, ThemeRegistrationAny } from \"shiki/core\";\n\ntype ShikiTransformersModule = typeof import(\"@shikijs/transformers\");\ntype ShikiTransformer = NonNullable<\n  Parameters<HighlighterCore[\"codeToHtml\"]>[1][\"transformers\"]\n>[number];\n\nconst SUPPORTED_LANGS = [\n  \"java\",\n  \"go\",\n  \"python\",\n  \"javascript\",\n  \"typescript\",\n  \"tsx\",\n  \"jsx\",\n  \"json\",\n  \"yaml\",\n  \"bash\",\n  \"shell\",\n  \"sql\",\n  \"xml\",\n  \"html\",\n  \"css\",\n] as const;\n\ntype SupportedLang = (typeof SUPPORTED_LANGS)[number];\n\nconst SUPPORTED_THEMES = [\"github-light\", \"github-dark\"] as const;\ntype SupportedTheme = (typeof SUPPORTED_THEMES)[number];\nconst DEFAULT_THEME: SupportedTheme = \"github-light\";\n\nlet highlighterLoad: Promise<HighlighterCore> | null = null;\nlet transformersLoad: Promise<ShikiTransformersModule> | null = null;\n\nfunction loadHighlighter(): Promise<HighlighterCore> {\n  highlighterLoad ??= (async () => {\n    const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([\n      import(\"shiki/core\"),\n      import(\"shiki/engine/oniguruma\"),\n    ]);\n    return createHighlighterCore({\n      themes: [\n        import(\"@shikijs/themes/github-light\") as Promise<{ default: ThemeRegistrationAny }>,\n        import(\"@shikijs/themes/github-dark\") as Promise<{ default: ThemeRegistrationAny }>,\n      ],\n      langs: [\n        import(\"@shikijs/langs/java\"),\n        import(\"@shikijs/langs/go\"),\n        import(\"@shikijs/langs/python\"),\n        import(\"@shikijs/langs/javascript\"),\n        import(\"@shikijs/langs/typescript\"),\n        import(\"@shikijs/langs/tsx\"),\n        import(\"@shikijs/langs/jsx\"),\n        import(\"@shikijs/langs/json\"),\n        import(\"@shikijs/langs/yaml\"),\n        import(\"@shikijs/langs/bash\"),\n        import(\"@shikijs/langs/sql\"),\n        import(\"@shikijs/langs/xml\"),\n        import(\"@shikijs/langs/html\"),\n        import(\"@shikijs/langs/css\"),\n      ],\n      engine: createOnigurumaEngine(import(\"shiki/wasm\")),\n    });\n  })();\n  return highlighterLoad;\n}\n\nexport function loadShikiTransformers(): Promise<ShikiTransformersModule> {\n  transformersLoad ??= import(\"@shikijs/transformers\");\n  return transformersLoad;\n}\n\nexport type HighlightOptions = {\n  lang: string;\n  theme?: string;\n  transformers?: ShikiTransformer[];\n};\n\n// Derive a highlighter language hint from a file path's extension (e.g.\n// \"src/app.tsx\" → \"tsx\"). Returns undefined for extensionless paths and dotfiles;\n// `resolveLang` then maps aliases and drops anything unsupported.\nexport function languageFromPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const basename = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = basename.lastIndexOf(\".\");\n  if (dot <= 0) return undefined;\n  return basename.slice(dot + 1).toLowerCase();\n}\n\nfunction resolveLang(input: string): SupportedLang | null {\n  const lang = input.toLowerCase();\n  if ((SUPPORTED_LANGS as readonly string[]).includes(lang)) return lang as SupportedLang;\n  if (lang === \"shell\" || lang === \"sh\" || lang === \"zsh\") return \"bash\";\n  if (lang === \"ts\") return \"typescript\";\n  if (lang === \"js\") return \"javascript\";\n  if (lang === \"py\") return \"python\";\n  if (lang === \"yml\") return \"yaml\";\n  return null;\n}\n\nfunction resolveTheme(input: string | undefined): SupportedTheme {\n  if (input && (SUPPORTED_THEMES as readonly string[]).includes(input)) {\n    return input as SupportedTheme;\n  }\n  return DEFAULT_THEME;\n}\n\nexport async function highlightCode(\n  source: string,\n  opts: HighlightOptions,\n): Promise<string | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    return highlighter.codeToHtml(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n      ...(opts.transformers ? { transformers: opts.transformers } : {}),\n    });\n  } catch {\n    return null;\n  }\n}\n\n// A single highlighted token: its text, an optional hex `color`, and Shiki's\n// `fontStyle` bitmask (1=italic, 2=bold, 4=underline).\nexport type HighlightedToken = { content: string; color?: string; fontStyle?: number };\nexport type HighlightedLine = HighlightedToken[];\n\n// Tokenize `source` into per-line themed tokens for `CodeDiff`, which paints its\n// own diff gutters/rows rather than embedding Shiki's `<pre>` HTML. Returns null\n// on empty source, an unsupported language, or a highlighter failure — the caller\n// then renders plain text (same graceful degradation as `highlightCode`).\nexport async function highlightToLines(\n  source: string,\n  opts: HighlightOptions,\n): Promise<HighlightedLine[] | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    const { tokens } = highlighter.codeToTokens(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n    });\n    return tokens.map((line) =>\n      line.map((token) => ({\n        content: token.content,\n        ...(token.color ? { color: token.color } : {}),\n        ...(token.fontStyle ? { fontStyle: token.fontStyle } : {}),\n      })),\n    );\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"code-highlight.js","sources":["../../src/data/code-highlight.ts"],"sourcesContent":["// Lazy-loaded wrapper around a Shiki *core* highlighter pre-registered with a\n// fixed language + theme set. The default `shiki` entry point bundles every\n// grammar/theme as separate dynamic imports — Vite then code-splits each into\n// its own chunk (~280 langs + 50 themes), even when only a handful are ever\n// used. Switching to `shiki/core` and registering a curated subset cuts the\n// app dist by ~6M and ~300 chunks.\n//\n// Languages are picked from what the renderer actually emits (Clicky code\n// blocks + Java stack traces). Anything outside the list silently falls back\n// to plain text — same behavior as before, just without paying for grammars\n// nobody asked for.\n\nimport type { HighlighterCore, ThemeRegistrationAny } from \"shiki/core\";\n\ntype ShikiTransformer = NonNullable<\n  Parameters<HighlighterCore[\"codeToHtml\"]>[1][\"transformers\"]\n>[number];\n\nconst SUPPORTED_LANGS = [\n  \"java\",\n  \"go\",\n  \"python\",\n  \"javascript\",\n  \"typescript\",\n  \"tsx\",\n  \"jsx\",\n  \"json\",\n  \"yaml\",\n  \"bash\",\n  \"shell\",\n  \"sql\",\n  \"xml\",\n  \"html\",\n  \"css\",\n] as const;\n\ntype SupportedLang = (typeof SUPPORTED_LANGS)[number];\n\nconst SUPPORTED_THEMES = [\"github-light\", \"github-dark\"] as const;\ntype SupportedTheme = (typeof SUPPORTED_THEMES)[number];\nconst DEFAULT_THEME: SupportedTheme = \"github-light\";\n\nlet highlighterLoad: Promise<HighlighterCore> | null = null;\n\nfunction loadHighlighter(): Promise<HighlighterCore> {\n  highlighterLoad ??= (async () => {\n    const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([\n      import(\"shiki/core\"),\n      import(\"shiki/engine/oniguruma\"),\n    ]);\n    return createHighlighterCore({\n      themes: [\n        import(\"@shikijs/themes/github-light\") as Promise<{ default: ThemeRegistrationAny }>,\n        import(\"@shikijs/themes/github-dark\") as Promise<{ default: ThemeRegistrationAny }>,\n      ],\n      langs: [\n        import(\"@shikijs/langs/java\"),\n        import(\"@shikijs/langs/go\"),\n        import(\"@shikijs/langs/python\"),\n        import(\"@shikijs/langs/javascript\"),\n        import(\"@shikijs/langs/typescript\"),\n        import(\"@shikijs/langs/tsx\"),\n        import(\"@shikijs/langs/jsx\"),\n        import(\"@shikijs/langs/json\"),\n        import(\"@shikijs/langs/yaml\"),\n        import(\"@shikijs/langs/bash\"),\n        import(\"@shikijs/langs/sql\"),\n        import(\"@shikijs/langs/xml\"),\n        import(\"@shikijs/langs/html\"),\n        import(\"@shikijs/langs/css\"),\n      ],\n      engine: createOnigurumaEngine(import(\"shiki/wasm\")),\n    });\n  })();\n  return highlighterLoad;\n}\n\nexport type HighlightOptions = {\n  /** Highlighter language. Undefined when the caller has none, in which case\n   *  both entry points return null and the caller renders plain text — better\n   *  than guessing a grammar and mis-colouring the source. */\n  lang: string | undefined;\n  theme?: string;\n  transformers?: ShikiTransformer[];\n};\n\n// Derive a highlighter language hint from a file path's extension (e.g.\n// \"src/app.tsx\" → \"tsx\"). Returns undefined for extensionless paths and dotfiles;\n// `resolveLang` then maps aliases and drops anything unsupported.\nexport function languageFromPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const basename = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = basename.lastIndexOf(\".\");\n  if (dot <= 0) return undefined;\n  return basename.slice(dot + 1).toLowerCase();\n}\n\nfunction resolveLang(input: string): SupportedLang | null {\n  const lang = input.toLowerCase();\n  if ((SUPPORTED_LANGS as readonly string[]).includes(lang)) return lang as SupportedLang;\n  if (lang === \"shell\" || lang === \"sh\" || lang === \"zsh\") return \"bash\";\n  if (lang === \"ts\") return \"typescript\";\n  if (lang === \"js\") return \"javascript\";\n  if (lang === \"py\") return \"python\";\n  if (lang === \"yml\") return \"yaml\";\n  return null;\n}\n\nfunction resolveTheme(input: string | undefined): SupportedTheme {\n  if (input && (SUPPORTED_THEMES as readonly string[]).includes(input)) {\n    return input as SupportedTheme;\n  }\n  return DEFAULT_THEME;\n}\n\nexport async function highlightCode(\n  source: string,\n  opts: HighlightOptions,\n): Promise<string | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    return highlighter.codeToHtml(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n      ...(opts.transformers ? { transformers: opts.transformers } : {}),\n    });\n  } catch {\n    return null;\n  }\n}\n\n// A single highlighted token: its text, an optional hex `color`, and Shiki's\n// `fontStyle` bitmask (1=italic, 2=bold, 4=underline).\nexport type HighlightedToken = { content: string; color?: string; fontStyle?: number };\nexport type HighlightedLine = HighlightedToken[];\n\n// Tokenize `source` into per-line themed tokens for the renderers that paint\n// their own gutters/rows rather than embedding Shiki's `<pre>` HTML — `CodeDiff`\n// (add/remove markers) and `FrameSourceWindow` (absolute, possibly\n// non-contiguous, source line numbers). Returns null on empty source, an\n// unsupported language, or a highlighter failure — the caller then renders plain\n// text (same graceful degradation as `highlightCode`).\nexport async function highlightToLines(\n  source: string,\n  opts: HighlightOptions,\n): Promise<HighlightedLine[] | null> {\n  if (!source || !opts.lang) return null;\n  const lang = resolveLang(opts.lang);\n  if (!lang) return null;\n  try {\n    const highlighter = await loadHighlighter();\n    const { tokens } = highlighter.codeToTokens(source, {\n      lang,\n      theme: resolveTheme(opts.theme),\n    });\n    return tokens.map((line) =>\n      line.map((token) => ({\n        content: token.content,\n        ...(token.color ? { color: token.color } : {}),\n        ...(token.fontStyle ? { fontStyle: token.fontStyle } : {}),\n      })),\n    );\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}

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":";;;;;AAuFO,MAAM,iCAAiC;AA4CvC,SAAS,gCACd,SACsB;AACtB,SAAO,QAAQ,IAAI,CAAC,QAAQ,WAAW;AAAA,IACrC,KAAK,OAAO,SAAS,KAAK,UAAU,KAAK,KAAK,OAAO;AAAA,IACrD,OAAO,OAAO,SAASA,eAAAA,YAAY,OAAO,IAAI;AAAA,IAC9C,UAAU,CAAC,QAAW,IAAI,OAAO,IAAI;AAAA,IACrC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAI,OAAO,SAAS,SAAY,EAAE,MAAM,OAAO,KAAA,IAAS,CAAA;AAAA,IACxD,GAAI,OAAO,cAAc,SAAY,EAAE,WAAW,OAAO,cAAc,CAAA;AAAA,EAAC,EACxE;AACJ;AAcO,SAAS,yBACd,SACA,QACA,WACA,UAAkC,CAAA,GACd;AACpB,QAAM,SAA6B,EAAE,SAAS,GAAC;AAC/C,QAAM,8BAAc,IAAA;AAEpB,aAAW,UAAU,SAAS;AAC5B,UAAM,SAAS,OAAO;AACtB,QAAI,CAAC,OAAQ;AACb,UAAM,YAAY,OAAO;AACzB,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,UAAU,OAAO,IAAI,sDAAsD;AAAA,IAC7F;AACA,UAAM,QAAQ,QAAQ,IAAI,SAAS;AACnC,QAAI,UAAU,QAAW;AACvB,YAAM,IAAI;AAAA,QACR,WAAW,KAAK,QAAQ,OAAO,IAAI,wBAAwB,SAAS;AAAA,MAAA;AAAA,IAExE;AACA,YAAQ,IAAI,WAAW,OAAO,IAAI;AAElC,UAAM,QAAQ,OAAO,SAASA,eAAAA,YAAY,OAAO,IAAI;AAMrD,QAAI,OAAO,SAAS,UAAU,CAAC,OAAO,WAAW;AAC/C,aAAO,YAAY,eAAe,WAAW,QAAQ,QAAQ,SAAS;AACtE;AAAA,IACF;AACA,WAAO,QAAQ;AAAA,MACbC,eAAAA;AAAAA,QACE,YAAY,EAAU,WAAW,OAAO,QAAQ,QAAQ,WAAW,SAAS;AAAA,QAC5E,QAAQ;AAAA,MAAA;AAAA,IACV;AAAA,EAEJ;AACA,SAAO;AACT;AAYA,SAAS,YAAY,MAAkC;AACrD,QAAM,EAAE,WAAW,OAAO,QAAQ,QAAQ,cAAc;AACxD,QAAM,MAAM,OAAO,SAAS,KAAK;AACjC,QAAM,QAAQ,CAAC,eACb,UAAU,CAAC,YAAYC,sBAAAA,sBAAsB,SAAS,WAAW,UAAU,CAAC;AAC9E,QAAM,SAAS;AAAA,IACb,KAAK;AAAA,IACL;AAAA,IACA,GAAI,OAAO,gBAAgB,SAAY,EAAE,aAAa,OAAO,YAAA,IAAgB,CAAA;AAAA,IAC7E,GAAI,OAAO,aAAa,SAAY,EAAE,UAAU,OAAO,aAAa,CAAA;AAAA,EAAC;AAGvE,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,QACN,GAAG,cAAcC,uCAAiB,GAAG,CAAC;AAAA,QACtC,SAAS,CAAC,MAAc,OACtB,MAAMC,sBAAAA,qBAAqB,EAAE,KAAK,MAAM,KAAK,GAAA,CAAI,CAAC;AAAA,QACpD,GAAI,OAAO,YAAY,SAAY,EAAE,SAAS,OAAO,QAAA,IAAY,CAAA;AAAA,QACjE,aAAa;AAAA,MAAA;AAAA,IAEjB,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,QACN,OAAOD,sBAAAA,iBAAiB,GAAG;AAAA,QAC3B,UAAU,CAAC,SAA+B,MAAMC,sBAAAA,qBAAqB,IAAI,CAAC;AAAA,QAC1E,GAAI,OAAO,QAAQ,SAAY,EAAE,WAAW,OAAO,IAAA,IAAQ,CAAA;AAAA,QAC3D,GAAI,OAAO,QAAQ,SAAY,EAAE,WAAW,OAAO,IAAA,IAAQ,CAAA;AAAA,QAC3D,GAAI,OAAO,SAAS,SAAY,EAAE,MAAM,OAAO,SAAS,CAAA;AAAA,MAAC;AAAA,IAE7D,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,QACN,OAAO,QAAQ,KAAK,SAAY,QAAQ;AAAA,QACxC,UAAU,CAAC,SAAmB,MAAM,SAAS,SAAY,KAAK,OAAO,IAAI,CAAC;AAAA,MAAA;AAAA,IAE9E,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,QACN,OAAO;AAAA,QACP,UAAU,CAAC,SAAiB,MAAM,IAAI;AAAA,MAAA;AAAA,IAE1C;AACE,aAAO,iBAAiB,MAAM,QAAQ,KAAK,KAAK;AAAA,EAAA;AAEtD;AAEA,SAAS,iBACP,EAAE,QAAQ,WACV,QACA,KACA,OACiB;;AACjB,QAAM,eAAe,QAAQ;AAK7B,MAAI,CAAC,OAAO,aAAW,YAAO,YAAP,mBAAgB,WAAU,OAAO,GAAG;AACzD,WAAO,EAAE,GAAG,QAAQ,MAAM,QAAQ,OAAO,KAAK,UAAU,CAAC,SAAiB,MAAM,IAAI,EAAA;AAAA,EACtF;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,IACN,OAAOC,sBAAAA,sBAAsB,GAAG;AAAA,IAChC,UAAU,CAAC,SAAS,MAAMC,sBAAAA,0BAA0B,IAAI,CAAC;AAAA,IACzD,UAAU,OAAO,WAAW,CAAA,GAAI,IAAI,mBAAmB;AAAA,IACvD,GAAI,OAAO,cAAc,SAAY,EAAE,WAAW,OAAO,UAAA,IAAc,CAAA;AAAA,IACvE,GAAI,OAAO,UAAU,SAAY,EAAE,OAAO,OAAO,MAAA,IAAU,CAAA;AAAA;AAAA;AAAA,IAG3D,GAAI,gBAAgB,OAAO,SACvB;AAAA,MACE,UAAU,OAAO,WAAmB;AAClC,cAAM,SAAS,MAAM,aAAa;AAAA,UAChC,WAAW,OAAO;AAAA,UAClB;AAAA,UACA,OAAO;AAAA,QAAA,CACR;AACD,eAAO,OAAO,QAAQ,IAAI,mBAAmB;AAAA,MAC/C;AAAA,IAAA,IAEF,CAAA;AAAA,EAAC;AAET;AAEA,SAAS,eACP,WACA,QACA,QACA,WACqB;AACrB,SAAO;AAAA,IACL,GAAG,cAAcH,sBAAAA,iBAAiB,OAAO,SAAS,KAAK,EAAE,CAAC;AAAA,IAC1D,SAAS,CAAC,MAAM,OACd;AAAA,MAAU,CAAC,YACTD,sBAAAA,sBAAsB,SAAS,WAAWE,sBAAAA,qBAAqB,EAAE,KAAK,MAAM,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,IAE1F,GAAI,OAAO,YAAY,SAAY,EAAE,SAAS,OAAO,QAAA,IAAY,CAAA;AAAA,IACjE,aAAa;AAAA,EAAA;AAEjB;AAGA,SAAS,cAAc,QAA2D;AAChF,SAAO;AAAA,IACL,GAAI,OAAO,QAAQ,SAAY,EAAE,MAAM,OAAO,IAAA,IAAQ,CAAA;AAAA,IACtD,GAAI,OAAO,QAAQ,SAAY,EAAE,IAAI,OAAO,QAAQ,CAAA;AAAA,EAAC;AAEzD;AAEA,SAAS,oBAAoB,QAAkD;AAC7E,QAAM,QAAQ,OAAO,SAAS,OAAO;AACrC,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd;AAAA,IACA,GAAI,OAAO,UAAU,SAAY,EAAE,OAAO,GAAG,KAAK,MAAM,OAAO,MAAM,eAAA,CAAgB,GAAA,IAAO,CAAA;AAAA,EAAC;AAEjG;AAOO,SAAS,2BAA2B,OAMlC;AACP,MAAI,MAAM,cAAc,MAAM,cAAc;AAC1C,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,MACE,MAAM,gBACN,MAAM,oBACN,CAAC,MAAM,0BACP,CAAC,MAAM,mBACP;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;;;;;"}
+{"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,