@ai-matrx/design-system 0.25.0 → 0.27.0

package/dist/data-table/infer-filter.cjs

@@ -132,6 +132,8 @@ function filterKindLabel(kind) {
       return "Boolean";
     case "number":
       return "Number";
+    case "date":
+      return "Date";
     case "auto":
       return "Auto";
     case false:

package/dist/data-table/infer-filter.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/infer-filter.ts","../../src/data-table/column-marker.ts","../../src/data-table/filter-engine.ts"],"sourcesContent":["import type { ColumnFilterKind, MatrxColumnDef } from \"./types\";\nimport { resolveColumnMarker } from \"./column-marker\";\nimport {\n  SELECT_EMPTY_VALUE,\n  SELECT_NOT_EMPTY_VALUE,\n  SELECT_NULL_VALUE,\n  getCellValue,\n  selectCellValues,\n} from \"./filter-engine\";\n\n/** Auto-inference switches to text above this many distinct values… */\nconst SELECT_CARDINALITY_CAP = 24;\n\nexport type ResolvedFilterKind = \"text\" | \"select\" | \"boolean\" | \"number\";\n\n/**\n * Infer a filter UI from sample row values. Prefer select for low-cardinality\n * string/enum columns, boolean for booleans, number for numeric, else text.\n */\nexport function resolveFilterKind<T>(\n  col: MatrxColumnDef<T>,\n  sampleRows: T[],\n): ResolvedFilterKind | null {\n  if (col.filter === false) return null;\n  if (col.filter && col.filter !== \"auto\") return col.filter;\n  if (resolveColumnMarker(col)) return \"boolean\";\n\n  const values = sampleRows\n    .slice(0, 200)\n    .map((row) => getCellValue(row, col))\n    .filter((v) => v != null);\n\n  if (values.length === 0) return \"text\";\n\n  if (values.every((v) => typeof v === \"boolean\")) return \"boolean\";\n  if (values.every((v) => typeof v === \"number\" && Number.isFinite(v))) {\n    return \"number\";\n  }\n\n  const strings = values.flatMap(selectCellValues);\n  const unique = new Set(strings);\n  if (\n    unique.size >= 1 &&\n    unique.size <= SELECT_CARDINALITY_CAP &&\n    unique.size < strings.length * 0.6\n  ) {\n    return \"select\";\n  }\n\n  return \"text\";\n}\n\nexport function collectSelectOptions<T>(\n  col: MatrxColumnDef<T>,\n  rows: T[],\n): Array<{ value: string; label: string }> {\n  const seen = new Set<string>();\n  const options: Array<{ value: string; label: string }> = [];\n  let hasEmpty = false;\n  let hasEmptyCollection = false;\n  for (const row of rows) {\n    const cell = getCellValue(row, col);\n    const values = selectCellValues(cell);\n    if (values.length === 0) {\n      hasEmpty = true;\n      if (Array.isArray(cell)) hasEmptyCollection = true;\n      continue;\n    }\n    for (const value of values) {\n      if (col.filterOptions?.length || seen.has(value)) continue;\n      seen.add(value);\n      options.push({ value, label: value });\n    }\n  }\n  const base = col.filterOptions?.length\n    ? col.filterOptions.map((option) => ({\n        ...option,\n        label: option.label.trim() ? option.label : option.value === \"\" ? \"(empty string)\" : option.value.trim() ? option.value : \"(whitespace)\",\n      }))\n    : options.sort((a, b) => a.label.localeCompare(b.label));\n  // Emptiness sentinels: whenever the column has blank cells, every select\n  // filter can isolate them — or exclude them — with zero per-table config.\n  if (hasEmpty) {\n    // An explicit literal-empty choice must remain independently deselectable.\n    // The combined empty sentinel would overlap it after All -> uncheck.\n    // Empty collections still require that broader option: neither null nor\n    // a literal empty string represents an empty array.\n    const emptyOption = !hasEmptyCollection && base.some((option) => option.value === \"\")\n      ? { value: SELECT_NULL_VALUE, label: \"(null)\" }\n      : { value: SELECT_EMPTY_VALUE, label: \"(empty)\" };\n    const additions = [];\n    if (!base.some((option) => option.value === emptyOption.value)) additions.push(emptyOption);\n    if (!base.some((option) => option.value === SELECT_NOT_EMPTY_VALUE)) {\n      additions.push({ value: SELECT_NOT_EMPTY_VALUE, label: \"(not empty)\" });\n    }\n    base.unshift(...additions);\n  }\n  return base;\n}\n\nexport function filterKindLabel(\n  kind: ColumnFilterKind | ResolvedFilterKind,\n): string {\n  switch (kind) {\n    case \"text\":\n      return \"Text\";\n    case \"select\":\n      return \"Select\";\n    case \"boolean\":\n      return \"Boolean\";\n    case \"number\":\n      return \"Number\";\n    case \"auto\":\n      return \"Auto\";\n    case false:\n      return \"Off\";\n  }\n}\n","import type { ColumnMarker, MatrxColumnDef } from \"./types\";\n\nexport type ResolvedColumnMarker = Exclude<ColumnMarker, false>;\n\nconst MARKER_ACCESSORS: Readonly<Record<string, ResolvedColumnMarker>> = {\n  favorite: \"favorite\",\n  is_favorite: \"favorite\",\n  favourite: \"favorite\",\n  is_favourite: \"favorite\",\n  pinned: \"pin\",\n  is_pinned: \"pin\",\n};\n\n/**\n * Resolve the semantic without guessing from partial names. A field such as\n * `favorite_count` is not a marker; consumers can always opt in explicitly.\n */\nexport function resolveColumnMarker<T>(\n  column: MatrxColumnDef<T>,\n): ResolvedColumnMarker | undefined {\n  if (column.marker === false) return undefined;\n  if (column.marker) return column.marker;\n  return column.accessorKey ? MARKER_ACCESSORS[column.accessorKey] : undefined;\n}\n\nexport function markerCopy(marker: ResolvedColumnMarker): {\n  label: string;\n  lowerLabel: string;\n  onlyLabel: string;\n  notLabel: string;\n} {\n  return marker === \"favorite\"\n    ? {\n        label: \"Favorites\",\n        lowerLabel: \"favorites\",\n        onlyLabel: \"Favorites only\",\n        notLabel: \"Not favorites\",\n      }\n    : {\n        label: \"Pins\",\n        lowerLabel: \"pins\",\n        onlyLabel: \"Pins only\",\n        notLabel: \"Not pinned\",\n      };\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n/** Exact SQL-style NULL selection, distinct from the empty-cell option. */\nexport const SELECT_NULL_VALUE = \"__null__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\n/** Select filters treat array-valued cells as sets, never as serialized JSON choices. */\nexport function selectCellValues(value: unknown): string[] {\n  return (Array.isArray(value) ? value : [value])\n    .map(stringifyCellValue)\n    .filter((item) => item !== \"\");\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      // `values: []` is an explicit multi-select state: the user deselected\n      // every option, so it must produce an empty result. Legacy single-value\n      // filters and an absent `values` field retain their clear/all behavior.\n      if (filter.values !== undefined && filter.values.length === 0) {\n        return false;\n      }\n      const selected = filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const values = selectCellValues(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_NULL_VALUE\n          ? value == null\n          : v === SELECT_EMPTY_VALUE\n          ? values.length === 0\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? values.length > 0\n            : v === \"\"\n              ? value === \"\" || (Array.isArray(value) && value.includes(\"\"))\n              : values.includes(v),\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      // A missing cell is not zero. Without this guard, Number(\"\") made a\n      // blank numeric value pass filters whose range included zero.\n      const raw = stringifyCellValue(value).trim();\n      if (raw === \"\") return false;\n      const normalized = raw.replace(/[^0-9.-]/g, \"\");\n      if (normalized === \"\") return false;\n      const n = typeof value === \"number\"\n        ? value\n        : Number(normalized);\n      if (!Number.isFinite(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values !== undefined || (f.value && f.value !== \"__all__\"))\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values !== undefined\n        ? true\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIA,IAAM,mBAAmE;AAAA,EACvE,UAAU;AAAA,EACV,aAAa;AAAA,EACb,WAAW;AAAA,EACX,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,WAAW;AACb;AAMO,SAAS,oBACd,QACkC;AAClC,MAAI,OAAO,WAAW,MAAO,QAAO;AACpC,MAAI,OAAO,OAAQ,QAAO,OAAO;AACjC,SAAO,OAAO,cAAc,iBAAiB,OAAO,WAAW,IAAI;AACrE;;;ACLO,IAAM,qBAAqB;AAC3B,IAAM,yBAAyB;AAE/B,IAAM,oBAAoB;AAQ1B,SAAS,aAAgB,KAAQ,KAAiC;AACvE,MAAI,IAAI,WAAY,QAAO,IAAI,WAAW,GAAG;AAC7C,MAAI,IAAI,aAAa;AACnB,WAAQ,IAAgC,IAAI,WAAW;AAAA,EACzD;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,OAAwB;AACzD,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;AAC3D,WAAO,OAAO,KAAK;AAAA,EACrB;AACA,MAAI,iBAAiB,KAAM,QAAO,MAAM,YAAY;AACpD,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAgDO,SAAS,iBAAiB,OAA0B;AACzD,UAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GAC1C,IAAI,kBAAkB,EACtB,OAAO,CAAC,SAAS,SAAS,EAAE;AACjC;;;AFlGA,IAAM,yBAAyB;AAQxB,SAAS,kBACd,KACA,YAC2B;AAC3B,MAAI,IAAI,WAAW,MAAO,QAAO;AACjC,MAAI,IAAI,UAAU,IAAI,WAAW,OAAQ,QAAO,IAAI;AACpD,MAAI,oBAAoB,GAAG,EAAG,QAAO;AAErC,QAAM,SAAS,WACZ,MAAM,GAAG,GAAG,EACZ,IAAI,CAAC,QAAQ,aAAa,KAAK,GAAG,CAAC,EACnC,OAAO,CAAC,MAAM,KAAK,IAAI;AAE1B,MAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,MAAI,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,SAAS,EAAG,QAAO;AACxD,MAAI,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,CAAC,GAAG;AACpE,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,OAAO,QAAQ,gBAAgB;AAC/C,QAAM,SAAS,IAAI,IAAI,OAAO;AAC9B,MACE,OAAO,QAAQ,KACf,OAAO,QAAQ,0BACf,OAAO,OAAO,QAAQ,SAAS,KAC/B;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,qBACd,KACA,MACyC;AACzC,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,UAAmD,CAAC;AAC1D,MAAI,WAAW;AACf,MAAI,qBAAqB;AACzB,aAAW,OAAO,MAAM;AACtB,UAAM,OAAO,aAAa,KAAK,GAAG;AAClC,UAAM,SAAS,iBAAiB,IAAI;AACpC,QAAI,OAAO,WAAW,GAAG;AACvB,iBAAW;AACX,UAAI,MAAM,QAAQ,IAAI,EAAG,sBAAqB;AAC9C;AAAA,IACF;AACA,eAAW,SAAS,QAAQ;AAC1B,UAAI,IAAI,eAAe,UAAU,KAAK,IAAI,KAAK,EAAG;AAClD,WAAK,IAAI,KAAK;AACd,cAAQ,KAAK,EAAE,OAAO,OAAO,MAAM,CAAC;AAAA,IACtC;AAAA,EACF;AACA,QAAM,OAAO,IAAI,eAAe,SAC5B,IAAI,cAAc,IAAI,CAAC,YAAY;AAAA,IACjC,GAAG;AAAA,IACH,OAAO,OAAO,MAAM,KAAK,IAAI,OAAO,QAAQ,OAAO,UAAU,KAAK,mBAAmB,OAAO,MAAM,KAAK,IAAI,OAAO,QAAQ;AAAA,EAC5H,EAAE,IACF,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,CAAC;AAGzD,MAAI,UAAU;AAKZ,UAAM,cAAc,CAAC,sBAAsB,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,EAAE,IAChF,EAAE,OAAO,mBAAmB,OAAO,SAAS,IAC5C,EAAE,OAAO,oBAAoB,OAAO,UAAU;AAClD,UAAM,YAAY,CAAC;AACnB,QAAI,CAAC,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,YAAY,KAAK,EAAG,WAAU,KAAK,WAAW;AAC1F,QAAI,CAAC,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,sBAAsB,GAAG;AACnE,gBAAU,KAAK,EAAE,OAAO,wBAAwB,OAAO,cAAc,CAAC;AAAA,IACxE;AACA,SAAK,QAAQ,GAAG,SAAS;AAAA,EAC3B;AACA,SAAO;AACT;AAEO,SAAS,gBACd,MACQ;AACR,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}
+{"version":3,"sources":["../../src/data-table/infer-filter.ts","../../src/data-table/column-marker.ts","../../src/data-table/filter-engine.ts"],"sourcesContent":["import type { ColumnFilterKind, MatrxColumnDef } from \"./types\";\nimport { resolveColumnMarker } from \"./column-marker\";\nimport {\n  SELECT_EMPTY_VALUE,\n  SELECT_NOT_EMPTY_VALUE,\n  SELECT_NULL_VALUE,\n  getCellValue,\n  selectCellValues,\n} from \"./filter-engine\";\n\n/** Auto-inference switches to text above this many distinct values… */\nconst SELECT_CARDINALITY_CAP = 24;\n\nexport type ResolvedFilterKind = \"text\" | \"select\" | \"boolean\" | \"number\" | \"date\";\n\n/**\n * Infer a filter UI from sample row values. Prefer select for low-cardinality\n * string/enum columns, boolean for booleans, number for numeric, else text.\n */\nexport function resolveFilterKind<T>(\n  col: MatrxColumnDef<T>,\n  sampleRows: T[],\n): ResolvedFilterKind | null {\n  if (col.filter === false) return null;\n  if (col.filter && col.filter !== \"auto\") return col.filter;\n  if (resolveColumnMarker(col)) return \"boolean\";\n\n  const values = sampleRows\n    .slice(0, 200)\n    .map((row) => getCellValue(row, col))\n    .filter((v) => v != null);\n\n  if (values.length === 0) return \"text\";\n\n  if (values.every((v) => typeof v === \"boolean\")) return \"boolean\";\n  if (values.every((v) => typeof v === \"number\" && Number.isFinite(v))) {\n    return \"number\";\n  }\n\n  const strings = values.flatMap(selectCellValues);\n  const unique = new Set(strings);\n  if (\n    unique.size >= 1 &&\n    unique.size <= SELECT_CARDINALITY_CAP &&\n    unique.size < strings.length * 0.6\n  ) {\n    return \"select\";\n  }\n\n  return \"text\";\n}\n\nexport function collectSelectOptions<T>(\n  col: MatrxColumnDef<T>,\n  rows: T[],\n): Array<{ value: string; label: string }> {\n  const seen = new Set<string>();\n  const options: Array<{ value: string; label: string }> = [];\n  let hasEmpty = false;\n  let hasEmptyCollection = false;\n  for (const row of rows) {\n    const cell = getCellValue(row, col);\n    const values = selectCellValues(cell);\n    if (values.length === 0) {\n      hasEmpty = true;\n      if (Array.isArray(cell)) hasEmptyCollection = true;\n      continue;\n    }\n    for (const value of values) {\n      if (col.filterOptions?.length || seen.has(value)) continue;\n      seen.add(value);\n      options.push({ value, label: value });\n    }\n  }\n  const base = col.filterOptions?.length\n    ? col.filterOptions.map((option) => ({\n        ...option,\n        label: option.label.trim() ? option.label : option.value === \"\" ? \"(empty string)\" : option.value.trim() ? option.value : \"(whitespace)\",\n      }))\n    : options.sort((a, b) => a.label.localeCompare(b.label));\n  // Emptiness sentinels: whenever the column has blank cells, every select\n  // filter can isolate them — or exclude them — with zero per-table config.\n  if (hasEmpty) {\n    // An explicit literal-empty choice must remain independently deselectable.\n    // The combined empty sentinel would overlap it after All -> uncheck.\n    // Empty collections still require that broader option: neither null nor\n    // a literal empty string represents an empty array.\n    const emptyOption = !hasEmptyCollection && base.some((option) => option.value === \"\")\n      ? { value: SELECT_NULL_VALUE, label: \"(null)\" }\n      : { value: SELECT_EMPTY_VALUE, label: \"(empty)\" };\n    const additions = [];\n    if (!base.some((option) => option.value === emptyOption.value)) additions.push(emptyOption);\n    if (!base.some((option) => option.value === SELECT_NOT_EMPTY_VALUE)) {\n      additions.push({ value: SELECT_NOT_EMPTY_VALUE, label: \"(not empty)\" });\n    }\n    base.unshift(...additions);\n  }\n  return base;\n}\n\nexport function filterKindLabel(\n  kind: ColumnFilterKind | ResolvedFilterKind,\n): string {\n  switch (kind) {\n    case \"text\":\n      return \"Text\";\n    case \"select\":\n      return \"Select\";\n    case \"boolean\":\n      return \"Boolean\";\n    case \"number\":\n      return \"Number\";\n    case \"date\":\n      return \"Date\";\n    case \"auto\":\n      return \"Auto\";\n    case false:\n      return \"Off\";\n  }\n}\n","import type { ColumnMarker, MatrxColumnDef } from \"./types\";\n\nexport type ResolvedColumnMarker = Exclude<ColumnMarker, false>;\n\nconst MARKER_ACCESSORS: Readonly<Record<string, ResolvedColumnMarker>> = {\n  favorite: \"favorite\",\n  is_favorite: \"favorite\",\n  favourite: \"favorite\",\n  is_favourite: \"favorite\",\n  pinned: \"pin\",\n  is_pinned: \"pin\",\n};\n\n/**\n * Resolve the semantic without guessing from partial names. A field such as\n * `favorite_count` is not a marker; consumers can always opt in explicitly.\n */\nexport function resolveColumnMarker<T>(\n  column: MatrxColumnDef<T>,\n): ResolvedColumnMarker | undefined {\n  if (column.marker === false) return undefined;\n  if (column.marker) return column.marker;\n  return column.accessorKey ? MARKER_ACCESSORS[column.accessorKey] : undefined;\n}\n\nexport function markerCopy(marker: ResolvedColumnMarker): {\n  label: string;\n  lowerLabel: string;\n  onlyLabel: string;\n  notLabel: string;\n} {\n  return marker === \"favorite\"\n    ? {\n        label: \"Favorites\",\n        lowerLabel: \"favorites\",\n        onlyLabel: \"Favorites only\",\n        notLabel: \"Not favorites\",\n      }\n    : {\n        label: \"Pins\",\n        lowerLabel: \"pins\",\n        onlyLabel: \"Pins only\",\n        notLabel: \"Not pinned\",\n      };\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\nimport { dateFilterBounds } from \"./date-filter\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n/** Exact SQL-style NULL selection, distinct from the empty-cell option. */\nexport const SELECT_NULL_VALUE = \"__null__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\n/** Select filters treat array-valued cells as sets, never as serialized JSON choices. */\nexport function selectCellValues(value: unknown): string[] {\n  return (Array.isArray(value) ? value : [value])\n    .map(stringifyCellValue)\n    .filter((item) => item !== \"\");\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      // `values: []` is an explicit multi-select state: the user deselected\n      // every option, so it must produce an empty result. Legacy single-value\n      // filters and an absent `values` field retain their clear/all behavior.\n      if (filter.values !== undefined && filter.values.length === 0) {\n        return false;\n      }\n      const selected = filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const values = selectCellValues(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_NULL_VALUE\n          ? value == null\n          : v === SELECT_EMPTY_VALUE\n          ? values.length === 0\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? values.length > 0\n            : v === \"\"\n              ? value === \"\" || (Array.isArray(value) && value.includes(\"\"))\n              : values.includes(v),\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      // A missing cell is not zero. Without this guard, Number(\"\") made a\n      // blank numeric value pass filters whose range included zero.\n      const raw = stringifyCellValue(value).trim();\n      if (raw === \"\") return false;\n      const normalized = raw.replace(/[^0-9.-]/g, \"\");\n      if (normalized === \"\") return false;\n      const n = typeof value === \"number\"\n        ? value\n        : Number(normalized);\n      if (!Number.isFinite(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    case \"date\": {\n      const raw = value instanceof Date ? value : new Date(stringifyCellValue(value));\n      if (Number.isNaN(raw.valueOf())) return false;\n      const { since, until } = dateFilterBounds(filter);\n      const timestamp = raw.valueOf();\n      if (since !== undefined) {\n        const sinceTimestamp = new Date(since).valueOf();\n        if (Number.isNaN(sinceTimestamp) || timestamp < sinceTimestamp) return false;\n      }\n      if (until !== undefined) {\n        const untilTimestamp = new Date(until).valueOf();\n        if (Number.isNaN(untilTimestamp) || timestamp >= untilTimestamp) return false;\n      }\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values !== undefined || (f.value && f.value !== \"__all__\"))\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n    case \"number\":\n      if (f.min !== undefined || f.max !== undefined) n += 1;\n      break;\n    case \"date\":\n      if (isColumnFilterActive(f)) n += 1;\n      break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values !== undefined\n        ? true\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n    case \"date\": {\n      const bounds = dateFilterBounds(filter);\n      return bounds.since !== undefined || bounds.until !== undefined;\n    }\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/infer-filter.d.cts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, f as ColumnFilterKind } from '../types-CmQrOz-T.cjs';
+import { M as MatrxColumnDef, f as ColumnFilterKind } from '../types-jQddSUnj.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,10 +7,12 @@ import './copy-types.cjs';
 import '../types-CJWU1Gae.cjs';
 import './grouping.cjs';
 import './fill.cjs';
+import './facets.cjs';
 import './spreadsheet.cjs';
 import './grid-selection.cjs';
+import './date-filter.cjs';
 
-type ResolvedFilterKind = "text" | "select" | "boolean" | "number";
+type ResolvedFilterKind = "text" | "select" | "boolean" | "number" | "date";
 /**
  * Infer a filter UI from sample row values. Prefer select for low-cardinality
  * string/enum columns, boolean for booleans, number for numeric, else text.

package/dist/data-table/infer-filter.d.ts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, f as ColumnFilterKind } from '../types-nlLCMiqd.js';
+import { M as MatrxColumnDef, f as ColumnFilterKind } from '../types-D9JBR6ZU.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,10 +7,12 @@ import './copy-types.js';
 import '../types-CJWU1Gae.js';
 import './grouping.js';
 import './fill.js';
+import './facets.js';
 import './spreadsheet.js';
 import './grid-selection.js';
+import './date-filter.js';
 
-type ResolvedFilterKind = "text" | "select" | "boolean" | "number";
+type ResolvedFilterKind = "text" | "select" | "boolean" | "number" | "date";
 /**
  * Infer a filter UI from sample row values. Prefer select for low-cardinality
  * string/enum columns, boolean for booleans, number for numeric, else text.

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

@@ -105,6 +105,8 @@ function filterKindLabel(kind) {
       return "Boolean";
     case "number":
       return "Number";
+    case "date":
+      return "Date";
     case "auto":
       return "Auto";
     case false:

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/column-marker.ts","../../src/data-table/filter-engine.ts","../../src/data-table/infer-filter.ts"],"sourcesContent":["import type { ColumnMarker, MatrxColumnDef } from \"./types\";\n\nexport type ResolvedColumnMarker = Exclude<ColumnMarker, false>;\n\nconst MARKER_ACCESSORS: Readonly<Record<string, ResolvedColumnMarker>> = {\n  favorite: \"favorite\",\n  is_favorite: \"favorite\",\n  favourite: \"favorite\",\n  is_favourite: \"favorite\",\n  pinned: \"pin\",\n  is_pinned: \"pin\",\n};\n\n/**\n * Resolve the semantic without guessing from partial names. A field such as\n * `favorite_count` is not a marker; consumers can always opt in explicitly.\n */\nexport function resolveColumnMarker<T>(\n  column: MatrxColumnDef<T>,\n): ResolvedColumnMarker | undefined {\n  if (column.marker === false) return undefined;\n  if (column.marker) return column.marker;\n  return column.accessorKey ? MARKER_ACCESSORS[column.accessorKey] : undefined;\n}\n\nexport function markerCopy(marker: ResolvedColumnMarker): {\n  label: string;\n  lowerLabel: string;\n  onlyLabel: string;\n  notLabel: string;\n} {\n  return marker === \"favorite\"\n    ? {\n        label: \"Favorites\",\n        lowerLabel: \"favorites\",\n        onlyLabel: \"Favorites only\",\n        notLabel: \"Not favorites\",\n      }\n    : {\n        label: \"Pins\",\n        lowerLabel: \"pins\",\n        onlyLabel: \"Pins only\",\n        notLabel: \"Not pinned\",\n      };\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n/** Exact SQL-style NULL selection, distinct from the empty-cell option. */\nexport const SELECT_NULL_VALUE = \"__null__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\n/** Select filters treat array-valued cells as sets, never as serialized JSON choices. */\nexport function selectCellValues(value: unknown): string[] {\n  return (Array.isArray(value) ? value : [value])\n    .map(stringifyCellValue)\n    .filter((item) => item !== \"\");\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      // `values: []` is an explicit multi-select state: the user deselected\n      // every option, so it must produce an empty result. Legacy single-value\n      // filters and an absent `values` field retain their clear/all behavior.\n      if (filter.values !== undefined && filter.values.length === 0) {\n        return false;\n      }\n      const selected = filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const values = selectCellValues(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_NULL_VALUE\n          ? value == null\n          : v === SELECT_EMPTY_VALUE\n          ? values.length === 0\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? values.length > 0\n            : v === \"\"\n              ? value === \"\" || (Array.isArray(value) && value.includes(\"\"))\n              : values.includes(v),\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      // A missing cell is not zero. Without this guard, Number(\"\") made a\n      // blank numeric value pass filters whose range included zero.\n      const raw = stringifyCellValue(value).trim();\n      if (raw === \"\") return false;\n      const normalized = raw.replace(/[^0-9.-]/g, \"\");\n      if (normalized === \"\") return false;\n      const n = typeof value === \"number\"\n        ? value\n        : Number(normalized);\n      if (!Number.isFinite(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values !== undefined || (f.value && f.value !== \"__all__\"))\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values !== undefined\n        ? true\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n","import type { ColumnFilterKind, MatrxColumnDef } from \"./types\";\nimport { resolveColumnMarker } from \"./column-marker\";\nimport {\n  SELECT_EMPTY_VALUE,\n  SELECT_NOT_EMPTY_VALUE,\n  SELECT_NULL_VALUE,\n  getCellValue,\n  selectCellValues,\n} from \"./filter-engine\";\n\n/** Auto-inference switches to text above this many distinct values… */\nconst SELECT_CARDINALITY_CAP = 24;\n\nexport type ResolvedFilterKind = \"text\" | \"select\" | \"boolean\" | \"number\";\n\n/**\n * Infer a filter UI from sample row values. Prefer select for low-cardinality\n * string/enum columns, boolean for booleans, number for numeric, else text.\n */\nexport function resolveFilterKind<T>(\n  col: MatrxColumnDef<T>,\n  sampleRows: T[],\n): ResolvedFilterKind | null {\n  if (col.filter === false) return null;\n  if (col.filter && col.filter !== \"auto\") return col.filter;\n  if (resolveColumnMarker(col)) return \"boolean\";\n\n  const values = sampleRows\n    .slice(0, 200)\n    .map((row) => getCellValue(row, col))\n    .filter((v) => v != null);\n\n  if (values.length === 0) return \"text\";\n\n  if (values.every((v) => typeof v === \"boolean\")) return \"boolean\";\n  if (values.every((v) => typeof v === \"number\" && Number.isFinite(v))) {\n    return \"number\";\n  }\n\n  const strings = values.flatMap(selectCellValues);\n  const unique = new Set(strings);\n  if (\n    unique.size >= 1 &&\n    unique.size <= SELECT_CARDINALITY_CAP &&\n    unique.size < strings.length * 0.6\n  ) {\n    return \"select\";\n  }\n\n  return \"text\";\n}\n\nexport function collectSelectOptions<T>(\n  col: MatrxColumnDef<T>,\n  rows: T[],\n): Array<{ value: string; label: string }> {\n  const seen = new Set<string>();\n  const options: Array<{ value: string; label: string }> = [];\n  let hasEmpty = false;\n  let hasEmptyCollection = false;\n  for (const row of rows) {\n    const cell = getCellValue(row, col);\n    const values = selectCellValues(cell);\n    if (values.length === 0) {\n      hasEmpty = true;\n      if (Array.isArray(cell)) hasEmptyCollection = true;\n      continue;\n    }\n    for (const value of values) {\n      if (col.filterOptions?.length || seen.has(value)) continue;\n      seen.add(value);\n      options.push({ value, label: value });\n    }\n  }\n  const base = col.filterOptions?.length\n    ? col.filterOptions.map((option) => ({\n        ...option,\n        label: option.label.trim() ? option.label : option.value === \"\" ? \"(empty string)\" : option.value.trim() ? option.value : \"(whitespace)\",\n      }))\n    : options.sort((a, b) => a.label.localeCompare(b.label));\n  // Emptiness sentinels: whenever the column has blank cells, every select\n  // filter can isolate them — or exclude them — with zero per-table config.\n  if (hasEmpty) {\n    // An explicit literal-empty choice must remain independently deselectable.\n    // The combined empty sentinel would overlap it after All -> uncheck.\n    // Empty collections still require that broader option: neither null nor\n    // a literal empty string represents an empty array.\n    const emptyOption = !hasEmptyCollection && base.some((option) => option.value === \"\")\n      ? { value: SELECT_NULL_VALUE, label: \"(null)\" }\n      : { value: SELECT_EMPTY_VALUE, label: \"(empty)\" };\n    const additions = [];\n    if (!base.some((option) => option.value === emptyOption.value)) additions.push(emptyOption);\n    if (!base.some((option) => option.value === SELECT_NOT_EMPTY_VALUE)) {\n      additions.push({ value: SELECT_NOT_EMPTY_VALUE, label: \"(not empty)\" });\n    }\n    base.unshift(...additions);\n  }\n  return base;\n}\n\nexport function filterKindLabel(\n  kind: ColumnFilterKind | ResolvedFilterKind,\n): string {\n  switch (kind) {\n    case \"text\":\n      return \"Text\";\n    case \"select\":\n      return \"Select\";\n    case \"boolean\":\n      return \"Boolean\";\n    case \"number\":\n      return \"Number\";\n    case \"auto\":\n      return \"Auto\";\n    case false:\n      return \"Off\";\n  }\n}\n"],"mappings":";;AAIA,IAAM,mBAAmE;AAAA,EACvE,UAAU;AAAA,EACV,aAAa;AAAA,EACb,WAAW;AAAA,EACX,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,WAAW;AACb;AAMO,SAAS,oBACd,QACkC;AAClC,MAAI,OAAO,WAAW,MAAO,QAAO;AACpC,MAAI,OAAO,OAAQ,QAAO,OAAO;AACjC,SAAO,OAAO,cAAc,iBAAiB,OAAO,WAAW,IAAI;AACrE;;;ACLO,IAAM,qBAAqB;AAC3B,IAAM,yBAAyB;AAE/B,IAAM,oBAAoB;AAQ1B,SAAS,aAAgB,KAAQ,KAAiC;AACvE,MAAI,IAAI,WAAY,QAAO,IAAI,WAAW,GAAG;AAC7C,MAAI,IAAI,aAAa;AACnB,WAAQ,IAAgC,IAAI,WAAW;AAAA,EACzD;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,OAAwB;AACzD,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;AAC3D,WAAO,OAAO,KAAK;AAAA,EACrB;AACA,MAAI,iBAAiB,KAAM,QAAO,MAAM,YAAY;AACpD,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAgDO,SAAS,iBAAiB,OAA0B;AACzD,UAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GAC1C,IAAI,kBAAkB,EACtB,OAAO,CAAC,SAAS,SAAS,EAAE;AACjC;;;AClGA,IAAM,yBAAyB;AAQxB,SAAS,kBACd,KACA,YAC2B;AAC3B,MAAI,IAAI,WAAW,MAAO,QAAO;AACjC,MAAI,IAAI,UAAU,IAAI,WAAW,OAAQ,QAAO,IAAI;AACpD,MAAI,oBAAoB,GAAG,EAAG,QAAO;AAErC,QAAM,SAAS,WACZ,MAAM,GAAG,GAAG,EACZ,IAAI,CAAC,QAAQ,aAAa,KAAK,GAAG,CAAC,EACnC,OAAO,CAAC,MAAM,KAAK,IAAI;AAE1B,MAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,MAAI,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,SAAS,EAAG,QAAO;AACxD,MAAI,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,CAAC,GAAG;AACpE,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,OAAO,QAAQ,gBAAgB;AAC/C,QAAM,SAAS,IAAI,IAAI,OAAO;AAC9B,MACE,OAAO,QAAQ,KACf,OAAO,QAAQ,0BACf,OAAO,OAAO,QAAQ,SAAS,KAC/B;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,qBACd,KACA,MACyC;AACzC,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,UAAmD,CAAC;AAC1D,MAAI,WAAW;AACf,MAAI,qBAAqB;AACzB,aAAW,OAAO,MAAM;AACtB,UAAM,OAAO,aAAa,KAAK,GAAG;AAClC,UAAM,SAAS,iBAAiB,IAAI;AACpC,QAAI,OAAO,WAAW,GAAG;AACvB,iBAAW;AACX,UAAI,MAAM,QAAQ,IAAI,EAAG,sBAAqB;AAC9C;AAAA,IACF;AACA,eAAW,SAAS,QAAQ;AAC1B,UAAI,IAAI,eAAe,UAAU,KAAK,IAAI,KAAK,EAAG;AAClD,WAAK,IAAI,KAAK;AACd,cAAQ,KAAK,EAAE,OAAO,OAAO,MAAM,CAAC;AAAA,IACtC;AAAA,EACF;AACA,QAAM,OAAO,IAAI,eAAe,SAC5B,IAAI,cAAc,IAAI,CAAC,YAAY;AAAA,IACjC,GAAG;AAAA,IACH,OAAO,OAAO,MAAM,KAAK,IAAI,OAAO,QAAQ,OAAO,UAAU,KAAK,mBAAmB,OAAO,MAAM,KAAK,IAAI,OAAO,QAAQ;AAAA,EAC5H,EAAE,IACF,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,CAAC;AAGzD,MAAI,UAAU;AAKZ,UAAM,cAAc,CAAC,sBAAsB,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,EAAE,IAChF,EAAE,OAAO,mBAAmB,OAAO,SAAS,IAC5C,EAAE,OAAO,oBAAoB,OAAO,UAAU;AAClD,UAAM,YAAY,CAAC;AACnB,QAAI,CAAC,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,YAAY,KAAK,EAAG,WAAU,KAAK,WAAW;AAC1F,QAAI,CAAC,KAAK,KAAK,CAAC,WAAW,OAAO,UAAU,sBAAsB,GAAG;AACnE,gBAAU,KAAK,EAAE,OAAO,wBAAwB,OAAO,cAAc,CAAC;AAAA,IACxE;AACA,SAAK,QAAQ,GAAG,SAAS;AAAA,EAC3B;AACA,SAAO;AACT;AAEO,SAAS,gBACd,MACQ;AACR,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}
+{"version":3,"sources":["../../src/data-table/column-marker.ts","../../src/data-table/filter-engine.ts","../../src/data-table/infer-filter.ts"],"sourcesContent":["import type { ColumnMarker, MatrxColumnDef } from \"./types\";\n\nexport type ResolvedColumnMarker = Exclude<ColumnMarker, false>;\n\nconst MARKER_ACCESSORS: Readonly<Record<string, ResolvedColumnMarker>> = {\n  favorite: \"favorite\",\n  is_favorite: \"favorite\",\n  favourite: \"favorite\",\n  is_favourite: \"favorite\",\n  pinned: \"pin\",\n  is_pinned: \"pin\",\n};\n\n/**\n * Resolve the semantic without guessing from partial names. A field such as\n * `favorite_count` is not a marker; consumers can always opt in explicitly.\n */\nexport function resolveColumnMarker<T>(\n  column: MatrxColumnDef<T>,\n): ResolvedColumnMarker | undefined {\n  if (column.marker === false) return undefined;\n  if (column.marker) return column.marker;\n  return column.accessorKey ? MARKER_ACCESSORS[column.accessorKey] : undefined;\n}\n\nexport function markerCopy(marker: ResolvedColumnMarker): {\n  label: string;\n  lowerLabel: string;\n  onlyLabel: string;\n  notLabel: string;\n} {\n  return marker === \"favorite\"\n    ? {\n        label: \"Favorites\",\n        lowerLabel: \"favorites\",\n        onlyLabel: \"Favorites only\",\n        notLabel: \"Not favorites\",\n      }\n    : {\n        label: \"Pins\",\n        lowerLabel: \"pins\",\n        onlyLabel: \"Pins only\",\n        notLabel: \"Not pinned\",\n      };\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\nimport { dateFilterBounds } from \"./date-filter\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n/** Exact SQL-style NULL selection, distinct from the empty-cell option. */\nexport const SELECT_NULL_VALUE = \"__null__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\n/** Select filters treat array-valued cells as sets, never as serialized JSON choices. */\nexport function selectCellValues(value: unknown): string[] {\n  return (Array.isArray(value) ? value : [value])\n    .map(stringifyCellValue)\n    .filter((item) => item !== \"\");\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      // `values: []` is an explicit multi-select state: the user deselected\n      // every option, so it must produce an empty result. Legacy single-value\n      // filters and an absent `values` field retain their clear/all behavior.\n      if (filter.values !== undefined && filter.values.length === 0) {\n        return false;\n      }\n      const selected = filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const values = selectCellValues(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_NULL_VALUE\n          ? value == null\n          : v === SELECT_EMPTY_VALUE\n          ? values.length === 0\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? values.length > 0\n            : v === \"\"\n              ? value === \"\" || (Array.isArray(value) && value.includes(\"\"))\n              : values.includes(v),\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      // A missing cell is not zero. Without this guard, Number(\"\") made a\n      // blank numeric value pass filters whose range included zero.\n      const raw = stringifyCellValue(value).trim();\n      if (raw === \"\") return false;\n      const normalized = raw.replace(/[^0-9.-]/g, \"\");\n      if (normalized === \"\") return false;\n      const n = typeof value === \"number\"\n        ? value\n        : Number(normalized);\n      if (!Number.isFinite(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    case \"date\": {\n      const raw = value instanceof Date ? value : new Date(stringifyCellValue(value));\n      if (Number.isNaN(raw.valueOf())) return false;\n      const { since, until } = dateFilterBounds(filter);\n      const timestamp = raw.valueOf();\n      if (since !== undefined) {\n        const sinceTimestamp = new Date(since).valueOf();\n        if (Number.isNaN(sinceTimestamp) || timestamp < sinceTimestamp) return false;\n      }\n      if (until !== undefined) {\n        const untilTimestamp = new Date(until).valueOf();\n        if (Number.isNaN(untilTimestamp) || timestamp >= untilTimestamp) return false;\n      }\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values !== undefined || (f.value && f.value !== \"__all__\"))\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n    case \"number\":\n      if (f.min !== undefined || f.max !== undefined) n += 1;\n      break;\n    case \"date\":\n      if (isColumnFilterActive(f)) n += 1;\n      break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values !== undefined\n        ? true\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n    case \"date\": {\n      const bounds = dateFilterBounds(filter);\n      return bounds.since !== undefined || bounds.until !== undefined;\n    }\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n","import type { ColumnFilterKind, MatrxColumnDef } from \"./types\";\nimport { resolveColumnMarker } from \"./column-marker\";\nimport {\n  SELECT_EMPTY_VALUE,\n  SELECT_NOT_EMPTY_VALUE,\n  SELECT_NULL_VALUE,\n  getCellValue,\n  selectCellValues,\n} from \"./filter-engine\";\n\n/** Auto-inference switches to text above this many distinct values… */\nconst SELECT_CARDINALITY_CAP = 24;\n\nexport type ResolvedFilterKind = \"text\" | \"select\" | \"boolean\" | \"number\" | \"date\";\n\n/**\n * Infer a filter UI from sample row values. Prefer select for low-cardinality\n * string/enum columns, boolean for booleans, number for numeric, else text.\n */\nexport function resolveFilterKind<T>(\n  col: MatrxColumnDef<T>,\n  sampleRows: T[],\n): ResolvedFilterKind | null {\n  if (col.filter === false) return null;\n  if (col.filter && col.filter !== \"auto\") return col.filter;\n  if (resolveColumnMarker(col)) return \"boolean\";\n\n  const values = sampleRows\n    .slice(0, 200)\n    .map((row) => getCellValue(row, col))\n    .filter((v) => v != null);\n\n  if (values.length === 0) return \"text\";\n\n  if (values.every((v) => typeof v === \"boolean\")) return \"boolean\";\n  if (values.every((v) => typeof v === \"number\" && Number.isFinite(v))) {\n    return \"number\";\n  }\n\n  const strings = values.flatMap(selectCellValues);\n  const unique = new Set(strings);\n  if (\n    unique.size >= 1 &&\n    unique.size <= SELECT_CARDINALITY_CAP &&\n    unique.size < strings.length * 0.6\n  ) {\n    return \"select\";\n  }\n\n  return \"text\";\n}\n\nexport function collectSelectOptions<T>(\n  col: MatrxColumnDef<T>,\n  rows: T[],\n): Array<{ value: string; label: string }> {\n  const seen = new Set<string>();\n  const options: Array<{ value: string; label: string }> = [];\n  let hasEmpty = false;\n  let hasEmptyCollection = false;\n  for (const row of rows) {\n    const cell = getCellValue(row, col);\n    const values = selectCellValues(cell);\n    if (values.length === 0) {\n      hasEmpty = true;\n      if (Array.isArray(cell)) hasEmptyCollection = true;\n      continue;\n    }\n    for (const value of values) {\n      if (col.filterOptions?.length || seen.has(value)) continue;\n      seen.add(value);\n      options.push({ value, label: value });\n    }\n  }\n  const base = col.filterOptions?.length\n    ? col.filterOptions.map((option) => ({\n        ...option,\n        label: option.label.trim() ? option.label : option.value === \"\" ? \"(empty string)\" : option.value.trim() ? option.value : \"(whitespace)\",\n      }))\n    : options.sort((a, b) => a.label.localeCompare(b.label));\n  // Emptiness sentinels: whenever the column has blank cells, every select\n  // filter can isolate them — or exclude them — with zero per-table config.\n  if (hasEmpty) {\n    // An explicit literal-empty choice must remain independently deselectable.\n    // The combined empty sentinel would overlap it after All -> uncheck.\n    // Empty collections still require that broader option: neither null nor\n    // a literal empty string represents an empty array.\n    const emptyOption = !hasEmptyCollection && base.some((option) => option.value === \"\")\n      ? { value: SELECT_NULL_VALUE, label: \"(null)\" }\n      : { value: SELECT_EMPTY_VALUE, label: \"(empty)\" };\n    const additions = [];\n    if (!base.some((option) => option.value === emptyOption.value)) additions.push(emptyOption);\n    if (!base.some((option) => option.value === SELECT_NOT_EMPTY_VALUE)) {\n      additions.push({ value: SELECT_NOT_EMPTY_VALUE, label: \"(not empty)\" });\n    }\n    base.unshift(...additions);\n  }\n  return base;\n}\n\nexport function filterKindLabel(\n  kind: ColumnFilterKind | ResolvedFilterKind,\n): string {\n  switch (kind) {\n    case \"text\":\n      return \"Text\";\n    case \"select\":\n      return \"Select\";\n    case \"boolean\":\n      return \"Boolean\";\n    case \"number\":\n      return \"Number\";\n    case \"date\":\n      return \"Date\";\n    case \"auto\":\n      return \"Auto\";\n    case false:\n      return \"Off\";\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/layered-filters.d.cts

@@ -1,4 +1,4 @@
-export { ap as LAYERED_FILTER_OPERATORS, aq as LAYERED_FILTER_OPERATOR_LABELS, ar as LayeredFilterField, as as LayeredFilterOperator, L as LayeredFilterRule, at as columnFiltersToLayeredRules, au as completeLayeredFilterRules, av as decodeLayeredFilterRules, aw as encodeLayeredFilterRules, ax as isCompleteLayeredFilterRule, ay as isLayeredFilterOperator, az as layeredFilterMatchesValue, aA as layeredFilterNeedsValue, aB as layeredFilterRuleSummary, aC as operatorsForLayeredField } from '../types-CmQrOz-T.cjs';
+export { aq as LAYERED_FILTER_OPERATORS, ar as LAYERED_FILTER_OPERATOR_LABELS, as as LayeredFilterField, at as LayeredFilterOperator, L as LayeredFilterRule, au as columnFiltersToLayeredRules, av as completeLayeredFilterRules, aw as decodeLayeredFilterRules, ax as encodeLayeredFilterRules, ay as isCompleteLayeredFilterRule, az as isLayeredFilterOperator, aA as layeredFilterMatchesValue, aB as layeredFilterNeedsValue, aC as layeredFilterRuleSummary, aD as operatorsForLayeredField } from '../types-jQddSUnj.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,5 +7,7 @@ import './copy-types.cjs';
 import '../types-CJWU1Gae.cjs';
 import './grouping.cjs';
 import './fill.cjs';
+import './facets.cjs';
 import './spreadsheet.cjs';
 import './grid-selection.cjs';
+import './date-filter.cjs';

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

@@ -1,4 +1,4 @@
-export { ap as LAYERED_FILTER_OPERATORS, aq as LAYERED_FILTER_OPERATOR_LABELS, ar as LayeredFilterField, as as LayeredFilterOperator, L as LayeredFilterRule, at as columnFiltersToLayeredRules, au as completeLayeredFilterRules, av as decodeLayeredFilterRules, aw as encodeLayeredFilterRules, ax as isCompleteLayeredFilterRule, ay as isLayeredFilterOperator, az as layeredFilterMatchesValue, aA as layeredFilterNeedsValue, aB as layeredFilterRuleSummary, aC as operatorsForLayeredField } from '../types-nlLCMiqd.js';
+export { aq as LAYERED_FILTER_OPERATORS, ar as LAYERED_FILTER_OPERATOR_LABELS, as as LayeredFilterField, at as LayeredFilterOperator, L as LayeredFilterRule, au as columnFiltersToLayeredRules, av as completeLayeredFilterRules, aw as decodeLayeredFilterRules, ax as encodeLayeredFilterRules, ay as isCompleteLayeredFilterRule, az as isLayeredFilterOperator, aA as layeredFilterMatchesValue, aB as layeredFilterNeedsValue, aC as layeredFilterRuleSummary, aD as operatorsForLayeredField } from '../types-D9JBR6ZU.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,5 +7,7 @@ import './copy-types.js';
 import '../types-CJWU1Gae.js';
 import './grouping.js';
 import './fill.js';
+import './facets.js';
 import './spreadsheet.js';
 import './grid-selection.js';
+import './date-filter.js';

package/dist/data-table/menu-targets.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/data-table/menu-targets.ts
+var menu_targets_exports = {};
+__export(menu_targets_exports, {
+  MATRX_CELL_COLUMN_ATTR: () => MATRX_CELL_COLUMN_ATTR,
+  MATRX_CELL_ROW_ATTR: () => MATRX_CELL_ROW_ATTR,
+  MATRX_CELL_SELECTED_ATTR: () => MATRX_CELL_SELECTED_ATTR,
+  MATRX_HEADER_COLUMN_ATTR: () => MATRX_HEADER_COLUMN_ATTR,
+  MATRX_ROW_ID_ATTR: () => MATRX_ROW_ID_ATTR,
+  MATRX_TABLE_ID_ATTR: () => MATRX_TABLE_ID_ATTR,
+  describeMenuLevel: () => describeMenuLevel,
+  readMenuTarget: () => readMenuTarget
+});
+module.exports = __toCommonJS(menu_targets_exports);
+var MATRX_TABLE_ID_ATTR = "data-matrx-table-id";
+var MATRX_ROW_ID_ATTR = "data-row-id";
+var MATRX_CELL_ROW_ATTR = "data-matrx-cell-row";
+var MATRX_CELL_COLUMN_ATTR = "data-matrx-table-column-id";
+var MATRX_HEADER_COLUMN_ATTR = "data-matrx-header-column-id";
+var MATRX_CELL_SELECTED_ATTR = "data-matrx-cell-selected";
+function attr(element, name) {
+  if (!element) return void 0;
+  const found = element.closest(`[${name}]`);
+  const value = found?.getAttribute(name);
+  return value === null || value === void 0 || value === "" ? void 0 : value;
+}
+function readMenuTarget(target) {
+  const tableId = attr(target, MATRX_TABLE_ID_ATTR);
+  if (!tableId) return null;
+  const headerColumnId = attr(target, MATRX_HEADER_COLUMN_ATTR);
+  if (headerColumnId) return { tableId, level: "column", columnId: headerColumnId };
+  const cellColumnId = attr(target, MATRX_CELL_COLUMN_ATTR);
+  const cellRowId = attr(target, MATRX_ROW_ID_ATTR) ?? attr(target, MATRX_CELL_ROW_ATTR);
+  const rowId = cellRowId;
+  if (cellRowId && cellColumnId) {
+    const selected = attr(target, MATRX_CELL_SELECTED_ATTR) === "true";
+    if (selected) return { tableId, level: "selection", rowId: cellRowId, columnId: cellColumnId };
+    return { tableId, level: "cell", rowId: cellRowId, columnId: cellColumnId };
+  }
+  if (rowId) return { tableId, level: "row", rowId };
+  return { tableId, level: "table" };
+}
+function describeMenuLevel(payload) {
+  switch (payload.level) {
+    case "cell":
+      return payload.columnLabel;
+    case "row":
+      return "Row";
+    case "column":
+      return payload.columnLabel;
+    case "selection": {
+      const cells = payload.cellCount;
+      return `${cells} ${cells === 1 ? "cell" : "cells"}`;
+    }
+    case "table":
+      return "Table";
+  }
+}
+//# sourceMappingURL=menu-targets.cjs.map

package/dist/data-table/menu-targets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-table/menu-targets.ts"],"sourcesContent":["/**\n * @ai-matrx/design-system/data-table — WHAT WAS RIGHT-CLICKED.\n *\n * A spreadsheet's right-click menu is not one menu: it is four, and which one\n * you get is decided by where the pointer was. A cell, the row it sits in, the\n * column it sits under, and — when the click lands inside an extended range —\n * the selection. The canonical table used to expose exactly ONE of those four\n * (the row), so every surface that wanted the other three forked the table.\n *\n * This module is the pure half of the fix: it reads the four levels off the\n * DOM anchors the table already renders, and nothing more. It does not build a\n * menu, name an action, or know what a menu is — the platform's universal\n * right-click menu is an application concern and stays there. The table's job\n * is to answer, truthfully, WHICH thing the person aimed at.\n *\n * THE PRECEDENCE, and why it is this way:\n *\n *   selection > cell > column > row > table\n *\n * A click inside an extended range means the range, because that is what the\n * person is looking at and what every spreadsheet acts on — taking the single\n * cell under the cursor there would silently throw away their selection. A\n * header click is the column even though the header is inside the table. A\n * click on a row but outside any cell (the checkbox gutter, the actions cell)\n * is the row. Anything else in the table is the table.\n *\n * Pure: no React, no package state. It reads `data-*` attributes and returns a\n * plain object. Nothing here throws on any input.\n */\n\n/** Which of the four things the pointer was aimed at. */\nexport type MatrxTableMenuLevel = \"cell\" | \"row\" | \"column\" | \"selection\" | \"table\";\n\nexport interface MatrxTableMenuTarget {\n  /** The table instance the click landed in. */\n  tableId: string;\n  level: MatrxTableMenuLevel;\n  /** Present for \"cell\" and \"row\". */\n  rowId?: string;\n  /** Present for \"cell\" and \"column\". */\n  columnId?: string;\n}\n\n/**\n * Attribute names, in one place, so the renderer and the reader cannot drift.\n * `data-row-id` predates this module and keeps its name: it is already read by\n * the row-drag preview and by every host that wired the row menu.\n */\nexport const MATRX_TABLE_ID_ATTR = \"data-matrx-table-id\";\nexport const MATRX_ROW_ID_ATTR = \"data-row-id\";\nexport const MATRX_CELL_ROW_ATTR = \"data-matrx-cell-row\";\nexport const MATRX_CELL_COLUMN_ATTR = \"data-matrx-table-column-id\";\nexport const MATRX_HEADER_COLUMN_ATTR = \"data-matrx-header-column-id\";\n/** Marks a cell that is inside the current extended range. */\nexport const MATRX_CELL_SELECTED_ATTR = \"data-matrx-cell-selected\";\n\ninterface MinimalElement {\n  closest(selector: string): MinimalElement | null;\n  getAttribute(name: string): string | null;\n}\n\nfunction attr(element: MinimalElement | null, name: string): string | undefined {\n  if (!element) return undefined;\n  const found = element.closest(`[${name}]`);\n  const value = found?.getAttribute(name);\n  return value === null || value === undefined || value === \"\" ? undefined : value;\n}\n\n/**\n * Read the four levels off the clicked element.\n *\n * Returns null when the click did not land in a canonical table at all — which\n * is the signal a host needs to leave its own page-level menu alone.\n */\nexport function readMenuTarget(\n  target: MinimalElement | null,\n): MatrxTableMenuTarget | null {\n  const tableId = attr(target, MATRX_TABLE_ID_ATTR);\n  if (!tableId) return null;\n\n  const headerColumnId = attr(target, MATRX_HEADER_COLUMN_ATTR);\n  if (headerColumnId) return { tableId, level: \"column\", columnId: headerColumnId };\n\n  // A cell's row comes from the `<tr>` it is in, which every table renders —\n  // the spreadsheet cursor's own row attribute is a second opinion, used only\n  // when the table is windowed sideways and the row wrapper is not an ancestor.\n  const cellColumnId = attr(target, MATRX_CELL_COLUMN_ATTR);\n  const cellRowId = attr(target, MATRX_ROW_ID_ATTR) ?? attr(target, MATRX_CELL_ROW_ATTR);\n  const rowId = cellRowId;\n\n  if (cellRowId && cellColumnId) {\n    // Inside an extended range the SELECTION is what the person sees and what\n    // the menu must act on. A range of one cell is not a range — acting on it\n    // as a selection would give a lone cell the plural verbs.\n    const selected = attr(target, MATRX_CELL_SELECTED_ATTR) === \"true\";\n    if (selected) return { tableId, level: \"selection\", rowId: cellRowId, columnId: cellColumnId };\n    return { tableId, level: \"cell\", rowId: cellRowId, columnId: cellColumnId };\n  }\n\n  if (rowId) return { tableId, level: \"row\", rowId };\n  return { tableId, level: \"table\" };\n}\n\n/**\n * The payload the table hands its host for the level that was clicked.\n *\n * The host builds the menu from this and never reaches back into the table.\n * Every level carries the table's own count of what it is acting on, because a\n * menu that says \"Clear 12 cells\" and clears 40 is worse than one that says\n * nothing.\n */\nexport type MatrxTableMenuPayload<T = unknown> =\n  | {\n      level: \"cell\";\n      row: T;\n      rowId: string;\n      columnId: string;\n      columnLabel: string;\n      value: unknown;\n      /** The cell's value as the table displays it, for Copy. */\n      text: string;\n      controls: unknown;\n    }\n  | { level: \"row\"; row: T; rowId: string; controls: unknown }\n  | {\n      level: \"column\";\n      columnId: string;\n      columnLabel: string;\n      /** Every rendered row's value for this column, in visual order. */\n      values: unknown[];\n    }\n  | {\n      level: \"selection\";\n      rowIds: string[];\n      columnIds: string[];\n      /** The selected rectangle as an Excel/Sheets-compatible TSV block. */\n      tsv: string;\n      cellCount: number;\n    }\n  | { level: \"table\"; rowCount: number; columnIds: string[] };\n\n/** Plain-English name for a level, for a host that labels its sections. */\nexport function describeMenuLevel(payload: MatrxTableMenuPayload): string {\n  switch (payload.level) {\n    case \"cell\":\n      return payload.columnLabel;\n    case \"row\":\n      return \"Row\";\n    case \"column\":\n      return payload.columnLabel;\n    case \"selection\": {\n      const cells = payload.cellCount;\n      return `${cells} ${cells === 1 ? \"cell\" : \"cells\"}`;\n    }\n    case \"table\":\n      return \"Table\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgDO,IAAM,sBAAsB;AAC5B,IAAM,oBAAoB;AAC1B,IAAM,sBAAsB;AAC5B,IAAM,yBAAyB;AAC/B,IAAM,2BAA2B;AAEjC,IAAM,2BAA2B;AAOxC,SAAS,KAAK,SAAgC,MAAkC;AAC9E,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,QAAQ,QAAQ,QAAQ,IAAI,IAAI,GAAG;AACzC,QAAM,QAAQ,OAAO,aAAa,IAAI;AACtC,SAAO,UAAU,QAAQ,UAAU,UAAa,UAAU,KAAK,SAAY;AAC7E;AAQO,SAAS,eACd,QAC6B;AAC7B,QAAM,UAAU,KAAK,QAAQ,mBAAmB;AAChD,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,iBAAiB,KAAK,QAAQ,wBAAwB;AAC5D,MAAI,eAAgB,QAAO,EAAE,SAAS,OAAO,UAAU,UAAU,eAAe;AAKhF,QAAM,eAAe,KAAK,QAAQ,sBAAsB;AACxD,QAAM,YAAY,KAAK,QAAQ,iBAAiB,KAAK,KAAK,QAAQ,mBAAmB;AACrF,QAAM,QAAQ;AAEd,MAAI,aAAa,cAAc;AAI7B,UAAM,WAAW,KAAK,QAAQ,wBAAwB,MAAM;AAC5D,QAAI,SAAU,QAAO,EAAE,SAAS,OAAO,aAAa,OAAO,WAAW,UAAU,aAAa;AAC7F,WAAO,EAAE,SAAS,OAAO,QAAQ,OAAO,WAAW,UAAU,aAAa;AAAA,EAC5E;AAEA,MAAI,MAAO,QAAO,EAAE,SAAS,OAAO,OAAO,MAAM;AACjD,SAAO,EAAE,SAAS,OAAO,QAAQ;AACnC;AAyCO,SAAS,kBAAkB,SAAwC;AACxE,UAAQ,QAAQ,OAAO;AAAA,IACrB,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK,aAAa;AAChB,YAAM,QAAQ,QAAQ;AACtB,aAAO,GAAG,KAAK,IAAI,UAAU,IAAI,SAAS,OAAO;AAAA,IACnD;AAAA,IACA,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/data-table/menu-targets.d.cts

@@ -0,0 +1,108 @@
+/**
+ * @ai-matrx/design-system/data-table — WHAT WAS RIGHT-CLICKED.
+ *
+ * A spreadsheet's right-click menu is not one menu: it is four, and which one
+ * you get is decided by where the pointer was. A cell, the row it sits in, the
+ * column it sits under, and — when the click lands inside an extended range —
+ * the selection. The canonical table used to expose exactly ONE of those four
+ * (the row), so every surface that wanted the other three forked the table.
+ *
+ * This module is the pure half of the fix: it reads the four levels off the
+ * DOM anchors the table already renders, and nothing more. It does not build a
+ * menu, name an action, or know what a menu is — the platform's universal
+ * right-click menu is an application concern and stays there. The table's job
+ * is to answer, truthfully, WHICH thing the person aimed at.
+ *
+ * THE PRECEDENCE, and why it is this way:
+ *
+ *   selection > cell > column > row > table
+ *
+ * A click inside an extended range means the range, because that is what the
+ * person is looking at and what every spreadsheet acts on — taking the single
+ * cell under the cursor there would silently throw away their selection. A
+ * header click is the column even though the header is inside the table. A
+ * click on a row but outside any cell (the checkbox gutter, the actions cell)
+ * is the row. Anything else in the table is the table.
+ *
+ * Pure: no React, no package state. It reads `data-*` attributes and returns a
+ * plain object. Nothing here throws on any input.
+ */
+/** Which of the four things the pointer was aimed at. */
+type MatrxTableMenuLevel = "cell" | "row" | "column" | "selection" | "table";
+interface MatrxTableMenuTarget {
+    /** The table instance the click landed in. */
+    tableId: string;
+    level: MatrxTableMenuLevel;
+    /** Present for "cell" and "row". */
+    rowId?: string;
+    /** Present for "cell" and "column". */
+    columnId?: string;
+}
+/**
+ * Attribute names, in one place, so the renderer and the reader cannot drift.
+ * `data-row-id` predates this module and keeps its name: it is already read by
+ * the row-drag preview and by every host that wired the row menu.
+ */
+declare const MATRX_TABLE_ID_ATTR = "data-matrx-table-id";
+declare const MATRX_ROW_ID_ATTR = "data-row-id";
+declare const MATRX_CELL_ROW_ATTR = "data-matrx-cell-row";
+declare const MATRX_CELL_COLUMN_ATTR = "data-matrx-table-column-id";
+declare const MATRX_HEADER_COLUMN_ATTR = "data-matrx-header-column-id";
+/** Marks a cell that is inside the current extended range. */
+declare const MATRX_CELL_SELECTED_ATTR = "data-matrx-cell-selected";
+interface MinimalElement {
+    closest(selector: string): MinimalElement | null;
+    getAttribute(name: string): string | null;
+}
+/**
+ * Read the four levels off the clicked element.
+ *
+ * Returns null when the click did not land in a canonical table at all — which
+ * is the signal a host needs to leave its own page-level menu alone.
+ */
+declare function readMenuTarget(target: MinimalElement | null): MatrxTableMenuTarget | null;
+/**
+ * The payload the table hands its host for the level that was clicked.
+ *
+ * The host builds the menu from this and never reaches back into the table.
+ * Every level carries the table's own count of what it is acting on, because a
+ * menu that says "Clear 12 cells" and clears 40 is worse than one that says
+ * nothing.
+ */
+type MatrxTableMenuPayload<T = unknown> = {
+    level: "cell";
+    row: T;
+    rowId: string;
+    columnId: string;
+    columnLabel: string;
+    value: unknown;
+    /** The cell's value as the table displays it, for Copy. */
+    text: string;
+    controls: unknown;
+} | {
+    level: "row";
+    row: T;
+    rowId: string;
+    controls: unknown;
+} | {
+    level: "column";
+    columnId: string;
+    columnLabel: string;
+    /** Every rendered row's value for this column, in visual order. */
+    values: unknown[];
+} | {
+    level: "selection";
+    rowIds: string[];
+    columnIds: string[];
+    /** The selected rectangle as an Excel/Sheets-compatible TSV block. */
+    tsv: string;
+    cellCount: number;
+} | {
+    level: "table";
+    rowCount: number;
+    columnIds: string[];
+};
+/** Plain-English name for a level, for a host that labels its sections. */
+declare function describeMenuLevel(payload: MatrxTableMenuPayload): string;
+
+export { MATRX_CELL_COLUMN_ATTR, MATRX_CELL_ROW_ATTR, MATRX_CELL_SELECTED_ATTR, MATRX_HEADER_COLUMN_ATTR, MATRX_ROW_ID_ATTR, MATRX_TABLE_ID_ATTR, type MatrxTableMenuLevel, type MatrxTableMenuPayload, type MatrxTableMenuTarget, describeMenuLevel, readMenuTarget };

package/dist/data-table/menu-targets.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @ai-matrx/design-system/data-table — WHAT WAS RIGHT-CLICKED.
+ *
+ * A spreadsheet's right-click menu is not one menu: it is four, and which one
+ * you get is decided by where the pointer was. A cell, the row it sits in, the
+ * column it sits under, and — when the click lands inside an extended range —
+ * the selection. The canonical table used to expose exactly ONE of those four
+ * (the row), so every surface that wanted the other three forked the table.
+ *
+ * This module is the pure half of the fix: it reads the four levels off the
+ * DOM anchors the table already renders, and nothing more. It does not build a
+ * menu, name an action, or know what a menu is — the platform's universal
+ * right-click menu is an application concern and stays there. The table's job
+ * is to answer, truthfully, WHICH thing the person aimed at.
+ *
+ * THE PRECEDENCE, and why it is this way:
+ *
+ *   selection > cell > column > row > table
+ *
+ * A click inside an extended range means the range, because that is what the
+ * person is looking at and what every spreadsheet acts on — taking the single
+ * cell under the cursor there would silently throw away their selection. A
+ * header click is the column even though the header is inside the table. A
+ * click on a row but outside any cell (the checkbox gutter, the actions cell)
+ * is the row. Anything else in the table is the table.
+ *
+ * Pure: no React, no package state. It reads `data-*` attributes and returns a
+ * plain object. Nothing here throws on any input.
+ */
+/** Which of the four things the pointer was aimed at. */
+type MatrxTableMenuLevel = "cell" | "row" | "column" | "selection" | "table";
+interface MatrxTableMenuTarget {
+    /** The table instance the click landed in. */
+    tableId: string;
+    level: MatrxTableMenuLevel;
+    /** Present for "cell" and "row". */
+    rowId?: string;
+    /** Present for "cell" and "column". */
+    columnId?: string;
+}
+/**
+ * Attribute names, in one place, so the renderer and the reader cannot drift.
+ * `data-row-id` predates this module and keeps its name: it is already read by
+ * the row-drag preview and by every host that wired the row menu.
+ */
+declare const MATRX_TABLE_ID_ATTR = "data-matrx-table-id";
+declare const MATRX_ROW_ID_ATTR = "data-row-id";
+declare const MATRX_CELL_ROW_ATTR = "data-matrx-cell-row";
+declare const MATRX_CELL_COLUMN_ATTR = "data-matrx-table-column-id";
+declare const MATRX_HEADER_COLUMN_ATTR = "data-matrx-header-column-id";
+/** Marks a cell that is inside the current extended range. */
+declare const MATRX_CELL_SELECTED_ATTR = "data-matrx-cell-selected";
+interface MinimalElement {
+    closest(selector: string): MinimalElement | null;
+    getAttribute(name: string): string | null;
+}
+/**
+ * Read the four levels off the clicked element.
+ *
+ * Returns null when the click did not land in a canonical table at all — which
+ * is the signal a host needs to leave its own page-level menu alone.
+ */
+declare function readMenuTarget(target: MinimalElement | null): MatrxTableMenuTarget | null;
+/**
+ * The payload the table hands its host for the level that was clicked.
+ *
+ * The host builds the menu from this and never reaches back into the table.
+ * Every level carries the table's own count of what it is acting on, because a
+ * menu that says "Clear 12 cells" and clears 40 is worse than one that says
+ * nothing.
+ */
+type MatrxTableMenuPayload<T = unknown> = {
+    level: "cell";
+    row: T;
+    rowId: string;
+    columnId: string;
+    columnLabel: string;
+    value: unknown;
+    /** The cell's value as the table displays it, for Copy. */
+    text: string;
+    controls: unknown;
+} | {
+    level: "row";
+    row: T;
+    rowId: string;
+    controls: unknown;
+} | {
+    level: "column";
+    columnId: string;
+    columnLabel: string;
+    /** Every rendered row's value for this column, in visual order. */
+    values: unknown[];
+} | {
+    level: "selection";
+    rowIds: string[];
+    columnIds: string[];
+    /** The selected rectangle as an Excel/Sheets-compatible TSV block. */
+    tsv: string;
+    cellCount: number;
+} | {
+    level: "table";
+    rowCount: number;
+    columnIds: string[];
+};
+/** Plain-English name for a level, for a host that labels its sections. */
+declare function describeMenuLevel(payload: MatrxTableMenuPayload): string;
+
+export { MATRX_CELL_COLUMN_ATTR, MATRX_CELL_ROW_ATTR, MATRX_CELL_SELECTED_ATTR, MATRX_HEADER_COLUMN_ATTR, MATRX_ROW_ID_ATTR, MATRX_TABLE_ID_ATTR, type MatrxTableMenuLevel, type MatrxTableMenuPayload, type MatrxTableMenuTarget, describeMenuLevel, readMenuTarget };