@neilberkman/sidereon 3.0.3 → 3.0.5

package/pkg-node/sidereon.js

@@ -6109,7 +6109,7 @@ 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);
@@ -8070,7 +8070,7 @@ 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}
      */
@@ -8085,7 +8085,7 @@ class GnssInsFilter {
     }
     /**
      * Build a filter from a JS configuration object.
-     * @param {any} config
+     * @param {FusionConfig} config
      */
     constructor(config) {
         const ret = wasm.gnssinsfilter_new(config);
@@ -11362,7 +11362,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Mean motion difference, radians per second.
+     * Mean motion difference, semicircles per second.
      * @returns {number}
      */
     get deltaN() {
@@ -11386,7 +11386,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Inclination at reference time, radians.
+     * Inclination at reference time, semicircles.
      * @returns {number}
      */
     get i0() {
@@ -11394,7 +11394,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Rate of inclination, radians per second.
+     * Rate of inclination, semicircles per second.
      * @returns {number}
      */
     get idot() {
@@ -11426,7 +11426,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Mean anomaly at reference time, radians.
+     * Mean anomaly at reference time, semicircles.
      * @returns {number}
      */
     get m0() {
@@ -11434,7 +11434,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Argument of perigee, radians.
+     * Argument of perigee, semicircles.
      * @returns {number}
      */
     get omega() {
@@ -11442,7 +11442,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Longitude of ascending node at weekly epoch, radians.
+     * Longitude of ascending node at weekly epoch, semicircles.
      * @returns {number}
      */
     get omega0() {
@@ -11450,7 +11450,7 @@ class LnavDecoded {
         return ret;
     }
     /**
-     * Rate of right ascension, radians per second.
+     * Rate of right ascension, semicircles per second.
      * @returns {number}
      */
     get omegaDot() {
@@ -22178,7 +22178,7 @@ class SmoothedTrack {
         return ret >>> 0;
     }
     /**
-     * @returns {any}
+     * @returns {SmoothedTrackEpoch[]}
      */
     get epochs() {
         const ret = wasm.smoothedtrack_epochs(this.__wbg_ptr);
@@ -22239,7 +22239,8 @@ exports.SourcedSolution = 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`].
  */
 class Sp3 {
     static __wrap(ptr) {
@@ -22923,6 +22924,22 @@ 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
@@ -22958,7 +22975,8 @@ exports.Sp3 = Sp3;
 
 /**
  * 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.
  */
 class Sp3AgreementMetric {
     static __wrap(ptr) {
@@ -28447,7 +28465,7 @@ 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) {
@@ -28472,8 +28490,8 @@ 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);
@@ -28484,7 +28502,7 @@ class TrackFilter {
     }
     /**
      * @param {number} dt_s
-     * @returns {any}
+     * @returns {TrackPrediction}
      */
     predict(dt_s) {
         const ret = wasm.trackfilter_predict(this.__wbg_ptr, dt_s);
@@ -28496,7 +28514,7 @@ class TrackFilter {
     /**
      * @param {number} dt_s
      * @param {TrackRtsHistoryBuilder} history
-     * @returns {any}
+     * @returns {TrackPrediction}
      */
     predictRecorded(dt_s, history) {
         _assertClass(history, TrackRtsHistoryBuilder);
@@ -28517,7 +28535,7 @@ class TrackFilter {
         }
     }
     /**
-     * @returns {any}
+     * @returns {TrackState}
      */
     get state() {
         const ret = wasm.trackfilter_state(this.__wbg_ptr);
@@ -28527,8 +28545,8 @@ 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);
@@ -28538,8 +28556,8 @@ 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);
@@ -28549,8 +28567,8 @@ 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);
@@ -28560,9 +28578,9 @@ 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);
@@ -28573,9 +28591,9 @@ 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);
@@ -28586,8 +28604,8 @@ 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);
@@ -28625,7 +28643,7 @@ class TrackFilterConfig {
         return ret >>> 0;
     }
     /**
-     * @returns {string}
+     * @returns {TrackCoordinateFrame}
      */
     get frame() {
         let deferred1_0;
@@ -28641,7 +28659,7 @@ 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) {
@@ -28660,7 +28678,7 @@ 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);
@@ -28672,7 +28690,7 @@ class TrackFilterConfig {
         return this;
     }
     /**
-     * @returns {any}
+     * @returns {TrackFilterConfigObject}
      */
     toObject() {
         const ret = wasm.trackfilterconfig_toObject(this.__wbg_ptr);
@@ -28710,7 +28728,7 @@ class TrackRtsHistory {
         return ret >>> 0;
     }
     /**
-     * @returns {any}
+     * @returns {TrackRtsEpoch[]}
      */
     get epochs() {
         const ret = wasm.trackrtshistory_epochs(this.__wbg_ptr);
@@ -29167,7 +29185,8 @@ 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]
@@ -31671,8 +31690,8 @@ exports.findMoonTransitsWithValidity = findMoonTransitsWithValidity;
  * @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[]}
  */
 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);
@@ -31705,9 +31724,9 @@ exports.findTcaCandidates = findTcaCandidates;
  * @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[]}
  */
 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);
@@ -31732,8 +31751,8 @@ exports.findTcaConjunctions = findTcaConjunctions;
  * 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}
  */
 function fitAllSp3EcefPreciseOrbits(sp3, options) {
     _assertClass(sp3, Sp3);
@@ -31842,10 +31861,10 @@ exports.fitPowerLawNoise = fitPowerLawNoise;
  * `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}
  */
 function fitPreciseEphemerisSampleOrbit(samples, satellite, options) {
     const ptr0 = passStringToWasm0(satellite, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -31930,8 +31949,8 @@ exports.fitReducedOrbitTle = fitReducedOrbitTle;
  * core `TdbEarthOrientationProvider` before fitting.
  * @param {Sp3} sp3
  * @param {string} satellite
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 function fitSp3EcefPreciseOrbit(sp3, satellite, options) {
     _assertClass(sp3, Sp3);
@@ -31951,9 +31970,9 @@ exports.fitSp3EcefPreciseOrbit = fitSp3EcefPreciseOrbit;
  * `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}
  */
 function fitSp3EcefPreciseOrbits(sp3, satellites, options) {
     _assertClass(sp3, Sp3);
@@ -31973,8 +31992,8 @@ exports.fitSp3EcefPreciseOrbits = fitSp3EcefPreciseOrbits;
  * `linearSolve`, `minLedgerSamples`, and `drag`.
  * @param {Sp3} sp3
  * @param {string} satellite
- * @param {any} options
- * @returns {any}
+ * @param {OrbitFitOptions | undefined | null} options
+ * @returns {OrbitFitReport}
  */
 function fitSp3PreciseOrbit(sp3, satellite, options) {
     _assertClass(sp3, Sp3);
@@ -37809,12 +37828,12 @@ exports.scenarioSchemaVersion = 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[]}
  */
 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);
@@ -37838,13 +37857,13 @@ exports.screenTcaCandidates = screenTcaCandidates;
  * `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[]}
  */
 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);