@neilberkman/sidereon 3.0.3 → 3.0.5

package/pkg/sidereon.js

@@ -6053,7 +6053,7 @@ export class ExactCacheSingleFlightWait {
      * Observe an opaque IndexedDB owner/heartbeat revision.
      * @param {number} now_ms
      * @param {Uint8Array} revision
-     * @returns {any}
+     * @returns {ExactCacheSingleFlightDecision}
      */
     observe(now_ms, revision) {
         const ptr0 = passArray8ToWasm0(revision, wasm.__wbindgen_malloc);
@@ -7991,7 +7991,7 @@ export class GnssInsFilter {
     }
     /**
      * Build a filter, then restore its state from versioned fusion-state bytes.
-     * @param {any} config
+     * @param {FusionConfig} config
      * @param {Uint8Array} bytes
      * @returns {GnssInsFilter}
      */
@@ -8006,7 +8006,7 @@ export class GnssInsFilter {
     }
     /**
      * Build a filter from a JS configuration object.
-     * @param {any} config
+     * @param {FusionConfig} config
      */
     constructor(config) {
         const ret = wasm.gnssinsfilter_new(config);
@@ -11252,7 +11252,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Mean motion difference, radians per second.
+     * Mean motion difference, semicircles per second.
      * @returns {number}
      */
     get deltaN() {
@@ -11276,7 +11276,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Inclination at reference time, radians.
+     * Inclination at reference time, semicircles.
      * @returns {number}
      */
     get i0() {
@@ -11284,7 +11284,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Rate of inclination, radians per second.
+     * Rate of inclination, semicircles per second.
      * @returns {number}
      */
     get idot() {
@@ -11316,7 +11316,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Mean anomaly at reference time, radians.
+     * Mean anomaly at reference time, semicircles.
      * @returns {number}
      */
     get m0() {
@@ -11324,7 +11324,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Argument of perigee, radians.
+     * Argument of perigee, semicircles.
      * @returns {number}
      */
     get omega() {
@@ -11332,7 +11332,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Longitude of ascending node at weekly epoch, radians.
+     * Longitude of ascending node at weekly epoch, semicircles.
      * @returns {number}
      */
     get omega0() {
@@ -11340,7 +11340,7 @@ export class LnavDecoded {
         return ret;
     }
     /**
-     * Rate of right ascension, radians per second.
+     * Rate of right ascension, semicircles per second.
      * @returns {number}
      */
     get omegaDot() {
@@ -21972,7 +21972,7 @@ export class SmoothedTrack {
         return ret >>> 0;
     }
     /**
-     * @returns {any}
+     * @returns {SmoothedTrackEpoch[]}
      */
     get epochs() {
         const ret = wasm.smoothedtrack_epochs(this.__wbg_ptr);
@@ -22031,7 +22031,8 @@ if (Symbol.dispose) SourcedSolution.prototype[Symbol.dispose] = SourcedSolution.
  * Create with [`load_sp3`]. Query interpolated states with
  * [`Sp3.interpolate`], the exact parsed records with [`Sp3.state`], the node
  * epoch axis with [`Sp3.epochsJ2000Seconds`], run positioning with
- * [`Sp3.solveSpp`], and serialize back with [`Sp3.toSp3String`].
+ * [`Sp3.solveSpp`], and serialize back with [`Sp3.toSp3String`] or explicitly
+ * quantize record values with [`Sp3.toSp3StringWithRounding`].
  */
 export class Sp3 {
     static __wrap(ptr) {
@@ -22715,6 +22716,22 @@ export class Sp3 {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * Serialize after explicitly rounding a copy of the record values to SP3
+     * column precision. The returned report gives the maximum absolute
+     * change in each record field, in that field's SI units. Header fields
+     * and epochs retain their existing precision. Structural failures,
+     * overflow, and values that would become SP3 absence sentinels still
+     * throw a typed `Sp3WriteError`.
+     * @returns {Sp3StringWithRounding}
+     */
+    toSp3StringWithRounding() {
+        const ret = wasm.sp3_toSp3StringWithRounding(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @param {string} satellite
      * @param {ExactEpochQuery} state_epoch
@@ -22749,7 +22766,8 @@ if (Symbol.dispose) Sp3.prototype[Symbol.dispose] = Sp3.prototype.free;
 
 /**
  * Per-(epoch, satellite) agreement statistics for one accepted merged cell:
- * how tightly the consensus sources clustered about the combined value.
+ * how tightly the consensus sources clustered about the combined value,
+ * before final SP3 record-column rounding.
  */
 export class Sp3AgreementMetric {
     static __wrap(ptr) {
@@ -28182,7 +28200,7 @@ export class TrackFilter {
     }
     /**
      * Build a filter from a position fix and uncertain zero initial velocity.
-     * @param {any} config
+     * @param {TrackFilterFromPositionInput} config
      * @returns {TrackFilter}
      */
     static fromPosition(config) {
@@ -28207,8 +28225,8 @@ export class TrackFilter {
         return this;
     }
     /**
-     * @param {any} request
-     * @returns {any}
+     * @param {TrackPositionObservationInput} request
+     * @returns {TrackInnovation}
      */
     positionInnovation(request) {
         const ret = wasm.trackfilter_positionInnovation(this.__wbg_ptr, request);
@@ -28219,7 +28237,7 @@ export class TrackFilter {
     }
     /**
      * @param {number} dt_s
-     * @returns {any}
+     * @returns {TrackPrediction}
      */
     predict(dt_s) {
         const ret = wasm.trackfilter_predict(this.__wbg_ptr, dt_s);
@@ -28231,7 +28249,7 @@ export class TrackFilter {
     /**
      * @param {number} dt_s
      * @param {TrackRtsHistoryBuilder} history
-     * @returns {any}
+     * @returns {TrackPrediction}
      */
     predictRecorded(dt_s, history) {
         _assertClass(history, TrackRtsHistoryBuilder);
@@ -28252,7 +28270,7 @@ export class TrackFilter {
         }
     }
     /**
-     * @returns {any}
+     * @returns {TrackState}
      */
     get state() {
         const ret = wasm.trackfilter_state(this.__wbg_ptr);
@@ -28262,8 +28280,8 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
-     * @returns {any}
+     * @param {TrackStateObservationInput} request
+     * @returns {TrackInnovation}
      */
     stateInnovation(request) {
         const ret = wasm.trackfilter_stateInnovation(this.__wbg_ptr, request);
@@ -28273,8 +28291,8 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
-     * @returns {any}
+     * @param {TrackPositionObservationInput} request
+     * @returns {TrackUpdate}
      */
     updatePosition(request) {
         const ret = wasm.trackfilter_updatePosition(this.__wbg_ptr, request);
@@ -28284,8 +28302,8 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
-     * @returns {any}
+     * @param {TrackGatedPositionObservationInput} request
+     * @returns {TrackGatedUpdate}
      */
     updatePositionGated(request) {
         const ret = wasm.trackfilter_updatePositionGated(this.__wbg_ptr, request);
@@ -28295,9 +28313,9 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
+     * @param {TrackGatedPositionObservationInput} request
      * @param {TrackRtsHistoryBuilder} history
-     * @returns {any}
+     * @returns {TrackGatedUpdate}
      */
     updatePositionGatedRecorded(request, history) {
         _assertClass(history, TrackRtsHistoryBuilder);
@@ -28308,9 +28326,9 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
+     * @param {TrackPositionObservationInput} request
      * @param {TrackRtsHistoryBuilder} history
-     * @returns {any}
+     * @returns {TrackUpdate}
      */
     updatePositionRecorded(request, history) {
         _assertClass(history, TrackRtsHistoryBuilder);
@@ -28321,8 +28339,8 @@ export class TrackFilter {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @param {any} request
-     * @returns {any}
+     * @param {TrackStateObservationInput} request
+     * @returns {TrackUpdate}
      */
     updateState(request) {
         const ret = wasm.trackfilter_updateState(this.__wbg_ptr, request);
@@ -28359,7 +28377,7 @@ export class TrackFilterConfig {
         return ret >>> 0;
     }
     /**
-     * @returns {string}
+     * @returns {TrackCoordinateFrame}
      */
     get frame() {
         let deferred1_0;
@@ -28375,7 +28393,7 @@ export class TrackFilterConfig {
     }
     /**
      * Build a config from a position fix and uncertain zero initial velocity.
-     * @param {any} config
+     * @param {TrackFilterFromPositionInput} config
      * @returns {TrackFilterConfig}
      */
     static fromPosition(config) {
@@ -28394,7 +28412,7 @@ export class TrackFilterConfig {
     }
     /**
      * Build a no-IMU track filter config from a JS object.
-     * @param {any} config
+     * @param {TrackFilterConfigInput} config
      */
     constructor(config) {
         const ret = wasm.trackfilterconfig_new(config);
@@ -28406,7 +28424,7 @@ export class TrackFilterConfig {
         return this;
     }
     /**
-     * @returns {any}
+     * @returns {TrackFilterConfigObject}
      */
     toObject() {
         const ret = wasm.trackfilterconfig_toObject(this.__wbg_ptr);
@@ -28443,7 +28461,7 @@ export class TrackRtsHistory {
         return ret >>> 0;
     }
     /**
-     * @returns {any}
+     * @returns {TrackRtsEpoch[]}
      */
     get epochs() {
         const ret = wasm.trackrtshistory_epochs(this.__wbg_ptr);
@@ -28893,7 +28911,8 @@ export class Wgs84Geodetic {
     }
     /**
      * Build a WGS84 geodetic coordinate. `heightM` defaults to 0. Throws a
-     * `RangeError` on a non-finite field or latitude outside `[-pi/2, pi/2]`.
+     * `RangeError` on a non-finite field, latitude outside `[-pi/2, pi/2]`,
+     * or longitude outside `[-pi, pi]`.
      * @param {number} lat_rad
      * @param {number} lon_rad
      * @param {number | null} [height_m]
@@ -31274,8 +31293,8 @@ export function findMoonTransitsWithValidity(latitude_deg, longitude_deg, altitu
  * @param {string} secondary_line2
  * @param {bigint} window_start_unix_micros
  * @param {bigint} window_end_unix_micros
- * @param {any} options
- * @returns {any}
+ * @param {TcaFinderOptions | undefined | null} options
+ * @returns {TcaCandidate[]}
  */
 export function findTcaCandidates(primary_line1, primary_line2, secondary_line1, secondary_line2, window_start_unix_micros, window_end_unix_micros, options) {
     const ptr0 = passStringToWasm0(primary_line1, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -31307,9 +31326,9 @@ export function findTcaCandidates(primary_line1, primary_line2, secondary_line1,
  * @param {string} secondary_line2
  * @param {bigint} window_start_unix_micros
  * @param {bigint} window_end_unix_micros
- * @param {any} pc_options
- * @param {any} options
- * @returns {any}
+ * @param {TcaPcOptions} pc_options
+ * @param {TcaFinderOptions | undefined | null} options
+ * @returns {TcaConjunction[]}
  */
 export function findTcaConjunctions(primary_line1, primary_line2, secondary_line1, secondary_line2, window_start_unix_micros, window_end_unix_micros, pc_options, options) {
     const ptr0 = passStringToWasm0(primary_line1, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -31333,8 +31352,8 @@ export function findTcaConjunctions(primary_line1, primary_line2, secondary_line
  * The residual ledger is computed against the original Earth-fixed SP3
  * observations by the core fit path.
  * @param {Sp3} sp3
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 export function fitAllSp3EcefPreciseOrbits(sp3, options) {
     _assertClass(sp3, Sp3);
@@ -31438,10 +31457,10 @@ export function fitPowerLawNoise(adev, mdev, options) {
  * `samples` is the same array accepted by `preciseEphemerisSamplesFromSamples`:
  * `{ sat, epoch, positionEcefM, clockS?, clockEvent? }` with epochs in seconds
  * since J2000.
- * @param {any} samples
+ * @param {Sp3PreciseEphemerisSample[]} samples
  * @param {string} satellite
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 export function fitPreciseEphemerisSampleOrbit(samples, satellite, options) {
     const ptr0 = passStringToWasm0(satellite, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -31522,8 +31541,8 @@ export function fitReducedOrbitTle(tle, options) {
  * core `TdbEarthOrientationProvider` before fitting.
  * @param {Sp3} sp3
  * @param {string} satellite
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 export function fitSp3EcefPreciseOrbit(sp3, satellite, options) {
     _assertClass(sp3, Sp3);
@@ -31542,9 +31561,9 @@ export function fitSp3EcefPreciseOrbit(sp3, satellite, options) {
  * `satellites` is a string array of IGS tokens such as `["G01", "G02"]`.
  * The Earth-fixed to inertial conversion is handled by the core provider.
  * @param {Sp3} sp3
- * @param {any} satellites
- * @param {any} options
- * @returns {any}
+ * @param {string[]} satellites
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 export function fitSp3EcefPreciseOrbits(sp3, satellites, options) {
     _assertClass(sp3, Sp3);
@@ -31563,8 +31582,8 @@ export function fitSp3EcefPreciseOrbits(sp3, satellites, options) {
  * `linearSolve`, `minLedgerSamples`, and `drag`.
  * @param {Sp3} sp3
  * @param {string} satellite
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 export function fitSp3PreciseOrbit(sp3, satellite, options) {
     _assertClass(sp3, Sp3);
@@ -37104,12 +37123,12 @@ export function scenarioSchemaVersion() {
  * `sidereon_core::astro::tca::screen_tca_candidates_from_tle_catalog_serial`.
  * @param {string} primary_line1
  * @param {string} primary_line2
- * @param {any} secondaries
+ * @param {TcaTle[]} secondaries
  * @param {bigint} window_start_unix_micros
  * @param {bigint} window_end_unix_micros
  * @param {number} miss_distance_threshold_km
- * @param {any} options
- * @returns {any}
+ * @param {TcaFinderOptions | undefined | null} options
+ * @returns {TcaScreeningHit[]}
  */
 export function screenTcaCandidates(primary_line1, primary_line2, secondaries, window_start_unix_micros, window_end_unix_micros, miss_distance_threshold_km, options) {
     const ptr0 = passStringToWasm0(primary_line1, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -37132,13 +37151,13 @@ export function screenTcaCandidates(primary_line1, primary_line2, secondaries, w
  * `sidereon_core::astro::tca::screen_tca_conjunctions_from_tle_catalog_serial`.
  * @param {string} primary_line1
  * @param {string} primary_line2
- * @param {any} secondaries
+ * @param {TcaTle[]} secondaries
  * @param {bigint} window_start_unix_micros
  * @param {bigint} window_end_unix_micros
  * @param {number} miss_distance_threshold_km
- * @param {any} pc_options
- * @param {any} options
- * @returns {any}
+ * @param {TcaPcOptions} pc_options
+ * @param {TcaFinderOptions | undefined | null} options
+ * @returns {TcaScreeningConjunctionHit[]}
  */
 export function screenTcaConjunctions(primary_line1, primary_line2, secondaries, window_start_unix_micros, window_end_unix_micros, miss_distance_threshold_km, pc_options, options) {
     const ptr0 = passStringToWasm0(primary_line1, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);