@datakable/core 1.0.1 → 1.1.0

package/dist/diagnostics/trace-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/trace-store.ts"],"sourcesContent":["import type { Trigger } from './types'\n\n/** One step of the traced run: counts (never rows) and its duration (§9.1: bounded). */\nexport interface TraceStep {\n  readonly input: number\n  readonly output: number\n  readonly ms: number\n}\n\n/** What the tracer kept of the last `pipeline:run` of a table (the last run only). */\nexport interface Trace {\n  readonly run: number\n  readonly trigger: Trigger\n  /** Duration of the whole run; `undefined` while it is in progress. */\n  ms: number | undefined\n  /** Steps that ran (a step served from its memo is absent), by feature name. */\n  readonly steps: Map<string, TraceStep>\n  /** The last `state:dispatch` (its `where`: a method / feature name) and its duration. */\n  dispatch: { where: string; ms: number } | undefined\n}\n\n/** Kept apart from the tracer so `explain()` reads traces without bundling the tracer itself. */\nconst traces = new WeakMap<object, Trace>()\n\n/** The last traced run of `table`, if a tracer is installed. */\nexport const readTrace = (table: object): Trace | undefined => traces.get(table)\n\nexport const writeTrace = (table: object, trace: Trace): void => {\n  traces.set(table, trace)\n}\n"],"mappings":";AAsBA,IAAM,SAAS,oBAAI,QAAuB;AAGnC,IAAM,YAAY,CAAC,UAAqC,OAAO,IAAI,KAAK;AAExE,IAAM,aAAa,CAAC,OAAe,UAAuB;AAC/D,SAAO,IAAI,OAAO,KAAK;AACzB;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/trace-store.ts"],"sourcesContent":["import type { ContextBase } from '../intercept/context'\nimport type { Trigger } from './types'\n\n/** One step of the traced run: counts (never rows) and its duration (§9.1: bounded). */\nexport interface TraceStep {\n  readonly input: number\n  readonly output: number\n  /** With time-sliced work (#61): the runs that waited on it, this one, and the slices between. */\n  readonly ms: number\n  /** Time-sliced work (#61): the runs {@link ms} spans (absent when the step ran in one). */\n  readonly runs?: number\n}\n\n/** What the tracer kept of the last `pipeline:run` of a table (the last run only). */\nexport interface Trace {\n  readonly run: number\n  readonly trigger: Trigger\n  /** Duration of the whole run; `undefined` while it is in progress. */\n  ms: number | undefined\n  /** Steps that ran (a step served from its memo is absent), by feature name. */\n  readonly steps: Map<string, TraceStep>\n  /** The last `state:dispatch` (its `where`: a method / feature name) and its duration. */\n  dispatch: { where: string; ms: number } | undefined\n}\n\n/**\n * Set on the `pipeline:step` ctx's `meta` by the runner when the step waits on time-sliced work\n * (its result comes in a later run).\n */\nexport const SLICED = 'sliced'\n\n/**\n * The tracer's (#61): the runner reports each slice of time-sliced work run between pipeline runs\n * (no step is timing it). Unset until a tracer is created.\n */\nexport const sliceTimer: {\n  current?: ((base: ContextBase, feature: string, ms: number) => void) | undefined\n} = {}\n\n/** Kept apart from the tracer so `explain()` reads traces without bundling the tracer itself. */\nconst traces = new WeakMap<object, Trace>()\n\n/** The last traced run of `table`, if a tracer is installed. */\nexport const readTrace = (table: object): Trace | undefined => traces.get(table)\n\nexport const writeTrace = (table: object, trace: Trace): void => {\n  traces.set(table, trace)\n}\n"],"mappings":";AA6BO,IAAM,SAAS;AAMf,IAAM,aAET,CAAC;AAGL,IAAM,SAAS,oBAAI,QAAuB;AAGnC,IAAM,YAAY,CAAC,UAAqC,OAAO,IAAI,KAAK;AAExE,IAAM,aAAa,CAAC,OAAe,UAAuB;AAC/D,SAAO,IAAI,OAAO,KAAK;AACzB;","names":[]}

package/dist/diagnostics/tracer.cjs

@@ -30,16 +30,70 @@ var import_trace_store = require("./trace-store.cjs");
 var STEP_BUDGET_MS = 50;
 var now = () => typeof performance === "object" && typeof performance?.now === "function" ? performance.now() : Date.now();
 var SEEN = "tracer";
+var work = /* @__PURE__ */ new WeakMap();
+function workOf(table) {
+  let w = work.get(table);
+  if (!w) {
+    w = { jobs: /* @__PURE__ */ new Map(), slots: /* @__PURE__ */ new Map() };
+    work.set(table, w);
+  }
+  return w;
+}
+function hint(emit, w, feature, stage, ms, rows, sliced) {
+  let slot;
+  let top = ["", 0];
+  for (const [where, t] of w.slots) {
+    if (t[1] > top[1]) {
+      slot = where;
+      top = t;
+    }
+  }
+  w.slots.clear();
+  if (ms <= STEP_BUDGET_MS) return;
+  emit("DK_PERF_HINT", {
+    feature,
+    stage,
+    ms,
+    rows,
+    budget: STEP_BUDGET_MS,
+    ...sliced ? { sliced } : {},
+    // Named when it took at least half of the time.
+    ...slot && top[1] * 2 >= ms ? { slot, column: top[0], share: Math.min(1, top[1] / ms) } : {}
+  });
+}
+function onSlice(base, feature, ms) {
+  const table = base.table;
+  const trace = (0, import_trace_store.readTrace)(table);
+  if (!trace) return;
+  const w = workOf(table);
+  const job = w.jobs.get(feature);
+  if (job) job.ms += ms;
+  hint(base.emit, w, feature, job?.stage ?? "", ms, trace.steps.get(feature)?.input ?? 0, true);
+}
 function tracer() {
   (0, import_catalog.keepDiagnostics)(import_perf_codes.perfDiagnostics);
+  import_trace_store.sliceTimer.current = onSlice;
   return {
     name: "tracer",
-    on: ["pipeline:run", "pipeline:step", "state:dispatch"],
+    on: ["pipeline:run", "pipeline:step", "state:dispatch", "column:batch"],
+    // column:batch: one timing per batch of a column, never per cell (§3.4).
+    hot: true,
     intercept(ctx, next) {
       const table = ctx.table;
       if (ctx.meta.has(SEEN) || typeof table !== "object" || table === null) return next();
       ctx.meta.set(SEEN, true);
       const start = now();
+      if (ctx.op === "column:batch") {
+        try {
+          return next();
+        } finally {
+          const slots = workOf(table).slots;
+          const t = slots.get(ctx.where);
+          const ms = now() - start;
+          if (t) t[1] += ms;
+          else slots.set(ctx.where, [ctx.input.column, ms]);
+        }
+      }
       if (ctx.op === "pipeline:run") {
         const trace = {
           run: ctx.run,
@@ -56,25 +110,32 @@ function tracer() {
         }
       }
       if (ctx.op === "pipeline:step") {
+        const w = workOf(table);
+        w.slots.clear();
         const out = next();
-        const ms = now() - start;
+        const own = now() - start;
+        const { feature, stage, indices } = ctx.input;
+        const pending = w.jobs;
+        const job = pending.get(feature);
+        let ms = own;
+        let runs;
+        if (ctx.meta.has(import_trace_store.SLICED)) {
+          pending.set(feature, { stage, ms: (job?.ms ?? 0) + own, runs: (job?.runs ?? 0) + 1 });
+        } else if (job) {
+          pending.delete(feature);
+          ms += job.ms;
+          runs = job.runs + 1;
+        }
         const trace = (0, import_trace_store.readTrace)(table);
         if (trace?.run === ctx.run) {
-          trace.steps.set(ctx.input.feature, {
-            input: ctx.input.indices.length,
+          trace.steps.set(feature, {
+            input: indices.length,
             output: out.length,
-            ms
-          });
-        }
-        if (ms > STEP_BUDGET_MS) {
-          ctx.emit("DK_PERF_HINT", {
-            feature: ctx.input.feature,
-            stage: ctx.input.stage,
             ms,
-            rows: ctx.input.indices.length,
-            budget: STEP_BUDGET_MS
+            ...runs ? { runs } : {}
           });
         }
+        hint(ctx.emit, w, feature, stage, own, indices.length, false);
         return out;
       }
       try {

package/dist/diagnostics/tracer.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/tracer.ts"],"sourcesContent":["import type { Interceptor } from '../intercept/define'\nimport { perfDiagnostics } from '../pipeline/perf-codes'\nimport { keepDiagnostics } from './catalog'\nimport { readTrace, type Trace, writeTrace } from './trace-store'\n\n/**\n * The longest a single step may take (ms): §9.3's longest-task budget. A traced step over it\n * reports `DK_PERF_HINT` (§8.3) with its numbers.\n */\nexport const STEP_BUDGET_MS = 50\n\ntype Traced = 'pipeline:run' | 'pipeline:step' | 'state:dispatch'\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\n/** Set on the ctx by the first tracer of a chain: a second one (user + built-in) only passes on. */\nconst SEEN = 'tracer'\n\n/**\n * The `tracer` interceptor (§3.4): timings and per-step counts of the last pipeline run, read by\n * `table.explain()`. `createTable` installs it in development; in production it is off (§8.2) and\n * opt-in with `createTable({ interceptors: [tracer()] })`. Keeps the last run only: counts, never\n * rows.\n */\nexport function tracer(): Interceptor<Traced> {\n  // Inside the factory: a bundle that never creates a tracer drops the definition (§9.1).\n  keepDiagnostics(perfDiagnostics)\n  return {\n    name: 'tracer',\n    on: ['pipeline:run', 'pipeline:step', 'state:dispatch'],\n    intercept(ctx, next) {\n      const table = ctx.table\n      if (ctx.meta.has(SEEN) || typeof table !== 'object' || table === null) return next()\n      ctx.meta.set(SEEN, true)\n      const start = now()\n      if (ctx.op === 'pipeline:run') {\n        const trace: Trace = {\n          run: ctx.run,\n          trigger: ctx.trigger,\n          ms: undefined,\n          steps: new Map(),\n          dispatch: readTrace(table)?.dispatch,\n        }\n        writeTrace(table, trace)\n        try {\n          return next()\n        } finally {\n          trace.ms = now() - start\n        }\n      }\n      if (ctx.op === 'pipeline:step') {\n        const out = next() as Uint32Array\n        const ms = now() - start\n        const trace = readTrace(table)\n        if (trace?.run === ctx.run) {\n          trace.steps.set(ctx.input.feature, {\n            input: ctx.input.indices.length,\n            output: out.length,\n            ms,\n          })\n        }\n        if (ms > STEP_BUDGET_MS) {\n          ctx.emit('DK_PERF_HINT', {\n            feature: ctx.input.feature,\n            stage: ctx.input.stage,\n            ms,\n            rows: ctx.input.indices.length,\n            budget: STEP_BUDGET_MS,\n          })\n        }\n        return out\n      }\n      try {\n        return next()\n      } finally {\n        const dispatch = { where: ctx.where, ms: now() - start }\n        const trace = readTrace(table)\n        // Before the first (lazy) run: kept on an empty trace until a run carries it over.\n        if (trace) trace.dispatch = dispatch\n        else {\n          writeTrace(table, {\n            run: ctx.run,\n            trigger: ctx.trigger,\n            ms: undefined,\n            steps: new Map(),\n            dispatch,\n          })\n        }\n      }\n    },\n  } as Interceptor<Traced>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,wBAAgC;AAChC,qBAAgC;AAChC,yBAAkD;AAM3C,IAAM,iBAAiB;AAI9B,IAAM,MAAM,MACV,OAAO,gBAAgB,YAAY,OAAO,aAAa,QAAQ,aAC3D,YAAY,IAAI,IAChB,KAAK,IAAI;AAGf,IAAM,OAAO;AAQN,SAAS,SAA8B;AAE5C,sCAAgB,iCAAe;AAC/B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,CAAC,gBAAgB,iBAAiB,gBAAgB;AAAA,IACtD,UAAU,KAAK,MAAM;AACnB,YAAM,QAAQ,IAAI;AAClB,UAAI,IAAI,KAAK,IAAI,IAAI,KAAK,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO,KAAK;AACnF,UAAI,KAAK,IAAI,MAAM,IAAI;AACvB,YAAM,QAAQ,IAAI;AAClB,UAAI,IAAI,OAAO,gBAAgB;AAC7B,cAAM,QAAe;AAAA,UACnB,KAAK,IAAI;AAAA,UACT,SAAS,IAAI;AAAA,UACb,IAAI;AAAA,UACJ,OAAO,oBAAI,IAAI;AAAA,UACf,cAAU,8BAAU,KAAK,GAAG;AAAA,QAC9B;AACA,2CAAW,OAAO,KAAK;AACvB,YAAI;AACF,iBAAO,KAAK;AAAA,QACd,UAAE;AACA,gBAAM,KAAK,IAAI,IAAI;AAAA,QACrB;AAAA,MACF;AACA,UAAI,IAAI,OAAO,iBAAiB;AAC9B,cAAM,MAAM,KAAK;AACjB,cAAM,KAAK,IAAI,IAAI;AACnB,cAAM,YAAQ,8BAAU,KAAK;AAC7B,YAAI,OAAO,QAAQ,IAAI,KAAK;AAC1B,gBAAM,MAAM,IAAI,IAAI,MAAM,SAAS;AAAA,YACjC,OAAO,IAAI,MAAM,QAAQ;AAAA,YACzB,QAAQ,IAAI;AAAA,YACZ;AAAA,UACF,CAAC;AAAA,QACH;AACA,YAAI,KAAK,gBAAgB;AACvB,cAAI,KAAK,gBAAgB;AAAA,YACvB,SAAS,IAAI,MAAM;AAAA,YACnB,OAAO,IAAI,MAAM;AAAA,YACjB;AAAA,YACA,MAAM,IAAI,MAAM,QAAQ;AAAA,YACxB,QAAQ;AAAA,UACV,CAAC;AAAA,QACH;AACA,eAAO;AAAA,MACT;AACA,UAAI;AACF,eAAO,KAAK;AAAA,MACd,UAAE;AACA,cAAM,WAAW,EAAE,OAAO,IAAI,OAAO,IAAI,IAAI,IAAI,MAAM;AACvD,cAAM,YAAQ,8BAAU,KAAK;AAE7B,YAAI,MAAO,OAAM,WAAW;AAAA,aACvB;AACH,6CAAW,OAAO;AAAA,YAChB,KAAK,IAAI;AAAA,YACT,SAAS,IAAI;AAAA,YACb,IAAI;AAAA,YACJ,OAAO,oBAAI,IAAI;AAAA,YACf;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/tracer.ts"],"sourcesContent":["import type { ContextBase } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { perfDiagnostics } from '../pipeline/perf-codes'\nimport { keepDiagnostics } from './catalog'\nimport { readTrace, SLICED, sliceTimer, type Trace, writeTrace } from './trace-store'\nimport type { Emit } from './types'\n\n/**\n * The longest a single step may take (ms): §9.3's longest-task budget. A traced step over it\n * reports `DK_PERF_HINT` (§8.3) with its numbers.\n */\nexport const STEP_BUDGET_MS = 50\n\ntype Traced = 'pipeline:run' | 'pipeline:step' | 'state:dispatch' | 'column:batch'\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\n/** Set on the ctx by the first tracer of a chain: a second one (user + built-in) only passes on. */\nconst SEEN = 'tracer'\n\n/**\n * Per table, across runs (#61): a step waiting on time-sliced work, by feature: its stage, the\n * time of its runs so far plus the slices since, and how many runs. The run that gets the result\n * adds its own time and shows the total.\n */\ntype Job = { stage: string; ms: number; runs: number }\n\n/**\n * Per table: its steps waiting on sliced work, and the time of each `column:batch` slot\n * (`columns[0].format` → column id, ms) since the current step or slice began (#62).\n */\ntype Work = { jobs: Map<string, Job>; slots: Map<string, [string, number]> }\nconst work = new WeakMap<object, Work>()\n\nfunction workOf(table: object): Work {\n  let w = work.get(table)\n  if (!w) {\n    w = { jobs: new Map(), slots: new Map() }\n    work.set(table, w)\n  }\n  return w\n}\n\n/** DK_PERF_HINT for a task over the budget, with the slot most of its time went to (#62). */\nfunction hint(\n  emit: Emit,\n  w: Work,\n  feature: string,\n  stage: string,\n  ms: number,\n  rows: number,\n  sliced: boolean,\n) {\n  let slot: string | undefined\n  let top: [string, number] = ['', 0]\n  for (const [where, t] of w.slots) {\n    if (t[1] > top[1]) {\n      slot = where\n      top = t\n    }\n  }\n  w.slots.clear()\n  if (ms <= STEP_BUDGET_MS) return\n  emit('DK_PERF_HINT', {\n    feature,\n    stage,\n    ms,\n    rows,\n    budget: STEP_BUDGET_MS,\n    ...(sliced ? { sliced } : {}),\n    // Named when it took at least half of the time.\n    ...(slot && top[1] * 2 >= ms ? { slot, column: top[0], share: Math.min(1, top[1] / ms) } : {}),\n  })\n}\n\n/** A slice of time-sliced work, run between pipeline runs (#61): its own task. */\nfunction onSlice(base: ContextBase, feature: string, ms: number) {\n  const table = base.table as object\n  const trace = readTrace(table)\n  // Only for tables this tracer (or another) traces.\n  if (!trace) return\n  const w = workOf(table)\n  const job = w.jobs.get(feature)\n  if (job) job.ms += ms\n  hint(base.emit, w, feature, job?.stage ?? '', ms, trace.steps.get(feature)?.input ?? 0, true)\n}\n\n/**\n * The `tracer` interceptor (§3.4): timings and per-step counts of the last pipeline run, read by\n * `table.explain()`. `createTable` installs it in development; in production it is off (§8.2) and\n * opt-in with `createTable({ interceptors: [tracer()] })`. Keeps the last run only: counts, never\n * rows. Time-sliced work (§9.1) is added to the step that waited on it (#61).\n */\nexport function tracer(): Interceptor<Traced> {\n  // Inside the factory: a bundle that never creates a tracer drops the definition (§9.1).\n  keepDiagnostics(perfDiagnostics)\n  sliceTimer.current = onSlice\n  return {\n    name: 'tracer',\n    on: ['pipeline:run', 'pipeline:step', 'state:dispatch', 'column:batch'],\n    // column:batch: one timing per batch of a column, never per cell (§3.4).\n    hot: true,\n    intercept(ctx, next) {\n      const table = ctx.table\n      if (ctx.meta.has(SEEN) || typeof table !== 'object' || table === null) return next()\n      ctx.meta.set(SEEN, true)\n      const start = now()\n      if (ctx.op === 'column:batch') {\n        try {\n          return next()\n        } finally {\n          const slots = workOf(table).slots\n          const t = slots.get(ctx.where)\n          const ms = now() - start\n          if (t) t[1] += ms\n          else slots.set(ctx.where, [ctx.input.column, ms])\n        }\n      }\n      if (ctx.op === 'pipeline:run') {\n        const trace: Trace = {\n          run: ctx.run,\n          trigger: ctx.trigger,\n          ms: undefined,\n          steps: new Map(),\n          dispatch: readTrace(table)?.dispatch,\n        }\n        writeTrace(table, trace)\n        try {\n          return next()\n        } finally {\n          trace.ms = now() - start\n        }\n      }\n      if (ctx.op === 'pipeline:step') {\n        const w = workOf(table)\n        w.slots.clear()\n        const out = next() as Uint32Array\n        const own = now() - start\n        const { feature, stage, indices } = ctx.input\n        const pending = w.jobs\n        const job = pending.get(feature)\n        let ms = own\n        let runs: number | undefined\n        if (ctx.meta.has(SLICED)) {\n          // Its result comes in a later run: that run shows the total.\n          pending.set(feature, { stage, ms: (job?.ms ?? 0) + own, runs: (job?.runs ?? 0) + 1 })\n        } else if (job) {\n          pending.delete(feature)\n          ms += job.ms\n          runs = job.runs + 1\n        }\n        const trace = readTrace(table)\n        if (trace?.run === ctx.run) {\n          trace.steps.set(feature, {\n            input: indices.length,\n            output: out.length,\n            ms,\n            ...(runs ? { runs } : {}),\n          })\n        }\n        // One task: the step's own time.\n        hint(ctx.emit, w, feature, stage, own, indices.length, false)\n        return out\n      }\n      try {\n        return next()\n      } finally {\n        const dispatch = { where: ctx.where, ms: now() - start }\n        const trace = readTrace(table)\n        // Before the first (lazy) run: kept on an empty trace until a run carries it over.\n        if (trace) trace.dispatch = dispatch\n        else {\n          writeTrace(table, {\n            run: ctx.run,\n            trigger: ctx.trigger,\n            ms: undefined,\n            steps: new Map(),\n            dispatch,\n          })\n        }\n      }\n    },\n  } as Interceptor<Traced>\n}\n"],"mappings":"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","names":[]}

package/dist/diagnostics/tracer.js

@@ -1,20 +1,74 @@
 // src/diagnostics/tracer.ts
 import { perfDiagnostics } from "../pipeline/perf-codes.js";
 import { keepDiagnostics } from "./catalog.js";
-import { readTrace, writeTrace } from "./trace-store.js";
+import { readTrace, SLICED, sliceTimer, writeTrace } from "./trace-store.js";
 var STEP_BUDGET_MS = 50;
 var now = () => typeof performance === "object" && typeof performance?.now === "function" ? performance.now() : Date.now();
 var SEEN = "tracer";
+var work = /* @__PURE__ */ new WeakMap();
+function workOf(table) {
+  let w = work.get(table);
+  if (!w) {
+    w = { jobs: /* @__PURE__ */ new Map(), slots: /* @__PURE__ */ new Map() };
+    work.set(table, w);
+  }
+  return w;
+}
+function hint(emit, w, feature, stage, ms, rows, sliced) {
+  let slot;
+  let top = ["", 0];
+  for (const [where, t] of w.slots) {
+    if (t[1] > top[1]) {
+      slot = where;
+      top = t;
+    }
+  }
+  w.slots.clear();
+  if (ms <= STEP_BUDGET_MS) return;
+  emit("DK_PERF_HINT", {
+    feature,
+    stage,
+    ms,
+    rows,
+    budget: STEP_BUDGET_MS,
+    ...sliced ? { sliced } : {},
+    // Named when it took at least half of the time.
+    ...slot && top[1] * 2 >= ms ? { slot, column: top[0], share: Math.min(1, top[1] / ms) } : {}
+  });
+}
+function onSlice(base, feature, ms) {
+  const table = base.table;
+  const trace = readTrace(table);
+  if (!trace) return;
+  const w = workOf(table);
+  const job = w.jobs.get(feature);
+  if (job) job.ms += ms;
+  hint(base.emit, w, feature, job?.stage ?? "", ms, trace.steps.get(feature)?.input ?? 0, true);
+}
 function tracer() {
   keepDiagnostics(perfDiagnostics);
+  sliceTimer.current = onSlice;
   return {
     name: "tracer",
-    on: ["pipeline:run", "pipeline:step", "state:dispatch"],
+    on: ["pipeline:run", "pipeline:step", "state:dispatch", "column:batch"],
+    // column:batch: one timing per batch of a column, never per cell (§3.4).
+    hot: true,
     intercept(ctx, next) {
       const table = ctx.table;
       if (ctx.meta.has(SEEN) || typeof table !== "object" || table === null) return next();
       ctx.meta.set(SEEN, true);
       const start = now();
+      if (ctx.op === "column:batch") {
+        try {
+          return next();
+        } finally {
+          const slots = workOf(table).slots;
+          const t = slots.get(ctx.where);
+          const ms = now() - start;
+          if (t) t[1] += ms;
+          else slots.set(ctx.where, [ctx.input.column, ms]);
+        }
+      }
       if (ctx.op === "pipeline:run") {
         const trace = {
           run: ctx.run,
@@ -31,25 +85,32 @@ function tracer() {
         }
       }
       if (ctx.op === "pipeline:step") {
+        const w = workOf(table);
+        w.slots.clear();
         const out = next();
-        const ms = now() - start;
+        const own = now() - start;
+        const { feature, stage, indices } = ctx.input;
+        const pending = w.jobs;
+        const job = pending.get(feature);
+        let ms = own;
+        let runs;
+        if (ctx.meta.has(SLICED)) {
+          pending.set(feature, { stage, ms: (job?.ms ?? 0) + own, runs: (job?.runs ?? 0) + 1 });
+        } else if (job) {
+          pending.delete(feature);
+          ms += job.ms;
+          runs = job.runs + 1;
+        }
         const trace = readTrace(table);
         if (trace?.run === ctx.run) {
-          trace.steps.set(ctx.input.feature, {
-            input: ctx.input.indices.length,
+          trace.steps.set(feature, {
+            input: indices.length,
             output: out.length,
-            ms
-          });
-        }
-        if (ms > STEP_BUDGET_MS) {
-          ctx.emit("DK_PERF_HINT", {
-            feature: ctx.input.feature,
-            stage: ctx.input.stage,
             ms,
-            rows: ctx.input.indices.length,
-            budget: STEP_BUDGET_MS
+            ...runs ? { runs } : {}
           });
         }
+        hint(ctx.emit, w, feature, stage, own, indices.length, false);
         return out;
       }
       try {

package/dist/diagnostics/tracer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/tracer.ts"],"sourcesContent":["import type { Interceptor } from '../intercept/define'\nimport { perfDiagnostics } from '../pipeline/perf-codes'\nimport { keepDiagnostics } from './catalog'\nimport { readTrace, type Trace, writeTrace } from './trace-store'\n\n/**\n * The longest a single step may take (ms): §9.3's longest-task budget. A traced step over it\n * reports `DK_PERF_HINT` (§8.3) with its numbers.\n */\nexport const STEP_BUDGET_MS = 50\n\ntype Traced = 'pipeline:run' | 'pipeline:step' | 'state:dispatch'\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\n/** Set on the ctx by the first tracer of a chain: a second one (user + built-in) only passes on. */\nconst SEEN = 'tracer'\n\n/**\n * The `tracer` interceptor (§3.4): timings and per-step counts of the last pipeline run, read by\n * `table.explain()`. `createTable` installs it in development; in production it is off (§8.2) and\n * opt-in with `createTable({ interceptors: [tracer()] })`. Keeps the last run only: counts, never\n * rows.\n */\nexport function tracer(): Interceptor<Traced> {\n  // Inside the factory: a bundle that never creates a tracer drops the definition (§9.1).\n  keepDiagnostics(perfDiagnostics)\n  return {\n    name: 'tracer',\n    on: ['pipeline:run', 'pipeline:step', 'state:dispatch'],\n    intercept(ctx, next) {\n      const table = ctx.table\n      if (ctx.meta.has(SEEN) || typeof table !== 'object' || table === null) return next()\n      ctx.meta.set(SEEN, true)\n      const start = now()\n      if (ctx.op === 'pipeline:run') {\n        const trace: Trace = {\n          run: ctx.run,\n          trigger: ctx.trigger,\n          ms: undefined,\n          steps: new Map(),\n          dispatch: readTrace(table)?.dispatch,\n        }\n        writeTrace(table, trace)\n        try {\n          return next()\n        } finally {\n          trace.ms = now() - start\n        }\n      }\n      if (ctx.op === 'pipeline:step') {\n        const out = next() as Uint32Array\n        const ms = now() - start\n        const trace = readTrace(table)\n        if (trace?.run === ctx.run) {\n          trace.steps.set(ctx.input.feature, {\n            input: ctx.input.indices.length,\n            output: out.length,\n            ms,\n          })\n        }\n        if (ms > STEP_BUDGET_MS) {\n          ctx.emit('DK_PERF_HINT', {\n            feature: ctx.input.feature,\n            stage: ctx.input.stage,\n            ms,\n            rows: ctx.input.indices.length,\n            budget: STEP_BUDGET_MS,\n          })\n        }\n        return out\n      }\n      try {\n        return next()\n      } finally {\n        const dispatch = { where: ctx.where, ms: now() - start }\n        const trace = readTrace(table)\n        // Before the first (lazy) run: kept on an empty trace until a run carries it over.\n        if (trace) trace.dispatch = dispatch\n        else {\n          writeTrace(table, {\n            run: ctx.run,\n            trigger: ctx.trigger,\n            ms: undefined,\n            steps: new Map(),\n            dispatch,\n          })\n        }\n      }\n    },\n  } as Interceptor<Traced>\n}\n"],"mappings":";AACA,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAChC,SAAS,WAAuB,kBAAkB;AAM3C,IAAM,iBAAiB;AAI9B,IAAM,MAAM,MACV,OAAO,gBAAgB,YAAY,OAAO,aAAa,QAAQ,aAC3D,YAAY,IAAI,IAChB,KAAK,IAAI;AAGf,IAAM,OAAO;AAQN,SAAS,SAA8B;AAE5C,kBAAgB,eAAe;AAC/B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,CAAC,gBAAgB,iBAAiB,gBAAgB;AAAA,IACtD,UAAU,KAAK,MAAM;AACnB,YAAM,QAAQ,IAAI;AAClB,UAAI,IAAI,KAAK,IAAI,IAAI,KAAK,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO,KAAK;AACnF,UAAI,KAAK,IAAI,MAAM,IAAI;AACvB,YAAM,QAAQ,IAAI;AAClB,UAAI,IAAI,OAAO,gBAAgB;AAC7B,cAAM,QAAe;AAAA,UACnB,KAAK,IAAI;AAAA,UACT,SAAS,IAAI;AAAA,UACb,IAAI;AAAA,UACJ,OAAO,oBAAI,IAAI;AAAA,UACf,UAAU,UAAU,KAAK,GAAG;AAAA,QAC9B;AACA,mBAAW,OAAO,KAAK;AACvB,YAAI;AACF,iBAAO,KAAK;AAAA,QACd,UAAE;AACA,gBAAM,KAAK,IAAI,IAAI;AAAA,QACrB;AAAA,MACF;AACA,UAAI,IAAI,OAAO,iBAAiB;AAC9B,cAAM,MAAM,KAAK;AACjB,cAAM,KAAK,IAAI,IAAI;AACnB,cAAM,QAAQ,UAAU,KAAK;AAC7B,YAAI,OAAO,QAAQ,IAAI,KAAK;AAC1B,gBAAM,MAAM,IAAI,IAAI,MAAM,SAAS;AAAA,YACjC,OAAO,IAAI,MAAM,QAAQ;AAAA,YACzB,QAAQ,IAAI;AAAA,YACZ;AAAA,UACF,CAAC;AAAA,QACH;AACA,YAAI,KAAK,gBAAgB;AACvB,cAAI,KAAK,gBAAgB;AAAA,YACvB,SAAS,IAAI,MAAM;AAAA,YACnB,OAAO,IAAI,MAAM;AAAA,YACjB;AAAA,YACA,MAAM,IAAI,MAAM,QAAQ;AAAA,YACxB,QAAQ;AAAA,UACV,CAAC;AAAA,QACH;AACA,eAAO;AAAA,MACT;AACA,UAAI;AACF,eAAO,KAAK;AAAA,MACd,UAAE;AACA,cAAM,WAAW,EAAE,OAAO,IAAI,OAAO,IAAI,IAAI,IAAI,MAAM;AACvD,cAAM,QAAQ,UAAU,KAAK;AAE7B,YAAI,MAAO,OAAM,WAAW;AAAA,aACvB;AACH,qBAAW,OAAO;AAAA,YAChB,KAAK,IAAI;AAAA,YACT,SAAS,IAAI;AAAA,YACb,IAAI;AAAA,YACJ,OAAO,oBAAI,IAAI;AAAA,YACf;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/tracer.ts"],"sourcesContent":["import type { ContextBase } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { perfDiagnostics } from '../pipeline/perf-codes'\nimport { keepDiagnostics } from './catalog'\nimport { readTrace, SLICED, sliceTimer, type Trace, writeTrace } from './trace-store'\nimport type { Emit } from './types'\n\n/**\n * The longest a single step may take (ms): §9.3's longest-task budget. A traced step over it\n * reports `DK_PERF_HINT` (§8.3) with its numbers.\n */\nexport const STEP_BUDGET_MS = 50\n\ntype Traced = 'pipeline:run' | 'pipeline:step' | 'state:dispatch' | 'column:batch'\n\nconst now = (): number =>\n  typeof performance === 'object' && typeof performance?.now === 'function'\n    ? performance.now()\n    : Date.now()\n\n/** Set on the ctx by the first tracer of a chain: a second one (user + built-in) only passes on. */\nconst SEEN = 'tracer'\n\n/**\n * Per table, across runs (#61): a step waiting on time-sliced work, by feature: its stage, the\n * time of its runs so far plus the slices since, and how many runs. The run that gets the result\n * adds its own time and shows the total.\n */\ntype Job = { stage: string; ms: number; runs: number }\n\n/**\n * Per table: its steps waiting on sliced work, and the time of each `column:batch` slot\n * (`columns[0].format` → column id, ms) since the current step or slice began (#62).\n */\ntype Work = { jobs: Map<string, Job>; slots: Map<string, [string, number]> }\nconst work = new WeakMap<object, Work>()\n\nfunction workOf(table: object): Work {\n  let w = work.get(table)\n  if (!w) {\n    w = { jobs: new Map(), slots: new Map() }\n    work.set(table, w)\n  }\n  return w\n}\n\n/** DK_PERF_HINT for a task over the budget, with the slot most of its time went to (#62). */\nfunction hint(\n  emit: Emit,\n  w: Work,\n  feature: string,\n  stage: string,\n  ms: number,\n  rows: number,\n  sliced: boolean,\n) {\n  let slot: string | undefined\n  let top: [string, number] = ['', 0]\n  for (const [where, t] of w.slots) {\n    if (t[1] > top[1]) {\n      slot = where\n      top = t\n    }\n  }\n  w.slots.clear()\n  if (ms <= STEP_BUDGET_MS) return\n  emit('DK_PERF_HINT', {\n    feature,\n    stage,\n    ms,\n    rows,\n    budget: STEP_BUDGET_MS,\n    ...(sliced ? { sliced } : {}),\n    // Named when it took at least half of the time.\n    ...(slot && top[1] * 2 >= ms ? { slot, column: top[0], share: Math.min(1, top[1] / ms) } : {}),\n  })\n}\n\n/** A slice of time-sliced work, run between pipeline runs (#61): its own task. */\nfunction onSlice(base: ContextBase, feature: string, ms: number) {\n  const table = base.table as object\n  const trace = readTrace(table)\n  // Only for tables this tracer (or another) traces.\n  if (!trace) return\n  const w = workOf(table)\n  const job = w.jobs.get(feature)\n  if (job) job.ms += ms\n  hint(base.emit, w, feature, job?.stage ?? '', ms, trace.steps.get(feature)?.input ?? 0, true)\n}\n\n/**\n * The `tracer` interceptor (§3.4): timings and per-step counts of the last pipeline run, read by\n * `table.explain()`. `createTable` installs it in development; in production it is off (§8.2) and\n * opt-in with `createTable({ interceptors: [tracer()] })`. Keeps the last run only: counts, never\n * rows. Time-sliced work (§9.1) is added to the step that waited on it (#61).\n */\nexport function tracer(): Interceptor<Traced> {\n  // Inside the factory: a bundle that never creates a tracer drops the definition (§9.1).\n  keepDiagnostics(perfDiagnostics)\n  sliceTimer.current = onSlice\n  return {\n    name: 'tracer',\n    on: ['pipeline:run', 'pipeline:step', 'state:dispatch', 'column:batch'],\n    // column:batch: one timing per batch of a column, never per cell (§3.4).\n    hot: true,\n    intercept(ctx, next) {\n      const table = ctx.table\n      if (ctx.meta.has(SEEN) || typeof table !== 'object' || table === null) return next()\n      ctx.meta.set(SEEN, true)\n      const start = now()\n      if (ctx.op === 'column:batch') {\n        try {\n          return next()\n        } finally {\n          const slots = workOf(table).slots\n          const t = slots.get(ctx.where)\n          const ms = now() - start\n          if (t) t[1] += ms\n          else slots.set(ctx.where, [ctx.input.column, ms])\n        }\n      }\n      if (ctx.op === 'pipeline:run') {\n        const trace: Trace = {\n          run: ctx.run,\n          trigger: ctx.trigger,\n          ms: undefined,\n          steps: new Map(),\n          dispatch: readTrace(table)?.dispatch,\n        }\n        writeTrace(table, trace)\n        try {\n          return next()\n        } finally {\n          trace.ms = now() - start\n        }\n      }\n      if (ctx.op === 'pipeline:step') {\n        const w = workOf(table)\n        w.slots.clear()\n        const out = next() as Uint32Array\n        const own = now() - start\n        const { feature, stage, indices } = ctx.input\n        const pending = w.jobs\n        const job = pending.get(feature)\n        let ms = own\n        let runs: number | undefined\n        if (ctx.meta.has(SLICED)) {\n          // Its result comes in a later run: that run shows the total.\n          pending.set(feature, { stage, ms: (job?.ms ?? 0) + own, runs: (job?.runs ?? 0) + 1 })\n        } else if (job) {\n          pending.delete(feature)\n          ms += job.ms\n          runs = job.runs + 1\n        }\n        const trace = readTrace(table)\n        if (trace?.run === ctx.run) {\n          trace.steps.set(feature, {\n            input: indices.length,\n            output: out.length,\n            ms,\n            ...(runs ? { runs } : {}),\n          })\n        }\n        // One task: the step's own time.\n        hint(ctx.emit, w, feature, stage, own, indices.length, false)\n        return out\n      }\n      try {\n        return next()\n      } finally {\n        const dispatch = { where: ctx.where, ms: now() - start }\n        const trace = readTrace(table)\n        // Before the first (lazy) run: kept on an empty trace until a run carries it over.\n        if (trace) trace.dispatch = dispatch\n        else {\n          writeTrace(table, {\n            run: ctx.run,\n            trigger: ctx.trigger,\n            ms: undefined,\n            steps: new Map(),\n            dispatch,\n          })\n        }\n      }\n    },\n  } as Interceptor<Traced>\n}\n"],"mappings":"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","names":[]}

package/dist/diagnostics/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/types.ts"],"sourcesContent":["import type { DiagnosticCode, DiagnosticDetails } from './catalog'\n\nexport type { DiagnosticCode, DiagnosticDetails } from './catalog'\n\nexport type DiagnosticLevel = 'error' | 'warn' | 'info'\n\nexport type Trigger = 'init' | 'data-change' | 'setOptions' | 'hydrate' | 'fetch' | `api:${string}`\n\nexport type Phase = 'ssr' | 'hydrate' | 'client'\n\n/**\n * Where in the developer's code or data (§8.1). `interceptor` and `operation` are additions for\n * plugin-level codes the spec table does not locate (interceptors, op registry).\n */\nexport type Location =\n  | { kind: 'column'; index: number; id: string }\n  | { kind: 'feature'; name: string }\n  | { kind: 'option'; path: string }\n  | { kind: 'row'; index: number; key?: string }\n  | { kind: 'interceptor'; name: string; op: string }\n  | { kind: 'operation'; op: string; slot?: string }\n\n/** A summary of table state — never raw input (§8.1). */\nexport interface DiagnosticStateSummary {\n  searchLength: number\n  activeFilters: string[]\n  sort: string[]\n  page: number\n}\n\nexport interface DiagnosticContext {\n  /** `options.name`, else `table#n`. */\n  table: string\n  /** Dev: creation site, e.g. `UsersPage.tsx:42`. */\n  createdAt?: string\n  /** `@datakable/core@x.y.z` */\n  package: string\n  trigger: Trigger\n  /** Pipeline run id — joins explain() and other diagnostics. */\n  run: number\n  phase: Phase\n  mode: Record<string, 'client' | 'server'>\n  state: DiagnosticStateSummary\n  occurrences: { count: number; first: number; last: number }\n  /** e.g. `DK_SCHEMA_INVALID_ROW#run57` */\n  causedBy?: string\n  /** Original error (ES2022 cause). Reaches `onDiagnostic` only; `toJSON` and the console leave it out. */\n  cause?: unknown\n}\n\nexport interface Diagnostic {\n  /** Stable public API; never reused or redefined. */\n  code: DiagnosticCode\n  level: DiagnosticLevel\n  /** What happened, instance-specific. Empty in production unless messages are opted in. */\n  problem: string\n  where: Location\n  /** Consequence + the fallback the system applied. */\n  impact: string\n  /** Concrete fixes, best first. */\n  fix: string[]\n  /** `docs/errors.md#<code>` (+ query params in production). */\n  docs: string\n  /** The catalog details. Redaction (T26) rewrites them before any sink sees them. */\n  details: Record<string, unknown>\n  context: DiagnosticContext\n  /** `code@where` — grouping key (dedupe, Sentry). */\n  fingerprint: string\n  /** Safe serializer: bigint, cycles and Errors never throw; `context.cause` is left out. */\n  toJSON(): object\n}\n\n/** Per-call additions to the live context. */\nexport interface EmitOptions {\n  cause?: unknown\n  causedBy?: string\n  run?: number\n  trigger?: Trigger\n  phase?: Phase\n}\n\n/** Emits a catalog diagnostic; `details` is typed by `code` (see `DiagnosticCatalog`). */\nexport type Emit = <C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  options?: EmitOptions,\n) => void\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/types.ts"],"sourcesContent":["import type { DiagnosticCode, DiagnosticDetails } from './catalog'\n\nexport type { DiagnosticCode, DiagnosticDetails } from './catalog'\n\nexport type DiagnosticLevel = 'error' | 'warn' | 'info'\n\nexport type Trigger = 'init' | 'data-change' | 'setOptions' | 'hydrate' | 'fetch' | `api:${string}`\n\nexport type Phase = 'ssr' | 'hydrate' | 'client'\n\n/**\n * Where in the developer's code or data (§8.1). `interceptor` and `operation` are additions for\n * plugin-level codes the spec table does not locate (interceptors, op registry).\n */\nexport type Location =\n  | { kind: 'column'; index: number; id: string }\n  | { kind: 'feature'; name: string }\n  | { kind: 'option'; path: string }\n  | { kind: 'row'; index: number; key?: string }\n  | { kind: 'interceptor'; name: string; op: string }\n  | { kind: 'operation'; op: string; slot?: string }\n\n/** A summary of table state — never raw input (§8.1). */\nexport interface DiagnosticStateSummary {\n  searchLength: number\n  activeFilters: string[]\n  sort: string[]\n  page: number\n}\n\nexport interface DiagnosticContext {\n  /** `options.name`, else `table#n`. */\n  table: string\n  /** Dev: creation site, e.g. `UsersPage.tsx:42`. */\n  createdAt?: string\n  /** `@datakable/core@x.y.z` */\n  package: string\n  trigger: Trigger\n  /** Pipeline run id — joins explain() and other diagnostics. */\n  run: number\n  phase: Phase\n  mode: Record<string, 'client' | 'server'>\n  state: DiagnosticStateSummary\n  occurrences: { count: number; first: number; last: number }\n  /** e.g. `DK_SCHEMA_INVALID_ROW#run57` */\n  causedBy?: string\n  /** Original error (ES2022 cause). Reaches `onDiagnostic` only; `toJSON` and the console leave it out. */\n  cause?: unknown\n}\n\nexport interface Diagnostic {\n  /** Stable public API; never reused or redefined. */\n  code: DiagnosticCode\n  level: DiagnosticLevel\n  /** What happened, instance-specific. Empty in production unless messages are opted in. */\n  problem: string\n  where: Location\n  /** Consequence + the fallback the system applied. */\n  impact: string\n  /** Concrete fixes, best first. */\n  fix: string[]\n  /** `docs/errors.md#<code>` (+ query params in production). */\n  docs: string\n  /** The catalog details. Redaction (T26) rewrites them before any sink sees them. */\n  details: Record<string, unknown>\n  context: DiagnosticContext\n  /** `code@where` — grouping key (dedupe, Sentry). */\n  fingerprint: string\n  /** Safe serializer: bigint, cycles and Errors never throw; `context.cause` is left out. */\n  toJSON(): object\n}\n\n/** Per-call additions to the live context. */\nexport interface EmitOptions {\n  cause?: unknown\n  causedBy?: string\n  run?: number\n  trigger?: Trigger\n  phase?: Phase\n  /**\n   * Not printed by the default console sink (another table printed it in this process, #38). Still\n   * stored and delivered to `onDiagnostic`.\n   */\n  quiet?: boolean\n}\n\n/** Emits a catalog diagnostic; `details` is typed by `code` (see `DiagnosticCatalog`). */\nexport type Emit = <C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  options?: EmitOptions,\n) => void\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/{explain-vkD2cewE.d.cts → explain-Q8Cg0cZy.d.cts}

@@ -1,4 +1,4 @@
-import { R as RowIssue, E as Emit, a as EmitOptions, D as Diagnostic, T as Trigger, P as Phase, I as InvalidRowsMode, F as FlaggedRow, b as Row, c as DiagnosticCode, d as DiagnosticDetails, e as TableSchema, f as RedactLevel, g as RedactFn, h as InvalidRow, i as RowKey } from './codes-OsjAR3Wz.cjs';
+import { R as RowIssue, E as Emit, a as EmitOptions, D as Diagnostic, T as Trigger, P as Phase, I as InvalidRowsMode, F as FlaggedRow, b as Row, c as DiagnosticCode, d as DiagnosticDetails, e as TableSchema, f as RedactLevel, g as RedactFn, h as InvalidRow, i as RowKey } from './codes-B9bCK73-.cjs';
 
 /** Runtime types an option can accept (`'array'` is checked before `'object'`). */
 type OptionType = 'string' | 'number' | 'boolean' | 'function' | 'object' | 'array';
@@ -130,7 +130,11 @@ type SortAlgorithm = 'auto' | 'tim' | 'radix' | 'counting' | 'native' | ((indice
 /** Fields shared by every column whose value type is `V`. */
 type BaseColumn<T, V, R> = {
     header?: string;
-    /** Search weight; omit to exclude the column from search. */
+    /**
+     * Search weight. Once any column declares one, only weighted columns are searched; when none
+     * does, the columns of strings, numbers and booleans are (a date, array or object column needs a
+     * weight to be searched).
+     */
     search?: number;
     sortable?: boolean;
     sortFn?: (a: V, b: V) => number;
@@ -635,7 +639,7 @@ interface TableDiagnosticsOptions {
     /**
      * Redaction (§8.2): a level, or a custom `redact(path, value)` on top of the default level
      * (`'keys'` in development, `'safe'` in production). Columns with `sensitive: true` are never
-     * logged; a sensitive `rowKey` column is hashed at every level.
+     * logged; a `rowKey` path into a sensitive column is hashed at every level.
      */
     redact?: RedactLevel | RedactFn;
 }
@@ -950,8 +954,13 @@ interface ExplainStep {
     readonly cached: boolean;
     /** The step threw or returned a bad output and passed its input through. */
     readonly failed: boolean;
-    /** Duration (tracer only, development or `interceptors: [tracer()]`). */
+    /**
+     * Duration (tracer only, development or `interceptors: [tracer()]`). A step that waited on
+     * time-sliced work: the total of its runs and of the slices between them (#61).
+     */
     readonly ms?: number;
+    /** Time-sliced work (#61): the runs {@link ms} spans; absent when the step ran in one. */
+    readonly runs?: number;
 }
 /** What `table.explain()` returns (§8.4); `String(e)` is the console summary. */
 interface TableExplanation {

package/dist/{explain-Dn99IQt0.d.ts → explain-i0OATi_W.d.ts}

@@ -1,4 +1,4 @@
-import { R as RowIssue, E as Emit, a as EmitOptions, D as Diagnostic, T as Trigger, P as Phase, I as InvalidRowsMode, F as FlaggedRow, b as Row, c as DiagnosticCode, d as DiagnosticDetails, e as TableSchema, f as RedactLevel, g as RedactFn, h as InvalidRow, i as RowKey } from './codes-OsjAR3Wz.js';
+import { R as RowIssue, E as Emit, a as EmitOptions, D as Diagnostic, T as Trigger, P as Phase, I as InvalidRowsMode, F as FlaggedRow, b as Row, c as DiagnosticCode, d as DiagnosticDetails, e as TableSchema, f as RedactLevel, g as RedactFn, h as InvalidRow, i as RowKey } from './codes-B9bCK73-.js';
 
 /** Runtime types an option can accept (`'array'` is checked before `'object'`). */
 type OptionType = 'string' | 'number' | 'boolean' | 'function' | 'object' | 'array';
@@ -130,7 +130,11 @@ type SortAlgorithm = 'auto' | 'tim' | 'radix' | 'counting' | 'native' | ((indice
 /** Fields shared by every column whose value type is `V`. */
 type BaseColumn<T, V, R> = {
     header?: string;
-    /** Search weight; omit to exclude the column from search. */
+    /**
+     * Search weight. Once any column declares one, only weighted columns are searched; when none
+     * does, the columns of strings, numbers and booleans are (a date, array or object column needs a
+     * weight to be searched).
+     */
     search?: number;
     sortable?: boolean;
     sortFn?: (a: V, b: V) => number;
@@ -635,7 +639,7 @@ interface TableDiagnosticsOptions {
     /**
      * Redaction (§8.2): a level, or a custom `redact(path, value)` on top of the default level
      * (`'keys'` in development, `'safe'` in production). Columns with `sensitive: true` are never
-     * logged; a sensitive `rowKey` column is hashed at every level.
+     * logged; a `rowKey` path into a sensitive column is hashed at every level.
      */
     redact?: RedactLevel | RedactFn;
 }
@@ -950,8 +954,13 @@ interface ExplainStep {
     readonly cached: boolean;
     /** The step threw or returned a bad output and passed its input through. */
     readonly failed: boolean;
-    /** Duration (tracer only, development or `interceptors: [tracer()]`). */
+    /**
+     * Duration (tracer only, development or `interceptors: [tracer()]`). A step that waited on
+     * time-sliced work: the total of its runs and of the slices between them (#61).
+     */
     readonly ms?: number;
+    /** Time-sliced work (#61): the runs {@link ms} spans; absent when the step ran in one. */
+    readonly runs?: number;
 }
 /** What `table.explain()` returns (§8.4); `String(e)` is the console summary. */
 interface TableExplanation {

package/dist/feature/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 capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
 var featureMessages = {
   DK_FEATURE_DUPLICATE: {

package/dist/feature/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_DUPLICATE: {\n      feature: string\n      /** Positions in `options.features` of the first and the repeated entry. */\n      first: number\n      second: number\n    }\n    DK_FEATURE_API_CONFLICT: {\n      method: string\n      /** The feature whose API was installed last (the one rejected). */\n      feature: string\n      /** Who already owns `method`: another feature's name, or `null` for the table itself. */\n      owner: string | null\n    }\n    DK_FEATURE_FAILED: {\n      feature: string\n      /** The hook that threw. `rowModel` is reported by the pipeline runner (T09). */\n      hook: 'initialState' | 'createApi' | 'rowModel'\n      /** The fallback that was applied. */\n      fallback: string\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /**\n       * Dev: a method of a feature whose `createApi()` threw was called later (`hook: 'createApi'`);\n       * `feature` names every feature whose API is missing.\n       */\n      method?: string\n    }\n  }\n}\n\nconst capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const featureMessages: DiagnosticMessages<\n  'DK_FEATURE_DUPLICATE' | 'DK_FEATURE_API_CONFLICT' | 'DK_FEATURE_FAILED'\n> = {\n  DK_FEATURE_DUPLICATE: {\n    problem: (d) =>\n      `feature \"${d.feature}\" is installed twice (features[${d.first}] and features[${d.second}]); ` +\n      'a feature name is its state slice key and must be unique per table',\n    impact: () => 'the table was not created',\n    fix: (d) => [\n      `remove features[${d.second}] (or features[${d.first}]): pass \"${d.feature}\" once, with all ` +\n        'its options in one call',\n      'for two different features that share a name, rename one: defineFeature({ name: ... })',\n    ],\n  },\n  DK_FEATURE_API_CONFLICT: {\n    problem: (d) =>\n      `feature \"${d.feature}\" exposes \"${d.method}\", which ` +\n      (d.owner === null\n        ? 'the table already has (a core table method)'\n        : `feature \"${d.owner}\" already exposes`),\n    impact: () => 'the table was not created: one of the two methods would be unreachable',\n    fix: (d) => [\n      `namespace the method in feature \"${d.feature}\": ` +\n        `${d.feature}${capitalize(d.method)}() or ${d.feature}.${d.method}()`,\n      d.owner === null\n        ? `core table methods cannot be replaced; use an interceptor (e.g. on state:dispatch) to ` +\n          `change what table.${d.method}() does`\n        : `or rename it in feature \"${d.owner}\", or install only one of the two features`,\n    ],\n  },\n  DK_FEATURE_FAILED: {\n    problem: (d) =>\n      d.method === undefined\n        ? `feature \"${d.feature}\" ${d.hook}() threw${d.errorName ? ` ${d.errorName}` : ''}`\n        : `table.${d.method}() was called, but it does not exist: createApi() threw at creation ` +\n          `for feature \"${d.feature}\", so its API is missing`,\n    impact: (d) => `${d.fallback}; the rest of the table is unaffected`,\n    fix: (d) => [\n      ...(d.method === undefined\n        ? []\n        : [\n            `see the first DK_FEATURE_FAILED of feature \"${d.feature}\" (trigger init): its ` +\n              'context.cause is the createApi() error',\n          ]),\n      `fix ${d.hook}() of feature \"${d.feature}\": it must not throw` +\n        (d.hook === 'rowModel' ? ' (return its input indices when it cannot filter)' : ''),\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n}\n\n/** Codes owned by the feature contract (§3.3, §8.3). */\nexport const featureDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_DUPLICATE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_DUPLICATE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_API_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_API_CONFLICT,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_FAILED,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAkC1D,IAAM,aAAa,CAAC,MAAc,EAAE,OAAO,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC;AAGhE,IAAM,kBAET;AAAA,EACF,sBAAsB;AAAA,IACpB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,kCAAkC,EAAE,KAAK,kBAAkB,EAAE,MAAM;AAAA,IAE1F,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mBAAmB,EAAE,MAAM,kBAAkB,EAAE,KAAK,aAAa,EAAE,OAAO;AAAA,MAE1E;AAAA,IACF;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,cAAc,EAAE,MAAM,eAC1C,EAAE,UAAU,OACT,gDACA,YAAY,EAAE,KAAK;AAAA,IACzB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO,MACxC,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,MAAM;AAAA,MACnE,EAAE,UAAU,OACR,2GACqB,EAAE,MAAM,YAC7B,4BAA4B,EAAE,KAAK;AAAA,IACzC;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,EAAE,WAAW,SACT,YAAY,EAAE,OAAO,KAAK,EAAE,IAAI,WAAW,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE,KAC/E,SAAS,EAAE,MAAM,oFACD,EAAE,OAAO;AAAA,IAC/B,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ;AAAA,IAC5B,KAAK,CAAC,MAAM;AAAA,MACV,GAAI,EAAE,WAAW,SACb,CAAC,IACD;AAAA,QACE,+CAA+C,EAAE,OAAO;AAAA,MAE1D;AAAA,MACJ,OAAO,EAAE,IAAI,kBAAkB,EAAE,OAAO,0BACrC,EAAE,SAAS,aAAa,sDAAsD;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,qBAAqB;AAAA,MAChC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,MACA;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,gBAAgB;AAAA,EAC7D;AACF;","names":[]}
+{"version":3,"sources":["../../src/feature/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_DUPLICATE: {\n      feature: string\n      /** Positions in `options.features` of the first and the repeated entry. */\n      first: number\n      second: number\n    }\n    DK_FEATURE_API_CONFLICT: {\n      method: string\n      /** The feature whose API was installed last (the one rejected). */\n      feature: string\n      /** Who already owns `method`: another feature's name, or `null` for the table itself. */\n      owner: string | null\n    }\n    DK_FEATURE_FAILED: {\n      feature: string\n      /** The hook that threw. `rowModel` is reported by the pipeline runner (T09). */\n      hook: 'initialState' | 'createApi' | 'rowModel'\n      /** The fallback that was applied. */\n      fallback: string\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /**\n       * Dev: a method of a feature whose `createApi()` threw was called later (`hook: 'createApi'`);\n       * `feature` names every feature whose API is missing.\n       */\n      method?: string\n    }\n  }\n}\n\nconst capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const featureMessages: DiagnosticMessages<\n  'DK_FEATURE_DUPLICATE' | 'DK_FEATURE_API_CONFLICT' | 'DK_FEATURE_FAILED'\n> = {\n  DK_FEATURE_DUPLICATE: {\n    problem: (d) =>\n      `feature \"${d.feature}\" is installed twice (features[${d.first}] and features[${d.second}]); ` +\n      'a feature name is its state slice key and must be unique per table',\n    impact: () => 'the table was not created',\n    fix: (d) => [\n      `remove features[${d.second}] (or features[${d.first}]): pass \"${d.feature}\" once, with all ` +\n        'its options in one call',\n      'for two different features that share a name, rename one: defineFeature({ name: ... })',\n    ],\n  },\n  DK_FEATURE_API_CONFLICT: {\n    problem: (d) =>\n      `feature \"${d.feature}\" exposes \"${d.method}\", which ` +\n      (d.owner === null\n        ? 'the table already has (a core table method)'\n        : `feature \"${d.owner}\" already exposes`),\n    impact: () => 'the table was not created: one of the two methods would be unreachable',\n    fix: (d) => [\n      `namespace the method in feature \"${d.feature}\": ` +\n        `${d.feature}${capitalize(d.method)}() or ${d.feature}.${d.method}()`,\n      d.owner === null\n        ? `core table methods cannot be replaced; use an interceptor (e.g. on state:dispatch) to ` +\n          `change what table.${d.method}() does`\n        : `or rename it in feature \"${d.owner}\", or install only one of the two features`,\n    ],\n  },\n  DK_FEATURE_FAILED: {\n    problem: (d) =>\n      d.method === undefined\n        ? `feature \"${d.feature}\" ${d.hook}() threw${d.errorName ? ` ${d.errorName}` : ''}`\n        : `table.${d.method}() was called, but it does not exist: createApi() threw at creation ` +\n          `for feature \"${d.feature}\", so its API is missing`,\n    impact: (d) => `${d.fallback}; the rest of the table is unaffected`,\n    fix: (d) => [\n      ...(d.method === undefined\n        ? []\n        : [\n            `see the first DK_FEATURE_FAILED of feature \"${d.feature}\" (trigger init): its ` +\n              'context.cause is the createApi() error',\n          ]),\n      `fix ${d.hook}() of feature \"${d.feature}\": it must not throw` +\n        (d.hook === 'rowModel' ? ' (return its input indices when it cannot filter)' : ''),\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n}\n\n/** Codes owned by the feature contract (§3.3, §8.3). */\nexport const featureDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_DUPLICATE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_DUPLICATE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_API_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_API_CONFLICT,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_FAILED,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAkCP,IAAM,aAAa,CAAC,MAAc,EAAE,OAAO,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC;AAGhE,IAAM,kBAET;AAAA,EACF,sBAAsB;AAAA,IACpB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,kCAAkC,EAAE,KAAK,kBAAkB,EAAE,MAAM;AAAA,IAE1F,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mBAAmB,EAAE,MAAM,kBAAkB,EAAE,KAAK,aAAa,EAAE,OAAO;AAAA,MAE1E;AAAA,IACF;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,cAAc,EAAE,MAAM,eAC1C,EAAE,UAAU,OACT,gDACA,YAAY,EAAE,KAAK;AAAA,IACzB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO,MACxC,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,MAAM;AAAA,MACnE,EAAE,UAAU,OACR,2GACqB,EAAE,MAAM,YAC7B,4BAA4B,EAAE,KAAK;AAAA,IACzC;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,EAAE,WAAW,SACT,YAAY,EAAE,OAAO,KAAK,EAAE,IAAI,WAAW,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE,KAC/E,SAAS,EAAE,MAAM,oFACD,EAAE,OAAO;AAAA,IAC/B,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ;AAAA,IAC5B,KAAK,CAAC,MAAM;AAAA,MACV,GAAI,EAAE,WAAW,SACb,CAAC,IACD;AAAA,QACE,+CAA+C,EAAE,OAAO;AAAA,MAE1D;AAAA,MACJ,OAAO,EAAE,IAAI,kBAAkB,EAAE,OAAO,0BACrC,EAAE,SAAS,aAAa,sDAAsD;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,qBAAqB;AAAA,MAChC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,MACA;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,gBAAgB;AAAA,EAC7D;AACF;","names":[]}

package/dist/feature/codes.js

@@ -1,5 +1,6 @@
 // src/feature/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
 var featureMessages = {
   DK_FEATURE_DUPLICATE: {

package/dist/feature/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_DUPLICATE: {\n      feature: string\n      /** Positions in `options.features` of the first and the repeated entry. */\n      first: number\n      second: number\n    }\n    DK_FEATURE_API_CONFLICT: {\n      method: string\n      /** The feature whose API was installed last (the one rejected). */\n      feature: string\n      /** Who already owns `method`: another feature's name, or `null` for the table itself. */\n      owner: string | null\n    }\n    DK_FEATURE_FAILED: {\n      feature: string\n      /** The hook that threw. `rowModel` is reported by the pipeline runner (T09). */\n      hook: 'initialState' | 'createApi' | 'rowModel'\n      /** The fallback that was applied. */\n      fallback: string\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /**\n       * Dev: a method of a feature whose `createApi()` threw was called later (`hook: 'createApi'`);\n       * `feature` names every feature whose API is missing.\n       */\n      method?: string\n    }\n  }\n}\n\nconst capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const featureMessages: DiagnosticMessages<\n  'DK_FEATURE_DUPLICATE' | 'DK_FEATURE_API_CONFLICT' | 'DK_FEATURE_FAILED'\n> = {\n  DK_FEATURE_DUPLICATE: {\n    problem: (d) =>\n      `feature \"${d.feature}\" is installed twice (features[${d.first}] and features[${d.second}]); ` +\n      'a feature name is its state slice key and must be unique per table',\n    impact: () => 'the table was not created',\n    fix: (d) => [\n      `remove features[${d.second}] (or features[${d.first}]): pass \"${d.feature}\" once, with all ` +\n        'its options in one call',\n      'for two different features that share a name, rename one: defineFeature({ name: ... })',\n    ],\n  },\n  DK_FEATURE_API_CONFLICT: {\n    problem: (d) =>\n      `feature \"${d.feature}\" exposes \"${d.method}\", which ` +\n      (d.owner === null\n        ? 'the table already has (a core table method)'\n        : `feature \"${d.owner}\" already exposes`),\n    impact: () => 'the table was not created: one of the two methods would be unreachable',\n    fix: (d) => [\n      `namespace the method in feature \"${d.feature}\": ` +\n        `${d.feature}${capitalize(d.method)}() or ${d.feature}.${d.method}()`,\n      d.owner === null\n        ? `core table methods cannot be replaced; use an interceptor (e.g. on state:dispatch) to ` +\n          `change what table.${d.method}() does`\n        : `or rename it in feature \"${d.owner}\", or install only one of the two features`,\n    ],\n  },\n  DK_FEATURE_FAILED: {\n    problem: (d) =>\n      d.method === undefined\n        ? `feature \"${d.feature}\" ${d.hook}() threw${d.errorName ? ` ${d.errorName}` : ''}`\n        : `table.${d.method}() was called, but it does not exist: createApi() threw at creation ` +\n          `for feature \"${d.feature}\", so its API is missing`,\n    impact: (d) => `${d.fallback}; the rest of the table is unaffected`,\n    fix: (d) => [\n      ...(d.method === undefined\n        ? []\n        : [\n            `see the first DK_FEATURE_FAILED of feature \"${d.feature}\" (trigger init): its ` +\n              'context.cause is the createApi() error',\n          ]),\n      `fix ${d.hook}() of feature \"${d.feature}\": it must not throw` +\n        (d.hook === 'rowModel' ? ' (return its input indices when it cannot filter)' : ''),\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n}\n\n/** Codes owned by the feature contract (§3.3, §8.3). */\nexport const featureDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_DUPLICATE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_DUPLICATE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_API_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_API_CONFLICT,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_FAILED,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAkC1D,IAAM,aAAa,CAAC,MAAc,EAAE,OAAO,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC;AAGhE,IAAM,kBAET;AAAA,EACF,sBAAsB;AAAA,IACpB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,kCAAkC,EAAE,KAAK,kBAAkB,EAAE,MAAM;AAAA,IAE1F,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mBAAmB,EAAE,MAAM,kBAAkB,EAAE,KAAK,aAAa,EAAE,OAAO;AAAA,MAE1E;AAAA,IACF;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,cAAc,EAAE,MAAM,eAC1C,EAAE,UAAU,OACT,gDACA,YAAY,EAAE,KAAK;AAAA,IACzB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO,MACxC,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,MAAM;AAAA,MACnE,EAAE,UAAU,OACR,2GACqB,EAAE,MAAM,YAC7B,4BAA4B,EAAE,KAAK;AAAA,IACzC;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,EAAE,WAAW,SACT,YAAY,EAAE,OAAO,KAAK,EAAE,IAAI,WAAW,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE,KAC/E,SAAS,EAAE,MAAM,oFACD,EAAE,OAAO;AAAA,IAC/B,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ;AAAA,IAC5B,KAAK,CAAC,MAAM;AAAA,MACV,GAAI,EAAE,WAAW,SACb,CAAC,IACD;AAAA,QACE,+CAA+C,EAAE,OAAO;AAAA,MAE1D;AAAA,MACJ,OAAO,EAAE,IAAI,kBAAkB,EAAE,OAAO,0BACrC,EAAE,SAAS,aAAa,sDAAsD;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,qBAAqB;AAAA,EAChC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,EACA;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,gBAAgB;AAAA,EAC7D;AACF;","names":[]}
+{"version":3,"sources":["../../src/feature/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FEATURE_DUPLICATE: {\n      feature: string\n      /** Positions in `options.features` of the first and the repeated entry. */\n      first: number\n      second: number\n    }\n    DK_FEATURE_API_CONFLICT: {\n      method: string\n      /** The feature whose API was installed last (the one rejected). */\n      feature: string\n      /** Who already owns `method`: another feature's name, or `null` for the table itself. */\n      owner: string | null\n    }\n    DK_FEATURE_FAILED: {\n      feature: string\n      /** The hook that threw. `rowModel` is reported by the pipeline runner (T09). */\n      hook: 'initialState' | 'createApi' | 'rowModel'\n      /** The fallback that was applied. */\n      fallback: string\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /**\n       * Dev: a method of a feature whose `createApi()` threw was called later (`hook: 'createApi'`);\n       * `feature` names every feature whose API is missing.\n       */\n      method?: string\n    }\n  }\n}\n\nconst capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const featureMessages: DiagnosticMessages<\n  'DK_FEATURE_DUPLICATE' | 'DK_FEATURE_API_CONFLICT' | 'DK_FEATURE_FAILED'\n> = {\n  DK_FEATURE_DUPLICATE: {\n    problem: (d) =>\n      `feature \"${d.feature}\" is installed twice (features[${d.first}] and features[${d.second}]); ` +\n      'a feature name is its state slice key and must be unique per table',\n    impact: () => 'the table was not created',\n    fix: (d) => [\n      `remove features[${d.second}] (or features[${d.first}]): pass \"${d.feature}\" once, with all ` +\n        'its options in one call',\n      'for two different features that share a name, rename one: defineFeature({ name: ... })',\n    ],\n  },\n  DK_FEATURE_API_CONFLICT: {\n    problem: (d) =>\n      `feature \"${d.feature}\" exposes \"${d.method}\", which ` +\n      (d.owner === null\n        ? 'the table already has (a core table method)'\n        : `feature \"${d.owner}\" already exposes`),\n    impact: () => 'the table was not created: one of the two methods would be unreachable',\n    fix: (d) => [\n      `namespace the method in feature \"${d.feature}\": ` +\n        `${d.feature}${capitalize(d.method)}() or ${d.feature}.${d.method}()`,\n      d.owner === null\n        ? `core table methods cannot be replaced; use an interceptor (e.g. on state:dispatch) to ` +\n          `change what table.${d.method}() does`\n        : `or rename it in feature \"${d.owner}\", or install only one of the two features`,\n    ],\n  },\n  DK_FEATURE_FAILED: {\n    problem: (d) =>\n      d.method === undefined\n        ? `feature \"${d.feature}\" ${d.hook}() threw${d.errorName ? ` ${d.errorName}` : ''}`\n        : `table.${d.method}() was called, but it does not exist: createApi() threw at creation ` +\n          `for feature \"${d.feature}\", so its API is missing`,\n    impact: (d) => `${d.fallback}; the rest of the table is unaffected`,\n    fix: (d) => [\n      ...(d.method === undefined\n        ? []\n        : [\n            `see the first DK_FEATURE_FAILED of feature \"${d.feature}\" (trigger init): its ` +\n              'context.cause is the createApi() error',\n          ]),\n      `fix ${d.hook}() of feature \"${d.feature}\": it must not throw` +\n        (d.hook === 'rowModel' ? ' (return its input indices when it cannot filter)' : ''),\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n}\n\n/** Codes owned by the feature contract (§3.3, §8.3). */\nexport const featureDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_DUPLICATE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_DUPLICATE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_API_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_API_CONFLICT,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && featureMessages.DK_FEATURE_FAILED,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAkCP,IAAM,aAAa,CAAC,MAAc,EAAE,OAAO,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC;AAGhE,IAAM,kBAET;AAAA,EACF,sBAAsB;AAAA,IACpB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,kCAAkC,EAAE,KAAK,kBAAkB,EAAE,MAAM;AAAA,IAE1F,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,mBAAmB,EAAE,MAAM,kBAAkB,EAAE,KAAK,aAAa,EAAE,OAAO;AAAA,MAE1E;AAAA,IACF;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,SAAS,CAAC,MACR,YAAY,EAAE,OAAO,cAAc,EAAE,MAAM,eAC1C,EAAE,UAAU,OACT,gDACA,YAAY,EAAE,KAAK;AAAA,IACzB,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,oCAAoC,EAAE,OAAO,MACxC,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,MAAM;AAAA,MACnE,EAAE,UAAU,OACR,2GACqB,EAAE,MAAM,YAC7B,4BAA4B,EAAE,KAAK;AAAA,IACzC;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,EAAE,WAAW,SACT,YAAY,EAAE,OAAO,KAAK,EAAE,IAAI,WAAW,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE,KAC/E,SAAS,EAAE,MAAM,oFACD,EAAE,OAAO;AAAA,IAC/B,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ;AAAA,IAC5B,KAAK,CAAC,MAAM;AAAA,MACV,GAAI,EAAE,WAAW,SACb,CAAC,IACD;AAAA,QACE,+CAA+C,EAAE,OAAO;AAAA,MAE1D;AAAA,MACJ,OAAO,EAAE,IAAI,kBAAkB,EAAE,OAAO,0BACrC,EAAE,SAAS,aAAa,sDAAsD;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,qBAAqB;AAAA,EAChC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,gBAAgB;AAAA,EAC7D;AAAA,EACA;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,gBAAgB;AAAA,EAC7D;AACF;","names":[]}

package/dist/feature/install.cjs

@@ -26,6 +26,7 @@ __export(install_exports, {
 module.exports = __toCommonJS(install_exports);
 var import_build = require("../diagnostics/build.cjs");
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var import_classify = require("../intercept/classify.cjs");
 var import_codes = require("./codes.cjs");
 (0, import_catalog.keepDiagnostics)(import_codes.featureDiagnostics);
@@ -45,7 +46,7 @@ function initialSlices(features, given, emit) {
       out[f.name] = f.initialState();
     } catch (e) {
       out[f.name] = void 0;
-      reportFailure(emit, f.name, "initialState", "the slice starts as undefined", e);
+      reportFailure(emit, f.name, "initialState", "slice-undefined", e);
     }
   }
   return given ? Object.assign(out, given) : out;
@@ -68,7 +69,7 @@ function installApis(features, host) {
     try {
       api = f.createApi(ctx);
     } catch (e) {
-      reportFailure(host.emit, name, "createApi", "its API was not installed", e);
+      reportFailure(host.emit, name, "createApi", "api-not-installed", e);
       failed.push(name);
       continue;
     }
@@ -120,7 +121,7 @@ function missingApi(failed, host) {
               feature,
               hook: "createApi",
               method: key,
-              fallback: `table.${key}() did nothing (the API of ${failed.length === 1 ? "that feature" : "those features"} was not installed)`
+              fallback: `${failed.length === 1 ? "api" : "apis"}-missing|${key}`
             })
           );
           return void 0;

package/dist/feature/install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/install.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport { errorName } from '../intercept/classify'\nimport type { Table, TableState } from '../table/types'\nimport { featureDiagnostics } from './codes'\nimport type { AnyFeature, FeatureContext, SliceUpdater } from './types'\n\nkeepDiagnostics(featureDiagnostics)\n\n/** What `createTable` gives the installer: the store operations a feature context needs. */\nexport interface FeatureHost {\n  readonly table: Table<unknown, TableState>\n  /** The table name, for config errors thrown before the first emit. */\n  readonly tableName: string\n  readonly emit: Emit\n  getSlice(name: string): unknown\n  /** `state:dispatch` of one slice (where = the feature name); notifies unless inside an API call. */\n  setSlice(name: string, updater: SliceUpdater<unknown>): void\n  /**\n   * Runs an API method: no-op + `DK_TABLE_DESTROYED` after destroy (returning `destroyed?.()`),\n   * trigger `api:<method>`, listeners notified once when the outermost call returns.\n   */\n  call(method: string, fn: () => unknown, destroyed?: () => unknown): unknown\n}\n\nfunction reportFailure(\n  emit: Emit,\n  feature: string,\n  hook: 'initialState' | 'createApi',\n  fallback: string,\n  e: unknown,\n) {\n  const name = errorName(e)\n  emit(\n    'DK_FEATURE_FAILED',\n    { feature, hook, fallback, ...(name === undefined ? {} : { errorName: name }) },\n    { cause: e },\n  )\n}\n\n/**\n * The starting snapshot: each feature's `initialState()` under its name, then `given`\n * (`options.initialState`) per slice on top. `initialState()` is not called for a given slice.\n */\nexport function initialSlices(\n  features: readonly AnyFeature[],\n  given: object | undefined,\n  emit: Emit,\n): TableState {\n  const out: TableState = {}\n  for (const f of features) {\n    if (given && Object.hasOwn(given, f.name)) continue\n    try {\n      out[f.name] = f.initialState()\n    } catch (e) {\n      out[f.name] = undefined\n      reportFailure(emit, f.name, 'initialState', 'the slice starts as undefined', e)\n    }\n  }\n  return given ? Object.assign(out, given) : out\n}\n\n/**\n * Creates every feature API (in the order the features were listed) and merges it onto the table.\n * Throws `DatakableConfigError` `DK_FEATURE_API_CONFLICT` when a member name is already taken by a\n * core table method or by an earlier feature. Methods are wrapped once here (cold path).\n */\nexport function installApis(features: readonly AnyFeature[], host: FeatureHost): void {\n  const target = host.table as unknown as Record<string, unknown>\n  const owners = new Map<string, string | null>()\n  for (const k of Object.keys(target)) owners.set(k, null)\n  /** Features whose `createApi()` threw: their methods are missing from the table. */\n  const failed: string[] = []\n\n  for (const f of features) {\n    const name = f.name\n    const ctx: FeatureContext<unknown> = {\n      name,\n      getState: () => host.getSlice(name),\n      setState: (updater) => host.setSlice(name, updater),\n      table: host.table,\n      emit: host.emit,\n    }\n    let api: unknown\n    try {\n      api = f.createApi(ctx)\n    } catch (e) {\n      reportFailure(host.emit, name, 'createApi', 'its API was not installed', e)\n      failed.push(name)\n      continue\n    }\n    if (api === null || typeof api !== 'object') continue\n    const members = api as Record<string, unknown>\n    const keys = Object.keys(members)\n    for (const method of keys) {\n      if (owners.has(method)) {\n        throwConfigError(\n          'DK_FEATURE_API_CONFLICT',\n          { method, feature: name, owner: owners.get(method) ?? null },\n          { table: host.tableName },\n        )\n      }\n    }\n    for (const method of keys) {\n      owners.set(method, name)\n      const member = members[method]\n      const destroyed = f.destroyedResult?.[method]\n      target[method] =\n        typeof member === 'function'\n          ? (...args: unknown[]) => host.call(method, () => member.apply(members, args), destroyed)\n          : member\n    }\n  }\n  if ((process.env.NODE_ENV !== \"production\") && failed.length > 0) Object.setPrototypeOf(target, missingApi(failed, host))\n}\n\n/**\n * Names generic code probes on any object (await, JSON, React, test runners, inspectors): never a\n * feature method, so never stubbed.\n */\nconst PROBES = new Set([\n  'then',\n  'catch',\n  'finally',\n  'toJSON',\n  'asymmetricMatch',\n  'nodeType',\n  'tagName',\n])\nconst isProbe = (k: string) => PROBES.has(k) || /^[_$@]/.test(k)\n\n/**\n * Dev (R4): the prototype of a table where a feature's `createApi()` threw. The types still promise\n * that feature's methods, so a call to a name the table does not have is a no-op that reports\n * `DK_FEATURE_FAILED` (with the method) instead of a raw TypeError at the caller. Only reads of\n * missing names reach it: the table keeps its identity and own members, `in` / `hasOwn` stay\n * false, and `Object.prototype` members, symbols and generic probes (`then`, `toJSON`, …) resolve\n * as usual.\n */\nfunction missingApi(failed: readonly string[], host: FeatureHost): object {\n  const feature = failed.join(', ')\n  const stubs = new Map<string, () => undefined>()\n  return new Proxy(Object.prototype, {\n    get(proto, key, receiver) {\n      if (typeof key !== 'string' || key in proto || isProbe(key)) {\n        return Reflect.get(proto, key, receiver)\n      }\n      let stub = stubs.get(key)\n      if (!stub) {\n        stub = () => {\n          host.call(key, () =>\n            host.emit('DK_FEATURE_FAILED', {\n              feature,\n              hook: 'createApi',\n              method: key,\n              fallback: `table.${key}() did nothing (the API of ${failed.length === 1 ? 'that feature' : 'those features'} was not installed)`,\n            }),\n          )\n          return undefined\n        }\n        stubs.set(key, stub)\n      }\n      return stub\n    },\n  })\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/feature/install.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Emit } from '../diagnostics/types'\nimport { errorName } from '../intercept/classify'\nimport type { Table, TableState } from '../table/types'\nimport { featureDiagnostics } from './codes'\nimport type { AnyFeature, FeatureContext, SliceUpdater } from './types'\n\nkeepDiagnostics(featureDiagnostics)\n\n/** What `createTable` gives the installer: the store operations a feature context needs. */\nexport interface FeatureHost {\n  readonly table: Table<unknown, TableState>\n  /** The table name, for config errors thrown before the first emit. */\n  readonly tableName: string\n  readonly emit: Emit\n  getSlice(name: string): unknown\n  /** `state:dispatch` of one slice (where = the feature name); notifies unless inside an API call. */\n  setSlice(name: string, updater: SliceUpdater<unknown>): void\n  /**\n   * Runs an API method: no-op + `DK_TABLE_DESTROYED` after destroy (returning `destroyed?.()`),\n   * trigger `api:<method>`, listeners notified once when the outermost call returns.\n   */\n  call(method: string, fn: () => unknown, destroyed?: () => unknown): unknown\n}\n\nfunction reportFailure(\n  emit: Emit,\n  feature: string,\n  hook: 'initialState' | 'createApi',\n  fallback: string,\n  e: unknown,\n) {\n  const name = errorName(e)\n  emit(\n    'DK_FEATURE_FAILED',\n    { feature, hook, fallback, ...(name === undefined ? {} : { errorName: name }) },\n    { cause: e },\n  )\n}\n\n/**\n * The starting snapshot: each feature's `initialState()` under its name, then `given`\n * (`options.initialState`) per slice on top. `initialState()` is not called for a given slice.\n */\nexport function initialSlices(\n  features: readonly AnyFeature[],\n  given: object | undefined,\n  emit: Emit,\n): TableState {\n  const out: TableState = {}\n  for (const f of features) {\n    if (given && Object.hasOwn(given, f.name)) continue\n    try {\n      out[f.name] = f.initialState()\n    } catch (e) {\n      out[f.name] = undefined\n      reportFailure(emit, f.name, 'initialState', 'slice-undefined', e)\n    }\n  }\n  return given ? Object.assign(out, given) : out\n}\n\n/**\n * Creates every feature API (in the order the features were listed) and merges it onto the table.\n * Throws `DatakableConfigError` `DK_FEATURE_API_CONFLICT` when a member name is already taken by a\n * core table method or by an earlier feature. Methods are wrapped once here (cold path).\n */\nexport function installApis(features: readonly AnyFeature[], host: FeatureHost): void {\n  const target = host.table as unknown as Record<string, unknown>\n  const owners = new Map<string, string | null>()\n  for (const k of Object.keys(target)) owners.set(k, null)\n  /** Features whose `createApi()` threw: their methods are missing from the table. */\n  const failed: string[] = []\n\n  for (const f of features) {\n    const name = f.name\n    const ctx: FeatureContext<unknown> = {\n      name,\n      getState: () => host.getSlice(name),\n      setState: (updater) => host.setSlice(name, updater),\n      table: host.table,\n      emit: host.emit,\n    }\n    let api: unknown\n    try {\n      api = f.createApi(ctx)\n    } catch (e) {\n      reportFailure(host.emit, name, 'createApi', 'api-not-installed', e)\n      failed.push(name)\n      continue\n    }\n    if (api === null || typeof api !== 'object') continue\n    const members = api as Record<string, unknown>\n    const keys = Object.keys(members)\n    for (const method of keys) {\n      if (owners.has(method)) {\n        throwConfigError(\n          'DK_FEATURE_API_CONFLICT',\n          { method, feature: name, owner: owners.get(method) ?? null },\n          { table: host.tableName },\n        )\n      }\n    }\n    for (const method of keys) {\n      owners.set(method, name)\n      const member = members[method]\n      const destroyed = f.destroyedResult?.[method]\n      target[method] =\n        typeof member === 'function'\n          ? (...args: unknown[]) => host.call(method, () => member.apply(members, args), destroyed)\n          : member\n    }\n  }\n  if ((process.env.NODE_ENV !== \"production\") && failed.length > 0) Object.setPrototypeOf(target, missingApi(failed, host))\n}\n\n/**\n * Names generic code probes on any object (await, JSON, React, test runners, inspectors): never a\n * feature method, so never stubbed.\n */\nconst PROBES = new Set([\n  'then',\n  'catch',\n  'finally',\n  'toJSON',\n  'asymmetricMatch',\n  'nodeType',\n  'tagName',\n])\nconst isProbe = (k: string) => PROBES.has(k) || /^[_$@]/.test(k)\n\n/**\n * Dev (R4): the prototype of a table where a feature's `createApi()` threw. The types still promise\n * that feature's methods, so a call to a name the table does not have is a no-op that reports\n * `DK_FEATURE_FAILED` (with the method) instead of a raw TypeError at the caller. Only reads of\n * missing names reach it: the table keeps its identity and own members, `in` / `hasOwn` stay\n * false, and `Object.prototype` members, symbols and generic probes (`then`, `toJSON`, …) resolve\n * as usual.\n */\nfunction missingApi(failed: readonly string[], host: FeatureHost): object {\n  const feature = failed.join(', ')\n  const stubs = new Map<string, () => undefined>()\n  return new Proxy(Object.prototype, {\n    get(proto, key, receiver) {\n      if (typeof key !== 'string' || key in proto || isProbe(key)) {\n        return Reflect.get(proto, key, receiver)\n      }\n      let stub = stubs.get(key)\n      if (!stub) {\n        stub = () => {\n          host.call(key, () =>\n            host.emit('DK_FEATURE_FAILED', {\n              feature,\n              hook: 'createApi',\n              method: key,\n              fallback: `${failed.length === 1 ? 'api' : 'apis'}-missing|${key}`,\n            }),\n          )\n          return undefined\n        }\n        stubs.set(key, stub)\n      }\n      return stub\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AACjC,qBAAgC;AAChC,2BAAO;AAEP,sBAA0B;AAE1B,mBAAmC;AAAA,IAGnC,gCAAgB,+BAAkB;AAkBlC,SAAS,cACP,MACA,SACA,MACA,UACA,GACA;AACA,QAAM,WAAO,2BAAU,CAAC;AACxB;AAAA,IACE;AAAA,IACA,EAAE,SAAS,MAAM,UAAU,GAAI,SAAS,SAAY,CAAC,IAAI,EAAE,WAAW,KAAK,EAAG;AAAA,IAC9E,EAAE,OAAO,EAAE;AAAA,EACb;AACF;AAMO,SAAS,cACd,UACA,OACA,MACY;AACZ,QAAM,MAAkB,CAAC;AACzB,aAAW,KAAK,UAAU;AACxB,QAAI,SAAS,OAAO,OAAO,OAAO,EAAE,IAAI,EAAG;AAC3C,QAAI;AACF,UAAI,EAAE,IAAI,IAAI,EAAE,aAAa;AAAA,IAC/B,SAAS,GAAG;AACV,UAAI,EAAE,IAAI,IAAI;AACd,oBAAc,MAAM,EAAE,MAAM,gBAAgB,mBAAmB,CAAC;AAAA,IAClE;AAAA,EACF;AACA,SAAO,QAAQ,OAAO,OAAO,KAAK,KAAK,IAAI;AAC7C;AAOO,SAAS,YAAY,UAAiC,MAAyB;AACpF,QAAM,SAAS,KAAK;AACpB,QAAM,SAAS,oBAAI,IAA2B;AAC9C,aAAW,KAAK,OAAO,KAAK,MAAM,EAAG,QAAO,IAAI,GAAG,IAAI;AAEvD,QAAM,SAAmB,CAAC;AAE1B,aAAW,KAAK,UAAU;AACxB,UAAM,OAAO,EAAE;AACf,UAAM,MAA+B;AAAA,MACnC;AAAA,MACA,UAAU,MAAM,KAAK,SAAS,IAAI;AAAA,MAClC,UAAU,CAAC,YAAY,KAAK,SAAS,MAAM,OAAO;AAAA,MAClD,OAAO,KAAK;AAAA,MACZ,MAAM,KAAK;AAAA,IACb;AACA,QAAI;AACJ,QAAI;AACF,YAAM,EAAE,UAAU,GAAG;AAAA,IACvB,SAAS,GAAG;AACV,oBAAc,KAAK,MAAM,MAAM,aAAa,qBAAqB,CAAC;AAClE,aAAO,KAAK,IAAI;AAChB;AAAA,IACF;AACA,QAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU;AAC7C,UAAM,UAAU;AAChB,UAAM,OAAO,OAAO,KAAK,OAAO;AAChC,eAAW,UAAU,MAAM;AACzB,UAAI,OAAO,IAAI,MAAM,GAAG;AACtB;AAAA,UACE;AAAA,UACA,EAAE,QAAQ,SAAS,MAAM,OAAO,OAAO,IAAI,MAAM,KAAK,KAAK;AAAA,UAC3D,EAAE,OAAO,KAAK,UAAU;AAAA,QAC1B;AAAA,MACF;AAAA,IACF;AACA,eAAW,UAAU,MAAM;AACzB,aAAO,IAAI,QAAQ,IAAI;AACvB,YAAM,SAAS,QAAQ,MAAM;AAC7B,YAAM,YAAY,EAAE,kBAAkB,MAAM;AAC5C,aAAO,MAAM,IACX,OAAO,WAAW,aACd,IAAI,SAAoB,KAAK,KAAK,QAAQ,MAAM,OAAO,MAAM,SAAS,IAAI,GAAG,SAAS,IACtF;AAAA,IACR;AAAA,EACF;AACA,MAAK,QAAQ,IAAI,aAAa,gBAAiB,OAAO,SAAS,EAAG,QAAO,eAAe,QAAQ,WAAW,QAAQ,IAAI,CAAC;AAC1H;AAMA,IAAM,SAAS,oBAAI,IAAI;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AACD,IAAM,UAAU,CAAC,MAAc,OAAO,IAAI,CAAC,KAAK,SAAS,KAAK,CAAC;AAU/D,SAAS,WAAW,QAA2B,MAA2B;AACxE,QAAM,UAAU,OAAO,KAAK,IAAI;AAChC,QAAM,QAAQ,oBAAI,IAA6B;AAC/C,SAAO,IAAI,MAAM,OAAO,WAAW;AAAA,IACjC,IAAI,OAAO,KAAK,UAAU;AACxB,UAAI,OAAO,QAAQ,YAAY,OAAO,SAAS,QAAQ,GAAG,GAAG;AAC3D,eAAO,QAAQ,IAAI,OAAO,KAAK,QAAQ;AAAA,MACzC;AACA,UAAI,OAAO,MAAM,IAAI,GAAG;AACxB,UAAI,CAAC,MAAM;AACT,eAAO,MAAM;AACX,eAAK;AAAA,YAAK;AAAA,YAAK,MACb,KAAK,KAAK,qBAAqB;AAAA,cAC7B;AAAA,cACA,MAAM;AAAA,cACN,QAAQ;AAAA,cACR,UAAU,GAAG,OAAO,WAAW,IAAI,QAAQ,MAAM,YAAY,GAAG;AAAA,YAClE,CAAC;AAAA,UACH;AACA,iBAAO;AAAA,QACT;AACA,cAAM,IAAI,KAAK,IAAI;AAAA,MACrB;AACA,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;","names":[]}