@datakable/core 1.0.0 → 1.1.0

package/dist/pipeline/runner.js

@@ -1,6 +1,8 @@
 // src/pipeline/runner.ts
 import { getValue } from "../column/get-value.js";
 import { keepDiagnostics } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
+import { SLICED, sliceTimer } from "../diagnostics/trace-store.js";
 import { featureDiagnostics } from "../feature/codes.js";
 import { matchCellIssues } from "../ingest/cell-issues.js";
 import { resolveRowKeys } from "../ingest/row-key.js";
@@ -52,7 +54,8 @@ function createPipeline(host) {
     // Not during SSR, and not for the first row model (the hydrated client matches the server).
     enabled: () => refresh !== void 0 && last !== void 0 && host.base().phase === "client",
     trigger: () => host.base().trigger,
-    done: (trigger) => refresh?.(trigger)
+    done: (trigger) => refresh?.(trigger),
+    timed: (feature, ms) => sliceTimer.current?.(host.base(), feature, ms)
   });
   function reportCell(col, index, e, field) {
     const name = errorName(e);
@@ -63,7 +66,7 @@ function createPipeline(host) {
         column: col.id,
         rows: [index],
         count: 1,
-        fallback: "the cell reads as undefined",
+        fallback: "cell-undefined",
         ...name === void 0 ? {} : { errorName: name }
       },
       { cause: e }
@@ -118,7 +121,7 @@ function createPipeline(host) {
         slot: "rowKey",
         rows: Array.from(keyFailures.sample()),
         count: keyFailures.count,
-        fallback: "those rows use the fallback key '#<index>'",
+        fallback: "row-key-index",
         ...name === void 0 ? {} : { errorName: name }
       },
       { cause: keyError }
@@ -178,6 +181,10 @@ function createPipeline(host) {
         const col = cols.byId.get(id);
         return col ? cache.formatted(data, col) : void 0;
       },
+      *formattedSliced(id) {
+        const col = cols.byId.get(id);
+        return col ? yield* cache.formattedSliced(data, col) : void 0;
+      },
       batch: (id, slot, rows, body) => {
         const col = cols.byId.get(id);
         if (col) cache.batch(col, slot, slot, rows, body);
@@ -221,13 +228,14 @@ function createPipeline(host) {
             {
               feature: f.name,
               hook: "rowModel",
-              fallback: "the step passed its input through",
+              fallback: "step-passthrough",
               ...name === void 0 ? {} : { errorName: name }
             },
             { cause: e }
           );
           return input;
         }
+        if (waiting > waited) ctx2.meta.set(SLICED, true);
         if (process.env.NODE_ENV !== "production" && !checkStep(stepEmit, f.name, input, before, out, data.length)) return input;
         ok = true;
         return out instanceof Uint32Array ? out : input;
@@ -262,11 +270,11 @@ function createPipeline(host) {
       });
     } finally {
       slicer?.end();
-    }
-    if (result) model = result;
-    else {
-      const isInitialLoad = host.isInitialLoad();
-      model = last ? { ...last.model, status: "error", isInitialLoad } : { rows: EMPTY, filteredCount: 0, totalCount: 0, status: "error", isInitialLoad };
+      if (result) model = result;
+      else {
+        const isInitialLoad = host.isInitialLoad();
+        model = last ? { ...last.model, status: "error", isInitialLoad } : { rows: EMPTY, filteredCount: 0, totalCount: 0, status: "error", isInitialLoad };
+      }
     }
     return model;
   }

package/dist/pipeline/runner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/runner.ts"],"sourcesContent":["import { getValue } from '../column/get-value'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { featureDiagnostics } from '../feature/codes'\nimport type { FeatureRuntime } from '../feature/runtime'\nimport type { AnyFeature, RowModelContext } from '../feature/types'\nimport { matchCellIssues } from '../ingest/cell-issues'\nimport { type KeyOf, resolveRowKeys } from '../ingest/row-key'\nimport { CellFailures } from '../intercept/cell-batch'\nimport { errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport { FALLBACK } from '../intercept/fallbacks'\nimport type { InterceptorRuntime } from '../intercept/runtime'\nimport type { TableState } from '../table/types'\nimport type { ColumnCache } from './column-cache'\nimport { type ResolvedColumn, type ResolvedColumns, resolveColumns } from './columns'\nimport { checkStep, indexPrint, stepDiagnostics } from './dev-checks'\nimport { allRows } from './indices'\nimport { lazyRows, Row, type RowIssue, type RowSource } from './row'\nimport type { Slicer } from './slice'\nimport { inStepDiagnosticSetsError } from './status-rule'\nimport type { RowModel, RowModelStatus } from './types'\n\nkeepDiagnostics(featureDiagnostics, stepDiagnostics)\n\nconst EMPTY: readonly never[] = []\nconst NO_EMIT = (() => undefined) as Emit\n\n/** What `createTable` gives the runner. */\nexport interface PipelineHost {\n  readonly runtime: InterceptorRuntime\n  /**\n   * What the features brought (`runtimeFor`): the column cache and time-slicing of their steps.\n   * Always set when a feature has a `rowModel`; a table without features runs no step.\n   */\n  readonly featureRuntime?: FeatureRuntime | undefined\n  readonly emit: Emit\n  /** Installed features in pipeline (stage) order. */\n  readonly features: readonly AnyFeature[]\n  /** `options.features` in the listed order: `where` = `features[<listed index>].rowModel`. */\n  readonly listed: readonly AnyFeature[]\n  base(): ContextBase\n  /** Starts a pipeline run: increments and returns the run id. */\n  nextRun(): number\n  getData(): readonly unknown[]\n  getState(): TableState\n  getColumns(): readonly unknown[] | undefined\n  getRowKey(): unknown\n  /** `RowModel.isInitialLoad`: no data applied yet (§6.6). */\n  isInitialLoad(): boolean\n  /**\n   * The table's status outside the pipeline (`'validating'`, `'error'` after a failed ingest, …);\n   * a step failing in this run makes the row model `'error'` regardless.\n   */\n  status(): RowModelStatus\n  /** Schema issues of a flagged row by data index (`invalidRows: 'flag'`); else `undefined`. */\n  issues(index: number): readonly RowIssue[] | undefined\n  /** `schema` + `invalidRows: 'flag'` (read once): steps get `RowModelContext.flagged`. */\n  readonly flagMode?: boolean\n  /**\n   * Time-sliced work (§9.1, `RowModelContext.slice`) ended: recompute the row model and notify,\n   * under the trigger of the run that started it. Without it nothing is sliced.\n   */\n  refresh?(trigger: Trigger): void\n}\n\nexport interface Pipeline<T> {\n  /** Runs `pipeline:run` and returns the row model (the previous object when nothing changed). */\n  run(): RowModel<T>\n  /** The last row model, if the pipeline ran. */\n  current(): RowModel<T> | undefined\n  /** The last run (`explain`, §8.4); `undefined` before the first. */\n  lastRun(): RunRecord | undefined\n  /**\n   * A `rowModel` context over the current data and columns for replaying a step on chosen rows\n   * (`explainRow`, §8.4): diagnostics are dropped and `batch` runs its body directly (no\n   * interceptors), so a replay reports nothing and changes nothing.\n   */\n  replayContext(name: string): RowModelContext\n  /** Cancels time-sliced work in progress (`destroy()`). */\n  dispose(): void\n}\n\n/**\n * One step of the last run (`explain` / `explainRow`, §8.4): references to the index arrays the\n * step memo holds anyway, never copies. `cached`: served from the memo; `failed`: the step threw or\n * returned a bad output and passed its input through.\n */\nexport interface RunRecord {\n  readonly run: number\n  readonly trigger: Trigger\n  /** The client steps that ran, in order (fewer when `pipeline:run` itself failed). */\n  readonly steps: readonly StepRecord[]\n}\n\nexport interface StepRecord {\n  readonly feature: AnyFeature\n  readonly input: Uint32Array\n  readonly output: Uint32Array\n  readonly cached: boolean\n  readonly failed: boolean\n}\n\ninterface StepMemo {\n  input: Uint32Array\n  state: unknown\n  columns: readonly unknown[]\n  output: Uint32Array\n}\n\ninterface Built<T> {\n  model: RowModel<T>\n  data: readonly unknown[]\n  indices: Uint32Array\n  columns: readonly unknown[]\n  rowKey: unknown\n}\n\n/**\n * The index-based pipeline (§3.3, §9.1): each step consumes and produces a `Uint32Array` of row\n * indices, is memoised on (input reference, own slice, columns), and `Row` objects are created only\n * for the final (visible) indices, each when it is first read.\n */\nexport function createPipeline<T>(host: PipelineHost): Pipeline<T> {\n  /**\n   * In-step diagnostics the §6.6 status rule counts (`inStepDiagnosticSetsError`), ever reported:\n   * a step whose run moved it makes the row model `'error'` and is not memoised.\n   */\n  const flags = { count: 0 }\n  /** `emit` for steps and the column cache: counts through the status rule. */\n  const stepEmit = ((code, details, options) => {\n    if (inStepDiagnosticSetsError(code)) flags.count++\n    host.emit(code, details, options)\n  }) as Emit\n  const rt = host.featureRuntime\n  // Only steps (and explainRow's replay of them) read the cache: they exist only with a runtime.\n  const cache = rt?.createColumnCache({\n    runtime: host.runtime,\n    emit: stepEmit,\n    base: () => host.base(),\n    flags,\n  }) as ColumnCache\n  // A server-mode feature (§7.1) only holds state: the server ran its step.\n  const steps = host.features.filter(\n    (f) => f.stage !== 'none' && f.mode !== 'server' && typeof f.rowModel === 'function',\n  )\n  const where = new Map(steps.map((f) => [f, `features[${host.listed.indexOf(f)}].rowModel`]))\n  const memo = new Map<AnyFeature, StepMemo>()\n  const sources = new WeakMap<ResolvedColumns, RowSource>()\n  const keyFailures = new CellFailures()\n  /** The first `rowKey` error of the current build (its `cause`). */\n  let keyError: unknown\n  const keyFailed = (index: number, e: unknown) => {\n    if (keyFailures.count === 0) keyError = e\n    keyFailures.add(index, e)\n  }\n  let last: Built<T> | undefined\n  /** Row keys resolved over all rows (§5.2), per (data, rowKey) reference. */\n  let keys: { data: readonly unknown[]; rowKey: unknown; keyOf: KeyOf } | undefined\n  let model: RowModel<T> | undefined\n  /** The last run (replaced per run; a few references per step). */\n  let lastRun: RunRecord | undefined\n  /** Steps of the current run waiting on time-sliced work (§9.1): the row model is 'pending'. */\n  let waiting = 0\n  const refresh = host.refresh\n  const slicer: Slicer | undefined = rt?.createSlicer({\n    emit: stepEmit,\n    // Not during SSR, and not for the first row model (the hydrated client matches the server).\n    enabled: () => refresh !== undefined && last !== undefined && host.base().phase === 'client',\n    trigger: () => host.base().trigger,\n    done: (trigger) => refresh?.(trigger),\n  })\n\n  /** `Row.getValue` failures: one emit per failing cell, built only when a cell fails. */\n  function reportCell(col: ResolvedColumn, index: number, e: unknown, field: string) {\n    const name = errorName(e)\n    host.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `columns[${col.index}].${field}`,\n        column: col.id,\n        rows: [index],\n        count: 1,\n        fallback: 'the cell reads as undefined',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: e },\n    )\n  }\n  // A key-path read error, captured by a closure made once (Row.getValue is per cell: no\n  // allocation per call).\n  let pathFailed = false\n  let pathError: unknown\n  const onPathError = (e: unknown) => {\n    pathFailed = true\n    pathError = e\n  }\n\n  function rowSource(cols: ResolvedColumns): RowSource {\n    let s = sources.get(cols)\n    if (s) return s\n    s = {\n      value(index, original, id) {\n        const col = cols.byId.get(id)\n        if (!col) return undefined\n        if (col.path) {\n          const v = getValue(original, col.path, onPathError)\n          if (pathFailed) {\n            const e = pathError\n            pathFailed = false\n            pathError = undefined\n            reportCell(col, index, e, 'key')\n          }\n          return v\n        }\n        if (!col.accessor) return undefined\n        try {\n          return col.accessor(original)\n        } catch (e) {\n          reportCell(col, index, e, 'accessor')\n          return undefined\n        }\n      },\n      issues: (index) => host.issues(index),\n      cellIssues(issues, id) {\n        const col = cols.byId.get(id)\n        return col ? matchCellIssues(issues, col.path) : EMPTY\n      },\n    }\n    sources.set(cols, s)\n    return s\n  }\n\n  function reportKeyFailures() {\n    if (keyFailures.count === 0) return\n    const name = errorName(keyError)\n    host.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: 'rowKey',\n        rows: Array.from(keyFailures.sample()),\n        count: keyFailures.count,\n        fallback: \"those rows use the fallback key '#<index>'\",\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: keyError },\n    )\n    keyFailures.reset()\n    keyError = undefined\n  }\n\n  function build(\n    data: readonly unknown[],\n    indices: Uint32Array,\n    columns: readonly unknown[],\n    filteredCount: number,\n    status: RowModelStatus,\n  ): RowModel<T> {\n    const rowKey = host.getRowKey()\n    const isInitialLoad = host.isInitialLoad()\n    const prev = last\n    if (\n      prev &&\n      prev.indices === indices &&\n      prev.data === data &&\n      prev.columns === columns &&\n      prev.rowKey === rowKey &&\n      prev.model.status === status &&\n      prev.model.isInitialLoad === isInitialLoad\n    ) {\n      return prev.model\n    }\n    const source = rowSource(resolveColumns(columns))\n    keyFailures.reset()\n    if (keys?.data !== data || keys.rowKey !== rowKey) {\n      keys = { data, rowKey, keyOf: resolveRowKeys(data, rowKey, host.emit, keyFailed) }\n    }\n    const keyOf = keys.keyOf\n    reportKeyFailures()\n    // A data array whose rows cannot be read fails this run (the last good row model is kept),\n    // not a later read of `rows[i]`.\n    for (let i = 0; i < indices.length; i++) void data[indices[i] as number]\n    // Rows are built when read (§9.3: no Row per visible row up front). The key scan above read\n    // every key; one that throws only now is reported now.\n    const rows = lazyRows(indices.length, (i) => {\n      const r = indices[i] as number\n      const original = data[r] as T\n      const row = new Row<T>(source, r, keyOf(original, r), original)\n      reportKeyFailures()\n      return row\n    })\n    const m: RowModel<T> = { rows, filteredCount, totalCount: data.length, status, isInitialLoad }\n    last = { model: m, data, indices, columns, rowKey }\n    return m\n  }\n\n  function run(): RowModel<T> {\n    host.nextRun()\n    const data = host.getData()\n    const columns = host.getColumns() ?? EMPTY\n    const cols = resolveColumns(columns)\n    const state = host.getState()\n    let failed = false\n    let result: RowModel<T> | undefined\n    const records: StepRecord[] = []\n    const { run: runId, trigger } = host.base()\n    lastRun = { run: runId, trigger, steps: records }\n\n    const rowModelContext = (name: string): RowModelContext => ({\n      name,\n      data,\n      emit: stepEmit,\n      ...(host.flagMode ? { flagged: (i: number) => host.issues(i) } : {}),\n      run: host.base().run,\n      columns,\n      getColumnValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.values(data, col) : undefined\n      },\n      getFormattedValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.formatted(data, col) : undefined\n      },\n      batch: (id, slot, rows, body) => {\n        const col = cols.byId.get(id)\n        if (col) cache.batch(col, slot, slot, rows, body)\n        return col !== undefined\n      },\n      slice: (key, job) => {\n        const r = (slicer as Slicer).run(key, job, name)\n        if (r === undefined) waiting++\n        return r\n      },\n    })\n\n    function step(f: AnyFeature, input: Uint32Array): Uint32Array {\n      const slice = state[f.name]\n      const m = memo.get(f)\n      if (m && m.input === input && Object.is(m.state, slice) && m.columns === columns) {\n        records.push({ feature: f, input, output: m.output, cached: true, failed: false })\n        return m.output\n      }\n      let ok = false\n      const flagged = flags.count\n      const waited = waiting\n      const ctx = createContext(\n        'pipeline:step',\n        { stage: f.stage, feature: f.name, indices: input },\n        where.get(f) as string,\n        host.base(),\n      )\n      const output = host.runtime.run('pipeline:step', ctx, () => {\n        let out: unknown\n        // Dev check (§3.4 devChecks): a bounded fingerprint of the input before rowModel runs.\n        const before = (process.env.NODE_ENV !== \"production\") ? indexPrint(input) : 0\n        try {\n          out = (f.rowModel as NonNullable<AnyFeature['rowModel']>)(\n            input,\n            slice,\n            rowModelContext(f.name),\n          )\n        } catch (e) {\n          const name = errorName(e)\n          host.emit(\n            'DK_FEATURE_FAILED',\n            {\n              feature: f.name,\n              hook: 'rowModel',\n              fallback: 'the step passed its input through',\n              ...(name === undefined ? {} : { errorName: name }),\n            },\n            { cause: e },\n          )\n          return input\n        }\n        // Dev: a mutated input warns; a bad output passes the input through, not memoised.\n        if ((process.env.NODE_ENV !== \"production\") && !checkStep(stepEmit, f.name, input, before, out, data.length)) return input\n        ok = true\n        return out instanceof Uint32Array ? out : input\n      })\n      // A counted in-step diagnostic (status rule): 'error' with the step's output, re-run next time.\n      // A step waiting on sliced work returned a stand-in: re-run next time too.\n      if (ok && flags.count === flagged) {\n        if (waiting === waited) memo.set(f, { input, state: slice, columns, output })\n        else memo.delete(f)\n      } else {\n        failed = true\n        memo.delete(f)\n      }\n      records.push({ feature: f, input, output, cached: false, failed: !ok })\n      return output\n    }\n\n    const ctx = createContext('pipeline:run', { rowCount: data.length }, 'features', host.base())\n    // The last good row model (§3.4): its indices; the runner keeps the matching rows below.\n    if (last) ctx.meta.set(FALLBACK, last.indices)\n    waiting = 0\n    slicer?.begin()\n    try {\n      void host.runtime.run('pipeline:run', ctx, () => {\n        let indices = allRows(data)\n        let filteredCount = -1\n        for (const f of steps) {\n          if (f.stage === 'paginate' && filteredCount < 0) filteredCount = indices.length\n          indices = step(f, indices)\n        }\n        if (filteredCount < 0) filteredCount = indices.length\n        // Sliced work in progress is 'pending', below every other status (§6.6 precedence).\n        const outside = host.status()\n        const status = failed ? 'error' : waiting > 0 && outside === 'idle' ? 'pending' : outside\n        result = build(data, indices, columns, filteredCount, status)\n        return indices\n      })\n    } finally {\n      // Sliced work no step asked for in this run is stale: cancelled.\n      slicer?.end()\n    }\n    if (result) model = result\n    else {\n      // pipeline:run failed: the boundary reported it; keep the last good rows.\n      const isInitialLoad = host.isInitialLoad()\n      model = last\n        ? { ...last.model, status: 'error', isInitialLoad }\n        : { rows: EMPTY, filteredCount: 0, totalCount: 0, status: 'error', isInitialLoad }\n    }\n    return model\n  }\n\n  function replayContext(name: string): RowModelContext {\n    const data = host.getData()\n    const columns = host.getColumns() ?? EMPTY\n    const cols = resolveColumns(columns)\n    return {\n      name,\n      data,\n      emit: NO_EMIT,\n      ...(host.flagMode ? { flagged: (i: number) => host.issues(i) } : {}),\n      run: host.base().run,\n      columns,\n      getColumnValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.values(data, col) : undefined\n      },\n      getFormattedValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.formatted(data, col) : undefined\n      },\n      batch: (id, _slot, _rows, body) => {\n        if (!cols.byId.has(id)) return false\n        body()\n        return true\n      },\n    }\n  }\n\n  return {\n    run,\n    current: () => model,\n    lastRun: () => lastRun,\n    replayContext,\n    dispose: () => slicer?.cancel(),\n  }\n}\n"],"mappings":"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","names":["ctx"]}
+{"version":3,"sources":["../../src/pipeline/runner.ts"],"sourcesContent":["import { getValue } from '../column/get-value'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { SLICED, sliceTimer } from '../diagnostics/trace-store'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { featureDiagnostics } from '../feature/codes'\nimport type { FeatureRuntime } from '../feature/runtime'\nimport type { AnyFeature, RowModelContext } from '../feature/types'\nimport { matchCellIssues } from '../ingest/cell-issues'\nimport { type KeyOf, resolveRowKeys } from '../ingest/row-key'\nimport { CellFailures } from '../intercept/cell-batch'\nimport { errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport { FALLBACK } from '../intercept/fallbacks'\nimport type { InterceptorRuntime } from '../intercept/runtime'\nimport type { TableState } from '../table/types'\nimport type { ColumnCache, SlicedFormatting } from './column-cache'\nimport { type ResolvedColumn, type ResolvedColumns, resolveColumns } from './columns'\nimport { checkStep, indexPrint, stepDiagnostics } from './dev-checks'\nimport { allRows } from './indices'\nimport { lazyRows, Row, type RowIssue, type RowSource } from './row'\nimport type { Slicer } from './slice'\nimport { inStepDiagnosticSetsError } from './status-rule'\nimport type { RowModel, RowModelStatus } from './types'\n\nkeepDiagnostics(featureDiagnostics, stepDiagnostics)\n\nconst EMPTY: readonly never[] = []\nconst NO_EMIT = (() => undefined) as Emit\n\n/** What `createTable` gives the runner. */\nexport interface PipelineHost {\n  readonly runtime: InterceptorRuntime\n  /**\n   * What the features brought (`runtimeFor`): the column cache and time-slicing of their steps.\n   * Always set when a feature has a `rowModel`; a table without features runs no step.\n   */\n  readonly featureRuntime?: FeatureRuntime | undefined\n  readonly emit: Emit\n  /** Installed features in pipeline (stage) order. */\n  readonly features: readonly AnyFeature[]\n  /** `options.features` in the listed order: `where` = `features[<listed index>].rowModel`. */\n  readonly listed: readonly AnyFeature[]\n  base(): ContextBase\n  /** Starts a pipeline run: increments and returns the run id. */\n  nextRun(): number\n  getData(): readonly unknown[]\n  getState(): TableState\n  getColumns(): readonly unknown[] | undefined\n  getRowKey(): unknown\n  /** `RowModel.isInitialLoad`: no data applied yet (§6.6). */\n  isInitialLoad(): boolean\n  /**\n   * The table's status outside the pipeline (`'validating'`, `'error'` after a failed ingest, …);\n   * a step failing in this run makes the row model `'error'` regardless.\n   */\n  status(): RowModelStatus\n  /** Schema issues of a flagged row by data index (`invalidRows: 'flag'`); else `undefined`. */\n  issues(index: number): readonly RowIssue[] | undefined\n  /** `schema` + `invalidRows: 'flag'` (read once): steps get `RowModelContext.flagged`. */\n  readonly flagMode?: boolean\n  /**\n   * Time-sliced work (§9.1, `RowModelContext.slice`) ended: recompute the row model and notify,\n   * under the trigger of the run that started it. Without it nothing is sliced.\n   */\n  refresh?(trigger: Trigger): void\n}\n\nexport interface Pipeline<T> {\n  /** Runs `pipeline:run` and returns the row model (the previous object when nothing changed). */\n  run(): RowModel<T>\n  /** The last row model, if the pipeline ran. */\n  current(): RowModel<T> | undefined\n  /** The last run (`explain`, §8.4); `undefined` before the first. */\n  lastRun(): RunRecord | undefined\n  /**\n   * A `rowModel` context over the current data and columns for replaying a step on chosen rows\n   * (`explainRow`, §8.4): diagnostics are dropped and `batch` runs its body directly (no\n   * interceptors), so a replay reports nothing and changes nothing.\n   */\n  replayContext(name: string): RowModelContext\n  /** Cancels time-sliced work in progress (`destroy()`). */\n  dispose(): void\n}\n\n/**\n * One step of the last run (`explain` / `explainRow`, §8.4): references to the index arrays the\n * step memo holds anyway, never copies. `cached`: served from the memo; `failed`: the step threw or\n * returned a bad output and passed its input through.\n */\nexport interface RunRecord {\n  readonly run: number\n  readonly trigger: Trigger\n  /** The client steps that ran, in order (fewer when `pipeline:run` itself failed). */\n  readonly steps: readonly StepRecord[]\n}\n\nexport interface StepRecord {\n  readonly feature: AnyFeature\n  readonly input: Uint32Array\n  readonly output: Uint32Array\n  readonly cached: boolean\n  readonly failed: boolean\n}\n\ninterface StepMemo {\n  input: Uint32Array\n  state: unknown\n  columns: readonly unknown[]\n  output: Uint32Array\n}\n\ninterface Built<T> {\n  model: RowModel<T>\n  data: readonly unknown[]\n  indices: Uint32Array\n  columns: readonly unknown[]\n  rowKey: unknown\n}\n\n/**\n * The index-based pipeline (§3.3, §9.1): each step consumes and produces a `Uint32Array` of row\n * indices, is memoised on (input reference, own slice, columns), and `Row` objects are created only\n * for the final (visible) indices, each when it is first read.\n */\nexport function createPipeline<T>(host: PipelineHost): Pipeline<T> {\n  /**\n   * In-step diagnostics the §6.6 status rule counts (`inStepDiagnosticSetsError`), ever reported:\n   * a step whose run moved it makes the row model `'error'` and is not memoised.\n   */\n  const flags = { count: 0 }\n  /** `emit` for steps and the column cache: counts through the status rule. */\n  const stepEmit = ((code, details, options) => {\n    if (inStepDiagnosticSetsError(code)) flags.count++\n    host.emit(code, details, options)\n  }) as Emit\n  const rt = host.featureRuntime\n  // Only steps (and explainRow's replay of them) read the cache: they exist only with a runtime.\n  const cache = rt?.createColumnCache({\n    runtime: host.runtime,\n    emit: stepEmit,\n    base: () => host.base(),\n    flags,\n  }) as ColumnCache\n  // A server-mode feature (§7.1) only holds state: the server ran its step.\n  const steps = host.features.filter(\n    (f) => f.stage !== 'none' && f.mode !== 'server' && typeof f.rowModel === 'function',\n  )\n  const where = new Map(steps.map((f) => [f, `features[${host.listed.indexOf(f)}].rowModel`]))\n  const memo = new Map<AnyFeature, StepMemo>()\n  const sources = new WeakMap<ResolvedColumns, RowSource>()\n  const keyFailures = new CellFailures()\n  /** The first `rowKey` error of the current build (its `cause`). */\n  let keyError: unknown\n  const keyFailed = (index: number, e: unknown) => {\n    if (keyFailures.count === 0) keyError = e\n    keyFailures.add(index, e)\n  }\n  let last: Built<T> | undefined\n  /** Row keys resolved over all rows (§5.2), per (data, rowKey) reference. */\n  let keys: { data: readonly unknown[]; rowKey: unknown; keyOf: KeyOf } | undefined\n  let model: RowModel<T> | undefined\n  /** The last run (replaced per run; a few references per step). */\n  let lastRun: RunRecord | undefined\n  /** Steps of the current run waiting on time-sliced work (§9.1): the row model is 'pending'. */\n  let waiting = 0\n  const refresh = host.refresh\n  const slicer: Slicer | undefined = rt?.createSlicer({\n    emit: stepEmit,\n    // Not during SSR, and not for the first row model (the hydrated client matches the server).\n    enabled: () => refresh !== undefined && last !== undefined && host.base().phase === 'client',\n    trigger: () => host.base().trigger,\n    done: (trigger) => refresh?.(trigger),\n    timed: (feature, ms) => sliceTimer.current?.(host.base(), feature, ms),\n  })\n\n  /** `Row.getValue` failures: one emit per failing cell, built only when a cell fails. */\n  function reportCell(col: ResolvedColumn, index: number, e: unknown, field: string) {\n    const name = errorName(e)\n    host.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: `columns[${col.index}].${field}`,\n        column: col.id,\n        rows: [index],\n        count: 1,\n        fallback: 'cell-undefined',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: e },\n    )\n  }\n  // A key-path read error, captured by a closure made once (Row.getValue is per cell: no\n  // allocation per call).\n  let pathFailed = false\n  let pathError: unknown\n  const onPathError = (e: unknown) => {\n    pathFailed = true\n    pathError = e\n  }\n\n  function rowSource(cols: ResolvedColumns): RowSource {\n    let s = sources.get(cols)\n    if (s) return s\n    s = {\n      value(index, original, id) {\n        const col = cols.byId.get(id)\n        if (!col) return undefined\n        if (col.path) {\n          const v = getValue(original, col.path, onPathError)\n          if (pathFailed) {\n            const e = pathError\n            pathFailed = false\n            pathError = undefined\n            reportCell(col, index, e, 'key')\n          }\n          return v\n        }\n        if (!col.accessor) return undefined\n        try {\n          return col.accessor(original)\n        } catch (e) {\n          reportCell(col, index, e, 'accessor')\n          return undefined\n        }\n      },\n      issues: (index) => host.issues(index),\n      cellIssues(issues, id) {\n        const col = cols.byId.get(id)\n        return col ? matchCellIssues(issues, col.path) : EMPTY\n      },\n    }\n    sources.set(cols, s)\n    return s\n  }\n\n  function reportKeyFailures() {\n    if (keyFailures.count === 0) return\n    const name = errorName(keyError)\n    host.emit(\n      'DK_CALLBACK_FAILED',\n      {\n        slot: 'rowKey',\n        rows: Array.from(keyFailures.sample()),\n        count: keyFailures.count,\n        fallback: 'row-key-index',\n        ...(name === undefined ? {} : { errorName: name }),\n      },\n      { cause: keyError },\n    )\n    keyFailures.reset()\n    keyError = undefined\n  }\n\n  function build(\n    data: readonly unknown[],\n    indices: Uint32Array,\n    columns: readonly unknown[],\n    filteredCount: number,\n    status: RowModelStatus,\n  ): RowModel<T> {\n    const rowKey = host.getRowKey()\n    const isInitialLoad = host.isInitialLoad()\n    const prev = last\n    if (\n      prev &&\n      prev.indices === indices &&\n      prev.data === data &&\n      prev.columns === columns &&\n      prev.rowKey === rowKey &&\n      prev.model.status === status &&\n      prev.model.isInitialLoad === isInitialLoad\n    ) {\n      return prev.model\n    }\n    const source = rowSource(resolveColumns(columns))\n    keyFailures.reset()\n    if (keys?.data !== data || keys.rowKey !== rowKey) {\n      keys = { data, rowKey, keyOf: resolveRowKeys(data, rowKey, host.emit, keyFailed) }\n    }\n    const keyOf = keys.keyOf\n    reportKeyFailures()\n    // A data array whose rows cannot be read fails this run (the last good row model is kept),\n    // not a later read of `rows[i]`.\n    for (let i = 0; i < indices.length; i++) void data[indices[i] as number]\n    // Rows are built when read (§9.3: no Row per visible row up front). The key scan above read\n    // every key; one that throws only now is reported now.\n    const rows = lazyRows(indices.length, (i) => {\n      const r = indices[i] as number\n      const original = data[r] as T\n      const row = new Row<T>(source, r, keyOf(original, r), original)\n      reportKeyFailures()\n      return row\n    })\n    const m: RowModel<T> = { rows, filteredCount, totalCount: data.length, status, isInitialLoad }\n    last = { model: m, data, indices, columns, rowKey }\n    return m\n  }\n\n  function run(): RowModel<T> {\n    host.nextRun()\n    const data = host.getData()\n    const columns = host.getColumns() ?? EMPTY\n    const cols = resolveColumns(columns)\n    const state = host.getState()\n    let failed = false\n    let result: RowModel<T> | undefined\n    const records: StepRecord[] = []\n    const { run: runId, trigger } = host.base()\n    lastRun = { run: runId, trigger, steps: records }\n\n    const rowModelContext = (name: string): RowModelContext & SlicedFormatting => ({\n      name,\n      data,\n      emit: stepEmit,\n      ...(host.flagMode ? { flagged: (i: number) => host.issues(i) } : {}),\n      run: host.base().run,\n      columns,\n      getColumnValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.values(data, col) : undefined\n      },\n      getFormattedValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.formatted(data, col) : undefined\n      },\n      *formattedSliced(id) {\n        const col = cols.byId.get(id)\n        return col ? yield* cache.formattedSliced(data, col) : undefined\n      },\n      batch: (id, slot, rows, body) => {\n        const col = cols.byId.get(id)\n        if (col) cache.batch(col, slot, slot, rows, body)\n        return col !== undefined\n      },\n      slice: (key, job) => {\n        const r = (slicer as Slicer).run(key, job, name)\n        if (r === undefined) waiting++\n        return r\n      },\n    })\n\n    function step(f: AnyFeature, input: Uint32Array): Uint32Array {\n      const slice = state[f.name]\n      const m = memo.get(f)\n      if (m && m.input === input && Object.is(m.state, slice) && m.columns === columns) {\n        records.push({ feature: f, input, output: m.output, cached: true, failed: false })\n        return m.output\n      }\n      let ok = false\n      const flagged = flags.count\n      const waited = waiting\n      const ctx = createContext(\n        'pipeline:step',\n        { stage: f.stage, feature: f.name, indices: input },\n        where.get(f) as string,\n        host.base(),\n      )\n      const output = host.runtime.run('pipeline:step', ctx, () => {\n        let out: unknown\n        // Dev check (§3.4 devChecks): a bounded fingerprint of the input before rowModel runs.\n        const before = (process.env.NODE_ENV !== \"production\") ? indexPrint(input) : 0\n        try {\n          out = (f.rowModel as NonNullable<AnyFeature['rowModel']>)(\n            input,\n            slice,\n            rowModelContext(f.name),\n          )\n        } catch (e) {\n          const name = errorName(e)\n          host.emit(\n            'DK_FEATURE_FAILED',\n            {\n              feature: f.name,\n              hook: 'rowModel',\n              fallback: 'step-passthrough',\n              ...(name === undefined ? {} : { errorName: name }),\n            },\n            { cause: e },\n          )\n          return input\n        }\n        // The tracer adds the time of this sliced work to the step (#61).\n        if (waiting > waited) ctx.meta.set(SLICED, true)\n        // Dev: a mutated input warns; a bad output passes the input through, not memoised.\n        if ((process.env.NODE_ENV !== \"production\") && !checkStep(stepEmit, f.name, input, before, out, data.length)) return input\n        ok = true\n        return out instanceof Uint32Array ? out : input\n      })\n      // A counted in-step diagnostic (status rule): 'error' with the step's output, re-run next time.\n      // A step waiting on sliced work returned a stand-in: re-run next time too.\n      if (ok && flags.count === flagged) {\n        if (waiting === waited) memo.set(f, { input, state: slice, columns, output })\n        else memo.delete(f)\n      } else {\n        failed = true\n        memo.delete(f)\n      }\n      records.push({ feature: f, input, output, cached: false, failed: !ok })\n      return output\n    }\n\n    const ctx = createContext('pipeline:run', { rowCount: data.length }, 'features', host.base())\n    // The last good row model (§3.4): its indices; the runner keeps the matching rows below.\n    if (last) ctx.meta.set(FALLBACK, last.indices)\n    waiting = 0\n    slicer?.begin()\n    try {\n      void host.runtime.run('pipeline:run', ctx, () => {\n        let indices = allRows(data)\n        let filteredCount = -1\n        for (const f of steps) {\n          if (f.stage === 'paginate' && filteredCount < 0) filteredCount = indices.length\n          indices = step(f, indices)\n        }\n        if (filteredCount < 0) filteredCount = indices.length\n        // Sliced work in progress is 'pending', below every other status (§6.6 precedence).\n        const outside = host.status()\n        const status = failed ? 'error' : waiting > 0 && outside === 'idle' ? 'pending' : outside\n        result = build(data, indices, columns, filteredCount, status)\n        return indices\n      })\n    } finally {\n      // Sliced work no step asked for in this run is stale: cancelled.\n      slicer?.end()\n      if (result) model = result\n      else {\n        // pipeline:run failed: the boundary reported it, or a strict throw is leaving the run\n        // (#43). Either way the last good rows with status 'error', never an empty 'idle' model.\n        const isInitialLoad = host.isInitialLoad()\n        model = last\n          ? { ...last.model, status: 'error', isInitialLoad }\n          : { rows: EMPTY, filteredCount: 0, totalCount: 0, status: 'error', isInitialLoad }\n      }\n    }\n    return model\n  }\n\n  function replayContext(name: string): RowModelContext {\n    const data = host.getData()\n    const columns = host.getColumns() ?? EMPTY\n    const cols = resolveColumns(columns)\n    return {\n      name,\n      data,\n      emit: NO_EMIT,\n      ...(host.flagMode ? { flagged: (i: number) => host.issues(i) } : {}),\n      run: host.base().run,\n      columns,\n      getColumnValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.values(data, col) : undefined\n      },\n      getFormattedValues: (id) => {\n        const col = cols.byId.get(id)\n        return col ? cache.formatted(data, col) : undefined\n      },\n      batch: (id, _slot, _rows, body) => {\n        if (!cols.byId.has(id)) return false\n        body()\n        return true\n      },\n    }\n  }\n\n  return {\n    run,\n    current: () => model,\n    lastRun: () => lastRun,\n    replayContext,\n    dispose: () => slicer?.cancel(),\n  }\n}\n"],"mappings":"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","names":["ctx"]}

package/dist/pipeline/slice.cjs

@@ -75,7 +75,9 @@ function createSlicer(host) {
     while (task.state === "running") {
       await pause(task.feature);
       if (task.state !== "running") return;
-      advance(task, now() + SLICE_MS);
+      const start = now();
+      advance(task, start + SLICE_MS);
+      host.timed?.(task.feature, now() - start);
     }
     running.delete(task);
     host.done(task.trigger);

package/dist/pipeline/slice.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/slice.ts"],"sourcesContent":["import { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { envDiagnostics } from './env-codes'\n\nkeepDiagnostics(envDiagnostics)\n\n/**\n * Time-sliced work (§9.1): a generator that `yield`s between chunks of work (every few thousand\n * rows). Its return value is the result.\n */\nexport type SliceJob<R> = () => Iterator<unknown, R, undefined>\n\n/**\n * One slice of work, in milliseconds. A job that finishes within it never goes async (small\n * tables keep synchronous row models); the slices of a longer one stay well under the 50 ms\n * long-task budget (§9.3) with the rest of the pipeline run around them.\n */\nexport const SLICE_MS = 8\n\nexport interface SlicerHost {\n  readonly emit: Emit\n  /** Slicing is allowed now: in the browser, after the table's first row model. */\n  enabled(): boolean\n  /** The trigger of the current run (a finished job recomputes under it). */\n  trigger(): Trigger\n  /** A job ended (its result or error is ready): recompute the row model and notify. */\n  done(trigger: Trigger): void\n}\n\nexport interface Slicer {\n  /**\n   * The result of the job for `key`: started on the first call (one synchronous slice), then\n   * `undefined` until it has finished. A job that threw rethrows here, in the step that asks.\n   */\n  run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined\n  /** Starts a pipeline run: jobs that no step asks for until {@link end} are cancelled. */\n  begin(): void\n  end(): void\n  /** Cancels every job (`destroy()`). */\n  cancel(): void\n}\n\n/** Runs `job` to completion (no slicing). */\nexport function runJob<R>(job: SliceJob<R>): R {\n  const it = job()\n  for (;;) {\n    const r = it.next()\n    if (r.done) return r.value\n  }\n}\n\n/**\n * `ctx.slice(key, job)` where the runner provides it (a table run), else the whole job now. For\n * features: `undefined` means \"still running\" (return a stand-in).\n */\nexport function sliced<R>(\n  ctx: { slice?: <X>(key: object, job: SliceJob<X>) => X | undefined },\n  key: object,\n  job: SliceJob<R>,\n): R | undefined {\n  return ctx.slice ? ctx.slice(key, job) : runJob(job)\n}\n\ninterface Task {\n  readonly key: object\n  readonly it: Iterator<unknown, unknown, undefined>\n  readonly trigger: Trigger\n  readonly feature: string\n  state: 'running' | 'done' | 'failed' | 'cancelled'\n  value: unknown\n}\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\ntype Scheduler = { yield?: () => Promise<void> }\n\n/** Runs `task` until it ends or `deadline` passes (checked at each `yield`). */\nfunction advance(task: Task, deadline: number) {\n  try {\n    for (;;) {\n      const r = task.it.next()\n      if (r.done) {\n        task.state = 'done'\n        task.value = r.value\n        return\n      }\n      if (now() >= deadline) return\n    }\n  } catch (e) {\n    task.state = 'failed'\n    task.value = e\n  }\n}\n\n/**\n * The table's slicer (§9.1). Between slices it yields to the main thread with\n * `scheduler.yield()`, or `setTimeout` where that is missing (`DK_ENV_FALLBACK`, once per table).\n * Jobs are keyed by an object of the caller (e.g. the data / columns they read), so a job is\n * started once and its result is shared by later runs.\n */\nexport function createSlicer(host: SlicerHost): Slicer {\n  const tasks = new WeakMap<object, Task>()\n  const running = new Set<Task>()\n  let asked: Set<Task> | undefined\n  let reported = false\n\n  function pause(feature: string): Promise<void> {\n    const s = (globalThis as { scheduler?: Scheduler }).scheduler\n    if (typeof s?.yield === 'function') return s.yield()\n    if (!reported) {\n      reported = true\n      host.emit('DK_ENV_FALLBACK', { api: 'scheduler.yield', feature, fallback: 'setTimeout' })\n    }\n    return new Promise((resolve) => setTimeout(resolve, 0))\n  }\n\n  async function drive(task: Task) {\n    while (task.state === 'running') {\n      await pause(task.feature)\n      if (task.state !== 'running') return\n      advance(task, now() + SLICE_MS)\n    }\n    running.delete(task)\n    host.done(task.trigger)\n  }\n\n  function result(task: Task): unknown {\n    if (task.state === 'failed') throw task.value\n    return task.state === 'done' ? task.value : undefined\n  }\n\n  return {\n    run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined {\n      const known = tasks.get(key)\n      if (known && known.state !== 'cancelled') {\n        asked?.add(known)\n        return result(known) as R | undefined\n      }\n      const task: Task = {\n        key,\n        it: job(),\n        trigger: host.trigger(),\n        feature,\n        state: 'running',\n        value: undefined,\n      }\n      tasks.set(key, task)\n      advance(task, host.enabled() ? now() + SLICE_MS : Number.POSITIVE_INFINITY)\n      if (task.state === 'running') {\n        running.add(task)\n        asked?.add(task)\n        // `drive` never rejects: `advance` catches the job's errors, `done` is the table's.\n        void drive(task).catch(() => {})\n      }\n      return result(task) as R | undefined\n    },\n    begin() {\n      asked = new Set()\n    },\n    end() {\n      const keep = asked\n      asked = undefined\n      if (!keep) return\n      for (const task of running) {\n        if (keep.has(task)) continue\n        task.state = 'cancelled'\n        running.delete(task)\n        tasks.delete(task.key)\n      }\n    },\n    cancel() {\n      for (const task of running) {\n        task.state = 'cancelled'\n        tasks.delete(task.key)\n      }\n      running.clear()\n    },\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pipeline/slice.ts"],"sourcesContent":["import { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { envDiagnostics } from './env-codes'\n\nkeepDiagnostics(envDiagnostics)\n\n/**\n * Time-sliced work (§9.1): a generator that `yield`s between chunks of work (every few thousand\n * rows). Its return value is the result.\n */\nexport type SliceJob<R> = () => Iterator<unknown, R, undefined>\n\n/**\n * One slice of work, in milliseconds. A job that finishes within it never goes async (small\n * tables keep synchronous row models); the slices of a longer one stay well under the 50 ms\n * long-task budget (§9.3) with the rest of the pipeline run around them.\n */\nexport const SLICE_MS = 8\n\nexport interface SlicerHost {\n  readonly emit: Emit\n  /** Slicing is allowed now: in the browser, after the table's first row model. */\n  enabled(): boolean\n  /** The trigger of the current run (a finished job recomputes under it). */\n  trigger(): Trigger\n  /** A job ended (its result or error is ready): recompute the row model and notify. */\n  done(trigger: Trigger): void\n  /** A slice run between pipeline runs took `ms` (the tracer's, #61). */\n  timed?(feature: string, ms: number): void\n}\n\nexport interface Slicer {\n  /**\n   * The result of the job for `key`: started on the first call (one synchronous slice), then\n   * `undefined` until it has finished. A job that threw rethrows here, in the step that asks.\n   */\n  run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined\n  /** Starts a pipeline run: jobs that no step asks for until {@link end} are cancelled. */\n  begin(): void\n  end(): void\n  /** Cancels every job (`destroy()`). */\n  cancel(): void\n}\n\n/** Runs `job` to completion (no slicing). */\nexport function runJob<R>(job: SliceJob<R>): R {\n  const it = job()\n  for (;;) {\n    const r = it.next()\n    if (r.done) return r.value\n  }\n}\n\n/**\n * `ctx.slice(key, job)` where the runner provides it (a table run), else the whole job now. For\n * features: `undefined` means \"still running\" (return a stand-in).\n */\nexport function sliced<R>(\n  ctx: { slice?: <X>(key: object, job: SliceJob<X>) => X | undefined },\n  key: object,\n  job: SliceJob<R>,\n): R | undefined {\n  return ctx.slice ? ctx.slice(key, job) : runJob(job)\n}\n\ninterface Task {\n  readonly key: object\n  readonly it: Iterator<unknown, unknown, undefined>\n  readonly trigger: Trigger\n  readonly feature: string\n  state: 'running' | 'done' | 'failed' | 'cancelled'\n  value: unknown\n}\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\ntype Scheduler = { yield?: () => Promise<void> }\n\n/** Runs `task` until it ends or `deadline` passes (checked at each `yield`). */\nfunction advance(task: Task, deadline: number) {\n  try {\n    for (;;) {\n      const r = task.it.next()\n      if (r.done) {\n        task.state = 'done'\n        task.value = r.value\n        return\n      }\n      if (now() >= deadline) return\n    }\n  } catch (e) {\n    task.state = 'failed'\n    task.value = e\n  }\n}\n\n/**\n * The table's slicer (§9.1). Between slices it yields to the main thread with\n * `scheduler.yield()`, or `setTimeout` where that is missing (`DK_ENV_FALLBACK`, once per table).\n * Jobs are keyed by an object of the caller (e.g. the data / columns they read), so a job is\n * started once and its result is shared by later runs.\n */\nexport function createSlicer(host: SlicerHost): Slicer {\n  const tasks = new WeakMap<object, Task>()\n  const running = new Set<Task>()\n  let asked: Set<Task> | undefined\n  let reported = false\n\n  function pause(feature: string): Promise<void> {\n    const s = (globalThis as { scheduler?: Scheduler }).scheduler\n    if (typeof s?.yield === 'function') return s.yield()\n    if (!reported) {\n      reported = true\n      host.emit('DK_ENV_FALLBACK', { api: 'scheduler.yield', feature, fallback: 'setTimeout' })\n    }\n    return new Promise((resolve) => setTimeout(resolve, 0))\n  }\n\n  async function drive(task: Task) {\n    while (task.state === 'running') {\n      await pause(task.feature)\n      if (task.state !== 'running') return\n      const start = now()\n      advance(task, start + SLICE_MS)\n      host.timed?.(task.feature, now() - start)\n    }\n    running.delete(task)\n    host.done(task.trigger)\n  }\n\n  function result(task: Task): unknown {\n    if (task.state === 'failed') throw task.value\n    return task.state === 'done' ? task.value : undefined\n  }\n\n  return {\n    run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined {\n      const known = tasks.get(key)\n      if (known && known.state !== 'cancelled') {\n        asked?.add(known)\n        return result(known) as R | undefined\n      }\n      const task: Task = {\n        key,\n        it: job(),\n        trigger: host.trigger(),\n        feature,\n        state: 'running',\n        value: undefined,\n      }\n      tasks.set(key, task)\n      advance(task, host.enabled() ? now() + SLICE_MS : Number.POSITIVE_INFINITY)\n      if (task.state === 'running') {\n        running.add(task)\n        asked?.add(task)\n        // `drive` never rejects: `advance` catches the job's errors, `done` is the table's.\n        void drive(task).catch(() => {})\n      }\n      return result(task) as R | undefined\n    },\n    begin() {\n      asked = new Set()\n    },\n    end() {\n      const keep = asked\n      asked = undefined\n      if (!keep) return\n      for (const task of running) {\n        if (keep.has(task)) continue\n        task.state = 'cancelled'\n        running.delete(task)\n        tasks.delete(task.key)\n      }\n    },\n    cancel() {\n      for (const task of running) {\n        task.state = 'cancelled'\n        tasks.delete(task.key)\n      }\n      running.clear()\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/pipeline/slice.js

@@ -48,7 +48,9 @@ function createSlicer(host) {
     while (task.state === "running") {
       await pause(task.feature);
       if (task.state !== "running") return;
-      advance(task, now() + SLICE_MS);
+      const start = now();
+      advance(task, start + SLICE_MS);
+      host.timed?.(task.feature, now() - start);
     }
     running.delete(task);
     host.done(task.trigger);

package/dist/pipeline/slice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/slice.ts"],"sourcesContent":["import { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { envDiagnostics } from './env-codes'\n\nkeepDiagnostics(envDiagnostics)\n\n/**\n * Time-sliced work (§9.1): a generator that `yield`s between chunks of work (every few thousand\n * rows). Its return value is the result.\n */\nexport type SliceJob<R> = () => Iterator<unknown, R, undefined>\n\n/**\n * One slice of work, in milliseconds. A job that finishes within it never goes async (small\n * tables keep synchronous row models); the slices of a longer one stay well under the 50 ms\n * long-task budget (§9.3) with the rest of the pipeline run around them.\n */\nexport const SLICE_MS = 8\n\nexport interface SlicerHost {\n  readonly emit: Emit\n  /** Slicing is allowed now: in the browser, after the table's first row model. */\n  enabled(): boolean\n  /** The trigger of the current run (a finished job recomputes under it). */\n  trigger(): Trigger\n  /** A job ended (its result or error is ready): recompute the row model and notify. */\n  done(trigger: Trigger): void\n}\n\nexport interface Slicer {\n  /**\n   * The result of the job for `key`: started on the first call (one synchronous slice), then\n   * `undefined` until it has finished. A job that threw rethrows here, in the step that asks.\n   */\n  run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined\n  /** Starts a pipeline run: jobs that no step asks for until {@link end} are cancelled. */\n  begin(): void\n  end(): void\n  /** Cancels every job (`destroy()`). */\n  cancel(): void\n}\n\n/** Runs `job` to completion (no slicing). */\nexport function runJob<R>(job: SliceJob<R>): R {\n  const it = job()\n  for (;;) {\n    const r = it.next()\n    if (r.done) return r.value\n  }\n}\n\n/**\n * `ctx.slice(key, job)` where the runner provides it (a table run), else the whole job now. For\n * features: `undefined` means \"still running\" (return a stand-in).\n */\nexport function sliced<R>(\n  ctx: { slice?: <X>(key: object, job: SliceJob<X>) => X | undefined },\n  key: object,\n  job: SliceJob<R>,\n): R | undefined {\n  return ctx.slice ? ctx.slice(key, job) : runJob(job)\n}\n\ninterface Task {\n  readonly key: object\n  readonly it: Iterator<unknown, unknown, undefined>\n  readonly trigger: Trigger\n  readonly feature: string\n  state: 'running' | 'done' | 'failed' | 'cancelled'\n  value: unknown\n}\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\ntype Scheduler = { yield?: () => Promise<void> }\n\n/** Runs `task` until it ends or `deadline` passes (checked at each `yield`). */\nfunction advance(task: Task, deadline: number) {\n  try {\n    for (;;) {\n      const r = task.it.next()\n      if (r.done) {\n        task.state = 'done'\n        task.value = r.value\n        return\n      }\n      if (now() >= deadline) return\n    }\n  } catch (e) {\n    task.state = 'failed'\n    task.value = e\n  }\n}\n\n/**\n * The table's slicer (§9.1). Between slices it yields to the main thread with\n * `scheduler.yield()`, or `setTimeout` where that is missing (`DK_ENV_FALLBACK`, once per table).\n * Jobs are keyed by an object of the caller (e.g. the data / columns they read), so a job is\n * started once and its result is shared by later runs.\n */\nexport function createSlicer(host: SlicerHost): Slicer {\n  const tasks = new WeakMap<object, Task>()\n  const running = new Set<Task>()\n  let asked: Set<Task> | undefined\n  let reported = false\n\n  function pause(feature: string): Promise<void> {\n    const s = (globalThis as { scheduler?: Scheduler }).scheduler\n    if (typeof s?.yield === 'function') return s.yield()\n    if (!reported) {\n      reported = true\n      host.emit('DK_ENV_FALLBACK', { api: 'scheduler.yield', feature, fallback: 'setTimeout' })\n    }\n    return new Promise((resolve) => setTimeout(resolve, 0))\n  }\n\n  async function drive(task: Task) {\n    while (task.state === 'running') {\n      await pause(task.feature)\n      if (task.state !== 'running') return\n      advance(task, now() + SLICE_MS)\n    }\n    running.delete(task)\n    host.done(task.trigger)\n  }\n\n  function result(task: Task): unknown {\n    if (task.state === 'failed') throw task.value\n    return task.state === 'done' ? task.value : undefined\n  }\n\n  return {\n    run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined {\n      const known = tasks.get(key)\n      if (known && known.state !== 'cancelled') {\n        asked?.add(known)\n        return result(known) as R | undefined\n      }\n      const task: Task = {\n        key,\n        it: job(),\n        trigger: host.trigger(),\n        feature,\n        state: 'running',\n        value: undefined,\n      }\n      tasks.set(key, task)\n      advance(task, host.enabled() ? now() + SLICE_MS : Number.POSITIVE_INFINITY)\n      if (task.state === 'running') {\n        running.add(task)\n        asked?.add(task)\n        // `drive` never rejects: `advance` catches the job's errors, `done` is the table's.\n        void drive(task).catch(() => {})\n      }\n      return result(task) as R | undefined\n    },\n    begin() {\n      asked = new Set()\n    },\n    end() {\n      const keep = asked\n      asked = undefined\n      if (!keep) return\n      for (const task of running) {\n        if (keep.has(task)) continue\n        task.state = 'cancelled'\n        running.delete(task)\n        tasks.delete(task.key)\n      }\n    },\n    cancel() {\n      for (const task of running) {\n        task.state = 'cancelled'\n        tasks.delete(task.key)\n      }\n      running.clear()\n    },\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pipeline/slice.ts"],"sourcesContent":["import { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit, Trigger } from '../diagnostics/types'\nimport { envDiagnostics } from './env-codes'\n\nkeepDiagnostics(envDiagnostics)\n\n/**\n * Time-sliced work (§9.1): a generator that `yield`s between chunks of work (every few thousand\n * rows). Its return value is the result.\n */\nexport type SliceJob<R> = () => Iterator<unknown, R, undefined>\n\n/**\n * One slice of work, in milliseconds. A job that finishes within it never goes async (small\n * tables keep synchronous row models); the slices of a longer one stay well under the 50 ms\n * long-task budget (§9.3) with the rest of the pipeline run around them.\n */\nexport const SLICE_MS = 8\n\nexport interface SlicerHost {\n  readonly emit: Emit\n  /** Slicing is allowed now: in the browser, after the table's first row model. */\n  enabled(): boolean\n  /** The trigger of the current run (a finished job recomputes under it). */\n  trigger(): Trigger\n  /** A job ended (its result or error is ready): recompute the row model and notify. */\n  done(trigger: Trigger): void\n  /** A slice run between pipeline runs took `ms` (the tracer's, #61). */\n  timed?(feature: string, ms: number): void\n}\n\nexport interface Slicer {\n  /**\n   * The result of the job for `key`: started on the first call (one synchronous slice), then\n   * `undefined` until it has finished. A job that threw rethrows here, in the step that asks.\n   */\n  run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined\n  /** Starts a pipeline run: jobs that no step asks for until {@link end} are cancelled. */\n  begin(): void\n  end(): void\n  /** Cancels every job (`destroy()`). */\n  cancel(): void\n}\n\n/** Runs `job` to completion (no slicing). */\nexport function runJob<R>(job: SliceJob<R>): R {\n  const it = job()\n  for (;;) {\n    const r = it.next()\n    if (r.done) return r.value\n  }\n}\n\n/**\n * `ctx.slice(key, job)` where the runner provides it (a table run), else the whole job now. For\n * features: `undefined` means \"still running\" (return a stand-in).\n */\nexport function sliced<R>(\n  ctx: { slice?: <X>(key: object, job: SliceJob<X>) => X | undefined },\n  key: object,\n  job: SliceJob<R>,\n): R | undefined {\n  return ctx.slice ? ctx.slice(key, job) : runJob(job)\n}\n\ninterface Task {\n  readonly key: object\n  readonly it: Iterator<unknown, unknown, undefined>\n  readonly trigger: Trigger\n  readonly feature: string\n  state: 'running' | 'done' | 'failed' | 'cancelled'\n  value: unknown\n}\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\ntype Scheduler = { yield?: () => Promise<void> }\n\n/** Runs `task` until it ends or `deadline` passes (checked at each `yield`). */\nfunction advance(task: Task, deadline: number) {\n  try {\n    for (;;) {\n      const r = task.it.next()\n      if (r.done) {\n        task.state = 'done'\n        task.value = r.value\n        return\n      }\n      if (now() >= deadline) return\n    }\n  } catch (e) {\n    task.state = 'failed'\n    task.value = e\n  }\n}\n\n/**\n * The table's slicer (§9.1). Between slices it yields to the main thread with\n * `scheduler.yield()`, or `setTimeout` where that is missing (`DK_ENV_FALLBACK`, once per table).\n * Jobs are keyed by an object of the caller (e.g. the data / columns they read), so a job is\n * started once and its result is shared by later runs.\n */\nexport function createSlicer(host: SlicerHost): Slicer {\n  const tasks = new WeakMap<object, Task>()\n  const running = new Set<Task>()\n  let asked: Set<Task> | undefined\n  let reported = false\n\n  function pause(feature: string): Promise<void> {\n    const s = (globalThis as { scheduler?: Scheduler }).scheduler\n    if (typeof s?.yield === 'function') return s.yield()\n    if (!reported) {\n      reported = true\n      host.emit('DK_ENV_FALLBACK', { api: 'scheduler.yield', feature, fallback: 'setTimeout' })\n    }\n    return new Promise((resolve) => setTimeout(resolve, 0))\n  }\n\n  async function drive(task: Task) {\n    while (task.state === 'running') {\n      await pause(task.feature)\n      if (task.state !== 'running') return\n      const start = now()\n      advance(task, start + SLICE_MS)\n      host.timed?.(task.feature, now() - start)\n    }\n    running.delete(task)\n    host.done(task.trigger)\n  }\n\n  function result(task: Task): unknown {\n    if (task.state === 'failed') throw task.value\n    return task.state === 'done' ? task.value : undefined\n  }\n\n  return {\n    run<R>(key: object, job: SliceJob<R>, feature: string): R | undefined {\n      const known = tasks.get(key)\n      if (known && known.state !== 'cancelled') {\n        asked?.add(known)\n        return result(known) as R | undefined\n      }\n      const task: Task = {\n        key,\n        it: job(),\n        trigger: host.trigger(),\n        feature,\n        state: 'running',\n        value: undefined,\n      }\n      tasks.set(key, task)\n      advance(task, host.enabled() ? now() + SLICE_MS : Number.POSITIVE_INFINITY)\n      if (task.state === 'running') {\n        running.add(task)\n        asked?.add(task)\n        // `drive` never rejects: `advance` catches the job's errors, `done` is the table's.\n        void drive(task).catch(() => {})\n      }\n      return result(task) as R | undefined\n    },\n    begin() {\n      asked = new Set()\n    },\n    end() {\n      const keep = asked\n      asked = undefined\n      if (!keep) return\n      for (const task of running) {\n        if (keep.has(task)) continue\n        task.state = 'cancelled'\n        running.delete(task)\n        tasks.delete(task.key)\n      }\n    },\n    cancel() {\n      for (const task of running) {\n        task.state = 'cancelled'\n        tasks.delete(task.key)\n      }\n      running.clear()\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/schema.d.cts

@@ -1,5 +1,5 @@
-import { S as StandardSchemaV1, e as TableSchema } from './codes-BKdS9EiO.cjs';
-export { q as DatakableSchemaError, h as InvalidRow, I as InvalidRowsMode, C as SCHEMA_INGEST, H as SchemaIssueColumn, J as SchemaOutcome, ad as isStandardSchema, am as schemaDiagnostics } from './codes-BKdS9EiO.cjs';
+import { S as StandardSchemaV1, e as TableSchema } from './codes-B9bCK73-.cjs';
+export { q as DatakableSchemaError, h as InvalidRow, I as InvalidRowsMode, C as SCHEMA_INGEST, H as SchemaIssueColumn, J as SchemaOutcome, ad as isStandardSchema, am as schemaDiagnostics } from './codes-B9bCK73-.cjs';
 
 /**
  * Opts a Standard Schema v1 (zod, valibot, arktype, …) into table validation (§5.1):

package/dist/schema.d.ts

@@ -1,5 +1,5 @@
-import { S as StandardSchemaV1, e as TableSchema } from './codes-BKdS9EiO.js';
-export { q as DatakableSchemaError, h as InvalidRow, I as InvalidRowsMode, C as SCHEMA_INGEST, H as SchemaIssueColumn, J as SchemaOutcome, ad as isStandardSchema, am as schemaDiagnostics } from './codes-BKdS9EiO.js';
+import { S as StandardSchemaV1, e as TableSchema } from './codes-B9bCK73-.js';
+export { q as DatakableSchemaError, h as InvalidRow, I as InvalidRowsMode, C as SCHEMA_INGEST, H as SchemaIssueColumn, J as SchemaOutcome, ad as isStandardSchema, am as schemaDiagnostics } from './codes-B9bCK73-.js';
 
 /**
  * Opts a Standard Schema v1 (zod, valibot, arktype, …) into table validation (§5.1):

package/dist/{search-async-entry-C3mXxLP8.d.cts → search-async-entry-CuLYPfY_.d.cts}

@@ -1,5 +1,5 @@
-import { i as RowKey } from './codes-BKdS9EiO.cjs';
-import { R as RowModelContext, c as FeatureContext } from './explain-aagaYHcy.cjs';
+import { i as RowKey } from './codes-B9bCK73-.cjs';
+import { R as RowModelContext, c as FeatureContext } from './explain-Q8Cg0cZy.cjs';
 
 /** What `setSearch` / `flushSearch` resolve to; they never reject. */
 interface SearchOutcome {

package/dist/{search-async-entry-BmQYT120.d.ts → search-async-entry-Cx7xpuVZ.d.ts}

@@ -1,5 +1,5 @@
-import { i as RowKey } from './codes-BKdS9EiO.js';
-import { R as RowModelContext, c as FeatureContext } from './explain-DcUZfFh5.js';
+import { i as RowKey } from './codes-B9bCK73-.js';
+import { R as RowModelContext, c as FeatureContext } from './explain-i0OATi_W.js';
 
 /** What `setSearch` / `flushSearch` resolve to; they never reject. */
 interface SearchOutcome {

package/dist/search-async.d.cts

@@ -1,3 +1,3 @@
-export { ap as searchDiagnostics } from './codes-BKdS9EiO.cjs';
-export { A as AsyncSearchFn, a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, w as withSearchFn } from './search-async-entry-C3mXxLP8.cjs';
-import './explain-aagaYHcy.cjs';
+export { ap as searchDiagnostics } from './codes-B9bCK73-.cjs';
+export { A as AsyncSearchFn, a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, w as withSearchFn } from './search-async-entry-CuLYPfY_.cjs';
+import './explain-Q8Cg0cZy.cjs';

package/dist/search-async.d.ts

@@ -1,3 +1,3 @@
-export { ap as searchDiagnostics } from './codes-BKdS9EiO.js';
-export { A as AsyncSearchFn, a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, w as withSearchFn } from './search-async-entry-BmQYT120.js';
-import './explain-DcUZfFh5.js';
+export { ap as searchDiagnostics } from './codes-B9bCK73-.js';
+export { A as AsyncSearchFn, a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, w as withSearchFn } from './search-async-entry-Cx7xpuVZ.js';
+import './explain-i0OATi_W.js';

package/dist/search.d.cts

@@ -1,8 +1,8 @@
-export { ap as searchDiagnostics } from './codes-BKdS9EiO.cjs';
-import { d as AnyRow, F as Feature, b as FixedTypes } from './explain-aagaYHcy.cjs';
+export { ap as searchDiagnostics } from './codes-B9bCK73-.cjs';
+import { d as AnyRow, F as Feature, b as FixedTypes } from './explain-Q8Cg0cZy.cjs';
 import { a as DataMode } from './mode-DFV8ryXo.cjs';
-import { d as SearchOutcome, A as AsyncSearchFn, S as SearchState } from './search-async-entry-C3mXxLP8.cjs';
-export { a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, f as SearchStatus, w as withSearchFn } from './search-async-entry-C3mXxLP8.cjs';
+import { d as SearchOutcome, A as AsyncSearchFn, S as SearchState } from './search-async-entry-CuLYPfY_.cjs';
+export { a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, f as SearchStatus, w as withSearchFn } from './search-async-entry-CuLYPfY_.cjs';
 
 interface SearchApi {
     /** Sets `input` (and `query`, with the client's immediate typing strategy). */
@@ -33,7 +33,8 @@ interface SearchTyping {
     wait?: SearchWait;
     /**
      * Debounce only. `'trailing'` (default): apply after the burst. `'leading'`: apply the first
-     * keystroke at once and drop the rest of the burst (`flushSearch()` applies them).
+     * keystroke at once and drop the rest of the burst (`flushSearch()` applies them; otherwise
+     * their `setSearch()` promises resolve `'superseded'` when the silence window ends).
      */
     behavior?: 'trailing' | 'leading';
     /** A trimmed input shorter than this is applied as an empty query (all rows). Default 0. */
@@ -70,7 +71,8 @@ interface SearchOptions<T = AnyRow> {
 }
 /**
  * Global search (§6.3), client mode: fuzzy matching with `ex-search` on the formatted values of the
- * searchable columns (`search: weight`; every column at weight 1 when none declares one).
+ * searchable columns (`search: weight`; when none declares one, every column of primitives at
+ * weight 1, #27).
  *
  * - The matcher is built on the first non-blank query, once per data + columns (not per keystroke),
  *   over the column cache's values; ex-search reads the projection `{ i, c0, c1, … }` one chunk of

package/dist/search.d.ts

@@ -1,8 +1,8 @@
-export { ap as searchDiagnostics } from './codes-BKdS9EiO.js';
-import { d as AnyRow, F as Feature, b as FixedTypes } from './explain-DcUZfFh5.js';
+export { ap as searchDiagnostics } from './codes-B9bCK73-.js';
+import { d as AnyRow, F as Feature, b as FixedTypes } from './explain-i0OATi_W.js';
 import { a as DataMode } from './mode-DFV8ryXo.js';
-import { d as SearchOutcome, A as AsyncSearchFn, S as SearchState } from './search-async-entry-BmQYT120.js';
-export { a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, f as SearchStatus, w as withSearchFn } from './search-async-entry-BmQYT120.js';
+import { d as SearchOutcome, A as AsyncSearchFn, S as SearchState } from './search-async-entry-Cx7xpuVZ.js';
+export { a as SEARCH_ENGINE, b as SearchFn, c as SearchFnContext, e as SearchResult, f as SearchStatus, w as withSearchFn } from './search-async-entry-Cx7xpuVZ.js';
 
 interface SearchApi {
     /** Sets `input` (and `query`, with the client's immediate typing strategy). */
@@ -33,7 +33,8 @@ interface SearchTyping {
     wait?: SearchWait;
     /**
      * Debounce only. `'trailing'` (default): apply after the burst. `'leading'`: apply the first
-     * keystroke at once and drop the rest of the burst (`flushSearch()` applies them).
+     * keystroke at once and drop the rest of the burst (`flushSearch()` applies them; otherwise
+     * their `setSearch()` promises resolve `'superseded'` when the silence window ends).
      */
     behavior?: 'trailing' | 'leading';
     /** A trimmed input shorter than this is applied as an empty query (all rows). Default 0. */
@@ -70,7 +71,8 @@ interface SearchOptions<T = AnyRow> {
 }
 /**
  * Global search (§6.3), client mode: fuzzy matching with `ex-search` on the formatted values of the
- * searchable columns (`search: weight`; every column at weight 1 when none declares one).
+ * searchable columns (`search: weight`; when none declares one, every column of primitives at
+ * weight 1, #27).
  *
  * - The matcher is built on the first non-blank query, once per data + columns (not per keystroke),
  *   over the column cache's values; ex-search reads the projection `{ i, c0, c1, … }` one chunk of

package/dist/server.d.cts

@@ -1,6 +1,6 @@
-import { a as Interceptor, D as Fetcher, i as ServerFetcher } from './explain-aagaYHcy.cjs';
-export { x as FetchOutcome, y as FetchParams, z as FetchResult, ab as SERVER_SOURCE } from './explain-aagaYHcy.cjs';
-export { B as BadResponse, N as asyncDiagnostics, a4 as fetchDiagnostics } from './codes-BKdS9EiO.cjs';
+import { a as Interceptor, D as Fetcher, i as ServerFetcher } from './explain-Q8Cg0cZy.cjs';
+export { x as FetchOutcome, y as FetchParams, z as FetchResult, ab as SERVER_SOURCE } from './explain-Q8Cg0cZy.cjs';
+export { B as BadResponse, N as asyncDiagnostics, a4 as fetchDiagnostics } from './codes-B9bCK73-.cjs';
 
 /** Spec §7.1: a request that has not settled after 30 s is aborted (`DK_ASYNC_TIMEOUT`). */
 declare const DEFAULT_ASYNC_TIMEOUT = 30000;

package/dist/server.d.ts

@@ -1,6 +1,6 @@
-import { a as Interceptor, D as Fetcher, i as ServerFetcher } from './explain-DcUZfFh5.js';
-export { x as FetchOutcome, y as FetchParams, z as FetchResult, ab as SERVER_SOURCE } from './explain-DcUZfFh5.js';
-export { B as BadResponse, N as asyncDiagnostics, a4 as fetchDiagnostics } from './codes-BKdS9EiO.js';
+import { a as Interceptor, D as Fetcher, i as ServerFetcher } from './explain-i0OATi_W.js';
+export { x as FetchOutcome, y as FetchParams, z as FetchResult, ab as SERVER_SOURCE } from './explain-i0OATi_W.js';
+export { B as BadResponse, N as asyncDiagnostics, a4 as fetchDiagnostics } from './codes-B9bCK73-.js';
 
 /** Spec §7.1: a request that has not settled after 30 s is aborted (`DK_ASYNC_TIMEOUT`). */
 declare const DEFAULT_ASYNC_TIMEOUT = 30000;

package/dist/sorting.d.cts

@@ -1,5 +1,5 @@
-export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-BKdS9EiO.cjs';
-import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-aagaYHcy.cjs';
+export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-B9bCK73-.cjs';
+import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-Q8Cg0cZy.cjs';
 import { a as DataMode } from './mode-DFV8ryXo.cjs';
 
 /** The rank of `v` in {@link RANK}. */
@@ -47,7 +47,10 @@ interface SortingTypes extends FeatureTypes {
  */
 type SortAlgorithmOption = SortAlgorithm;
 interface SortingOptions {
-    /** Locale(s) of the string collator (`Intl.Collator(locale, { numeric: true })`); default: the runtime's. */
+    /**
+     * Locale(s) of the string collator (`Intl.Collator(locale, { numeric: true })`). Default `'en'`,
+     * not the runtime's: the server and the browser must sort alike (SSR hydration, #12).
+     */
     locale?: string | readonly string[];
     /** The sort algorithm (default `'auto'`); a column's `sortAlgorithm` takes precedence. */
     algorithm?: SortAlgorithmOption;

package/dist/sorting.d.ts

@@ -1,5 +1,5 @@
-export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-BKdS9EiO.js';
-import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-DcUZfFh5.js';
+export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-B9bCK73-.js';
+import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-i0OATi_W.js';
 import { a as DataMode } from './mode-DFV8ryXo.js';
 
 /** The rank of `v` in {@link RANK}. */
@@ -47,7 +47,10 @@ interface SortingTypes extends FeatureTypes {
  */
 type SortAlgorithmOption = SortAlgorithm;
 interface SortingOptions {
-    /** Locale(s) of the string collator (`Intl.Collator(locale, { numeric: true })`); default: the runtime's. */
+    /**
+     * Locale(s) of the string collator (`Intl.Collator(locale, { numeric: true })`). Default `'en'`,
+     * not the runtime's: the server and the browser must sort alike (SSR hydration, #12).
+     */
     locale?: string | readonly string[];
     /** The sort algorithm (default `'auto'`); a column's `sortAlgorithm` takes precedence. */
     algorithm?: SortAlgorithmOption;

package/dist/source/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 asyncMessages = {
   DK_ASYNC_TIMEOUT: {
     problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,

package/dist/source/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAcnD,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAcA,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/source/codes.js

@@ -1,5 +1,6 @@
 // src/source/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var asyncMessages = {
   DK_ASYNC_TIMEOUT: {
     problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,

package/dist/source/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAcnD,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAcA,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/source/fetch-codes.cjs

@@ -25,6 +25,7 @@ __export(fetch_codes_exports, {
 });
 module.exports = __toCommonJS(fetch_codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var BAD = {
   "not-an-object": (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,
   "rows-not-an-array": (d) => `fetcher result.rows is ${d.received}, not an array`,