@datakable/core 1.0.0 → 1.1.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/pagination/pagination.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport { describeValue } from '../../diagnostics/redact'\nimport { defineFeature } from '../../feature/define'\nimport type { FeatureContext } from '../../feature/types'\nimport { defineInterceptor } from '../../intercept/define'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { getTableInternals } from '../../table/internals'\nimport type { Table, TableState } from '../../table/types'\nimport { paginationDiagnostics } from './codes'\n\nkeepDiagnostics(paginationDiagnostics)\n\nexport interface PaginationState {\n  pageIndex: number\n  pageSize: number\n}\n\nexport interface PaginationApi {\n  /** Goes to page `index`, clamped to `[0, getPageCount() - 1]`. */\n  setPageIndex(index: number): void\n  /** Changes the page size and keeps the first visible row on screen (`floor(firstRow / size)`). */\n  setPageSize(size: number): void\n  /** Next page; no-op on the last page. */\n  nextPage(): void\n  /** Previous page; no-op on the first page. */\n  prevPage(): void\n  /** `ceil(rowCount / pageSize)`; `0` when there are no rows. */\n  getPageCount(): number\n  canNextPage(): boolean\n  canPrevPage(): boolean\n}\n\nexport interface PaginationOptions {\n  /** Starting page size (default 10). `options.initialState.pagination` takes precedence. */\n  pageSize?: number\n  /** Go back to page 0 when search, filters or sort change (default `true`). */\n  autoResetPageIndex?: boolean\n  /**\n   * `'server'`: the server pages (its state goes to `options.fetcher`, or the app passes the\n   * current page as `data`); the page count is `ceil(rowCount / pageSize)` with `rowCount` from the\n   * fetcher result or the `rowCount` option (§6.5, §7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst DEFAULT_PAGE_SIZE = 10\nconst NAME = 'pagination'\n\nconst isIndex = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 0\nconst isSize = (v: unknown): v is number => Number.isInteger(v) && (v as number) > 0\nconst received = (v: unknown) => (typeof v === 'number' ? String(v) : describeValue(v))\n\nconst paginationOptions = {\n  pageSize: { type: 'number', check: isSize, expected: 'an integer > 0' },\n  autoResetPageIndex: { type: 'boolean' },\n  mode: modeOption,\n} as const\n\n/** Stages whose state changes send the table back to page 0 (`autoResetPageIndex`). */\nconst RESET_STAGES = new Set(['filter', 'search', 'sort'])\n\n/**\n * A slice change that resets the page. For a search slice only the applied `query` counts: typing\n * (`input`) and `status` alone keep the page (a debounced keystroke must not jump to page 0).\n */\nfunction changed(stage: string, a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return false\n  if (stage === 'search' && hasQuery(a) && hasQuery(b)) return !Object.is(a.query, b.query)\n  return true\n}\n\nconst hasQuery = (v: unknown): v is { query: unknown } =>\n  v !== null && typeof v === 'object' && 'query' in v\n\n/** The page actually shown: `pageIndex` clamped to the last page (0 for no rows). */\nfunction effectiveIndex(pageIndex: number, pageSize: number, rowCount: number): number {\n  const last = rowCount === 0 ? 0 : Math.ceil(rowCount / pageSize) - 1\n  return pageIndex > last ? last : pageIndex\n}\n\n/** What the pagination interceptor needs of one table (registered by `createApi`). */\ninterface Host {\n  /** Runs after `state:dispatch` / `table:setOptions` committed: validation, then auto-reset. */\n  after(before: TableState): void\n}\n\n/**\n * Client-side pagination (§6.5). State `{ pageIndex, pageSize }`; the `paginate` step returns the\n * rows of the current page (`RowModel.filteredCount` stays the count before paging).\n *\n * - `setPageSize` keeps the first visible row on screen; `setPageIndex` clamps.\n * - `autoResetPageIndex` (default `true`): a change of a filter / search / sort slice resets\n *   `pageIndex` to 0 in the same update (one notification). An update that also sets the\n *   pagination slice keeps the page it sets.\n * - `pageIndex` is clamped when the row count shrinks (data change, filters with auto-reset off).\n * - Invalid values are never silent: API arguments are ignored and slices written to the store are\n *   replaced, both with `DK_INVALID_PAGINATION`.\n */\nexport const pagination = (opts: PaginationOptions = {}) => {\n  const initialSize = opts.pageSize ?? DEFAULT_PAGE_SIZE\n  const autoReset = opts.autoResetPageIndex !== false\n  const mode = opts.mode ?? 'client'\n  // One feature instance may serve several tables: per-table state lives here.\n  const hosts = new WeakMap<object, Host>()\n\n  const interceptor = defineInterceptor({\n    name: NAME,\n    on: ['state:dispatch', 'table:setOptions'],\n    intercept(ctx, next) {\n      const host = hosts.get(ctx.table as object)\n      if (!host) return next()\n      const before = (ctx.table as Table<unknown, TableState>).getState()\n      const out = next()\n      host.after(before)\n      return out\n    },\n  })\n\n  return defineFeature({\n    name: NAME,\n    stage: 'paginate',\n    mode,\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? paginationOptions : ({} as typeof paginationOptions),\n      opts,\n    ),\n    interceptors: [interceptor],\n    initialState: (): PaginationState => ({ pageIndex: 0, pageSize: initialSize }),\n    // After destroy(): the getters still return their declared types (no pages, no navigation).\n    destroyedResult: { getPageCount: () => 0, canNextPage: () => false, canPrevPage: () => false },\n    createApi: (ctx: FeatureContext<PaginationState>): PaginationApi => {\n      const table = ctx.table\n\n      const internals = getTableInternals(table)\n      let missingReported = false\n      /**\n       * Rows to page over. Server mode (§6.5, §7.1): the fetcher result's `rowCount`\n       * (`undefined` until the first one applied), else the `rowCount` option, else\n       * `DK_ROW_COUNT_MISSING` and `data.length` as the total.\n       */\n      const rowCount = (): number | undefined => {\n        if (mode !== 'server') return table.getRowModel().filteredCount\n        const n = internals.rowCount()\n        if (n !== undefined || internals.hasFetcher()) return n\n        const rows = table.getRowModel().totalCount\n        if (!missingReported) {\n          missingReported = true\n          ctx.emit('DK_ROW_COUNT_MISSING', { rows })\n        }\n        return rows\n      }\n\n      /** The slice with invalid fields replaced (`prev` = the last valid slice, if any). */\n      function sanitize(s: unknown, prev: unknown): PaginationState | undefined {\n        const fallbackSize = isSize((prev as PaginationState | undefined)?.pageSize)\n          ? (prev as PaginationState).pageSize\n          : initialSize\n        if (s === null || typeof s !== 'object') {\n          report('state', 'pageIndex', s, 'the pagination state was reset to its initial value')\n          return { pageIndex: 0, pageSize: initialSize }\n        }\n        const { pageIndex, pageSize } = s as Partial<PaginationState>\n        let fixed: PaginationState | undefined\n        if (!isIndex(pageIndex)) {\n          report('state', 'pageIndex', pageIndex, 'pageIndex was replaced by 0')\n          fixed = { ...(s as PaginationState), pageIndex: 0 }\n        }\n        if (!isSize(pageSize)) {\n          report('state', 'pageSize', pageSize, `pageSize was replaced by ${fallbackSize}`)\n          fixed = { ...(fixed ?? (s as PaginationState)), pageSize: fallbackSize }\n        }\n        return fixed\n      }\n\n      function report(\n        source: 'setPageIndex' | 'setPageSize' | 'state',\n        field: 'pageIndex' | 'pageSize',\n        value: unknown,\n        fallback: string,\n      ) {\n        ctx.emit('DK_INVALID_PAGINATION', { source, field, received: received(value), fallback })\n      }\n\n      /**\n       * The current slice and the page actually shown. An unknown count (a server count not\n       * fetched yet) clamps nothing.\n       */\n      function current() {\n        const s = ctx.getState()\n        const count = rowCount()\n        const index =\n          count === undefined ? s.pageIndex : effectiveIndex(s.pageIndex, s.pageSize, count)\n        return { s, count, index }\n      }\n\n      function goTo(index: number) {\n        const { s, count } = current()\n        const target =\n          index < 0 ? 0 : count === undefined ? index : effectiveIndex(index, s.pageSize, count)\n        if (target !== s.pageIndex) ctx.setState({ ...s, pageIndex: target })\n      }\n\n      hosts.set(table, {\n        after(before) {\n          const now = table.getState()\n          const slice = now[NAME]\n          if (!Object.is(before[NAME], slice)) {\n            const fixed = sanitize(slice, before[NAME])\n            if (fixed) ctx.setState(fixed)\n            return // an update that sets the pagination slice keeps its page\n          }\n          if (!autoReset || (slice as PaginationState).pageIndex === 0) return\n          for (const f of getTableInternals(table).features) {\n            if (RESET_STAGES.has(f.stage) && changed(f.stage, before[f.name], now[f.name])) {\n              ctx.setState({ ...(slice as PaginationState), pageIndex: 0 })\n              return\n            }\n          }\n        },\n      })\n\n      // A slice given at creation (initialState / controlled state) is checked once, here.\n      const fixed = sanitize(ctx.getState(), undefined)\n      if (fixed) ctx.setState(fixed)\n\n      // Clamp when the row count shrinks. A listener sees every change (data, async ingest,\n      // filters with auto-reset off); its update is notified in the next round.\n      table.subscribe(() => {\n        const { s, index } = current()\n        if (index !== s.pageIndex) ctx.setState({ ...s, pageIndex: index })\n      })\n\n      return {\n        setPageIndex(index) {\n          if (!Number.isInteger(index)) {\n            report('setPageIndex', 'pageIndex', index, 'the call was ignored')\n            return\n          }\n          goTo(index)\n        },\n        setPageSize(size) {\n          if (!isSize(size)) {\n            report('setPageSize', 'pageSize', size, 'the call was ignored')\n            return\n          }\n          const { s, index } = current()\n          if (size === s.pageSize) return\n          const firstRow = index * s.pageSize\n          ctx.setState({ pageIndex: Math.floor(firstRow / size), pageSize: size })\n        },\n        nextPage() {\n          goTo(current().index + 1)\n        },\n        prevPage() {\n          goTo(current().index - 1)\n        },\n        getPageCount() {\n          const count = rowCount()\n          return !count ? 0 : Math.ceil(count / ctx.getState().pageSize)\n        },\n        canNextPage() {\n          const { s, count, index } = current()\n          return count !== undefined && (index + 1) * s.pageSize < count\n        },\n        canPrevPage() {\n          return current().index > 0\n        },\n      }\n    },\n    rowModel: (indices, s) => {\n      const size = isSize(s?.pageSize) ? s.pageSize : initialSize\n      const index = effectiveIndex(isIndex(s?.pageIndex) ? s.pageIndex : 0, size, indices.length)\n      const start = index * size\n      if (start === 0 && size >= indices.length) return indices\n      return indices.subarray(start, start + size)\n    },\n  })\n}\n"],"mappings":"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","names":["import_define","fixed"]}
+{"version":3,"sources":["../../../src/features/pagination/pagination.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\nimport { describeValue } from '../../diagnostics/redact'\nimport { defineFeature } from '../../feature/define'\nimport type { FeatureContext } from '../../feature/types'\nimport { defineInterceptor } from '../../intercept/define'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { getTableInternals } from '../../table/internals'\nimport type { Table, TableState } from '../../table/types'\nimport { paginationDiagnostics } from './codes'\n\nkeepDiagnostics(paginationDiagnostics)\n\nexport interface PaginationState {\n  pageIndex: number\n  pageSize: number\n}\n\nexport interface PaginationApi {\n  /** Goes to page `index`, clamped to `[0, getPageCount() - 1]`. */\n  setPageIndex(index: number): void\n  /** Changes the page size and keeps the first visible row on screen (`floor(firstRow / size)`). */\n  setPageSize(size: number): void\n  /** Next page; no-op on the last page. */\n  nextPage(): void\n  /** Previous page; no-op on the first page. */\n  prevPage(): void\n  /** `ceil(rowCount / pageSize)`; `0` when there are no rows. */\n  getPageCount(): number\n  canNextPage(): boolean\n  canPrevPage(): boolean\n}\n\nexport interface PaginationOptions {\n  /** Starting page size (default 10). `options.initialState.pagination` takes precedence. */\n  pageSize?: number\n  /** Go back to page 0 when search, filters or sort change (default `true`). */\n  autoResetPageIndex?: boolean\n  /**\n   * `'server'`: the server pages (its state goes to `options.fetcher`, or the app passes the\n   * current page as `data`); the page count is `ceil(rowCount / pageSize)` with `rowCount` from the\n   * fetcher result or the `rowCount` option (§6.5, §7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst DEFAULT_PAGE_SIZE = 10\nconst NAME = 'pagination'\n\nconst isIndex = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 0\nconst isSize = (v: unknown): v is number => Number.isInteger(v) && (v as number) > 0\nconst received = (v: unknown) => (typeof v === 'number' ? String(v) : describeValue(v))\n\nconst paginationOptions = {\n  pageSize: { type: 'number', check: isSize, expected: 'an integer > 0' },\n  autoResetPageIndex: { type: 'boolean' },\n  mode: modeOption,\n} as const\n\n/** Stages whose state changes send the table back to page 0 (`autoResetPageIndex`). */\nconst RESET_STAGES = new Set(['filter', 'search', 'sort'])\n\n/**\n * A slice change that resets the page. For a search slice only the applied `query` counts: typing\n * (`input`) and `status` alone keep the page (a debounced keystroke must not jump to page 0).\n */\nfunction changed(stage: string, a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return false\n  if (stage === 'search' && hasQuery(a) && hasQuery(b)) return !Object.is(a.query, b.query)\n  return true\n}\n\nconst hasQuery = (v: unknown): v is { query: unknown } =>\n  v !== null && typeof v === 'object' && 'query' in v\n\n/** The page actually shown: `pageIndex` clamped to the last page (0 for no rows). */\nfunction effectiveIndex(pageIndex: number, pageSize: number, rowCount: number): number {\n  const last = rowCount === 0 ? 0 : Math.ceil(rowCount / pageSize) - 1\n  return pageIndex > last ? last : pageIndex\n}\n\n/** What the pagination interceptor needs of one table (registered by `createApi`). */\ninterface Host {\n  /** Runs after `state:dispatch` / `table:setOptions` committed: validation, then auto-reset. */\n  after(before: TableState): void\n}\n\n/**\n * Client-side pagination (§6.5). State `{ pageIndex, pageSize }`; the `paginate` step returns the\n * rows of the current page (`RowModel.filteredCount` stays the count before paging).\n *\n * - `setPageSize` keeps the first visible row on screen; `setPageIndex` clamps.\n * - `autoResetPageIndex` (default `true`): a change of a filter / search / sort slice resets\n *   `pageIndex` to 0 in the same update (one notification). An update that also sets the\n *   pagination slice keeps the page it sets.\n * - `pageIndex` is clamped when the row count shrinks (data change, filters with auto-reset off).\n * - Invalid values are never silent: API arguments are ignored and slices written to the store are\n *   replaced, both with `DK_INVALID_PAGINATION`.\n */\nexport const pagination = (opts: PaginationOptions = {}) => {\n  // Production skips the option validator: an invalid size must not reach the state, or sanitize()\n  // would \"fix\" a slice with the same bad size and re-dispatch forever (#13). Reported in createApi.\n  const badSize = opts.pageSize !== undefined && !isSize(opts.pageSize)\n  const initialSize = badSize ? DEFAULT_PAGE_SIZE : (opts.pageSize ?? DEFAULT_PAGE_SIZE)\n  const autoReset = opts.autoResetPageIndex !== false\n  const mode = opts.mode ?? 'client'\n  // One feature instance may serve several tables: per-table state lives here.\n  const hosts = new WeakMap<object, Host>()\n\n  const interceptor = defineInterceptor({\n    name: NAME,\n    on: ['state:dispatch', 'table:setOptions'],\n    intercept(ctx, next) {\n      const host = hosts.get(ctx.table as object)\n      if (!host) return next()\n      const before = (ctx.table as Table<unknown, TableState>).getState()\n      const out = next()\n      host.after(before)\n      return out\n    },\n  })\n\n  return defineFeature({\n    name: NAME,\n    stage: 'paginate',\n    mode,\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? paginationOptions : ({} as typeof paginationOptions),\n      opts,\n    ),\n    interceptors: [interceptor],\n    initialState: (): PaginationState => ({ pageIndex: 0, pageSize: initialSize }),\n    // After destroy(): the getters still return their declared types (no pages, no navigation).\n    destroyedResult: { getPageCount: () => 0, canNextPage: () => false, canPrevPage: () => false },\n    createApi: (ctx: FeatureContext<PaginationState>): PaginationApi => {\n      const table = ctx.table\n\n      const internals = getTableInternals(table)\n      let missingReported = false\n      /**\n       * Rows to page over. Server mode (§6.5, §7.1): the fetcher result's `rowCount`\n       * (`undefined` until the first one applied), else the `rowCount` option, else\n       * `DK_ROW_COUNT_MISSING` and `data.length` as the total.\n       */\n      const rowCount = (): number | undefined => {\n        if (mode !== 'server') return table.getRowModel().filteredCount\n        const n = internals.rowCount()\n        if (n !== undefined || internals.hasFetcher()) return n\n        const rows = table.getRowModel().totalCount\n        if (!missingReported) {\n          missingReported = true\n          ctx.emit('DK_ROW_COUNT_MISSING', { rows })\n        }\n        return rows\n      }\n\n      /** The slice with invalid fields replaced (`prev` = the last valid slice, if any). */\n      function sanitize(s: unknown, prev: unknown): PaginationState | undefined {\n        const fallbackSize = isSize((prev as PaginationState | undefined)?.pageSize)\n          ? (prev as PaginationState).pageSize\n          : initialSize\n        if (s === null || typeof s !== 'object') {\n          report('state', 'pageIndex', s, 'page-reset')\n          return { pageIndex: 0, pageSize: initialSize }\n        }\n        const { pageIndex, pageSize } = s as Partial<PaginationState>\n        let fixed: PaginationState | undefined\n        if (!isIndex(pageIndex)) {\n          report('state', 'pageIndex', pageIndex, 'page-index-0')\n          fixed = { ...(s as PaginationState), pageIndex: 0 }\n        }\n        if (!isSize(pageSize)) {\n          report('state', 'pageSize', pageSize, `page-size|${fallbackSize}`)\n          fixed = { ...(fixed ?? (s as PaginationState)), pageSize: fallbackSize }\n        }\n        return fixed\n      }\n\n      function report(\n        source: 'setPageIndex' | 'setPageSize' | 'state' | 'option',\n        field: 'pageIndex' | 'pageSize',\n        value: unknown,\n        fallback: string,\n      ) {\n        ctx.emit('DK_INVALID_PAGINATION', { source, field, received: received(value), fallback })\n      }\n\n      /**\n       * The current slice and the page actually shown (for `count` rows, default: the current\n       * count). An unknown count (a server count not fetched yet) clamps nothing.\n       */\n      function current(count = rowCount()) {\n        const s = ctx.getState()\n        const index =\n          count === undefined ? s.pageIndex : effectiveIndex(s.pageIndex, s.pageSize, count)\n        return { s, count, index }\n      }\n\n      function goTo(index: number) {\n        const { s, count } = current()\n        const target =\n          index < 0 ? 0 : count === undefined ? index : effectiveIndex(index, s.pageSize, count)\n        if (target !== s.pageIndex) ctx.setState({ ...s, pageIndex: target })\n      }\n\n      hosts.set(table, {\n        after(before) {\n          const now = table.getState()\n          const slice = now[NAME]\n          if (!Object.is(before[NAME], slice)) {\n            const fixed = sanitize(slice, before[NAME])\n            if (fixed) ctx.setState(fixed)\n            return // an update that sets the pagination slice keeps its page\n          }\n          if (!autoReset || (slice as PaginationState).pageIndex === 0) return\n          for (const f of getTableInternals(table).features) {\n            if (RESET_STAGES.has(f.stage) && changed(f.stage, before[f.name], now[f.name])) {\n              ctx.setState({ ...(slice as PaginationState), pageIndex: 0 })\n              return\n            }\n          }\n        },\n      })\n\n      if (badSize) report('option', 'pageSize', opts.pageSize, `pageSize ${initialSize} was used`)\n      // A slice given at creation (initialState / controlled state) is checked once, here.\n      const fixed = sanitize(ctx.getState(), undefined)\n      if (fixed) ctx.setState(fixed)\n      // ... and clamped to the last page, so the state never says \"page 100 of 3\" (#19). Client:\n      // the paged rows are a subset of `data`, whose length bounds the last page without running\n      // the pipeline here (restored filters leaving fewer rows: the listener below); no data yet\n      // clamps nothing. Server: a known `rowCount`.\n      const clamp = (count?: number) => {\n        const { s, index } = current(count)\n        if (index < s.pageIndex) ctx.setState({ ...s, pageIndex: index })\n      }\n      const n =\n        mode === 'server' ? internals.rowCount() : (table.getOptions().data as unknown[])?.length\n      if (n) clamp(n)\n\n      // Clamp when the row count shrinks. A listener sees every change (data, async ingest,\n      // filters with auto-reset off); its update is notified in the next round.\n      table.subscribe(() => clamp())\n\n      return {\n        setPageIndex(index) {\n          if (!Number.isInteger(index)) {\n            report('setPageIndex', 'pageIndex', index, 'call-ignored')\n            return\n          }\n          goTo(index)\n        },\n        setPageSize(size) {\n          if (!isSize(size)) {\n            report('setPageSize', 'pageSize', size, 'call-ignored')\n            return\n          }\n          const { s, index } = current()\n          if (size === s.pageSize) return\n          const firstRow = index * s.pageSize\n          ctx.setState({ pageIndex: Math.floor(firstRow / size), pageSize: size })\n        },\n        nextPage() {\n          goTo(current().index + 1)\n        },\n        prevPage() {\n          goTo(current().index - 1)\n        },\n        getPageCount() {\n          const count = rowCount()\n          return !count ? 0 : Math.ceil(count / ctx.getState().pageSize)\n        },\n        canNextPage() {\n          const { s, count, index } = current()\n          return count !== undefined && (index + 1) * s.pageSize < count\n        },\n        canPrevPage() {\n          return current().index > 0\n        },\n      }\n    },\n    rowModel: (indices, s) => {\n      const size = isSize(s?.pageSize) ? s.pageSize : initialSize\n      const index = effectiveIndex(isIndex(s?.pageIndex) ? s.pageIndex : 0, size, indices.length)\n      const start = index * size\n      if (start === 0 && size >= indices.length) return indices\n      return indices.subarray(start, start + size)\n    },\n  })\n}\n"],"mappings":"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","names":["import_define","n","fixed"]}

package/dist/features/pagination/pagination.js

@@ -1,6 +1,7 @@
 // src/features/pagination/pagination.ts
 import { defineOptions } from "../../catalog/options.js";
 import { keepDiagnostics } from "../../diagnostics/catalog.js";
+import "../../diagnostics/process-guard.js";
 import { describeValue } from "../../diagnostics/redact.js";
 import { defineFeature } from "../../feature/define.js";
 import { defineInterceptor } from "../../intercept/define.js";
@@ -30,7 +31,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();
@@ -65,8 +67,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;
@@ -77,17 +79,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;
@@ -95,9 +97,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 };
       }
@@ -124,23 +125,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();

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/pagination/pagination.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport { describeValue } from '../../diagnostics/redact'\nimport { defineFeature } from '../../feature/define'\nimport type { FeatureContext } from '../../feature/types'\nimport { defineInterceptor } from '../../intercept/define'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { getTableInternals } from '../../table/internals'\nimport type { Table, TableState } from '../../table/types'\nimport { paginationDiagnostics } from './codes'\n\nkeepDiagnostics(paginationDiagnostics)\n\nexport interface PaginationState {\n  pageIndex: number\n  pageSize: number\n}\n\nexport interface PaginationApi {\n  /** Goes to page `index`, clamped to `[0, getPageCount() - 1]`. */\n  setPageIndex(index: number): void\n  /** Changes the page size and keeps the first visible row on screen (`floor(firstRow / size)`). */\n  setPageSize(size: number): void\n  /** Next page; no-op on the last page. */\n  nextPage(): void\n  /** Previous page; no-op on the first page. */\n  prevPage(): void\n  /** `ceil(rowCount / pageSize)`; `0` when there are no rows. */\n  getPageCount(): number\n  canNextPage(): boolean\n  canPrevPage(): boolean\n}\n\nexport interface PaginationOptions {\n  /** Starting page size (default 10). `options.initialState.pagination` takes precedence. */\n  pageSize?: number\n  /** Go back to page 0 when search, filters or sort change (default `true`). */\n  autoResetPageIndex?: boolean\n  /**\n   * `'server'`: the server pages (its state goes to `options.fetcher`, or the app passes the\n   * current page as `data`); the page count is `ceil(rowCount / pageSize)` with `rowCount` from the\n   * fetcher result or the `rowCount` option (§6.5, §7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst DEFAULT_PAGE_SIZE = 10\nconst NAME = 'pagination'\n\nconst isIndex = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 0\nconst isSize = (v: unknown): v is number => Number.isInteger(v) && (v as number) > 0\nconst received = (v: unknown) => (typeof v === 'number' ? String(v) : describeValue(v))\n\nconst paginationOptions = {\n  pageSize: { type: 'number', check: isSize, expected: 'an integer > 0' },\n  autoResetPageIndex: { type: 'boolean' },\n  mode: modeOption,\n} as const\n\n/** Stages whose state changes send the table back to page 0 (`autoResetPageIndex`). */\nconst RESET_STAGES = new Set(['filter', 'search', 'sort'])\n\n/**\n * A slice change that resets the page. For a search slice only the applied `query` counts: typing\n * (`input`) and `status` alone keep the page (a debounced keystroke must not jump to page 0).\n */\nfunction changed(stage: string, a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return false\n  if (stage === 'search' && hasQuery(a) && hasQuery(b)) return !Object.is(a.query, b.query)\n  return true\n}\n\nconst hasQuery = (v: unknown): v is { query: unknown } =>\n  v !== null && typeof v === 'object' && 'query' in v\n\n/** The page actually shown: `pageIndex` clamped to the last page (0 for no rows). */\nfunction effectiveIndex(pageIndex: number, pageSize: number, rowCount: number): number {\n  const last = rowCount === 0 ? 0 : Math.ceil(rowCount / pageSize) - 1\n  return pageIndex > last ? last : pageIndex\n}\n\n/** What the pagination interceptor needs of one table (registered by `createApi`). */\ninterface Host {\n  /** Runs after `state:dispatch` / `table:setOptions` committed: validation, then auto-reset. */\n  after(before: TableState): void\n}\n\n/**\n * Client-side pagination (§6.5). State `{ pageIndex, pageSize }`; the `paginate` step returns the\n * rows of the current page (`RowModel.filteredCount` stays the count before paging).\n *\n * - `setPageSize` keeps the first visible row on screen; `setPageIndex` clamps.\n * - `autoResetPageIndex` (default `true`): a change of a filter / search / sort slice resets\n *   `pageIndex` to 0 in the same update (one notification). An update that also sets the\n *   pagination slice keeps the page it sets.\n * - `pageIndex` is clamped when the row count shrinks (data change, filters with auto-reset off).\n * - Invalid values are never silent: API arguments are ignored and slices written to the store are\n *   replaced, both with `DK_INVALID_PAGINATION`.\n */\nexport const pagination = (opts: PaginationOptions = {}) => {\n  const initialSize = opts.pageSize ?? DEFAULT_PAGE_SIZE\n  const autoReset = opts.autoResetPageIndex !== false\n  const mode = opts.mode ?? 'client'\n  // One feature instance may serve several tables: per-table state lives here.\n  const hosts = new WeakMap<object, Host>()\n\n  const interceptor = defineInterceptor({\n    name: NAME,\n    on: ['state:dispatch', 'table:setOptions'],\n    intercept(ctx, next) {\n      const host = hosts.get(ctx.table as object)\n      if (!host) return next()\n      const before = (ctx.table as Table<unknown, TableState>).getState()\n      const out = next()\n      host.after(before)\n      return out\n    },\n  })\n\n  return defineFeature({\n    name: NAME,\n    stage: 'paginate',\n    mode,\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? paginationOptions : ({} as typeof paginationOptions),\n      opts,\n    ),\n    interceptors: [interceptor],\n    initialState: (): PaginationState => ({ pageIndex: 0, pageSize: initialSize }),\n    // After destroy(): the getters still return their declared types (no pages, no navigation).\n    destroyedResult: { getPageCount: () => 0, canNextPage: () => false, canPrevPage: () => false },\n    createApi: (ctx: FeatureContext<PaginationState>): PaginationApi => {\n      const table = ctx.table\n\n      const internals = getTableInternals(table)\n      let missingReported = false\n      /**\n       * Rows to page over. Server mode (§6.5, §7.1): the fetcher result's `rowCount`\n       * (`undefined` until the first one applied), else the `rowCount` option, else\n       * `DK_ROW_COUNT_MISSING` and `data.length` as the total.\n       */\n      const rowCount = (): number | undefined => {\n        if (mode !== 'server') return table.getRowModel().filteredCount\n        const n = internals.rowCount()\n        if (n !== undefined || internals.hasFetcher()) return n\n        const rows = table.getRowModel().totalCount\n        if (!missingReported) {\n          missingReported = true\n          ctx.emit('DK_ROW_COUNT_MISSING', { rows })\n        }\n        return rows\n      }\n\n      /** The slice with invalid fields replaced (`prev` = the last valid slice, if any). */\n      function sanitize(s: unknown, prev: unknown): PaginationState | undefined {\n        const fallbackSize = isSize((prev as PaginationState | undefined)?.pageSize)\n          ? (prev as PaginationState).pageSize\n          : initialSize\n        if (s === null || typeof s !== 'object') {\n          report('state', 'pageIndex', s, 'the pagination state was reset to its initial value')\n          return { pageIndex: 0, pageSize: initialSize }\n        }\n        const { pageIndex, pageSize } = s as Partial<PaginationState>\n        let fixed: PaginationState | undefined\n        if (!isIndex(pageIndex)) {\n          report('state', 'pageIndex', pageIndex, 'pageIndex was replaced by 0')\n          fixed = { ...(s as PaginationState), pageIndex: 0 }\n        }\n        if (!isSize(pageSize)) {\n          report('state', 'pageSize', pageSize, `pageSize was replaced by ${fallbackSize}`)\n          fixed = { ...(fixed ?? (s as PaginationState)), pageSize: fallbackSize }\n        }\n        return fixed\n      }\n\n      function report(\n        source: 'setPageIndex' | 'setPageSize' | 'state',\n        field: 'pageIndex' | 'pageSize',\n        value: unknown,\n        fallback: string,\n      ) {\n        ctx.emit('DK_INVALID_PAGINATION', { source, field, received: received(value), fallback })\n      }\n\n      /**\n       * The current slice and the page actually shown. An unknown count (a server count not\n       * fetched yet) clamps nothing.\n       */\n      function current() {\n        const s = ctx.getState()\n        const count = rowCount()\n        const index =\n          count === undefined ? s.pageIndex : effectiveIndex(s.pageIndex, s.pageSize, count)\n        return { s, count, index }\n      }\n\n      function goTo(index: number) {\n        const { s, count } = current()\n        const target =\n          index < 0 ? 0 : count === undefined ? index : effectiveIndex(index, s.pageSize, count)\n        if (target !== s.pageIndex) ctx.setState({ ...s, pageIndex: target })\n      }\n\n      hosts.set(table, {\n        after(before) {\n          const now = table.getState()\n          const slice = now[NAME]\n          if (!Object.is(before[NAME], slice)) {\n            const fixed = sanitize(slice, before[NAME])\n            if (fixed) ctx.setState(fixed)\n            return // an update that sets the pagination slice keeps its page\n          }\n          if (!autoReset || (slice as PaginationState).pageIndex === 0) return\n          for (const f of getTableInternals(table).features) {\n            if (RESET_STAGES.has(f.stage) && changed(f.stage, before[f.name], now[f.name])) {\n              ctx.setState({ ...(slice as PaginationState), pageIndex: 0 })\n              return\n            }\n          }\n        },\n      })\n\n      // A slice given at creation (initialState / controlled state) is checked once, here.\n      const fixed = sanitize(ctx.getState(), undefined)\n      if (fixed) ctx.setState(fixed)\n\n      // Clamp when the row count shrinks. A listener sees every change (data, async ingest,\n      // filters with auto-reset off); its update is notified in the next round.\n      table.subscribe(() => {\n        const { s, index } = current()\n        if (index !== s.pageIndex) ctx.setState({ ...s, pageIndex: index })\n      })\n\n      return {\n        setPageIndex(index) {\n          if (!Number.isInteger(index)) {\n            report('setPageIndex', 'pageIndex', index, 'the call was ignored')\n            return\n          }\n          goTo(index)\n        },\n        setPageSize(size) {\n          if (!isSize(size)) {\n            report('setPageSize', 'pageSize', size, 'the call was ignored')\n            return\n          }\n          const { s, index } = current()\n          if (size === s.pageSize) return\n          const firstRow = index * s.pageSize\n          ctx.setState({ pageIndex: Math.floor(firstRow / size), pageSize: size })\n        },\n        nextPage() {\n          goTo(current().index + 1)\n        },\n        prevPage() {\n          goTo(current().index - 1)\n        },\n        getPageCount() {\n          const count = rowCount()\n          return !count ? 0 : Math.ceil(count / ctx.getState().pageSize)\n        },\n        canNextPage() {\n          const { s, count, index } = current()\n          return count !== undefined && (index + 1) * s.pageSize < count\n        },\n        canPrevPage() {\n          return current().index > 0\n        },\n      }\n    },\n    rowModel: (indices, s) => {\n      const size = isSize(s?.pageSize) ? s.pageSize : initialSize\n      const index = effectiveIndex(isIndex(s?.pageIndex) ? s.pageIndex : 0, size, indices.length)\n      const start = index * size\n      if (start === 0 && size >= indices.length) return indices\n      return indices.subarray(start, start + size)\n    },\n  })\n}\n"],"mappings":"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","names":["fixed"]}
+{"version":3,"sources":["../../../src/features/pagination/pagination.ts"],"sourcesContent":["import { defineOptions } from '../../catalog/options'\nimport { keepDiagnostics } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\nimport { describeValue } from '../../diagnostics/redact'\nimport { defineFeature } from '../../feature/define'\nimport type { FeatureContext } from '../../feature/types'\nimport { defineInterceptor } from '../../intercept/define'\nimport { type DataMode, modeOption } from '../../source/mode'\nimport { getTableInternals } from '../../table/internals'\nimport type { Table, TableState } from '../../table/types'\nimport { paginationDiagnostics } from './codes'\n\nkeepDiagnostics(paginationDiagnostics)\n\nexport interface PaginationState {\n  pageIndex: number\n  pageSize: number\n}\n\nexport interface PaginationApi {\n  /** Goes to page `index`, clamped to `[0, getPageCount() - 1]`. */\n  setPageIndex(index: number): void\n  /** Changes the page size and keeps the first visible row on screen (`floor(firstRow / size)`). */\n  setPageSize(size: number): void\n  /** Next page; no-op on the last page. */\n  nextPage(): void\n  /** Previous page; no-op on the first page. */\n  prevPage(): void\n  /** `ceil(rowCount / pageSize)`; `0` when there are no rows. */\n  getPageCount(): number\n  canNextPage(): boolean\n  canPrevPage(): boolean\n}\n\nexport interface PaginationOptions {\n  /** Starting page size (default 10). `options.initialState.pagination` takes precedence. */\n  pageSize?: number\n  /** Go back to page 0 when search, filters or sort change (default `true`). */\n  autoResetPageIndex?: boolean\n  /**\n   * `'server'`: the server pages (its state goes to `options.fetcher`, or the app passes the\n   * current page as `data`); the page count is `ceil(rowCount / pageSize)` with `rowCount` from the\n   * fetcher result or the `rowCount` option (§6.5, §7.1). Default `'client'`.\n   */\n  mode?: DataMode\n}\n\nconst DEFAULT_PAGE_SIZE = 10\nconst NAME = 'pagination'\n\nconst isIndex = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 0\nconst isSize = (v: unknown): v is number => Number.isInteger(v) && (v as number) > 0\nconst received = (v: unknown) => (typeof v === 'number' ? String(v) : describeValue(v))\n\nconst paginationOptions = {\n  pageSize: { type: 'number', check: isSize, expected: 'an integer > 0' },\n  autoResetPageIndex: { type: 'boolean' },\n  mode: modeOption,\n} as const\n\n/** Stages whose state changes send the table back to page 0 (`autoResetPageIndex`). */\nconst RESET_STAGES = new Set(['filter', 'search', 'sort'])\n\n/**\n * A slice change that resets the page. For a search slice only the applied `query` counts: typing\n * (`input`) and `status` alone keep the page (a debounced keystroke must not jump to page 0).\n */\nfunction changed(stage: string, a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return false\n  if (stage === 'search' && hasQuery(a) && hasQuery(b)) return !Object.is(a.query, b.query)\n  return true\n}\n\nconst hasQuery = (v: unknown): v is { query: unknown } =>\n  v !== null && typeof v === 'object' && 'query' in v\n\n/** The page actually shown: `pageIndex` clamped to the last page (0 for no rows). */\nfunction effectiveIndex(pageIndex: number, pageSize: number, rowCount: number): number {\n  const last = rowCount === 0 ? 0 : Math.ceil(rowCount / pageSize) - 1\n  return pageIndex > last ? last : pageIndex\n}\n\n/** What the pagination interceptor needs of one table (registered by `createApi`). */\ninterface Host {\n  /** Runs after `state:dispatch` / `table:setOptions` committed: validation, then auto-reset. */\n  after(before: TableState): void\n}\n\n/**\n * Client-side pagination (§6.5). State `{ pageIndex, pageSize }`; the `paginate` step returns the\n * rows of the current page (`RowModel.filteredCount` stays the count before paging).\n *\n * - `setPageSize` keeps the first visible row on screen; `setPageIndex` clamps.\n * - `autoResetPageIndex` (default `true`): a change of a filter / search / sort slice resets\n *   `pageIndex` to 0 in the same update (one notification). An update that also sets the\n *   pagination slice keeps the page it sets.\n * - `pageIndex` is clamped when the row count shrinks (data change, filters with auto-reset off).\n * - Invalid values are never silent: API arguments are ignored and slices written to the store are\n *   replaced, both with `DK_INVALID_PAGINATION`.\n */\nexport const pagination = (opts: PaginationOptions = {}) => {\n  // Production skips the option validator: an invalid size must not reach the state, or sanitize()\n  // would \"fix\" a slice with the same bad size and re-dispatch forever (#13). Reported in createApi.\n  const badSize = opts.pageSize !== undefined && !isSize(opts.pageSize)\n  const initialSize = badSize ? DEFAULT_PAGE_SIZE : (opts.pageSize ?? DEFAULT_PAGE_SIZE)\n  const autoReset = opts.autoResetPageIndex !== false\n  const mode = opts.mode ?? 'client'\n  // One feature instance may serve several tables: per-table state lives here.\n  const hosts = new WeakMap<object, Host>()\n\n  const interceptor = defineInterceptor({\n    name: NAME,\n    on: ['state:dispatch', 'table:setOptions'],\n    intercept(ctx, next) {\n      const host = hosts.get(ctx.table as object)\n      if (!host) return next()\n      const before = (ctx.table as Table<unknown, TableState>).getState()\n      const out = next()\n      host.after(before)\n      return out\n    },\n  })\n\n  return defineFeature({\n    name: NAME,\n    stage: 'paginate',\n    mode,\n    options: defineOptions(\n      // The option validator runs in development only (§9.3): production drops the schema.\n      (process.env.NODE_ENV !== \"production\") ? paginationOptions : ({} as typeof paginationOptions),\n      opts,\n    ),\n    interceptors: [interceptor],\n    initialState: (): PaginationState => ({ pageIndex: 0, pageSize: initialSize }),\n    // After destroy(): the getters still return their declared types (no pages, no navigation).\n    destroyedResult: { getPageCount: () => 0, canNextPage: () => false, canPrevPage: () => false },\n    createApi: (ctx: FeatureContext<PaginationState>): PaginationApi => {\n      const table = ctx.table\n\n      const internals = getTableInternals(table)\n      let missingReported = false\n      /**\n       * Rows to page over. Server mode (§6.5, §7.1): the fetcher result's `rowCount`\n       * (`undefined` until the first one applied), else the `rowCount` option, else\n       * `DK_ROW_COUNT_MISSING` and `data.length` as the total.\n       */\n      const rowCount = (): number | undefined => {\n        if (mode !== 'server') return table.getRowModel().filteredCount\n        const n = internals.rowCount()\n        if (n !== undefined || internals.hasFetcher()) return n\n        const rows = table.getRowModel().totalCount\n        if (!missingReported) {\n          missingReported = true\n          ctx.emit('DK_ROW_COUNT_MISSING', { rows })\n        }\n        return rows\n      }\n\n      /** The slice with invalid fields replaced (`prev` = the last valid slice, if any). */\n      function sanitize(s: unknown, prev: unknown): PaginationState | undefined {\n        const fallbackSize = isSize((prev as PaginationState | undefined)?.pageSize)\n          ? (prev as PaginationState).pageSize\n          : initialSize\n        if (s === null || typeof s !== 'object') {\n          report('state', 'pageIndex', s, 'page-reset')\n          return { pageIndex: 0, pageSize: initialSize }\n        }\n        const { pageIndex, pageSize } = s as Partial<PaginationState>\n        let fixed: PaginationState | undefined\n        if (!isIndex(pageIndex)) {\n          report('state', 'pageIndex', pageIndex, 'page-index-0')\n          fixed = { ...(s as PaginationState), pageIndex: 0 }\n        }\n        if (!isSize(pageSize)) {\n          report('state', 'pageSize', pageSize, `page-size|${fallbackSize}`)\n          fixed = { ...(fixed ?? (s as PaginationState)), pageSize: fallbackSize }\n        }\n        return fixed\n      }\n\n      function report(\n        source: 'setPageIndex' | 'setPageSize' | 'state' | 'option',\n        field: 'pageIndex' | 'pageSize',\n        value: unknown,\n        fallback: string,\n      ) {\n        ctx.emit('DK_INVALID_PAGINATION', { source, field, received: received(value), fallback })\n      }\n\n      /**\n       * The current slice and the page actually shown (for `count` rows, default: the current\n       * count). An unknown count (a server count not fetched yet) clamps nothing.\n       */\n      function current(count = rowCount()) {\n        const s = ctx.getState()\n        const index =\n          count === undefined ? s.pageIndex : effectiveIndex(s.pageIndex, s.pageSize, count)\n        return { s, count, index }\n      }\n\n      function goTo(index: number) {\n        const { s, count } = current()\n        const target =\n          index < 0 ? 0 : count === undefined ? index : effectiveIndex(index, s.pageSize, count)\n        if (target !== s.pageIndex) ctx.setState({ ...s, pageIndex: target })\n      }\n\n      hosts.set(table, {\n        after(before) {\n          const now = table.getState()\n          const slice = now[NAME]\n          if (!Object.is(before[NAME], slice)) {\n            const fixed = sanitize(slice, before[NAME])\n            if (fixed) ctx.setState(fixed)\n            return // an update that sets the pagination slice keeps its page\n          }\n          if (!autoReset || (slice as PaginationState).pageIndex === 0) return\n          for (const f of getTableInternals(table).features) {\n            if (RESET_STAGES.has(f.stage) && changed(f.stage, before[f.name], now[f.name])) {\n              ctx.setState({ ...(slice as PaginationState), pageIndex: 0 })\n              return\n            }\n          }\n        },\n      })\n\n      if (badSize) report('option', 'pageSize', opts.pageSize, `pageSize ${initialSize} was used`)\n      // A slice given at creation (initialState / controlled state) is checked once, here.\n      const fixed = sanitize(ctx.getState(), undefined)\n      if (fixed) ctx.setState(fixed)\n      // ... and clamped to the last page, so the state never says \"page 100 of 3\" (#19). Client:\n      // the paged rows are a subset of `data`, whose length bounds the last page without running\n      // the pipeline here (restored filters leaving fewer rows: the listener below); no data yet\n      // clamps nothing. Server: a known `rowCount`.\n      const clamp = (count?: number) => {\n        const { s, index } = current(count)\n        if (index < s.pageIndex) ctx.setState({ ...s, pageIndex: index })\n      }\n      const n =\n        mode === 'server' ? internals.rowCount() : (table.getOptions().data as unknown[])?.length\n      if (n) clamp(n)\n\n      // Clamp when the row count shrinks. A listener sees every change (data, async ingest,\n      // filters with auto-reset off); its update is notified in the next round.\n      table.subscribe(() => clamp())\n\n      return {\n        setPageIndex(index) {\n          if (!Number.isInteger(index)) {\n            report('setPageIndex', 'pageIndex', index, 'call-ignored')\n            return\n          }\n          goTo(index)\n        },\n        setPageSize(size) {\n          if (!isSize(size)) {\n            report('setPageSize', 'pageSize', size, 'call-ignored')\n            return\n          }\n          const { s, index } = current()\n          if (size === s.pageSize) return\n          const firstRow = index * s.pageSize\n          ctx.setState({ pageIndex: Math.floor(firstRow / size), pageSize: size })\n        },\n        nextPage() {\n          goTo(current().index + 1)\n        },\n        prevPage() {\n          goTo(current().index - 1)\n        },\n        getPageCount() {\n          const count = rowCount()\n          return !count ? 0 : Math.ceil(count / ctx.getState().pageSize)\n        },\n        canNextPage() {\n          const { s, count, index } = current()\n          return count !== undefined && (index + 1) * s.pageSize < count\n        },\n        canPrevPage() {\n          return current().index > 0\n        },\n      }\n    },\n    rowModel: (indices, s) => {\n      const size = isSize(s?.pageSize) ? s.pageSize : initialSize\n      const index = effectiveIndex(isIndex(s?.pageIndex) ? s.pageIndex : 0, size, indices.length)\n      const start = index * size\n      if (start === 0 && size >= indices.length) return indices\n      return indices.subarray(start, start + size)\n    },\n  })\n}\n"],"mappings":"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","names":["n","fixed"]}

package/dist/features/search/codes.cjs

@@ -25,6 +25,7 @@ __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 searchMessages = {
   DK_SEARCH_FAILED: {
     problem: (d) => d.problem === "bad-result" ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or { keys: RowKey[] }` : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ""}`,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/search/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_SEARCH_FAILED: {\n      /** `error.name` of the rejection / throw; the full error is `context.cause`. */\n      errorName?: string\n      /** `bad-result`: resolved with neither an array of rows nor `{ keys }`. */\n      problem?: 'bad-result'\n      /** The type of the bad result (`describeValue`), never the value. */\n      received?: string\n      /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */\n      hadResults: boolean\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const searchMessages: DiagnosticMessages<'DK_SEARCH_FAILED'> = {\n  DK_SEARCH_FAILED: {\n    problem: (d) =>\n      d.problem === 'bad-result'\n        ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or ` +\n          '{ keys: RowKey[] }'\n        : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadResults\n        ? \"the previous search results are kept (status: 'error')\"\n        : \"the rows are shown unsearched (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'bad-result'\n        ? 'return ctx.rows.filter(...) (the row objects themselves) or { keys: [...] } with the ' +\n          'rowKey values of the matching rows'\n        : 'check the request searchFn sends (the original error is context.cause, passed to ' +\n          'onDiagnostic)',\n      'retry from the UI with flushSearch(); the next query change runs searchFn again',\n    ],\n  },\n}\n\n/** Codes owned by the `search` feature (spec §6.3, §8.3). */\nexport const searchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_SEARCH_FAILED',\n      level: 'error',\n      where: () => ({ kind: 'option', path: 'searchFn' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && searchMessages.DK_SEARCH_FAILED,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAkBnD,IAAM,iBAAyD;AAAA,EACpE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MACR,EAAE,YAAY,eACV,0BAA0B,EAAE,QAAQ,iEAEpC,6BAA6B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IACvE,QAAQ,CAAC,MACP,EAAE,aACE,2DACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,eACV,4HAEA;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,oBAAoB;AAAA,MAC/B;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,eAAe;AAAA,EAC5D;AACF;","names":[]}
+{"version":3,"sources":["../../../src/features/search/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_SEARCH_FAILED: {\n      /** `error.name` of the rejection / throw; the full error is `context.cause`. */\n      errorName?: string\n      /** `bad-result`: resolved with neither an array of rows nor `{ keys }`. */\n      problem?: 'bad-result'\n      /** The type of the bad result (`describeValue`), never the value. */\n      received?: string\n      /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */\n      hadResults: boolean\n    }\n    DK_SEARCH_COLUMN_SKIPPED: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in the table's columns (`options.columns`, else the derived columns). */\n      index: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const searchMessages: DiagnosticMessages<'DK_SEARCH_FAILED'> = {\n  DK_SEARCH_FAILED: {\n    problem: (d) =>\n      d.problem === 'bad-result'\n        ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or ` +\n          '{ keys: RowKey[] }'\n        : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadResults\n        ? \"the previous search results are kept (status: 'error')\"\n        : \"the rows are shown unsearched (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'bad-result'\n        ? 'return ctx.rows.filter(...) (the row objects themselves) or { keys: [...] } with the ' +\n          'rowKey values of the matching rows'\n        : 'check the request searchFn sends (the original error is context.cause, passed to ' +\n          'onDiagnostic)',\n      'retry from the UI with flushSearch(); the next query change runs searchFn again',\n    ],\n  },\n}\n\n/** Codes owned by the `search` feature (spec §6.3, §8.3). */\nexport const searchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_SEARCH_FAILED',\n      level: 'error',\n      where: () => ({ kind: 'option', path: 'searchFn' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && searchMessages.DK_SEARCH_FAILED,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAwBA,IAAM,iBAAyD;AAAA,EACpE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MACR,EAAE,YAAY,eACV,0BAA0B,EAAE,QAAQ,iEAEpC,6BAA6B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IACvE,QAAQ,CAAC,MACP,EAAE,aACE,2DACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,eACV,4HAEA;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,oBAAoB;AAAA,MAC/B;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,eAAe;AAAA,EAC5D;AACF;","names":[]}

package/dist/features/search/codes.js

@@ -1,5 +1,6 @@
 // src/features/search/codes.ts
 import { defineDiagnostic } from "../../diagnostics/catalog.js";
+import "../../diagnostics/process-guard.js";
 var searchMessages = {
   DK_SEARCH_FAILED: {
     problem: (d) => d.problem === "bad-result" ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or { keys: RowKey[] }` : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ""}`,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/search/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_SEARCH_FAILED: {\n      /** `error.name` of the rejection / throw; the full error is `context.cause`. */\n      errorName?: string\n      /** `bad-result`: resolved with neither an array of rows nor `{ keys }`. */\n      problem?: 'bad-result'\n      /** The type of the bad result (`describeValue`), never the value. */\n      received?: string\n      /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */\n      hadResults: boolean\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const searchMessages: DiagnosticMessages<'DK_SEARCH_FAILED'> = {\n  DK_SEARCH_FAILED: {\n    problem: (d) =>\n      d.problem === 'bad-result'\n        ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or ` +\n          '{ keys: RowKey[] }'\n        : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadResults\n        ? \"the previous search results are kept (status: 'error')\"\n        : \"the rows are shown unsearched (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'bad-result'\n        ? 'return ctx.rows.filter(...) (the row objects themselves) or { keys: [...] } with the ' +\n          'rowKey values of the matching rows'\n        : 'check the request searchFn sends (the original error is context.cause, passed to ' +\n          'onDiagnostic)',\n      'retry from the UI with flushSearch(); the next query change runs searchFn again',\n    ],\n  },\n}\n\n/** Codes owned by the `search` feature (spec §6.3, §8.3). */\nexport const searchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_SEARCH_FAILED',\n      level: 'error',\n      where: () => ({ kind: 'option', path: 'searchFn' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && searchMessages.DK_SEARCH_FAILED,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAkBnD,IAAM,iBAAyD;AAAA,EACpE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MACR,EAAE,YAAY,eACV,0BAA0B,EAAE,QAAQ,iEAEpC,6BAA6B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IACvE,QAAQ,CAAC,MACP,EAAE,aACE,2DACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,eACV,4HAEA;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,oBAAoB;AAAA,EAC/B;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,eAAe;AAAA,EAC5D;AACF;","names":[]}
+{"version":3,"sources":["../../../src/features/search/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_SEARCH_FAILED: {\n      /** `error.name` of the rejection / throw; the full error is `context.cause`. */\n      errorName?: string\n      /** `bad-result`: resolved with neither an array of rows nor `{ keys }`. */\n      problem?: 'bad-result'\n      /** The type of the bad result (`describeValue`), never the value. */\n      received?: string\n      /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */\n      hadResults: boolean\n    }\n    DK_SEARCH_COLUMN_SKIPPED: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in the table's columns (`options.columns`, else the derived columns). */\n      index: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const searchMessages: DiagnosticMessages<'DK_SEARCH_FAILED'> = {\n  DK_SEARCH_FAILED: {\n    problem: (d) =>\n      d.problem === 'bad-result'\n        ? `searchFn resolved with ${d.received}, not an array of rows (from ctx.rows) or ` +\n          '{ keys: RowKey[] }'\n        : `searchFn rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadResults\n        ? \"the previous search results are kept (status: 'error')\"\n        : \"the rows are shown unsearched (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'bad-result'\n        ? 'return ctx.rows.filter(...) (the row objects themselves) or { keys: [...] } with the ' +\n          'rowKey values of the matching rows'\n        : 'check the request searchFn sends (the original error is context.cause, passed to ' +\n          'onDiagnostic)',\n      'retry from the UI with flushSearch(); the next query change runs searchFn again',\n    ],\n  },\n}\n\n/** Codes owned by the `search` feature (spec §6.3, §8.3). */\nexport const searchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_SEARCH_FAILED',\n      level: 'error',\n      where: () => ({ kind: 'option', path: 'searchFn' }),\n    },\n    (process.env.NODE_ENV !== \"production\") && searchMessages.DK_SEARCH_FAILED,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAwBA,IAAM,iBAAyD;AAAA,EACpE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MACR,EAAE,YAAY,eACV,0BAA0B,EAAE,QAAQ,iEAEpC,6BAA6B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IACvE,QAAQ,CAAC,MACP,EAAE,aACE,2DACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,eACV,4HAEA;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,oBAAoB;AAAA,EAC/B;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,eAAe;AAAA,EAC5D;AACF;","names":[]}

package/dist/features/search/search-index.cjs

@@ -26,18 +26,24 @@ __export(search_index_exports, {
 });
 module.exports = __toCommonJS(search_index_exports);
 var import_ex_search = require("ex-search");
+var import_get_value = require("../../column/get-value.cjs");
+var import_process_guard = require("../../diagnostics/process-guard.cjs");
+var import_column_cache = require("../../pipeline/column-cache.cjs");
 var import_columns = require("../../pipeline/columns.cjs");
 var import_row = require("../../pipeline/row.cjs");
 var import_capability = require("../../versioning/capability.cjs");
 var CHUNK = 4096;
-var hasExSearch = () => typeof import_ex_search.ExSearch === "function" && typeof import_ex_search.ExSearch.prototype.search === "function" && typeof import_ex_search.ExSearch.prototype.setData === "function";
+var CELLS = 16384;
+var hasExSearch = () => [import_ex_search.ExSearch.prototype.search, import_ex_search.ExSearch.prototype.setData, import_ex_search.Scorer.fuzzy].every(
+  (f) => typeof f === "function"
+);
 function probeExSearch(emit) {
   return process.env.NODE_ENV !== "production" ? (0, import_capability.detectCapability)(
     hasExSearch,
     {
       feature: "search",
       dependency: "ex-search",
-      capability: "ExSearch",
+      capability: "ExSearch, Scorer.fuzzy",
       supported: "^1.1.1",
       fallback: "case-insensitive exact / prefix / substring matching (no fuzzy matching)"
     },
@@ -45,12 +51,38 @@ function probeExSearch(emit) {
   ) : (0, import_capability.hasCapability)(hasExSearch);
 }
 function numberReader(values) {
-  for (let r = 0; r < values.length; r++) if (Number.isNaN(values[r])) return void 0;
-  return (r) => String(values[r]);
+  const nullish = (0, import_column_cache.nullishOf)(values);
+  return (r) => {
+    const v = values[r];
+    return !Number.isNaN(v) ? String(v) : nullish?.[r] ? "" : "NaN";
+  };
+}
+function* scan(size, get) {
+  const over = /* @__PURE__ */ new Map();
+  try {
+    for (let r = 0; r < size; r++) {
+      const v = get(r);
+      if (v !== null && (typeof v === "object" || typeof v === "function")) return false;
+      if (typeof v === "string" && /[\u0300-\uffff]/.test(v)) {
+        const n = v.normalize("NFC");
+        if (n !== v) over.set(r, n);
+      }
+      if (r % CHUNK === CHUNK - 1) yield;
+    }
+  } catch {
+    return void 0;
+  }
+  const read = (r) => {
+    const v = get(r);
+    return v === null || v === void 0 ? "" : String(v);
+  };
+  return over.size ? (r) => over.get(r) ?? read(r) : read;
 }
 function* buildIndex(ctx, config, useExSearch) {
   const cols = (0, import_columns.resolveColumns)(ctx.columns);
   const declared = cols.list.some((c) => c.def.search !== void 0);
+  const data = ctx.data;
+  const n = data.length;
   const keys = [];
   const reads = [];
   for (const col of cols.list) {
@@ -58,33 +90,53 @@ function* buildIndex(ctx, config, useExSearch) {
     const w = col.def.search;
     const weight = declared ? typeof w === "number" && w > 0 ? w : 0 : 1;
     if (weight === 0) continue;
-    let read;
-    if (!col.format) {
+    const path = col.format ? void 0 : col.path;
+    let failed = false;
+    const onError = () => {
+      failed = true;
+    };
+    let read = path ? yield* scan(n, (r) => (0, import_get_value.getValue)(data[r], path, onError)) : void 0;
+    if (failed || read === false && declared) read = void 0;
+    if (read === void 0) {
       const values = ctx.getColumnValues(col.id);
-      if (values instanceof Float64Array) read = numberReader(values);
+      if (!values) continue;
+      yield;
+      const numbers = values instanceof Float64Array;
+      if (numbers && !col.format) read = numberReader(values);
+      else {
+        const own = numbers || declared && col.format ? void 0 : yield* scan(n, (r) => values[r]);
+        if (own === false && !declared) read = false;
+        else if (own && !col.format) read = own;
+        else {
+          const sliced = ctx.formattedSliced;
+          const formatted = sliced ? yield* sliced(col.id) : ctx.getFormattedValues(col.id);
+          if (!formatted) continue;
+          read = yield* scan(n, (r) => formatted[r]);
+        }
+      }
     }
     if (!read) {
-      const formatted = ctx.getFormattedValues(col.id);
-      if (!formatted) continue;
-      read = (r) => formatted[r] ?? "";
+      if (process.env.NODE_ENV !== "production" && read === false) {
+        ctx.emit("DK_SEARCH_COLUMN_SKIPPED", { column: col.id, index: col.index });
+      }
+      continue;
     }
     keys.push({ name: `c${keys.length}`, weight });
     reads.push(read);
     yield;
   }
   if (keys.length === 0) return null;
-  const fold = !config.caseSensitive;
-  const at = (k, r) => {
-    const v = reads[k](r);
-    return fold ? v.toLowerCase() : v;
-  };
-  return useExSearch ? exSearchIndex(ctx.data.length, keys, at, config) : containsIndex(keys, at, config);
+  const fold = (v) => config.caseSensitive ? v : v.toLowerCase();
+  const foldQuery = (q) => fold(q.normalize("NFC"));
+  const at = (k, r) => fold(reads[k](r));
+  return useExSearch ? exSearchIndex(ctx.data.length, keys, at, foldQuery, config) : containsIndex(keys, at, foldQuery, config);
 }
-function* chunked(rows, matchChunk) {
-  if (rows.length <= CHUNK) return rankHits(matchChunk(rows));
+function* chunked(rows, columns, matchChunk) {
+  const size = Math.max(256, Math.floor(CELLS / columns));
+  if (rows.length <= size) return rankHits(matchChunk(rows));
   const hits = [];
-  for (let k = 0; k < rows.length; k += CHUNK) {
-    for (const h of matchChunk(rows.subarray(k, k + CHUNK))) hits.push(h);
+  for (let k = 0; k < rows.length; k += size) {
+    for (const h of matchChunk(rows.subarray(k, k + size))) hits.push(h);
     yield;
   }
   return rankHits(hits);
@@ -100,12 +152,12 @@ function projection(size, keys, at) {
     return o;
   };
   const items = new Proxy(target, {
-    get(t, p, receiver) {
+    get(t, p) {
       if (p === "length") return length();
       const j = (0, import_row.arrayIndex)(p, length());
-      return j >= 0 ? item(j) : Reflect.get(t, p, receiver);
+      return j >= 0 ? item(j) : t[p];
     },
-    has: (t, p) => (0, import_row.arrayIndex)(p, length()) >= 0 || Reflect.has(t, p)
+    has: (t, p) => (0, import_row.arrayIndex)(p, length()) >= 0 || p in t
   });
   return {
     items,
@@ -115,22 +167,39 @@ function projection(size, keys, at) {
     }
   };
 }
-function exSearchIndex(size, keys, at, config) {
+function exSearchIndex(size, keys, at, fold, config) {
   const engine = new import_ex_search.ExSearch({
-    keys: keys.map((k) => ({ name: k.name, weight: k.weight })),
-    threshold: config.threshold,
-    fuzzyMaxDistance: config.fuzzyMaxDistance,
+    keys,
+    ...config,
     caseSensitive: true,
     // DataKable re-ranks with exact scores and an index tie-break; tim keeps ex-search's own pass
     // stable and avoids radix's score quantisation.
     sortAlgorithm: "tim"
   });
-  const view = projection(size, keys, at);
+  const max = config.fuzzyMaxDistance;
+  let q = "";
+  const near = (k, r) => {
+    const v = at(k, r);
+    if (v.includes(q) || /\s/.test(q)) return v;
+    let best = "";
+    let top = 0;
+    const words = v.split(/\s+/);
+    for (const w of words[1] ? [v, ...words] : words) {
+      const s = Math.abs(w.length - q.length) > max ? 0 : import_ex_search.Scorer.fuzzy(w, q, max, true);
+      if (s > top) {
+        best = w;
+        top = s;
+      }
+    }
+    return best;
+  };
+  const view = projection(size, keys, near);
   engine.setData(view.items);
   return {
     match(rows, query) {
-      const q = config.caseSensitive ? query : query.toLowerCase();
-      return chunked(rows, (chunk) => {
+      const folded = fold(query);
+      return chunked(rows, keys.length, (chunk) => {
+        q = folded;
         view.show(chunk);
         try {
           return engine.search(q);
@@ -141,11 +210,11 @@ function exSearchIndex(size, keys, at, config) {
     }
   };
 }
-function containsIndex(keys, at, config) {
+function containsIndex(keys, at, fold, config) {
   return {
     match(rows, query) {
-      const q = config.caseSensitive ? query : query.toLowerCase();
-      return chunked(rows, (chunk) => {
+      const q = fold(query);
+      return chunked(rows, keys.length, (chunk) => {
         const hits = [];
         for (let j = 0; j < chunk.length; j++) {
           const r = chunk[j];
@@ -164,22 +233,10 @@ function containsIndex(keys, at, config) {
   };
 }
 function rankHits(hits) {
-  const n = hits.length;
-  const index = new Uint32Array(n);
-  const score = new Float64Array(n);
-  const order = new Uint32Array(n);
-  for (let k = 0; k < n; k++) {
-    const h = hits[k];
-    index[k] = h.i;
-    score[k] = h.score;
-    order[k] = k;
-  }
-  order.sort(
-    (a, b) => score[b] - score[a] || index[a] - index[b]
+  return Uint32Array.from(
+    hits.sort((a, b) => b.score - a.score || a.i - b.i),
+    (h) => h.i
   );
-  const out = new Uint32Array(n);
-  for (let k = 0; k < n; k++) out[k] = index[order[k]];
-  return out;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {