@datakable/core 1.0.0 → 1.1.0

package/dist/source/fetch-codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/source/fetch-codes.js

@@ -1,5 +1,6 @@
 // src/source/fetch-codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var BAD = {
   "not-an-object": (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,
   "rows-not-an-array": (d) => `fetcher result.rows is ${d.received}, not an array`,

package/dist/source/fetch-codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AA0C1D,IAAM,MAGF;AAAA,EACF,iBAAiB,CAAC,MAAM,yBAAyB,EAAE,QAAQ;AAAA,EAC3D,qBAAqB,CAAC,MAAM,0BAA0B,EAAE,QAAQ;AAAA,EAChE,oBAAoB,MAClB;AAAA,EACF,oBAAoB,CAAC,MAAM,8BAA8B,EAAE,QAAQ;AAAA,EACnE,sBAAsB,CAAC,MACrB,4BAA4B,EAAE,QAAQ,kCAAkC,EAAE,IAAI;AAClF;AAEA,IAAM,UAAU,EAAE,MAAM,UAAU,MAAM,UAAU;AAG3C,IAAM,gBAMT;AAAA,EACF,eAAe;AAAA,IACb,SAAS,CAAC,MACR,YAAY,EAAE,MAAM,MAAM,EAAE,WAAW,6BAA6B,EAAE,MAAM,MACxE,EAAE,WAAW;AAAA,IACnB,QAAQ,MACN;AAAA,IACF,KAAK,CAAC,MAAM;AAAA,MACV,SAAS,EAAE,MAAM,wBAAwB,EAAE,MAAM;AAAA,MACjD,cAAc,EAAE,MAAM,oBAAoB,EAAE,MAAM;AAAA,IACpD;AAAA,EACF;AAAA,EACA,gCAAgC;AAAA,IAC9B,SAAS,MAAM;AAAA,IACf,QAAQ,CAAC,MACP,EAAE,UAAU,SACR,2EACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,2DACG,EAAE,SAAS,SAAS,IAAI,gBAAgB,EAAE,SAAS,KAAK,IAAI,CAAC,MAAM,MACpE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,iBAAiB;AAAA,IACf,SAAS,CAAC,MAAM,4BAA4B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAChF,QAAQ,CAAC,MACP,EAAE,UACE,iDACA;AAAA,IACN,KAAK,MAAM;AAAA,MACT;AAAA,MAEA;AAAA,IAEF;AAAA,EACF;AAAA,EACA,kBAAkB;AAAA,IAChB,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,KAAK,MAAM;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB,SAAS,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC;AAAA,IAChC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,uBACV,0FACA;AAAA,MAEJ;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,OAAO;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/table/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 listSlices = (s) => s.length === 0 ? "a function updater" : s.map((k) => `"${k}"`).join(", ");
 var tableMessages = {
   DK_LISTENER_FAILED: {

package/dist/table/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AA2B1D,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AA2BP,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/table/codes.js

@@ -1,5 +1,6 @@
 // src/table/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var listSlices = (s) => s.length === 0 ? "a function updater" : s.map((k) => `"${k}"`).join(", ");
 var tableMessages = {
   DK_LISTENER_FAILED: {

package/dist/table/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AA2B1D,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AA2BP,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/table/create-table.cjs

@@ -27,8 +27,10 @@ var import_codes = require("../catalog/codes.cjs");
 var import_validator = require("../catalog/validator.cjs");
 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_explain = require("../diagnostics/explain.cjs");
 var import_hub = require("../diagnostics/hub.cjs");
+var import_redact = require("../diagnostics/redact.cjs");
 var import_tracer = require("../diagnostics/tracer.cjs");
 var import_runtime = require("../feature/runtime.cjs");
 var import_data_checks = require("../ingest/data-checks.cjs");
@@ -65,7 +67,23 @@ var RANK = [
   "error"
 ];
 var isThenable = (v) => v != null && typeof v.then === "function";
-var freeze = (s) => process.env.NODE_ENV !== "production" ? Object.freeze(s) : s;
+var deepFrozen = process.env.NODE_ENV !== "production" ? /* @__PURE__ */ new WeakSet() : void 0;
+function deepFreeze(v) {
+  if (v === null || typeof v !== "object" || deepFrozen?.has(v)) return;
+  const isArray = Array.isArray(v);
+  if (!isArray) {
+    const proto = Object.getPrototypeOf(v);
+    if (proto !== Object.prototype && proto !== null) return;
+  }
+  deepFrozen?.add(v);
+  Object.freeze(v);
+  if (isArray) for (let i = 0; i < v.length; i++) deepFreeze(v[i]);
+  else for (const k in v) deepFreeze(v[k]);
+}
+var freeze = (s) => {
+  if (process.env.NODE_ENV !== "production") deepFreeze(s);
+  return s;
+};
 var columnId = (c) => c.key ?? c.id;
 function createTable(initialOptions) {
   let options = { ...initialOptions };
@@ -118,7 +136,11 @@ function createTable(initialOptions) {
     ...typeof redactOption === "string" ? { level: redactOption } : {},
     ...typeof redactOption === "function" ? { redact: redactOption } : {},
     sensitiveColumns,
-    rowKeySensitive: () => typeof options.rowKey === "string" && sensitiveColumns().includes(options.rowKey)
+    // A rowKey path into (or above) a sensitive column reads its data too (#45).
+    rowKeySensitive: () => {
+      const k = options.rowKey;
+      return typeof k === "string" && sensitiveColumns().some((c) => (0, import_redact.pathsOverlap)(k, c));
+    }
   };
   const hub = (0, import_hub.createDiagnostics)({
     ...options.name === void 0 ? {} : { name: options.name },
@@ -159,7 +181,7 @@ function createTable(initialOptions) {
     options.invalidRows ?? "drop",
     () => options.columns
   );
-  if (options.schema && !schemaIngest) unwrapped("schema", "withSchema");
+  if (options.schema && !schemaIngest) unwrapped("schema", options.schema, "withSchema");
   function sensitiveColumns() {
     const out = [];
     for (const c of options.columns ?? EMPTY) {
@@ -329,7 +351,7 @@ function createTable(initialOptions) {
     if (next === data) return;
     data = next;
     pending = true;
-    dataChecks?.check(data, options.columns);
+    if (process.env.NODE_ENV !== "production") dataChecks?.check(data, options.columns);
     rowModelDirty = true;
   }
   const runner = (0, import_runner.createPipeline)({
@@ -485,7 +507,7 @@ function createTable(initialOptions) {
         );
       });
     } finally {
-      if (!fetched) dataCheck?.remember(options.data);
+      if (process.env.NODE_ENV !== "production" && !fetched) dataCheck?.remember(options.data);
     }
   }
   function update(updater, slot) {
@@ -554,7 +576,7 @@ function createTable(initialOptions) {
         if (next.rowCount !== previous.rowCount) pending = true;
         if (next.fetcher !== previous.fetcher) server?.reset();
         if (next.data !== previous.data) ingest();
-        else {
+        else if (process.env.NODE_ENV !== "production") {
           if ("data" in partial) dataCheck?.check(next.data);
           if (next.columns !== previous.columns) dataChecks?.check(data, next.columns);
         }
@@ -625,13 +647,20 @@ function createTable(initialOptions) {
   function useServer(fetcher, phase) {
     const factory = fetcher?.[import_server_brand.SERVER_SOURCE];
     if (factory) server = use(factory);
-    else if (fetcher) unwrapped("fetcher", "withFetcher", phase);
+    else if (fetcher) unwrapped("fetcher", fetcher, "withFetcher", "server", phase);
     return server;
   }
-  function unwrapped(path, wrap, phase = "init") {
+  function unwrapped(path, value, wrap, entry = path, phase = "init") {
     return (0, import_build.throwConfigError)(
       "DK_INVALID_OPTION",
-      { path, expected: `${wrap}(${path})`, received: path, suggestions: [], phase },
+      {
+        path,
+        expected: `wrapped|${wrap}|${path}|${entry}`,
+        // prose key (diagnostics/prose.ts)
+        received: typeof value,
+        suggestions: [],
+        phase
+      },
       { table: hub.table, trigger: phase }
     );
   }
@@ -653,6 +682,7 @@ function createTable(initialOptions) {
   }
   (0, import_internals.setTableInternals)(table, {
     features: pipeline,
+    name: options.name,
     rowCount: () => typeof options.fetcher === "function" ? server?.rowCount() : options.rowCount,
     hasFetcher: () => typeof options.fetcher === "function",
     emit: hub.emit,

package/dist/table/create-table.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/table/create-table.ts"],"sourcesContent":["import { optionDiagnostics } from '../catalog/codes'\nimport { validateOptionChange, validateOptions } from '../catalog/validator'\nimport { DatakableError, defaultPhase, throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport { type ExplainHost, explainRow, explainTable } from '../diagnostics/explain'\nimport { createDiagnostics } from '../diagnostics/hub'\nimport type { RedactionOptions } from '../diagnostics/redact'\nimport { tracer } from '../diagnostics/tracer'\nimport type { Trigger } from '../diagnostics/types'\nimport { runtimeFor } from '../feature/runtime'\nimport type { AnyFeature, ApiOf, SliceUpdater, TableStateFor } from '../feature/types'\nimport { createDataChecks } from '../ingest/data-checks'\nimport { createDerivedColumns } from '../ingest/derive-columns'\nimport type { SchemaOutcome } from '../ingest/schema'\nimport { SCHEMA_INGEST, type TableSchema } from '../ingest/schema-brand'\nimport type { InvalidRowsMode } from '../ingest/schema-codes'\nimport type { StandardSchemaV1 } from '../ingest/standard-schema'\nimport { errorBoundary } from '../intercept/boundary'\nimport { callUser, errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { FAILED, FALLBACK } from '../intercept/fallbacks'\nimport type { OpInput, OpName, OpResult } from '../intercept/operations'\nimport { type Core, createInterceptorRuntime } from '../intercept/runtime'\nimport { createPipeline } from '../pipeline/runner'\nimport type { RowModel, RowModelStatus } from '../pipeline/types'\nimport { checkModeOrder, type FetchOutcome } from '../source/fetcher'\nimport type { ServerSource } from '../source/server'\nimport { SERVER_SOURCE, type ServerFetcher } from '../source/server-brand'\nimport { checkVersions } from '../versioning/registry'\nimport { tableDiagnostics } from './codes'\nimport { createDataMutationCheck, dataMutationDiagnostics } from './data-mutation'\nimport {\n  deferral,\n  type ExtensionFactory,\n  setTableInternals,\n  type TableExtension,\n  type TableHost,\n} from './internals'\nimport { keepReadOnce } from './read-once'\nimport { createStateFeedbackCheck, stateFeedbackDiagnostics } from './state-feedback'\nimport {\n  type ControlledState,\n  type Listener,\n  type Table,\n  type TableOptions,\n  type TableState,\n  UPDATE_DEPTH_LIMIT,\n  type Updater,\n} from './types'\n\nkeepDiagnostics(\n  tableDiagnostics,\n  dataMutationDiagnostics,\n  stateFeedbackDiagnostics,\n  optionDiagnostics,\n)\n\nconst EMPTY: readonly never[] = []\n\n/** §6.6 status precedence, lowest first: the table shows the highest of its sources. */\nconst RANK: readonly RowModelStatus[] = [\n  'idle',\n  'pending',\n  'validating',\n  'searching',\n  'fetching',\n  'error',\n]\n\nconst isThenable = (v: unknown): v is PromiseLike<unknown> =>\n  v != null && typeof (v as { then?: unknown }).then === 'function'\n\nconst freeze = <S extends object>(s: S): S => ((process.env.NODE_ENV !== \"production\") ? Object.freeze(s) : s)\n\n/** The row type: the schema output with a `schema` (§5.1), else `T`. */\nexport type SchemaRow<T, Sch> = [Sch] extends [TableSchema] ? StandardSchemaV1.InferOutput<Sch> : T\n\n/**\n * `createTable` options: with a `schema`, the row type is its output and `data` is the raw input\n * (`unknown[]`, e.g. parsed JSON), validated per row.\n */\nexport type CreateTableOptions<T, S extends TableState, Sch, M extends InvalidRowsMode> = Omit<\n  TableOptions<SchemaRow<T, Sch>, S>,\n  'data' | 'schema' | 'invalidRows' | 'fetcher' | 'initialData'\n> & {\n  data?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n  /** With a schema, the raw rows (validated like `data`). */\n  initialData?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n  /** With a schema, the fetcher returns raw rows (validated like `data`). */\n  fetcher?: ServerFetcher<[Sch] extends [TableSchema] ? unknown : T>\n  // Without an inferred schema (explicit type arguments, a `TableOptions<T>` object) these keep\n  // their `TableOptions` types.\n  schema?: [Sch] extends [TableSchema] ? Sch : TableSchema<unknown, T>\n  invalidRows?: [Sch] extends [TableSchema] ? M : InvalidRowsMode\n}\n\n/** Column id: `key` for key columns, `id` for accessor columns. */\nconst columnId = (c: { key?: unknown; id?: unknown }): unknown => c.key ?? c.id\n\n/**\n * Creates the table store (§3.2): immutable state snapshots, controlled slices, isolated listeners,\n * a re-entrancy guard and `destroy()`. Every unit of work runs as an operation (§3.4) through the\n * table's interceptor runtime, with the errorBoundary outermost and diagnostics on a per-table hub.\n *\n * `ctx.where` is always a constant option path or method name (`options`, `options.data`,\n * `setState`, `destroy`): it reaches fingerprints, docs URLs and issue links unredacted, so it must\n * never carry row keys or cell values.\n */\nexport function createTable<\n  T,\n  S extends TableState = never,\n  const Fs extends readonly AnyFeature[] = [],\n  const Sch extends TableSchema | undefined = undefined,\n  const M extends InvalidRowsMode = 'drop',\n>(\n  options: CreateTableOptions<T, TableStateFor<S, Fs, SchemaRow<T, Sch>>, Sch, M> & {\n    features?: Fs\n  },\n): Table<\n  SchemaRow<T, Sch>,\n  TableStateFor<S, Fs, SchemaRow<T, Sch>>,\n  M,\n  [Sch] extends [TableSchema] ? unknown : T\n> &\n  ApiOf<Fs, SchemaRow<T, Sch>>\nexport function createTable<T, S extends TableState>(\n  initialOptions: TableOptions<T, S>,\n): Table<T, S> {\n  let options: TableOptions<T, S> = { ...initialOptions }\n  let destroyed = false\n  let trigger: Trigger = 'init'\n  /** Pipeline run id; each `pipeline:run` increments it. */\n  let run = 0\n  let data: readonly T[] = EMPTY\n  let ingestSeq = 0\n  /** Data given by the user has been applied once (`RowModel.isInitialLoad`, §6.6). */\n  let loaded = false\n  /** The last `data:ingest` failed (op fallback): `status: 'error'` until one succeeds (§6.6). */\n  let ingestFailed = false\n  /** The ingest whose async schema validation is in flight (`status: 'validating'`); 0: none. */\n  let validatingSeq = 0\n  /** Rows of the current data that failed the schema (`getInvalidRows`, §5.1). */\n  let schemaOutcome: SchemaOutcome | undefined\n  /**\n   * SSR (§7.2): `options.initialData` until the creation ingest read it (`undefined` with `data`),\n   * then its ingested rows while they are the table's data (`initialRows`).\n   */\n  let initialInput = options.data === undefined ? options.initialData : undefined\n  let initialRows: readonly unknown[] | undefined\n  /** Created inside `createDeferred` (§7.2): async work waits for `startTable`. */\n  let deferring = deferral.depth > 0\n  /**\n   * Opt-in parts of the store (`TableInternals.use`): the async request machinery and the server\n   * source. A table without an async source creates none (§9.3).\n   */\n  const extensions = new Map<ExtensionFactory<TableExtension>, TableExtension>()\n  /** The server source (`withFetcher`, §7.1), once a fetcher was given. */\n  let server: ServerSource | undefined\n\n  let controlled = new Set<string>()\n  let snapshot: S\n  /** The snapshot listeners last saw (`prev` of the next notification). */\n  let notified: S\n  /** A committed change (state or data) not yet notified. */\n  let pending = false\n  let notifying = false\n  let rounds = 0\n  let loopReported = false\n  let current: number | undefined\n  let listenerSeq = 0\n  const listeners = new Map<number, Listener<S>>()\n  /** Depth of feature API calls in progress: listeners are notified when the outermost returns. */\n  let apiDepth = 0\n  /** Data, state or columns changed since the row model was computed. */\n  let rowModelDirty = true\n  /** Diagnostic context (§8.1): the data mode of each pipeline feature (set once features load). */\n  const modes: Record<string, 'client' | 'server'> = {}\n\n  const table: Table<T, S> = {\n    getState: () => snapshot,\n    setState,\n    subscribe,\n    setOptions,\n    getOptions: () => options,\n    getData: () => data,\n    // Core method: on the literal before installApis, so no feature can take the name.\n    getRowModel,\n    getInvalidRows: () => schemaOutcome?.invalid ?? EMPTY,\n    getDiagnostics: () => hub.getDiagnostics(),\n    // Core methods (§8.4), read-only: also on the literal before installApis.\n    explain: () => explainTable(explainHost),\n    explainRow: (key) => explainRow(explainHost, key),\n    refetch,\n    destroy,\n  }\n\n  // Redaction (§8.2): `diagnostics.redact` gives the level or a custom rule; column defs give the\n  // sensitive columns and whether the rowKey column is sensitive. Both are read per emit, so\n  // `setOptions({ columns })` is followed.\n  const redactOption = options.diagnostics?.redact\n  const redaction: RedactionOptions = {\n    ...(typeof redactOption === 'string' ? { level: redactOption } : {}),\n    ...(typeof redactOption === 'function' ? { redact: redactOption } : {}),\n    sensitiveColumns,\n    rowKeySensitive: () =>\n      typeof options.rowKey === 'string' && sensitiveColumns().includes(options.rowKey),\n  }\n  const hub = createDiagnostics({\n    ...(options.name === undefined ? {} : { name: options.name }),\n    table,\n    onDiagnostic: (d) => options.onDiagnostic?.(d),\n    ...(options.strict === undefined ? {} : { strict: options.strict }),\n    getContext: () => ({ trigger, run, mode: modes }),\n    getDataRef: () => data,\n    redaction,\n  })\n  // Option validator (§3.4, `table:init`), development only: before anything reads the options.\n  // Invalid values throw DK_INVALID_OPTION; unknown / no-effect options are reported on the hub.\n  if ((process.env.NODE_ENV !== \"production\")) validateOptions(options, { table: hub.table, emit: hub.emit })\n  // Features (§3.3) are read once, at creation. `features` is the listed order (API install, conflict\n  // reports); `pipeline` is stage order for the runner. Duplicates throw here (config error).\n  const features: readonly AnyFeature[] = options.features ?? EMPTY\n  // The feature runtime comes with the features (`defineFeature`): none for a table without.\n  const rt = runtimeFor(features)\n  const pipeline = rt ? rt.orderFeatures(features, hub.table) : EMPTY\n  // Data modes (§7.1): DK_MODE_ORDER (a config error, development). A fetcher without a server-mode\n  // feature (DK_FETCHER_WITHOUT_SERVER_MODE) is checked by the server source.\n  if ((process.env.NODE_ENV !== \"production\")) checkModeOrder(pipeline, hub.table)\n  for (const f of pipeline) if (f.stage !== 'none') modes[f.name] = f.mode ?? 'client'\n  // Extension interceptors come first (asyncControl, one per table, installed with the first async\n  // source: user / feature interceptors and the core see its signal); the boundary stays\n  // outermost. Feature interceptors (pipeline order) come next, then the user's.\n  const front: Interceptor<OpName>[] = []\n  const featureInterceptors = pipeline.flatMap((f) => f.interceptors ?? EMPTY)\n  // The tracer (§3.4, explain timings) is development-only: `(process.env.NODE_ENV !== \"production\")` folds to `false` in production\n  // builds, which drops it from the bundle; there it is opt-in with `interceptors: [tracer()]`.\n  const traced = (process.env.NODE_ENV !== \"production\") ? [tracer() as Interceptor<OpName>] : EMPTY\n  const withFront = (list: readonly Interceptor<OpName>[] | undefined) => [\n    ...front,\n    ...traced,\n    ...featureInterceptors,\n    ...(list ?? EMPTY),\n  ]\n  const runtime = createInterceptorRuntime({\n    interceptors: withFront(options.interceptors),\n    emit: hub.emit,\n  })\n  runtime.installBoundary(errorBoundary)\n  hub.attach(runtime)\n  // Dev check (§5.3): the same `data` array passed again with changed contents (DK_DATA_MUTATED).\n  const dataCheck = (process.env.NODE_ENV !== \"production\") ? createDataMutationCheck(hub.emit) : undefined\n  // Feature `requires.core` (throws DK_FEATURE_INCOMPATIBLE), duplicate cores, version mismatch\n  // (§8.5): development checks (changed 2026-10-13 for §9.3).\n  if ((process.env.NODE_ENV !== \"production\")) checkVersions(features, hub.emit, hub.table)\n  // Ingest data checks (§5.3) and zero-config columns (§4.1): both read only the first rows.\n  // The data checks are developer hints: development only (changed 2026-10-13 for §9.3).\n  const dataChecks = (process.env.NODE_ENV !== \"production\") ? createDataChecks(hub.emit) : undefined\n  /** Controlled changes not fed back (DK_CONTROLLED_NOT_FED_BACK, development). */\n  const feedback = (process.env.NODE_ENV !== \"production\") ? createStateFeedbackCheck(hub.emit) : undefined\n  const derivedColumns = createDerivedColumns()\n  // Schema ingest (§5.1): `schema` and `invalidRows` are read once (validated above). The step\n  // comes with the schema (`withSchema`, `@datakable/core/schema`): a table without one never\n  // bundles it.\n  const schemaIngest = (options.schema as Partial<TableSchema> | undefined)?.[SCHEMA_INGEST]?.(\n    options.invalidRows ?? 'drop',\n    () => options.columns,\n  )\n  // Never silent (§8.6): in production (no option validator) an unwrapped schema would be ignored.\n  if (options.schema && !schemaIngest) unwrapped('schema', 'withSchema')\n\n  function sensitiveColumns(): string[] {\n    const out: string[] = []\n    for (const c of options.columns ?? EMPTY) {\n      const id = columnId(c as { key?: unknown; id?: unknown })\n      if (c.sensitive && typeof id === 'string') out.push(id)\n    }\n    return out\n  }\n\n  function base(): ContextBase {\n    return { table, run, trigger, phase: defaultPhase(), emit: hub.emit }\n  }\n\n  function op<O extends OpName>(\n    name: O,\n    input: OpInput<O>,\n    where: string,\n    core: Core<O>,\n    fallback?: unknown,\n  ): OpResult<O> {\n    const ctx = createContext(name, input, where, base())\n    if (fallback !== undefined) ctx.meta.set(FALLBACK, fallback)\n    return runtime.run(name, ctx, core)\n  }\n\n  function withTrigger<R>(t: Trigger, fn: () => R): R {\n    const prev = trigger\n    trigger = t\n    try {\n      return fn()\n    } finally {\n      trigger = prev\n    }\n  }\n\n  // --- state -------------------------------------------------------------------------------------\n\n  function controlledKeys(state: ControlledState<S> | undefined): Set<string> {\n    const keys = new Set<string>()\n    if (state) for (const k of Object.keys(state)) if (state[k] !== undefined) keys.add(k)\n    return keys\n  }\n\n  /** `s` with the controlled slices from `options.state`; `s` itself when none differ. */\n  function overlay(s: S): S {\n    let next: TableState | undefined\n    const state = options.state as TableState | undefined\n    if (state) {\n      for (const k of controlled) {\n        if (!Object.is(s[k], state[k])) {\n          next ??= { ...s }\n          next[k] = state[k]\n        }\n      }\n    }\n    return next ? freeze(next as S) : s\n  }\n\n  function commit(next: S) {\n    snapshot = next\n    pending = true\n    rowModelDirty = true\n  }\n\n  function warnControlled(dropped: string[] | undefined) {\n    if (options.onStateChange || controlled.size === 0) return\n    const slices = dropped ?? [...controlled]\n    hub.emit('DK_CONTROLLED_WITHOUT_HANDLER', { slices, dropped: dropped !== undefined })\n  }\n\n  function syncControlled() {\n    controlled = controlledKeys(options.state)\n    const next = overlay(snapshot)\n    if (next !== snapshot) commit(next)\n    if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n    warnControlled(undefined)\n  }\n\n  function dispatch(updater: Updater<S>, slot: string) {\n    // A method argument, not an option: `where` = `operation table.setState at updater`.\n    const partial: Partial<S> =\n      typeof updater === 'function'\n        ? callUser(\n            'updater',\n            updater,\n            snapshot,\n            undefined,\n            slot === 'setState' ? 'table.setState' : `${slot}.setState`,\n          )\n        : updater\n    if (partial === null || typeof partial !== 'object') return\n    let next: TableState | undefined\n    let changes: TableState | undefined\n    let dropped: string[] | undefined\n    for (const k of Object.keys(partial)) {\n      const v = (partial as TableState)[k]\n      if (Object.is(snapshot[k], v)) continue\n      if (controlled.has(k)) {\n        if (options.onStateChange) {\n          changes ??= {}\n          changes[k] = v\n        } else {\n          dropped ??= []\n          dropped.push(k)\n        }\n        continue\n      }\n      next ??= { ...snapshot }\n      next[k] = v\n    }\n    // The owner is told first: if onStateChange throws, nothing is committed (state unchanged).\n    if (changes && options.onStateChange) {\n      const c = changes as Partial<S>\n      if ((process.env.NODE_ENV !== \"production\")) feedback?.ask(Object.keys(changes), trigger)\n      callUser('onStateChange', options.onStateChange, (prev: Partial<S>) => ({ ...prev, ...c }))\n      if ((process.env.NODE_ENV !== \"production\")) feedback?.asked()\n    }\n    if (next) commit(freeze(next as S))\n    if (dropped) warnControlled(dropped)\n  }\n\n  /**\n   * Notifies listeners until no change is pending. Updates made by listeners are committed at once\n   * and notified in the next round (not nested), so every listener sees rounds in order.\n   */\n  function flush() {\n    if (notifying) return\n    sync()\n    if (!pending) return\n    notifying = true\n    let rethrow: unknown\n    try {\n      while (pending && !destroyed) {\n        // Server state changed (this round's state): the fetch starts in the same notification.\n        sync()\n        pending = false\n        rounds++\n        const prev = notified\n        const state = snapshot\n        notified = state\n        // Listeners read the row model of the state they are notified with.\n        ensureRowModel()\n        for (const [id, listener] of [...listeners]) {\n          // A listener may destroy the table: the rest of the round is not notified.\n          if (destroyed) break\n          current = id\n          try {\n            listener(state, prev)\n          } catch (e) {\n            // strict: a DatakableError (e.g. DK_UPDATE_LOOP) thrown inside the listener.\n            if (e instanceof DatakableError) {\n              rethrow ??= e\n              continue\n            }\n            try {\n              const name = errorName(e)\n              hub.emit(\n                'DK_LISTENER_FAILED',\n                { listener: id, ...(name === undefined ? {} : { errorName: name }) },\n                { cause: e },\n              )\n            } catch (strictError) {\n              rethrow ??= strictError\n            }\n          }\n        }\n      }\n    } finally {\n      notifying = false\n      rounds = 0\n      loopReported = false\n      current = undefined\n    }\n    if (rethrow !== undefined) throw rethrow\n  }\n\n  /** `false` (and one `DK_UPDATE_LOOP`) when a re-entrant update would exceed the depth limit. */\n  function admit(slices: string[]): boolean {\n    if (!notifying || rounds < UPDATE_DEPTH_LIMIT) return true\n    if (!loopReported) {\n      loopReported = true\n      hub.emit('DK_UPDATE_LOOP', {\n        limit: UPDATE_DEPTH_LIMIT,\n        slices,\n        ...(current === undefined ? {} : { listener: current }),\n      })\n    }\n    return false\n  }\n\n  function destroyedCall(method: string) {\n    withTrigger(`api:${method}`, () => hub.emit('DK_TABLE_DESTROYED', { method }))\n  }\n\n  // --- data --------------------------------------------------------------------------------------\n\n  /** Applies ingested data; `given`: it came from a user `options.data` (marks the first load). */\n  function setData(next: readonly T[], given: boolean) {\n    if (given && !loaded) {\n      // isInitialLoad flips: a new row model and a notification even for the same reference.\n      loaded = true\n      pending = true\n      rowModelDirty = true\n    }\n    if (next === data) return\n    data = next\n    pending = true\n    // After `data` is set: diagnostics dedupe per data reference.\n    dataChecks?.check(data, options.columns)\n    // The pipeline runs before the next notification (or on getRowModel), as `pipeline:run` with\n    // ctx.meta[FALLBACK] = the last good row model (pipeline/runner.ts).\n    rowModelDirty = true\n  }\n\n  // --- row model ---------------------------------------------------------------------------------\n\n  const runner = createPipeline<T>({\n    runtime,\n    featureRuntime: rt,\n    emit: hub.emit,\n    features: pipeline,\n    listed: features,\n    base,\n    nextRun: () => ++run,\n    getData: () => data,\n    getState: () => snapshot,\n    getColumns: () => options.columns ?? derivedColumns(data),\n    getRowKey: () => options.rowKey,\n    isInitialLoad: () => !loaded,\n    status,\n    issues: (index) => schemaOutcome?.flagged?.get(index),\n    flagMode: schemaIngest !== undefined && options.invalidRows === 'flag',\n    // Time-sliced work ended (§9.1): 'pending' → the finished row model, never silent (§6.6).\n    refresh: (t) => {\n      if (destroyed) return\n      withTrigger(t, () => {\n        touch()\n        if (apiDepth === 0) flush()\n      })\n    },\n  })\n\n  const explainHost: ExplainHost = {\n    table,\n    features: pipeline,\n    rowModel: getRowModel as () => RowModel<unknown>,\n    lastRun: runner.lastRun,\n    replay: runner.replayContext,\n    data: () => data,\n    state: () => snapshot,\n    rowKey: () => options.rowKey,\n    schemaMode: () => (schemaIngest ? (options.invalidRows ?? 'drop') : undefined),\n    schema: () => schemaOutcome,\n    diagnostics: () => hub.getDiagnostics(),\n    redaction,\n    ...(rt ? { detail: rt.explainDetail } : {}),\n  }\n\n  /**\n   * Status from outside the pipeline (§6.6): a failed ingest, a running async schema, the search\n   * slice (`pending` / `searching` / `error`), and the extensions' (a failed fetch, an in-flight\n   * fetcher / `searchFn`, deferred async work). Precedence: error > fetching > searching >\n   * validating > pending > idle.\n   */\n  function status(): RowModelStatus {\n    const search = searchStatus()\n    let s: RowModelStatus =\n      ingestFailed || search === 'error'\n        ? 'error'\n        : search === 'searching'\n          ? 'searching'\n          : validatingSeq !== 0\n            ? 'validating'\n            : search === 'pending'\n              ? 'pending'\n              : 'idle'\n    for (const e of extensions.values()) {\n      const x = e.status?.()\n      if (x !== undefined && RANK.indexOf(x) > RANK.indexOf(s)) s = x\n    }\n    return s\n  }\n\n  /** Extensions start work that follows state (the fetcher on server state, §7.1). */\n  function sync() {\n    for (const e of extensions.values()) e.sync?.()\n  }\n\n  /** The `status` of the first search-stage slice that reports one (§6.3). */\n  function searchStatus(): unknown {\n    for (const f of pipeline) {\n      if (f.stage !== 'search') continue\n      const s = (snapshot as Record<string, unknown> | undefined)?.[f.name]\n      if (s !== null && typeof s === 'object' && 'status' in s) {\n        const v = (s as { status: unknown }).status\n        if (v !== 'idle') return v\n      }\n    }\n    return 'idle'\n  }\n\n  /** A row model change not caused by state: recompute and notify on the next flush. */\n  function touch() {\n    pending = true\n    rowModelDirty = true\n  }\n\n  /** Recomputes the row model if data, state or columns changed (never after destroy). */\n  function ensureRowModel() {\n    if (!rowModelDirty || destroyed) return\n    rowModelDirty = false\n    runner.run()\n  }\n\n  function getRowModel(): RowModel<T> {\n    ensureRowModel()\n    // Only empty when destroyed before the first run.\n    return (\n      runner.current() ?? {\n        rows: EMPTY,\n        filteredCount: 0,\n        totalCount: 0,\n        status: status(),\n        isInitialLoad: !loaded,\n      }\n    )\n  }\n\n  /**\n   * Applies the result of the latest `data:ingest`. A fallback (the boundary set `FAILED`) keeps\n   * the previous data, sets `status: 'error'` and never marks the table loaded (§6.6, §8.6).\n   */\n  function applyIngest(out: readonly unknown[], failed: boolean, given: boolean, initial = false) {\n    if (validatingSeq !== 0) {\n      validatingSeq = 0\n      touch()\n    }\n    if (failed) {\n      ingestFailed = true\n      touch()\n      return\n    }\n    if (ingestFailed) {\n      ingestFailed = false\n      touch()\n    }\n    schemaOutcome = schemaIngest?.outcome(out)\n    setData(out as readonly T[], given)\n    // `initialData` is the initial async result only while it is the data (§7.2).\n    initialRows = initial ? out : undefined\n  }\n\n  /**\n   * `data:ingest` with the previous data as fallback: the schema step (§5.1) runs in its core. An\n   * async result is applied if still latest. `fetched`: rows of an applied fetcher result (§7.1),\n   * ingested like `options.data` (schema, data checks) and marking the table loaded.\n   */\n  function ingest(fetched?: readonly unknown[]) {\n    const seq = ++ingestSeq\n    // At creation, `initialData` stands in for a missing `data` (§7.2); read once.\n    const initial = fetched === undefined && initialInput !== undefined\n    const input = fetched ?? (initial ? initialInput : options.data)\n    initialInput = undefined\n    const given = input !== undefined\n    const source: Trigger = fetched ? 'fetch' : 'data-change'\n    // A validation still in flight is superseded (its result is discarded): not 'validating' now,\n    // unless this ingest's own schema step goes async.\n    if (validatingSeq !== 0) {\n      validatingSeq = 0\n      touch()\n    }\n    try {\n      withTrigger(source, () => {\n        const ctx = createContext(\n          'data:ingest',\n          { data: input ?? EMPTY },\n          fetched ? 'fetcher' : initial ? 'options.initialData' : 'options.data',\n          base(),\n        )\n        ctx.meta.set(FALLBACK, data)\n        let sync = true\n        const out = runtime.run('data:ingest', ctx, (c) => {\n          const input = c.input.data as readonly unknown[]\n          if (!schemaIngest) return input\n          const r = schemaIngest.validate(input, c.emit)\n          if (isThenable(r) && seq === ingestSeq && !destroyed) {\n            // 'validating' is never silent: a new row model and a notification now (§6.6).\n            validatingSeq = seq\n            touch()\n            if (!sync) flush()\n          }\n          return r\n        })\n        sync = false\n        if (!isThenable(out)) {\n          applyIngest(out, ctx.meta.has(FAILED), given, initial)\n          return\n        }\n        const settle = (d: readonly unknown[], failed: boolean) => {\n          if (seq !== ingestSeq || destroyed) return\n          withTrigger(source, () => {\n            applyIngest(d, failed, given, initial)\n            flush()\n          })\n        }\n        Promise.resolve(out).then(\n          (d) => settle(d, ctx.meta.has(FAILED)),\n          // A DatakableError the boundary rethrew (strict, or `invalidRows: 'throw'` with an async\n          // schema, already reported): the previous data is kept with 'error'. No unhandled\n          // rejection either way (§8.6).\n          () => settle(data, true),\n        )\n      })\n    } finally {\n      // Dev (§5.3): fingerprint `data` after the core read it, so the check never takes reads\n      // first; also when the ingest threw, so a later same-reference check compares this data.\n      if (!fetched) dataCheck?.remember(options.data)\n    }\n  }\n\n  // --- API ---------------------------------------------------------------------------------------\n\n  /** `state:dispatch` (where = `slot`, a constant method / feature name); notifies unless batched. */\n  function update(updater: Updater<S>, slot: string) {\n    void op('state:dispatch', { updater }, slot, (): undefined => {\n      dispatch(updater, slot)\n    })\n    if (apiDepth === 0) flush()\n  }\n\n  function setState(updater: Updater<S>) {\n    if (destroyed) return destroyedCall('setState')\n    if (!admit(typeof updater === 'function' ? [] : Object.keys(updater ?? {}))) return\n    withTrigger('api:setState', () => update(updater, 'setState'))\n  }\n\n  // --- features ----------------------------------------------------------------------------------\n\n  /** A feature's `ctx.setState`: replaces its own slice (trigger: the API call's, if any). */\n  function setSlice(name: string, updater: SliceUpdater<unknown>) {\n    if (destroyed) return destroyedCall(`${name}.setState`)\n    if (!admit([name])) return\n    const slice: Updater<S> =\n      typeof updater === 'function'\n        ? (prev) => ({ [name]: (updater as (p: unknown) => unknown)(prev[name]) }) as Partial<S>\n        : ({ [name]: updater } as Partial<S>)\n    update(slice, name)\n  }\n\n  /** Runs a feature API method (wrapped once by `installApis`). */\n  function callApi(method: string, fn: () => unknown, ifDestroyed?: () => unknown): unknown {\n    if (destroyed) {\n      destroyedCall(method)\n      return ifDestroyed?.()\n    }\n    return withTrigger(`api:${method}`, () => {\n      apiDepth++\n      try {\n        return fn()\n      } finally {\n        apiDepth--\n        if (apiDepth === 0) flush()\n      }\n    })\n  }\n\n  function subscribe(listener: Listener<S>): () => void {\n    if (destroyed) {\n      destroyedCall('subscribe')\n      return () => {}\n    }\n    const id = ++listenerSeq\n    listeners.set(id, listener)\n    return () => {\n      listeners.delete(id)\n    }\n  }\n\n  function setOptions(partial: Partial<TableOptions<T, S>>) {\n    if (destroyed) return destroyedCall('setOptions')\n    if (!admit(Object.keys(partial.state ?? {}))) return\n    withTrigger('setOptions', () => {\n      const previous = options\n      const next = { ...options, ...partial }\n      // Option validator (§3.4, `table:setOptions`, development): an invalid value throws before\n      // anything changes. Read-once options (`features`, `timeout`, `diagnostics`, …) keep their\n      // value in every build.\n      if ((process.env.NODE_ENV !== \"production\")) validateOptionChange(partial, next, previous, { table: hub.table, emit: hub.emit })\n      else keepReadOnce(partial, next, previous)\n      if ('fetcher' in partial) useServer(next.fetcher, 'setOptions')?.check(next.fetcher)\n      void op('table:setOptions', { options: next, previous }, 'options', (): undefined => {\n        options = next\n        if (next.interceptors !== previous.interceptors) {\n          runtime.setInterceptors(withFront(next.interceptors))\n        }\n        if ('state' in partial || 'onStateChange' in partial) syncControlled()\n        if (next.columns !== previous.columns || next.rowKey !== previous.rowKey) {\n          rowModelDirty = true\n          pending = true\n        }\n        // The page count changed (§6.5): listeners re-read it (and pagination clamps).\n        if (next.rowCount !== previous.rowCount) pending = true\n        // A new fetcher reference runs at once, even with the same params (flush → sync).\n        if (next.fetcher !== previous.fetcher) server?.reset()\n        // New data is checked when applied (setData); same data with new columns is checked here.\n        if (next.data !== previous.data) ingest()\n        else {\n          if ('data' in partial) dataCheck?.check(next.data)\n          if (next.columns !== previous.columns) dataChecks?.check(data, next.columns)\n        }\n      })\n      flush()\n    })\n  }\n\n  function destroy() {\n    if (destroyed) return\n    withTrigger('api:destroy', () => {\n      try {\n        void op('table:destroy', undefined, 'destroy', (): undefined => {\n          destroyed = true\n        })\n      } finally {\n        // Even if an interceptor skipped the core: the table is destroyed.\n        destroyed = true\n        ingestSeq++\n        listeners.clear()\n        runner.dispose()\n        if ((process.env.NODE_ENV !== \"production\")) feedback?.dispose()\n      }\n    })\n  }\n\n  // --- extensions (§9.3) ---------------------------------------------------------------------\n\n  function batch<R>(t: Trigger, fn: () => R): R {\n    return withTrigger(t, () => {\n      apiDepth++\n      try {\n        return fn()\n      } finally {\n        apiDepth--\n        if (apiDepth === 0) flush()\n      }\n    })\n  }\n\n  const host: TableHost = {\n    table: table as unknown as Table<unknown, TableState>,\n    name: hub.table,\n    emit: hub.emit,\n    runtime,\n    features: pipeline,\n    options: () => options as TableOptions<unknown>,\n    state: () => snapshot,\n    base,\n    destroyed: () => destroyed,\n    loaded: () => loaded,\n    status,\n    touch,\n    notify: () => {\n      if (apiDepth === 0) flush()\n    },\n    batch,\n    ingest: (rows) => ingest(rows),\n    intercept(interceptor) {\n      front.push(interceptor)\n      runtime.setInterceptors(withFront(options.interceptors))\n    },\n    deferring: () => deferring,\n    use,\n  }\n\n  function use<E extends TableExtension>(factory: ExtensionFactory<E>): E {\n    let e = extensions.get(factory as ExtensionFactory<TableExtension>) as E | undefined\n    if (!e) {\n      e = factory(host)\n      extensions.set(factory as ExtensionFactory<TableExtension>, e)\n    }\n    return e\n  }\n\n  /** The server source a `withFetcher` fetcher brings (created once); else the current one. */\n  function useServer(fetcher: unknown, phase?: 'setOptions'): ServerSource | undefined {\n    const factory = (fetcher as Partial<ServerFetcher<unknown>> | undefined)?.[SERVER_SOURCE]\n    if (factory) server = use(factory)\n    // Never silent (§8.6): in production an unwrapped fetcher would never run.\n    else if (fetcher) unwrapped('fetcher', 'withFetcher', phase)\n    return server\n  }\n\n  /**\n   * `DK_INVALID_OPTION` for a schema / fetcher not wrapped with its opt-in import (§5.1, §7.1). A\n   * production check: in development the option validator reports it first, with the full text.\n   */\n  function unwrapped(\n    path: 'schema' | 'fetcher',\n    wrap: string,\n    phase: 'init' | 'setOptions' = 'init',\n  ): never {\n    return throwConfigError(\n      'DK_INVALID_OPTION',\n      { path, expected: `${wrap}(${path})`, received: path, suggestions: [], phase },\n      { table: hub.table, trigger: phase },\n    )\n  }\n\n  /**\n   * Runs the fetcher again with the current params (§7.1); never rejects. Without a fetcher:\n   * `{ status: 'applied' }` at once.\n   */\n  function refetch(): Promise<FetchOutcome> {\n    if (destroyed) {\n      destroyedCall('refetch')\n      return Promise.resolve({ status: 'superseded' })\n    }\n    return (\n      withTrigger('api:refetch', () => server?.sync(true)) ?? Promise.resolve({ status: 'applied' })\n    )\n  }\n\n  /** `startTable` (§7.2): the deferred work starts; listeners see the new status at once. */\n  function start() {\n    if (!deferring || destroyed) return\n    deferring = false\n    let had = false\n    for (const e of extensions.values()) if (e.start?.()) had = true\n    if (!had) return\n    // The pipeline re-runs: 'pending' ends and the search feature's check starts its searchFn.\n    touch()\n    withTrigger('hydrate', () => flush())\n  }\n\n  setTableInternals(table, {\n    features: pipeline,\n    rowCount: () => (typeof options.fetcher === 'function' ? server?.rowCount() : options.rowCount),\n    hasFetcher: () => typeof options.fetcher === 'function',\n    emit: hub.emit,\n    use,\n    peek: (factory) => extensions.get(factory as ExtensionFactory<TableExtension>) as never,\n    extensions: () => extensions.values(),\n    start,\n    initialRows: () =>\n      initialRows !== undefined && initialRows === data ? initialRows : undefined,\n  })\n\n  // --- init --------------------------------------------------------------------------------------\n\n  controlled = controlledKeys(options.state)\n  if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n  // Feature `initialState()` slices, with `options.initialState` on top per slice.\n  snapshot = overlay(\n    freeze(\n      (rt\n        ? rt.initialSlices(features, options.initialState, hub.emit)\n        : { ...options.initialState }) as S,\n    ),\n  )\n  notified = snapshot\n  // Merges the feature APIs onto the table; a name clash throws DK_FEATURE_API_CONFLICT.\n  rt?.installApis(features, {\n    table: table as unknown as Table<unknown, TableState>,\n    tableName: hub.table,\n    emit: hub.emit,\n    getSlice: (name) => snapshot[name],\n    setSlice,\n    call: callApi,\n  })\n  // Server source (§7.1): with a `withFetcher` fetcher (throws DK_FETCHER_WITHOUT_SERVER_MODE).\n  useServer(options.fetcher)\n  withTrigger('init', () => {\n    // `void`: sync ops never return a promise (op kinds, §3.4).\n    void op('table:init', { options }, 'options', (): undefined => {\n      // Ingest first: dedupe is per data reference, so warnings follow the initial data.\n      ingest()\n      warnControlled(undefined)\n    })\n    // Server source (§7.1): the first request starts now ('fetching', isInitialLoad: true), unless\n    // initialData answered the initial server state (§7.2).\n    sync()\n  })\n  pending = false\n  return table\n}\n"],"mappings":"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","names":["import_runtime","import_codes","sync","input"]}
+{"version":3,"sources":["../../src/table/create-table.ts"],"sourcesContent":["import { optionDiagnostics } from '../catalog/codes'\nimport { validateOptionChange, validateOptions } from '../catalog/validator'\nimport { DatakableError, defaultPhase, throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { type ExplainHost, explainRow, explainTable } from '../diagnostics/explain'\nimport { createDiagnostics } from '../diagnostics/hub'\nimport { pathsOverlap, type RedactionOptions } from '../diagnostics/redact'\nimport { tracer } from '../diagnostics/tracer'\nimport type { Trigger } from '../diagnostics/types'\nimport { runtimeFor } from '../feature/runtime'\nimport type { AnyFeature, ApiOf, SliceUpdater, TableStateFor } from '../feature/types'\nimport { createDataChecks } from '../ingest/data-checks'\nimport { createDerivedColumns } from '../ingest/derive-columns'\nimport type { SchemaOutcome } from '../ingest/schema'\nimport { SCHEMA_INGEST, type TableSchema } from '../ingest/schema-brand'\nimport type { InvalidRowsMode } from '../ingest/schema-codes'\nimport type { StandardSchemaV1 } from '../ingest/standard-schema'\nimport { errorBoundary } from '../intercept/boundary'\nimport { callUser, errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { FAILED, FALLBACK } from '../intercept/fallbacks'\nimport type { OpInput, OpName, OpResult } from '../intercept/operations'\nimport { type Core, createInterceptorRuntime } from '../intercept/runtime'\nimport { createPipeline } from '../pipeline/runner'\nimport type { RowModel, RowModelStatus } from '../pipeline/types'\nimport { checkModeOrder, type FetchOutcome } from '../source/fetcher'\nimport type { ServerSource } from '../source/server'\nimport { SERVER_SOURCE, type ServerFetcher } from '../source/server-brand'\nimport { checkVersions } from '../versioning/registry'\nimport { tableDiagnostics } from './codes'\nimport { createDataMutationCheck, dataMutationDiagnostics } from './data-mutation'\nimport {\n  deferral,\n  type ExtensionFactory,\n  setTableInternals,\n  type TableExtension,\n  type TableHost,\n} from './internals'\nimport { keepReadOnce } from './read-once'\nimport { createStateFeedbackCheck, stateFeedbackDiagnostics } from './state-feedback'\nimport {\n  type ControlledState,\n  type Listener,\n  type Table,\n  type TableOptions,\n  type TableState,\n  UPDATE_DEPTH_LIMIT,\n  type Updater,\n} from './types'\n\nkeepDiagnostics(\n  tableDiagnostics,\n  dataMutationDiagnostics,\n  stateFeedbackDiagnostics,\n  optionDiagnostics,\n)\n\nconst EMPTY: readonly never[] = []\n\n/** §6.6 status precedence, lowest first: the table shows the highest of its sources. */\nconst RANK: readonly RowModelStatus[] = [\n  'idle',\n  'pending',\n  'validating',\n  'searching',\n  'fetching',\n  'error',\n]\n\nconst isThenable = (v: unknown): v is PromiseLike<unknown> =>\n  v != null && typeof (v as { then?: unknown }).then === 'function'\n\n/** Objects already deep-frozen (dev): an unchanged slice is not walked again on the next commit. */\nconst deepFrozen = (process.env.NODE_ENV !== \"production\") ? new WeakSet<object>() : undefined\n\n/**\n * Freezes plain objects and arrays reachable from `v` (dev). Class instances (Date, Map, typed\n * arrays, user classes) are left alone: freezing them would break their own methods.\n */\nfunction deepFreeze(v: unknown): void {\n  if (v === null || typeof v !== 'object' || deepFrozen?.has(v)) return\n  const isArray = Array.isArray(v)\n  if (!isArray) {\n    const proto = Object.getPrototypeOf(v)\n    if (proto !== Object.prototype && proto !== null) return\n  }\n  deepFrozen?.add(v)\n  Object.freeze(v)\n  if (isArray) for (let i = 0; i < v.length; i++) deepFreeze(v[i])\n  else for (const k in v) deepFreeze((v as Record<string, unknown>)[k])\n}\n\n/** Snapshots and their slices are immutable in development (#20); production skips the walk. */\nconst freeze = <S extends object>(s: S): S => {\n  if ((process.env.NODE_ENV !== \"production\")) deepFreeze(s)\n  return s\n}\n\n/** The row type: the schema output with a `schema` (§5.1), else `T`. */\nexport type SchemaRow<T, Sch> = [Sch] extends [TableSchema] ? StandardSchemaV1.InferOutput<Sch> : T\n\n/**\n * `createTable` options: with a `schema`, the row type is its output and `data` is the raw input\n * (`unknown[]`, e.g. parsed JSON), validated per row.\n */\nexport type CreateTableOptions<T, S extends TableState, Sch, M extends InvalidRowsMode> = Omit<\n  TableOptions<SchemaRow<T, Sch>, S>,\n  'data' | 'schema' | 'invalidRows' | 'fetcher' | 'initialData'\n> & {\n  data?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n  /** With a schema, the raw rows (validated like `data`). */\n  initialData?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n  /** With a schema, the fetcher returns raw rows (validated like `data`). */\n  fetcher?: ServerFetcher<[Sch] extends [TableSchema] ? unknown : T>\n  // Without an inferred schema (explicit type arguments, a `TableOptions<T>` object) these keep\n  // their `TableOptions` types.\n  schema?: [Sch] extends [TableSchema] ? Sch : TableSchema<unknown, T>\n  invalidRows?: [Sch] extends [TableSchema] ? M : InvalidRowsMode\n}\n\n/** Column id: `key` for key columns, `id` for accessor columns. */\nconst columnId = (c: { key?: unknown; id?: unknown }): unknown => c.key ?? c.id\n\n/**\n * Creates the table store (§3.2): immutable state snapshots, controlled slices, isolated listeners,\n * a re-entrancy guard and `destroy()`. Every unit of work runs as an operation (§3.4) through the\n * table's interceptor runtime, with the errorBoundary outermost and diagnostics on a per-table hub.\n *\n * `ctx.where` is always a constant option path or method name (`options`, `options.data`,\n * `setState`, `destroy`): it reaches fingerprints, docs URLs and issue links unredacted, so it must\n * never carry row keys or cell values.\n */\nexport function createTable<\n  T,\n  S extends TableState = never,\n  const Fs extends readonly AnyFeature[] = [],\n  const Sch extends TableSchema | undefined = undefined,\n  const M extends InvalidRowsMode = 'drop',\n>(\n  options: CreateTableOptions<T, TableStateFor<S, Fs, SchemaRow<T, Sch>>, Sch, M> & {\n    features?: Fs\n  },\n): Table<\n  SchemaRow<T, Sch>,\n  TableStateFor<S, Fs, SchemaRow<T, Sch>>,\n  M,\n  [Sch] extends [TableSchema] ? unknown : T\n> &\n  ApiOf<Fs, SchemaRow<T, Sch>>\nexport function createTable<T, S extends TableState>(\n  initialOptions: TableOptions<T, S>,\n): Table<T, S> {\n  let options: TableOptions<T, S> = { ...initialOptions }\n  let destroyed = false\n  let trigger: Trigger = 'init'\n  /** Pipeline run id; each `pipeline:run` increments it. */\n  let run = 0\n  let data: readonly T[] = EMPTY\n  let ingestSeq = 0\n  /** Data given by the user has been applied once (`RowModel.isInitialLoad`, §6.6). */\n  let loaded = false\n  /** The last `data:ingest` failed (op fallback): `status: 'error'` until one succeeds (§6.6). */\n  let ingestFailed = false\n  /** The ingest whose async schema validation is in flight (`status: 'validating'`); 0: none. */\n  let validatingSeq = 0\n  /** Rows of the current data that failed the schema (`getInvalidRows`, §5.1). */\n  let schemaOutcome: SchemaOutcome | undefined\n  /**\n   * SSR (§7.2): `options.initialData` until the creation ingest read it (`undefined` with `data`),\n   * then its ingested rows while they are the table's data (`initialRows`).\n   */\n  let initialInput = options.data === undefined ? options.initialData : undefined\n  let initialRows: readonly unknown[] | undefined\n  /** Created inside `createDeferred` (§7.2): async work waits for `startTable`. */\n  let deferring = deferral.depth > 0\n  /**\n   * Opt-in parts of the store (`TableInternals.use`): the async request machinery and the server\n   * source. A table without an async source creates none (§9.3).\n   */\n  const extensions = new Map<ExtensionFactory<TableExtension>, TableExtension>()\n  /** The server source (`withFetcher`, §7.1), once a fetcher was given. */\n  let server: ServerSource | undefined\n\n  let controlled = new Set<string>()\n  let snapshot: S\n  /** The snapshot listeners last saw (`prev` of the next notification). */\n  let notified: S\n  /** A committed change (state or data) not yet notified. */\n  let pending = false\n  let notifying = false\n  let rounds = 0\n  let loopReported = false\n  let current: number | undefined\n  let listenerSeq = 0\n  const listeners = new Map<number, Listener<S>>()\n  /** Depth of feature API calls in progress: listeners are notified when the outermost returns. */\n  let apiDepth = 0\n  /** Data, state or columns changed since the row model was computed. */\n  let rowModelDirty = true\n  /** Diagnostic context (§8.1): the data mode of each pipeline feature (set once features load). */\n  const modes: Record<string, 'client' | 'server'> = {}\n\n  const table: Table<T, S> = {\n    getState: () => snapshot,\n    setState,\n    subscribe,\n    setOptions,\n    getOptions: () => options,\n    getData: () => data,\n    // Core method: on the literal before installApis, so no feature can take the name.\n    getRowModel,\n    getInvalidRows: () => schemaOutcome?.invalid ?? EMPTY,\n    getDiagnostics: () => hub.getDiagnostics(),\n    // Core methods (§8.4), read-only: also on the literal before installApis.\n    explain: () => explainTable(explainHost),\n    explainRow: (key) => explainRow(explainHost, key),\n    refetch,\n    destroy,\n  }\n\n  // Redaction (§8.2): `diagnostics.redact` gives the level or a custom rule; column defs give the\n  // sensitive columns and whether the rowKey column is sensitive. Both are read per emit, so\n  // `setOptions({ columns })` is followed.\n  const redactOption = options.diagnostics?.redact\n  const redaction: RedactionOptions = {\n    ...(typeof redactOption === 'string' ? { level: redactOption } : {}),\n    ...(typeof redactOption === 'function' ? { redact: redactOption } : {}),\n    sensitiveColumns,\n    // A rowKey path into (or above) a sensitive column reads its data too (#45).\n    rowKeySensitive: () => {\n      const k = options.rowKey\n      return typeof k === 'string' && sensitiveColumns().some((c) => pathsOverlap(k, c))\n    },\n  }\n  const hub = createDiagnostics({\n    ...(options.name === undefined ? {} : { name: options.name }),\n    table,\n    onDiagnostic: (d) => options.onDiagnostic?.(d),\n    ...(options.strict === undefined ? {} : { strict: options.strict }),\n    getContext: () => ({ trigger, run, mode: modes }),\n    getDataRef: () => data,\n    redaction,\n  })\n  // Option validator (§3.4, `table:init`), development only: before anything reads the options.\n  // Invalid values throw DK_INVALID_OPTION; unknown / no-effect options are reported on the hub.\n  if ((process.env.NODE_ENV !== \"production\")) validateOptions(options, { table: hub.table, emit: hub.emit })\n  // Features (§3.3) are read once, at creation. `features` is the listed order (API install, conflict\n  // reports); `pipeline` is stage order for the runner. Duplicates throw here (config error).\n  const features: readonly AnyFeature[] = options.features ?? EMPTY\n  // The feature runtime comes with the features (`defineFeature`): none for a table without.\n  const rt = runtimeFor(features)\n  const pipeline = rt ? rt.orderFeatures(features, hub.table) : EMPTY\n  // Data modes (§7.1): DK_MODE_ORDER (a config error, development). A fetcher without a server-mode\n  // feature (DK_FETCHER_WITHOUT_SERVER_MODE) is checked by the server source.\n  if ((process.env.NODE_ENV !== \"production\")) checkModeOrder(pipeline, hub.table)\n  for (const f of pipeline) if (f.stage !== 'none') modes[f.name] = f.mode ?? 'client'\n  // Extension interceptors come first (asyncControl, one per table, installed with the first async\n  // source: user / feature interceptors and the core see its signal); the boundary stays\n  // outermost. Feature interceptors (pipeline order) come next, then the user's.\n  const front: Interceptor<OpName>[] = []\n  const featureInterceptors = pipeline.flatMap((f) => f.interceptors ?? EMPTY)\n  // The tracer (§3.4, explain timings) is development-only: `(process.env.NODE_ENV !== \"production\")` folds to `false` in production\n  // builds, which drops it from the bundle; there it is opt-in with `interceptors: [tracer()]`.\n  const traced = (process.env.NODE_ENV !== \"production\") ? [tracer() as Interceptor<OpName>] : EMPTY\n  const withFront = (list: readonly Interceptor<OpName>[] | undefined) => [\n    ...front,\n    ...traced,\n    ...featureInterceptors,\n    ...(list ?? EMPTY),\n  ]\n  const runtime = createInterceptorRuntime({\n    interceptors: withFront(options.interceptors),\n    emit: hub.emit,\n  })\n  runtime.installBoundary(errorBoundary)\n  hub.attach(runtime)\n  // Dev check (§5.3): the same `data` array passed again with changed contents (DK_DATA_MUTATED).\n  const dataCheck = (process.env.NODE_ENV !== \"production\") ? createDataMutationCheck(hub.emit) : undefined\n  // Feature `requires.core` (throws DK_FEATURE_INCOMPATIBLE), duplicate cores, version mismatch\n  // (§8.5): development checks (changed 2026-10-13 for §9.3).\n  if ((process.env.NODE_ENV !== \"production\")) checkVersions(features, hub.emit, hub.table)\n  // Ingest data checks (§5.3) and zero-config columns (§4.1): both read only the first rows.\n  // The data checks are developer hints: development only (changed 2026-10-13 for §9.3).\n  const dataChecks = (process.env.NODE_ENV !== \"production\") ? createDataChecks(hub.emit) : undefined\n  /** Controlled changes not fed back (DK_CONTROLLED_NOT_FED_BACK, development). */\n  const feedback = (process.env.NODE_ENV !== \"production\") ? createStateFeedbackCheck(hub.emit) : undefined\n  const derivedColumns = createDerivedColumns()\n  // Schema ingest (§5.1): `schema` and `invalidRows` are read once (validated above). The step\n  // comes with the schema (`withSchema`, `@datakable/core/schema`): a table without one never\n  // bundles it.\n  const schemaIngest = (options.schema as Partial<TableSchema> | undefined)?.[SCHEMA_INGEST]?.(\n    options.invalidRows ?? 'drop',\n    () => options.columns,\n  )\n  // Never silent (§8.6): in production (no option validator) an unwrapped schema would be ignored.\n  if (options.schema && !schemaIngest) unwrapped('schema', options.schema, 'withSchema')\n\n  function sensitiveColumns(): string[] {\n    const out: string[] = []\n    for (const c of options.columns ?? EMPTY) {\n      const id = columnId(c as { key?: unknown; id?: unknown })\n      if (c.sensitive && typeof id === 'string') out.push(id)\n    }\n    return out\n  }\n\n  function base(): ContextBase {\n    return { table, run, trigger, phase: defaultPhase(), emit: hub.emit }\n  }\n\n  function op<O extends OpName>(\n    name: O,\n    input: OpInput<O>,\n    where: string,\n    core: Core<O>,\n    fallback?: unknown,\n  ): OpResult<O> {\n    const ctx = createContext(name, input, where, base())\n    if (fallback !== undefined) ctx.meta.set(FALLBACK, fallback)\n    return runtime.run(name, ctx, core)\n  }\n\n  function withTrigger<R>(t: Trigger, fn: () => R): R {\n    const prev = trigger\n    trigger = t\n    try {\n      return fn()\n    } finally {\n      trigger = prev\n    }\n  }\n\n  // --- state -------------------------------------------------------------------------------------\n\n  function controlledKeys(state: ControlledState<S> | undefined): Set<string> {\n    const keys = new Set<string>()\n    if (state) for (const k of Object.keys(state)) if (state[k] !== undefined) keys.add(k)\n    return keys\n  }\n\n  /** `s` with the controlled slices from `options.state`; `s` itself when none differ. */\n  function overlay(s: S): S {\n    let next: TableState | undefined\n    const state = options.state as TableState | undefined\n    if (state) {\n      for (const k of controlled) {\n        if (!Object.is(s[k], state[k])) {\n          next ??= { ...s }\n          next[k] = state[k]\n        }\n      }\n    }\n    return next ? freeze(next as S) : s\n  }\n\n  function commit(next: S) {\n    snapshot = next\n    pending = true\n    rowModelDirty = true\n  }\n\n  function warnControlled(dropped: string[] | undefined) {\n    if (options.onStateChange || controlled.size === 0) return\n    const slices = dropped ?? [...controlled]\n    hub.emit('DK_CONTROLLED_WITHOUT_HANDLER', { slices, dropped: dropped !== undefined })\n  }\n\n  function syncControlled() {\n    controlled = controlledKeys(options.state)\n    const next = overlay(snapshot)\n    if (next !== snapshot) commit(next)\n    if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n    warnControlled(undefined)\n  }\n\n  function dispatch(updater: Updater<S>, slot: string) {\n    // A method argument, not an option: `where` = `operation table.setState at updater`.\n    const partial: Partial<S> =\n      typeof updater === 'function'\n        ? callUser(\n            'updater',\n            updater,\n            snapshot,\n            undefined,\n            slot === 'setState' ? 'table.setState' : `${slot}.setState`,\n          )\n        : updater\n    if (partial === null || typeof partial !== 'object') return\n    let next: TableState | undefined\n    let changes: TableState | undefined\n    let dropped: string[] | undefined\n    for (const k of Object.keys(partial)) {\n      const v = (partial as TableState)[k]\n      if (Object.is(snapshot[k], v)) continue\n      if (controlled.has(k)) {\n        if (options.onStateChange) {\n          changes ??= {}\n          changes[k] = v\n        } else {\n          dropped ??= []\n          dropped.push(k)\n        }\n        continue\n      }\n      next ??= { ...snapshot }\n      next[k] = v\n    }\n    // The owner is told first: if onStateChange throws, nothing is committed (state unchanged).\n    if (changes && options.onStateChange) {\n      const c = changes as Partial<S>\n      if ((process.env.NODE_ENV !== \"production\")) feedback?.ask(Object.keys(changes), trigger)\n      callUser('onStateChange', options.onStateChange, (prev: Partial<S>) => ({ ...prev, ...c }))\n      if ((process.env.NODE_ENV !== \"production\")) feedback?.asked()\n    }\n    if (next) commit(freeze(next as S))\n    if (dropped) warnControlled(dropped)\n  }\n\n  /**\n   * Notifies listeners until no change is pending. Updates made by listeners are committed at once\n   * and notified in the next round (not nested), so every listener sees rounds in order.\n   */\n  function flush() {\n    if (notifying) return\n    sync()\n    if (!pending) return\n    notifying = true\n    let rethrow: unknown\n    try {\n      while (pending && !destroyed) {\n        // Server state changed (this round's state): the fetch starts in the same notification.\n        sync()\n        pending = false\n        rounds++\n        const prev = notified\n        const state = snapshot\n        notified = state\n        // Listeners read the row model of the state they are notified with.\n        ensureRowModel()\n        for (const [id, listener] of [...listeners]) {\n          // A listener may destroy the table: the rest of the round is not notified.\n          if (destroyed) break\n          current = id\n          try {\n            listener(state, prev)\n          } catch (e) {\n            // strict: a DatakableError (e.g. DK_UPDATE_LOOP) thrown inside the listener.\n            if (e instanceof DatakableError) {\n              rethrow ??= e\n              continue\n            }\n            try {\n              const name = errorName(e)\n              hub.emit(\n                'DK_LISTENER_FAILED',\n                { listener: id, ...(name === undefined ? {} : { errorName: name }) },\n                { cause: e },\n              )\n            } catch (strictError) {\n              rethrow ??= strictError\n            }\n          }\n        }\n      }\n    } finally {\n      notifying = false\n      rounds = 0\n      loopReported = false\n      current = undefined\n    }\n    if (rethrow !== undefined) throw rethrow\n  }\n\n  /** `false` (and one `DK_UPDATE_LOOP`) when a re-entrant update would exceed the depth limit. */\n  function admit(slices: string[]): boolean {\n    if (!notifying || rounds < UPDATE_DEPTH_LIMIT) return true\n    if (!loopReported) {\n      loopReported = true\n      hub.emit('DK_UPDATE_LOOP', {\n        limit: UPDATE_DEPTH_LIMIT,\n        slices,\n        ...(current === undefined ? {} : { listener: current }),\n      })\n    }\n    return false\n  }\n\n  function destroyedCall(method: string) {\n    withTrigger(`api:${method}`, () => hub.emit('DK_TABLE_DESTROYED', { method }))\n  }\n\n  // --- data --------------------------------------------------------------------------------------\n\n  /** Applies ingested data; `given`: it came from a user `options.data` (marks the first load). */\n  function setData(next: readonly T[], given: boolean) {\n    if (given && !loaded) {\n      // isInitialLoad flips: a new row model and a notification even for the same reference.\n      loaded = true\n      pending = true\n      rowModelDirty = true\n    }\n    if (next === data) return\n    data = next\n    pending = true\n    // After `data` is set: diagnostics dedupe per data reference.\n    if ((process.env.NODE_ENV !== \"production\")) dataChecks?.check(data, options.columns)\n    // The pipeline runs before the next notification (or on getRowModel), as `pipeline:run` with\n    // ctx.meta[FALLBACK] = the last good row model (pipeline/runner.ts).\n    rowModelDirty = true\n  }\n\n  // --- row model ---------------------------------------------------------------------------------\n\n  const runner = createPipeline<T>({\n    runtime,\n    featureRuntime: rt,\n    emit: hub.emit,\n    features: pipeline,\n    listed: features,\n    base,\n    nextRun: () => ++run,\n    getData: () => data,\n    getState: () => snapshot,\n    getColumns: () => options.columns ?? derivedColumns(data),\n    getRowKey: () => options.rowKey,\n    isInitialLoad: () => !loaded,\n    status,\n    issues: (index) => schemaOutcome?.flagged?.get(index),\n    flagMode: schemaIngest !== undefined && options.invalidRows === 'flag',\n    // Time-sliced work ended (§9.1): 'pending' → the finished row model, never silent (§6.6).\n    refresh: (t) => {\n      if (destroyed) return\n      withTrigger(t, () => {\n        touch()\n        if (apiDepth === 0) flush()\n      })\n    },\n  })\n\n  const explainHost: ExplainHost = {\n    table,\n    features: pipeline,\n    rowModel: getRowModel as () => RowModel<unknown>,\n    lastRun: runner.lastRun,\n    replay: runner.replayContext,\n    data: () => data,\n    state: () => snapshot,\n    rowKey: () => options.rowKey,\n    schemaMode: () => (schemaIngest ? (options.invalidRows ?? 'drop') : undefined),\n    schema: () => schemaOutcome,\n    diagnostics: () => hub.getDiagnostics(),\n    redaction,\n    ...(rt ? { detail: rt.explainDetail } : {}),\n  }\n\n  /**\n   * Status from outside the pipeline (§6.6): a failed ingest, a running async schema, the search\n   * slice (`pending` / `searching` / `error`), and the extensions' (a failed fetch, an in-flight\n   * fetcher / `searchFn`, deferred async work). Precedence: error > fetching > searching >\n   * validating > pending > idle.\n   */\n  function status(): RowModelStatus {\n    const search = searchStatus()\n    let s: RowModelStatus =\n      ingestFailed || search === 'error'\n        ? 'error'\n        : search === 'searching'\n          ? 'searching'\n          : validatingSeq !== 0\n            ? 'validating'\n            : search === 'pending'\n              ? 'pending'\n              : 'idle'\n    for (const e of extensions.values()) {\n      const x = e.status?.()\n      if (x !== undefined && RANK.indexOf(x) > RANK.indexOf(s)) s = x\n    }\n    return s\n  }\n\n  /** Extensions start work that follows state (the fetcher on server state, §7.1). */\n  function sync() {\n    for (const e of extensions.values()) e.sync?.()\n  }\n\n  /** The `status` of the first search-stage slice that reports one (§6.3). */\n  function searchStatus(): unknown {\n    for (const f of pipeline) {\n      if (f.stage !== 'search') continue\n      const s = (snapshot as Record<string, unknown> | undefined)?.[f.name]\n      if (s !== null && typeof s === 'object' && 'status' in s) {\n        const v = (s as { status: unknown }).status\n        if (v !== 'idle') return v\n      }\n    }\n    return 'idle'\n  }\n\n  /** A row model change not caused by state: recompute and notify on the next flush. */\n  function touch() {\n    pending = true\n    rowModelDirty = true\n  }\n\n  /** Recomputes the row model if data, state or columns changed (never after destroy). */\n  function ensureRowModel() {\n    if (!rowModelDirty || destroyed) return\n    rowModelDirty = false\n    runner.run()\n  }\n\n  function getRowModel(): RowModel<T> {\n    ensureRowModel()\n    // Only empty when destroyed before the first run.\n    return (\n      runner.current() ?? {\n        rows: EMPTY,\n        filteredCount: 0,\n        totalCount: 0,\n        status: status(),\n        isInitialLoad: !loaded,\n      }\n    )\n  }\n\n  /**\n   * Applies the result of the latest `data:ingest`. A fallback (the boundary set `FAILED`) keeps\n   * the previous data, sets `status: 'error'` and never marks the table loaded (§6.6, §8.6).\n   */\n  function applyIngest(out: readonly unknown[], failed: boolean, given: boolean, initial = false) {\n    if (validatingSeq !== 0) {\n      validatingSeq = 0\n      touch()\n    }\n    if (failed) {\n      ingestFailed = true\n      touch()\n      return\n    }\n    if (ingestFailed) {\n      ingestFailed = false\n      touch()\n    }\n    schemaOutcome = schemaIngest?.outcome(out)\n    setData(out as readonly T[], given)\n    // `initialData` is the initial async result only while it is the data (§7.2).\n    initialRows = initial ? out : undefined\n  }\n\n  /**\n   * `data:ingest` with the previous data as fallback: the schema step (§5.1) runs in its core. An\n   * async result is applied if still latest. `fetched`: rows of an applied fetcher result (§7.1),\n   * ingested like `options.data` (schema, data checks) and marking the table loaded.\n   */\n  function ingest(fetched?: readonly unknown[]) {\n    const seq = ++ingestSeq\n    // At creation, `initialData` stands in for a missing `data` (§7.2); read once.\n    const initial = fetched === undefined && initialInput !== undefined\n    const input = fetched ?? (initial ? initialInput : options.data)\n    initialInput = undefined\n    const given = input !== undefined\n    const source: Trigger = fetched ? 'fetch' : 'data-change'\n    // A validation still in flight is superseded (its result is discarded): not 'validating' now,\n    // unless this ingest's own schema step goes async.\n    if (validatingSeq !== 0) {\n      validatingSeq = 0\n      touch()\n    }\n    try {\n      withTrigger(source, () => {\n        const ctx = createContext(\n          'data:ingest',\n          { data: input ?? EMPTY },\n          fetched ? 'fetcher' : initial ? 'options.initialData' : 'options.data',\n          base(),\n        )\n        ctx.meta.set(FALLBACK, data)\n        let sync = true\n        const out = runtime.run('data:ingest', ctx, (c) => {\n          const input = c.input.data as readonly unknown[]\n          if (!schemaIngest) return input\n          const r = schemaIngest.validate(input, c.emit)\n          if (isThenable(r) && seq === ingestSeq && !destroyed) {\n            // 'validating' is never silent: a new row model and a notification now (§6.6).\n            validatingSeq = seq\n            touch()\n            if (!sync) flush()\n          }\n          return r\n        })\n        sync = false\n        if (!isThenable(out)) {\n          applyIngest(out, ctx.meta.has(FAILED), given, initial)\n          return\n        }\n        const settle = (d: readonly unknown[], failed: boolean) => {\n          if (seq !== ingestSeq || destroyed) return\n          withTrigger(source, () => {\n            applyIngest(d, failed, given, initial)\n            flush()\n          })\n        }\n        Promise.resolve(out).then(\n          (d) => settle(d, ctx.meta.has(FAILED)),\n          // A DatakableError the boundary rethrew (strict, or `invalidRows: 'throw'` with an async\n          // schema, already reported): the previous data is kept with 'error'. No unhandled\n          // rejection either way (§8.6).\n          () => settle(data, true),\n        )\n      })\n    } finally {\n      // Dev (§5.3): fingerprint `data` after the core read it, so the check never takes reads\n      // first; also when the ingest threw, so a later same-reference check compares this data.\n      if ((process.env.NODE_ENV !== \"production\") && !fetched) dataCheck?.remember(options.data)\n    }\n  }\n\n  // --- API ---------------------------------------------------------------------------------------\n\n  /** `state:dispatch` (where = `slot`, a constant method / feature name); notifies unless batched. */\n  function update(updater: Updater<S>, slot: string) {\n    void op('state:dispatch', { updater }, slot, (): undefined => {\n      dispatch(updater, slot)\n    })\n    if (apiDepth === 0) flush()\n  }\n\n  function setState(updater: Updater<S>) {\n    if (destroyed) return destroyedCall('setState')\n    if (!admit(typeof updater === 'function' ? [] : Object.keys(updater ?? {}))) return\n    withTrigger('api:setState', () => update(updater, 'setState'))\n  }\n\n  // --- features ----------------------------------------------------------------------------------\n\n  /** A feature's `ctx.setState`: replaces its own slice (trigger: the API call's, if any). */\n  function setSlice(name: string, updater: SliceUpdater<unknown>) {\n    if (destroyed) return destroyedCall(`${name}.setState`)\n    if (!admit([name])) return\n    const slice: Updater<S> =\n      typeof updater === 'function'\n        ? (prev) => ({ [name]: (updater as (p: unknown) => unknown)(prev[name]) }) as Partial<S>\n        : ({ [name]: updater } as Partial<S>)\n    update(slice, name)\n  }\n\n  /** Runs a feature API method (wrapped once by `installApis`). */\n  function callApi(method: string, fn: () => unknown, ifDestroyed?: () => unknown): unknown {\n    if (destroyed) {\n      destroyedCall(method)\n      return ifDestroyed?.()\n    }\n    return withTrigger(`api:${method}`, () => {\n      apiDepth++\n      try {\n        return fn()\n      } finally {\n        apiDepth--\n        if (apiDepth === 0) flush()\n      }\n    })\n  }\n\n  function subscribe(listener: Listener<S>): () => void {\n    if (destroyed) {\n      destroyedCall('subscribe')\n      return () => {}\n    }\n    const id = ++listenerSeq\n    listeners.set(id, listener)\n    return () => {\n      listeners.delete(id)\n    }\n  }\n\n  function setOptions(partial: Partial<TableOptions<T, S>>) {\n    if (destroyed) return destroyedCall('setOptions')\n    if (!admit(Object.keys(partial.state ?? {}))) return\n    withTrigger('setOptions', () => {\n      const previous = options\n      const next = { ...options, ...partial }\n      // Option validator (§3.4, `table:setOptions`, development): an invalid value throws before\n      // anything changes. Read-once options (`features`, `timeout`, `diagnostics`, …) keep their\n      // value in every build.\n      if ((process.env.NODE_ENV !== \"production\")) validateOptionChange(partial, next, previous, { table: hub.table, emit: hub.emit })\n      else keepReadOnce(partial, next, previous)\n      if ('fetcher' in partial) useServer(next.fetcher, 'setOptions')?.check(next.fetcher)\n      void op('table:setOptions', { options: next, previous }, 'options', (): undefined => {\n        options = next\n        if (next.interceptors !== previous.interceptors) {\n          runtime.setInterceptors(withFront(next.interceptors))\n        }\n        if ('state' in partial || 'onStateChange' in partial) syncControlled()\n        if (next.columns !== previous.columns || next.rowKey !== previous.rowKey) {\n          rowModelDirty = true\n          pending = true\n        }\n        // The page count changed (§6.5): listeners re-read it (and pagination clamps).\n        if (next.rowCount !== previous.rowCount) pending = true\n        // A new fetcher reference runs at once, even with the same params (flush → sync).\n        if (next.fetcher !== previous.fetcher) server?.reset()\n        // New data is checked when applied (setData); same data with new columns is checked here.\n        if (next.data !== previous.data) ingest()\n        else if ((process.env.NODE_ENV !== \"production\")) {\n          if ('data' in partial) dataCheck?.check(next.data)\n          if (next.columns !== previous.columns) dataChecks?.check(data, next.columns)\n        }\n      })\n      flush()\n    })\n  }\n\n  function destroy() {\n    if (destroyed) return\n    withTrigger('api:destroy', () => {\n      try {\n        void op('table:destroy', undefined, 'destroy', (): undefined => {\n          destroyed = true\n        })\n      } finally {\n        // Even if an interceptor skipped the core: the table is destroyed.\n        destroyed = true\n        ingestSeq++\n        listeners.clear()\n        runner.dispose()\n        if ((process.env.NODE_ENV !== \"production\")) feedback?.dispose()\n      }\n    })\n  }\n\n  // --- extensions (§9.3) ---------------------------------------------------------------------\n\n  function batch<R>(t: Trigger, fn: () => R): R {\n    return withTrigger(t, () => {\n      apiDepth++\n      try {\n        return fn()\n      } finally {\n        apiDepth--\n        if (apiDepth === 0) flush()\n      }\n    })\n  }\n\n  const host: TableHost = {\n    table: table as unknown as Table<unknown, TableState>,\n    name: hub.table,\n    emit: hub.emit,\n    runtime,\n    features: pipeline,\n    options: () => options as TableOptions<unknown>,\n    state: () => snapshot,\n    base,\n    destroyed: () => destroyed,\n    loaded: () => loaded,\n    status,\n    touch,\n    notify: () => {\n      if (apiDepth === 0) flush()\n    },\n    batch,\n    ingest: (rows) => ingest(rows),\n    intercept(interceptor) {\n      front.push(interceptor)\n      runtime.setInterceptors(withFront(options.interceptors))\n    },\n    deferring: () => deferring,\n    use,\n  }\n\n  function use<E extends TableExtension>(factory: ExtensionFactory<E>): E {\n    let e = extensions.get(factory as ExtensionFactory<TableExtension>) as E | undefined\n    if (!e) {\n      e = factory(host)\n      extensions.set(factory as ExtensionFactory<TableExtension>, e)\n    }\n    return e\n  }\n\n  /** The server source a `withFetcher` fetcher brings (created once); else the current one. */\n  function useServer(fetcher: unknown, phase?: 'setOptions'): ServerSource | undefined {\n    const factory = (fetcher as Partial<ServerFetcher<unknown>> | undefined)?.[SERVER_SOURCE]\n    if (factory) server = use(factory)\n    // Never silent (§8.6): in production an unwrapped fetcher would never run.\n    else if (fetcher) unwrapped('fetcher', fetcher, 'withFetcher', 'server', phase)\n    return server\n  }\n\n  /**\n   * `DK_INVALID_OPTION` for a schema / fetcher not wrapped with its opt-in import (§5.1, §7.1). A\n   * production check: in development the option validator reports it first, with the full text.\n   */\n  function unwrapped(\n    path: 'schema' | 'fetcher',\n    value: unknown,\n    wrap: string,\n    entry: string = path,\n    phase: 'init' | 'setOptions' = 'init',\n  ): never {\n    return throwConfigError(\n      'DK_INVALID_OPTION',\n      {\n        path,\n        expected: `wrapped|${wrap}|${path}|${entry}`, // prose key (diagnostics/prose.ts)\n        received: typeof value,\n        suggestions: [],\n        phase,\n      },\n      { table: hub.table, trigger: phase },\n    )\n  }\n\n  /**\n   * Runs the fetcher again with the current params (§7.1); never rejects. Without a fetcher:\n   * `{ status: 'applied' }` at once.\n   */\n  function refetch(): Promise<FetchOutcome> {\n    if (destroyed) {\n      destroyedCall('refetch')\n      return Promise.resolve({ status: 'superseded' })\n    }\n    return (\n      withTrigger('api:refetch', () => server?.sync(true)) ?? Promise.resolve({ status: 'applied' })\n    )\n  }\n\n  /** `startTable` (§7.2): the deferred work starts; listeners see the new status at once. */\n  function start() {\n    if (!deferring || destroyed) return\n    deferring = false\n    let had = false\n    for (const e of extensions.values()) if (e.start?.()) had = true\n    if (!had) return\n    // The pipeline re-runs: 'pending' ends and the search feature's check starts its searchFn.\n    touch()\n    withTrigger('hydrate', () => flush())\n  }\n\n  setTableInternals(table, {\n    features: pipeline,\n    name: options.name,\n    rowCount: () => (typeof options.fetcher === 'function' ? server?.rowCount() : options.rowCount),\n    hasFetcher: () => typeof options.fetcher === 'function',\n    emit: hub.emit,\n    use,\n    peek: (factory) => extensions.get(factory as ExtensionFactory<TableExtension>) as never,\n    extensions: () => extensions.values(),\n    start,\n    initialRows: () =>\n      initialRows !== undefined && initialRows === data ? initialRows : undefined,\n  })\n\n  // --- init --------------------------------------------------------------------------------------\n\n  controlled = controlledKeys(options.state)\n  if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n  // Feature `initialState()` slices, with `options.initialState` on top per slice.\n  snapshot = overlay(\n    freeze(\n      (rt\n        ? rt.initialSlices(features, options.initialState, hub.emit)\n        : { ...options.initialState }) as S,\n    ),\n  )\n  notified = snapshot\n  // Merges the feature APIs onto the table; a name clash throws DK_FEATURE_API_CONFLICT.\n  rt?.installApis(features, {\n    table: table as unknown as Table<unknown, TableState>,\n    tableName: hub.table,\n    emit: hub.emit,\n    getSlice: (name) => snapshot[name],\n    setSlice,\n    call: callApi,\n  })\n  // Server source (§7.1): with a `withFetcher` fetcher (throws DK_FETCHER_WITHOUT_SERVER_MODE).\n  useServer(options.fetcher)\n  withTrigger('init', () => {\n    // `void`: sync ops never return a promise (op kinds, §3.4).\n    void op('table:init', { options }, 'options', (): undefined => {\n      // Ingest first: dedupe is per data reference, so warnings follow the initial data.\n      ingest()\n      warnControlled(undefined)\n    })\n    // Server source (§7.1): the first request starts now ('fetching', isInitialLoad: true), unless\n    // initialData answered the initial server state (§7.2).\n    sync()\n  })\n  pending = false\n  return table\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAClC,uBAAsD;AACtD,mBAA+D;AAC/D,qBAAgC;AAChC,2BAAO;AACP,qBAA2D;AAC3D,iBAAkC;AAClC,oBAAoD;AACpD,oBAAuB;AAEvB,qBAA2B;AAE3B,yBAAiC;AACjC,4BAAqC;AAErC,0BAAgD;AAGhD,sBAA8B;AAC9B,sBAAoC;AACpC,qBAAgD;AAEhD,uBAAiC;AAEjC,IAAAA,kBAAoD;AACpD,oBAA+B;AAE/B,qBAAkD;AAElD,0BAAkD;AAClD,sBAA8B;AAC9B,IAAAC,gBAAiC;AACjC,2BAAiE;AACjE,uBAMO;AACP,uBAA6B;AAC7B,4BAAmE;AACnE,mBAQO;AAAA,IAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,QAA0B,CAAC;AAGjC,IAAM,OAAkC;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,aAAa,CAAC,MAClB,KAAK,QAAQ,OAAQ,EAAyB,SAAS;AAGzD,IAAM,aAAc,QAAQ,IAAI,aAAa,eAAgB,oBAAI,QAAgB,IAAI;AAMrF,SAAS,WAAW,GAAkB;AACpC,MAAI,MAAM,QAAQ,OAAO,MAAM,YAAY,YAAY,IAAI,CAAC,EAAG;AAC/D,QAAM,UAAU,MAAM,QAAQ,CAAC;AAC/B,MAAI,CAAC,SAAS;AACZ,UAAM,QAAQ,OAAO,eAAe,CAAC;AACrC,QAAI,UAAU,OAAO,aAAa,UAAU,KAAM;AAAA,EACpD;AACA,cAAY,IAAI,CAAC;AACjB,SAAO,OAAO,CAAC;AACf,MAAI,QAAS,UAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,IAAK,YAAW,EAAE,CAAC,CAAC;AAAA,MAC1D,YAAW,KAAK,EAAG,YAAY,EAA8B,CAAC,CAAC;AACtE;AAGA,IAAM,SAAS,CAAmB,MAAY;AAC5C,MAAK,QAAQ,IAAI,aAAa,aAAe,YAAW,CAAC;AACzD,SAAO;AACT;AAyBA,IAAM,WAAW,CAAC,MAAgD,EAAE,OAAO,EAAE;AA4BtE,SAAS,YACd,gBACa;AACb,MAAI,UAA8B,EAAE,GAAG,eAAe;AACtD,MAAI,YAAY;AAChB,MAAI,UAAmB;AAEvB,MAAI,MAAM;AACV,MAAI,OAAqB;AACzB,MAAI,YAAY;AAEhB,MAAI,SAAS;AAEb,MAAI,eAAe;AAEnB,MAAI,gBAAgB;AAEpB,MAAI;AAKJ,MAAI,eAAe,QAAQ,SAAS,SAAY,QAAQ,cAAc;AACtE,MAAI;AAEJ,MAAI,YAAY,0BAAS,QAAQ;AAKjC,QAAM,aAAa,oBAAI,IAAsD;AAE7E,MAAI;AAEJ,MAAI,aAAa,oBAAI,IAAY;AACjC,MAAI;AAEJ,MAAI;AAEJ,MAAI,UAAU;AACd,MAAI,YAAY;AAChB,MAAI,SAAS;AACb,MAAI,eAAe;AACnB,MAAI;AACJ,MAAI,cAAc;AAClB,QAAM,YAAY,oBAAI,IAAyB;AAE/C,MAAI,WAAW;AAEf,MAAI,gBAAgB;AAEpB,QAAM,QAA6C,CAAC;AAEpD,QAAM,QAAqB;AAAA,IACzB,UAAU,MAAM;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,IAClB,SAAS,MAAM;AAAA;AAAA,IAEf;AAAA,IACA,gBAAgB,MAAM,eAAe,WAAW;AAAA,IAChD,gBAAgB,MAAM,IAAI,eAAe;AAAA;AAAA,IAEzC,SAAS,UAAM,6BAAa,WAAW;AAAA,IACvC,YAAY,CAAC,YAAQ,2BAAW,aAAa,GAAG;AAAA,IAChD;AAAA,IACA;AAAA,EACF;AAKA,QAAM,eAAe,QAAQ,aAAa;AAC1C,QAAM,YAA8B;AAAA,IAClC,GAAI,OAAO,iBAAiB,WAAW,EAAE,OAAO,aAAa,IAAI,CAAC;AAAA,IAClE,GAAI,OAAO,iBAAiB,aAAa,EAAE,QAAQ,aAAa,IAAI,CAAC;AAAA,IACrE;AAAA;AAAA,IAEA,iBAAiB,MAAM;AACrB,YAAM,IAAI,QAAQ;AAClB,aAAO,OAAO,MAAM,YAAY,iBAAiB,EAAE,KAAK,CAAC,UAAM,4BAAa,GAAG,CAAC,CAAC;AAAA,IACnF;AAAA,EACF;AACA,QAAM,UAAM,8BAAkB;AAAA,IAC5B,GAAI,QAAQ,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;AAAA,IAC3D;AAAA,IACA,cAAc,CAAC,MAAM,QAAQ,eAAe,CAAC;AAAA,IAC7C,GAAI,QAAQ,WAAW,SAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;AAAA,IACjE,YAAY,OAAO,EAAE,SAAS,KAAK,MAAM,MAAM;AAAA,IAC/C,YAAY,MAAM;AAAA,IAClB;AAAA,EACF,CAAC;AAGD,MAAK,QAAQ,IAAI,aAAa,aAAe,uCAAgB,SAAS,EAAE,OAAO,IAAI,OAAO,MAAM,IAAI,KAAK,CAAC;AAG1G,QAAM,WAAkC,QAAQ,YAAY;AAE5D,QAAM,SAAK,2BAAW,QAAQ;AAC9B,QAAM,WAAW,KAAK,GAAG,cAAc,UAAU,IAAI,KAAK,IAAI;AAG9D,MAAK,QAAQ,IAAI,aAAa,aAAe,oCAAe,UAAU,IAAI,KAAK;AAC/E,aAAW,KAAK,SAAU,KAAI,EAAE,UAAU,OAAQ,OAAM,EAAE,IAAI,IAAI,EAAE,QAAQ;AAI5E,QAAM,QAA+B,CAAC;AACtC,QAAM,sBAAsB,SAAS,QAAQ,CAAC,MAAM,EAAE,gBAAgB,KAAK;AAG3E,QAAM,SAAU,QAAQ,IAAI,aAAa,eAAgB,KAAC,sBAAO,CAAwB,IAAI;AAC7F,QAAM,YAAY,CAAC,SAAqD;AAAA,IACtE,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAI,QAAQ;AAAA,EACd;AACA,QAAM,cAAU,0CAAyB;AAAA,IACvC,cAAc,UAAU,QAAQ,YAAY;AAAA,IAC5C,MAAM,IAAI;AAAA,EACZ,CAAC;AACD,UAAQ,gBAAgB,6BAAa;AACrC,MAAI,OAAO,OAAO;AAElB,QAAM,YAAa,QAAQ,IAAI,aAAa,mBAAgB,8CAAwB,IAAI,IAAI,IAAI;AAGhG,MAAK,QAAQ,IAAI,aAAa,aAAe,oCAAc,UAAU,IAAI,MAAM,IAAI,KAAK;AAGxF,QAAM,aAAc,QAAQ,IAAI,aAAa,mBAAgB,qCAAiB,IAAI,IAAI,IAAI;AAE1F,QAAM,WAAY,QAAQ,IAAI,aAAa,mBAAgB,gDAAyB,IAAI,IAAI,IAAI;AAChG,QAAM,qBAAiB,4CAAqB;AAI5C,QAAM,eAAgB,QAAQ,SAA8C,iCAAa;AAAA,IACvF,QAAQ,eAAe;AAAA,IACvB,MAAM,QAAQ;AAAA,EAChB;AAEA,MAAI,QAAQ,UAAU,CAAC,aAAc,WAAU,UAAU,QAAQ,QAAQ,YAAY;AAErF,WAAS,mBAA6B;AACpC,UAAM,MAAgB,CAAC;AACvB,eAAW,KAAK,QAAQ,WAAW,OAAO;AACxC,YAAM,KAAK,SAAS,CAAoC;AACxD,UAAI,EAAE,aAAa,OAAO,OAAO,SAAU,KAAI,KAAK,EAAE;AAAA,IACxD;AACA,WAAO;AAAA,EACT;AAEA,WAAS,OAAoB;AAC3B,WAAO,EAAE,OAAO,KAAK,SAAS,WAAO,2BAAa,GAAG,MAAM,IAAI,KAAK;AAAA,EACtE;AAEA,WAAS,GACP,MACA,OACA,OACA,MACA,UACa;AACb,UAAM,UAAM,8BAAc,MAAM,OAAO,OAAO,KAAK,CAAC;AACpD,QAAI,aAAa,OAAW,KAAI,KAAK,IAAI,2BAAU,QAAQ;AAC3D,WAAO,QAAQ,IAAI,MAAM,KAAK,IAAI;AAAA,EACpC;AAEA,WAAS,YAAe,GAAY,IAAgB;AAClD,UAAM,OAAO;AACb,cAAU;AACV,QAAI;AACF,aAAO,GAAG;AAAA,IACZ,UAAE;AACA,gBAAU;AAAA,IACZ;AAAA,EACF;AAIA,WAAS,eAAe,OAAoD;AAC1E,UAAM,OAAO,oBAAI,IAAY;AAC7B,QAAI;AAAO,iBAAW,KAAK,OAAO,KAAK,KAAK,EAAG,KAAI,MAAM,CAAC,MAAM,OAAW,MAAK,IAAI,CAAC;AAAA;AACrF,WAAO;AAAA,EACT;AAGA,WAAS,QAAQ,GAAS;AACxB,QAAI;AACJ,UAAM,QAAQ,QAAQ;AACtB,QAAI,OAAO;AACT,iBAAW,KAAK,YAAY;AAC1B,YAAI,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG;AAC9B,mBAAS,EAAE,GAAG,EAAE;AAChB,eAAK,CAAC,IAAI,MAAM,CAAC;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AACA,WAAO,OAAO,OAAO,IAAS,IAAI;AAAA,EACpC;AAEA,WAAS,OAAO,MAAS;AACvB,eAAW;AACX,cAAU;AACV,oBAAgB;AAAA,EAClB;AAEA,WAAS,eAAe,SAA+B;AACrD,QAAI,QAAQ,iBAAiB,WAAW,SAAS,EAAG;AACpD,UAAM,SAAS,WAAW,CAAC,GAAG,UAAU;AACxC,QAAI,KAAK,iCAAiC,EAAE,QAAQ,SAAS,YAAY,OAAU,CAAC;AAAA,EACtF;AAEA,WAAS,iBAAiB;AACxB,iBAAa,eAAe,QAAQ,KAAK;AACzC,UAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAI,SAAS,SAAU,QAAO,IAAI;AAClC,QAAK,QAAQ,IAAI,aAAa,aAAe,WAAU,OAAO,QAAQ,OAAiC,UAAU;AACjH,mBAAe,MAAS;AAAA,EAC1B;AAEA,WAAS,SAAS,SAAqB,MAAc;AAEnD,UAAM,UACJ,OAAO,YAAY,iBACf;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS,aAAa,mBAAmB,GAAG,IAAI;AAAA,IAClD,IACA;AACN,QAAI,YAAY,QAAQ,OAAO,YAAY,SAAU;AACrD,QAAI;AACJ,QAAI;AACJ,QAAI;AACJ,eAAW,KAAK,OAAO,KAAK,OAAO,GAAG;AACpC,YAAM,IAAK,QAAuB,CAAC;AACnC,UAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,EAAG;AAC/B,UAAI,WAAW,IAAI,CAAC,GAAG;AACrB,YAAI,QAAQ,eAAe;AACzB,sBAAY,CAAC;AACb,kBAAQ,CAAC,IAAI;AAAA,QACf,OAAO;AACL,sBAAY,CAAC;AACb,kBAAQ,KAAK,CAAC;AAAA,QAChB;AACA;AAAA,MACF;AACA,eAAS,EAAE,GAAG,SAAS;AACvB,WAAK,CAAC,IAAI;AAAA,IACZ;AAEA,QAAI,WAAW,QAAQ,eAAe;AACpC,YAAM,IAAI;AACV,UAAK,QAAQ,IAAI,aAAa,aAAe,WAAU,IAAI,OAAO,KAAK,OAAO,GAAG,OAAO;AACxF,oCAAS,iBAAiB,QAAQ,eAAe,CAAC,UAAsB,EAAE,GAAG,MAAM,GAAG,EAAE,EAAE;AAC1F,UAAK,QAAQ,IAAI,aAAa,aAAe,WAAU,MAAM;AAAA,IAC/D;AACA,QAAI,KAAM,QAAO,OAAO,IAAS,CAAC;AAClC,QAAI,QAAS,gBAAe,OAAO;AAAA,EACrC;AAMA,WAAS,QAAQ;AACf,QAAI,UAAW;AACf,SAAK;AACL,QAAI,CAAC,QAAS;AACd,gBAAY;AACZ,QAAI;AACJ,QAAI;AACF,aAAO,WAAW,CAAC,WAAW;AAE5B,aAAK;AACL,kBAAU;AACV;AACA,cAAM,OAAO;AACb,cAAM,QAAQ;AACd,mBAAW;AAEX,uBAAe;AACf,mBAAW,CAAC,IAAI,QAAQ,KAAK,CAAC,GAAG,SAAS,GAAG;AAE3C,cAAI,UAAW;AACf,oBAAU;AACV,cAAI;AACF,qBAAS,OAAO,IAAI;AAAA,UACtB,SAAS,GAAG;AAEV,gBAAI,aAAa,6BAAgB;AAC/B,0BAAY;AACZ;AAAA,YACF;AACA,gBAAI;AACF,oBAAM,WAAO,2BAAU,CAAC;AACxB,kBAAI;AAAA,gBACF;AAAA,gBACA,EAAE,UAAU,IAAI,GAAI,SAAS,SAAY,CAAC,IAAI,EAAE,WAAW,KAAK,EAAG;AAAA,gBACnE,EAAE,OAAO,EAAE;AAAA,cACb;AAAA,YACF,SAAS,aAAa;AACpB,0BAAY;AAAA,YACd;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,kBAAY;AACZ,eAAS;AACT,qBAAe;AACf,gBAAU;AAAA,IACZ;AACA,QAAI,YAAY,OAAW,OAAM;AAAA,EACnC;AAGA,WAAS,MAAM,QAA2B;AACxC,QAAI,CAAC,aAAa,SAAS,gCAAoB,QAAO;AACtD,QAAI,CAAC,cAAc;AACjB,qBAAe;AACf,UAAI,KAAK,kBAAkB;AAAA,QACzB,OAAO;AAAA,QACP;AAAA,QACA,GAAI,YAAY,SAAY,CAAC,IAAI,EAAE,UAAU,QAAQ;AAAA,MACvD,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAEA,WAAS,cAAc,QAAgB;AACrC,gBAAY,OAAO,MAAM,IAAI,MAAM,IAAI,KAAK,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAAA,EAC/E;AAKA,WAAS,QAAQ,MAAoB,OAAgB;AACnD,QAAI,SAAS,CAAC,QAAQ;AAEpB,eAAS;AACT,gBAAU;AACV,sBAAgB;AAAA,IAClB;AACA,QAAI,SAAS,KAAM;AACnB,WAAO;AACP,cAAU;AAEV,QAAK,QAAQ,IAAI,aAAa,aAAe,aAAY,MAAM,MAAM,QAAQ,OAAO;AAGpF,oBAAgB;AAAA,EAClB;AAIA,QAAM,aAAS,8BAAkB;AAAA,IAC/B;AAAA,IACA,gBAAgB;AAAA,IAChB,MAAM,IAAI;AAAA,IACV,UAAU;AAAA,IACV,QAAQ;AAAA,IACR;AAAA,IACA,SAAS,MAAM,EAAE;AAAA,IACjB,SAAS,MAAM;AAAA,IACf,UAAU,MAAM;AAAA,IAChB,YAAY,MAAM,QAAQ,WAAW,eAAe,IAAI;AAAA,IACxD,WAAW,MAAM,QAAQ;AAAA,IACzB,eAAe,MAAM,CAAC;AAAA,IACtB;AAAA,IACA,QAAQ,CAAC,UAAU,eAAe,SAAS,IAAI,KAAK;AAAA,IACpD,UAAU,iBAAiB,UAAa,QAAQ,gBAAgB;AAAA;AAAA,IAEhE,SAAS,CAAC,MAAM;AACd,UAAI,UAAW;AACf,kBAAY,GAAG,MAAM;AACnB,cAAM;AACN,YAAI,aAAa,EAAG,OAAM;AAAA,MAC5B,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,QAAM,cAA2B;AAAA,IAC/B;AAAA,IACA,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS,OAAO;AAAA,IAChB,QAAQ,OAAO;AAAA,IACf,MAAM,MAAM;AAAA,IACZ,OAAO,MAAM;AAAA,IACb,QAAQ,MAAM,QAAQ;AAAA,IACtB,YAAY,MAAO,eAAgB,QAAQ,eAAe,SAAU;AAAA,IACpE,QAAQ,MAAM;AAAA,IACd,aAAa,MAAM,IAAI,eAAe;AAAA,IACtC;AAAA,IACA,GAAI,KAAK,EAAE,QAAQ,GAAG,cAAc,IAAI,CAAC;AAAA,EAC3C;AAQA,WAAS,SAAyB;AAChC,UAAM,SAAS,aAAa;AAC5B,QAAI,IACF,gBAAgB,WAAW,UACvB,UACA,WAAW,cACT,cACA,kBAAkB,IAChB,eACA,WAAW,YACT,YACA;AACZ,eAAW,KAAK,WAAW,OAAO,GAAG;AACnC,YAAM,IAAI,EAAE,SAAS;AACrB,UAAI,MAAM,UAAa,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAG,KAAI;AAAA,IAChE;AACA,WAAO;AAAA,EACT;AAGA,WAAS,OAAO;AACd,eAAW,KAAK,WAAW,OAAO,EAAG,GAAE,OAAO;AAAA,EAChD;AAGA,WAAS,eAAwB;AAC/B,eAAW,KAAK,UAAU;AACxB,UAAI,EAAE,UAAU,SAAU;AAC1B,YAAM,IAAK,WAAmD,EAAE,IAAI;AACpE,UAAI,MAAM,QAAQ,OAAO,MAAM,YAAY,YAAY,GAAG;AACxD,cAAM,IAAK,EAA0B;AACrC,YAAI,MAAM,OAAQ,QAAO;AAAA,MAC3B;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAGA,WAAS,QAAQ;AACf,cAAU;AACV,oBAAgB;AAAA,EAClB;AAGA,WAAS,iBAAiB;AACxB,QAAI,CAAC,iBAAiB,UAAW;AACjC,oBAAgB;AAChB,WAAO,IAAI;AAAA,EACb;AAEA,WAAS,cAA2B;AAClC,mBAAe;AAEf,WACE,OAAO,QAAQ,KAAK;AAAA,MAClB,MAAM;AAAA,MACN,eAAe;AAAA,MACf,YAAY;AAAA,MACZ,QAAQ,OAAO;AAAA,MACf,eAAe,CAAC;AAAA,IAClB;AAAA,EAEJ;AAMA,WAAS,YAAY,KAAyB,QAAiB,OAAgB,UAAU,OAAO;AAC9F,QAAI,kBAAkB,GAAG;AACvB,sBAAgB;AAChB,YAAM;AAAA,IACR;AACA,QAAI,QAAQ;AACV,qBAAe;AACf,YAAM;AACN;AAAA,IACF;AACA,QAAI,cAAc;AAChB,qBAAe;AACf,YAAM;AAAA,IACR;AACA,oBAAgB,cAAc,QAAQ,GAAG;AACzC,YAAQ,KAAqB,KAAK;AAElC,kBAAc,UAAU,MAAM;AAAA,EAChC;AAOA,WAAS,OAAO,SAA8B;AAC5C,UAAM,MAAM,EAAE;AAEd,UAAM,UAAU,YAAY,UAAa,iBAAiB;AAC1D,UAAM,QAAQ,YAAY,UAAU,eAAe,QAAQ;AAC3D,mBAAe;AACf,UAAM,QAAQ,UAAU;AACxB,UAAM,SAAkB,UAAU,UAAU;AAG5C,QAAI,kBAAkB,GAAG;AACvB,sBAAgB;AAChB,YAAM;AAAA,IACR;AACA,QAAI;AACF,kBAAY,QAAQ,MAAM;AACxB,cAAM,UAAM;AAAA,UACV;AAAA,UACA,EAAE,MAAM,SAAS,MAAM;AAAA,UACvB,UAAU,YAAY,UAAU,wBAAwB;AAAA,UACxD,KAAK;AAAA,QACP;AACA,YAAI,KAAK,IAAI,2BAAU,IAAI;AAC3B,YAAIC,QAAO;AACX,cAAM,MAAM,QAAQ,IAAI,eAAe,KAAK,CAAC,MAAM;AACjD,gBAAMC,SAAQ,EAAE,MAAM;AACtB,cAAI,CAAC,aAAc,QAAOA;AAC1B,gBAAM,IAAI,aAAa,SAASA,QAAO,EAAE,IAAI;AAC7C,cAAI,WAAW,CAAC,KAAK,QAAQ,aAAa,CAAC,WAAW;AAEpD,4BAAgB;AAChB,kBAAM;AACN,gBAAI,CAACD,MAAM,OAAM;AAAA,UACnB;AACA,iBAAO;AAAA,QACT,CAAC;AACD,QAAAA,QAAO;AACP,YAAI,CAAC,WAAW,GAAG,GAAG;AACpB,sBAAY,KAAK,IAAI,KAAK,IAAI,uBAAM,GAAG,OAAO,OAAO;AACrD;AAAA,QACF;AACA,cAAM,SAAS,CAAC,GAAuB,WAAoB;AACzD,cAAI,QAAQ,aAAa,UAAW;AACpC,sBAAY,QAAQ,MAAM;AACxB,wBAAY,GAAG,QAAQ,OAAO,OAAO;AACrC,kBAAM;AAAA,UACR,CAAC;AAAA,QACH;AACA,gBAAQ,QAAQ,GAAG,EAAE;AAAA,UACnB,CAAC,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,uBAAM,CAAC;AAAA;AAAA;AAAA;AAAA,UAIrC,MAAM,OAAO,MAAM,IAAI;AAAA,QACzB;AAAA,MACF,CAAC;AAAA,IACH,UAAE;AAGA,UAAK,QAAQ,IAAI,aAAa,gBAAiB,CAAC,QAAS,YAAW,SAAS,QAAQ,IAAI;AAAA,IAC3F;AAAA,EACF;AAKA,WAAS,OAAO,SAAqB,MAAc;AACjD,SAAK,GAAG,kBAAkB,EAAE,QAAQ,GAAG,MAAM,MAAiB;AAC5D,eAAS,SAAS,IAAI;AAAA,IACxB,CAAC;AACD,QAAI,aAAa,EAAG,OAAM;AAAA,EAC5B;AAEA,WAAS,SAAS,SAAqB;AACrC,QAAI,UAAW,QAAO,cAAc,UAAU;AAC9C,QAAI,CAAC,MAAM,OAAO,YAAY,aAAa,CAAC,IAAI,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,EAAG;AAC7E,gBAAY,gBAAgB,MAAM,OAAO,SAAS,UAAU,CAAC;AAAA,EAC/D;AAKA,WAAS,SAAS,MAAc,SAAgC;AAC9D,QAAI,UAAW,QAAO,cAAc,GAAG,IAAI,WAAW;AACtD,QAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAG;AACpB,UAAM,QACJ,OAAO,YAAY,aACf,CAAC,UAAU,EAAE,CAAC,IAAI,GAAI,QAAoC,KAAK,IAAI,CAAC,EAAE,KACrE,EAAE,CAAC,IAAI,GAAG,QAAQ;AACzB,WAAO,OAAO,IAAI;AAAA,EACpB;AAGA,WAAS,QAAQ,QAAgB,IAAmB,aAAsC;AACxF,QAAI,WAAW;AACb,oBAAc,MAAM;AACpB,aAAO,cAAc;AAAA,IACvB;AACA,WAAO,YAAY,OAAO,MAAM,IAAI,MAAM;AACxC;AACA,UAAI;AACF,eAAO,GAAG;AAAA,MACZ,UAAE;AACA;AACA,YAAI,aAAa,EAAG,OAAM;AAAA,MAC5B;AAAA,IACF,CAAC;AAAA,EACH;AAEA,WAAS,UAAU,UAAmC;AACpD,QAAI,WAAW;AACb,oBAAc,WAAW;AACzB,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AACA,UAAM,KAAK,EAAE;AACb,cAAU,IAAI,IAAI,QAAQ;AAC1B,WAAO,MAAM;AACX,gBAAU,OAAO,EAAE;AAAA,IACrB;AAAA,EACF;AAEA,WAAS,WAAW,SAAsC;AACxD,QAAI,UAAW,QAAO,cAAc,YAAY;AAChD,QAAI,CAAC,MAAM,OAAO,KAAK,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAG;AAC9C,gBAAY,cAAc,MAAM;AAC9B,YAAM,WAAW;AACjB,YAAM,OAAO,EAAE,GAAG,SAAS,GAAG,QAAQ;AAItC,UAAK,QAAQ,IAAI,aAAa,aAAe,4CAAqB,SAAS,MAAM,UAAU,EAAE,OAAO,IAAI,OAAO,MAAM,IAAI,KAAK,CAAC;AAAA,UAC1H,oCAAa,SAAS,MAAM,QAAQ;AACzC,UAAI,aAAa,QAAS,WAAU,KAAK,SAAS,YAAY,GAAG,MAAM,KAAK,OAAO;AACnF,WAAK,GAAG,oBAAoB,EAAE,SAAS,MAAM,SAAS,GAAG,WAAW,MAAiB;AACnF,kBAAU;AACV,YAAI,KAAK,iBAAiB,SAAS,cAAc;AAC/C,kBAAQ,gBAAgB,UAAU,KAAK,YAAY,CAAC;AAAA,QACtD;AACA,YAAI,WAAW,WAAW,mBAAmB,QAAS,gBAAe;AACrE,YAAI,KAAK,YAAY,SAAS,WAAW,KAAK,WAAW,SAAS,QAAQ;AACxE,0BAAgB;AAChB,oBAAU;AAAA,QACZ;AAEA,YAAI,KAAK,aAAa,SAAS,SAAU,WAAU;AAEnD,YAAI,KAAK,YAAY,SAAS,QAAS,SAAQ,MAAM;AAErD,YAAI,KAAK,SAAS,SAAS,KAAM,QAAO;AAAA,iBAC9B,QAAQ,IAAI,aAAa,cAAe;AAChD,cAAI,UAAU,QAAS,YAAW,MAAM,KAAK,IAAI;AACjD,cAAI,KAAK,YAAY,SAAS,QAAS,aAAY,MAAM,MAAM,KAAK,OAAO;AAAA,QAC7E;AAAA,MACF,CAAC;AACD,YAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,WAAS,UAAU;AACjB,QAAI,UAAW;AACf,gBAAY,eAAe,MAAM;AAC/B,UAAI;AACF,aAAK,GAAG,iBAAiB,QAAW,WAAW,MAAiB;AAC9D,sBAAY;AAAA,QACd,CAAC;AAAA,MACH,UAAE;AAEA,oBAAY;AACZ;AACA,kBAAU,MAAM;AAChB,eAAO,QAAQ;AACf,YAAK,QAAQ,IAAI,aAAa,aAAe,WAAU,QAAQ;AAAA,MACjE;AAAA,IACF,CAAC;AAAA,EACH;AAIA,WAAS,MAAS,GAAY,IAAgB;AAC5C,WAAO,YAAY,GAAG,MAAM;AAC1B;AACA,UAAI;AACF,eAAO,GAAG;AAAA,MACZ,UAAE;AACA;AACA,YAAI,aAAa,EAAG,OAAM;AAAA,MAC5B;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,OAAkB;AAAA,IACtB;AAAA,IACA,MAAM,IAAI;AAAA,IACV,MAAM,IAAI;AAAA,IACV;AAAA,IACA,UAAU;AAAA,IACV,SAAS,MAAM;AAAA,IACf,OAAO,MAAM;AAAA,IACb;AAAA,IACA,WAAW,MAAM;AAAA,IACjB,QAAQ,MAAM;AAAA,IACd;AAAA,IACA;AAAA,IACA,QAAQ,MAAM;AACZ,UAAI,aAAa,EAAG,OAAM;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,QAAQ,CAAC,SAAS,OAAO,IAAI;AAAA,IAC7B,UAAU,aAAa;AACrB,YAAM,KAAK,WAAW;AACtB,cAAQ,gBAAgB,UAAU,QAAQ,YAAY,CAAC;AAAA,IACzD;AAAA,IACA,WAAW,MAAM;AAAA,IACjB;AAAA,EACF;AAEA,WAAS,IAA8B,SAAiC;AACtE,QAAI,IAAI,WAAW,IAAI,OAA2C;AAClE,QAAI,CAAC,GAAG;AACN,UAAI,QAAQ,IAAI;AAChB,iBAAW,IAAI,SAA6C,CAAC;AAAA,IAC/D;AACA,WAAO;AAAA,EACT;AAGA,WAAS,UAAU,SAAkB,OAAgD;AACnF,UAAM,UAAW,UAA0D,iCAAa;AACxF,QAAI,QAAS,UAAS,IAAI,OAAO;AAAA,aAExB,QAAS,WAAU,WAAW,SAAS,eAAe,UAAU,KAAK;AAC9E,WAAO;AAAA,EACT;AAMA,WAAS,UACP,MACA,OACA,MACA,QAAgB,MAChB,QAA+B,QACxB;AACP,eAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE;AAAA,QACA,UAAU,WAAW,IAAI,IAAI,IAAI,IAAI,KAAK;AAAA;AAAA,QAC1C,UAAU,OAAO;AAAA,QACjB,aAAa,CAAC;AAAA,QACd;AAAA,MACF;AAAA,MACA,EAAE,OAAO,IAAI,OAAO,SAAS,MAAM;AAAA,IACrC;AAAA,EACF;AAMA,WAAS,UAAiC;AACxC,QAAI,WAAW;AACb,oBAAc,SAAS;AACvB,aAAO,QAAQ,QAAQ,EAAE,QAAQ,aAAa,CAAC;AAAA,IACjD;AACA,WACE,YAAY,eAAe,MAAM,QAAQ,KAAK,IAAI,CAAC,KAAK,QAAQ,QAAQ,EAAE,QAAQ,UAAU,CAAC;AAAA,EAEjG;AAGA,WAAS,QAAQ;AACf,QAAI,CAAC,aAAa,UAAW;AAC7B,gBAAY;AACZ,QAAI,MAAM;AACV,eAAW,KAAK,WAAW,OAAO,EAAG,KAAI,EAAE,QAAQ,EAAG,OAAM;AAC5D,QAAI,CAAC,IAAK;AAEV,UAAM;AACN,gBAAY,WAAW,MAAM,MAAM,CAAC;AAAA,EACtC;AAEA,0CAAkB,OAAO;AAAA,IACvB,UAAU;AAAA,IACV,MAAM,QAAQ;AAAA,IACd,UAAU,MAAO,OAAO,QAAQ,YAAY,aAAa,QAAQ,SAAS,IAAI,QAAQ;AAAA,IACtF,YAAY,MAAM,OAAO,QAAQ,YAAY;AAAA,IAC7C,MAAM,IAAI;AAAA,IACV;AAAA,IACA,MAAM,CAAC,YAAY,WAAW,IAAI,OAA2C;AAAA,IAC7E,YAAY,MAAM,WAAW,OAAO;AAAA,IACpC;AAAA,IACA,aAAa,MACX,gBAAgB,UAAa,gBAAgB,OAAO,cAAc;AAAA,EACtE,CAAC;AAID,eAAa,eAAe,QAAQ,KAAK;AACzC,MAAK,QAAQ,IAAI,aAAa,aAAe,WAAU,OAAO,QAAQ,OAAiC,UAAU;AAEjH,aAAW;AAAA,IACT;AAAA,MACG,KACG,GAAG,cAAc,UAAU,QAAQ,cAAc,IAAI,IAAI,IACzD,EAAE,GAAG,QAAQ,aAAa;AAAA,IAChC;AAAA,EACF;AACA,aAAW;AAEX,MAAI,YAAY,UAAU;AAAA,IACxB;AAAA,IACA,WAAW,IAAI;AAAA,IACf,MAAM,IAAI;AAAA,IACV,UAAU,CAAC,SAAS,SAAS,IAAI;AAAA,IACjC;AAAA,IACA,MAAM;AAAA,EACR,CAAC;AAED,YAAU,QAAQ,OAAO;AACzB,cAAY,QAAQ,MAAM;AAExB,SAAK,GAAG,cAAc,EAAE,QAAQ,GAAG,WAAW,MAAiB;AAE7D,aAAO;AACP,qBAAe,MAAS;AAAA,IAC1B,CAAC;AAGD,SAAK;AAAA,EACP,CAAC;AACD,YAAU;AACV,SAAO;AACT;","names":["import_runtime","import_codes","sync","input"]}