@neilberkman/sidereon 0.9.2 → 0.10.0

package/pkg-node/sidereon.d.ts

@@ -233,6 +233,19 @@ export class AtmosphereDensity {
     readonly temperatureK: number;
 }
 
+export class BiasSet {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    codeBiasModelM(sat: string, used_obs1: string, used_obs2: string, freq1_hz: number, freq2_hz: number, glonass_channel: number | null | undefined, clock_ref_obs1: string, clock_ref_obs2: string, epoch_j2000_s: number, time_scale?: string | null): number | undefined;
+    codeDsbSeconds(sat: string, obs1: string, obs2: string, epoch_j2000_s: number, time_scale?: string | null): number | undefined;
+    codeOsbSeconds(sat: string, obs: string, epoch_j2000_s: number, time_scale?: string | null): number | undefined;
+    phaseOsbCycles(sat: string, obs: string, epoch_j2000_s: number, time_scale?: string | null): number | undefined;
+    readonly recordCount: number;
+    readonly records: any;
+    readonly skippedRecords: number;
+}
+
 /**
  * A parsed broadcast ephemeris store from a RINEX NAV file. `records` are the
  * usable GPS/Galileo/BeiDou records selected by the core default SPP policy.
@@ -1299,6 +1312,27 @@ export class DopplerShift {
     readonly rangeRateKmS: number;
 }
 
+export class DragForce {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    acceleration(epoch_s: number, position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+    static fromAreaMass(cd: number, area_m2: number, mass_kg: number, space_weather: SpaceWeather, cutoff_altitude_km?: number | null): DragForce;
+    static fromBallisticCoefficient(bc_kg_m2: number, space_weather: SpaceWeather, cutoff_altitude_km?: number | null): DragForce;
+    static fromBcFactor(bc_factor_m2_kg: number, space_weather: SpaceWeather, cutoff_altitude_km?: number | null): DragForce;
+    readonly bcFactorM2Kg: number;
+    readonly cutoffAltitudeKm: number;
+    readonly spaceWeather: SpaceWeather;
+}
+
+export class DtedTerrain {
+    free(): void;
+    [Symbol.dispose](): void;
+    heightM(longitude_deg: number, latitude_deg: number): number;
+    heightMWithOptions(longitude_deg: number, latitude_deg: number, options: any): number;
+    constructor(root: string);
+}
+
 /**
  * Orthonormal encounter frame built from two relative states.
  */
@@ -3978,6 +4012,11 @@ export class ReducedOrbitState {
     readonly velocityMS: Float64Array;
 }
 
+export enum RetrogradeFactor {
+    Prograde = 0,
+    Retrograde = 1,
+}
+
 /**
  * A parsed RINEX clock product with satellite clock-bias interpolation.
  */
@@ -4168,6 +4207,15 @@ export class SatelliteVector {
     readonly values: Float64Array;
 }
 
+export class SbasCorrectionStore {
+    free(): void;
+    [Symbol.dispose](): void;
+    ingest(bytes: Uint8Array, form: string | null | undefined, geo: string, week: number, tow_s: number, time_scale?: string | null): void;
+    ionoSlantDelayM(geo: string, receiver_lat_rad: number, receiver_lon_rad: number, receiver_height_m: number, elevation_rad: number, azimuth_rad: number, frequency_hz: number): number | undefined;
+    constructor();
+    readyGeos(t_j2000_s: number): string[];
+}
+
 /**
  * Per-constellation single-frequency pseudorange code-selection policy. Build
  * with `new SignalPolicy()` then chain `.withSystem(system, codes)`, or use
@@ -4374,6 +4422,13 @@ export class Sp3 {
      * or failed. Delegates to the serial reference batch kernel.
      */
     solveSppBatch(epochs: any, options: any): SppBatchSolution;
+    /**
+     * Run the core robust-reweighted SPP driver under the RAIM/FDE exclusion loop.
+     *
+     * `request` is the FDE request with a `robust` object. The implementation
+     * delegates to `sidereon_core::quality::spp_robust_fde_driver`.
+     */
+    sppRobustFdeDriver(request: any): FdeSolution;
     /**
      * The exact parsed state of `satellite` at record `epochIndex` (no
      * interpolation). Throws a `RangeError` past the last epoch and a
@@ -4516,7 +4571,7 @@ export class Sp3MergeReport {
     [Symbol.dispose](): void;
     /**
      * Per-(epoch, satellite) agreement statistics for every accepted cell, in
-     * output (epoch, then satellite) order — one entry per cell written to the
+     * output (epoch, then satellite) order, one entry per cell written to the
      * merged product.
      */
     readonly agreement: Sp3AgreementMetric[];
@@ -4619,6 +4674,15 @@ export class Sp3State {
     readonly velocityMS: Float64Array | undefined;
 }
 
+export class SpaceWeather {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(f107?: number | null, f107a?: number | null, ap?: number | null);
+    readonly ap: number;
+    readonly f107: number;
+    readonly f107a: number;
+}
+
 /**
  * Canonical quiet-Sun space-weather indices for NRLMSISE-00, mirrored from the
  * core so a JS caller can pass moderate-activity defaults to [`atmosphereDensity`]
@@ -4847,6 +4911,16 @@ export class SppSolution {
     readonly zM: number;
 }
 
+export class SsrCorrectionStore {
+    free(): void;
+    [Symbol.dispose](): void;
+    clock(sat: string): any;
+    ingest(bytes: Uint8Array, framed: boolean | null | undefined, week: number, tow_s: number, time_scale?: string | null): void;
+    constructor();
+    orbit(sat: string): any;
+    uraIndex(sat: string): number | undefined;
+}
+
 /**
  * A batch of Sun and Moon positions, one per epoch: flat row-major `sun` and
  * `moon` `Float64Array`s of length `3 * epochCount`, in **metres**.
@@ -5243,6 +5317,16 @@ export class ZenithDelay {
  */
 export function acquire(samples: Float64Array, prn: bigint, options: any): AcquisitionResult;
 
+/**
+ * On-sky angle in degrees between two direction vectors.
+ */
+export function angularSeparation(a: Float64Array, b: Float64Array): number;
+
+/**
+ * On-sky angle in degrees between two `(lonDeg, latDeg)` direction pairs.
+ */
+export function angularSeparationCoords(a_lon_deg: number, a_lat_deg: number, b_lon_deg: number, b_lat_deg: number): number;
+
 /**
  * Evaluate NRLMSISE-00 neutral-atmosphere density and temperature.
  *
@@ -5262,6 +5346,16 @@ export function atmosphereDensity(lat_deg: number, lon_deg: number, alt_km: numb
  */
 export function atmosphereSpaceWeatherDefaults(): SpaceWeatherDefaults;
 
+/**
+ * Solar beta angle in degrees from orbit normal and Sun vectors.
+ */
+export function betaAngle(orbit_normal: Float64Array, sun: Float64Array): number;
+
+/**
+ * Solar beta angle in degrees from an inertial state and Sun vector.
+ */
+export function betaAngleFromState(r: Float64Array, v: Float64Array, sun: Float64Array): number;
+
 /**
  * Resolve integer ambiguities with a bounded lattice search.
  *
@@ -5312,6 +5406,10 @@ export function civilToJ2000Seconds(year: number, month: number, day: number, ho
  */
 export function cn0(eirp_dbw: number, fspl_db: number, receiver_gt_dbk: number, other_losses_db?: number | null): number;
 
+export function coe2eq(coe: any, factor?: RetrogradeFactor | null): any;
+
+export function coe2mee(coe: any, factor?: RetrogradeFactor | null): any;
+
 /**
  * Convert classical orbital elements to an inertial Cartesian state.
  *
@@ -5381,6 +5479,10 @@ export function covarianceIsSymmetric(covariance_km2: Float64Array): boolean;
  */
 export function coverageLookAngles(satellites: Tle[], stations: GroundStation[], epoch_unix_us: bigint): CoverageGrid;
 
+export function cwPropagate(rel: any, n_rad_s: number, dt_s: number): any;
+
+export function cwStm(n_rad_s: number, dt_s: number): Float64Array;
+
 /**
  * Decode Compact RINEX (Hatanaka) bytes into plain RINEX OBS text. Throws a
  * `TypeError` on non-UTF-8 input and an `Error` on a decode failure.
@@ -5424,6 +5526,10 @@ export function decodeRtcmFrame(bytes: Uint8Array): any;
  */
 export function decodeRtcmMessage(body: Uint8Array): any;
 
+export function decodeSbasMessage(bytes: Uint8Array, form?: string | null): any;
+
+export function decodeSsr(bytes: Uint8Array, framed?: boolean | null): any;
+
 /**
  * Standard dual-frequency ionosphere-free carrier pair for a constellation.
  */
@@ -5508,6 +5614,10 @@ export function dopplerToRangeRate(doppler_hz: number, carrier_hz: number): numb
  */
 export function earthAngularRadius(satellite_position_km: Float64Array): Float64Array;
 
+export function eccentricToMean(eccentric_anomaly_rad: number, eccentricity: number): number;
+
+export function eccentricToTrue(eccentric_anomaly_rad: number, eccentricity: number): number;
+
 /**
  * Convert a batch of ITRS (ECEF) positions to geodetic coordinates.
  *
@@ -5611,6 +5721,10 @@ export function encounterFrame(position1_km: Float64Array, velocity1_km_s: Float
  */
 export function encounterPlaneCovariance(frame: EncounterFrame, covariance_km2: Float64Array): Float64Array;
 
+export function eq2coe(eq: any): any;
+
+export function eq2rv(eq: any, mu_km3_s2: number): any;
+
 /**
  * Confidence ellipse from an arbitrary 2x2 covariance block.
  *
@@ -5622,6 +5736,8 @@ export function encounterPlaneCovariance(frame: EncounterFrame, covariance_km2:
  */
 export function errorEllipse2(covariance: Float64Array, confidence: number): ErrorEllipse2;
 
+export function estimateDecay(drag: DragForce, request: any): any;
+
 /**
  * Find Moon elevation threshold crossings (moonrise / moonset) over a UTC
  * window.
@@ -5770,7 +5886,7 @@ export function fromCelestrakJson(json: string, system?: string | null): any;
  * skipping (rather than throwing on) entries that do not resolve.
  *
  * The lenient sibling of [`fromCelestrakJson`]: feed it a raw combined CelesTrak
- * `gnss` feed and it returns `{ records, skipped }` — `records` is the `Record[]`
+ * `gnss` feed and it returns `{ records, skipped }`. `records` is the `Record[]`
  * for `system` (the same shape `fromCelestrakJson` returns, sorted by
  * `(system, prn)`), and `skipped` is a `SkippedOmm[]` of the entries whose
  * `OBJECT_NAME` did not resolve to a PRN for `system` (another constellation's
@@ -5894,7 +6010,7 @@ export function gnssPasses(sp3: Sp3, station_ecef_m: Float64Array, start_j2000_s
 export function gnssSp3Id(system: string, prn: number): string;
 
 /**
- * Stable lower-case display label for a constellation, e.g. `"gps"`.
+ * Canonical core display label for a constellation, e.g. `"GPS"`.
  */
 export function gnssSystemLabel(system: GnssSystem): string;
 
@@ -6049,7 +6165,7 @@ export function kurtosis(x: Float64Array, fisher?: boolean | null, bias?: boolea
  * `covariance` is its `n x n` covariance as a row-major `number[][]`, and
  * `ratioThreshold` is the ratio-test acceptance threshold (RTKLIB's default is
  * `3.0`). Finds the true integer-least-squares optimum and runner-up for any
- * positive-definite covariance — no search box, no combinatorial blow-up.
+ * positive-definite covariance. No search box, no combinatorial blow-up.
  * Returns an `IlsResult`. Throws a `TypeError` on a malformed shape, a
  * `RangeError` on a non-finite or out-of-domain input, and an `Error` on a
  * singular covariance or a non-converging search.
@@ -6172,6 +6288,14 @@ export function lnavTow(bits: Uint8Array): bigint | undefined;
  */
 export function loadAntex(bytes: Uint8Array): Antex;
 
+export function loadBiasSinex(bytes: Uint8Array): BiasSet;
+
+export function loadBiasSinexLossy(bytes: Uint8Array): BiasSet;
+
+export function loadCodeDcb(bytes: Uint8Array, options: any): BiasSet;
+
+export function loadCodeDcbLossy(bytes: Uint8Array, options: any): BiasSet;
+
 /**
  * Alias of [`decodeCrinex`] for callers that read a file as bytes.
  */
@@ -6209,6 +6333,24 @@ export function loadRinexObs(bytes: Uint8Array): RinexObs;
  */
 export function loadSp3(bytes: Uint8Array): Sp3;
 
+export function lunarSolarEclipses(start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+export function lunarSolarEclipsesSpk(spk: Spk, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+export function lvlhRotation(position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
+export function meanMotionCircular(radius_km: number): number;
+
+export function meanMotionFromState(position_km: Float64Array, velocity_km_s: Float64Array): number;
+
+export function meanToEccentric(mean_anomaly_rad: number, eccentricity: number): number;
+
+export function meanToTrue(mean_anomaly_rad: number, eccentricity: number): number;
+
+export function mee2coe(mee: any): any;
+
+export function mee2rv(mee: any, mu_km3_s2: number): any;
+
 /**
  * Melbourne-Wubbena combination, metres.
  */
@@ -6235,6 +6377,10 @@ export function mergeNavcen(records: any, statuses: any): any;
  */
 export function mergeSp3(sources: Sp3[], options: any): Sp3MergeResult;
 
+export function meridianTransits(body: string, station: any, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+export function meridianTransitsSpk(spk: Spk, body: string, station: any, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
 /**
  * Mean, variance, skewness, and excess kurtosis of a residual set in one pass.
  *
@@ -6276,6 +6422,10 @@ export function moonElevationDeg(latitude_deg: number, longitude_deg: number, al
  */
 export function moonIllumination(latitude_deg: number, longitude_deg: number, altitude_km: number, epoch_unix_us: bigint): any;
 
+export function moonPhases(start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+export function moonPhasesSpk(spk: Spk, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
 /**
  * Narrow-lane code combination, metres.
  */
@@ -6351,6 +6501,21 @@ export function observablesSp3(sp3: Sp3, satellite: string, receiver_ecef_m: Flo
  */
 export function observationKindLabel(kind: ObservationKind): string;
 
+/**
+ * Observe `"sun"` or `"moon"` from a geodetic station at a UTC unix microsecond epoch.
+ */
+export function observe(station: any, epoch_unix_us: bigint, target: string, options: any): any;
+
+/**
+ * Observe a caller-supplied SSB-centered target state using an SPK for Earth and Sun.
+ */
+export function observeBarycentricState(station: any, epoch_unix_us: bigint, spk: Spk, position_km: Float64Array, velocity_km_s: Float64Array, options: any): any;
+
+/**
+ * Observe an SPK target body by NAIF id using default full-chain options.
+ */
+export function observeSpkBody(station: any, epoch_unix_us: bigint, spk: Spk, naif_id: number): any;
+
 /**
  * Ocean tide loading displacement of an ITRF station, metres (ECEF).
  *
@@ -6501,6 +6666,13 @@ export function phaseAngle(satellite_position_km: Float64Array, sun_position_km:
  */
 export function phaseMeters(phi_cycles: number, f_hz: number): number;
 
+export function planetaryEvents(spk: Spk, planet: string, kind: string, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+/**
+ * Position angle in degrees from North through East.
+ */
+export function positionAngle(from_lon_deg: number, from_lat_deg: number, to_lon_deg: number, to_lat_deg: number): number;
+
 /**
  * Precompute static PPP correction tables for a precise-orbit arc.
  *
@@ -6516,6 +6688,8 @@ export function phaseMeters(phi_cycles: number, f_hz: number): number;
  */
 export function pppCorrections(sp3: Sp3, epochs: any, receiver_ecef_m: Float64Array, options: any): any;
 
+export function pppCorrectionsWithCodeBias(sp3: Sp3, epochs: any, receiver_ecef_m: Float64Array, options: any, bias_set: BiasSet, code_bias: any): any;
+
 /**
  * Build a sample-backed precise-ephemeris source from an array of samples.
  *
@@ -6581,6 +6755,8 @@ export function prepareIonosphereFreeRtkArc(epochs: any, wide_lane_cycles: any,
  */
 export function propagateBatch(satellites: Tle[], epochs_unix_us: BigInt64Array): FleetPropagation;
 
+export function propagateKepler(coe: any, mu_km3_s2: number, dt_s: number): any;
+
 /**
  * Numerically propagate an ECI Cartesian state and sample it at a grid of
  * epochs.
@@ -6621,11 +6797,15 @@ export function raimFdeDesign(rows: any, options: any): any;
  */
 export function rangeRateToDoppler(range_rate_m_s: number, carrier_hz: number): number;
 
+export function relativeState(chief: any, deputy: any): any;
+
 /**
  * Build a sampled GPS C/A code replica, an `Int8Array`.
  */
 export function replica(prn: bigint, options: any): Int8Array;
 
+export function ricRotation(position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
 /**
  * RINEX observation band frequency in hertz for a system and band digit.
  */
@@ -6636,6 +6816,8 @@ export function rinexBandFrequencyHz(system: GnssSystem, band: string, glonass_c
  */
 export function rinexBandWavelengthM(system: GnssSystem, band: string, glonass_channel?: number | null): number | undefined;
 
+export function rswRotation(position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
 /**
  * Read the 12-bit RTCM message number from a message body.
  *
@@ -6644,6 +6826,8 @@ export function rinexBandWavelengthM(system: GnssSystem, band: string, glonass_c
  */
 export function rtcmMessageNumber(body: Uint8Array): number;
 
+export function rtnRotation(position_km: Float64Array, velocity_km_s: Float64Array): Float64Array;
+
 /**
  * Transform a 3x3 RTN covariance (flat row-major length 9) to ECI for the given
  * orbit state. Returns a flat row-major length-9 `Float64Array`.
@@ -6662,6 +6846,14 @@ export function rtnToEciCovariance(covariance_rtn: Float64Array, position_km: Fl
  */
 export function rv2coe(r: Float64Array, v: Float64Array, mu: number): any;
 
+export function rv2eq(r: Float64Array, v: Float64Array, mu_km3_s2: number, factor?: RetrogradeFactor | null): any;
+
+export function rv2mee(r: Float64Array, v: Float64Array, mu_km3_s2: number, factor?: RetrogradeFactor | null): any;
+
+export function sampleBroadcastEphemeris(broadcast: BroadcastEphemeris, satellites: string[], start_j2000_s: number, stop_j2000_s: number, step_s: number): any;
+
+export function sampleSp3Ephemeris(sp3: Sp3, satellites: string[], start_j2000_s: number, stop_j2000_s: number, step_s: number): any;
+
 /**
  * Apparent visual magnitude of a sunlit body from a diffuse-sphere phase law.
  *
@@ -6673,6 +6865,8 @@ export function rv2coe(r: Float64Array, v: Float64Array, mu: number): any;
  */
 export function satelliteVisualMagnitude(range_km: number, phase_angle_deg: number, standard_magnitude: number, reference_range_km: number): number;
 
+export function sbasCorrectedState(broadcast: BroadcastEphemeris, store: SbasCorrectionStore, geo: string, sat: string, t_j2000_s: number, mode?: string | null): any;
+
 /**
  * Screen a primary satellite against a secondary TLE catalog for threshold TCAs.
  *
@@ -6694,6 +6888,10 @@ export function screenTcaCandidates(primary_line1: string, primary_line2: string
  */
 export function screenTcaConjunctions(primary_line1: string, primary_line2: string, secondaries: any, window_start_unix_micros: bigint, window_end_unix_micros: bigint, miss_distance_threshold_km: number, pc_options: any, options: any): any;
 
+export function seasons(start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
+export function seasonsSpk(spk: Spk, start_unix_us: bigint, end_unix_us: bigint, step_s: number, tolerance_s: number): any;
+
 /**
  * Select an IONEX product usable at `requestedEpochJ2000S`, degrading to a
  * diurnal-shifted prior product within `policy`.
@@ -6796,6 +6994,8 @@ export function solidEarthPoleTide(station_ecef_m: Float64Array, year: number, m
  */
 export function solidEarthTide(station_ecef_m: Float64Array, year: number, month: number, day: number, fractional_hour: number, sun_ecef_m: Float64Array, moon_ecef_m: Float64Array): Float64Array;
 
+export function solveKepler(mean_anomaly_rad: number, eccentricity: number): any;
+
 /**
  * Solve a sequence of moving-baseline RTK epochs.
  *
@@ -6881,6 +7081,8 @@ export function solveRtkFixed(config: any): RtkFixedSolution;
  */
 export function solveRtkFloat(config: any): RtkFloatSolution;
 
+export function solveSppSbas(broadcast: BroadcastEphemeris, store: SbasCorrectionStore, geo: string, request: any, mode?: string | null): SppSolution;
+
 /**
  * Solve a static RTK arc with one batch float solution and one validated fixed
  * solution over the whole arc.
@@ -6937,6 +7139,8 @@ export function sp3PreciseEphemerisSamples(sp3: Sp3): any;
  */
 export function splitJdToJ2000Seconds(jd_whole: number, jd_fraction: number): number;
 
+export function ssrCorrectedState(broadcast: BroadcastEphemeris, store: SsrCorrectionStore, sat: string, t_j2000_s: number, fallback_to_broadcast?: boolean | null, allow_regional_provider?: number | null): any;
+
 /**
  * Sub-observer point (planetary central meridian) on a rotating body.
  *
@@ -7086,6 +7290,10 @@ export function tropoSlantDelay(elevation_deg: number, lat_deg: number, lon_deg:
  */
 export function tropoZenithDelay(lat_deg: number, height_m: number, met: any): ZenithDelay;
 
+export function trueToEccentric(true_anomaly_rad: number, eccentricity: number): number;
+
+export function trueToMean(true_anomaly_rad: number, eccentricity: number): number;
+
 /**
  * Provenance and coverage of the embedded UT1-UTC / delta-T (EOP) table.
  */