export type DeepCalendar = {
    /**
     * SI-tropical-year label for a
     * JD, anchored at startModelYearWithCorrection — NOT a calendar year (the
     * scene's precession rotations integrate on this axis; a fit on it agrees
     * with the runtime by construction; the round-trip bias Y_SI − Y is −11.0 yr
     * at −302,635 and grows quadratically).
     */
    jdToSIyear: (jd: number) => number;
    /**
     * the exact inverse of jdToSIyear.
     */
    siYearToJD: (ySI: number) => number;
    /**
     * builds the ∫ daysPerYear dt table
     * (idempotent; under the lattice α).
     */
    ensureCumulDaysTable: () => void;
    /**
     * 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.
     */
    yearToJD: (year: number) => (number | null);
    /**
     * diagnostic — the
     * table length once built, null before.
     */
    cumulDaysTableLength: () => (number | null);
};
/**
 * @typedef {Object} DeepCalendar
 * @property {(jd: number) => number} jdToSIyear SI-tropical-year label for a
 *   JD, anchored at startModelYearWithCorrection — NOT a calendar year (the
 *   scene's precession rotations integrate on this axis; a fit on it agrees
 *   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 {() => 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 {() => (number | null)} cumulDaysTableLength diagnostic — the
 *   table length once built, null before.
 */
/**
 * @param {{
 *   meanYearInDaysAtAgeMa: (tMa: number) => (number | null),
 *   withLatticeAlpha: (build: () => void) => void,
 *   startModelJD: number,
 *   startModelYear: number,
 *   startModelYearWithCorrection: number,
 *   siTropicalYearDays: number,
 *   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({ 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;
    yearMin?: number;
    yearMax?: number;
    stepYears?: number;
}): DeepCalendar;