@flanksource/clicky-ui 0.3.36 → 0.3.37

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

@@ -1,3 +1,4 @@
+import { readDurationNumber, parseGoDurationMs, DURATION_SCALE_MS } from "../lib/duration.js";
 function isMultiFilterEscapable(char) {
   return char === "\\" || char === "!" || char === "," || /\s/.test(char);
 }
@@ -57,7 +58,8 @@ function serializeMultiFilterValue(value) {
   return Object.entries(value).flatMap(([key, mode]) => {
     if (!key) return [];
     const escaped = escapeMultiFilterKey(key);
-    if (mode === "include") return [key.startsWith("!") ? `\\${escaped}` : escaped];
+    if (mode === "include")
+      return [key.startsWith("!") ? `\\${escaped}` : escaped];
     if (mode === "exclude") return [`!${escaped}`];
     return [];
   }).join(",");
@@ -65,24 +67,80 @@ function serializeMultiFilterValue(value) {
 function splitCommaValues(value) {
   return value.split(",").map((item) => item.trim()).filter(Boolean);
 }
-function parseBoundsValue(raw) {
+function parseBoundsValue(raw, defaultOperator) {
   const bounds = {};
+  if (defaultOperator && !raw.trim()) {
+    if (defaultOperator.startsWith(">")) bounds.minOperator = defaultOperator;
+    else bounds.maxOperator = defaultOperator;
+  }
   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(/^<=?/, "");
+    if (!trimmed) continue;
+    const match = /^(>=|>|<=|<)(.+)$/.exec(trimmed) ?? (defaultOperator ? [trimmed, defaultOperator, trimmed] : null);
+    if (!match) continue;
+    const [, operator, operand] = match;
+    if (operator === ">" || operator === ">=") {
+      bounds.min = operand.trim();
+      bounds.minOperator = operator;
+    } else {
+      bounds.max = operand.trim();
+      bounds.maxOperator = operator;
     }
   }
   return bounds;
 }
 function serializeBoundsValue(value) {
+  var _a, _b;
   const tokens = [];
-  if (value.min) tokens.push(`>=${value.min}`);
-  if (value.max) tokens.push(`<=${value.max}`);
+  if ((_a = value.min) == null ? void 0 : _a.trim())
+    tokens.push(`${value.minOperator ?? ">="}${value.min.trim()}`);
+  if ((_b = value.max) == null ? void 0 : _b.trim())
+    tokens.push(`${value.maxOperator ?? "<="}${value.max.trim()}`);
   return tokens.join(",");
 }
+function parseDurationBoundsValue(raw, storageUnit = "ms", defaultOperator) {
+  const bounds = parseBoundsValue(raw, defaultOperator);
+  const result = {
+    ...bounds.minOperator ? { minOperator: bounds.minOperator } : {},
+    ...bounds.maxOperator ? { maxOperator: bounds.maxOperator } : {}
+  };
+  if (bounds.min !== void 0) {
+    result.min = durationOperandInUnit(bounds.min, storageUnit);
+    result.minUnit = storageUnit;
+  }
+  if (bounds.max !== void 0) {
+    result.max = durationOperandInUnit(bounds.max, storageUnit);
+    result.maxUnit = storageUnit;
+  }
+  return result;
+}
+function serializeDurationBoundsValue(value, defaultUnit = "ms") {
+  var _a, _b;
+  return serializeBoundsValue({
+    ...((_a = value.min) == null ? void 0 : _a.trim()) ? {
+      min: `${value.min.trim()}${value.minUnit ?? defaultUnit}`,
+      ...value.minOperator ? { minOperator: value.minOperator } : {}
+    } : {},
+    ...((_b = value.max) == null ? void 0 : _b.trim()) ? {
+      max: `${value.max.trim()}${value.maxUnit ?? defaultUnit}`,
+      ...value.maxOperator ? { maxOperator: value.maxOperator } : {}
+    } : {}
+  });
+}
+function durationOperandInUnit(operand, unit) {
+  var _a;
+  const trimmed = operand.trim();
+  const signed = trimmed[0] === "+" || trimmed[0] === "-";
+  const sign = trimmed[0] === "-" ? -1 : 1;
+  const unsigned = signed ? trimmed.slice(1) : trimmed;
+  if (((_a = readDurationNumber(unsigned, 0)) == null ? void 0 : _a.next) === unsigned.length) return trimmed;
+  const totalMs = parseGoDurationMs(unsigned);
+  if (totalMs === null) throw new Error(`Invalid duration bound ${operand}`);
+  return formatDurationNumber(sign * totalMs / DURATION_SCALE_MS[unit]);
+}
+function formatDurationNumber(value) {
+  return Number.isInteger(value) ? String(value) : String(Number(value.toFixed(9)));
+}
 function updateFilterSelection(selection, key, serialized) {
   const next = { ...selection };
   if (serialized) {
@@ -94,8 +152,10 @@ function updateFilterSelection(selection, key, serialized) {
 }
 export {
   parseBoundsValue,
+  parseDurationBoundsValue,
   parseMultiFilterValue,
   serializeBoundsValue,
+  serializeDurationBoundsValue,
   serializeMultiFilterValue,
   splitCommaValues,
   updateFilterSelection

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

@@ -1 +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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"}
+{"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\";\nimport {\n  DURATION_SCALE_MS,\n  parseGoDurationMs,\n  readDurationNumber,\n} from \"../lib/duration\";\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(\n  value: string,\n): 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 =\n      item.length > 1 && item[0]!.char === \"!\" && !item[0]!.escaped;\n    const key = (excluded ? item.slice(1) : item)\n      .map((entry) => entry.char)\n      .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(\n  value: Record<string, FilterBarMultiFilterMode>,\n): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (!key) return [];\n      const escaped = escapeMultiFilterKey(key);\n      if (mode === \"include\")\n        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  minOperator?: \">\" | \">=\";\n  max?: string;\n  maxOperator?: \"<\" | \"<=\";\n};\n\nexport type DurationFilterUnit = \"ms\" | \"s\" | \"m\" | \"h\";\nexport type FilterDefaultOperator = \">\" | \">=\" | \"<\" | \"<=\";\n\nexport type DurationBoundsValue = FilterBoundsValue & {\n  minUnit?: DurationFilterUnit;\n  maxUnit?: DurationFilterUnit;\n};\n\n/**\n * Reads a bounded selection without collapsing strict comparisons into\n * inclusive ones. Operators are part of the query contract, not decoration.\n */\nexport function parseBoundsValue(raw: string, defaultOperator?: FilterDefaultOperator): FilterBoundsValue {\n  const bounds: FilterBoundsValue = {};\n  if (defaultOperator && !raw.trim()) {\n    if (defaultOperator.startsWith(\">\")) bounds.minOperator = defaultOperator as \">\" | \">=\";\n    else bounds.maxOperator = defaultOperator as \"<\" | \"<=\";\n  }\n  for (const token of raw.split(\",\")) {\n    const trimmed = token.trim();\n    if (!trimmed) continue;\n    const match = /^(>=|>|<=|<)(.+)$/.exec(trimmed) ?? (defaultOperator ? [trimmed, defaultOperator, trimmed] : null);\n    if (!match) continue;\n    const [, operator, operand] = match;\n    if (operator === \">\" || operator === \">=\") {\n      bounds.min = operand!.trim();\n      bounds.minOperator = operator;\n    } else {\n      bounds.max = operand!.trim();\n      bounds.maxOperator = operator as \"<\" | \"<=\";\n    }\n  }\n  return bounds;\n}\n\nexport function serializeBoundsValue(value: FilterBoundsValue): string {\n  const tokens: string[] = [];\n  if (value.min?.trim())\n    tokens.push(`${value.minOperator ?? \">=\"}${value.min.trim()}`);\n  if (value.max?.trim())\n    tokens.push(`${value.maxOperator ?? \"<=\"}${value.max.trim()}`);\n  return tokens.join(\",\");\n}\n\nexport function parseDurationBoundsValue(\n  raw: string,\n  storageUnit: DurationFilterUnit = \"ms\",\n  defaultOperator?: FilterDefaultOperator,\n): DurationBoundsValue {\n  const bounds = parseBoundsValue(raw, defaultOperator);\n  const result: DurationBoundsValue = {\n    ...(bounds.minOperator ? { minOperator: bounds.minOperator } : {}),\n    ...(bounds.maxOperator ? { maxOperator: bounds.maxOperator } : {}),\n  };\n  if (bounds.min !== undefined) {\n    result.min = durationOperandInUnit(bounds.min, storageUnit);\n    result.minUnit = storageUnit;\n  }\n  if (bounds.max !== undefined) {\n    result.max = durationOperandInUnit(bounds.max, storageUnit);\n    result.maxUnit = storageUnit;\n  }\n  return result;\n}\n\nexport function serializeDurationBoundsValue(\n  value: DurationBoundsValue,\n  defaultUnit: DurationFilterUnit = \"ms\",\n): string {\n  return serializeBoundsValue({\n    ...(value.min?.trim()\n      ? {\n          min: `${value.min.trim()}${value.minUnit ?? defaultUnit}`,\n          ...(value.minOperator ? { minOperator: value.minOperator } : {}),\n        }\n      : {}),\n    ...(value.max?.trim()\n      ? {\n          max: `${value.max.trim()}${value.maxUnit ?? defaultUnit}`,\n          ...(value.maxOperator ? { maxOperator: value.maxOperator } : {}),\n        }\n      : {}),\n  });\n}\n\nfunction durationOperandInUnit(\n  operand: string,\n  unit: DurationFilterUnit,\n): string {\n  const trimmed = operand.trim();\n  const signed = trimmed[0] === \"+\" || trimmed[0] === \"-\";\n  const sign = trimmed[0] === \"-\" ? -1 : 1;\n  const unsigned = signed ? trimmed.slice(1) : trimmed;\n\n  // A bare number carries the caller's unit already.\n  if (readDurationNumber(unsigned, 0)?.next === unsigned.length) return trimmed;\n\n  const totalMs = parseGoDurationMs(unsigned);\n  if (totalMs === null) throw new Error(`Invalid duration bound ${operand}`);\n  return formatDurationNumber((sign * totalMs) / DURATION_SCALE_MS[unit]);\n}\n\nfunction formatDurationNumber(value: number): string {\n  return Number.isInteger(value)\n    ? String(value)\n    : String(Number(value.toFixed(9)));\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

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const filterBarUtils = require("../components/filter-bar-utils.cjs");
-const format = require("../lib/format.cjs");
 const dataTableFilterValues = require("./data-table-filter-values.cjs");
 const dataTableUtils = require("./data-table-utils.cjs");
 const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;
@@ -24,7 +23,9 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
     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`);
+      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) {
@@ -40,7 +41,14 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
     }
     config.filters.push(
       filterBarUtils.applyFilterExtensions(
-        buildFilter({ filterKey, label, filter, values, setValues, options }),
+        buildFilter({
+          filterKey,
+          label,
+          filter,
+          values,
+          setValues,
+          options
+        }),
         options.extensions
       )
     );
@@ -50,7 +58,9 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
 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 write = (serialized) => setValues(
+    (current) => dataTableFilterValues.updateFilterSelection(current, filterKey, serialized)
+  );
   const shared = {
     key: filterKey,
     label,
@@ -71,9 +81,6 @@ function buildFilter(args) {
         timeEnabled: filter.kind === "time"
       };
     case "range":
-    // A duration is a range that knows what its numbers mean, so it differs
-    // only in how the slider labels them.
-    case "duration":
       return {
         ...shared,
         kind: "number",
@@ -82,13 +89,31 @@ function buildFilter(args) {
         ...filter.min !== void 0 ? { domainMin: filter.min } : {},
         ...filter.max !== void 0 ? { domainMax: filter.max } : {},
         ...filter.step !== void 0 ? { step: filter.step } : {},
-        ...filter.kind === "duration" ? { formatValue: (value) => format.formatUnit(value, filter.unit || "ms") } : {}
+        ...filter.unit ? { unit: filter.unit } : {}
       };
+    case "duration": {
+      const unit = durationStorageUnit(filter.unit);
+      return {
+        ...shared,
+        kind: "duration",
+        unit,
+        value: dataTableFilterValues.parseDurationBoundsValue(raw, unit),
+        onChange: (next) => write(dataTableFilterValues.serializeDurationBoundsValue(next, unit)),
+        ...filter.min !== void 0 ? { domainMin: filter.min } : {},
+        ...filter.max !== void 0 ? { domainMax: filter.max } : {},
+        ...filter.step !== void 0 ? { step: filter.step } : {}
+      };
+    }
     // An exact match has nothing to enumerate, which is what buildTermsFilter
     // already falls back to for a selection that turned out to have no values.
     // Declaring it says so up front rather than arriving there by exhaustion.
     case "exact":
-      return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
+      return {
+        ...shared,
+        kind: "text",
+        value: raw,
+        onChange: (next) => write(next)
+      };
     case "boolean":
       return {
         ...shared,
@@ -107,11 +132,23 @@ function buildFilter(args) {
       return buildTermsFilter(args, shared, raw, write);
   }
 }
+function durationStorageUnit(unit) {
+  const resolved = unit || "ms";
+  if (resolved !== "ms" && resolved !== "s") {
+    throw new Error(`Unsupported duration storage unit ${resolved}`);
+  }
+  return resolved;
+}
 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: "text",
+      value: raw,
+      onChange: (next) => write(next)
+    };
   }
   return {
     ...shared,
@@ -139,7 +176,11 @@ 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 }))
+      (current) => dataTableFilterValues.updateFilterSelection(
+        current,
+        filterKey,
+        dataTableFilterValues.serializeBoundsValue({ min: from, max: to })
+      )
     ),
     ...filter.presets !== void 0 ? { presets: filter.presets } : {},
     timeEnabled: true

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

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

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

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

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

@@ -1,6 +1,5 @@
 import { applyFilterExtensions } from "../components/filter-bar-utils.js";
-import { formatUnit } from "../lib/format.js";
-import { updateFilterSelection, serializeBoundsValue, parseBoundsValue, serializeMultiFilterValue, parseMultiFilterValue } from "./data-table-filter-values.js";
+import { updateFilterSelection, serializeBoundsValue, parseBoundsValue, serializeDurationBoundsValue, parseDurationBoundsValue, 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) {
@@ -22,7 +21,9 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
     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`);
+      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) {
@@ -38,7 +39,14 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
     }
     config.filters.push(
       applyFilterExtensions(
-        buildFilter({ filterKey, label, filter, values, setValues, options }),
+        buildFilter({
+          filterKey,
+          label,
+          filter,
+          values,
+          setValues,
+          options
+        }),
         options.extensions
       )
     );
@@ -48,7 +56,9 @@ function serverFiltersToFilterBar(columns, values, setValues, options = {}) {
 function buildFilter(args) {
   const { filterKey, label, filter, values, setValues } = args;
   const raw = values[filterKey] ?? "";
-  const write = (serialized) => setValues((current) => updateFilterSelection(current, filterKey, serialized));
+  const write = (serialized) => setValues(
+    (current) => updateFilterSelection(current, filterKey, serialized)
+  );
   const shared = {
     key: filterKey,
     label,
@@ -69,9 +79,6 @@ function buildFilter(args) {
         timeEnabled: filter.kind === "time"
       };
     case "range":
-    // A duration is a range that knows what its numbers mean, so it differs
-    // only in how the slider labels them.
-    case "duration":
       return {
         ...shared,
         kind: "number",
@@ -80,13 +87,31 @@ function buildFilter(args) {
         ...filter.min !== void 0 ? { domainMin: filter.min } : {},
         ...filter.max !== void 0 ? { domainMax: filter.max } : {},
         ...filter.step !== void 0 ? { step: filter.step } : {},
-        ...filter.kind === "duration" ? { formatValue: (value) => formatUnit(value, filter.unit || "ms") } : {}
+        ...filter.unit ? { unit: filter.unit } : {}
       };
+    case "duration": {
+      const unit = durationStorageUnit(filter.unit);
+      return {
+        ...shared,
+        kind: "duration",
+        unit,
+        value: parseDurationBoundsValue(raw, unit),
+        onChange: (next) => write(serializeDurationBoundsValue(next, unit)),
+        ...filter.min !== void 0 ? { domainMin: filter.min } : {},
+        ...filter.max !== void 0 ? { domainMax: filter.max } : {},
+        ...filter.step !== void 0 ? { step: filter.step } : {}
+      };
+    }
     // An exact match has nothing to enumerate, which is what buildTermsFilter
     // already falls back to for a selection that turned out to have no values.
     // Declaring it says so up front rather than arriving there by exhaustion.
     case "exact":
-      return { ...shared, kind: "text", value: raw, onChange: (next) => write(next) };
+      return {
+        ...shared,
+        kind: "text",
+        value: raw,
+        onChange: (next) => write(next)
+      };
     case "boolean":
       return {
         ...shared,
@@ -105,11 +130,23 @@ function buildFilter(args) {
       return buildTermsFilter(args, shared, raw, write);
   }
 }
+function durationStorageUnit(unit) {
+  const resolved = unit || "ms";
+  if (resolved !== "ms" && resolved !== "s") {
+    throw new Error(`Unsupported duration storage unit ${resolved}`);
+  }
+  return resolved;
+}
 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: "text",
+      value: raw,
+      onChange: (next) => write(next)
+    };
   }
   return {
     ...shared,
@@ -137,7 +174,11 @@ function buildTimeRange(filterKey, filter, values, setValues) {
   return {
     ...boundsToRange(parseBoundsValue(values[filterKey] ?? "")),
     onApply: (from, to) => setValues(
-      (current) => updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to }))
+      (current) => updateFilterSelection(
+        current,
+        filterKey,
+        serializeBoundsValue({ min: from, max: to })
+      )
     ),
     ...filter.presets !== void 0 ? { presets: filter.presets } : {},
     timeEnabled: true