@flanksource/clicky-ui 0.3.17 → 0.3.19

package/dist/data/data-table-filter-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-values.js","sources":["../../src/data/data-table-filter-values.ts"],"sourcesContent":["import type { FilterBarMultiFilterMode } from \"../components/filter-bar-field-utils\";\n\n/**\n * A filter selection as one flat, URL-safe record: filter key → comma-joined\n * values, each optionally `!`-prefixed to exclude. It is the one encoding the\n * profile catalog (which syncs it to the URL) and the ad-hoc query browser both\n * speak, so a selection means the same thing wherever it is read.\n */\nexport type DataTableFilterSelection = Record<string, string>;\n\n// The serialized multi-filter value is a wire contract, not internal state: it\n// is packed into a query parameter and parsed server-side by clicky's\n// `entity.MultiFilter` (collections.MatchItems semantics — `,` separates\n// patterns, a leading `!` negates). That grammar has no escape sequence, so a\n// value that itself starts with `!` or contains `,` cannot be expressed on the\n// wire at all. Backslash escapes below therefore only ever apply to values the\n// server could never represent, leaving every representable value byte\n// identical, while making the local parse/serialize pair lossless so an\n// *included* \"!failed\" is not read back as an *exclusion* of \"failed\" on the\n// next render.\n//\n// WORKAROUND(no-server-escape-syntax): the escapes are understood by this\n// module only; a backslash sent to the server is matched literally.\n// Correct fix: teach entity.MultiFilter / collections.MatchItems an escape\n// sequence, then drop this note.\n// Ref: PR review, discussed with user 2026-08-05\n//\n// Grammar: `\\\\`, `\\!`, `\\,` and `\\<whitespace>` decode to the bare character; a\n// backslash before anything else is literal. Unescaped whitespace around an\n// item is trimmed (hand-edited URLs), unescaped `,` separates items, and an\n// unescaped leading `!` marks an exclusion. Empty keys are not representable\n// and are dropped.\ntype MultiFilterChar = { char: string; escaped: boolean };\n\nfunction isMultiFilterEscapable(char: string) {\n  return char === \"\\\\\" || char === \"!\" || char === \",\" || /\\s/.test(char);\n}\n\nfunction isUnescapedSpace(entry: MultiFilterChar) {\n  return !entry.escaped && /\\s/.test(entry.char);\n}\n\nfunction splitMultiFilterItems(value: string): MultiFilterChar[][] {\n  const items: MultiFilterChar[][] = [[]];\n  for (let index = 0; index < value.length; index++) {\n    const char = value[index]!;\n    const next = value[index + 1];\n    if (char === \"\\\\\" && next !== undefined && isMultiFilterEscapable(next)) {\n      items[items.length - 1]!.push({ char: next, escaped: true });\n      index++;\n    } else if (char === \",\") {\n      items.push([]);\n    } else {\n      items[items.length - 1]!.push({ char, escaped: false });\n    }\n  }\n  return items.map((item) => {\n    let start = 0;\n    let end = item.length;\n    while (start < end && isUnescapedSpace(item[start]!)) start++;\n    while (end > start && isUnescapedSpace(item[end - 1]!)) end--;\n    return item.slice(start, end);\n  });\n}\n\nexport function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode> {\n  const parsed: Record<string, FilterBarMultiFilterMode> = {};\n  for (const item of splitMultiFilterItems(value)) {\n    if (item.length === 0) continue;\n    const excluded = item.length > 1 && item[0]!.char === \"!\" && !item[0]!.escaped;\n    const key = (excluded ? item.slice(1) : item).map((entry) => entry.char).join(\"\");\n    if (key) parsed[key] = excluded ? \"exclude\" : \"include\";\n  }\n  return parsed;\n}\n\nfunction escapeMultiFilterKey(key: string): string {\n  let escaped = \"\";\n  for (let index = 0; index < key.length; index++) {\n    const char = key[index]!;\n    const isBoundary = index === 0 || index === key.length - 1;\n    if (char === \",\") {\n      escaped += \"\\\\,\";\n    } else if (char === \"\\\\\" && isMultiFilterEscapable(key[index + 1] ?? \"\")) {\n      escaped += \"\\\\\\\\\";\n    } else if (isBoundary && /\\s/.test(char)) {\n      escaped += `\\\\${char}`;\n    } else {\n      escaped += char;\n    }\n  }\n  return escaped;\n}\n\nexport function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (!key) return [];\n      const escaped = escapeMultiFilterKey(key);\n      if (mode === \"include\") return [key.startsWith(\"!\") ? `\\\\${escaped}` : escaped];\n      if (mode === \"exclude\") return [`!${escaped}`];\n      return [];\n    })\n    .join(\",\");\n}\n\nexport function splitCommaValues(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * A bounded selection: both edges under one key, each token carrying its own\n * comparison operator. It is the other half of the selection grammar, and the\n * one a range and a time bound share.\n */\nexport type FilterBoundsValue = {\n  min?: string;\n  max?: string;\n};\n\n/**\n * Reads a bounded selection. The bar's controls are inclusive on both edges, so\n * that is what they write back — but a bound typed by hand or arriving in a URL\n * keeps whatever operator it came with.\n */\nexport function parseBoundsValue(raw: string): FilterBoundsValue {\n  const bounds: FilterBoundsValue = {};\n  for (const token of raw.split(\",\")) {\n    const trimmed = token.trim();\n    if (trimmed.startsWith(\">\")) {\n      bounds.min = trimmed.replace(/^>=?/, \"\");\n    } else if (trimmed.startsWith(\"<\")) {\n      bounds.max = trimmed.replace(/^<=?/, \"\");\n    }\n  }\n  return bounds;\n}\n\nexport function serializeBoundsValue(value: FilterBoundsValue): string {\n  const tokens: string[] = [];\n  if (value.min) tokens.push(`>=${value.min}`);\n  if (value.max) tokens.push(`<=${value.max}`);\n  return tokens.join(\",\");\n}\n\n/**\n * Writes a serialized value into a selection, dropping the key when it is\n * empty. An absent key and a key holding \"\" would send different query strings\n * for the same \"nothing selected\", so only one of them is ever built.\n */\nexport function updateFilterSelection(\n  selection: DataTableFilterSelection,\n  key: string,\n  serialized: string,\n): DataTableFilterSelection {\n  const next = { ...selection };\n  if (serialized) {\n    next[key] = serialized;\n  } else {\n    delete next[key];\n  }\n  return next;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const filterBarUtils = require("../components/filter-bar-utils.cjs");
+const dataTableFilterValues = require("./data-table-filter-values.cjs");
+const dataTableUtils = require("./data-table-utils.cjs");
+const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;
+function serverColumnsToDataTableColumns(columns) {
+  return columns.map((column, index) => ({
+    key: column.name === "" ? `column-${index}` : column.name,
+    label: column.label ?? dataTableUtils.prettifyKey(column.name),
+    accessor: (row) => row[column.name],
+    sortable: true,
+    filterable: false,
+    ...column.kind !== void 0 ? { kind: column.kind } : {},
+    ...column.filterKey !== void 0 ? { filterKey: column.filterKey } : {}
+  }));
+}
+function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
+  const config = { filters: [] };
+  const claimed = /* @__PURE__ */ new Map();
+  for (const column of columns) {
+    const filter = column.filter;
+    if (!filter) continue;
+    const filterKey = column.filterKey;
+    if (!filterKey) {
+      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);
+    }
+    const owner = claimed.get(filterKey);
+    if (owner !== void 0) {
+      throw new Error(
+        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`
+      );
+    }
+    claimed.set(filterKey, column.name);
+    const label = column.label ?? dataTableUtils.prettifyKey(column.name);
+    if (filter.kind === "time" && !config.timeRange) {
+      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);
+      continue;
+    }
+    config.filters.push(
+      filterBarUtils.applyFilterExtensions(
+        buildFilter({ filterKey, label, filter, values, setValues, options }),
+        options.extensions
+      )
+    );
+  }
+  return config;
+}
+function buildFilter(args) {
+  const { filterKey, label, filter, values, setValues } = args;
+  const raw = values[filterKey] ?? "";
+  const write = (serialized) => setValues((current) => dataTableFilterValues.updateFilterSelection(current, filterKey, serialized));
+  const shared = {
+    key: filterKey,
+    label,
+    ...filter.description !== void 0 ? { description: filter.description } : {},
+    ...filter.disabled !== void 0 ? { disabled: filter.disabled } : {}
+  };
+  switch (filter.kind) {
+    case "time":
+      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
+      };
+    case "range":
+      return {
+        ...shared,
+        kind: "number",
+        value: dataTableFilterValues.parseBoundsValue(raw),
+        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 } : {}
+      };
+    case "boolean":
+      return {
+        ...shared,
+        kind: "tristate",
+        value: raw === "" ? void 0 : raw === "true",
+        onChange: (next) => write(next === void 0 ? "" : String(next))
+      };
+    case "text":
+      return {
+        ...shared,
+        kind: "text",
+        value: raw,
+        onChange: (next) => write(next)
+      };
+    default:
+      return buildTermsFilter(args, shared, raw, write);
+  }
+}
+function buildTermsFilter({ filter, options }, shared, raw, write) {
+  var _a;
+  const lookupValues = options.lookupValues;
+  if (!filter.lookup && (((_a = filter.options) == null ? void 0 : _a.length) ?? 0) === 0) {
+    return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
+  }
+  return {
+    ...shared,
+    kind: "multi",
+    value: dataTableFilterValues.parseMultiFilterValue(raw),
+    onChange: (next) => write(dataTableFilterValues.serializeMultiFilterValue(next)),
+    options: (filter.options ?? []).map(toMultiSelectOption),
+    ...filter.truncated !== void 0 ? { truncated: filter.truncated } : {},
+    ...filter.total !== void 0 ? { total: filter.total } : {},
+    // The field owns the in-flight flag from the promise this returns, so no
+    // `loading` is passed: a second source of truth for it could disagree.
+    ...lookupValues && filter.lookup ? {
+      onSearch: async (search) => {
+        const result = await lookupValues({
+          filterKey: shared.key,
+          search,
+          limit: DATA_TABLE_FILTER_LOOKUP_LIMIT
+        });
+        return result.options.map(toMultiSelectOption);
+      }
+    } : {}
+  };
+}
+function buildTimeRange(filterKey, filter, values, setValues) {
+  return {
+    ...boundsToRange(dataTableFilterValues.parseBoundsValue(values[filterKey] ?? "")),
+    onApply: (from, to) => setValues(
+      (current) => dataTableFilterValues.updateFilterSelection(current, filterKey, dataTableFilterValues.serializeBoundsValue({ min: from, max: to }))
+    ),
+    ...filter.presets !== void 0 ? { presets: filter.presets } : {},
+    timeEnabled: true
+  };
+}
+function boundsToRange(bounds) {
+  return {
+    ...bounds.min !== void 0 ? { from: bounds.min } : {},
+    ...bounds.max !== void 0 ? { to: bounds.max } : {}
+  };
+}
+function toMultiSelectOption(option) {
+  const label = option.label ?? option.value;
+  return {
+    value: option.value,
+    label,
+    ...option.count !== void 0 ? { title: `${label} · ${option.count.toLocaleString()}` } : {}
+  };
+}
+function assertDataTableFilterProps(props) {
+  if (props.autoFilter && props.manualFilter) {
+    throw new Error(
+      "DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead."
+    );
+  }
+  if (props.manualFilter && props.showGlobalFilter && !props.globalFilterControlled && !props.hasExternalSearch) {
+    throw new Error(
+      "DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source."
+    );
+  }
+}
+exports.DATA_TABLE_FILTER_LOOKUP_LIMIT = DATA_TABLE_FILTER_LOOKUP_LIMIT;
+exports.assertDataTableFilterProps = assertDataTableFilterProps;
+exports.serverColumnsToDataTableColumns = serverColumnsToDataTableColumns;
+exports.serverFiltersToFilterBar = serverFiltersToFilterBar;
+//# sourceMappingURL=data-table-server-filters.cjs.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,128 @@
+import { Dispatch, SetStateAction } from 'react';
+import { FilterBarFilter, FilterBarRangePreset, FilterBarRangeProps } from '../components/FilterBar';
+import { FilterExtension } from '../components/filter-bar-utils';
+import { DataTableColumn, DataTableColumnKind } from './DataTable';
+import { DataTableFilterSelection } from './data-table-filter-values';
+/**
+ * Which control a filter renders as.
+ *
+ * Deliberately opaque: "terms" is not "a SQL IN() or an OpenSearch terms
+ * query", it is "a set of discrete values the user includes or excludes". The
+ * source compiles the selection; nothing about how it does so crosses into the
+ * browser.
+ */
+export type DataTableFilterKind = "terms" | "range" | "time" | "boolean" | "text";
+export type DataTableFilterOption = {
+    /** Value written into the selection. */
+    value: string;
+    /** Display label. Falls back to `value`. */
+    label?: string;
+    /** How many rows carry this value, shown as a tooltip. */
+    count?: number;
+};
+export type DataTableColumnFilter = {
+    kind: DataTableFilterKind;
+    /** Head of the option set for kind:"terms". Empty relies on `lookup`. */
+    options?: DataTableFilterOption[];
+    /** True when `options` is a capped head of a larger set. */
+    truncated?: boolean;
+    /** Distinct count behind a truncated head; drives the "… and N more" hint. */
+    total?: number;
+    /** The source can answer a type-ahead for this filter. */
+    lookup?: boolean;
+    /** Slider domain for kind:"range". */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Range presets for kind:"time". */
+    presets?: FilterBarRangePreset[];
+    /** Helper text shown in the filter popover. */
+    description?: string;
+    disabled?: boolean;
+};
+/**
+ * A result column as the source describes it: how to render it, and — when the
+ * source can narrow on it — which filter parameter it binds to and what control
+ * that filter is.
+ *
+ * `filterKey` need not equal `name`: an analyzed text field filters through an
+ * exact-value sibling, and a computed column filters by the alias it was given.
+ */
+export type DataTableServerColumn = {
+    /** Field name as the source knows it; also the literal row key. */
+    name: string;
+    /** Header label. Defaults to a prettified `name`. */
+    label?: string;
+    /** Backend type string, verbatim (e.g. "TIMESTAMPTZ", "keyword"). Display only. */
+    databaseType?: string;
+    /** Cell rendering kind. */
+    kind?: DataTableColumnKind;
+    /** Filter parameter this column narrows on. Absent means not filterable. */
+    filterKey?: string;
+    /** The control the filter renders as. Absent means not filterable. */
+    filter?: DataTableColumnFilter;
+};
+/** Head-set size for a filter value type-ahead. */
+export declare const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;
+export type DataTableFilterLookupRequest = {
+    /** Which filter is being searched — the column's `filterKey`. */
+    filterKey: string;
+    /** What the user typed. Empty asks for the head of the set. */
+    search: string;
+    /** How many options to return. */
+    limit: number;
+};
+export type DataTableFilterLookupResult = {
+    options: DataTableFilterOption[];
+};
+/**
+ * Answers a filter's value type-ahead. Sync or async — a static option source
+ * returns an array, a server-backed one a promise.
+ */
+export type DataTableFilterLookup = (request: DataTableFilterLookupRequest) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;
+export type ServerFilterBarOptions = {
+    /** Answers a terms type-ahead for filters whose `lookup` is set. */
+    lookupValues?: DataTableFilterLookup;
+    /** Decorators applied to each built filter (icons, relabelling). */
+    extensions?: FilterExtension[];
+};
+export type ServerFilterConfig = {
+    filters: FilterBarFilter[];
+    /** Present when exactly one column declared kind:"time". */
+    timeRange?: FilterBarRangeProps;
+};
+/**
+ * Turns the source's column description into DataTable columns.
+ *
+ * Every column gets a literal `accessor` — a raw result set has empty, dotted
+ * and colliding names, none of which survive being read as a path — and
+ * `filterable: false`, because a described result is filtered by the source and
+ * never by cardinality guessed from one page.
+ */
+export declare function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(columns: DataTableServerColumn[]): DataTableColumn<T>[];
+/**
+ * Builds the FilterBar controls for a described result, already wired to
+ * `values`/`setValues`.
+ *
+ * Pure — it holds no state and fetches nothing; a `lookup` filter closes over
+ * the caller's loader. Pass the result as DataTable's `externalFilters`
+ * together with `manualFilter`, since the source has already applied it.
+ *
+ * Throws when a column declares a filter it cannot address: no `filterKey`, a
+ * `filterKey` another column already claimed, or a second time range. Each
+ * would bind a control to a filter that means something else.
+ */
+export declare function serverFiltersToFilterBar(columns: DataTableServerColumn[], values: DataTableFilterSelection, setValues: Dispatch<SetStateAction<DataTableFilterSelection>>, options?: ServerFilterBarOptions): ServerFilterConfig;
+/**
+ * Refuses a DataTable that would filter twice or offer a control wired to
+ * nothing. Both are silent in a running table — rows narrow more than the user
+ * asked, or a box swallows what they type — so they are refused at the seam.
+ */
+export declare function assertDataTableFilterProps(props: {
+    autoFilter: boolean;
+    manualFilter: boolean;
+    showGlobalFilter: boolean;
+    globalFilterControlled: boolean;
+    hasExternalSearch: boolean;
+}): void;
+//# sourceMappingURL=data-table-server-filters.d.ts.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,165 @@
+import { applyFilterExtensions } from "../components/filter-bar-utils.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;
+function serverColumnsToDataTableColumns(columns) {
+  return columns.map((column, index) => ({
+    key: column.name === "" ? `column-${index}` : column.name,
+    label: column.label ?? prettifyKey(column.name),
+    accessor: (row) => row[column.name],
+    sortable: true,
+    filterable: false,
+    ...column.kind !== void 0 ? { kind: column.kind } : {},
+    ...column.filterKey !== void 0 ? { filterKey: column.filterKey } : {}
+  }));
+}
+function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
+  const config = { filters: [] };
+  const claimed = /* @__PURE__ */ new Map();
+  for (const column of columns) {
+    const filter = column.filter;
+    if (!filter) continue;
+    const filterKey = column.filterKey;
+    if (!filterKey) {
+      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);
+    }
+    const owner = claimed.get(filterKey);
+    if (owner !== void 0) {
+      throw new Error(
+        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`
+      );
+    }
+    claimed.set(filterKey, column.name);
+    const label = column.label ?? prettifyKey(column.name);
+    if (filter.kind === "time" && !config.timeRange) {
+      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);
+      continue;
+    }
+    config.filters.push(
+      applyFilterExtensions(
+        buildFilter({ filterKey, label, filter, values, setValues, options }),
+        options.extensions
+      )
+    );
+  }
+  return config;
+}
+function buildFilter(args) {
+  const { filterKey, label, filter, values, setValues } = args;
+  const raw = values[filterKey] ?? "";
+  const write = (serialized) => setValues((current) => updateFilterSelection(current, filterKey, serialized));
+  const shared = {
+    key: filterKey,
+    label,
+    ...filter.description !== void 0 ? { description: filter.description } : {},
+    ...filter.disabled !== void 0 ? { disabled: filter.disabled } : {}
+  };
+  switch (filter.kind) {
+    case "time":
+      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
+      };
+    case "range":
+      return {
+        ...shared,
+        kind: "number",
+        value: parseBoundsValue(raw),
+        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 } : {}
+      };
+    case "boolean":
+      return {
+        ...shared,
+        kind: "tristate",
+        value: raw === "" ? void 0 : raw === "true",
+        onChange: (next) => write(next === void 0 ? "" : String(next))
+      };
+    case "text":
+      return {
+        ...shared,
+        kind: "text",
+        value: raw,
+        onChange: (next) => write(next)
+      };
+    default:
+      return buildTermsFilter(args, shared, raw, write);
+  }
+}
+function buildTermsFilter({ filter, options }, shared, raw, write) {
+  var _a;
+  const lookupValues = options.lookupValues;
+  if (!filter.lookup && (((_a = filter.options) == null ? void 0 : _a.length) ?? 0) === 0) {
+    return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
+  }
+  return {
+    ...shared,
+    kind: "multi",
+    value: parseMultiFilterValue(raw),
+    onChange: (next) => write(serializeMultiFilterValue(next)),
+    options: (filter.options ?? []).map(toMultiSelectOption),
+    ...filter.truncated !== void 0 ? { truncated: filter.truncated } : {},
+    ...filter.total !== void 0 ? { total: filter.total } : {},
+    // The field owns the in-flight flag from the promise this returns, so no
+    // `loading` is passed: a second source of truth for it could disagree.
+    ...lookupValues && filter.lookup ? {
+      onSearch: async (search) => {
+        const result = await lookupValues({
+          filterKey: shared.key,
+          search,
+          limit: DATA_TABLE_FILTER_LOOKUP_LIMIT
+        });
+        return result.options.map(toMultiSelectOption);
+      }
+    } : {}
+  };
+}
+function buildTimeRange(filterKey, filter, values, setValues) {
+  return {
+    ...boundsToRange(parseBoundsValue(values[filterKey] ?? "")),
+    onApply: (from, to) => setValues(
+      (current) => updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to }))
+    ),
+    ...filter.presets !== void 0 ? { presets: filter.presets } : {},
+    timeEnabled: true
+  };
+}
+function boundsToRange(bounds) {
+  return {
+    ...bounds.min !== void 0 ? { from: bounds.min } : {},
+    ...bounds.max !== void 0 ? { to: bounds.max } : {}
+  };
+}
+function toMultiSelectOption(option) {
+  const label = option.label ?? option.value;
+  return {
+    value: option.value,
+    label,
+    ...option.count !== void 0 ? { title: `${label} · ${option.count.toLocaleString()}` } : {}
+  };
+}
+function assertDataTableFilterProps(props) {
+  if (props.autoFilter && props.manualFilter) {
+    throw new Error(
+      "DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead."
+    );
+  }
+  if (props.manualFilter && props.showGlobalFilter && !props.globalFilterControlled && !props.hasExternalSearch) {
+    throw new Error(
+      "DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source."
+    );
+  }
+}
+export {
+  DATA_TABLE_FILTER_LOOKUP_LIMIT,
+  assertDataTableFilterProps,
+  serverColumnsToDataTableColumns,
+  serverFiltersToFilterBar
+};
+//# sourceMappingURL=data-table-server-filters.js.map

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

@@ -0,0 +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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"}