@essrt/physics 20.0.1 → 22.0.0

package/README.md

@@ -45,8 +45,8 @@ deep-ecc-channel, month-chain), earth (year-lengths, precession-composed,
 frame-of-date, sidereal-year-channel, deep-orbital-history), planets
 (keplerian-chain, orbit-chain, secular-shape, secular-series,
 inv-plane-frame, spin-channel, ecc-channel, geometry, model), deltat
-(cycles, deep-time, recession-history, historical), cardinal points, phase,
-chain-cycles, sun, climate and eclipse finders.
+(cycles, deep-time, recession-history, historical), the cardinal structure,
+the deep calendar, chain-cycles, sun, climate and eclipse finders.
 
 For rendered display values (day/year lengths, precession rates, orbital
 elements as preformatted strings), see
@@ -72,9 +72,9 @@ model.lengths.tropicalYearDays(2000); // 365.24219
 // system — self-identifying, with its own constants hash.
 const cf = createModel({
   ...DEFAULT_CONSTANTS,
-  foundational: { ...DEFAULT_CONSTANTS.foundational, holisticyearLength: 400000 },
+  earthOrbital: { ...DEFAULT_CONSTANTS.earthOrbital, obliquityJ2000_deg: 23.5 },
 });
-cf.epoch.hAtYear(2000);               // 400000 — the anchor unit (a fit constant, not a period)
+cf.earth.obliquityDeg(2000);          // 23.5 — the injected anchor read through the assembly
 cf.identity.counterfactual;           // true
 ```
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@essrt/physics",
-  "version": "20.0.1",
+  "version": "22.0.0",
   "description": "ESSRT (Expanding Solar System Resonance Theory) physics core — pure, injectable-constants, no I/O, no globals, no DOM. The complete model incl. fitted coefficients; every published version immutably ships one recorded model identity.",
   "essrt": {
-    "modelVersion": "v23.0",
+    "modelVersion": "v25.0",
     "_note": "The model identity this package version ships (IP-unified-architecture §10: package semver tracks the API axis; the model version + CONSTANTS_HASH/COEFFICIENTS_HASH in src/constants/ carry the scientific identity). The version-pinning gate enforces this pairing against public/input/model-version.json."
   },
   "type": "module",
@@ -31,11 +31,8 @@
   ],
   "exports": {
     ".": { "types": "./types/index.d.ts", "default": "./src/index.js" },
-    "./phase": { "types": "./types/phase/index.d.cts", "default": "./src/phase/index.cjs" },
     "./phase/deep-calendar": { "types": "./types/phase/deep-calendar.d.cts", "default": "./src/phase/deep-calendar.cjs" },
-    "./cardinal": { "types": "./types/cardinal/index.d.cts", "default": "./src/cardinal/index.cjs" },
     "./cardinal/one-source-structure": { "types": "./types/cardinal/one-source-structure.d.cts", "default": "./src/cardinal/one-source-structure.cjs" },
-    "./moon/ecc-channel": { "types": "./types/moon/ecc-channel.d.cts", "default": "./src/moon/ecc-channel.cjs" },
     "./moon/deep-ecc-channel": { "types": "./types/moon/deep-ecc-channel.d.cts", "default": "./src/moon/deep-ecc-channel.cjs" },
     "./moon/deep-modes-artifact": { "types": "./types/moon/deep-modes-artifact.d.cts", "default": "./src/moon/deep-modes-artifact.cjs" },
     "./earth/deep-orbital-history": { "types": "./types/earth/deep-orbital-history.d.cts", "default": "./src/earth/deep-orbital-history.cjs" },
@@ -50,7 +47,6 @@
     "./moon/series-extension": { "types": "./types/moon/series-extension.d.cts", "default": "./src/moon/series-extension.cjs" },
     "./moon/apparent": { "types": "./types/moon/apparent.d.cts", "default": "./src/moon/apparent.cjs" },
     "./planets/geometry": { "types": "./types/planets/geometry.d.cts", "default": "./src/planets/geometry.cjs" },
-    "./planets/ecc-channel": { "types": "./types/planets/ecc-channel.d.cts", "default": "./src/planets/ecc-channel.cjs" },
     "./planets/orbit-chain": { "types": "./types/planets/orbit-chain.d.cts", "default": "./src/planets/orbit-chain.cjs" },
     "./planets/keplerian-chain": { "types": "./types/planets/keplerian-chain.d.cts", "default": "./src/planets/keplerian-chain.cjs" },
     "./planets/spin-channel": { "types": "./types/planets/spin-channel.d.cts", "default": "./src/planets/spin-channel.cjs" },
@@ -58,14 +54,14 @@
     "./planets/inv-plane-frame": { "types": "./types/planets/inv-plane-frame.d.cts", "default": "./src/planets/inv-plane-frame.cjs" },
     "./planets/secular-series": { "types": "./types/planets/secular-series.d.cts", "default": "./src/planets/secular-series.cjs" },
     "./planets/model": { "types": "./types/planets/model.d.cts", "default": "./src/planets/model.cjs" },
+    "./planets/display-names": { "types": "./types/planets/display-names.d.cts", "default": "./src/planets/display-names.cjs" },
     "./deltat/cycles": { "types": "./types/deltat/cycles.d.cts", "default": "./src/deltat/cycles.cjs" },
     "./deltat/deep-time": { "types": "./types/deltat/deep-time.d.cts", "default": "./src/deltat/deep-time.cjs" },
     "./deltat/historical": { "types": "./types/deltat/historical.d.cts", "default": "./src/deltat/historical.cjs" },
     "./deltat/recession-history": { "types": "./types/deltat/recession-history.d.cts", "default": "./src/deltat/recession-history.cjs" },
     "./climate/l1-orbital": { "types": "./types/climate/l1-orbital.d.cts", "default": "./src/climate/l1-orbital.cjs" },
     "./eclipse/finders": { "types": "./types/eclipse/finders.d.cts", "default": "./src/eclipse/finders.cjs" },
-    "./eclipse/sun-planetary-completion": { "types": "./types/eclipse/sun-planetary-completion.d.cts", "default": "./src/eclipse/sun-planetary-completion.cjs" },
-    "./sun/longitude-correction": { "types": "./types/sun/longitude-correction.d.cts", "default": "./src/sun/longitude-correction.cjs" }
+    "./eclipse/sun-planetary-completion": { "types": "./types/eclipse/sun-planetary-completion.d.cts", "default": "./src/eclipse/sun-planetary-completion.cjs" }
   },
   "license": "AGPL-3.0-or-later"
 }

package/src/cardinal/one-source-structure.cjs

@@ -31,8 +31,9 @@
  * DELIBERATELY NOT HERE: absolute event dates. They need a mean-sun
  * crossing chain, which is a per-renderer concern (the measured ±2–13 min
  * twin-stack split between the browser scene and the Step-6a instrument);
- * the era-certified absolute dates remain the frozen harmonic device
- * (createCardinalModel — the certified era clock).
+ * the shipped absolute dates are the one Sun's apparent crossings,
+ * createModel().cardinal (plan 06 R1; the frozen harmonic device
+ * createCardinalModel that certified the era was deleted at plan 09 step 7a).
  *
  * Pure factory: no artifact reads, no registry reads — the caller injects
  * the one-source sampler and the movement's mean tropical year, exactly

package/src/chain-cycles/index.cjs

@@ -42,7 +42,6 @@
 /**
  * @param {{
  *   ageAnchorYear: number,
- *   tropicalYearSecondsAtAge: (tMa: number) => (number | null),
  *   tropicalYearJ2000Seconds: number,
  *   isDeepTime: () => boolean,
  *   gridMinYear?: number,
@@ -52,12 +51,18 @@
  *   maxCacheEntries?: number,
  * }} deps — ageAnchorYear is the year whose age is 0 in the period
  *   functions' t_Ma coordinate (startmodelYear = 2000.5, the certified
- *   convention); tropicalYearJ2000Seconds feeds the snapshot branch;
+ *   convention); tropicalYearJ2000Seconds is the length of ONE tick of the
+ *   year axis the integrator is fed — the linear SI-year label, each tick
+ *   exactly one J2000 tropical year of seconds — so it is the integrand's
+ *   weight in BOTH branches (plan 09 step 7c′: the deep branch had weighted
+ *   each tick by the tropical year OF DATE, adding that year's deep-time
+ *   drift to every lunar count — ~5° of Moon at ±100 kyr, ~1.3 orbits at
+ *   1 Ma — although the tick itself never changes length; the owner's call:
+ *   a plain correctness fix, the tick already is an SI tick);
  *   isDeepTime is read PER CALL so the engine's runtime toggle works.
  */
 function createChainCycleIntegrator({
   ageAnchorYear,
-  tropicalYearSecondsAtAge,
   tropicalYearJ2000Seconds,
   isDeepTime,
   gridMinYear = 2000 - 250000,
@@ -73,28 +78,8 @@ function createChainCycleIntegrator({
   /** @type {Map<PeriodSecondsAtAge, Float64Array | null>} */
   const tables = new Map();
 
-  // Exact-argument memo for the year-length integrand of the out-of-range
-  // Simpson fallback. Within one animation frame every integrator node
-  // (the six-plus Moon chains + the seven planets) integrates the SAME
-  // (anchor, currentYear) pair, so the Simpson sample lattice — and with
-  // it every tropicalYearSecondsAtAge(tMa) — repeats across chains, up to
-  // 13× per sample. Exact-key reuse returns the bit-identical value: pure
-  // dedupe, not a resolution change (the sampler-purity trap class is
-  // about grids serving NEARBY arguments; this serves only the same one).
-  // Bounded by wholesale clear — one frame's lattice is ≤ ~1025 entries.
-  /** @type {Map<number, number | null>} */
-  const yearSecondsMemo = new Map();
-  const YEAR_SECONDS_MEMO_CAP = 4096;
-  /** @param {number} tMa @returns {number | null} */
-  function tropicalYearSecondsMemo(tMa) {
-    let v = yearSecondsMemo.get(tMa);
-    if (v === undefined) {
-      v = tropicalYearSecondsAtAge(tMa);
-      if (yearSecondsMemo.size >= YEAR_SECONDS_MEMO_CAP) yearSecondsMemo.clear();
-      yearSecondsMemo.set(tMa, v);
-    }
-    return v;
-  }
+  // (plan 09 step 7c′: the exact-argument memo of the year-of-date weight
+  // left with the weight — the tick length is the constant below.)
 
   /** Lazy cumulative table for one chain; null when the chain is undefined
    *  anywhere in range (→ Simpson fallback).
@@ -111,8 +96,7 @@ function createChainCycleIntegrator({
       const tMa = (ageAnchorYear - y) / 1e6;
       const tPeriodS = periodFnSeconds(tMa);
       if (tPeriodS === null) return null;
-      const tYrS = tropicalYearSecondsAtAge(tMa);
-      return tYrS === null ? null : tYrS / tPeriodS;
+      return tropicalYearJ2000Seconds / tPeriodS;   // cycles per tick (one SI year)
     };
     let ok = true;
     let fPrev = f(gridMinYear);
@@ -190,9 +174,7 @@ function createChainCycleIntegrator({
       const tMa = (ageAnchorYear - y) / 1e6;
       const tPeriodS = periodFnSeconds(tMa);
       if (tPeriodS === null) return null;
-      const tYrS = tropicalYearSecondsMemo(tMa);
-      if (tYrS === null) return null;
-      const integrand = tYrS / tPeriodS;  // cycles per SI year
+      const integrand = tropicalYearJ2000Seconds / tPeriodS;  // cycles per tick (one SI year)
       const w = (i === 0 || i === n) ? 1 : (i % 2 === 1 ? 4 : 2);
       sum += w * integrand;
     }

package/src/climate/l1-orbital.cjs

@@ -88,7 +88,9 @@ function laggedL1Terms(l1Terms, relaxationKyr) {
  *   j2RateJ2000PerYr?: number,
  *   j2J2000?: number,
  * }} cfg - relaxationKyr, alphaGiaRateJ2000PerYr and j2RateJ2000PerYr are
- *   model-parameters deepTime constants; alphaJ2000 the IERS
+ *   assembled deepTime block (DEFAULT_CONSTANTS.deepTime: τ the banked record
+ *   data/deep-time-fitted.json, the rate derived from astro-reference
+ *   giaCoxChaoPeltier — plan 11 step 1); alphaJ2000 the IERS
  *   moment-of-inertia factor; j2J2000 Earth's J₂ (astro-reference)
  * @returns {{
  *   alphaAt: (year: number) => number,

package/src/constants/coefficients.d.ts

@@ -1,74 +1,11 @@
 // GENERATED — do not edit. Regenerate: node tools/constants/generate.mjs --write
 // The fitted coefficients' shapes for TypeScript consumers (§2g); values live
-// in coefficients.js, emitted VERBATIM from fitted-coefficients.json.
+// in coefficients.js, emitted VERBATIM from the fit artifacts under data/.
 
-export declare const COEFFICIENTS_HASH: "82c86b078b32fff8";
+export declare const COEFFICIENTS_HASH: "91e2d041c7b6e038";
 
 export declare const FITTED_COEFFICIENTS: {
-  readonly ANOMALISTIC_YEAR_HARMONICS: Array<[number, number, number]>;
   readonly BALANCE_PRESETS: Array<Array<number | string>>;
-  readonly CARDINAL_POINT_ANCHORS: {
-    "SS": number;
-    "WS": number;
-    "VE": number;
-    "AE": number;
-  };
-  readonly CARDINAL_POINT_ANCHORS_ADJUSTED: {
-    "SS": number;
-    "WS": number;
-    "VE": number;
-    "AE": number;
-  };
-  readonly CARDINAL_POINT_DERIVED: {
-    "lincoef": number;
-    "h0": number;
-    "h1": number;
-    "eccOrderDivisors": [number, number];
-    "note": string;
-  };
-  readonly CARDINAL_POINT_ECC_TERMS: {
-    "SS": Array<{
-      "order": number;
-      "sin": number;
-      "cos": number;
-    }>;
-    "WS": Array<{
-      "order": number;
-      "sin": number;
-      "cos": number;
-    }>;
-    "VE": Array<{
-      "order": number;
-      "sin": number;
-      "cos": number;
-    }>;
-    "AE": Array<{
-      "order": number;
-      "sin": number;
-      "cos": number;
-    }>;
-  };
-  readonly CARDINAL_POINT_HARMONICS: {
-    "SS": Array<[number, number, number]>;
-    "WS": Array<[number, number, number]>;
-    "VE": Array<[number, number, number]>;
-    "AE": Array<[number, number, number]>;
-  };
-  readonly CARDINAL_POINT_JOINT_TERMS: {
-    "quadratureDeg": {
-      "SS": number;
-      "AE": number;
-      "WS": number;
-      "VE": number;
-    };
-    "terms": Array<{
-      "order": number;
-      "div": number;
-      "sin": number;
-      "cos": number;
-    }>;
-    "note": string;
-  };
   readonly CLIMATE_FORMULA_COEFFS: {
     "config": {
       "L1_lines": Array<{
@@ -303,105 +240,105 @@ export declare const FITTED_COEFFICIENTS: {
           "delta_l3": number;
         };
         "carbon_amplification_ratios": {
-          "19.0014": {
+          "19.0015": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "19.1554": {
+          "19.1555": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "22.4452": {
+          "22.4453": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "23.1931": {
+          "23.1933": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "23.7599": {
+          "23.7601": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "27.2689": {
+          "27.2691": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "28.8424": {
+          "28.8426": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "29.0047": {
+          "29.0050": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "29.6172": {
+          "29.6174": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "29.8091": {
+          "29.8094": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "39.5560": {
+          "39.5564": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "40.2292": {
+          "40.2297": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "40.9239": {
+          "40.9244": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "41.6445": {
+          "41.6450": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
             "ratio": number;
             "label": string;
           };
-          "53.6174": {
+          "53.6182": {
             "period_kyr": number;
             "lr04_post_mpt_amp": number;
             "epica_amp": number;
@@ -634,17 +571,4 @@ export declare const FITTED_COEFFICIENTS: {
   };
   readonly MEEUS_LATITUDE_TERMS: Array<number[]>;
   readonly MEEUS_LONGITUDE_TERMS: Array<number[]>;
-  readonly PERI_HARMONICS_RAW: Array<[number, number, number]>;
-  readonly PERI_OFFSET: number;
-  readonly RA_DAY_OFFSET_MS: {
-    "mean": number;
-    "terms": Array<[number, number, number]>;
-    "note": string;
-  };
-  readonly SIDEREAL_YEAR_HARMONICS: Array<[number, number, number]>;
-  readonly SOLSTICE_OBLIQUITY_HARMONICS: Array<[number, number, number]>;
-  readonly SOLSTICE_OBLIQUITY_MEAN_FITTED: number;
-  readonly SUN_LONGITUDE_HARMONICS: Array<[number, number, number]>;
-  readonly SUN_LONGITUDE_MEAN: number;
-  readonly TROPICAL_YEAR_HARMONICS: Array<[number, number, number]>;
 };