@neilberkman/sidereon 0.26.1 → 0.27.1

package/pkg-node/sidereon.d.ts

@@ -2788,6 +2788,11 @@ export class GeoidGrid {
      * Parse an EGM96 `WW15MGH.DAC` byte buffer into a full-resolution grid.
      */
     static fromEgm96Dac(bytes: Uint8Array): GeoidGrid;
+    /**
+     * Parse PROJ's public EGM96 15-arcminute `egm96_15.gtx` byte stream.
+     * Use `undulationProjRad` with an explicit arithmetic recipe.
+     */
+    static fromProjEgm96Gtx(bytes: Uint8Array): GeoidGrid;
     /**
      * Parse a grid from the documented whitespace-delimited text format (a
      * six-field header `lat_min lon_min dlat dlon n_lat n_lon` followed by
@@ -2817,6 +2822,14 @@ export class GeoidGrid {
      * degrees (latitude positive north, longitude positive east).
      */
     undulationDeg(lat_deg: number, lon_deg: number): number;
+    /**
+     * Evaluate PROJ 9.3.0-compatible vertical-grid interpolation at geodetic
+     * radians. The caller must select separate or fused multiply/add behavior;
+     * no platform-dependent default is inferred. Invalid coordinates throw a
+     * `RangeError` with machine-readable `kind`, `coordinate`, and `detail`
+     * properties.
+     */
+    undulationProjRad(lat_rad: number, lon_rad: number, arithmetic: ProjVgridshiftArithmetic): number;
     /**
      * Bilinearly interpolated undulation `N` (metres) at a geodetic position in
      * radians (latitude positive north, longitude positive east).
@@ -5930,6 +5943,36 @@ export class PredictedObservables {
     readonly transmitTimeJ2000S: number;
 }
 
+/**
+ * Floating-point evaluation recipe for PROJ vertical-grid interpolation.
+ */
+export enum ProjVgridshiftArithmetic {
+    /**
+     * Round every multiplication and addition separately. This matches the
+     * reviewed x86-64 PROJ 9.3.0 build with contraction disabled.
+     */
+    SeparateMultiplyAdd = 0,
+    /**
+     * Evaluate each accumulation with a fused multiply-add and one rounding.
+     * This matches the contracted AArch64 PROJ 9.3.0 reference build.
+     */
+    FusedMultiplyAdd = 1,
+}
+
+/**
+ * Error category reported by PROJ vertical-grid coordinate lookup.
+ */
+export enum ProjVgridshiftError {
+    /**
+     * Latitude or longitude was not finite.
+     */
+    NonFiniteCoordinate = 0,
+    /**
+     * Latitude or longitude was outside the loaded grid.
+     */
+    CoordinateOutsideGrid = 1,
+}
+
 /**
  * Reason a satellite was dropped from paired pseudorange combination.
  */

package/pkg-node/sidereon.js

@@ -5531,6 +5531,21 @@ class GeoidGrid {
         }
         return GeoidGrid.__wrap(ret[0]);
     }
+    /**
+     * Parse PROJ's public EGM96 15-arcminute `egm96_15.gtx` byte stream.
+     * Use `undulationProjRad` with an explicit arithmetic recipe.
+     * @param {Uint8Array} bytes
+     * @returns {GeoidGrid}
+     */
+    static fromProjEgm96Gtx(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.geoidgrid_fromProjEgm96Gtx(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return GeoidGrid.__wrap(ret[0]);
+    }
     /**
      * Parse a grid from the documented whitespace-delimited text format (a
      * six-field header `lat_min lon_min dlat dlon n_lat n_lon` followed by
@@ -5607,6 +5622,24 @@ class GeoidGrid {
         const ret = wasm.geoidgrid_undulationDeg(this.__wbg_ptr, lat_deg, lon_deg);
         return ret;
     }
+    /**
+     * Evaluate PROJ 9.3.0-compatible vertical-grid interpolation at geodetic
+     * radians. The caller must select separate or fused multiply/add behavior;
+     * no platform-dependent default is inferred. Invalid coordinates throw a
+     * `RangeError` with machine-readable `kind`, `coordinate`, and `detail`
+     * properties.
+     * @param {number} lat_rad
+     * @param {number} lon_rad
+     * @param {ProjVgridshiftArithmetic} arithmetic
+     * @returns {number}
+     */
+    undulationProjRad(lat_rad, lon_rad, arithmetic) {
+        const ret = wasm.geoidgrid_undulationProjRad(this.__wbg_ptr, lat_rad, lon_rad, arithmetic);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0];
+    }
     /**
      * Bilinearly interpolated undulation `N` (metres) at a geodetic position in
      * radians (latitude positive north, longitude positive east).
@@ -13739,6 +13772,40 @@ class PredictedObservables {
 if (Symbol.dispose) PredictedObservables.prototype[Symbol.dispose] = PredictedObservables.prototype.free;
 exports.PredictedObservables = PredictedObservables;
 
+/**
+ * Floating-point evaluation recipe for PROJ vertical-grid interpolation.
+ * @enum {0 | 1}
+ */
+const ProjVgridshiftArithmetic = Object.freeze({
+    /**
+     * Round every multiplication and addition separately. This matches the
+     * reviewed x86-64 PROJ 9.3.0 build with contraction disabled.
+     */
+    SeparateMultiplyAdd: 0, "0": "SeparateMultiplyAdd",
+    /**
+     * Evaluate each accumulation with a fused multiply-add and one rounding.
+     * This matches the contracted AArch64 PROJ 9.3.0 reference build.
+     */
+    FusedMultiplyAdd: 1, "1": "FusedMultiplyAdd",
+});
+exports.ProjVgridshiftArithmetic = ProjVgridshiftArithmetic;
+
+/**
+ * Error category reported by PROJ vertical-grid coordinate lookup.
+ * @enum {0 | 1}
+ */
+const ProjVgridshiftError = Object.freeze({
+    /**
+     * Latitude or longitude was not finite.
+     */
+    NonFiniteCoordinate: 0, "0": "NonFiniteCoordinate",
+    /**
+     * Latitude or longitude was outside the loaded grid.
+     */
+    CoordinateOutsideGrid: 1, "1": "CoordinateOutsideGrid",
+});
+exports.ProjVgridshiftError = ProjVgridshiftError;
+
 /**
  * Reason a satellite was dropped from paired pseudorange combination.
  * @enum {0 | 1 | 2 | 3}