@neilberkman/sidereon 0.26.1 → 0.27.1

package/pkg/sidereon.js

@@ -5463,6 +5463,21 @@ export 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
@@ -5539,6 +5554,24 @@ export 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).
@@ -13588,6 +13621,38 @@ export class PredictedObservables {
 }
 if (Symbol.dispose) PredictedObservables.prototype[Symbol.dispose] = PredictedObservables.prototype.free;
 
+/**
+ * Floating-point evaluation recipe for PROJ vertical-grid interpolation.
+ * @enum {0 | 1}
+ */
+export 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",
+});
+
+/**
+ * Error category reported by PROJ vertical-grid coordinate lookup.
+ * @enum {0 | 1}
+ */
+export 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",
+});
+
 /**
  * Reason a satellite was dropped from paired pseudorange combination.
  * @enum {0 | 1 | 2 | 3}