@flanksource/clicky-ui 0.3.16 → 0.3.18

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

@@ -0,0 +1,171 @@
+"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") {
+      if (config.timeRange) {
+        throw new Error(
+          `Columns ${claimed.get(filterKey)} and ${column.name} both declare a time range; the filter bar has one`
+        );
+      }
+      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 "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) {
+  const lookupValues = options.lookupValues;
+  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) {
+  const bounds = parseBoundsValue(values[filterKey] ?? "");
+  return {
+    ...bounds.min !== void 0 ? { from: bounds.min } : {},
+    ...bounds.max !== void 0 ? { to: bounds.max } : {},
+    onApply: (from, to) => setValues(
+      (current) => dataTableFilterValues.updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to }))
+    ),
+    ...filter.presets !== void 0 ? { presets: filter.presets } : {},
+    timeEnabled: true
+  };
+}
+function parseBoundsValue(raw) {
+  const bounds = {};
+  for (const token of raw.split(",")) {
+    const trimmed = token.trim();
+    if (trimmed.startsWith(">")) {
+      bounds.min = trimmed.replace(/^>=?/, "");
+    } else if (trimmed.startsWith("<")) {
+      bounds.max = trimmed.replace(/^<=?/, "");
+    }
+  }
+  return bounds;
+}
+function serializeBoundsValue(value) {
+  const tokens = [];
+  if (value.min) tokens.push(`>=${value.min}`);
+  if (value.max) tokens.push(`<=${value.max}`);
+  return tokens.join(",");
+}
+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  parseMultiFilterValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\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    if (filter.kind === \"time\") {\n      if (config.timeRange) {\n        throw new Error(\n          `Columns ${claimed.get(filterKey)} and ${column.name} both declare a time range; the filter bar has one`,\n        );\n      }\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 \"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  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  const bounds = parseBoundsValue(values[filterKey] ?? \"\");\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\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/**\n * Reads the bounded half of the selection grammar: comma-separated tokens, each\n * carrying its own comparison operator. The bar's controls are inclusive on\n * both edges, so that is what they write back — but a bound typed by hand or\n * arriving in a URL keeps whatever operator it came with.\n */\nfunction parseBoundsValue(raw: string): FilterBarNumberValue {\n  const bounds: FilterBarNumberValue = {};\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\nfunction serializeBoundsValue(value: FilterBarNumberValue): 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\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","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,171 @@
+import { applyFilterExtensions } from "../components/filter-bar-utils.js";
+import { updateFilterSelection, 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") {
+      if (config.timeRange) {
+        throw new Error(
+          `Columns ${claimed.get(filterKey)} and ${column.name} both declare a time range; the filter bar has one`
+        );
+      }
+      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 "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) {
+  const lookupValues = options.lookupValues;
+  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) {
+  const bounds = parseBoundsValue(values[filterKey] ?? "");
+  return {
+    ...bounds.min !== void 0 ? { from: bounds.min } : {},
+    ...bounds.max !== void 0 ? { to: bounds.max } : {},
+    onApply: (from, to) => setValues(
+      (current) => updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to }))
+    ),
+    ...filter.presets !== void 0 ? { presets: filter.presets } : {},
+    timeEnabled: true
+  };
+}
+function parseBoundsValue(raw) {
+  const bounds = {};
+  for (const token of raw.split(",")) {
+    const trimmed = token.trim();
+    if (trimmed.startsWith(">")) {
+      bounds.min = trimmed.replace(/^>=?/, "");
+    } else if (trimmed.startsWith("<")) {
+      bounds.max = trimmed.replace(/^<=?/, "");
+    }
+  }
+  return bounds;
+}
+function serializeBoundsValue(value) {
+  const tokens = [];
+  if (value.min) tokens.push(`>=${value.min}`);
+  if (value.max) tokens.push(`<=${value.max}`);
+  return tokens.join(",");
+}
+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  parseMultiFilterValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\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    if (filter.kind === \"time\") {\n      if (config.timeRange) {\n        throw new Error(\n          `Columns ${claimed.get(filterKey)} and ${column.name} both declare a time range; the filter bar has one`,\n        );\n      }\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 \"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  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  const bounds = parseBoundsValue(values[filterKey] ?? \"\");\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\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/**\n * Reads the bounded half of the selection grammar: comma-separated tokens, each\n * carrying its own comparison operator. The bar's controls are inclusive on\n * both edges, so that is what they write back — but a bound typed by hand or\n * arriving in a URL keeps whatever operator it came with.\n */\nfunction parseBoundsValue(raw: string): FilterBarNumberValue {\n  const bounds: FilterBarNumberValue = {};\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\nfunction serializeBoundsValue(value: FilterBarNumberValue): 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\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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"}