@datakable/core 1.0.0 → 1.1.0

package/dist/features/column-filters/column-filters.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/column-filters.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport { defineFeature } from '../../feature/define'\nimport type { RowModelContext } from '../../feature/types'\nimport { CellFailures } from '../../intercept/cell-batch'\nimport { errorName } from '../../intercept/classify'\nimport { boundaryDiagnostics } from '../../intercept/codes'\nimport type { ColumnValues } from '../../pipeline/types'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { columnFiltersDiagnostics } from './codes'\nimport {\n  BAD,\n  type Compiled,\n  compile,\n  MATCH,\n  NO,\n  type Outcome,\n  type RawFilter,\n  type Test,\n  typeName,\n} from './match'\nimport type { ColumnFiltersState, ColumnFiltersTypes } from './types'\n\nkeepDiagnostics(columnFiltersDiagnostics, boundaryDiagnostics)\n\nexport interface ColumnFiltersOptions {\n  /**\n   * `'server'`: the server filters (the slice goes to `options.fetcher` as `filters`, or the app\n   * fetches); core skips this step (§7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst columnFiltersOptions = { mode: modeOption } as const\n\n/** Position of column `id` in `options.columns` (diagnostic `where`); `-1` if absent. */\nfunction columnIndex(columns: readonly unknown[], id: string): number {\n  for (let i = 0; i < columns.length; i++) {\n    const c = columns[i] as { key?: unknown; id?: unknown } | null | undefined\n    if (c && typeof c === 'object' && (typeof c.key === 'string' ? c.key : c.id) === id) return i\n  }\n  return -1\n}\n\nfunction columnIds(columns: readonly unknown[]): string[] {\n  const out: string[] = []\n  for (const c of columns as readonly ({ key?: unknown; id?: unknown } | null)[]) {\n    const id = c && (typeof c.key === 'string' ? c.key : c.id)\n    if (typeof id === 'string') out.push(id)\n  }\n  return out\n}\n\n/** Nullish and `NaN` (nullish in a numeric column cache) match no active filter (§6.1). */\nconst absent = (v: unknown) =>\n  v === undefined || v === null || (typeof v === 'number' && Number.isNaN(v))\n\n/** One cell: an array cell matches if any element matches, else `BAD` if one had a wrong type. */\nfunction testCell(test: Test, v: unknown, r: number): Outcome {\n  if (!Array.isArray(v)) return test(v, r)\n  let out: Outcome = NO\n  for (let i = 0; i < v.length; i++) {\n    const e = v[i]\n    if (absent(e)) continue\n    const o = test(e, -1)\n    if (o === MATCH) return MATCH\n    if (o === BAD) out = BAD\n  }\n  return out\n}\n\n/**\n * Per-batch failures, recorded as numbers (§3.4) and reused across runs: wrong-type cells, or\n * throwing `custom` calls. Text and `where` are built only when something failed.\n */\nconst failures = new CellFailures()\nconst first = { type: '', error: undefined as unknown }\n\n/** Keeps the rows of `rows[0..n)` that pass `c`, compacted into `out` (may be `rows`). */\nfunction apply(\n  c: Extract<Compiled, { kind: 'test' | 'custom' }>,\n  values: ColumnValues,\n  data: readonly unknown[],\n  rows: Uint32Array,\n  n: number,\n  out: Uint32Array,\n): number {\n  let k = 0\n  if (c.kind === 'custom') {\n    const { fn, value } = c\n    for (let i = 0; i < n; i++) {\n      const r = rows[i] as number\n      const v = values[r]\n      if (absent(v)) continue\n      try {\n        if (fn(v, value, data[r])) out[k++] = r\n      } catch (e) {\n        if (failures.count === 0) first.error = e\n        failures.add(r, e)\n      }\n    }\n    return k\n  }\n  const test = c.test\n  for (let i = 0; i < n; i++) {\n    const r = rows[i] as number\n    const v = values[r]\n    if (absent(v)) continue\n    const o = testCell(test, v, r)\n    if (o === MATCH) out[k++] = r\n    else if (o === BAD) {\n      if (failures.count === 0) first.type = typeName(v)\n      failures.add(r, undefined)\n    }\n  }\n  return k\n}\n\nfunction report(ctx: RowModelContext, c: Compiled, id: string, kind: string, index: number) {\n  if (c.kind === 'custom') {\n    // Like a column:batch filterFn failure (§3.4); `where` is the filter's state path.\n    const name = errorName(first.error)\n    ctx.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `state.columnFilters.${id}.fn`,\n        column: id,\n        rows: Array.from(failures.sample()),\n        count: failures.count,\n        fallback: 'the failed rows are treated as non-matching',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: first.error },\n    )\n  } else if (c.kind === 'test') {\n    ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n      column: id,\n      index,\n      filter: kind,\n      source: 'cell',\n      expected: c.expected,\n      received: first.type,\n      count: failures.count,\n      rows: Array.from(failures.sample()),\n    })\n  }\n}\n\n/**\n * Applies every active column filter (AND) to `indices`: one pass per filtered column over the\n * column cache (§9.1), no per-cell allocation. Returns `indices` itself when nothing is active;\n * otherwise a new array (`indices` is never mutated).\n */\nfunction filterRows(\n  indices: Uint32Array,\n  state: Readonly<Record<string, unknown>> | undefined,\n  ctx: RowModelContext,\n): Uint32Array {\n  if (!state || typeof state !== 'object') return indices\n  let out: Uint32Array | undefined\n  let n = indices.length\n  for (const id of Object.keys(state)) {\n    const filter = state[id]\n    if (filter === undefined) continue\n    const values = ctx.getColumnValues(id)\n    if (!values) {\n      // Not a column (§7.2): ignored. No columns at all (zero-config, no rows yet) is not reported.\n      if (ctx.columns.length > 0) {\n        ctx.emit('DK_STATE_UNKNOWN_KEY', {\n          slice: 'columnFilters',\n          key: id,\n          known: columnIds(ctx.columns),\n        })\n      }\n      continue\n    }\n    const c = compile(filter, values)\n    if (c.kind === 'off') continue\n    const index = columnIndex(ctx.columns, id)\n    if (c.kind === 'bad') {\n      ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n        column: id,\n        index,\n        filter: c.filter,\n        source: 'filter',\n        expected: c.expected,\n        received: c.received,\n        count: 0,\n        rows: [],\n      })\n      return new Uint32Array(0)\n    }\n    const src = out ?? indices\n    out ??= new Uint32Array(indices.length)\n    failures.reset()\n    first.error = undefined\n    try {\n      if (c.kind === 'custom') {\n        // A user callback per cell: one `filterFn` column:batch (§3.4). A skipped batch keeps\n        // the slot fallback: no row matches.\n        const rows = src.subarray(0, n)\n        const dst = out\n        let k = 0\n        ctx.batch(id, 'filterFn', rows, () => {\n          k = apply(c, values, ctx.data, rows, rows.length, dst)\n        })\n        n = k\n      } else n = apply(c, values, ctx.data, src, n, out)\n      if (failures.count > 0) report(ctx, c, id, String((filter as RawFilter).type), index)\n    } finally {\n      failures.reset()\n      first.error = undefined\n    }\n  }\n  return out ? out.subarray(0, n) : indices\n}\n\n/**\n * Column filters (§6.1): `equals`, `contains` (case-insensitive, NFC), `in`, `range` (inclusive),\n * `custom`. Filters combine with AND; nullish cells match no active filter; array cells match if\n * any element matches; a cell of the wrong runtime type is a non-match + `DK_FILTER_TYPE_MISMATCH`.\n *\n * ```ts\n * const table = createTable({ data: users, columns, features: [columnFilters()] })\n * table.setColumnFilter('age', { type: 'range', value: { min: 18 } })\n * table.setColumnFilter('name', { type: 'contains', value: 'ada' })\n * ```\n */\nexport const columnFilters = (opts: ColumnFiltersOptions = {}) =>\n  defineFeature<'columnFilters', ColumnFiltersTypes>({\n    name: 'columnFilters',\n    stage: 'filter',\n    mode: opts.mode ?? 'client',\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? columnFiltersOptions : ({} as typeof columnFiltersOptions),\n      opts,\n    ),\n    initialState: () => ({}),\n    createApi: (ctx) => ({\n      setColumnFilter: (id, filter) =>\n        ctx.setState((prev) => {\n          const next: Record<string, unknown> = { ...prev }\n          if (filter === undefined) delete next[id]\n          else next[id] = filter\n          return next as ColumnFiltersState<unknown>\n        }),\n      resetColumnFilters: () => ctx.setState({}),\n    }),\n    rowModel: filterRows,\n  })\n"],"mappings":"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","names":["import_codes"]}
+{"version":3,"sources":["../../../src/features/column-filters/column-filters.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\nimport { defineFeature } from '../../feature/define'\nimport type { RowModelContext } from '../../feature/types'\nimport { CellFailures } from '../../intercept/cell-batch'\nimport { errorName } from '../../intercept/classify'\nimport { boundaryDiagnostics } from '../../intercept/codes'\nimport type { ColumnValues } from '../../pipeline/types'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { columnFiltersDiagnostics } from './codes'\nimport {\n  BAD,\n  type Compiled,\n  compile,\n  MATCH,\n  NO,\n  type Outcome,\n  type RawFilter,\n  type Test,\n  typeName,\n} from './match'\nimport type { ColumnFiltersState, ColumnFiltersTypes } from './types'\n\nkeepDiagnostics(columnFiltersDiagnostics, boundaryDiagnostics)\n\nexport interface ColumnFiltersOptions {\n  /**\n   * `'server'`: the server filters (the slice goes to `options.fetcher` as `filters`, or the app\n   * fetches); core skips this step (§7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst columnFiltersOptions = { mode: modeOption } as const\n\n/** Position of column `id` in `options.columns` (diagnostic `where`); `-1` if absent. */\nfunction columnIndex(columns: readonly unknown[], id: string): number {\n  for (let i = 0; i < columns.length; i++) {\n    const c = columns[i] as { key?: unknown; id?: unknown } | null | undefined\n    if (c && typeof c === 'object' && (typeof c.key === 'string' ? c.key : c.id) === id) return i\n  }\n  return -1\n}\n\nfunction columnIds(columns: readonly unknown[]): string[] {\n  const out: string[] = []\n  for (const c of columns as readonly ({ key?: unknown; id?: unknown } | null)[]) {\n    const id = c && (typeof c.key === 'string' ? c.key : c.id)\n    if (typeof id === 'string') out.push(id)\n  }\n  return out\n}\n\n/** Nullish and `NaN` (nullish in a numeric column cache) match no active filter (§6.1). */\nconst absent = (v: unknown) =>\n  v === undefined || v === null || (typeof v === 'number' && Number.isNaN(v))\n\n/** One cell: an array cell matches if any element matches, else `BAD` if one had a wrong type. */\nfunction testCell(test: Test, v: unknown, r: number): Outcome {\n  if (!Array.isArray(v)) return test(v, r)\n  let out: Outcome = NO\n  for (let i = 0; i < v.length; i++) {\n    const e = v[i]\n    if (absent(e)) continue\n    const o = test(e, -1)\n    if (o === MATCH) return MATCH\n    if (o === BAD) out = BAD\n  }\n  return out\n}\n\n/**\n * Per-batch failures, recorded as numbers (§3.4) and reused across runs: wrong-type cells, or\n * throwing `custom` calls. Text and `where` are built only when something failed.\n */\nconst failures = new CellFailures()\nconst first = { type: '', error: undefined as unknown }\n\n/** Keeps the rows of `rows[0..n)` that pass `c`, compacted into `out` (may be `rows`). */\nfunction apply(\n  c: Extract<Compiled, { kind: 'test' | 'custom' }>,\n  values: ColumnValues,\n  data: readonly unknown[],\n  rows: Uint32Array,\n  n: number,\n  out: Uint32Array,\n): number {\n  let k = 0\n  if (c.kind === 'custom') {\n    const { fn, value } = c\n    for (let i = 0; i < n; i++) {\n      const r = rows[i] as number\n      const v = values[r]\n      if (absent(v)) continue\n      try {\n        if (fn(v, value, data[r])) out[k++] = r\n      } catch (e) {\n        if (failures.count === 0) first.error = e\n        failures.add(r, e)\n      }\n    }\n    return k\n  }\n  const test = c.test\n  for (let i = 0; i < n; i++) {\n    const r = rows[i] as number\n    const v = values[r]\n    if (absent(v)) continue\n    const o = testCell(test, v, r)\n    if (o === MATCH) out[k++] = r\n    else if (o === BAD) {\n      if (failures.count === 0) first.type = typeName(v)\n      failures.add(r, undefined)\n    }\n  }\n  return k\n}\n\nfunction report(ctx: RowModelContext, c: Compiled, id: string, kind: string, index: number) {\n  if (c.kind === 'custom') {\n    // Like a column:batch filterFn failure (§3.4); `where` is the filter's state path.\n    const name = errorName(first.error)\n    ctx.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `state.columnFilters.${id}.fn`,\n        column: id,\n        rows: Array.from(failures.sample()),\n        count: failures.count,\n        fallback: 'rows-unmatched',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: first.error },\n    )\n  } else if (c.kind === 'test') {\n    ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n      column: id,\n      index,\n      filter: kind,\n      source: 'cell',\n      expected: c.expected,\n      received: first.type,\n      count: failures.count,\n      rows: Array.from(failures.sample()),\n    })\n  }\n}\n\n/**\n * Applies every active column filter (AND) to `indices`: one pass per filtered column over the\n * column cache (§9.1), no per-cell allocation. Returns `indices` itself when nothing is active;\n * otherwise a new array (`indices` is never mutated).\n */\nfunction filterRows(\n  indices: Uint32Array,\n  state: Readonly<Record<string, unknown>> | undefined,\n  ctx: RowModelContext,\n): Uint32Array {\n  if (!state || typeof state !== 'object') return indices\n  let out: Uint32Array | undefined\n  let n = indices.length\n  for (const id of Object.keys(state)) {\n    const filter = state[id]\n    if (filter === undefined) continue\n    const values = ctx.getColumnValues(id)\n    if (!values) {\n      // Not a column (§7.2): ignored. No columns at all (zero-config, no rows yet) is not reported.\n      if (ctx.columns.length > 0) {\n        ctx.emit('DK_STATE_UNKNOWN_KEY', {\n          slice: 'columnFilters',\n          key: id,\n          known: columnIds(ctx.columns),\n        })\n      }\n      continue\n    }\n    const c = compile(filter, values)\n    if (c.kind === 'off') continue\n    const index = columnIndex(ctx.columns, id)\n    if (c.kind === 'bad') {\n      ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n        column: id,\n        index,\n        filter: c.filter,\n        source: 'filter',\n        expected: c.expected,\n        received: c.received,\n        count: 0,\n        rows: [],\n      })\n      return new Uint32Array(0)\n    }\n    const src = out ?? indices\n    out ??= new Uint32Array(indices.length)\n    failures.reset()\n    first.error = undefined\n    try {\n      if (c.kind === 'custom') {\n        // A user callback per cell: one `filterFn` column:batch (§3.4). A skipped batch keeps\n        // the slot fallback: no row matches.\n        const rows = src.subarray(0, n)\n        const dst = out\n        let k = 0\n        ctx.batch(id, 'filterFn', rows, () => {\n          k = apply(c, values, ctx.data, rows, rows.length, dst)\n        })\n        n = k\n      } else n = apply(c, values, ctx.data, src, n, out)\n      if (failures.count > 0) report(ctx, c, id, String((filter as RawFilter).type), index)\n    } finally {\n      failures.reset()\n      first.error = undefined\n    }\n  }\n  return out ? out.subarray(0, n) : indices\n}\n\n/**\n * Column filters (§6.1): `equals`, `contains` (case-insensitive, NFC), `in`, `range` (inclusive),\n * `custom`. Filters combine with AND; nullish cells match no active filter; array cells match if\n * any element matches; a cell of the wrong runtime type is a non-match + `DK_FILTER_TYPE_MISMATCH`.\n *\n * ```ts\n * const table = createTable({ data: users, columns, features: [columnFilters()] })\n * table.setColumnFilter('age', { type: 'range', value: { min: 18 } })\n * table.setColumnFilter('name', { type: 'contains', value: 'ada' })\n * ```\n */\nexport const columnFilters = (opts: ColumnFiltersOptions = {}) =>\n  defineFeature<'columnFilters', ColumnFiltersTypes>({\n    name: 'columnFilters',\n    stage: 'filter',\n    mode: opts.mode ?? 'client',\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? columnFiltersOptions : ({} as typeof columnFiltersOptions),\n      opts,\n    ),\n    initialState: () => ({}),\n    createApi: (ctx) => ({\n      setColumnFilter: (id, filter) =>\n        ctx.setState((prev) => {\n          // No change (the same filter, or clearing a column without one): keep the slice.\n          if ((prev as Record<string, unknown>)[id] === filter) return prev\n          const next: Record<string, unknown> = { ...prev }\n          if (filter === undefined) delete next[id]\n          else next[id] = filter\n          return next as ColumnFiltersState<unknown>\n        }),\n      resetColumnFilters: () => ctx.setState((prev) => (Object.keys(prev).length ? {} : prev)),\n    }),\n    rowModel: filterRows,\n  })\n"],"mappings":"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","names":["import_codes"]}

package/dist/features/column-filters/column-filters.js

@@ -1,6 +1,7 @@
 // src/features/column-filters/column-filters.ts
 import { defineOptions } from "../../catalog/options.js";
 import { keepDiagnostics } from "../../diagnostics/catalog.js";
+import "../../diagnostics/process-guard.js";
 import { defineFeature } from "../../feature/define.js";
 import { CellFailures } from "../../intercept/cell-batch.js";
 import { errorName } from "../../intercept/classify.js";
@@ -87,7 +88,7 @@ function report(ctx, c, id, kind, index) {
         column: id,
         rows: Array.from(failures.sample()),
         count: failures.count,
-        fallback: "the failed rows are treated as non-matching",
+        fallback: "rows-unmatched",
         ...name === void 0 ? {} : { errorName: name }
       },
       { cause: first.error }
@@ -173,12 +174,13 @@ var columnFilters = (opts = {}) => defineFeature({
   initialState: () => ({}),
   createApi: (ctx) => ({
     setColumnFilter: (id, filter) => ctx.setState((prev) => {
+      if (prev[id] === filter) return prev;
       const next = { ...prev };
       if (filter === void 0) delete next[id];
       else next[id] = filter;
       return next;
     }),
-    resetColumnFilters: () => ctx.setState({})
+    resetColumnFilters: () => ctx.setState((prev) => Object.keys(prev).length ? {} : prev)
   }),
   rowModel: filterRows
 });

package/dist/features/column-filters/column-filters.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/column-filters.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport { defineFeature } from '../../feature/define'\nimport type { RowModelContext } from '../../feature/types'\nimport { CellFailures } from '../../intercept/cell-batch'\nimport { errorName } from '../../intercept/classify'\nimport { boundaryDiagnostics } from '../../intercept/codes'\nimport type { ColumnValues } from '../../pipeline/types'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { columnFiltersDiagnostics } from './codes'\nimport {\n  BAD,\n  type Compiled,\n  compile,\n  MATCH,\n  NO,\n  type Outcome,\n  type RawFilter,\n  type Test,\n  typeName,\n} from './match'\nimport type { ColumnFiltersState, ColumnFiltersTypes } from './types'\n\nkeepDiagnostics(columnFiltersDiagnostics, boundaryDiagnostics)\n\nexport interface ColumnFiltersOptions {\n  /**\n   * `'server'`: the server filters (the slice goes to `options.fetcher` as `filters`, or the app\n   * fetches); core skips this step (§7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst columnFiltersOptions = { mode: modeOption } as const\n\n/** Position of column `id` in `options.columns` (diagnostic `where`); `-1` if absent. */\nfunction columnIndex(columns: readonly unknown[], id: string): number {\n  for (let i = 0; i < columns.length; i++) {\n    const c = columns[i] as { key?: unknown; id?: unknown } | null | undefined\n    if (c && typeof c === 'object' && (typeof c.key === 'string' ? c.key : c.id) === id) return i\n  }\n  return -1\n}\n\nfunction columnIds(columns: readonly unknown[]): string[] {\n  const out: string[] = []\n  for (const c of columns as readonly ({ key?: unknown; id?: unknown } | null)[]) {\n    const id = c && (typeof c.key === 'string' ? c.key : c.id)\n    if (typeof id === 'string') out.push(id)\n  }\n  return out\n}\n\n/** Nullish and `NaN` (nullish in a numeric column cache) match no active filter (§6.1). */\nconst absent = (v: unknown) =>\n  v === undefined || v === null || (typeof v === 'number' && Number.isNaN(v))\n\n/** One cell: an array cell matches if any element matches, else `BAD` if one had a wrong type. */\nfunction testCell(test: Test, v: unknown, r: number): Outcome {\n  if (!Array.isArray(v)) return test(v, r)\n  let out: Outcome = NO\n  for (let i = 0; i < v.length; i++) {\n    const e = v[i]\n    if (absent(e)) continue\n    const o = test(e, -1)\n    if (o === MATCH) return MATCH\n    if (o === BAD) out = BAD\n  }\n  return out\n}\n\n/**\n * Per-batch failures, recorded as numbers (§3.4) and reused across runs: wrong-type cells, or\n * throwing `custom` calls. Text and `where` are built only when something failed.\n */\nconst failures = new CellFailures()\nconst first = { type: '', error: undefined as unknown }\n\n/** Keeps the rows of `rows[0..n)` that pass `c`, compacted into `out` (may be `rows`). */\nfunction apply(\n  c: Extract<Compiled, { kind: 'test' | 'custom' }>,\n  values: ColumnValues,\n  data: readonly unknown[],\n  rows: Uint32Array,\n  n: number,\n  out: Uint32Array,\n): number {\n  let k = 0\n  if (c.kind === 'custom') {\n    const { fn, value } = c\n    for (let i = 0; i < n; i++) {\n      const r = rows[i] as number\n      const v = values[r]\n      if (absent(v)) continue\n      try {\n        if (fn(v, value, data[r])) out[k++] = r\n      } catch (e) {\n        if (failures.count === 0) first.error = e\n        failures.add(r, e)\n      }\n    }\n    return k\n  }\n  const test = c.test\n  for (let i = 0; i < n; i++) {\n    const r = rows[i] as number\n    const v = values[r]\n    if (absent(v)) continue\n    const o = testCell(test, v, r)\n    if (o === MATCH) out[k++] = r\n    else if (o === BAD) {\n      if (failures.count === 0) first.type = typeName(v)\n      failures.add(r, undefined)\n    }\n  }\n  return k\n}\n\nfunction report(ctx: RowModelContext, c: Compiled, id: string, kind: string, index: number) {\n  if (c.kind === 'custom') {\n    // Like a column:batch filterFn failure (§3.4); `where` is the filter's state path.\n    const name = errorName(first.error)\n    ctx.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `state.columnFilters.${id}.fn`,\n        column: id,\n        rows: Array.from(failures.sample()),\n        count: failures.count,\n        fallback: 'the failed rows are treated as non-matching',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: first.error },\n    )\n  } else if (c.kind === 'test') {\n    ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n      column: id,\n      index,\n      filter: kind,\n      source: 'cell',\n      expected: c.expected,\n      received: first.type,\n      count: failures.count,\n      rows: Array.from(failures.sample()),\n    })\n  }\n}\n\n/**\n * Applies every active column filter (AND) to `indices`: one pass per filtered column over the\n * column cache (§9.1), no per-cell allocation. Returns `indices` itself when nothing is active;\n * otherwise a new array (`indices` is never mutated).\n */\nfunction filterRows(\n  indices: Uint32Array,\n  state: Readonly<Record<string, unknown>> | undefined,\n  ctx: RowModelContext,\n): Uint32Array {\n  if (!state || typeof state !== 'object') return indices\n  let out: Uint32Array | undefined\n  let n = indices.length\n  for (const id of Object.keys(state)) {\n    const filter = state[id]\n    if (filter === undefined) continue\n    const values = ctx.getColumnValues(id)\n    if (!values) {\n      // Not a column (§7.2): ignored. No columns at all (zero-config, no rows yet) is not reported.\n      if (ctx.columns.length > 0) {\n        ctx.emit('DK_STATE_UNKNOWN_KEY', {\n          slice: 'columnFilters',\n          key: id,\n          known: columnIds(ctx.columns),\n        })\n      }\n      continue\n    }\n    const c = compile(filter, values)\n    if (c.kind === 'off') continue\n    const index = columnIndex(ctx.columns, id)\n    if (c.kind === 'bad') {\n      ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n        column: id,\n        index,\n        filter: c.filter,\n        source: 'filter',\n        expected: c.expected,\n        received: c.received,\n        count: 0,\n        rows: [],\n      })\n      return new Uint32Array(0)\n    }\n    const src = out ?? indices\n    out ??= new Uint32Array(indices.length)\n    failures.reset()\n    first.error = undefined\n    try {\n      if (c.kind === 'custom') {\n        // A user callback per cell: one `filterFn` column:batch (§3.4). A skipped batch keeps\n        // the slot fallback: no row matches.\n        const rows = src.subarray(0, n)\n        const dst = out\n        let k = 0\n        ctx.batch(id, 'filterFn', rows, () => {\n          k = apply(c, values, ctx.data, rows, rows.length, dst)\n        })\n        n = k\n      } else n = apply(c, values, ctx.data, src, n, out)\n      if (failures.count > 0) report(ctx, c, id, String((filter as RawFilter).type), index)\n    } finally {\n      failures.reset()\n      first.error = undefined\n    }\n  }\n  return out ? out.subarray(0, n) : indices\n}\n\n/**\n * Column filters (§6.1): `equals`, `contains` (case-insensitive, NFC), `in`, `range` (inclusive),\n * `custom`. Filters combine with AND; nullish cells match no active filter; array cells match if\n * any element matches; a cell of the wrong runtime type is a non-match + `DK_FILTER_TYPE_MISMATCH`.\n *\n * ```ts\n * const table = createTable({ data: users, columns, features: [columnFilters()] })\n * table.setColumnFilter('age', { type: 'range', value: { min: 18 } })\n * table.setColumnFilter('name', { type: 'contains', value: 'ada' })\n * ```\n */\nexport const columnFilters = (opts: ColumnFiltersOptions = {}) =>\n  defineFeature<'columnFilters', ColumnFiltersTypes>({\n    name: 'columnFilters',\n    stage: 'filter',\n    mode: opts.mode ?? 'client',\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? columnFiltersOptions : ({} as typeof columnFiltersOptions),\n      opts,\n    ),\n    initialState: () => ({}),\n    createApi: (ctx) => ({\n      setColumnFilter: (id, filter) =>\n        ctx.setState((prev) => {\n          const next: Record<string, unknown> = { ...prev }\n          if (filter === undefined) delete next[id]\n          else next[id] = filter\n          return next as ColumnFiltersState<unknown>\n        }),\n      resetColumnFilters: () => ctx.setState({}),\n    }),\n    rowModel: filterRows,\n  })\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/features/column-filters/column-filters.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\nimport { defineFeature } from '../../feature/define'\nimport type { RowModelContext } from '../../feature/types'\nimport { CellFailures } from '../../intercept/cell-batch'\nimport { errorName } from '../../intercept/classify'\nimport { boundaryDiagnostics } from '../../intercept/codes'\nimport type { ColumnValues } from '../../pipeline/types'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { columnFiltersDiagnostics } from './codes'\nimport {\n  BAD,\n  type Compiled,\n  compile,\n  MATCH,\n  NO,\n  type Outcome,\n  type RawFilter,\n  type Test,\n  typeName,\n} from './match'\nimport type { ColumnFiltersState, ColumnFiltersTypes } from './types'\n\nkeepDiagnostics(columnFiltersDiagnostics, boundaryDiagnostics)\n\nexport interface ColumnFiltersOptions {\n  /**\n   * `'server'`: the server filters (the slice goes to `options.fetcher` as `filters`, or the app\n   * fetches); core skips this step (§7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst columnFiltersOptions = { mode: modeOption } as const\n\n/** Position of column `id` in `options.columns` (diagnostic `where`); `-1` if absent. */\nfunction columnIndex(columns: readonly unknown[], id: string): number {\n  for (let i = 0; i < columns.length; i++) {\n    const c = columns[i] as { key?: unknown; id?: unknown } | null | undefined\n    if (c && typeof c === 'object' && (typeof c.key === 'string' ? c.key : c.id) === id) return i\n  }\n  return -1\n}\n\nfunction columnIds(columns: readonly unknown[]): string[] {\n  const out: string[] = []\n  for (const c of columns as readonly ({ key?: unknown; id?: unknown } | null)[]) {\n    const id = c && (typeof c.key === 'string' ? c.key : c.id)\n    if (typeof id === 'string') out.push(id)\n  }\n  return out\n}\n\n/** Nullish and `NaN` (nullish in a numeric column cache) match no active filter (§6.1). */\nconst absent = (v: unknown) =>\n  v === undefined || v === null || (typeof v === 'number' && Number.isNaN(v))\n\n/** One cell: an array cell matches if any element matches, else `BAD` if one had a wrong type. */\nfunction testCell(test: Test, v: unknown, r: number): Outcome {\n  if (!Array.isArray(v)) return test(v, r)\n  let out: Outcome = NO\n  for (let i = 0; i < v.length; i++) {\n    const e = v[i]\n    if (absent(e)) continue\n    const o = test(e, -1)\n    if (o === MATCH) return MATCH\n    if (o === BAD) out = BAD\n  }\n  return out\n}\n\n/**\n * Per-batch failures, recorded as numbers (§3.4) and reused across runs: wrong-type cells, or\n * throwing `custom` calls. Text and `where` are built only when something failed.\n */\nconst failures = new CellFailures()\nconst first = { type: '', error: undefined as unknown }\n\n/** Keeps the rows of `rows[0..n)` that pass `c`, compacted into `out` (may be `rows`). */\nfunction apply(\n  c: Extract<Compiled, { kind: 'test' | 'custom' }>,\n  values: ColumnValues,\n  data: readonly unknown[],\n  rows: Uint32Array,\n  n: number,\n  out: Uint32Array,\n): number {\n  let k = 0\n  if (c.kind === 'custom') {\n    const { fn, value } = c\n    for (let i = 0; i < n; i++) {\n      const r = rows[i] as number\n      const v = values[r]\n      if (absent(v)) continue\n      try {\n        if (fn(v, value, data[r])) out[k++] = r\n      } catch (e) {\n        if (failures.count === 0) first.error = e\n        failures.add(r, e)\n      }\n    }\n    return k\n  }\n  const test = c.test\n  for (let i = 0; i < n; i++) {\n    const r = rows[i] as number\n    const v = values[r]\n    if (absent(v)) continue\n    const o = testCell(test, v, r)\n    if (o === MATCH) out[k++] = r\n    else if (o === BAD) {\n      if (failures.count === 0) first.type = typeName(v)\n      failures.add(r, undefined)\n    }\n  }\n  return k\n}\n\nfunction report(ctx: RowModelContext, c: Compiled, id: string, kind: string, index: number) {\n  if (c.kind === 'custom') {\n    // Like a column:batch filterFn failure (§3.4); `where` is the filter's state path.\n    const name = errorName(first.error)\n    ctx.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `state.columnFilters.${id}.fn`,\n        column: id,\n        rows: Array.from(failures.sample()),\n        count: failures.count,\n        fallback: 'rows-unmatched',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: first.error },\n    )\n  } else if (c.kind === 'test') {\n    ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n      column: id,\n      index,\n      filter: kind,\n      source: 'cell',\n      expected: c.expected,\n      received: first.type,\n      count: failures.count,\n      rows: Array.from(failures.sample()),\n    })\n  }\n}\n\n/**\n * Applies every active column filter (AND) to `indices`: one pass per filtered column over the\n * column cache (§9.1), no per-cell allocation. Returns `indices` itself when nothing is active;\n * otherwise a new array (`indices` is never mutated).\n */\nfunction filterRows(\n  indices: Uint32Array,\n  state: Readonly<Record<string, unknown>> | undefined,\n  ctx: RowModelContext,\n): Uint32Array {\n  if (!state || typeof state !== 'object') return indices\n  let out: Uint32Array | undefined\n  let n = indices.length\n  for (const id of Object.keys(state)) {\n    const filter = state[id]\n    if (filter === undefined) continue\n    const values = ctx.getColumnValues(id)\n    if (!values) {\n      // Not a column (§7.2): ignored. No columns at all (zero-config, no rows yet) is not reported.\n      if (ctx.columns.length > 0) {\n        ctx.emit('DK_STATE_UNKNOWN_KEY', {\n          slice: 'columnFilters',\n          key: id,\n          known: columnIds(ctx.columns),\n        })\n      }\n      continue\n    }\n    const c = compile(filter, values)\n    if (c.kind === 'off') continue\n    const index = columnIndex(ctx.columns, id)\n    if (c.kind === 'bad') {\n      ctx.emit('DK_FILTER_TYPE_MISMATCH', {\n        column: id,\n        index,\n        filter: c.filter,\n        source: 'filter',\n        expected: c.expected,\n        received: c.received,\n        count: 0,\n        rows: [],\n      })\n      return new Uint32Array(0)\n    }\n    const src = out ?? indices\n    out ??= new Uint32Array(indices.length)\n    failures.reset()\n    first.error = undefined\n    try {\n      if (c.kind === 'custom') {\n        // A user callback per cell: one `filterFn` column:batch (§3.4). A skipped batch keeps\n        // the slot fallback: no row matches.\n        const rows = src.subarray(0, n)\n        const dst = out\n        let k = 0\n        ctx.batch(id, 'filterFn', rows, () => {\n          k = apply(c, values, ctx.data, rows, rows.length, dst)\n        })\n        n = k\n      } else n = apply(c, values, ctx.data, src, n, out)\n      if (failures.count > 0) report(ctx, c, id, String((filter as RawFilter).type), index)\n    } finally {\n      failures.reset()\n      first.error = undefined\n    }\n  }\n  return out ? out.subarray(0, n) : indices\n}\n\n/**\n * Column filters (§6.1): `equals`, `contains` (case-insensitive, NFC), `in`, `range` (inclusive),\n * `custom`. Filters combine with AND; nullish cells match no active filter; array cells match if\n * any element matches; a cell of the wrong runtime type is a non-match + `DK_FILTER_TYPE_MISMATCH`.\n *\n * ```ts\n * const table = createTable({ data: users, columns, features: [columnFilters()] })\n * table.setColumnFilter('age', { type: 'range', value: { min: 18 } })\n * table.setColumnFilter('name', { type: 'contains', value: 'ada' })\n * ```\n */\nexport const columnFilters = (opts: ColumnFiltersOptions = {}) =>\n  defineFeature<'columnFilters', ColumnFiltersTypes>({\n    name: 'columnFilters',\n    stage: 'filter',\n    mode: opts.mode ?? 'client',\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? columnFiltersOptions : ({} as typeof columnFiltersOptions),\n      opts,\n    ),\n    initialState: () => ({}),\n    createApi: (ctx) => ({\n      setColumnFilter: (id, filter) =>\n        ctx.setState((prev) => {\n          // No change (the same filter, or clearing a column without one): keep the slice.\n          if ((prev as Record<string, unknown>)[id] === filter) return prev\n          const next: Record<string, unknown> = { ...prev }\n          if (filter === undefined) delete next[id]\n          else next[id] = filter\n          return next as ColumnFiltersState<unknown>\n        }),\n      resetColumnFilters: () => ctx.setState((prev) => (Object.keys(prev).length ? {} : prev)),\n    }),\n    rowModel: filterRows,\n  })\n"],"mappings":"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","names":[]}

package/dist/features/column-filters/match.cjs

@@ -62,7 +62,7 @@ function equals(fv) {
   }
   const type = typeof fv;
   if (type === "object" || type === "function" || type === "symbol") {
-    return bad("equals", "a primitive or a Date", fv);
+    return bad("equals", "prim-or-date", fv);
   }
   return {
     kind: "test",
@@ -103,7 +103,7 @@ function inList(fv) {
     if (item === void 0 || item === null) continue;
     if (item instanceof Date) times.add(item.getTime());
     else if (typeof item === "object" || typeof item === "function") {
-      return bad("in", "an array of primitives or Dates", item);
+      return bad("in", "prims-or-dates", item);
     } else prims.add(item);
     types.add(typeName(item));
   }
@@ -133,12 +133,12 @@ function range(fv) {
   const { min: rawMin, max: rawMax } = fv;
   const min = bound(rawMin);
   const max = bound(rawMax);
-  if (min === false) return bad("range", `${NUMERIC} or a valid Date bound`, rawMin);
-  if (max === false) return bad("range", `${NUMERIC} or a valid Date bound`, rawMax);
+  if (min === false) return bad("range", "range-bound", rawMin);
+  if (max === false) return bad("range", "range-bound", rawMax);
   if (!min && !max) return OFF;
   const family = min || max;
   if (min && max && min.family !== max.family) {
-    return bad("range", `min and max of the same type (${min.family})`, rawMax);
+    return bad("range", `same-type|${min.family}`, rawMax);
   }
   const lo = min ? min.at : void 0;
   const hi = max ? max.at : void 0;

package/dist/features/column-filters/match.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/match.ts"],"sourcesContent":["import type { ColumnValues } from '../../pipeline/types'\nimport { FILTER_KINDS } from './codes'\n\n/** Result of testing one value: a match, no match, or a value of the wrong type (non-match). */\nexport const NO = 0\nexport const MATCH = 1\nexport const BAD = 2\nexport type Outcome = typeof NO | typeof MATCH | typeof BAD\n\n/**\n * Tests one non-nullish value. `r` is the row index when the value is the whole cell, `-1` for an\n * element of an array cell (per-row caches apply to whole cells only).\n */\nexport type Test = (value: unknown, r: number) => Outcome\n\n/** A runtime filter, as read from state (runtime JSON ignores the types). */\nexport interface RawFilter {\n  readonly type?: unknown\n  readonly value?: unknown\n  readonly fn?: unknown\n}\n\nexport type Compiled =\n  /** Inactive: the step skips it. */\n  | { readonly kind: 'off' }\n  /** A value test with what it accepts (for `DK_FILTER_TYPE_MISMATCH`). */\n  | { readonly kind: 'test'; readonly test: Test; readonly expected: string }\n  | {\n      readonly kind: 'custom'\n      readonly fn: (v: unknown, fv: unknown, row: unknown) => unknown\n      readonly value: unknown\n    }\n  /** Malformed filter value: matches nothing; reported once with `source: 'filter'`. */\n  | {\n      readonly kind: 'bad'\n      readonly filter: string\n      readonly expected: string\n      readonly received: string\n    }\n\nconst OFF: Compiled = { kind: 'off' }\n\n/** A short type name for diagnostics: `null`, `array`, `Date`, else `typeof`. Never a value. */\nexport const typeName = (v: unknown): string =>\n  v === null ? 'null' : Array.isArray(v) ? 'array' : v instanceof Date ? 'Date' : typeof v\n\n/** `undefined`, `null` and `''` leave a filter (or a range bound) inactive (§6.1). */\nconst empty = (v: unknown) => v === undefined || v === null || v === ''\n\n/** Case-insensitive, NFC-normalised form for `contains` (Thai combining marks compare correctly). */\nconst fold = (s: string) => s.toLowerCase().normalize('NFC')\n\n/**\n * Folded cell strings per column-values array: the column cache returns the same array for the same\n * data and column, so typing into a `contains` filter folds each cell once.\n */\nconst folded = new WeakMap<ColumnValues, (string | undefined)[]>()\n\nfunction foldedFor(values: ColumnValues): (string | undefined)[] {\n  let f = folded.get(values)\n  if (!f) {\n    f = new Array<string | undefined>(values.length)\n    folded.set(values, f)\n  }\n  return f\n}\n\nconst bad = (filter: string, expected: string, received: unknown): Compiled => ({\n  kind: 'bad',\n  filter,\n  expected,\n  received: typeName(received),\n})\n\nfunction equals(fv: unknown): Compiled {\n  if (empty(fv)) return OFF\n  if (fv instanceof Date) {\n    const t = fv.getTime()\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (e.getTime() === t ? MATCH : NO) : BAD),\n    }\n  }\n  const type = typeof fv\n  if (type === 'object' || type === 'function' || type === 'symbol') {\n    return bad('equals', 'a primitive or a Date', fv)\n  }\n  return {\n    kind: 'test',\n    expected: type,\n    test: (e) => (typeof e === type ? (e === fv ? MATCH : NO) : BAD),\n  }\n}\n\nfunction contains(fv: unknown, values: ColumnValues): Compiled {\n  if (empty(fv)) return OFF\n  if (typeof fv !== 'string') return bad('contains', 'string', fv)\n  const needle = fold(fv)\n  const cache = foldedFor(values)\n  return {\n    kind: 'test',\n    expected: 'string',\n    test: (e, r) => {\n      if (typeof e !== 'string') return BAD\n      let s: string | undefined\n      if (r < 0) s = fold(e)\n      else {\n        s = cache[r]\n        if (s === undefined) {\n          s = fold(e)\n          cache[r] = s\n        }\n      }\n      return s.includes(needle) ? MATCH : NO\n    },\n  }\n}\n\nfunction inList(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (!Array.isArray(fv)) return bad('in', 'array', fv)\n  const prims = new Set<unknown>()\n  const times = new Set<number>()\n  const types = new Set<string>()\n  for (const item of fv as unknown[]) {\n    if (item === undefined || item === null) continue\n    if (item instanceof Date) times.add(item.getTime())\n    else if (typeof item === 'object' || typeof item === 'function') {\n      return bad('in', 'an array of primitives or Dates', item)\n    } else prims.add(item)\n    types.add(typeName(item))\n  }\n  if (types.size === 0) return OFF\n  const hasDate = times.size > 0\n  return {\n    kind: 'test',\n    expected: [...types].join(' | '),\n    test: (e) => {\n      if (e instanceof Date) return hasDate ? (times.has(e.getTime()) ? MATCH : NO) : BAD\n      return types.has(typeof e) ? (prims.has(e) ? MATCH : NO) : BAD\n    },\n  }\n}\n\ntype Family = 'number' | 'Date'\n\n/** A range bound: absent, its family + comparable value, or malformed. */\nfunction bound(v: unknown): { family: Family; at: number | bigint } | null | false {\n  if (empty(v)) return null\n  if (typeof v === 'number' || typeof v === 'bigint') return { family: 'number', at: v }\n  if (v instanceof Date && !Number.isNaN(v.getTime())) return { family: 'Date', at: v.getTime() }\n  return false\n}\n\nconst NUMERIC = 'number | bigint'\n\nfunction range(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (typeof fv !== 'object' || Array.isArray(fv) || fv instanceof Date) {\n    return bad('range', '{ min?, max? }', fv)\n  }\n  const { min: rawMin, max: rawMax } = fv as { min?: unknown; max?: unknown }\n  const min = bound(rawMin)\n  const max = bound(rawMax)\n  if (min === false) return bad('range', `${NUMERIC} or a valid Date bound`, rawMin)\n  if (max === false) return bad('range', `${NUMERIC} or a valid Date bound`, rawMax)\n  if (!min && !max) return OFF\n  const family = (min || max) as { family: Family }\n  if (min && max && min.family !== max.family) {\n    return bad('range', `min and max of the same type (${min.family})`, rawMax)\n  }\n  // Mixed number / bigint comparisons are exact in JS (`3n >= 2.5`).\n  const lo = min ? (min.at as number) : undefined\n  const hi = max ? (max.at as number) : undefined\n  const inside = (x: number) => (lo === undefined || x >= lo) && (hi === undefined || x <= hi)\n  if (family.family === 'Date') {\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (inside(e.getTime()) ? MATCH : NO) : BAD),\n    }\n  }\n  return {\n    kind: 'test',\n    expected: NUMERIC,\n    test: (e) =>\n      typeof e === 'number' || typeof e === 'bigint' ? (inside(e as number) ? MATCH : NO) : BAD,\n  }\n}\n\n/** Compiles one column's filter for this run (cold: once per active filter per run). */\nexport function compile(filter: unknown, values: ColumnValues): Compiled {\n  if (filter === undefined || filter === null) return OFF\n  if (typeof filter !== 'object') return bad('(none)', '{ type, value }', filter)\n  const f = filter as RawFilter\n  switch (f.type) {\n    case 'equals':\n      return equals(f.value)\n    case 'contains':\n      return contains(f.value, values)\n    case 'in':\n      return inList(f.value)\n    case 'range':\n      return range(f.value)\n    case 'custom':\n      return typeof f.fn === 'function'\n        ? {\n            kind: 'custom',\n            fn: f.fn as (v: unknown, fv: unknown, row: unknown) => unknown,\n            value: f.value,\n          }\n        : bad('custom', 'fn: (value, filterValue, row) => boolean', f.fn)\n    default:\n      return {\n        kind: 'bad',\n        filter: typeof f.type === 'string' ? f.type : '(none)',\n        expected: FILTER_KINDS.join(' | '),\n        received: 'unknown filter kind',\n      }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAA6B;AAGtB,IAAM,KAAK;AACX,IAAM,QAAQ;AACd,IAAM,MAAM;AAkCnB,IAAM,MAAgB,EAAE,MAAM,MAAM;AAG7B,IAAM,WAAW,CAAC,MACvB,MAAM,OAAO,SAAS,MAAM,QAAQ,CAAC,IAAI,UAAU,aAAa,OAAO,SAAS,OAAO;AAGzF,IAAM,QAAQ,CAAC,MAAe,MAAM,UAAa,MAAM,QAAQ,MAAM;AAGrE,IAAM,OAAO,CAAC,MAAc,EAAE,YAAY,EAAE,UAAU,KAAK;AAM3D,IAAM,SAAS,oBAAI,QAA8C;AAEjE,SAAS,UAAU,QAA8C;AAC/D,MAAI,IAAI,OAAO,IAAI,MAAM;AACzB,MAAI,CAAC,GAAG;AACN,QAAI,IAAI,MAA0B,OAAO,MAAM;AAC/C,WAAO,IAAI,QAAQ,CAAC;AAAA,EACtB;AACA,SAAO;AACT;AAEA,IAAM,MAAM,CAAC,QAAgB,UAAkB,cAAiC;AAAA,EAC9E,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA,UAAU,SAAS,QAAQ;AAC7B;AAEA,SAAS,OAAO,IAAuB;AACrC,MAAI,MAAM,EAAE,EAAG,QAAO;AACtB,MAAI,cAAc,MAAM;AACtB,UAAM,IAAI,GAAG,QAAQ;AACrB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,MAAM,CAAC,MAAO,aAAa,OAAQ,EAAE,QAAQ,MAAM,IAAI,QAAQ,KAAM;AAAA,IACvE;AAAA,EACF;AACA,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,cAAc,SAAS,UAAU;AACjE,WAAO,IAAI,UAAU,yBAAyB,EAAE;AAAA,EAClD;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,CAAC,MAAO,OAAO,MAAM,OAAQ,MAAM,KAAK,QAAQ,KAAM;AAAA,EAC9D;AACF;AAEA,SAAS,SAAS,IAAa,QAAgC;AAC7D,MAAI,MAAM,EAAE,EAAG,QAAO;AACtB,MAAI,OAAO,OAAO,SAAU,QAAO,IAAI,YAAY,UAAU,EAAE;AAC/D,QAAM,SAAS,KAAK,EAAE;AACtB,QAAM,QAAQ,UAAU,MAAM;AAC9B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,CAAC,GAAG,MAAM;AACd,UAAI,OAAO,MAAM,SAAU,QAAO;AAClC,UAAI;AACJ,UAAI,IAAI,EAAG,KAAI,KAAK,CAAC;AAAA,WAChB;AACH,YAAI,MAAM,CAAC;AACX,YAAI,MAAM,QAAW;AACnB,cAAI,KAAK,CAAC;AACV,gBAAM,CAAC,IAAI;AAAA,QACb;AAAA,MACF;AACA,aAAO,EAAE,SAAS,MAAM,IAAI,QAAQ;AAAA,IACtC;AAAA,EACF;AACF;AAEA,SAAS,OAAO,IAAuB;AACrC,MAAI,OAAO,UAAa,OAAO,KAAM,QAAO;AAC5C,MAAI,CAAC,MAAM,QAAQ,EAAE,EAAG,QAAO,IAAI,MAAM,SAAS,EAAE;AACpD,QAAM,QAAQ,oBAAI,IAAa;AAC/B,QAAM,QAAQ,oBAAI,IAAY;AAC9B,QAAM,QAAQ,oBAAI,IAAY;AAC9B,aAAW,QAAQ,IAAiB;AAClC,QAAI,SAAS,UAAa,SAAS,KAAM;AACzC,QAAI,gBAAgB,KAAM,OAAM,IAAI,KAAK,QAAQ,CAAC;AAAA,aACzC,OAAO,SAAS,YAAY,OAAO,SAAS,YAAY;AAC/D,aAAO,IAAI,MAAM,mCAAmC,IAAI;AAAA,IAC1D,MAAO,OAAM,IAAI,IAAI;AACrB,UAAM,IAAI,SAAS,IAAI,CAAC;AAAA,EAC1B;AACA,MAAI,MAAM,SAAS,EAAG,QAAO;AAC7B,QAAM,UAAU,MAAM,OAAO;AAC7B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU,CAAC,GAAG,KAAK,EAAE,KAAK,KAAK;AAAA,IAC/B,MAAM,CAAC,MAAM;AACX,UAAI,aAAa,KAAM,QAAO,UAAW,MAAM,IAAI,EAAE,QAAQ,CAAC,IAAI,QAAQ,KAAM;AAChF,aAAO,MAAM,IAAI,OAAO,CAAC,IAAK,MAAM,IAAI,CAAC,IAAI,QAAQ,KAAM;AAAA,IAC7D;AAAA,EACF;AACF;AAKA,SAAS,MAAM,GAAoE;AACjF,MAAI,MAAM,CAAC,EAAG,QAAO;AACrB,MAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SAAU,QAAO,EAAE,QAAQ,UAAU,IAAI,EAAE;AACrF,MAAI,aAAa,QAAQ,CAAC,OAAO,MAAM,EAAE,QAAQ,CAAC,EAAG,QAAO,EAAE,QAAQ,QAAQ,IAAI,EAAE,QAAQ,EAAE;AAC9F,SAAO;AACT;AAEA,IAAM,UAAU;AAEhB,SAAS,MAAM,IAAuB;AACpC,MAAI,OAAO,UAAa,OAAO,KAAM,QAAO;AAC5C,MAAI,OAAO,OAAO,YAAY,MAAM,QAAQ,EAAE,KAAK,cAAc,MAAM;AACrE,WAAO,IAAI,SAAS,kBAAkB,EAAE;AAAA,EAC1C;AACA,QAAM,EAAE,KAAK,QAAQ,KAAK,OAAO,IAAI;AACrC,QAAM,MAAM,MAAM,MAAM;AACxB,QAAM,MAAM,MAAM,MAAM;AACxB,MAAI,QAAQ,MAAO,QAAO,IAAI,SAAS,GAAG,OAAO,0BAA0B,MAAM;AACjF,MAAI,QAAQ,MAAO,QAAO,IAAI,SAAS,GAAG,OAAO,0BAA0B,MAAM;AACjF,MAAI,CAAC,OAAO,CAAC,IAAK,QAAO;AACzB,QAAM,SAAU,OAAO;AACvB,MAAI,OAAO,OAAO,IAAI,WAAW,IAAI,QAAQ;AAC3C,WAAO,IAAI,SAAS,iCAAiC,IAAI,MAAM,KAAK,MAAM;AAAA,EAC5E;AAEA,QAAM,KAAK,MAAO,IAAI,KAAgB;AACtC,QAAM,KAAK,MAAO,IAAI,KAAgB;AACtC,QAAM,SAAS,CAAC,OAAe,OAAO,UAAa,KAAK,QAAQ,OAAO,UAAa,KAAK;AACzF,MAAI,OAAO,WAAW,QAAQ;AAC5B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,MAAM,CAAC,MAAO,aAAa,OAAQ,OAAO,EAAE,QAAQ,CAAC,IAAI,QAAQ,KAAM;AAAA,IACzE;AAAA,EACF;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,CAAC,MACL,OAAO,MAAM,YAAY,OAAO,MAAM,WAAY,OAAO,CAAW,IAAI,QAAQ,KAAM;AAAA,EAC1F;AACF;AAGO,SAAS,QAAQ,QAAiB,QAAgC;AACvE,MAAI,WAAW,UAAa,WAAW,KAAM,QAAO;AACpD,MAAI,OAAO,WAAW,SAAU,QAAO,IAAI,UAAU,mBAAmB,MAAM;AAC9E,QAAM,IAAI;AACV,UAAQ,EAAE,MAAM;AAAA,IACd,KAAK;AACH,aAAO,OAAO,EAAE,KAAK;AAAA,IACvB,KAAK;AACH,aAAO,SAAS,EAAE,OAAO,MAAM;AAAA,IACjC,KAAK;AACH,aAAO,OAAO,EAAE,KAAK;AAAA,IACvB,KAAK;AACH,aAAO,MAAM,EAAE,KAAK;AAAA,IACtB,KAAK;AACH,aAAO,OAAO,EAAE,OAAO,aACnB;AAAA,QACE,MAAM;AAAA,QACN,IAAI,EAAE;AAAA,QACN,OAAO,EAAE;AAAA,MACX,IACA,IAAI,UAAU,4CAA4C,EAAE,EAAE;AAAA,IACpE;AACE,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ,OAAO,EAAE,SAAS,WAAW,EAAE,OAAO;AAAA,QAC9C,UAAU,0BAAa,KAAK,KAAK;AAAA,QACjC,UAAU;AAAA,MACZ;AAAA,EACJ;AACF;","names":[]}
+{"version":3,"sources":["../../../src/features/column-filters/match.ts"],"sourcesContent":["import type { ColumnValues } from '../../pipeline/types'\nimport { FILTER_KINDS } from './codes'\n\n/** Result of testing one value: a match, no match, or a value of the wrong type (non-match). */\nexport const NO = 0\nexport const MATCH = 1\nexport const BAD = 2\nexport type Outcome = typeof NO | typeof MATCH | typeof BAD\n\n/**\n * Tests one non-nullish value. `r` is the row index when the value is the whole cell, `-1` for an\n * element of an array cell (per-row caches apply to whole cells only).\n */\nexport type Test = (value: unknown, r: number) => Outcome\n\n/** A runtime filter, as read from state (runtime JSON ignores the types). */\nexport interface RawFilter {\n  readonly type?: unknown\n  readonly value?: unknown\n  readonly fn?: unknown\n}\n\nexport type Compiled =\n  /** Inactive: the step skips it. */\n  | { readonly kind: 'off' }\n  /** A value test with what it accepts (for `DK_FILTER_TYPE_MISMATCH`). */\n  | { readonly kind: 'test'; readonly test: Test; readonly expected: string }\n  | {\n      readonly kind: 'custom'\n      readonly fn: (v: unknown, fv: unknown, row: unknown) => unknown\n      readonly value: unknown\n    }\n  /** Malformed filter value: matches nothing; reported once with `source: 'filter'`. */\n  | {\n      readonly kind: 'bad'\n      readonly filter: string\n      readonly expected: string\n      readonly received: string\n    }\n\nconst OFF: Compiled = { kind: 'off' }\n\n/** A short type name for diagnostics: `null`, `array`, `Date`, else `typeof`. Never a value. */\nexport const typeName = (v: unknown): string =>\n  v === null ? 'null' : Array.isArray(v) ? 'array' : v instanceof Date ? 'Date' : typeof v\n\n/** `undefined`, `null` and `''` leave a filter (or a range bound) inactive (§6.1). */\nconst empty = (v: unknown) => v === undefined || v === null || v === ''\n\n/** Case-insensitive, NFC-normalised form for `contains` (Thai combining marks compare correctly). */\nconst fold = (s: string) => s.toLowerCase().normalize('NFC')\n\n/**\n * Folded cell strings per column-values array: the column cache returns the same array for the same\n * data and column, so typing into a `contains` filter folds each cell once.\n */\nconst folded = new WeakMap<ColumnValues, (string | undefined)[]>()\n\nfunction foldedFor(values: ColumnValues): (string | undefined)[] {\n  let f = folded.get(values)\n  if (!f) {\n    f = new Array<string | undefined>(values.length)\n    folded.set(values, f)\n  }\n  return f\n}\n\nconst bad = (filter: string, expected: string, received: unknown): Compiled => ({\n  kind: 'bad',\n  filter,\n  expected,\n  received: typeName(received),\n})\n\nfunction equals(fv: unknown): Compiled {\n  if (empty(fv)) return OFF\n  if (fv instanceof Date) {\n    const t = fv.getTime()\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (e.getTime() === t ? MATCH : NO) : BAD),\n    }\n  }\n  const type = typeof fv\n  if (type === 'object' || type === 'function' || type === 'symbol') {\n    return bad('equals', 'prim-or-date', fv)\n  }\n  return {\n    kind: 'test',\n    expected: type,\n    test: (e) => (typeof e === type ? (e === fv ? MATCH : NO) : BAD),\n  }\n}\n\nfunction contains(fv: unknown, values: ColumnValues): Compiled {\n  if (empty(fv)) return OFF\n  if (typeof fv !== 'string') return bad('contains', 'string', fv)\n  const needle = fold(fv)\n  const cache = foldedFor(values)\n  return {\n    kind: 'test',\n    expected: 'string',\n    test: (e, r) => {\n      if (typeof e !== 'string') return BAD\n      let s: string | undefined\n      if (r < 0) s = fold(e)\n      else {\n        s = cache[r]\n        if (s === undefined) {\n          s = fold(e)\n          cache[r] = s\n        }\n      }\n      return s.includes(needle) ? MATCH : NO\n    },\n  }\n}\n\nfunction inList(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (!Array.isArray(fv)) return bad('in', 'array', fv)\n  const prims = new Set<unknown>()\n  const times = new Set<number>()\n  const types = new Set<string>()\n  for (const item of fv as unknown[]) {\n    if (item === undefined || item === null) continue\n    if (item instanceof Date) times.add(item.getTime())\n    else if (typeof item === 'object' || typeof item === 'function') {\n      return bad('in', 'prims-or-dates', item)\n    } else prims.add(item)\n    types.add(typeName(item))\n  }\n  if (types.size === 0) return OFF\n  const hasDate = times.size > 0\n  return {\n    kind: 'test',\n    expected: [...types].join(' | '),\n    test: (e) => {\n      if (e instanceof Date) return hasDate ? (times.has(e.getTime()) ? MATCH : NO) : BAD\n      return types.has(typeof e) ? (prims.has(e) ? MATCH : NO) : BAD\n    },\n  }\n}\n\ntype Family = 'number' | 'Date'\n\n/** A range bound: absent, its family + comparable value, or malformed. */\nfunction bound(v: unknown): { family: Family; at: number | bigint } | null | false {\n  if (empty(v)) return null\n  if (typeof v === 'number' || typeof v === 'bigint') return { family: 'number', at: v }\n  if (v instanceof Date && !Number.isNaN(v.getTime())) return { family: 'Date', at: v.getTime() }\n  return false\n}\n\nconst NUMERIC = 'number | bigint'\n\nfunction range(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (typeof fv !== 'object' || Array.isArray(fv) || fv instanceof Date) {\n    return bad('range', '{ min?, max? }', fv)\n  }\n  const { min: rawMin, max: rawMax } = fv as { min?: unknown; max?: unknown }\n  const min = bound(rawMin)\n  const max = bound(rawMax)\n  // `expected` prose keys (diagnostics/prose.ts).\n  if (min === false) return bad('range', 'range-bound', rawMin)\n  if (max === false) return bad('range', 'range-bound', rawMax)\n  if (!min && !max) return OFF\n  const family = (min || max) as { family: Family }\n  if (min && max && min.family !== max.family) {\n    return bad('range', `same-type|${min.family}`, rawMax)\n  }\n  // Mixed number / bigint comparisons are exact in JS (`3n >= 2.5`).\n  const lo = min ? (min.at as number) : undefined\n  const hi = max ? (max.at as number) : undefined\n  const inside = (x: number) => (lo === undefined || x >= lo) && (hi === undefined || x <= hi)\n  if (family.family === 'Date') {\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (inside(e.getTime()) ? MATCH : NO) : BAD),\n    }\n  }\n  return {\n    kind: 'test',\n    expected: NUMERIC,\n    test: (e) =>\n      typeof e === 'number' || typeof e === 'bigint' ? (inside(e as number) ? MATCH : NO) : BAD,\n  }\n}\n\n/** Compiles one column's filter for this run (cold: once per active filter per run). */\nexport function compile(filter: unknown, values: ColumnValues): Compiled {\n  if (filter === undefined || filter === null) return OFF\n  if (typeof filter !== 'object') return bad('(none)', '{ type, value }', filter)\n  const f = filter as RawFilter\n  switch (f.type) {\n    case 'equals':\n      return equals(f.value)\n    case 'contains':\n      return contains(f.value, values)\n    case 'in':\n      return inList(f.value)\n    case 'range':\n      return range(f.value)\n    case 'custom':\n      return typeof f.fn === 'function'\n        ? {\n            kind: 'custom',\n            fn: f.fn as (v: unknown, fv: unknown, row: unknown) => unknown,\n            value: f.value,\n          }\n        : bad('custom', 'fn: (value, filterValue, row) => boolean', f.fn)\n    default:\n      return {\n        kind: 'bad',\n        filter: typeof f.type === 'string' ? f.type : '(none)',\n        expected: FILTER_KINDS.join(' | '),\n        received: 'unknown filter kind',\n      }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/features/column-filters/match.js

@@ -34,7 +34,7 @@ function equals(fv) {
   }
   const type = typeof fv;
   if (type === "object" || type === "function" || type === "symbol") {
-    return bad("equals", "a primitive or a Date", fv);
+    return bad("equals", "prim-or-date", fv);
   }
   return {
     kind: "test",
@@ -75,7 +75,7 @@ function inList(fv) {
     if (item === void 0 || item === null) continue;
     if (item instanceof Date) times.add(item.getTime());
     else if (typeof item === "object" || typeof item === "function") {
-      return bad("in", "an array of primitives or Dates", item);
+      return bad("in", "prims-or-dates", item);
     } else prims.add(item);
     types.add(typeName(item));
   }
@@ -105,12 +105,12 @@ function range(fv) {
   const { min: rawMin, max: rawMax } = fv;
   const min = bound(rawMin);
   const max = bound(rawMax);
-  if (min === false) return bad("range", `${NUMERIC} or a valid Date bound`, rawMin);
-  if (max === false) return bad("range", `${NUMERIC} or a valid Date bound`, rawMax);
+  if (min === false) return bad("range", "range-bound", rawMin);
+  if (max === false) return bad("range", "range-bound", rawMax);
   if (!min && !max) return OFF;
   const family = min || max;
   if (min && max && min.family !== max.family) {
-    return bad("range", `min and max of the same type (${min.family})`, rawMax);
+    return bad("range", `same-type|${min.family}`, rawMax);
   }
   const lo = min ? min.at : void 0;
   const hi = max ? max.at : void 0;

package/dist/features/column-filters/match.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/match.ts"],"sourcesContent":["import type { ColumnValues } from '../../pipeline/types'\nimport { FILTER_KINDS } from './codes'\n\n/** Result of testing one value: a match, no match, or a value of the wrong type (non-match). */\nexport const NO = 0\nexport const MATCH = 1\nexport const BAD = 2\nexport type Outcome = typeof NO | typeof MATCH | typeof BAD\n\n/**\n * Tests one non-nullish value. `r` is the row index when the value is the whole cell, `-1` for an\n * element of an array cell (per-row caches apply to whole cells only).\n */\nexport type Test = (value: unknown, r: number) => Outcome\n\n/** A runtime filter, as read from state (runtime JSON ignores the types). */\nexport interface RawFilter {\n  readonly type?: unknown\n  readonly value?: unknown\n  readonly fn?: unknown\n}\n\nexport type Compiled =\n  /** Inactive: the step skips it. */\n  | { readonly kind: 'off' }\n  /** A value test with what it accepts (for `DK_FILTER_TYPE_MISMATCH`). */\n  | { readonly kind: 'test'; readonly test: Test; readonly expected: string }\n  | {\n      readonly kind: 'custom'\n      readonly fn: (v: unknown, fv: unknown, row: unknown) => unknown\n      readonly value: unknown\n    }\n  /** Malformed filter value: matches nothing; reported once with `source: 'filter'`. */\n  | {\n      readonly kind: 'bad'\n      readonly filter: string\n      readonly expected: string\n      readonly received: string\n    }\n\nconst OFF: Compiled = { kind: 'off' }\n\n/** A short type name for diagnostics: `null`, `array`, `Date`, else `typeof`. Never a value. */\nexport const typeName = (v: unknown): string =>\n  v === null ? 'null' : Array.isArray(v) ? 'array' : v instanceof Date ? 'Date' : typeof v\n\n/** `undefined`, `null` and `''` leave a filter (or a range bound) inactive (§6.1). */\nconst empty = (v: unknown) => v === undefined || v === null || v === ''\n\n/** Case-insensitive, NFC-normalised form for `contains` (Thai combining marks compare correctly). */\nconst fold = (s: string) => s.toLowerCase().normalize('NFC')\n\n/**\n * Folded cell strings per column-values array: the column cache returns the same array for the same\n * data and column, so typing into a `contains` filter folds each cell once.\n */\nconst folded = new WeakMap<ColumnValues, (string | undefined)[]>()\n\nfunction foldedFor(values: ColumnValues): (string | undefined)[] {\n  let f = folded.get(values)\n  if (!f) {\n    f = new Array<string | undefined>(values.length)\n    folded.set(values, f)\n  }\n  return f\n}\n\nconst bad = (filter: string, expected: string, received: unknown): Compiled => ({\n  kind: 'bad',\n  filter,\n  expected,\n  received: typeName(received),\n})\n\nfunction equals(fv: unknown): Compiled {\n  if (empty(fv)) return OFF\n  if (fv instanceof Date) {\n    const t = fv.getTime()\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (e.getTime() === t ? MATCH : NO) : BAD),\n    }\n  }\n  const type = typeof fv\n  if (type === 'object' || type === 'function' || type === 'symbol') {\n    return bad('equals', 'a primitive or a Date', fv)\n  }\n  return {\n    kind: 'test',\n    expected: type,\n    test: (e) => (typeof e === type ? (e === fv ? MATCH : NO) : BAD),\n  }\n}\n\nfunction contains(fv: unknown, values: ColumnValues): Compiled {\n  if (empty(fv)) return OFF\n  if (typeof fv !== 'string') return bad('contains', 'string', fv)\n  const needle = fold(fv)\n  const cache = foldedFor(values)\n  return {\n    kind: 'test',\n    expected: 'string',\n    test: (e, r) => {\n      if (typeof e !== 'string') return BAD\n      let s: string | undefined\n      if (r < 0) s = fold(e)\n      else {\n        s = cache[r]\n        if (s === undefined) {\n          s = fold(e)\n          cache[r] = s\n        }\n      }\n      return s.includes(needle) ? MATCH : NO\n    },\n  }\n}\n\nfunction inList(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (!Array.isArray(fv)) return bad('in', 'array', fv)\n  const prims = new Set<unknown>()\n  const times = new Set<number>()\n  const types = new Set<string>()\n  for (const item of fv as unknown[]) {\n    if (item === undefined || item === null) continue\n    if (item instanceof Date) times.add(item.getTime())\n    else if (typeof item === 'object' || typeof item === 'function') {\n      return bad('in', 'an array of primitives or Dates', item)\n    } else prims.add(item)\n    types.add(typeName(item))\n  }\n  if (types.size === 0) return OFF\n  const hasDate = times.size > 0\n  return {\n    kind: 'test',\n    expected: [...types].join(' | '),\n    test: (e) => {\n      if (e instanceof Date) return hasDate ? (times.has(e.getTime()) ? MATCH : NO) : BAD\n      return types.has(typeof e) ? (prims.has(e) ? MATCH : NO) : BAD\n    },\n  }\n}\n\ntype Family = 'number' | 'Date'\n\n/** A range bound: absent, its family + comparable value, or malformed. */\nfunction bound(v: unknown): { family: Family; at: number | bigint } | null | false {\n  if (empty(v)) return null\n  if (typeof v === 'number' || typeof v === 'bigint') return { family: 'number', at: v }\n  if (v instanceof Date && !Number.isNaN(v.getTime())) return { family: 'Date', at: v.getTime() }\n  return false\n}\n\nconst NUMERIC = 'number | bigint'\n\nfunction range(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (typeof fv !== 'object' || Array.isArray(fv) || fv instanceof Date) {\n    return bad('range', '{ min?, max? }', fv)\n  }\n  const { min: rawMin, max: rawMax } = fv as { min?: unknown; max?: unknown }\n  const min = bound(rawMin)\n  const max = bound(rawMax)\n  if (min === false) return bad('range', `${NUMERIC} or a valid Date bound`, rawMin)\n  if (max === false) return bad('range', `${NUMERIC} or a valid Date bound`, rawMax)\n  if (!min && !max) return OFF\n  const family = (min || max) as { family: Family }\n  if (min && max && min.family !== max.family) {\n    return bad('range', `min and max of the same type (${min.family})`, rawMax)\n  }\n  // Mixed number / bigint comparisons are exact in JS (`3n >= 2.5`).\n  const lo = min ? (min.at as number) : undefined\n  const hi = max ? (max.at as number) : undefined\n  const inside = (x: number) => (lo === undefined || x >= lo) && (hi === undefined || x <= hi)\n  if (family.family === 'Date') {\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (inside(e.getTime()) ? MATCH : NO) : BAD),\n    }\n  }\n  return {\n    kind: 'test',\n    expected: NUMERIC,\n    test: (e) =>\n      typeof e === 'number' || typeof e === 'bigint' ? (inside(e as number) ? MATCH : NO) : BAD,\n  }\n}\n\n/** Compiles one column's filter for this run (cold: once per active filter per run). */\nexport function compile(filter: unknown, values: ColumnValues): Compiled {\n  if (filter === undefined || filter === null) return OFF\n  if (typeof filter !== 'object') return bad('(none)', '{ type, value }', filter)\n  const f = filter as RawFilter\n  switch (f.type) {\n    case 'equals':\n      return equals(f.value)\n    case 'contains':\n      return contains(f.value, values)\n    case 'in':\n      return inList(f.value)\n    case 'range':\n      return range(f.value)\n    case 'custom':\n      return typeof f.fn === 'function'\n        ? {\n            kind: 'custom',\n            fn: f.fn as (v: unknown, fv: unknown, row: unknown) => unknown,\n            value: f.value,\n          }\n        : bad('custom', 'fn: (value, filterValue, row) => boolean', f.fn)\n    default:\n      return {\n        kind: 'bad',\n        filter: typeof f.type === 'string' ? f.type : '(none)',\n        expected: FILTER_KINDS.join(' | '),\n        received: 'unknown filter kind',\n      }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/features/column-filters/match.ts"],"sourcesContent":["import type { ColumnValues } from '../../pipeline/types'\nimport { FILTER_KINDS } from './codes'\n\n/** Result of testing one value: a match, no match, or a value of the wrong type (non-match). */\nexport const NO = 0\nexport const MATCH = 1\nexport const BAD = 2\nexport type Outcome = typeof NO | typeof MATCH | typeof BAD\n\n/**\n * Tests one non-nullish value. `r` is the row index when the value is the whole cell, `-1` for an\n * element of an array cell (per-row caches apply to whole cells only).\n */\nexport type Test = (value: unknown, r: number) => Outcome\n\n/** A runtime filter, as read from state (runtime JSON ignores the types). */\nexport interface RawFilter {\n  readonly type?: unknown\n  readonly value?: unknown\n  readonly fn?: unknown\n}\n\nexport type Compiled =\n  /** Inactive: the step skips it. */\n  | { readonly kind: 'off' }\n  /** A value test with what it accepts (for `DK_FILTER_TYPE_MISMATCH`). */\n  | { readonly kind: 'test'; readonly test: Test; readonly expected: string }\n  | {\n      readonly kind: 'custom'\n      readonly fn: (v: unknown, fv: unknown, row: unknown) => unknown\n      readonly value: unknown\n    }\n  /** Malformed filter value: matches nothing; reported once with `source: 'filter'`. */\n  | {\n      readonly kind: 'bad'\n      readonly filter: string\n      readonly expected: string\n      readonly received: string\n    }\n\nconst OFF: Compiled = { kind: 'off' }\n\n/** A short type name for diagnostics: `null`, `array`, `Date`, else `typeof`. Never a value. */\nexport const typeName = (v: unknown): string =>\n  v === null ? 'null' : Array.isArray(v) ? 'array' : v instanceof Date ? 'Date' : typeof v\n\n/** `undefined`, `null` and `''` leave a filter (or a range bound) inactive (§6.1). */\nconst empty = (v: unknown) => v === undefined || v === null || v === ''\n\n/** Case-insensitive, NFC-normalised form for `contains` (Thai combining marks compare correctly). */\nconst fold = (s: string) => s.toLowerCase().normalize('NFC')\n\n/**\n * Folded cell strings per column-values array: the column cache returns the same array for the same\n * data and column, so typing into a `contains` filter folds each cell once.\n */\nconst folded = new WeakMap<ColumnValues, (string | undefined)[]>()\n\nfunction foldedFor(values: ColumnValues): (string | undefined)[] {\n  let f = folded.get(values)\n  if (!f) {\n    f = new Array<string | undefined>(values.length)\n    folded.set(values, f)\n  }\n  return f\n}\n\nconst bad = (filter: string, expected: string, received: unknown): Compiled => ({\n  kind: 'bad',\n  filter,\n  expected,\n  received: typeName(received),\n})\n\nfunction equals(fv: unknown): Compiled {\n  if (empty(fv)) return OFF\n  if (fv instanceof Date) {\n    const t = fv.getTime()\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (e.getTime() === t ? MATCH : NO) : BAD),\n    }\n  }\n  const type = typeof fv\n  if (type === 'object' || type === 'function' || type === 'symbol') {\n    return bad('equals', 'prim-or-date', fv)\n  }\n  return {\n    kind: 'test',\n    expected: type,\n    test: (e) => (typeof e === type ? (e === fv ? MATCH : NO) : BAD),\n  }\n}\n\nfunction contains(fv: unknown, values: ColumnValues): Compiled {\n  if (empty(fv)) return OFF\n  if (typeof fv !== 'string') return bad('contains', 'string', fv)\n  const needle = fold(fv)\n  const cache = foldedFor(values)\n  return {\n    kind: 'test',\n    expected: 'string',\n    test: (e, r) => {\n      if (typeof e !== 'string') return BAD\n      let s: string | undefined\n      if (r < 0) s = fold(e)\n      else {\n        s = cache[r]\n        if (s === undefined) {\n          s = fold(e)\n          cache[r] = s\n        }\n      }\n      return s.includes(needle) ? MATCH : NO\n    },\n  }\n}\n\nfunction inList(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (!Array.isArray(fv)) return bad('in', 'array', fv)\n  const prims = new Set<unknown>()\n  const times = new Set<number>()\n  const types = new Set<string>()\n  for (const item of fv as unknown[]) {\n    if (item === undefined || item === null) continue\n    if (item instanceof Date) times.add(item.getTime())\n    else if (typeof item === 'object' || typeof item === 'function') {\n      return bad('in', 'prims-or-dates', item)\n    } else prims.add(item)\n    types.add(typeName(item))\n  }\n  if (types.size === 0) return OFF\n  const hasDate = times.size > 0\n  return {\n    kind: 'test',\n    expected: [...types].join(' | '),\n    test: (e) => {\n      if (e instanceof Date) return hasDate ? (times.has(e.getTime()) ? MATCH : NO) : BAD\n      return types.has(typeof e) ? (prims.has(e) ? MATCH : NO) : BAD\n    },\n  }\n}\n\ntype Family = 'number' | 'Date'\n\n/** A range bound: absent, its family + comparable value, or malformed. */\nfunction bound(v: unknown): { family: Family; at: number | bigint } | null | false {\n  if (empty(v)) return null\n  if (typeof v === 'number' || typeof v === 'bigint') return { family: 'number', at: v }\n  if (v instanceof Date && !Number.isNaN(v.getTime())) return { family: 'Date', at: v.getTime() }\n  return false\n}\n\nconst NUMERIC = 'number | bigint'\n\nfunction range(fv: unknown): Compiled {\n  if (fv === undefined || fv === null) return OFF\n  if (typeof fv !== 'object' || Array.isArray(fv) || fv instanceof Date) {\n    return bad('range', '{ min?, max? }', fv)\n  }\n  const { min: rawMin, max: rawMax } = fv as { min?: unknown; max?: unknown }\n  const min = bound(rawMin)\n  const max = bound(rawMax)\n  // `expected` prose keys (diagnostics/prose.ts).\n  if (min === false) return bad('range', 'range-bound', rawMin)\n  if (max === false) return bad('range', 'range-bound', rawMax)\n  if (!min && !max) return OFF\n  const family = (min || max) as { family: Family }\n  if (min && max && min.family !== max.family) {\n    return bad('range', `same-type|${min.family}`, rawMax)\n  }\n  // Mixed number / bigint comparisons are exact in JS (`3n >= 2.5`).\n  const lo = min ? (min.at as number) : undefined\n  const hi = max ? (max.at as number) : undefined\n  const inside = (x: number) => (lo === undefined || x >= lo) && (hi === undefined || x <= hi)\n  if (family.family === 'Date') {\n    return {\n      kind: 'test',\n      expected: 'Date',\n      test: (e) => (e instanceof Date ? (inside(e.getTime()) ? MATCH : NO) : BAD),\n    }\n  }\n  return {\n    kind: 'test',\n    expected: NUMERIC,\n    test: (e) =>\n      typeof e === 'number' || typeof e === 'bigint' ? (inside(e as number) ? MATCH : NO) : BAD,\n  }\n}\n\n/** Compiles one column's filter for this run (cold: once per active filter per run). */\nexport function compile(filter: unknown, values: ColumnValues): Compiled {\n  if (filter === undefined || filter === null) return OFF\n  if (typeof filter !== 'object') return bad('(none)', '{ type, value }', filter)\n  const f = filter as RawFilter\n  switch (f.type) {\n    case 'equals':\n      return equals(f.value)\n    case 'contains':\n      return contains(f.value, values)\n    case 'in':\n      return inList(f.value)\n    case 'range':\n      return range(f.value)\n    case 'custom':\n      return typeof f.fn === 'function'\n        ? {\n            kind: 'custom',\n            fn: f.fn as (v: unknown, fv: unknown, row: unknown) => unknown,\n            value: f.value,\n          }\n        : bad('custom', 'fn: (value, filterValue, row) => boolean', f.fn)\n    default:\n      return {\n        kind: 'bad',\n        filter: typeof f.type === 'string' ? f.type : '(none)',\n        expected: FILTER_KINDS.join(' | '),\n        received: 'unknown filter kind',\n      }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/features/pagination/codes.cjs

@@ -25,15 +25,18 @@ __export(codes_exports, {
 });
 module.exports = __toCommonJS(codes_exports);
 var import_catalog = require("../../diagnostics/catalog.cjs");
+var import_process_guard = require("../../diagnostics/process-guard.cjs");
 var ACCEPTED = {
   pageIndex: "an integer \u2265 0",
   pageSize: "an integer > 0"
 };
 var paginationMessages = {
   DK_INVALID_PAGINATION: {
-    problem: (d) => d.source === "state" ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}` : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,
+    problem: (d) => d.source === "option" ? `pagination({ pageSize: ${d.received} }); pageSize must be ${ACCEPTED.pageSize}` : d.source === "state" ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}` : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,
     impact: (d) => d.fallback,
-    fix: (d) => d.source === "state" ? [
+    fix: (d) => d.source === "option" ? [
+      `pass ${ACCEPTED.pageSize} to pagination({ pageSize }), or leave it out for the default of 10`
+    ] : d.source === "state" ? [
       `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and the controlled options.state)`,
       d.field === "pageIndex" ? "use table.setPageIndex(i): it clamps to the existing pages" : "use table.setPageSize(n): it also keeps the first visible row on screen"
     ] : [
@@ -54,7 +57,7 @@ var paginationDiagnostics = [
     {
       code: "DK_INVALID_PAGINATION",
       level: "warn",
-      where: (d) => d.source === "state" ? { kind: "option", path: `state.pagination.${d.field}` } : { kind: "operation", op: `table.${d.source}` }
+      where: (d) => d.source === "option" ? { kind: "feature", name: "pagination" } : d.source === "state" ? { kind: "option", path: `state.pagination.${d.field}` } : { kind: "operation", op: `table.${d.source}` }
     },
     process.env.NODE_ENV !== "production" && paginationMessages.DK_INVALID_PAGINATION
   ),

package/dist/features/pagination/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/pagination/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_INVALID_PAGINATION: {\n      /** The API method that received the value, or `'state'` for a slice written to the store. */\n      source: 'setPageIndex' | 'setPageSize' | 'state'\n      field: 'pageIndex' | 'pageSize'\n      /** The value's type only (`describeValue`), plus the number itself when it is one. */\n      received: string\n      /** What was done instead. */\n      fallback: string\n    }\n    DK_ROW_COUNT_MISSING: {\n      /** `data.length`, used as the total instead. */\n      rows: number\n    }\n  }\n}\n\nconst ACCEPTED = {\n  pageIndex: 'an integer ≥ 0',\n  pageSize: 'an integer > 0',\n} as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const paginationMessages: DiagnosticMessages<\n  'DK_INVALID_PAGINATION' | 'DK_ROW_COUNT_MISSING'\n> = {\n  DK_INVALID_PAGINATION: {\n    problem: (d) =>\n      d.source === 'state'\n        ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}`\n        : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,\n    impact: (d) => d.fallback,\n    fix: (d) =>\n      d.source === 'state'\n        ? [\n            `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and ` +\n              'the controlled options.state)',\n            d.field === 'pageIndex'\n              ? 'use table.setPageIndex(i): it clamps to the existing pages'\n              : 'use table.setPageSize(n): it also keeps the first visible row on screen',\n          ]\n        : [\n            `pass ${ACCEPTED[d.field]} to ${d.source}()` +\n              (d.received.startsWith('string') ? ' (convert input values with Number(...))' : ''),\n          ],\n  },\n  DK_ROW_COUNT_MISSING: {\n    problem: () =>\n      'pagination is in server mode, but there is no fetcher and no rowCount option: the ' +\n      'total number of rows is unknown',\n    impact: (d) =>\n      `the page count falls back to data.length (${d.rows}) as the total: one page, ` +\n      'canNextPage() is false',\n    fix: () => [\n      'pass the total from your API: setOptions({ data: page.rows, rowCount: page.total })',\n      \"or pass a fetcher that resolves { rows, rowCount }, or use pagination({ mode: 'client' }) \" +\n        'with all rows as data',\n    ],\n  },\n}\n\n/** Codes owned by the `pagination` feature (§6.5). */\nexport const paginationDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_PAGINATION',\n      level: 'warn',\n      where: (d) =>\n        d.source === 'state'\n          ? { kind: 'option', path: `state.pagination.${d.field}` }\n          : { kind: 'operation', op: `table.${d.source}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_INVALID_PAGINATION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_ROW_COUNT_MISSING',\n      level: 'warn',\n      where: () => ({ kind: 'option', path: 'rowCount' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_ROW_COUNT_MISSING,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAoB1D,IAAM,WAAW;AAAA,EACf,WAAW;AAAA,EACX,UAAU;AACZ;AAGO,IAAM,qBAET;AAAA,EACF,uBAAuB;AAAA,IACrB,SAAS,CAAC,MACR,EAAE,WAAW,UACT,4BAA4B,EAAE,KAAK,MAAM,EAAE,QAAQ,gBAAgB,SAAS,EAAE,KAAK,CAAC,KACpF,GAAG,EAAE,MAAM,eAAe,EAAE,QAAQ,KAAK,EAAE,KAAK,YAAY,SAAS,EAAE,KAAK,CAAC;AAAA,IACnF,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MACJ,EAAE,WAAW,UACT;AAAA,MACE,oBAAoB,EAAE,KAAK,OAAO,SAAS,EAAE,KAAK,CAAC;AAAA,MAEnD,EAAE,UAAU,cACR,+DACA;AAAA,IACN,IACA;AAAA,MACE,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,QACrC,EAAE,SAAS,WAAW,QAAQ,IAAI,6CAA6C;AAAA,IACpF;AAAA,EACR;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS,MACP;AAAA,IAEF,QAAQ,CAAC,MACP,6CAA6C,EAAE,IAAI;AAAA,IAErD,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB;AAAA,MACnC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,WAAW,UACT,EAAE,MAAM,UAAU,MAAM,oBAAoB,EAAE,KAAK,GAAG,IACtD,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IACrD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,OAAO,EAAE,MAAM,UAAU,MAAM,WAAW;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AACF;","names":[]}
+{"version":3,"sources":["../../../src/features/pagination/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_INVALID_PAGINATION: {\n      /**\n       * The API method that received the value, `'state'` for a slice written to the store, or\n       * `'option'` for `pagination({ pageSize })` (checked here in production, where the option\n       * validator is off).\n       */\n      source: 'setPageIndex' | 'setPageSize' | 'state' | 'option'\n      field: 'pageIndex' | 'pageSize'\n      /** The value's type only (`describeValue`), plus the number itself when it is one. */\n      received: string\n      /** What was done instead. */\n      fallback: string\n    }\n    DK_ROW_COUNT_MISSING: {\n      /** `data.length`, used as the total instead. */\n      rows: number\n    }\n  }\n}\n\nconst ACCEPTED = {\n  pageIndex: 'an integer ≥ 0',\n  pageSize: 'an integer > 0',\n} as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const paginationMessages: DiagnosticMessages<\n  'DK_INVALID_PAGINATION' | 'DK_ROW_COUNT_MISSING'\n> = {\n  DK_INVALID_PAGINATION: {\n    problem: (d) =>\n      d.source === 'option'\n        ? `pagination({ pageSize: ${d.received} }); pageSize must be ${ACCEPTED.pageSize}`\n        : d.source === 'state'\n          ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}`\n          : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,\n    impact: (d) => d.fallback,\n    fix: (d) =>\n      d.source === 'option'\n        ? [\n            `pass ${ACCEPTED.pageSize} to pagination({ pageSize }), or leave it out for the ` +\n              'default of 10',\n          ]\n        : d.source === 'state'\n          ? [\n              `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and ` +\n                'the controlled options.state)',\n              d.field === 'pageIndex'\n                ? 'use table.setPageIndex(i): it clamps to the existing pages'\n                : 'use table.setPageSize(n): it also keeps the first visible row on screen',\n            ]\n          : [\n              `pass ${ACCEPTED[d.field]} to ${d.source}()` +\n                (d.received.startsWith('string') ? ' (convert input values with Number(...))' : ''),\n            ],\n  },\n  DK_ROW_COUNT_MISSING: {\n    problem: () =>\n      'pagination is in server mode, but there is no fetcher and no rowCount option: the ' +\n      'total number of rows is unknown',\n    impact: (d) =>\n      `the page count falls back to data.length (${d.rows}) as the total: one page, ` +\n      'canNextPage() is false',\n    fix: () => [\n      'pass the total from your API: setOptions({ data: page.rows, rowCount: page.total })',\n      \"or pass a fetcher that resolves { rows, rowCount }, or use pagination({ mode: 'client' }) \" +\n        'with all rows as data',\n    ],\n  },\n}\n\n/** Codes owned by the `pagination` feature (§6.5). */\nexport const paginationDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_PAGINATION',\n      level: 'warn',\n      where: (d) =>\n        d.source === 'option'\n          ? { kind: 'feature', name: 'pagination' }\n          : d.source === 'state'\n            ? { kind: 'option', path: `state.pagination.${d.field}` }\n            : { kind: 'operation', op: `table.${d.source}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_INVALID_PAGINATION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_ROW_COUNT_MISSING',\n      level: 'warn',\n      where: () => ({ kind: 'option', path: 'rowCount' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_ROW_COUNT_MISSING,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAwBP,IAAM,WAAW;AAAA,EACf,WAAW;AAAA,EACX,UAAU;AACZ;AAGO,IAAM,qBAET;AAAA,EACF,uBAAuB;AAAA,IACrB,SAAS,CAAC,MACR,EAAE,WAAW,WACT,0BAA0B,EAAE,QAAQ,yBAAyB,SAAS,QAAQ,KAC9E,EAAE,WAAW,UACX,4BAA4B,EAAE,KAAK,MAAM,EAAE,QAAQ,gBAAgB,SAAS,EAAE,KAAK,CAAC,KACpF,GAAG,EAAE,MAAM,eAAe,EAAE,QAAQ,KAAK,EAAE,KAAK,YAAY,SAAS,EAAE,KAAK,CAAC;AAAA,IACrF,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MACJ,EAAE,WAAW,WACT;AAAA,MACE,QAAQ,SAAS,QAAQ;AAAA,IAE3B,IACA,EAAE,WAAW,UACX;AAAA,MACE,oBAAoB,EAAE,KAAK,OAAO,SAAS,EAAE,KAAK,CAAC;AAAA,MAEnD,EAAE,UAAU,cACR,+DACA;AAAA,IACN,IACA;AAAA,MACE,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,QACrC,EAAE,SAAS,WAAW,QAAQ,IAAI,6CAA6C;AAAA,IACpF;AAAA,EACV;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS,MACP;AAAA,IAEF,QAAQ,CAAC,MACP,6CAA6C,EAAE,IAAI;AAAA,IAErD,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB;AAAA,MACnC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,WAAW,WACT,EAAE,MAAM,WAAW,MAAM,aAAa,IACtC,EAAE,WAAW,UACX,EAAE,MAAM,UAAU,MAAM,oBAAoB,EAAE,KAAK,GAAG,IACtD,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IACvD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,OAAO,EAAE,MAAM,UAAU,MAAM,WAAW;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AACF;","names":[]}

package/dist/features/pagination/codes.js

@@ -1,14 +1,17 @@
 // src/features/pagination/codes.ts
 import { defineDiagnostic } from "../../diagnostics/catalog.js";
+import "../../diagnostics/process-guard.js";
 var ACCEPTED = {
   pageIndex: "an integer \u2265 0",
   pageSize: "an integer > 0"
 };
 var paginationMessages = {
   DK_INVALID_PAGINATION: {
-    problem: (d) => d.source === "state" ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}` : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,
+    problem: (d) => d.source === "option" ? `pagination({ pageSize: ${d.received} }); pageSize must be ${ACCEPTED.pageSize}` : d.source === "state" ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}` : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,
     impact: (d) => d.fallback,
-    fix: (d) => d.source === "state" ? [
+    fix: (d) => d.source === "option" ? [
+      `pass ${ACCEPTED.pageSize} to pagination({ pageSize }), or leave it out for the default of 10`
+    ] : d.source === "state" ? [
       `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and the controlled options.state)`,
       d.field === "pageIndex" ? "use table.setPageIndex(i): it clamps to the existing pages" : "use table.setPageSize(n): it also keeps the first visible row on screen"
     ] : [
@@ -29,7 +32,7 @@ var paginationDiagnostics = [
     {
       code: "DK_INVALID_PAGINATION",
       level: "warn",
-      where: (d) => d.source === "state" ? { kind: "option", path: `state.pagination.${d.field}` } : { kind: "operation", op: `table.${d.source}` }
+      where: (d) => d.source === "option" ? { kind: "feature", name: "pagination" } : d.source === "state" ? { kind: "option", path: `state.pagination.${d.field}` } : { kind: "operation", op: `table.${d.source}` }
     },
     process.env.NODE_ENV !== "production" && paginationMessages.DK_INVALID_PAGINATION
   ),

package/dist/features/pagination/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/pagination/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_INVALID_PAGINATION: {\n      /** The API method that received the value, or `'state'` for a slice written to the store. */\n      source: 'setPageIndex' | 'setPageSize' | 'state'\n      field: 'pageIndex' | 'pageSize'\n      /** The value's type only (`describeValue`), plus the number itself when it is one. */\n      received: string\n      /** What was done instead. */\n      fallback: string\n    }\n    DK_ROW_COUNT_MISSING: {\n      /** `data.length`, used as the total instead. */\n      rows: number\n    }\n  }\n}\n\nconst ACCEPTED = {\n  pageIndex: 'an integer ≥ 0',\n  pageSize: 'an integer > 0',\n} as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const paginationMessages: DiagnosticMessages<\n  'DK_INVALID_PAGINATION' | 'DK_ROW_COUNT_MISSING'\n> = {\n  DK_INVALID_PAGINATION: {\n    problem: (d) =>\n      d.source === 'state'\n        ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}`\n        : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,\n    impact: (d) => d.fallback,\n    fix: (d) =>\n      d.source === 'state'\n        ? [\n            `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and ` +\n              'the controlled options.state)',\n            d.field === 'pageIndex'\n              ? 'use table.setPageIndex(i): it clamps to the existing pages'\n              : 'use table.setPageSize(n): it also keeps the first visible row on screen',\n          ]\n        : [\n            `pass ${ACCEPTED[d.field]} to ${d.source}()` +\n              (d.received.startsWith('string') ? ' (convert input values with Number(...))' : ''),\n          ],\n  },\n  DK_ROW_COUNT_MISSING: {\n    problem: () =>\n      'pagination is in server mode, but there is no fetcher and no rowCount option: the ' +\n      'total number of rows is unknown',\n    impact: (d) =>\n      `the page count falls back to data.length (${d.rows}) as the total: one page, ` +\n      'canNextPage() is false',\n    fix: () => [\n      'pass the total from your API: setOptions({ data: page.rows, rowCount: page.total })',\n      \"or pass a fetcher that resolves { rows, rowCount }, or use pagination({ mode: 'client' }) \" +\n        'with all rows as data',\n    ],\n  },\n}\n\n/** Codes owned by the `pagination` feature (§6.5). */\nexport const paginationDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_PAGINATION',\n      level: 'warn',\n      where: (d) =>\n        d.source === 'state'\n          ? { kind: 'option', path: `state.pagination.${d.field}` }\n          : { kind: 'operation', op: `table.${d.source}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_INVALID_PAGINATION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_ROW_COUNT_MISSING',\n      level: 'warn',\n      where: () => ({ kind: 'option', path: 'rowCount' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_ROW_COUNT_MISSING,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAoB1D,IAAM,WAAW;AAAA,EACf,WAAW;AAAA,EACX,UAAU;AACZ;AAGO,IAAM,qBAET;AAAA,EACF,uBAAuB;AAAA,IACrB,SAAS,CAAC,MACR,EAAE,WAAW,UACT,4BAA4B,EAAE,KAAK,MAAM,EAAE,QAAQ,gBAAgB,SAAS,EAAE,KAAK,CAAC,KACpF,GAAG,EAAE,MAAM,eAAe,EAAE,QAAQ,KAAK,EAAE,KAAK,YAAY,SAAS,EAAE,KAAK,CAAC;AAAA,IACnF,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MACJ,EAAE,WAAW,UACT;AAAA,MACE,oBAAoB,EAAE,KAAK,OAAO,SAAS,EAAE,KAAK,CAAC;AAAA,MAEnD,EAAE,UAAU,cACR,+DACA;AAAA,IACN,IACA;AAAA,MACE,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,QACrC,EAAE,SAAS,WAAW,QAAQ,IAAI,6CAA6C;AAAA,IACpF;AAAA,EACR;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS,MACP;AAAA,IAEF,QAAQ,CAAC,MACP,6CAA6C,EAAE,IAAI;AAAA,IAErD,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB;AAAA,EACnC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,WAAW,UACT,EAAE,MAAM,UAAU,MAAM,oBAAoB,EAAE,KAAK,GAAG,IACtD,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IACrD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,OAAO,EAAE,MAAM,UAAU,MAAM,WAAW;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AACF;","names":[]}
+{"version":3,"sources":["../../../src/features/pagination/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_INVALID_PAGINATION: {\n      /**\n       * The API method that received the value, `'state'` for a slice written to the store, or\n       * `'option'` for `pagination({ pageSize })` (checked here in production, where the option\n       * validator is off).\n       */\n      source: 'setPageIndex' | 'setPageSize' | 'state' | 'option'\n      field: 'pageIndex' | 'pageSize'\n      /** The value's type only (`describeValue`), plus the number itself when it is one. */\n      received: string\n      /** What was done instead. */\n      fallback: string\n    }\n    DK_ROW_COUNT_MISSING: {\n      /** `data.length`, used as the total instead. */\n      rows: number\n    }\n  }\n}\n\nconst ACCEPTED = {\n  pageIndex: 'an integer ≥ 0',\n  pageSize: 'an integer > 0',\n} as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const paginationMessages: DiagnosticMessages<\n  'DK_INVALID_PAGINATION' | 'DK_ROW_COUNT_MISSING'\n> = {\n  DK_INVALID_PAGINATION: {\n    problem: (d) =>\n      d.source === 'option'\n        ? `pagination({ pageSize: ${d.received} }); pageSize must be ${ACCEPTED.pageSize}`\n        : d.source === 'state'\n          ? `the pagination state has ${d.field} = ${d.received}; it must be ${ACCEPTED[d.field]}`\n          : `${d.source}() received ${d.received}; ${d.field} must be ${ACCEPTED[d.field]}`,\n    impact: (d) => d.fallback,\n    fix: (d) =>\n      d.source === 'option'\n        ? [\n            `pass ${ACCEPTED.pageSize} to pagination({ pageSize }), or leave it out for the ` +\n              'default of 10',\n          ]\n        : d.source === 'state'\n          ? [\n              `write pagination.${d.field} as ${ACCEPTED[d.field]} (check initialState, setState and ` +\n                'the controlled options.state)',\n              d.field === 'pageIndex'\n                ? 'use table.setPageIndex(i): it clamps to the existing pages'\n                : 'use table.setPageSize(n): it also keeps the first visible row on screen',\n            ]\n          : [\n              `pass ${ACCEPTED[d.field]} to ${d.source}()` +\n                (d.received.startsWith('string') ? ' (convert input values with Number(...))' : ''),\n            ],\n  },\n  DK_ROW_COUNT_MISSING: {\n    problem: () =>\n      'pagination is in server mode, but there is no fetcher and no rowCount option: the ' +\n      'total number of rows is unknown',\n    impact: (d) =>\n      `the page count falls back to data.length (${d.rows}) as the total: one page, ` +\n      'canNextPage() is false',\n    fix: () => [\n      'pass the total from your API: setOptions({ data: page.rows, rowCount: page.total })',\n      \"or pass a fetcher that resolves { rows, rowCount }, or use pagination({ mode: 'client' }) \" +\n        'with all rows as data',\n    ],\n  },\n}\n\n/** Codes owned by the `pagination` feature (§6.5). */\nexport const paginationDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_PAGINATION',\n      level: 'warn',\n      where: (d) =>\n        d.source === 'option'\n          ? { kind: 'feature', name: 'pagination' }\n          : d.source === 'state'\n            ? { kind: 'option', path: `state.pagination.${d.field}` }\n            : { kind: 'operation', op: `table.${d.source}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_INVALID_PAGINATION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_ROW_COUNT_MISSING',\n      level: 'warn',\n      where: () => ({ kind: 'option', path: 'rowCount' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && paginationMessages.DK_ROW_COUNT_MISSING,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAwBP,IAAM,WAAW;AAAA,EACf,WAAW;AAAA,EACX,UAAU;AACZ;AAGO,IAAM,qBAET;AAAA,EACF,uBAAuB;AAAA,IACrB,SAAS,CAAC,MACR,EAAE,WAAW,WACT,0BAA0B,EAAE,QAAQ,yBAAyB,SAAS,QAAQ,KAC9E,EAAE,WAAW,UACX,4BAA4B,EAAE,KAAK,MAAM,EAAE,QAAQ,gBAAgB,SAAS,EAAE,KAAK,CAAC,KACpF,GAAG,EAAE,MAAM,eAAe,EAAE,QAAQ,KAAK,EAAE,KAAK,YAAY,SAAS,EAAE,KAAK,CAAC;AAAA,IACrF,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MACJ,EAAE,WAAW,WACT;AAAA,MACE,QAAQ,SAAS,QAAQ;AAAA,IAE3B,IACA,EAAE,WAAW,UACX;AAAA,MACE,oBAAoB,EAAE,KAAK,OAAO,SAAS,EAAE,KAAK,CAAC;AAAA,MAEnD,EAAE,UAAU,cACR,+DACA;AAAA,IACN,IACA;AAAA,MACE,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,QACrC,EAAE,SAAS,WAAW,QAAQ,IAAI,6CAA6C;AAAA,IACpF;AAAA,EACV;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS,MACP;AAAA,IAEF,QAAQ,CAAC,MACP,6CAA6C,EAAE,IAAI;AAAA,IAErD,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB;AAAA,EACnC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,WAAW,WACT,EAAE,MAAM,WAAW,MAAM,aAAa,IACtC,EAAE,WAAW,UACX,EAAE,MAAM,UAAU,MAAM,oBAAoB,EAAE,KAAK,GAAG,IACtD,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IACvD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,OAAO,EAAE,MAAM,UAAU,MAAM,WAAW;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AACF;","names":[]}

package/dist/features/pagination/pagination.cjs

@@ -25,6 +25,7 @@ __export(pagination_exports, {
 module.exports = __toCommonJS(pagination_exports);
 var import_options = require("../../catalog/options.cjs");
 var import_catalog = require("../../diagnostics/catalog.cjs");
+var import_process_guard = require("../../diagnostics/process-guard.cjs");
 var import_redact = require("../../diagnostics/redact.cjs");
 var import_define = require("../../feature/define.cjs");
 var import_define2 = require("../../intercept/define.cjs");
@@ -54,7 +55,8 @@ function effectiveIndex(pageIndex, pageSize, rowCount) {
   return pageIndex > last ? last : pageIndex;
 }
 var pagination = (opts = {}) => {
-  const initialSize = opts.pageSize ?? DEFAULT_PAGE_SIZE;
+  const badSize = opts.pageSize !== void 0 && !isSize(opts.pageSize);
+  const initialSize = badSize ? DEFAULT_PAGE_SIZE : opts.pageSize ?? DEFAULT_PAGE_SIZE;
   const autoReset = opts.autoResetPageIndex !== false;
   const mode = opts.mode ?? "client";
   const hosts = /* @__PURE__ */ new WeakMap();
@@ -89,8 +91,8 @@ var pagination = (opts = {}) => {
       let missingReported = false;
       const rowCount = () => {
         if (mode !== "server") return table.getRowModel().filteredCount;
-        const n = internals.rowCount();
-        if (n !== void 0 || internals.hasFetcher()) return n;
+        const n2 = internals.rowCount();
+        if (n2 !== void 0 || internals.hasFetcher()) return n2;
         const rows = table.getRowModel().totalCount;
         if (!missingReported) {
           missingReported = true;
@@ -101,17 +103,17 @@ var pagination = (opts = {}) => {
       function sanitize(s, prev) {
         const fallbackSize = isSize(prev?.pageSize) ? prev.pageSize : initialSize;
         if (s === null || typeof s !== "object") {
-          report("state", "pageIndex", s, "the pagination state was reset to its initial value");
+          report("state", "pageIndex", s, "page-reset");
           return { pageIndex: 0, pageSize: initialSize };
         }
         const { pageIndex, pageSize } = s;
         let fixed2;
         if (!isIndex(pageIndex)) {
-          report("state", "pageIndex", pageIndex, "pageIndex was replaced by 0");
+          report("state", "pageIndex", pageIndex, "page-index-0");
           fixed2 = { ...s, pageIndex: 0 };
         }
         if (!isSize(pageSize)) {
-          report("state", "pageSize", pageSize, `pageSize was replaced by ${fallbackSize}`);
+          report("state", "pageSize", pageSize, `page-size|${fallbackSize}`);
           fixed2 = { ...fixed2 ?? s, pageSize: fallbackSize };
         }
         return fixed2;
@@ -119,9 +121,8 @@ var pagination = (opts = {}) => {
       function report(source, field, value, fallback) {
         ctx.emit("DK_INVALID_PAGINATION", { source, field, received: received(value), fallback });
       }
-      function current() {
+      function current(count = rowCount()) {
         const s = ctx.getState();
-        const count = rowCount();
         const index = count === void 0 ? s.pageIndex : effectiveIndex(s.pageIndex, s.pageSize, count);
         return { s, count, index };
       }
@@ -148,23 +149,27 @@ var pagination = (opts = {}) => {
           }
         }
       });
+      if (badSize) report("option", "pageSize", opts.pageSize, `pageSize ${initialSize} was used`);
       const fixed = sanitize(ctx.getState(), void 0);
       if (fixed) ctx.setState(fixed);
-      table.subscribe(() => {
-        const { s, index } = current();
-        if (index !== s.pageIndex) ctx.setState({ ...s, pageIndex: index });
-      });
+      const clamp = (count) => {
+        const { s, index } = current(count);
+        if (index < s.pageIndex) ctx.setState({ ...s, pageIndex: index });
+      };
+      const n = mode === "server" ? internals.rowCount() : table.getOptions().data?.length;
+      if (n) clamp(n);
+      table.subscribe(() => clamp());
       return {
         setPageIndex(index) {
           if (!Number.isInteger(index)) {
-            report("setPageIndex", "pageIndex", index, "the call was ignored");
+            report("setPageIndex", "pageIndex", index, "call-ignored");
             return;
           }
           goTo(index);
         },
         setPageSize(size) {
           if (!isSize(size)) {
-            report("setPageSize", "pageSize", size, "the call was ignored");
+            report("setPageSize", "pageSize", size, "call-ignored");
             return;
           }
           const { s, index } = current();