universal-physics-tensor 10.0.0 → 12.0.0

package/dist/core/constants.js

@@ -1,5 +1,5 @@
 /**
- * Canonical CODATA 2018 + SI-defined physical constants for UPT.
+ * Canonical CODATA 2022 + SI-defined physical constants for UPT.
  *
  * The one owner of every fundamental physical constant used across the
  * numerical, dimensional, and bridge layers; `tests/core/constants-owner.test.ts`
@@ -9,75 +9,95 @@
  *   • 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).
- *   • Planck 2018 best estimate for `H0_SI`, in SI through the unit table's parsec.
+ *   • CODATA 2022 best estimates for measured constants (`G_SI`, `ALPHA`, Planck units).
+ *   • Planck 2018 best estimate for `H0_SI`, in SI through MathTS
+ *     `Unit.exactScale('km/s/Mpc')` — the same exact-scale path the unit
+ *     reader delegates to. This module cannot import `convertValue`
+ *     (`dimensional/` is tier 1; `core/` is tier 0).
  *
  * This file is the one owner of every value. `PhysicalConstants` in
  * `src/core/types.ts` and the constant registry in
  * `src/dimensional/symbolic-constants.ts` are projections of it, and a test
- * refuses a CODATA literal anywhere else under `src/`. A unit is the unit
- * table's: `H0_SI` reads the parsec from `data/units.json` rather than
- * restating it, so the Hubble rate here and `67.4 km/s/Mpc` read through the
- * unit table are one number.
+ * refuses a CODATA literal anywhere else under `src/`.
  *
  * @module core/constants
  * @public
  */
-import { checkedDataFile } from './data-file.js';
+import { Unit, exactScaleToNumber } from '@danielsimonjr/mathts-core';
+import * as mathtsConstants from '@danielsimonjr/mathts-functions';
+/**
+ * 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;
-/** Rydberg constant R∞ (infinite nuclear mass), CODATA 2018: 10 973 731.568 160(21) m⁻¹. */
-export const R_INF_SI = 10973731.56816;
-/** 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;
-/** 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');
-    const scale = file.units.find((row) => row.symbols.includes(symbol))?.scale;
-    const value = scale === undefined ? Number.NaN : Number(scale);
-    if (!Number.isFinite(value))
-        throw new Error(`data/units.json: the '${symbol}' row must state a decimal scale (got ${scale ?? 'no row'})`);
-    return value;
+/** 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');
+/**
+ * MathTS exact scale of a valueless unit text, rounded once. This is the
+ * same pair of calls the delegated unit reader uses (`Unit.exactScale` then
+ * `exactScaleToNumber`).
+ */
+function exactScaleNumber(text) {
+    const exact = Unit.exactScale(text);
+    if (exact === null)
+        throw new Error(`MathTS has no exact scale for '${text}'`);
+    return exactScaleToNumber(exact);
 }
 /**
  * Hubble parameter H₀ (s⁻¹).
  *
- * Planck 2018 TT,TE,EE+lowE+lensing best estimate: 67.4 km/s/Mpc, converted
- * with the parsec of the unit table (`data/units.json`, 648000/π au), so it is
- * the value `convertValue('67.4km/s/Mpc', 'Hz')` reads: one Hubble rate,
- * 2.1842852410855023e-18 s⁻¹. The unit table is the one place the parsec is
- * written; this module reads it rather than restating it.
+ * Planck 2018 TT,TE,EE+lowE+lensing best estimate: 67.4 km/s/Mpc. The
+ * conversion to Hz is `Unit.exactScale('km/s/Mpc')` rounded once — the same
+ * exact-scale path `convertValue('67.4km/s/Mpc', 'Hz')` delegates to. Calling
+ * `convertValue` from this file is a layer-order violation (`core/` cannot
+ * import `dimensional/units.ts`).
+ * @public
  */
-export const H0_SI = 67.4e3 / (1e6 * unitTableDecimal('pc'));
+export const H0_SI = 67.4 * exactScaleNumber('km/s/Mpc');
 /**
  * Solar mass (kg). IAU 2015 nominal value rounded to the
  * repo-conventional literal (used by the BE-42 docstring, the
@@ -100,7 +120,7 @@ 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.
  *
@@ -120,18 +140,18 @@ export const GM_SUN_SI = 1.3271244e20;
  */
 export const M_SUN_IAU_SI = GM_SUN_SI / G_SI;
 /**
- * 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
+ * @public
  */
-export const M_PROTON_SI = 1.67262192369e-27;
+export const M_PROTON_SI = codata('protonMass');
 /**
  * Avogadro constant (mol⁻¹). Exact in the 2019 SI.
  * @internal
@@ -143,16 +163,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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,sEAAsE;AACtE,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAC;AAC9B,4FAA4F;AAC5F,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEvC,mEAAmE;AACnE,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAEhC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AAE5C,8HAA8H;AAC9H,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAEnD,gEAAgE;AAChE,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAExC,mFAAmF;AACnF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;AAElD,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAE1C,6CAA6C;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC;AAElC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC,iHAAiH;AACjH,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAmG,CAAC;IAC7I,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,yCAAyC,KAAK,IAAI,QAAQ,GAAG,CAAC,CAAC;IAC3I,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEjC,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEjC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1E,sGAAsG;AACtG,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAE9C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAEnE,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,iBAAiB,CAAC","sourcesContent":["/**\n * Canonical CODATA 2018 + 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 2018 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 { checkedDataFile } from './data-file.js';\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 2018: 10 973 731.568 160(21) m⁻¹. */\nexport const R_INF_SI = 10973731.56816;\n\n/** Newtonian gravitational constant (m³ kg⁻¹ s⁻²). CODATA 2018. */\nexport const G_SI = 6.67430e-11;\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`. Planck units below stay the published\n * CODATA 2018 values, which were computed from the truncated display.\n */\nexport const HBAR_SI = H_SI / (2 * Math.PI);\n\n/** The CODATA 2018 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 2018. */\nexport const ALPHA = 7.2973525693e-3;\n\n/** Vacuum permittivity ε₀ (F/m). CODATA 2018. @internal */\nexport const EPS0_SI = 8.8541878128e-12;\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 2018. @internal */\nexport const SIGMA_SB_SI = 5.670374419e-8;\n\n/** Planck mass √(ℏc/G) (kg). CODATA 2018. */\nexport const M_P_SI = 2.176434e-8;\n\n/** Planck length √(ℏG/c³) (m). CODATA 2018. */\nexport const L_P_SI = 1.616255e-35;\n\n/** Planck time √(ℏG/c⁵) (s). CODATA 2018. */\nexport const T_P_SI = 5.391247e-44;\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 = 6.6524587321e-29;\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 2018. 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 = 9.1093837015e-31;\n\n/**\n * Proton mass (kg). CODATA 2018. 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 = 1.67262192369e-27;\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 2018.\n *\n * @public\n */\nexport const B_WIEN_SI = 2.897771955e-3;\n\n/**\n * Unified atomic mass unit (kg). CODATA 2018 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 = 1.66053906660e-27;\n"]}
+{"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 MathTS\n *     `Unit.exactScale('km/s/Mpc')` — the same exact-scale path the unit\n *     reader delegates to. This module cannot import `convertValue`\n *     (`dimensional/` is tier 1; `core/` is tier 0).\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/`.\n *\n * @module core/constants\n * @public\n */\n\nimport { Unit, exactScaleToNumber } from '@danielsimonjr/mathts-core';\nimport * as mathtsConstants from '@danielsimonjr/mathts-functions';\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/**\n * MathTS exact scale of a valueless unit text, rounded once. This is the\n * same pair of calls the delegated unit reader uses (`Unit.exactScale` then\n * `exactScaleToNumber`).\n */\nfunction exactScaleNumber(text: string): number {\n  const exact = Unit.exactScale(text);\n  if (exact === null) throw new Error(`MathTS has no exact scale for '${text}'`);\n  return exactScaleToNumber(exact);\n}\n\n/**\n * Hubble parameter H₀ (s⁻¹).\n *\n * Planck 2018 TT,TE,EE+lowE+lensing best estimate: 67.4 km/s/Mpc. The\n * conversion to Hz is `Unit.exactScale('km/s/Mpc')` rounded once — the same\n * exact-scale path `convertValue('67.4km/s/Mpc', 'Hz')` delegates to. Calling\n * `convertValue` from this file is a layer-order violation (`core/` cannot\n * import `dimensional/units.ts`).\n * @public\n */\nexport const H0_SI = 67.4 * exactScaleNumber('km/s/Mpc');\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 * @public\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","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/** 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"]}
+{"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/format.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The printed forms of a number.
+ *
+ * A recovered or compared quantity prints through {@link formatQuantity}: a
+ * fixed count of significant digits, an integer as an integer. A value a
+ * reader may need to reproduce bit for bit prints through
+ * {@link formatExact}. A fraction reported as a percentage prints through
+ * {@link formatPercent}. The number itself is never rounded by these; only
+ * its text is.
+ *
+ * @module core/format
+ */
+/**
+ * `value` to `digits` significant digits (15 by default, the precision an
+ * evaluator input is already passed at; a statistic such as a residual in σ
+ * asks for 3), with trailing zeros dropped so an integer stays `1`, not
+ * `1.0000e+0`.
+ * @internal
+ */
+export declare function formatQuantity(value: number, digits?: number): string;
+/** The shortest decimal that round-trips to the same double (`upt evaluate`'s outputs). @internal */
+export declare function formatExact(value: number): string;
+/** How {@link formatPercent} prints a statistic: significant digits, and a `+` on a positive value when `signed`. @internal */
+export interface PercentDigits {
+    readonly significant: number;
+    readonly signed?: boolean;
+}
+/**
+ * The fraction `x` as a percentage. A number of `digits` fixes the decimals
+ * (`0.1234` → `12.3%`); `{ significant }` prints that many significant digits
+ * through {@link formatQuantity} (`-0.437` → `-43.7%`, `1.5` → `150%`), and
+ * `signed` adds `+` to a positive value (`+25.7%`; zero stays `0%`).
+ * @internal
+ */
+export declare function formatPercent(x: number, digits?: number | PercentDigits): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAEjE;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,+HAA+H;AAC/H,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,aAAiB,GAAG,MAAM,CAGnF"}

package/dist/core/format.js

@@ -0,0 +1,39 @@
+/**
+ * The printed forms of a number.
+ *
+ * A recovered or compared quantity prints through {@link formatQuantity}: a
+ * fixed count of significant digits, an integer as an integer. A value a
+ * reader may need to reproduce bit for bit prints through
+ * {@link formatExact}. A fraction reported as a percentage prints through
+ * {@link formatPercent}. The number itself is never rounded by these; only
+ * its text is.
+ *
+ * @module core/format
+ */
+/**
+ * `value` to `digits` significant digits (15 by default, the precision an
+ * evaluator input is already passed at; a statistic such as a residual in σ
+ * asks for 3), with trailing zeros dropped so an integer stays `1`, not
+ * `1.0000e+0`.
+ * @internal
+ */
+export function formatQuantity(value, digits = 15) {
+    return String(Number(value.toPrecision(digits)));
+}
+/** The shortest decimal that round-trips to the same double (`upt evaluate`'s outputs). @internal */
+export function formatExact(value) {
+    return String(value);
+}
+/**
+ * The fraction `x` as a percentage. A number of `digits` fixes the decimals
+ * (`0.1234` → `12.3%`); `{ significant }` prints that many significant digits
+ * through {@link formatQuantity} (`-0.437` → `-43.7%`, `1.5` → `150%`), and
+ * `signed` adds `+` to a positive value (`+25.7%`; zero stays `0%`).
+ * @internal
+ */
+export function formatPercent(x, digits = 1) {
+    if (typeof digits === 'number')
+        return `${(100 * x).toFixed(digits)}%`;
+    return `${digits.signed === true && x > 0 ? '+' : ''}${formatQuantity(x * 100, digits.significant)}%`;
+}
+//# sourceMappingURL=format.js.map

package/dist/core/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAM,GAAG,EAAE;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,MAAM,GAA2B,CAAC;IACzE,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IACvE,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC;AACxG,CAAC","sourcesContent":["/**\n * The printed forms of a number.\n *\n * A recovered or compared quantity prints through {@link formatQuantity}: a\n * fixed count of significant digits, an integer as an integer. A value a\n * reader may need to reproduce bit for bit prints through\n * {@link formatExact}. A fraction reported as a percentage prints through\n * {@link formatPercent}. The number itself is never rounded by these; only\n * its text is.\n *\n * @module core/format\n */\n\n/**\n * `value` to `digits` significant digits (15 by default, the precision an\n * evaluator input is already passed at; a statistic such as a residual in σ\n * asks for 3), with trailing zeros dropped so an integer stays `1`, not\n * `1.0000e+0`.\n * @internal\n */\nexport function formatQuantity(value: number, digits = 15): string {\n  return String(Number(value.toPrecision(digits)));\n}\n\n/** The shortest decimal that round-trips to the same double (`upt evaluate`'s outputs). @internal */\nexport function formatExact(value: number): string {\n  return String(value);\n}\n\n/** How {@link formatPercent} prints a statistic: significant digits, and a `+` on a positive value when `signed`. @internal */\nexport interface PercentDigits {\n  readonly significant: number;\n  readonly signed?: boolean;\n}\n\n/**\n * The fraction `x` as a percentage. A number of `digits` fixes the decimals\n * (`0.1234` → `12.3%`); `{ significant }` prints that many significant digits\n * through {@link formatQuantity} (`-0.437` → `-43.7%`, `1.5` → `150%`), and\n * `signed` adds `+` to a positive value (`+25.7%`; zero stays `0%`).\n * @internal\n */\nexport function formatPercent(x: number, digits: number | PercentDigits = 1): string {\n  if (typeof digits === 'number') return `${(100 * x).toFixed(digits)}%`;\n  return `${digits.signed === true && x > 0 ? '+' : ''}${formatQuantity(x * 100, digits.significant)}%`;\n}\n"]}

package/dist/core/hash.d.ts

@@ -0,0 +1,14 @@
+/**
+ * One SHA-256 digest.
+ *
+ * The record fingerprints, the PhysJS reviewed-row hashes, the unit-table
+ * hash and the canonical-JSON hash all read the same digest; each site used
+ * to build its own `createHash('sha256')`. A string is hashed as UTF-8, a
+ * `Buffer` as its bytes. Nothing is normalised here: a caller that folds line
+ * endings does so before hashing, and says so.
+ *
+ * @module core/hash
+ */
+/** The SHA-256 of `text` (UTF-8 for a string, raw bytes for a Buffer) as lowercase hex. @internal */
+export declare function sha256Hex(text: string | Buffer): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD"}

package/dist/core/hash.js

@@ -0,0 +1,17 @@
+/**
+ * One SHA-256 digest.
+ *
+ * The record fingerprints, the PhysJS reviewed-row hashes, the unit-table
+ * hash and the canonical-JSON hash all read the same digest; each site used
+ * to build its own `createHash('sha256')`. A string is hashed as UTF-8, a
+ * `Buffer` as its bytes. Nothing is normalised here: a caller that folds line
+ * endings does so before hashing, and says so.
+ *
+ * @module core/hash
+ */
+import { createHash } from 'node:crypto';
+/** The SHA-256 of `text` (UTF-8 for a string, raw bytes for a Buffer) as lowercase hex. @internal */
+export function sha256Hex(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/core/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qGAAqG;AACrG,MAAM,UAAU,SAAS,CAAC,IAAqB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC","sourcesContent":["/**\n * One SHA-256 digest.\n *\n * The record fingerprints, the PhysJS reviewed-row hashes, the unit-table\n * hash and the canonical-JSON hash all read the same digest; each site used\n * to build its own `createHash('sha256')`. A string is hashed as UTF-8, a\n * `Buffer` as its bytes. Nothing is normalised here: a caller that folds line\n * endings does so before hashing, and says so.\n *\n * @module core/hash\n */\n\nimport { createHash } from 'node:crypto';\n\n/** The SHA-256 of `text` (UTF-8 for a string, raw bytes for a Buffer) as lowercase hex. @internal */\nexport function sha256Hex(text: string | Buffer): string {\n  return createHash('sha256').update(text).digest('hex');\n}\n"]}

package/dist/core/json-schema.d.ts

@@ -18,6 +18,8 @@
 export type JsonSchema = {
     readonly [keyword: string]: unknown;
 };
+/** A JSON object: not an array, not null. The one object guard of the data readers. @internal */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 /**
  * Every place `value` breaks `schema`, as `$.path: reason` lines. Empty when it conforms.
  * Throws when the schema uses a keyword outside the subset.

package/dist/core/json-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/core/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAkJjE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI3E"}
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/core/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAwBjE,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAwHD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI3E"}

package/dist/core/json-schema.js

@@ -35,13 +35,14 @@ const KEYWORDS = new Set([
     'then',
     'else',
 ]);
-function isObject(value) {
+/** A JSON object: not an array, not null. The one object guard of the data readers. @internal */
+export function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 function typeMatches(type, value) {
     switch (type) {
         case 'object':
-            return isObject(value);
+            return isPlainObject(value);
         case 'array':
             return Array.isArray(value);
         case 'string':
@@ -63,8 +64,8 @@ function resolveRef(root, ref) {
     // local definition table and nothing else is resolved.
     const m = /^#\/(\$defs|definitions)\/([^/]+)$/.exec(ref);
     const defs = m === null ? undefined : root[m[1]];
-    const target = m === null || !isObject(defs) ? undefined : defs[m[2]];
-    if (!isObject(target))
+    const target = m === null || !isPlainObject(defs) ? undefined : defs[m[2]];
+    if (!isPlainObject(target))
         throw new Error(`json-schema: unresolved $ref '${ref}'`);
     return target;
 }
@@ -78,11 +79,11 @@ function check(root, schema, value, path, problems) {
         check(root, resolveRef(root, schema['$ref']), value, path, problems);
     // `if`/`then`/`else`: the branch whose condition the value meets is checked; the condition's
     // own problems are not reported.
-    if (isObject(schema['if'])) {
+    if (isPlainObject(schema['if'])) {
         const condition = [];
         check(root, schema['if'], value, path, condition);
         const branch = condition.length === 0 ? schema['then'] : schema['else'];
-        if (isObject(branch))
+        if (isPlainObject(branch))
             check(root, branch, value, path, problems);
     }
     if (schema['type'] !== undefined) {
@@ -124,22 +125,22 @@ function check(root, schema, value, path, problems) {
             if (seen.size !== value.length)
                 problems.push(`${path}: items are not unique`);
         }
-        if (isObject(schema['items'])) {
+        if (isPlainObject(schema['items'])) {
             const items = schema['items'];
             value.forEach((item, i) => check(root, items, item, `${path}[${i}]`, problems));
         }
         else if (Array.isArray(schema['items'])) {
             // A tuple: each position has its own schema; a position past the tuple is unchecked.
             schema['items'].forEach((itemSchema, i) => {
-                if (!isObject(itemSchema))
+                if (!isPlainObject(itemSchema))
                     throw new Error(`json-schema: items[${i}] at ${path} is not a schema`);
                 if (i < value.length)
                     check(root, itemSchema, value[i], `${path}[${i}]`, problems);
             });
         }
     }
-    if (isObject(value)) {
-        const properties = isObject(schema['properties']) ? schema['properties'] : {};
+    if (isPlainObject(value)) {
+        const properties = isPlainObject(schema['properties']) ? schema['properties'] : {};
         if (Array.isArray(schema['required'])) {
             for (const key of schema['required']) {
                 if (!Object.hasOwn(value, key))
@@ -148,17 +149,17 @@ function check(root, schema, value, path, problems) {
         }
         for (const [key, child] of Object.entries(value)) {
             const where = `${path}.${key}`;
-            if (isObject(schema['propertyNames']))
+            if (isPlainObject(schema['propertyNames']))
                 check(root, schema['propertyNames'], key, `${where} (name)`, problems);
             // Own properties only: a `__proto__` key must not resolve to Object.prototype.
             const declared = Object.hasOwn(properties, key) ? properties[key] : undefined;
-            if (isObject(declared)) {
+            if (isPlainObject(declared)) {
                 check(root, declared, child, where, problems);
             }
             else if (schema['additionalProperties'] === false) {
                 problems.push(`${where}: unexpected property`);
             }
-            else if (isObject(schema['additionalProperties'])) {
+            else if (isPlainObject(schema['additionalProperties'])) {
                 check(root, schema['additionalProperties'], child, where, problems);
             }
         }