@essrt/physics 4.8.0 → 4.9.0

package/types/moon/arguments.d.cts

@@ -0,0 +1,138 @@
+export type MoonArgsDeg = {
+    Lp: number;
+    D: number;
+    M: number;
+    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,
+ *     elpEarthFigureJ2ArcsecPerCy2: number,
+ *     elpGeneralPrecessionPA_T2ArcsecPerCy2: number,
+ *     eccE0: number,
+ *   },
+ *   fns: {
+ *     eccAt: (tYr: number) => number,
+ *     channelIntegral: (T: number, s: number) => number,
+ *     computeObliquityEarth: (year: 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,
+ *     pKinDegPerYearAt?: (year: number) => number,
+ *   },
+ * }} deps — fns are the ENGINE'S OWN chain wrappers (each engine's toggle
+ *   semantics ride along); eccAt/channelIntegral are the shared moon ecc
+ *   channel; constants are J2000-frozen injections. The OPTIONAL precession
+ *   pair powers the (d′) of-date rate completion: pDyn = the DYNAMICAL
+ *   axial precession (day-form beat of the engine's sidereal/solar year
+ *   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).
+ */
+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;
+        elpEarthFigureJ2ArcsecPerCy2: number;
+        elpGeneralPrecessionPA_T2ArcsecPerCy2: number;
+        eccE0: number;
+    };
+    fns: {
+        eccAt: (tYr: number) => number;
+        channelIntegral: (T: number, s: number) => number;
+        computeObliquityEarth: (year: 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;
+        pKinDegPerYearAt?: (year: number) => number;
+    };
+}): {
+    argsAt: (jdTT: number) => MoonArgsDeg;
+    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;
+    bundle: {
+        LP0: number;
+        D0: number;
+        M0: number;
+        MP0: number;
+        F0: number;
+        LPR: number;
+        DR: number;
+        MR: number;
+        P_DEGCY: 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;
+        };
+    };
+};
+/**
+ * Astronomical JD → decimal year: Julian calendar before 1582-10-15,
+ * Gregorian after (Meeus Ch. 7 inverse). The S3-aligned coordinate for the
+ * Sun secular deviations. @param {number} jd @returns {number}
+ */
+export function jdToDecimalYear(jd: number): number;

package/types/moon/deep-ecc-channel.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @param {{
+ *   earthZ: ReadonlyArray<{omegaRadPerYr: number, re: number, im: number}>,
+ *   anchorE: number,
+ *   anchorPeriEclipticDeg: number,
+ * }} artifact — the embedded deep-modes artifact (earth z-modes + the J2000
+ *   anchor pair joined from the chain artifact's one home).
+ */
+export function createDeepEccChannel({ earthZ, anchorE, anchorPeriEclipticDeg }: {
+    earthZ: ReadonlyArray<{
+        omegaRadPerYr: number;
+        re: number;
+        im: number;
+    }>;
+    anchorE: number;
+    anchorPeriEclipticDeg: number;
+}): {
+    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;
+};

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

@@ -0,0 +1,140 @@
+export const DEEP_MODES_ARTIFACT: Readonly<{
+    meta: {
+        integrator: string;
+        order: number;
+        dtDays: number;
+        spanYears: number;
+        sampleDays: number;
+        gr: boolean;
+        seed: string;
+        masses: string;
+        runCommand: string;
+        dumpFile: string;
+        dumpSha256: string;
+        conservationMaxDE: number;
+        decimation: number;
+        naffTerms: number;
+        naffZetaTerms: number;
+        naffZetaTermsEra: number;
+        frame: string;
+        laskarRef: string;
+    };
+    verdict: {
+        strongestBeatPeriodKyr: number;
+        strongestBeatArcsecPerYr: number;
+        la2004BeatPeriodKyr: number;
+        rockMetronomeKyr: number;
+        companion124Kyr: number;
+        companion95Kyr: number;
+        earthLeadingModesArcsecPerYr: number[];
+        topBeatLines: {
+            periodKyr: number;
+            productAmp: number;
+        }[];
+        note: string;
+    };
+    earthZ: {
+        omegaRadPerYr: number;
+        re: number;
+        im: number;
+    }[];
+    earthZeta: {
+        omegaRadPerYr: number;
+        re: number;
+        im: number;
+    }[];
+    earthZetaEra: {
+        omegaRadPerYr: number;
+        re: number;
+        im: number;
+    }[];
+    planetLeadingZetaArcsecPerYr: {
+        mercury: number;
+        venus: number;
+        earth: number;
+        mars: number;
+        jupiter: number;
+        saturn: number;
+        uranus: number;
+        neptune: number;
+    };
+    planetZ: {
+        mercury: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        venus: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        mars: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        jupiter: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        saturn: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        uranus: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        neptune: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+    };
+    planetZeta: {
+        mercury: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        venus: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        mars: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        jupiter: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        saturn: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        uranus: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+        neptune: {
+            omegaRadPerYr: number;
+            re: number;
+            im: number;
+        }[];
+    };
+    anchorE: 0.016702435651957018;
+    anchorPeriEclipticDeg: 462.9179213996577;
+    anchorInclEclipticDeg: 0.00010345820355474172;
+    anchorAscNodeEclipticDeg: 140.29217988414328;
+}>;
+export const DEEP_MODES_ARTIFACT_HASH: "77e0baf779e85de5";

package/types/moon/ecc-channel.d.cts

@@ -0,0 +1,30 @@
+/**
+ * @param {{
+ *   cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null),
+ *   eccentricityBase: number,
+ *   eccentricityJ2000?: number,
+ *   perihelionLongitudeJ2000Deg: number,
+ *   inclinationCycleAnchorDeg: number,
+ * }} deps — cyclesBetween MUST be the engine's own H-lattice phase counter
+ *   (integrated under deep time); perihelionLongitudeJ2000Deg is ϖ_ICRF at
+ *   J2000 (102.94719°, the FULL value — a truncated copy once cost 0.684″);
+ *   inclinationCycleAnchorDeg is the H/3 inclination anchor (21.77°).
+ */
+export function createMoonEccChannel({ cyclesBetween, eccentricityBase, perihelionLongitudeJ2000Deg, inclinationCycleAnchorDeg, eccentricityJ2000, }: {
+    cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null);
+    eccentricityBase: number;
+    eccentricityJ2000?: number;
+    perihelionLongitudeJ2000Deg: number;
+    inclinationCycleAnchorDeg: number;
+}): {
+    eccAt: (tYr: number) => number;
+    eccRateAt: (tYr: number) => number;
+    modulation: (tMa: number, s: number) => number;
+    channelIntegral: (T: number, s: number) => number;
+    eFactorAt: (tYr: number) => number;
+    th0: number;
+    amplitude: number;
+    mean: number;
+    e0: number;
+    g0: number;
+};

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

@@ -0,0 +1,79 @@
+/**
+ * @param {{
+ *   constants: {
+ *     aMoonNowMetres: number,
+ *     alpha1PerMa: number,
+ *     alpha3PerMa3: number,
+ *     alpha4PerMa4: number,
+ *     gmEarthMoonM3PerS2: number,
+ *     massRatioEarthMoon: number,
+ *     moonSiderealMonthInputDays: number,
+ *     holisticYearJ2000: number,
+ *     meanSiderealYearJ2000Seconds: number,
+ *     nApsidalOfDateJ2000: number,
+ *     nNodalOfDateJ2000: number,
+ *     moonApsidalJ2000Seconds: number,
+ *     moonNodalJ2000Seconds: number,
+ *     moonSiderealMonthJ2000Seconds: number,
+ *     sPerigee: number,
+ *     sNode: number,
+ *   },
+ *   fns: {
+ *     meanLodSecondsAtAge: (tMa: number) => (number | null),
+ *     meanSiderealYearSecondsAtAge: (tMa: number) => number,
+ *     meanHAtAge: (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.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).
+ */
+export function createMoonMonthChain({ constants, fns }: {
+    constants: {
+        aMoonNowMetres: number;
+        alpha1PerMa: number;
+        alpha3PerMa3: number;
+        alpha4PerMa4: number;
+        gmEarthMoonM3PerS2: number;
+        massRatioEarthMoon: number;
+        moonSiderealMonthInputDays: number;
+        holisticYearJ2000: number;
+        meanSiderealYearJ2000Seconds: number;
+        nApsidalOfDateJ2000: number;
+        nNodalOfDateJ2000: number;
+        moonApsidalJ2000Seconds: number;
+        moonNodalJ2000Seconds: number;
+        moonSiderealMonthJ2000Seconds: number;
+        sPerigee: number;
+        sNode: number;
+    };
+    fns: {
+        meanLodSecondsAtAge: (tMa: number) => (number | null);
+        meanSiderealYearSecondsAtAge: (tMa: number) => number;
+        meanHAtAge: (tMa: number) => (number | null);
+        modulation: (tMa: number, s: number) => number;
+        distanceMetresAtAge?: (tMa: number) => number;
+    };
+}): {
+    distanceMetresAtAge: (tMa: number) => number;
+    distanceKmAtAge: (tMa: number) => number;
+    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;
+    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;
+    nodalMonthSecondsAtAge: (tMa: number) => number | null;
+    apsidalMeetsNodalSecondsAtAge: (tMa: number) => number | null;
+    lunarLevelingSecondsAtAge: (tMa: number) => number | null;
+};

package/types/moon/series-extension.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Derived series-extension correction to the full-series Moon:
+ * the Delaunay tail plus the A2 planetary tail (longitude only).
+ * @param {number} T - Julian centuries TT from J2000
+ * @returns {{dLonDeg: number, dLatDeg: number}} degrees — ADD to the
+ *   full-series Moon longitude/latitude
+ */
+export function moonSeriesExtensionDeg(T: number): {
+    dLonDeg: number;
+    dLatDeg: number;
+};

package/types/moon/series.d.cts

@@ -0,0 +1,91 @@
+export type MeeusTermTable = Array<[number, number, number, number, number]>;
+/**
+ * @typedef {Array<[number, number, number, number, number]>} MeeusTermTable
+ */
+/**
+ * @param {{
+ *   constants: {
+ *     moonL: MeeusTermTable,
+ *     moonB: MeeusTermTable,
+ *     moonR: MeeusTermTable,
+ *     moonRMeanKm: number,
+ *     moonDistanceJ2000Km: number,
+ *     j2000JD: number,
+ *     julianCenturyDays: number,
+ *     moonMeeusLpCorrectionDeg: number,
+ *     fwA2RateDegPerCy: number,
+ *     fwA3RateDegPerCy: number,
+ *   },
+ *   fns: {
+ *     argsAt: (jdTT: number) => {Lp: number, D: number, M: number, Mp: number, F: number},
+ *     eFactorForD: (dDaysTT: number, T: number, T2: number) => number,
+ *     eFactorAtJdTT: (jdTT: number, T: number, T2: number) => number,
+ *     getMoonDistanceKm: (jdTT?: number) => number,
+ *     getEccentricityBase: () => number,
+ *     deltaTSeconds: (jdUT: 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),
+ *     jupiterOrbitsBetween: (yearA: number, yearB: number) => (number | null),
+ *     isDeepTime: () => boolean,
+ *     isFrameworkNative: () => boolean,
+ *   },
+ * }} deps — argsAt is the engine's dispatcher (probe hook and mode toggle
+ *   ride along); eFactorForD preserves each engine's exact E-factor call
+ *   shape (S11: the two convert d→years with differently-associated
+ *   expressions); distance/eccentricity are GETTERS because the browser's
+ *   moonDistance is deep-time-mutable.
+ */
+export function createMoonSeries({ constants, fns }: {
+    constants: {
+        moonL: MeeusTermTable;
+        moonB: MeeusTermTable;
+        moonR: MeeusTermTable;
+        moonRMeanKm: number;
+        moonDistanceJ2000Km: number;
+        j2000JD: number;
+        julianCenturyDays: number;
+        moonMeeusLpCorrectionDeg: number;
+        fwA2RateDegPerCy: number;
+        fwA3RateDegPerCy: number;
+    };
+    fns: {
+        argsAt: (jdTT: number) => {
+            Lp: number;
+            D: number;
+            M: number;
+            Mp: number;
+            F: number;
+        };
+        eFactorForD: (dDaysTT: number, T: number, T2: number) => number;
+        eFactorAtJdTT: (jdTT: number, T: number, T2: number) => number;
+        getMoonDistanceKm: (jdTT?: number) => number;
+        getEccentricityBase: () => number;
+        deltaTSeconds: (jdUT: 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);
+        jupiterOrbitsBetween: (yearA: number, yearB: number) => (number | null);
+        isDeepTime: () => boolean;
+        isFrameworkNative: () => boolean;
+    };
+}): {
+    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;
+    };
+};

package/types/phase/index.d.cts

@@ -0,0 +1,38 @@
+/**
+ * @param {{
+ *   holisticHAtAgeMa: (tMa: number) => (number | null),
+ *   tableAnchorYear: number,
+ *   driftRefYear: number,
+ *   hJ2000: number,
+ *   yearMin?: number,
+ *   yearMax?: number,
+ *   stepYears?: number,
+ * }} cfg — holisticHAtAgeMa MUST be the lattice-α form; tableAnchorYear is
+ *   startmodelYear (2000.5, table zero + t_Ma convention); driftRefYear is
+ *   startModelYearWithCorrection (the R3 drift anchor); hJ2000 the snapshot
+ *   rate the drift compares against; 10-kyr cells match both engines'
+ *   historic tables.
+ */
+export function createPhaseMachinery({ holisticHAtAgeMa, tableAnchorYear, driftRefYear, hJ2000, yearMin, yearMax, stepYears, }: {
+    holisticHAtAgeMa: (tMa: number) => (number | null);
+    tableAnchorYear: number;
+    driftRefYear: number;
+    hJ2000: number;
+    yearMin?: number;
+    yearMax?: number;
+    stepYears?: number;
+}): {
+    ensureTable: () => void;
+    cumulAtYear: (year: number) => number | null;
+    integralBetween: (yearA: number, yearB: number) => number | null;
+    j2000Drift: (yearA: number) => number;
+    cyclesBetween: (yearA: number, yearB: number, divisorN: number) => number | null;
+    yearAtCumul: (targetCumul: number) => number | null;
+    grid: () => {
+        yearMin: number;
+        yearMax: number;
+        stepYears: number;
+        j2000Idx: number;
+        length: number;
+    };
+};

package/types/planets/asc-node-integrator.d.cts

@@ -0,0 +1,30 @@
+/**
+ * @param {{ ascendingNodeDeg: number, inclinationDeg: number }} tilt —
+ *   static node and inclination (engine-decomposed from its scene scheme)
+ * @param {number} currentYear
+ * @param {{
+ *   obliquityAt: (year: number) => number,
+ *   earthInclinationAt: (year: number) => number,
+ *   obliquityExtremaInRange: (yearMin: number, yearMax: number) => number[],
+ *   inclinationCrossingsInRange: (inclinationDeg: number, yearMin: number, yearMax: number) => number[],
+ *   eclipticInclinationAt: ((year: number) => number) | null,
+ *   earthInclinationMeanDeg: number,
+ *   earthInclinationAmplitudeDeg: number,
+ *   epochYear?: number,
+ * }} deps — eclipticInclinationAt non-null enables the dynamic-inclination
+ *   crossover search and per-segment rates (the planetName path).
+ * @returns {number} dynamic ascending node longitude, degrees 0–360
+ */
+export function integrateAscendingNode(tilt: {
+    ascendingNodeDeg: number;
+    inclinationDeg: number;
+}, currentYear: number, deps: {
+    obliquityAt: (year: number) => number;
+    earthInclinationAt: (year: number) => number;
+    obliquityExtremaInRange: (yearMin: number, yearMax: number) => number[];
+    inclinationCrossingsInRange: (inclinationDeg: number, yearMin: number, yearMax: number) => number[];
+    eclipticInclinationAt: ((year: number) => number) | null;
+    earthInclinationMeanDeg: number;
+    earthInclinationAmplitudeDeg: number;
+    epochYear?: number;
+}): number;

package/types/planets/chain-artifact.d.ts

@@ -0,0 +1,15 @@
+/**
+ * GENERATED — do not edit. Regenerate:
+ *   node tools/constants/generate.mjs --write
+ *
+ * Source: data/nbody-secular-frequencies.json (the governed engine-D
+ * artifact), emitted VERBATIM. Two gates guard the two legs of the causal
+ * chain: check:artifacts pins artifact ↔ engine (input hashes name the
+ * regeneration command), this module's staleness check pins embed ↔ artifact.
+ * A changed planet mass therefore propagates engine → artifact → here → the
+ * browser scene, or a gate goes red.
+ */
+/** @type {string} */
+export const CHAIN_ARTIFACT_HASH: string;
+/** @type {Readonly<Record<string, unknown>>} */
+export const CHAIN_ARTIFACT: Readonly<Record<string, unknown>>;

package/types/planets/ecc-channel.d.cts

@@ -0,0 +1,20 @@
+/**
+ * The law of cosines over resolved cycles. null cycles → the MEAN
+ * eccentricity √(base² + amp²) (past the tidal-lock asymptote).
+ * @param {number | null} cycles @param {number} base @param {number} amplitude
+ * @returns {number} */
+export function eccentricityFromCycles(cycles: number | null, base: number, amplitude: number): number;
+/**
+ * Browser-convention evaluator: J2000-FIXED anchor + cycle length, divisor
+ * N = H_J2000/cycleLength, integrated phase via the injected engine
+ * cyclesBetween (toggle semantics ride along), null → mean.
+ * @param {number} currentYear @param {number} anchorYearJ2000
+ * @param {number} cycleLengthYearsJ2000 @param {number} base
+ * @param {number} amplitude
+ * @param {{ holisticYearJ2000: number,
+ *   cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null) }} env
+ * @returns {number} */
+export function computeEccentricityIntegrated(currentYear: number, anchorYearJ2000: number, cycleLengthYearsJ2000: number, base: number, amplitude: number, env: {
+    holisticYearJ2000: number;
+    cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null);
+}): number;