@squawk/mode-s 0.1.0

package/dist/mode-ac.js

@@ -0,0 +1,86 @@
+import { extractBits } from './bits.js';
+/**
+ * Converts a raw Mode A code to a Mode C altitude in 100s of feet, via the
+ * reflected-binary unscrambling defined for the Mode C altitude pulse
+ * train. Ported from dump1090-fa's `mode_ac.c` (`internalModeAToModeC`) and
+ * verified by exhaustive comparison against it across all 65536 possible
+ * inputs (0 mismatches) - this package's own capture data has no Mode A/C
+ * traffic to validate against directly (the format's use is opt-in and was
+ * off on the reference station), so this port leans on that exhaustive
+ * algorithmic cross-check rather than real-world samples.
+ *
+ * @param modeA - The raw 16-bit Mode A value.
+ * @returns Altitude in 100s of feet, or undefined if the code is not a valid Mode C altitude report.
+ */
+function modeAToModeC(modeA) {
+    if ((modeA & 0xffff8889) !== 0 || (modeA & 0x000000f0) === 0) {
+        return undefined;
+    }
+    let oneHundreds = 0;
+    if (modeA & 0x0010) {
+        oneHundreds ^= 0x007; // C1
+    }
+    if (modeA & 0x0020) {
+        oneHundreds ^= 0x003; // C2
+    }
+    if (modeA & 0x0040) {
+        oneHundreds ^= 0x001; // C4
+    }
+    if ((oneHundreds & 5) === 5) {
+        oneHundreds ^= 2; // remap 7 <-> 5
+    }
+    if (oneHundreds > 5) {
+        return undefined;
+    }
+    let fiveHundreds = 0;
+    if (modeA & 0x0002) {
+        fiveHundreds ^= 0x0ff; // D2
+    }
+    if (modeA & 0x0004) {
+        fiveHundreds ^= 0x07f; // D4
+    }
+    if (modeA & 0x1000) {
+        fiveHundreds ^= 0x03f; // A1
+    }
+    if (modeA & 0x2000) {
+        fiveHundreds ^= 0x01f; // A2
+    }
+    if (modeA & 0x4000) {
+        fiveHundreds ^= 0x00f; // A4
+    }
+    if (modeA & 0x0100) {
+        fiveHundreds ^= 0x007; // B1
+    }
+    if (modeA & 0x0200) {
+        fiveHundreds ^= 0x003; // B2
+    }
+    if (modeA & 0x0400) {
+        fiveHundreds ^= 0x001; // B4
+    }
+    if (fiveHundreds & 1) {
+        oneHundreds = 6 - oneHundreds;
+    }
+    return fiveHundreds * 5 + oneHundreds - 13;
+}
+/**
+ * Decodes a Mode A/C reply, as carried by a Beast type-1 frame. Beast
+ * represents the reply as the raw big-endian 16-bit value dump1090-fa
+ * calls "ModeA" internally: each of the four squawk digits occupies one
+ * nibble (masking with `0x7777` isolates them), with the Ident pulse and a
+ * couple of spare bits interspersed.
+ *
+ * Mode A/C carries no ICAO address, so a decoded reply cannot be
+ * associated with a specific aircraft the way a Mode-S message can - it is
+ * decode-only in this package, not wired into any aircraft-tracking state.
+ *
+ * @param bytes - The 2-byte Mode A/C payload from a Beast type-1 frame.
+ * @returns The decoded squawk code, Ident flag, and altitude (if the reply looks like a valid Mode C report).
+ */
+export function decodeModeAc(bytes) {
+    const modeA = extractBits(bytes, 0, 16);
+    const squawk = (modeA & 0x7777).toString(16).padStart(4, '0');
+    const identActive = (modeA & 0x0080) !== 0;
+    const modeC = identActive ? undefined : modeAToModeC(modeA);
+    const altitudeFt = modeC === undefined ? undefined : modeC * 100;
+    return { kind: 'modeAc', squawk, identActive, altitudeFt };
+}

package/dist/operational-status.d.ts

@@ -0,0 +1,9 @@
+import type { AircraftOperationalStatus } from './types/index.js';
+/**
+ * Decodes an ADS-B Aircraft Operational Status message (BDS 6,5, type code 31).
+ *
+ * @param me - The 7-byte ME field of a DF17/18 message whose type code is 31.
+ * @returns The decoded operational status.
+ */
+export declare function decodeAircraftOperationalStatus(me: Uint8Array): AircraftOperationalStatus;
+//# sourceMappingURL=operational-status.d.ts.map

package/dist/operational-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational-status.d.ts","sourceRoot":"","sources":["../src/operational-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,UAAU,GAAG,yBAAyB,CAgBzF"}

package/dist/operational-status.js

@@ -0,0 +1,23 @@
+import { extractBits } from './bits.js';
+/**
+ * Decodes an ADS-B Aircraft Operational Status message (BDS 6,5, type code 31).
+ *
+ * @param me - The 7-byte ME field of a DF17/18 message whose type code is 31.
+ * @returns The decoded operational status.
+ */
+export function decodeAircraftOperationalStatus(me) {
+    const surface = extractBits(me, 5, 3) === 1;
+    const adsbVersion = extractBits(me, 40, 3);
+    return {
+        surface,
+        adsbVersion,
+        capabilityClassCode: extractBits(me, 8, 16),
+        operationalModeCode: extractBits(me, 24, 16),
+        nicSupplementA: extractBits(me, 43, 1) === 1,
+        navAccuracyCategoryPosition: extractBits(me, 44, 4),
+        sourceIntegrityLevel: extractBits(me, 50, 2),
+        nicBaro: !surface && adsbVersion >= 1 ? extractBits(me, 52, 1) === 1 : undefined,
+        headingReference: extractBits(me, 53, 1) === 1 ? 'magnetic' : 'true',
+        silSupplementPerHour: adsbVersion === 2 ? extractBits(me, 54, 1) === 1 : undefined,
+    };
+}

package/dist/surface-movement.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decodes the 7-bit movement field of an ADS-B surface position message
+ * (BDS 0,6) to ground speed in knots.
+ *
+ * @param movementField - The raw 7-bit movement field, 0-127.
+ * @returns Ground speed in knots, or undefined if the field reports no information (0) or is out of the defined range (>124).
+ */
+export declare function decodeSurfaceMovement(movementField: number): number | undefined;
+//# sourceMappingURL=surface-movement.d.ts.map

package/dist/surface-movement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-movement.d.ts","sourceRoot":"","sources":["../src/surface-movement.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmB/E"}

package/dist/surface-movement.js

@@ -0,0 +1,37 @@
+/**
+ * Movement-field decode table: lower bound of each bin, the ground speed
+ * (kt) at that lower bound, and the per-step increment within the bin.
+ * Per DO-260B SS A.2.4.2 - the 7-bit movement field packs finer resolution
+ * at low speed (0.125 kt steps while taxiing) and coarser resolution at
+ * high speed (5 kt steps), rather than a uniform linear scale.
+ */
+const BIN_LOWER_BOUND = [2, 9, 13, 39, 94, 109, 124];
+const KNOTS_AT_LOWER_BOUND = [0.125, 1, 2, 15, 70, 100, 175];
+const STEP_WITHIN_BIN = [0.125, 0.25, 0.5, 1, 2, 5];
+/**
+ * Decodes the 7-bit movement field of an ADS-B surface position message
+ * (BDS 0,6) to ground speed in knots.
+ *
+ * @param movementField - The raw 7-bit movement field, 0-127.
+ * @returns Ground speed in knots, or undefined if the field reports no information (0) or is out of the defined range (>124).
+ */
+export function decodeSurfaceMovement(movementField) {
+    if (movementField === 0 || movementField > 124) {
+        return undefined;
+    }
+    if (movementField === 1) {
+        return 0;
+    }
+    if (movementField === 124) {
+        return 175;
+    }
+    const binIndex = BIN_LOWER_BOUND.findIndex((lowerBound) => lowerBound > movementField);
+    const previousBoundIndex = binIndex - 1;
+    const lowerBound = BIN_LOWER_BOUND[previousBoundIndex];
+    const knotsAtLowerBound = KNOTS_AT_LOWER_BOUND[previousBoundIndex];
+    const step = STEP_WITHIN_BIN[previousBoundIndex];
+    if (lowerBound === undefined || knotsAtLowerBound === undefined || step === undefined) {
+        return undefined;
+    }
+    return knotsAtLowerBound + (movementField - lowerBound) * step;
+}

package/dist/target-state-status.d.ts

@@ -0,0 +1,9 @@
+import type { TargetStateAndStatus } from './types/index.js';
+/**
+ * Decodes an ADS-B Target State and Status message (BDS 6,2, type code 29).
+ *
+ * @param me - The 7-byte ME field of a DF17/18 message whose type code is 29.
+ * @returns The decoded target state and status.
+ */
+export declare function decodeTargetStateAndStatus(me: Uint8Array): TargetStateAndStatus;
+//# sourceMappingURL=target-state-status.d.ts.map

package/dist/target-state-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-state-status.d.ts","sourceRoot":"","sources":["../src/target-state-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,UAAU,GAAG,oBAAoB,CA+B/E"}

package/dist/target-state-status.js

@@ -0,0 +1,34 @@
+import { extractBits } from './bits.js';
+/**
+ * Decodes an ADS-B Target State and Status message (BDS 6,2, type code 29).
+ *
+ * @param me - The 7-byte ME field of a DF17/18 message whose type code is 29.
+ * @returns The decoded target state and status.
+ */
+export function decodeTargetStateAndStatus(me) {
+    const altitudeSourceBit = extractBits(me, 8, 1);
+    const altitudeRaw = extractBits(me, 9, 11);
+    const selectedAltitudeFt = altitudeRaw === 0 ? undefined : (altitudeRaw - 1) * 32;
+    const selectedAltitudeSource = altitudeRaw === 0 ? undefined : altitudeSourceBit === 1 ? 'fms' : 'mcpFcu';
+    const baroRaw = extractBits(me, 20, 9);
+    const baroPressureSettingMb = baroRaw === 0 ? undefined : 800 + (baroRaw - 1) * 0.8;
+    const headingStatus = extractBits(me, 29, 1);
+    const headingRaw = extractBits(me, 30, 9);
+    const selectedHeadingDeg = headingStatus === 1 ? (headingRaw * 360) / 512 : undefined;
+    const modeStatus = extractBits(me, 46, 1);
+    return {
+        selectedAltitudeSource,
+        selectedAltitudeFt,
+        baroPressureSettingMb,
+        selectedHeadingDeg,
+        navAccuracyCategoryPosition: extractBits(me, 39, 4),
+        nicBaro: extractBits(me, 43, 1) === 1,
+        sourceIntegrityLevel: extractBits(me, 44, 2),
+        autopilotEngaged: modeStatus === 1 ? extractBits(me, 47, 1) === 1 : undefined,
+        vnavModeActive: modeStatus === 1 ? extractBits(me, 48, 1) === 1 : undefined,
+        altitudeHoldModeActive: modeStatus === 1 ? extractBits(me, 49, 1) === 1 : undefined,
+        approachModeActive: modeStatus === 1 ? extractBits(me, 51, 1) === 1 : undefined,
+        lnavModeActive: modeStatus === 1 ? extractBits(me, 53, 1) === 1 : undefined,
+        tcasOperational: extractBits(me, 52, 1) === 1,
+    };
+}

package/dist/test-utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test-only inverse of `bits.ts`'s `extractBits`: sets `bitLength` bits of
+ * `value` into `bytes` starting at `bitOffset` (0-indexed from the MSB),
+ * for building synthetic ME fields in specs.
+ */
+export declare function setBits(bytes: Uint8Array, bitOffset: number, bitLength: number, value: number): void;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAWN"}

package/dist/test-utils.js

@@ -0,0 +1,17 @@
+/**
+ * Test-only inverse of `bits.ts`'s `extractBits`: sets `bitLength` bits of
+ * `value` into `bytes` starting at `bitOffset` (0-indexed from the MSB),
+ * for building synthetic ME fields in specs.
+ */
+export function setBits(bytes, bitOffset, bitLength, value) {
+    for (let i = 0; i < bitLength; i++) {
+        const bitPos = bitOffset + i;
+        const byteIndex = bitPos >> 3;
+        const bitInByte = 7 - (bitPos & 7);
+        const bit = (value >> (bitLength - 1 - i)) & 1;
+        const current = bytes[byteIndex];
+        if (bit === 1 && current !== undefined) {
+            bytes[byteIndex] = current | (1 << bitInByte);
+        }
+    }
+}

package/dist/types/acas.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The named Resolution Advisory type for a single-threat encounter, derived
+ * from the corrective/sense/rate/crossing/reversal flags per RTCA DO-185B
+ * Table 2-16 (reproduced as Table 3 in the FAA's "Introduction to TCAS II
+ * v7.1"). "Maintain Climb"/"Maintain Descend" and "Crossing Maintain
+ * Climb"/"Crossing Maintain Descend" are not distinct wire values - they
+ * are the same broadcast RA as `climb`/`descend` (or their crossing
+ * variants), annunciated differently by the receiving aircraft's own TCAS
+ * unit depending on whether it was already climbing/descending faster than
+ * the initially-commanded rate.
+ */
+export type ResolutionAdvisoryType = 'climb' | 'descend' | 'crossingClimb' | 'crossingDescend' | 'increaseClimb' | 'increaseDescent' | 'reduceClimb' | 'reduceDescent' | 'doNotClimb' | 'doNotDescend' | 'reversalToClimb' | 'reversalToDescend';
+/** No threat-identity data (Threat Type Indicator 0). */
+export interface AcasThreatNone {
+    /** Discriminant tag - no threat-identity data follows. */
+    threatType: 'none';
+}
+/** The threat identified by its 24-bit ICAO address (Threat Type Indicator 1). */
+export interface AcasThreatIcaoAddress {
+    /** Discriminant tag - the threat is identified by ICAO address. */
+    threatType: 'icaoAddress';
+    /** The threat aircraft's 24-bit ICAO hex address. */
+    threatIcaoHex: string;
+}
+/** The threat identified by relative altitude, range, and bearing (Threat Type Indicator 2). */
+export interface AcasThreatAltitudeRangeBearing {
+    /** Discriminant tag - the threat is identified by altitude/range/bearing. */
+    threatType: 'altitudeRangeBearing';
+    /** The threat's altitude in feet, or undefined if the field is unavailable. */
+    threatAltitudeFt: number | undefined;
+    /** The threat's range in nautical miles, or undefined if the field is unavailable. */
+    threatRangeNm: number | undefined;
+    /** The threat's bearing in degrees relative to own aircraft, or undefined if the field is unavailable. */
+    threatBearingDeg: number | undefined;
+}
+/**
+ * The identity of the threat an ACAS Resolution Advisory report responds
+ * to, discriminated by `threatType` (the 2-bit Threat Type Indicator, TTI).
+ */
+export type AcasThreat = AcasThreatNone | AcasThreatIcaoAddress | AcasThreatAltitudeRangeBearing;
+/** Which kind of threat-identity data an ACAS Resolution Advisory report carries - the `threatType` discriminant of {@link AcasThreat}. */
+export type AcasThreatType = AcasThreat['threatType'];
+/**
+ * A decoded ACAS/TCAS Resolution Advisory report - BDS 3,0 content, carried
+ * either in a DF16 long air-air surveillance reply's MV field, or in a
+ * DF17/18 type-code-28 subtype-2 ME field (the ADS-B RA broadcast, which
+ * carries the identical content so aircraft without interrogation
+ * capability can still see an active RA).
+ */
+export interface AcasResolutionAdvisoryReport {
+    /** Whether a Resolution Advisory is currently active. False (with every other field still populated) means no advisory is presently in effect. */
+    active: boolean;
+    /** The named RA type for a single-threat encounter, derived from `corrective`/`downwardSense`/`increasedRate`/`senseReversal`/`altitudeCrossing`. Undefined when `active` is false, or when the flag combination has no defined single-threat RA type (e.g. some multi-threat composites - see `doNotPassBelow`/`doNotPassAbove`/`doNotTurnLeft`/`doNotTurnRight`). */
+    advisoryType: ResolutionAdvisoryType | undefined;
+    /** True if own aircraft must change its current vertical speed to comply; false if the RA is preventive (own aircraft is already in conformance and must only avoid certain rates). */
+    corrective: boolean;
+    /** True when the RA's sense is downward (descend-family); false when upward (climb-family). */
+    downwardSense: boolean;
+    /** True once own aircraft has been told to accelerate its climb/descent beyond the initial RA's target rate. */
+    increasedRate: boolean;
+    /** True when this RA reverses the sense of a previously issued RA for the same encounter. */
+    senseReversal: boolean;
+    /** True when this RA requires own aircraft to cross through the threat's altitude. */
+    altitudeCrossing: boolean;
+    /** True for a positive RA (a specific target climb/descend rate); false for a negative/Vertical-Speed-Limit RA (a rate to avoid). */
+    positive: boolean;
+    /** Resolution Advisory Complement: restricts own aircraft from descending below its current altitude. Primarily meaningful in multi-threat encounters. */
+    doNotPassBelow: boolean;
+    /** Resolution Advisory Complement: restricts own aircraft from climbing above its current altitude. Primarily meaningful in multi-threat encounters. */
+    doNotPassAbove: boolean;
+    /** Resolution Advisory Complement: reserved for a horizontal-maneuver capability TCAS II does not implement (TCAS II issues vertical RAs only) - expected to always be false in practice, decoded for completeness. */
+    doNotTurnLeft: boolean;
+    /** Resolution Advisory Complement: reserved for a horizontal-maneuver capability TCAS II does not implement (TCAS II issues vertical RAs only) - expected to always be false in practice, decoded for completeness. */
+    doNotTurnRight: boolean;
+    /** True for up to 18 seconds after an RA ends, indicating it is no longer displayed to the pilot. */
+    terminated: boolean;
+    /** True when this report resolves more than one simultaneous threat. */
+    multipleThreat: boolean;
+    /** The threat this report responds to - narrow on `threat.threatType` to access the identity fields for that kind. */
+    threat: AcasThreat;
+}
+//# sourceMappingURL=acas.d.ts.map

package/dist/types/acas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acas.d.ts","sourceRoot":"","sources":["../../src/types/acas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,SAAS,GACT,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,cAAc,GACd,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,UAAU,EAAE,aAAa,CAAC;IAC1B,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gGAAgG;AAChG,MAAM,WAAW,8BAA8B;IAC7C,6EAA6E;IAC7E,UAAU,EAAE,sBAAsB,CAAC;IACnC,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sFAAsF;IACtF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,0GAA0G;IAC1G,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,qBAAqB,GAAG,8BAA8B,CAAC;AAEjG,2IAA2I;AAC3I,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kJAAkJ;IAClJ,MAAM,EAAE,OAAO,CAAC;IAChB,uWAAuW;IACvW,YAAY,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACjD,uLAAuL;IACvL,UAAU,EAAE,OAAO,CAAC;IACpB,+FAA+F;IAC/F,aAAa,EAAE,OAAO,CAAC;IACvB,gHAAgH;IAChH,aAAa,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,aAAa,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qIAAqI;IACrI,QAAQ,EAAE,OAAO,CAAC;IAClB,0JAA0J;IAC1J,cAAc,EAAE,OAAO,CAAC;IACxB,wJAAwJ;IACxJ,cAAc,EAAE,OAAO,CAAC;IACxB,uNAAuN;IACvN,aAAa,EAAE,OAAO,CAAC;IACvB,uNAAuN;IACvN,cAAc,EAAE,OAAO,CAAC;IACxB,qGAAqG;IACrG,UAAU,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,cAAc,EAAE,OAAO,CAAC;IACxB,sHAAsH;IACtH,MAAM,EAAE,UAAU,CAAC;CACpB"}

package/dist/types/acas.js

@@ -0,0 +1 @@
+export {};

package/dist/types/comm-b.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Decoded BDS 4,0 (Selected Vertical Intention) - the pilot's MCP/FCU and
+ * FMS selected altitude targets, barometric pressure setting, and MCP mode
+ * flags, per ICAO Doc 9871 Table A-2-31.
+ */
+export interface SelectedVerticalIntention {
+    /** Discriminant tag identifying this as a decoded BDS 4,0 register. */
+    bdsCode: '4,0';
+    /** MCP/FCU selected altitude target, in feet. Undefined if not available. */
+    mcpFcuSelectedAltitudeFt: number | undefined;
+    /** FMS selected altitude target, in feet. Undefined if not available. */
+    fmsSelectedAltitudeFt: number | undefined;
+    /** Barometric pressure (altimeter) setting, in millibars/hectopascals. Undefined if not available. */
+    baroPressureSettingMb: number | undefined;
+    /** Whether VNAV mode is active. Undefined when the MCP mode bits are not reported (populated or omitted together with `altitudeHoldModeActive`/`approachModeActive`). */
+    vnavModeActive: boolean | undefined;
+    /** Whether altitude-hold mode is active. Undefined when the MCP mode bits are not reported. */
+    altitudeHoldModeActive: boolean | undefined;
+    /** Whether approach mode is active. Undefined when the MCP mode bits are not reported. */
+    approachModeActive: boolean | undefined;
+    /** Which altitude target the aircraft is currently flying toward. Undefined if not reported. */
+    targetAltitudeSource: 'unknown' | 'aircraftAltitude' | 'mcpFcu' | 'fms' | undefined;
+}
+/**
+ * Decoded BDS 5,0 (Track and Turn Report) - a flight-management-system
+ * snapshot of roll, track, groundspeed, turn rate, and true airspeed, per
+ * ICAO Doc 9871 Table A-2-34.
+ */
+export interface TrackAndTurnReport {
+    /** Discriminant tag identifying this as a decoded BDS 5,0 register. */
+    bdsCode: '5,0';
+    /** Roll angle in degrees, positive for a right turn. Undefined if not available. */
+    rollAngleDeg: number | undefined;
+    /** True track angle in degrees. Undefined if not available. */
+    trueTrackDeg: number | undefined;
+    /** Ground speed in knots. Undefined if not available. */
+    groundSpeedKt: number | undefined;
+    /** Rate of change of track angle, in degrees per second (positive turning right). Undefined if not available. */
+    trackAngleRateDegPerSec: number | undefined;
+    /** True airspeed in knots. Undefined if not available. */
+    trueAirspeedKt: number | undefined;
+}
+/**
+ * Decoded BDS 6,0 (Heading and Speed Report) - an air-data-computer
+ * snapshot of magnetic heading, indicated airspeed, Mach number, and
+ * vertical rates, per ICAO Doc 9871 Table A-2-35.
+ */
+export interface HeadingAndSpeedReport {
+    /** Discriminant tag identifying this as a decoded BDS 6,0 register. */
+    bdsCode: '6,0';
+    /** Magnetic heading in degrees. Undefined if not available. */
+    magneticHeadingDeg: number | undefined;
+    /** Indicated airspeed in knots. Undefined if not available. */
+    indicatedAirspeedKt: number | undefined;
+    /** Mach number. Undefined if not available. */
+    mach: number | undefined;
+    /** Barometric vertical rate in feet per minute, positive for climbing. Undefined if not available. */
+    baroVerticalRateFtPerMin: number | undefined;
+    /** Inertial vertical rate in feet per minute, positive for climbing. Undefined if not available. */
+    inertialVerticalRateFtPerMin: number | undefined;
+}
+/**
+ * A decoded Comm-B "Enhanced Surveillance" register - the ones DF20/21
+ * carry with no self-declared register identifier, so a caller cannot know
+ * in advance which of these three an MB field holds. Discriminated by
+ * `bdsCode`.
+ */
+export type CommBRegister = SelectedVerticalIntention | TrackAndTurnReport | HeadingAndSpeedReport;
+//# sourceMappingURL=comm-b.d.ts.map

package/dist/types/comm-b.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comm-b.d.ts","sourceRoot":"","sources":["../../src/types/comm-b.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,6EAA6E;IAC7E,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,sGAAsG;IACtG,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,yKAAyK;IACzK,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,+FAA+F;IAC/F,sBAAsB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,0FAA0F;IAC1F,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,gGAAgG;IAChG,oBAAoB,EAAE,SAAS,GAAG,kBAAkB,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;CACrF;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yDAAyD;IACzD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,iHAAiH;IACjH,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,0DAA0D;IAC1D,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,sGAAsG;IACtG,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,oGAAoG;IACpG,4BAA4B,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,yBAAyB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC"}

package/dist/types/comm-b.js

@@ -0,0 +1 @@
+export {};

package/dist/types/cpr.d.ts

@@ -0,0 +1,25 @@
+import type { Position } from '@squawk/types';
+/**
+ * Raw 17-bit CPR-encoded position fields, as carried by an ADS-B airborne or
+ * surface position message. Each field is a raw integer in [0, 131071].
+ *
+ * `ExtendedSquitterPosition.latCpr`/`lonCpr` (from `decodeModeSMessage`) are
+ * `number | undefined` - undefined for a type-code-0 message, which has no
+ * position fix to encode. Check for that case before constructing a
+ * `CprPosition` from a decoded message; the two types are otherwise
+ * structurally identical.
+ */
+export interface CprPosition {
+    /** Raw 17-bit CPR-encoded latitude field. */
+    latCpr: number;
+    /** Raw 17-bit CPR-encoded longitude field. */
+    lonCpr: number;
+}
+/**
+ * A reference position used to disambiguate a single CPR-encoded frame that
+ * has no paired opposite-format frame to decode globally against. Must be
+ * within roughly 180 NM of the true position for airborne decode, or 45 NM
+ * for surface decode - the caller is responsible for that precondition.
+ */
+export type CprReference = Pick<Position, 'lat' | 'lon'>;
+//# sourceMappingURL=cpr.d.ts.map

package/dist/types/cpr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpr.d.ts","sourceRoot":"","sources":["../../src/types/cpr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC"}

package/dist/types/cpr.js

@@ -0,0 +1 @@
+export {};

package/dist/types/emergency-status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Emergency/priority state carried by an ADS-B aircraft status message
+ * (BDS 6,1 subtype 1, type code 28), per the 3-bit emergency state field.
+ */
+export type EmergencyState = 'none' | 'general' | 'lifeguardMedical' | 'minimumFuel' | 'noCommunications' | 'unlawfulInterference' | 'downed' | 'reserved';
+//# sourceMappingURL=emergency-status.d.ts.map

package/dist/types/emergency-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emergency-status.d.ts","sourceRoot":"","sources":["../../src/types/emergency-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,sBAAsB,GACtB,QAAQ,GACR,UAAU,CAAC"}

package/dist/types/emergency-status.js

@@ -0,0 +1 @@
+export {};

package/dist/types/frame.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A Mode-S message with its downlink format and CRC remainder extracted,
+ * prior to any per-type decoding. The envelope every other decoder in this
+ * package builds on.
+ */
+export interface ModeSMessageEnvelope {
+    /** Raw message bytes - 7 for a short (56-bit) message, 14 for a long (112-bit) message. */
+    bytes: Uint8Array;
+    /**
+     * The raw 5-bit downlink format value (0-31) from the top of byte 0.
+     * Values 24-31 all denote Comm-D (DF24) - the lower 2 bits of this field
+     * are the KE/ND subfields for that format, not distinct downlink formats.
+     * This package does not decode Comm-D; callers should treat any value
+     * >= 24 as "DF24, unsupported" rather than as a distinguishable DF25-31.
+     */
+    downlinkFormat: number;
+    /**
+     * 24-bit CRC remainder computed over the entire message. Interpretation
+     * depends on `downlinkFormat`:
+     * - DF11/17/18 (squitters): zero indicates an unmodified message. A
+     *   non-zero value on DF11 (up to 127 - a 1-bit IC selector plus either a
+     *   4-bit legacy II code or a 6-bit SI code) identifies the interrogator
+     *   the ground station used, not a validation failure.
+     * - DF0/4/5/16/20/21 (surveillance replies): this value IS the
+     *   transmitting aircraft's 24-bit ICAO address, XORed into the parity
+     *   field by design. There is no pass/fail check for these formats in
+     *   isolation - callers confirm validity by matching this value against
+     *   an ICAO address already known from squitter traffic.
+     */
+    crcRemainder: number;
+}
+//# sourceMappingURL=frame.d.ts.map

package/dist/types/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/types/frame.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,2FAA2F;IAC3F,KAAK,EAAE,UAAU,CAAC;IAClB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/frame.js

@@ -0,0 +1 @@
+export {};

package/dist/types/identification.d.ts

@@ -0,0 +1,9 @@
+import type { AircraftCategory } from '@squawk/types';
+/** Decoded ADS-B aircraft identification (BDS 0,8, type codes 1-4). */
+export interface AircraftIdentification {
+    /** Callsign, trimmed of leading/trailing whitespace. Undefined if the field is entirely blank. Invalid 6-bit characters decode to '#' and remain in the string rather than being silently dropped. */
+    callsign: string | undefined;
+    /** Wake vortex / performance category, if the type code and category subfield map to one of squawk's known category codes. Undefined for "no category information" or a reserved combination. */
+    category: AircraftCategory | undefined;
+}
+//# sourceMappingURL=identification.d.ts.map

package/dist/types/identification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identification.d.ts","sourceRoot":"","sources":["../../src/types/identification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,sMAAsM;IACtM,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iMAAiM;IACjM,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACxC"}

package/dist/types/identification.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+export * from './acas.js';
+export * from './comm-b.js';
+export * from './cpr.js';
+export * from './emergency-status.js';
+export * from './frame.js';
+export * from './identification.js';
+export * from './message.js';
+export * from './mode-ac.js';
+export * from './operational-status.js';
+export * from './target-state-status.js';
+export * from './velocity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,11 @@
+export * from './acas.js';
+export * from './comm-b.js';
+export * from './cpr.js';
+export * from './emergency-status.js';
+export * from './frame.js';
+export * from './identification.js';
+export * from './message.js';
+export * from './mode-ac.js';
+export * from './operational-status.js';
+export * from './target-state-status.js';
+export * from './velocity.js';