@fboes/aerofly-custom-missions 1.12.0 → 1.13.1

package/CHANGELOG.md

@@ -2,7 +2,18 @@
 
 This changelog documents all notable changes to the Aerofly Custom Missions project. Each version entry includes a list of changes, with the most recent version at the top.
 
-## [1.12.0] - 2026-07-08
+## [Unreleased]
+
+## [1.13.1] - 2026-07-24
+
+- Fixed orientation / heading parsing
+
+## [1.13.0] - 2026-07-23
+
+- Made unit conversions more precise
+- Added correct UID generator
+
+## [1.12.0] - 2026-07-01
 
 - Added unofficial `_cruiseSpeed` property to `AeroflyNavigationConfig`
 

package/dist/dto-flight/AeroflyNavRouteAirports.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 class AeroflyNavRouteAirport extends AeroflyNavRouteBase {
     /**
@@ -27,10 +27,10 @@ class AeroflyNavRouteAirport extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     getElement(index = 0) {
         const element = super.getElement(index);

package/dist/dto-flight/AeroflyNavRouteBase.js

@@ -1,5 +1,6 @@
-import { Convert } from "../node/Convert.js";
-import { AeroflyConfigurationNode, AeroflyConfigurationNodeComment } from "../node/AeroflyConfigurationNode.js";
+import { convertLonLatToVector, convertVectorToLonLat } from "../node/Convert.js";
+import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
+import { AeroflyVector3Float } from "../node/AeroflyTypes.js";
 export class AeroflyNavRouteBase {
     /**
      * @property {AeroflyNavRouteType} type like "origin", "departure_runway", "departure", "waypoint", "arrival", "approach", "destination_runway" or "destination"
@@ -18,7 +19,7 @@ export class AeroflyNavRouteBase {
      */
     latitude;
     /**
-     * @property {?bigint} uid unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission, can be null for new waypoints
+     * @property {?bigint} uid unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission. Obviously the UID encodes the geographic position as well as the name of the waypoint.
      */
     uid;
     /**
@@ -27,7 +28,7 @@ export class AeroflyNavRouteBase {
      * @param {number} longitude WGS84
      * @param {number} latitude WGS84
      * @param {object} [options] additional options for the waypoint
-     * @param {?bigint} [options.uid] unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission, can be null for new waypoints
+     * @param {?bigint} [options.uid] unique identifier for the waypoint, must match Aerofly FS internal UID if used in an existing mission. Obviously the UID encodes the geographic position as well as the name of the waypoint.
      */
     constructor(type, identifier, longitude, latitude, { uid = null } = {}) {
         this.type = type;
@@ -40,10 +41,10 @@ export class AeroflyNavRouteBase {
      * @returns {AeroflyVector3Float} to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, 0);
+        return convertLonLatToVector(this.longitude, this.latitude, 0);
     }
     set position(position) {
-        const latLonAlt = Convert.convertVectorToLonLat(position);
+        const latLonAlt = convertVectorToLonLat(position);
         this.longitude = latLonAlt.longitude;
         this.latitude = latLonAlt.latitude;
     }
@@ -53,18 +54,69 @@ export class AeroflyNavRouteBase {
      * @returns {this} for chaining
      */
     setPosition(position) {
-        this.position = position;
+        this.position = AeroflyVector3Float.fromArray(position);
         return this;
     }
     getElement(index = 0) {
         const element = new AeroflyConfigurationNode("tmnav_route_" + this.type, this.identifier, String(index))
             .appendChild("string8u", "Identifier", this.identifier)
-            .appendChild("vector3_float64", "Position", this.position, `Lon ${this.longitude.toFixed(6)}, Lat ${this.latitude.toFixed(6)}`)
-            .append(this.uid
-            ? new AeroflyConfigurationNode("uint64", "Uid", this.uid)
-            : new AeroflyConfigurationNodeComment("uint64", "Uid", ""));
+            .appendChild("vector3_float64", "Position", this.position.toArray(), `Lon ${this.longitude.toFixed(6)}, Lat ${this.latitude.toFixed(6)}`)
+            .appendChild("uint64", "Uid", this.uid ?? this.getUidFallback(), this.uid ? "" : "Fallback UID, not matching Aerofly FS internal UID");
         return element;
     }
+    /**
+     * @returns {bigint} 24 bit longitude
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    encodeLongitude() {
+        let scaled = this.longitude / 180;
+        scaled = 65536.0 * (0.5 + 0.5 * scaled); // 16 bit
+        return BigInt(Math.round(256.0 * scaled + 0.5)); // 24 bit
+    }
+    /**
+     * @returns {bigint} 24 bit latitude
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    encodeLatitude() {
+        const worldGridConstantA = 2.3311223704144;
+        let scaled = this.latitude / 180;
+        scaled = Math.tan(worldGridConstantA * scaled) / worldGridConstantA;
+        scaled = 65536.0 * (0.5 + 0.5 * scaled); // 16 bit
+        return BigInt(Math.round(256.0 * scaled + 0.5)); // 24 bit
+    }
+    /**
+     * @returns {number} 16 bit type
+     */
+    encodeWaypointType() {
+        // Type code (airport (0500) / runway (0800) / SID (4400) / STAR (4800) / Approach (4C00) / RNAV waypoint (C000) / airways (4000)
+        switch (this.type) {
+            case "origin":
+            case "destination":
+                return 0x0500;
+            case "departure_runway":
+            case "destination_runway":
+                return 0x0800;
+            case "departure":
+                return 0x4400;
+            case "arrival":
+                return 0x4800;
+            case "approach":
+                return 0x4c00;
+        }
+        return 0;
+    }
+    /**
+     * @returns {bigint} Packs both into a single 64-bit value:
+     * - Bits 63..40 → longitude  (24 bit)
+     * - Bits 39..16 → latitude   (24 bit)
+     * - Bits 15..0  → payload    (16 bit)
+     * @see https://www.aerofly.com/community/forum/index.php?thread/29490-navdata-coordinates-to-uid/
+     */
+    getUidFallback() {
+        return ((this.encodeLongitude() << 40n) |
+            (this.encodeLatitude() << 16n) |
+            (BigInt(this.encodeWaypointType()) & 0xffffn));
+    }
     toJSON() {
         return {
             ...this,

package/dist/dto-flight/AeroflyNavRouteBase.test.js

@@ -0,0 +1,56 @@
+import { describe, it } from "node:test";
+import { strict as assert } from "node:assert";
+import { AeroflyNavRouteDestination } from "../index.js";
+describe("AeroflyNavRouteBase", () => {
+    it("should create UIDs almost matching the ingame UIDs", () => {
+        const testCases = [
+            {
+                wp: new AeroflyNavRouteDestination("MAX-NE", 179.999, 89.999),
+                assertUid: 18446694595666707712n,
+                ingameUid: 0n,
+            },
+            {
+                wp: new AeroflyNavRouteDestination("MAX-SW", -179.999, -89.999),
+                assertUid: 51677066167552n,
+                ingameUid: 0n,
+            },
+            {
+                wp: new AeroflyNavRouteDestination("KEYW", -81.7599558, 24.5561197),
+                assertUid: 5033914504046314752n,
+                ingameUid: 5033914504046249216n,
+            },
+            {
+                wp: new AeroflyNavRouteDestination("EGLL", -0.45277777, 51.47138888),
+                assertUid: 9200173076798702848n,
+                ingameUid: 9199731073154483456n,
+            },
+            {
+                wp: new AeroflyNavRouteDestination("YSSY", 151.177, -33.4961),
+                assertUid: 16969826619723154688n,
+                ingameUid: 16969837613165511936n,
+            },
+            {
+                wp: new AeroflyNavRouteDestination("RJTT", 139.779, 35.709),
+                assertUid: 16385782762532177152n,
+                ingameUid: 16385890514078663936n,
+            },
+        ];
+        for (const testCase of testCases) {
+            assert.strictEqual(testCase.wp.getUidFallback(), testCase.assertUid, `${testCase.wp.identifier} was ${testCase.ingameUid}`);
+        }
+    });
+    it("should unpack UIDs for airports to code 1280", () => {
+        const unpackPayload = (packed) => {
+            return Number(packed & 0xffffn);
+        };
+        const testCases = [
+            { uid: 5033914504046314752n, code: 1280, airport: "KEYW" },
+            { uid: 9200173076798702848n, code: 1280, airport: "EGLL" },
+            { uid: 16969826619723154688n, code: 1280, airport: "YSSY" },
+            { uid: 16385782762532177152n, code: 1280, airport: "RJTT" },
+        ];
+        for (const testCase of testCases) {
+            assert.strictEqual(unpackPayload(testCase.uid), testCase.code, testCase.airport);
+        }
+    });
+});

package/dist/dto-flight/AeroflyNavRouteRunway.js

@@ -1,6 +1,7 @@
-import { Convert } from "../node/Convert.js";
+import { convertDirectionToHeading, convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
+import { AeroflyVector3Float } from "../node/AeroflyTypes.js";
 class AeroflyNavRouteRunway extends AeroflyNavRouteBase {
     /**
      * @property {?number} direction_degree runway direction in degrees, null if not set
@@ -27,34 +28,33 @@ class AeroflyNavRouteRunway extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     /**
      * @returns {number | null} runway length in feet, null if not set
      */
     get runwayLength_ft() {
-        return this.runwayLength !== null ? Convert.convertMeterToFeet(this.runwayLength) : null;
+        return this.runwayLength !== null ? convertMeterToFeet(this.runwayLength) : null;
     }
     set runwayLength_ft(runwayLength_ft) {
-        this.runwayLength = runwayLength_ft !== null ? Convert.convertFeetToMeter(runwayLength_ft) : null;
+        this.runwayLength = runwayLength_ft !== null ? convertFeetToMeter(runwayLength_ft) : null;
     }
     /**
      * @returns {AeroflyVector3Float | null} runway direction, null if not set
      */
     get direction() {
-        // TODO: calculate direction vector from direction_degree
-        return this.direction_degree !== null ? [0, 0, 0] : null;
+        return this.direction_degree !== null ? new AeroflyVector3Float(0, 0, 0) : null; // TODO: Get direction vector
     }
     set direction(direction) {
-        this.direction_degree = 0; // TODO: calculate direction_degree from direction vector
+        this.direction_degree = convertDirectionToHeading(direction, this.position);
     }
     getElement(index = 0) {
         const element = super.getElement(index);
         if (this.direction !== null) {
-            element.appendChild("vector3_float64", "Direction", this.direction, `Runway direction ${Math.round(this.direction_degree ?? 0)}°`);
+            element.appendChild("vector3_float64", "Direction", this.direction.toArray(), `Runway direction ${Math.round(this.direction_degree ?? 0)}°`);
         }
         if (this.elevation !== null) {
             element.appendChild("float64", "Elevation", this.elevation, this.elevation_ft ? `Elevation ${Math.ceil(this.elevation_ft)} ft` : undefined);

package/dist/dto-flight/AeroflyNavRouteTransition.js

@@ -1,6 +1,7 @@
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
+import { AeroflyVector3Float } from "../node/AeroflyTypes.js";
 class AeroflyNavRouteTransition extends AeroflyNavRouteBase {
     /**
      * @property {string} airport ICAO code of the airport this transition belongs to, e.g. "SEA", "PDX"
@@ -29,28 +30,28 @@ class AeroflyNavRouteTransition extends AeroflyNavRouteBase {
      * @returns {number | null} elevation in feet, null if not set
      */
     get elevation_ft() {
-        return this.elevation !== null ? Convert.convertMeterToFeet(this.elevation) : null;
+        return this.elevation !== null ? convertMeterToFeet(this.elevation) : null;
     }
     set elevation_ft(elevation_ft) {
-        this.elevation = elevation_ft !== null ? Convert.convertFeetToMeter(elevation_ft) : null;
+        this.elevation = elevation_ft !== null ? convertFeetToMeter(elevation_ft) : null;
     }
     /**
      * @returns {AeroflyVector3Float} deliberately empty
      */
     get position() {
-        return [0, 0, 0]; // sic!
+        return new AeroflyVector3Float(0, 0, 0); // sic!
     }
     /**
      * @returns {AeroflyVector3Float} deliberately empty
      */
     get direction() {
-        return [0, 0, 0]; // sic!
+        return new AeroflyVector3Float(0, 0, 0); // sic!
     }
     getElement(index = 0) {
         const element = super.getElement(index);
         element
             .appendChild("string8u", "Airport", this.airport)
-            .appendChild("vector3_float64", "Direction", this.direction)
+            .appendChild("vector3_float64", "Direction", this.direction.toArray())
             .appendChild("float64", "Elevation", this.elevation ?? 0, `Elevation ${this.elevation_ft !== null ? Math.ceil(this.elevation_ft) + " ft" : "unknown"}`)
             .appendChild("string8u", "Transition", this.transition)
             .appendChild("uint64", "TransitionUid", this.transitionUid ?? 0);
@@ -86,7 +87,7 @@ export class AeroflyNavRouteArrival extends AeroflyNavRouteTransition {
         const element = super.getElement(index);
         element
             .appendChild("string8u", "Airport", this.airport)
-            .appendChild("vector3_float64", "Direction", this.direction)
+            .appendChild("vector3_float64", "Direction", this.direction.toArray())
             .appendChild("float64", "Elevation", this.elevation ?? 0, `Elevation ${this.elevation_ft !== null ? Math.ceil(this.elevation_ft) + " ft" : "unknown"}`);
         return element;
     }

package/dist/dto-flight/AeroflyNavRouteWaypoint.js

@@ -1,4 +1,4 @@
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertLonLatToVector, convertMeterToFeet, convertVectorToLonLat, } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
@@ -9,6 +9,10 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @property {?number} navaidFrequency if the waypoint is a navaid, its frequency in Hz
      */
     navaidFrequency;
+    /**
+     * @property {?bigint} navaidUid if the waypoint is a navaid, its unique identifier, must match Aerofly FS internal UID if used in an existing mission
+     */
+    navaidUid;
     /**
      * @property {number | null} altitude in meter, null if not set
      */
@@ -23,17 +27,21 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @param {number} latitude WGS84
      * @param {object} [options] additional options for the waypoint
      * @param {?number} [options.navaidFrequency] if the waypoint is a navaid, its frequency in Hz
+     * @param {?number} [options.navaidFrequency_khz] if the waypoint is a navaid, its frequency in kHz, will override navaidFrequency in Hz if provided
+     * @param {?number} [options.navaidFrequency_mhz] if the waypoint is a navaid, its frequency in MHz, will override navaidFrequency in Hz if provided
+     * @param {?bigint} [options.navaidUid] if the waypoint is a navaid, its unique identifier, must match Aerofly FS internal UID if used in an existing mission
      * @param {number} [options.altitude] in meter
      * @param {?number} [options.altitude_ft] altitude in feet, will override altitude in meter if provided
      * @param {boolean} [options.flyOver] if true, the waypoint is meant to be flown over, otherwise it can be used as a fly-by waypoint
      * @param {?bigint} [options.uid] unique identifier for the waypoint, will be generated automatically if not provided
      */
-    constructor(identifier, longitude, latitude, { navaidFrequency = null, navaidFrequency_khz = null, navaidFrequency_mhz = null, altitude = null, altitude_ft = null, flyOver = false, uid = null, } = {}) {
+    constructor(identifier, longitude, latitude, { navaidFrequency = null, navaidFrequency_khz = null, navaidFrequency_mhz = null, navaidUid = null, altitude = null, altitude_ft = null, flyOver = false, uid = null, } = {}) {
         super("waypoint", identifier, longitude, latitude, { uid });
         this.identifier = identifier;
         this.longitude = longitude;
         this.latitude = latitude;
         this.navaidFrequency = navaidFrequency;
+        this.navaidUid = navaidUid;
         this.altitude = altitude;
         if (altitude_ft !== null) {
             this.altitude_ft = altitude_ft;
@@ -50,10 +58,10 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @returns {number | null} altitude in feet, null if not set
      */
     get altitude_ft() {
-        return this.altitude !== null ? Convert.convertMeterToFeet(this.altitude) : null;
+        return this.altitude !== null ? convertMeterToFeet(this.altitude) : null;
     }
     set altitude_ft(altitude_ft) {
-        this.altitude = altitude_ft !== null ? Convert.convertFeetToMeter(altitude_ft) : null;
+        this.altitude = altitude_ft !== null ? convertFeetToMeter(altitude_ft) : null;
     }
     get navaidFrequency_khz() {
         return this.navaidFrequency ? this.navaidFrequency / 1000 : null;
@@ -71,20 +79,19 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
      * @returns {AeroflyVector3Float} to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, this.altitude || 0);
+        return convertLonLatToVector(this.longitude, this.latitude, this.altitude || 0);
     }
     set position(position) {
-        const { longitude, latitude, altitude_meter } = Convert.convertVectorToLonLat(position);
+        const { longitude, latitude, altitude_meter } = convertVectorToLonLat(position);
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude = altitude_meter;
     }
     getElement(index = 0) {
         const element = super.getElement(index);
-        if (this.navaidFrequency) {
-            element.appendChild("float64", "NavaidFrequency", this.navaidFrequency);
-        }
         element
+            .appendChild("float64", "NavaidFrequency", this.navaidFrequency ?? 0)
+            .appendChild("uint64", "NavaidUid", this.navaidUid ?? BigInt(0))
             .appendChild("vector2_float64", "Altitude", this.altitude !== null && this.altitude > 0 ? [this.altitude, this.altitude] : [-1001, 100001], `${this.altitude_ft !== null && this.altitude_ft > 0 ? Math.ceil(this.altitude_ft) + " ft" : "unrestricted"}`)
             .appendChild("bool", "FlyOver", this.flyOver);
         return element;
@@ -97,6 +104,7 @@ export class AeroflyNavRouteWaypoint extends AeroflyNavRouteBase {
             altitude_ft: this.altitude_ft,
             navaidFrequency: undefined,
             navaidFrequency_khz: this.navaidFrequency_khz,
+            navaidUid: this.navaidUid !== null ? this.navaidUid.toString() : null,
         };
     }
 }

package/dist/dto-flight/AeroflyNavigationConfig.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertFeetToMeter, convertMeterToFeet } from "../node/Convert.js";
 import { AeroflyNavRouteBase } from "./AeroflyNavRouteBase.js";
 export class AeroflyNavigationConfig {
     /**
@@ -31,16 +31,16 @@ export class AeroflyNavigationConfig {
      * @returns {AeroflyNavigationConfig} with cruise altitude converted to meters
      */
     static createInFeet(cruiseAltitude_ft, waypoints = [], _cruiseSpeed_kts = undefined) {
-        return new AeroflyNavigationConfig(Convert.convertFeetToMeter(cruiseAltitude_ft), waypoints, _cruiseSpeed_kts);
+        return new AeroflyNavigationConfig(convertFeetToMeter(cruiseAltitude_ft), waypoints, _cruiseSpeed_kts);
     }
     /**
      * @returns {number} cruise altitude in feet
      */
     get cruiseAltitude_ft() {
-        return Convert.convertMeterToFeet(this.cruiseAltitude);
+        return convertMeterToFeet(this.cruiseAltitude);
     }
     set cruiseAltitude_ft(cruiseAltitude_ft) {
-        this.cruiseAltitude = Convert.convertFeetToMeter(cruiseAltitude_ft);
+        this.cruiseAltitude = convertFeetToMeter(cruiseAltitude_ft);
     }
     /**
      * @returns {AeroflyConfigurationNode[]} indexed checkpoints

package/dist/dto-flight/AeroflySettingsFlight.js

@@ -1,5 +1,6 @@
-import { Convert } from "../node/Convert.js";
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
+import { AeroflyMatrix3Float, AeroflyVector3Float, } from "../node/AeroflyTypes.js";
+import { convertFeetToMeter, convertLonLatToVector, convertVectorToLonLat, convertHeadingToOrientation, convertOrientationToHeading, convertMeterToFeet, } from "../node/Convert.js";
 export class AeroflySettingsFlight {
     longitude;
     latitude;
@@ -52,13 +53,13 @@ export class AeroflySettingsFlight {
         this.runway = runway;
     }
     static createInFeet(longitude, latitude, altitude_ft, heading_degree, speed_kts = 0, additionalAttributes = {}) {
-        return new AeroflySettingsFlight(longitude, latitude, Convert.convertFeetToMeter(altitude_ft), heading_degree, speed_kts, additionalAttributes);
+        return new AeroflySettingsFlight(longitude, latitude, convertFeetToMeter(altitude_ft), heading_degree, speed_kts, additionalAttributes);
     }
     static createInCartesian(position, velocity, orientation, additionalAttributes = {}) {
         const flight = new AeroflySettingsFlight(0, 0, 0, 0, 0, additionalAttributes);
-        flight.position = position;
-        flight.velocity = velocity;
-        flight.orientation = orientation;
+        flight.position = AeroflyVector3Float.fromArray(position);
+        flight.velocity = AeroflyVector3Float.fromArray(velocity);
+        flight.orientation = AeroflyMatrix3Float.fromArray(orientation);
         return flight;
     }
     /**
@@ -95,10 +96,10 @@ export class AeroflySettingsFlight {
      * @returns {AeroflyVector3Float} position vector to use in Aerofly FS4's `main.mcf`
      */
     get position() {
-        return Convert.convertLonLatToVector(this.longitude, this.latitude, this.altitude_meter);
+        return convertLonLatToVector(this.longitude, this.latitude, this.altitude_meter);
     }
     set position(position) {
-        const { longitude, latitude, altitude_meter } = Convert.convertVectorToLonLat(position);
+        const { longitude, latitude, altitude_meter } = convertVectorToLonLat(position);
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude_meter = altitude_meter;
@@ -109,26 +110,26 @@ export class AeroflySettingsFlight {
     get velocity() {
         const speed = this.speed_ms;
         const heading_rad = this.heading_degree * (Math.PI / 180);
-        return [Math.cos(heading_rad) * speed, Math.sin(heading_rad) * speed, 0];
+        return new AeroflyVector3Float(Math.cos(heading_rad) * speed, Math.sin(heading_rad) * speed, 0);
     }
     set velocity(velocity) {
         // TODO: implement setting velocity vector and updating speed accordingly
         this.speed_ms = 0;
     }
     get orientation() {
-        return Convert.convertDegreeToMatrix(this.heading_degree);
+        return convertHeadingToOrientation(this.heading_degree, this.position);
     }
     set orientation(orientation) {
-        this.heading_degree = Convert.convertMatrixToDegree(orientation);
+        this.heading_degree = convertOrientationToHeading(orientation, this.position);
     }
     /**
      * @returns {number} altitude in feet AGL
      */
     get altitude_ft() {
-        return Convert.convertMeterToFeet(this.altitude_meter);
+        return convertMeterToFeet(this.altitude_meter);
     }
     set altitude_ft(altitude_ft) {
-        this.altitude_meter = Convert.convertFeetToMeter(altitude_ft);
+        this.altitude_meter = convertFeetToMeter(altitude_ft);
     }
     /**
      * @returns {number} speed in meters per seconds
@@ -141,9 +142,9 @@ export class AeroflySettingsFlight {
     }
     getElement() {
         return new AeroflyConfigurationNode("tmsettings_flight", "flight_setting")
-            .appendChild("vector3_float64", "position", this.position, `Lon ${this.longitude.toFixed(6)}, Lat ${this.latitude.toFixed(6)}, ${Math.ceil(this.altitude_ft)} ft`)
-            .appendChild("vector3_float64", "velocity", this.velocity, `${Math.round(this.speed_kts)} kts`)
-            .appendChild("matrix3_float64", "orientation", this.orientation, `${Math.round(this.heading_degree)}° heading`)
+            .appendChild("vector3_float64", "position", this.position.toArray(), `Lon ${this.longitude.toFixed(6)}, Lat ${this.latitude.toFixed(6)}, ${Math.ceil(this.altitude_ft)} ft`)
+            .appendChild("vector3_float64", "velocity", this.velocity.toArray(), `${Math.round(this.speed_kts)} kts`)
+            .appendChild("matrix3_float64", "orientation", this.orientation.toArray(), `${Math.round(this.heading_degree)}° heading`)
             .appendChild("float64", "gear", this.gear)
             .appendChild("float64", "throttle", this.throttle)
             .appendChild("float64", "flaps", this.flaps)

package/dist/dto-flight/AeroflySettingsFlight.test.js

@@ -27,28 +27,6 @@ describe("AeroflySettingsFlight", () => {
         assert.strictEqual(flight.runway, "16L", `Expected runway to be 16L, got ${flight.runway}`);
         assertValidAeroflyStructure(flight.toString());
     });
-    it("should use valid orientation from main.mcf", () => {
-        const flight = new AeroflySettingsFlight(-122.3088, 47.4502, 1000, 90, 150);
-        // Canada
-        flight.orientation = [
-            -0.763419555334921, 0.645896043270811, 0.00298057365988389, -0.564914354076689, -0.665451427226094,
-            -0.487899754622681, -0.313149094027667, -0.374155982565915, 0.872894578754952,
-        ];
-        console.log("Orientation:", flight.heading_degree); // should be 270, is 216
-        // South Africa
-        flight.orientation = [
-            0.324874838801671, -0.945743434574979, 0.0050690306677758, -0.526455468124437, -0.185291526716742,
-            -0.829766045466347, 0.785685038164447, 0.266901491350839, -0.5580883574482,
-        ];
-        console.log("Orientation:", flight.heading_degree); // should be 270, is 301
-        // Japan
-        flight.orientation = [
-            0.717429258146935, 0.696613268777701, 0.00502128644729529, -0.393795668419003, 0.411487688662976,
-            -0.821950639401925, -0.574647919242008, 0.587714076606685, 0.569536595021937,
-        ];
-        console.log("Orientation:", flight.heading_degree); // should be 270, is 331
-        assertValidAeroflyStructure(flight.toString());
-    });
     it("should create fallbacks for flight configurations", () => {
         const flight = new AeroflySettingsFlight(-122.3088, 47.4502, 1000, 90, 150, {
             configuration: "OnGround",

package/dist/dto-flight/AeroflySettingsFuelLoad.js

@@ -1,5 +1,5 @@
 import { AeroflyConfigurationNode } from "../node/AeroflyConfigurationNode.js";
-import { Convert } from "../node/Convert.js";
+import { convertKgToLb, convertLbToKg } from "../node/Convert.js";
 export class AeroflySettingsFuelLoad {
     /**
      * @property {string} aircraft  aerofly aircraft name (e.g. "c172")
@@ -34,20 +34,20 @@ export class AeroflySettingsFuelLoad {
         this.configuration = configuration;
     }
     get fuelMass_lb() {
-        return Convert.convertKgToLb(this.fuelMass);
+        return convertKgToLb(this.fuelMass);
     }
     set fuelMass_lb(fuelMass_lb) {
-        this.fuelMass = Convert.convertLbToKg(fuelMass_lb);
+        this.fuelMass = convertLbToKg(fuelMass_lb);
     }
     get payloadMass_lb() {
-        return Convert.convertKgToLb(this.payloadMass);
+        return convertKgToLb(this.payloadMass);
     }
     set payloadMass_lb(payloadMass_lb) {
-        this.payloadMass = Convert.convertLbToKg(payloadMass_lb);
+        this.payloadMass = convertLbToKg(payloadMass_lb);
     }
     getElement() {
         return new AeroflyConfigurationNode("tmsettings_fuel_load", "fuel_load_setting")
-            .appendChild("fuel_load_configuration", "configuration", this.fuelMass > 0 ? "Keep" : this.configuration)
+            .appendChild("fuel_load_configuration", "configuration", this.fuelMass > 0 && this.configuration === "Invalid" ? "Custom" : this.configuration)
             .appendChild("string8u", "aircraft", this.aircraft)
             .appendChild("float64", "fuel_mass", this.fuelMass)
             .appendChild("float64", "payload_mass", this.payloadMass);

package/dist/node/AeroflyTypes.js

@@ -0,0 +1,63 @@
+export class AeroflyVector3Float {
+    x;
+    y;
+    z;
+    constructor(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    normalize() {
+        const norm = Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+        if (norm === 0) {
+            return new AeroflyVector3Float(0, 0, 0);
+        }
+        return new AeroflyVector3Float(this.x / norm, this.y / norm, this.z / norm);
+    }
+    cross(b) {
+        return new AeroflyVector3Float(this.y * b.z - this.z * b.y, this.z * b.x - this.x * b.z, this.x * b.y - this.y * b.x);
+    }
+    dot(b) {
+        return this.x * b.x + this.y * b.y + this.z * b.z;
+    }
+    static fromArray(array) {
+        return new this(...array);
+    }
+    toArray() {
+        return [this.x, this.y, this.z];
+    }
+}
+export class AeroflyMatrix3Float {
+    xx;
+    yx;
+    zx;
+    xy;
+    yy;
+    zy;
+    xz;
+    yz;
+    zz;
+    constructor(xx, yx, zx, xy, yy, zy, xz, yz, zz) {
+        this.xx = xx;
+        this.yx = yx;
+        this.zx = zx;
+        this.xy = xy;
+        this.yy = yy;
+        this.zy = zy;
+        this.xz = xz;
+        this.yz = yz;
+        this.zz = zz;
+    }
+    transpose() {
+        return new AeroflyMatrix3Float(this.xx, this.xy, this.xz, this.yx, this.yy, this.yz, this.zx, this.zy, this.zz);
+    }
+    multiplyVector(v) {
+        return new AeroflyVector3Float(this.xx * v.x + this.xy * v.y + this.xz * v.z, this.yx * v.x + this.yy * v.y + this.yz * v.z, this.zx * v.x + this.zy * v.y + this.zz * v.z);
+    }
+    static fromArray(array) {
+        return new this(...array);
+    }
+    toArray() {
+        return [this.xx, this.yx, this.zx, this.xy, this.yy, this.zy, this.xz, this.yz, this.zz];
+    }
+}