@squawk/procedure-data

@squawk/procedure-data

Pre-processed snapshot of US instrument procedure data derived from the FAA NASR 28-day subscription cycle. Data only - no query logic, no dependency on @squawk/procedures.

Documentation

Coverage

• Standard Instrument Departures (SIDs/DPs)
• Standard Terminal Arrival Routes (STARs)
• Full waypoint sequences with fix identifiers and coordinates
• Named enroute transitions for each procedure
• Multiple common route variants for different runway configurations
• Adapted airport associations per procedure and per route
• Waypoint type classification (fix, navaid, airport)

Installation

npm install @squawk/procedure-data

Usage

import { usBundledProcedures } from '@squawk/procedure-data';

// Inspect metadata
console.log(usBundledProcedures.properties.nasrCycleDate); // "2026-01-22"
console.log(usBundledProcedures.properties.recordCount);
console.log(usBundledProcedures.properties.sidCount);
console.log(usBundledProcedures.properties.starCount);

// Use with @squawk/procedures for zero-config procedure queries
import { createProcedureResolver } from '@squawk/procedures';

const resolver = createProcedureResolver({ data: usBundledProcedures.records });

Consumers who have their own data pipeline can use @squawk/procedures alone and pass any compatible Procedure array at initialization.

Data format

Each record is a full Procedure object from @squawk/types. Key fields:

Property	Type	Description
name	string	Human-readable name (e.g. "AALLE FOUR")
computerCode	string	FAA computer code (e.g. "AALLE4")
type	ProcedureType	SID or STAR
airports	string[]	All adapted airports served by this procedure
commonRoutes	ProcedureCommonRoute[]	Trunk paths with waypoints and per-route adapted airports
transitions	ProcedureTransition[]	Named entry/exit transitions

Each ProcedureWaypoint contains:

Property	Type	Description
fixIdentifier	string	Fix or navaid identifier (e.g. "AALLE", "DEN")
category	ProcedureWaypointCategory	FIX, NAVAID, or AIRPORT
typeCode	ProcedureWaypointTypeCode	Raw FAA type code (P, R, NW, ND, AA, etc.)
lat, lon	number	Decimal degrees
icaoRegionCode	string or undefined	ICAO region code (e.g. "K2", "K5")

Data source

All data is derived from the FAA National Airspace System Resource (NASR) 28-day subscription, which is public domain. Procedure data comes from STARDP.txt, a fixed-width file encoding SID and STAR waypoint sequences. The build pipeline that produces this dataset lives in scripts/build-procedure-data/.