@eifi1/ui-kit 0.33.1 → 0.34.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/data-table-filters.ts"],"sourcesContent":["import type { DataTableColumn } from \"./data-table\";\n\n/** How a column is filtered. `text`/`select`/`date`/`number` each read a value\n *  off the row and compare it against the user's {@link FilterValue}. */\nexport type ColumnFilter<T> =\n  | { type: \"text\"; getValue: (row: T) => string }\n  | { type: \"select\"; getValue: (row: T) => string; options?: { value: string; label?: string }[] }\n  | { type: \"date\"; getValue: (row: T) => string | null | undefined }\n  | { type: \"number\"; getValue: (row: T) => number | null | undefined };\n\n/** The current state of a column's filter (what the user has entered). */\nexport type FilterValue =\n  | { type: \"text\"; q: string }\n  | { type: \"select\"; values: string[] }\n  | { type: \"date\"; from: string; to: string }\n  | { type: \"number\"; min: string; max: string; abs: boolean };\n\n/** A column's filter config, falling back to a plain text filter over `filterBy`. */\nexport function resolveFilter<T>(col: DataTableColumn<T>): ColumnFilter<T> | null {\n  if (col.filter) return col.filter;\n  if (col.filterBy) return { type: \"text\", getValue: col.filterBy };\n  return null;\n}\n\n/** Whether a filter value is actually narrowing anything (vs its empty default). */\nexport function isFilterActive(v: FilterValue | undefined): boolean {\n  if (!v) return false;\n  switch (v.type) {\n    case \"text\":\n      return v.q.trim().length > 0;\n    case \"select\":\n      return v.values.length > 0;\n    case \"date\":\n      return !!v.from || !!v.to;\n    case \"number\":\n      return v.min !== \"\" || v.max !== \"\" || v.abs;\n  }\n}\n\n/**\n * Whether `row` passes column `col`'s filter given the user's `state`.\n *\n * `locale` is for the text filter's case folding. Plain `toLowerCase` folds by the\n * root rules, under which a Turkish user typing \"istanbul\" does not find \"İSTANBUL\";\n * `toLocaleLowerCase(locale)` does. Optional, and `undefined` is the runtime's default.\n */\nexport function rowMatches<T>(\n  col: DataTableColumn<T>,\n  row: T,\n  state: FilterValue,\n  locale?: string,\n): boolean {\n  const filter = resolveFilter(col);\n  if (!filter) return true;\n  switch (filter.type) {\n    case \"text\": {\n      if (state.type !== \"text\" || !state.q.trim()) return true;\n      return filter\n        .getValue(row)\n        .toLocaleLowerCase(locale)\n        .includes(state.q.trim().toLocaleLowerCase(locale));\n    }\n    case \"select\": {\n      if (state.type !== \"select\" || state.values.length === 0) return true;\n      return state.values.includes(filter.getValue(row));\n    }\n    case \"date\": {\n      if (state.type !== \"date\") return true;\n      const raw = filter.getValue(row);\n      if (!raw) return !state.from && !state.to;\n      const v = raw.slice(0, 10);\n      if (state.from && v < state.from) return false;\n      if (state.to && v > state.to) return false;\n      return true;\n    }\n    case \"number\": {\n      if (state.type !== \"number\") return true;\n      const raw = filter.getValue(row);\n      if (raw == null || Number.isNaN(raw)) return !state.min && !state.max;\n      const x = state.abs ? Math.abs(raw) : raw;\n      if (state.min !== \"\" && x < Number(state.min)) return false;\n      if (state.max !== \"\" && x > Number(state.max)) return false;\n      return true;\n    }\n  }\n}\n\n/** The empty filter state for a column's filter type. */\nexport function defaultFilterState<T>(filter: ColumnFilter<T>): FilterValue {\n  switch (filter.type) {\n    case \"text\":\n      return { type: \"text\", q: \"\" };\n    case \"select\":\n      return { type: \"select\", values: [] };\n    case \"date\":\n      return { type: \"date\", from: \"\", to: \"\" };\n    case \"number\":\n      return { type: \"number\", min: \"\", max: \"\", abs: false };\n  }\n}\n\n/**\n * Escape the ONE character the select codec uses as its separator, plus the escape\n * marker itself so the transform is reversible.\n *\n * A minimal escape rather than `encodeURIComponent`, deliberately: these strings sit\n * inside a query-parameter value that `URLSearchParams` already encodes, so a full\n * percent-encode would double-encode every space into `%2520` and make shared links\n * unreadable for no gain. Only `,` can be misread here.\n *\n * Backwards compatible with every link written before this existed: a value with\n * neither `,` nor `%` passes through both directions untouched, and `%` on its own\n * never matched `%25` either.\n */\nfunction escapeSelectValue(v: string): string {\n  return v.replace(/%/g, \"%25\").replace(/,/g, \"%2C\");\n}\n\n/** Inverse of {@link escapeSelectValue}. The order matters and is the reverse of the\n *  escape: undoing `%2C` first cannot see the `2C` inside an escaped `%252C`. */\nfunction unescapeSelectValue(v: string): string {\n  return v.replace(/%2C/g, \",\").replace(/%25/g, \"%\");\n}\n\n/** URL-safe encoding of a filter value (`f.<column>` param), null when empty. */\nexport function encodeFilterValue(v: FilterValue): string | null {\n  switch (v.type) {\n    case \"text\":\n      return v.q.trim() ? v.q : null;\n    case \"select\":\n      // Escaped before joining: an option value may legitimately contain the\n      // separator (a free-text title, a payee or category name), and without this it\n      // came back as two values and the filter silently matched nothing.\n      return v.values.length ? v.values.map(escapeSelectValue).join(\",\") : null;\n    case \"date\":\n      return v.from || v.to ? `${v.from}..${v.to}` : null;\n    case \"number\": {\n      const hasRange = v.min !== \"\" || v.max !== \"\";\n      if (!hasRange && !v.abs) return null;\n      return `${v.min}..${v.max}${v.abs ? \"!\" : \"\"}`;\n    }\n  }\n}\n\n/** Inverse of {@link encodeFilterValue} given just the filter type — for\n *  callers that know a column's type without holding its full config. */\nexport function decodeFilterValueOfType(type: FilterValue[\"type\"], raw: string): FilterValue {\n  switch (type) {\n    case \"text\":\n      return { type: \"text\", q: raw };\n    case \"select\":\n      return {\n        type: \"select\",\n        values: raw\n          .split(\",\")\n          .filter((v) => v.length > 0)\n          .map(unescapeSelectValue),\n      };\n    case \"date\": {\n      const [from = \"\", to = \"\"] = raw.split(\"..\");\n      return { type: \"date\", from, to };\n    }\n    case \"number\": {\n      let body = raw;\n      const abs = body.endsWith(\"!\");\n      if (abs) body = body.slice(0, -1);\n      const [min = \"\", max = \"\"] = body.split(\"..\");\n      return { type: \"number\", min, max, abs };\n    }\n  }\n}\n\n/** Inverse of {@link encodeFilterValue}, typed by the column's filter config. */\nexport function decodeFilterValue<T>(filter: ColumnFilter<T>, raw: string): FilterValue {\n  return decodeFilterValueOfType(filter.type, raw);\n}\n\n// ---------- Filter builders ----------\n//\n// Terse builders for `DataTableColumn.filter`, lifted from kastlan's column-filters.ts,\n// which every converted list page imports. The one that earns its keep is `selectFilter`:\n// in `serverPagination` mode a select filter MUST declare its options (the table would\n// otherwise derive them from the rows of the page on screen), and the options an app has\n// to hand are usually a translated `{ value: label }` map.\n\n/** A free-text filter over `getValue`. */\nexport function textFilter<T>(getValue: (row: T) => string): ColumnFilter<T> {\n  return { type: \"text\", getValue };\n}\n\n/**\n * A multi-select filter. `options` is an options array, or a `{ value: label }` record\n * (a translated status map) — kept in its key order. Left out, the table derives the\n * options from the rows it holds.\n */\nexport function selectFilter<T>(\n  getValue: (row: T) => string,\n  options?: { value: string; label?: string }[] | Record<string, string>,\n): ColumnFilter<T> {\n  const opts = Array.isArray(options)\n    ? options\n    : options\n      ? Object.entries(options).map(([value, label]) => ({ value, label }))\n      : undefined;\n  return { type: \"select\", getValue, options: opts };\n}\n\n/** A from/to date filter over an ISO date (or date-time) string. */\nexport function dateFilter<T>(getValue: (row: T) => string | null | undefined): ColumnFilter<T> {\n  return { type: \"date\", getValue };\n}\n\n/** A min/max (and absolute-value) filter over a number. */\nexport function numberFilter<T>(getValue: (row: T) => number | null | undefined): ColumnFilter<T> {\n  return { type: \"number\", getValue };\n}\n\n/**\n * A link to a list page with one column filter already applied — in the table's own URL\n * scheme (`f.<column>=<encoded>`), which a table with `urlSync` (or\n * {@link useTableUrlState}) reads on mount. kastlan's `buildListUrl`, which had to\n * restate the `f.` prefix to do it.\n *\n * `value` is a string for a text filter, an array for a select filter, or any\n * {@link FilterValue}. A filter that narrows nothing returns `path` unchanged. A `path`\n * that already carries a query keeps it; a `#fragment` stays at the end.\n *\n *     filterHref(\"/units\", \"status\", [\"vacant\"]) // \"/units?f.status=vacant\"\n */\nexport function filterHref(\n  path: string,\n  column: string,\n  value: string | string[] | FilterValue,\n  /** The target table's `urlSync` prefix, if it has one (`{ prefix: \"inv.\" }` →\n   *  `inv.f.<column>`). */\n  options?: { prefix?: string },\n): string {\n  const state: FilterValue =\n    typeof value === \"string\"\n      ? { type: \"text\", q: value }\n      : Array.isArray(value)\n        ? { type: \"select\", values: value }\n        : value;\n  const encoded = encodeFilterValue(state);\n  if (encoded == null) return path;\n  const hashAt = path.indexOf(\"#\");\n  const base = hashAt >= 0 ? path.slice(0, hashAt) : path;\n  const hash = hashAt >= 0 ? path.slice(hashAt) : \"\";\n  const queryAt = base.indexOf(\"?\");\n  const params = new URLSearchParams(queryAt >= 0 ? base.slice(queryAt + 1) : \"\");\n  params.set(`${options?.prefix ?? \"\"}f.${column}`, encoded);\n  return `${queryAt >= 0 ? base.slice(0, queryAt) : base}?${params.toString()}${hash}`;\n}\n"],"mappings":";AAkBO,SAAS,cAAiB,KAAiD;AAChF,MAAI,IAAI,OAAQ,QAAO,IAAI;AAC3B,MAAI,IAAI,SAAU,QAAO,EAAE,MAAM,QAAQ,UAAU,IAAI,SAAS;AAChE,SAAO;AACT;AAGO,SAAS,eAAe,GAAqC;AAClE,MAAI,CAAC,EAAG,QAAO;AACf,UAAQ,EAAE,MAAM;AAAA,IACd,KAAK;AACH,aAAO,EAAE,EAAE,KAAK,EAAE,SAAS;AAAA,IAC7B,KAAK;AACH,aAAO,EAAE,OAAO,SAAS;AAAA,IAC3B,KAAK;AACH,aAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE;AAAA,IACzB,KAAK;AACH,aAAO,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,EAAE;AAAA,EAC7C;AACF;AASO,SAAS,WACd,KACA,KACA,OACA,QACS;AACT,QAAM,SAAS,cAAc,GAAG;AAChC,MAAI,CAAC,OAAQ,QAAO;AACpB,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK,QAAQ;AACX,UAAI,MAAM,SAAS,UAAU,CAAC,MAAM,EAAE,KAAK,EAAG,QAAO;AACrD,aAAO,OACJ,SAAS,GAAG,EACZ,kBAAkB,MAAM,EACxB,SAAS,MAAM,EAAE,KAAK,EAAE,kBAAkB,MAAM,CAAC;AAAA,IACtD;AAAA,IACA,KAAK,UAAU;AACb,UAAI,MAAM,SAAS,YAAY,MAAM,OAAO,WAAW,EAAG,QAAO;AACjE,aAAO,MAAM,OAAO,SAAS,OAAO,SAAS,GAAG,CAAC;AAAA,IACnD;AAAA,IACA,KAAK,QAAQ;AACX,UAAI,MAAM,SAAS,OAAQ,QAAO;AAClC,YAAM,MAAM,OAAO,SAAS,GAAG;AAC/B,UAAI,CAAC,IAAK,QAAO,CAAC,MAAM,QAAQ,CAAC,MAAM;AACvC,YAAM,IAAI,IAAI,MAAM,GAAG,EAAE;AACzB,UAAI,MAAM,QAAQ,IAAI,MAAM,KAAM,QAAO;AACzC,UAAI,MAAM,MAAM,IAAI,MAAM,GAAI,QAAO;AACrC,aAAO;AAAA,IACT;AAAA,IACA,KAAK,UAAU;AACb,UAAI,MAAM,SAAS,SAAU,QAAO;AACpC,YAAM,MAAM,OAAO,SAAS,GAAG;AAC/B,UAAI,OAAO,QAAQ,OAAO,MAAM,GAAG,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,MAAM;AAClE,YAAM,IAAI,MAAM,MAAM,KAAK,IAAI,GAAG,IAAI;AACtC,UAAI,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,GAAG,EAAG,QAAO;AACtD,UAAI,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,GAAG,EAAG,QAAO;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAGO,SAAS,mBAAsB,QAAsC;AAC1E,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK;AACH,aAAO,EAAE,MAAM,QAAQ,GAAG,GAAG;AAAA,IAC/B,KAAK;AACH,aAAO,EAAE,MAAM,UAAU,QAAQ,CAAC,EAAE;AAAA,IACtC,KAAK;AACH,aAAO,EAAE,MAAM,QAAQ,MAAM,IAAI,IAAI,GAAG;AAAA,IAC1C,KAAK;AACH,aAAO,EAAE,MAAM,UAAU,KAAK,IAAI,KAAK,IAAI,KAAK,MAAM;AAAA,EAC1D;AACF;AAeA,SAAS,kBAAkB,GAAmB;AAC5C,SAAO,EAAE,QAAQ,MAAM,KAAK,EAAE,QAAQ,MAAM,KAAK;AACnD;AAIA,SAAS,oBAAoB,GAAmB;AAC9C,SAAO,EAAE,QAAQ,QAAQ,GAAG,EAAE,QAAQ,QAAQ,GAAG;AACnD;AAGO,SAAS,kBAAkB,GAA+B;AAC/D,UAAQ,EAAE,MAAM;AAAA,IACd,KAAK;AACH,aAAO,EAAE,EAAE,KAAK,IAAI,EAAE,IAAI;AAAA,IAC5B,KAAK;AAIH,aAAO,EAAE,OAAO,SAAS,EAAE,OAAO,IAAI,iBAAiB,EAAE,KAAK,GAAG,IAAI;AAAA,IACvE,KAAK;AACH,aAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,IAAI,KAAK,EAAE,EAAE,KAAK;AAAA,IACjD,KAAK,UAAU;AACb,YAAM,WAAW,EAAE,QAAQ,MAAM,EAAE,QAAQ;AAC3C,UAAI,CAAC,YAAY,CAAC,EAAE,IAAK,QAAO;AAChC,aAAO,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,GAAG,EAAE,MAAM,MAAM,EAAE;AAAA,IAC9C;AAAA,EACF;AACF;AAIO,SAAS,wBAAwB,MAA2B,KAA0B;AAC3F,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,EAAE,MAAM,QAAQ,GAAG,IAAI;AAAA,IAChC,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ,IACL,MAAM,GAAG,EACT,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAC1B,IAAI,mBAAmB;AAAA,MAC5B;AAAA,IACF,KAAK,QAAQ;AACX,YAAM,CAAC,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,MAAM,IAAI;AAC3C,aAAO,EAAE,MAAM,QAAQ,MAAM,GAAG;AAAA,IAClC;AAAA,IACA,KAAK,UAAU;AACb,UAAI,OAAO;AACX,YAAM,MAAM,KAAK,SAAS,GAAG;AAC7B,UAAI,IAAK,QAAO,KAAK,MAAM,GAAG,EAAE;AAChC,YAAM,CAAC,MAAM,IAAI,MAAM,EAAE,IAAI,KAAK,MAAM,IAAI;AAC5C,aAAO,EAAE,MAAM,UAAU,KAAK,KAAK,IAAI;AAAA,IACzC;AAAA,EACF;AACF;AAGO,SAAS,kBAAqB,QAAyB,KAA0B;AACtF,SAAO,wBAAwB,OAAO,MAAM,GAAG;AACjD;AAWO,SAAS,WAAc,UAA+C;AAC3E,SAAO,EAAE,MAAM,QAAQ,SAAS;AAClC;AAOO,SAAS,aACd,UACA,SACiB;AACjB,QAAM,OAAO,MAAM,QAAQ,OAAO,IAC9B,UACA,UACE,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,OAAO,MAAM,EAAE,IAClE;AACN,SAAO,EAAE,MAAM,UAAU,UAAU,SAAS,KAAK;AACnD;AAGO,SAAS,WAAc,UAAkE;AAC9F,SAAO,EAAE,MAAM,QAAQ,SAAS;AAClC;AAGO,SAAS,aAAgB,UAAkE;AAChG,SAAO,EAAE,MAAM,UAAU,SAAS;AACpC;AAcO,SAAS,WACd,MACA,QACA,OAGA,SACQ;AACR,QAAM,QACJ,OAAO,UAAU,WACb,EAAE,MAAM,QAAQ,GAAG,MAAM,IACzB,MAAM,QAAQ,KAAK,IACjB,EAAE,MAAM,UAAU,QAAQ,MAAM,IAChC;AACR,QAAM,UAAU,kBAAkB,KAAK;AACvC,MAAI,WAAW,KAAM,QAAO;AAC5B,QAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,QAAM,OAAO,UAAU,IAAI,KAAK,MAAM,GAAG,MAAM,IAAI;AACnD,QAAM,OAAO,UAAU,IAAI,KAAK,MAAM,MAAM,IAAI;AAChD,QAAM,UAAU,KAAK,QAAQ,GAAG;AAChC,QAAM,SAAS,IAAI,gBAAgB,WAAW,IAAI,KAAK,MAAM,UAAU,CAAC,IAAI,EAAE;AAC9E,SAAO,IAAI,GAAG,SAAS,UAAU,EAAE,KAAK,MAAM,IAAI,OAAO;AACzD,SAAO,GAAG,WAAW,IAAI,KAAK,MAAM,GAAG,OAAO,IAAI,IAAI,IAAI,OAAO,SAAS,CAAC,GAAG,IAAI;AACpF;","names":[]}
+{"version":3,"sources":["../../src/components/data-table-filters.ts"],"sourcesContent":["import type { DataTableColumn } from \"./data-table\";\nimport { toLocalIso } from \"../lib/dates\";\nimport { foldForSearch } from \"../lib/text-match\";\n\n/** How a column is filtered. `text`/`select`/`date`/`number` each read a value\n *  off the row and compare it against the user's {@link FilterValue}. */\nexport type ColumnFilter<T> =\n  | { type: \"text\"; getValue: (row: T) => string }\n  | { type: \"select\"; getValue: (row: T) => string; options?: { value: string; label?: string }[] }\n  | { type: \"date\"; getValue: (row: T) => string | null | undefined }\n  | { type: \"number\"; getValue: (row: T) => number | null | undefined };\n\n/** The current state of a column's filter (what the user has entered). */\nexport type FilterValue =\n  | { type: \"text\"; q: string }\n  | { type: \"select\"; values: string[] }\n  | { type: \"date\"; from: string; to: string }\n  | { type: \"number\"; min: string; max: string; abs: boolean };\n\n/** A column's filter config, falling back to a plain text filter over `filterBy`. */\nexport function resolveFilter<T>(col: DataTableColumn<T>): ColumnFilter<T> | null {\n  if (col.filter) return col.filter;\n  if (col.filterBy) return { type: \"text\", getValue: col.filterBy };\n  return null;\n}\n\n/** Whether a filter value is actually narrowing anything (vs its empty default). */\nexport function isFilterActive(v: FilterValue | undefined): boolean {\n  if (!v) return false;\n  switch (v.type) {\n    case \"text\":\n      return v.q.trim().length > 0;\n    case \"select\":\n      return v.values.length > 0;\n    case \"date\":\n      return !!v.from || !!v.to;\n    case \"number\":\n      return numberBound(v.min) !== null || numberBound(v.max) !== null || v.abs;\n  }\n}\n\n/**\n * A number filter's bound as a number, or `null` for none: blank, or not a finite\n * number (BUG-10, refactor audit 2026-10). `Number(\"abc\")` is NaN, and every comparison\n * with NaN is false, so a broken bound — `f.amount=abc..` in a shared link — used to\n * match every row while the column showed its filter as active; `Number(\" \")` is 0, and\n * a blank bound kept every negative row out. The popover hands in the dot-decimal text\n * its locale's marks read (`readTyped`); anything else is no bound.\n */\nfunction numberBound(raw: string): number | null {\n  if (raw.trim() === \"\") return null;\n  const n = Number(raw);\n  return Number.isFinite(n) ? n : null;\n}\n\n/**\n * The calendar day a date filter compares, as \"YYYY-MM-DD\" — the LOCAL day, the one\n * the cell, the DatePicker and the presets show (round 0.34 BUG-2).\n *\n * A bare \"YYYY-MM-DD\" is a calendar day already and is kept as it is. Anything with a\n * time part is an instant: its first ten characters were the UTC day for a server\n * timestamp (\"…Z\", \"+00:00\"), so in Berlin a report filed at 00:30 showed as the 12th\n * and was filtered as the 11th. It is read as the instant it names and put on the\n * local calendar. A string `Date` cannot read keeps the old first-ten-characters\n * answer rather than matching nothing.\n */\nfunction localDay(raw: string): string {\n  if (/^\\d{4}-\\d{2}-\\d{2}$/.test(raw)) return raw;\n  const d = new Date(raw);\n  return Number.isNaN(d.getTime()) ? raw.slice(0, 10) : toLocalIso(d);\n}\n\n/**\n * Whether `row` passes column `col`'s filter given the user's `state`.\n *\n * `locale` is for the text filter's case folding. Plain `toLowerCase` folds by the\n * root rules, under which a Turkish user typing \"ırmak\" does not find \"IRMAK\";\n * `toLocaleLowerCase(locale)` does. Optional, and `undefined` is the runtime's default.\n * The text filter folds as every kit list does ({@link foldForSearch}, DUP-5): accents\n * off too, so \"zurich\" finds Zürich.\n */\nexport function rowMatches<T>(\n  col: DataTableColumn<T>,\n  row: T,\n  state: FilterValue,\n  locale?: string,\n): boolean {\n  const filter = resolveFilter(col);\n  if (!filter) return true;\n  switch (filter.type) {\n    case \"text\": {\n      if (state.type !== \"text\" || !state.q.trim()) return true;\n      return foldForSearch(filter.getValue(row), locale).includes(foldForSearch(state.q.trim(), locale));\n    }\n    case \"select\": {\n      if (state.type !== \"select\" || state.values.length === 0) return true;\n      return state.values.includes(filter.getValue(row));\n    }\n    case \"date\": {\n      if (state.type !== \"date\") return true;\n      const raw = filter.getValue(row);\n      if (!raw) return !state.from && !state.to;\n      const v = localDay(raw);\n      if (state.from && v < state.from) return false;\n      if (state.to && v > state.to) return false;\n      return true;\n    }\n    case \"number\": {\n      if (state.type !== \"number\") return true;\n      const raw = filter.getValue(row);\n      const min = numberBound(state.min);\n      const max = numberBound(state.max);\n      if (raw == null || Number.isNaN(raw)) return min === null && max === null;\n      const x = state.abs ? Math.abs(raw) : raw;\n      if (min !== null && x < min) return false;\n      if (max !== null && x > max) return false;\n      return true;\n    }\n  }\n}\n\n/** The empty filter state for a column's filter type. */\nexport function defaultFilterState<T>(filter: ColumnFilter<T>): FilterValue {\n  switch (filter.type) {\n    case \"text\":\n      return { type: \"text\", q: \"\" };\n    case \"select\":\n      return { type: \"select\", values: [] };\n    case \"date\":\n      return { type: \"date\", from: \"\", to: \"\" };\n    case \"number\":\n      return { type: \"number\", min: \"\", max: \"\", abs: false };\n  }\n}\n\n/**\n * Escape the ONE character the select codec uses as its separator, plus the escape\n * marker itself so the transform is reversible.\n *\n * A minimal escape rather than `encodeURIComponent`, deliberately: these strings sit\n * inside a query-parameter value that `URLSearchParams` already encodes, so a full\n * percent-encode would double-encode every space into `%2520` and make shared links\n * unreadable for no gain. Only `,` can be misread here.\n *\n * Backwards compatible with every link written before this existed: a value with\n * neither `,` nor `%` passes through both directions untouched, and `%` on its own\n * never matched `%25` either.\n */\nfunction escapeSelectValue(v: string): string {\n  return v.replace(/%/g, \"%25\").replace(/,/g, \"%2C\");\n}\n\n/** Inverse of {@link escapeSelectValue}. The order matters and is the reverse of the\n *  escape: undoing `%2C` first cannot see the `2C` inside an escaped `%252C`. */\nfunction unescapeSelectValue(v: string): string {\n  return v.replace(/%2C/g, \",\").replace(/%25/g, \"%\");\n}\n\n/** URL-safe encoding of a filter value (`f.<column>` param), null when empty. */\nexport function encodeFilterValue(v: FilterValue): string | null {\n  switch (v.type) {\n    case \"text\":\n      return v.q.trim() ? v.q : null;\n    case \"select\":\n      // Escaped before joining: an option value may legitimately contain the\n      // separator (a free-text title, a payee or category name), and without this it\n      // came back as two values and the filter silently matched nothing.\n      return v.values.length ? v.values.map(escapeSelectValue).join(\",\") : null;\n    case \"date\":\n      return v.from || v.to ? `${v.from}..${v.to}` : null;\n    case \"number\": {\n      const hasRange = v.min !== \"\" || v.max !== \"\";\n      if (!hasRange && !v.abs) return null;\n      return `${v.min}..${v.max}${v.abs ? \"!\" : \"\"}`;\n    }\n  }\n}\n\n/** Inverse of {@link encodeFilterValue} given just the filter type — for\n *  callers that know a column's type without holding its full config. */\nexport function decodeFilterValueOfType(type: FilterValue[\"type\"], raw: string): FilterValue {\n  switch (type) {\n    case \"text\":\n      return { type: \"text\", q: raw };\n    case \"select\":\n      return {\n        type: \"select\",\n        values: raw\n          .split(\",\")\n          .filter((v) => v.length > 0)\n          .map(unescapeSelectValue),\n      };\n    case \"date\": {\n      const [from = \"\", to = \"\"] = raw.split(\"..\");\n      return { type: \"date\", from, to };\n    }\n    case \"number\": {\n      let body = raw;\n      const abs = body.endsWith(\"!\");\n      if (abs) body = body.slice(0, -1);\n      const [min = \"\", max = \"\"] = body.split(\"..\");\n      // A bound that is not a finite number is dropped here, so a broken link leaves the\n      // filter off rather than active and matching everything (BUG-10).\n      const kept = (s: string) => (numberBound(s) === null ? \"\" : s);\n      return { type: \"number\", min: kept(min), max: kept(max), abs };\n    }\n  }\n}\n\n/** Inverse of {@link encodeFilterValue}, typed by the column's filter config. */\nexport function decodeFilterValue<T>(filter: ColumnFilter<T>, raw: string): FilterValue {\n  return decodeFilterValueOfType(filter.type, raw);\n}\n\n// ---------- Filter builders ----------\n//\n// Terse builders for `DataTableColumn.filter`, lifted from kastlan's column-filters.ts,\n// which every converted list page imports. The one that earns its keep is `selectFilter`:\n// in `serverPagination` mode a select filter MUST declare its options (the table would\n// otherwise derive them from the rows of the page on screen), and the options an app has\n// to hand are usually a translated `{ value: label }` map.\n\n/** A free-text filter over `getValue`. */\nexport function textFilter<T>(getValue: (row: T) => string): ColumnFilter<T> {\n  return { type: \"text\", getValue };\n}\n\n/**\n * A multi-select filter. `options` is an options array, or a `{ value: label }` record\n * (a translated status map) — kept in its key order. Left out, the table derives the\n * options from the rows it holds.\n */\nexport function selectFilter<T>(\n  getValue: (row: T) => string,\n  options?: { value: string; label?: string }[] | Record<string, string>,\n): ColumnFilter<T> {\n  const opts = Array.isArray(options)\n    ? options\n    : options\n      ? Object.entries(options).map(([value, label]) => ({ value, label }))\n      : undefined;\n  return { type: \"select\", getValue, options: opts };\n}\n\n/** A from/to date filter over an ISO date (or date-time) string. */\nexport function dateFilter<T>(getValue: (row: T) => string | null | undefined): ColumnFilter<T> {\n  return { type: \"date\", getValue };\n}\n\n/** A min/max (and absolute-value) filter over a number. */\nexport function numberFilter<T>(getValue: (row: T) => number | null | undefined): ColumnFilter<T> {\n  return { type: \"number\", getValue };\n}\n\n/**\n * A link to a list page with one column filter already applied — in the table's own URL\n * scheme (`f.<column>=<encoded>`), which a table with `urlSync` (or\n * {@link useTableUrlState}) reads on mount. kastlan's `buildListUrl`, which had to\n * restate the `f.` prefix to do it.\n *\n * `value` is a string for a text filter, an array for a select filter, or any\n * {@link FilterValue}. A filter that narrows nothing returns `path` unchanged. A `path`\n * that already carries a query keeps it; a `#fragment` stays at the end.\n *\n *     filterHref(\"/units\", \"status\", [\"vacant\"]) // \"/units?f.status=vacant\"\n */\nexport function filterHref(\n  path: string,\n  column: string,\n  value: string | string[] | FilterValue,\n  /** The target table's `urlSync` prefix, if it has one (`{ prefix: \"inv.\" }` →\n   *  `inv.f.<column>`). */\n  options?: { prefix?: string },\n): string {\n  const state: FilterValue =\n    typeof value === \"string\"\n      ? { type: \"text\", q: value }\n      : Array.isArray(value)\n        ? { type: \"select\", values: value }\n        : value;\n  const encoded = encodeFilterValue(state);\n  if (encoded == null) return path;\n  const hashAt = path.indexOf(\"#\");\n  const base = hashAt >= 0 ? path.slice(0, hashAt) : path;\n  const hash = hashAt >= 0 ? path.slice(hashAt) : \"\";\n  const queryAt = base.indexOf(\"?\");\n  const params = new URLSearchParams(queryAt >= 0 ? base.slice(queryAt + 1) : \"\");\n  params.set(`${options?.prefix ?? \"\"}f.${column}`, encoded);\n  return `${queryAt >= 0 ? base.slice(0, queryAt) : base}?${params.toString()}${hash}`;\n}\n"],"mappings":"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","names":[]}

package/dist/components/data-table-head.d.ts

@@ -0,0 +1,36 @@
+import type { Dispatch, SetStateAction } from "react";
+import type { FilterValue } from "./data-table-filters.js";
+import type { SortState } from "./data-table-sort.js";
+import type { DataTableLabels } from "./data-table-labels.js";
+import type { DataTableColumn, DataTableProps, FilterState } from "./data-table.js";
+/** The wide-screen table's header row. */
+export declare function DataTableHead<T>({ visibleColumns, selection, compact, labels, locale, isServer, hasSortCallback, hasFilterCallback, sorts, filters, selectOptionsByKey, multiSort, resizable, widths, setWidths, headRefs, toggleSort, setFilterValue, clearFilter, startResize, moveResize, finishResize, }: {
+    visibleColumns: DataTableColumn<T>[];
+    selection: DataTableProps<T>["selection"];
+    compact: boolean;
+    labels: DataTableLabels;
+    locale?: string;
+    isServer: boolean;
+    /** The caller owns the sort (`onSortsChange`), so a server table can offer it. */
+    hasSortCallback: boolean;
+    /** The caller owns the filters (`onFiltersChange`), likewise. */
+    hasFilterCallback: boolean;
+    sorts: SortState[];
+    filters: FilterState;
+    selectOptionsByKey: Record<string, {
+        value: string;
+        label: string;
+    }[]>;
+    multiSort: boolean;
+    resizable: boolean;
+    widths: Record<string, number>;
+    setWidths: Dispatch<SetStateAction<Record<string, number>>>;
+    /** Filled here, one `<th>` per column — what a resize and "Auto-size" measure. */
+    headRefs: Map<string, HTMLTableCellElement>;
+    toggleSort: (key: string, shiftKey: boolean) => void;
+    setFilterValue: (key: string, value: FilterValue) => void;
+    clearFilter: (key: string) => void;
+    startResize: (e: React.PointerEvent<HTMLElement>, key: string) => void;
+    moveResize: (e: React.PointerEvent<HTMLElement>) => void;
+    finishResize: (e: React.PointerEvent<HTMLElement>, commit: boolean) => void;
+}): import("react").JSX.Element;

package/dist/components/data-table-head.js

@@ -0,0 +1,190 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createElement } from "react";
+import { ArrowDown, ArrowUp, ArrowUpDown, Filter } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { defaultFilterState, isFilterActive, resolveFilter } from "./data-table-filters.js";
+import { FilterPopover } from "./data-table-filter-popover.js";
+import { Popover } from "./popover.js";
+import { Tooltip } from "./tooltip.js";
+import { ROW_ACTIONS_KEY } from "./data-table-row-actions.js";
+import { columnLabel, logicalAlign, splitCellProps } from "./data-table-shared.js";
+const END_ALIGN = /(^|\s)text-end(?=\s|$)/;
+function DataTableHead({
+  visibleColumns,
+  selection,
+  compact,
+  labels,
+  locale,
+  isServer,
+  hasSortCallback,
+  hasFilterCallback,
+  sorts,
+  filters,
+  selectOptionsByKey,
+  multiSort,
+  resizable,
+  widths,
+  setWidths,
+  headRefs,
+  toggleSort,
+  setFilterValue,
+  clearFilter,
+  startResize,
+  moveResize,
+  finishResize
+}) {
+  return /* @__PURE__ */ jsx("thead", { className: "bg-surface-2 text-secondary", children: /* @__PURE__ */ jsxs("tr", { className: "text-start", children: [
+    selection && /* @__PURE__ */ jsx(
+      "th",
+      {
+        scope: "col",
+        className: cn(
+          "sticky top-0 z-10 bg-surface-2 align-middle backdrop-blur-sm",
+          compact ? "w-8 px-2 py-1" : "w-10 px-3 py-2"
+        ),
+        children: /* @__PURE__ */ jsx(
+          "input",
+          {
+            type: "checkbox",
+            className: cn("align-middle accent-indigo-600", compact ? "size-3.5" : "size-4"),
+            checked: selection.allSelected,
+            ref: (el) => {
+              if (el) el.indeterminate = selection.someSelected && !selection.allSelected;
+            },
+            onChange: (e) => selection.onToggleAll(e.target.checked),
+            "aria-label": labels.selectAllRows
+          }
+        )
+      }
+    ),
+    visibleColumns.map((col) => {
+      const sortable = (!isServer || hasSortCallback) && !!col.sortBy;
+      const filter = !isServer || hasFilterCallback ? resolveFilter(col) : null;
+      const filterState = filters[col.key] ?? (filter ? defaultFilterState(filter) : void 0);
+      const sortIdx = sorts.findIndex((s) => s.key === col.key);
+      const active = sortIdx !== -1;
+      const Icon = active ? sorts[sortIdx].dir === "asc" ? ArrowUp : ArrowDown : ArrowUpDown;
+      const filterActive = filterState && isFilterActive(filterState);
+      const headClass = logicalAlign(col.headClassName);
+      const isEndAligned = !!headClass && END_ALIGN.test(headClass);
+      const width = widths[col.key];
+      const ownHead = splitCellProps(col.headProps);
+      const pinnedHead = width ? { width, minWidth: width, maxWidth: width } : void 0;
+      return /* @__PURE__ */ createElement(
+        "th",
+        {
+          ...ownHead.attrs,
+          key: col.key,
+          ref: (el) => {
+            if (el) headRefs.set(col.key, el);
+            else headRefs.delete(col.key);
+          },
+          scope: "col",
+          "aria-sort": sortable ? sortIdx === 0 ? sorts[0].dir === "asc" ? "ascending" : "descending" : "none" : void 0,
+          style: ownHead.style || pinnedHead ? { ...ownHead.style, ...pinnedHead } : void 0,
+          className: cn(
+            "relative font-medium align-middle whitespace-nowrap",
+            compact ? "px-2 py-1" : "px-3 py-2",
+            // Keep the header visible while the user scrolls the page.
+            // Each <th> carries its own bg so the row doesn't render
+            // transparent over the data rows underneath.
+            "sticky top-0 z-10 bg-surface-2 backdrop-blur-sm",
+            logicalAlign(ownHead.className),
+            headClass
+          )
+        },
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: cn(
+              "flex items-center gap-1",
+              isEndAligned && "flex-row-reverse"
+            ),
+            children: [
+              /* @__PURE__ */ jsx(Tooltip, { label: sortable && multiSort ? labels.sortHint : void 0, portal: true, children: /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  onClick: (e) => sortable && toggleSort(col.key, e.shiftKey),
+                  disabled: !sortable,
+                  className: cn(
+                    "flex items-center gap-1 text-start",
+                    sortable && "hover:text-primary"
+                  ),
+                  children: [
+                    /* @__PURE__ */ jsx("span", { children: col.header }),
+                    sortable && /* @__PURE__ */ jsx(Icon, { className: cn("size-3", active ? "opacity-100" : "opacity-40") }),
+                    active && sorts.length > 1 && /* @__PURE__ */ jsx("span", { className: "text-micro font-semibold leading-none text-brand", children: sortIdx + 1 })
+                  ]
+                }
+              ) }),
+              filter && /* @__PURE__ */ jsx(
+                Popover,
+                {
+                  width: filter.type === "date" ? "26.25rem" : void 0,
+                  labels: { panel: labels.filterColumn(columnLabel(col, labels), false) },
+                  trigger: ({ open, toggle, ref }) => /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      type: "button",
+                      ref,
+                      onClick: toggle,
+                      "aria-label": labels.filterColumn(columnLabel(col, labels), Boolean(filterActive)),
+                      "aria-haspopup": "dialog",
+                      "aria-expanded": open,
+                      className: cn(
+                        "rounded p-1 transition-colors",
+                        filterActive ? "bg-brand-soft text-brand-muted" : "text-placeholder hover:text-secondary hover:bg-hover"
+                      ),
+                      children: /* @__PURE__ */ jsx(Filter, { className: "size-3" })
+                    }
+                  ),
+                  children: () => /* @__PURE__ */ jsx(
+                    FilterPopover,
+                    {
+                      column: col,
+                      state: filterState ?? defaultFilterState(filter),
+                      onChange: (next) => setFilterValue(col.key, next),
+                      onClear: () => clearFilter(col.key),
+                      selectOptions: selectOptionsByKey[col.key] ?? [],
+                      labels,
+                      locale
+                    }
+                  )
+                }
+              )
+            ]
+          }
+        ),
+        resizable && col.key !== ROW_ACTIONS_KEY && /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a
+           pointer-only drag handle for a visual preference (column width); it is
+           deliberately not a tab stop, and no content or action depends on it. */
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            role: "separator",
+            "aria-orientation": "vertical",
+            onPointerDown: (e) => startResize(e, col.key),
+            onPointerMove: moveResize,
+            onPointerUp: (e) => finishResize(e, true),
+            onPointerCancel: (e) => finishResize(e, false),
+            onDoubleClick: (e) => {
+              e.preventDefault();
+              setWidths((w) => {
+                const next = { ...w };
+                delete next[col.key];
+                return next;
+              });
+            },
+            className: "absolute end-0 top-0 z-10 h-full w-1.5 -translate-x-1/2 rtl:translate-x-1/2 cursor-col-resize select-none touch-none hover:bg-brand-soft-hover"
+          }
+        )
+      );
+    })
+  ] }) });
+}
+export {
+  DataTableHead
+};
+//# sourceMappingURL=data-table-head.js.map

package/dist/components/data-table-head.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/data-table-head.tsx"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport { ArrowDown, ArrowUp, ArrowUpDown, Filter } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { defaultFilterState, isFilterActive, resolveFilter } from \"./data-table-filters\";\nimport type { FilterValue } from \"./data-table-filters\";\nimport type { SortState } from \"./data-table-sort\";\nimport { FilterPopover } from \"./data-table-filter-popover\";\nimport { Popover } from \"./popover\";\nimport { Tooltip } from \"./tooltip\";\nimport type { DataTableLabels } from \"./data-table-labels\";\nimport { ROW_ACTIONS_KEY } from \"./data-table-row-actions\";\nimport { columnLabel, logicalAlign, splitCellProps } from \"./data-table-shared\";\nimport type { DataTableColumn, DataTableProps, FilterState } from \"./data-table\";\n\n// DataTable's `<thead>` on a wide screen: the select-all box, and per column the sort\n// button, the filter popover and the resize handle. Moved out of data-table.tsx whole\n// (refactor audit 2026-10, MOD-3 step 5); the state it shows and changes stays the\n// table's.\n\n/** Whether a column is end-aligned — the header then puts its filter button first. */\nconst END_ALIGN = /(^|\\s)text-end(?=\\s|$)/;\n\n/** The wide-screen table's header row. */\nexport function DataTableHead<T>({\n  visibleColumns,\n  selection,\n  compact,\n  labels,\n  locale,\n  isServer,\n  hasSortCallback,\n  hasFilterCallback,\n  sorts,\n  filters,\n  selectOptionsByKey,\n  multiSort,\n  resizable,\n  widths,\n  setWidths,\n  headRefs,\n  toggleSort,\n  setFilterValue,\n  clearFilter,\n  startResize,\n  moveResize,\n  finishResize,\n}: {\n  visibleColumns: DataTableColumn<T>[];\n  selection: DataTableProps<T>[\"selection\"];\n  compact: boolean;\n  labels: DataTableLabels;\n  locale?: string;\n  isServer: boolean;\n  /** The caller owns the sort (`onSortsChange`), so a server table can offer it. */\n  hasSortCallback: boolean;\n  /** The caller owns the filters (`onFiltersChange`), likewise. */\n  hasFilterCallback: boolean;\n  sorts: SortState[];\n  filters: FilterState;\n  selectOptionsByKey: Record<string, { value: string; label: string }[]>;\n  multiSort: boolean;\n  resizable: boolean;\n  widths: Record<string, number>;\n  setWidths: Dispatch<SetStateAction<Record<string, number>>>;\n  /** Filled here, one `<th>` per column — what a resize and \"Auto-size\" measure. */\n  headRefs: Map<string, HTMLTableCellElement>;\n  toggleSort: (key: string, shiftKey: boolean) => void;\n  setFilterValue: (key: string, value: FilterValue) => void;\n  clearFilter: (key: string) => void;\n  startResize: (e: React.PointerEvent<HTMLElement>, key: string) => void;\n  moveResize: (e: React.PointerEvent<HTMLElement>) => void;\n  finishResize: (e: React.PointerEvent<HTMLElement>, commit: boolean) => void;\n}) {\n  return (\n    <thead className=\"bg-surface-2 text-secondary\">\n      <tr className=\"text-start\">\n        {selection && (\n          <th\n            scope=\"col\"\n            className={cn(\n              \"sticky top-0 z-10 bg-surface-2 align-middle backdrop-blur-sm\",\n              compact ? \"w-8 px-2 py-1\" : \"w-10 px-3 py-2\",\n            )}\n          >\n            <input\n              type=\"checkbox\"\n              className={cn(\"align-middle accent-indigo-600\", compact ? \"size-3.5\" : \"size-4\")}\n              checked={selection.allSelected}\n              ref={(el) => {\n                if (el) el.indeterminate = selection.someSelected && !selection.allSelected;\n              }}\n              onChange={(e) => selection.onToggleAll(e.target.checked)}\n              aria-label={labels.selectAllRows}\n            />\n          </th>\n        )}\n        {visibleColumns.map((col) => {\n          // In server mode the utilities stay hidden unless the caller\n          // takes them over and feeds them back into the server query.\n          const sortable = (!isServer || hasSortCallback) && !!col.sortBy;\n          const filter = !isServer || hasFilterCallback ? resolveFilter(col) : null;\n          const filterState = filters[col.key] ?? (filter ? defaultFilterState(filter) : undefined);\n          const sortIdx = sorts.findIndex((s) => s.key === col.key);\n          const active = sortIdx !== -1;\n          const Icon = active ? (sorts[sortIdx].dir === \"asc\" ? ArrowUp : ArrowDown) : ArrowUpDown;\n          const filterActive = filterState && isFilterActive(filterState);\n          // Logical, and a legacy `text-right` still counts — see `logicalAlign`.\n          const headClass = logicalAlign(col.headClassName);\n          const isEndAligned = !!headClass && END_ALIGN.test(headClass);\n          const width = widths[col.key];\n          const ownHead = splitCellProps(col.headProps);\n          const pinnedHead = width ? { width, minWidth: width, maxWidth: width } : undefined;\n          return (\n            <th\n              {...ownHead.attrs}\n              key={col.key}\n              ref={(el) => {\n                if (el) headRefs.set(col.key, el);\n                else headRefs.delete(col.key);\n              }}\n              scope=\"col\"\n              // Only a header the user can actually sort says anything: an\n              // `aria-sort` on a plain column is a control that is not there,\n              // and a persisted or URL sort can name a column with no `sortBy`\n              // (the sort chain drops it silently) — which would otherwise\n              // claim a sort the table is not applying.\n              //\n              // \"none\" on the rest is the half that was missing. Without it a\n              // sortable header is indistinguishable from a plain one until the\n              // user presses it. Secondary criteria read \"none\" too: ARIA allows\n              // exactly one sorted column, and the priority is carried by the\n              // badge and by what the header button announces on press.\n              aria-sort={\n                sortable\n                  ? sortIdx === 0\n                    ? sorts[0].dir === \"asc\"\n                      ? \"ascending\"\n                      : \"descending\"\n                    : \"none\"\n                  : undefined\n              }\n              style={ownHead.style || pinnedHead ? { ...ownHead.style, ...pinnedHead } : undefined}\n              className={cn(\n                \"relative font-medium align-middle whitespace-nowrap\",\n                compact ? \"px-2 py-1\" : \"px-3 py-2\",\n                // Keep the header visible while the user scrolls the page.\n                // Each <th> carries its own bg so the row doesn't render\n                // transparent over the data rows underneath.\n                \"sticky top-0 z-10 bg-surface-2 backdrop-blur-sm\",\n                logicalAlign(ownHead.className),\n                headClass,\n              )}\n            >\n              <div\n                className={cn(\n                  \"flex items-center gap-1\",\n                  isEndAligned && \"flex-row-reverse\",\n                )}\n              >\n                <Tooltip label={sortable && multiSort ? labels.sortHint : undefined} portal>\n                  <button\n                    type=\"button\"\n                    onClick={(e) => sortable && toggleSort(col.key, e.shiftKey)}\n                    disabled={!sortable}\n                    className={cn(\n                      \"flex items-center gap-1 text-start\",\n                      sortable && \"hover:text-primary\",\n                    )}\n                  >\n                    <span>{col.header}</span>\n                    {sortable && (\n                      <Icon className={cn(\"size-3\", active ? \"opacity-100\" : \"opacity-40\")} />\n                    )}\n                    {/* Priority badge, only meaningful with 2+ sort keys */}\n                    {active && sorts.length > 1 && (\n                      <span className=\"text-micro font-semibold leading-none text-brand\">\n                        {sortIdx + 1}\n                      </span>\n                    )}\n                  </button>\n                </Tooltip>\n                {filter && (\n                  <Popover\n                    // 420 px at Normal, in rem so the calendar grows with its\n                    // text (§3.2); Popover caps it at the viewport.\n                    width={filter.type === \"date\" ? \"26.25rem\" : undefined}\n                    // The panel is THIS column's filter, and says so. Unnamed it was\n                    // announced as the kit-wide fallback, \"Popover\"; then as \"Filter\"\n                    // in every column alike (round 0.34 Wave 2, BUG-7c).\n                    labels={{ panel: labels.filterColumn(columnLabel(col, labels), false) }}\n                    trigger={({ open, toggle, ref }) => (\n                      <button\n                        type=\"button\"\n                        ref={ref}\n                        onClick={toggle}\n                        // Named for its column, and for being filtered: the tint\n                        // alone said that to nobody who cannot see it (BUG-7c).\n                        aria-label={labels.filterColumn(columnLabel(col, labels), Boolean(filterActive))}\n                        aria-haspopup=\"dialog\"\n                        aria-expanded={open}\n                        className={cn(\n                          \"rounded p-1 transition-colors\",\n                          filterActive\n                            ? \"bg-brand-soft text-brand-muted\"\n                            : \"text-placeholder hover:text-secondary hover:bg-hover\",\n                        )}\n                      >\n                        <Filter className=\"size-3\" />\n                      </button>\n                    )}\n                  >\n                    {() => (\n                      <FilterPopover\n                        column={col}\n                        state={filterState ?? defaultFilterState(filter)}\n                        onChange={(next) => setFilterValue(col.key, next)}\n                        onClear={() => clearFilter(col.key)}\n                        selectOptions={selectOptionsByKey[col.key] ?? []}\n                        labels={labels}\n                        locale={locale}\n                      />\n                    )}\n                  </Popover>\n                )}\n              </div>\n              {resizable && col.key !== ROW_ACTIONS_KEY && (\n              /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a\n                 pointer-only drag handle for a visual preference (column width); it is\n                 deliberately not a tab stop, and no content or action depends on it. */\n              <span\n                role=\"separator\"\n                aria-orientation=\"vertical\"\n                onPointerDown={(e) => startResize(e, col.key)}\n                onPointerMove={moveResize}\n                onPointerUp={(e) => finishResize(e, true)}\n                onPointerCancel={(e) => finishResize(e, false)}\n                onDoubleClick={(e) => {\n                  e.preventDefault();\n                  setWidths((w) => {\n                    const next = { ...w };\n                    delete next[col.key];\n                    return next;\n                  });\n                }}\n                // `touch-none`: without it the browser claims a finger drag for\n                // scrolling before the first `pointermove` ever arrives.\n                // `end-0` and a translate that flips with it: the handle sits on the column's\n                // trailing edge, which is its left one in a right-to-left table.\n                className=\"absolute end-0 top-0 z-10 h-full w-1.5 -translate-x-1/2 rtl:translate-x-1/2 cursor-col-resize select-none touch-none hover:bg-brand-soft-hover\"\n              />\n              )}\n            </th>\n          );\n        })}\n      </tr>\n    </thead>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/data-table-labels.d.ts

@@ -1,15 +1,124 @@
-export { D as DEFAULT_DATA_TABLE_LABELS, f as DataTableLabels, u as missingDataTableLabels, x as resolveDataTableLabels } from '../data-table-labels-BJ5JE_X2.js';
-import 'react';
-import './data-table-sort.js';
-import './swipeable-row.js';
-import './status-dot.js';
-import './progress-bar.js';
-import './signed-amount.js';
-import './stat-tile.js';
-import './chip.js';
-import 'lucide-react';
-import './field-parts.js';
-import './tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import './write-lock.js';
+import type { DataTableSortLabels } from "./data-table.js";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+/** The phone sort control's four keys (`sortBy`, `sortDefault`, `sortAscending`,
+ *  `sortDescending`, 0.22.0) are {@link DataTableSortLabels}', declared beside the
+ *  control and part of this namespace like every other key. */
+export interface DataTableLabels extends DataTableSortLabels {
+    columns: string;
+    selectAllRows: string;
+    sortHint: string;
+    filter: string;
+    close: string;
+    selectRow: string;
+    /**
+     * The name of an opening row's disclosure button on desktop — visually hidden, in the
+     * row's first cell, carrying `aria-expanded` and `aria-controls` (round 0.34, the
+     * showcase's axe check: ARIA allows `aria-expanded` on a row only in a treegrid, and
+     * the `<tr>` wore it). The same words whether the row is open or shut: the state is
+     * the button's to say.
+     */
+    rowDetails: string;
+    autoSize: string;
+    loading: string;
+    filters: string;
+    clearAll: string;
+    done: string;
+    pageSize: string;
+    pageSizeAll: string;
+    prevPage: string;
+    nextPage: string;
+    clearFilter: string;
+    filterPlaceholder: string;
+    selectFilter: string;
+    selectAll: string;
+    selectNone: string;
+    dateFrom: string;
+    dateTo: string;
+    numberMin: string;
+    numberMax: string;
+    numberAbs: string;
+    presets: Record<string, string>;
+    /**
+     * The table's own accessible name. Deliberately a label rather than a second,
+     * parallel `tableLabel` prop: the audit already records "three different prop
+     * names for the accessible name" as a finding, and a table that is not "Data
+     * table" says so with `labels={{ table: "Transactions" }}` at the call site.
+     */
+    table: string;
+    /** After a filter changes: "12 of 137 rows". */
+    filterResults: (shown: number, total: number) => string;
+    /** After a header is activated: "Sorted by Name, ascending". */
+    sortedAscending: (column: string) => string;
+    sortedDescending: (column: string) => string;
+    /** The third click, which removes the column from the sort entirely. */
+    sortCleared: (column: string) => string;
+    /** After paging: "Page 3 of 14". `page` is 1-BASED, as spoken. */
+    pageChanged: (page: number, totalPages: number) => string;
+    /** The pagination range summary: "1–25 / 137". */
+    pageRange: (from: number, to: number, total: number) => string;
+    /** The same summary when the page size is "all" — just the row count. */
+    rowCount: (total: number) => string;
+    /** The column-settings rail and its heading: "Columns (4/9)". */
+    columnsCount: (visible: number, total: number) => string;
+    /**
+     * A column's filter button and panel: "Filter Amount", and "Filter Amount (active)"
+     * while the column is filtered (round 0.34 Wave 2, BUG-7c). Every column's used to be
+     * "Filter" alike, and "filtered" was a colour. An app that translated only `filter`
+     * gets `"<filter>: <column>"` from it — see {@link resolveDataTableLabels}.
+     */
+    filterColumn: (column: string, active: boolean) => string;
+    /** The body of a table with no rows and no `empty` prop of its own. A sentence, not
+     *  "—": a dash in the only row of a table reads as one row with a missing value. */
+    empty: string;
+    /** The accessible name of the `rowActions` column (its header is visually empty). */
+    actions: string;
+    /** The `kind: "edit"` row action's name — its tooltip and its swipe label. */
+    edit: string;
+    /** The `kind: "delete"` row action's name. */
+    delete: string;
+    /** What {@link BooleanMark} says to a screen reader for `true` / `false` / nothing. */
+    booleanTrue: string;
+    booleanFalse: string;
+    booleanUnset: string;
+}
+export declare const DEFAULT_DATA_TABLE_LABELS: DataTableLabels;
+/**
+ * Merge caller overrides onto the English defaults (presets merged too, key by key, as
+ * the provider merges them — so the parameter is a {@link LabelOverride}).
+ *
+ * The parameter is lenient on purpose — a table with no labels at all still
+ * renders — but that is also how a translated app ends up half English and never
+ * hears about it: lenkbank ships nineteen of these keys in English in a German UI
+ * today, because every one of them is backfilled silently. The kit will not start
+ * throwing over it (three apps depend on the lenient merge), so
+ * {@link missingDataTableLabels} is the other half: it answers which keys fell back,
+ * and an app asserts on that in its OWN test, where the answer is actionable.
+ *
+ * @deprecated 0.34 — pass `labels` to DataTable, or the provider's `dataTable`, which this
+ * merge serves; removed in 0.35 from the public surface, where DataTable keeps it as its
+ * own (refactor audit 2026-10, API-6a). One app test calls it.
+ */
+export declare function resolveDataTableLabels(partial?: LabelOverride<DataTableLabels>): DataTableLabels;
+/**
+ * The label keys `labels` does not supply, and which therefore come back English
+ * from {@link resolveDataTableLabels}.
+ *
+ * For a consumer's own test:
+ *
+ * ```ts
+ * expect(missingDataTableLabels(de.dataTable)).toEqual([]);
+ * ```
+ *
+ * which fails the day the kit adds a key — which is the point. Adding a label is
+ * additive here and a silent regression in a translated app, and nothing else in
+ * either repository can tell the two apart.
+ *
+ * Preset labels are reported one at a time (`presets.yesterday`), because `presets`
+ * is a `Record` merged key by key: answering `"presets"` would say nothing about
+ * which of the eleven are still English.
+ *
+ * @deprecated 0.34 — `missingKitLabels(labels, DEFAULT_UI_KIT_LABELS)`, which checks every
+ * namespace, the table's among them, and which all three apps' tests already call;
+ * removed in 0.35 (refactor audit 2026-10, API-6a).
+ */
+export declare function missingDataTableLabels(labels?: Partial<DataTableLabels>): string[];

package/dist/components/data-table-labels.js

@@ -6,6 +6,7 @@ const DEFAULT_DATA_TABLE_LABELS = {
   filter: "Filter",
   close: "Close",
   selectRow: "Select row",
+  rowDetails: "Details",
   autoSize: "Auto-size columns",
   loading: "Loading\u2026",
   filters: "Filters",
@@ -48,6 +49,7 @@ const DEFAULT_DATA_TABLE_LABELS = {
   pageRange: (from, to, total) => `${from}\u2013${to} / ${total}`,
   rowCount: (total) => `${total}`,
   columnsCount: (visible, total) => `Columns (${visible}/${total})`,
+  filterColumn: (column, active) => active ? `Filter ${column} (active)` : `Filter ${column}`,
   empty: "No entries",
   actions: "Actions",
   edit: "Edit",
@@ -66,14 +68,15 @@ const DEFAULT_DATA_TABLE_LABELS = {
 };
 function resolveDataTableLabels(partial) {
   if (!partial) return DEFAULT_DATA_TABLE_LABELS;
-  const merged = {
-    ...DEFAULT_DATA_TABLE_LABELS,
-    ...partial,
-    presets: { ...DEFAULT_DATA_TABLE_LABELS.presets, ...partial.presets ?? {} }
-  };
+  const presets = { ...DEFAULT_DATA_TABLE_LABELS.presets };
+  for (const [key, text] of Object.entries(partial.presets ?? {})) if (text !== void 0) presets[key] = text;
+  const merged = { ...DEFAULT_DATA_TABLE_LABELS, ...partial, presets };
   if (partial.columns !== void 0 && partial.columnsCount === void 0) {
     merged.columnsCount = (visible, total) => `${merged.columns} (${visible}/${total})`;
   }
+  if (partial.filter !== void 0 && partial.filterColumn === void 0) {
+    merged.filterColumn = (column) => `${merged.filter}: ${column}`;
+  }
   return merged;
 }
 function missingDataTableLabels(labels) {
@@ -82,6 +85,7 @@ function missingDataTableLabels(labels) {
     if (key === "presets") continue;
     if (labels?.[key] !== void 0) continue;
     if (key === "columnsCount" && labels?.columns !== void 0) continue;
+    if (key === "filterColumn" && labels?.filter !== void 0) continue;
     missing.push(key);
   }
   for (const preset of Object.keys(DEFAULT_DATA_TABLE_LABELS.presets)) {

package/dist/components/data-table-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/data-table-labels.ts"],"sourcesContent":["// All user-facing strings for the DataTable system — the `dataTable` namespace of\n// `<UiKitProvider labels>`, and per table the `labels` prop over that. The package\n// ships no translations; the English defaults below make the table usable with no\n// wiring.\n\n// A type-only import: erased at build time, so this module stays free of the table\n// itself (and of react-router), which `i18n/defaults` relies on.\nimport type { DataTableSortLabels } from \"./data-table\";\n\n/** The phone sort control's four keys (`sortBy`, `sortDefault`, `sortAscending`,\n *  `sortDescending`, 0.22.0) are {@link DataTableSortLabels}', declared beside the\n *  control and part of this namespace like every other key. */\nexport interface DataTableLabels extends DataTableSortLabels {\n  // Table chrome\n  columns: string;\n  selectAllRows: string;\n  sortHint: string;\n  filter: string;\n  close: string;\n  selectRow: string;\n  autoSize: string;\n  loading: string;\n  filters: string;\n  clearAll: string;\n  done: string;\n  // Pagination\n  pageSize: string;\n  pageSizeAll: string;\n  prevPage: string;\n  nextPage: string;\n  // Filter popover\n  clearFilter: string;\n  filterPlaceholder: string;\n  selectFilter: string;\n  selectAll: string;\n  selectNone: string;\n  dateFrom: string;\n  dateTo: string;\n  numberMin: string;\n  numberMax: string;\n  numberAbs: string;\n  // Date-range preset labels, keyed by preset key (see dateRangePresets()).\n  presets: Record<string, string>;\n\n  /**\n   * The table's own accessible name. Deliberately a label rather than a second,\n   * parallel `tableLabel` prop: the audit already records \"three different prop\n   * names for the accessible name\" as a finding, and a table that is not \"Data\n   * table\" says so with `labels={{ table: \"Transactions\" }}` at the call site.\n   */\n  table: string;\n\n  // ---- Announcements ----\n  // Spoken through the live region, never rendered. Each takes its numbers as\n  // ARGUMENTS: a count glued into an English template literal is untranslatable,\n  // and the grammar around it moves with the number in most languages.\n\n  /** After a filter changes: \"12 of 137 rows\". */\n  filterResults: (shown: number, total: number) => string;\n  /** After a header is activated: \"Sorted by Name, ascending\". */\n  sortedAscending: (column: string) => string;\n  sortedDescending: (column: string) => string;\n  /** The third click, which removes the column from the sort entirely. */\n  sortCleared: (column: string) => string;\n  /** After paging: \"Page 3 of 14\". `page` is 1-BASED, as spoken. */\n  pageChanged: (page: number, totalPages: number) => string;\n\n  // ---- Counted chrome ----\n  // Visible text that interpolates numbers. These were template literals until the\n  // audit flagged them: a consumer could translate every key in this file and still\n  // be left with English (and with ASCII digit grouping) in the footer.\n\n  /** The pagination range summary: \"1–25 / 137\". */\n  pageRange: (from: number, to: number, total: number) => string;\n  /** The same summary when the page size is \"all\" — just the row count. */\n  rowCount: (total: number) => string;\n  /** The column-settings rail and its heading: \"Columns (4/9)\". */\n  columnsCount: (visible: number, total: number) => string;\n\n  // ---- Empty state, row actions, boolean cells (0.12.0) ----\n\n  /** The body of a table with no rows and no `empty` prop of its own. A sentence, not\n   *  \"—\": a dash in the only row of a table reads as one row with a missing value. */\n  empty: string;\n  /** The accessible name of the `rowActions` column (its header is visually empty). */\n  actions: string;\n  /** The `kind: \"edit\"` row action's name — its tooltip and its swipe label. */\n  edit: string;\n  /** The `kind: \"delete\"` row action's name. */\n  delete: string;\n  /** What {@link BooleanMark} says to a screen reader for `true` / `false` / nothing. */\n  booleanTrue: string;\n  booleanFalse: string;\n  booleanUnset: string;\n}\n\nexport const DEFAULT_DATA_TABLE_LABELS: DataTableLabels = {\n  columns: \"Columns\",\n  selectAllRows: \"Select all rows\",\n  sortHint: \"Click to sort · Shift-click to add a sort\",\n  filter: \"Filter\",\n  close: \"Close\",\n  selectRow: \"Select row\",\n  autoSize: \"Auto-size columns\",\n  loading: \"Loading…\",\n  filters: \"Filters\",\n  clearAll: \"Clear all\",\n  done: \"Done\",\n  pageSize: \"Rows per page\",\n  pageSizeAll: \"All\",\n  prevPage: \"Previous page\",\n  nextPage: \"Next page\",\n  clearFilter: \"Clear filter\",\n  filterPlaceholder: \"Filter…\",\n  selectFilter: \"Select\",\n  selectAll: \"All\",\n  selectNone: \"None\",\n  dateFrom: \"From\",\n  dateTo: \"To\",\n  numberMin: \"Min\",\n  numberMax: \"Max\",\n  numberAbs: \"Absolute value\",\n  presets: {\n    today: \"Today\",\n    yesterday: \"Yesterday\",\n    this_week: \"This week\",\n    last_week: \"Last week\",\n    last_7_days: \"Last 7 days\",\n    last_30_days: \"Last 30 days\",\n    this_month: \"This month\",\n    last_month: \"Last month\",\n    last_3_months: \"Last 3 months\",\n    ytd: \"Year to date\",\n    last_year: \"Last year\",\n  },\n  table: \"Data table\",\n  filterResults: (shown, total) => `${shown} of ${total} rows`,\n  sortedAscending: (column) => `Sorted by ${column}, ascending`,\n  sortedDescending: (column) => `Sorted by ${column}, descending`,\n  sortCleared: (column) => `Sort cleared on ${column}`,\n  pageChanged: (page, totalPages) => `Page ${page} of ${totalPages}`,\n  // The separators are the ones that shipped, so adding the seam changes no screen.\n  pageRange: (from, to, total) => `${from}–${to} / ${total}`,\n  rowCount: (total) => `${total}`,\n  columnsCount: (visible, total) => `Columns (${visible}/${total})`,\n  empty: \"No entries\",\n  actions: \"Actions\",\n  edit: \"Edit\",\n  delete: \"Delete\",\n  booleanTrue: \"Yes\",\n  booleanFalse: \"No\",\n  booleanUnset: \"Not set\",\n  // The phone sort control (0.22.0). The same words as `DEFAULT_DATA_TABLE_SORT_LABELS`\n  // in data-table.tsx, written out rather than spread in: importing that VALUE here\n  // would make data-table.tsx and this module import each other (data-table.tsx reads\n  // its resolver from here), and would pull the whole table into `i18n/defaults`.\n  sortBy: \"Sort by\",\n  sortDefault: \"Default order\",\n  sortAscending: \"Ascending\",\n  sortDescending: \"Descending\",\n};\n\n/**\n * Merge caller overrides onto the English defaults (presets merged too).\n *\n * The parameter is `Partial` on purpose — a table with no labels at all still\n * renders — but that is also how a translated app ends up half English and never\n * hears about it: lenkbank ships nineteen of these keys in English in a German UI\n * today, because every one of them is backfilled silently. The kit will not start\n * throwing over it (three apps depend on the lenient merge), so\n * {@link missingDataTableLabels} is the other half: it answers which keys fell back,\n * and an app asserts on that in its OWN test, where the answer is actionable.\n */\nexport function resolveDataTableLabels(partial?: Partial<DataTableLabels>): DataTableLabels {\n  if (!partial) return DEFAULT_DATA_TABLE_LABELS;\n  const merged: DataTableLabels = {\n    ...DEFAULT_DATA_TABLE_LABELS,\n    ...partial,\n    presets: { ...DEFAULT_DATA_TABLE_LABELS.presets, ...(partial.presets ?? {}) },\n  };\n  // `columnsCount` was split out of `columns` + a template literal. Consumers have\n  // been translating `columns` since 0.1, and backfilling the English default over\n  // that would hand them \"Columns (4/9)\" back for having translated the key that\n  // existed at the time — the same silent-English failure the audit records against\n  // this file. So the count is derived from the RESOLVED `columns` unless the caller\n  // states the whole sentence, which is the escape hatch for a language where the\n  // parenthetical does not fit.\n  if (partial.columns !== undefined && partial.columnsCount === undefined) {\n    merged.columnsCount = (visible, total) => `${merged.columns} (${visible}/${total})`;\n  }\n  return merged;\n}\n\n/**\n * The label keys `labels` does not supply, and which therefore come back English\n * from {@link resolveDataTableLabels}.\n *\n * For a consumer's own test:\n *\n * ```ts\n * expect(missingDataTableLabels(de.dataTable)).toEqual([]);\n * ```\n *\n * which fails the day the kit adds a key — which is the point. Adding a label is\n * additive here and a silent regression in a translated app, and nothing else in\n * either repository can tell the two apart.\n *\n * Preset labels are reported one at a time (`presets.yesterday`), because `presets`\n * is a `Record` merged key by key: answering `\"presets\"` would say nothing about\n * which of the eleven are still English.\n */\nexport function missingDataTableLabels(labels?: Partial<DataTableLabels>): string[] {\n  const missing: string[] = [];\n  for (const key of Object.keys(DEFAULT_DATA_TABLE_LABELS) as Array<keyof DataTableLabels>) {\n    if (key === \"presets\") continue;\n    if (labels?.[key] !== undefined) continue;\n    // `columnsCount` is DERIVED from a translated `columns` by the resolver above,\n    // so a caller who set that one is not leaking English here. Reporting it would\n    // send them to translate a key they have already covered, and an `toEqual([])`\n    // assertion built on this would never go green.\n    if (key === \"columnsCount\" && labels?.columns !== undefined) continue;\n    missing.push(key);\n  }\n  for (const preset of Object.keys(DEFAULT_DATA_TABLE_LABELS.presets)) {\n    if (labels?.presets?.[preset] === undefined) missing.push(`presets.${preset}`);\n  }\n  return missing;\n}\n"],"mappings":";AAgGO,MAAM,4BAA6C;AAAA,EACxD,SAAS;AAAA,EACT,eAAe;AAAA,EACf,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AAAA,EACV,aAAa;AAAA,EACb,UAAU;AAAA,EACV,UAAU;AAAA,EACV,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,cAAc;AAAA,EACd,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,IACP,OAAO;AAAA,IACP,WAAW;AAAA,IACX,WAAW;AAAA,IACX,WAAW;AAAA,IACX,aAAa;AAAA,IACb,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,KAAK;AAAA,IACL,WAAW;AAAA,EACb;AAAA,EACA,OAAO;AAAA,EACP,eAAe,CAAC,OAAO,UAAU,GAAG,KAAK,OAAO,KAAK;AAAA,EACrD,iBAAiB,CAAC,WAAW,aAAa,MAAM;AAAA,EAChD,kBAAkB,CAAC,WAAW,aAAa,MAAM;AAAA,EACjD,aAAa,CAAC,WAAW,mBAAmB,MAAM;AAAA,EAClD,aAAa,CAAC,MAAM,eAAe,QAAQ,IAAI,OAAO,UAAU;AAAA;AAAA,EAEhE,WAAW,CAAC,MAAM,IAAI,UAAU,GAAG,IAAI,SAAI,EAAE,MAAM,KAAK;AAAA,EACxD,UAAU,CAAC,UAAU,GAAG,KAAK;AAAA,EAC7B,cAAc,CAAC,SAAS,UAAU,YAAY,OAAO,IAAI,KAAK;AAAA,EAC9D,OAAO;AAAA,EACP,SAAS;AAAA,EACT,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA,EAKd,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,eAAe;AAAA,EACf,gBAAgB;AAClB;AAaO,SAAS,uBAAuB,SAAqD;AAC1F,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAA0B;AAAA,IAC9B,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,EAAE,GAAG,0BAA0B,SAAS,GAAI,QAAQ,WAAW,CAAC,EAAG;AAAA,EAC9E;AAQA,MAAI,QAAQ,YAAY,UAAa,QAAQ,iBAAiB,QAAW;AACvE,WAAO,eAAe,CAAC,SAAS,UAAU,GAAG,OAAO,OAAO,KAAK,OAAO,IAAI,KAAK;AAAA,EAClF;AACA,SAAO;AACT;AAoBO,SAAS,uBAAuB,QAA6C;AAClF,QAAM,UAAoB,CAAC;AAC3B,aAAW,OAAO,OAAO,KAAK,yBAAyB,GAAmC;AACxF,QAAI,QAAQ,UAAW;AACvB,QAAI,SAAS,GAAG,MAAM,OAAW;AAKjC,QAAI,QAAQ,kBAAkB,QAAQ,YAAY,OAAW;AAC7D,YAAQ,KAAK,GAAG;AAAA,EAClB;AACA,aAAW,UAAU,OAAO,KAAK,0BAA0B,OAAO,GAAG;AACnE,QAAI,QAAQ,UAAU,MAAM,MAAM,OAAW,SAAQ,KAAK,WAAW,MAAM,EAAE;AAAA,EAC/E;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/components/data-table-labels.ts"],"sourcesContent":["// All user-facing strings for the DataTable system — the `dataTable` namespace of\n// `<UiKitProvider labels>`, and per table the `labels` prop over that. The kit's seven\n// catalogues carry the translations; the English defaults below make the table usable\n// with no wiring.\n\n// A type-only import: erased at build time, so this module stays free of the table\n// itself (and of react-router), which `i18n/defaults` relies on.\nimport type { DataTableSortLabels } from \"./data-table\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\n\n/** The phone sort control's four keys (`sortBy`, `sortDefault`, `sortAscending`,\n *  `sortDescending`, 0.22.0) are {@link DataTableSortLabels}', declared beside the\n *  control and part of this namespace like every other key. */\nexport interface DataTableLabels extends DataTableSortLabels {\n  // Table chrome\n  columns: string;\n  selectAllRows: string;\n  sortHint: string;\n  filter: string;\n  close: string;\n  selectRow: string;\n  /**\n   * The name of an opening row's disclosure button on desktop — visually hidden, in the\n   * row's first cell, carrying `aria-expanded` and `aria-controls` (round 0.34, the\n   * showcase's axe check: ARIA allows `aria-expanded` on a row only in a treegrid, and\n   * the `<tr>` wore it). The same words whether the row is open or shut: the state is\n   * the button's to say.\n   */\n  rowDetails: string;\n  autoSize: string;\n  loading: string;\n  filters: string;\n  clearAll: string;\n  done: string;\n  // Pagination\n  pageSize: string;\n  pageSizeAll: string;\n  prevPage: string;\n  nextPage: string;\n  // Filter popover\n  clearFilter: string;\n  filterPlaceholder: string;\n  selectFilter: string;\n  selectAll: string;\n  selectNone: string;\n  dateFrom: string;\n  dateTo: string;\n  numberMin: string;\n  numberMax: string;\n  numberAbs: string;\n  // Date-range preset labels, keyed by preset key (see dateRangePresets()).\n  presets: Record<string, string>;\n\n  /**\n   * The table's own accessible name. Deliberately a label rather than a second,\n   * parallel `tableLabel` prop: the audit already records \"three different prop\n   * names for the accessible name\" as a finding, and a table that is not \"Data\n   * table\" says so with `labels={{ table: \"Transactions\" }}` at the call site.\n   */\n  table: string;\n\n  // ---- Announcements ----\n  // Spoken through the live region, never rendered. Each takes its numbers as\n  // ARGUMENTS: a count glued into an English template literal is untranslatable,\n  // and the grammar around it moves with the number in most languages.\n\n  /** After a filter changes: \"12 of 137 rows\". */\n  filterResults: (shown: number, total: number) => string;\n  /** After a header is activated: \"Sorted by Name, ascending\". */\n  sortedAscending: (column: string) => string;\n  sortedDescending: (column: string) => string;\n  /** The third click, which removes the column from the sort entirely. */\n  sortCleared: (column: string) => string;\n  /** After paging: \"Page 3 of 14\". `page` is 1-BASED, as spoken. */\n  pageChanged: (page: number, totalPages: number) => string;\n\n  // ---- Counted chrome ----\n  // Visible text that interpolates numbers. These were template literals until the\n  // audit flagged them: a consumer could translate every key in this file and still\n  // be left with English (and with ASCII digit grouping) in the footer.\n\n  /** The pagination range summary: \"1–25 / 137\". */\n  pageRange: (from: number, to: number, total: number) => string;\n  /** The same summary when the page size is \"all\" — just the row count. */\n  rowCount: (total: number) => string;\n  /** The column-settings rail and its heading: \"Columns (4/9)\". */\n  columnsCount: (visible: number, total: number) => string;\n  /**\n   * A column's filter button and panel: \"Filter Amount\", and \"Filter Amount (active)\"\n   * while the column is filtered (round 0.34 Wave 2, BUG-7c). Every column's used to be\n   * \"Filter\" alike, and \"filtered\" was a colour. An app that translated only `filter`\n   * gets `\"<filter>: <column>\"` from it — see {@link resolveDataTableLabels}.\n   */\n  filterColumn: (column: string, active: boolean) => string;\n\n  // ---- Empty state, row actions, boolean cells (0.12.0) ----\n\n  /** The body of a table with no rows and no `empty` prop of its own. A sentence, not\n   *  \"—\": a dash in the only row of a table reads as one row with a missing value. */\n  empty: string;\n  /** The accessible name of the `rowActions` column (its header is visually empty). */\n  actions: string;\n  /** The `kind: \"edit\"` row action's name — its tooltip and its swipe label. */\n  edit: string;\n  /** The `kind: \"delete\"` row action's name. */\n  delete: string;\n  /** What {@link BooleanMark} says to a screen reader for `true` / `false` / nothing. */\n  booleanTrue: string;\n  booleanFalse: string;\n  booleanUnset: string;\n}\n\nexport const DEFAULT_DATA_TABLE_LABELS: DataTableLabels = {\n  columns: \"Columns\",\n  selectAllRows: \"Select all rows\",\n  sortHint: \"Click to sort · Shift-click to add a sort\",\n  filter: \"Filter\",\n  close: \"Close\",\n  selectRow: \"Select row\",\n  rowDetails: \"Details\",\n  autoSize: \"Auto-size columns\",\n  loading: \"Loading…\",\n  filters: \"Filters\",\n  clearAll: \"Clear all\",\n  done: \"Done\",\n  pageSize: \"Rows per page\",\n  pageSizeAll: \"All\",\n  prevPage: \"Previous page\",\n  nextPage: \"Next page\",\n  clearFilter: \"Clear filter\",\n  filterPlaceholder: \"Filter…\",\n  selectFilter: \"Select\",\n  selectAll: \"All\",\n  selectNone: \"None\",\n  dateFrom: \"From\",\n  dateTo: \"To\",\n  numberMin: \"Min\",\n  numberMax: \"Max\",\n  numberAbs: \"Absolute value\",\n  presets: {\n    today: \"Today\",\n    yesterday: \"Yesterday\",\n    this_week: \"This week\",\n    last_week: \"Last week\",\n    last_7_days: \"Last 7 days\",\n    last_30_days: \"Last 30 days\",\n    this_month: \"This month\",\n    last_month: \"Last month\",\n    last_3_months: \"Last 3 months\",\n    ytd: \"Year to date\",\n    last_year: \"Last year\",\n  },\n  table: \"Data table\",\n  filterResults: (shown, total) => `${shown} of ${total} rows`,\n  sortedAscending: (column) => `Sorted by ${column}, ascending`,\n  sortedDescending: (column) => `Sorted by ${column}, descending`,\n  sortCleared: (column) => `Sort cleared on ${column}`,\n  pageChanged: (page, totalPages) => `Page ${page} of ${totalPages}`,\n  // The separators are the ones that shipped, so adding the seam changes no screen.\n  pageRange: (from, to, total) => `${from}–${to} / ${total}`,\n  rowCount: (total) => `${total}`,\n  columnsCount: (visible, total) => `Columns (${visible}/${total})`,\n  filterColumn: (column, active) => (active ? `Filter ${column} (active)` : `Filter ${column}`),\n  empty: \"No entries\",\n  actions: \"Actions\",\n  edit: \"Edit\",\n  delete: \"Delete\",\n  booleanTrue: \"Yes\",\n  booleanFalse: \"No\",\n  booleanUnset: \"Not set\",\n  // The phone sort control (0.22.0). The same words as `DEFAULT_DATA_TABLE_SORT_LABELS`\n  // in data-table.tsx, written out rather than spread in: importing that VALUE here\n  // would make data-table.tsx and this module import each other (data-table.tsx reads\n  // its resolver from here), and would pull the whole table into `i18n/defaults`.\n  sortBy: \"Sort by\",\n  sortDefault: \"Default order\",\n  sortAscending: \"Ascending\",\n  sortDescending: \"Descending\",\n};\n\n/**\n * Merge caller overrides onto the English defaults (presets merged too, key by key, as\n * the provider merges them — so the parameter is a {@link LabelOverride}).\n *\n * The parameter is lenient on purpose — a table with no labels at all still\n * renders — but that is also how a translated app ends up half English and never\n * hears about it: lenkbank ships nineteen of these keys in English in a German UI\n * today, because every one of them is backfilled silently. The kit will not start\n * throwing over it (three apps depend on the lenient merge), so\n * {@link missingDataTableLabels} is the other half: it answers which keys fell back,\n * and an app asserts on that in its OWN test, where the answer is actionable.\n *\n * @deprecated 0.34 — pass `labels` to DataTable, or the provider's `dataTable`, which this\n * merge serves; removed in 0.35 from the public surface, where DataTable keeps it as its\n * own (refactor audit 2026-10, API-6a). One app test calls it.\n */\nexport function resolveDataTableLabels(partial?: LabelOverride<DataTableLabels>): DataTableLabels {\n  if (!partial) return DEFAULT_DATA_TABLE_LABELS;\n  // An `undefined` preset is skipped, as the provider skips it, rather than blanking one.\n  const presets = { ...DEFAULT_DATA_TABLE_LABELS.presets };\n  for (const [key, text] of Object.entries(partial.presets ?? {})) if (text !== undefined) presets[key] = text;\n  const merged: DataTableLabels = { ...DEFAULT_DATA_TABLE_LABELS, ...partial, presets };\n  // `columnsCount` was split out of `columns` + a template literal. Consumers have\n  // been translating `columns` since 0.1, and backfilling the English default over\n  // that would hand them \"Columns (4/9)\" back for having translated the key that\n  // existed at the time — the same silent-English failure the audit records against\n  // this file. So the count is derived from the RESOLVED `columns` unless the caller\n  // states the whole sentence, which is the escape hatch for a language where the\n  // parenthetical does not fit.\n  if (partial.columns !== undefined && partial.columnsCount === undefined) {\n    merged.columnsCount = (visible, total) => `${merged.columns} (${visible}/${total})`;\n  }\n  // The same for `filterColumn` (0.34), from a translated `filter`: the app's own word\n  // with the column, rather than English for having translated the key that existed.\n  if (partial.filter !== undefined && partial.filterColumn === undefined) {\n    merged.filterColumn = (column) => `${merged.filter}: ${column}`;\n  }\n  return merged;\n}\n\n/**\n * The label keys `labels` does not supply, and which therefore come back English\n * from {@link resolveDataTableLabels}.\n *\n * For a consumer's own test:\n *\n * ```ts\n * expect(missingDataTableLabels(de.dataTable)).toEqual([]);\n * ```\n *\n * which fails the day the kit adds a key — which is the point. Adding a label is\n * additive here and a silent regression in a translated app, and nothing else in\n * either repository can tell the two apart.\n *\n * Preset labels are reported one at a time (`presets.yesterday`), because `presets`\n * is a `Record` merged key by key: answering `\"presets\"` would say nothing about\n * which of the eleven are still English.\n *\n * @deprecated 0.34 — `missingKitLabels(labels, DEFAULT_UI_KIT_LABELS)`, which checks every\n * namespace, the table's among them, and which all three apps' tests already call;\n * removed in 0.35 (refactor audit 2026-10, API-6a).\n */\nexport function missingDataTableLabels(labels?: Partial<DataTableLabels>): string[] {\n  const missing: string[] = [];\n  for (const key of Object.keys(DEFAULT_DATA_TABLE_LABELS) as Array<keyof DataTableLabels>) {\n    if (key === \"presets\") continue;\n    if (labels?.[key] !== undefined) continue;\n    // `columnsCount` is DERIVED from a translated `columns` by the resolver above,\n    // so a caller who set that one is not leaking English here. Reporting it would\n    // send them to translate a key they have already covered, and an `toEqual([])`\n    // assertion built on this would never go green.\n    if (key === \"columnsCount\" && labels?.columns !== undefined) continue;\n    if (key === \"filterColumn\" && labels?.filter !== undefined) continue;\n    missing.push(key);\n  }\n  for (const preset of Object.keys(DEFAULT_DATA_TABLE_LABELS.presets)) {\n    if (labels?.presets?.[preset] === undefined) missing.push(`presets.${preset}`);\n  }\n  return missing;\n}\n"],"mappings":"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","names":[]}