@datakable/core 1.0.1 → 2.0.0

package/dist/pipeline/column-cache.js

@@ -3,24 +3,39 @@ import { describeReturn, expectedReturn, formatSlot, slotDiagnostics } from "../
 import { defaultFormat } from "../column/format.js";
 import { getValue } from "../column/get-value.js";
 import { keepDiagnostics } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 import { CellFailures, runCells } from "../intercept/cell-batch.js";
 import { createContextPool } from "../intercept/context.js";
 import { pipelineDiagnostics } from "./codes.js";
 import { allRows } from "./indices.js";
+import { runJob } from "./slice.js";
 keepDiagnostics(pipelineDiagnostics, slotDiagnostics);
 var NULL = 1;
 var UNDEFINED = 2;
+var nullishKinds = /* @__PURE__ */ new WeakMap();
+function nullishOf(values) {
+  return nullishKinds.get(values);
+}
 function allStrings(values) {
   for (let i = 0; i < values.length; i++) if (typeof values[i] !== "string") return false;
   return true;
 }
 var typeName = (v) => Array.isArray(v) ? "array" : typeof v;
+var STEP = 512;
+var SHARED = 1024;
+function share(cells) {
+  const seen = /* @__PURE__ */ new Map();
+  for (let r = 0; r < cells.length; r++) {
+    const s = cells[r];
+    const hit = seen.get(s);
+    if (hit !== void 0) cells[r] = hit;
+    else if (seen.size < SHARED) seen.set(s, s);
+  }
+}
 function createColumnCache(host) {
   const byData = /* @__PURE__ */ new WeakMap();
   const pool = createContextPool();
   const failures = new CellFailures();
-  const unrenderable = new CellFailures();
-  const badReturns = new CellFailures();
   function entry(data, column) {
     let cols = byData.get(data);
     if (!cols) {
@@ -47,8 +62,6 @@ function createColumnCache(host) {
           body();
         } finally {
           failures.reset();
-          unrenderable.reset();
-          badReturns.reset();
         }
       });
     } finally {
@@ -104,6 +117,7 @@ function createColumnCache(host) {
       }
     }
     e.nullish = kinds;
+    if (kinds) nullishKinds.set(out, kinds);
     return out;
   }
   const flags = host.flags;
@@ -118,14 +132,15 @@ function createColumnCache(host) {
     if (flags && flags.count > before) e.flaggedValues = true;
     return e.values;
   }
-  function formatted(data, column) {
-    const e = entry(data, column);
+  function* formatting(data, column, sliced) {
+    let e = entry(data, column);
     if (e.formatted) {
       if (flags && e.flaggedFormatted) flags.count++;
       return e.formatted;
     }
     const before = flags?.count ?? 0;
     const vals = values(data, column);
+    if (sliced) yield;
     const kinds = e.nullish;
     const valueAt = (r) => {
       const k = kinds?.[r];
@@ -133,80 +148,82 @@ function createColumnCache(host) {
     };
     const n = data.length;
     const rows = allRows(data);
-    let out;
     const format = column.format;
-    batch(column, "format", "format", rows, () => {
-      if (!format && !(vals instanceof Float64Array) && allStrings(vals)) {
-        out = vals;
-        return;
-      }
-      const cells = new Array(n).fill("");
-      out = cells;
-      if (format) {
-        let firstBad;
-        runCells(
-          rows,
-          (r) => {
-            const s = format(valueAt(r));
-            if (typeof s === "string") return s;
-            if (process.env.NODE_ENV !== "production") {
-              if (badReturns.count === 0) firstBad = s;
-              badReturns.add(r, void 0);
-            }
-            return defaultFormat(s);
-          },
-          cells,
-          "",
-          failures
-        );
-        failures.report(host.emit, column.index, column.id, "format");
-        if (process.env.NODE_ENV !== "production" && badReturns.count > 0) {
-          host.emit("DK_CALLBACK_BAD_RETURN", {
-            slot: `columns[${column.index}].format`,
-            column: column.id,
-            expected: expectedReturn(formatSlot),
-            received: describeReturn(firstBad),
-            count: badReturns.count,
-            rows: Array.from(badReturns.sample()),
-            fallback: formatSlot.fallback
-          });
-        }
-        return;
-      }
-      let cur = 0;
-      let firstType = "";
-      const onUnrenderable = column.hasCell ? void 0 : (v) => {
-        if (unrenderable.count === 0) firstType = typeName(v);
-        unrenderable.add(cur, void 0);
-      };
-      runCells(
-        rows,
-        (r) => {
-          cur = r;
-          return defaultFormat(valueAt(r), onUnrenderable);
-        },
-        cells,
-        "",
-        failures
-      );
-      failures.report(host.emit, column.index, column.id, "format");
-      if (unrenderable.count > 0) {
-        host.emit("DK_UNRENDERABLE_VALUE", {
-          column: column.id,
-          index: column.index,
-          count: unrenderable.count,
-          rows: Array.from(unrenderable.sample()),
-          valueType: firstType
-        });
+    const failed = new CellFailures();
+    const bad = process.env.NODE_ENV !== "production" ? new CellFailures() : void 0;
+    const unrendered = new CellFailures();
+    let firstBad;
+    let firstType = "";
+    let cur = 0;
+    const onUnrenderable = column.hasCell ? void 0 : (v) => {
+      if (unrendered.count === 0) firstType = typeName(v);
+      unrendered.add(cur, void 0);
+    };
+    const cell = format ? (r) => {
+      const s = format(valueAt(r));
+      if (typeof s === "string") return s;
+      if (process.env.NODE_ENV !== "production" && bad) {
+        if (bad.count === 0) firstBad = s;
+        bad.add(r, void 0);
       }
-    });
-    e.formatted = out ?? new Array(n).fill("");
-    if (flags && flags.count > before) e.flaggedFormatted = true;
+      return defaultFormat(s);
+    } : (r) => {
+      cur = r;
+      return defaultFormat(valueAt(r), onUnrenderable);
+    };
+    const strings = !format && !(vals instanceof Float64Array) && allStrings(vals);
+    let out = strings ? void 0 : new Array(n).fill("");
+    for (let from = 0; from < n; from += STEP) {
+      const part = sliced && !strings ? rows.subarray(from, from + STEP) : rows;
+      batch(column, "format", "format", part, () => {
+        if (strings) out = vals;
+        else runCells(part, cell, out, "", failed);
+      });
+      if (part === rows || from + STEP >= n) break;
+      yield;
+    }
+    out ??= new Array(n).fill("");
+    failed.report(host.emit, column.index, column.id, "format");
+    if (process.env.NODE_ENV !== "production" && bad && bad.count > 0) {
+      host.emit("DK_CALLBACK_BAD_RETURN", {
+        slot: `columns[${column.index}].format`,
+        column: column.id,
+        expected: expectedReturn(formatSlot),
+        received: describeReturn(firstBad),
+        count: bad.count,
+        rows: Array.from(bad.sample()),
+        fallback: formatSlot.fallback
+      });
+    }
+    if (unrendered.count > 0) {
+      host.emit("DK_UNRENDERABLE_VALUE", {
+        column: column.id,
+        index: column.index,
+        count: unrendered.count,
+        rows: Array.from(unrendered.sample()),
+        valueType: firstType
+      });
+    }
+    if (out !== vals) share(out);
+    e = entry(data, column);
+    if (!e.formatted) {
+      e.formatted = out;
+      if (flags && flags.count > before) e.flaggedFormatted = true;
+    }
     return e.formatted;
   }
-  return { values, formatted, batch };
+  function formatted(data, column) {
+    return runJob(() => formatting(data, column, false));
+  }
+  return {
+    values,
+    formatted,
+    formattedSliced: (data, column) => formatting(data, column, true),
+    batch
+  };
 }
 export {
-  createColumnCache
+  createColumnCache,
+  nullishOf
 };
 //# sourceMappingURL=column-cache.js.map

package/dist/pipeline/column-cache.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/column-cache.ts"],"sourcesContent":["import { describeReturn, expectedReturn, formatSlot, slotDiagnostics } from '../catalog/slots'\nimport { defaultFormat } from '../column/format'\nimport { getValue } from '../column/get-value'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport { CellFailures, type CellSlot, runCells } from '../intercept/cell-batch'\nimport { type ContextBase, createContextPool } from '../intercept/context'\nimport type { InterceptorRuntime } from '../intercept/runtime'\nimport { pipelineDiagnostics } from './codes'\nimport type { ColumnLike, ResolvedColumn } from './columns'\nimport { allRows } from './indices'\nimport type { ColumnValues } from './types'\n\nkeepDiagnostics(pipelineDiagnostics, slotDiagnostics)\n\nexport interface ColumnCacheHost {\n  readonly runtime: InterceptorRuntime\n  readonly emit: Emit\n  base(): ContextBase\n  /**\n   * The §6.6 status rule's counter (pipeline/status-rule.ts): `emit` increments it for a diagnostic\n   * the rule counts. An entry whose read incremented it is flagged, and every later read of that\n   * entry increments it again (its cells still hold the fallback values).\n   */\n  readonly flags?: { count: number }\n}\n\nexport interface ColumnCache {\n  /**\n   * The values of `column` for every row of `data` (index = row index). An all-number column is a\n   * `Float64Array` with `NaN` for `null` / `undefined`; any other column a plain array.\n   */\n  values(data: readonly unknown[], column: ResolvedColumn): ColumnValues\n  /** `format` (or the default formatter) applied to {@link values}: what the user sees. */\n  formatted(data: readonly unknown[], column: ResolvedColumn): readonly string[]\n  /**\n   * Runs `body` as one `column:batch` over `rows` (pooled ctx, `where` = `columns[i].<field>`):\n   * interceptors see one dispatch per column, never one per cell. `body` loops over the cells\n   * with an inline `try/catch` and reports its own failures.\n   */\n  batch(\n    column: ResolvedColumn,\n    slot: CellSlot,\n    field: string,\n    rows: Uint32Array,\n    body: () => void,\n  ): void\n}\n\ninterface Entry {\n  values?: ColumnValues\n  /** Numeric columns: 1 = `null`, 2 = `undefined` per row. Absent when there are none. */\n  nullish?: Uint8Array | undefined\n  formatted?: readonly string[]\n  /** Reading `values` / `formatted` reported a diagnostic the status rule counts. */\n  flaggedValues?: boolean\n  flaggedFormatted?: boolean\n}\n\nconst NULL = 1\nconst UNDEFINED = 2\n\nfunction allStrings(values: readonly unknown[]): boolean {\n  for (let i = 0; i < values.length; i++) if (typeof values[i] !== 'string') return false\n  return true\n}\n\nconst typeName = (v: unknown) => (Array.isArray(v) ? 'array' : typeof v)\n\n/**\n * The lazy column cache (§9.1): a column is read only when a step asks for it, once per data\n * reference, in one `column:batch` per column (never per cell, §3.4). Entries live in a `WeakMap`\n * keyed by the data reference, then by the column definition, so new data or a changed column\n * releases them.\n */\nexport function createColumnCache(host: ColumnCacheHost): ColumnCache {\n  const byData = new WeakMap<readonly unknown[], WeakMap<ColumnLike, Entry>>()\n  const pool = createContextPool()\n  const failures = new CellFailures()\n  const unrenderable = new CellFailures()\n  /** Dev: `format` returns that broke the slot contract (`first` = the first bad value). */\n  const badReturns = new CellFailures()\n\n  function entry(data: readonly unknown[], column: ResolvedColumn): Entry {\n    let cols = byData.get(data)\n    if (!cols) {\n      cols = new WeakMap()\n      byData.set(data, cols)\n    }\n    let e = cols.get(column.def)\n    if (!e) {\n      e = {}\n      cols.set(column.def, e)\n    }\n    return e\n  }\n\n  /** One `column:batch` (pooled ctx); `where` = `columns[i].<field>`, never row data. */\n  function batch(\n    column: ResolvedColumn,\n    slot: CellSlot,\n    field: string,\n    rows: Uint32Array,\n    body: () => void,\n  ) {\n    const ctx = pool.acquire(\n      'column:batch',\n      { column: column.id, slot, rows },\n      `columns[${column.index}].${field}`,\n      host.base(),\n    )\n    try {\n      void host.runtime.run('column:batch', ctx, (): undefined => {\n        try {\n          body()\n        } finally {\n          failures.reset()\n          unrenderable.reset()\n          badReturns.reset()\n        }\n      })\n    } finally {\n      pool.release(ctx)\n    }\n  }\n\n  function readValues(data: readonly unknown[], column: ResolvedColumn, e: Entry): ColumnValues {\n    const n = data.length\n    const rows = allRows(data)\n    const out: unknown[] = new Array(n).fill(undefined)\n    const field = column.path ? 'key' : 'accessor'\n    batch(column, 'accessor', field, rows, () => {\n      const path = column.path\n      const accessor = column.accessor\n      if (path) {\n        let cur = 0\n        const onError = (error: unknown) => failures.add(cur, error)\n        runCells(\n          rows,\n          (r) => {\n            cur = r\n            return getValue(data[r], path, onError)\n          },\n          out,\n          undefined,\n          failures,\n        )\n      } else if (accessor) {\n        runCells(rows, (r) => accessor(data[r]), out, undefined, failures)\n      }\n      failures.report(host.emit, column.index, column.id, 'accessor', undefined, field)\n    })\n    return toNumeric(out, e) ?? out\n  }\n\n  /** A `Float64Array` when every non-nullish value is a number (and there is one); else nothing. */\n  function toNumeric(values: unknown[], e: Entry): Float64Array | undefined {\n    let numbers = 0\n    let nullish = 0\n    for (let i = 0; i < values.length; i++) {\n      const v = values[i]\n      if (typeof v === 'number') numbers++\n      else if (v === null || v === undefined) nullish++\n      else return undefined\n    }\n    if (numbers === 0) return undefined\n    const out = new Float64Array(values.length)\n    const kinds = nullish > 0 ? new Uint8Array(values.length) : undefined\n    for (let i = 0; i < values.length; i++) {\n      const v = values[i]\n      if (typeof v === 'number') out[i] = v\n      else {\n        out[i] = Number.NaN\n        if (kinds) kinds[i] = v === null ? NULL : UNDEFINED\n      }\n    }\n    e.nullish = kinds\n    return out\n  }\n\n  const flags = host.flags\n\n  function values(data: readonly unknown[], column: ResolvedColumn): ColumnValues {\n    const e = entry(data, column)\n    if (e.values) {\n      if (flags && e.flaggedValues) flags.count++\n      return e.values\n    }\n    const before = flags?.count ?? 0\n    e.values = readValues(data, column, e)\n    if (flags && flags.count > before) e.flaggedValues = true\n    return e.values\n  }\n\n  function formatted(data: readonly unknown[], column: ResolvedColumn): readonly string[] {\n    const e = entry(data, column)\n    if (e.formatted) {\n      if (flags && e.flaggedFormatted) flags.count++\n      return e.formatted\n    }\n    const before = flags?.count ?? 0\n    const vals = values(data, column)\n    const kinds = e.nullish\n    // The raw value: nullish numbers read back as null / undefined, not NaN.\n    const valueAt = (r: number): unknown => {\n      const k = kinds?.[r]\n      return k ? (k === NULL ? null : undefined) : vals[r]\n    }\n    const n = data.length\n    const rows = allRows(data)\n    let out: string[] | undefined\n    const format = column.format\n    batch(column, 'format', 'format', rows, () => {\n      // Values that are all strings already format to themselves: no copy (§9.3 memory).\n      if (!format && !(vals instanceof Float64Array) && allStrings(vals)) {\n        out = vals as string[]\n        return\n      }\n      const cells: string[] = new Array(n).fill('')\n      out = cells\n      if (format) {\n        let firstBad: unknown\n        runCells(\n          rows,\n          (r) => {\n            const s = format(valueAt(r))\n            if (typeof s === 'string') return s\n            // Slot contract (dev): counted only on this non-string path; coerced either way.\n            if ((process.env.NODE_ENV !== \"production\")) {\n              if (badReturns.count === 0) firstBad = s\n              badReturns.add(r, undefined)\n            }\n            return defaultFormat(s)\n          },\n          cells,\n          '',\n          failures,\n        )\n        failures.report(host.emit, column.index, column.id, 'format')\n        if ((process.env.NODE_ENV !== \"production\") && badReturns.count > 0) {\n          host.emit('DK_CALLBACK_BAD_RETURN', {\n            slot: `columns[${column.index}].format`,\n            column: column.id,\n            expected: expectedReturn(formatSlot),\n            received: describeReturn(firstBad),\n            count: badReturns.count,\n            rows: Array.from(badReturns.sample()),\n            fallback: formatSlot.fallback,\n          })\n        }\n        return\n      }\n      let cur = 0\n      let firstType = ''\n      // A column with `cell` renders itself: its formatted value only feeds search.\n      const onUnrenderable = column.hasCell\n        ? undefined\n        : (v: unknown) => {\n            if (unrenderable.count === 0) firstType = typeName(v)\n            unrenderable.add(cur, undefined)\n          }\n      runCells(\n        rows,\n        (r) => {\n          cur = r\n          return defaultFormat(valueAt(r), onUnrenderable)\n        },\n        cells,\n        '',\n        failures,\n      )\n      failures.report(host.emit, column.index, column.id, 'format')\n      if (unrenderable.count > 0) {\n        host.emit('DK_UNRENDERABLE_VALUE', {\n          column: column.id,\n          index: column.index,\n          count: unrenderable.count,\n          rows: Array.from(unrenderable.sample()),\n          valueType: firstType,\n        })\n      }\n    })\n    // An interceptor skipped the batch: every cell is the slot fallback.\n    e.formatted = out ?? new Array<string>(n).fill('')\n    if (flags && flags.count > before) e.flaggedFormatted = true\n    return e.formatted\n  }\n\n  return { values, formatted, batch }\n}\n"],"mappings":"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","names":["values"]}
+{"version":3,"sources":["../../src/pipeline/column-cache.ts"],"sourcesContent":["import { describeReturn, expectedReturn, formatSlot, slotDiagnostics } from '../catalog/slots'\nimport { defaultFormat } from '../column/format'\nimport { getValue } from '../column/get-value'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Emit } from '../diagnostics/types'\nimport { CellFailures, type CellSlot, runCells } from '../intercept/cell-batch'\nimport { type ContextBase, createContextPool } from '../intercept/context'\nimport type { InterceptorRuntime } from '../intercept/runtime'\nimport { pipelineDiagnostics } from './codes'\nimport type { ColumnLike, ResolvedColumn } from './columns'\nimport { allRows } from './indices'\nimport { runJob } from './slice'\nimport type { ColumnValues } from './types'\n\nkeepDiagnostics(pipelineDiagnostics, slotDiagnostics)\n\nexport interface ColumnCacheHost {\n  readonly runtime: InterceptorRuntime\n  readonly emit: Emit\n  base(): ContextBase\n  /**\n   * The §6.6 status rule's counter (pipeline/status-rule.ts): `emit` increments it for a diagnostic\n   * the rule counts. An entry whose read incremented it is flagged, and every later read of that\n   * entry increments it again (its cells still hold the fallback values).\n   */\n  readonly flags?: { count: number }\n}\n\n/**\n * Internal member of the pipeline's run context (not on the public `RowModelContext`): a column's\n * formatted values as a time-sliced job (search, #40); `undefined` for an unknown column.\n */\nexport interface SlicedFormatting {\n  readonly formattedSliced?: (\n    id: string,\n  ) => Generator<undefined, readonly string[] | undefined, undefined>\n}\n\nexport interface ColumnCache {\n  /**\n   * The values of `column` for every row of `data` (index = row index). An all-number column is a\n   * `Float64Array` with `NaN` for `null` / `undefined`; any other column a plain array.\n   */\n  values(data: readonly unknown[], column: ResolvedColumn): ColumnValues\n  /** `format` (or the default formatter) applied to {@link values}: what the user sees. */\n  formatted(data: readonly unknown[], column: ResolvedColumn): readonly string[]\n  /**\n   * {@link formatted} as a time-sliced job (§9.1, #40): the cells are formatted in batches of a few\n   * milliseconds with a `yield` between them (one `column:batch` per batch, never per cell).\n   */\n  formattedSliced(\n    data: readonly unknown[],\n    column: ResolvedColumn,\n  ): Generator<undefined, readonly string[], undefined>\n  /**\n   * Runs `body` as one `column:batch` over `rows` (pooled ctx, `where` = `columns[i].<field>`):\n   * interceptors see one dispatch per column, never one per cell. `body` loops over the cells\n   * with an inline `try/catch` and reports its own failures.\n   */\n  batch(\n    column: ResolvedColumn,\n    slot: CellSlot,\n    field: string,\n    rows: Uint32Array,\n    body: () => void,\n  ): void\n}\n\ninterface Entry {\n  values?: ColumnValues\n  /** Numeric columns: 1 = `null`, 2 = `undefined` per row. Absent when there are none. */\n  nullish?: Uint8Array | undefined\n  formatted?: readonly string[]\n  /** Reading `values` / `formatted` reported a diagnostic the status rule counts. */\n  flaggedValues?: boolean\n  flaggedFormatted?: boolean\n}\n\nconst NULL = 1\nconst UNDEFINED = 2\n\n/** The nullish kinds of each cached numeric column that has any (see {@link nullishOf}). */\nconst nullishKinds = new WeakMap<Float64Array, Uint8Array>()\n\n/**\n * Which rows of a cached all-number column (`values` from the column cache) hold `null` /\n * `undefined` (non-zero) rather than a real `NaN`: both are stored as `NaN`. `undefined` when no\n * row does. Lets search format such a column on the fly (`''` / `'NaN'`) instead of caching a\n * string per row (#27).\n */\nexport function nullishOf(values: Float64Array): Uint8Array | undefined {\n  return nullishKinds.get(values)\n}\n\nfunction allStrings(values: readonly unknown[]): boolean {\n  for (let i = 0; i < values.length; i++) if (typeof values[i] !== 'string') return false\n  return true\n}\n\nconst typeName = (v: unknown) => (Array.isArray(v) ? 'array' : typeof v)\n\n/** Rows per batch of a sliced format (#40): small, so the slicer's clock check comes often. */\nconst STEP = 512\n\n/** Distinct strings {@link share} remembers per column: enough for categories, tags, flags. */\nconst SHARED = 1024\n\n/**\n * Repeated formatted strings of a column share one copy (§9.3 memory, #27): each formatted cell is\n * a fresh string, so a column of tags or categories would keep one per row. Only the first\n * {@link SHARED} distinct strings are remembered; once per column, after formatting.\n */\nfunction share(cells: string[]) {\n  const seen = new Map<string, string>()\n  for (let r = 0; r < cells.length; r++) {\n    const s = cells[r] as string\n    const hit = seen.get(s)\n    if (hit !== undefined) cells[r] = hit\n    else if (seen.size < SHARED) seen.set(s, s)\n  }\n}\n\n/**\n * The lazy column cache (§9.1): a column is read only when a step asks for it, once per data\n * reference, in one `column:batch` per column (never per cell, §3.4). Entries live in a `WeakMap`\n * keyed by the data reference, then by the column definition, so new data or a changed column\n * releases them.\n */\nexport function createColumnCache(host: ColumnCacheHost): ColumnCache {\n  const byData = new WeakMap<readonly unknown[], WeakMap<ColumnLike, Entry>>()\n  const pool = createContextPool()\n  const failures = new CellFailures()\n\n  function entry(data: readonly unknown[], column: ResolvedColumn): Entry {\n    let cols = byData.get(data)\n    if (!cols) {\n      cols = new WeakMap()\n      byData.set(data, cols)\n    }\n    let e = cols.get(column.def)\n    if (!e) {\n      e = {}\n      cols.set(column.def, e)\n    }\n    return e\n  }\n\n  /** One `column:batch` (pooled ctx); `where` = `columns[i].<field>`, never row data. */\n  function batch(\n    column: ResolvedColumn,\n    slot: CellSlot,\n    field: string,\n    rows: Uint32Array,\n    body: () => void,\n  ) {\n    const ctx = pool.acquire(\n      'column:batch',\n      { column: column.id, slot, rows },\n      `columns[${column.index}].${field}`,\n      host.base(),\n    )\n    try {\n      void host.runtime.run('column:batch', ctx, (): undefined => {\n        try {\n          body()\n        } finally {\n          failures.reset()\n        }\n      })\n    } finally {\n      pool.release(ctx)\n    }\n  }\n\n  function readValues(data: readonly unknown[], column: ResolvedColumn, e: Entry): ColumnValues {\n    const n = data.length\n    const rows = allRows(data)\n    const out: unknown[] = new Array(n).fill(undefined)\n    const field = column.path ? 'key' : 'accessor'\n    batch(column, 'accessor', field, rows, () => {\n      const path = column.path\n      const accessor = column.accessor\n      if (path) {\n        let cur = 0\n        const onError = (error: unknown) => failures.add(cur, error)\n        runCells(\n          rows,\n          (r) => {\n            cur = r\n            return getValue(data[r], path, onError)\n          },\n          out,\n          undefined,\n          failures,\n        )\n      } else if (accessor) {\n        runCells(rows, (r) => accessor(data[r]), out, undefined, failures)\n      }\n      failures.report(host.emit, column.index, column.id, 'accessor', undefined, field)\n    })\n    return toNumeric(out, e) ?? out\n  }\n\n  /** A `Float64Array` when every non-nullish value is a number (and there is one); else nothing. */\n  function toNumeric(values: unknown[], e: Entry): Float64Array | undefined {\n    let numbers = 0\n    let nullish = 0\n    for (let i = 0; i < values.length; i++) {\n      const v = values[i]\n      if (typeof v === 'number') numbers++\n      else if (v === null || v === undefined) nullish++\n      else return undefined\n    }\n    if (numbers === 0) return undefined\n    const out = new Float64Array(values.length)\n    const kinds = nullish > 0 ? new Uint8Array(values.length) : undefined\n    for (let i = 0; i < values.length; i++) {\n      const v = values[i]\n      if (typeof v === 'number') out[i] = v\n      else {\n        out[i] = Number.NaN\n        if (kinds) kinds[i] = v === null ? NULL : UNDEFINED\n      }\n    }\n    e.nullish = kinds\n    if (kinds) nullishKinds.set(out, kinds)\n    return out\n  }\n\n  const flags = host.flags\n\n  function values(data: readonly unknown[], column: ResolvedColumn): ColumnValues {\n    const e = entry(data, column)\n    if (e.values) {\n      if (flags && e.flaggedValues) flags.count++\n      return e.values\n    }\n    const before = flags?.count ?? 0\n    e.values = readValues(data, column, e)\n    if (flags && flags.count > before) e.flaggedValues = true\n    return e.values\n  }\n\n  /**\n   * Formats `column` once per data reference, in one `column:batch`; `sliced` (#40): in batches of\n   * {@link STEP} rows with a `yield` between them, so the slicer can end the task on time (a slow\n   * formatter, e.g. dates, is never one long task). Failures and slot-contract breaks are counted\n   * over the whole column and reported once.\n   */\n  function* formatting(\n    data: readonly unknown[],\n    column: ResolvedColumn,\n    sliced: boolean,\n  ): Generator<undefined, readonly string[], undefined> {\n    let e = entry(data, column)\n    if (e.formatted) {\n      if (flags && e.flaggedFormatted) flags.count++\n      return e.formatted\n    }\n    const before = flags?.count ?? 0\n    const vals = values(data, column)\n    if (sliced) yield // reading the values is a task of its own\n    const kinds = e.nullish\n    // The raw value: nullish numbers read back as null / undefined, not NaN.\n    const valueAt = (r: number): unknown => {\n      const k = kinds?.[r]\n      return k ? (k === NULL ? null : undefined) : vals[r]\n    }\n    const n = data.length\n    const rows = allRows(data)\n    const format = column.format\n    // Job-local counts: a sliced column spans several batches.\n    const failed = new CellFailures()\n    const bad = (process.env.NODE_ENV !== \"production\") ? new CellFailures() : undefined\n    const unrendered = new CellFailures()\n    let firstBad: unknown\n    let firstType = ''\n    let cur = 0\n    // A column with `cell` renders itself: its formatted value only feeds search.\n    const onUnrenderable = column.hasCell\n      ? undefined\n      : (v: unknown) => {\n          if (unrendered.count === 0) firstType = typeName(v)\n          unrendered.add(cur, undefined)\n        }\n    const cell = format\n      ? (r: number) => {\n          const s = format(valueAt(r))\n          if (typeof s === 'string') return s\n          // Slot contract (dev): counted only on this non-string path; coerced either way.\n          if ((process.env.NODE_ENV !== \"production\") && bad) {\n            if (bad.count === 0) firstBad = s\n            bad.add(r, undefined)\n          }\n          return defaultFormat(s)\n        }\n      : (r: number) => {\n          cur = r\n          return defaultFormat(valueAt(r), onUnrenderable)\n        }\n    // Values that are all strings already format to themselves: no copy (§9.3 memory).\n    const strings = !format && !(vals instanceof Float64Array) && allStrings(vals)\n    let out: string[] | undefined = strings ? undefined : new Array(n).fill('')\n    for (let from = 0; from < n; from += STEP) {\n      const part = sliced && !strings ? rows.subarray(from, from + STEP) : rows\n      // An interceptor may skip a batch: its cells keep the slot fallback ('').\n      batch(column, 'format', 'format', part, () => {\n        if (strings) out = vals as string[]\n        else runCells(part, cell, out as string[], '', failed)\n      })\n      if (part === rows || from + STEP >= n) break\n      yield\n    }\n    out ??= new Array<string>(n).fill('')\n    failed.report(host.emit, column.index, column.id, 'format')\n    if ((process.env.NODE_ENV !== \"production\") && bad && bad.count > 0) {\n      host.emit('DK_CALLBACK_BAD_RETURN', {\n        slot: `columns[${column.index}].format`,\n        column: column.id,\n        expected: expectedReturn(formatSlot),\n        received: describeReturn(firstBad),\n        count: bad.count,\n        rows: Array.from(bad.sample()),\n        fallback: formatSlot.fallback,\n      })\n    }\n    if (unrendered.count > 0) {\n      host.emit('DK_UNRENDERABLE_VALUE', {\n        column: column.id,\n        index: column.index,\n        count: unrendered.count,\n        rows: Array.from(unrendered.sample()),\n        valueType: firstType,\n      })\n    }\n    if (out !== vals) share(out)\n    // A synchronous read may have cached the column while a sliced job ran.\n    e = entry(data, column)\n    if (!e.formatted) {\n      e.formatted = out\n      if (flags && flags.count > before) e.flaggedFormatted = true\n    }\n    return e.formatted\n  }\n\n  function formatted(data: readonly unknown[], column: ResolvedColumn): readonly string[] {\n    return runJob(() => formatting(data, column, false))\n  }\n\n  return {\n    values,\n    formatted,\n    formattedSliced: (data, column) => formatting(data, column, true),\n    batch,\n  }\n}\n"],"mappings":"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","names":["values"]}

package/dist/pipeline/dev-checks.cjs

@@ -27,6 +27,7 @@ __export(dev_checks_exports, {
 module.exports = __toCommonJS(dev_checks_exports);
 var import_slots = require("../catalog/slots.cjs");
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var stepDiagnostics = process.env.NODE_ENV !== "production" ? [
   (0, import_catalog.defineDiagnostic)({
     code: "DK_FEATURE_BAD_OUTPUT",

package/dist/pipeline/dev-checks.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/dev-checks.ts"],"sourcesContent":["import { describeReturn } from '../catalog/slots'\nimport { defineDiagnostic } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\n\n/**\n * `devChecks` on `pipeline:step` (§3.4, §8.3): a feature `rowModel` must return a `Uint32Array` of\n * row indices and must not write to its input (the input is the previous step's memoised output).\n * Dev only: the definitions, their text and the checks sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has\n * none of it. They run only when a step is recomputed (memo misses), with bounded cost.\n */\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_BAD_OUTPUT: {\n      feature: string\n      /** What `rowModel` returned, as a type (`an Array`); never the value. */\n      received: string\n      /** An out-of-range index (a `Uint32Array` output): its value and the row count. */\n      index?: number\n      rowCount?: number\n    }\n    DK_FEATURE_MUTATED_INPUT: {\n      feature: string\n    }\n  }\n}\n\nexport const stepDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_FEATURE_BAD_OUTPUT',\n        level: 'error',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) =>\n          d.index === undefined\n            ? `feature \"${d.feature}\" rowModel() returned ${d.received}, not a Uint32Array of ` +\n              'row indices'\n            : `feature \"${d.feature}\" rowModel() returned row index ${d.index}, but the data has ` +\n              `${d.rowCount} rows`,\n        impact: () => 'the step passed its input through (the feature had no effect this run)',\n        fix: (d) => [\n          `return a Uint32Array of row indices from rowModel() of feature \"${d.feature}\": ` +\n            'indices.subarray(0, n), a new Uint32Array(n) you filled, or Uint32Array.from(list)',\n          d.index === undefined\n            ? 'rowModel() is synchronous; return the input indices when the feature is inactive'\n            : 'only return indices taken from the input (each is a position in options.data)',\n        ],\n      }),\n      defineDiagnostic({\n        code: 'DK_FEATURE_MUTATED_INPUT',\n        level: 'warn',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) => `feature \"${d.feature}\" rowModel() wrote to its input indices`,\n        impact: () =>\n          \"the input is the previous step's memoised output: later runs can show rows in the \" +\n          'wrong order or the wrong rows until the data changes',\n        fix: (d) => [\n          `copy before changing in feature \"${d.feature}\": indices.slice().sort(...) instead of ` +\n            'indices.sort(...)',\n          'or write the result into a new Uint32Array',\n        ],\n      }),\n    ]\n  : []\n\n/** At most this many input positions are hashed per step. */\nconst SAMPLES = 64\n\n/**\n * A bounded fingerprint of an index array: FNV-1a over the length and at most {@link SAMPLES}\n * evenly spaced positions (every position when shorter; position 0 always).\n */\nexport function indexPrint(indices: Uint32Array): number {\n  const n = indices.length\n  const stride = n <= SAMPLES ? 1 : Math.floor(n / SAMPLES)\n  let h = Math.imul(0x811c9dc5 ^ n, 0x01000193)\n  for (let i = 0, k = 0; i < n && k < SAMPLES; i += stride, k++) {\n    h = Math.imul(h ^ (indices[i] as number), 0x01000193)\n  }\n  return h >>> 0\n}\n\n/** The first index `>= rowCount`, or -1. */\nfunction outOfRange(out: Uint32Array, rowCount: number): number {\n  for (let i = 0; i < out.length; i++) if ((out[i] as number) >= rowCount) return out[i] as number\n  return -1\n}\n\n/**\n * Checks one recomputed step (dev): reports a mutated input (`before` = {@link indexPrint} of the\n * input before `rowModel` ran) and a bad output. Returns whether `out` can be used.\n */\nexport function checkStep(\n  emit: Emit,\n  feature: string,\n  input: Uint32Array,\n  before: number,\n  out: unknown,\n  rowCount: number,\n): boolean {\n  if (indexPrint(input) !== before) emit('DK_FEATURE_MUTATED_INPUT', { feature })\n  if (!(out instanceof Uint32Array)) {\n    emit('DK_FEATURE_BAD_OUTPUT', { feature, received: describeReturn(out) })\n    return false\n  }\n  const index = outOfRange(out, rowCount)\n  if (index < 0) return true\n  emit('DK_FEATURE_BAD_OUTPUT', { feature, received: 'a Uint32Array', index, rowCount })\n  return false\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA+B;AAC/B,qBAAiC;AA0B1B,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,MACE,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MACR,EAAE,UAAU,SACR,YAAY,EAAE,OAAO,yBAAyB,EAAE,QAAQ,uCAExD,YAAY,EAAE,OAAO,mCAAmC,EAAE,KAAK,sBAC5D,EAAE,QAAQ;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mEAAmE,EAAE,OAAO;AAAA,MAE5E,EAAE,UAAU,SACR,qFACA;AAAA,IACN;AAAA,EACF,CAAC;AAAA,MACD,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MAAM,YAAY,EAAE,OAAO;AAAA,IACrC,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO;AAAA,MAE7C;AAAA,IACF;AAAA,EACF,CAAC;AACH,IACA,CAAC;AAGL,IAAM,UAAU;AAMT,SAAS,WAAW,SAA8B;AACvD,QAAM,IAAI,QAAQ;AAClB,QAAM,SAAS,KAAK,UAAU,IAAI,KAAK,MAAM,IAAI,OAAO;AACxD,MAAI,IAAI,KAAK,KAAK,aAAa,GAAG,QAAU;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,KAAK,QAAQ,KAAK;AAC7D,QAAI,KAAK,KAAK,IAAK,QAAQ,CAAC,GAAc,QAAU;AAAA,EACtD;AACA,SAAO,MAAM;AACf;AAGA,SAAS,WAAW,KAAkB,UAA0B;AAC9D,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,KAAK,IAAI,CAAC,KAAgB,SAAU,QAAO,IAAI,CAAC;AACrF,SAAO;AACT;AAMO,SAAS,UACd,MACA,SACA,OACA,QACA,KACA,UACS;AACT,MAAI,WAAW,KAAK,MAAM,OAAQ,MAAK,4BAA4B,EAAE,QAAQ,CAAC;AAC9E,MAAI,EAAE,eAAe,cAAc;AACjC,SAAK,yBAAyB,EAAE,SAAS,cAAU,6BAAe,GAAG,EAAE,CAAC;AACxE,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,WAAW,KAAK,QAAQ;AACtC,MAAI,QAAQ,EAAG,QAAO;AACtB,OAAK,yBAAyB,EAAE,SAAS,UAAU,iBAAiB,OAAO,SAAS,CAAC;AACrF,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/pipeline/dev-checks.ts"],"sourcesContent":["import { describeReturn } from '../catalog/slots'\nimport { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Emit } from '../diagnostics/types'\n\n/**\n * `devChecks` on `pipeline:step` (§3.4, §8.3): a feature `rowModel` must return a `Uint32Array` of\n * row indices and must not write to its input (the input is the previous step's memoised output).\n * Dev only: the definitions, their text and the checks sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has\n * none of it. They run only when a step is recomputed (memo misses), with bounded cost.\n */\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_BAD_OUTPUT: {\n      feature: string\n      /** What `rowModel` returned, as a type (`an Array`); never the value. */\n      received: string\n      /** An out-of-range index (a `Uint32Array` output): its value and the row count. */\n      index?: number\n      rowCount?: number\n    }\n    DK_FEATURE_MUTATED_INPUT: {\n      feature: string\n    }\n  }\n}\n\nexport const stepDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_FEATURE_BAD_OUTPUT',\n        level: 'error',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) =>\n          d.index === undefined\n            ? `feature \"${d.feature}\" rowModel() returned ${d.received}, not a Uint32Array of ` +\n              'row indices'\n            : `feature \"${d.feature}\" rowModel() returned row index ${d.index}, but the data has ` +\n              `${d.rowCount} rows`,\n        impact: () => 'the step passed its input through (the feature had no effect this run)',\n        fix: (d) => [\n          `return a Uint32Array of row indices from rowModel() of feature \"${d.feature}\": ` +\n            'indices.subarray(0, n), a new Uint32Array(n) you filled, or Uint32Array.from(list)',\n          d.index === undefined\n            ? 'rowModel() is synchronous; return the input indices when the feature is inactive'\n            : 'only return indices taken from the input (each is a position in options.data)',\n        ],\n      }),\n      defineDiagnostic({\n        code: 'DK_FEATURE_MUTATED_INPUT',\n        level: 'warn',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) => `feature \"${d.feature}\" rowModel() wrote to its input indices`,\n        impact: () =>\n          \"the input is the previous step's memoised output: later runs can show rows in the \" +\n          'wrong order or the wrong rows until the data changes',\n        fix: (d) => [\n          `copy before changing in feature \"${d.feature}\": indices.slice().sort(...) instead of ` +\n            'indices.sort(...)',\n          'or write the result into a new Uint32Array',\n        ],\n      }),\n    ]\n  : []\n\n/** At most this many input positions are hashed per step. */\nconst SAMPLES = 64\n\n/**\n * A bounded fingerprint of an index array: FNV-1a over the length and at most {@link SAMPLES}\n * evenly spaced positions (every position when shorter; position 0 always).\n */\nexport function indexPrint(indices: Uint32Array): number {\n  const n = indices.length\n  const stride = n <= SAMPLES ? 1 : Math.floor(n / SAMPLES)\n  let h = Math.imul(0x811c9dc5 ^ n, 0x01000193)\n  for (let i = 0, k = 0; i < n && k < SAMPLES; i += stride, k++) {\n    h = Math.imul(h ^ (indices[i] as number), 0x01000193)\n  }\n  return h >>> 0\n}\n\n/** The first index `>= rowCount`, or -1. */\nfunction outOfRange(out: Uint32Array, rowCount: number): number {\n  for (let i = 0; i < out.length; i++) if ((out[i] as number) >= rowCount) return out[i] as number\n  return -1\n}\n\n/**\n * Checks one recomputed step (dev): reports a mutated input (`before` = {@link indexPrint} of the\n * input before `rowModel` ran) and a bad output. Returns whether `out` can be used.\n */\nexport function checkStep(\n  emit: Emit,\n  feature: string,\n  input: Uint32Array,\n  before: number,\n  out: unknown,\n  rowCount: number,\n): boolean {\n  if (indexPrint(input) !== before) emit('DK_FEATURE_MUTATED_INPUT', { feature })\n  if (!(out instanceof Uint32Array)) {\n    emit('DK_FEATURE_BAD_OUTPUT', { feature, received: describeReturn(out) })\n    return false\n  }\n  const index = outOfRange(out, rowCount)\n  if (index < 0) return true\n  emit('DK_FEATURE_BAD_OUTPUT', { feature, received: 'a Uint32Array', index, rowCount })\n  return false\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA+B;AAC/B,qBAAiC;AACjC,2BAAO;AA0BA,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,MACE,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MACR,EAAE,UAAU,SACR,YAAY,EAAE,OAAO,yBAAyB,EAAE,QAAQ,uCAExD,YAAY,EAAE,OAAO,mCAAmC,EAAE,KAAK,sBAC5D,EAAE,QAAQ;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mEAAmE,EAAE,OAAO;AAAA,MAE5E,EAAE,UAAU,SACR,qFACA;AAAA,IACN;AAAA,EACF,CAAC;AAAA,MACD,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MAAM,YAAY,EAAE,OAAO;AAAA,IACrC,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO;AAAA,MAE7C;AAAA,IACF;AAAA,EACF,CAAC;AACH,IACA,CAAC;AAGL,IAAM,UAAU;AAMT,SAAS,WAAW,SAA8B;AACvD,QAAM,IAAI,QAAQ;AAClB,QAAM,SAAS,KAAK,UAAU,IAAI,KAAK,MAAM,IAAI,OAAO;AACxD,MAAI,IAAI,KAAK,KAAK,aAAa,GAAG,QAAU;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,KAAK,QAAQ,KAAK;AAC7D,QAAI,KAAK,KAAK,IAAK,QAAQ,CAAC,GAAc,QAAU;AAAA,EACtD;AACA,SAAO,MAAM;AACf;AAGA,SAAS,WAAW,KAAkB,UAA0B;AAC9D,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,KAAK,IAAI,CAAC,KAAgB,SAAU,QAAO,IAAI,CAAC;AACrF,SAAO;AACT;AAMO,SAAS,UACd,MACA,SACA,OACA,QACA,KACA,UACS;AACT,MAAI,WAAW,KAAK,MAAM,OAAQ,MAAK,4BAA4B,EAAE,QAAQ,CAAC;AAC9E,MAAI,EAAE,eAAe,cAAc;AACjC,SAAK,yBAAyB,EAAE,SAAS,cAAU,6BAAe,GAAG,EAAE,CAAC;AACxE,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,WAAW,KAAK,QAAQ;AACtC,MAAI,QAAQ,EAAG,QAAO;AACtB,OAAK,yBAAyB,EAAE,SAAS,UAAU,iBAAiB,OAAO,SAAS,CAAC;AACrF,SAAO;AACT;","names":[]}

package/dist/pipeline/dev-checks.js

@@ -1,6 +1,7 @@
 // src/pipeline/dev-checks.ts
 import { describeReturn } from "../catalog/slots.js";
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var stepDiagnostics = process.env.NODE_ENV !== "production" ? [
   defineDiagnostic({
     code: "DK_FEATURE_BAD_OUTPUT",

package/dist/pipeline/dev-checks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/dev-checks.ts"],"sourcesContent":["import { describeReturn } from '../catalog/slots'\nimport { defineDiagnostic } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\n\n/**\n * `devChecks` on `pipeline:step` (§3.4, §8.3): a feature `rowModel` must return a `Uint32Array` of\n * row indices and must not write to its input (the input is the previous step's memoised output).\n * Dev only: the definitions, their text and the checks sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has\n * none of it. They run only when a step is recomputed (memo misses), with bounded cost.\n */\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_BAD_OUTPUT: {\n      feature: string\n      /** What `rowModel` returned, as a type (`an Array`); never the value. */\n      received: string\n      /** An out-of-range index (a `Uint32Array` output): its value and the row count. */\n      index?: number\n      rowCount?: number\n    }\n    DK_FEATURE_MUTATED_INPUT: {\n      feature: string\n    }\n  }\n}\n\nexport const stepDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_FEATURE_BAD_OUTPUT',\n        level: 'error',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) =>\n          d.index === undefined\n            ? `feature \"${d.feature}\" rowModel() returned ${d.received}, not a Uint32Array of ` +\n              'row indices'\n            : `feature \"${d.feature}\" rowModel() returned row index ${d.index}, but the data has ` +\n              `${d.rowCount} rows`,\n        impact: () => 'the step passed its input through (the feature had no effect this run)',\n        fix: (d) => [\n          `return a Uint32Array of row indices from rowModel() of feature \"${d.feature}\": ` +\n            'indices.subarray(0, n), a new Uint32Array(n) you filled, or Uint32Array.from(list)',\n          d.index === undefined\n            ? 'rowModel() is synchronous; return the input indices when the feature is inactive'\n            : 'only return indices taken from the input (each is a position in options.data)',\n        ],\n      }),\n      defineDiagnostic({\n        code: 'DK_FEATURE_MUTATED_INPUT',\n        level: 'warn',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) => `feature \"${d.feature}\" rowModel() wrote to its input indices`,\n        impact: () =>\n          \"the input is the previous step's memoised output: later runs can show rows in the \" +\n          'wrong order or the wrong rows until the data changes',\n        fix: (d) => [\n          `copy before changing in feature \"${d.feature}\": indices.slice().sort(...) instead of ` +\n            'indices.sort(...)',\n          'or write the result into a new Uint32Array',\n        ],\n      }),\n    ]\n  : []\n\n/** At most this many input positions are hashed per step. */\nconst SAMPLES = 64\n\n/**\n * A bounded fingerprint of an index array: FNV-1a over the length and at most {@link SAMPLES}\n * evenly spaced positions (every position when shorter; position 0 always).\n */\nexport function indexPrint(indices: Uint32Array): number {\n  const n = indices.length\n  const stride = n <= SAMPLES ? 1 : Math.floor(n / SAMPLES)\n  let h = Math.imul(0x811c9dc5 ^ n, 0x01000193)\n  for (let i = 0, k = 0; i < n && k < SAMPLES; i += stride, k++) {\n    h = Math.imul(h ^ (indices[i] as number), 0x01000193)\n  }\n  return h >>> 0\n}\n\n/** The first index `>= rowCount`, or -1. */\nfunction outOfRange(out: Uint32Array, rowCount: number): number {\n  for (let i = 0; i < out.length; i++) if ((out[i] as number) >= rowCount) return out[i] as number\n  return -1\n}\n\n/**\n * Checks one recomputed step (dev): reports a mutated input (`before` = {@link indexPrint} of the\n * input before `rowModel` ran) and a bad output. Returns whether `out` can be used.\n */\nexport function checkStep(\n  emit: Emit,\n  feature: string,\n  input: Uint32Array,\n  before: number,\n  out: unknown,\n  rowCount: number,\n): boolean {\n  if (indexPrint(input) !== before) emit('DK_FEATURE_MUTATED_INPUT', { feature })\n  if (!(out instanceof Uint32Array)) {\n    emit('DK_FEATURE_BAD_OUTPUT', { feature, received: describeReturn(out) })\n    return false\n  }\n  const index = outOfRange(out, rowCount)\n  if (index < 0) return true\n  emit('DK_FEATURE_BAD_OUTPUT', { feature, received: 'a Uint32Array', index, rowCount })\n  return false\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AA0B1B,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,EACE,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MACR,EAAE,UAAU,SACR,YAAY,EAAE,OAAO,yBAAyB,EAAE,QAAQ,uCAExD,YAAY,EAAE,OAAO,mCAAmC,EAAE,KAAK,sBAC5D,EAAE,QAAQ;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mEAAmE,EAAE,OAAO;AAAA,MAE5E,EAAE,UAAU,SACR,qFACA;AAAA,IACN;AAAA,EACF,CAAC;AAAA,EACD,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MAAM,YAAY,EAAE,OAAO;AAAA,IACrC,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO;AAAA,MAE7C;AAAA,IACF;AAAA,EACF,CAAC;AACH,IACA,CAAC;AAGL,IAAM,UAAU;AAMT,SAAS,WAAW,SAA8B;AACvD,QAAM,IAAI,QAAQ;AAClB,QAAM,SAAS,KAAK,UAAU,IAAI,KAAK,MAAM,IAAI,OAAO;AACxD,MAAI,IAAI,KAAK,KAAK,aAAa,GAAG,QAAU;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,KAAK,QAAQ,KAAK;AAC7D,QAAI,KAAK,KAAK,IAAK,QAAQ,CAAC,GAAc,QAAU;AAAA,EACtD;AACA,SAAO,MAAM;AACf;AAGA,SAAS,WAAW,KAAkB,UAA0B;AAC9D,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,KAAK,IAAI,CAAC,KAAgB,SAAU,QAAO,IAAI,CAAC;AACrF,SAAO;AACT;AAMO,SAAS,UACd,MACA,SACA,OACA,QACA,KACA,UACS;AACT,MAAI,WAAW,KAAK,MAAM,OAAQ,MAAK,4BAA4B,EAAE,QAAQ,CAAC;AAC9E,MAAI,EAAE,eAAe,cAAc;AACjC,SAAK,yBAAyB,EAAE,SAAS,UAAU,eAAe,GAAG,EAAE,CAAC;AACxE,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,WAAW,KAAK,QAAQ;AACtC,MAAI,QAAQ,EAAG,QAAO;AACtB,OAAK,yBAAyB,EAAE,SAAS,UAAU,iBAAiB,OAAO,SAAS,CAAC;AACrF,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/pipeline/dev-checks.ts"],"sourcesContent":["import { describeReturn } from '../catalog/slots'\nimport { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Emit } from '../diagnostics/types'\n\n/**\n * `devChecks` on `pipeline:step` (§3.4, §8.3): a feature `rowModel` must return a `Uint32Array` of\n * row indices and must not write to its input (the input is the previous step's memoised output).\n * Dev only: the definitions, their text and the checks sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has\n * none of it. They run only when a step is recomputed (memo misses), with bounded cost.\n */\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_BAD_OUTPUT: {\n      feature: string\n      /** What `rowModel` returned, as a type (`an Array`); never the value. */\n      received: string\n      /** An out-of-range index (a `Uint32Array` output): its value and the row count. */\n      index?: number\n      rowCount?: number\n    }\n    DK_FEATURE_MUTATED_INPUT: {\n      feature: string\n    }\n  }\n}\n\nexport const stepDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_FEATURE_BAD_OUTPUT',\n        level: 'error',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) =>\n          d.index === undefined\n            ? `feature \"${d.feature}\" rowModel() returned ${d.received}, not a Uint32Array of ` +\n              'row indices'\n            : `feature \"${d.feature}\" rowModel() returned row index ${d.index}, but the data has ` +\n              `${d.rowCount} rows`,\n        impact: () => 'the step passed its input through (the feature had no effect this run)',\n        fix: (d) => [\n          `return a Uint32Array of row indices from rowModel() of feature \"${d.feature}\": ` +\n            'indices.subarray(0, n), a new Uint32Array(n) you filled, or Uint32Array.from(list)',\n          d.index === undefined\n            ? 'rowModel() is synchronous; return the input indices when the feature is inactive'\n            : 'only return indices taken from the input (each is a position in options.data)',\n        ],\n      }),\n      defineDiagnostic({\n        code: 'DK_FEATURE_MUTATED_INPUT',\n        level: 'warn',\n        where: (d) => ({ kind: 'feature', name: d.feature }),\n        problem: (d) => `feature \"${d.feature}\" rowModel() wrote to its input indices`,\n        impact: () =>\n          \"the input is the previous step's memoised output: later runs can show rows in the \" +\n          'wrong order or the wrong rows until the data changes',\n        fix: (d) => [\n          `copy before changing in feature \"${d.feature}\": indices.slice().sort(...) instead of ` +\n            'indices.sort(...)',\n          'or write the result into a new Uint32Array',\n        ],\n      }),\n    ]\n  : []\n\n/** At most this many input positions are hashed per step. */\nconst SAMPLES = 64\n\n/**\n * A bounded fingerprint of an index array: FNV-1a over the length and at most {@link SAMPLES}\n * evenly spaced positions (every position when shorter; position 0 always).\n */\nexport function indexPrint(indices: Uint32Array): number {\n  const n = indices.length\n  const stride = n <= SAMPLES ? 1 : Math.floor(n / SAMPLES)\n  let h = Math.imul(0x811c9dc5 ^ n, 0x01000193)\n  for (let i = 0, k = 0; i < n && k < SAMPLES; i += stride, k++) {\n    h = Math.imul(h ^ (indices[i] as number), 0x01000193)\n  }\n  return h >>> 0\n}\n\n/** The first index `>= rowCount`, or -1. */\nfunction outOfRange(out: Uint32Array, rowCount: number): number {\n  for (let i = 0; i < out.length; i++) if ((out[i] as number) >= rowCount) return out[i] as number\n  return -1\n}\n\n/**\n * Checks one recomputed step (dev): reports a mutated input (`before` = {@link indexPrint} of the\n * input before `rowModel` ran) and a bad output. Returns whether `out` can be used.\n */\nexport function checkStep(\n  emit: Emit,\n  feature: string,\n  input: Uint32Array,\n  before: number,\n  out: unknown,\n  rowCount: number,\n): boolean {\n  if (indexPrint(input) !== before) emit('DK_FEATURE_MUTATED_INPUT', { feature })\n  if (!(out instanceof Uint32Array)) {\n    emit('DK_FEATURE_BAD_OUTPUT', { feature, received: describeReturn(out) })\n    return false\n  }\n  const index = outOfRange(out, rowCount)\n  if (index < 0) return true\n  emit('DK_FEATURE_BAD_OUTPUT', { feature, received: 'a Uint32Array', index, rowCount })\n  return false\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,OAAO;AA0BA,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,EACE,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MACR,EAAE,UAAU,SACR,YAAY,EAAE,OAAO,yBAAyB,EAAE,QAAQ,uCAExD,YAAY,EAAE,OAAO,mCAAmC,EAAE,KAAK,sBAC5D,EAAE,QAAQ;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mEAAmE,EAAE,OAAO;AAAA,MAE5E,EAAE,UAAU,SACR,qFACA;AAAA,IACN;AAAA,EACF,CAAC;AAAA,EACD,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IAClD,SAAS,CAAC,MAAM,YAAY,EAAE,OAAO;AAAA,IACrC,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO;AAAA,MAE7C;AAAA,IACF;AAAA,EACF,CAAC;AACH,IACA,CAAC;AAGL,IAAM,UAAU;AAMT,SAAS,WAAW,SAA8B;AACvD,QAAM,IAAI,QAAQ;AAClB,QAAM,SAAS,KAAK,UAAU,IAAI,KAAK,MAAM,IAAI,OAAO;AACxD,MAAI,IAAI,KAAK,KAAK,aAAa,GAAG,QAAU;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,SAAS,KAAK,QAAQ,KAAK;AAC7D,QAAI,KAAK,KAAK,IAAK,QAAQ,CAAC,GAAc,QAAU;AAAA,EACtD;AACA,SAAO,MAAM;AACf;AAGA,SAAS,WAAW,KAAkB,UAA0B;AAC9D,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,KAAK,IAAI,CAAC,KAAgB,SAAU,QAAO,IAAI,CAAC;AACrF,SAAO;AACT;AAMO,SAAS,UACd,MACA,SACA,OACA,QACA,KACA,UACS;AACT,MAAI,WAAW,KAAK,MAAM,OAAQ,MAAK,4BAA4B,EAAE,QAAQ,CAAC;AAC9E,MAAI,EAAE,eAAe,cAAc;AACjC,SAAK,yBAAyB,EAAE,SAAS,UAAU,eAAe,GAAG,EAAE,CAAC;AACxE,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,WAAW,KAAK,QAAQ;AACtC,MAAI,QAAQ,EAAG,QAAO;AACtB,OAAK,yBAAyB,EAAE,SAAS,UAAU,iBAAiB,OAAO,SAAS,CAAC;AACrF,SAAO;AACT;","names":[]}

package/dist/pipeline/env-codes.cjs

@@ -25,6 +25,7 @@ __export(env_codes_exports, {
 });
 module.exports = __toCommonJS(env_codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var ms = (n) => `${n.toFixed(1)} ms`;
 var envMessages = {
   DK_ENV_FALLBACK: {
@@ -39,11 +40,11 @@ var envMessages = {
     ]
   },
   DK_PERF_HINT: {
-    problem: (d) => `the "${d.feature}" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} budget of one task`,
+    problem: (d) => `${d.sliced ? "a time slice of " : ""}the "${d.feature}" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} budget of one task` + (d.slot ? `; ${Math.round((d.share ?? 1) * 100)} % of it in ${d.slot} (column "${d.column}")` : ""),
     impact: () => "the page could not respond to input while it ran (a long task)",
     fix: (d) => [
       d.stage === "none" ? `move the work of "${d.feature}" out of rowModel (precompute it, or run it in a Worker)` : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,
-      `make the per-row work of "${d.feature}" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`
+      d.slot ? `make ${d.slot} cheaper (precompute it, avoid Intl / regex per call), or run it in a Worker` : `make the per-row work of "${d.feature}" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`
     ]
   }
 };

package/dist/pipeline/env-codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/env-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ENV_FALLBACK: {\n      /** The missing runtime capability, e.g. `'scheduler.yield'` or `'Intl.Collator'`. */\n      api: string\n      /** The feature that needed it (`where`). */\n      feature: string\n      /** What was asked for, e.g. the requested collator locale. */\n      requested?: string\n      /** What is used instead, e.g. `'setTimeout'` or the resolved locale. */\n      fallback: string\n    }\n    DK_PERF_HINT: {\n      /** The feature whose step exceeded the budget (`where`). */\n      feature: string\n      /** Its pipeline stage. */\n      stage: string\n      /** Measured step time, in milliseconds. */\n      ms: number\n      /** Rows the step received. */\n      rows: number\n      /** The budget, in milliseconds (§9.3: the longest task). */\n      budget: number\n    }\n  }\n}\n\nconst ms = (n: number) => `${n.toFixed(1)} ms`\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const envMessages: DiagnosticMessages<'DK_ENV_FALLBACK' | 'DK_PERF_HINT'> = {\n  DK_ENV_FALLBACK: {\n    problem: (d) =>\n      `${d.api}${d.requested === undefined ? '' : ` (${JSON.stringify(d.requested)})`} is not ` +\n      `available in this environment (feature \"${d.feature}\")`,\n    impact: (d) => `DataKable uses ${d.fallback} instead; results are the same`,\n    fix: (d) =>\n      d.api === 'Intl.Collator'\n        ? [\n            `use a locale this runtime supports (Intl.Collator.supportedLocalesOf(${JSON.stringify(d.requested)}) is empty)`,\n            'or ship full ICU data (Node: the default full-icu build; browsers: a polyfill such as @formatjs/intl)',\n          ]\n        : [\n            `nothing to do: ${d.fallback} is a correct fallback for ${d.api}`,\n            `${d.api} is used automatically where the runtime provides it`,\n          ],\n  },\n  DK_PERF_HINT: {\n    problem: (d) =>\n      `the \"${d.feature}\" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} ` +\n      'budget of one task',\n    impact: () => 'the page could not respond to input while it ran (a long task)',\n    fix: (d) => [\n      d.stage === 'none'\n        ? `move the work of \"${d.feature}\" out of rowModel (precompute it, or run it in a Worker)`\n        : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,\n      `make the per-row work of \"${d.feature}\" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`,\n    ],\n  },\n}\n\n/** `DK_ENV_FALLBACK` (§8.3): a missing runtime capability and the fallback used. */\nexport const envDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ENV_FALLBACK',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_ENV_FALLBACK,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AA6B1D,IAAM,KAAK,CAAC,MAAc,GAAG,EAAE,QAAQ,CAAC,CAAC;AAGlC,IAAM,cAAsE;AAAA,EACjF,iBAAiB;AAAA,IACf,SAAS,CAAC,MACR,GAAG,EAAE,GAAG,GAAG,EAAE,cAAc,SAAY,KAAK,KAAK,KAAK,UAAU,EAAE,SAAS,CAAC,GAAG,mDACpC,EAAE,OAAO;AAAA,IACtD,QAAQ,CAAC,MAAM,kBAAkB,EAAE,QAAQ;AAAA,IAC3C,KAAK,CAAC,MACJ,EAAE,QAAQ,kBACN;AAAA,MACE,wEAAwE,KAAK,UAAU,EAAE,SAAS,CAAC;AAAA,MACnG;AAAA,IACF,IACA;AAAA,MACE,kBAAkB,EAAE,QAAQ,8BAA8B,EAAE,GAAG;AAAA,MAC/D,GAAG,EAAE,GAAG;AAAA,IACV;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,SAAS,CAAC,MACR,QAAQ,EAAE,OAAO,eAAe,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,mBAAmB,GAAG,EAAE,MAAM,CAAC;AAAA,IAEtF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,UAAU,SACR,qBAAqB,EAAE,OAAO,6DAC9B,yBAAyB,EAAE,OAAO;AAAA,MACtC,6BAA6B,EAAE,OAAO;AAAA,IACxC;AAAA,EACF;AACF;AAGO,IAAM,iBAAiB;AAAA,MAC5B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}
+{"version":3,"sources":["../../src/pipeline/env-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ENV_FALLBACK: {\n      /** The missing runtime capability, e.g. `'scheduler.yield'` or `'Intl.Collator'`. */\n      api: string\n      /** The feature that needed it (`where`). */\n      feature: string\n      /** What was asked for, e.g. the requested collator locale. */\n      requested?: string\n      /** What is used instead, e.g. `'setTimeout'` or the resolved locale. */\n      fallback: string\n    }\n    DK_PERF_HINT: {\n      /** The feature whose step exceeded the budget (`where`). */\n      feature: string\n      /** Its pipeline stage. */\n      stage: string\n      /** Measured step time, in milliseconds. */\n      ms: number\n      /** Rows the step received. */\n      rows: number\n      /** The budget, in milliseconds (§9.3: the longest task). */\n      budget: number\n      /** One slice of the step's time-sliced work, run between pipeline runs (#61). */\n      sliced?: boolean\n      /** The column slot at least half of the time went to, e.g. `columns[0].format` (#62). */\n      slot?: string\n      /** Its column id. */\n      column?: string\n      /** Its share of {@link ms}, 0.5 to 1. */\n      share?: number\n    }\n  }\n}\n\nconst ms = (n: number) => `${n.toFixed(1)} ms`\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const envMessages: DiagnosticMessages<'DK_ENV_FALLBACK' | 'DK_PERF_HINT'> = {\n  DK_ENV_FALLBACK: {\n    problem: (d) =>\n      `${d.api}${d.requested === undefined ? '' : ` (${JSON.stringify(d.requested)})`} is not ` +\n      `available in this environment (feature \"${d.feature}\")`,\n    impact: (d) => `DataKable uses ${d.fallback} instead; results are the same`,\n    fix: (d) =>\n      d.api === 'Intl.Collator'\n        ? [\n            `use a locale this runtime supports (Intl.Collator.supportedLocalesOf(${JSON.stringify(d.requested)}) is empty)`,\n            'or ship full ICU data (Node: the default full-icu build; browsers: a polyfill such as @formatjs/intl)',\n          ]\n        : [\n            `nothing to do: ${d.fallback} is a correct fallback for ${d.api}`,\n            `${d.api} is used automatically where the runtime provides it`,\n          ],\n  },\n  DK_PERF_HINT: {\n    problem: (d) =>\n      `${d.sliced ? 'a time slice of ' : ''}the \"${d.feature}\" step took ${ms(d.ms)} on ` +\n      `${d.rows} rows, over the ${ms(d.budget)} budget of one task` +\n      (d.slot\n        ? `; ${Math.round((d.share ?? 1) * 100)} % of it in ${d.slot} (column \"${d.column}\")`\n        : ''),\n    impact: () => 'the page could not respond to input while it ran (a long task)',\n    fix: (d) => [\n      d.stage === 'none'\n        ? `move the work of \"${d.feature}\" out of rowModel (precompute it, or run it in a Worker)`\n        : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,\n      d.slot\n        ? `make ${d.slot} cheaper (precompute it, avoid Intl / regex per call), or run it in a Worker`\n        : `make the per-row work of \"${d.feature}\" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`,\n    ],\n  },\n}\n\n/** `DK_ENV_FALLBACK` (§8.3): a missing runtime capability and the fallback used. */\nexport const envDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ENV_FALLBACK',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_ENV_FALLBACK,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAqCP,IAAM,KAAK,CAAC,MAAc,GAAG,EAAE,QAAQ,CAAC,CAAC;AAGlC,IAAM,cAAsE;AAAA,EACjF,iBAAiB;AAAA,IACf,SAAS,CAAC,MACR,GAAG,EAAE,GAAG,GAAG,EAAE,cAAc,SAAY,KAAK,KAAK,KAAK,UAAU,EAAE,SAAS,CAAC,GAAG,mDACpC,EAAE,OAAO;AAAA,IACtD,QAAQ,CAAC,MAAM,kBAAkB,EAAE,QAAQ;AAAA,IAC3C,KAAK,CAAC,MACJ,EAAE,QAAQ,kBACN;AAAA,MACE,wEAAwE,KAAK,UAAU,EAAE,SAAS,CAAC;AAAA,MACnG;AAAA,IACF,IACA;AAAA,MACE,kBAAkB,EAAE,QAAQ,8BAA8B,EAAE,GAAG;AAAA,MAC/D,GAAG,EAAE,GAAG;AAAA,IACV;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,SAAS,CAAC,MACR,GAAG,EAAE,SAAS,qBAAqB,EAAE,QAAQ,EAAE,OAAO,eAAe,GAAG,EAAE,EAAE,CAAC,OAC1E,EAAE,IAAI,mBAAmB,GAAG,EAAE,MAAM,CAAC,yBACvC,EAAE,OACC,KAAK,KAAK,OAAO,EAAE,SAAS,KAAK,GAAG,CAAC,eAAe,EAAE,IAAI,aAAa,EAAE,MAAM,OAC/E;AAAA,IACN,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,UAAU,SACR,qBAAqB,EAAE,OAAO,6DAC9B,yBAAyB,EAAE,OAAO;AAAA,MACtC,EAAE,OACE,QAAQ,EAAE,IAAI,iFACd,6BAA6B,EAAE,OAAO;AAAA,IAC5C;AAAA,EACF;AACF;AAGO,IAAM,iBAAiB;AAAA,MAC5B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}

package/dist/pipeline/env-codes.js

@@ -1,5 +1,6 @@
 // src/pipeline/env-codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var ms = (n) => `${n.toFixed(1)} ms`;
 var envMessages = {
   DK_ENV_FALLBACK: {
@@ -14,11 +15,11 @@ var envMessages = {
     ]
   },
   DK_PERF_HINT: {
-    problem: (d) => `the "${d.feature}" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} budget of one task`,
+    problem: (d) => `${d.sliced ? "a time slice of " : ""}the "${d.feature}" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} budget of one task` + (d.slot ? `; ${Math.round((d.share ?? 1) * 100)} % of it in ${d.slot} (column "${d.column}")` : ""),
     impact: () => "the page could not respond to input while it ran (a long task)",
     fix: (d) => [
       d.stage === "none" ? `move the work of "${d.feature}" out of rowModel (precompute it, or run it in a Worker)` : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,
-      `make the per-row work of "${d.feature}" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`
+      d.slot ? `make ${d.slot} cheaper (precompute it, avoid Intl / regex per call), or run it in a Worker` : `make the per-row work of "${d.feature}" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`
     ]
   }
 };

package/dist/pipeline/env-codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/env-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ENV_FALLBACK: {\n      /** The missing runtime capability, e.g. `'scheduler.yield'` or `'Intl.Collator'`. */\n      api: string\n      /** The feature that needed it (`where`). */\n      feature: string\n      /** What was asked for, e.g. the requested collator locale. */\n      requested?: string\n      /** What is used instead, e.g. `'setTimeout'` or the resolved locale. */\n      fallback: string\n    }\n    DK_PERF_HINT: {\n      /** The feature whose step exceeded the budget (`where`). */\n      feature: string\n      /** Its pipeline stage. */\n      stage: string\n      /** Measured step time, in milliseconds. */\n      ms: number\n      /** Rows the step received. */\n      rows: number\n      /** The budget, in milliseconds (§9.3: the longest task). */\n      budget: number\n    }\n  }\n}\n\nconst ms = (n: number) => `${n.toFixed(1)} ms`\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const envMessages: DiagnosticMessages<'DK_ENV_FALLBACK' | 'DK_PERF_HINT'> = {\n  DK_ENV_FALLBACK: {\n    problem: (d) =>\n      `${d.api}${d.requested === undefined ? '' : ` (${JSON.stringify(d.requested)})`} is not ` +\n      `available in this environment (feature \"${d.feature}\")`,\n    impact: (d) => `DataKable uses ${d.fallback} instead; results are the same`,\n    fix: (d) =>\n      d.api === 'Intl.Collator'\n        ? [\n            `use a locale this runtime supports (Intl.Collator.supportedLocalesOf(${JSON.stringify(d.requested)}) is empty)`,\n            'or ship full ICU data (Node: the default full-icu build; browsers: a polyfill such as @formatjs/intl)',\n          ]\n        : [\n            `nothing to do: ${d.fallback} is a correct fallback for ${d.api}`,\n            `${d.api} is used automatically where the runtime provides it`,\n          ],\n  },\n  DK_PERF_HINT: {\n    problem: (d) =>\n      `the \"${d.feature}\" step took ${ms(d.ms)} on ${d.rows} rows, over the ${ms(d.budget)} ` +\n      'budget of one task',\n    impact: () => 'the page could not respond to input while it ran (a long task)',\n    fix: (d) => [\n      d.stage === 'none'\n        ? `move the work of \"${d.feature}\" out of rowModel (precompute it, or run it in a Worker)`\n        : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,\n      `make the per-row work of \"${d.feature}\" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`,\n    ],\n  },\n}\n\n/** `DK_ENV_FALLBACK` (§8.3): a missing runtime capability and the fallback used. */\nexport const envDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ENV_FALLBACK',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_ENV_FALLBACK,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AA6B1D,IAAM,KAAK,CAAC,MAAc,GAAG,EAAE,QAAQ,CAAC,CAAC;AAGlC,IAAM,cAAsE;AAAA,EACjF,iBAAiB;AAAA,IACf,SAAS,CAAC,MACR,GAAG,EAAE,GAAG,GAAG,EAAE,cAAc,SAAY,KAAK,KAAK,KAAK,UAAU,EAAE,SAAS,CAAC,GAAG,mDACpC,EAAE,OAAO;AAAA,IACtD,QAAQ,CAAC,MAAM,kBAAkB,EAAE,QAAQ;AAAA,IAC3C,KAAK,CAAC,MACJ,EAAE,QAAQ,kBACN;AAAA,MACE,wEAAwE,KAAK,UAAU,EAAE,SAAS,CAAC;AAAA,MACnG;AAAA,IACF,IACA;AAAA,MACE,kBAAkB,EAAE,QAAQ,8BAA8B,EAAE,GAAG;AAAA,MAC/D,GAAG,EAAE,GAAG;AAAA,IACV;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,SAAS,CAAC,MACR,QAAQ,EAAE,OAAO,eAAe,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,mBAAmB,GAAG,EAAE,MAAM,CAAC;AAAA,IAEtF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,UAAU,SACR,qBAAqB,EAAE,OAAO,6DAC9B,yBAAyB,EAAE,OAAO;AAAA,MACtC,6BAA6B,EAAE,OAAO;AAAA,IACxC;AAAA,EACF;AACF;AAGO,IAAM,iBAAiB;AAAA,EAC5B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}
+{"version":3,"sources":["../../src/pipeline/env-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ENV_FALLBACK: {\n      /** The missing runtime capability, e.g. `'scheduler.yield'` or `'Intl.Collator'`. */\n      api: string\n      /** The feature that needed it (`where`). */\n      feature: string\n      /** What was asked for, e.g. the requested collator locale. */\n      requested?: string\n      /** What is used instead, e.g. `'setTimeout'` or the resolved locale. */\n      fallback: string\n    }\n    DK_PERF_HINT: {\n      /** The feature whose step exceeded the budget (`where`). */\n      feature: string\n      /** Its pipeline stage. */\n      stage: string\n      /** Measured step time, in milliseconds. */\n      ms: number\n      /** Rows the step received. */\n      rows: number\n      /** The budget, in milliseconds (§9.3: the longest task). */\n      budget: number\n      /** One slice of the step's time-sliced work, run between pipeline runs (#61). */\n      sliced?: boolean\n      /** The column slot at least half of the time went to, e.g. `columns[0].format` (#62). */\n      slot?: string\n      /** Its column id. */\n      column?: string\n      /** Its share of {@link ms}, 0.5 to 1. */\n      share?: number\n    }\n  }\n}\n\nconst ms = (n: number) => `${n.toFixed(1)} ms`\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const envMessages: DiagnosticMessages<'DK_ENV_FALLBACK' | 'DK_PERF_HINT'> = {\n  DK_ENV_FALLBACK: {\n    problem: (d) =>\n      `${d.api}${d.requested === undefined ? '' : ` (${JSON.stringify(d.requested)})`} is not ` +\n      `available in this environment (feature \"${d.feature}\")`,\n    impact: (d) => `DataKable uses ${d.fallback} instead; results are the same`,\n    fix: (d) =>\n      d.api === 'Intl.Collator'\n        ? [\n            `use a locale this runtime supports (Intl.Collator.supportedLocalesOf(${JSON.stringify(d.requested)}) is empty)`,\n            'or ship full ICU data (Node: the default full-icu build; browsers: a polyfill such as @formatjs/intl)',\n          ]\n        : [\n            `nothing to do: ${d.fallback} is a correct fallback for ${d.api}`,\n            `${d.api} is used automatically where the runtime provides it`,\n          ],\n  },\n  DK_PERF_HINT: {\n    problem: (d) =>\n      `${d.sliced ? 'a time slice of ' : ''}the \"${d.feature}\" step took ${ms(d.ms)} on ` +\n      `${d.rows} rows, over the ${ms(d.budget)} budget of one task` +\n      (d.slot\n        ? `; ${Math.round((d.share ?? 1) * 100)} % of it in ${d.slot} (column \"${d.column}\")`\n        : ''),\n    impact: () => 'the page could not respond to input while it ran (a long task)',\n    fix: (d) => [\n      d.stage === 'none'\n        ? `move the work of \"${d.feature}\" out of rowModel (precompute it, or run it in a Worker)`\n        : `let the server do it: ${d.feature}({ mode: 'server' }) with options.fetcher`,\n      d.slot\n        ? `make ${d.slot} cheaper (precompute it, avoid Intl / regex per call), or run it in a Worker`\n        : `make the per-row work of \"${d.feature}\" cheaper (precompute keys, avoid Intl / regex per row), or run it in a Worker`,\n    ],\n  },\n}\n\n/** `DK_ENV_FALLBACK` (§8.3): a missing runtime capability and the fallback used. */\nexport const envDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ENV_FALLBACK',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_ENV_FALLBACK,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAqCP,IAAM,KAAK,CAAC,MAAc,GAAG,EAAE,QAAQ,CAAC,CAAC;AAGlC,IAAM,cAAsE;AAAA,EACjF,iBAAiB;AAAA,IACf,SAAS,CAAC,MACR,GAAG,EAAE,GAAG,GAAG,EAAE,cAAc,SAAY,KAAK,KAAK,KAAK,UAAU,EAAE,SAAS,CAAC,GAAG,mDACpC,EAAE,OAAO;AAAA,IACtD,QAAQ,CAAC,MAAM,kBAAkB,EAAE,QAAQ;AAAA,IAC3C,KAAK,CAAC,MACJ,EAAE,QAAQ,kBACN;AAAA,MACE,wEAAwE,KAAK,UAAU,EAAE,SAAS,CAAC;AAAA,MACnG;AAAA,IACF,IACA;AAAA,MACE,kBAAkB,EAAE,QAAQ,8BAA8B,EAAE,GAAG;AAAA,MAC/D,GAAG,EAAE,GAAG;AAAA,IACV;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,SAAS,CAAC,MACR,GAAG,EAAE,SAAS,qBAAqB,EAAE,QAAQ,EAAE,OAAO,eAAe,GAAG,EAAE,EAAE,CAAC,OAC1E,EAAE,IAAI,mBAAmB,GAAG,EAAE,MAAM,CAAC,yBACvC,EAAE,OACC,KAAK,KAAK,OAAO,EAAE,SAAS,KAAK,GAAG,CAAC,eAAe,EAAE,IAAI,aAAa,EAAE,MAAM,OAC/E;AAAA,IACN,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,UAAU,SACR,qBAAqB,EAAE,OAAO,6DAC9B,yBAAyB,EAAE,OAAO;AAAA,MACtC,EAAE,OACE,QAAQ,EAAE,IAAI,iFACd,6BAA6B,EAAE,OAAO;AAAA,IAC5C;AAAA,EACF;AACF;AAGO,IAAM,iBAAiB;AAAA,EAC5B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}

package/dist/pipeline/perf-codes.cjs

@@ -24,6 +24,7 @@ __export(perf_codes_exports, {
 });
 module.exports = __toCommonJS(perf_codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var import_env_codes = require("./env-codes.cjs");
 var perfDiagnostics = [
   (0, import_catalog.defineDiagnostic)(

package/dist/pipeline/perf-codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/perf-codes.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport { envMessages } from './env-codes'\n\n// Apart from env-codes.ts: only the tracer uses this definition, and the tracer is off in\n// production unless installed (`interceptors: [tracer()]`), so a production bundle without it\n// carries no DK_PERF_HINT.\n\n/** `DK_PERF_HINT` (§8.3): a traced step over its budget (the tracer reports it). */\nexport const perfDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_PERF_HINT',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_PERF_HINT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiC;AACjC,uBAA4B;AAOrB,IAAM,kBAAkB;AAAA,MAC7B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,6BAAY;AAAA,EACzD;AACF;","names":[]}
+{"version":3,"sources":["../../src/pipeline/perf-codes.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { envMessages } from './env-codes'\n\n// Apart from env-codes.ts: only the tracer uses this definition, and the tracer is off in\n// production unless installed (`interceptors: [tracer()]`), so a production bundle without it\n// carries no DK_PERF_HINT.\n\n/** `DK_PERF_HINT` (§8.3): a traced step over its budget (the tracer reports it). */\nexport const perfDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_PERF_HINT',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_PERF_HINT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiC;AACjC,2BAAO;AACP,uBAA4B;AAOrB,IAAM,kBAAkB;AAAA,MAC7B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,6BAAY;AAAA,EACzD;AACF;","names":[]}

package/dist/pipeline/perf-codes.js

@@ -1,5 +1,6 @@
 // src/pipeline/perf-codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 import { envMessages } from "./env-codes.js";
 var perfDiagnostics = [
   defineDiagnostic(

package/dist/pipeline/perf-codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pipeline/perf-codes.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport { envMessages } from './env-codes'\n\n// Apart from env-codes.ts: only the tracer uses this definition, and the tracer is off in\n// production unless installed (`interceptors: [tracer()]`), so a production bundle without it\n// carries no DK_PERF_HINT.\n\n/** `DK_PERF_HINT` (§8.3): a traced step over its budget (the tracer reports it). */\nexport const perfDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_PERF_HINT',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_PERF_HINT,\n  ),\n]\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAOrB,IAAM,kBAAkB;AAAA,EAC7B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}
+{"version":3,"sources":["../../src/pipeline/perf-codes.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { envMessages } from './env-codes'\n\n// Apart from env-codes.ts: only the tracer uses this definition, and the tracer is off in\n// production unless installed (`interceptors: [tracer()]`), so a production bundle without it\n// carries no DK_PERF_HINT.\n\n/** `DK_PERF_HINT` (§8.3): a traced step over its budget (the tracer reports it). */\nexport const perfDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_PERF_HINT',\n      level: 'info',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && envMessages.DK_PERF_HINT,\n  ),\n]\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,OAAO;AACP,SAAS,mBAAmB;AAOrB,IAAM,kBAAkB;AAAA,EAC7B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,YAAY;AAAA,EACzD;AACF;","names":[]}

package/dist/pipeline/runner.cjs

@@ -25,6 +25,8 @@ __export(runner_exports, {
 module.exports = __toCommonJS(runner_exports);
 var import_get_value = require("../column/get-value.cjs");
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
+var import_trace_store = require("../diagnostics/trace-store.cjs");
 var import_codes = require("../feature/codes.cjs");
 var import_cell_issues = require("../ingest/cell-issues.cjs");
 var import_row_key = require("../ingest/row-key.cjs");
@@ -76,7 +78,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) => import_trace_store.sliceTimer.current?.(host.base(), feature, ms)
   });
   function reportCell(col, index, e, field) {
     const name = (0, import_classify.errorName)(e);
@@ -87,7 +90,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 }
@@ -142,7 +145,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 }
@@ -202,6 +205,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);
@@ -245,13 +252,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(import_trace_store.SLICED, true);
         if (process.env.NODE_ENV !== "production" && !(0, import_dev_checks.checkStep)(stepEmit, f.name, input, before, out, data.length)) return input;
         ok = true;
         return out instanceof Uint32Array ? out : input;
@@ -286,11 +294,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;
   }