/** * Usage category of a fix as classified by the FAA. * * - `WP` - Waypoint * - `RP` - Reporting Point * - `MW` - Military Waypoint * - `MR` - Military Reporting Point * - `CN` - Computer Navigation Fix (internal FAA automation point) * - `VFR` - VFR Waypoint * - `NRS` - NRS Waypoint * - `RADAR` - Radar fix */ export type FixUseCode = 'WP' | 'RP' | 'MW' | 'MR' | 'CN' | 'VFR' | 'NRS' | 'RADAR'; /** * The full set of {@link FixUseCode} values, in declaration order. * * Use as the single source of truth for value-side iteration (e.g. building a * lookup table keyed by use code) or with {@link isFixUseCode} to narrow an * external string into the union. The `as const satisfies` brand keeps this * array in sync with the type at compile time. */ export declare const FIX_USE_CODES: readonly ["WP", "RP", "MW", "MR", "CN", "VFR", "NRS", "RADAR"]; /** * Type guard that narrows a string to {@link FixUseCode} when it matches a * member of {@link FIX_USE_CODES}. * * Useful when consuming external strings (URL params, config files, MCP tool * inputs) that should be validated before being used as a fix use code. * * @param value - The string to test. * @returns `true` if `value` is a valid `FixUseCode`. */ export declare function isFixUseCode(value: string): value is FixUseCode; /** * Maps FAA FIX_USE_CODE values from NASR data to FixUseCode. * FAA values may have trailing whitespace so trimmed values are mapped here. */ export declare const FIX_USE_CODE_MAP: Record; /** * Compulsory reporting designation for a fix. * * - `HIGH` - Compulsory at high altitude * - `LOW` - Compulsory at low altitude * - `LOW/HIGH` - Compulsory at both low and high altitude */ export type FixCompulsory = 'HIGH' | 'LOW' | 'LOW/HIGH'; /** * Maps FAA COMPULSORY values from NASR data to FixCompulsory. */ export declare const FIX_COMPULSORY_MAP: Record; /** * A navigational aid association for a fix, indicating the bearing and * distance from a nearby navaid to the fix position. */ export interface FixNavaidAssociation { /** Navaid identifier (e.g. "PDK", "BOS"). */ navaidId: string; /** Navaid facility type (e.g. "VOR", "VORTAC", "LOC", "NDB"). */ navaidType: string; /** Bearing in degrees from the navaid to the fix. */ bearingDeg: number; /** DME distance in nautical miles from the navaid to the fix. */ distanceNm: number; } /** * A named fix or waypoint published by the FAA. Includes US fixes and * selected foreign fixes (Canadian, Mexican, Caribbean, Pacific) that * participate in US operations. * Fixes are specific geographic positions used in flight planning, instrument * procedures, and ATC operations. They are defined by geographic coordinates * and may be associated with one or more navaids via radial/distance intersections. */ export interface Fix { /** Fix identifier (e.g. "MERIT", "BOSCO", "AAALL"). */ identifier: string; /** ICAO region code (e.g. "K6", "K7", "K1"). */ icaoRegionCode: string; /** Two-letter state code (e.g. "MA", "NY", "CA"). Absent for non-US fixes. */ state?: string; /** Two-letter country code (e.g. "US"). */ country: string; /** Latitude in decimal degrees, positive north. */ lat: number; /** Longitude in decimal degrees, positive east. */ lon: number; /** Usage category of the fix. */ useCode: FixUseCode; /** High-altitude ARTCC identifier (e.g. "ZNY", "ZBW"). */ highArtccId?: string; /** Low-altitude ARTCC identifier (e.g. "ZNY", "ZBW"). */ lowArtccId?: string; /** Whether this fix has a pitch designation. */ pitch: boolean; /** Whether this fix has a catch designation. */ catch: boolean; /** Whether this fix is associated with Special Use Airspace or an ATCAA. */ suaAtcaa: boolean; /** Minimum reception altitude in feet, if published. */ minimumReceptionAltitudeFt?: number; /** Compulsory reporting designation, if applicable. */ compulsory?: FixCompulsory; /** Previous fix identifier, if the fix was renamed. */ previousIdentifier?: string; /** Charting remark text, if any. */ chartingRemark?: string; /** Chart types on which this fix appears (e.g. "IAP", "STAR", "ENROUTE LOW"). */ chartTypes: string[]; /** Navaid associations defining the fix by radial/distance from nearby navaids. */ navaidAssociations: FixNavaidAssociation[]; } //# sourceMappingURL=fix.d.ts.map