@datakable/core 1.0.0 → 1.1.0

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-BKdS9EiO.cjs';
-import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-aagaYHcy.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-BKdS9EiO.js';
-import { G as FilterFor, a1 as Path, P as LooseRow, a2 as PathValue, e as FeatureTypes, F as Feature } from './explain-DcUZfFh5.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). */

package/dist/diagnostics/build.cjs

@@ -27,17 +27,21 @@ __export(build_exports, {
   defaultPhase: () => defaultPhase,
   formatWhere: () => formatWhere,
   internalError: () => internalError,
-  throwConfigError: () => throwConfigError
+  throwConfigError: () => throwConfigError,
+  wallClock: () => wallClock
 });
 module.exports = __toCommonJS(build_exports);
 var import_version = require("../version.cjs");
 var import_catalog = require("./catalog.cjs");
 var import_codes = require("./codes.cjs");
+var import_process_guard = require("./process-guard.cjs");
+var import_prose = require("./prose.cjs");
 var import_redact = require("./redact.cjs");
 var import_safe_json = require("./safe-json.cjs");
 var PACKAGE = `@datakable/core@${import_version.VERSION}`;
 var DOCS = "https://github.com/Ink01101011/datakable/blob/main/docs/errors.md";
 var INTERNAL = import_codes.coreDiagnostics.find((d) => d.code === "DK_INTERNAL");
+var wallClock = () => typeof performance === "object" && performance?.timeOrigin ? Math.floor(performance.timeOrigin + performance.now()) : Date.now();
 var defaultPhase = () => typeof document === "undefined" ? "ssr" : "client";
 function formatWhere(where) {
   switch (where.kind) {
@@ -91,11 +95,12 @@ function buildDiagnostic(code, details, input = {}) {
     def = INTERNAL;
     d = {
       op: "diagnostic:emit",
-      problem: `unknown diagnostic code "${code}": define it with defineDiagnostic() first`
+      problem: `unknown-code|${code}`
     };
   }
   const b = def;
   const dev = input.dev ?? process.env.NODE_ENV !== "production";
+  if (dev || (0, import_catalog.hasMessages)()) d = (0, import_prose.expandDetails)(d, dev);
   const r = input.redaction ?? (0, import_redact.resolveRedaction)(void 0, dev);
   const where = (0, import_redact.redactLocation)(b.where(d), r);
   d = (0, import_redact.redactDetails)(
@@ -107,7 +112,7 @@ function buildDiagnostic(code, details, input = {}) {
   const dd = d;
   const t = dev || (0, import_catalog.hasMessages)() ? (0, import_catalog.getDiagnosticText)(def.code) : void 0;
   const whereText = formatWhere(where);
-  const now = input.now ?? Date.now();
+  const now = input.now ?? wallClock();
   const context = {
     table: input.table ?? "(global)",
     package: PACKAGE,
@@ -180,6 +185,7 @@ function internalError(op, problem) {
   defaultPhase,
   formatWhere,
   internalError,
-  throwConfigError
+  throwConfigError,
+  wallClock
 });
 //# sourceMappingURL=build.cjs.map

package/dist/diagnostics/build.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/build.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport {\n  type DiagnosticCode,\n  type DiagnosticDefinition,\n  type DiagnosticDetails,\n  type DiagnosticText,\n  getDiagnosticDefinition,\n  getDiagnosticText,\n  hasMessages,\n} from './catalog'\nimport { coreDiagnostics } from './codes'\nimport {\n  type RedactField,\n  type Redactor,\n  redactDetails,\n  redactLocation,\n  resolveRedaction,\n} from './redact'\nimport { toSafeJson } from './safe-json'\nimport type {\n  Diagnostic,\n  DiagnosticContext,\n  DiagnosticLevel,\n  DiagnosticStateSummary,\n  Location,\n  Phase,\n  Trigger,\n} from './types'\n\nexport const PACKAGE = `@datakable/core@${VERSION}`\nconst DOCS = 'https://github.com/Ink01101011/datakable/blob/main/docs/errors.md'\n\n// Referencing the core entries keeps them in the bundle (`sideEffects: false`).\nconst INTERNAL = coreDiagnostics.find((d) => d.code === 'DK_INTERNAL') as DiagnosticDefinition\n\n/** Everything the enrich step adds; all optional so a diagnostic can be built outside a table. */\nexport interface BuildInput {\n  table?: string\n  createdAt?: string\n  trigger?: Trigger\n  run?: number\n  phase?: Phase\n  mode?: Record<string, 'client' | 'server'>\n  state?: DiagnosticStateSummary\n  /** Timestamp for `occurrences`. Default `Date.now()`. */\n  now?: number\n  cause?: unknown\n  causedBy?: string\n  /** Build the problem / impact / fix text. Default: development builds only (§8.2); production\n   * builds also build it once `@datakable/core/messages` is installed. */\n  dev?: boolean\n  /** Redaction policy (§8.2). Default: `'keys'` when `dev`, else `'safe'`. */\n  redaction?: Redactor\n}\n\nexport const defaultPhase = (): Phase => (typeof document === 'undefined' ? 'ssr' : 'client')\n\nexport function formatWhere(where: Location): string {\n  switch (where.kind) {\n    case 'column':\n      return `columns[${where.index}] (id \"${where.id}\")`\n    case 'feature':\n      return `feature \"${where.name}\"`\n    case 'option':\n      return `options.${where.path}`\n    case 'row':\n      return where.key === undefined\n        ? `row #${where.index}`\n        : `row #${where.index} (key ${where.key})`\n    case 'interceptor':\n      return `interceptor \"${where.name}\" on ${where.op}`\n    case 'operation':\n      return where.slot ? `operation ${where.op} at ${where.slot}` : `operation ${where.op}`\n  }\n}\n\nclass DiagnosticRecord implements Diagnostic {\n  constructor(\n    public code: DiagnosticCode,\n    public level: DiagnosticLevel,\n    public problem: string,\n    public where: Location,\n    public impact: string,\n    public fix: string[],\n    public docs: string,\n    public details: Record<string, unknown>,\n    public context: DiagnosticContext,\n    public fingerprint: string,\n  ) {}\n\n  toJSON(): object {\n    const { cause: _cause, ...context } = this.context\n    return {\n      code: this.code,\n      level: this.level,\n      problem: this.problem,\n      where: toSafeJson(this.where),\n      impact: this.impact,\n      fix: this.fix,\n      docs: this.docs,\n      details: toSafeJson(this.details),\n      context: toSafeJson(context),\n      fingerprint: this.fingerprint,\n    }\n  }\n}\n\n/**\n * Builds a diagnostic from a catalog code + details (the `enrich` step). Never throws for an unknown\n * code: that becomes `DK_INTERNAL`, so a typo in a plugin cannot take the logger down.\n */\nexport function buildDiagnostic<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input: BuildInput = {},\n): Diagnostic {\n  let def = getDiagnosticDefinition(code)\n  let d = details as Record<string, unknown>\n  if (!def) {\n    def = INTERNAL\n    d = {\n      op: 'diagnostic:emit',\n      problem: `unknown diagnostic code \"${code}\": define it with defineDiagnostic() first`,\n    }\n  }\n  const b = def as unknown as DiagnosticDefinition<'DK_INTERNAL'>\n  const dev = input.dev ?? (process.env.NODE_ENV !== \"production\")\n  // Redact first: `where`, the text builders, the fingerprint and the docs URL only ever see\n  // redacted data, so no consumer downstream (interceptors, sinks, strict errors) can leak it.\n  const r = input.redaction ?? resolveRedaction(undefined, dev)\n  const where = redactLocation(b.where(d as DiagnosticDetails<'DK_INTERNAL'>), r)\n  d = redactDetails(\n    d,\n    def.redact as Readonly<Record<string, RedactField | undefined>> | undefined,\n    where,\n    r,\n  )\n  const dd = d as DiagnosticDetails<'DK_INTERNAL'>\n  // Text: development builds, or production with `@datakable/core/messages` installed (§8.2).\n  const t =\n    dev || hasMessages()\n      ? (getDiagnosticText(def.code) as DiagnosticText<'DK_INTERNAL'> | undefined)\n      : undefined\n  const whereText = formatWhere(where)\n  const now = input.now ?? Date.now()\n  const context: DiagnosticContext = {\n    table: input.table ?? '(global)',\n    package: PACKAGE,\n    trigger: input.trigger ?? 'init',\n    run: input.run ?? 0,\n    phase: input.phase ?? defaultPhase(),\n    mode: input.mode ?? {},\n    state: input.state ?? { searchLength: 0, activeFilters: [], sort: [], page: 0 },\n    occurrences: { count: 1, first: now, last: now },\n  }\n  if (input.createdAt !== undefined) context.createdAt = input.createdAt\n  if (input.causedBy !== undefined) context.causedBy = input.causedBy\n  if (input.cause !== undefined) context.cause = input.cause\n  let docs = def.docs ?? `${DOCS}#${def.code.toLowerCase()}`\n  if (!dev) {\n    const hash = docs.indexOf('#')\n    const params = `?v=${VERSION}&where=${encodeURIComponent(whereText)}`\n    docs = hash < 0 ? docs + params : docs.slice(0, hash) + params + docs.slice(hash)\n  }\n  return new DiagnosticRecord(\n    def.code,\n    def.level,\n    t ? t.problem(dd) : '',\n    where,\n    t ? t.impact(dd) : '',\n    t ? t.fix(dd) : [],\n    docs,\n    d,\n    context,\n    `${def.code}@${whereText}`,\n  )\n}\n\n/** Thrown under `strict: true` for error-level diagnostics, and for core invariants (§8.2). */\nexport class DatakableError extends Error {\n  override name = 'DatakableError'\n  readonly code: DiagnosticCode\n  readonly level: DiagnosticLevel\n  readonly problem: string\n  readonly where: Location\n  readonly impact: string\n  readonly fix: string[]\n  readonly docs: string\n  readonly diagnostic: Diagnostic\n\n  constructor(d: Diagnostic) {\n    const lines = [`${d.code}: ${d.problem || '(see docs)'}`, `  where   ${formatWhere(d.where)}`]\n    d.fix.forEach((f, i) => {\n      lines.push(`${i === 0 ? '  fix     ' : '          '}${i + 1}. ${f}`)\n    })\n    lines.push(`  docs    ${d.docs}`)\n    super(lines.join('\\n'), d.context.cause === undefined ? undefined : { cause: d.context.cause })\n    this.code = d.code\n    this.level = d.level\n    this.problem = d.problem\n    this.where = d.where\n    this.impact = d.impact\n    this.fix = d.fix\n    this.docs = d.docs\n    this.diagnostic = d\n  }\n}\n\n/** Deterministic programmer errors thrown at creation (`error (config)` codes, §8.6). */\nexport class DatakableConfigError extends DatakableError {\n  override name = 'DatakableConfigError'\n}\n\nexport function throwConfigError<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input?: BuildInput,\n): never {\n  throw new DatakableConfigError(buildDiagnostic(code, details, input))\n}\n\n/** A core invariant broke (unregistered op, boundary installed twice): `DK_INTERNAL`. */\nexport function internalError(op: string, problem: string): DatakableError {\n  return new DatakableError(buildDiagnostic('DK_INTERNAL', { op, problem }))\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/diagnostics/build.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport {\n  type DiagnosticCode,\n  type DiagnosticDefinition,\n  type DiagnosticDetails,\n  type DiagnosticText,\n  getDiagnosticDefinition,\n  getDiagnosticText,\n  hasMessages,\n} from './catalog'\nimport { coreDiagnostics } from './codes'\nimport './process-guard'\nimport { expandDetails } from './prose'\nimport {\n  type RedactField,\n  type Redactor,\n  redactDetails,\n  redactLocation,\n  resolveRedaction,\n} from './redact'\nimport { toSafeJson } from './safe-json'\nimport type {\n  Diagnostic,\n  DiagnosticContext,\n  DiagnosticLevel,\n  DiagnosticStateSummary,\n  Location,\n  Phase,\n  Trigger,\n} from './types'\n\nexport const PACKAGE = `@datakable/core@${VERSION}`\nconst DOCS = 'https://github.com/Ink01101011/datakable/blob/main/docs/errors.md'\n\n// Referencing the core entries keeps them in the bundle (`sideEffects: false`).\nconst INTERNAL = coreDiagnostics.find((d) => d.code === 'DK_INTERNAL') as DiagnosticDefinition\n\n/** Everything the enrich step adds; all optional so a diagnostic can be built outside a table. */\nexport interface BuildInput {\n  table?: string\n  createdAt?: string\n  trigger?: Trigger\n  run?: number\n  phase?: Phase\n  mode?: Record<string, 'client' | 'server'>\n  state?: DiagnosticStateSummary\n  /** Timestamp for `occurrences` (epoch ms). Default `wallClock()`. */\n  now?: number\n  cause?: unknown\n  causedBy?: string\n  /** Build the problem / impact / fix text. Default: development builds only (§8.2); production\n   * builds also build it once `@datakable/core/messages` is installed. */\n  dev?: boolean\n  /** Redaction policy (§8.2). Default: `'keys'` when `dev`, else `'safe'`. */\n  redaction?: Redactor\n}\n\n/**\n * Epoch ms read through `performance`, never `Date` (#7): Next 16 `cacheComponents` aborts a\n * prerender that reads `Date.now()` and reserves `performance` for introspection like this.\n */\nexport const wallClock = (): number =>\n  typeof performance === 'object' && performance?.timeOrigin\n    ? Math.floor(performance.timeOrigin + performance.now())\n    : Date.now()\n\nexport const defaultPhase = (): Phase => (typeof document === 'undefined' ? 'ssr' : 'client')\n\nexport function formatWhere(where: Location): string {\n  switch (where.kind) {\n    case 'column':\n      return `columns[${where.index}] (id \"${where.id}\")`\n    case 'feature':\n      return `feature \"${where.name}\"`\n    case 'option':\n      return `options.${where.path}`\n    case 'row':\n      return where.key === undefined\n        ? `row #${where.index}`\n        : `row #${where.index} (key ${where.key})`\n    case 'interceptor':\n      return `interceptor \"${where.name}\" on ${where.op}`\n    case 'operation':\n      return where.slot ? `operation ${where.op} at ${where.slot}` : `operation ${where.op}`\n  }\n}\n\nclass DiagnosticRecord implements Diagnostic {\n  constructor(\n    public code: DiagnosticCode,\n    public level: DiagnosticLevel,\n    public problem: string,\n    public where: Location,\n    public impact: string,\n    public fix: string[],\n    public docs: string,\n    public details: Record<string, unknown>,\n    public context: DiagnosticContext,\n    public fingerprint: string,\n  ) {}\n\n  toJSON(): object {\n    const { cause: _cause, ...context } = this.context\n    return {\n      code: this.code,\n      level: this.level,\n      problem: this.problem,\n      where: toSafeJson(this.where),\n      impact: this.impact,\n      fix: this.fix,\n      docs: this.docs,\n      details: toSafeJson(this.details),\n      context: toSafeJson(context),\n      fingerprint: this.fingerprint,\n    }\n  }\n}\n\n/**\n * Builds a diagnostic from a catalog code + details (the `enrich` step). Never throws for an unknown\n * code: that becomes `DK_INTERNAL`, so a typo in a plugin cannot take the logger down.\n */\nexport function buildDiagnostic<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input: BuildInput = {},\n): Diagnostic {\n  let def = getDiagnosticDefinition(code)\n  let d = details as Record<string, unknown>\n  if (!def) {\n    def = INTERNAL\n    d = {\n      op: 'diagnostic:emit',\n      problem: `unknown-code|${code}`,\n    }\n  }\n  const b = def as unknown as DiagnosticDefinition<'DK_INTERNAL'>\n  const dev = input.dev ?? (process.env.NODE_ENV !== \"production\")\n  // Detail prose keys (`fallback: 'cells-undefined'`) read as sentences wherever text is built.\n  if (dev || hasMessages()) d = expandDetails(d, dev)\n  // Redact first: `where`, the text builders, the fingerprint and the docs URL only ever see\n  // redacted data, so no consumer downstream (interceptors, sinks, strict errors) can leak it.\n  const r = input.redaction ?? resolveRedaction(undefined, dev)\n  const where = redactLocation(b.where(d as DiagnosticDetails<'DK_INTERNAL'>), r)\n  d = redactDetails(\n    d,\n    def.redact as Readonly<Record<string, RedactField | undefined>> | undefined,\n    where,\n    r,\n  )\n  const dd = d as DiagnosticDetails<'DK_INTERNAL'>\n  // Text: development builds, or production with `@datakable/core/messages` installed (§8.2).\n  const t =\n    dev || hasMessages()\n      ? (getDiagnosticText(def.code) as DiagnosticText<'DK_INTERNAL'> | undefined)\n      : undefined\n  const whereText = formatWhere(where)\n  const now = input.now ?? wallClock()\n  const context: DiagnosticContext = {\n    table: input.table ?? '(global)',\n    package: PACKAGE,\n    trigger: input.trigger ?? 'init',\n    run: input.run ?? 0,\n    phase: input.phase ?? defaultPhase(),\n    mode: input.mode ?? {},\n    state: input.state ?? { searchLength: 0, activeFilters: [], sort: [], page: 0 },\n    occurrences: { count: 1, first: now, last: now },\n  }\n  if (input.createdAt !== undefined) context.createdAt = input.createdAt\n  if (input.causedBy !== undefined) context.causedBy = input.causedBy\n  if (input.cause !== undefined) context.cause = input.cause\n  let docs = def.docs ?? `${DOCS}#${def.code.toLowerCase()}`\n  if (!dev) {\n    const hash = docs.indexOf('#')\n    const params = `?v=${VERSION}&where=${encodeURIComponent(whereText)}`\n    docs = hash < 0 ? docs + params : docs.slice(0, hash) + params + docs.slice(hash)\n  }\n  return new DiagnosticRecord(\n    def.code,\n    def.level,\n    t ? t.problem(dd) : '',\n    where,\n    t ? t.impact(dd) : '',\n    t ? t.fix(dd) : [],\n    docs,\n    d,\n    context,\n    `${def.code}@${whereText}`,\n  )\n}\n\n/** Thrown under `strict: true` for error-level diagnostics, and for core invariants (§8.2). */\nexport class DatakableError extends Error {\n  override name = 'DatakableError'\n  readonly code: DiagnosticCode\n  readonly level: DiagnosticLevel\n  readonly problem: string\n  readonly where: Location\n  readonly impact: string\n  readonly fix: string[]\n  readonly docs: string\n  readonly diagnostic: Diagnostic\n\n  constructor(d: Diagnostic) {\n    const lines = [`${d.code}: ${d.problem || '(see docs)'}`, `  where   ${formatWhere(d.where)}`]\n    d.fix.forEach((f, i) => {\n      lines.push(`${i === 0 ? '  fix     ' : '          '}${i + 1}. ${f}`)\n    })\n    lines.push(`  docs    ${d.docs}`)\n    super(lines.join('\\n'), d.context.cause === undefined ? undefined : { cause: d.context.cause })\n    this.code = d.code\n    this.level = d.level\n    this.problem = d.problem\n    this.where = d.where\n    this.impact = d.impact\n    this.fix = d.fix\n    this.docs = d.docs\n    this.diagnostic = d\n  }\n}\n\n/** Deterministic programmer errors thrown at creation (`error (config)` codes, §8.6). */\nexport class DatakableConfigError extends DatakableError {\n  override name = 'DatakableConfigError'\n}\n\nexport function throwConfigError<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input?: BuildInput,\n): never {\n  throw new DatakableConfigError(buildDiagnostic(code, details, input))\n}\n\n/** A core invariant broke (unregistered op, boundary installed twice): `DK_INTERNAL`. */\nexport function internalError(op: string, problem: string): DatakableError {\n  return new DatakableError(buildDiagnostic('DK_INTERNAL', { op, problem }))\n}\n"],"mappings":"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","names":[]}

package/dist/diagnostics/build.js

@@ -6,6 +6,8 @@ import {
   hasMessages
 } from "./catalog.js";
 import { coreDiagnostics } from "./codes.js";
+import "./process-guard.js";
+import { expandDetails } from "./prose.js";
 import {
   redactDetails,
   redactLocation,
@@ -15,6 +17,7 @@ import { toSafeJson } from "./safe-json.js";
 var PACKAGE = `@datakable/core@${VERSION}`;
 var DOCS = "https://github.com/Ink01101011/datakable/blob/main/docs/errors.md";
 var INTERNAL = coreDiagnostics.find((d) => d.code === "DK_INTERNAL");
+var wallClock = () => typeof performance === "object" && performance?.timeOrigin ? Math.floor(performance.timeOrigin + performance.now()) : Date.now();
 var defaultPhase = () => typeof document === "undefined" ? "ssr" : "client";
 function formatWhere(where) {
   switch (where.kind) {
@@ -68,11 +71,12 @@ function buildDiagnostic(code, details, input = {}) {
     def = INTERNAL;
     d = {
       op: "diagnostic:emit",
-      problem: `unknown diagnostic code "${code}": define it with defineDiagnostic() first`
+      problem: `unknown-code|${code}`
     };
   }
   const b = def;
   const dev = input.dev ?? process.env.NODE_ENV !== "production";
+  if (dev || hasMessages()) d = expandDetails(d, dev);
   const r = input.redaction ?? resolveRedaction(void 0, dev);
   const where = redactLocation(b.where(d), r);
   d = redactDetails(
@@ -84,7 +88,7 @@ function buildDiagnostic(code, details, input = {}) {
   const dd = d;
   const t = dev || hasMessages() ? getDiagnosticText(def.code) : void 0;
   const whereText = formatWhere(where);
-  const now = input.now ?? Date.now();
+  const now = input.now ?? wallClock();
   const context = {
     table: input.table ?? "(global)",
     package: PACKAGE,
@@ -156,6 +160,7 @@ export {
   defaultPhase,
   formatWhere,
   internalError,
-  throwConfigError
+  throwConfigError,
+  wallClock
 };
 //# sourceMappingURL=build.js.map

package/dist/diagnostics/build.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/build.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport {\n  type DiagnosticCode,\n  type DiagnosticDefinition,\n  type DiagnosticDetails,\n  type DiagnosticText,\n  getDiagnosticDefinition,\n  getDiagnosticText,\n  hasMessages,\n} from './catalog'\nimport { coreDiagnostics } from './codes'\nimport {\n  type RedactField,\n  type Redactor,\n  redactDetails,\n  redactLocation,\n  resolveRedaction,\n} from './redact'\nimport { toSafeJson } from './safe-json'\nimport type {\n  Diagnostic,\n  DiagnosticContext,\n  DiagnosticLevel,\n  DiagnosticStateSummary,\n  Location,\n  Phase,\n  Trigger,\n} from './types'\n\nexport const PACKAGE = `@datakable/core@${VERSION}`\nconst DOCS = 'https://github.com/Ink01101011/datakable/blob/main/docs/errors.md'\n\n// Referencing the core entries keeps them in the bundle (`sideEffects: false`).\nconst INTERNAL = coreDiagnostics.find((d) => d.code === 'DK_INTERNAL') as DiagnosticDefinition\n\n/** Everything the enrich step adds; all optional so a diagnostic can be built outside a table. */\nexport interface BuildInput {\n  table?: string\n  createdAt?: string\n  trigger?: Trigger\n  run?: number\n  phase?: Phase\n  mode?: Record<string, 'client' | 'server'>\n  state?: DiagnosticStateSummary\n  /** Timestamp for `occurrences`. Default `Date.now()`. */\n  now?: number\n  cause?: unknown\n  causedBy?: string\n  /** Build the problem / impact / fix text. Default: development builds only (§8.2); production\n   * builds also build it once `@datakable/core/messages` is installed. */\n  dev?: boolean\n  /** Redaction policy (§8.2). Default: `'keys'` when `dev`, else `'safe'`. */\n  redaction?: Redactor\n}\n\nexport const defaultPhase = (): Phase => (typeof document === 'undefined' ? 'ssr' : 'client')\n\nexport function formatWhere(where: Location): string {\n  switch (where.kind) {\n    case 'column':\n      return `columns[${where.index}] (id \"${where.id}\")`\n    case 'feature':\n      return `feature \"${where.name}\"`\n    case 'option':\n      return `options.${where.path}`\n    case 'row':\n      return where.key === undefined\n        ? `row #${where.index}`\n        : `row #${where.index} (key ${where.key})`\n    case 'interceptor':\n      return `interceptor \"${where.name}\" on ${where.op}`\n    case 'operation':\n      return where.slot ? `operation ${where.op} at ${where.slot}` : `operation ${where.op}`\n  }\n}\n\nclass DiagnosticRecord implements Diagnostic {\n  constructor(\n    public code: DiagnosticCode,\n    public level: DiagnosticLevel,\n    public problem: string,\n    public where: Location,\n    public impact: string,\n    public fix: string[],\n    public docs: string,\n    public details: Record<string, unknown>,\n    public context: DiagnosticContext,\n    public fingerprint: string,\n  ) {}\n\n  toJSON(): object {\n    const { cause: _cause, ...context } = this.context\n    return {\n      code: this.code,\n      level: this.level,\n      problem: this.problem,\n      where: toSafeJson(this.where),\n      impact: this.impact,\n      fix: this.fix,\n      docs: this.docs,\n      details: toSafeJson(this.details),\n      context: toSafeJson(context),\n      fingerprint: this.fingerprint,\n    }\n  }\n}\n\n/**\n * Builds a diagnostic from a catalog code + details (the `enrich` step). Never throws for an unknown\n * code: that becomes `DK_INTERNAL`, so a typo in a plugin cannot take the logger down.\n */\nexport function buildDiagnostic<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input: BuildInput = {},\n): Diagnostic {\n  let def = getDiagnosticDefinition(code)\n  let d = details as Record<string, unknown>\n  if (!def) {\n    def = INTERNAL\n    d = {\n      op: 'diagnostic:emit',\n      problem: `unknown diagnostic code \"${code}\": define it with defineDiagnostic() first`,\n    }\n  }\n  const b = def as unknown as DiagnosticDefinition<'DK_INTERNAL'>\n  const dev = input.dev ?? (process.env.NODE_ENV !== \"production\")\n  // Redact first: `where`, the text builders, the fingerprint and the docs URL only ever see\n  // redacted data, so no consumer downstream (interceptors, sinks, strict errors) can leak it.\n  const r = input.redaction ?? resolveRedaction(undefined, dev)\n  const where = redactLocation(b.where(d as DiagnosticDetails<'DK_INTERNAL'>), r)\n  d = redactDetails(\n    d,\n    def.redact as Readonly<Record<string, RedactField | undefined>> | undefined,\n    where,\n    r,\n  )\n  const dd = d as DiagnosticDetails<'DK_INTERNAL'>\n  // Text: development builds, or production with `@datakable/core/messages` installed (§8.2).\n  const t =\n    dev || hasMessages()\n      ? (getDiagnosticText(def.code) as DiagnosticText<'DK_INTERNAL'> | undefined)\n      : undefined\n  const whereText = formatWhere(where)\n  const now = input.now ?? Date.now()\n  const context: DiagnosticContext = {\n    table: input.table ?? '(global)',\n    package: PACKAGE,\n    trigger: input.trigger ?? 'init',\n    run: input.run ?? 0,\n    phase: input.phase ?? defaultPhase(),\n    mode: input.mode ?? {},\n    state: input.state ?? { searchLength: 0, activeFilters: [], sort: [], page: 0 },\n    occurrences: { count: 1, first: now, last: now },\n  }\n  if (input.createdAt !== undefined) context.createdAt = input.createdAt\n  if (input.causedBy !== undefined) context.causedBy = input.causedBy\n  if (input.cause !== undefined) context.cause = input.cause\n  let docs = def.docs ?? `${DOCS}#${def.code.toLowerCase()}`\n  if (!dev) {\n    const hash = docs.indexOf('#')\n    const params = `?v=${VERSION}&where=${encodeURIComponent(whereText)}`\n    docs = hash < 0 ? docs + params : docs.slice(0, hash) + params + docs.slice(hash)\n  }\n  return new DiagnosticRecord(\n    def.code,\n    def.level,\n    t ? t.problem(dd) : '',\n    where,\n    t ? t.impact(dd) : '',\n    t ? t.fix(dd) : [],\n    docs,\n    d,\n    context,\n    `${def.code}@${whereText}`,\n  )\n}\n\n/** Thrown under `strict: true` for error-level diagnostics, and for core invariants (§8.2). */\nexport class DatakableError extends Error {\n  override name = 'DatakableError'\n  readonly code: DiagnosticCode\n  readonly level: DiagnosticLevel\n  readonly problem: string\n  readonly where: Location\n  readonly impact: string\n  readonly fix: string[]\n  readonly docs: string\n  readonly diagnostic: Diagnostic\n\n  constructor(d: Diagnostic) {\n    const lines = [`${d.code}: ${d.problem || '(see docs)'}`, `  where   ${formatWhere(d.where)}`]\n    d.fix.forEach((f, i) => {\n      lines.push(`${i === 0 ? '  fix     ' : '          '}${i + 1}. ${f}`)\n    })\n    lines.push(`  docs    ${d.docs}`)\n    super(lines.join('\\n'), d.context.cause === undefined ? undefined : { cause: d.context.cause })\n    this.code = d.code\n    this.level = d.level\n    this.problem = d.problem\n    this.where = d.where\n    this.impact = d.impact\n    this.fix = d.fix\n    this.docs = d.docs\n    this.diagnostic = d\n  }\n}\n\n/** Deterministic programmer errors thrown at creation (`error (config)` codes, §8.6). */\nexport class DatakableConfigError extends DatakableError {\n  override name = 'DatakableConfigError'\n}\n\nexport function throwConfigError<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input?: BuildInput,\n): never {\n  throw new DatakableConfigError(buildDiagnostic(code, details, input))\n}\n\n/** A core invariant broke (unregistered op, boundary installed twice): `DK_INTERNAL`. */\nexport function internalError(op: string, problem: string): DatakableError {\n  return new DatakableError(buildDiagnostic('DK_INTERNAL', { op, problem }))\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/diagnostics/build.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport {\n  type DiagnosticCode,\n  type DiagnosticDefinition,\n  type DiagnosticDetails,\n  type DiagnosticText,\n  getDiagnosticDefinition,\n  getDiagnosticText,\n  hasMessages,\n} from './catalog'\nimport { coreDiagnostics } from './codes'\nimport './process-guard'\nimport { expandDetails } from './prose'\nimport {\n  type RedactField,\n  type Redactor,\n  redactDetails,\n  redactLocation,\n  resolveRedaction,\n} from './redact'\nimport { toSafeJson } from './safe-json'\nimport type {\n  Diagnostic,\n  DiagnosticContext,\n  DiagnosticLevel,\n  DiagnosticStateSummary,\n  Location,\n  Phase,\n  Trigger,\n} from './types'\n\nexport const PACKAGE = `@datakable/core@${VERSION}`\nconst DOCS = 'https://github.com/Ink01101011/datakable/blob/main/docs/errors.md'\n\n// Referencing the core entries keeps them in the bundle (`sideEffects: false`).\nconst INTERNAL = coreDiagnostics.find((d) => d.code === 'DK_INTERNAL') as DiagnosticDefinition\n\n/** Everything the enrich step adds; all optional so a diagnostic can be built outside a table. */\nexport interface BuildInput {\n  table?: string\n  createdAt?: string\n  trigger?: Trigger\n  run?: number\n  phase?: Phase\n  mode?: Record<string, 'client' | 'server'>\n  state?: DiagnosticStateSummary\n  /** Timestamp for `occurrences` (epoch ms). Default `wallClock()`. */\n  now?: number\n  cause?: unknown\n  causedBy?: string\n  /** Build the problem / impact / fix text. Default: development builds only (§8.2); production\n   * builds also build it once `@datakable/core/messages` is installed. */\n  dev?: boolean\n  /** Redaction policy (§8.2). Default: `'keys'` when `dev`, else `'safe'`. */\n  redaction?: Redactor\n}\n\n/**\n * Epoch ms read through `performance`, never `Date` (#7): Next 16 `cacheComponents` aborts a\n * prerender that reads `Date.now()` and reserves `performance` for introspection like this.\n */\nexport const wallClock = (): number =>\n  typeof performance === 'object' && performance?.timeOrigin\n    ? Math.floor(performance.timeOrigin + performance.now())\n    : Date.now()\n\nexport const defaultPhase = (): Phase => (typeof document === 'undefined' ? 'ssr' : 'client')\n\nexport function formatWhere(where: Location): string {\n  switch (where.kind) {\n    case 'column':\n      return `columns[${where.index}] (id \"${where.id}\")`\n    case 'feature':\n      return `feature \"${where.name}\"`\n    case 'option':\n      return `options.${where.path}`\n    case 'row':\n      return where.key === undefined\n        ? `row #${where.index}`\n        : `row #${where.index} (key ${where.key})`\n    case 'interceptor':\n      return `interceptor \"${where.name}\" on ${where.op}`\n    case 'operation':\n      return where.slot ? `operation ${where.op} at ${where.slot}` : `operation ${where.op}`\n  }\n}\n\nclass DiagnosticRecord implements Diagnostic {\n  constructor(\n    public code: DiagnosticCode,\n    public level: DiagnosticLevel,\n    public problem: string,\n    public where: Location,\n    public impact: string,\n    public fix: string[],\n    public docs: string,\n    public details: Record<string, unknown>,\n    public context: DiagnosticContext,\n    public fingerprint: string,\n  ) {}\n\n  toJSON(): object {\n    const { cause: _cause, ...context } = this.context\n    return {\n      code: this.code,\n      level: this.level,\n      problem: this.problem,\n      where: toSafeJson(this.where),\n      impact: this.impact,\n      fix: this.fix,\n      docs: this.docs,\n      details: toSafeJson(this.details),\n      context: toSafeJson(context),\n      fingerprint: this.fingerprint,\n    }\n  }\n}\n\n/**\n * Builds a diagnostic from a catalog code + details (the `enrich` step). Never throws for an unknown\n * code: that becomes `DK_INTERNAL`, so a typo in a plugin cannot take the logger down.\n */\nexport function buildDiagnostic<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input: BuildInput = {},\n): Diagnostic {\n  let def = getDiagnosticDefinition(code)\n  let d = details as Record<string, unknown>\n  if (!def) {\n    def = INTERNAL\n    d = {\n      op: 'diagnostic:emit',\n      problem: `unknown-code|${code}`,\n    }\n  }\n  const b = def as unknown as DiagnosticDefinition<'DK_INTERNAL'>\n  const dev = input.dev ?? (process.env.NODE_ENV !== \"production\")\n  // Detail prose keys (`fallback: 'cells-undefined'`) read as sentences wherever text is built.\n  if (dev || hasMessages()) d = expandDetails(d, dev)\n  // Redact first: `where`, the text builders, the fingerprint and the docs URL only ever see\n  // redacted data, so no consumer downstream (interceptors, sinks, strict errors) can leak it.\n  const r = input.redaction ?? resolveRedaction(undefined, dev)\n  const where = redactLocation(b.where(d as DiagnosticDetails<'DK_INTERNAL'>), r)\n  d = redactDetails(\n    d,\n    def.redact as Readonly<Record<string, RedactField | undefined>> | undefined,\n    where,\n    r,\n  )\n  const dd = d as DiagnosticDetails<'DK_INTERNAL'>\n  // Text: development builds, or production with `@datakable/core/messages` installed (§8.2).\n  const t =\n    dev || hasMessages()\n      ? (getDiagnosticText(def.code) as DiagnosticText<'DK_INTERNAL'> | undefined)\n      : undefined\n  const whereText = formatWhere(where)\n  const now = input.now ?? wallClock()\n  const context: DiagnosticContext = {\n    table: input.table ?? '(global)',\n    package: PACKAGE,\n    trigger: input.trigger ?? 'init',\n    run: input.run ?? 0,\n    phase: input.phase ?? defaultPhase(),\n    mode: input.mode ?? {},\n    state: input.state ?? { searchLength: 0, activeFilters: [], sort: [], page: 0 },\n    occurrences: { count: 1, first: now, last: now },\n  }\n  if (input.createdAt !== undefined) context.createdAt = input.createdAt\n  if (input.causedBy !== undefined) context.causedBy = input.causedBy\n  if (input.cause !== undefined) context.cause = input.cause\n  let docs = def.docs ?? `${DOCS}#${def.code.toLowerCase()}`\n  if (!dev) {\n    const hash = docs.indexOf('#')\n    const params = `?v=${VERSION}&where=${encodeURIComponent(whereText)}`\n    docs = hash < 0 ? docs + params : docs.slice(0, hash) + params + docs.slice(hash)\n  }\n  return new DiagnosticRecord(\n    def.code,\n    def.level,\n    t ? t.problem(dd) : '',\n    where,\n    t ? t.impact(dd) : '',\n    t ? t.fix(dd) : [],\n    docs,\n    d,\n    context,\n    `${def.code}@${whereText}`,\n  )\n}\n\n/** Thrown under `strict: true` for error-level diagnostics, and for core invariants (§8.2). */\nexport class DatakableError extends Error {\n  override name = 'DatakableError'\n  readonly code: DiagnosticCode\n  readonly level: DiagnosticLevel\n  readonly problem: string\n  readonly where: Location\n  readonly impact: string\n  readonly fix: string[]\n  readonly docs: string\n  readonly diagnostic: Diagnostic\n\n  constructor(d: Diagnostic) {\n    const lines = [`${d.code}: ${d.problem || '(see docs)'}`, `  where   ${formatWhere(d.where)}`]\n    d.fix.forEach((f, i) => {\n      lines.push(`${i === 0 ? '  fix     ' : '          '}${i + 1}. ${f}`)\n    })\n    lines.push(`  docs    ${d.docs}`)\n    super(lines.join('\\n'), d.context.cause === undefined ? undefined : { cause: d.context.cause })\n    this.code = d.code\n    this.level = d.level\n    this.problem = d.problem\n    this.where = d.where\n    this.impact = d.impact\n    this.fix = d.fix\n    this.docs = d.docs\n    this.diagnostic = d\n  }\n}\n\n/** Deterministic programmer errors thrown at creation (`error (config)` codes, §8.6). */\nexport class DatakableConfigError extends DatakableError {\n  override name = 'DatakableConfigError'\n}\n\nexport function throwConfigError<C extends DiagnosticCode>(\n  code: C,\n  details: DiagnosticDetails<C>,\n  input?: BuildInput,\n): never {\n  throw new DatakableConfigError(buildDiagnostic(code, details, input))\n}\n\n/** A core invariant broke (unregistered op, boundary installed twice): `DK_INTERNAL`. */\nexport function internalError(op: string, problem: string): DatakableError {\n  return new DatakableError(buildDiagnostic('DK_INTERNAL', { op, problem }))\n}\n"],"mappings":"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","names":[]}

package/dist/diagnostics/catalog.cjs

@@ -25,18 +25,22 @@ __export(catalog_exports, {
   getDiagnosticText: () => getDiagnosticText,
   hasMessages: () => hasMessages,
   installMessages: () => installMessages,
+  installedText: () => installedText,
   keepDiagnostics: () => keepDiagnostics,
   listDiagnosticCodes: () => listDiagnosticCodes
 });
 module.exports = __toCommonJS(catalog_exports);
+var import_process_guard = require("./process-guard.cjs");
 var registry = /* @__PURE__ */ new Map();
 function defineDiagnostic(meta, text) {
   const definition = text ? { ...meta, ...text } : meta;
-  const prev = registry.get(definition.code);
-  if (process.env.NODE_ENV !== "production" && prev && prev.level !== definition.level) {
-    throw new Error(
-      `[DataKable] diagnostic code ${definition.code} is already defined as level "${prev.level}"; codes are never redefined \u2014 pick a new code`
-    );
+  if (process.env.NODE_ENV !== "production") {
+    const prev = registry.get(definition.code);
+    if (prev && prev.level !== definition.level) {
+      throw new Error(
+        `[DataKable] diagnostic code ${definition.code} is already defined as level "${prev.level}"; codes are never redefined \u2014 pick a new code`
+      );
+    }
   }
   registry.set(definition.code, definition);
   return definition;
@@ -47,6 +51,7 @@ function installMessages(...all) {
     for (const code of Object.keys(m)) messages.set(code, m[code]);
   }
 }
+var installedText = (key) => messages.get(key);
 var hasMessages = () => messages.size > 0;
 function getDiagnosticText(code) {
   const def = registry.get(code);
@@ -70,6 +75,7 @@ function listDiagnosticCodes() {
   getDiagnosticText,
   hasMessages,
   installMessages,
+  installedText,
   keepDiagnostics,
   listDiagnosticCodes
 });

package/dist/diagnostics/catalog.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/catalog.ts"],"sourcesContent":["import type { RedactField } from './redact'\nimport type { DiagnosticLevel, Location } from './types'\n\n/**\n * Code → details type, one entry per diagnostic code. Open for declaration merging, like\n * `Operations`: the module that owns a code declares its details next to its `defineDiagnostic`\n * (`declare module '@datakable/core' { interface DiagnosticCatalog { DK_X: {...} } }`).\n */\n// biome-ignore lint/suspicious/noEmptyInterface: filled by declaration merging\nexport interface DiagnosticCatalog {}\n\nexport type DiagnosticCode = keyof DiagnosticCatalog & string\nexport type DiagnosticDetails<C extends DiagnosticCode> = DiagnosticCatalog[C]\n\n/**\n * The human-readable half of a catalog entry (§8.2). The builders get the emitted details and must\n * compute their text from that real data. They run only in development, or in production after\n * `import '@datakable/core/messages'` (`datakable/messages`), so keep them pure and cheap.\n */\nexport interface DiagnosticText<C extends DiagnosticCode = DiagnosticCode> {\n  problem(details: DiagnosticDetails<C>): string\n  /** Consequence + the fallback applied. */\n  impact(details: DiagnosticDetails<C>): string\n  /** Concrete fixes, best first; never empty. */\n  fix(details: DiagnosticDetails<C>): string[]\n}\n\n/** Text for several codes, keyed by code (one object per owning module). */\nexport type DiagnosticMessages<C extends DiagnosticCode> = { readonly [K in C]: DiagnosticText<K> }\n\n/**\n * One catalog entry (§3.5, §8.3). `where` runs always; the text builders (`DiagnosticText`) only in\n * development or with messages opted in.\n */\nexport interface DiagnosticDefinition<C extends DiagnosticCode = DiagnosticCode>\n  extends DiagnosticText<C> {\n  readonly code: C\n  readonly level: DiagnosticLevel\n  /** `error (config)` codes: thrown as `DatakableConfigError` at creation (§8.6). */\n  readonly config?: boolean\n  where(details: DiagnosticDetails<C>): Location\n  /** Overrides the default `docs/errors.md#<code>` URL. */\n  readonly docs?: string\n  /**\n   * Detail fields that carry user data (row keys, cell values, schema issues, thrown errors), so\n   * redaction (§8.2) rewrites them before `where`, the text builders or any sink see them. See\n   * `RedactField`. Fields not listed are logged as-is.\n   */\n  readonly redact?: { readonly [K in keyof DiagnosticDetails<C>]?: RedactField }\n}\n\n/** A definition without its text: the part a production bundle keeps. */\nexport type DiagnosticMeta<C extends DiagnosticCode = DiagnosticCode> = Omit<\n  DiagnosticDefinition<C>,\n  keyof DiagnosticText\n>\n\nconst registry = new Map<string, DiagnosticDefinition>()\n\n/**\n * Adds a code to the catalog and returns the definition. A code may be defined again only with the\n * same level (module re-evaluation); a code is never redefined with another meaning (§8.5).\n *\n * Core passes the text separately as `(process.env.NODE_ENV !== \"production\") && messages.DK_X` (§8.2): a production bundle folds that\n * to `false`, drops the module's message object, and keeps only `code`, `level`, `where` and\n * `redact`. The same message object is what `@datakable/core/messages` installs.\n */\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  definition: DiagnosticDefinition<C>,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C>,\n  text: DiagnosticText<C> | false,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C> & Partial<DiagnosticText<C>>,\n  text?: DiagnosticText<C> | false,\n): DiagnosticDefinition<C> {\n  const definition = (text ? { ...meta, ...text } : meta) as DiagnosticDefinition<C>\n  const prev = registry.get(definition.code)\n  // Development check: codes are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\") && prev && prev.level !== definition.level) {\n    throw new Error(\n      `[DataKable] diagnostic code ${definition.code} is already defined as level ` +\n        `\"${prev.level}\"; codes are never redefined — pick a new code`,\n    )\n  }\n  registry.set(definition.code, definition as unknown as DiagnosticDefinition)\n  return definition\n}\n\nconst messages = new Map<string, DiagnosticText>()\n\n/**\n * Installs full message text for production builds (§8.2); called by `@datakable/core/messages`.\n * Development builds already carry the text on each definition.\n */\nexport function installMessages(...all: ReadonlyArray<Readonly<Record<string, unknown>>>): void {\n  for (const m of all) {\n    for (const code of Object.keys(m)) messages.set(code, m[code] as DiagnosticText)\n  }\n}\n\n/** `true` once `installMessages` ran: production diagnostics then build their text too. */\nexport const hasMessages = (): boolean => messages.size > 0\n\n/** The text builders for a code: from its definition (development) or installed messages. */\nexport function getDiagnosticText(code: string): DiagnosticText | undefined {\n  const def = registry.get(code)\n  return def && typeof def.problem === 'function' ? def : messages.get(code)\n}\n\n/**\n * Uses the definitions of the codes a module emits, so a bundler keeps them. `@datakable/core` is\n * built one file per module with `sideEffects: false`: a codes module that is only referenced\n * (`void defs`) is dropped from a consumer's bundle together with its `defineDiagnostic` calls, and\n * the codes would then emit as unknown. Call this at the top level of the emitting module. It\n * (re-)registers the definitions, which is idempotent. `pnpm check:catalog` verifies it per bundle.\n */\nexport function keepDiagnostics(\n  ...lists: ReadonlyArray<readonly { readonly code: string }[]>\n): void {\n  for (const list of lists) {\n    for (const def of list) registry.set(def.code, def as unknown as DiagnosticDefinition)\n  }\n}\n\nexport function getDiagnosticDefinition(code: string): DiagnosticDefinition | undefined {\n  return registry.get(code)\n}\n\nexport function listDiagnosticCodes(): string[] {\n  return [...registry.keys()]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyDA,IAAM,WAAW,oBAAI,IAAkC;AAiBhD,SAAS,iBACd,MACA,MACyB;AACzB,QAAM,aAAc,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI;AAClD,QAAM,OAAO,SAAS,IAAI,WAAW,IAAI;AAEzC,MAAK,QAAQ,IAAI,aAAa,gBAAiB,QAAQ,KAAK,UAAU,WAAW,OAAO;AACtF,UAAM,IAAI;AAAA,MACR,+BAA+B,WAAW,IAAI,iCACxC,KAAK,KAAK;AAAA,IAClB;AAAA,EACF;AACA,WAAS,IAAI,WAAW,MAAM,UAA6C;AAC3E,SAAO;AACT;AAEA,IAAM,WAAW,oBAAI,IAA4B;AAM1C,SAAS,mBAAmB,KAA6D;AAC9F,aAAW,KAAK,KAAK;AACnB,eAAW,QAAQ,OAAO,KAAK,CAAC,EAAG,UAAS,IAAI,MAAM,EAAE,IAAI,CAAmB;AAAA,EACjF;AACF;AAGO,IAAM,cAAc,MAAe,SAAS,OAAO;AAGnD,SAAS,kBAAkB,MAA0C;AAC1E,QAAM,MAAM,SAAS,IAAI,IAAI;AAC7B,SAAO,OAAO,OAAO,IAAI,YAAY,aAAa,MAAM,SAAS,IAAI,IAAI;AAC3E;AASO,SAAS,mBACX,OACG;AACN,aAAW,QAAQ,OAAO;AACxB,eAAW,OAAO,KAAM,UAAS,IAAI,IAAI,MAAM,GAAsC;AAAA,EACvF;AACF;AAEO,SAAS,wBAAwB,MAAgD;AACtF,SAAO,SAAS,IAAI,IAAI;AAC1B;AAEO,SAAS,sBAAgC;AAC9C,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/catalog.ts"],"sourcesContent":["import './process-guard'\nimport type { RedactField } from './redact'\nimport type { DiagnosticLevel, Location } from './types'\n\n/**\n * Code → details type, one entry per diagnostic code. Open for declaration merging, like\n * `Operations`: the module that owns a code declares its details next to its `defineDiagnostic`\n * (`declare module '@datakable/core' { interface DiagnosticCatalog { DK_X: {...} } }`).\n */\n// biome-ignore lint/suspicious/noEmptyInterface: filled by declaration merging\nexport interface DiagnosticCatalog {}\n\nexport type DiagnosticCode = keyof DiagnosticCatalog & string\nexport type DiagnosticDetails<C extends DiagnosticCode> = DiagnosticCatalog[C]\n\n/**\n * The human-readable half of a catalog entry (§8.2). The builders get the emitted details and must\n * compute their text from that real data. They run only in development, or in production after\n * `import '@datakable/core/messages'` (`datakable/messages`), so keep them pure and cheap.\n */\nexport interface DiagnosticText<C extends DiagnosticCode = DiagnosticCode> {\n  problem(details: DiagnosticDetails<C>): string\n  /** Consequence + the fallback applied. */\n  impact(details: DiagnosticDetails<C>): string\n  /** Concrete fixes, best first; never empty. */\n  fix(details: DiagnosticDetails<C>): string[]\n}\n\n/** Text for several codes, keyed by code (one object per owning module). */\nexport type DiagnosticMessages<C extends DiagnosticCode> = { readonly [K in C]: DiagnosticText<K> }\n\n/**\n * One catalog entry (§3.5, §8.3). `where` runs always; the text builders (`DiagnosticText`) only in\n * development or with messages opted in.\n */\nexport interface DiagnosticDefinition<C extends DiagnosticCode = DiagnosticCode>\n  extends DiagnosticText<C> {\n  readonly code: C\n  readonly level: DiagnosticLevel\n  /** `error (config)` codes: thrown as `DatakableConfigError` at creation (§8.6). */\n  readonly config?: boolean\n  where(details: DiagnosticDetails<C>): Location\n  /** Overrides the default `docs/errors.md#<code>` URL. */\n  readonly docs?: string\n  /**\n   * Detail fields that carry user data (row keys, cell values, schema issues, thrown errors), so\n   * redaction (§8.2) rewrites them before `where`, the text builders or any sink see them. See\n   * `RedactField`. Fields not listed are logged as-is.\n   */\n  readonly redact?: { readonly [K in keyof DiagnosticDetails<C>]?: RedactField }\n}\n\n/** A definition without its text: the part a production bundle keeps. */\nexport type DiagnosticMeta<C extends DiagnosticCode = DiagnosticCode> = Omit<\n  DiagnosticDefinition<C>,\n  keyof DiagnosticText\n>\n\nconst registry = new Map<string, DiagnosticDefinition>()\n\n/**\n * Adds a code to the catalog and returns the definition. A code may be defined again only with the\n * same level (module re-evaluation); a code is never redefined with another meaning (§8.5).\n *\n * Core passes the text separately as `(process.env.NODE_ENV !== \"production\") && messages.DK_X` (§8.2): a production bundle folds that\n * to `false`, drops the module's message object, and keeps only `code`, `level`, `where` and\n * `redact`. The same message object is what `@datakable/core/messages` installs.\n */\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  definition: DiagnosticDefinition<C>,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C>,\n  text: DiagnosticText<C> | false,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C> & Partial<DiagnosticText<C>>,\n  text?: DiagnosticText<C> | false,\n): DiagnosticDefinition<C> {\n  const definition = (text ? { ...meta, ...text } : meta) as DiagnosticDefinition<C>\n  // Development check: codes are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\")) {\n    const prev = registry.get(definition.code)\n    if (prev && prev.level !== definition.level) {\n      throw new Error(\n        `[DataKable] diagnostic code ${definition.code} is already defined as level ` +\n          `\"${prev.level}\"; codes are never redefined — pick a new code`,\n      )\n    }\n  }\n  registry.set(definition.code, definition as unknown as DiagnosticDefinition)\n  return definition\n}\n\nconst messages = new Map<string, DiagnosticText>()\n\n/**\n * Installs full message text for production builds (§8.2); called by `@datakable/core/messages`.\n * Development builds already carry the text on each definition.\n */\nexport function installMessages(...all: ReadonlyArray<Readonly<Record<string, unknown>>>): void {\n  for (const m of all) {\n    for (const code of Object.keys(m)) messages.set(code, m[code] as DiagnosticText)\n  }\n}\n\n/** An installed message by key: a code's text builders, or a detail prose sentence (`prose.ts`). */\nexport const installedText = (key: string): unknown => messages.get(key)\n\n/** `true` once `installMessages` ran: production diagnostics then build their text too. */\nexport const hasMessages = (): boolean => messages.size > 0\n\n/** The text builders for a code: from its definition (development) or installed messages. */\nexport function getDiagnosticText(code: string): DiagnosticText | undefined {\n  const def = registry.get(code)\n  return def && typeof def.problem === 'function' ? def : messages.get(code)\n}\n\n/**\n * Uses the definitions of the codes a module emits, so a bundler keeps them. `@datakable/core` is\n * built one file per module with `sideEffects: false`: a codes module that is only referenced\n * (`void defs`) is dropped from a consumer's bundle together with its `defineDiagnostic` calls, and\n * the codes would then emit as unknown. Call this at the top level of the emitting module. It\n * (re-)registers the definitions, which is idempotent. `pnpm check:catalog` verifies it per bundle.\n */\nexport function keepDiagnostics(\n  ...lists: ReadonlyArray<readonly { readonly code: string }[]>\n): void {\n  for (const list of lists) {\n    for (const def of list) registry.set(def.code, def as unknown as DiagnosticDefinition)\n  }\n}\n\nexport function getDiagnosticDefinition(code: string): DiagnosticDefinition | undefined {\n  return registry.get(code)\n}\n\nexport function listDiagnosticCodes(): string[] {\n  return [...registry.keys()]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAO;AA0DP,IAAM,WAAW,oBAAI,IAAkC;AAiBhD,SAAS,iBACd,MACA,MACyB;AACzB,QAAM,aAAc,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI;AAElD,MAAK,QAAQ,IAAI,aAAa,cAAe;AAC3C,UAAM,OAAO,SAAS,IAAI,WAAW,IAAI;AACzC,QAAI,QAAQ,KAAK,UAAU,WAAW,OAAO;AAC3C,YAAM,IAAI;AAAA,QACR,+BAA+B,WAAW,IAAI,iCACxC,KAAK,KAAK;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,WAAS,IAAI,WAAW,MAAM,UAA6C;AAC3E,SAAO;AACT;AAEA,IAAM,WAAW,oBAAI,IAA4B;AAM1C,SAAS,mBAAmB,KAA6D;AAC9F,aAAW,KAAK,KAAK;AACnB,eAAW,QAAQ,OAAO,KAAK,CAAC,EAAG,UAAS,IAAI,MAAM,EAAE,IAAI,CAAmB;AAAA,EACjF;AACF;AAGO,IAAM,gBAAgB,CAAC,QAAyB,SAAS,IAAI,GAAG;AAGhE,IAAM,cAAc,MAAe,SAAS,OAAO;AAGnD,SAAS,kBAAkB,MAA0C;AAC1E,QAAM,MAAM,SAAS,IAAI,IAAI;AAC7B,SAAO,OAAO,OAAO,IAAI,YAAY,aAAa,MAAM,SAAS,IAAI,IAAI;AAC3E;AASO,SAAS,mBACX,OACG;AACN,aAAW,QAAQ,OAAO;AACxB,eAAW,OAAO,KAAM,UAAS,IAAI,IAAI,MAAM,GAAsC;AAAA,EACvF;AACF;AAEO,SAAS,wBAAwB,MAAgD;AACtF,SAAO,SAAS,IAAI,IAAI;AAC1B;AAEO,SAAS,sBAAgC;AAC9C,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;","names":[]}

package/dist/diagnostics/catalog.js

@@ -1,12 +1,15 @@
 // src/diagnostics/catalog.ts
+import "./process-guard.js";
 var registry = /* @__PURE__ */ new Map();
 function defineDiagnostic(meta, text) {
   const definition = text ? { ...meta, ...text } : meta;
-  const prev = registry.get(definition.code);
-  if (process.env.NODE_ENV !== "production" && prev && prev.level !== definition.level) {
-    throw new Error(
-      `[DataKable] diagnostic code ${definition.code} is already defined as level "${prev.level}"; codes are never redefined \u2014 pick a new code`
-    );
+  if (process.env.NODE_ENV !== "production") {
+    const prev = registry.get(definition.code);
+    if (prev && prev.level !== definition.level) {
+      throw new Error(
+        `[DataKable] diagnostic code ${definition.code} is already defined as level "${prev.level}"; codes are never redefined \u2014 pick a new code`
+      );
+    }
   }
   registry.set(definition.code, definition);
   return definition;
@@ -17,6 +20,7 @@ function installMessages(...all) {
     for (const code of Object.keys(m)) messages.set(code, m[code]);
   }
 }
+var installedText = (key) => messages.get(key);
 var hasMessages = () => messages.size > 0;
 function getDiagnosticText(code) {
   const def = registry.get(code);
@@ -39,6 +43,7 @@ export {
   getDiagnosticText,
   hasMessages,
   installMessages,
+  installedText,
   keepDiagnostics,
   listDiagnosticCodes
 };

package/dist/diagnostics/catalog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/catalog.ts"],"sourcesContent":["import type { RedactField } from './redact'\nimport type { DiagnosticLevel, Location } from './types'\n\n/**\n * Code → details type, one entry per diagnostic code. Open for declaration merging, like\n * `Operations`: the module that owns a code declares its details next to its `defineDiagnostic`\n * (`declare module '@datakable/core' { interface DiagnosticCatalog { DK_X: {...} } }`).\n */\n// biome-ignore lint/suspicious/noEmptyInterface: filled by declaration merging\nexport interface DiagnosticCatalog {}\n\nexport type DiagnosticCode = keyof DiagnosticCatalog & string\nexport type DiagnosticDetails<C extends DiagnosticCode> = DiagnosticCatalog[C]\n\n/**\n * The human-readable half of a catalog entry (§8.2). The builders get the emitted details and must\n * compute their text from that real data. They run only in development, or in production after\n * `import '@datakable/core/messages'` (`datakable/messages`), so keep them pure and cheap.\n */\nexport interface DiagnosticText<C extends DiagnosticCode = DiagnosticCode> {\n  problem(details: DiagnosticDetails<C>): string\n  /** Consequence + the fallback applied. */\n  impact(details: DiagnosticDetails<C>): string\n  /** Concrete fixes, best first; never empty. */\n  fix(details: DiagnosticDetails<C>): string[]\n}\n\n/** Text for several codes, keyed by code (one object per owning module). */\nexport type DiagnosticMessages<C extends DiagnosticCode> = { readonly [K in C]: DiagnosticText<K> }\n\n/**\n * One catalog entry (§3.5, §8.3). `where` runs always; the text builders (`DiagnosticText`) only in\n * development or with messages opted in.\n */\nexport interface DiagnosticDefinition<C extends DiagnosticCode = DiagnosticCode>\n  extends DiagnosticText<C> {\n  readonly code: C\n  readonly level: DiagnosticLevel\n  /** `error (config)` codes: thrown as `DatakableConfigError` at creation (§8.6). */\n  readonly config?: boolean\n  where(details: DiagnosticDetails<C>): Location\n  /** Overrides the default `docs/errors.md#<code>` URL. */\n  readonly docs?: string\n  /**\n   * Detail fields that carry user data (row keys, cell values, schema issues, thrown errors), so\n   * redaction (§8.2) rewrites them before `where`, the text builders or any sink see them. See\n   * `RedactField`. Fields not listed are logged as-is.\n   */\n  readonly redact?: { readonly [K in keyof DiagnosticDetails<C>]?: RedactField }\n}\n\n/** A definition without its text: the part a production bundle keeps. */\nexport type DiagnosticMeta<C extends DiagnosticCode = DiagnosticCode> = Omit<\n  DiagnosticDefinition<C>,\n  keyof DiagnosticText\n>\n\nconst registry = new Map<string, DiagnosticDefinition>()\n\n/**\n * Adds a code to the catalog and returns the definition. A code may be defined again only with the\n * same level (module re-evaluation); a code is never redefined with another meaning (§8.5).\n *\n * Core passes the text separately as `(process.env.NODE_ENV !== \"production\") && messages.DK_X` (§8.2): a production bundle folds that\n * to `false`, drops the module's message object, and keeps only `code`, `level`, `where` and\n * `redact`. The same message object is what `@datakable/core/messages` installs.\n */\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  definition: DiagnosticDefinition<C>,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C>,\n  text: DiagnosticText<C> | false,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C> & Partial<DiagnosticText<C>>,\n  text?: DiagnosticText<C> | false,\n): DiagnosticDefinition<C> {\n  const definition = (text ? { ...meta, ...text } : meta) as DiagnosticDefinition<C>\n  const prev = registry.get(definition.code)\n  // Development check: codes are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\") && prev && prev.level !== definition.level) {\n    throw new Error(\n      `[DataKable] diagnostic code ${definition.code} is already defined as level ` +\n        `\"${prev.level}\"; codes are never redefined — pick a new code`,\n    )\n  }\n  registry.set(definition.code, definition as unknown as DiagnosticDefinition)\n  return definition\n}\n\nconst messages = new Map<string, DiagnosticText>()\n\n/**\n * Installs full message text for production builds (§8.2); called by `@datakable/core/messages`.\n * Development builds already carry the text on each definition.\n */\nexport function installMessages(...all: ReadonlyArray<Readonly<Record<string, unknown>>>): void {\n  for (const m of all) {\n    for (const code of Object.keys(m)) messages.set(code, m[code] as DiagnosticText)\n  }\n}\n\n/** `true` once `installMessages` ran: production diagnostics then build their text too. */\nexport const hasMessages = (): boolean => messages.size > 0\n\n/** The text builders for a code: from its definition (development) or installed messages. */\nexport function getDiagnosticText(code: string): DiagnosticText | undefined {\n  const def = registry.get(code)\n  return def && typeof def.problem === 'function' ? def : messages.get(code)\n}\n\n/**\n * Uses the definitions of the codes a module emits, so a bundler keeps them. `@datakable/core` is\n * built one file per module with `sideEffects: false`: a codes module that is only referenced\n * (`void defs`) is dropped from a consumer's bundle together with its `defineDiagnostic` calls, and\n * the codes would then emit as unknown. Call this at the top level of the emitting module. It\n * (re-)registers the definitions, which is idempotent. `pnpm check:catalog` verifies it per bundle.\n */\nexport function keepDiagnostics(\n  ...lists: ReadonlyArray<readonly { readonly code: string }[]>\n): void {\n  for (const list of lists) {\n    for (const def of list) registry.set(def.code, def as unknown as DiagnosticDefinition)\n  }\n}\n\nexport function getDiagnosticDefinition(code: string): DiagnosticDefinition | undefined {\n  return registry.get(code)\n}\n\nexport function listDiagnosticCodes(): string[] {\n  return [...registry.keys()]\n}\n"],"mappings":";AAyDA,IAAM,WAAW,oBAAI,IAAkC;AAiBhD,SAAS,iBACd,MACA,MACyB;AACzB,QAAM,aAAc,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI;AAClD,QAAM,OAAO,SAAS,IAAI,WAAW,IAAI;AAEzC,MAAK,QAAQ,IAAI,aAAa,gBAAiB,QAAQ,KAAK,UAAU,WAAW,OAAO;AACtF,UAAM,IAAI;AAAA,MACR,+BAA+B,WAAW,IAAI,iCACxC,KAAK,KAAK;AAAA,IAClB;AAAA,EACF;AACA,WAAS,IAAI,WAAW,MAAM,UAA6C;AAC3E,SAAO;AACT;AAEA,IAAM,WAAW,oBAAI,IAA4B;AAM1C,SAAS,mBAAmB,KAA6D;AAC9F,aAAW,KAAK,KAAK;AACnB,eAAW,QAAQ,OAAO,KAAK,CAAC,EAAG,UAAS,IAAI,MAAM,EAAE,IAAI,CAAmB;AAAA,EACjF;AACF;AAGO,IAAM,cAAc,MAAe,SAAS,OAAO;AAGnD,SAAS,kBAAkB,MAA0C;AAC1E,QAAM,MAAM,SAAS,IAAI,IAAI;AAC7B,SAAO,OAAO,OAAO,IAAI,YAAY,aAAa,MAAM,SAAS,IAAI,IAAI;AAC3E;AASO,SAAS,mBACX,OACG;AACN,aAAW,QAAQ,OAAO;AACxB,eAAW,OAAO,KAAM,UAAS,IAAI,IAAI,MAAM,GAAsC;AAAA,EACvF;AACF;AAEO,SAAS,wBAAwB,MAAgD;AACtF,SAAO,SAAS,IAAI,IAAI;AAC1B;AAEO,SAAS,sBAAgC;AAC9C,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;","names":[]}
+{"version":3,"sources":["../../src/diagnostics/catalog.ts"],"sourcesContent":["import './process-guard'\nimport type { RedactField } from './redact'\nimport type { DiagnosticLevel, Location } from './types'\n\n/**\n * Code → details type, one entry per diagnostic code. Open for declaration merging, like\n * `Operations`: the module that owns a code declares its details next to its `defineDiagnostic`\n * (`declare module '@datakable/core' { interface DiagnosticCatalog { DK_X: {...} } }`).\n */\n// biome-ignore lint/suspicious/noEmptyInterface: filled by declaration merging\nexport interface DiagnosticCatalog {}\n\nexport type DiagnosticCode = keyof DiagnosticCatalog & string\nexport type DiagnosticDetails<C extends DiagnosticCode> = DiagnosticCatalog[C]\n\n/**\n * The human-readable half of a catalog entry (§8.2). The builders get the emitted details and must\n * compute their text from that real data. They run only in development, or in production after\n * `import '@datakable/core/messages'` (`datakable/messages`), so keep them pure and cheap.\n */\nexport interface DiagnosticText<C extends DiagnosticCode = DiagnosticCode> {\n  problem(details: DiagnosticDetails<C>): string\n  /** Consequence + the fallback applied. */\n  impact(details: DiagnosticDetails<C>): string\n  /** Concrete fixes, best first; never empty. */\n  fix(details: DiagnosticDetails<C>): string[]\n}\n\n/** Text for several codes, keyed by code (one object per owning module). */\nexport type DiagnosticMessages<C extends DiagnosticCode> = { readonly [K in C]: DiagnosticText<K> }\n\n/**\n * One catalog entry (§3.5, §8.3). `where` runs always; the text builders (`DiagnosticText`) only in\n * development or with messages opted in.\n */\nexport interface DiagnosticDefinition<C extends DiagnosticCode = DiagnosticCode>\n  extends DiagnosticText<C> {\n  readonly code: C\n  readonly level: DiagnosticLevel\n  /** `error (config)` codes: thrown as `DatakableConfigError` at creation (§8.6). */\n  readonly config?: boolean\n  where(details: DiagnosticDetails<C>): Location\n  /** Overrides the default `docs/errors.md#<code>` URL. */\n  readonly docs?: string\n  /**\n   * Detail fields that carry user data (row keys, cell values, schema issues, thrown errors), so\n   * redaction (§8.2) rewrites them before `where`, the text builders or any sink see them. See\n   * `RedactField`. Fields not listed are logged as-is.\n   */\n  readonly redact?: { readonly [K in keyof DiagnosticDetails<C>]?: RedactField }\n}\n\n/** A definition without its text: the part a production bundle keeps. */\nexport type DiagnosticMeta<C extends DiagnosticCode = DiagnosticCode> = Omit<\n  DiagnosticDefinition<C>,\n  keyof DiagnosticText\n>\n\nconst registry = new Map<string, DiagnosticDefinition>()\n\n/**\n * Adds a code to the catalog and returns the definition. A code may be defined again only with the\n * same level (module re-evaluation); a code is never redefined with another meaning (§8.5).\n *\n * Core passes the text separately as `(process.env.NODE_ENV !== \"production\") && messages.DK_X` (§8.2): a production bundle folds that\n * to `false`, drops the module's message object, and keeps only `code`, `level`, `where` and\n * `redact`. The same message object is what `@datakable/core/messages` installs.\n */\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  definition: DiagnosticDefinition<C>,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C>,\n  text: DiagnosticText<C> | false,\n): DiagnosticDefinition<C>\nexport function defineDiagnostic<const C extends DiagnosticCode>(\n  meta: DiagnosticMeta<C> & Partial<DiagnosticText<C>>,\n  text?: DiagnosticText<C> | false,\n): DiagnosticDefinition<C> {\n  const definition = (text ? { ...meta, ...text } : meta) as DiagnosticDefinition<C>\n  // Development check: codes are fixed at build time, a production bundle skips it.\n  if ((process.env.NODE_ENV !== \"production\")) {\n    const prev = registry.get(definition.code)\n    if (prev && prev.level !== definition.level) {\n      throw new Error(\n        `[DataKable] diagnostic code ${definition.code} is already defined as level ` +\n          `\"${prev.level}\"; codes are never redefined — pick a new code`,\n      )\n    }\n  }\n  registry.set(definition.code, definition as unknown as DiagnosticDefinition)\n  return definition\n}\n\nconst messages = new Map<string, DiagnosticText>()\n\n/**\n * Installs full message text for production builds (§8.2); called by `@datakable/core/messages`.\n * Development builds already carry the text on each definition.\n */\nexport function installMessages(...all: ReadonlyArray<Readonly<Record<string, unknown>>>): void {\n  for (const m of all) {\n    for (const code of Object.keys(m)) messages.set(code, m[code] as DiagnosticText)\n  }\n}\n\n/** An installed message by key: a code's text builders, or a detail prose sentence (`prose.ts`). */\nexport const installedText = (key: string): unknown => messages.get(key)\n\n/** `true` once `installMessages` ran: production diagnostics then build their text too. */\nexport const hasMessages = (): boolean => messages.size > 0\n\n/** The text builders for a code: from its definition (development) or installed messages. */\nexport function getDiagnosticText(code: string): DiagnosticText | undefined {\n  const def = registry.get(code)\n  return def && typeof def.problem === 'function' ? def : messages.get(code)\n}\n\n/**\n * Uses the definitions of the codes a module emits, so a bundler keeps them. `@datakable/core` is\n * built one file per module with `sideEffects: false`: a codes module that is only referenced\n * (`void defs`) is dropped from a consumer's bundle together with its `defineDiagnostic` calls, and\n * the codes would then emit as unknown. Call this at the top level of the emitting module. It\n * (re-)registers the definitions, which is idempotent. `pnpm check:catalog` verifies it per bundle.\n */\nexport function keepDiagnostics(\n  ...lists: ReadonlyArray<readonly { readonly code: string }[]>\n): void {\n  for (const list of lists) {\n    for (const def of list) registry.set(def.code, def as unknown as DiagnosticDefinition)\n  }\n}\n\nexport function getDiagnosticDefinition(code: string): DiagnosticDefinition | undefined {\n  return registry.get(code)\n}\n\nexport function listDiagnosticCodes(): string[] {\n  return [...registry.keys()]\n}\n"],"mappings":";AAAA,OAAO;AA0DP,IAAM,WAAW,oBAAI,IAAkC;AAiBhD,SAAS,iBACd,MACA,MACyB;AACzB,QAAM,aAAc,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI;AAElD,MAAK,QAAQ,IAAI,aAAa,cAAe;AAC3C,UAAM,OAAO,SAAS,IAAI,WAAW,IAAI;AACzC,QAAI,QAAQ,KAAK,UAAU,WAAW,OAAO;AAC3C,YAAM,IAAI;AAAA,QACR,+BAA+B,WAAW,IAAI,iCACxC,KAAK,KAAK;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,WAAS,IAAI,WAAW,MAAM,UAA6C;AAC3E,SAAO;AACT;AAEA,IAAM,WAAW,oBAAI,IAA4B;AAM1C,SAAS,mBAAmB,KAA6D;AAC9F,aAAW,KAAK,KAAK;AACnB,eAAW,QAAQ,OAAO,KAAK,CAAC,EAAG,UAAS,IAAI,MAAM,EAAE,IAAI,CAAmB;AAAA,EACjF;AACF;AAGO,IAAM,gBAAgB,CAAC,QAAyB,SAAS,IAAI,GAAG;AAGhE,IAAM,cAAc,MAAe,SAAS,OAAO;AAGnD,SAAS,kBAAkB,MAA0C;AAC1E,QAAM,MAAM,SAAS,IAAI,IAAI;AAC7B,SAAO,OAAO,OAAO,IAAI,YAAY,aAAa,MAAM,SAAS,IAAI,IAAI;AAC3E;AASO,SAAS,mBACX,OACG;AACN,aAAW,QAAQ,OAAO;AACxB,eAAW,OAAO,KAAM,UAAS,IAAI,IAAI,MAAM,GAAsC;AAAA,EACvF;AACF;AAEO,SAAS,wBAAwB,MAAgD;AACtF,SAAO,SAAS,IAAI,IAAI;AAC1B;AAEO,SAAS,sBAAgC;AAC9C,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;","names":[]}

package/dist/diagnostics/codes.cjs

@@ -26,6 +26,7 @@ __export(codes_exports, {
 module.exports = __toCommonJS(codes_exports);
 var import_version = require("../version.cjs");
 var import_catalog = require("./catalog.cjs");
+var import_process_guard = require("./process-guard.cjs");
 var ISSUES = "https://github.com/Ink01101011/datakable/issues/new";
 function issueLink(d) {
   const title = `DK_INTERNAL in ${d.op}${d.errorName ? ` (${d.errorName})` : ""}`;
@@ -89,14 +90,17 @@ var coreDiagnostics = [
     },
     process.env.NODE_ENV !== "production" && coreMessages.DK_INTERCEPTOR_FAILED
   ),
-  (0, import_catalog.defineDiagnostic)(
-    {
-      code: "DK_HOT_INTERCEPTOR",
-      level: "warn",
-      where: (d) => ({ kind: "interceptor", name: d.interceptor, op: d.op })
-    },
-    process.env.NODE_ENV !== "production" && coreMessages.DK_HOT_INTERCEPTOR
-  ),
+  // Dev-only warning (never emitted in production): no definition there either.
+  ...process.env.NODE_ENV !== "production" ? [
+    (0, import_catalog.defineDiagnostic)(
+      {
+        code: "DK_HOT_INTERCEPTOR",
+        level: "warn",
+        where: (d) => ({ kind: "interceptor", name: d.interceptor, op: d.op })
+      },
+      process.env.NODE_ENV !== "production" && coreMessages.DK_HOT_INTERCEPTOR
+    )
+  ] : [],
   (0, import_catalog.defineDiagnostic)(
     {
       code: "DK_OPERATION_CONFLICT",

package/dist/diagnostics/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/diagnostics/codes.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport { type DiagnosticMessages, defineDiagnostic } from './catalog'\n\ndeclare module './catalog' {\n  interface DiagnosticCatalog {\n    DK_INTERCEPTOR_FAILED: { interceptor: string; op: string; slot: string }\n    DK_HOT_INTERCEPTOR: { interceptor: string; op: string }\n    DK_OPERATION_CONFLICT: {\n      op: string\n      kind: string\n      hot: boolean\n      previousKind: string\n      previousHot: boolean\n    }\n    DK_INTERNAL: {\n      op: string\n      problem: string\n      /** The ctx `where` of the failed call (errorBoundary). */\n      slot?: string\n      /** `error.name` of the classified throw (errorBoundary). */\n      errorName?: string\n      /** The registry fallback applied (errorBoundary); invariant callers abort instead. */\n      fallback?: string\n      /**\n       * `error.message` of the classified throw (errorBoundary). Engine messages embed row values\n       * (`Cannot create property 'x' on string '<value>'`), so it is redacted as a cell value.\n       */\n      message?: unknown\n    }\n  }\n}\n\nconst ISSUES = 'https://github.com/Ink01101011/datakable/issues/new'\n\n/** Prefilled GitHub issue (§8.3): version, op, slot and error name — never values. */\nfunction issueLink(d: { op: string; slot?: string; errorName?: string }): string {\n  const title = `DK_INTERNAL in ${d.op}${d.errorName ? ` (${d.errorName})` : ''}`\n  const body = [\n    `package: @datakable/core@${VERSION}`,\n    `operation: ${d.op}`,\n    `slot: ${d.slot ?? '-'}`,\n    `error: ${d.errorName ?? '-'}`,\n    '',\n    'diagnostic.toJSON():',\n    '',\n    'table.explain():',\n    '',\n  ].join('\\n')\n  return `${ISSUES}?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const coreMessages: DiagnosticMessages<\n  'DK_INTERCEPTOR_FAILED' | 'DK_HOT_INTERCEPTOR' | 'DK_OPERATION_CONFLICT' | 'DK_INTERNAL'\n> = {\n  DK_INTERCEPTOR_FAILED: {\n    problem: (d) => `interceptor \"${d.interceptor}\" threw on ${d.op} (at ${d.slot})`,\n    impact: () => 'the interceptor was skipped for this call; the operation ran without it',\n    fix: (d) => [\n      `catch errors inside \"${d.interceptor}\" and always return next() (or a valid result)`,\n      `see context.cause for the original error`,\n    ],\n  },\n  DK_HOT_INTERCEPTOR: {\n    problem: (d) =>\n      `interceptor \"${d.interceptor}\" is attached to hot op \"${d.op}\" without hot: true`,\n    // Measured by intercept/chain.bench.ts (Apple M4 Pro, Node 25.2.1): one pass-through\n    // interceptor adds ~10 ns per call; spec §9.2 measured +15% when wrapping per cell. Kept inside\n    // the builder (no module constant), so production bundles carry none of it.\n    impact: () =>\n      'it runs once per column per pipeline run; measured cost: ~10 ns per call per ' +\n      'interceptor (+15% on a per-cell format call, spec §9.2) on top of the interceptor body, ' +\n      'which runs columns × pipeline runs times. It still runs (dev-only warning).',\n    fix: (d) => [\n      `set hot: true on \"${d.interceptor}\" to accept the cost, and never loop per cell inside it`,\n      `attach \"${d.interceptor}\" to cold ops only (list them in \\`on\\` instead of '*' / '${d.op}')`,\n    ],\n  },\n  DK_OPERATION_CONFLICT: {\n    problem: (d) =>\n      `operation \"${d.op}\" is already registered as ${d.previousKind}` +\n      `${d.previousHot ? ' (hot)' : ''}; got ${d.kind}${d.hot ? ' (hot)' : ''}`,\n    impact: () => 'the registration was rejected; the first one stays in effect',\n    fix: (d) => [\n      `register \"${d.op}\" with the same kind and hot flag (${d.previousKind}, hot: ${d.previousHot})`,\n      `or give the new operation its own name, e.g. \"myplugin:${d.op.split(':').pop()}\"`,\n    ],\n  },\n  DK_INTERNAL: {\n    problem: (d) =>\n      d.errorName\n        ? `${d.errorName} thrown inside DataKable code during ${d.op}` +\n          `${d.message === undefined ? '' : ` (message: ${String(d.message)})`} — likely a DataKable bug`\n        : d.problem,\n    impact: (d) => (d.fallback ? `${d.fallback}; the table keeps working` : 'the call was aborted'),\n    fix: (d) => [\n      `this is likely a DataKable bug or a plugin wiring error — report it: ${issueLink(d)}`,\n      'attach diagnostic.toJSON() and table.explain() (both redacted) to the issue',\n      'meanwhile, check plugins / interceptors registered on this operation',\n    ],\n  },\n}\n\n/** Codes owned by core plumbing (interceptor runtime, op registry). Features define their own. */\nexport const coreDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INTERCEPTOR_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'interceptor', name: d.interceptor, op: d.op }),\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_INTERCEPTOR_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_HOT_INTERCEPTOR',\n      level: 'warn',\n      where: (d) => ({ kind: 'interceptor', name: d.interceptor, op: d.op }),\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_HOT_INTERCEPTOR,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_OPERATION_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'operation', op: d.op }),\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_OPERATION_CONFLICT,\n  ),\n  // Core invariants (unknown op, boundary installed twice) and throws that errorBoundary traced to\n  // DataKable's own code (top stack frame in a datakable path).\n  defineDiagnostic(\n    {\n      code: 'DK_INTERNAL',\n      level: 'error',\n      where: (d) =>\n        d.slot ? { kind: 'operation', op: d.op, slot: d.slot } : { kind: 'operation', op: d.op },\n      redact: { message: 'value' },\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_INTERNAL,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/diagnostics/codes.ts"],"sourcesContent":["import { VERSION } from '../version'\nimport { type DiagnosticMessages, defineDiagnostic } from './catalog'\nimport './process-guard'\n\ndeclare module './catalog' {\n  interface DiagnosticCatalog {\n    DK_INTERCEPTOR_FAILED: { interceptor: string; op: string; slot: string }\n    DK_HOT_INTERCEPTOR: { interceptor: string; op: string }\n    DK_OPERATION_CONFLICT: {\n      op: string\n      kind: string\n      hot: boolean\n      previousKind: string\n      previousHot: boolean\n    }\n    DK_INTERNAL: {\n      op: string\n      problem: string\n      /** The ctx `where` of the failed call (errorBoundary). */\n      slot?: string\n      /** `error.name` of the classified throw (errorBoundary). */\n      errorName?: string\n      /** The registry fallback applied (errorBoundary); invariant callers abort instead. */\n      fallback?: string\n      /**\n       * `error.message` of the classified throw (errorBoundary). Engine messages embed row values\n       * (`Cannot create property 'x' on string '<value>'`), so it is redacted as a cell value.\n       */\n      message?: unknown\n    }\n  }\n}\n\nconst ISSUES = 'https://github.com/Ink01101011/datakable/issues/new'\n\n/** Prefilled GitHub issue (§8.3): version, op, slot and error name — never values. */\nfunction issueLink(d: { op: string; slot?: string; errorName?: string }): string {\n  const title = `DK_INTERNAL in ${d.op}${d.errorName ? ` (${d.errorName})` : ''}`\n  const body = [\n    `package: @datakable/core@${VERSION}`,\n    `operation: ${d.op}`,\n    `slot: ${d.slot ?? '-'}`,\n    `error: ${d.errorName ?? '-'}`,\n    '',\n    'diagnostic.toJSON():',\n    '',\n    'table.explain():',\n    '',\n  ].join('\\n')\n  return `${ISSUES}?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const coreMessages: DiagnosticMessages<\n  'DK_INTERCEPTOR_FAILED' | 'DK_HOT_INTERCEPTOR' | 'DK_OPERATION_CONFLICT' | 'DK_INTERNAL'\n> = {\n  DK_INTERCEPTOR_FAILED: {\n    problem: (d) => `interceptor \"${d.interceptor}\" threw on ${d.op} (at ${d.slot})`,\n    impact: () => 'the interceptor was skipped for this call; the operation ran without it',\n    fix: (d) => [\n      `catch errors inside \"${d.interceptor}\" and always return next() (or a valid result)`,\n      `see context.cause for the original error`,\n    ],\n  },\n  DK_HOT_INTERCEPTOR: {\n    problem: (d) =>\n      `interceptor \"${d.interceptor}\" is attached to hot op \"${d.op}\" without hot: true`,\n    // Measured by intercept/chain.bench.ts (Apple M4 Pro, Node 25.2.1): one pass-through\n    // interceptor adds ~10 ns per call; spec §9.2 measured +15% when wrapping per cell. Kept inside\n    // the builder (no module constant), so production bundles carry none of it.\n    impact: () =>\n      'it runs once per column per pipeline run; measured cost: ~10 ns per call per ' +\n      'interceptor (+15% on a per-cell format call, spec §9.2) on top of the interceptor body, ' +\n      'which runs columns × pipeline runs times. It still runs (dev-only warning).',\n    fix: (d) => [\n      `set hot: true on \"${d.interceptor}\" to accept the cost, and never loop per cell inside it`,\n      `attach \"${d.interceptor}\" to cold ops only (list them in \\`on\\` instead of '*' / '${d.op}')`,\n    ],\n  },\n  DK_OPERATION_CONFLICT: {\n    problem: (d) =>\n      `operation \"${d.op}\" is already registered as ${d.previousKind}` +\n      `${d.previousHot ? ' (hot)' : ''}; got ${d.kind}${d.hot ? ' (hot)' : ''}`,\n    impact: () => 'the registration was rejected; the first one stays in effect',\n    fix: (d) => [\n      `register \"${d.op}\" with the same kind and hot flag (${d.previousKind}, hot: ${d.previousHot})`,\n      `or give the new operation its own name, e.g. \"myplugin:${d.op.split(':').pop()}\"`,\n    ],\n  },\n  DK_INTERNAL: {\n    problem: (d) =>\n      d.errorName\n        ? `${d.errorName} thrown inside DataKable code during ${d.op}` +\n          `${d.message === undefined ? '' : ` (message: ${String(d.message)})`} — likely a DataKable bug`\n        : d.problem,\n    impact: (d) => (d.fallback ? `${d.fallback}; the table keeps working` : 'the call was aborted'),\n    fix: (d) => [\n      `this is likely a DataKable bug or a plugin wiring error — report it: ${issueLink(d)}`,\n      'attach diagnostic.toJSON() and table.explain() (both redacted) to the issue',\n      'meanwhile, check plugins / interceptors registered on this operation',\n    ],\n  },\n}\n\n/** Codes owned by core plumbing (interceptor runtime, op registry). Features define their own. */\nexport const coreDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_INTERCEPTOR_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'interceptor', name: d.interceptor, op: d.op }),\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_INTERCEPTOR_FAILED,\n  ),\n  // Dev-only warning (never emitted in production): no definition there either.\n  ...((process.env.NODE_ENV !== \"production\")\n    ? [\n        defineDiagnostic(\n          {\n            code: 'DK_HOT_INTERCEPTOR',\n            level: 'warn',\n            where: (d) => ({ kind: 'interceptor', name: d.interceptor, op: d.op }),\n          },\n          (process.env.NODE_ENV !== \"production\") && coreMessages.DK_HOT_INTERCEPTOR,\n        ),\n      ]\n    : []),\n  defineDiagnostic(\n    {\n      code: 'DK_OPERATION_CONFLICT',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'operation', op: d.op }),\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_OPERATION_CONFLICT,\n  ),\n  // Core invariants (unknown op, boundary installed twice) and throws that errorBoundary traced to\n  // DataKable's own code (top stack frame in a datakable path).\n  defineDiagnostic(\n    {\n      code: 'DK_INTERNAL',\n      level: 'error',\n      where: (d) =>\n        d.slot ? { kind: 'operation', op: d.op, slot: d.slot } : { kind: 'operation', op: d.op },\n      redact: { message: 'value' },\n    },\n    (process.env.NODE_ENV !== \"production\") && coreMessages.DK_INTERNAL,\n  ),\n]\n"],"mappings":"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","names":[]}