@skyvexsoftware/stratos-sdk 0.8.1 → 0.9.0

package/dist/helpers/aircraft.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Aircraft size classification used by the landing analyser (and any future
+ * scorer) to apply class-aware thresholds — a 1000 fpm descent at 50 ft is
+ * marginal in a narrowbody but a clear bust in a widebody, etc.
+ */
+export type AircraftClass = "widebody" | "narrowbody" | "regional";
+/**
+ * Classify an ICAO aircraft type into widebody / narrowbody / regional.
+ * Returns "narrowbody" when the type is unknown or unparseable — it's the
+ * most common class and yields sensible (non-overly-strict) thresholds.
+ */
+export declare function classifyAircraft(aircraftType: string | null | undefined): AircraftClass;
+//# sourceMappingURL=aircraft.d.ts.map

package/dist/helpers/aircraft.js

@@ -0,0 +1,130 @@
+/**
+ * Aircraft size classification used by the landing analyser (and any future
+ * scorer) to apply class-aware thresholds — a 1000 fpm descent at 50 ft is
+ * marginal in a narrowbody but a clear bust in a widebody, etc.
+ */
+/**
+ * Known ICAO type designators by class. Lists are deliberately
+ * conservative — when a type doesn't match, we fall back to narrowbody as the
+ * least-restrictive sensible default.
+ */
+const WIDEBODY_TYPES = [
+    "A306",
+    "A30B",
+    "A310",
+    "A330",
+    "A332",
+    "A333",
+    "A338",
+    "A339",
+    "A340",
+    "A342",
+    "A343",
+    "A345",
+    "A346",
+    "A350",
+    "A359",
+    "A35K",
+    "A380",
+    "A388",
+    "B742",
+    "B743",
+    "B744",
+    "B748",
+    "B74F",
+    "B752",
+    "B753",
+    "B762",
+    "B763",
+    "B764",
+    "B772",
+    "B773",
+    "B77F",
+    "B77L",
+    "B77W",
+    "B788",
+    "B789",
+    "B78X",
+    "DC10",
+    "IL96",
+    "MD11",
+];
+const REGIONAL_TYPES = [
+    "AT42",
+    "AT43",
+    "AT45",
+    "AT46",
+    "AT72",
+    "AT75",
+    "AT76",
+    "ATR",
+    "ATR42",
+    "ATR72",
+    "BCS1",
+    "BCS3",
+    "C25A",
+    "C56X",
+    "CRJ",
+    "CRJ1",
+    "CRJ2",
+    "CRJ7",
+    "CRJ9",
+    "CRJX",
+    "CRJ200",
+    "CRJ700",
+    "CRJ900",
+    "CRJ1000",
+    "DH8A",
+    "DH8B",
+    "DH8C",
+    "DH8D",
+    "DHC8",
+    "E135",
+    "E140",
+    "E145",
+    "E170",
+    "E175",
+    "E190",
+    "E195",
+    "E75L",
+    "E75S",
+    "ERJ",
+    "ERJ135",
+    "ERJ140",
+    "ERJ145",
+    "SB20",
+    "SF34",
+    "SF50",
+];
+/** Strip whitespace and non-alphanumeric chars and uppercase. */
+function normalizeType(aircraftType) {
+    if (!aircraftType)
+        return null;
+    const value = aircraftType.toUpperCase().trim();
+    if (!value || value === "—")
+        return null;
+    return value.replace(/[^A-Z0-9]/g, "");
+}
+/**
+ * Classify an ICAO aircraft type into widebody / narrowbody / regional.
+ * Returns "narrowbody" when the type is unknown or unparseable — it's the
+ * most common class and yields sensible (non-overly-strict) thresholds.
+ */
+export function classifyAircraft(aircraftType) {
+    const normalized = normalizeType(aircraftType);
+    if (!normalized)
+        return "narrowbody";
+    if (WIDEBODY_TYPES.includes(normalized))
+        return "widebody";
+    if (REGIONAL_TYPES.includes(normalized))
+        return "regional";
+    for (const prefix of WIDEBODY_TYPES) {
+        if (normalized.startsWith(prefix))
+            return "widebody";
+    }
+    for (const prefix of REGIONAL_TYPES) {
+        if (normalized.startsWith(prefix))
+            return "regional";
+    }
+    return "narrowbody";
+}

package/dist/helpers/index.d.ts

@@ -2,4 +2,6 @@ export { createPlugin } from "./createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./server";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./units";
 export type { WeightUnit, AltitudeUnit, DistanceUnit, UnitPreferences, } from "./units";
+export { classifyAircraft } from "./aircraft";
+export type { AircraftClass } from "./aircraft";
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.js

@@ -1,3 +1,4 @@
 export { createPlugin } from "./createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./server";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./units";
+export { classifyAircraft } from "./aircraft";

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { PluginAuthor, PluginManifest } from "./types/manifest";
 export type { PluginAirline, PluginAirlineAccessor, PluginAuthAccessor, PluginVaApiClient, PluginConfigStore, PluginContext, PluginDatabaseAccessor, PluginIPCRegistrar, PluginLogger, PluginNavigationHelper, PluginPilotUser, PluginServerRegistrar, PluginToastAPI, PluginUIContext, PluginSettingType, PluginSettingOption, PluginSettingDefinition, PluginAvailableSettings, BooleanSettingDef, TextSettingDef, LongtextSettingDef, NumberSettingDef, RangeSettingDef, ListSettingDef, RadioSettingDef, DateSettingDef, JsonSettingDef, } from "./types/context";
 export type { PluginBackgroundModule, PluginRouteComponent, PluginUIModule, } from "./types/module";
 export { FlightPhase, SimulatorType, EventCategory, } from "./shared-types/simulator";
-export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, LandingSample, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./shared-types/simulator";
+export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, GateCapture, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, LandingSample, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./shared-types/simulator";
 export type { ThemeMode } from "./shared-types/theme";
 export type { FlightPlan, FlightStatus, CurrentFlight, FlightComment, PreflightCheck, PreflightCheckResult, StartFlightOptions, FlightManagerPayload, StartFlightResult, RecoverableFlight, } from "./shared-types/flight-manager";
 export { createPlugin } from "./helpers/createPlugin";
@@ -10,6 +10,8 @@ export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";
 export { vaApi } from "./api/vaApi";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./helpers/units";
 export type { WeightUnit, AltitudeUnit, DistanceUnit, UnitPreferences, } from "./helpers/units";
+export { classifyAircraft } from "./helpers/aircraft";
+export type { AircraftClass } from "./helpers/aircraft";
 export { PluginUICtx, usePluginContext } from "./hooks/context";
 export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";
 export { useFlightManager } from "./hooks/useFlightManager";

package/dist/index.js

@@ -5,6 +5,7 @@ export { createPlugin } from "./helpers/createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";
 export { vaApi } from "./api/vaApi";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./helpers/units";
+export { classifyAircraft } from "./helpers/aircraft";
 // ── React Hooks ────────────────────────────────────────────────────────
 export { PluginUICtx, usePluginContext } from "./hooks/context";
 export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";

package/dist/shared-types/index.d.ts

@@ -1,5 +1,5 @@
 export { FlightPhase, SimulatorType, EventCategory } from "./simulator";
-export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./simulator";
+export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, GateCapture, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./simulator";
 export type { ThemeMode } from "./theme";
 export type { FlightPlan, FlightStatus, CurrentFlight, FlightComment, PreflightCheck, PreflightCheckResult, StartFlightOptions, FlightManagerPayload, StartFlightResult, RecoverableFlight, } from "./flight-manager";
 export { SOCKET_EVENTS } from "./socket-events";

package/dist/shared-types/simulator.d.ts

@@ -266,6 +266,17 @@ export type BounceData = {
     touchdownGForce: number;
     durationMs: number;
 };
+/** Snapshot of aircraft state at the 50 ft stabilized-approach gate */
+export type GateCapture = {
+    /** Actual AGL at capture, may be a few ft above/below the nominal 50 ft */
+    altitudeAgl: number;
+    indicatedAirspeed: number;
+    verticalSpeed: number;
+    bank: number;
+    pitch: number;
+    groundSpeed: number;
+    timestamp: number;
+};
 /** Complete landing analysis result */
 export type LandingAnalysis = {
     landingRateFpm: number;
@@ -281,7 +292,15 @@ export type LandingAnalysis = {
     approachAltitude: number;
     approachIas: number;
     approachVs: number;
+    approachBank: number;
+    approachPitch: number;
     approachTimestamp: number;
+    /**
+     * Snapshot at ~50 ft AGL on final, used for the stabilized-approach gate.
+     * Null when the capture was missed (e.g. very fast descent, sim disconnect
+     * right before touchdown, or capture armed below 50 ft).
+     */
+    gateCapture: GateCapture | null;
     descentTimeSeconds: number;
     averageDescentRateFpm: number;
     bounceCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyvexsoftware/stratos-sdk",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Plugin SDK for Stratos — types, hooks, and UI components",
   "author": {
     "name": "Skyvex Software Pty Ltd",