@datakable/core 1.0.0 → 1.1.0

package/dist/versioning/codes.js

@@ -1,5 +1,6 @@
 // src/versioning/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 import { compareVersions, parseVersion } from "./semver.js";
 var FIXED_GROUP = ["@datakable/core", "@datakable/react", "datakable"];
 var OPTIONS = "options.";
@@ -29,6 +30,15 @@ var versioningMessages = {
       'or force one version: "pnpm": { "overrides": { "@datakable/core": "<version>" } } in package.json (npm "overrides", yarn "resolutions")'
     ]
   },
+  DK_DUPLICATE_CORE_SAME_VERSION: {
+    problem: (d) => `@datakable/core ${d.version} is loaded ${d.copies} times, all this version: its ESM and CJS builds, a bundler's layers (Next.js dev: RSC, SSR, route handlers), a hot reload, or two installs of it`,
+    impact: () => "tables work, each with its own copy; a DatakableError thrown by one copy is not an instanceof the classes of the other, and a browser bundle with both ships core twice",
+    fix: () => [
+      'compare errors by their .code (e.g. err.code === "DK_INVALID_OPTION"), not instanceof',
+      "mixed import and require of @datakable/core in one Node process: use one of them",
+      "in a browser bundle, find the second install: pnpm why @datakable/core, then pnpm dedupe"
+    ]
+  },
   DK_VERSION_MISMATCH: {
     problem: (d) => `${d.package}@${d.version} is used with @datakable/core@${d.core}; these packages are released together and must have the same version`,
     impact: () => "it may work, but APIs and types between the two can disagree",
@@ -77,6 +87,14 @@ var versioningDiagnostics = [
     },
     process.env.NODE_ENV !== "production" && versioningMessages.DK_DUPLICATE_CORE
   ),
+  defineDiagnostic(
+    {
+      code: "DK_DUPLICATE_CORE_SAME_VERSION",
+      level: "info",
+      where: () => CREATE
+    },
+    process.env.NODE_ENV !== "production" && versioningMessages.DK_DUPLICATE_CORE_SAME_VERSION
+  ),
   defineDiagnostic(
     {
       code: "DK_VERSION_MISMATCH",

package/dist/versioning/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/versioning/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport type { Location } from '../diagnostics/types'\nimport { compareVersions, parseVersion } from './semver'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_DEPRECATED: {\n      /** `options.<path>` for an option, else the method, e.g. `table.setGlobalFilter`. */\n      api: string\n      since: string\n      removeIn: string\n      replacement: string\n      codemod?: string\n    }\n    DK_DUPLICATE_CORE: {\n      /** Versions of every registered core copy, in registration order (this copy last). */\n      versions: string[]\n    }\n    DK_VERSION_MISMATCH: {\n      /** The fixed-group package whose version differs, e.g. `@datakable/react`. */\n      package: string\n      version: string\n      /** This core's version. */\n      core: string\n    }\n    DK_DEP_INCOMPATIBLE: {\n      /** The feature that uses the capability. */\n      feature: string\n      dependency: string\n      capability: string\n      /** The dependency range DataKable supports. */\n      supported: string\n      /** What is used instead. */\n      fallback: string\n    }\n    DK_FEATURE_INCOMPATIBLE: {\n      feature: string\n      /** `requires.core` of the feature. */\n      required: string\n      core: string\n      /** `true` when `required` is not a semver range. */\n      invalid: boolean\n    }\n  }\n}\n\n/** The fixed release group (§12): always published with one version. */\nexport const FIXED_GROUP = ['@datakable/core', '@datakable/react', 'datakable'] as const\n\nconst OPTIONS = 'options.'\nconst CREATE: Location = { kind: 'operation', op: 'createTable' }\n\n/** The newer of two versions (unparseable ones lose). */\nconst newest = (a: string, b: string): string => {\n  const pa = parseVersion(a)\n  const pb = parseVersion(b)\n  if (!pa) return b\n  if (!pb) return a\n  return compareVersions(pa, pb) < 0 ? b : a\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const versioningMessages: DiagnosticMessages<\n  | 'DK_DEPRECATED'\n  | 'DK_DUPLICATE_CORE'\n  | 'DK_VERSION_MISMATCH'\n  | 'DK_DEP_INCOMPATIBLE'\n  | 'DK_FEATURE_INCOMPATIBLE'\n> = {\n  DK_DEPRECATED: {\n    problem: (d) => `${d.api} is deprecated since ${d.since}`,\n    impact: (d) =>\n      `it still works in this version and is removed in ${d.removeIn}; this warning is shown ` +\n      'once per session',\n    fix: (d) => [\n      `use ${d.replacement} instead`,\n      ...(d.codemod ? [`run the codemod: ${d.codemod}`] : []),\n    ],\n  },\n  DK_DUPLICATE_CORE: {\n    problem: (d) =>\n      `${d.versions.length} copies of @datakable/core are loaded (${d.versions.join(', ')}); ` +\n      'features, interceptors and types from one copy do not match the other',\n    impact: () =>\n      'each table works with its own copy, but plugins built against the other copy may be ' +\n      'ignored or fail instanceof / registry checks, and the bundle ships core twice',\n    fix: () => [\n      'find who pulls the second copy: pnpm why @datakable/core (npm ls @datakable/core / yarn why)',\n      'dedupe it: pnpm dedupe (npm dedupe), and align @datakable/react and datakable to one version',\n      'or force one version: \"pnpm\": { \"overrides\": { \"@datakable/core\": \"<version>\" } } in ' +\n        'package.json (npm \"overrides\", yarn \"resolutions\")',\n    ],\n  },\n  DK_VERSION_MISMATCH: {\n    problem: (d) =>\n      `${d.package}@${d.version} is used with @datakable/core@${d.core}; ` +\n      'these packages are released together and must have the same version',\n    impact: () => 'it may work, but APIs and types between the two can disagree',\n    fix: (d) => {\n      const v = newest(d.version, d.core)\n      return [\n        `pnpm add ${FIXED_GROUP.map((p) => `${p}@${v}`).join(' ')} (install only the ones you use)`,\n        `or with npm: npm install ${FIXED_GROUP.map((p) => `${p}@${v}`).join(' ')}`,\n      ]\n    },\n  },\n  DK_DEP_INCOMPATIBLE: {\n    problem: (d) =>\n      `${d.dependency} has no usable ${d.capability}; it was probably overridden to a version ` +\n      `outside ${d.supported}`,\n    impact: (d) => `feature \"${d.feature}\" uses ${d.fallback} instead; results stay correct`,\n    fix: (d) => [\n      `install a supported version: pnpm add ${d.dependency}@\"${d.supported}\" (check pnpm why ${d.dependency})`,\n      `remove the override / resolution of ${d.dependency} from package.json`,\n    ],\n  },\n  DK_FEATURE_INCOMPATIBLE: {\n    problem: (d) =>\n      d.invalid\n        ? `feature \"${d.feature}\" declares requires.core \"${d.required}\", which is not a semver range`\n        : `feature \"${d.feature}\" requires @datakable/core ${d.required}, but this is ${d.core}`,\n    impact: () => 'the table was not created',\n    fix: (d) =>\n      d.invalid\n        ? [\n            `the feature author must set requires: { core: '^1.0' } (a semver range such as ` +\n              `'^1.0', '>=1.2 <2' or '1.x')`,\n            `meanwhile, remove feature \"${d.feature}\" from options.features`,\n          ]\n        : [\n            `upgrade core: pnpm add @datakable/core@\"${d.required}\" (and @datakable/react / ` +\n              'datakable to the same version)',\n            `or use a version of feature \"${d.feature}\" that supports @datakable/core ${d.core}`,\n          ],\n  },\n}\n\n/** Codes owned by versioning (§8.5). */\nexport const versioningDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_DEPRECATED',\n      level: 'warn',\n      where: (d) =>\n        d.api.startsWith(OPTIONS)\n          ? { kind: 'option', path: d.api.slice(OPTIONS.length) }\n          : { kind: 'operation', op: d.api },\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DEPRECATED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_DUPLICATE_CORE',\n      level: 'error',\n      where: () => CREATE,\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DUPLICATE_CORE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_VERSION_MISMATCH',\n      level: 'warn',\n      where: () => CREATE,\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_VERSION_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_DEP_INCOMPATIBLE',\n      level: 'warn',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DEP_INCOMPATIBLE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_INCOMPATIBLE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_FEATURE_INCOMPATIBLE,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/versioning/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport type { Location } from '../diagnostics/types'\nimport { compareVersions, parseVersion } from './semver'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_DEPRECATED: {\n      /** `options.<path>` for an option, else the method, e.g. `table.setGlobalFilter`. */\n      api: string\n      since: string\n      removeIn: string\n      replacement: string\n      codemod?: string\n    }\n    DK_DUPLICATE_CORE: {\n      /** Versions of every registered core copy, in registration order (this copy last). */\n      versions: string[]\n    }\n    DK_DUPLICATE_CORE_SAME_VERSION: {\n      version: string\n      /** Copies of core registered so far (this copy included), all of `version`. */\n      copies: number\n    }\n    DK_VERSION_MISMATCH: {\n      /** The fixed-group package whose version differs, e.g. `@datakable/react`. */\n      package: string\n      version: string\n      /** This core's version. */\n      core: string\n    }\n    DK_DEP_INCOMPATIBLE: {\n      /** The feature that uses the capability. */\n      feature: string\n      dependency: string\n      capability: string\n      /** The dependency range DataKable supports. */\n      supported: string\n      /** What is used instead. */\n      fallback: string\n    }\n    DK_FEATURE_INCOMPATIBLE: {\n      feature: string\n      /** `requires.core` of the feature. */\n      required: string\n      core: string\n      /** `true` when `required` is not a semver range. */\n      invalid: boolean\n    }\n  }\n}\n\n/** The fixed release group (§12): always published with one version. */\nexport const FIXED_GROUP = ['@datakable/core', '@datakable/react', 'datakable'] as const\n\nconst OPTIONS = 'options.'\nconst CREATE: Location = { kind: 'operation', op: 'createTable' }\n\n/** The newer of two versions (unparseable ones lose). */\nconst newest = (a: string, b: string): string => {\n  const pa = parseVersion(a)\n  const pb = parseVersion(b)\n  if (!pa) return b\n  if (!pb) return a\n  return compareVersions(pa, pb) < 0 ? b : a\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const versioningMessages: DiagnosticMessages<\n  | 'DK_DEPRECATED'\n  | 'DK_DUPLICATE_CORE'\n  | 'DK_DUPLICATE_CORE_SAME_VERSION'\n  | 'DK_VERSION_MISMATCH'\n  | 'DK_DEP_INCOMPATIBLE'\n  | 'DK_FEATURE_INCOMPATIBLE'\n> = {\n  DK_DEPRECATED: {\n    problem: (d) => `${d.api} is deprecated since ${d.since}`,\n    impact: (d) =>\n      `it still works in this version and is removed in ${d.removeIn}; this warning is shown ` +\n      'once per session',\n    fix: (d) => [\n      `use ${d.replacement} instead`,\n      ...(d.codemod ? [`run the codemod: ${d.codemod}`] : []),\n    ],\n  },\n  DK_DUPLICATE_CORE: {\n    problem: (d) =>\n      `${d.versions.length} copies of @datakable/core are loaded (${d.versions.join(', ')}); ` +\n      'features, interceptors and types from one copy do not match the other',\n    impact: () =>\n      'each table works with its own copy, but plugins built against the other copy may be ' +\n      'ignored or fail instanceof / registry checks, and the bundle ships core twice',\n    fix: () => [\n      'find who pulls the second copy: pnpm why @datakable/core (npm ls @datakable/core / yarn why)',\n      'dedupe it: pnpm dedupe (npm dedupe), and align @datakable/react and datakable to one version',\n      'or force one version: \"pnpm\": { \"overrides\": { \"@datakable/core\": \"<version>\" } } in ' +\n        'package.json (npm \"overrides\", yarn \"resolutions\")',\n    ],\n  },\n  DK_DUPLICATE_CORE_SAME_VERSION: {\n    problem: (d) =>\n      `@datakable/core ${d.version} is loaded ${d.copies} times, all this version: its ESM and ` +\n      \"CJS builds, a bundler's layers (Next.js dev: RSC, SSR, route handlers), a hot reload, or \" +\n      'two installs of it',\n    impact: () =>\n      'tables work, each with its own copy; a DatakableError thrown by one copy is not an ' +\n      'instanceof the classes of the other, and a browser bundle with both ships core twice',\n    fix: () => [\n      'compare errors by their .code (e.g. err.code === \"DK_INVALID_OPTION\"), not instanceof',\n      'mixed import and require of @datakable/core in one Node process: use one of them',\n      'in a browser bundle, find the second install: pnpm why @datakable/core, then pnpm dedupe',\n    ],\n  },\n  DK_VERSION_MISMATCH: {\n    problem: (d) =>\n      `${d.package}@${d.version} is used with @datakable/core@${d.core}; ` +\n      'these packages are released together and must have the same version',\n    impact: () => 'it may work, but APIs and types between the two can disagree',\n    fix: (d) => {\n      const v = newest(d.version, d.core)\n      return [\n        `pnpm add ${FIXED_GROUP.map((p) => `${p}@${v}`).join(' ')} (install only the ones you use)`,\n        `or with npm: npm install ${FIXED_GROUP.map((p) => `${p}@${v}`).join(' ')}`,\n      ]\n    },\n  },\n  DK_DEP_INCOMPATIBLE: {\n    problem: (d) =>\n      `${d.dependency} has no usable ${d.capability}; it was probably overridden to a version ` +\n      `outside ${d.supported}`,\n    impact: (d) => `feature \"${d.feature}\" uses ${d.fallback} instead; results stay correct`,\n    fix: (d) => [\n      `install a supported version: pnpm add ${d.dependency}@\"${d.supported}\" (check pnpm why ${d.dependency})`,\n      `remove the override / resolution of ${d.dependency} from package.json`,\n    ],\n  },\n  DK_FEATURE_INCOMPATIBLE: {\n    problem: (d) =>\n      d.invalid\n        ? `feature \"${d.feature}\" declares requires.core \"${d.required}\", which is not a semver range`\n        : `feature \"${d.feature}\" requires @datakable/core ${d.required}, but this is ${d.core}`,\n    impact: () => 'the table was not created',\n    fix: (d) =>\n      d.invalid\n        ? [\n            `the feature author must set requires: { core: '^1.0' } (a semver range such as ` +\n              `'^1.0', '>=1.2 <2' or '1.x')`,\n            `meanwhile, remove feature \"${d.feature}\" from options.features`,\n          ]\n        : [\n            `upgrade core: pnpm add @datakable/core@\"${d.required}\" (and @datakable/react / ` +\n              'datakable to the same version)',\n            `or use a version of feature \"${d.feature}\" that supports @datakable/core ${d.core}`,\n          ],\n  },\n}\n\n/** Codes owned by versioning (§8.5). */\nexport const versioningDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_DEPRECATED',\n      level: 'warn',\n      where: (d) =>\n        d.api.startsWith(OPTIONS)\n          ? { kind: 'option', path: d.api.slice(OPTIONS.length) }\n          : { kind: 'operation', op: d.api },\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DEPRECATED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_DUPLICATE_CORE',\n      level: 'error',\n      where: () => CREATE,\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DUPLICATE_CORE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_DUPLICATE_CORE_SAME_VERSION',\n      level: 'info',\n      where: () => CREATE,\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DUPLICATE_CORE_SAME_VERSION,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_VERSION_MISMATCH',\n      level: 'warn',\n      where: () => CREATE,\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_VERSION_MISMATCH,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_DEP_INCOMPATIBLE',\n      level: 'warn',\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_DEP_INCOMPATIBLE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FEATURE_INCOMPATIBLE',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.feature }),\n    },\n    (process.env.NODE_ENV !== \"production\") && versioningMessages.DK_FEATURE_INCOMPATIBLE,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAEP,SAAS,iBAAiB,oBAAoB;AAkDvC,IAAM,cAAc,CAAC,mBAAmB,oBAAoB,WAAW;AAE9E,IAAM,UAAU;AAChB,IAAM,SAAmB,EAAE,MAAM,aAAa,IAAI,cAAc;AAGhE,IAAM,SAAS,CAAC,GAAW,MAAsB;AAC/C,QAAM,KAAK,aAAa,CAAC;AACzB,QAAM,KAAK,aAAa,CAAC;AACzB,MAAI,CAAC,GAAI,QAAO;AAChB,MAAI,CAAC,GAAI,QAAO;AAChB,SAAO,gBAAgB,IAAI,EAAE,IAAI,IAAI,IAAI;AAC3C;AAGO,IAAM,qBAOT;AAAA,EACF,eAAe;AAAA,IACb,SAAS,CAAC,MAAM,GAAG,EAAE,GAAG,wBAAwB,EAAE,KAAK;AAAA,IACvD,QAAQ,CAAC,MACP,oDAAoD,EAAE,QAAQ;AAAA,IAEhE,KAAK,CAAC,MAAM;AAAA,MACV,OAAO,EAAE,WAAW;AAAA,MACpB,GAAI,EAAE,UAAU,CAAC,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACvD;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,SAAS,CAAC,MACR,GAAG,EAAE,SAAS,MAAM,0CAA0C,EAAE,SAAS,KAAK,IAAI,CAAC;AAAA,IAErF,QAAQ,MACN;AAAA,IAEF,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,IAEF;AAAA,EACF;AAAA,EACA,gCAAgC;AAAA,IAC9B,SAAS,CAAC,MACR,mBAAmB,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,IAGpD,QAAQ,MACN;AAAA,IAEF,KAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,SAAS,CAAC,MACR,GAAG,EAAE,OAAO,IAAI,EAAE,OAAO,iCAAiC,EAAE,IAAI;AAAA,IAElE,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AACV,YAAM,IAAI,OAAO,EAAE,SAAS,EAAE,IAAI;AAClC,aAAO;AAAA,QACL,YAAY,YAAY,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC;AAAA,QACzD,4BAA4B,YAAY,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,SAAS,CAAC,MACR,GAAG,EAAE,UAAU,kBAAkB,EAAE,UAAU,qDAClC,EAAE,SAAS;AAAA,IACxB,QAAQ,CAAC,MAAM,YAAY,EAAE,OAAO,UAAU,EAAE,QAAQ;AAAA,IACxD,KAAK,CAAC,MAAM;AAAA,MACV,yCAAyC,EAAE,UAAU,KAAK,EAAE,SAAS,qBAAqB,EAAE,UAAU;AAAA,MACtG,uCAAuC,EAAE,UAAU;AAAA,IACrD;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,SAAS,CAAC,MACR,EAAE,UACE,YAAY,EAAE,OAAO,6BAA6B,EAAE,QAAQ,mCAC5D,YAAY,EAAE,OAAO,8BAA8B,EAAE,QAAQ,iBAAiB,EAAE,IAAI;AAAA,IAC1F,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MACJ,EAAE,UACE;AAAA,MACE;AAAA,MAEA,8BAA8B,EAAE,OAAO;AAAA,IACzC,IACA;AAAA,MACE,2CAA2C,EAAE,QAAQ;AAAA,MAErD,gCAAgC,EAAE,OAAO,mCAAmC,EAAE,IAAI;AAAA,IACpF;AAAA,EACR;AACF;AAGO,IAAM,wBAAwB;AAAA,EACnC;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,IAAI,WAAW,OAAO,IACpB,EAAE,MAAM,UAAU,MAAM,EAAE,IAAI,MAAM,QAAQ,MAAM,EAAE,IACpD,EAAE,MAAM,aAAa,IAAI,EAAE,IAAI;AAAA,IACvC;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,QAAQ;AAAA,IACpD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,mBAAmB;AAAA,EAChE;AACF;","names":[]}

package/dist/versioning/registry.cjs

@@ -81,8 +81,10 @@ function checkVersions(features, emit, table) {
   const reg = getVersionRegistry();
   if (!reg.cores.includes(self)) {
     reg.cores.push(self);
-    if (reg.cores.length > 1) {
-      emit("DK_DUPLICATE_CORE", { versions: reg.cores.map((c) => String(c?.version)) });
+    const versions = reg.cores.map((c) => String(c?.version));
+    if (versions.some((v) => v !== import_version.VERSION)) emit("DK_DUPLICATE_CORE", { versions });
+    else if (versions.length > 1 && firstInSession("DK_DUPLICATE_CORE_SAME_VERSION")) {
+      emit("DK_DUPLICATE_CORE_SAME_VERSION", { version: import_version.VERSION, copies: versions.length });
     }
   }
   for (const name of import_codes.FIXED_GROUP) {

package/dist/versioning/registry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/versioning/registry.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport type { AnyFeature } from '../feature/types'\nimport { VERSION } from '../version'\nimport { FIXED_GROUP, versioningDiagnostics } from './codes'\nimport { satisfies } from './semver'\n\nkeepDiagnostics(versioningDiagnostics)\n\n/** `globalThis[Symbol.for('datakable')]`: shared by every copy of core in the process (§8.5). */\nexport const REGISTRY_KEY: unique symbol = Symbol.for('datakable') as never\n\ninterface CoreEntry {\n  readonly version: string\n}\n\n/** Version 1 of the registry shape. Later cores must keep these fields readable. */\nexport interface VersionRegistry {\n  v: number\n  /** One entry per core copy that created a table, in registration order. */\n  cores: CoreEntry[]\n  /** Fixed-group package → version (`registerPackage`). */\n  packages: Record<string, string>\n  /** Once-per-session keys (deprecations, dependency capabilities). */\n  reported: Set<string>\n}\n\n/** This copy of core; its identity tells copies apart even when their versions are equal. */\nconst self: CoreEntry = { version: VERSION }\n/** `package@version` pairs this copy already reported as mismatched. */\nconst mismatched = new Set<string>()\nlet local: VersionRegistry | undefined\n\nconst isObject = (v: unknown): v is Record<string, unknown> => v !== null && typeof v === 'object'\n\n/**\n * The global registry, created on first use. Fields are read defensively: a registry left by\n * another core version (or anything else under the symbol) is repaired, never trusted to throw.\n */\nexport function getVersionRegistry(): VersionRegistry {\n  const g = globalThis as unknown as Record<symbol, unknown>\n  try {\n    let r = g[REGISTRY_KEY]\n    if (!isObject(r)) {\n      r = {}\n      g[REGISTRY_KEY] = r\n    }\n    const reg = r as Partial<VersionRegistry>\n    if (typeof reg.v !== 'number') reg.v = 1\n    if (!Array.isArray(reg.cores)) reg.cores = []\n    if (!isObject(reg.packages)) reg.packages = {}\n    if (!(reg.reported instanceof Set)) reg.reported = new Set()\n    return reg as VersionRegistry\n  } catch {\n    // Frozen / non-writable global: fall back to a per-copy registry (no cross-copy detection).\n    local ??= { v: 1, cores: [], packages: {}, reported: new Set() }\n    return local\n  }\n}\n\n/**\n * Records a fixed-group package's version (`@datakable/react`, `datakable`) so `createTable` can\n * report `DK_VERSION_MISMATCH`. Called once by each binding when it is first used.\n */\nexport function registerPackage(name: string, version: string): void {\n  getVersionRegistry().packages[name] = version\n}\n\n/** `true` the first time `key` is seen in this session (across core copies). */\nexport function firstInSession(key: string): boolean {\n  const reported = getVersionRegistry().reported\n  if (reported.has(key)) return false\n  reported.add(key)\n  return true\n}\n\n/**\n * Version checks of one `createTable` (§8.5), cold path:\n * - feature `requires.core` against this core → `DatakableConfigError` `DK_FEATURE_INCOMPATIBLE`;\n * - registers this copy on its first table; a copy finding another one → `DK_DUPLICATE_CORE` (once);\n * - fixed-group packages with another version → `DK_VERSION_MISMATCH` (once per package version).\n */\nexport function checkVersions(features: readonly AnyFeature[], emit: Emit, table: string): void {\n  for (const f of features) {\n    const required = f.requires?.core\n    if (required === undefined) continue\n    const ok = typeof required === 'string' ? satisfies(VERSION, required) : undefined\n    if (ok === true) continue\n    throwConfigError(\n      'DK_FEATURE_INCOMPATIBLE',\n      { feature: f.name, required: String(required), core: VERSION, invalid: ok === undefined },\n      { table },\n    )\n  }\n  const reg = getVersionRegistry()\n  if (!reg.cores.includes(self)) {\n    reg.cores.push(self)\n    if (reg.cores.length > 1) {\n      emit('DK_DUPLICATE_CORE', { versions: reg.cores.map((c) => String(c?.version)) })\n    }\n  }\n  for (const name of FIXED_GROUP) {\n    const version = reg.packages[name]\n    if (typeof version !== 'string' || version === VERSION) continue\n    const key = `${name}@${version}`\n    if (mismatched.has(key)) continue\n    mismatched.add(key)\n    emit('DK_VERSION_MISMATCH', { package: name, version, core: VERSION })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AACjC,qBAAgC;AAGhC,qBAAwB;AACxB,mBAAmD;AACnD,oBAA0B;AAAA,IAE1B,gCAAgB,kCAAqB;AAG9B,IAAM,eAA8B,uBAAO,IAAI,WAAW;AAkBjE,IAAM,OAAkB,EAAE,SAAS,uBAAQ;AAE3C,IAAM,aAAa,oBAAI,IAAY;AACnC,IAAI;AAEJ,IAAM,WAAW,CAAC,MAA6C,MAAM,QAAQ,OAAO,MAAM;AAMnF,SAAS,qBAAsC;AACpD,QAAM,IAAI;AACV,MAAI;AACF,QAAI,IAAI,EAAE,YAAY;AACtB,QAAI,CAAC,SAAS,CAAC,GAAG;AAChB,UAAI,CAAC;AACL,QAAE,YAAY,IAAI;AAAA,IACpB;AACA,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,MAAM,SAAU,KAAI,IAAI;AACvC,QAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,EAAG,KAAI,QAAQ,CAAC;AAC5C,QAAI,CAAC,SAAS,IAAI,QAAQ,EAAG,KAAI,WAAW,CAAC;AAC7C,QAAI,EAAE,IAAI,oBAAoB,KAAM,KAAI,WAAW,oBAAI,IAAI;AAC3D,WAAO;AAAA,EACT,QAAQ;AAEN,cAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,oBAAI,IAAI,EAAE;AAC/D,WAAO;AAAA,EACT;AACF;AAMO,SAAS,gBAAgB,MAAc,SAAuB;AACnE,qBAAmB,EAAE,SAAS,IAAI,IAAI;AACxC;AAGO,SAAS,eAAe,KAAsB;AACnD,QAAM,WAAW,mBAAmB,EAAE;AACtC,MAAI,SAAS,IAAI,GAAG,EAAG,QAAO;AAC9B,WAAS,IAAI,GAAG;AAChB,SAAO;AACT;AAQO,SAAS,cAAc,UAAiC,MAAY,OAAqB;AAC9F,aAAW,KAAK,UAAU;AACxB,UAAM,WAAW,EAAE,UAAU;AAC7B,QAAI,aAAa,OAAW;AAC5B,UAAM,KAAK,OAAO,aAAa,eAAW,yBAAU,wBAAS,QAAQ,IAAI;AACzE,QAAI,OAAO,KAAM;AACjB;AAAA,MACE;AAAA,MACA,EAAE,SAAS,EAAE,MAAM,UAAU,OAAO,QAAQ,GAAG,MAAM,wBAAS,SAAS,OAAO,OAAU;AAAA,MACxF,EAAE,MAAM;AAAA,IACV;AAAA,EACF;AACA,QAAM,MAAM,mBAAmB;AAC/B,MAAI,CAAC,IAAI,MAAM,SAAS,IAAI,GAAG;AAC7B,QAAI,MAAM,KAAK,IAAI;AACnB,QAAI,IAAI,MAAM,SAAS,GAAG;AACxB,WAAK,qBAAqB,EAAE,UAAU,IAAI,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;AAAA,IAClF;AAAA,EACF;AACA,aAAW,QAAQ,0BAAa;AAC9B,UAAM,UAAU,IAAI,SAAS,IAAI;AACjC,QAAI,OAAO,YAAY,YAAY,YAAY,uBAAS;AACxD,UAAM,MAAM,GAAG,IAAI,IAAI,OAAO;AAC9B,QAAI,WAAW,IAAI,GAAG,EAAG;AACzB,eAAW,IAAI,GAAG;AAClB,SAAK,uBAAuB,EAAE,SAAS,MAAM,SAAS,MAAM,uBAAQ,CAAC;AAAA,EACvE;AACF;","names":[]}
+{"version":3,"sources":["../../src/versioning/registry.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport type { AnyFeature } from '../feature/types'\nimport { VERSION } from '../version'\nimport { FIXED_GROUP, versioningDiagnostics } from './codes'\nimport { satisfies } from './semver'\n\nkeepDiagnostics(versioningDiagnostics)\n\n/** `globalThis[Symbol.for('datakable')]`: shared by every copy of core in the process (§8.5). */\nexport const REGISTRY_KEY: unique symbol = Symbol.for('datakable') as never\n\ninterface CoreEntry {\n  readonly version: string\n}\n\n/** Version 1 of the registry shape. Later cores must keep these fields readable. */\nexport interface VersionRegistry {\n  v: number\n  /** One entry per core copy that created a table, in registration order. */\n  cores: CoreEntry[]\n  /** Fixed-group package → version (`registerPackage`). */\n  packages: Record<string, string>\n  /** Once-per-session keys (deprecations, dependency capabilities). */\n  reported: Set<string>\n}\n\n/** This copy of core; its identity tells copies apart even when their versions are equal. */\nconst self: CoreEntry = { version: VERSION }\n/** `package@version` pairs this copy already reported as mismatched. */\nconst mismatched = new Set<string>()\nlet local: VersionRegistry | undefined\n\nconst isObject = (v: unknown): v is Record<string, unknown> => v !== null && typeof v === 'object'\n\n/**\n * The global registry, created on first use. Fields are read defensively: a registry left by\n * another core version (or anything else under the symbol) is repaired, never trusted to throw.\n */\nexport function getVersionRegistry(): VersionRegistry {\n  const g = globalThis as unknown as Record<symbol, unknown>\n  try {\n    let r = g[REGISTRY_KEY]\n    if (!isObject(r)) {\n      r = {}\n      g[REGISTRY_KEY] = r\n    }\n    const reg = r as Partial<VersionRegistry>\n    if (typeof reg.v !== 'number') reg.v = 1\n    if (!Array.isArray(reg.cores)) reg.cores = []\n    if (!isObject(reg.packages)) reg.packages = {}\n    if (!(reg.reported instanceof Set)) reg.reported = new Set()\n    return reg as VersionRegistry\n  } catch {\n    // Frozen / non-writable global: fall back to a per-copy registry (no cross-copy detection).\n    local ??= { v: 1, cores: [], packages: {}, reported: new Set() }\n    return local\n  }\n}\n\n/**\n * Records a fixed-group package's version (`@datakable/react`, `datakable`) so `createTable` can\n * report `DK_VERSION_MISMATCH`. Called once by each binding when it is first used.\n */\nexport function registerPackage(name: string, version: string): void {\n  getVersionRegistry().packages[name] = version\n}\n\n/** `true` the first time `key` is seen in this session (across core copies). */\nexport function firstInSession(key: string): boolean {\n  const reported = getVersionRegistry().reported\n  if (reported.has(key)) return false\n  reported.add(key)\n  return true\n}\n\n/**\n * Version checks of one `createTable` (§8.5), cold path:\n * - feature `requires.core` against this core → `DatakableConfigError` `DK_FEATURE_INCOMPATIBLE`;\n * - registers this copy on its first table; a copy finding one of another version →\n *   `DK_DUPLICATE_CORE` (once per copy), only copies of its own version →\n *   `DK_DUPLICATE_CORE_SAME_VERSION` (info, once per session);\n * - fixed-group packages with another version → `DK_VERSION_MISMATCH` (once per package version).\n */\nexport function checkVersions(features: readonly AnyFeature[], emit: Emit, table: string): void {\n  for (const f of features) {\n    const required = f.requires?.core\n    if (required === undefined) continue\n    const ok = typeof required === 'string' ? satisfies(VERSION, required) : undefined\n    if (ok === true) continue\n    throwConfigError(\n      'DK_FEATURE_INCOMPATIBLE',\n      { feature: f.name, required: String(required), core: VERSION, invalid: ok === undefined },\n      { table },\n    )\n  }\n  const reg = getVersionRegistry()\n  if (!reg.cores.includes(self)) {\n    reg.cores.push(self)\n    const versions = reg.cores.map((c) => String(c?.version))\n    // One version evaluated again (ESM + CJS builds, bundler layers, HMR) is not a second install\n    // (#14): an info, once per session, that strict never throws.\n    if (versions.some((v) => v !== VERSION)) emit('DK_DUPLICATE_CORE', { versions })\n    else if (versions.length > 1 && firstInSession('DK_DUPLICATE_CORE_SAME_VERSION')) {\n      emit('DK_DUPLICATE_CORE_SAME_VERSION', { version: VERSION, copies: versions.length })\n    }\n  }\n  for (const name of FIXED_GROUP) {\n    const version = reg.packages[name]\n    if (typeof version !== 'string' || version === VERSION) continue\n    const key = `${name}@${version}`\n    if (mismatched.has(key)) continue\n    mismatched.add(key)\n    emit('DK_VERSION_MISMATCH', { package: name, version, core: VERSION })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AACjC,qBAAgC;AAGhC,qBAAwB;AACxB,mBAAmD;AACnD,oBAA0B;AAAA,IAE1B,gCAAgB,kCAAqB;AAG9B,IAAM,eAA8B,uBAAO,IAAI,WAAW;AAkBjE,IAAM,OAAkB,EAAE,SAAS,uBAAQ;AAE3C,IAAM,aAAa,oBAAI,IAAY;AACnC,IAAI;AAEJ,IAAM,WAAW,CAAC,MAA6C,MAAM,QAAQ,OAAO,MAAM;AAMnF,SAAS,qBAAsC;AACpD,QAAM,IAAI;AACV,MAAI;AACF,QAAI,IAAI,EAAE,YAAY;AACtB,QAAI,CAAC,SAAS,CAAC,GAAG;AAChB,UAAI,CAAC;AACL,QAAE,YAAY,IAAI;AAAA,IACpB;AACA,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,MAAM,SAAU,KAAI,IAAI;AACvC,QAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,EAAG,KAAI,QAAQ,CAAC;AAC5C,QAAI,CAAC,SAAS,IAAI,QAAQ,EAAG,KAAI,WAAW,CAAC;AAC7C,QAAI,EAAE,IAAI,oBAAoB,KAAM,KAAI,WAAW,oBAAI,IAAI;AAC3D,WAAO;AAAA,EACT,QAAQ;AAEN,cAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,oBAAI,IAAI,EAAE;AAC/D,WAAO;AAAA,EACT;AACF;AAMO,SAAS,gBAAgB,MAAc,SAAuB;AACnE,qBAAmB,EAAE,SAAS,IAAI,IAAI;AACxC;AAGO,SAAS,eAAe,KAAsB;AACnD,QAAM,WAAW,mBAAmB,EAAE;AACtC,MAAI,SAAS,IAAI,GAAG,EAAG,QAAO;AAC9B,WAAS,IAAI,GAAG;AAChB,SAAO;AACT;AAUO,SAAS,cAAc,UAAiC,MAAY,OAAqB;AAC9F,aAAW,KAAK,UAAU;AACxB,UAAM,WAAW,EAAE,UAAU;AAC7B,QAAI,aAAa,OAAW;AAC5B,UAAM,KAAK,OAAO,aAAa,eAAW,yBAAU,wBAAS,QAAQ,IAAI;AACzE,QAAI,OAAO,KAAM;AACjB;AAAA,MACE;AAAA,MACA,EAAE,SAAS,EAAE,MAAM,UAAU,OAAO,QAAQ,GAAG,MAAM,wBAAS,SAAS,OAAO,OAAU;AAAA,MACxF,EAAE,MAAM;AAAA,IACV;AAAA,EACF;AACA,QAAM,MAAM,mBAAmB;AAC/B,MAAI,CAAC,IAAI,MAAM,SAAS,IAAI,GAAG;AAC7B,QAAI,MAAM,KAAK,IAAI;AACnB,UAAM,WAAW,IAAI,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAGxD,QAAI,SAAS,KAAK,CAAC,MAAM,MAAM,sBAAO,EAAG,MAAK,qBAAqB,EAAE,SAAS,CAAC;AAAA,aACtE,SAAS,SAAS,KAAK,eAAe,gCAAgC,GAAG;AAChF,WAAK,kCAAkC,EAAE,SAAS,wBAAS,QAAQ,SAAS,OAAO,CAAC;AAAA,IACtF;AAAA,EACF;AACA,aAAW,QAAQ,0BAAa;AAC9B,UAAM,UAAU,IAAI,SAAS,IAAI;AACjC,QAAI,OAAO,YAAY,YAAY,YAAY,uBAAS;AACxD,UAAM,MAAM,GAAG,IAAI,IAAI,OAAO;AAC9B,QAAI,WAAW,IAAI,GAAG,EAAG;AACzB,eAAW,IAAI,GAAG;AAClB,SAAK,uBAAuB,EAAE,SAAS,MAAM,SAAS,MAAM,uBAAQ,CAAC;AAAA,EACvE;AACF;","names":[]}

package/dist/versioning/registry.js

@@ -53,8 +53,10 @@ function checkVersions(features, emit, table) {
   const reg = getVersionRegistry();
   if (!reg.cores.includes(self)) {
     reg.cores.push(self);
-    if (reg.cores.length > 1) {
-      emit("DK_DUPLICATE_CORE", { versions: reg.cores.map((c) => String(c?.version)) });
+    const versions = reg.cores.map((c) => String(c?.version));
+    if (versions.some((v) => v !== VERSION)) emit("DK_DUPLICATE_CORE", { versions });
+    else if (versions.length > 1 && firstInSession("DK_DUPLICATE_CORE_SAME_VERSION")) {
+      emit("DK_DUPLICATE_CORE_SAME_VERSION", { version: VERSION, copies: versions.length });
     }
   }
   for (const name of FIXED_GROUP) {

package/dist/versioning/registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/versioning/registry.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport type { AnyFeature } from '../feature/types'\nimport { VERSION } from '../version'\nimport { FIXED_GROUP, versioningDiagnostics } from './codes'\nimport { satisfies } from './semver'\n\nkeepDiagnostics(versioningDiagnostics)\n\n/** `globalThis[Symbol.for('datakable')]`: shared by every copy of core in the process (§8.5). */\nexport const REGISTRY_KEY: unique symbol = Symbol.for('datakable') as never\n\ninterface CoreEntry {\n  readonly version: string\n}\n\n/** Version 1 of the registry shape. Later cores must keep these fields readable. */\nexport interface VersionRegistry {\n  v: number\n  /** One entry per core copy that created a table, in registration order. */\n  cores: CoreEntry[]\n  /** Fixed-group package → version (`registerPackage`). */\n  packages: Record<string, string>\n  /** Once-per-session keys (deprecations, dependency capabilities). */\n  reported: Set<string>\n}\n\n/** This copy of core; its identity tells copies apart even when their versions are equal. */\nconst self: CoreEntry = { version: VERSION }\n/** `package@version` pairs this copy already reported as mismatched. */\nconst mismatched = new Set<string>()\nlet local: VersionRegistry | undefined\n\nconst isObject = (v: unknown): v is Record<string, unknown> => v !== null && typeof v === 'object'\n\n/**\n * The global registry, created on first use. Fields are read defensively: a registry left by\n * another core version (or anything else under the symbol) is repaired, never trusted to throw.\n */\nexport function getVersionRegistry(): VersionRegistry {\n  const g = globalThis as unknown as Record<symbol, unknown>\n  try {\n    let r = g[REGISTRY_KEY]\n    if (!isObject(r)) {\n      r = {}\n      g[REGISTRY_KEY] = r\n    }\n    const reg = r as Partial<VersionRegistry>\n    if (typeof reg.v !== 'number') reg.v = 1\n    if (!Array.isArray(reg.cores)) reg.cores = []\n    if (!isObject(reg.packages)) reg.packages = {}\n    if (!(reg.reported instanceof Set)) reg.reported = new Set()\n    return reg as VersionRegistry\n  } catch {\n    // Frozen / non-writable global: fall back to a per-copy registry (no cross-copy detection).\n    local ??= { v: 1, cores: [], packages: {}, reported: new Set() }\n    return local\n  }\n}\n\n/**\n * Records a fixed-group package's version (`@datakable/react`, `datakable`) so `createTable` can\n * report `DK_VERSION_MISMATCH`. Called once by each binding when it is first used.\n */\nexport function registerPackage(name: string, version: string): void {\n  getVersionRegistry().packages[name] = version\n}\n\n/** `true` the first time `key` is seen in this session (across core copies). */\nexport function firstInSession(key: string): boolean {\n  const reported = getVersionRegistry().reported\n  if (reported.has(key)) return false\n  reported.add(key)\n  return true\n}\n\n/**\n * Version checks of one `createTable` (§8.5), cold path:\n * - feature `requires.core` against this core → `DatakableConfigError` `DK_FEATURE_INCOMPATIBLE`;\n * - registers this copy on its first table; a copy finding another one → `DK_DUPLICATE_CORE` (once);\n * - fixed-group packages with another version → `DK_VERSION_MISMATCH` (once per package version).\n */\nexport function checkVersions(features: readonly AnyFeature[], emit: Emit, table: string): void {\n  for (const f of features) {\n    const required = f.requires?.core\n    if (required === undefined) continue\n    const ok = typeof required === 'string' ? satisfies(VERSION, required) : undefined\n    if (ok === true) continue\n    throwConfigError(\n      'DK_FEATURE_INCOMPATIBLE',\n      { feature: f.name, required: String(required), core: VERSION, invalid: ok === undefined },\n      { table },\n    )\n  }\n  const reg = getVersionRegistry()\n  if (!reg.cores.includes(self)) {\n    reg.cores.push(self)\n    if (reg.cores.length > 1) {\n      emit('DK_DUPLICATE_CORE', { versions: reg.cores.map((c) => String(c?.version)) })\n    }\n  }\n  for (const name of FIXED_GROUP) {\n    const version = reg.packages[name]\n    if (typeof version !== 'string' || version === VERSION) continue\n    const key = `${name}@${version}`\n    if (mismatched.has(key)) continue\n    mismatched.add(key)\n    emit('DK_VERSION_MISMATCH', { package: name, version, core: VERSION })\n  }\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAGhC,SAAS,eAAe;AACxB,SAAS,aAAa,6BAA6B;AACnD,SAAS,iBAAiB;AAE1B,gBAAgB,qBAAqB;AAG9B,IAAM,eAA8B,uBAAO,IAAI,WAAW;AAkBjE,IAAM,OAAkB,EAAE,SAAS,QAAQ;AAE3C,IAAM,aAAa,oBAAI,IAAY;AACnC,IAAI;AAEJ,IAAM,WAAW,CAAC,MAA6C,MAAM,QAAQ,OAAO,MAAM;AAMnF,SAAS,qBAAsC;AACpD,QAAM,IAAI;AACV,MAAI;AACF,QAAI,IAAI,EAAE,YAAY;AACtB,QAAI,CAAC,SAAS,CAAC,GAAG;AAChB,UAAI,CAAC;AACL,QAAE,YAAY,IAAI;AAAA,IACpB;AACA,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,MAAM,SAAU,KAAI,IAAI;AACvC,QAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,EAAG,KAAI,QAAQ,CAAC;AAC5C,QAAI,CAAC,SAAS,IAAI,QAAQ,EAAG,KAAI,WAAW,CAAC;AAC7C,QAAI,EAAE,IAAI,oBAAoB,KAAM,KAAI,WAAW,oBAAI,IAAI;AAC3D,WAAO;AAAA,EACT,QAAQ;AAEN,cAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,oBAAI,IAAI,EAAE;AAC/D,WAAO;AAAA,EACT;AACF;AAMO,SAAS,gBAAgB,MAAc,SAAuB;AACnE,qBAAmB,EAAE,SAAS,IAAI,IAAI;AACxC;AAGO,SAAS,eAAe,KAAsB;AACnD,QAAM,WAAW,mBAAmB,EAAE;AACtC,MAAI,SAAS,IAAI,GAAG,EAAG,QAAO;AAC9B,WAAS,IAAI,GAAG;AAChB,SAAO;AACT;AAQO,SAAS,cAAc,UAAiC,MAAY,OAAqB;AAC9F,aAAW,KAAK,UAAU;AACxB,UAAM,WAAW,EAAE,UAAU;AAC7B,QAAI,aAAa,OAAW;AAC5B,UAAM,KAAK,OAAO,aAAa,WAAW,UAAU,SAAS,QAAQ,IAAI;AACzE,QAAI,OAAO,KAAM;AACjB;AAAA,MACE;AAAA,MACA,EAAE,SAAS,EAAE,MAAM,UAAU,OAAO,QAAQ,GAAG,MAAM,SAAS,SAAS,OAAO,OAAU;AAAA,MACxF,EAAE,MAAM;AAAA,IACV;AAAA,EACF;AACA,QAAM,MAAM,mBAAmB;AAC/B,MAAI,CAAC,IAAI,MAAM,SAAS,IAAI,GAAG;AAC7B,QAAI,MAAM,KAAK,IAAI;AACnB,QAAI,IAAI,MAAM,SAAS,GAAG;AACxB,WAAK,qBAAqB,EAAE,UAAU,IAAI,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;AAAA,IAClF;AAAA,EACF;AACA,aAAW,QAAQ,aAAa;AAC9B,UAAM,UAAU,IAAI,SAAS,IAAI;AACjC,QAAI,OAAO,YAAY,YAAY,YAAY,QAAS;AACxD,UAAM,MAAM,GAAG,IAAI,IAAI,OAAO;AAC9B,QAAI,WAAW,IAAI,GAAG,EAAG;AACzB,eAAW,IAAI,GAAG;AAClB,SAAK,uBAAuB,EAAE,SAAS,MAAM,SAAS,MAAM,QAAQ,CAAC;AAAA,EACvE;AACF;","names":[]}
+{"version":3,"sources":["../../src/versioning/registry.ts"],"sourcesContent":["import { throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport type { Emit } from '../diagnostics/types'\nimport type { AnyFeature } from '../feature/types'\nimport { VERSION } from '../version'\nimport { FIXED_GROUP, versioningDiagnostics } from './codes'\nimport { satisfies } from './semver'\n\nkeepDiagnostics(versioningDiagnostics)\n\n/** `globalThis[Symbol.for('datakable')]`: shared by every copy of core in the process (§8.5). */\nexport const REGISTRY_KEY: unique symbol = Symbol.for('datakable') as never\n\ninterface CoreEntry {\n  readonly version: string\n}\n\n/** Version 1 of the registry shape. Later cores must keep these fields readable. */\nexport interface VersionRegistry {\n  v: number\n  /** One entry per core copy that created a table, in registration order. */\n  cores: CoreEntry[]\n  /** Fixed-group package → version (`registerPackage`). */\n  packages: Record<string, string>\n  /** Once-per-session keys (deprecations, dependency capabilities). */\n  reported: Set<string>\n}\n\n/** This copy of core; its identity tells copies apart even when their versions are equal. */\nconst self: CoreEntry = { version: VERSION }\n/** `package@version` pairs this copy already reported as mismatched. */\nconst mismatched = new Set<string>()\nlet local: VersionRegistry | undefined\n\nconst isObject = (v: unknown): v is Record<string, unknown> => v !== null && typeof v === 'object'\n\n/**\n * The global registry, created on first use. Fields are read defensively: a registry left by\n * another core version (or anything else under the symbol) is repaired, never trusted to throw.\n */\nexport function getVersionRegistry(): VersionRegistry {\n  const g = globalThis as unknown as Record<symbol, unknown>\n  try {\n    let r = g[REGISTRY_KEY]\n    if (!isObject(r)) {\n      r = {}\n      g[REGISTRY_KEY] = r\n    }\n    const reg = r as Partial<VersionRegistry>\n    if (typeof reg.v !== 'number') reg.v = 1\n    if (!Array.isArray(reg.cores)) reg.cores = []\n    if (!isObject(reg.packages)) reg.packages = {}\n    if (!(reg.reported instanceof Set)) reg.reported = new Set()\n    return reg as VersionRegistry\n  } catch {\n    // Frozen / non-writable global: fall back to a per-copy registry (no cross-copy detection).\n    local ??= { v: 1, cores: [], packages: {}, reported: new Set() }\n    return local\n  }\n}\n\n/**\n * Records a fixed-group package's version (`@datakable/react`, `datakable`) so `createTable` can\n * report `DK_VERSION_MISMATCH`. Called once by each binding when it is first used.\n */\nexport function registerPackage(name: string, version: string): void {\n  getVersionRegistry().packages[name] = version\n}\n\n/** `true` the first time `key` is seen in this session (across core copies). */\nexport function firstInSession(key: string): boolean {\n  const reported = getVersionRegistry().reported\n  if (reported.has(key)) return false\n  reported.add(key)\n  return true\n}\n\n/**\n * Version checks of one `createTable` (§8.5), cold path:\n * - feature `requires.core` against this core → `DatakableConfigError` `DK_FEATURE_INCOMPATIBLE`;\n * - registers this copy on its first table; a copy finding one of another version →\n *   `DK_DUPLICATE_CORE` (once per copy), only copies of its own version →\n *   `DK_DUPLICATE_CORE_SAME_VERSION` (info, once per session);\n * - fixed-group packages with another version → `DK_VERSION_MISMATCH` (once per package version).\n */\nexport function checkVersions(features: readonly AnyFeature[], emit: Emit, table: string): void {\n  for (const f of features) {\n    const required = f.requires?.core\n    if (required === undefined) continue\n    const ok = typeof required === 'string' ? satisfies(VERSION, required) : undefined\n    if (ok === true) continue\n    throwConfigError(\n      'DK_FEATURE_INCOMPATIBLE',\n      { feature: f.name, required: String(required), core: VERSION, invalid: ok === undefined },\n      { table },\n    )\n  }\n  const reg = getVersionRegistry()\n  if (!reg.cores.includes(self)) {\n    reg.cores.push(self)\n    const versions = reg.cores.map((c) => String(c?.version))\n    // One version evaluated again (ESM + CJS builds, bundler layers, HMR) is not a second install\n    // (#14): an info, once per session, that strict never throws.\n    if (versions.some((v) => v !== VERSION)) emit('DK_DUPLICATE_CORE', { versions })\n    else if (versions.length > 1 && firstInSession('DK_DUPLICATE_CORE_SAME_VERSION')) {\n      emit('DK_DUPLICATE_CORE_SAME_VERSION', { version: VERSION, copies: versions.length })\n    }\n  }\n  for (const name of FIXED_GROUP) {\n    const version = reg.packages[name]\n    if (typeof version !== 'string' || version === VERSION) continue\n    const key = `${name}@${version}`\n    if (mismatched.has(key)) continue\n    mismatched.add(key)\n    emit('DK_VERSION_MISMATCH', { package: name, version, core: VERSION })\n  }\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAGhC,SAAS,eAAe;AACxB,SAAS,aAAa,6BAA6B;AACnD,SAAS,iBAAiB;AAE1B,gBAAgB,qBAAqB;AAG9B,IAAM,eAA8B,uBAAO,IAAI,WAAW;AAkBjE,IAAM,OAAkB,EAAE,SAAS,QAAQ;AAE3C,IAAM,aAAa,oBAAI,IAAY;AACnC,IAAI;AAEJ,IAAM,WAAW,CAAC,MAA6C,MAAM,QAAQ,OAAO,MAAM;AAMnF,SAAS,qBAAsC;AACpD,QAAM,IAAI;AACV,MAAI;AACF,QAAI,IAAI,EAAE,YAAY;AACtB,QAAI,CAAC,SAAS,CAAC,GAAG;AAChB,UAAI,CAAC;AACL,QAAE,YAAY,IAAI;AAAA,IACpB;AACA,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,MAAM,SAAU,KAAI,IAAI;AACvC,QAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,EAAG,KAAI,QAAQ,CAAC;AAC5C,QAAI,CAAC,SAAS,IAAI,QAAQ,EAAG,KAAI,WAAW,CAAC;AAC7C,QAAI,EAAE,IAAI,oBAAoB,KAAM,KAAI,WAAW,oBAAI,IAAI;AAC3D,WAAO;AAAA,EACT,QAAQ;AAEN,cAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,oBAAI,IAAI,EAAE;AAC/D,WAAO;AAAA,EACT;AACF;AAMO,SAAS,gBAAgB,MAAc,SAAuB;AACnE,qBAAmB,EAAE,SAAS,IAAI,IAAI;AACxC;AAGO,SAAS,eAAe,KAAsB;AACnD,QAAM,WAAW,mBAAmB,EAAE;AACtC,MAAI,SAAS,IAAI,GAAG,EAAG,QAAO;AAC9B,WAAS,IAAI,GAAG;AAChB,SAAO;AACT;AAUO,SAAS,cAAc,UAAiC,MAAY,OAAqB;AAC9F,aAAW,KAAK,UAAU;AACxB,UAAM,WAAW,EAAE,UAAU;AAC7B,QAAI,aAAa,OAAW;AAC5B,UAAM,KAAK,OAAO,aAAa,WAAW,UAAU,SAAS,QAAQ,IAAI;AACzE,QAAI,OAAO,KAAM;AACjB;AAAA,MACE;AAAA,MACA,EAAE,SAAS,EAAE,MAAM,UAAU,OAAO,QAAQ,GAAG,MAAM,SAAS,SAAS,OAAO,OAAU;AAAA,MACxF,EAAE,MAAM;AAAA,IACV;AAAA,EACF;AACA,QAAM,MAAM,mBAAmB;AAC/B,MAAI,CAAC,IAAI,MAAM,SAAS,IAAI,GAAG;AAC7B,QAAI,MAAM,KAAK,IAAI;AACnB,UAAM,WAAW,IAAI,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAGxD,QAAI,SAAS,KAAK,CAAC,MAAM,MAAM,OAAO,EAAG,MAAK,qBAAqB,EAAE,SAAS,CAAC;AAAA,aACtE,SAAS,SAAS,KAAK,eAAe,gCAAgC,GAAG;AAChF,WAAK,kCAAkC,EAAE,SAAS,SAAS,QAAQ,SAAS,OAAO,CAAC;AAAA,IACtF;AAAA,EACF;AACA,aAAW,QAAQ,aAAa;AAC9B,UAAM,UAAU,IAAI,SAAS,IAAI;AACjC,QAAI,OAAO,YAAY,YAAY,YAAY,QAAS;AACxD,UAAM,MAAM,GAAG,IAAI,IAAI,OAAO;AAC9B,QAAI,WAAW,IAAI,GAAG,EAAG;AACzB,eAAW,IAAI,GAAG;AAClB,SAAK,uBAAuB,EAAE,SAAS,MAAM,SAAS,MAAM,QAAQ,CAAC;AAAA,EACvE;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datakable/core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Headless, framework-agnostic core of DataKable — table state, sorting, filtering and types.",
   "license": "MIT",
   "author": "Supakit Kitjanabumrungsak",
@@ -23,11 +23,47 @@
   "type": "module",
   "sideEffects": [
     "./dist/messages/index.js",
-    "./dist/messages/index.cjs"
+    "./dist/messages/index.cjs",
+    "./dist/diagnostics/process-guard.js",
+    "./dist/diagnostics/process-guard.cjs"
   ],
+  "engines": {
+    "node": ">=18.18.0"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "column-filters": [
+        "./dist/column-filters.d.ts"
+      ],
+      "validity": [
+        "./dist/validity.d.ts"
+      ],
+      "search": [
+        "./dist/search.d.ts"
+      ],
+      "sorting": [
+        "./dist/sorting.d.ts"
+      ],
+      "pagination": [
+        "./dist/pagination.d.ts"
+      ],
+      "messages": [
+        "./dist/messages.d.ts"
+      ],
+      "schema": [
+        "./dist/schema.d.ts"
+      ],
+      "search-async": [
+        "./dist/search-async.d.ts"
+      ],
+      "server": [
+        "./dist/server.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "import": {
@@ -146,7 +182,7 @@
     "build": "tsup && node scripts/postbuild.mjs",
     "dev": "tsup --watch",
     "typecheck": "tsc -p tsconfig.json",
-    "check:pkg": "publint --strict && attw --pack . --profile node16 && node scripts/check-catalog.mjs",
+    "check:pkg": "publint --strict && attw --pack . && node scripts/check-catalog.mjs",
     "check:catalog": "node scripts/check-catalog.mjs"
   }
 }