@essrt/physics 23.3.2 → 23.6.0

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

@@ -27,14 +27,14 @@ export type DeepTimeLodConstants = {
      */
     alpha1PerMa: number;
     /**
-     * - ω₀, the J2000 day length (the SI day since plan 09; identifier kept)
+     * - ω₀, the J2000 day length (the SI day; identifier kept)
      */
     lodNowH13Seconds: number;
     meanSiderealYearJ2000Seconds: number;
     solarMassLossFracPerYear: number;
     /**
      * - f_S, the solar fraction of the J2000
-     * precession torque (derive-params) — the unit H(t) = 13·T_p,composed needs it
+     * precession torque (derive-params) — the composed precession rate needs it
      */
     precessionSolarShareJ2000: number;
 };
@@ -61,10 +61,9 @@ export type DeepTimeLodDeps = {
      */
     swingLodRateAt: (year: number) => number;
     /**
-     * - the model's DERIVED
-     * J2000 axial precession period: the certified year-length laws' beat at
-     * 2000, sid/(sid − trop) ≈ 25,771.4 yr (plan 06 S5 — one J2000 precession
-     * reading; the same anchor the hybrid obliquity self-anchors on). Read
+     * - the model's J2000 axial
+     * precession period, 1,296,000/p_A = 25,771.575 yr (the IAU 2006 general
+     * precession; the same anchor the hybrid obliquity self-anchors on). Read
      * LAZILY on the first composed-rate use, never at construction: every
      * runtime's year laws read THIS factory's bases.
      */
@@ -74,16 +73,14 @@ export type DeepTimeLodDeps = {
      * plane's nodal regression on the invariable plane, 1,296,000/|s₃| with s₃
      * the dominant ζ mode of the banked deep secular modes (≈ 68,751 yr). An
      * ORBITAL quantity (μ-tier: it does not follow Earth's spin), the reference
-     * the solar day's "ecliptic missing motion" term rides (plan 06 T2 item —
-     * formerly the spin unit's H/5, 67,063 yr, 2.5 % off and scaling with the
-     * spin at deep time). Lazy, like the precession anchor.
+     * the solar day's "ecliptic missing motion" term rides. Lazy, like the
+     * precession anchor.
      */
     nodalPeriodYearsFn: () => number;
     /**
      * - OPTIONAL time-dependent
      * Earth-Moon angular momentum. Absent → the J2000 constant: conservation
-     * (plan 12 option A — the Driver-1½ solar-channel budget is deleted;
-     * measured: conservation on the cited history reproduces Farhat's own LOD
+     * (measured: conservation on the cited history reproduces Farhat's own LOD
      * to 0.01 h at 100 Ma, 0.14 h at 2.46 Ga).
      */
     lEmAtAgeKgm2S?: ((tMa: number) => number) | undefined;
@@ -98,7 +95,7 @@ export type DeepTimeLodDeps = {
      * -
      * OPTIONAL cos ε̄(t)/cos ε̄(0) of the cited mean obliquity (earth/mean-
      * obliquity-history) — the factor the precession RATE of date carries on the
-     * constant (plan 12 §8 option (a)); absent → 1, the constant alone, bit-identical.
+     * constant; absent → 1, the constant alone, bit-identical.
      */
     meanObliquityCosRatioAtAge?: ((tMa: number) => number | null) | undefined;
 };
@@ -113,11 +110,11 @@ export type DeepTimeLodDeps = {
  * @property {number} aLockMetres - tidal-lock distance (LOD denominator → 0)
  * @property {number} aMoonNowMetres - Farhat polynomial anchor
  * @property {number} alpha1PerMa - the LLR recession rate (the J2000 slope of the cited history)
- * @property {number} lodNowH13Seconds - ω₀, the J2000 day length (the SI day since plan 09; identifier kept)
+ * @property {number} lodNowH13Seconds - ω₀, the J2000 day length (the SI day; identifier kept)
  * @property {number} meanSiderealYearJ2000Seconds
  * @property {number} solarMassLossFracPerYear
  * @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
+ *   precession torque (derive-params) — the composed precession rate needs it
  */
 /**
  * @typedef {Object} DeepTimeLodDeps
@@ -127,23 +124,20 @@ export type DeepTimeLodDeps = {
  * @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
- * @property {() => number} precessionPeriodJ2000YearsFn - the model's DERIVED
- *   J2000 axial precession period: the certified year-length laws' beat at
- *   2000, sid/(sid − trop) ≈ 25,771.4 yr (plan 06 S5 — one J2000 precession
- *   reading; the same anchor the hybrid obliquity self-anchors on). Read
+ * @property {() => number} precessionPeriodJ2000YearsFn - the model's J2000 axial
+ *   precession period, 1,296,000/p_A = 25,771.575 yr (the IAU 2006 general
+ *   precession; the same anchor the hybrid obliquity self-anchors on). Read
  *   LAZILY on the first composed-rate use, never at construction: every
  *   runtime's year laws read THIS factory's bases.
  * @property {() => number} nodalPeriodYearsFn - the period of Earth's orbit
  *   plane's nodal regression on the invariable plane, 1,296,000/|s₃| with s₃
  *   the dominant ζ mode of the banked deep secular modes (≈ 68,751 yr). An
  *   ORBITAL quantity (μ-tier: it does not follow Earth's spin), the reference
- *   the solar day's "ecliptic missing motion" term rides (plan 06 T2 item —
- *   formerly the spin unit's H/5, 67,063 yr, 2.5 % off and scaling with the
- *   spin at deep time). Lazy, like the precession anchor.
+ *   the solar day's "ecliptic missing motion" term rides. Lazy, like the
+ *   precession anchor.
  * @property {(tMa: number) => number} [lEmAtAgeKgm2S] - OPTIONAL time-dependent
  *   Earth-Moon angular momentum. Absent → the J2000 constant: conservation
- *   (plan 12 option A — the Driver-1½ solar-channel budget is deleted;
- *   measured: conservation on the cited history reproduces Farhat's own LOD
+ *   (measured: conservation on the cited history reproduces Farhat's own LOD
  *   to 0.01 h at 100 Ma, 0.14 h at 2.46 Ga).
  * @property {(tMa: number) => number|null} [moonDistanceSlopeMetresPerMaAtAge] -
  *   OPTIONAL analytic slope of the distance history (metres per Ma, positive
@@ -152,7 +146,7 @@ export type DeepTimeLodDeps = {
  * @property {(tMa: number) => number|null} [meanObliquityCosRatioAtAge] -
  *   OPTIONAL cos ε̄(t)/cos ε̄(0) of the cited mean obliquity (earth/mean-
  *   obliquity-history) — the factor the precession RATE of date carries on the
- *   constant (plan 12 §8 option (a)); absent → 1, the constant alone, bit-identical.
+ *   constant; absent → 1, the constant alone, bit-identical.
  */
 /** @param {DeepTimeLodDeps} deps */
 export function createDeepTimeLod(deps: DeepTimeLodDeps): {

package/types/index.d.ts

@@ -66,7 +66,7 @@ export { computeMassChainJ2000, computeMoonPeriodsJ2000 } from "./earth/mass-cha
 export { SECONDS_PER_DAY, DAYS_PER_JULIAN_YEAR, JULIAN_CENTURY_DAYS, SECONDS_PER_JULIAN_YEAR } from "./constants/units.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 { buildPlanetChainsFromArtifactData, computePlanetElementsAtYear, computeHeliocentricEclipticFromElements, computePoissonArgRad, computeOsculatingElements, solveKeplerRad, computeApsidalSecularDegPerYr, computeApsidalSecularDegPerYr as computeApsidalTangentDegPerYr, 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";

package/types/model/cardinal-instants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cardinal instants — the apparent Sun (completed, aberrated, nutated) and the Newton crossings.
+ *
+ * One slice of `assembleModel` (../model.js): receives the context the earlier slices built, returns the bindings the later ones read.
+ */
+/** @param {import('./published-periods.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleCardinalInstants(ctx: import("./published-periods.js").Ctx): {
+    cardinalCrossingJdUT: (year: number, type: string) => number;
+    cardinalCrossingNearJdUT: (jdSeedUT: number, type: string) => number;
+    cardinalTargetDeg: (type: string) => number;
+    sunAberrationArcsecAt: (year: number) => number;
+    sunApparentLonDegAtJdUT: (jdUT: number) => number;
+};
+export type Ctx = import("./published-periods.js").Ctx & ReturnType<typeof assembleCardinalInstants>;

package/types/model/context.d.ts

@@ -0,0 +1,87 @@
+/**
+ * RESEARCH OVERRIDES for Earth's orbit laws (doc 109 §7): an alternative e(t), de/dt(t) and
+ * ϖ_of-date(t) flow through every consumer (the eclipse Sun, the Moon's E-factor, the cardinal
+ * points) exactly as the shipped laws do. `{}` = the shipped laws. Not a counterfactual in the §2d
+ * sense (no hash change) — callers must say when they used it; the generators refuse to --write
+ * under an override.
+ */
+export type Laws = {
+    eccentricityAt?: (year: number) => number;
+    eccentricityRateAt?: (year: number) => number;
+    perihelionLongitudeDegAt?: (year: number) => number;
+};
+/**
+ * `giaEllipticityOfDate: false` builds the one-source history WITHOUT the J₂(t)/J₂₀ factor of date
+ * (the ice-driven GIA channel, which rides the climate formula's own post-MPT layer): the orbital
+ * FORCING alone. The T1 exporter derives the climate lines' obliquity rate on it, so the lines
+ * cannot depend on their own fit (v23.0; measured 3e-5 of the rate, 2–3 yr of period). Default true =
+ * the shipped physics.
+ */
+export type Options = {
+    giaEllipticityOfDate?: boolean;
+};
+/**
+ * The forward bindings — what an early slice reads at call time from a later one. Typed by the
+ * members actually read, so the composer's assignment is checked against each owner's surface.
+ */
+export type LateBindings = {
+    /**
+     * owner: year-day-lengths — read by deep-time-chain
+     */
+    certifiedAxialPrecessionJ2000Years: () => number;
+    /**
+     * owner: one-source-movement — read by deep-time-chain and earth-scalars
+     */
+    oneSourceM: {
+        epsAt(year: number): number;
+        eAt(year: number): number;
+        periOfDateDegAt(year: number): number;
+        precessionOfDateFactorsAt(year: number): {
+            solarTorque: number;
+            ellipticity: number;
+        };
+        axialPrecessionYearsLunisolarJ2000: number;
+    };
+    /**
+     * owner: one-source-movement — read by year-day-lengths
+     */
+    yearLengthsM: {
+        anomalisticYearSecondsAtYear(year: number): number;
+    };
+    /**
+     * owner: sun-and-eclipses — read by lunar-theory (the arguments' Sun)
+     */
+    sunMeanLongitudeDegAt: (year: number) => number;
+    /**
+     * owner: published-periods — read by lunar-theory (the dynamical rate of date)
+     */
+    publishedAxialPrecessionYearsAtYear: (year: number) => number;
+    /**
+     * owner: published-periods — read by year-day-lengths
+     */
+    publishedSiderealYearSecondsAtYear: (year: number) => number;
+    /**
+     * owner: cardinal-instants — read by sun-and-eclipses (the besselian's apparent Sun)
+     */
+    sunAberrationArcsecAt: (year: number) => number;
+};
+/**
+ * The composer's inputs — the first slice's context.
+ */
+export type ModelInputs = {
+    /**
+     * the frozen constants context
+     */
+    C: Readonly<Record<string, any>>;
+    /**
+     * the fitted coefficients
+     */
+    F: Readonly<Record<string, any>>;
+    laws: Laws;
+    /**
+     * the governed N-body secular series (the API/Node path; null for the bare package)
+     */
+    secularSeriesArtifact: any;
+    options: Options;
+    late: LateBindings;
+};

package/types/model/deep-time-chain.d.ts

@@ -0,0 +1,288 @@
+/** @param {import('./derived-constants.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleDeepTimeChain(ctx: import("./derived-constants.js").Ctx): {
+    EPOCH_PARAMS: import("../layer0/index.js").EpochParams;
+    alphaGia: {
+        alphaAt: (year: number) => number;
+        j2RatioAt: (year: number) => number;
+        laggedL1PermilAt: (year: number) => number;
+        kPerPermille: number;
+        relaxationKyr: number;
+        laggedL1Terms: Array<{
+            period_kyr: number;
+            a: number;
+            b: number;
+        }>;
+    };
+    chain: Readonly<{
+        meanSolarYearDays: number;
+        meanSiderealYearDays: any;
+        meanSiderealYearSeconds: number;
+        meanLengthOfDay: any;
+        meanTropicalYearJ2000Seconds: number;
+        siTropicalYearDays: number;
+        axialPrecessionJ2000Years: number;
+        axialPrecessionJ2000Days: number;
+        G_CONSTANT: any;
+        MASS_RATIO_EARTH_MOON: any;
+        currentAUDistance: any;
+        earthMoiFactorJ2000: any;
+        moonDistanceKm: any;
+        moonSiderealMonthInput: any;
+        moonOrbitalShift: number;
+        moonDistanceCorrected: number;
+        GM_EARTH_MOON_SYSTEM: number;
+        GM_EARTH_ALONE: number;
+        GM_MOON_ALONE: number;
+        GM_SUN_PLUS_EARTH: number;
+        GM_SUN: number;
+        M_SUN: number;
+        moonApsidalJ2000Seconds: number;
+        moonNodalJ2000Seconds: number;
+        moonSiderealMonthJ2000Seconds: number;
+        moonPeriods: {
+            moonApsidalPrecessionDaysEarth: number;
+            moonNodalPrecessionDaysEarth: number;
+            moonApsidalJ2000Seconds: number;
+            moonNodalJ2000Seconds: number;
+            moonSiderealMonthJ2000Seconds: number;
+            moonAnomalisticMonthDays: number;
+            moonNodalMonthDays: number;
+            moonSynodicMonthDays: number;
+            moonTropicalMonthDays: number;
+            moonFullMoonCycleEarthDays: number;
+            moonFullMoonCycleICRFDays: number;
+            moonApsidalMeetsNodalDays: number;
+            moonLunarLevelingCycleDays: number;
+            moonDraconicYearICRFDays: number;
+            moonDraconicYearEarthDays: number;
+        };
+        certifiedAxialPrecessionJ2000Years: () => number;
+        precessionRateJ2000ArcsecPerYr: () => number;
+        EPOCH_PARAMS: import("../layer0/index.js").EpochParams;
+        ageAnchorYear: any;
+        alphaGia: {
+            alphaAt: (year: number) => number;
+            j2RatioAt: (year: number) => number;
+            laggedL1PermilAt: (year: number) => number;
+            kPerPermille: number;
+            relaxationKyr: number;
+            laggedL1Terms: Array<{
+                period_kyr: number;
+                a: number;
+                b: number;
+            }>;
+        };
+        earthMoiFactorAtAge: (tMa: number) => number;
+        withLatticeAlpha: (build: () => void) => void;
+        j2RatioAtYear: (year: number) => number;
+        iEarthAtAge: (tMa: number) => number;
+        recession: {
+            distanceMetresAtAge: (tMa: number) => number | null;
+            slopeMetresPerMaAtAge: (tMa: number) => number | null;
+            ratioAtAge: (tMa: number) => number | null;
+            spanMa: number;
+        };
+        meanObliquity: {
+            meanObliquityDegAtAge: (tMa: number) => number | null;
+            cosRatioAtAge: (tMa: number) => number | null;
+            meanObliquityJ2000Deg: number;
+            spanMa: number;
+        };
+        dtCycles: {
+            taperAt: (year: number) => number;
+            taperDerivativeAt: (year: number) => number;
+            cycleDeltaTSecondsAt: (cycleKey: string, year: number) => number;
+            cycleLodSecondsAt: (cycleKey: string, year: number) => number;
+            swingDeltaTSecondsAt: (year: number) => number;
+            swingLodSecondsAt: (year: number) => number;
+            swingLodRateAt: (year: number) => number;
+        };
+        s3ArcsecPerYr: number;
+        deepLod: {
+            lodSecondsAtAge: (t_Ma: number) => number | null;
+            lodSecondsAtAgeWithAlpha: (t_Ma: number, alpha: number) => number | null;
+            lodHoursAtAge: (t_Ma: number) => number | null;
+            lunisolarPrecessionRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+            lunisolarPrecessionPeriodYearsAtAge: (t_Ma: number) => number | null;
+            lunisolarTorqueRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+            lunisolarTorquePeriodYearsAtAge: (t_Ma: number) => number | null;
+            precessionObliquityFactorAtAge: (t_Ma: number) => number | null;
+            lunarTorqueFactorAtAge: (tMa: number) => (number | null);
+            precessionTorqueTermAtAge: (tMa: number) => (number | null);
+            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;
+            dLodDtDecompositionAtAge: (t_Ma: number) => {
+                tidal: number | null;
+                gia: number | null;
+                stack: number | null;
+                resonator: number | null;
+                net_L2: number | null;
+                net_L3: number | null;
+                net_L4: number | null;
+            };
+        };
+        l0: import("../layer0/index.js").EpochPrimitives;
+        deepEcc: {
+            eccAt: (tYr: number) => number;
+            eccRateAt: (tYr: number) => number;
+            modulation: (tMa: number, s: number) => number;
+            channelIntegral: (T: number, s: number) => number;
+            eFactorAt: (tYr: number) => number;
+            e0: number;
+            g0: number;
+        };
+        eCompModulation: (tMa: number, s: number) => number;
+        moonChain: {
+            distanceMetresAtAge: (tMa: number) => number | null;
+            distanceKmAtAge: (tMa: number) => number | null;
+            solarDeltaAKmAtAge: (tMa: number, aApparentKm: number) => number | null;
+            distanceCorrectedKmAtAge: (tMa: number) => number | null;
+            siderealMonthSecondsAtAge: (tMa: number) => number | null;
+            synodicMonthSecondsAtAge: (tMa: number) => number | null;
+            tropicalMonthSecondsAtAge: (tMa: number) => number | null;
+            perigeePrecessionSecondsAtAge: (tMa: number) => number | null;
+            nodePrecessionSecondsAtAge: (tMa: number) => number | null;
+            anomalisticMonthSecondsAtAge: (tMa: number) => number | null;
+            nodalMonthSecondsAtAge: (tMa: number) => number | null;
+            apsidalMeetsNodalSecondsAtAge: (tMa: number) => number | null;
+            lunarLevelingSecondsAtAge: (tMa: number) => number | null;
+        };
+        meanMoonDistanceMetresAtAge: (tMa: number) => number | null;
+        meanMoonDistanceAtAge: (tMa: number) => number | null;
+        meanLodSecondsAtAge: (tMa: number) => number | null;
+        meanLodHoursAtAge: (t_Ma: number) => number | null;
+        meanLunisolarPrecessionRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+        meanLunisolarPrecessionPeriodYearsAtAge: (tMa: number) => number | null;
+        meanLunisolarTorqueRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+        meanLunisolarTorquePeriodYearsAtAge: (t_Ma: number) => number | null;
+        precessionObliquityFactorAtAge: (t_Ma: number) => number | null;
+        meanObliquityCitedDegAtAge: (tMa: number) => number | null;
+        meanAuAtAge: (tMa: number) => number;
+        meanSiderealYearSecondsAtAge: (tMa: number) => number;
+        meanTropicalYearSecondsAtAge: (t_Ma: number) => number;
+        meanTropicalYearDaysAtAge: (t_Ma: number) => number | null;
+        meanYearInDaysAtAge: (t_Ma: number) => number | null;
+        meanDeltaTSecondsAtAge: (tMa: number) => number;
+        bondCycleDeltaTCorrection: (year: number) => number;
+        hallstattCycleDeltaTCorrection: (year: number) => number;
+        jose5CycleDeltaTCorrection: (year: number) => number;
+        jose4CycleDeltaTCorrection: (year: number) => number;
+        bondCycleLodCorrection: (year: number) => number;
+        hallstattCycleLodCorrection: (year: number) => number;
+        jose5CycleLodCorrection: (year: number) => number;
+        jose4CycleLodCorrection: (year: number) => number;
+        dtCycleLodCorrectionSum: (year: number) => number;
+        resonatorSwingDeltaTCorrection: (year: number) => number;
+        resonatorSwingLodCorrection: (year: number) => number;
+        resonatorSwingLodRate: (year: number) => number;
+        meanLodSecondsWithCorrectionsAtAge: (t_Ma: number) => number | null;
+        dLodDtDecompositionAtAge: (t_Ma: number) => {
+            tidal: number | null;
+            gia: number | null;
+            stack: number | null;
+            resonator: number | null;
+            net_L2: number | null;
+            net_L3: number | null;
+            net_L4: number | null;
+        };
+        h5Correction: (year: number) => number;
+        computeLodKinematicSecondsAtEpoch: (year: number) => number;
+        computeLodRealSecondsAtEpoch: (year: number) => number;
+        meanSolarDeltaAAtAge: (tMa: number, aApparentKm: number) => number | null;
+        meanMoonDistanceCorrectedAtAge: (tMa: number) => number | null;
+        meanMoonSiderealMonthAtAge: (tMa: number) => number | null;
+        meanSynodicMonthAtAge: (tMa: number) => number | null;
+        meanTropicalMonthAtAge: (tMa: number) => number | null;
+        meanLunarPerigeePrecessionAtAge: (tMa: number) => number | null;
+        meanLunarNodePrecessionAtAge: (tMa: number) => number | null;
+        meanAnomalisticMonthAtAge: (tMa: number) => number | null;
+        meanNodalMonthAtAge: (tMa: number) => number | null;
+        meanApsidalMeetsNodalAtAge: (tMa: number) => number | null;
+        meanLunarLevelingCycleAtAge: (tMa: number) => number | null;
+        meanStellarDayAtAge: (tMa: number) => number | null;
+        meanStellarDayProjectedAtAge: (tMa: number) => number | null;
+        meanSiderealDayAtAge: (tMa: number) => number | null;
+        meanPlanetSemiMajorAxisAtAge: (planetName: string, tMa: number) => number | null;
+        meanPlanetOrbitalPeriodAtAge: (tMa: number, periodJ2000Seconds: number) => number;
+        meanEarthPlanetSynodicPeriodAtAge: (tMa: number, periodJ2000Seconds: number) => number;
+    }>;
+    deepEcc: {
+        eccAt: (tYr: number) => number;
+        eccRateAt: (tYr: number) => number;
+        modulation: (tMa: number, s: number) => number;
+        channelIntegral: (T: number, s: number) => number;
+        eFactorAt: (tYr: number) => number;
+        e0: number;
+        g0: number;
+    };
+    deepLod: {
+        lodSecondsAtAge: (t_Ma: number) => number | null;
+        lodSecondsAtAgeWithAlpha: (t_Ma: number, alpha: number) => number | null;
+        lodHoursAtAge: (t_Ma: number) => number | null;
+        lunisolarPrecessionRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+        lunisolarPrecessionPeriodYearsAtAge: (t_Ma: number) => number | null;
+        lunisolarTorqueRateArcsecPerYrAtAge: (t_Ma: number) => number | null;
+        lunisolarTorquePeriodYearsAtAge: (t_Ma: number) => number | null;
+        precessionObliquityFactorAtAge: (t_Ma: number) => number | null;
+        lunarTorqueFactorAtAge: (tMa: number) => (number | null);
+        precessionTorqueTermAtAge: (tMa: number) => (number | null);
+        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;
+        dLodDtDecompositionAtAge: (t_Ma: number) => {
+            tidal: number | null;
+            gia: number | null;
+            stack: number | null;
+            resonator: number | null;
+            net_L2: number | null;
+            net_L3: number | null;
+            net_L4: number | null;
+        };
+    };
+    dtCycleLodCorrectionSum: (year: number) => number;
+    dtCycles: {
+        taperAt: (year: number) => number;
+        taperDerivativeAt: (year: number) => number;
+        cycleDeltaTSecondsAt: (cycleKey: string, year: number) => number;
+        cycleLodSecondsAt: (cycleKey: string, year: number) => number;
+        swingDeltaTSecondsAt: (year: number) => number;
+        swingLodSecondsAt: (year: number) => number;
+        swingLodRateAt: (year: number) => number;
+    };
+    earthMoiFactorAtAge: (tMa: number) => number;
+    evalClimateL1: (year: number) => number;
+    moonChain: {
+        distanceMetresAtAge: (tMa: number) => number | null;
+        distanceKmAtAge: (tMa: number) => number | null;
+        solarDeltaAKmAtAge: (tMa: number, aApparentKm: number) => number | null;
+        distanceCorrectedKmAtAge: (tMa: number) => number | null;
+        siderealMonthSecondsAtAge: (tMa: number) => number | null;
+        synodicMonthSecondsAtAge: (tMa: number) => number | null;
+        tropicalMonthSecondsAtAge: (tMa: number) => number | null;
+        perigeePrecessionSecondsAtAge: (tMa: number) => number | null;
+        nodePrecessionSecondsAtAge: (tMa: number) => number | null;
+        anomalisticMonthSecondsAtAge: (tMa: number) => number | null;
+        nodalMonthSecondsAtAge: (tMa: number) => number | null;
+        apsidalMeetsNodalSecondsAtAge: (tMa: number) => number | null;
+        lunarLevelingSecondsAtAge: (tMa: number) => number | null;
+    };
+    moonDistanceKmAtYearOrNaN: (year: number) => number;
+    moonDistanceMetresAtAge: (tMa: number) => number | null;
+    s3ArcsecPerYr: number;
+    spinAxisInertialRateMeanArcsecPerYr: (yearFrom: number, yearTo: number, stepYears?: number, opts?: {
+        ellipticity?: boolean;
+    }) => number;
+    yearToTMa: (year: number) => number;
+};
+export type Ctx = import("./derived-constants.js").Ctx & ReturnType<typeof assembleDeepTimeChain>;

package/types/model/delta-t.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ΔT (TT − UT1) — the raw integral plus the cycle stack, memoized on the exact argument.
+ *
+ * One slice of `assembleModel` (../model.js): receives the context the earlier slices built, returns the bindings the later ones read.
+ */
+/** @param {import('./moon-epoch.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleDeltaT(ctx: import("./moon-epoch.js").Ctx): {
+    deltaTSeconds: (year: number) => number;
+    meanDeltaTSecondsAtAge: (tMa: number) => number;
+};
+export type Ctx = import("./moon-epoch.js").Ctx & ReturnType<typeof assembleDeltaT>;

package/types/model/derived-constants.d.ts

@@ -0,0 +1,25 @@
+/** @param {import('./context.js').ModelInputs} ctx @returns the bindings the later slices read */
+export function assembleDerivedConstants(ctx: import("./context.js").ModelInputs): {
+    GM_EARTH_ALONE: number;
+    GM_EARTH_MOON_SYSTEM: number;
+    GM_MOON_ALONE: number;
+    GM_SUN: number;
+    GM_SUN_PLUS_EARTH: number;
+    G_CONSTANT: any;
+    MASS_RATIO_EARTH_MOON: any;
+    M_SUN: number;
+    axialPrecessionJ2000Days: number;
+    currentAUDistance: any;
+    meanLengthOfDay: any;
+    meanSiderealYearDays: any;
+    meanSolarYearDays: number;
+    meanTropicalYearJ2000Seconds: number;
+    moonDistanceCorrected: number;
+    moonDistanceKm: any;
+    moonOrbitalShift: number;
+    moonSiderealMonth: any;
+    moonSiderealMonthInput: any;
+    startmodelJD: any;
+    startmodelYear: any;
+};
+export type Ctx = import("./context.js").ModelInputs & ReturnType<typeof assembleDerivedConstants>;

package/types/model/earth-scalars.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Earth scalars of date — e, ϖ, ε read from the one-source movement; the eclipse Sun's mean elements (the research `laws` hook).
+ *
+ * One slice of `assembleModel` (../model.js): receives the context the earlier slices built, returns the bindings the later ones read.
+ */
+/** @param {import('./deep-time-chain.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleEarthScalars(ctx: import("./deep-time-chain.js").Ctx): {
+    earthPerihelionDeg: (year: number) => number;
+    eccentricityAt: (year: number) => number;
+    obliquityDeg: (year: number) => number;
+    sunEccentricityAt: (year: number) => any;
+    sunPerihelionDegAt: (year: number) => number;
+};
+export type Ctx = import("./deep-time-chain.js").Ctx & ReturnType<typeof assembleEarthScalars>;

package/types/model/inv-plane-elements.d.ts

@@ -0,0 +1,6 @@
+/** @param {import('./planet-elements-of-date.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleInvPlaneElements(ctx: import("./planet-elements-of-date.js").Ctx): {
+    ascendingNodeDeg: (year: number) => number;
+    inclinationDeg: (year: number) => number;
+};
+export type Ctx = import("./planet-elements-of-date.js").Ctx & ReturnType<typeof assembleInvPlaneElements>;

package/types/model/lunar-theory.d.ts

@@ -0,0 +1,72 @@
+/** @param {import('./time-axis.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleLunarTheory(ctx: import("./time-axis.js").Ctx): {
+    frameworkDeltaTSecondsAtJD: (jd: number) => number;
+    j2000JD: number;
+    jdTTFromUT: (jd: number) => number;
+    julianCenturyDays: number;
+    moonArgs: {
+        argsAt: (jdTT: number) => MoonArgsDeg;
+        fwArgs: (jdTT: number) => MoonArgsDeg;
+        fwArgsDeep: (jd: number) => MoonArgsDeg | null;
+        pureMeeusArgs: (jdTT: number) => MoonArgsDeg;
+        planetaryCarrier: (T: number) => number;
+        obliquityCarrier: (T: number) => number;
+        lpSecularCompletion: (T: number) => number;
+        bundle: {
+            LP0: number;
+            D0: number;
+            M0: number;
+            MP0: number;
+            F0: number;
+            LPR: number;
+            DR: number;
+            MR: number;
+            WDOT: number;
+            NDOT: number;
+            T2_W: number;
+            T2_N: number;
+            T3_W: number;
+            T3_N: number;
+            T2_LP: number;
+            T2_LP_TIDAL: number;
+            S_W: number;
+            S_N: number;
+        };
+        _rateCompletion: () => {
+            rc: {
+                ok: boolean;
+                pFix: (dyYears: number) => number;
+                pdSlopeDegPerCy2: number;
+            };
+            anchors: {
+                ok: boolean;
+                Lp: number;
+                w: number;
+                om: number;
+                Lsun: number;
+                ws: number;
+                Tq: number;
+            };
+        };
+    };
+    moonSeries: {
+        sceneEvalAt: (dDaysTT: number) => {
+            thetaAddRad: number;
+            lonDeg: number;
+            latRad: number;
+            latDeg: number;
+            distKm: number;
+            T: number;
+        };
+        truncatedLonDeg: (jdUT: number) => number;
+        truncatedBetaDeg: (jdUT: number) => number;
+        truncatedDistanceKm: (jdUT: number) => number;
+        additionalArgs: (T: number, dDaysTT: number) => {
+            A1: number;
+            A2: number;
+            A3: number;
+        };
+    };
+    moonSynodicMonthDays: number;
+};
+export type Ctx = import("./time-axis.js").Ctx & ReturnType<typeof assembleLunarTheory>;

package/types/model/moon-epoch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Moon at epoch — the solar-Δa-corrected Kepler month.
+ *
+ * One slice of `assembleModel` (../model.js): receives the context the earlier slices built, returns the bindings the later ones read.
+ */
+/** @param {import('./one-source-movement.js').Ctx} ctx @returns the bindings the later slices read */
+export function assembleMoonEpoch(ctx: import("./one-source-movement.js").Ctx): {
+    moonSiderealMonthDaysAt: (year: number) => number;
+};
+export type Ctx = import("./one-source-movement.js").Ctx & ReturnType<typeof assembleMoonEpoch>;