universal-physics-tensor 9.0.0 → 11.0.0

package/dist/core/axes-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"axes-registry.js","sourceRoot":"","sources":["../../src/core/axes-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkCjD,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACtC,UAAU,EAAE,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;IAC5C,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;IAC1C,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,CAAC;IACzC,aAAa,EAAE,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC;IAClD,eAAe,EAAE,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACtD,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;IACpC,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAC3C,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC;IAC7C,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,eAAe,GAAoB,MAAM,CAAC,MAAM,CAAC;IACrD,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAClD,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;IAC5C,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAClD,cAAc,EAAE,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC;CAC3D,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,IAAI,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,eAAe;CAC7B,CAAC,CAAC"}
+{"version":3,"file":"axes-registry.js","sourceRoot":"","sources":["../../src/core/axes-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAsCjD,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACtC,UAAU,EAAE,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;IAC5C,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;IAC1C,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,CAAC;IACzC,aAAa,EAAE,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC;IAClD,eAAe,EAAE,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACtD,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;IACpC,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAC3C,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC;IAC7C,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,eAAe,GAAoB,MAAM,CAAC,MAAM,CAAC;IACrD,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAClD,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;IAC5C,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAClD,cAAc,EAAE,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC;CAC3D,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,IAAI,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,eAAe;CAC7B,CAAC,CAAC","sourcesContent":["/**\n * `Axes` singleton registry — module-load-stable `UniversalIndex`\n * references for every physics-axis value in `src/core/types.ts`.\n *\n * Phase 1 of v0.7 Proposal 1 (Intelligent Index Layer).\n *\n * Per Decision #4 (`docs/planning/v0.7-Proposal-1-Design.md`),\n * `Axes` is computed exactly once per Node process. Both the outer\n * namespace and each per-axis sub-object are `Object.freeze`d:\n * mutation attempts in strict mode throw `TypeError`. The values\n * inside are full `UniversalIndex<Axis>` objects (with stable\n * `id`s assigned at module load); same-object identity across\n * import sites is the load-bearing guarantee.\n *\n * Census basis: `docs/architecture/archive/v0.7-p1-baseline.md` Task 0.1.\n *   - 4 scales × 5 forces × 5 symmetries × 4 information measures\n *     = 18 stable references total\n *   - dimension/topology axes are integer-valued and NOT enumerable\n *     from `TensorConfig` — no `Axes.dimension` or `Axes.topology`\n *     sub-namespace ships in v0.7.0\n *\n * @module core/axes-registry\n */\n\nimport { makeIndex } from './universal-index.js';\nimport type { UniversalIndex } from './universal-index.js';\nimport type {\n  PhysicalScale,\n  Force,\n  Symmetry,\n  InformationMeasure,\n} from './types.js';\n\n// ---------------------------------------------------------------------------\n// Per-namespace records — typed so consumers get autocompletion for\n// `Axes.scale.<quantum|mesoscopic|classical|cosmological>`, etc.\n// ---------------------------------------------------------------------------\n\n/** The scale namespace of {@link AxesRegistry}: one index per `PhysicalScale`. @public */\nexport type ScaleAxes = { readonly [K in PhysicalScale]: UniversalIndex<'scale'> };\n/** The force namespace of {@link AxesRegistry}: one index per `Force`. @public */\nexport type ForceAxes = { readonly [K in Force]: UniversalIndex<'force'> };\n/** The symmetry namespace of {@link AxesRegistry}: one index per `Symmetry`. @public */\nexport type SymmetryAxes = { readonly [K in Symmetry]: UniversalIndex<'symmetry'> };\n/** The information namespace of {@link AxesRegistry}: one index per `InformationMeasure`. @public */\nexport type InformationAxes = {\n  readonly [K in InformationMeasure]: UniversalIndex<'information'>;\n};\n\n/**\n * Outer registry shape. Frozen at module load; per-namespace\n * sub-objects also frozen.\n *\n * @public\n */\nexport interface AxesRegistry {\n  readonly scale: ScaleAxes;\n  readonly force: ForceAxes;\n  readonly symmetry: SymmetryAxes;\n  readonly information: InformationAxes;\n}\n\n// ---------------------------------------------------------------------------\n// Registry construction — one makeIndex call per member, frozen\n// ---------------------------------------------------------------------------\n\nconst scaleAxes: ScaleAxes = Object.freeze({\n  quantum: makeIndex('scale', 'quantum'),\n  mesoscopic: makeIndex('scale', 'mesoscopic'),\n  classical: makeIndex('scale', 'classical'),\n  cosmological: makeIndex('scale', 'cosmological'),\n});\n\nconst forceAxes: ForceAxes = Object.freeze({\n  gravitational: makeIndex('force', 'gravitational'),\n  electromagnetic: makeIndex('force', 'electromagnetic'),\n  weak: makeIndex('force', 'weak'),\n  strong: makeIndex('force', 'strong'),\n  emergent: makeIndex('force', 'emergent'),\n});\n\nconst symmetryAxes: SymmetryAxes = Object.freeze({\n  poincare: makeIndex('symmetry', 'poincare'),\n  gauge: makeIndex('symmetry', 'gauge'),\n  conformal: makeIndex('symmetry', 'conformal'),\n  susy: makeIndex('symmetry', 'susy'),\n  emergent: makeIndex('symmetry', 'emergent'),\n});\n\nconst informationAxes: InformationAxes = Object.freeze({\n  vonNeumann: makeIndex('information', 'vonNeumann'),\n  shannon: makeIndex('information', 'shannon'),\n  kolmogorov: makeIndex('information', 'kolmogorov'),\n  quantumDiscord: makeIndex('information', 'quantumDiscord'),\n});\n\n/**\n * The canonical `Axes` registry. Same object across all import\n * sites; entry references stable across all reads.\n *\n * Usage:\n *   import { Axes } from 'universal-physics-tensor';\n *   const myIdx = Axes.scale.quantum; // UniversalIndex<'scale'>\n *\n * Two `LabeledTensor`s contracting on `Axes.scale.quantum` produce\n * a contraction. Two fresh `makeIndex('scale', 'quantum')` calls are\n * different ids: `contract` throws `IndexNameMismatchError` and names\n * both ids. Use the registry for shared identity (Decision #4).\n *\n * @public\n */\nexport const Axes: AxesRegistry = Object.freeze({\n  scale: scaleAxes,\n  force: forceAxes,\n  symmetry: symmetryAxes,\n  information: informationAxes,\n});\n"]}

package/dist/core/cell.js.map

@@ -1 +1 @@
-{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../src/core/cell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA+GH,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAC9E,yEAAyE;AACzE,oEAAoE;AACpE,sEAAsE;AACtE,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,yEAAyE;AACzE,sEAAsE;AACtE,yEAAyE;AACzE,qEAAqE;AACrE,iCAAiC;AAEjC;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,CAAS;IACvC,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,aAAa,CAAC;IACnC,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,aAAa,CAAC;IACnC,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO;QACL,IAAI,EAAE,KAAK;QACX,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,CAAiB;IAC5C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAC;QAChD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,CAAqB;IACnD,mEAAmE;IACnE,mEAAmE;IACnE,mBAAmB;IACnB,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpF,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAEpF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ;QACR,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAC;QAChD,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../src/core/cell.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Typed `Cell` discriminated union for `UniversalTensor`'s cell storage.\n *\n * Three variants — `LawCell`, `BridgeCell`, `EmergenceCell` — each\n * carrying a `kind` discriminator that lets TypeScript narrow to the\n * specific variant at every consumption site. Mirrors the v0.6.1\n * validator-registry's discriminated-union pattern at\n * `src/dimensional/validator-registry.ts`.\n *\n * Design doc: `docs/planning/v0.7-Proposal-3-Design.md`.\n * Review findings: `docs/planning/v0.7-Proposal-3-Review-Findings.md`.\n *\n * Migration relationship to `src/core/types.ts`:\n *   - `PhysicalLaw` ↔ `LawCell` (field-shape faithful; `confidence`\n *     flips `number` → string-literal union)\n *   - `BridgeEquation` ↔ `BridgeCell` (same migration)\n *   - `EmergentPhenomenon` ↔ `EmergenceCell` (same migration)\n *\n * The old interfaces are NOT deleted and NOT `@deprecated`-tagged in\n * this sprint (per Eve-R2 + the Phase 0 consumer-import census:\n * 4 in-repo sites still use them). A future v0.7.x sprint migrates\n * those consumers and then adds `@deprecated`.\n *\n * **No `confidenceToStatus` adapter is shipped** (per Eve-R3). The\n * 42-bridge catalog has BOTH a numeric `confidence` AND a curated\n * string `status` field, set independently; an adapter would\n * produce labels that contradict the catalog curation\n * (e.g. `status: 'established'` + `confidence: 0.7` → adapter\n * returns `'speculative'`). Callers must pass the string explicitly\n * at cell-construction sites.\n *\n * @module core/cell\n */\n\nimport type {\n  PhysicalScale,\n  Force,\n  Symmetry,\n  InformationMeasure,\n  TensorIndices,\n  PhysicalLaw,\n  BridgeEquation,\n  EmergentPhenomenon,\n} from './types.js';\n\n/**\n * Epistemic confidence vocabulary for `Cell` variants. Matches the\n * `'established' | 'speculative' | 'highly-speculative'` portion of\n * `BridgeEquationStatus` from `src/bridges/index.ts:42-46`, minus\n * `'invalid'` — cells in the tensor are by definition active; invalid\n * catalog entries should not be added.\n *\n * @public\n */\nexport type CellConfidence =\n  | 'established'\n  | 'speculative'\n  | 'highly-speculative';\n\n/**\n * Fields common to every `Cell` variant. Each variant extends this\n * with a `kind` discriminator and variant-specific fields. The\n * `equation` field carries LaTeX-formatted mathematical content\n * (matching the existing `PhysicalLaw.equation` / `BridgeEquation.\n * equation` convention).\n *\n * @public\n */\nexport interface CellBase {\n  /** Unique identifier within the parent `UniversalTensor`. */\n  readonly id: string;\n\n  /** Epistemic confidence vocabulary (see `CellConfidence`). */\n  readonly confidence: CellConfidence;\n\n  /** Mathematical formulation (LaTeX). */\n  readonly equation: string;\n}\n\n/**\n * Cell variant representing a known physical law. 1:1 field-shape\n * correspondence with `PhysicalLaw` from `src/core/types.ts:88`,\n * except `confidence` is the string vocabulary (not `number`) and\n * the discriminator `kind: 'law'` is added.\n *\n * @public\n */\nexport interface LawCell extends CellBase {\n  readonly kind: 'law';\n  readonly name: string;\n  readonly scales: ReadonlyArray<PhysicalScale>;\n  readonly forces: ReadonlyArray<Force>;\n  readonly symmetries: ReadonlyArray<Symmetry>;\n  readonly informationMeasures?: ReadonlyArray<InformationMeasure>;\n  readonly dimensions?: ReadonlyArray<number>;\n  readonly topologies?: ReadonlyArray<number>;\n  readonly references?: ReadonlyArray<string>;\n}\n\n/**\n * Cell variant representing a bridge equation between regimes. 1:1\n * field-shape correspondence with `BridgeEquation` from\n * `src/core/types.ts:126`, except `confidence` is the string\n * vocabulary and the discriminator `kind: 'bridge'` is added.\n *\n * @public\n */\nexport interface BridgeCell extends CellBase {\n  readonly kind: 'bridge';\n  readonly name: string;\n  readonly source: TensorIndices;\n  readonly target: TensorIndices;\n  readonly validated: boolean;\n  readonly description: string;\n}\n\n/**\n * Cell variant representing an emergent phenomenon. 1:1 field-shape\n * correspondence with `EmergentPhenomenon` from `src/core/types.ts:155`,\n * except `confidence` is the string vocabulary and the discriminator\n * `kind: 'emergence'` is added. Note: the old interface uses\n * `description` for the mathematical content; `EmergenceCell` carries\n * it as both `equation` (inherited from `CellBase`, mandatory) and\n * `description` (kept for prose-context fidelity, optional).\n *\n * @public\n */\nexport interface EmergenceCell extends CellBase {\n  readonly kind: 'emergence';\n  readonly name: string;\n  readonly order: number;\n  readonly indices: ReadonlyArray<TensorIndices>;\n  readonly description?: string;\n}\n\n/**\n * The disjoint union of all `Cell` variants. Consumers narrow via\n * `switch (cell.kind)` with an exhaustive `_exhaustive: never` arm.\n *\n * @public\n */\nexport type Cell = LawCell | BridgeCell | EmergenceCell;\n\n// ---------------------------------------------------------------------------\n// Inverse adapters (legacy interface → Cell variant)\n// ---------------------------------------------------------------------------\n// Used by UniversalTensor.populatedCells() (Phase 2 Task 2.1) to resolve\n// stored cell-IDs back to Cell objects. Counterparts to the forward\n// adapters (cellToLaw / cellToBridge / cellToEmergence) at tensor.ts.\n//\n// The numeric `confidence: number` from the legacy interfaces is bucketed\n// back into the string vocabulary via `numberToCellConfidence`. This is\n// the lossy direction Eve-R3 flagged — but in THIS direction, the call\n// site is \"we have a legacy entry that was already in the tensor; bucket\n// its numeric confidence into the closest string label\". Per Decision #6\n// fan-out semantics, this can only happen for entries that round-tripped\n// through `addCell` (where the original string was authoritative) OR\n// entries added via the legacy `addLaw`/`addBridge`/`addEmergence` paths\n// (where the consumer chose a number directly). The bucketing matches\n// the forward `statusToConfidenceNumber` in tensor.ts: 0.95→established,\n// 0.6→speculative, 0.3→highly-speculative; thresholds chosen to make\n// the standard round-trip exact.\n\n/**\n * Inverse of `statusToConfidenceNumber` at tensor.ts:48-58. Buckets a\n * numeric confidence in [0,1] back to the string vocabulary. Used by\n * the inverse adapters below.\n *\n * @internal\n */\nfunction numberToCellConfidence(n: number): CellConfidence {\n  if (n >= 0.8) return 'established';\n  if (n >= 0.4) return 'speculative';\n  return 'highly-speculative';\n}\n\n/**\n * Adapter: `PhysicalLaw` (legacy) → `LawCell`. Used by\n * `UniversalTensor.populatedCells()`.\n *\n * @internal\n */\nexport function lawToCell(law: PhysicalLaw): LawCell {\n  return {\n    kind: 'law',\n    id: law.id,\n    name: law.name,\n    equation: law.equation,\n    confidence: numberToCellConfidence(law.confidence),\n    scales: law.scales,\n    forces: law.forces,\n    symmetries: law.symmetries,\n    ...(law.informationMeasures ? { informationMeasures: law.informationMeasures } : {}),\n    ...(law.dimensions ? { dimensions: law.dimensions } : {}),\n    ...(law.topologies ? { topologies: law.topologies } : {}),\n    ...(law.references ? { references: law.references } : {}),\n  };\n}\n\n/**\n * Adapter: `BridgeEquation` (legacy) → `BridgeCell`. Used by\n * `UniversalTensor.populatedCells()`.\n *\n * @internal\n */\nexport function bridgeToCell(b: BridgeEquation): BridgeCell {\n  return {\n    kind: 'bridge',\n    id: b.id,\n    name: b.name,\n    equation: b.equation,\n    confidence: numberToCellConfidence(b.confidence),\n    source: b.source,\n    target: b.target,\n    validated: b.validated,\n    description: b.description,\n  };\n}\n\n/**\n * Adapter: `EmergentPhenomenon` (legacy) → `EmergenceCell`. The\n * legacy `description` field holds the mathematical content (LaTeX);\n * we surface it as `equation` and leave `description` undefined\n * unless the legacy entry had a \"math\\n\\nprose\" split (per the\n * forward `cellToEmergence` adapter convention).\n *\n * @internal\n */\nexport function emergenceToCell(p: EmergentPhenomenon): EmergenceCell {\n  // Split convention: if description contains \"\\n\\n\", treat the part\n  // before as equation and after as prose; otherwise the whole field\n  // is the equation.\n  const splitIdx = p.description.indexOf('\\n\\n');\n  const equation = splitIdx === -1 ? p.description : p.description.slice(0, splitIdx);\n  const description = splitIdx === -1 ? undefined : p.description.slice(splitIdx + 2);\n\n  return {\n    kind: 'emergence',\n    id: p.id,\n    name: p.name,\n    equation,\n    confidence: numberToCellConfidence(p.confidence),\n    order: p.order,\n    indices: p.indices,\n    ...(description ? { description } : {}),\n  };\n}\n"]}

package/dist/core/compare.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Numeric and string comparisons the layers above share.
+ *
+ * Two quotients state how far a value is from a reference; three predicates
+ * decide agreement in the product form `|a − b| ≤ tol · scale`, which is the
+ * form the sites that migrated here used, so a verdict at a tolerance
+ * boundary does not move by an ulp. The codepoint order is the sort that
+ * `a < b ? -1 : a > b ? 1 : 0` spelled at ten sites; it is not
+ * `localeCompare`, and a sort that used `localeCompare` keeps it.
+ *
+ * @module core/compare
+ */
+/** `|value − ref| / max(|ref|, floor)`: the relative difference against a reference, with a floor for a reference near zero. @internal */
+export declare function relDiff(value: number, ref: number, floor?: number): number;
+/** `|a − b| / max(|a|, |b|, floor)`: the relative difference of two values neither of which is the reference. @internal */
+export declare function symmetricRelDiff(a: number, b: number, floor?: number): number;
+/** `|value − ref| ≤ tol · max(|ref|, floor)`: agreement relative to the reference. @internal */
+export declare function withinRel(value: number, ref: number, tol: number, floor?: number): boolean;
+/**
+ * `|value − ref| ≤ tol · max(1, |ref|)`: relative far from one, absolute near
+ * zero. The form a stored number written to a few significant digits is
+ * checked against the computed one with.
+ * @internal
+ */
+export declare function withinMixed(value: number, ref: number, tol: number): boolean;
+/** `|a − b| ≤ tol · max(|a|, |b|, floor)`: agreement of two values neither of which is the reference. @internal */
+export declare function withinSymmetric(a: number, b: number, tol: number, floor?: number): boolean;
+/** The UTF-16 code-unit order of two strings: −1, 0 or 1. Not `localeCompare`. @internal */
+export declare function compareCodepoint(a: string, b: string): number;
+/** A comparator over records, by a string key in codepoint order. @internal */
+export declare function byKey<T>(key: (item: T) => string): (a: T, b: T) => number;
+//# sourceMappingURL=compare.d.ts.map

package/dist/core/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/core/compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0IAA0I;AAC1I,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAErE;AAED,2HAA2H;AAC3H,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAExE;AAED,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,mHAAmH;AACnH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAErF;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAEzE"}

package/dist/core/compare.js

@@ -0,0 +1,46 @@
+/**
+ * Numeric and string comparisons the layers above share.
+ *
+ * Two quotients state how far a value is from a reference; three predicates
+ * decide agreement in the product form `|a − b| ≤ tol · scale`, which is the
+ * form the sites that migrated here used, so a verdict at a tolerance
+ * boundary does not move by an ulp. The codepoint order is the sort that
+ * `a < b ? -1 : a > b ? 1 : 0` spelled at ten sites; it is not
+ * `localeCompare`, and a sort that used `localeCompare` keeps it.
+ *
+ * @module core/compare
+ */
+/** `|value − ref| / max(|ref|, floor)`: the relative difference against a reference, with a floor for a reference near zero. @internal */
+export function relDiff(value, ref, floor = 0) {
+    return Math.abs(value - ref) / Math.max(Math.abs(ref), floor);
+}
+/** `|a − b| / max(|a|, |b|, floor)`: the relative difference of two values neither of which is the reference. @internal */
+export function symmetricRelDiff(a, b, floor = 0) {
+    return Math.abs(a - b) / Math.max(Math.abs(a), Math.abs(b), floor);
+}
+/** `|value − ref| ≤ tol · max(|ref|, floor)`: agreement relative to the reference. @internal */
+export function withinRel(value, ref, tol, floor = 0) {
+    return Math.abs(value - ref) <= tol * Math.max(Math.abs(ref), floor);
+}
+/**
+ * `|value − ref| ≤ tol · max(1, |ref|)`: relative far from one, absolute near
+ * zero. The form a stored number written to a few significant digits is
+ * checked against the computed one with.
+ * @internal
+ */
+export function withinMixed(value, ref, tol) {
+    return Math.abs(value - ref) <= tol * Math.max(1, Math.abs(ref));
+}
+/** `|a − b| ≤ tol · max(|a|, |b|, floor)`: agreement of two values neither of which is the reference. @internal */
+export function withinSymmetric(a, b, tol, floor = 1) {
+    return Math.abs(a - b) <= tol * Math.max(Math.abs(a), Math.abs(b), floor);
+}
+/** The UTF-16 code-unit order of two strings: −1, 0 or 1. Not `localeCompare`. @internal */
+export function compareCodepoint(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** A comparator over records, by a string key in codepoint order. @internal */
+export function byKey(key) {
+    return (a, b) => compareCodepoint(key(a), key(b));
+}
+//# sourceMappingURL=compare.js.map

package/dist/core/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/core/compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0IAA0I;AAC1I,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,GAAW,EAAE,KAAK,GAAG,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,2HAA2H;AAC3H,MAAM,UAAU,gBAAgB,CAAC,CAAS,EAAE,CAAS,EAAE,KAAK,GAAG,CAAC;IAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,KAAK,GAAG,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,GAAW,EAAE,KAAK,GAAG,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,CAAS,EAAE,CAAS;IACnD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,KAAK,CAAI,GAAwB;IAC/C,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Numeric and string comparisons the layers above share.\n *\n * Two quotients state how far a value is from a reference; three predicates\n * decide agreement in the product form `|a − b| ≤ tol · scale`, which is the\n * form the sites that migrated here used, so a verdict at a tolerance\n * boundary does not move by an ulp. The codepoint order is the sort that\n * `a < b ? -1 : a > b ? 1 : 0` spelled at ten sites; it is not\n * `localeCompare`, and a sort that used `localeCompare` keeps it.\n *\n * @module core/compare\n */\n\n/** `|value − ref| / max(|ref|, floor)`: the relative difference against a reference, with a floor for a reference near zero. @internal */\nexport function relDiff(value: number, ref: number, floor = 0): number {\n  return Math.abs(value - ref) / Math.max(Math.abs(ref), floor);\n}\n\n/** `|a − b| / max(|a|, |b|, floor)`: the relative difference of two values neither of which is the reference. @internal */\nexport function symmetricRelDiff(a: number, b: number, floor = 0): number {\n  return Math.abs(a - b) / Math.max(Math.abs(a), Math.abs(b), floor);\n}\n\n/** `|value − ref| ≤ tol · max(|ref|, floor)`: agreement relative to the reference. @internal */\nexport function withinRel(value: number, ref: number, tol: number, floor = 0): boolean {\n  return Math.abs(value - ref) <= tol * Math.max(Math.abs(ref), floor);\n}\n\n/**\n * `|value − ref| ≤ tol · max(1, |ref|)`: relative far from one, absolute near\n * zero. The form a stored number written to a few significant digits is\n * checked against the computed one with.\n * @internal\n */\nexport function withinMixed(value: number, ref: number, tol: number): boolean {\n  return Math.abs(value - ref) <= tol * Math.max(1, Math.abs(ref));\n}\n\n/** `|a − b| ≤ tol · max(|a|, |b|, floor)`: agreement of two values neither of which is the reference. @internal */\nexport function withinSymmetric(a: number, b: number, tol: number, floor = 1): boolean {\n  return Math.abs(a - b) <= tol * Math.max(Math.abs(a), Math.abs(b), floor);\n}\n\n/** The UTF-16 code-unit order of two strings: −1, 0 or 1. Not `localeCompare`. @internal */\nexport function compareCodepoint(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n\n/** A comparator over records, by a string key in codepoint order. @internal */\nexport function byKey<T>(key: (item: T) => string): (a: T, b: T) => number {\n  return (a, b) => compareCodepoint(key(a), key(b));\n}\n"]}

package/dist/core/constants.d.ts

@@ -1,17 +1,15 @@
 /**
- * Canonical CODATA 2018 + SI-defined physical constants for UPT (v0.5.1).
+ * Canonical CODATA 2022 + SI-defined physical constants for UPT.
  *
- * Single source of truth for fundamental physical constants used across the
- * numerical, dimensional, and bridge layers. Replaces the truncated local
- * literals (`c_SI = 2.998e8`, etc.) that drifted across `src/numerical/`,
- * `src/bridges/`, and `tests/fixtures/` — see audit `PC-1` in
- * `docs/architecture/archive/v0.5.1-audit.md`.
+ * The one owner of every fundamental physical constant used across the
+ * numerical, dimensional, and bridge layers; `tests/core/constants-owner.test.ts`
+ * fails on a second copy of any of these decimals elsewhere under `src/`.
  *
  * Values use:
  *   • Exact-SI definitions (`C_SI`, `H_SI`, `K_B_SI`, `E_SI`) where the
  *     2019 SI redefinition fixed their values exactly.
  *   • `HBAR_SI` is the exact quotient `H_SI / (2π)`, not the truncated CODATA display.
- *   • CODATA 2018 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).
+ *   • CODATA 2022 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).
  *   • Planck 2018 best estimate for `H0_SI`, in SI through the unit table's parsec.
  *
  * This file is the one owner of every value. `PhysicalConstants` in
@@ -27,37 +25,39 @@
  */
 /** Speed of light in vacuum (m/s). Exact SI definition since 1983. */
 export declare const C_SI = 299792458;
-/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2018. */
-export declare const G_SI = 6.6743e-11;
+/** Rydberg constant R∞ (infinite nuclear mass), CODATA 2022 (m⁻¹), read from MathTS. */
+export declare const R_INF_SI: number;
+/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2022. */
+export declare const G_SI: number;
 /** Planck constant (J·s). Exact SI definition since 2019. */
 export declare const H_SI = 6.62607015e-34;
 /**
  * Reduced Planck constant h/(2π) (J·s). Exact, from the 2019 SI definition of
  * h. The CODATA display `1.054571817e-34` is that quotient truncated; it is
- * smaller by a relative `6.127e-10`. Planck units below stay the published
- * CODATA 2018 values, which were computed from the truncated display.
+ * smaller by a relative `6.127e-10`. The Planck units below are
+ * MathTS's CODATA 2022 values, not recomputed here from {@link HBAR_SI}.
  */
 export declare const HBAR_SI: number;
-/** The CODATA 2018 display value of ħ: {@link HBAR_SI} truncated. Kept so the difference is computed, not typed. @internal */
+/** The CODATA display value of ħ: {@link HBAR_SI} truncated. Kept so the difference is computed, not typed. @internal */
 export declare const HBAR_CODATA_DISPLAY = 1.054571817e-34;
 /** Boltzmann constant (J/K). Exact SI definition since 2019. */
 export declare const K_B_SI = 1.380649e-23;
 /** Elementary charge (C). Exact SI definition since 2019. */
 export declare const E_SI = 1.602176634e-19;
-/** Fine-structure constant α (dimensionless). CODATA 2018. */
-export declare const ALPHA = 0.0072973525693;
-/** Vacuum permittivity ε₀ (F/m). CODATA 2018. @internal */
-export declare const EPS0_SI = 8.8541878128e-12;
+/** Fine-structure constant α (dimensionless). CODATA 2022. */
+export declare const ALPHA: number;
+/** Vacuum permittivity ε₀ (F/m). CODATA 2022. @internal */
+export declare const EPS0_SI: number;
 /** Vacuum permeability μ₀ = 1/(ε₀ c²) (H/m), from ε₀ and the exact c. @internal */
 export declare const MU0_SI: number;
-/** Stefan–Boltzmann constant σ (W m⁻² K⁻⁴). CODATA 2018. @internal */
-export declare const SIGMA_SB_SI = 5.670374419e-8;
-/** Planck mass √(ℏc/G) (kg). CODATA 2018. */
-export declare const M_P_SI = 2.176434e-8;
-/** Planck length √(ℏG/c³) (m). CODATA 2018. */
-export declare const L_P_SI = 1.616255e-35;
-/** Planck time √(ℏG/c⁵) (s). CODATA 2018. */
-export declare const T_P_SI = 5.391247e-44;
+/** Stefan–Boltzmann constant σ (W m⁻² K⁻⁴). CODATA 2022. @internal */
+export declare const SIGMA_SB_SI: number;
+/** Planck mass √(ℏc/G) (kg). CODATA 2022. */
+export declare const M_P_SI: number;
+/** Planck length √(ℏG/c³) (m). CODATA 2022. */
+export declare const L_P_SI: number;
+/** Planck time √(ℏG/c⁵) (s). CODATA 2022. */
+export declare const T_P_SI: number;
 /**
  * Hubble parameter H₀ (s⁻¹).
  *
@@ -83,12 +83,14 @@ export declare const VON_KLITZING_SI: number;
 export declare const JOSEPHSON_CONSTANT_SI: number;
 /** Lorenz number L = (π²/3) (k_B/e)² (W Ω K⁻²). */
 export declare const LORENZ_NUMBER_SI: number;
+/** Euler–Mascheroni constant γ. The BCS gap is π k_B T_c / e^γ; the formula name is `euler_gamma`. */
+export declare const EULER_GAMMA = 0.5772156649015329;
 /** Weak-coupling BCS gap ratio 2Δ(0)/(k_B T_c) = 2π e^{−γ}. */
 export declare const BCS_GAP_RATIO: number;
 /** Lane-Emden n=3 dimensionless radius used by the white-dwarf mass. */
 export declare const LANE_EMDEN_OMEGA3 = 2.01824;
 /** Thomson cross section (m²). */
-export declare const THOMSON_CROSS_SECTION_SI = 6.6524587321e-29;
+export declare const THOMSON_CROSS_SECTION_SI: number;
 /**
  * Nominal solar gravitational parameter (GM)☉ (m³ s⁻²), IAU 2015 Resolution B3.
  *
@@ -107,21 +109,19 @@ export declare const GM_SUN_SI = 132712440000000000000;
  * @internal
  */
 export declare const M_SUN_IAU_SI: number;
-/** Where {@link GM_SUN_SI} comes from. @internal */
-export declare const GM_SUN_SOURCE = "IAU 2015 Resolution B3, nominal solar mass parameter (GM)\u2609 = 1.3271244e20 m\u00B3 s\u207B\u00B2";
 /**
- * Electron mass (kg), CODATA 2018. Added for the v0.11 namespacing
+ * Electron mass (kg), CODATA 2022. Added for the v0.11 namespacing
  * gate's criterion-3 pin (λ_T of an electron at the Hawking
  * temperature — see the Adam vet A-5).
  * @public
  */
-export declare const M_E_SI = 9.1093837015e-31;
+export declare const M_E_SI: number;
 /**
- * Proton mass (kg). CODATA 2018. Shared by the Eddington evaluator and
+ * Proton mass (kg). CODATA 2022. Shared by the Eddington evaluator and
  * `upt eval` (`m_p`, `m_proton`). Not the Planck mass `M_P_SI`.
  * @internal
  */
-export declare const M_PROTON_SI = 1.67262192369e-27;
+export declare const M_PROTON_SI: number;
 /**
  * Avogadro constant (mol⁻¹). Exact in the 2019 SI.
  * @internal
@@ -133,16 +133,16 @@ export declare const N_A_SI = 6.02214076e+23;
  */
 export declare const FARADAY_SI: number;
 /**
- * Wien displacement-law constant b = λ_max·T (m·K). CODATA 2018.
+ * Wien displacement-law constant b = λ_max·T (m·K). CODATA 2022.
  *
  * @public
  */
-export declare const B_WIEN_SI = 0.002897771955;
+export declare const B_WIEN_SI: number;
 /**
- * Unified atomic mass unit (kg). CODATA 2018 atomic mass constant.
+ * Unified atomic mass unit (kg). CODATA 2022 atomic mass constant.
  * One value for the Chandrasekhar evaluator and the symbolic constant `m_u`.
  * Kept off the package barrel: callers use `m_u` in the symbolic registry.
  * @internal
  */
-export declare const M_U_SI = 1.6605390666e-27;
+export declare const M_U_SI: number;
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,sEAAsE;AACtE,eAAO,MAAM,IAAI,YAAY,CAAC;AAE9B,mEAAmE;AACnE,eAAO,MAAM,IAAI,aAAc,CAAC;AAEhC,6DAA6D;AAC7D,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,QAAuB,CAAC;AAE5C,8HAA8H;AAC9H,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,gEAAgE;AAChE,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC,6DAA6D;AAC7D,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,8DAA8D;AAC9D,eAAO,MAAM,KAAK,kBAAkB,CAAC;AAErC,2DAA2D;AAC3D,eAAO,MAAM,OAAO,mBAAmB,CAAC;AAExC,mFAAmF;AACnF,eAAO,MAAM,MAAM,QAA8B,CAAC;AAElD,sEAAsE;AACtE,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAE1C,6CAA6C;AAC7C,eAAO,MAAM,MAAM,cAAc,CAAC;AAElC,+CAA+C;AAC/C,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC,6CAA6C;AAC7C,eAAO,MAAM,MAAM,eAAe,CAAC;AAWnC;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,QAA0C,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,YAAW,CAAC;AAEjC,mEAAmE;AACnE,eAAO,MAAM,QAAQ,YAAW,CAAC;AAEjC,8CAA8C;AAC9C,eAAO,MAAM,eAAe,QAAuB,CAAC;AAEpD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,QAA4C,CAAC;AAK1E,+DAA+D;AAC/D,eAAO,MAAM,aAAa,QAAwC,CAAC;AAEnE,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,wBAAe,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAmB,CAAC;AAE7C,oDAAoD;AACpD,eAAO,MAAM,aAAa,yGAAqF,CAAC;AAEhH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,mBAAmB,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,MAAM,iBAAgB,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAgB,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,mBAAoB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoBH,sEAAsE;AACtE,eAAO,MAAM,IAAI,YAAY,CAAC;AAC9B,wFAAwF;AACxF,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAE1C,mEAAmE;AACnE,eAAO,MAAM,IAAI,QAAgC,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,QAAuB,CAAC;AAE5C,yHAAyH;AACzH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,gEAAgE;AAChE,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC,6DAA6D;AAC7D,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,8DAA8D;AAC9D,eAAO,MAAM,KAAK,QAA0B,CAAC;AAE7C,2DAA2D;AAC3D,eAAO,MAAM,OAAO,QAA6B,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,MAAM,QAA8B,CAAC;AAElD,sEAAsE;AACtE,eAAO,MAAM,WAAW,QAA4B,CAAC;AAErD,6CAA6C;AAC7C,eAAO,MAAM,MAAM,QAAuB,CAAC;AAE3C,+CAA+C;AAC/C,eAAO,MAAM,MAAM,QAAyB,CAAC;AAE7C,6CAA6C;AAC7C,eAAO,MAAM,MAAM,QAAuB,CAAC;AAW3C;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,QAA0C,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,YAAW,CAAC;AAEjC,mEAAmE;AACnE,eAAO,MAAM,QAAQ,YAAW,CAAC;AAEjC,8CAA8C;AAC9C,eAAO,MAAM,eAAe,QAAuB,CAAC;AAEpD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,QAA4C,CAAC;AAE1E,sGAAsG;AACtG,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,aAAa,QAAwC,CAAC;AAEnE,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,QAAgC,CAAC;AAEtE;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,wBAAe,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAmB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,MAAM,QAAyB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,MAAM,iBAAgB,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAgB,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAA6B,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/core/constants.js

@@ -1,17 +1,15 @@
 /**
- * Canonical CODATA 2018 + SI-defined physical constants for UPT (v0.5.1).
+ * Canonical CODATA 2022 + SI-defined physical constants for UPT.
  *
- * Single source of truth for fundamental physical constants used across the
- * numerical, dimensional, and bridge layers. Replaces the truncated local
- * literals (`c_SI = 2.998e8`, etc.) that drifted across `src/numerical/`,
- * `src/bridges/`, and `tests/fixtures/` — see audit `PC-1` in
- * `docs/architecture/archive/v0.5.1-audit.md`.
+ * The one owner of every fundamental physical constant used across the
+ * numerical, dimensional, and bridge layers; `tests/core/constants-owner.test.ts`
+ * fails on a second copy of any of these decimals elsewhere under `src/`.
  *
  * Values use:
  *   • Exact-SI definitions (`C_SI`, `H_SI`, `K_B_SI`, `E_SI`) where the
  *     2019 SI redefinition fixed their values exactly.
  *   • `HBAR_SI` is the exact quotient `H_SI / (2π)`, not the truncated CODATA display.
- *   • CODATA 2018 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).
+ *   • CODATA 2022 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).
  *   • Planck 2018 best estimate for `H0_SI`, in SI through the unit table's parsec.
  *
  * This file is the one owner of every value. `PhysicalConstants` in
@@ -25,40 +23,59 @@
  * @module core/constants
  * @public
  */
+import * as mathtsConstants from '@danielsimonjr/mathts-functions';
 import { checkedDataFile } from './data-file.js';
+/**
+ * A measured constant's SI value, read from MathTS (CODATA 2022). MathTS is the
+ * one source of measured constants; UPT keeps no copy of their decimals. A
+ * constant MathTS lacks is a MathTS issue, not a local value.
+ */
+function codata(name) {
+    const value = mathtsConstants[name];
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'object' && value !== null && typeof value.toNumeric === 'function') {
+        const n = value.toNumeric();
+        if (typeof n === 'number' && Number.isFinite(n))
+            return n;
+    }
+    throw new Error(`MathTS has no numeric constant ${name}`);
+}
 /** Speed of light in vacuum (m/s). Exact SI definition since 1983. */
 export const C_SI = 299792458;
-/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2018. */
-export const G_SI = 6.67430e-11;
+/** Rydberg constant R∞ (infinite nuclear mass), CODATA 2022 (m⁻¹), read from MathTS. */
+export const R_INF_SI = codata('rydberg');
+/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2022. */
+export const G_SI = codata('gravitationConstant');
 /** Planck constant (J·s). Exact SI definition since 2019. */
 export const H_SI = 6.62607015e-34;
 /**
  * Reduced Planck constant h/(2π) (J·s). Exact, from the 2019 SI definition of
  * h. The CODATA display `1.054571817e-34` is that quotient truncated; it is
- * smaller by a relative `6.127e-10`. Planck units below stay the published
- * CODATA 2018 values, which were computed from the truncated display.
+ * smaller by a relative `6.127e-10`. The Planck units below are
+ * MathTS's CODATA 2022 values, not recomputed here from {@link HBAR_SI}.
  */
 export const HBAR_SI = H_SI / (2 * Math.PI);
-/** The CODATA 2018 display value of ħ: {@link HBAR_SI} truncated. Kept so the difference is computed, not typed. @internal */
+/** The CODATA display value of ħ: {@link HBAR_SI} truncated. Kept so the difference is computed, not typed. @internal */
 export const HBAR_CODATA_DISPLAY = 1.054571817e-34;
 /** Boltzmann constant (J/K). Exact SI definition since 2019. */
 export const K_B_SI = 1.380649e-23;
 /** Elementary charge (C). Exact SI definition since 2019. */
 export const E_SI = 1.602176634e-19;
-/** Fine-structure constant α (dimensionless). CODATA 2018. */
-export const ALPHA = 7.2973525693e-3;
-/** Vacuum permittivity ε₀ (F/m). CODATA 2018. @internal */
-export const EPS0_SI = 8.8541878128e-12;
+/** Fine-structure constant α (dimensionless). CODATA 2022. */
+export const ALPHA = codata('fineStructure');
+/** Vacuum permittivity ε₀ (F/m). CODATA 2022. @internal */
+export const EPS0_SI = codata('electricConstant');
 /** Vacuum permeability μ₀ = 1/(ε₀ c²) (H/m), from ε₀ and the exact c. @internal */
 export const MU0_SI = 1 / (EPS0_SI * C_SI * C_SI);
-/** Stefan–Boltzmann constant σ (W m⁻² K⁻⁴). CODATA 2018. @internal */
-export const SIGMA_SB_SI = 5.670374419e-8;
-/** Planck mass √(ℏc/G) (kg). CODATA 2018. */
-export const M_P_SI = 2.176434e-8;
-/** Planck length √(ℏG/c³) (m). CODATA 2018. */
-export const L_P_SI = 1.616255e-35;
-/** Planck time √(ℏG/c⁵) (s). CODATA 2018. */
-export const T_P_SI = 5.391247e-44;
+/** Stefan–Boltzmann constant σ (W m⁻² K⁻⁴). CODATA 2022. @internal */
+export const SIGMA_SB_SI = codata('stefanBoltzmann');
+/** Planck mass √(ℏc/G) (kg). CODATA 2022. */
+export const M_P_SI = codata('planckMass');
+/** Planck length √(ℏG/c³) (m). CODATA 2022. */
+export const L_P_SI = codata('planckLength');
+/** Planck time √(ℏG/c⁵) (s). CODATA 2022. */
+export const T_P_SI = codata('planckTime');
 /** The `scale` of the `symbol` row in `data/units.json`, which must be a plain decimal (metres for a length). */
 function unitTableDecimal(symbol) {
     const file = checkedDataFile('units.json');
@@ -93,14 +110,14 @@ export const VON_KLITZING_SI = H_SI / (E_SI * E_SI);
 export const JOSEPHSON_CONSTANT_SI = (2 * E_SI) / H_SI;
 /** Lorenz number L = (π²/3) (k_B/e)² (W Ω K⁻²). */
 export const LORENZ_NUMBER_SI = (Math.PI ** 2 / 3) * (K_B_SI / E_SI) ** 2;
-/** Euler-Mascheroni constant γ. */
-const EULER_GAMMA = 0.5772156649015329;
+/** Euler–Mascheroni constant γ. The BCS gap is π k_B T_c / e^γ; the formula name is `euler_gamma`. */
+export const EULER_GAMMA = 0.5772156649015329;
 /** Weak-coupling BCS gap ratio 2Δ(0)/(k_B T_c) = 2π e^{−γ}. */
 export const BCS_GAP_RATIO = (2 * Math.PI) / Math.exp(EULER_GAMMA);
 /** Lane-Emden n=3 dimensionless radius used by the white-dwarf mass. */
 export const LANE_EMDEN_OMEGA3 = 2.01824;
 /** Thomson cross section (m²). */
-export const THOMSON_CROSS_SECTION_SI = 6.6524587321e-29;
+export const THOMSON_CROSS_SECTION_SI = codata('thomsonCrossSection');
 /**
  * Nominal solar gravitational parameter (GM)☉ (m³ s⁻²), IAU 2015 Resolution B3.
  *
@@ -119,21 +136,19 @@ export const GM_SUN_SI = 1.3271244e20;
  * @internal
  */
 export const M_SUN_IAU_SI = GM_SUN_SI / G_SI;
-/** Where {@link GM_SUN_SI} comes from. @internal */
-export const GM_SUN_SOURCE = 'IAU 2015 Resolution B3, nominal solar mass parameter (GM)☉ = 1.3271244e20 m³ s⁻²';
 /**
- * Electron mass (kg), CODATA 2018. Added for the v0.11 namespacing
+ * Electron mass (kg), CODATA 2022. Added for the v0.11 namespacing
  * gate's criterion-3 pin (λ_T of an electron at the Hawking
  * temperature — see the Adam vet A-5).
  * @public
  */
-export const M_E_SI = 9.1093837015e-31;
+export const M_E_SI = codata('electronMass');
 /**
- * Proton mass (kg). CODATA 2018. Shared by the Eddington evaluator and
+ * Proton mass (kg). CODATA 2022. Shared by the Eddington evaluator and
  * `upt eval` (`m_p`, `m_proton`). Not the Planck mass `M_P_SI`.
  * @internal
  */
-export const M_PROTON_SI = 1.67262192369e-27;
+export const M_PROTON_SI = codata('protonMass');
 /**
  * Avogadro constant (mol⁻¹). Exact in the 2019 SI.
  * @internal
@@ -145,16 +160,16 @@ export const N_A_SI = 6.02214076e23;
  */
 export const FARADAY_SI = N_A_SI * E_SI;
 /**
- * Wien displacement-law constant b = λ_max·T (m·K). CODATA 2018.
+ * Wien displacement-law constant b = λ_max·T (m·K). CODATA 2022.
  *
  * @public
  */
-export const B_WIEN_SI = 2.897771955e-3;
+export const B_WIEN_SI = codata('wienDisplacement');
 /**
- * Unified atomic mass unit (kg). CODATA 2018 atomic mass constant.
+ * Unified atomic mass unit (kg). CODATA 2022 atomic mass constant.
  * One value for the Chandrasekhar evaluator and the symbolic constant `m_u`.
  * Kept off the package barrel: callers use `m_u` in the symbolic registry.
  * @internal
  */
-export const M_U_SI = 1.66053906660e-27;
+export const M_U_SI = codata('atomicMass');
 //# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Canonical CODATA 2022 + SI-defined physical constants for UPT.\n *\n * The one owner of every fundamental physical constant used across the\n * numerical, dimensional, and bridge layers; `tests/core/constants-owner.test.ts`\n * fails on a second copy of any of these decimals elsewhere under `src/`.\n *\n * Values use:\n *   • Exact-SI definitions (`C_SI`, `H_SI`, `K_B_SI`, `E_SI`) where the\n *     2019 SI redefinition fixed their values exactly.\n *   • `HBAR_SI` is the exact quotient `H_SI / (2π)`, not the truncated CODATA display.\n *   • CODATA 2022 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).\n *   • Planck 2018 best estimate for `H0_SI`, in SI through the unit table's parsec.\n *\n * This file is the one owner of every value. `PhysicalConstants` in\n * `src/core/types.ts` and the constant registry in\n * `src/dimensional/symbolic-constants.ts` are projections of it, and a test\n * refuses a CODATA literal anywhere else under `src/`. A unit is the unit\n * table's: `H0_SI` reads the parsec from `data/units.json` rather than\n * restating it, so the Hubble rate here and `67.4 km/s/Mpc` read through the\n * unit table are one number.\n *\n * @module core/constants\n * @public\n */\n\nimport * as mathtsConstants from '@danielsimonjr/mathts-functions';\nimport { checkedDataFile } from './data-file.js';\n\n/**\n * A measured constant's SI value, read from MathTS (CODATA 2022). MathTS is the\n * one source of measured constants; UPT keeps no copy of their decimals. A\n * constant MathTS lacks is a MathTS issue, not a local value.\n */\nfunction codata(name: string): number {\n  const value: unknown = (mathtsConstants as Record<string, unknown>)[name];\n  if (typeof value === 'number') return value;\n  if (typeof value === 'object' && value !== null && typeof (value as { toNumeric?: unknown }).toNumeric === 'function') {\n    const n = (value as { toNumeric: () => unknown }).toNumeric();\n    if (typeof n === 'number' && Number.isFinite(n)) return n;\n  }\n  throw new Error(`MathTS has no numeric constant ${name}`);\n}\n\n/** Speed of light in vacuum (m/s). Exact SI definition since 1983. */\nexport const C_SI = 299792458;\n/** Rydberg constant R∞ (infinite nuclear mass), CODATA 2022 (m⁻¹), read from MathTS. */\nexport const R_INF_SI = codata('rydberg');\n\n/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2022. */\nexport const G_SI = codata('gravitationConstant');\n\n/** Planck constant (J·s). Exact SI definition since 2019. */\nexport const H_SI = 6.62607015e-34;\n\n/**\n * Reduced Planck constant h/(2π) (J·s). Exact, from the 2019 SI definition of\n * h. The CODATA display `1.054571817e-34` is that quotient truncated; it is\n * smaller by a relative `6.127e-10`. The Planck units below are\n * MathTS's CODATA 2022 values, not recomputed here from {@link HBAR_SI}.\n */\nexport const HBAR_SI = H_SI / (2 * Math.PI);\n\n/** The CODATA display value of ħ: {@link HBAR_SI} truncated. Kept so the difference is computed, not typed. @internal */\nexport const HBAR_CODATA_DISPLAY = 1.054571817e-34;\n\n/** Boltzmann constant (J/K). Exact SI definition since 2019. */\nexport const K_B_SI = 1.380649e-23;\n\n/** Elementary charge (C). Exact SI definition since 2019. */\nexport const E_SI = 1.602176634e-19;\n\n/** Fine-structure constant α (dimensionless). CODATA 2022. */\nexport const ALPHA = codata('fineStructure');\n\n/** Vacuum permittivity ε₀ (F/m). CODATA 2022. @internal */\nexport const EPS0_SI = codata('electricConstant');\n\n/** Vacuum permeability μ₀ = 1/(ε₀ c²) (H/m), from ε₀ and the exact c. @internal */\nexport const MU0_SI = 1 / (EPS0_SI * C_SI * C_SI);\n\n/** Stefan–Boltzmann constant σ (W m⁻² K⁻⁴). CODATA 2022. @internal */\nexport const SIGMA_SB_SI = codata('stefanBoltzmann');\n\n/** Planck mass √(ℏc/G) (kg). CODATA 2022. */\nexport const M_P_SI = codata('planckMass');\n\n/** Planck length √(ℏG/c³) (m). CODATA 2022. */\nexport const L_P_SI = codata('planckLength');\n\n/** Planck time √(ℏG/c⁵) (s). CODATA 2022. */\nexport const T_P_SI = codata('planckTime');\n\n/** The `scale` of the `symbol` row in `data/units.json`, which must be a plain decimal (metres for a length). */\nfunction unitTableDecimal(symbol: string): number {\n  const file = checkedDataFile('units.json') as { readonly units: readonly { readonly symbols: readonly string[]; readonly scale: string }[] };\n  const scale = file.units.find((row) => row.symbols.includes(symbol))?.scale;\n  const value = scale === undefined ? Number.NaN : Number(scale);\n  if (!Number.isFinite(value)) throw new Error(`data/units.json: the '${symbol}' row must state a decimal scale (got ${scale ?? 'no row'})`);\n  return value;\n}\n\n/**\n * Hubble parameter H₀ (s⁻¹).\n *\n * Planck 2018 TT,TE,EE+lowE+lensing best estimate: 67.4 km/s/Mpc, converted\n * with the parsec of the unit table (`data/units.json`, 648000/π au), so it is\n * the value `convertValue('67.4km/s/Mpc', 'Hz')` reads: one Hubble rate,\n * 2.1842852410855023e-18 s⁻¹. The unit table is the one place the parsec is\n * written; this module reads it rather than restating it.\n */\nexport const H0_SI = 67.4e3 / (1e6 * unitTableDecimal('pc'));\n\n/**\n * Solar mass (kg). IAU 2015 nominal value rounded to the\n * repo-conventional literal (used by the BE-42 docstring, the\n * bridge-gradient tests, and the v0.8.0 calibration edges).\n * @public\n */\nexport const M_SUN_SI = 1.989e30;\n\n/** Solar mass in kilograms. The same value as {@link M_SUN_SI}. */\nexport const M_SUN_KG = M_SUN_SI;\n\n/** von Klitzing constant R_K = h/e² (ohm). */\nexport const VON_KLITZING_SI = H_SI / (E_SI * E_SI);\n\n/** Josephson constant K_J = 2e/h (Hz/V). */\nexport const JOSEPHSON_CONSTANT_SI = (2 * E_SI) / H_SI;\n\n/** Lorenz number L = (π²/3) (k_B/e)² (W Ω K⁻²). */\nexport const LORENZ_NUMBER_SI = (Math.PI ** 2 / 3) * (K_B_SI / E_SI) ** 2;\n\n/** Euler–Mascheroni constant γ. The BCS gap is π k_B T_c / e^γ; the formula name is `euler_gamma`. */\nexport const EULER_GAMMA = 0.5772156649015329;\n\n/** Weak-coupling BCS gap ratio 2Δ(0)/(k_B T_c) = 2π e^{−γ}. */\nexport const BCS_GAP_RATIO = (2 * Math.PI) / Math.exp(EULER_GAMMA);\n\n/** Lane-Emden n=3 dimensionless radius used by the white-dwarf mass. */\nexport const LANE_EMDEN_OMEGA3 = 2.01824;\n\n/** Thomson cross section (m²). */\nexport const THOMSON_CROSS_SECTION_SI = codata('thomsonCrossSection');\n\n/**\n * Nominal solar gravitational parameter (GM)☉ (m³ s⁻²), IAU 2015 Resolution B3.\n *\n * The product GM☉ is known to about 10 significant digits, while G alone is\n * known to about 5, so a confrontation that needs GM☉ takes this value rather\n * than `G_SI × M_SUN_SI`: that product is 3.0e-4 too high, five times the VLBI\n * 1σ on the solar-limb deflection. A mass that some evaluator requires in kg\n * is `GM_SUN_SI / G_SI`, which reproduces G·M = GM☉ exactly.\n * @public\n */\nexport const GM_SUN_SI = 1.3271244e20;\n\n/**\n * The solar mass (kg) that reproduces {@link GM_SUN_SI} with {@link G_SI}:\n * the double `GM_SUN_SI / G_SI`. The unit `Msun_iau` and the registry name\n * `Msun_iau` both read this one value.\n * @internal\n */\nexport const M_SUN_IAU_SI = GM_SUN_SI / G_SI;\n\n/**\n * Electron mass (kg), CODATA 2022. Added for the v0.11 namespacing\n * gate's criterion-3 pin (λ_T of an electron at the Hawking\n * temperature — see the Adam vet A-5).\n * @public\n */\nexport const M_E_SI = codata('electronMass');\n\n/**\n * Proton mass (kg). CODATA 2022. Shared by the Eddington evaluator and\n * `upt eval` (`m_p`, `m_proton`). Not the Planck mass `M_P_SI`.\n * @internal\n */\nexport const M_PROTON_SI = codata('protonMass');\n\n/**\n * Avogadro constant (mol⁻¹). Exact in the 2019 SI.\n * @internal\n */\nexport const N_A_SI = 6.02214076e23;\n\n/**\n * Faraday constant (C·mol⁻¹), `N_A * e`.\n * @internal\n */\nexport const FARADAY_SI = N_A_SI * E_SI;\n\n/**\n * Wien displacement-law constant b = λ_max·T (m·K). CODATA 2022.\n *\n * @public\n */\nexport const B_WIEN_SI = codata('wienDisplacement');\n\n/**\n * Unified atomic mass unit (kg). CODATA 2022 atomic mass constant.\n * One value for the Chandrasekhar evaluator and the symbolic constant `m_u`.\n * Kept off the package barrel: callers use `m_u` in the symbolic registry.\n * @internal\n */\nexport const M_U_SI = codata('atomicMass');\n"]}

package/dist/core/data-file.d.ts

@@ -10,6 +10,13 @@
  * @module core/data-file
  */
 import { type JsonSchema } from './json-schema.js';
+/**
+ * The JSON value in the file at `path`. A file that is not JSON throws a
+ * `SyntaxError` whose message starts with `path`, so a bad file is found by
+ * its name; a file that cannot be read throws the file-system error as is.
+ * @internal
+ */
+export declare function readJsonFile(path: string): unknown;
 /** The schema file of `file`: `units.json` → `units.schema.json`. @internal */
 export declare function schemaFileOf(file: string): string;
 /** The text of `data/<file>`. @internal */

package/dist/core/data-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-file.d.ts","sourceRoot":"","sources":["../../src/core/data-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInE,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAKrF;AAID,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD"}
+{"version":3,"file":"data-file.d.ts","sourceRoot":"","sources":["../../src/core/data-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQlD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAKrF;AAID,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD"}

package/dist/core/data-file.js

@@ -14,6 +14,23 @@ import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { schemaProblems } from './json-schema.js';
 const DATA_DIR = join(dirname(fileURLToPath(import.meta.url)), '../../data');
+/**
+ * The JSON value in the file at `path`. A file that is not JSON throws a
+ * `SyntaxError` whose message starts with `path`, so a bad file is found by
+ * its name; a file that cannot be read throws the file-system error as is.
+ * @internal
+ */
+export function readJsonFile(path) {
+    const text = readFileSync(path, 'utf8');
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw new SyntaxError(`${path}: ${error.message}`, { cause: error });
+        throw error;
+    }
+}
 /** The schema file of `file`: `units.json` → `units.schema.json`. @internal */
 export function schemaFileOf(file) {
     return file.replace(/\.json$/, '.schema.json');

package/dist/core/data-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-file.js","sourceRoot":"","sources":["../../src/core/data-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAE7E,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACjD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAe,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,MAAkB;IAC1E,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,wBAAwB,YAAY,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5H,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE3C,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"data-file.js","sourceRoot":"","sources":["../../src/core/data-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACjD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAe,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,MAAkB;IAC1E,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,wBAAwB,YAAY,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5H,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE3C,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["/**\n * The packaged data files under `data/`, read and checked against their schemas.\n *\n * Every data file the library loads has a schema beside it, named by one\n * convention (`units.json` → `units.schema.json`), and is checked against it\n * with {@link schemaProblems} when it loads, so a malformed file fails at load\n * with every problem listed instead of failing later where a field is read.\n * A file two modules read is parsed and checked once per process.\n *\n * @module core/data-file\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { schemaProblems, type JsonSchema } from './json-schema.js';\n\nconst DATA_DIR = join(dirname(fileURLToPath(import.meta.url)), '../../data');\n\n/**\n * The JSON value in the file at `path`. A file that is not JSON throws a\n * `SyntaxError` whose message starts with `path`, so a bad file is found by\n * its name; a file that cannot be read throws the file-system error as is.\n * @internal\n */\nexport function readJsonFile(path: string): unknown {\n  const text = readFileSync(path, 'utf8');\n  try {\n    return JSON.parse(text) as unknown;\n  } catch (error) {\n    if (error instanceof SyntaxError) throw new SyntaxError(`${path}: ${error.message}`, { cause: error });\n    throw error;\n  }\n}\n\n/** The schema file of `file`: `units.json` → `units.schema.json`. @internal */\nexport function schemaFileOf(file: string): string {\n  return file.replace(/\\.json$/, '.schema.json');\n}\n\n/** The text of `data/<file>`. @internal */\nexport function dataText(file: string): string {\n  return readFileSync(join(DATA_DIR, file), 'utf8');\n}\n\n/** The schema of `data/<file>`, parsed. @internal */\nexport function dataSchema(file: string): JsonSchema {\n  return JSON.parse(dataText(schemaFileOf(file))) as JsonSchema;\n}\n\n/**\n * `text`, the contents of `data/<file>`, parsed and checked against `schema`.\n * Throws listing every problem. A test passes a broken copy.\n * @internal\n */\nexport function parseDataFile(file: string, text: string, schema: JsonSchema): unknown {\n  const value: unknown = JSON.parse(text);\n  const problems = schemaProblems(schema, value);\n  if (problems.length > 0) throw new Error(`data/${file} does not match data/${schemaFileOf(file)}:\\n${problems.join('\\n')}`);\n  return value;\n}\n\nconst checked = new Map<string, unknown>();\n\n/** `data/<file>`, parsed and checked against its schema, once per process. @internal */\nexport function checkedDataFile(file: string): unknown {\n  if (!checked.has(file)) checked.set(file, parseDataFile(file, dataText(file), dataSchema(file)));\n  return checked.get(file);\n}\n"]}

package/dist/core/flux-rules.js

@@ -175,7 +175,7 @@ function checkEmergenceCoordinate(cell) {
     return { ok: true };
 }
 // ---------------------------------------------------------------------------
-// Rule 3 — Causality (WARNING tier in v0.7)
+// Rule 3 — Causality (ERROR tier)
 // ---------------------------------------------------------------------------
 /**
  * Pure dispatcher for Rule 3 over the `Cell` discriminated union.