@essrt/physics 20.0.1 → 21.0.0

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";
@@ -23,7 +19,6 @@ 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 +45,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;
@@ -67,13 +57,13 @@ 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 { 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;

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

@@ -26,7 +26,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,
@@ -66,7 +66,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;

package/types/phase/deep-calendar.d.cts

@@ -1,15 +1,3 @@
-export type PhaseMachinery = {
-    ensureTable: () => void;
-    cumulAtYear: (year: number) => (number | null);
-    yearAtCumul: (targetCumul: number) => (number | null);
-    grid: () => {
-        yearMin: number;
-        yearMax: number;
-        stepYears: number;
-        j2000Idx: number;
-        length: number;
-    };
-};
 export type DeepCalendar = {
     /**
      * SI-tropical-year label for a
@@ -23,10 +11,6 @@ export type DeepCalendar = {
      * the exact inverse of jdToSIyear.
      */
     siYearToJD: (ySI: number) => number;
-    /**
-     *   inverse of the phase machinery's cumulAtYear — null outside the table.
-     */
-    yearAtCumulIntegral: (targetCumul: number) => (number | null);
     /**
      * builds the ∫ daysPerYear dt table
      * (idempotent; under the lattice α).
@@ -39,24 +23,12 @@ export type DeepCalendar = {
      * year = startModelYear.
      */
     yearToJD: (year: number) => (number | null);
-    /**
-     *   calendar year of the k-th H-balanced event, k = 0 being `balancedYear`;
-     *   negative k = past; null outside the table domain.
-     */
-    balancedYearAtCycle: (cycleOffset: number) => (number | null);
     /**
      * diagnostic — the
      * table length once built, null before.
      */
     cumulDaysTableLength: () => (number | null);
 };
-/**
- * @typedef {Object} PhaseMachinery
- * @property {() => void} ensureTable
- * @property {(year: number) => (number | null)} cumulAtYear
- * @property {(targetCumul: number) => (number | null)} yearAtCumul
- * @property {() => {yearMin: number, yearMax: number, stepYears: number, j2000Idx: number, length: number}} grid
- */
 /**
  * @typedef {Object} DeepCalendar
  * @property {(jd: number) => number} jdToSIyear SI-tropical-year label for a
@@ -65,51 +37,43 @@ export type DeepCalendar = {
  *   with the runtime by construction; the round-trip bias Y_SI − Y is −11.0 yr
  *   at −302,635 and grows quadratically).
  * @property {(ySI: number) => number} siYearToJD the exact inverse of jdToSIyear.
- * @property {(targetCumul: number) => (number | null)} yearAtCumulIntegral
- *   inverse of the phase machinery's cumulAtYear — null outside the table.
  * @property {() => void} ensureCumulDaysTable builds the ∫ daysPerYear dt table
  *   (idempotent; under the lattice α).
  * @property {(year: number) => (number | null)} yearToJD calendar year → JD,
  *   integrating days-per-year from startModelYear; null outside the table
  *   domain or past the tidal-lock asymptote; startModelJD exactly at
  *   year = startModelYear.
- * @property {(cycleOffset: number) => (number | null)} balancedYearAtCycle
- *   calendar year of the k-th H-balanced event, k = 0 being `balancedYear`;
- *   negative k = past; null outside the table domain.
  * @property {() => (number | null)} cumulDaysTableLength diagnostic — the
  *   table length once built, null before.
  */
 /**
  * @param {{
- *   phase: () => PhaseMachinery,
  *   meanYearInDaysAtAgeMa: (tMa: number) => (number | null),
  *   withLatticeAlpha: (build: () => void) => void,
  *   startModelJD: number,
  *   startModelYear: number,
  *   startModelYearWithCorrection: number,
  *   siTropicalYearDays: number,
- *   balancedYear: number,
- *   hJ2000: number,
- *   cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null),
- * }} deps — `phase` is the engine's (lazily built) phase machinery, whose
- *   grid the days table shares; `meanYearInDaysAtAgeMa` the engine's
- *   days-per-year source (the LOD channel's `yearInDaysAtAge`);
- *   `withLatticeAlpha` the engine's R2 pin; `cyclesBetween` the engine's
- *   cycle counter (the browser passes its toggle-aware form, Node the
- *   integrated form — the caller's convention, preserved); `startModelYear`
- *   is the table zero (2000.5) and `startModelYearWithCorrection` the SI-axis
- *   anchor (≈ 2000.4977) — two different constants, do not unify.
+ *   yearMin?: number,
+ *   yearMax?: number,
+ *   stepYears?: number,
+ * }} deps — `meanYearInDaysAtAgeMa` is the engine's days-per-year source
+ *   (the LOD channel's `yearInDaysAtAge`); `withLatticeAlpha` the engine's
+ *   R2 pin; `startModelYear` is the table zero (2000.5) and
+ *   `startModelYearWithCorrection` the SI-axis anchor (≈ 2000.4977) — two
+ *   different constants, do not unify; the grid (±500 Myr, 10-kyr cells)
+ *   is the engines' deep-time grid — the table zero sits at the cell
+ *   nearest `startModelYear`.
  * @returns {DeepCalendar}
  */
-export function createDeepCalendar({ phase, meanYearInDaysAtAgeMa, withLatticeAlpha, startModelJD, startModelYear, startModelYearWithCorrection, siTropicalYearDays, balancedYear, hJ2000, cyclesBetween, }: {
-    phase: () => PhaseMachinery;
+export function createDeepCalendar({ meanYearInDaysAtAgeMa, withLatticeAlpha, startModelJD, startModelYear, startModelYearWithCorrection, siTropicalYearDays, yearMin, yearMax, stepYears, }: {
     meanYearInDaysAtAgeMa: (tMa: number) => (number | null);
     withLatticeAlpha: (build: () => void) => void;
     startModelJD: number;
     startModelYear: number;
     startModelYearWithCorrection: number;
     siTropicalYearDays: number;
-    balancedYear: number;
-    hJ2000: number;
-    cyclesBetween: (yearA: number, yearB: number, divisorN: number) => (number | null);
+    yearMin?: number;
+    yearMax?: number;
+    stepYears?: number;
 }): DeepCalendar;

package/types/planets/geometry.d.cts

@@ -1,7 +1,8 @@
 export type PlanetGeometryBody = {
     key: string;
     type?: string;
-    solarYearInput: number;
+    periodDays: number;
+    semiMajorAxisAu?: number;
     orbitalEccentricityBase?: number;
     longitudePerihelion?: number;
     ascendingNode?: number;
@@ -12,7 +13,8 @@ export type PlanetGeometryBody = {
  * @typedef {{
  *   key: string,
  *   type?: string,
- *   solarYearInput: number,
+ *   periodDays: number,
+ *   semiMajorAxisAu?: number,
  *   orbitalEccentricityBase?: number,
  *   longitudePerihelion?: number,
  *   ascendingNode?: number,
@@ -21,19 +23,19 @@ export type PlanetGeometryBody = {
  * }} PlanetGeometryBody
  */
 /**
- * @param {PlanetGeometryBody} body
+ * @param {PlanetGeometryBody} body — `periodDays` the body's sidereal orbital
+ *   period in SI days; `semiMajorAxisAu` the chain's J2000 a where a chain
+ *   exists (else Kepler's a from the period, in the scene's solar-year units)
  * @param {{
- *   holisticYears: number,
  *   meanSolarYearDays: number,
  *   currentAUDistanceKm: number,
  *   earthEccentricityJ2000: number,
  *   earthPerihelionLongitudeJ2000Deg: number,
- * }} env — the engine's J2000 values (browser passes its live globals at
- *   load time, preserving its original initial-derivation semantics; the
- *   epoch machinery that later mutates the browser's `let` aliases is
- *   untouched by this layer).
+ * }} env — the engine's J2000 values; `meanSolarYearDays` is the scene's
+ *   year unit (`pos` counts mean solar years), so `periodYears` is the period
+ *   in that unit, the scaffold's `speed` = 2π/periodYears.
  * @returns {{
- *   solarYearCount: number, orbitDistance: number, periodYears: number,
+ *   orbitDistance: number, periodYears: number, periodDays: number,
  *   realOrbitalEccentricity: (number | undefined),
  *   elipticOrbit: (number | undefined), perihelionDistance: (number | undefined),
  *   speedKmh: number, rotationPeriodHours: (number | undefined),
@@ -41,15 +43,14 @@ export type PlanetGeometryBody = {
  * }}
  */
 export function derivePlanetGeometry(body: PlanetGeometryBody, env: {
-    holisticYears: number;
     meanSolarYearDays: number;
     currentAUDistanceKm: number;
     earthEccentricityJ2000: number;
     earthPerihelionLongitudeJ2000Deg: number;
 }): {
-    solarYearCount: number;
     orbitDistance: number;
     periodYears: number;
+    periodDays: number;
     realOrbitalEccentricity: (number | undefined);
     elipticOrbit: (number | undefined);
     perihelionDistance: (number | undefined);
@@ -58,3 +59,18 @@ export function derivePlanetGeometry(body: PlanetGeometryBody, env: {
     eccentricityPerihelion: (number | undefined);
     lowestPoint: (number | undefined);
 };
+/**
+ * The scaffold's orbit inputs for one body — ONE home for the rule (plan 09
+ * step 7b): where the governed engine-D chain artifact has the body, the
+ * chain's J2000 semi-major axis and its fitted era-window mean motion (deg
+ * per Julian year → the period in SI days); otherwise the body's observed
+ * period input (the no-chain bodies Pluto, Halley, Eros, Ceres).
+ * @param {string} key
+ * @param {any} chainArtifact the CHAIN_ARTIFACT (or the governed JSON it embeds)
+ * @param {number} fallbackPeriodDays the observed period input, SI days
+ * @returns {{ periodDays: number, semiMajorAxisAu: (number | undefined) }}
+ */
+export function scaffoldOrbitInputs(key: string, chainArtifact: any, fallbackPeriodDays: number): {
+    periodDays: number;
+    semiMajorAxisAu: (number | undefined);
+};

package/types/planets/model.d.cts

@@ -3,6 +3,9 @@ export type PlanetModelBody = {
      * - geometry type branch ('I' | 'II' | 'III')
      */
     type?: string | undefined;
+    /**
+     * - the observed sidereal period input, SI days (the scaffold period of the no-chain bodies; the chain planets ride the artifact's elements)
+     */
     solarYearInput: number;
     invPlaneInclinationJ2000?: number | undefined;
     longitudePerihelion?: number | undefined;
@@ -26,7 +29,10 @@ export type PlanetModelBody = {
     orbitDistanceOverride?: number | undefined;
 };
 export type PlanetModelEnv = {
-    holisticYears: number;
+    /**
+     * - the governed engine-D chain artifact (CHAIN_ARTIFACT): the seven chain planets' scaffold a and period ride its J2000 elements (plan 09 step 7b)
+     */
+    chainArtifact?: any;
     meanSolarYearDays: number;
     balancedYear: number;
     systemResetN: number;
@@ -42,7 +48,7 @@ export type PlanetModelRecord = {
 /**
  * @typedef {Object} PlanetModelBody
  * @property {string} [type] - geometry type branch ('I' | 'II' | 'III')
- * @property {number} solarYearInput
+ * @property {number} solarYearInput - the observed sidereal period input, SI days (the scaffold period of the no-chain bodies; the chain planets ride the artifact's elements)
  * @property {number} [invPlaneInclinationJ2000]
  * @property {number} [longitudePerihelion]
  * @property {number} [wobblePeriodYears] - carriers: the chain's g-mode beat (input since Phase 7 commit 2)
@@ -57,7 +63,7 @@ export type PlanetModelRecord = {
  */
 /**
  * @typedef {Object} PlanetModelEnv
- * @property {number} holisticYears
+ * @property {any} [chainArtifact] - the governed engine-D chain artifact (CHAIN_ARTIFACT): the seven chain planets' scaffold a and period ride its J2000 elements (plan 09 step 7b)
  * @property {number} meanSolarYearDays
  * @property {number} balancedYear
  * @property {number} systemResetN