@datakable/core 1.0.0 → 1.1.0

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

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

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

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

package/dist/feature/codes.cjs

@@ -25,6 +25,7 @@ __export(codes_exports, {
 });
 module.exports = __toCommonJS(codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
 var featureMessages = {
   DK_FEATURE_DUPLICATE: {

package/dist/feature/codes.cjs.map

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

package/dist/feature/codes.js

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

package/dist/feature/codes.js.map

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

package/dist/feature/define.cjs

@@ -29,7 +29,7 @@ var import_slice = require("../pipeline/slice.cjs");
 var import_install = require("./install.cjs");
 var import_order = require("./order.cjs");
 var import_runtime = require("./runtime.cjs");
-import_runtime.featureRuntime.current ??= {
+var runtime = {
   orderFeatures: import_order.orderFeatures,
   initialSlices: import_install.initialSlices,
   installApis: import_install.installApis,
@@ -37,7 +37,9 @@ import_runtime.featureRuntime.current ??= {
   createSlicer: import_slice.createSlicer,
   explainDetail: import_explain_detail.explainDetail
 };
+import_runtime.featureRuntime.current ??= runtime;
 function defineFeature(definition) {
+  import_runtime.featureRuntime.current ??= runtime;
   return definition;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/feature/define.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/define.ts"],"sourcesContent":["import { explainDetail } from '../diagnostics/explain-detail'\nimport { createColumnCache } from '../pipeline/column-cache'\nimport { createSlicer } from '../pipeline/slice'\nimport { initialSlices, installApis } from './install'\nimport { orderFeatures } from './order'\nimport { featureRuntime } from './runtime'\nimport type {\n  AnyRow,\n  Feature,\n  FeatureContext,\n  FeatureTypes,\n  FixedTypes,\n  RowModelContext,\n} from './types'\n\n// Features bring their runtime (§3.3, changed 2026-10-13 for §9.3): loading defineFeature installs\n// it, so a table without features never bundles it.\nfeatureRuntime.current ??= {\n  orderFeatures,\n  initialSlices,\n  installApis,\n  createColumnCache,\n  createSlicer,\n  explainDetail,\n}\n\n/** A feature whose state `S` and API `A` do not depend on the row type (inferred). */\nexport interface FixedFeatureDefinition<Name extends string, S, A>\n  extends Omit<\n    Feature<Name, FixedTypes<S, A>>,\n    '_types' | 'initialState' | 'createApi' | 'rowModel'\n  > {\n  initialState: () => S\n  createApi: (ctx: FeatureContext<S>) => A\n  rowModel?: (indices: Uint32Array, state: S, ctx: RowModelContext<AnyRow>) => Uint32Array\n}\n\n/**\n * Defines a feature (§3.3). Identity at runtime; it exists for typing.\n *\n * Row-typed feature (all built-ins): declare the types interface and pass both type arguments.\n *\n * ```ts\n * interface SortingTypes extends FeatureTypes { state: SortState<this['T']>; api: SortApi<this['T']> }\n * export const sorting = (opts: SortingOptions = {}) =>\n *   defineFeature<'sorting', SortingTypes>({ name: 'sorting', stage: 'sort', ... })\n * ```\n *\n * Feature that does not depend on `T`: no type arguments, state and API are inferred.\n */\nexport function defineFeature<const Name extends string, S, A extends object>(\n  definition: FixedFeatureDefinition<Name, S, A>,\n): Feature<Name, FixedTypes<S, A>>\nexport function defineFeature<const Name extends string, F extends FeatureTypes>(\n  definition: Feature<Name, F>,\n): Feature<Name, F>\nexport function defineFeature(definition: Feature): Feature {\n  return definition\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA8B;AAC9B,0BAAkC;AAClC,mBAA6B;AAC7B,qBAA2C;AAC3C,mBAA8B;AAC9B,qBAA+B;AAY/B,8BAAe,YAAY;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAgCO,SAAS,cAAc,YAA8B;AAC1D,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/feature/define.ts"],"sourcesContent":["import { explainDetail } from '../diagnostics/explain-detail'\nimport { createColumnCache } from '../pipeline/column-cache'\nimport { createSlicer } from '../pipeline/slice'\nimport { initialSlices, installApis } from './install'\nimport { orderFeatures } from './order'\nimport { featureRuntime } from './runtime'\nimport type {\n  AnyRow,\n  Feature,\n  FeatureContext,\n  FeatureTypes,\n  FixedTypes,\n  RowModelContext,\n} from './types'\n\n// Features bring their runtime (§3.3, changed 2026-10-13 for §9.3): defineFeature installs it, so a\n// table without features never bundles it. It is installed by the CALL, not only by loading this\n// module: the package is `sideEffects`-free here, and a bundler that inlines an identity\n// defineFeature (esbuild --minify) then drops this module with its top-level statement (#5).\nconst runtime = {\n  orderFeatures,\n  initialSlices,\n  installApis,\n  createColumnCache,\n  createSlicer,\n  explainDetail,\n}\nfeatureRuntime.current ??= runtime\n\n/** A feature whose state `S` and API `A` do not depend on the row type (inferred). */\nexport interface FixedFeatureDefinition<Name extends string, S, A>\n  extends Omit<\n    Feature<Name, FixedTypes<S, A>>,\n    '_types' | 'initialState' | 'createApi' | 'rowModel'\n  > {\n  initialState: () => S\n  createApi: (ctx: FeatureContext<S>) => A\n  rowModel?: (indices: Uint32Array, state: S, ctx: RowModelContext<AnyRow>) => Uint32Array\n}\n\n/**\n * Defines a feature (§3.3). Returns `definition` as is (it exists for typing) and installs the\n * feature runtime.\n *\n * Row-typed feature (all built-ins): declare the types interface and pass both type arguments.\n *\n * ```ts\n * interface SortingTypes extends FeatureTypes { state: SortState<this['T']>; api: SortApi<this['T']> }\n * export const sorting = (opts: SortingOptions = {}) =>\n *   defineFeature<'sorting', SortingTypes>({ name: 'sorting', stage: 'sort', ... })\n * ```\n *\n * Feature that does not depend on `T`: no type arguments, state and API are inferred.\n */\nexport function defineFeature<const Name extends string, S, A extends object>(\n  definition: FixedFeatureDefinition<Name, S, A>,\n): Feature<Name, FixedTypes<S, A>>\nexport function defineFeature<const Name extends string, F extends FeatureTypes>(\n  definition: Feature<Name, F>,\n): Feature<Name, F>\nexport function defineFeature(definition: Feature): Feature {\n  featureRuntime.current ??= runtime\n  return definition\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA8B;AAC9B,0BAAkC;AAClC,mBAA6B;AAC7B,qBAA2C;AAC3C,mBAA8B;AAC9B,qBAA+B;AAc/B,IAAM,UAAU;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACA,8BAAe,YAAY;AAiCpB,SAAS,cAAc,YAA8B;AAC1D,gCAAe,YAAY;AAC3B,SAAO;AACT;","names":[]}

package/dist/feature/define.js

@@ -5,7 +5,7 @@ import { createSlicer } from "../pipeline/slice.js";
 import { initialSlices, installApis } from "./install.js";
 import { orderFeatures } from "./order.js";
 import { featureRuntime } from "./runtime.js";
-featureRuntime.current ??= {
+var runtime = {
   orderFeatures,
   initialSlices,
   installApis,
@@ -13,7 +13,9 @@ featureRuntime.current ??= {
   createSlicer,
   explainDetail
 };
+featureRuntime.current ??= runtime;
 function defineFeature(definition) {
+  featureRuntime.current ??= runtime;
   return definition;
 }
 export {

package/dist/feature/define.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/define.ts"],"sourcesContent":["import { explainDetail } from '../diagnostics/explain-detail'\nimport { createColumnCache } from '../pipeline/column-cache'\nimport { createSlicer } from '../pipeline/slice'\nimport { initialSlices, installApis } from './install'\nimport { orderFeatures } from './order'\nimport { featureRuntime } from './runtime'\nimport type {\n  AnyRow,\n  Feature,\n  FeatureContext,\n  FeatureTypes,\n  FixedTypes,\n  RowModelContext,\n} from './types'\n\n// Features bring their runtime (§3.3, changed 2026-10-13 for §9.3): loading defineFeature installs\n// it, so a table without features never bundles it.\nfeatureRuntime.current ??= {\n  orderFeatures,\n  initialSlices,\n  installApis,\n  createColumnCache,\n  createSlicer,\n  explainDetail,\n}\n\n/** A feature whose state `S` and API `A` do not depend on the row type (inferred). */\nexport interface FixedFeatureDefinition<Name extends string, S, A>\n  extends Omit<\n    Feature<Name, FixedTypes<S, A>>,\n    '_types' | 'initialState' | 'createApi' | 'rowModel'\n  > {\n  initialState: () => S\n  createApi: (ctx: FeatureContext<S>) => A\n  rowModel?: (indices: Uint32Array, state: S, ctx: RowModelContext<AnyRow>) => Uint32Array\n}\n\n/**\n * Defines a feature (§3.3). Identity at runtime; it exists for typing.\n *\n * Row-typed feature (all built-ins): declare the types interface and pass both type arguments.\n *\n * ```ts\n * interface SortingTypes extends FeatureTypes { state: SortState<this['T']>; api: SortApi<this['T']> }\n * export const sorting = (opts: SortingOptions = {}) =>\n *   defineFeature<'sorting', SortingTypes>({ name: 'sorting', stage: 'sort', ... })\n * ```\n *\n * Feature that does not depend on `T`: no type arguments, state and API are inferred.\n */\nexport function defineFeature<const Name extends string, S, A extends object>(\n  definition: FixedFeatureDefinition<Name, S, A>,\n): Feature<Name, FixedTypes<S, A>>\nexport function defineFeature<const Name extends string, F extends FeatureTypes>(\n  definition: Feature<Name, F>,\n): Feature<Name, F>\nexport function defineFeature(definition: Feature): Feature {\n  return definition\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,eAAe,mBAAmB;AAC3C,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAY/B,eAAe,YAAY;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAgCO,SAAS,cAAc,YAA8B;AAC1D,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/feature/define.ts"],"sourcesContent":["import { explainDetail } from '../diagnostics/explain-detail'\nimport { createColumnCache } from '../pipeline/column-cache'\nimport { createSlicer } from '../pipeline/slice'\nimport { initialSlices, installApis } from './install'\nimport { orderFeatures } from './order'\nimport { featureRuntime } from './runtime'\nimport type {\n  AnyRow,\n  Feature,\n  FeatureContext,\n  FeatureTypes,\n  FixedTypes,\n  RowModelContext,\n} from './types'\n\n// Features bring their runtime (§3.3, changed 2026-10-13 for §9.3): defineFeature installs it, so a\n// table without features never bundles it. It is installed by the CALL, not only by loading this\n// module: the package is `sideEffects`-free here, and a bundler that inlines an identity\n// defineFeature (esbuild --minify) then drops this module with its top-level statement (#5).\nconst runtime = {\n  orderFeatures,\n  initialSlices,\n  installApis,\n  createColumnCache,\n  createSlicer,\n  explainDetail,\n}\nfeatureRuntime.current ??= runtime\n\n/** A feature whose state `S` and API `A` do not depend on the row type (inferred). */\nexport interface FixedFeatureDefinition<Name extends string, S, A>\n  extends Omit<\n    Feature<Name, FixedTypes<S, A>>,\n    '_types' | 'initialState' | 'createApi' | 'rowModel'\n  > {\n  initialState: () => S\n  createApi: (ctx: FeatureContext<S>) => A\n  rowModel?: (indices: Uint32Array, state: S, ctx: RowModelContext<AnyRow>) => Uint32Array\n}\n\n/**\n * Defines a feature (§3.3). Returns `definition` as is (it exists for typing) and installs the\n * feature runtime.\n *\n * Row-typed feature (all built-ins): declare the types interface and pass both type arguments.\n *\n * ```ts\n * interface SortingTypes extends FeatureTypes { state: SortState<this['T']>; api: SortApi<this['T']> }\n * export const sorting = (opts: SortingOptions = {}) =>\n *   defineFeature<'sorting', SortingTypes>({ name: 'sorting', stage: 'sort', ... })\n * ```\n *\n * Feature that does not depend on `T`: no type arguments, state and API are inferred.\n */\nexport function defineFeature<const Name extends string, S, A extends object>(\n  definition: FixedFeatureDefinition<Name, S, A>,\n): Feature<Name, FixedTypes<S, A>>\nexport function defineFeature<const Name extends string, F extends FeatureTypes>(\n  definition: Feature<Name, F>,\n): Feature<Name, F>\nexport function defineFeature(definition: Feature): Feature {\n  featureRuntime.current ??= runtime\n  return definition\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,eAAe,mBAAmB;AAC3C,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAc/B,IAAM,UAAU;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACA,eAAe,YAAY;AAiCpB,SAAS,cAAc,YAA8B;AAC1D,iBAAe,YAAY;AAC3B,SAAO;AACT;","names":[]}

package/dist/feature/install.cjs

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

package/dist/feature/install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/install.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport { errorName } from '../intercept/classify'\nimport type { Table, TableState } from '../table/types'\nimport { featureDiagnostics } from './codes'\nimport type { AnyFeature, FeatureContext, SliceUpdater } from './types'\n\nkeepDiagnostics(featureDiagnostics)\n\n/** What `createTable` gives the installer: the store operations a feature context needs. */\nexport interface FeatureHost {\n  readonly table: Table<unknown, TableState>\n  /** The table name, for config errors thrown before the first emit. */\n  readonly tableName: string\n  readonly emit: Emit\n  getSlice(name: string): unknown\n  /** `state:dispatch` of one slice (where = the feature name); notifies unless inside an API call. */\n  setSlice(name: string, updater: SliceUpdater<unknown>): void\n  /**\n   * Runs an API method: no-op + `DK_TABLE_DESTROYED` after destroy (returning `destroyed?.()`),\n   * trigger `api:<method>`, listeners notified once when the outermost call returns.\n   */\n  call(method: string, fn: () => unknown, destroyed?: () => unknown): unknown\n}\n\nfunction reportFailure(\n  emit: Emit,\n  feature: string,\n  hook: 'initialState' | 'createApi',\n  fallback: string,\n  e: unknown,\n) {\n  const name = errorName(e)\n  emit(\n    'DK_FEATURE_FAILED',\n    { feature, hook, fallback, ...(name === undefined ? {} : { errorName: name }) },\n    { cause: e },\n  )\n}\n\n/**\n * The starting snapshot: each feature's `initialState()` under its name, then `given`\n * (`options.initialState`) per slice on top. `initialState()` is not called for a given slice.\n */\nexport function initialSlices(\n  features: readonly AnyFeature[],\n  given: object | undefined,\n  emit: Emit,\n): TableState {\n  const out: TableState = {}\n  for (const f of features) {\n    if (given && Object.hasOwn(given, f.name)) continue\n    try {\n      out[f.name] = f.initialState()\n    } catch (e) {\n      out[f.name] = undefined\n      reportFailure(emit, f.name, 'initialState', 'the slice starts as undefined', e)\n    }\n  }\n  return given ? Object.assign(out, given) : out\n}\n\n/**\n * Creates every feature API (in the order the features were listed) and merges it onto the table.\n * Throws `DatakableConfigError` `DK_FEATURE_API_CONFLICT` when a member name is already taken by a\n * core table method or by an earlier feature. Methods are wrapped once here (cold path).\n */\nexport function installApis(features: readonly AnyFeature[], host: FeatureHost): void {\n  const target = host.table as unknown as Record<string, unknown>\n  const owners = new Map<string, string | null>()\n  for (const k of Object.keys(target)) owners.set(k, null)\n  /** Features whose `createApi()` threw: their methods are missing from the table. */\n  const failed: string[] = []\n\n  for (const f of features) {\n    const name = f.name\n    const ctx: FeatureContext<unknown> = {\n      name,\n      getState: () => host.getSlice(name),\n      setState: (updater) => host.setSlice(name, updater),\n      table: host.table,\n      emit: host.emit,\n    }\n    let api: unknown\n    try {\n      api = f.createApi(ctx)\n    } catch (e) {\n      reportFailure(host.emit, name, 'createApi', 'its API was not installed', e)\n      failed.push(name)\n      continue\n    }\n    if (api === null || typeof api !== 'object') continue\n    const members = api as Record<string, unknown>\n    const keys = Object.keys(members)\n    for (const method of keys) {\n      if (owners.has(method)) {\n        throwConfigError(\n          'DK_FEATURE_API_CONFLICT',\n          { method, feature: name, owner: owners.get(method) ?? null },\n          { table: host.tableName },\n        )\n      }\n    }\n    for (const method of keys) {\n      owners.set(method, name)\n      const member = members[method]\n      const destroyed = f.destroyedResult?.[method]\n      target[method] =\n        typeof member === 'function'\n          ? (...args: unknown[]) => host.call(method, () => member.apply(members, args), destroyed)\n          : member\n    }\n  }\n  if ((process.env.NODE_ENV !== \"production\") && failed.length > 0) Object.setPrototypeOf(target, missingApi(failed, host))\n}\n\n/**\n * Names generic code probes on any object (await, JSON, React, test runners, inspectors): never a\n * feature method, so never stubbed.\n */\nconst PROBES = new Set([\n  'then',\n  'catch',\n  'finally',\n  'toJSON',\n  'asymmetricMatch',\n  'nodeType',\n  'tagName',\n])\nconst isProbe = (k: string) => PROBES.has(k) || /^[_$@]/.test(k)\n\n/**\n * Dev (R4): the prototype of a table where a feature's `createApi()` threw. The types still promise\n * that feature's methods, so a call to a name the table does not have is a no-op that reports\n * `DK_FEATURE_FAILED` (with the method) instead of a raw TypeError at the caller. Only reads of\n * missing names reach it: the table keeps its identity and own members, `in` / `hasOwn` stay\n * false, and `Object.prototype` members, symbols and generic probes (`then`, `toJSON`, …) resolve\n * as usual.\n */\nfunction missingApi(failed: readonly string[], host: FeatureHost): object {\n  const feature = failed.join(', ')\n  const stubs = new Map<string, () => undefined>()\n  return new Proxy(Object.prototype, {\n    get(proto, key, receiver) {\n      if (typeof key !== 'string' || key in proto || isProbe(key)) {\n        return Reflect.get(proto, key, receiver)\n      }\n      let stub = stubs.get(key)\n      if (!stub) {\n        stub = () => {\n          host.call(key, () =>\n            host.emit('DK_FEATURE_FAILED', {\n              feature,\n              hook: 'createApi',\n              method: key,\n              fallback: `table.${key}() did nothing (the API of ${failed.length === 1 ? 'that feature' : 'those features'} was not installed)`,\n            }),\n          )\n          return undefined\n        }\n        stubs.set(key, stub)\n      }\n      return stub\n    },\n  })\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/feature/install.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Emit } from '../diagnostics/types'\nimport { errorName } from '../intercept/classify'\nimport type { Table, TableState } from '../table/types'\nimport { featureDiagnostics } from './codes'\nimport type { AnyFeature, FeatureContext, SliceUpdater } from './types'\n\nkeepDiagnostics(featureDiagnostics)\n\n/** What `createTable` gives the installer: the store operations a feature context needs. */\nexport interface FeatureHost {\n  readonly table: Table<unknown, TableState>\n  /** The table name, for config errors thrown before the first emit. */\n  readonly tableName: string\n  readonly emit: Emit\n  getSlice(name: string): unknown\n  /** `state:dispatch` of one slice (where = the feature name); notifies unless inside an API call. */\n  setSlice(name: string, updater: SliceUpdater<unknown>): void\n  /**\n   * Runs an API method: no-op + `DK_TABLE_DESTROYED` after destroy (returning `destroyed?.()`),\n   * trigger `api:<method>`, listeners notified once when the outermost call returns.\n   */\n  call(method: string, fn: () => unknown, destroyed?: () => unknown): unknown\n}\n\nfunction reportFailure(\n  emit: Emit,\n  feature: string,\n  hook: 'initialState' | 'createApi',\n  fallback: string,\n  e: unknown,\n) {\n  const name = errorName(e)\n  emit(\n    'DK_FEATURE_FAILED',\n    { feature, hook, fallback, ...(name === undefined ? {} : { errorName: name }) },\n    { cause: e },\n  )\n}\n\n/**\n * The starting snapshot: each feature's `initialState()` under its name, then `given`\n * (`options.initialState`) per slice on top. `initialState()` is not called for a given slice.\n */\nexport function initialSlices(\n  features: readonly AnyFeature[],\n  given: object | undefined,\n  emit: Emit,\n): TableState {\n  const out: TableState = {}\n  for (const f of features) {\n    if (given && Object.hasOwn(given, f.name)) continue\n    try {\n      out[f.name] = f.initialState()\n    } catch (e) {\n      out[f.name] = undefined\n      reportFailure(emit, f.name, 'initialState', 'slice-undefined', e)\n    }\n  }\n  return given ? Object.assign(out, given) : out\n}\n\n/**\n * Creates every feature API (in the order the features were listed) and merges it onto the table.\n * Throws `DatakableConfigError` `DK_FEATURE_API_CONFLICT` when a member name is already taken by a\n * core table method or by an earlier feature. Methods are wrapped once here (cold path).\n */\nexport function installApis(features: readonly AnyFeature[], host: FeatureHost): void {\n  const target = host.table as unknown as Record<string, unknown>\n  const owners = new Map<string, string | null>()\n  for (const k of Object.keys(target)) owners.set(k, null)\n  /** Features whose `createApi()` threw: their methods are missing from the table. */\n  const failed: string[] = []\n\n  for (const f of features) {\n    const name = f.name\n    const ctx: FeatureContext<unknown> = {\n      name,\n      getState: () => host.getSlice(name),\n      setState: (updater) => host.setSlice(name, updater),\n      table: host.table,\n      emit: host.emit,\n    }\n    let api: unknown\n    try {\n      api = f.createApi(ctx)\n    } catch (e) {\n      reportFailure(host.emit, name, 'createApi', 'api-not-installed', e)\n      failed.push(name)\n      continue\n    }\n    if (api === null || typeof api !== 'object') continue\n    const members = api as Record<string, unknown>\n    const keys = Object.keys(members)\n    for (const method of keys) {\n      if (owners.has(method)) {\n        throwConfigError(\n          'DK_FEATURE_API_CONFLICT',\n          { method, feature: name, owner: owners.get(method) ?? null },\n          { table: host.tableName },\n        )\n      }\n    }\n    for (const method of keys) {\n      owners.set(method, name)\n      const member = members[method]\n      const destroyed = f.destroyedResult?.[method]\n      target[method] =\n        typeof member === 'function'\n          ? (...args: unknown[]) => host.call(method, () => member.apply(members, args), destroyed)\n          : member\n    }\n  }\n  if ((process.env.NODE_ENV !== \"production\") && failed.length > 0) Object.setPrototypeOf(target, missingApi(failed, host))\n}\n\n/**\n * Names generic code probes on any object (await, JSON, React, test runners, inspectors): never a\n * feature method, so never stubbed.\n */\nconst PROBES = new Set([\n  'then',\n  'catch',\n  'finally',\n  'toJSON',\n  'asymmetricMatch',\n  'nodeType',\n  'tagName',\n])\nconst isProbe = (k: string) => PROBES.has(k) || /^[_$@]/.test(k)\n\n/**\n * Dev (R4): the prototype of a table where a feature's `createApi()` threw. The types still promise\n * that feature's methods, so a call to a name the table does not have is a no-op that reports\n * `DK_FEATURE_FAILED` (with the method) instead of a raw TypeError at the caller. Only reads of\n * missing names reach it: the table keeps its identity and own members, `in` / `hasOwn` stay\n * false, and `Object.prototype` members, symbols and generic probes (`then`, `toJSON`, …) resolve\n * as usual.\n */\nfunction missingApi(failed: readonly string[], host: FeatureHost): object {\n  const feature = failed.join(', ')\n  const stubs = new Map<string, () => undefined>()\n  return new Proxy(Object.prototype, {\n    get(proto, key, receiver) {\n      if (typeof key !== 'string' || key in proto || isProbe(key)) {\n        return Reflect.get(proto, key, receiver)\n      }\n      let stub = stubs.get(key)\n      if (!stub) {\n        stub = () => {\n          host.call(key, () =>\n            host.emit('DK_FEATURE_FAILED', {\n              feature,\n              hook: 'createApi',\n              method: key,\n              fallback: `${failed.length === 1 ? 'api' : 'apis'}-missing|${key}`,\n            }),\n          )\n          return undefined\n        }\n        stubs.set(key, stub)\n      }\n      return stub\n    },\n  })\n}\n"],"mappings":"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","names":[]}

package/dist/feature/install.js

@@ -1,6 +1,7 @@
 // src/feature/install.ts
 import { throwConfigError } from "../diagnostics/build.js";
 import { keepDiagnostics } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 import { errorName } from "../intercept/classify.js";
 import { featureDiagnostics } from "./codes.js";
 keepDiagnostics(featureDiagnostics);
@@ -20,7 +21,7 @@ function initialSlices(features, given, emit) {
       out[f.name] = f.initialState();
     } catch (e) {
       out[f.name] = void 0;
-      reportFailure(emit, f.name, "initialState", "the slice starts as undefined", e);
+      reportFailure(emit, f.name, "initialState", "slice-undefined", e);
     }
   }
   return given ? Object.assign(out, given) : out;
@@ -43,7 +44,7 @@ function installApis(features, host) {
     try {
       api = f.createApi(ctx);
     } catch (e) {
-      reportFailure(host.emit, name, "createApi", "its API was not installed", e);
+      reportFailure(host.emit, name, "createApi", "api-not-installed", e);
       failed.push(name);
       continue;
     }
@@ -95,7 +96,7 @@ function missingApi(failed, host) {
               feature,
               hook: "createApi",
               method: key,
-              fallback: `table.${key}() did nothing (the API of ${failed.length === 1 ? "that feature" : "those features"} was not installed)`
+              fallback: `${failed.length === 1 ? "api" : "apis"}-missing|${key}`
             })
           );
           return void 0;

package/dist/feature/install.js.map

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

package/dist/feature/runtime.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/runtime.ts"],"sourcesContent":["import type { explainDetail } from '../diagnostics/explain-detail'\nimport type { createColumnCache } from '../pipeline/column-cache'\nimport type { createSlicer } from '../pipeline/slice'\nimport type { initialSlices, installApis } from './install'\nimport type { orderFeatures } from './order'\n\n/**\n * What features bring to the table they are installed in (§3.3, changed 2026-10-13 for §9.3): the\n * stage ordering and API install, the column cache and time-slicing of the pipeline steps, and the\n * step details of `explainRow`. `defineFeature` (every built-in feature uses it) loads it, so a\n * table without features does not bundle it.\n */\nexport interface FeatureRuntime {\n  readonly orderFeatures: typeof orderFeatures\n  readonly initialSlices: typeof initialSlices\n  readonly installApis: typeof installApis\n  readonly createColumnCache: typeof createColumnCache\n  readonly createSlicer: typeof createSlicer\n  readonly explainDetail: typeof explainDetail\n}\n\n/** Set when `feature/define.ts` is loaded (the same module-scoped registry as the catalogs). */\nexport const featureRuntime: { current?: FeatureRuntime | undefined } = {}\n\n/** The runtime for `features`: `undefined` without features; throws when none was loaded. */\nexport function runtimeFor(features: readonly unknown[]): FeatureRuntime | undefined {\n  if (features.length === 0) return undefined\n  const rt = featureRuntime.current\n  if (!rt) {\n    throw new TypeError(\n      '[DataKable] options.features is set but no feature runtime is loaded: create features with ' +\n        \"defineFeature() from '@datakable/core' (every built-in feature does)\",\n    )\n  }\n  return rt\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,IAAM,iBAA2D,CAAC;AAGlE,SAAS,WAAW,UAA0D;AACnF,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAM,KAAK,eAAe;AAC1B,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/feature/runtime.ts"],"sourcesContent":["import type { explainDetail } from '../diagnostics/explain-detail'\nimport type { createColumnCache } from '../pipeline/column-cache'\nimport type { createSlicer } from '../pipeline/slice'\nimport type { initialSlices, installApis } from './install'\nimport type { orderFeatures } from './order'\n\n/**\n * What features bring to the table they are installed in (§3.3, changed 2026-10-13 for §9.3): the\n * stage ordering and API install, the column cache and time-slicing of the pipeline steps, and the\n * step details of `explainRow`. Calling `defineFeature` (every built-in feature does) installs it,\n * so a table without features does not bundle it.\n */\nexport interface FeatureRuntime {\n  readonly orderFeatures: typeof orderFeatures\n  readonly initialSlices: typeof initialSlices\n  readonly installApis: typeof installApis\n  readonly createColumnCache: typeof createColumnCache\n  readonly createSlicer: typeof createSlicer\n  readonly explainDetail: typeof explainDetail\n}\n\n/** Set by `defineFeature` and when `feature/define.ts` loads (module-scoped, as the catalogs). */\nexport const featureRuntime: { current?: FeatureRuntime | undefined } = {}\n\n/** The runtime for `features`: `undefined` without features; throws when none was loaded. */\nexport function runtimeFor(features: readonly unknown[]): FeatureRuntime | undefined {\n  if (features.length === 0) return undefined\n  const rt = featureRuntime.current\n  if (!rt) {\n    throw new TypeError(\n      '[DataKable] options.features is set but no feature runtime is loaded: create features with ' +\n        \"defineFeature() from '@datakable/core' (every built-in feature does)\",\n    )\n  }\n  return rt\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,IAAM,iBAA2D,CAAC;AAGlE,SAAS,WAAW,UAA0D;AACnF,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAM,KAAK,eAAe;AAC1B,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/feature/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feature/runtime.ts"],"sourcesContent":["import type { explainDetail } from '../diagnostics/explain-detail'\nimport type { createColumnCache } from '../pipeline/column-cache'\nimport type { createSlicer } from '../pipeline/slice'\nimport type { initialSlices, installApis } from './install'\nimport type { orderFeatures } from './order'\n\n/**\n * What features bring to the table they are installed in (§3.3, changed 2026-10-13 for §9.3): the\n * stage ordering and API install, the column cache and time-slicing of the pipeline steps, and the\n * step details of `explainRow`. `defineFeature` (every built-in feature uses it) loads it, so a\n * table without features does not bundle it.\n */\nexport interface FeatureRuntime {\n  readonly orderFeatures: typeof orderFeatures\n  readonly initialSlices: typeof initialSlices\n  readonly installApis: typeof installApis\n  readonly createColumnCache: typeof createColumnCache\n  readonly createSlicer: typeof createSlicer\n  readonly explainDetail: typeof explainDetail\n}\n\n/** Set when `feature/define.ts` is loaded (the same module-scoped registry as the catalogs). */\nexport const featureRuntime: { current?: FeatureRuntime | undefined } = {}\n\n/** The runtime for `features`: `undefined` without features; throws when none was loaded. */\nexport function runtimeFor(features: readonly unknown[]): FeatureRuntime | undefined {\n  if (features.length === 0) return undefined\n  const rt = featureRuntime.current\n  if (!rt) {\n    throw new TypeError(\n      '[DataKable] options.features is set but no feature runtime is loaded: create features with ' +\n        \"defineFeature() from '@datakable/core' (every built-in feature does)\",\n    )\n  }\n  return rt\n}\n"],"mappings":";AAsBO,IAAM,iBAA2D,CAAC;AAGlE,SAAS,WAAW,UAA0D;AACnF,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAM,KAAK,eAAe;AAC1B,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/feature/runtime.ts"],"sourcesContent":["import type { explainDetail } from '../diagnostics/explain-detail'\nimport type { createColumnCache } from '../pipeline/column-cache'\nimport type { createSlicer } from '../pipeline/slice'\nimport type { initialSlices, installApis } from './install'\nimport type { orderFeatures } from './order'\n\n/**\n * What features bring to the table they are installed in (§3.3, changed 2026-10-13 for §9.3): the\n * stage ordering and API install, the column cache and time-slicing of the pipeline steps, and the\n * step details of `explainRow`. Calling `defineFeature` (every built-in feature does) installs it,\n * so a table without features does not bundle it.\n */\nexport interface FeatureRuntime {\n  readonly orderFeatures: typeof orderFeatures\n  readonly initialSlices: typeof initialSlices\n  readonly installApis: typeof installApis\n  readonly createColumnCache: typeof createColumnCache\n  readonly createSlicer: typeof createSlicer\n  readonly explainDetail: typeof explainDetail\n}\n\n/** Set by `defineFeature` and when `feature/define.ts` loads (module-scoped, as the catalogs). */\nexport const featureRuntime: { current?: FeatureRuntime | undefined } = {}\n\n/** The runtime for `features`: `undefined` without features; throws when none was loaded. */\nexport function runtimeFor(features: readonly unknown[]): FeatureRuntime | undefined {\n  if (features.length === 0) return undefined\n  const rt = featureRuntime.current\n  if (!rt) {\n    throw new TypeError(\n      '[DataKable] options.features is set but no feature runtime is loaded: create features with ' +\n        \"defineFeature() from '@datakable/core' (every built-in feature does)\",\n    )\n  }\n  return rt\n}\n"],"mappings":";AAsBO,IAAM,iBAA2D,CAAC;AAGlE,SAAS,WAAW,UAA0D;AACnF,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAM,KAAK,eAAe;AAC1B,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/features/column-filters/codes.cjs

@@ -27,6 +27,7 @@ __export(codes_exports, {
 module.exports = __toCommonJS(codes_exports);
 var import_suggest = require("../../catalog/suggest.cjs");
 var import_catalog = require("../../diagnostics/catalog.cjs");
+var import_process_guard = require("../../diagnostics/process-guard.cjs");
 var FILTER_KINDS = ["equals", "contains", "in", "range", "custom"];
 var rowList = (rows, count) => {
   if (rows.length === 0) return "";

package/dist/features/column-filters/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/codes.ts"],"sourcesContent":["import { suggest } from '../../catalog/suggest'\nimport { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FILTER_TYPE_MISMATCH: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in `options.columns`. */\n      index: number\n      /** The filter kind (`type`) as given, e.g. `contains`. */\n      filter: string\n      /** `cell`: cell values of the wrong type; `filter`: the filter value itself is malformed. */\n      source: 'cell' | 'filter'\n      /** What the filter accepts, e.g. `string`, `number | bigint`, `Date`, `array`. */\n      expected: string\n      /** The type of the first offending value (`string`, `number`, `Date`, `array`, …). */\n      received: string\n      /** Cells of the wrong type (0 for `source: 'filter'`). */\n      count: number\n      /** A sample of their row indices (first few, in order). */\n      rows: readonly number[]\n    }\n    DK_STATE_UNKNOWN_KEY: {\n      /** The state slice holding the key, e.g. `columnFilters`. */\n      slice: string\n      /** The key that names no column. */\n      key: string\n      /** The table's column ids (did-you-mean). */\n      known: readonly string[]\n    }\n  }\n}\n\n/** The filter kinds of §6.1. */\nexport const FILTER_KINDS = ['equals', 'contains', 'in', 'range', 'custom'] as const\n\nconst rowList = (rows: readonly number[], count: number) => {\n  if (rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return count > rows.length ? ` (first: ${list}, …)` : ` (rows ${list})`\n}\n\nconst plural = (n: number, one: string, many: string) => (n === 1 ? `1 ${one}` : `${n} ${many}`)\n\n/** A conversion from `received` to `expected`, as code, when one is obvious. */\nfunction convert(expected: string, received: string): string | undefined {\n  if (expected.includes('number') && received === 'string') return 'Number(x)'\n  if (expected === 'string' && (received === 'number' || received === 'bigint')) return 'String(x)'\n  if (expected === 'Date' && (received === 'string' || received === 'number')) return 'new Date(x)'\n  return undefined\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const columnFiltersMessages: DiagnosticMessages<\n  'DK_FILTER_TYPE_MISMATCH' | 'DK_STATE_UNKNOWN_KEY'\n> = {\n  DK_STATE_UNKNOWN_KEY: {\n    problem: (d) => `state.${d.slice} has an entry for \"${d.key}\", which is not a column`,\n    impact: () =>\n      'the entry is ignored (the other entries still apply); it may come from an older URL or ' +\n      'saved state, or the column was renamed or removed',\n    fix: (d) => {\n      const near = suggest(d.key, d.known)\n      return [\n        near.length > 0\n          ? `did you mean \"${near[0]}\"? (state.${d.slice}[\"${near[0]}\"])`\n          : `use one of the column ids: ${d.known.map((k) => `\"${k}\"`).join(', ')}`,\n        `drop \"${d.key}\" when parsing initialState / state (e.g. from the URL), or add the column`,\n      ]\n    },\n  },\n  DK_FILTER_TYPE_MISMATCH: {\n    problem: (d) =>\n      d.source === 'filter'\n        ? `the \"${d.filter}\" filter on column \"${d.column}\" has a value of type ${d.received}; ` +\n          `it expects ${d.expected}`\n        : `the \"${d.filter}\" filter on column \"${d.column}\" compares ${d.expected} values, but ` +\n          `${plural(d.count, 'cell holds', 'cells hold')} another type (first: ` +\n          `${d.received})${rowList(d.rows, d.count)}`,\n    impact: (d) =>\n      d.source === 'filter'\n        ? 'the filter matches no rows until its value is fixed'\n        : 'those rows are treated as non-matching; the other rows are filtered normally',\n    fix: (d) => {\n      const at = `state.columnFilters[\"${d.column}\"]`\n      if (d.source === 'filter') {\n        if (!(FILTER_KINDS as readonly string[]).includes(d.filter)) {\n          const near = suggest(d.filter, FILTER_KINDS)\n          return [\n            near.length > 0\n              ? `did you mean type: '${near[0]}'? (${at})`\n              : `use one of the filter kinds ${FILTER_KINDS.join(', ')} in ${at}`,\n          ]\n        }\n        return [\n          `give ${at} a value of type ${d.expected}: { type: '${d.filter}', value: … }`,\n          'remove the filter (setColumnFilter(id, undefined)) while there is no value',\n        ]\n      }\n      const out: string[] = []\n      const c = convert(d.expected, d.received)\n      if (c) {\n        out.push(\n          `if the filter value is the wrong type, convert it before setting it: ${c.replace('x', 'input')}`,\n          `if the data is the wrong type, normalise the column: ` +\n            `{ id: '${d.column}', accessor: (row) => ${c.replace('x', 'row.<field>')} } ` +\n            `(columns[${d.index}])`,\n        )\n      } else {\n        out.push(\n          `normalise the column so every cell is ${d.expected}: an accessor on columns[${d.index}]`,\n        )\n      }\n      out.push(\n        `or filter with a kind that fits ${d.received} cells, or a custom filter: ` +\n          `{ type: 'custom', value, fn: (cell, value, row) => boolean }`,\n      )\n      return out\n    },\n  },\n}\n\n/** Codes owned by the `columnFilters` feature (§6.1, §8.3). */\nexport const columnFiltersDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FILTER_TYPE_MISMATCH',\n      level: 'warn',\n      where: (d) => ({ kind: 'column', index: d.index, id: d.column }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_FILTER_TYPE_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_STATE_UNKNOWN_KEY',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slice}.${d.key}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_STATE_UNKNOWN_KEY,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/features/column-filters/codes.ts"],"sourcesContent":["import { suggest } from '../../catalog/suggest'\nimport { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FILTER_TYPE_MISMATCH: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in `options.columns`. */\n      index: number\n      /** The filter kind (`type`) as given, e.g. `contains`. */\n      filter: string\n      /** `cell`: cell values of the wrong type; `filter`: the filter value itself is malformed. */\n      source: 'cell' | 'filter'\n      /** What the filter accepts, e.g. `string`, `number | bigint`, `Date`, `array`. */\n      expected: string\n      /** The type of the first offending value (`string`, `number`, `Date`, `array`, …). */\n      received: string\n      /** Cells of the wrong type (0 for `source: 'filter'`). */\n      count: number\n      /** A sample of their row indices (first few, in order). */\n      rows: readonly number[]\n    }\n    DK_STATE_UNKNOWN_KEY: {\n      /** The state slice holding the key, e.g. `columnFilters`. */\n      slice: string\n      /** The key that names no column. */\n      key: string\n      /** The table's column ids (did-you-mean). */\n      known: readonly string[]\n    }\n  }\n}\n\n/** The filter kinds of §6.1. */\nexport const FILTER_KINDS = ['equals', 'contains', 'in', 'range', 'custom'] as const\n\nconst rowList = (rows: readonly number[], count: number) => {\n  if (rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return count > rows.length ? ` (first: ${list}, …)` : ` (rows ${list})`\n}\n\nconst plural = (n: number, one: string, many: string) => (n === 1 ? `1 ${one}` : `${n} ${many}`)\n\n/** A conversion from `received` to `expected`, as code, when one is obvious. */\nfunction convert(expected: string, received: string): string | undefined {\n  if (expected.includes('number') && received === 'string') return 'Number(x)'\n  if (expected === 'string' && (received === 'number' || received === 'bigint')) return 'String(x)'\n  if (expected === 'Date' && (received === 'string' || received === 'number')) return 'new Date(x)'\n  return undefined\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const columnFiltersMessages: DiagnosticMessages<\n  'DK_FILTER_TYPE_MISMATCH' | 'DK_STATE_UNKNOWN_KEY'\n> = {\n  DK_STATE_UNKNOWN_KEY: {\n    problem: (d) => `state.${d.slice} has an entry for \"${d.key}\", which is not a column`,\n    impact: () =>\n      'the entry is ignored (the other entries still apply); it may come from an older URL or ' +\n      'saved state, or the column was renamed or removed',\n    fix: (d) => {\n      const near = suggest(d.key, d.known)\n      return [\n        near.length > 0\n          ? `did you mean \"${near[0]}\"? (state.${d.slice}[\"${near[0]}\"])`\n          : `use one of the column ids: ${d.known.map((k) => `\"${k}\"`).join(', ')}`,\n        `drop \"${d.key}\" when parsing initialState / state (e.g. from the URL), or add the column`,\n      ]\n    },\n  },\n  DK_FILTER_TYPE_MISMATCH: {\n    problem: (d) =>\n      d.source === 'filter'\n        ? `the \"${d.filter}\" filter on column \"${d.column}\" has a value of type ${d.received}; ` +\n          `it expects ${d.expected}`\n        : `the \"${d.filter}\" filter on column \"${d.column}\" compares ${d.expected} values, but ` +\n          `${plural(d.count, 'cell holds', 'cells hold')} another type (first: ` +\n          `${d.received})${rowList(d.rows, d.count)}`,\n    impact: (d) =>\n      d.source === 'filter'\n        ? 'the filter matches no rows until its value is fixed'\n        : 'those rows are treated as non-matching; the other rows are filtered normally',\n    fix: (d) => {\n      const at = `state.columnFilters[\"${d.column}\"]`\n      if (d.source === 'filter') {\n        if (!(FILTER_KINDS as readonly string[]).includes(d.filter)) {\n          const near = suggest(d.filter, FILTER_KINDS)\n          return [\n            near.length > 0\n              ? `did you mean type: '${near[0]}'? (${at})`\n              : `use one of the filter kinds ${FILTER_KINDS.join(', ')} in ${at}`,\n          ]\n        }\n        return [\n          `give ${at} a value of type ${d.expected}: { type: '${d.filter}', value: … }`,\n          'remove the filter (setColumnFilter(id, undefined)) while there is no value',\n        ]\n      }\n      const out: string[] = []\n      const c = convert(d.expected, d.received)\n      if (c) {\n        out.push(\n          `if the filter value is the wrong type, convert it before setting it: ${c.replace('x', 'input')}`,\n          `if the data is the wrong type, normalise the column: ` +\n            `{ id: '${d.column}', accessor: (row) => ${c.replace('x', 'row.<field>')} } ` +\n            `(columns[${d.index}])`,\n        )\n      } else {\n        out.push(\n          `normalise the column so every cell is ${d.expected}: an accessor on columns[${d.index}]`,\n        )\n      }\n      out.push(\n        `or filter with a kind that fits ${d.received} cells, or a custom filter: ` +\n          `{ type: 'custom', value, fn: (cell, value, row) => boolean }`,\n      )\n      return out\n    },\n  },\n}\n\n/** Codes owned by the `columnFilters` feature (§6.1, §8.3). */\nexport const columnFiltersDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FILTER_TYPE_MISMATCH',\n      level: 'warn',\n      where: (d) => ({ kind: 'column', index: d.index, id: d.column }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_FILTER_TYPE_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_STATE_UNKNOWN_KEY',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slice}.${d.key}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_STATE_UNKNOWN_KEY,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/features/column-filters/codes.js

@@ -1,6 +1,7 @@
 // src/features/column-filters/codes.ts
 import { suggest } from "../../catalog/suggest.js";
 import { defineDiagnostic } from "../../diagnostics/catalog.js";
+import "../../diagnostics/process-guard.js";
 var FILTER_KINDS = ["equals", "contains", "in", "range", "custom"];
 var rowList = (rows, count) => {
   if (rows.length === 0) return "";

package/dist/features/column-filters/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/features/column-filters/codes.ts"],"sourcesContent":["import { suggest } from '../../catalog/suggest'\nimport { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FILTER_TYPE_MISMATCH: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in `options.columns`. */\n      index: number\n      /** The filter kind (`type`) as given, e.g. `contains`. */\n      filter: string\n      /** `cell`: cell values of the wrong type; `filter`: the filter value itself is malformed. */\n      source: 'cell' | 'filter'\n      /** What the filter accepts, e.g. `string`, `number | bigint`, `Date`, `array`. */\n      expected: string\n      /** The type of the first offending value (`string`, `number`, `Date`, `array`, …). */\n      received: string\n      /** Cells of the wrong type (0 for `source: 'filter'`). */\n      count: number\n      /** A sample of their row indices (first few, in order). */\n      rows: readonly number[]\n    }\n    DK_STATE_UNKNOWN_KEY: {\n      /** The state slice holding the key, e.g. `columnFilters`. */\n      slice: string\n      /** The key that names no column. */\n      key: string\n      /** The table's column ids (did-you-mean). */\n      known: readonly string[]\n    }\n  }\n}\n\n/** The filter kinds of §6.1. */\nexport const FILTER_KINDS = ['equals', 'contains', 'in', 'range', 'custom'] as const\n\nconst rowList = (rows: readonly number[], count: number) => {\n  if (rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return count > rows.length ? ` (first: ${list}, …)` : ` (rows ${list})`\n}\n\nconst plural = (n: number, one: string, many: string) => (n === 1 ? `1 ${one}` : `${n} ${many}`)\n\n/** A conversion from `received` to `expected`, as code, when one is obvious. */\nfunction convert(expected: string, received: string): string | undefined {\n  if (expected.includes('number') && received === 'string') return 'Number(x)'\n  if (expected === 'string' && (received === 'number' || received === 'bigint')) return 'String(x)'\n  if (expected === 'Date' && (received === 'string' || received === 'number')) return 'new Date(x)'\n  return undefined\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const columnFiltersMessages: DiagnosticMessages<\n  'DK_FILTER_TYPE_MISMATCH' | 'DK_STATE_UNKNOWN_KEY'\n> = {\n  DK_STATE_UNKNOWN_KEY: {\n    problem: (d) => `state.${d.slice} has an entry for \"${d.key}\", which is not a column`,\n    impact: () =>\n      'the entry is ignored (the other entries still apply); it may come from an older URL or ' +\n      'saved state, or the column was renamed or removed',\n    fix: (d) => {\n      const near = suggest(d.key, d.known)\n      return [\n        near.length > 0\n          ? `did you mean \"${near[0]}\"? (state.${d.slice}[\"${near[0]}\"])`\n          : `use one of the column ids: ${d.known.map((k) => `\"${k}\"`).join(', ')}`,\n        `drop \"${d.key}\" when parsing initialState / state (e.g. from the URL), or add the column`,\n      ]\n    },\n  },\n  DK_FILTER_TYPE_MISMATCH: {\n    problem: (d) =>\n      d.source === 'filter'\n        ? `the \"${d.filter}\" filter on column \"${d.column}\" has a value of type ${d.received}; ` +\n          `it expects ${d.expected}`\n        : `the \"${d.filter}\" filter on column \"${d.column}\" compares ${d.expected} values, but ` +\n          `${plural(d.count, 'cell holds', 'cells hold')} another type (first: ` +\n          `${d.received})${rowList(d.rows, d.count)}`,\n    impact: (d) =>\n      d.source === 'filter'\n        ? 'the filter matches no rows until its value is fixed'\n        : 'those rows are treated as non-matching; the other rows are filtered normally',\n    fix: (d) => {\n      const at = `state.columnFilters[\"${d.column}\"]`\n      if (d.source === 'filter') {\n        if (!(FILTER_KINDS as readonly string[]).includes(d.filter)) {\n          const near = suggest(d.filter, FILTER_KINDS)\n          return [\n            near.length > 0\n              ? `did you mean type: '${near[0]}'? (${at})`\n              : `use one of the filter kinds ${FILTER_KINDS.join(', ')} in ${at}`,\n          ]\n        }\n        return [\n          `give ${at} a value of type ${d.expected}: { type: '${d.filter}', value: … }`,\n          'remove the filter (setColumnFilter(id, undefined)) while there is no value',\n        ]\n      }\n      const out: string[] = []\n      const c = convert(d.expected, d.received)\n      if (c) {\n        out.push(\n          `if the filter value is the wrong type, convert it before setting it: ${c.replace('x', 'input')}`,\n          `if the data is the wrong type, normalise the column: ` +\n            `{ id: '${d.column}', accessor: (row) => ${c.replace('x', 'row.<field>')} } ` +\n            `(columns[${d.index}])`,\n        )\n      } else {\n        out.push(\n          `normalise the column so every cell is ${d.expected}: an accessor on columns[${d.index}]`,\n        )\n      }\n      out.push(\n        `or filter with a kind that fits ${d.received} cells, or a custom filter: ` +\n          `{ type: 'custom', value, fn: (cell, value, row) => boolean }`,\n      )\n      return out\n    },\n  },\n}\n\n/** Codes owned by the `columnFilters` feature (§6.1, §8.3). */\nexport const columnFiltersDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FILTER_TYPE_MISMATCH',\n      level: 'warn',\n      where: (d) => ({ kind: 'column', index: d.index, id: d.column }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_FILTER_TYPE_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_STATE_UNKNOWN_KEY',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slice}.${d.key}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_STATE_UNKNOWN_KEY,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/features/column-filters/codes.ts"],"sourcesContent":["import { suggest } from '../../catalog/suggest'\nimport { type DiagnosticMessages, defineDiagnostic } from '../../diagnostics/catalog'\nimport '../../diagnostics/process-guard'\n\ndeclare module '../../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_FILTER_TYPE_MISMATCH: {\n      /** Column id (`key` or `id`). */\n      column: string\n      /** Position in `options.columns`. */\n      index: number\n      /** The filter kind (`type`) as given, e.g. `contains`. */\n      filter: string\n      /** `cell`: cell values of the wrong type; `filter`: the filter value itself is malformed. */\n      source: 'cell' | 'filter'\n      /** What the filter accepts, e.g. `string`, `number | bigint`, `Date`, `array`. */\n      expected: string\n      /** The type of the first offending value (`string`, `number`, `Date`, `array`, …). */\n      received: string\n      /** Cells of the wrong type (0 for `source: 'filter'`). */\n      count: number\n      /** A sample of their row indices (first few, in order). */\n      rows: readonly number[]\n    }\n    DK_STATE_UNKNOWN_KEY: {\n      /** The state slice holding the key, e.g. `columnFilters`. */\n      slice: string\n      /** The key that names no column. */\n      key: string\n      /** The table's column ids (did-you-mean). */\n      known: readonly string[]\n    }\n  }\n}\n\n/** The filter kinds of §6.1. */\nexport const FILTER_KINDS = ['equals', 'contains', 'in', 'range', 'custom'] as const\n\nconst rowList = (rows: readonly number[], count: number) => {\n  if (rows.length === 0) return ''\n  const list = rows.map((r) => `#${r}`).join(', ')\n  return count > rows.length ? ` (first: ${list}, …)` : ` (rows ${list})`\n}\n\nconst plural = (n: number, one: string, many: string) => (n === 1 ? `1 ${one}` : `${n} ${many}`)\n\n/** A conversion from `received` to `expected`, as code, when one is obvious. */\nfunction convert(expected: string, received: string): string | undefined {\n  if (expected.includes('number') && received === 'string') return 'Number(x)'\n  if (expected === 'string' && (received === 'number' || received === 'bigint')) return 'String(x)'\n  if (expected === 'Date' && (received === 'string' || received === 'number')) return 'new Date(x)'\n  return undefined\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const columnFiltersMessages: DiagnosticMessages<\n  'DK_FILTER_TYPE_MISMATCH' | 'DK_STATE_UNKNOWN_KEY'\n> = {\n  DK_STATE_UNKNOWN_KEY: {\n    problem: (d) => `state.${d.slice} has an entry for \"${d.key}\", which is not a column`,\n    impact: () =>\n      'the entry is ignored (the other entries still apply); it may come from an older URL or ' +\n      'saved state, or the column was renamed or removed',\n    fix: (d) => {\n      const near = suggest(d.key, d.known)\n      return [\n        near.length > 0\n          ? `did you mean \"${near[0]}\"? (state.${d.slice}[\"${near[0]}\"])`\n          : `use one of the column ids: ${d.known.map((k) => `\"${k}\"`).join(', ')}`,\n        `drop \"${d.key}\" when parsing initialState / state (e.g. from the URL), or add the column`,\n      ]\n    },\n  },\n  DK_FILTER_TYPE_MISMATCH: {\n    problem: (d) =>\n      d.source === 'filter'\n        ? `the \"${d.filter}\" filter on column \"${d.column}\" has a value of type ${d.received}; ` +\n          `it expects ${d.expected}`\n        : `the \"${d.filter}\" filter on column \"${d.column}\" compares ${d.expected} values, but ` +\n          `${plural(d.count, 'cell holds', 'cells hold')} another type (first: ` +\n          `${d.received})${rowList(d.rows, d.count)}`,\n    impact: (d) =>\n      d.source === 'filter'\n        ? 'the filter matches no rows until its value is fixed'\n        : 'those rows are treated as non-matching; the other rows are filtered normally',\n    fix: (d) => {\n      const at = `state.columnFilters[\"${d.column}\"]`\n      if (d.source === 'filter') {\n        if (!(FILTER_KINDS as readonly string[]).includes(d.filter)) {\n          const near = suggest(d.filter, FILTER_KINDS)\n          return [\n            near.length > 0\n              ? `did you mean type: '${near[0]}'? (${at})`\n              : `use one of the filter kinds ${FILTER_KINDS.join(', ')} in ${at}`,\n          ]\n        }\n        return [\n          `give ${at} a value of type ${d.expected}: { type: '${d.filter}', value: … }`,\n          'remove the filter (setColumnFilter(id, undefined)) while there is no value',\n        ]\n      }\n      const out: string[] = []\n      const c = convert(d.expected, d.received)\n      if (c) {\n        out.push(\n          `if the filter value is the wrong type, convert it before setting it: ${c.replace('x', 'input')}`,\n          `if the data is the wrong type, normalise the column: ` +\n            `{ id: '${d.column}', accessor: (row) => ${c.replace('x', 'row.<field>')} } ` +\n            `(columns[${d.index}])`,\n        )\n      } else {\n        out.push(\n          `normalise the column so every cell is ${d.expected}: an accessor on columns[${d.index}]`,\n        )\n      }\n      out.push(\n        `or filter with a kind that fits ${d.received} cells, or a custom filter: ` +\n          `{ type: 'custom', value, fn: (cell, value, row) => boolean }`,\n      )\n      return out\n    },\n  },\n}\n\n/** Codes owned by the `columnFilters` feature (§6.1, §8.3). */\nexport const columnFiltersDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_FILTER_TYPE_MISMATCH',\n      level: 'warn',\n      where: (d) => ({ kind: 'column', index: d.index, id: d.column }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_FILTER_TYPE_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_STATE_UNKNOWN_KEY',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slice}.${d.key}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && columnFiltersMessages.DK_STATE_UNKNOWN_KEY,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/features/column-filters/column-filters.cjs

@@ -25,6 +25,7 @@ __export(column_filters_exports, {
 module.exports = __toCommonJS(column_filters_exports);
 var import_options = require("../../catalog/options.cjs");
 var import_catalog = require("../../diagnostics/catalog.cjs");
+var import_process_guard = require("../../diagnostics/process-guard.cjs");
 var import_define = require("../../feature/define.cjs");
 var import_cell_batch = require("../../intercept/cell-batch.cjs");
 var import_classify = require("../../intercept/classify.cjs");
@@ -105,7 +106,7 @@ function report(ctx, c, id, kind, index) {
         column: id,
         rows: Array.from(failures.sample()),
         count: failures.count,
-        fallback: "the failed rows are treated as non-matching",
+        fallback: "rows-unmatched",
         ...name === void 0 ? {} : { errorName: name }
       },
       { cause: first.error }
@@ -191,12 +192,13 @@ var columnFilters = (opts = {}) => (0, import_define.defineFeature)({
   initialState: () => ({}),
   createApi: (ctx) => ({
     setColumnFilter: (id, filter) => ctx.setState((prev) => {
+      if (prev[id] === filter) return prev;
       const next = { ...prev };
       if (filter === void 0) delete next[id];
       else next[id] = filter;
       return next;
     }),
-    resetColumnFilters: () => ctx.setState({})
+    resetColumnFilters: () => ctx.setState((prev) => Object.keys(prev).length ? {} : prev)
   }),
   rowModel: filterRows
 });