gnss-js 2.9.0 → 2.10.0

package/dist/rtcm3.d.ts

@@ -1,5 +1,7 @@
 import { b as Rtcm3Frame, E as EphemerisInfo } from './ephemeris-BAnBLLB9.js';
 export { B as BitReader, R as Rtcm3DebugHandler, a as Rtcm3Decoder, d as decodeEphemeris, r as readString, c as reportDecodeError, s as setRtcm3DebugHandler } from './ephemeris-BAnBLLB9.js';
+import { a as ObsEpoch, O as ObsDecodeOptions } from './msm-CcQJV3PC.js';
+export { b as ObsSatObs, c as ObsSignal, d as decodeMsmFull, o as obsEpochToDate, r as resetGloFreqCache, s as setGloFreqNumber } from './msm-CcQJV3PC.js';
 
 /** One code bias for a specific signal (DF380/DF381 + DF383). */
 interface SsrCodeBias {
@@ -116,91 +118,6 @@ interface IgsSsrIonoLayer {
  */
 declare function decodeIgsSsr(frame: Rtcm3Frame): IgsSsrMessage | null;
 
-/**
- * Full RTCM3 MSM4-7 decoder — extracts pseudorange, carrier phase,
- * Doppler, and C/N0 for every satellite × signal cell.
- *
- * Reference: BNC 2.13.4 RTCM3Decoder.cpp (BKG) and RTCM 10403.3 §3.5.
- *
- * Only MSM types 4-7 are decoded (full data). Types 1-3 carry partial
- * data and are skipped.
- */
-
-/** Single signal observation for one satellite */
-interface ObsSignal {
-    /** RINEX 2-char obs code, e.g. "1C", "5X" */
-    rinexCode: string;
-    /** Pseudorange in meters (undefined if invalid) */
-    pseudorange?: number;
-    /** Carrier phase in cycles (undefined if invalid) */
-    phase?: number;
-    /** Doppler in Hz (undefined if invalid) */
-    doppler?: number;
-    /** Signal-to-noise ratio in dB-Hz */
-    cn0?: number;
-    /** Lock time in seconds */
-    lockTime?: number;
-    /** Half-cycle ambiguity indicator */
-    halfCycle?: boolean;
-    /** Wavelength used (meters) — needed for RINEX phase */
-    wavelength: number;
-}
-/** All observations for one satellite in one epoch */
-interface ObsSatObs {
-    /** PRN string, e.g. "G01", "R15", "E04" */
-    prn: string;
-    /** System letter: G, R, E, C, J, I, S */
-    system: string;
-    /** Signal observations */
-    signals: ObsSignal[];
-}
-/**
- * One decoded observation epoch. Originally the MSM4–7 output shape, now the
- * neutral shape every RTCM3 obs source fills: MSM (`decodeMsmFull`), legacy
- * 1001–1012 (`decodeLegacyObs`), via the `decodeObs` dispatcher.
- */
-interface ObsEpoch {
-    /** Message type (1074, 1077, etc.) */
-    messageType: number;
-    /** Epoch time as GPS milliseconds of week (or GLONASS day-of-week ms, BDS SOW) */
-    epochMs: number;
-    /** System letter */
-    system: string;
-    /** Observations per satellite */
-    observations: ObsSatObs[];
-}
-/**
- * Decode a single RTCM3 MSM4-7 frame into full observations.
- * Returns null for non-MSM or MSM1-3 frames.
- */
-declare function decodeMsmFull(frame: Rtcm3Frame): ObsEpoch | null;
-/**
- * Convert an observation epoch timestamp to a Date.
- * For GPS/Galileo/BDS/QZSS: epochMs is ms of GPS week.
- * For GLONASS: epochMs is day-of-week × 86400000 + ms of day (UTC+3).
- *
- * Requires an approximate reference time to resolve the current week.
- */
-/**
- * NOTE: returns a GPS-scale Date — the clock-face convention used by
- * the RINEX parser and every consumer of epoch milliseconds in this
- * library (satellite propagation, SPP, RINEX epoch tags). It is NOT
- * UTC: converting to UTC here put every downstream satellite position
- * 18 s (the current leap-second count) off — a ±14 km per-satellite
- * range error that scattered live SPP solutions by kilometres.
- */
-declare function obsEpochToDate(sys: string, epochMs: number, refTime?: Date): Date;
-/**
- * Set a GLONASS FDMA frequency number (k = -7..+13) for a slot (1-24),
- * e.g. from a decoded 1020 ephemeris. MSM4/6 carry no DF419, so without
- * this the wavelength — and hence carrier phase — stays unknown.
- */
-declare function setGloFreqNumber(slot: number, k: number): void;
-/**
- * Reset the GLONASS frequency number cache (e.g., when switching mountpoints).
- */
-declare function resetGloFreqCache(): void;
-
 /**
  * Decode a legacy RTCM3 observation frame (1001–1004 GPS, 1009–1012 GLONASS)
  * into an {@link ObsEpoch}, or null for any other message type.
@@ -208,13 +125,14 @@ declare function resetGloFreqCache(): void;
 declare function decodeLegacyObs(frame: Rtcm3Frame): ObsEpoch | null;
 /**
  * Decode any RTCM3 observation frame into an {@link ObsEpoch}: MSM4–7 first
- * ({@link decodeMsmFull}), then the legacy fixed-layout obs (1001–1004 GPS,
+ * ({@link decodeMsmFull}; MSM1–3 too with `opts.compactMsm` — resolve those
+ * with `resolveMsmRanges` before use), then the legacy fixed-layout obs (1001–1004 GPS,
  * 1009–1012 GLONASS) via {@link decodeLegacyObs}. Returns null for any
  * non-observation message. This is the single obs entry point every consumer
  * (stream stats, live SPP/QC/RTK, station monitor) should call, so a new obs
  * source is added here once rather than at every call site.
  */
-declare function decodeObs(frame: Rtcm3Frame): ObsEpoch | null;
+declare function decodeObs(frame: Rtcm3Frame, opts?: ObsDecodeOptions): ObsEpoch | null;
 
 /** One announced message in the station's schedule (DF055/DF056/DF057). */
 interface SystemParamsMessage {
@@ -319,4 +237,4 @@ declare function rtcm3Constellation(msgType: number): string | null;
 declare function createStreamStats(): StreamStats;
 declare function updateStreamStats(stats: StreamStats, frames: Rtcm3Frame[], rawBytes: number): void;
 
-export { EphemerisInfo, type IgsSsrIonoLayer, type IgsSsrMessage, type MessageTypeStats, type ObsEpoch, type ObsSatObs, type ObsSignal, RTCM3_MESSAGE_NAMES, Rtcm3Frame, type SatCn0, type SignalCn0, type SsrCodeBias, type SsrKind, type SsrMessage, type SsrPhaseBias, type SsrSatCorrection, type StationMeta, type StreamStats, type SystemParams, type SystemParamsMessage, createStationMeta, createStreamStats, decodeIgsSsr, decodeLegacyObs, decodeMsmFull, decodeObs, decodeSsr, decodeSystemParams, isSsrMessage, obsEpochToDate, resetGloFreqCache, rtcm3Constellation, setGloFreqNumber, updateStationMeta, updateStreamStats };
+export { EphemerisInfo, type IgsSsrIonoLayer, type IgsSsrMessage, type MessageTypeStats, ObsDecodeOptions, ObsEpoch, RTCM3_MESSAGE_NAMES, Rtcm3Frame, type SatCn0, type SignalCn0, type SsrCodeBias, type SsrKind, type SsrMessage, type SsrPhaseBias, type SsrSatCorrection, type StationMeta, type StreamStats, type SystemParams, type SystemParamsMessage, createStationMeta, createStreamStats, decodeIgsSsr, decodeLegacyObs, decodeObs, decodeSsr, decodeSystemParams, isSsrMessage, rtcm3Constellation, updateStationMeta, updateStreamStats };

package/dist/rtcm3.js

@@ -21,7 +21,7 @@ import {
   setRtcm3DebugHandler,
   updateStationMeta,
   updateStreamStats
-} from "./chunk-7GNRNKBR.js";
+} from "./chunk-N6GQUHM4.js";
 import "./chunk-HVXYFUCB.js";
 import "./chunk-LEEU5OIO.js";
 import "./chunk-FIEWO4J4.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,