@datakable/core 1.0.0 → 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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AA0C1D,IAAM,QAAQ,CAAC,MACb,EAAE,YAAY,SAAY,EAAE,MAAM,UAAU,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAGlG,IAAM,QAAQ,CAAC,MACb,EAAE,YAAY,SAAY,WAAW,EAAE,IAAI,KAAK,GAAG,EAAE,OAAO,MAAM,EAAE,IAAI;AAE1E,IAAM,OAAO,CAAC,SAAiB,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;AAG5D,IAAM,iBAET;AAAA,EACF,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,EAAE,YAAY,SACV,mBAAmB,EAAE,IAAI,MACzB,YAAY,EAAE,OAAO,4BAA4B,EAAE,IAAI;AAAA,IAC7D,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AACV,YAAM,MAAgB,CAAC;AACvB,YAAM,IAAI,EAAE,YAAY,CAAC;AACzB,UAAI,MAAM,OAAW,KAAI,KAAK,iBAAiB,CAAC,cAAc,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG;AACvF,UAAI,EAAE,UAAU,QAAW;AACzB,YAAI;AAAA,UACF,IAAI,EAAE,IAAI,8BAA8B,EAAE,KAAK,8BAC1C,EAAE,KAAK,MAAM,EAAE,IAAI;AAAA,QAC1B;AAAA,MACF;AACA,UAAI;AAAA,QACF,WAAW,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,SAAY,KAAK,GAAG,EAAE,OAAO,GAAG,iBACjE,EAAE,MAAM,KAAK,IAAI,KAAK,QAAQ;AAAA,MACnD;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,YAAY,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,IACpE,QAAQ,CAAC,MACP,EAAE,UAAU,SACR,8BACA;AAAA,IACN,KAAK,CAAC,MAAM;AACV,YAAM,MAAgB,CAAC;AACvB,UAAI,EAAE,SAAS,OAAW,KAAI,KAAK,EAAE,IAAI;AACzC,YAAM,IAAI,EAAE,YAAY,CAAC;AACzB,UAAI,MAAM,OAAW,KAAI,KAAK,QAAQ,CAAC,sCAAsC,MAAM,CAAC,CAAC,EAAE;AACvF,UAAI,KAAK,QAAQ,EAAE,QAAQ,OAAO,MAAM,CAAC,CAAC,mCAAmC;AAC7E,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,SAAS,CAAC,MACR,EAAE,OACE,gBAAgB,EAAE,IAAI,sBAAsB,EAAE,MAAM,KACpD,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,MAAM;AAAA,IAC5C,QAAQ,CAAC,MACP,EAAE,OACE,6EACA;AAAA,IACN,KAAK,CAAC,MACJ,EAAE,OACE;AAAA,MACE,QAAQ,EAAE,IAAI;AAAA,IAEhB,IACA,CAAC,UAAU,MAAM,CAAC,CAAC,qDAAqD,EAAE,MAAM,GAAG;AAAA,EAC3F;AACF;AAGO,IAAM,oBAAoB;AAAA,MAC/B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP;AAAA,IACF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,eAAe;AAAA,EAC5D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,eAAe;AAAA,EAC5D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP;AAAA,IACF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,eAAe;AAAA,EAC5D;AACF;","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-BKdS9EiO.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 {
@@ -353,19 +360,27 @@ interface RowSource {
     /** The issues of a flagged row that touch column `id` (`matchCellIssues`). */
     cellIssues(issues: readonly RowIssue[], id: string): readonly RowIssue[];
 }
+/**
+ * The key a {@link Row} keeps its {@link RowSource} under. A symbol, not a `#private` field: a
+ * proxy-based store (Vue `ref` / `reactive`, Pinia, MobX) calls the getters and methods with
+ * `this` = its proxy, which has no private slot, so `#source` threw there (#11). A symbol key
+ * reads through any proxy, stays out of `Object.keys` and JSON, and is not exported.
+ */
+declare const SOURCE: unique symbol;
 /**
  * One visible row (§6.6). Created only for the rows `getRowModel()` returns, never for the whole
  * data set (§9.1), and only when read ({@link lazyRows}); the methods live on the prototype, so a
  * row costs its four fields.
  */
 declare class Row<T = unknown> {
-    #private;
     /** The row's `rowKey` value (the row index without `rowKey`). */
     readonly key: RowKey;
     /** Position in the ingested data. */
     readonly index: number;
     /** The row object as passed in `data`. */
     readonly original: T;
+    /** @internal */
+    private readonly [SOURCE];
     /** @internal Rows are created by the pipeline. */
     constructor(source: RowSource, index: number, key: RowKey, original: T);
     /** `false` for a row flagged by schema validation (`invalidRows: 'flag'`). */
@@ -405,7 +420,7 @@ interface BuildInput {
     phase?: Phase;
     mode?: Record<string, 'client' | 'server'>;
     state?: DiagnosticStateSummary;
-    /** Timestamp for `occurrences`. Default `Date.now()`. */
+    /** Timestamp for `occurrences` (epoch ms). Default `wallClock()`. */
     now?: number;
     cause?: unknown;
     causedBy?: string;
@@ -680,8 +695,12 @@ declare const featureDiagnostics: (DiagnosticDefinition<"DK_FEATURE_DUPLICATE">
 declare module '@datakable/core' {
     interface DiagnosticCatalog {
         DK_INVALID_PAGINATION: {
-            /** The API method that received the value, or `'state'` for a slice written to the store. */
-            source: 'setPageIndex' | 'setPageSize' | 'state';
+            /**
+             * The API method that received the value, `'state'` for a slice written to the store, or
+             * `'option'` for `pagination({ pageSize })` (checked here in production, where the option
+             * validator is off).
+             */
+            source: 'setPageIndex' | 'setPageSize' | 'state' | 'option';
             field: 'pageIndex' | 'pageSize';
             /** The value's type only (`describeValue`), plus the number itself when it is one. */
             received: string;
@@ -709,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). */
@@ -944,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;
         };
     }
 }
@@ -1043,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;
@@ -1071,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-BKdS9EiO.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 {
@@ -353,19 +360,27 @@ interface RowSource {
     /** The issues of a flagged row that touch column `id` (`matchCellIssues`). */
     cellIssues(issues: readonly RowIssue[], id: string): readonly RowIssue[];
 }
+/**
+ * The key a {@link Row} keeps its {@link RowSource} under. A symbol, not a `#private` field: a
+ * proxy-based store (Vue `ref` / `reactive`, Pinia, MobX) calls the getters and methods with
+ * `this` = its proxy, which has no private slot, so `#source` threw there (#11). A symbol key
+ * reads through any proxy, stays out of `Object.keys` and JSON, and is not exported.
+ */
+declare const SOURCE: unique symbol;
 /**
  * One visible row (§6.6). Created only for the rows `getRowModel()` returns, never for the whole
  * data set (§9.1), and only when read ({@link lazyRows}); the methods live on the prototype, so a
  * row costs its four fields.
  */
 declare class Row<T = unknown> {
-    #private;
     /** The row's `rowKey` value (the row index without `rowKey`). */
     readonly key: RowKey;
     /** Position in the ingested data. */
     readonly index: number;
     /** The row object as passed in `data`. */
     readonly original: T;
+    /** @internal */
+    private readonly [SOURCE];
     /** @internal Rows are created by the pipeline. */
     constructor(source: RowSource, index: number, key: RowKey, original: T);
     /** `false` for a row flagged by schema validation (`invalidRows: 'flag'`). */
@@ -405,7 +420,7 @@ interface BuildInput {
     phase?: Phase;
     mode?: Record<string, 'client' | 'server'>;
     state?: DiagnosticStateSummary;
-    /** Timestamp for `occurrences`. Default `Date.now()`. */
+    /** Timestamp for `occurrences` (epoch ms). Default `wallClock()`. */
     now?: number;
     cause?: unknown;
     causedBy?: string;
@@ -680,8 +695,12 @@ declare const featureDiagnostics: (DiagnosticDefinition<"DK_FEATURE_DUPLICATE">
 declare module '@datakable/core' {
     interface DiagnosticCatalog {
         DK_INVALID_PAGINATION: {
-            /** The API method that received the value, or `'state'` for a slice written to the store. */
-            source: 'setPageIndex' | 'setPageSize' | 'state';
+            /**
+             * The API method that received the value, `'state'` for a slice written to the store, or
+             * `'option'` for `pagination({ pageSize })` (checked here in production, where the option
+             * validator is off).
+             */
+            source: 'setPageIndex' | 'setPageSize' | 'state' | 'option';
             field: 'pageIndex' | 'pageSize';
             /** The value's type only (`describeValue`), plus the number itself when it is one. */
             received: string;
@@ -709,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). */
@@ -944,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;
         };
     }
 }
@@ -1043,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;
@@ -1071,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 {