gnss-js 1.65.0 → 1.66.0

package/dist/rtcm2.d.cts

@@ -0,0 +1,116 @@
+/**
+ * RTCM 2.x decoder (RTCM 10402.3). A wholly different wire format from RTCM3:
+ * a stream of 30-bit GPS-style words (24 data + 6 parity bits), each carried in
+ * the low 6 bits of successive bytes ("6-of-8" — every byte has its top two
+ * bits set to 01, so 0x40–0x7F). Words are parity-checked and their D30* bit
+ * inverts the following data, exactly like the GPS LNAV navigation message.
+ *
+ * Framing/parity are a faithful port of RTKLIB `input_rtcm2` + `decode_word`.
+ * {@link Rtcm2Decoder.decode} strips the encoding, parity-checks, syncs on the
+ * 0x66 preamble and returns the message frames (header + the packed 24-bit-word
+ * body); the per-type body decoders (`rtcm2Station`, `rtcm2Observation`,
+ * `rtcm2Dgps`, `rtcm2Time`, `rtcm2Text`) read that body.
+ *
+ * Nearly extinct in favour of RTCM3, but still broadcast by some legacy CORS.
+ */
+/** One decoded RTCM 2.x message frame (header + packed 24-bit-word body). */
+interface Rtcm2Frame {
+    messageType: number;
+    stationId: number;
+    /** Modified Z-count, seconds within the hour (0–3599.4). */
+    zcountSec: number;
+    sequenceNo: number;
+    /** Station health (3-bit). */
+    health: number;
+    /** Number of 24-bit data words after the 2-word header. */
+    lengthWords: number;
+    /** The parity-stripped message: header + data words, 24 bits per word packed
+     *  MSB-first into bytes (message type at bit 8, body from bit 48). */
+    payload: Uint8Array;
+}
+/**
+ * Streaming RTCM 2.x framer. Feed bytes; get back complete, parity-valid
+ * message frames. Retains partial-word state across calls.
+ */
+declare class Rtcm2Decoder {
+    private word;
+    private nbyte;
+    private nbit;
+    private len;
+    private buff;
+    /** Reset the framer (e.g. after a stream reconnect). */
+    reset(): void;
+    decode(bytes: Uint8Array): Rtcm2Frame[];
+    private readHeader;
+}
+/** Reference-station coordinates from Type 3 (ARP) or Type 22 (extension). */
+interface Rtcm2Station {
+    /** ECEF position (m) — Type 3. */
+    position?: [number, number, number];
+    /** L1 phase-centre → ARP offset (m) — Type 22. */
+    l1Offset?: [number, number, number];
+    /** Antenna height above the monument (m) — Type 22. */
+    height?: number;
+}
+/** Decode Type 3 (reference station ARP) or Type 22 (extended parameters). */
+declare function rtcm2Station(frame: Rtcm2Frame): Rtcm2Station | null;
+/** One raw observation record from a Type 18/19 message. */
+interface Rtcm2ObsRecord {
+    prn: string;
+    system: 'G' | 'R';
+    /** Frequency: 0 = L1, 1 = L2. */
+    freq: number;
+    code: 'C/A' | 'P';
+    /** Carrier phase (cycles) — Type 18. */
+    phaseCycles?: number;
+    /** Pseudorange (m) — Type 19. */
+    pseudorangeM?: number;
+    /** Loss-of-lock indicator (Type 18). */
+    lossOfLock?: number;
+}
+/** Decode a Type 18 (carrier phase) or Type 19 (pseudorange) message into its
+ *  per-satellite records. Returns the frequency, the multiple-message sync flag
+ *  and the records; the caller pairs 18+19 across an epoch to form observations.
+ *  Returns null for other types or an L2-frequency variant we don't map. */
+declare function rtcm2Observation(frame: Rtcm2Frame): {
+    freq: number;
+    sync: boolean;
+    microSec: number;
+    records: Rtcm2ObsRecord[];
+} | null;
+/** One differential correction from a Type 1/9 (GPS) or Type 31 (GLONASS). */
+interface Rtcm2Correction {
+    prn: string;
+    /** Pseudorange correction (m). */
+    prc: number;
+    /** Range-rate correction (m/s). */
+    rrc: number;
+    /** Issue of data. */
+    iod: number;
+    /** UDRE scale index (0–3). */
+    udre: number;
+}
+/** Decode differential corrections — Type 1/9 (GPS) or Type 31 (GLONASS). */
+declare function rtcm2Dgps(frame: Rtcm2Frame): {
+    system: 'G' | 'R';
+    corrections: Rtcm2Correction[];
+} | null;
+/** Decode Type 14 — GPS time of week (week/hour + leap seconds). */
+declare function rtcm2Time(frame: Rtcm2Frame): {
+    week: number;
+    hour: number;
+    zcountSec: number;
+    leapSeconds: number;
+} | null;
+/** Decode Type 16 — GPS special (ASCII text) message. */
+declare function rtcm2Text(frame: Rtcm2Frame): string | null;
+/** RTCM 2.x message-type names for the census/inspector. */
+declare const RTCM2_MESSAGE_NAMES: Record<number, string>;
+/**
+ * Heuristic: does this buffer look like an RTCM 2.x stream? Every byte must be
+ * 6-of-8 (top two bits 01), and the framer must extract at least two
+ * parity-valid frames from the head.
+ */
+declare function looksLikeRtcm2(bytes: Uint8Array): boolean;
+
+export { RTCM2_MESSAGE_NAMES, type Rtcm2Correction, Rtcm2Decoder, type Rtcm2Frame, type Rtcm2ObsRecord, type Rtcm2Station, looksLikeRtcm2, rtcm2Dgps, rtcm2Observation, rtcm2Station, rtcm2Text, rtcm2Time };

package/dist/rtcm2.d.ts

@@ -0,0 +1,116 @@
+/**
+ * RTCM 2.x decoder (RTCM 10402.3). A wholly different wire format from RTCM3:
+ * a stream of 30-bit GPS-style words (24 data + 6 parity bits), each carried in
+ * the low 6 bits of successive bytes ("6-of-8" — every byte has its top two
+ * bits set to 01, so 0x40–0x7F). Words are parity-checked and their D30* bit
+ * inverts the following data, exactly like the GPS LNAV navigation message.
+ *
+ * Framing/parity are a faithful port of RTKLIB `input_rtcm2` + `decode_word`.
+ * {@link Rtcm2Decoder.decode} strips the encoding, parity-checks, syncs on the
+ * 0x66 preamble and returns the message frames (header + the packed 24-bit-word
+ * body); the per-type body decoders (`rtcm2Station`, `rtcm2Observation`,
+ * `rtcm2Dgps`, `rtcm2Time`, `rtcm2Text`) read that body.
+ *
+ * Nearly extinct in favour of RTCM3, but still broadcast by some legacy CORS.
+ */
+/** One decoded RTCM 2.x message frame (header + packed 24-bit-word body). */
+interface Rtcm2Frame {
+    messageType: number;
+    stationId: number;
+    /** Modified Z-count, seconds within the hour (0–3599.4). */
+    zcountSec: number;
+    sequenceNo: number;
+    /** Station health (3-bit). */
+    health: number;
+    /** Number of 24-bit data words after the 2-word header. */
+    lengthWords: number;
+    /** The parity-stripped message: header + data words, 24 bits per word packed
+     *  MSB-first into bytes (message type at bit 8, body from bit 48). */
+    payload: Uint8Array;
+}
+/**
+ * Streaming RTCM 2.x framer. Feed bytes; get back complete, parity-valid
+ * message frames. Retains partial-word state across calls.
+ */
+declare class Rtcm2Decoder {
+    private word;
+    private nbyte;
+    private nbit;
+    private len;
+    private buff;
+    /** Reset the framer (e.g. after a stream reconnect). */
+    reset(): void;
+    decode(bytes: Uint8Array): Rtcm2Frame[];
+    private readHeader;
+}
+/** Reference-station coordinates from Type 3 (ARP) or Type 22 (extension). */
+interface Rtcm2Station {
+    /** ECEF position (m) — Type 3. */
+    position?: [number, number, number];
+    /** L1 phase-centre → ARP offset (m) — Type 22. */
+    l1Offset?: [number, number, number];
+    /** Antenna height above the monument (m) — Type 22. */
+    height?: number;
+}
+/** Decode Type 3 (reference station ARP) or Type 22 (extended parameters). */
+declare function rtcm2Station(frame: Rtcm2Frame): Rtcm2Station | null;
+/** One raw observation record from a Type 18/19 message. */
+interface Rtcm2ObsRecord {
+    prn: string;
+    system: 'G' | 'R';
+    /** Frequency: 0 = L1, 1 = L2. */
+    freq: number;
+    code: 'C/A' | 'P';
+    /** Carrier phase (cycles) — Type 18. */
+    phaseCycles?: number;
+    /** Pseudorange (m) — Type 19. */
+    pseudorangeM?: number;
+    /** Loss-of-lock indicator (Type 18). */
+    lossOfLock?: number;
+}
+/** Decode a Type 18 (carrier phase) or Type 19 (pseudorange) message into its
+ *  per-satellite records. Returns the frequency, the multiple-message sync flag
+ *  and the records; the caller pairs 18+19 across an epoch to form observations.
+ *  Returns null for other types or an L2-frequency variant we don't map. */
+declare function rtcm2Observation(frame: Rtcm2Frame): {
+    freq: number;
+    sync: boolean;
+    microSec: number;
+    records: Rtcm2ObsRecord[];
+} | null;
+/** One differential correction from a Type 1/9 (GPS) or Type 31 (GLONASS). */
+interface Rtcm2Correction {
+    prn: string;
+    /** Pseudorange correction (m). */
+    prc: number;
+    /** Range-rate correction (m/s). */
+    rrc: number;
+    /** Issue of data. */
+    iod: number;
+    /** UDRE scale index (0–3). */
+    udre: number;
+}
+/** Decode differential corrections — Type 1/9 (GPS) or Type 31 (GLONASS). */
+declare function rtcm2Dgps(frame: Rtcm2Frame): {
+    system: 'G' | 'R';
+    corrections: Rtcm2Correction[];
+} | null;
+/** Decode Type 14 — GPS time of week (week/hour + leap seconds). */
+declare function rtcm2Time(frame: Rtcm2Frame): {
+    week: number;
+    hour: number;
+    zcountSec: number;
+    leapSeconds: number;
+} | null;
+/** Decode Type 16 — GPS special (ASCII text) message. */
+declare function rtcm2Text(frame: Rtcm2Frame): string | null;
+/** RTCM 2.x message-type names for the census/inspector. */
+declare const RTCM2_MESSAGE_NAMES: Record<number, string>;
+/**
+ * Heuristic: does this buffer look like an RTCM 2.x stream? Every byte must be
+ * 6-of-8 (top two bits 01), and the framer must extract at least two
+ * parity-valid frames from the head.
+ */
+declare function looksLikeRtcm2(bytes: Uint8Array): boolean;
+
+export { RTCM2_MESSAGE_NAMES, type Rtcm2Correction, Rtcm2Decoder, type Rtcm2Frame, type Rtcm2ObsRecord, type Rtcm2Station, looksLikeRtcm2, rtcm2Dgps, rtcm2Observation, rtcm2Station, rtcm2Text, rtcm2Time };

package/dist/rtcm2.js

@@ -0,0 +1,20 @@
+import {
+  RTCM2_MESSAGE_NAMES,
+  Rtcm2Decoder,
+  looksLikeRtcm2,
+  rtcm2Dgps,
+  rtcm2Observation,
+  rtcm2Station,
+  rtcm2Text,
+  rtcm2Time
+} from "./chunk-S624C5AC.js";
+export {
+  RTCM2_MESSAGE_NAMES,
+  Rtcm2Decoder,
+  looksLikeRtcm2,
+  rtcm2Dgps,
+  rtcm2Observation,
+  rtcm2Station,
+  rtcm2Text,
+  rtcm2Time
+};

package/dist/sbf.js

@@ -24,15 +24,15 @@ import {
   sbasL5MessageName,
   sbasL5MessageType,
   scanSbfFrames
-} from "./chunk-UHLUAU6H.js";
-import "./chunk-FA2UTLEQ.js";
+} from "./chunk-WW3DKCDN.js";
+import "./chunk-3KSDL3CO.js";
 import "./chunk-WQX354KD.js";
+import "./chunk-HVXYFUCB.js";
 import "./chunk-37QNKGTC.js";
+import "./chunk-LEEU5OIO.js";
 import "./chunk-6FAL6P4G.js";
 import "./chunk-YUW33VXK.js";
 import "./chunk-V2D5KUKH.js";
-import "./chunk-HVXYFUCB.js";
-import "./chunk-LEEU5OIO.js";
 export {
   SBAS_L5_MT_NAMES,
   SBAS_L5_PREAMBLE_UW,

package/dist/ubx.js

@@ -6,13 +6,13 @@ import {
   parseUbxRawNav,
   parseUbxRawx,
   ubxFrames
-} from "./chunk-MRC6LIPM.js";
-import "./chunk-FA2UTLEQ.js";
+} from "./chunk-GH7MYXON.js";
+import "./chunk-3KSDL3CO.js";
 import "./chunk-WQX354KD.js";
-import "./chunk-YUW33VXK.js";
-import "./chunk-V2D5KUKH.js";
 import "./chunk-HVXYFUCB.js";
 import "./chunk-LEEU5OIO.js";
+import "./chunk-YUW33VXK.js";
+import "./chunk-V2D5KUKH.js";
 export {
   parseUbxCnav,
   parseUbxIonoUtc,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "1.65.0",
+  "version": "1.66.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,
@@ -55,6 +55,11 @@
       "import": "./dist/binex.js",
       "require": "./dist/binex.cjs"
     },
+    "./rtcm2": {
+      "types": "./dist/rtcm2.d.ts",
+      "import": "./dist/rtcm2.js",
+      "require": "./dist/rtcm2.cjs"
+    },
     "./rtcm3": {
       "types": "./dist/rtcm3.d.ts",
       "import": "./dist/rtcm3.js",

package/dist/{chunk-FA2UTLEQ.js → chunk-3KSDL3CO.js}

@@ -1,3 +1,6 @@
+import {
+  getUtcDate
+} from "./chunk-HVXYFUCB.js";
 import {
   crc24q
 } from "./chunk-YUW33VXK.js";
@@ -6,9 +9,6 @@ import {
   getBitS,
   getBitU
 } from "./chunk-V2D5KUKH.js";
-import {
-  getUtcDate
-} from "./chunk-HVXYFUCB.js";
 
 // src/navbits/bds.ts
 var BDT_EPOCH_MS = Date.UTC(2006, 0, 1);

package/dist/{chunk-MHGNKSSH.js → chunk-JYWYQ7DW.js}

@@ -1,9 +1,9 @@
-import {
-  ecefToGeodetic
-} from "./chunk-37QNKGTC.js";
 import {
   getGpsLeap
 } from "./chunk-HVXYFUCB.js";
+import {
+  ecefToGeodetic
+} from "./chunk-37QNKGTC.js";
 import {
   START_BDS_TIME,
   START_GPS_TIME

package/dist/{chunk-KUTNIP3O.js → chunk-SEYH4BEN.js}

@@ -1,6 +1,9 @@
 import {
   decodeSbasGeoNav
 } from "./chunk-WQX354KD.js";
+import {
+  getUtcDate
+} from "./chunk-HVXYFUCB.js";
 import {
   CnavAssembler,
   cnavCrcOk
@@ -8,9 +11,6 @@ import {
 import {
   decodeGpsLnavFrame
 } from "./chunk-V2D5KUKH.js";
-import {
-  getUtcDate
-} from "./chunk-HVXYFUCB.js";
 
 // src/novatel/frame.ts
 var OEM4_HLEN = 28;