@datakable/core 1.0.1 → 1.1.0

package/README.md

@@ -17,7 +17,7 @@ constant and remove development-only checks, tracing and message text from produ
 Vite, webpack, Next.js, Rollup (`@rollup/plugin-replace`) and esbuild
 (`--define:process.env.NODE_ENV='"production"'`) all replace it. Without a replacement, unbundled
 browser code throws `ReferenceError: process is not defined`, as React and Redux do. Node needs
-nothing.
+nothing beyond Node.js `>=18.18`. The types need TypeScript `>=5.4`.
 
 ## Contents
 
@@ -111,7 +111,9 @@ The features are also exported from `@datakable/core` itself. The pipeline alway
   (number / bigint / Date, inclusive) and `custom` (`fn(value, filterValue, row)`). Filters AND
   together; an array cell matches when any element matches.
 - **Search:** fuzzy matching over the formatted cell values. When a column declares
-  `search: weight`, only columns with a weight are searched; otherwise every column is, at weight 1. `input` follows the keyboard,
+  `search: weight`, only columns with a weight are searched; otherwise the columns of strings,
+  numbers and booleans are, at weight 1 (a column of dates, arrays or objects needs a weight;
+  `DK_SEARCH_COLUMN_SKIPPED` in development). `input` follows the keyboard,
   `query` is the applied value; `typing` sets `immediate` / `debounce` / `throttle`, `wait`,
   `minLength` and `commitOn: 'enter'`. `setSearch` / `flushSearch` return a promise of
   `{ status: 'applied' | 'superseded' | 'error' }` and never reject. A `searchFn` replaces the

package/dist/catalog/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 where = (d) => d.feature === void 0 ? { kind: "option", path: d.path } : { kind: "feature", name: d.feature };
 var label = (d) => d.feature === void 0 ? `options.${d.path}` : `${d.feature}({ ${d.path} })`;
 var leaf = (path) => path.slice(path.lastIndexOf(".") + 1);
@@ -68,14 +69,17 @@ var optionMessages = {
   }
 };
 var optionDiagnostics = [
-  (0, import_catalog.defineDiagnostic)(
-    {
-      code: "DK_UNKNOWN_OPTION",
-      level: "warn",
-      where
-    },
-    process.env.NODE_ENV !== "production" && optionMessages.DK_UNKNOWN_OPTION
-  ),
+  // Only the development option validator emits it: no definition in production.
+  ...process.env.NODE_ENV !== "production" ? [
+    (0, import_catalog.defineDiagnostic)(
+      {
+        code: "DK_UNKNOWN_OPTION",
+        level: "warn",
+        where
+      },
+      process.env.NODE_ENV !== "production" && optionMessages.DK_UNKNOWN_OPTION
+    )
+  ] : [],
   (0, import_catalog.defineDiagnostic)(
     {
       code: "DK_INVALID_OPTION",

package/dist/catalog/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/catalog/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport type { Location } from '../diagnostics/types'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_UNKNOWN_OPTION: {\n      /** Option path as written (`colums`, `diagnostics.redcat`); option keys, never values. */\n      path: string\n      /** Set when the option was given to a feature factory. */\n      feature?: string\n      /** Close accepted names, best first (did-you-mean). */\n      suggestions: string[]\n      /** The accepted options at that level. */\n      known: string[]\n      /** An installed feature that has this option (it was passed to the table instead). */\n      owner?: string\n    }\n    DK_INVALID_OPTION: {\n      path: string\n      feature?: string\n      /** The accepted values in words. */\n      expected: string\n      /** What was given: a type, or a short constant (`\"ful\"`, `NaN`). */\n      received: string\n      /** Close accepted values (enums), best first. */\n      suggestions: string[]\n      /** A fix specific to this mistake, shown first. */\n      hint?: string\n      /** Where it was given: `createTable` (the table was not created) or `setOptions` (rejected). */\n      phase: 'init' | 'setOptions'\n    }\n    DK_OPTION_NO_EFFECT: {\n      path: string\n      feature?: string\n      /** Why the option is ignored. */\n      reason: string\n      /** `true` for a read-once option changed with `setOptions`. */\n      once: boolean\n    }\n  }\n}\n\nconst where = (d: { path: string; feature?: string }): Location =>\n  d.feature === undefined ? { kind: 'option', path: d.path } : { kind: 'feature', name: d.feature }\n\n/** `options.timeout` / `paging({ pageSize })`. */\nconst label = (d: { path: string; feature?: string }) =>\n  d.feature === undefined ? `options.${d.path}` : `${d.feature}({ ${d.path} })`\n\nconst leaf = (path: string) => path.slice(path.lastIndexOf('.') + 1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const optionMessages: DiagnosticMessages<\n  'DK_UNKNOWN_OPTION' | 'DK_INVALID_OPTION' | 'DK_OPTION_NO_EFFECT'\n> = {\n  DK_UNKNOWN_OPTION: {\n    problem: (d) =>\n      d.feature === undefined\n        ? `unknown option \"${d.path}\"`\n        : `feature \"${d.feature}\" got an unknown option \"${d.path}\"`,\n    impact: () => 'the option is ignored',\n    fix: (d) => {\n      const out: string[] = []\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`did you mean \"${s}\"? rename \"${leaf(d.path)}\" to \"${s}\"`)\n      if (d.owner !== undefined) {\n        out.push(\n          `\"${d.path}\" is an option of feature \"${d.owner}\": pass it to the feature, ` +\n            `${d.owner}({ ${d.path}: ... })`,\n        )\n      }\n      out.push(\n        `remove \"${leaf(d.path)}\"; accepted ${d.feature === undefined ? '' : `${d.feature} `}` +\n          `options here: ${d.known.join(', ') || '(none)'}`,\n      )\n      return out\n    },\n  },\n  DK_INVALID_OPTION: {\n    problem: (d) => `${label(d)} must be ${d.expected}, got ${d.received}`,\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => {\n      const out: string[] = []\n      if (d.hint !== undefined) out.push(d.hint)\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`use '${s}' (the closest accepted value) for ${label(d)}`)\n      out.push(`pass ${d.expected} as ${label(d)}, or leave it out for the default`)\n      return out\n    },\n  },\n  DK_OPTION_NO_EFFECT: {\n    problem: (d) =>\n      d.once\n        ? `setOptions({ ${d.path} }) has no effect: ${d.reason}`\n        : `${label(d)} has no effect: ${d.reason}`,\n    impact: (d) =>\n      d.once\n        ? 'the new value was ignored; the table keeps the value it was created with'\n        : 'the option is ignored in this configuration',\n    fix: (d) =>\n      d.once\n        ? [\n            `pass ${d.path} to createTable() instead; to change it, create a new table ` +\n              '(in React, change the component key)',\n          ]\n        : [`remove ${label(d)}, or change the configuration so that it applies (${d.reason})`],\n  },\n}\n\n/** Codes owned by the options catalog (§3.5, §8.3). */\nexport const optionDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_UNKNOWN_OPTION',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_UNKNOWN_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_OPTION',\n      level: 'error',\n      config: true,\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_INVALID_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_OPTION_NO_EFFECT',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_OPTION_NO_EFFECT,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/catalog/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Location } from '../diagnostics/types'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_UNKNOWN_OPTION: {\n      /** Option path as written (`colums`, `diagnostics.redcat`); option keys, never values. */\n      path: string\n      /** Set when the option was given to a feature factory. */\n      feature?: string\n      /** Close accepted names, best first (did-you-mean). */\n      suggestions: string[]\n      /** The accepted options at that level. */\n      known: string[]\n      /** An installed feature that has this option (it was passed to the table instead). */\n      owner?: string\n    }\n    DK_INVALID_OPTION: {\n      path: string\n      feature?: string\n      /** The accepted values in words. */\n      expected: string\n      /** What was given: a type, or a short constant (`\"ful\"`, `NaN`). */\n      received: string\n      /** Close accepted values (enums), best first. */\n      suggestions: string[]\n      /** A fix specific to this mistake, shown first. */\n      hint?: string\n      /** Where it was given: `createTable` (the table was not created) or `setOptions` (rejected). */\n      phase: 'init' | 'setOptions'\n    }\n    DK_OPTION_NO_EFFECT: {\n      path: string\n      feature?: string\n      /** Why the option is ignored. */\n      reason: string\n      /** `true` for a read-once option changed with `setOptions`. */\n      once: boolean\n    }\n  }\n}\n\nconst where = (d: { path: string; feature?: string }): Location =>\n  d.feature === undefined ? { kind: 'option', path: d.path } : { kind: 'feature', name: d.feature }\n\n/** `options.timeout` / `paging({ pageSize })`. */\nconst label = (d: { path: string; feature?: string }) =>\n  d.feature === undefined ? `options.${d.path}` : `${d.feature}({ ${d.path} })`\n\nconst leaf = (path: string) => path.slice(path.lastIndexOf('.') + 1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const optionMessages: DiagnosticMessages<\n  'DK_UNKNOWN_OPTION' | 'DK_INVALID_OPTION' | 'DK_OPTION_NO_EFFECT'\n> = {\n  DK_UNKNOWN_OPTION: {\n    problem: (d) =>\n      d.feature === undefined\n        ? `unknown option \"${d.path}\"`\n        : `feature \"${d.feature}\" got an unknown option \"${d.path}\"`,\n    impact: () => 'the option is ignored',\n    fix: (d) => {\n      const out: string[] = []\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`did you mean \"${s}\"? rename \"${leaf(d.path)}\" to \"${s}\"`)\n      if (d.owner !== undefined) {\n        out.push(\n          `\"${d.path}\" is an option of feature \"${d.owner}\": pass it to the feature, ` +\n            `${d.owner}({ ${d.path}: ... })`,\n        )\n      }\n      out.push(\n        `remove \"${leaf(d.path)}\"; accepted ${d.feature === undefined ? '' : `${d.feature} `}` +\n          `options here: ${d.known.join(', ') || '(none)'}`,\n      )\n      return out\n    },\n  },\n  DK_INVALID_OPTION: {\n    problem: (d) => `${label(d)} must be ${d.expected}, got ${d.received}`,\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => {\n      const out: string[] = []\n      if (d.hint !== undefined) out.push(d.hint)\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`use '${s}' (the closest accepted value) for ${label(d)}`)\n      out.push(`pass ${d.expected} as ${label(d)}, or leave it out for the default`)\n      return out\n    },\n  },\n  DK_OPTION_NO_EFFECT: {\n    problem: (d) =>\n      d.once\n        ? `setOptions({ ${d.path} }) has no effect: ${d.reason}`\n        : `${label(d)} has no effect: ${d.reason}`,\n    impact: (d) =>\n      d.once\n        ? 'the new value was ignored; the table keeps the value it was created with'\n        : 'the option is ignored in this configuration',\n    fix: (d) =>\n      d.once\n        ? [\n            `pass ${d.path} to createTable() instead; to change it, create a new table ` +\n              '(in React, change the component key)',\n          ]\n        : [`remove ${label(d)}, or change the configuration so that it applies (${d.reason})`],\n  },\n}\n\n/** Codes owned by the options catalog (§3.5, §8.3). */\nexport const optionDiagnostics = [\n  // Only the development option validator emits it: no definition in production.\n  ...((process.env.NODE_ENV !== \"production\")\n    ? [\n        defineDiagnostic(\n          {\n            code: 'DK_UNKNOWN_OPTION',\n            level: 'warn',\n            where,\n          },\n          (process.env.NODE_ENV !== \"production\") && optionMessages.DK_UNKNOWN_OPTION,\n        ),\n      ]\n    : []),\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_OPTION',\n      level: 'error',\n      config: true,\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_INVALID_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_OPTION_NO_EFFECT',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_OPTION_NO_EFFECT,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/catalog/codes.js

@@ -1,5 +1,6 @@
 // src/catalog/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var where = (d) => d.feature === void 0 ? { kind: "option", path: d.path } : { kind: "feature", name: d.feature };
 var label = (d) => d.feature === void 0 ? `options.${d.path}` : `${d.feature}({ ${d.path} })`;
 var leaf = (path) => path.slice(path.lastIndexOf(".") + 1);
@@ -43,14 +44,17 @@ var optionMessages = {
   }
 };
 var optionDiagnostics = [
-  defineDiagnostic(
-    {
-      code: "DK_UNKNOWN_OPTION",
-      level: "warn",
-      where
-    },
-    process.env.NODE_ENV !== "production" && optionMessages.DK_UNKNOWN_OPTION
-  ),
+  // Only the development option validator emits it: no definition in production.
+  ...process.env.NODE_ENV !== "production" ? [
+    defineDiagnostic(
+      {
+        code: "DK_UNKNOWN_OPTION",
+        level: "warn",
+        where
+      },
+      process.env.NODE_ENV !== "production" && optionMessages.DK_UNKNOWN_OPTION
+    )
+  ] : [],
   defineDiagnostic(
     {
       code: "DK_INVALID_OPTION",

package/dist/catalog/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/catalog/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport type { Location } from '../diagnostics/types'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_UNKNOWN_OPTION: {\n      /** Option path as written (`colums`, `diagnostics.redcat`); option keys, never values. */\n      path: string\n      /** Set when the option was given to a feature factory. */\n      feature?: string\n      /** Close accepted names, best first (did-you-mean). */\n      suggestions: string[]\n      /** The accepted options at that level. */\n      known: string[]\n      /** An installed feature that has this option (it was passed to the table instead). */\n      owner?: string\n    }\n    DK_INVALID_OPTION: {\n      path: string\n      feature?: string\n      /** The accepted values in words. */\n      expected: string\n      /** What was given: a type, or a short constant (`\"ful\"`, `NaN`). */\n      received: string\n      /** Close accepted values (enums), best first. */\n      suggestions: string[]\n      /** A fix specific to this mistake, shown first. */\n      hint?: string\n      /** Where it was given: `createTable` (the table was not created) or `setOptions` (rejected). */\n      phase: 'init' | 'setOptions'\n    }\n    DK_OPTION_NO_EFFECT: {\n      path: string\n      feature?: string\n      /** Why the option is ignored. */\n      reason: string\n      /** `true` for a read-once option changed with `setOptions`. */\n      once: boolean\n    }\n  }\n}\n\nconst where = (d: { path: string; feature?: string }): Location =>\n  d.feature === undefined ? { kind: 'option', path: d.path } : { kind: 'feature', name: d.feature }\n\n/** `options.timeout` / `paging({ pageSize })`. */\nconst label = (d: { path: string; feature?: string }) =>\n  d.feature === undefined ? `options.${d.path}` : `${d.feature}({ ${d.path} })`\n\nconst leaf = (path: string) => path.slice(path.lastIndexOf('.') + 1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const optionMessages: DiagnosticMessages<\n  'DK_UNKNOWN_OPTION' | 'DK_INVALID_OPTION' | 'DK_OPTION_NO_EFFECT'\n> = {\n  DK_UNKNOWN_OPTION: {\n    problem: (d) =>\n      d.feature === undefined\n        ? `unknown option \"${d.path}\"`\n        : `feature \"${d.feature}\" got an unknown option \"${d.path}\"`,\n    impact: () => 'the option is ignored',\n    fix: (d) => {\n      const out: string[] = []\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`did you mean \"${s}\"? rename \"${leaf(d.path)}\" to \"${s}\"`)\n      if (d.owner !== undefined) {\n        out.push(\n          `\"${d.path}\" is an option of feature \"${d.owner}\": pass it to the feature, ` +\n            `${d.owner}({ ${d.path}: ... })`,\n        )\n      }\n      out.push(\n        `remove \"${leaf(d.path)}\"; accepted ${d.feature === undefined ? '' : `${d.feature} `}` +\n          `options here: ${d.known.join(', ') || '(none)'}`,\n      )\n      return out\n    },\n  },\n  DK_INVALID_OPTION: {\n    problem: (d) => `${label(d)} must be ${d.expected}, got ${d.received}`,\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => {\n      const out: string[] = []\n      if (d.hint !== undefined) out.push(d.hint)\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`use '${s}' (the closest accepted value) for ${label(d)}`)\n      out.push(`pass ${d.expected} as ${label(d)}, or leave it out for the default`)\n      return out\n    },\n  },\n  DK_OPTION_NO_EFFECT: {\n    problem: (d) =>\n      d.once\n        ? `setOptions({ ${d.path} }) has no effect: ${d.reason}`\n        : `${label(d)} has no effect: ${d.reason}`,\n    impact: (d) =>\n      d.once\n        ? 'the new value was ignored; the table keeps the value it was created with'\n        : 'the option is ignored in this configuration',\n    fix: (d) =>\n      d.once\n        ? [\n            `pass ${d.path} to createTable() instead; to change it, create a new table ` +\n              '(in React, change the component key)',\n          ]\n        : [`remove ${label(d)}, or change the configuration so that it applies (${d.reason})`],\n  },\n}\n\n/** Codes owned by the options catalog (§3.5, §8.3). */\nexport const optionDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_UNKNOWN_OPTION',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_UNKNOWN_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_OPTION',\n      level: 'error',\n      config: true,\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_INVALID_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_OPTION_NO_EFFECT',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_OPTION_NO_EFFECT,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/catalog/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Location } from '../diagnostics/types'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_UNKNOWN_OPTION: {\n      /** Option path as written (`colums`, `diagnostics.redcat`); option keys, never values. */\n      path: string\n      /** Set when the option was given to a feature factory. */\n      feature?: string\n      /** Close accepted names, best first (did-you-mean). */\n      suggestions: string[]\n      /** The accepted options at that level. */\n      known: string[]\n      /** An installed feature that has this option (it was passed to the table instead). */\n      owner?: string\n    }\n    DK_INVALID_OPTION: {\n      path: string\n      feature?: string\n      /** The accepted values in words. */\n      expected: string\n      /** What was given: a type, or a short constant (`\"ful\"`, `NaN`). */\n      received: string\n      /** Close accepted values (enums), best first. */\n      suggestions: string[]\n      /** A fix specific to this mistake, shown first. */\n      hint?: string\n      /** Where it was given: `createTable` (the table was not created) or `setOptions` (rejected). */\n      phase: 'init' | 'setOptions'\n    }\n    DK_OPTION_NO_EFFECT: {\n      path: string\n      feature?: string\n      /** Why the option is ignored. */\n      reason: string\n      /** `true` for a read-once option changed with `setOptions`. */\n      once: boolean\n    }\n  }\n}\n\nconst where = (d: { path: string; feature?: string }): Location =>\n  d.feature === undefined ? { kind: 'option', path: d.path } : { kind: 'feature', name: d.feature }\n\n/** `options.timeout` / `paging({ pageSize })`. */\nconst label = (d: { path: string; feature?: string }) =>\n  d.feature === undefined ? `options.${d.path}` : `${d.feature}({ ${d.path} })`\n\nconst leaf = (path: string) => path.slice(path.lastIndexOf('.') + 1)\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const optionMessages: DiagnosticMessages<\n  'DK_UNKNOWN_OPTION' | 'DK_INVALID_OPTION' | 'DK_OPTION_NO_EFFECT'\n> = {\n  DK_UNKNOWN_OPTION: {\n    problem: (d) =>\n      d.feature === undefined\n        ? `unknown option \"${d.path}\"`\n        : `feature \"${d.feature}\" got an unknown option \"${d.path}\"`,\n    impact: () => 'the option is ignored',\n    fix: (d) => {\n      const out: string[] = []\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`did you mean \"${s}\"? rename \"${leaf(d.path)}\" to \"${s}\"`)\n      if (d.owner !== undefined) {\n        out.push(\n          `\"${d.path}\" is an option of feature \"${d.owner}\": pass it to the feature, ` +\n            `${d.owner}({ ${d.path}: ... })`,\n        )\n      }\n      out.push(\n        `remove \"${leaf(d.path)}\"; accepted ${d.feature === undefined ? '' : `${d.feature} `}` +\n          `options here: ${d.known.join(', ') || '(none)'}`,\n      )\n      return out\n    },\n  },\n  DK_INVALID_OPTION: {\n    problem: (d) => `${label(d)} must be ${d.expected}, got ${d.received}`,\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => {\n      const out: string[] = []\n      if (d.hint !== undefined) out.push(d.hint)\n      const s = d.suggestions[0]\n      if (s !== undefined) out.push(`use '${s}' (the closest accepted value) for ${label(d)}`)\n      out.push(`pass ${d.expected} as ${label(d)}, or leave it out for the default`)\n      return out\n    },\n  },\n  DK_OPTION_NO_EFFECT: {\n    problem: (d) =>\n      d.once\n        ? `setOptions({ ${d.path} }) has no effect: ${d.reason}`\n        : `${label(d)} has no effect: ${d.reason}`,\n    impact: (d) =>\n      d.once\n        ? 'the new value was ignored; the table keeps the value it was created with'\n        : 'the option is ignored in this configuration',\n    fix: (d) =>\n      d.once\n        ? [\n            `pass ${d.path} to createTable() instead; to change it, create a new table ` +\n              '(in React, change the component key)',\n          ]\n        : [`remove ${label(d)}, or change the configuration so that it applies (${d.reason})`],\n  },\n}\n\n/** Codes owned by the options catalog (§3.5, §8.3). */\nexport const optionDiagnostics = [\n  // Only the development option validator emits it: no definition in production.\n  ...((process.env.NODE_ENV !== \"production\")\n    ? [\n        defineDiagnostic(\n          {\n            code: 'DK_UNKNOWN_OPTION',\n            level: 'warn',\n            where,\n          },\n          (process.env.NODE_ENV !== \"production\") && optionMessages.DK_UNKNOWN_OPTION,\n        ),\n      ]\n    : []),\n  defineDiagnostic(\n    {\n      code: 'DK_INVALID_OPTION',\n      level: 'error',\n      config: true,\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_INVALID_OPTION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_OPTION_NO_EFFECT',\n      level: 'warn',\n      where,\n    },\n    (process.env.NODE_ENV !== \"production\") && optionMessages.DK_OPTION_NO_EFFECT,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/catalog/slots.cjs

@@ -30,13 +30,16 @@ __export(slots_exports, {
 });
 module.exports = __toCommonJS(slots_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var slots = /* @__PURE__ */ new Map();
 function defineSlot(slot) {
-  const prev = slots.get(slot.name);
-  if (process.env.NODE_ENV !== "production" && prev && prev.returns !== slot.returns) {
-    throw new Error(
-      `[DataKable] slot "${slot.name}" is already defined to return ${prev.returns}; a slot contract is never redefined \u2014 pick a new slot name`
-    );
+  if (process.env.NODE_ENV !== "production") {
+    const prev = slots.get(slot.name);
+    if (prev && prev.returns !== slot.returns) {
+      throw new Error(
+        `[DataKable] slot "${slot.name}" is already defined to return ${prev.returns}; a slot contract is never redefined \u2014 pick a new slot name`
+      );
+    }
   }
   slots.set(slot.name, slot);
   return slot;
@@ -70,7 +73,8 @@ var expectedReturn = (slot) => expectedText[slot.returns];
 var formatSlot = defineSlot({
   name: "format",
   returns: "string",
-  fallback: "those cells were coerced with the default formatter"
+  fallback: "cells-coerced"
+  // prose key (diagnostics/prose.ts)
 });
 var rowList = (rows, count) => {
   if (!rows || rows.length === 0) return "";

package/dist/catalog/slots.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/catalog/slots.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\n\n/** What a callback slot must return: a type, or `'sync'` (anything but a thenable). */\nexport type SlotReturns = 'string' | 'number' | 'boolean' | 'sync'\n\n/** A callback return contract (§3.5): read by the slot checks to report `DK_CALLBACK_BAD_RETURN`. */\nexport interface SlotDefinition {\n  /** The slot name, as in `columns[i].<name>` (`format`, `cell`). */\n  readonly name: string\n  readonly returns: SlotReturns\n  /** What DataKable does with a bad return (the diagnostic's impact). */\n  readonly fallback?: string\n}\n\nconst slots = new Map<string, SlotDefinition>()\n\n/**\n * Adds a callback return contract to the slot catalog and returns it. Like a diagnostic code, a slot\n * is never redefined with another contract (module re-evaluation with the same one is fine).\n */\nexport function defineSlot<const S extends SlotDefinition>(slot: S): S {\n  const prev = slots.get(slot.name)\n  // Development check: slots are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\") && prev && prev.returns !== slot.returns) {\n    throw new Error(\n      `[DataKable] slot \"${slot.name}\" is already defined to return ${prev.returns}; ` +\n        'a slot contract is never redefined — pick a new slot name',\n    )\n  }\n  slots.set(slot.name, slot)\n  return slot\n}\n\nexport function getSlot(name: string): SlotDefinition | undefined {\n  return slots.get(name)\n}\n\nconst isThenable = (v: unknown) =>\n  v != null &&\n  (typeof v === 'object' || typeof v === 'function') &&\n  typeof (v as { then?: unknown }).then === 'function'\n\n/** Whether `value` meets the slot's contract. */\nexport function matchesSlot(slot: Pick<SlotDefinition, 'returns'>, value: unknown): boolean {\n  return slot.returns === 'sync' ? !isThenable(value) : typeof value === slot.returns\n}\n\nconst article = (word: string) => (/^[AEIOUaeiou]/.test(word) ? `an ${word}` : `a ${word}`)\n\n/** The type of a returned value in words (`a number`, `an Array`, `a Promise`); never the value. */\nexport function describeReturn(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  const type = typeof value\n  if (type !== 'object' && type !== 'function') return article(type)\n  if (Array.isArray(value)) return 'an Array'\n  if (isThenable(value)) return 'a Promise'\n  const proto = Object.getPrototypeOf(value) as { constructor?: { name?: unknown } } | null\n  const name = proto?.constructor?.name\n  return typeof name === 'string' && name !== '' ? article(name) : article(type)\n}\n\nconst expectedText: Record<SlotReturns, string> = {\n  string: 'a string',\n  number: 'a number',\n  boolean: 'a boolean',\n  sync: 'a value (not a Promise)',\n}\n\n/** `expected` of a `DK_CALLBACK_BAD_RETURN` for `slot`. */\nexport const expectedReturn = (slot: Pick<SlotDefinition, 'returns'>) => expectedText[slot.returns]\n\n/** `columns[i].format` (§4.1): its value is coerced with the default formatter when not a string. */\nexport const formatSlot = defineSlot({\n  name: 'format',\n  returns: 'string',\n  fallback: 'those cells were coerced with the default formatter',\n})\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_CALLBACK_BAD_RETURN: {\n      /** The callback's option path, e.g. `columns[2].format`. */\n      slot: string\n      /** Column id, for cell slots. */\n      column?: string\n      /** The contract, in words (`a string`). */\n      expected: string\n      /** The type of the first bad return (`a number`); never the value. */\n      received: string\n      /** How many calls returned a bad value. */\n      count: number\n      /** A sample of the row indices (first few, in order). */\n      rows?: readonly number[]\n      /** The fallback that was applied. */\n      fallback: string\n    }\n  }\n}\n\nconst rowList = (rows: readonly number[] | undefined, count: number) => {\n  if (!rows || rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return ` (${count > rows.length ? `first: ${list}, …` : `rows ${list}`})`\n}\n\n/**\n * The slot contract check (§3.4 `slotContract`). Dev only: the definition, its text and every call\n * site sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has none of it. It runs inside the existing\n * `column:batch` loop (per batch, never an interceptor per cell).\n */\nexport const slotDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_CALLBACK_BAD_RETURN',\n        level: 'warn',\n        where: (d) => ({ kind: 'option', path: d.slot }),\n        problem: (d) =>\n          `${d.slot}${d.column === undefined ? '' : ` (column \"${d.column}\")`} returned ` +\n          `${d.received} instead of ${d.expected} for ` +\n          `${d.count === 1 ? '1 row' : `${d.count} rows`}${rowList(d.rows, d.count)}`,\n        impact: (d) => d.fallback,\n        fix: (d) => [\n          d.expected === 'a string'\n            ? `return a string from ${d.slot}, e.g. (v) => String(v) or (v) => v.toFixed(2)`\n            : `return ${d.expected} from ${d.slot}`,\n          `if ${d.slot} is async or returns markup, compute the value before the table ` +\n            '(or render it with cell)',\n        ],\n      }),\n    ]\n  : []\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiC;AAcjC,IAAM,QAAQ,oBAAI,IAA4B;AAMvC,SAAS,WAA2C,MAAY;AACrE,QAAM,OAAO,MAAM,IAAI,KAAK,IAAI;AAEhC,MAAK,QAAQ,IAAI,aAAa,gBAAiB,QAAQ,KAAK,YAAY,KAAK,SAAS;AACpF,UAAM,IAAI;AAAA,MACR,qBAAqB,KAAK,IAAI,kCAAkC,KAAK,OAAO;AAAA,IAE9E;AAAA,EACF;AACA,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,SAAO;AACT;AAEO,SAAS,QAAQ,MAA0C;AAChE,SAAO,MAAM,IAAI,IAAI;AACvB;AAEA,IAAM,aAAa,CAAC,MAClB,KAAK,SACJ,OAAO,MAAM,YAAY,OAAO,MAAM,eACvC,OAAQ,EAAyB,SAAS;AAGrC,SAAS,YAAY,MAAuC,OAAyB;AAC1F,SAAO,KAAK,YAAY,SAAS,CAAC,WAAW,KAAK,IAAI,OAAO,UAAU,KAAK;AAC9E;AAEA,IAAM,UAAU,CAAC,SAAkB,gBAAgB,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,KAAK,IAAI;AAGjF,SAAS,eAAe,OAAwB;AACrD,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,WAAY,QAAO,QAAQ,IAAI;AACjE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,MAAI,WAAW,KAAK,EAAG,QAAO;AAC9B,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,QAAM,OAAO,OAAO,aAAa;AACjC,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC/E;AAEA,IAAM,eAA4C;AAAA,EAChD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AACR;AAGO,IAAM,iBAAiB,CAAC,SAA0C,aAAa,KAAK,OAAO;AAG3F,IAAM,aAAa,WAAW;AAAA,EACnC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAuBD,IAAM,UAAU,CAAC,MAAqC,UAAkB;AACtE,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,QAAM,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAC/C,SAAO,KAAK,QAAQ,KAAK,SAAS,UAAU,IAAI,aAAQ,QAAQ,IAAI,EAAE;AACxE;AAOO,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,MACE,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,KAAK;AAAA,IAC9C,SAAS,CAAC,MACR,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,SAAY,KAAK,aAAa,EAAE,MAAM,IAAI,aAChE,EAAE,QAAQ,eAAe,EAAE,QAAQ,QACnC,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE,KAAK,OAAO,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA,IAC3E,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,aAAa,aACX,wBAAwB,EAAE,IAAI,mDAC9B,UAAU,EAAE,QAAQ,SAAS,EAAE,IAAI;AAAA,MACvC,MAAM,EAAE,IAAI;AAAA,IAEd;AAAA,EACF,CAAC;AACH,IACA,CAAC;","names":[]}
+{"version":3,"sources":["../../src/catalog/slots.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** What a callback slot must return: a type, or `'sync'` (anything but a thenable). */\nexport type SlotReturns = 'string' | 'number' | 'boolean' | 'sync'\n\n/** A callback return contract (§3.5): read by the slot checks to report `DK_CALLBACK_BAD_RETURN`. */\nexport interface SlotDefinition {\n  /** The slot name, as in `columns[i].<name>` (`format`, `cell`). */\n  readonly name: string\n  readonly returns: SlotReturns\n  /** What DataKable does with a bad return (the diagnostic's impact). */\n  readonly fallback?: string\n}\n\nconst slots = new Map<string, SlotDefinition>()\n\n/**\n * Adds a callback return contract to the slot catalog and returns it. Like a diagnostic code, a slot\n * is never redefined with another contract (module re-evaluation with the same one is fine).\n */\nexport function defineSlot<const S extends SlotDefinition>(slot: S): S {\n  // Development check: slots are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\")) {\n    const prev = slots.get(slot.name)\n    if (prev && prev.returns !== slot.returns) {\n      throw new Error(\n        `[DataKable] slot \"${slot.name}\" is already defined to return ${prev.returns}; ` +\n          'a slot contract is never redefined — pick a new slot name',\n      )\n    }\n  }\n  slots.set(slot.name, slot)\n  return slot\n}\n\nexport function getSlot(name: string): SlotDefinition | undefined {\n  return slots.get(name)\n}\n\nconst isThenable = (v: unknown) =>\n  v != null &&\n  (typeof v === 'object' || typeof v === 'function') &&\n  typeof (v as { then?: unknown }).then === 'function'\n\n/** Whether `value` meets the slot's contract. */\nexport function matchesSlot(slot: Pick<SlotDefinition, 'returns'>, value: unknown): boolean {\n  return slot.returns === 'sync' ? !isThenable(value) : typeof value === slot.returns\n}\n\nconst article = (word: string) => (/^[AEIOUaeiou]/.test(word) ? `an ${word}` : `a ${word}`)\n\n/** The type of a returned value in words (`a number`, `an Array`, `a Promise`); never the value. */\nexport function describeReturn(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  const type = typeof value\n  if (type !== 'object' && type !== 'function') return article(type)\n  if (Array.isArray(value)) return 'an Array'\n  if (isThenable(value)) return 'a Promise'\n  const proto = Object.getPrototypeOf(value) as { constructor?: { name?: unknown } } | null\n  const name = proto?.constructor?.name\n  return typeof name === 'string' && name !== '' ? article(name) : article(type)\n}\n\nconst expectedText: Record<SlotReturns, string> = {\n  string: 'a string',\n  number: 'a number',\n  boolean: 'a boolean',\n  sync: 'a value (not a Promise)',\n}\n\n/** `expected` of a `DK_CALLBACK_BAD_RETURN` for `slot`. */\nexport const expectedReturn = (slot: Pick<SlotDefinition, 'returns'>) => expectedText[slot.returns]\n\n/** `columns[i].format` (§4.1): its value is coerced with the default formatter when not a string. */\nexport const formatSlot = defineSlot({\n  name: 'format',\n  returns: 'string',\n  fallback: 'cells-coerced', // prose key (diagnostics/prose.ts)\n})\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_CALLBACK_BAD_RETURN: {\n      /** The callback's option path, e.g. `columns[2].format`. */\n      slot: string\n      /** Column id, for cell slots. */\n      column?: string\n      /** The contract, in words (`a string`). */\n      expected: string\n      /** The type of the first bad return (`a number`); never the value. */\n      received: string\n      /** How many calls returned a bad value. */\n      count: number\n      /** A sample of the row indices (first few, in order). */\n      rows?: readonly number[]\n      /** The fallback that was applied. */\n      fallback: string\n    }\n  }\n}\n\nconst rowList = (rows: readonly number[] | undefined, count: number) => {\n  if (!rows || rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return ` (${count > rows.length ? `first: ${list}, …` : `rows ${list}`})`\n}\n\n/**\n * The slot contract check (§3.4 `slotContract`). Dev only: the definition, its text and every call\n * site sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has none of it. It runs inside the existing\n * `column:batch` loop (per batch, never an interceptor per cell).\n */\nexport const slotDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_CALLBACK_BAD_RETURN',\n        level: 'warn',\n        where: (d) => ({ kind: 'option', path: d.slot }),\n        problem: (d) =>\n          `${d.slot}${d.column === undefined ? '' : ` (column \"${d.column}\")`} returned ` +\n          `${d.received} instead of ${d.expected} for ` +\n          `${d.count === 1 ? '1 row' : `${d.count} rows`}${rowList(d.rows, d.count)}`,\n        impact: (d) => d.fallback,\n        fix: (d) => [\n          d.expected === 'a string'\n            ? `return a string from ${d.slot}, e.g. (v) => String(v) or (v) => v.toFixed(2)`\n            : `return ${d.expected} from ${d.slot}`,\n          `if ${d.slot} is async or returns markup, compute the value before the table ` +\n            '(or render it with cell)',\n        ],\n      }),\n    ]\n  : []\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiC;AACjC,2BAAO;AAcP,IAAM,QAAQ,oBAAI,IAA4B;AAMvC,SAAS,WAA2C,MAAY;AAErE,MAAK,QAAQ,IAAI,aAAa,cAAe;AAC3C,UAAM,OAAO,MAAM,IAAI,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAK,YAAY,KAAK,SAAS;AACzC,YAAM,IAAI;AAAA,QACR,qBAAqB,KAAK,IAAI,kCAAkC,KAAK,OAAO;AAAA,MAE9E;AAAA,IACF;AAAA,EACF;AACA,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,SAAO;AACT;AAEO,SAAS,QAAQ,MAA0C;AAChE,SAAO,MAAM,IAAI,IAAI;AACvB;AAEA,IAAM,aAAa,CAAC,MAClB,KAAK,SACJ,OAAO,MAAM,YAAY,OAAO,MAAM,eACvC,OAAQ,EAAyB,SAAS;AAGrC,SAAS,YAAY,MAAuC,OAAyB;AAC1F,SAAO,KAAK,YAAY,SAAS,CAAC,WAAW,KAAK,IAAI,OAAO,UAAU,KAAK;AAC9E;AAEA,IAAM,UAAU,CAAC,SAAkB,gBAAgB,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,KAAK,IAAI;AAGjF,SAAS,eAAe,OAAwB;AACrD,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,WAAY,QAAO,QAAQ,IAAI;AACjE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,MAAI,WAAW,KAAK,EAAG,QAAO;AAC9B,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,QAAM,OAAO,OAAO,aAAa;AACjC,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC/E;AAEA,IAAM,eAA4C;AAAA,EAChD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AACR;AAGO,IAAM,iBAAiB,CAAC,SAA0C,aAAa,KAAK,OAAO;AAG3F,IAAM,aAAa,WAAW;AAAA,EACnC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AACZ,CAAC;AAuBD,IAAM,UAAU,CAAC,MAAqC,UAAkB;AACtE,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,QAAM,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAC/C,SAAO,KAAK,QAAQ,KAAK,SAAS,UAAU,IAAI,aAAQ,QAAQ,IAAI,EAAE;AACxE;AAOO,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,MACE,iCAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,KAAK;AAAA,IAC9C,SAAS,CAAC,MACR,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,SAAY,KAAK,aAAa,EAAE,MAAM,IAAI,aAChE,EAAE,QAAQ,eAAe,EAAE,QAAQ,QACnC,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE,KAAK,OAAO,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA,IAC3E,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,aAAa,aACX,wBAAwB,EAAE,IAAI,mDAC9B,UAAU,EAAE,QAAQ,SAAS,EAAE,IAAI;AAAA,MACvC,MAAM,EAAE,IAAI;AAAA,IAEd;AAAA,EACF,CAAC;AACH,IACA,CAAC;","names":[]}

package/dist/catalog/slots.js

@@ -1,12 +1,15 @@
 // src/catalog/slots.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var slots = /* @__PURE__ */ new Map();
 function defineSlot(slot) {
-  const prev = slots.get(slot.name);
-  if (process.env.NODE_ENV !== "production" && prev && prev.returns !== slot.returns) {
-    throw new Error(
-      `[DataKable] slot "${slot.name}" is already defined to return ${prev.returns}; a slot contract is never redefined \u2014 pick a new slot name`
-    );
+  if (process.env.NODE_ENV !== "production") {
+    const prev = slots.get(slot.name);
+    if (prev && prev.returns !== slot.returns) {
+      throw new Error(
+        `[DataKable] slot "${slot.name}" is already defined to return ${prev.returns}; a slot contract is never redefined \u2014 pick a new slot name`
+      );
+    }
   }
   slots.set(slot.name, slot);
   return slot;
@@ -40,7 +43,8 @@ var expectedReturn = (slot) => expectedText[slot.returns];
 var formatSlot = defineSlot({
   name: "format",
   returns: "string",
-  fallback: "those cells were coerced with the default formatter"
+  fallback: "cells-coerced"
+  // prose key (diagnostics/prose.ts)
 });
 var rowList = (rows, count) => {
   if (!rows || rows.length === 0) return "";

package/dist/catalog/slots.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/catalog/slots.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\n\n/** What a callback slot must return: a type, or `'sync'` (anything but a thenable). */\nexport type SlotReturns = 'string' | 'number' | 'boolean' | 'sync'\n\n/** A callback return contract (§3.5): read by the slot checks to report `DK_CALLBACK_BAD_RETURN`. */\nexport interface SlotDefinition {\n  /** The slot name, as in `columns[i].<name>` (`format`, `cell`). */\n  readonly name: string\n  readonly returns: SlotReturns\n  /** What DataKable does with a bad return (the diagnostic's impact). */\n  readonly fallback?: string\n}\n\nconst slots = new Map<string, SlotDefinition>()\n\n/**\n * Adds a callback return contract to the slot catalog and returns it. Like a diagnostic code, a slot\n * is never redefined with another contract (module re-evaluation with the same one is fine).\n */\nexport function defineSlot<const S extends SlotDefinition>(slot: S): S {\n  const prev = slots.get(slot.name)\n  // Development check: slots are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\") && prev && prev.returns !== slot.returns) {\n    throw new Error(\n      `[DataKable] slot \"${slot.name}\" is already defined to return ${prev.returns}; ` +\n        'a slot contract is never redefined — pick a new slot name',\n    )\n  }\n  slots.set(slot.name, slot)\n  return slot\n}\n\nexport function getSlot(name: string): SlotDefinition | undefined {\n  return slots.get(name)\n}\n\nconst isThenable = (v: unknown) =>\n  v != null &&\n  (typeof v === 'object' || typeof v === 'function') &&\n  typeof (v as { then?: unknown }).then === 'function'\n\n/** Whether `value` meets the slot's contract. */\nexport function matchesSlot(slot: Pick<SlotDefinition, 'returns'>, value: unknown): boolean {\n  return slot.returns === 'sync' ? !isThenable(value) : typeof value === slot.returns\n}\n\nconst article = (word: string) => (/^[AEIOUaeiou]/.test(word) ? `an ${word}` : `a ${word}`)\n\n/** The type of a returned value in words (`a number`, `an Array`, `a Promise`); never the value. */\nexport function describeReturn(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  const type = typeof value\n  if (type !== 'object' && type !== 'function') return article(type)\n  if (Array.isArray(value)) return 'an Array'\n  if (isThenable(value)) return 'a Promise'\n  const proto = Object.getPrototypeOf(value) as { constructor?: { name?: unknown } } | null\n  const name = proto?.constructor?.name\n  return typeof name === 'string' && name !== '' ? article(name) : article(type)\n}\n\nconst expectedText: Record<SlotReturns, string> = {\n  string: 'a string',\n  number: 'a number',\n  boolean: 'a boolean',\n  sync: 'a value (not a Promise)',\n}\n\n/** `expected` of a `DK_CALLBACK_BAD_RETURN` for `slot`. */\nexport const expectedReturn = (slot: Pick<SlotDefinition, 'returns'>) => expectedText[slot.returns]\n\n/** `columns[i].format` (§4.1): its value is coerced with the default formatter when not a string. */\nexport const formatSlot = defineSlot({\n  name: 'format',\n  returns: 'string',\n  fallback: 'those cells were coerced with the default formatter',\n})\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_CALLBACK_BAD_RETURN: {\n      /** The callback's option path, e.g. `columns[2].format`. */\n      slot: string\n      /** Column id, for cell slots. */\n      column?: string\n      /** The contract, in words (`a string`). */\n      expected: string\n      /** The type of the first bad return (`a number`); never the value. */\n      received: string\n      /** How many calls returned a bad value. */\n      count: number\n      /** A sample of the row indices (first few, in order). */\n      rows?: readonly number[]\n      /** The fallback that was applied. */\n      fallback: string\n    }\n  }\n}\n\nconst rowList = (rows: readonly number[] | undefined, count: number) => {\n  if (!rows || rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return ` (${count > rows.length ? `first: ${list}, …` : `rows ${list}`})`\n}\n\n/**\n * The slot contract check (§3.4 `slotContract`). Dev only: the definition, its text and every call\n * site sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has none of it. It runs inside the existing\n * `column:batch` loop (per batch, never an interceptor per cell).\n */\nexport const slotDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_CALLBACK_BAD_RETURN',\n        level: 'warn',\n        where: (d) => ({ kind: 'option', path: d.slot }),\n        problem: (d) =>\n          `${d.slot}${d.column === undefined ? '' : ` (column \"${d.column}\")`} returned ` +\n          `${d.received} instead of ${d.expected} for ` +\n          `${d.count === 1 ? '1 row' : `${d.count} rows`}${rowList(d.rows, d.count)}`,\n        impact: (d) => d.fallback,\n        fix: (d) => [\n          d.expected === 'a string'\n            ? `return a string from ${d.slot}, e.g. (v) => String(v) or (v) => v.toFixed(2)`\n            : `return ${d.expected} from ${d.slot}`,\n          `if ${d.slot} is async or returns markup, compute the value before the table ` +\n            '(or render it with cell)',\n        ],\n      }),\n    ]\n  : []\n"],"mappings":";AAAA,SAAS,wBAAwB;AAcjC,IAAM,QAAQ,oBAAI,IAA4B;AAMvC,SAAS,WAA2C,MAAY;AACrE,QAAM,OAAO,MAAM,IAAI,KAAK,IAAI;AAEhC,MAAK,QAAQ,IAAI,aAAa,gBAAiB,QAAQ,KAAK,YAAY,KAAK,SAAS;AACpF,UAAM,IAAI;AAAA,MACR,qBAAqB,KAAK,IAAI,kCAAkC,KAAK,OAAO;AAAA,IAE9E;AAAA,EACF;AACA,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,SAAO;AACT;AAEO,SAAS,QAAQ,MAA0C;AAChE,SAAO,MAAM,IAAI,IAAI;AACvB;AAEA,IAAM,aAAa,CAAC,MAClB,KAAK,SACJ,OAAO,MAAM,YAAY,OAAO,MAAM,eACvC,OAAQ,EAAyB,SAAS;AAGrC,SAAS,YAAY,MAAuC,OAAyB;AAC1F,SAAO,KAAK,YAAY,SAAS,CAAC,WAAW,KAAK,IAAI,OAAO,UAAU,KAAK;AAC9E;AAEA,IAAM,UAAU,CAAC,SAAkB,gBAAgB,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,KAAK,IAAI;AAGjF,SAAS,eAAe,OAAwB;AACrD,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,WAAY,QAAO,QAAQ,IAAI;AACjE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,MAAI,WAAW,KAAK,EAAG,QAAO;AAC9B,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,QAAM,OAAO,OAAO,aAAa;AACjC,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC/E;AAEA,IAAM,eAA4C;AAAA,EAChD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AACR;AAGO,IAAM,iBAAiB,CAAC,SAA0C,aAAa,KAAK,OAAO;AAG3F,IAAM,aAAa,WAAW;AAAA,EACnC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAuBD,IAAM,UAAU,CAAC,MAAqC,UAAkB;AACtE,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,QAAM,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAC/C,SAAO,KAAK,QAAQ,KAAK,SAAS,UAAU,IAAI,aAAQ,QAAQ,IAAI,EAAE;AACxE;AAOO,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,EACE,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,KAAK;AAAA,IAC9C,SAAS,CAAC,MACR,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,SAAY,KAAK,aAAa,EAAE,MAAM,IAAI,aAChE,EAAE,QAAQ,eAAe,EAAE,QAAQ,QACnC,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE,KAAK,OAAO,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA,IAC3E,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,aAAa,aACX,wBAAwB,EAAE,IAAI,mDAC9B,UAAU,EAAE,QAAQ,SAAS,EAAE,IAAI;AAAA,MACvC,MAAM,EAAE,IAAI;AAAA,IAEd;AAAA,EACF,CAAC;AACH,IACA,CAAC;","names":[]}
+{"version":3,"sources":["../../src/catalog/slots.ts"],"sourcesContent":["import { defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** What a callback slot must return: a type, or `'sync'` (anything but a thenable). */\nexport type SlotReturns = 'string' | 'number' | 'boolean' | 'sync'\n\n/** A callback return contract (§3.5): read by the slot checks to report `DK_CALLBACK_BAD_RETURN`. */\nexport interface SlotDefinition {\n  /** The slot name, as in `columns[i].<name>` (`format`, `cell`). */\n  readonly name: string\n  readonly returns: SlotReturns\n  /** What DataKable does with a bad return (the diagnostic's impact). */\n  readonly fallback?: string\n}\n\nconst slots = new Map<string, SlotDefinition>()\n\n/**\n * Adds a callback return contract to the slot catalog and returns it. Like a diagnostic code, a slot\n * is never redefined with another contract (module re-evaluation with the same one is fine).\n */\nexport function defineSlot<const S extends SlotDefinition>(slot: S): S {\n  // Development check: slots are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\")) {\n    const prev = slots.get(slot.name)\n    if (prev && prev.returns !== slot.returns) {\n      throw new Error(\n        `[DataKable] slot \"${slot.name}\" is already defined to return ${prev.returns}; ` +\n          'a slot contract is never redefined — pick a new slot name',\n      )\n    }\n  }\n  slots.set(slot.name, slot)\n  return slot\n}\n\nexport function getSlot(name: string): SlotDefinition | undefined {\n  return slots.get(name)\n}\n\nconst isThenable = (v: unknown) =>\n  v != null &&\n  (typeof v === 'object' || typeof v === 'function') &&\n  typeof (v as { then?: unknown }).then === 'function'\n\n/** Whether `value` meets the slot's contract. */\nexport function matchesSlot(slot: Pick<SlotDefinition, 'returns'>, value: unknown): boolean {\n  return slot.returns === 'sync' ? !isThenable(value) : typeof value === slot.returns\n}\n\nconst article = (word: string) => (/^[AEIOUaeiou]/.test(word) ? `an ${word}` : `a ${word}`)\n\n/** The type of a returned value in words (`a number`, `an Array`, `a Promise`); never the value. */\nexport function describeReturn(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  const type = typeof value\n  if (type !== 'object' && type !== 'function') return article(type)\n  if (Array.isArray(value)) return 'an Array'\n  if (isThenable(value)) return 'a Promise'\n  const proto = Object.getPrototypeOf(value) as { constructor?: { name?: unknown } } | null\n  const name = proto?.constructor?.name\n  return typeof name === 'string' && name !== '' ? article(name) : article(type)\n}\n\nconst expectedText: Record<SlotReturns, string> = {\n  string: 'a string',\n  number: 'a number',\n  boolean: 'a boolean',\n  sync: 'a value (not a Promise)',\n}\n\n/** `expected` of a `DK_CALLBACK_BAD_RETURN` for `slot`. */\nexport const expectedReturn = (slot: Pick<SlotDefinition, 'returns'>) => expectedText[slot.returns]\n\n/** `columns[i].format` (§4.1): its value is coerced with the default formatter when not a string. */\nexport const formatSlot = defineSlot({\n  name: 'format',\n  returns: 'string',\n  fallback: 'cells-coerced', // prose key (diagnostics/prose.ts)\n})\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_CALLBACK_BAD_RETURN: {\n      /** The callback's option path, e.g. `columns[2].format`. */\n      slot: string\n      /** Column id, for cell slots. */\n      column?: string\n      /** The contract, in words (`a string`). */\n      expected: string\n      /** The type of the first bad return (`a number`); never the value. */\n      received: string\n      /** How many calls returned a bad value. */\n      count: number\n      /** A sample of the row indices (first few, in order). */\n      rows?: readonly number[]\n      /** The fallback that was applied. */\n      fallback: string\n    }\n  }\n}\n\nconst rowList = (rows: readonly number[] | undefined, count: number) => {\n  if (!rows || rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return ` (${count > rows.length ? `first: ${list}, …` : `rows ${list}`})`\n}\n\n/**\n * The slot contract check (§3.4 `slotContract`). Dev only: the definition, its text and every call\n * site sit behind `(process.env.NODE_ENV !== \"production\")`, so a production bundle has none of it. It runs inside the existing\n * `column:batch` loop (per batch, never an interceptor per cell).\n */\nexport const slotDiagnostics = (process.env.NODE_ENV !== \"production\")\n  ? [\n      defineDiagnostic({\n        code: 'DK_CALLBACK_BAD_RETURN',\n        level: 'warn',\n        where: (d) => ({ kind: 'option', path: d.slot }),\n        problem: (d) =>\n          `${d.slot}${d.column === undefined ? '' : ` (column \"${d.column}\")`} returned ` +\n          `${d.received} instead of ${d.expected} for ` +\n          `${d.count === 1 ? '1 row' : `${d.count} rows`}${rowList(d.rows, d.count)}`,\n        impact: (d) => d.fallback,\n        fix: (d) => [\n          d.expected === 'a string'\n            ? `return a string from ${d.slot}, e.g. (v) => String(v) or (v) => v.toFixed(2)`\n            : `return ${d.expected} from ${d.slot}`,\n          `if ${d.slot} is async or returns markup, compute the value before the table ` +\n            '(or render it with cell)',\n        ],\n      }),\n    ]\n  : []\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,OAAO;AAcP,IAAM,QAAQ,oBAAI,IAA4B;AAMvC,SAAS,WAA2C,MAAY;AAErE,MAAK,QAAQ,IAAI,aAAa,cAAe;AAC3C,UAAM,OAAO,MAAM,IAAI,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAK,YAAY,KAAK,SAAS;AACzC,YAAM,IAAI;AAAA,QACR,qBAAqB,KAAK,IAAI,kCAAkC,KAAK,OAAO;AAAA,MAE9E;AAAA,IACF;AAAA,EACF;AACA,QAAM,IAAI,KAAK,MAAM,IAAI;AACzB,SAAO;AACT;AAEO,SAAS,QAAQ,MAA0C;AAChE,SAAO,MAAM,IAAI,IAAI;AACvB;AAEA,IAAM,aAAa,CAAC,MAClB,KAAK,SACJ,OAAO,MAAM,YAAY,OAAO,MAAM,eACvC,OAAQ,EAAyB,SAAS;AAGrC,SAAS,YAAY,MAAuC,OAAyB;AAC1F,SAAO,KAAK,YAAY,SAAS,CAAC,WAAW,KAAK,IAAI,OAAO,UAAU,KAAK;AAC9E;AAEA,IAAM,UAAU,CAAC,SAAkB,gBAAgB,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,KAAK,IAAI;AAGjF,SAAS,eAAe,OAAwB;AACrD,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,WAAY,QAAO,QAAQ,IAAI;AACjE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,MAAI,WAAW,KAAK,EAAG,QAAO;AAC9B,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,QAAM,OAAO,OAAO,aAAa;AACjC,SAAO,OAAO,SAAS,YAAY,SAAS,KAAK,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC/E;AAEA,IAAM,eAA4C;AAAA,EAChD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AACR;AAGO,IAAM,iBAAiB,CAAC,SAA0C,aAAa,KAAK,OAAO;AAG3F,IAAM,aAAa,WAAW;AAAA,EACnC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA;AACZ,CAAC;AAuBD,IAAM,UAAU,CAAC,MAAqC,UAAkB;AACtE,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,QAAM,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAC/C,SAAO,KAAK,QAAQ,KAAK,SAAS,UAAU,IAAI,aAAQ,QAAQ,IAAI,EAAE;AACxE;AAOO,IAAM,kBAAmB,QAAQ,IAAI,aAAa,eACrD;AAAA,EACE,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,OAAO;AAAA,IACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,KAAK;AAAA,IAC9C,SAAS,CAAC,MACR,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,SAAY,KAAK,aAAa,EAAE,MAAM,IAAI,aAChE,EAAE,QAAQ,eAAe,EAAE,QAAQ,QACnC,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE,KAAK,OAAO,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA,IAC3E,QAAQ,CAAC,MAAM,EAAE;AAAA,IACjB,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,aAAa,aACX,wBAAwB,EAAE,IAAI,mDAC9B,UAAU,EAAE,QAAQ,SAAS,EAAE,IAAI;AAAA,MACvC,MAAM,EAAE,IAAI;AAAA,IAEd;AAAA,EACF,CAAC;AACH,IACA,CAAC;","names":[]}

package/dist/{codes-OsjAR3Wz.d.cts → codes-B9bCK73-.d.cts}

@@ -86,6 +86,11 @@ interface EmitOptions {
     run?: number;
     trigger?: Trigger;
     phase?: Phase;
+    /**
+     * Not printed by the default console sink (another table printed it in this process, #38). Still
+     * stored and delivered to `onDiagnostic`.
+     */
+    quiet?: boolean;
 }
 /** Emits a catalog diagnostic; `details` is typed by `code` (see `DiagnosticCatalog`). */
 type Emit = <C extends DiagnosticCode>(code: C, details: DiagnosticDetails<C>, options?: EmitOptions) => void;
@@ -114,7 +119,7 @@ interface RedactionOptions {
     redact?: RedactFn;
     /** Ids / keys of `sensitive: true` columns: never logged at any level. */
     sensitiveColumns?: () => Iterable<string>;
-    /** The `rowKey` column is sensitive: row keys are hashed at every level. */
+    /** The `rowKey` path is, is inside or contains a sensitive column: keys hashed at every level. */
     rowKeySensitive?: () => boolean;
 }
 /**
@@ -148,7 +153,9 @@ declare function hashRowKey(key: unknown): string;
 declare function describeValue(v: unknown): string;
 /**
  * A schema issue as `{ path, message }`. Validators embed received values in their messages, so
- * under `'safe'` / `'keys'` (and for sensitive columns) the message is DataKable's own text.
+ * under `'safe'` / `'keys'` the message is DataKable's own text. So it is at every level when the
+ * table has a sensitive column: any message (a root-level refinement, another field's) may embed
+ * its value (#46).
  */
 declare function scrubSchemaIssue(issue: unknown, r: Redactor, fieldPath?: string): {
     path: string;
@@ -307,7 +314,7 @@ declare function describeReturn(value: unknown): string;
 declare const formatSlot: {
     readonly name: "format";
     readonly returns: "string";
-    readonly fallback: "those cells were coerced with the default formatter";
+    readonly fallback: "cells-coerced";
 };
 declare module '@datakable/core' {
     interface DiagnosticCatalog {
@@ -721,6 +728,12 @@ declare module '@datakable/core' {
             /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */
             hadResults: boolean;
         };
+        DK_SEARCH_COLUMN_SKIPPED: {
+            /** Column id (`key` or `id`). */
+            column: string;
+            /** Position in the table's columns (`options.columns`, else the derived columns). */
+            index: number;
+        };
     }
 }
 /** Codes owned by the `search` feature (spec §6.3, §8.3). */
@@ -956,6 +969,14 @@ declare module '@datakable/core' {
             rows: number;
             /** The budget, in milliseconds (§9.3: the longest task). */
             budget: number;
+            /** One slice of the step's time-sliced work, run between pipeline runs (#61). */
+            sliced?: boolean;
+            /** The column slot at least half of the time went to, e.g. `columns[0].format` (#62). */
+            slot?: string;
+            /** Its column id. */
+            column?: string;
+            /** Its share of {@link ms}, 0.5 to 1. */
+            share?: number;
         };
     }
 }
@@ -1055,6 +1076,11 @@ declare module '@datakable/core' {
             /** Versions of every registered core copy, in registration order (this copy last). */
             versions: string[];
         };
+        DK_DUPLICATE_CORE_SAME_VERSION: {
+            version: string;
+            /** Copies of core registered so far (this copy included), all of `version`. */
+            copies: number;
+        };
         DK_VERSION_MISMATCH: {
             /** The fixed-group package whose version differs, e.g. `@datakable/react`. */
             package: string;
@@ -1083,7 +1109,7 @@ declare module '@datakable/core' {
     }
 }
 /** Codes owned by versioning (§8.5). */
-declare const versioningDiagnostics: (DiagnosticDefinition<"DK_DEPRECATED"> | DiagnosticDefinition<"DK_DUPLICATE_CORE"> | DiagnosticDefinition<"DK_VERSION_MISMATCH"> | DiagnosticDefinition<"DK_DEP_INCOMPATIBLE"> | DiagnosticDefinition<"DK_FEATURE_INCOMPATIBLE">)[];
+declare const versioningDiagnostics: (DiagnosticDefinition<"DK_DEPRECATED"> | DiagnosticDefinition<"DK_DUPLICATE_CORE"> | DiagnosticDefinition<"DK_DUPLICATE_CORE_SAME_VERSION"> | DiagnosticDefinition<"DK_VERSION_MISMATCH"> | DiagnosticDefinition<"DK_DEP_INCOMPATIBLE"> | DiagnosticDefinition<"DK_FEATURE_INCOMPATIBLE">)[];
 
 declare module '@datakable/core' {
     interface DiagnosticCatalog {

package/dist/{codes-OsjAR3Wz.d.ts → codes-B9bCK73-.d.ts}

@@ -86,6 +86,11 @@ interface EmitOptions {
     run?: number;
     trigger?: Trigger;
     phase?: Phase;
+    /**
+     * Not printed by the default console sink (another table printed it in this process, #38). Still
+     * stored and delivered to `onDiagnostic`.
+     */
+    quiet?: boolean;
 }
 /** Emits a catalog diagnostic; `details` is typed by `code` (see `DiagnosticCatalog`). */
 type Emit = <C extends DiagnosticCode>(code: C, details: DiagnosticDetails<C>, options?: EmitOptions) => void;
@@ -114,7 +119,7 @@ interface RedactionOptions {
     redact?: RedactFn;
     /** Ids / keys of `sensitive: true` columns: never logged at any level. */
     sensitiveColumns?: () => Iterable<string>;
-    /** The `rowKey` column is sensitive: row keys are hashed at every level. */
+    /** The `rowKey` path is, is inside or contains a sensitive column: keys hashed at every level. */
     rowKeySensitive?: () => boolean;
 }
 /**
@@ -148,7 +153,9 @@ declare function hashRowKey(key: unknown): string;
 declare function describeValue(v: unknown): string;
 /**
  * A schema issue as `{ path, message }`. Validators embed received values in their messages, so
- * under `'safe'` / `'keys'` (and for sensitive columns) the message is DataKable's own text.
+ * under `'safe'` / `'keys'` the message is DataKable's own text. So it is at every level when the
+ * table has a sensitive column: any message (a root-level refinement, another field's) may embed
+ * its value (#46).
  */
 declare function scrubSchemaIssue(issue: unknown, r: Redactor, fieldPath?: string): {
     path: string;
@@ -307,7 +314,7 @@ declare function describeReturn(value: unknown): string;
 declare const formatSlot: {
     readonly name: "format";
     readonly returns: "string";
-    readonly fallback: "those cells were coerced with the default formatter";
+    readonly fallback: "cells-coerced";
 };
 declare module '@datakable/core' {
     interface DiagnosticCatalog {
@@ -721,6 +728,12 @@ declare module '@datakable/core' {
             /** Whether a previous `searchFn` result is shown (`false`: none applied yet). */
             hadResults: boolean;
         };
+        DK_SEARCH_COLUMN_SKIPPED: {
+            /** Column id (`key` or `id`). */
+            column: string;
+            /** Position in the table's columns (`options.columns`, else the derived columns). */
+            index: number;
+        };
     }
 }
 /** Codes owned by the `search` feature (spec §6.3, §8.3). */
@@ -956,6 +969,14 @@ declare module '@datakable/core' {
             rows: number;
             /** The budget, in milliseconds (§9.3: the longest task). */
             budget: number;
+            /** One slice of the step's time-sliced work, run between pipeline runs (#61). */
+            sliced?: boolean;
+            /** The column slot at least half of the time went to, e.g. `columns[0].format` (#62). */
+            slot?: string;
+            /** Its column id. */
+            column?: string;
+            /** Its share of {@link ms}, 0.5 to 1. */
+            share?: number;
         };
     }
 }
@@ -1055,6 +1076,11 @@ declare module '@datakable/core' {
             /** Versions of every registered core copy, in registration order (this copy last). */
             versions: string[];
         };
+        DK_DUPLICATE_CORE_SAME_VERSION: {
+            version: string;
+            /** Copies of core registered so far (this copy included), all of `version`. */
+            copies: number;
+        };
         DK_VERSION_MISMATCH: {
             /** The fixed-group package whose version differs, e.g. `@datakable/react`. */
             package: string;
@@ -1083,7 +1109,7 @@ declare module '@datakable/core' {
     }
 }
 /** Codes owned by versioning (§8.5). */
-declare const versioningDiagnostics: (DiagnosticDefinition<"DK_DEPRECATED"> | DiagnosticDefinition<"DK_DUPLICATE_CORE"> | DiagnosticDefinition<"DK_VERSION_MISMATCH"> | DiagnosticDefinition<"DK_DEP_INCOMPATIBLE"> | DiagnosticDefinition<"DK_FEATURE_INCOMPATIBLE">)[];
+declare const versioningDiagnostics: (DiagnosticDefinition<"DK_DEPRECATED"> | DiagnosticDefinition<"DK_DUPLICATE_CORE"> | DiagnosticDefinition<"DK_DUPLICATE_CORE_SAME_VERSION"> | DiagnosticDefinition<"DK_VERSION_MISMATCH"> | DiagnosticDefinition<"DK_DEP_INCOMPATIBLE"> | DiagnosticDefinition<"DK_FEATURE_INCOMPATIBLE">)[];
 
 declare module '@datakable/core' {
     interface DiagnosticCatalog {

package/dist/column/column-def.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/column/column-def.ts"],"sourcesContent":["import type { RowIssue } from '../pipeline/row'\nimport type { IsAny, Path, PathValue, Primitive } from './path'\n\n/** Whole-row `any` is treated as `Record<string, unknown>` (spec §4.2); other rows pass through. */\nexport type LooseRow<T> = IsAny<T> extends true ? Record<string, unknown> : T\n\n/** `true` for `any` and `unknown`: values whose shape is not known at compile time. */\ntype IsLoose<V> = IsAny<V> extends true ? true : unknown extends V ? true : false\n\n/** Type-agnostic filter kinds, the only ones allowed for `any` / `unknown` values. */\ntype LooseFilter = { type: 'equals' } | { type: 'contains' }\n\n// The filter sets are named so a wrong kind reads \"not assignable to type 'StringFilter'\" instead\n// of an inlined union (docs/how-to-fix/reading-type-errors.md, E3).\n/** Filter kinds for number, bigint and `Date` values. */\ntype NumberFilter = { type: 'range' } | { type: 'equals' } | { type: 'in' }\n/** Filter kinds for string values. `range` is not one of them. */\ntype StringFilter = { type: 'equals' } | { type: 'in' } | { type: 'contains' }\n/** Filter kinds for boolean values. */\ntype BooleanFilter = { type: 'equals' }\n\n/**\n * Filter kinds allowed for a column whose value type is `V` (spec §4.1, §6.1). Arrays of\n * primitives take their element's kinds (an array cell matches if any element matches).\n */\nexport type FilterFor<V> =\n  IsLoose<V> extends true\n    ? LooseFilter\n    : NonNullable<V> extends number | bigint | Date\n      ? NumberFilter\n      : NonNullable<V> extends string\n        ? StringFilter\n        : NonNullable<V> extends boolean\n          ? BooleanFilter\n          : NonNullable<V> extends readonly (infer E)[]\n            ? FilterFor<E>\n            : never\n\n/** Values the default formatter can render: primitives, `Date`, arrays of those. */\ntype Displayable = Primitive | readonly Primitive[]\n\n/** Argument of a column's `cell` renderer. */\nexport type CellContext<T, V> = { row: T; value: V }\n\n/** Argument of a column's `invalidCell` renderer (a flagged row, `invalidRows: 'flag'`, §5.1). */\nexport type InvalidCellContext = {\n  /** The raw, unvalidated row. */\n  original: unknown\n  /** The cell's raw value (the column's key path or accessor over `original`). */\n  value: unknown\n  /** The row's schema issues that touch this cell: `row.getCellIssues(column)`. */\n  issues: readonly RowIssue[]\n}\n\n/** Built-in sort algorithms, or a custom one over row indices (spec §6.4). */\nexport type SortAlgorithm =\n  | 'auto'\n  | 'tim'\n  | 'radix'\n  | 'counting'\n  | 'native'\n  | ((indices: Uint32Array, compare: (a: number, b: number) => number) => Uint32Array)\n\n/** Fields shared by every column whose value type is `V`. */\ntype BaseColumn<T, V, R> = {\n  header?: string\n  /** Search weight; omit to exclude the column from search. */\n  search?: number\n  sortable?: boolean\n  sortFn?: (a: V, b: V) => number\n  sortBy?: (row: T) => Primitive\n  sortAlgorithm?: SortAlgorithm\n  filter?: FilterFor<V>\n  /** Never logged by diagnostics at any level. */\n  sensitive?: boolean\n  invalidCell?: (ctx: InvalidCellContext) => R\n  /**\n   * Renders the cell. Required (or `format`) when the value is an object, a function or an\n   * array of objects — the default formatter cannot display those. Primitives, `Date`, arrays of\n   * primitives, `unknown` and `any` need neither. Returns `R` (`ReactNode` in\n   * `@datakable/react`).\n   */\n  cell?: (ctx: CellContext<T, V>) => R\n  /**\n   * Formats the value to a string. Required (or `cell`) when the value is an object, a function\n   * or an array of objects — the default formatter cannot display those. Primitives, `Date`,\n   * arrays of primitives, `unknown` and `any` need neither.\n   */\n  format?: (value: V) => string\n}\n\n/**\n * Rendering requirement for value `V`: objects, functions and arrays of objects MUST give `cell`\n * or `format`. Primitives, `Date`, arrays of primitives, `unknown` and `any` need neither.\n */\nexport type RenderReq<T, V, R> =\n  IsLoose<V> extends true\n    ? BaseColumn<T, V, R>\n    : [NonNullable<V>] extends [Displayable]\n      ? BaseColumn<T, V, R>\n      : BaseColumn<T, V, R> & (NeedsCell<T, V, R> | NeedsFormat<V>)\n\n// The two ways to satisfy the rendering requirement are named so that a column missing both reads\n// \"Property 'format' is missing ... required in type 'NeedsFormat<V>'\", with `NeedsCell<T, V, R>`\n// listed as the alternative (docs/how-to-fix/reading-type-errors.md, E4 / E5). The JSDoc repeats BaseColumn's\n// word for word: autocomplete on a required `cell` / `format` shows it once only while the copies\n// are identical (pinned in type-errors.test.ts).\n\n/** Value `V` cannot be shown by the default formatter: the column needs `cell` (or `format`). */\ntype NeedsCell<T, V, R> = {\n  /**\n   * Renders the cell. Required (or `format`) when the value is an object, a function or an\n   * array of objects — the default formatter cannot display those. Primitives, `Date`, arrays of\n   * primitives, `unknown` and `any` need neither. Returns `R` (`ReactNode` in\n   * `@datakable/react`).\n   */\n  cell: (ctx: CellContext<T, V>) => R\n}\n\n/** Value `V` cannot be shown by the default formatter: the column needs `format` (or `cell`). */\ntype NeedsFormat<V> = {\n  /**\n   * Formats the value to a string. Required (or `cell`) when the value is an object, a function\n   * or an array of objects — the default formatter cannot display those. Primitives, `Date`,\n   * arrays of primitives, `unknown` and `any` need neither.\n   */\n  format: (value: V) => string\n}\n\n/**\n * Sort requirement for value `V` (spec §6.4): an object, function or array-of-objects column has\n * no default order, so `sortable: true` needs `sortFn` or `sortBy`. Primitives, `Date`, arrays of\n * primitives, `unknown` and `any` need neither.\n */\nexport type SortReq<T, V> =\n  IsLoose<V> extends true\n    ? unknown\n    : [NonNullable<V>] extends [Displayable]\n      ? unknown\n      : { sortable?: false } | NeedsSortFn<V> | NeedsSortBy<T>\n\n/** `sortable: true` on a column without a default order: compare the values with `sortFn`. */\ntype NeedsSortFn<V> = { sortable: true; sortFn: (a: V, b: V) => number }\n/** `sortable: true` on a column without a default order: sort by a primitive key. */\ntype NeedsSortBy<T> = { sortable: true; sortBy: (row: T) => Primitive }\n\n/** A column bound to a dot-path of `T`; a distributive union over every path. */\nexport type KeyColumn<T, R> = {\n  [P in Path<T>]: { key: P } & RenderReq<T, PathValue<T, P>, R> & SortReq<T, PathValue<T, P>>\n}[Path<T>]\n\n/** A derived column: `accessor` computes the value from the (contextually typed) row. */\nexport type AccessorColumn<T, R> = {\n  id: string\n  accessor: (row: T) => unknown\n  key?: never\n} & BaseColumn<T, unknown, R>\n\n/**\n * One column of a table over rows `T`. `R` is the `cell` render result (`unknown` in core,\n * `ReactNode` in `@datakable/react`). Whole-row `any` is treated as `Record<string, unknown>`.\n */\nexport type ColumnDef<T, R = unknown> = KeyColumn<LooseRow<T>, R> | AccessorColumn<LooseRow<T>, R>\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/column/column-def.ts"],"sourcesContent":["import type { RowIssue } from '../pipeline/row'\nimport type { IsAny, Path, PathValue, Primitive } from './path'\n\n/** Whole-row `any` is treated as `Record<string, unknown>` (spec §4.2); other rows pass through. */\nexport type LooseRow<T> = IsAny<T> extends true ? Record<string, unknown> : T\n\n/** `true` for `any` and `unknown`: values whose shape is not known at compile time. */\ntype IsLoose<V> = IsAny<V> extends true ? true : unknown extends V ? true : false\n\n/** Type-agnostic filter kinds, the only ones allowed for `any` / `unknown` values. */\ntype LooseFilter = { type: 'equals' } | { type: 'contains' }\n\n// The filter sets are named so a wrong kind reads \"not assignable to type 'StringFilter'\" instead\n// of an inlined union (docs/how-to-fix/reading-type-errors.md, E3).\n/** Filter kinds for number, bigint and `Date` values. */\ntype NumberFilter = { type: 'range' } | { type: 'equals' } | { type: 'in' }\n/** Filter kinds for string values. `range` is not one of them. */\ntype StringFilter = { type: 'equals' } | { type: 'in' } | { type: 'contains' }\n/** Filter kinds for boolean values. */\ntype BooleanFilter = { type: 'equals' }\n\n/**\n * Filter kinds allowed for a column whose value type is `V` (spec §4.1, §6.1). Arrays of\n * primitives take their element's kinds (an array cell matches if any element matches).\n */\nexport type FilterFor<V> =\n  IsLoose<V> extends true\n    ? LooseFilter\n    : NonNullable<V> extends number | bigint | Date\n      ? NumberFilter\n      : NonNullable<V> extends string\n        ? StringFilter\n        : NonNullable<V> extends boolean\n          ? BooleanFilter\n          : NonNullable<V> extends readonly (infer E)[]\n            ? FilterFor<E>\n            : never\n\n/** Values the default formatter can render: primitives, `Date`, arrays of those. */\ntype Displayable = Primitive | readonly Primitive[]\n\n/** Argument of a column's `cell` renderer. */\nexport type CellContext<T, V> = { row: T; value: V }\n\n/** Argument of a column's `invalidCell` renderer (a flagged row, `invalidRows: 'flag'`, §5.1). */\nexport type InvalidCellContext = {\n  /** The raw, unvalidated row. */\n  original: unknown\n  /** The cell's raw value (the column's key path or accessor over `original`). */\n  value: unknown\n  /** The row's schema issues that touch this cell: `row.getCellIssues(column)`. */\n  issues: readonly RowIssue[]\n}\n\n/** Built-in sort algorithms, or a custom one over row indices (spec §6.4). */\nexport type SortAlgorithm =\n  | 'auto'\n  | 'tim'\n  | 'radix'\n  | 'counting'\n  | 'native'\n  | ((indices: Uint32Array, compare: (a: number, b: number) => number) => Uint32Array)\n\n/** Fields shared by every column whose value type is `V`. */\ntype BaseColumn<T, V, R> = {\n  header?: string\n  /**\n   * Search weight. Once any column declares one, only weighted columns are searched; when none\n   * does, the columns of strings, numbers and booleans are (a date, array or object column needs a\n   * weight to be searched).\n   */\n  search?: number\n  sortable?: boolean\n  sortFn?: (a: V, b: V) => number\n  sortBy?: (row: T) => Primitive\n  sortAlgorithm?: SortAlgorithm\n  filter?: FilterFor<V>\n  /** Never logged by diagnostics at any level. */\n  sensitive?: boolean\n  invalidCell?: (ctx: InvalidCellContext) => R\n  /**\n   * Renders the cell. Required (or `format`) when the value is an object, a function or an\n   * array of objects — the default formatter cannot display those. Primitives, `Date`, arrays of\n   * primitives, `unknown` and `any` need neither. Returns `R` (`ReactNode` in\n   * `@datakable/react`).\n   */\n  cell?: (ctx: CellContext<T, V>) => R\n  /**\n   * Formats the value to a string. Required (or `cell`) when the value is an object, a function\n   * or an array of objects — the default formatter cannot display those. Primitives, `Date`,\n   * arrays of primitives, `unknown` and `any` need neither.\n   */\n  format?: (value: V) => string\n}\n\n/**\n * Rendering requirement for value `V`: objects, functions and arrays of objects MUST give `cell`\n * or `format`. Primitives, `Date`, arrays of primitives, `unknown` and `any` need neither.\n */\nexport type RenderReq<T, V, R> =\n  IsLoose<V> extends true\n    ? BaseColumn<T, V, R>\n    : [NonNullable<V>] extends [Displayable]\n      ? BaseColumn<T, V, R>\n      : BaseColumn<T, V, R> & (NeedsCell<T, V, R> | NeedsFormat<V>)\n\n// The two ways to satisfy the rendering requirement are named so that a column missing both reads\n// \"Property 'format' is missing ... required in type 'NeedsFormat<V>'\", with `NeedsCell<T, V, R>`\n// listed as the alternative (docs/how-to-fix/reading-type-errors.md, E4 / E5). The JSDoc repeats BaseColumn's\n// word for word: autocomplete on a required `cell` / `format` shows it once only while the copies\n// are identical (pinned in type-errors.test.ts).\n\n/** Value `V` cannot be shown by the default formatter: the column needs `cell` (or `format`). */\ntype NeedsCell<T, V, R> = {\n  /**\n   * Renders the cell. Required (or `format`) when the value is an object, a function or an\n   * array of objects — the default formatter cannot display those. Primitives, `Date`, arrays of\n   * primitives, `unknown` and `any` need neither. Returns `R` (`ReactNode` in\n   * `@datakable/react`).\n   */\n  cell: (ctx: CellContext<T, V>) => R\n}\n\n/** Value `V` cannot be shown by the default formatter: the column needs `format` (or `cell`). */\ntype NeedsFormat<V> = {\n  /**\n   * Formats the value to a string. Required (or `cell`) when the value is an object, a function\n   * or an array of objects — the default formatter cannot display those. Primitives, `Date`,\n   * arrays of primitives, `unknown` and `any` need neither.\n   */\n  format: (value: V) => string\n}\n\n/**\n * Sort requirement for value `V` (spec §6.4): an object, function or array-of-objects column has\n * no default order, so `sortable: true` needs `sortFn` or `sortBy`. Primitives, `Date`, arrays of\n * primitives, `unknown` and `any` need neither.\n */\nexport type SortReq<T, V> =\n  IsLoose<V> extends true\n    ? unknown\n    : [NonNullable<V>] extends [Displayable]\n      ? unknown\n      : { sortable?: false } | NeedsSortFn<V> | NeedsSortBy<T>\n\n/** `sortable: true` on a column without a default order: compare the values with `sortFn`. */\ntype NeedsSortFn<V> = { sortable: true; sortFn: (a: V, b: V) => number }\n/** `sortable: true` on a column without a default order: sort by a primitive key. */\ntype NeedsSortBy<T> = { sortable: true; sortBy: (row: T) => Primitive }\n\n/** A column bound to a dot-path of `T`; a distributive union over every path. */\nexport type KeyColumn<T, R> = {\n  [P in Path<T>]: { key: P } & RenderReq<T, PathValue<T, P>, R> & SortReq<T, PathValue<T, P>>\n}[Path<T>]\n\n/** A derived column: `accessor` computes the value from the (contextually typed) row. */\nexport type AccessorColumn<T, R> = {\n  id: string\n  accessor: (row: T) => unknown\n  key?: never\n} & BaseColumn<T, unknown, R>\n\n/**\n * One column of a table over rows `T`. `R` is the `cell` render result (`unknown` in core,\n * `ReactNode` in `@datakable/react`). Whole-row `any` is treated as `Record<string, unknown>`.\n */\nexport type ColumnDef<T, R = unknown> = KeyColumn<LooseRow<T>, R> | AccessorColumn<LooseRow<T>, R>\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/column/get-value.cjs

@@ -33,7 +33,12 @@ function getValue(row, path, onError) {
   try {
     for (let i = 0; i < segs.length; i++) {
       if (cur === null || typeof cur !== "object") return void 0;
-      cur = cur[segs[i]];
+      const seg = segs[i];
+      const next = cur[seg];
+      if ((typeof next === "function" || seg === "__proto__") && !Object.hasOwn(cur, seg)) {
+        return void 0;
+      }
+      cur = next;
     }
   } catch (error) {
     onError?.(error);

package/dist/column/get-value.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/column/get-value.ts"],"sourcesContent":["/** A dot-path split into its segments once, for repeated per-cell walks. */\nexport type CompiledPath = readonly string[]\n\n/** Splits a dot-path (`'address.geo.lat'`) into segments. Call once per column, not per cell. */\nexport function compilePath(path: string): CompiledPath {\n  return path.split('.')\n}\n\n/**\n * Reads the value at `path` of `row`, defensively (§4.3): a `null`, `undefined` or non-object\n * (primitive, function) part-way through yields `undefined`. Arrays are walked by index. Never\n * throws: a throwing getter or Proxy trap yields `undefined` and is passed to `onError`.\n *\n * Hot paths should pass a {@link compilePath} result so the walk allocates nothing per cell.\n */\nexport function getValue(\n  row: unknown,\n  path: string | CompiledPath,\n  onError?: (error: unknown) => void,\n): unknown {\n  const segs = typeof path === 'string' ? compilePath(path) : path\n  let cur: unknown = row\n  try {\n    for (let i = 0; i < segs.length; i++) {\n      if (cur === null || typeof cur !== 'object') return undefined\n      cur = (cur as Record<string, unknown>)[segs[i] as string]\n    }\n  } catch (error) {\n    // The column cache (pipeline/column-cache.ts) passes onError and reports DK_CALLBACK_FAILED\n    // once per column batch with the failing row indices (no per-cell emit).\n    onError?.(error)\n    return undefined\n  }\n  return cur\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,SAAS,YAAY,MAA4B;AACtD,SAAO,KAAK,MAAM,GAAG;AACvB;AASO,SAAS,SACd,KACA,MACA,SACS;AACT,QAAM,OAAO,OAAO,SAAS,WAAW,YAAY,IAAI,IAAI;AAC5D,MAAI,MAAe;AACnB,MAAI;AACF,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,YAAO,IAAgC,KAAK,CAAC,CAAW;AAAA,IAC1D;AAAA,EACF,SAAS,OAAO;AAGd,cAAU,KAAK;AACf,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/column/get-value.ts"],"sourcesContent":["/** A dot-path split into its segments once, for repeated per-cell walks. */\nexport type CompiledPath = readonly string[]\n\n/** Splits a dot-path (`'address.geo.lat'`) into segments. Call once per column, not per cell. */\nexport function compilePath(path: string): CompiledPath {\n  return path.split('.')\n}\n\n/**\n * Reads the value at `path` of `row`, defensively (§4.3): a `null`, `undefined` or non-object\n * (primitive, function) part-way through yields `undefined`. Arrays are walked by index. An\n * inherited method or `__proto__` (`constructor`, `toString`, `map`) yields `undefined`. Never\n * throws: a throwing getter or Proxy trap yields `undefined` and is passed to `onError`.\n *\n * Hot paths should pass a {@link compilePath} result so the walk allocates nothing per cell.\n */\nexport function getValue(\n  row: unknown,\n  path: string | CompiledPath,\n  onError?: (error: unknown) => void,\n): unknown {\n  const segs = typeof path === 'string' ? compilePath(path) : path\n  let cur: unknown = row\n  try {\n    for (let i = 0; i < segs.length; i++) {\n      if (cur === null || typeof cur !== 'object') return undefined\n      const seg = segs[i] as string\n      const next = (cur as Record<string, unknown>)[seg]\n      // Inherited methods and `__proto__` (`constructor`, `toString`) are not row data (#42);\n      // checked only for function values, so plain data and class getters cost nothing more.\n      if ((typeof next === 'function' || seg === '__proto__') && !Object.hasOwn(cur, seg)) {\n        return undefined\n      }\n      cur = next\n    }\n  } catch (error) {\n    // The column cache (pipeline/column-cache.ts) passes onError and reports DK_CALLBACK_FAILED\n    // once per column batch with the failing row indices (no per-cell emit).\n    onError?.(error)\n    return undefined\n  }\n  return cur\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,SAAS,YAAY,MAA4B;AACtD,SAAO,KAAK,MAAM,GAAG;AACvB;AAUO,SAAS,SACd,KACA,MACA,SACS;AACT,QAAM,OAAO,OAAO,SAAS,WAAW,YAAY,IAAI,IAAI;AAC5D,MAAI,MAAe;AACnB,MAAI;AACF,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,YAAM,MAAM,KAAK,CAAC;AAClB,YAAM,OAAQ,IAAgC,GAAG;AAGjD,WAAK,OAAO,SAAS,cAAc,QAAQ,gBAAgB,CAAC,OAAO,OAAO,KAAK,GAAG,GAAG;AACnF,eAAO;AAAA,MACT;AACA,YAAM;AAAA,IACR;AAAA,EACF,SAAS,OAAO;AAGd,cAAU,KAAK;AACf,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/column/get-value.js

@@ -8,7 +8,12 @@ function getValue(row, path, onError) {
   try {
     for (let i = 0; i < segs.length; i++) {
       if (cur === null || typeof cur !== "object") return void 0;
-      cur = cur[segs[i]];
+      const seg = segs[i];
+      const next = cur[seg];
+      if ((typeof next === "function" || seg === "__proto__") && !Object.hasOwn(cur, seg)) {
+        return void 0;
+      }
+      cur = next;
     }
   } catch (error) {
     onError?.(error);

package/dist/column/get-value.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/column/get-value.ts"],"sourcesContent":["/** A dot-path split into its segments once, for repeated per-cell walks. */\nexport type CompiledPath = readonly string[]\n\n/** Splits a dot-path (`'address.geo.lat'`) into segments. Call once per column, not per cell. */\nexport function compilePath(path: string): CompiledPath {\n  return path.split('.')\n}\n\n/**\n * Reads the value at `path` of `row`, defensively (§4.3): a `null`, `undefined` or non-object\n * (primitive, function) part-way through yields `undefined`. Arrays are walked by index. Never\n * throws: a throwing getter or Proxy trap yields `undefined` and is passed to `onError`.\n *\n * Hot paths should pass a {@link compilePath} result so the walk allocates nothing per cell.\n */\nexport function getValue(\n  row: unknown,\n  path: string | CompiledPath,\n  onError?: (error: unknown) => void,\n): unknown {\n  const segs = typeof path === 'string' ? compilePath(path) : path\n  let cur: unknown = row\n  try {\n    for (let i = 0; i < segs.length; i++) {\n      if (cur === null || typeof cur !== 'object') return undefined\n      cur = (cur as Record<string, unknown>)[segs[i] as string]\n    }\n  } catch (error) {\n    // The column cache (pipeline/column-cache.ts) passes onError and reports DK_CALLBACK_FAILED\n    // once per column batch with the failing row indices (no per-cell emit).\n    onError?.(error)\n    return undefined\n  }\n  return cur\n}\n"],"mappings":";AAIO,SAAS,YAAY,MAA4B;AACtD,SAAO,KAAK,MAAM,GAAG;AACvB;AASO,SAAS,SACd,KACA,MACA,SACS;AACT,QAAM,OAAO,OAAO,SAAS,WAAW,YAAY,IAAI,IAAI;AAC5D,MAAI,MAAe;AACnB,MAAI;AACF,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,YAAO,IAAgC,KAAK,CAAC,CAAW;AAAA,IAC1D;AAAA,EACF,SAAS,OAAO;AAGd,cAAU,KAAK;AACf,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/column/get-value.ts"],"sourcesContent":["/** A dot-path split into its segments once, for repeated per-cell walks. */\nexport type CompiledPath = readonly string[]\n\n/** Splits a dot-path (`'address.geo.lat'`) into segments. Call once per column, not per cell. */\nexport function compilePath(path: string): CompiledPath {\n  return path.split('.')\n}\n\n/**\n * Reads the value at `path` of `row`, defensively (§4.3): a `null`, `undefined` or non-object\n * (primitive, function) part-way through yields `undefined`. Arrays are walked by index. An\n * inherited method or `__proto__` (`constructor`, `toString`, `map`) yields `undefined`. Never\n * throws: a throwing getter or Proxy trap yields `undefined` and is passed to `onError`.\n *\n * Hot paths should pass a {@link compilePath} result so the walk allocates nothing per cell.\n */\nexport function getValue(\n  row: unknown,\n  path: string | CompiledPath,\n  onError?: (error: unknown) => void,\n): unknown {\n  const segs = typeof path === 'string' ? compilePath(path) : path\n  let cur: unknown = row\n  try {\n    for (let i = 0; i < segs.length; i++) {\n      if (cur === null || typeof cur !== 'object') return undefined\n      const seg = segs[i] as string\n      const next = (cur as Record<string, unknown>)[seg]\n      // Inherited methods and `__proto__` (`constructor`, `toString`) are not row data (#42);\n      // checked only for function values, so plain data and class getters cost nothing more.\n      if ((typeof next === 'function' || seg === '__proto__') && !Object.hasOwn(cur, seg)) {\n        return undefined\n      }\n      cur = next\n    }\n  } catch (error) {\n    // The column cache (pipeline/column-cache.ts) passes onError and reports DK_CALLBACK_FAILED\n    // once per column batch with the failing row indices (no per-cell emit).\n    onError?.(error)\n    return undefined\n  }\n  return cur\n}\n"],"mappings":";AAIO,SAAS,YAAY,MAA4B;AACtD,SAAO,KAAK,MAAM,GAAG;AACvB;AAUO,SAAS,SACd,KACA,MACA,SACS;AACT,QAAM,OAAO,OAAO,SAAS,WAAW,YAAY,IAAI,IAAI;AAC5D,MAAI,MAAe;AACnB,MAAI;AACF,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,YAAM,MAAM,KAAK,CAAC;AAClB,YAAM,OAAQ,IAAgC,GAAG;AAGjD,WAAK,OAAO,SAAS,cAAc,QAAQ,gBAAgB,CAAC,OAAO,OAAO,KAAK,GAAG,GAAG;AACnF,eAAO;AAAA,MACT;AACA,YAAM;AAAA,IACR;AAAA,EACF,SAAS,OAAO;AAGd,cAAU,KAAK;AACf,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/column-filters.d.cts

@@ -1,5 +1,5 @@
-export { U as columnFiltersDiagnostics } from './codes-OsjAR3Wz.cjs';
-import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-vkD2cewE.cjs';
+export { U as columnFiltersDiagnostics } from './codes-B9bCK73-.cjs';
+import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-Q8Cg0cZy.cjs';
 import { a as DataMode } from './mode-DFV8ryXo.cjs';
 
 /** The value a filter compares against: the element type for array-valued cells (§6.1). */

package/dist/column-filters.d.ts

@@ -1,5 +1,5 @@
-export { U as columnFiltersDiagnostics } from './codes-OsjAR3Wz.js';
-import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-Dn99IQt0.js';
+export { U as columnFiltersDiagnostics } from './codes-B9bCK73-.js';
+import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-i0OATi_W.js';
 import { a as DataMode } from './mode-DFV8ryXo.js';
 
 /** The value a filter compares against: the element type for array-valued cells (§6.1). */