@essrt/physics 20.0.1 → 22.0.0

package/types/deltat/deep-time.d.cts

@@ -25,17 +25,12 @@ export type DeepTimeLodConstants = {
     alpha1PerMa: number;
     alpha3PerMa3: number;
     alpha4PerMa4: number;
-    holisticYearJ2000: number;
     /**
-     * - the H/13-identity mean LOD at J2000
+     * - ω₀, the J2000 day length (the SI day since plan 09; identifier kept)
      */
     lodNowH13Seconds: number;
     meanSiderealYearJ2000Seconds: number;
     solarMassLossFracPerYear: number;
-    /**
-     * - Actual-LOD numerator
-     */
-    siderealYearDaysKinematicJ2000: number;
     /**
      * - f_S, the solar fraction of the J2000
      * precession torque (derive-params) — the unit H(t) = 13·T_p,composed needs it
@@ -49,7 +44,6 @@ export type DeepTimeLodDeps = {
      * - GIA α(t)
      */
     moiFactorAtAge: (tMa: number) => number;
-    siderealYearDaysFourierAt: (year: number) => number;
     /**
      * - gated δLOD sum (incl. swing)
      */
@@ -101,11 +95,9 @@ export type DeepTimeLodDeps = {
  * @property {number} aMoonNowMetres - Farhat polynomial anchor
  * @property {number} alpha1PerMa @property {number} alpha3PerMa3
  * @property {number} alpha4PerMa4
- * @property {number} holisticYearJ2000
- * @property {number} lodNowH13Seconds - the H/13-identity mean LOD at J2000
+ * @property {number} lodNowH13Seconds - ω₀, the J2000 day length (the SI day since plan 09; identifier kept)
  * @property {number} meanSiderealYearJ2000Seconds
  * @property {number} solarMassLossFracPerYear
- * @property {number} siderealYearDaysKinematicJ2000 - Actual-LOD numerator
  * @property {number} precessionSolarShareJ2000 - f_S, the solar fraction of the J2000
  *   precession torque (derive-params) — the unit H(t) = 13·T_p,composed needs it
  */
@@ -114,7 +106,6 @@ export type DeepTimeLodDeps = {
  * @property {DeepTimeLodConstants} constants
  * @property {(tMa: number) => number} moonDistanceMetresAtAge
  * @property {(tMa: number) => number} moiFactorAtAge - GIA α(t)
- * @property {(year: number) => number} siderealYearDaysFourierAt
  * @property {(year: number) => number} cycleLodSumAt - gated δLOD sum (incl. swing)
  * @property {(year: number) => number} swingLodAt - gated swing δLOD alone
  * @property {(year: number) => number} swingLodRateAt - gated analytic swing rate
@@ -141,7 +132,6 @@ export function createDeepTimeLod(deps: DeepTimeLodDeps): {
     lodSecondsAtAge: (t_Ma: number) => number | null;
     lodSecondsAtAgeWithAlpha: (t_Ma: number, alpha: number) => number | null;
     lodHoursAtAge: (t_Ma: number) => number | null;
-    hAtAge: (t_Ma: number) => number | null;
     lunisolarPrecessionRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
     lunisolarPrecessionPeriodYearsAtAge: (t_Ma: number) => number | null;
     lunarTorqueFactorAtAge: (tMa: number) => (number | null);
@@ -149,11 +139,11 @@ export function createDeepTimeLod(deps: DeepTimeLodDeps): {
     siderealYearSecondsAtAge: (t_Ma: number) => number;
     tropicalYearSecondsAtAge: (t_Ma: number) => number;
     tropicalYearDaysAtAge: (t_Ma: number) => number | null;
+    tropicalYearSecondsFromLod: (t_Ma: number, LOD_s: number | null) => number;
     eclipticLodCorrectionSecondsAtAge: (t_Ma: number) => number | null;
     yearInDaysAtAge: (t_Ma: number) => number | null;
     deltaTRawSecondsAtAge: (t_Ma: number) => number;
     lodSecondsWithCorrectionsAtAge: (t_Ma: number) => number | null;
-    lodSecondsActualAtAge: (t_Ma: number) => number | null;
     dLodDtDecompositionAtAge: (t_Ma: number) => {
         tidal: number | null;
         gia: number | null;
@@ -163,7 +153,4 @@ export function createDeepTimeLod(deps: DeepTimeLodDeps): {
         net_L3: number | null;
         net_L4: number | null;
     };
-    eraClockHAtAge: (t_Ma: number) => number | null;
-    eraClockTropicalYearSecondsAtAge: (t_Ma: number) => number;
-    eraClockYearInDaysAtAge: (t_Ma: number) => number | null;
 };

package/types/earth/frame-of-date.d.cts

@@ -35,3 +35,12 @@ export function computeEarthFrameOfDate(sample: {
  * @returns {number} θ in radians, in (−π, π]
  */
 export function solveWheelAngleForLongitude(lambdaRad: number, e: number, periRad: number): number;
+/**
+ * The scene's world frame: R maps a J2000-ecliptic vector to world, columns
+ * [ĝ, n̂ × ĝ, n̂] = [the equinox, longitude 90°, the ecliptic pole] with
+ * n̂ = world Y exactly and ĝ at the view azimuth.
+ * @returns {number[][]} a 3×3 rotation matrix, rows × columns
+ */
+export function computeSceneWorldFrameJ2000(): number[][];
+/** The J2000 equinox's azimuth in the scene's world XZ plane, degrees (atan2(x, z)) — the view convention. */
+export const SCENE_EQUINOX_VIEW_AZIMUTH_DEG: 158.2265109779131;

package/types/earth/year-lengths.d.cts

@@ -53,6 +53,18 @@ export function createYearLengths({ sampleAt, massLossSiderealSecondsAtYearFn }:
     /** The planetary λ̇ ratio (diagnostic; ≡1 at J2000). */
     planetaryRelAtYear: (year: number) => number;
 }>;
+/** The J2000 mean tropical year, DAYS — derived in ONE home from two IAU
+ *  inputs, the sidereal year and the general precession in longitude p_A
+ *  (″ per JULIAN year), in the exact rate form
+ *      1/T_trop = 1/T_sid + p_A / (1,296,000″ · 365.25 d)
+ *  — the same beat `shorterYear` evaluates of date. 365.242190469 d on the
+ *  IAU 2006 inputs. Plan 09: replaces the Meeus & Savoie 1992 input
+ *  365.2421897 (66 ms shorter, whose beat with the sidereal year read
+ *  25,770.7 yr against p_A's 25,771.6 — three inputs over-determining a
+ *  two-parameter identity). Counting p_A per tropical or sidereal year
+ *  instead moves this by 26 ms; IAU states p_A per Julian year.
+ *  @param {number} siderealYearDays @param {number} generalPrecessionArcsecPerJulianYr @returns {number} */
+export function computeMeanTropicalYearJ2000Days(siderealYearDays: number, generalPrecessionArcsecPerJulianYr: number): number;
 /**
  * The published of-date window (plan 06 Phase 3 S2): inside |year − 2000| ≤
  * this span the one-family route is THE published year-length / precession

package/types/eclipse/sun-planetary-completion.d.cts

@@ -63,15 +63,6 @@ export function computeCarrierRatesDegPerCy({ meanSiderealYearDays, moonSidereal
  * @returns {[number, number]}
  */
 export function eccVectorOfDateEmbedded(bodyIndex: number, T: number): [number, number];
-/** sha256/16 of JSON.stringify(FITTED_COEFFICIENTS.SUN_LONGITUDE_HARMONICS)
- *  at derivation time — the matched-pair fingerprint asserted by test:model.
- *  Unchanged from v1/v2: SUN_HARMONICS did not move in the D2 or N3
- *  landings. Plan 07 R10 moved the hash WITHOUT a refit: the three (sin, cos)
- *  pairs were rotated exactly from the t₀ phase origin to J2000
- *  (tools/fit/reorigin-combs-j2000.mjs), the finder Sun is bit-identical, so
- *  the residual this table was derived from is unchanged — the table stands
- *  (fidelity 0.616″, 70 terms), only the fingerprint is re-recorded. */
-export const PAIRED_SUN_HARMONICS_SHA256: "53530a28a60b3c4a";
 /** sha256/16 of JSON.stringify([...planets, moonElongation]) — the seven
  *  full-precision carrier rates (deg/cy TT) the tables pair with: since plan
  *  06 I3 the model's own banked J2000 sidereal mean motions for the planets

package/types/index.d.ts

@@ -1,17 +1,13 @@
 export { createEpochPrimitives } from "./layer0/index.js";
 export { deriveEpochParams } from "./layer0/derive-params.js";
 export { createDerivedViews } from "./layer1/index.js";
-export { createPhaseMachinery } from "./phase/index.cjs";
 export { createDeepCalendar } from "./phase/deep-calendar.cjs";
-export { createCardinalModel } from "./cardinal/index.cjs";
 export { createCardinalStructure } from "./cardinal/one-source-structure.cjs";
-export { createMoonEccChannel } from "./moon/ecc-channel.cjs";
 export { createMoonMonthChain } from "./moon/month-chain.cjs";
 export { createChainCycleIntegrator } from "./chain-cycles/index.cjs";
 export { createMoonArguments } from "./moon/arguments.cjs";
 export { createMoonSeries } from "./moon/series.cjs";
 export { createMoonApparent } from "./moon/apparent.cjs";
-export { derivePlanetGeometry } from "./planets/geometry.cjs";
 export * as planetOrbitChain from "./planets/orbit-chain.cjs";
 export { computeSecularShape } from "./planets/secular-shape.cjs";
 export { createSecularSeriesOverride } from "./planets/secular-series.cjs";
@@ -19,11 +15,11 @@ export { createDeepEccChannel } from "./moon/deep-ecc-channel.cjs";
 export { createDeepOrbitalHistory } from "./earth/deep-orbital-history.cjs";
 export { createSiderealYearChannel } from "./earth/sidereal-year-channel.cjs";
 export { createPlanetModel } from "./planets/model.cjs";
+export { PLANET_DISPLAY_NAMES } from "./planets/display-names.cjs";
 export { createDeltaTCycles } from "./deltat/cycles.cjs";
 export { createDeepTimeLod } from "./deltat/deep-time.cjs";
 export { deltaTEspenakMeeusCanonSeconds } from "./deltat/historical.cjs";
 export { createEclipseFinders } from "./eclipse/finders.cjs";
-export { createSunLongitudeCorrection } from "./sun/longitude-correction.cjs";
 export function createModel(constants?: Constants, opts?: {
     laws?: {
         eccentricityAt?: (year: number) => number;
@@ -50,11 +46,6 @@ export type ModelIdentity = {
 export type Model = {
     constants: Constants;
     hash: string;
-    computeLatticePeriodsYears: () => {
-        axialPrecessionPeriodYears: number;
-        inclinationPrecessionPeriodYears: number;
-        perihelionPrecessionPeriodYears: number;
-    };
     eccentricity: (year: number) => number;
     identity: ModelIdentity;
 } & ModelSurfaces;
@@ -66,14 +57,14 @@ import { REFERENCE_DATA } from './constants/index.js';
 import { assembleModel } from './model.js';
 export { GENERATED as DEFAULT_CONSTANTS, CONSTANTS_HASH, MODEL_VERSION, PREPRINT_DOI, REFERENCE_DATA };
 export { FITTED_COEFFICIENTS, COEFFICIENTS_HASH } from "./constants/index.js";
-export { computeEarthFrameOfDate, solveWheelAngleForLongitude } from "./earth/frame-of-date.cjs";
-export { eccentricityFromCycles, computeEccentricityIntegrated } from "./planets/ecc-channel.cjs";
+export { computeEarthFrameOfDate, solveWheelAngleForLongitude, computeSceneWorldFrameJ2000, SCENE_EQUINOX_VIEW_AZIMUTH_DEG } from "./earth/frame-of-date.cjs";
+export { derivePlanetGeometry, scaffoldOrbitInputs } from "./planets/geometry.cjs";
 export { buildPlanetChainsFromArtifactData, computePlanetElementsAtYear, computeHeliocentricEclipticFromElements, computePoissonArgRad, computeOsculatingElements, solveKeplerRad, computeApsidalSecularDegPerYr, ANCHOR_EPOCH_YEAR, ANCHOR_EPOCH_JD } from "./planets/keplerian-chain.cjs";
 export { computeEquatorNodeOriginSFrameDeg, convertNodeSFrameToEquatorOriginDeg } from "./planets/inv-plane-frame.cjs";
 export { computePlanetPrecessionConstant, createPlanetSpinChannel, createPlanetSpinChannelFromArtifacts, computeObliquityJ2000Deg } from "./planets/spin-channel.cjs";
 export { CHAIN_ARTIFACT, CHAIN_ARTIFACT_HASH } from "./planets/chain-artifact.js";
 export { DEEP_MODES_ARTIFACT, DEEP_MODES_ARTIFACT_HASH } from "./moon/deep-modes-artifact.cjs";
-export { createYearLengths, ONE_FAMILY_WINDOW_YEARS } from "./earth/year-lengths.cjs";
+export { createYearLengths, computeMeanTropicalYearJ2000Days, ONE_FAMILY_WINDOW_YEARS } from "./earth/year-lengths.cjs";
 export { computeSolarTorqueShare, createComposedPrecession } from "./earth/precession-composed.cjs";
 export { createMoonRecessionHistory, createSolarChannelBudget } from "./deltat/recession-history.cjs";
 export { evalClimateL1OrbitalPermil, laggedL1Terms, createAlphaGiaChannel } from "./climate/l1-orbital.cjs";

package/types/layer0/derive-params.d.ts

@@ -15,12 +15,11 @@ export type RawEpochConstants = {
     alpha1PerMa: number;
     alpha3PerMa3: number;
     alpha4PerMa4: number;
+    meanSiderealYearSeconds: number;
     /**
-     * H
+     * ω₀: the J2000 day length, SI seconds (the SI day since plan 09)
      */
-    holisticYearJ2000: number;
-    meanSiderealYearSeconds: number;
-    meanSiderealYearDaysKinematic: number;
+    lodJ2000Seconds: number;
     /**
      * M_SUN
      */
@@ -43,4 +42,8 @@ export type RawEpochConstants = {
     astronomicalUnitKm: number;
     earthOrbitalEccentricityJ2000: number;
     moonEclipticInclinationJ2000Deg: number;
+    /**
+     * the model's ONE J2000 precession reading (1,296,000/p_A; plan 09)
+     */
+    axialPrecessionJ2000Years: number;
 };

package/types/layer0/index.d.ts

@@ -33,7 +33,6 @@ export type EpochParams = {
     moonEccentricityFactor: number;
     earthMassKg: number;
     earthRadiusM: number;
-    holisticYearJ2000: number;
     lodNowH13Seconds: number;
     siderealYearJ2000Seconds: number;
     solarMassLossFracPerYear: number;
@@ -41,24 +40,18 @@ export type EpochParams = {
      * f_S, the solar fraction of the J2000 precession torque
      */
     precessionSolarShareJ2000: number;
+    /**
+     * p₀, the composed precession rate's J2000 anchor (1,296,000/axial0)
+     */
+    precessionRateJ2000ArcsecPerYr: number;
 };
 export type EpochPrimitives = {
     tMa: (year: number) => number;
     moonDistanceMetres: (year: number) => number;
     lodSeconds: (year: number) => number | null;
-    /**
-     * the UNIT: 13 × the composed lunisolar precession period
-     */
-    holisticH: (year: number) => number | null;
     siderealYearSeconds: (year: number) => number;
-    tropicalYearSeconds: (year: number) => number;
-    anomalisticYearSeconds: (year: number) => number | null;
-    /**
-     * the frozen era clock's phase convention H₀·LOD/LOD₀ (device tier)
-     */
-    eraClockH: (year: number) => number | null;
     /**
-     * T_sid·(1 − 13/H_era) — the frozen comb family's base
+     * sidereal less one equinox turn per T_p(t) (the composed precession period)
      */
-    eraClockTropicalYearSeconds: (year: number) => number;
+    tropicalYearSeconds: (year: number) => number;
 };

package/types/layer1/index.d.ts

@@ -5,6 +5,4 @@ export type EpochPrimitives = import("../layer0/index.js").EpochPrimitives;
 export type DerivedViews = {
     tropicalYearDays: (year: number) => number | null;
     siderealYearDays: (year: number) => number | null;
-    anomalisticYearDays: (year: number) => number | null;
-    siderealYearDaysViaLattice: (year: number) => number | null;
 };

package/types/model.d.ts

@@ -32,16 +32,20 @@ export function assembleModel(C: Readonly<Record<string, any>>, F: Readonly<Reco
         jdFromYear: (year: number) => number;
         siTropicalYearDays: number;
     }>;
+    sun: Readonly<{
+        /** Mean longitude of date, degrees, unwrapped — L0 + 360·∫dt/T_trop (the one-family tropical year). @param {number} year @returns {number} */
+        meanLongitudeDegAt: (year: number) => number;
+        /** The Sun's mean perihelion longitude of date (Earth's ϖ, mean elements), degrees, wrapped to [0, 360). @param {number} year @returns {number} */
+        perihelionLongitudeDegAt: (year: number) => number;
+    }>;
     epoch: Readonly<{
         yearToTMa: (year: number) => number;
-        hAtYear: (year: number) => number | null;
         lodSecondsAtYear: (year: number) => number | null;
         lodRealSecondsAtYear: (year: number) => number;
         alphaAtYear: (year: number) => number;
         moonDistanceKmAtYear: (year: number) => number;
         siderealYearSecondsAtYear: (year: number) => number;
         deltaTSecondsAtYear: (year: number) => number;
-        cyclesBetween: (yearA: number, yearB: number, divisorN: number) => number;
         axialPrecessionYearsAtYear: (year: number) => number;
         tropicalYearSecondsAtYear: (year: number) => number;
     }>;
@@ -119,22 +123,18 @@ export function assembleModel(C: Readonly<Record<string, any>>, F: Readonly<Reco
     earth: Readonly<{
         perihelionLongitudeDeg: (year: number) => number;
         obliquityDeg: (year: number) => number;
-        obliquityCombDeg: (year: number) => number;
         eccentricity: (year: number) => number;
         inclinationDeg: (year: number) => number;
         ascendingNodeDeg: (year: number) => number;
     }>;
     lengths: Readonly<{
         tropicalYearDays: (year: number) => number;
-        tropicalYearDirectDays: (year: number) => number;
         siderealYearDays: (year: number) => number;
         anomalisticYearDays: (year: number) => number;
         dayLengthSeconds: (year: number) => number;
         lodRealSeconds: (year: number) => number;
         siderealDaySeconds: (year: number) => number;
         stellarDaySeconds: (year: number) => number;
-        measuredSolarDaySeconds: (year: number) => number;
-        raDayOffsetMs: (year: number) => number;
     }>;
     cardinal: Readonly<{
         jd: (year: number, type: string) => number;
@@ -261,6 +261,8 @@ export function assembleModel(C: Readonly<Record<string, any>>, F: Readonly<Reco
                 meanDeg: number;
                 maxDeg: number;
             } | null;
+            spinAxisEclipticJ2000AtYear: (year: number) => number[] | null;
+            orbitNormalEclipticJ2000AtYear: (year: number) => number[];
             stepYr: number;
             maxSpanYr: 10000000;
         }>;

package/types/moon/arguments.d.cts

@@ -5,20 +5,11 @@ export type MoonArgsDeg = {
     Mp: number;
     F: number;
 };
-/**
- * @typedef {{Lp: number, D: number, M: number, Mp: number, F: number}} MoonArgsDeg
- */
 /**
  * @param {{
  *   constants: {
  *     j2000JD: number,
  *     julianCenturyDays: number,
- *     holisticYearJ2000: number,
- *     balancedYearJ2000: number,
- *     meanSolarYearDays: number,
- *     meanAnomalisticYearDays: number,
- *     tropicalYearHarmonics: Array<[number, number, number]>,
- *     anomalisticYearHarmonics: Array<[number, number, number]>,
  *     eccentricityJ2000: number,
  *     eccentricityDotJ2000: number,
  *     eccentricityDotDotJ2000: number,
@@ -30,11 +21,12 @@ export type MoonArgsDeg = {
  *     eccAt: (tYr: number) => number,
  *     channelIntegral: (T: number, s: number) => number,
  *     computeObliquityEarth: (year: number) => number,
+ *     sunMeanLonDegAtJdTT: (jdTT: number) => number,
+ *     sunPerihelionLonDegAtJdTT: (jdTT: number) => number,
  *     jdToSIyear: (jd: number) => number,
  *     tropicalOrbitsBetween: (yearA: number, yearB: number) => (number | null),
  *     apsidalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null),
  *     nodalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null),
- *     cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null),
  *     isDeepTime: () => boolean,
  *     isFrameworkNative: () => boolean,
  *     pDynDegPerYearAt?: (year: number) => number,
@@ -48,17 +40,20 @@ export type MoonArgsDeg = {
  *   evaluators — the tweakpane identity, real at J2000, epoch-valid);
  *   pKin = the KINEMATIC pair's beat (the H/13-family mean the chains
  *   embed). Absent ⇒ the completion is disabled (pre-(d′) behaviour).
+ *   Plan 09: the Sun of the arguments is the engine's ONE certified Sun —
+ *   sunMeanLonDegAtJdTT (the mean longitude that integrates the one-family
+ *   tropical year, unwrapped) and sunPerihelionLonDegAtJdTT (the mean
+ *   perihelion of date, wrapped — the arguments wrap M, and the rate anchors
+ *   difference it over ±25 days wrapped to ±180°). The former "model timeline" Sun — 360° per mean solar
+ *   year plus the closed-form integrals of the retired year-length combs,
+ *   the perihelion on the H/16 chain count — sat 0.2° behind the IAU mean
+ *   Sun at −2000 (the combs could not carry the tropical year's secular
+ *   drift); measured against Meeus L0 before the move.
  */
 export function createMoonArguments({ constants, fns }: {
     constants: {
         j2000JD: number;
         julianCenturyDays: number;
-        holisticYearJ2000: number;
-        balancedYearJ2000: number;
-        meanSolarYearDays: number;
-        meanAnomalisticYearDays: number;
-        tropicalYearHarmonics: Array<[number, number, number]>;
-        anomalisticYearHarmonics: Array<[number, number, number]>;
         eccentricityJ2000: number;
         eccentricityDotJ2000: number;
         eccentricityDotDotJ2000: number;
@@ -70,11 +65,12 @@ export function createMoonArguments({ constants, fns }: {
         eccAt: (tYr: number) => number;
         channelIntegral: (T: number, s: number) => number;
         computeObliquityEarth: (year: number) => number;
+        sunMeanLonDegAtJdTT: (jdTT: number) => number;
+        sunPerihelionLonDegAtJdTT: (jdTT: number) => number;
         jdToSIyear: (jd: number) => number;
         tropicalOrbitsBetween: (yearA: number, yearB: number) => (number | null);
         apsidalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null);
         nodalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null);
-        cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null);
         isDeepTime: () => boolean;
         isFrameworkNative: () => boolean;
         pDynDegPerYearAt?: (year: number) => number;
@@ -85,10 +81,6 @@ export function createMoonArguments({ constants, fns }: {
     fwArgs: (jdTT: number) => MoonArgsDeg;
     fwArgsDeep: (jd: number) => MoonArgsDeg | null;
     pureMeeusArgs: (jdTT: number) => MoonArgsDeg;
-    sunSecularDeviations: (jdTT: number) => {
-        dLs: number;
-        dPeri: number;
-    };
     planetaryCarrier: (T: number) => number;
     obliquityCarrier: (T: number) => number;
     lpSecularCompletion: (T: number) => number;
@@ -101,7 +93,6 @@ export function createMoonArguments({ constants, fns }: {
         LPR: number;
         DR: number;
         MR: number;
-        P_DEGCY: number;
         WDOT: number;
         NDOT: number;
         T2_W: number;
@@ -136,3 +127,13 @@ export function createMoonArguments({ constants, fns }: {
  * Sun secular deviations. @param {number} jd @returns {number}
  */
 export function jdToDecimalYear(jd: number): number;
+/**
+ * @typedef {{Lp: number, D: number, M: number, Mp: number, F: number}} MoonArgsDeg
+ */
+/** The secular-completion taper half-width, Julian years: the cos² envelope
+ *  inside which the chain's Meeus-measured rate anchors and the Lp secular
+ *  completion act (full at the anchor, zero beyond). A recorded window of the
+ *  completion, not a law — the anchors were measured with it (plan 09 step
+ *  5c: it was written as the era unit's twelfth, H/12, "lattice-derived";
+ *  the value is kept bit-identical and named for what it is). */
+export const SECULAR_COMPLETION_TAPER_YEARS: 27943.083333333332;

package/types/moon/deep-modes-artifact.d.cts

@@ -151,11 +151,11 @@ export const DEEP_MODES_ARTIFACT: Readonly<{
             im: number;
         }[];
     };
-    anchorE: 0.016702435651957018;
-    anchorPeriEclipticDeg: 462.9179213996577;
+    anchorE: 0.016702435651957125;
+    anchorPeriEclipticDeg: 462.9179213996576;
     anchorInclEclipticDeg: 0.00010345820355474172;
     anchorAscNodeEclipticDeg: 140.29217988414328;
     anchorZDotPerYr: number[];
     slopeTaperYears: 27943.083333333332;
 }>;
-export const DEEP_MODES_ARTIFACT_HASH: "7633dd8f434fd6fc";
+export const DEEP_MODES_ARTIFACT_HASH: "87c325fac77d94a4";

package/types/moon/month-chain.d.cts

@@ -8,14 +8,9 @@
  *     gmEarthMoonM3PerS2: number,
  *     massRatioEarthMoon: number,
  *     moonSiderealMonthInputDays: number,
- *     holisticYearJ2000: number,
  *     meanSiderealYearJ2000Seconds: number,
- *     nApsidalOfDateJ2000: number,
- *     nNodalOfDateJ2000: number,
  *     moonApsidalJ2000Seconds: number,
  *     moonNodalJ2000Seconds: number,
- *     moonApsidalOfDateJ2000Seconds: number,
- *     moonNodalOfDateJ2000Seconds: number,
  *     moonSiderealMonthJ2000Seconds: number,
  *     sPerigee: number,
  *     sNode: number,
@@ -23,13 +18,18 @@
  *   fns: {
  *     meanLodSecondsAtAge: (tMa: number) => (number | null),
  *     meanSiderealYearSecondsAtAge: (tMa: number) => number,
- *     meanHAtAge: (tMa: number) => (number | null),
+ *     precessionPeriodYearsAtAge: (tMa: number) => (number | null),
  *     modulation: (tMa: number, s: number) => number,
  *     distanceMetresAtAge?: (tMa: number) => number,
  *   },
  * }} deps — fns are the ENGINE'S OWN layer-0/1 evaluators and the shared
  *   eccentricity channel's modulation; constants are the engine's derived
  *   J2000 anchors (both engines derive them from the same JSON).
+ *   fns.precessionPeriodYearsAtAge is the engine's lunisolar precession period
+ *   of date T_p(t), Julian years (the composed rate's period; plan 09 step
+ *   5c — the tropical month's equinox turn, formerly the counter's 13/H(t),
+ *   0.086 % slow: the chain's J2000 tropical month sat 5.85 ms above the IAU
+ *   input, the 1/T_p form is within 0.1 ms of it).
  *   fns.distanceMetresAtAge, when present, OVERRIDES the internal quartic —
  *   the Driver-1½ regime-aware history (recession-history.cjs); absent, the
  *   internal quartic is the pure twin (bit-identical for t ≤ jointMa).
@@ -43,14 +43,9 @@ export function createMoonMonthChain({ constants, fns }: {
         gmEarthMoonM3PerS2: number;
         massRatioEarthMoon: number;
         moonSiderealMonthInputDays: number;
-        holisticYearJ2000: number;
         meanSiderealYearJ2000Seconds: number;
-        nApsidalOfDateJ2000: number;
-        nNodalOfDateJ2000: number;
         moonApsidalJ2000Seconds: number;
         moonNodalJ2000Seconds: number;
-        moonApsidalOfDateJ2000Seconds: number;
-        moonNodalOfDateJ2000Seconds: number;
         moonSiderealMonthJ2000Seconds: number;
         sPerigee: number;
         sNode: number;
@@ -58,7 +53,7 @@ export function createMoonMonthChain({ constants, fns }: {
     fns: {
         meanLodSecondsAtAge: (tMa: number) => (number | null);
         meanSiderealYearSecondsAtAge: (tMa: number) => number;
-        meanHAtAge: (tMa: number) => (number | null);
+        precessionPeriodYearsAtAge: (tMa: number) => (number | null);
         modulation: (tMa: number, s: number) => number;
         distanceMetresAtAge?: (tMa: number) => number;
     };
@@ -70,10 +65,6 @@ export function createMoonMonthChain({ constants, fns }: {
     siderealMonthSecondsAtAge: (tMa: number) => number | null;
     synodicMonthSecondsAtAge: (tMa: number) => number | null;
     tropicalMonthSecondsAtAge: (tMa: number) => number | null;
-    apsidalCyclesOfDateAtAge: (tMa: number) => number | null;
-    nodalCyclesOfDateAtAge: (tMa: number) => number | null;
-    apsidalPrecessionSecondsOfDateAtAge: (tMa: number) => number | null;
-    nodalPrecessionSecondsOfDateAtAge: (tMa: number) => number | null;
     perigeePrecessionSecondsAtAge: (tMa: number) => number | null;
     nodePrecessionSecondsAtAge: (tMa: number) => number | null;
     anomalisticMonthSecondsAtAge: (tMa: number) => number | null;

package/types/moon/series.d.cts

@@ -12,7 +12,6 @@ export type MeeusTermTable = Array<[number, number, number, number, number]>;
  *     moonDistanceJ2000Km: number,
  *     j2000JD: number,
  *     julianCenturyDays: number,
- *     moonMeeusLpCorrectionDeg: number,
  *     fwA2RateDegPerCy: number,
  *     fwA3RateDegPerCy: number,
  *   },
@@ -26,7 +25,7 @@ export type MeeusTermTable = Array<[number, number, number, number, number]>;
  *     jdToSIyear: (jd: number) => number,
  *     tropicalOrbitsBetween: (yearA: number, yearB: number) => (number | null),
  *     apsidalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null),
- *     cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null),
+ *     siderealOrbitsBetween: (yearA: number, yearB: number) => (number | null),
  *     jupiterOrbitsBetween: (yearA: number, yearB: number) => (number | null),
  *     isDeepTime: () => boolean,
  *     isFrameworkNative: () => boolean,
@@ -46,7 +45,6 @@ export function createMoonSeries({ constants, fns }: {
         moonDistanceJ2000Km: number;
         j2000JD: number;
         julianCenturyDays: number;
-        moonMeeusLpCorrectionDeg: number;
         fwA2RateDegPerCy: number;
         fwA3RateDegPerCy: number;
     };
@@ -66,7 +64,7 @@ export function createMoonSeries({ constants, fns }: {
         jdToSIyear: (jd: number) => number;
         tropicalOrbitsBetween: (yearA: number, yearB: number) => (number | null);
         apsidalOfDateCyclesBetween: (yearA: number, yearB: number) => (number | null);
-        cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null);
+        siderealOrbitsBetween: (yearA: number, yearB: number) => (number | null);
         jupiterOrbitsBetween: (yearA: number, yearB: number) => (number | null);
         isDeepTime: () => boolean;
         isFrameworkNative: () => boolean;