@essrt/physics 4.9.0 → 6.0.0

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

@@ -33,4 +33,14 @@ export type RawEpochConstants = {
     moonDistanceKm: number;
     moonOrbitalEccentricity: number;
     gmEarthMoonSystemKm3S2: number;
+    /**
+     * GM☉ (km³/s²) — the solar precession torque
+     */
+    gmSunKm3S2: number;
+    /**
+     * 1 AU (km)
+     */
+    astronomicalUnitKm: number;
+    earthOrbitalEccentricityJ2000: number;
+    moonEclipticInclinationJ2000Deg: number;
 };

package/types/layer0/index.d.ts

@@ -37,13 +37,28 @@ export type EpochParams = {
     lodNowH13Seconds: number;
     siderealYearJ2000Seconds: number;
     solarMassLossFracPerYear: number;
+    /**
+     * f_S, the solar fraction of the J2000 precession torque
+     */
+    precessionSolarShareJ2000: 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
+     */
+    eraClockTropicalYearSeconds: (year: number) => number;
 };

package/types/model.d.ts

@@ -34,10 +34,44 @@ export function assembleModel(C: Readonly<Record<string, any>>, F: Readonly<Reco
         deltaTSecondsAtYear: (year: number) => number;
         cyclesBetween: (yearA: number, yearB: number, divisorN: number) => number;
         axialPrecessionYearsAtYear: (year: number) => number;
+        tropicalYearSecondsAtYear: (year: number) => number;
+    }>;
+    lunisolar: Readonly<{
+        /** The mean lunisolar precession period T_p(t), years — the composed torque rate's period on the derived J2000 anchor (25,771.4 at J2000). @param {number} year @returns {number} */
+        meanPeriodYearsAtYear: (year: number) => number;
+        /** The composed rate ψ̇(t) = [ω/ω₀]·p₀·[f_S + (1 − f_S)(a₀/a_M)³], ″/yr (p₀ = 50.2883, derived). @param {number} year @returns {number} */
+        meanRateArcsecPerYrAtYear: (year: number) => number;
+        /** The of-date period — the one-family beat inside ±2 Myr, the composed mean beyond. @param {number} year @returns {number} */
+        ofDatePeriodYearsAtYear: (year: number) => number;
+        /** f_S, the solar fraction of the J2000 precession torque. */
+        solarShareJ2000: number;
+        /** (a₀/a_M(t))³ — the lunar torque's growth on the recession history. @param {number} year @returns {number} */
+        lunarTorqueFactorAtYear: (year: number) => number;
+        /** f_S + (1 − f_S)(a₀/a_M)³ — the torque term the unit divides H_era by. @param {number} year @returns {number} */
+        torqueTermAtYear: (year: number) => number;
+        /** The hybrid's precession constant α = p₀ / cos ε₀, ″/yr (p₀ the derived J2000 rate, ε₀ the J2000 obliquity input; 54.81). */
+        torqueConstantJ2000ArcsecPerYr: number;
+        /** |s₃|, the dominant nodal mode of Earth's orbit — the largest-amplitude ζ mode of the banked deep secular modes, ″/yr (18.85; the obliquity beat's partner). ONE home for the registry, the browser and the API. */
+        nodalModeS3ArcsecPerYr: number;
+        /** The ecliptic (nodal) precession period 1,296,000/|s₃|, years (68,751) — an orbital quantity, fixed at every epoch at the two-body level. */
+        nodalPeriodYears: number;
+        /** The obliquity beat 2π/(ψ̇(t) − |s₃|), years — the SHIPPED deep-time obliquity period (falsification leg 1; 41,224 at J2000, on the composed rate). @param {number} year @returns {number} */
+        obliquityBeatYearsAtYear: (year: number) => number;
+        /** The apsidal (perihelion vs the stars) period from the engine-D chain's secular tangent, years — inside the published window only (the tangent is an extrapolation beyond the banked series: it turns negative at −5 Myr); null beyond. @param {number} year @returns {number|null} */
+        apsidalPeriodYearsAtYear: (year: number) => number | null;
+        /** T_aps(t) / T_p(t) — the apsidal period in of-date precession periods (4.33 at J2000, a reading; 0.84 … 9.9 across ±26 kyr, measured); null beyond the published window. @param {number} year @returns {number|null} */
+        apsidalPerPrecessionAtYear: (year: number) => number | null;
+        /** T_peri(t) = 1/(1/T_p + 1/T_aps) — the perihelion-of-date period (equinox precession + inertial perihelion motion, frame arithmetic at every epoch), years, on the of-date T_p; null beyond the published window. @param {number} year @returns {number|null} */
+        periOfDatePeriodYearsAtYear: (year: number) => number | null;
+        /** T_peri(t) / T_p(t) (0.812 at J2000 — the J2000 reading); null beyond the published window. @param {number} year @returns {number|null} */
+        periOfDatePerPrecessionAtYear: (year: number) => number | null;
+        /** The published of-date window, years from 2000. */
+        publishedWindowYears: 2000000;
     }>;
     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;