ootk 4.0.9 → 5.1.0

package/dist/time/EpochTT.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Epoch } from './Epoch.js';
+/** Represents a Terrestrial Time (TT) epoch. */
+export declare class EpochTT extends Epoch {
+}

package/dist/time/EpochTT.js

@@ -0,0 +1,27 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Epoch } from './Epoch.js';
+/** Represents a Terrestrial Time (TT) epoch. */
+export class EpochTT extends Epoch {
+}
+//# sourceMappingURL=EpochTT.js.map

package/dist/time/EpochTT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EpochTT.js","sourceRoot":"","sources":["../../src/time/EpochTT.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,gDAAgD;AAChD,MAAM,OAAO,OAAQ,SAAQ,KAAK;CAAI"}

package/dist/time/EpochUTC.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Seconds } from '../main.js';
+import { Epoch } from './Epoch.js';
+import { EpochGPS } from './EpochGPS.js';
+import { EpochTAI } from './EpochTAI.js';
+import { EpochTDB } from './EpochTDB.js';
+import { EpochTT } from './EpochTT.js';
+type FromDateParams = {
+    year: number;
+    month: number;
+    day: number;
+    hour?: number;
+    minute?: number;
+    second?: number;
+};
+export declare class EpochUTC extends Epoch {
+    static now(): EpochUTC;
+    static fromDate({ year, month, day, hour, minute, second }: FromDateParams): EpochUTC;
+    static fromDateTime(dt: Date): EpochUTC;
+    static fromDateTimeString(dateTimeString: string): EpochUTC;
+    static fromJ2000TTSeconds(seconds: Seconds): EpochUTC;
+    static fromDefinitiveString(definitiveString: string): EpochUTC;
+    roll(seconds: Seconds): EpochUTC;
+    toMjd(): number;
+    toMjdGsfc(): number;
+    toTAI(): EpochTAI;
+    toTT(): EpochTT;
+    toTDB(): EpochTDB;
+    toGPS(): EpochGPS;
+    gmstAngle(): number;
+    gmstAngleDegrees(): number;
+    private static readonly gmstPoly_;
+    private static readonly dayOfYearLookup_;
+    private static isLeapYear_;
+    private static dayOfYear_;
+    private static dateToPosix_;
+}
+export {};

package/dist/time/EpochUTC.js

@@ -0,0 +1,137 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import { DEG2RAD, MS_PER_DAY, RAD2DEG, secondsPerWeek, TAU } from '../utils/constants.js';
+import { evalPoly } from '../utils/functions.js';
+import { DataHandler } from './../data/DataHandler.js';
+import { Epoch } from './Epoch.js';
+import { EpochGPS } from './EpochGPS.js';
+import { EpochTAI } from './EpochTAI.js';
+import { EpochTDB } from './EpochTDB.js';
+import { EpochTT } from './EpochTT.js';
+export class EpochUTC extends Epoch {
+    static now() {
+        return new EpochUTC(new Date().getTime() / 1000);
+    }
+    static fromDate({ year, month, day, hour = 0, minute = 0, second = 0 }) {
+        return new EpochUTC(EpochUTC.dateToPosix_({ year, month, day, hour, minute, second }));
+    }
+    static fromDateTime(dt) {
+        return new EpochUTC(dt.getTime() / 1000);
+    }
+    static fromDateTimeString(dateTimeString) {
+        const dts = dateTimeString.trim().toUpperCase().endsWith('Z') ? dateTimeString : `${dateTimeString}Z`;
+        return new EpochUTC(new Date(dts).getTime() / 1000);
+    }
+    static fromJ2000TTSeconds(seconds) {
+        const tInit = new EpochUTC(seconds + 946728000);
+        const ls = DataHandler.getInstance().getLeapSeconds(tInit.toJulianDate());
+        return tInit.roll(-32.184 - ls);
+    }
+    static fromDefinitiveString(definitiveString) {
+        const fields = definitiveString.trim().split(' ');
+        const dateFields = fields[0].split('/');
+        const day = parseInt(dateFields[0]);
+        const year = parseInt(dateFields[1]);
+        // eslint-disable-next-line prefer-destructuring
+        const timeField = fields[1];
+        // Add day - 1 days in milliseconds to the epoch.
+        const dts = new Date(`${year}-01-01T${timeField}Z`).getTime() + (day - 1) * MS_PER_DAY;
+        return new EpochUTC(dts / 1000);
+    }
+    roll(seconds) {
+        return new EpochUTC(this.posix + seconds);
+    }
+    toMjd() {
+        return this.toJulianDate() - 2400000.5;
+    }
+    toMjdGsfc() {
+        return this.toMjd() - 29999.5;
+    }
+    toTAI() {
+        const ls = DataHandler.getInstance().getLeapSeconds(this.toJulianDate());
+        return new EpochTAI(this.posix + ls);
+    }
+    toTT() {
+        return new EpochTT(this.toTAI().posix + 32.184);
+    }
+    toTDB() {
+        const tt = this.toTT();
+        const tTT = tt.toJulianCenturies();
+        const mEarth = (357.5277233 + 35999.05034 * tTT) * DEG2RAD;
+        const seconds = 0.001658 * Math.sin(mEarth) + 0.00001385 * Math.sin(2 * mEarth);
+        return new EpochTDB(tt.posix + seconds);
+    }
+    toGPS() {
+        const referenceTime = EpochUTC.fromDateTimeString('1980-01-06T00:00:00.000Z');
+        const ls = DataHandler.getInstance().getLeapSeconds(this.toJulianDate());
+        const delta = this.roll(ls - EpochGPS.offset).difference(referenceTime);
+        const week = delta / secondsPerWeek;
+        const weekFloor = Math.floor(week);
+        const seconds = (week - weekFloor) * secondsPerWeek;
+        return new EpochGPS(weekFloor, seconds, referenceTime);
+    }
+    gmstAngle() {
+        const t = this.toJulianCenturies();
+        const seconds = evalPoly(t, EpochUTC.gmstPoly_);
+        let result = ((seconds / 240) * DEG2RAD) % TAU;
+        if (result < 0) {
+            result += TAU;
+        }
+        return result;
+    }
+    gmstAngleDegrees() {
+        return this.gmstAngle() * RAD2DEG;
+    }
+    static gmstPoly_ = new Float64Array([
+        -6.2e-6,
+        0.093104,
+        876600 * 3600 + 8640184.812866,
+        67310.54841,
+    ]);
+    static dayOfYearLookup_ = [
+        [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334],
+        [0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335],
+    ];
+    static isLeapYear_(year) {
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    }
+    static dayOfYear_(year, month, day) {
+        const dex = EpochUTC.isLeapYear_(year) ? 1 : 0;
+        const dayOfYearArray = EpochUTC.dayOfYearLookup_[dex];
+        const daysBeforeCurrentMonth = dayOfYearArray[month - 1];
+        return daysBeforeCurrentMonth + day - 1;
+    }
+    static dateToPosix_({ year, month, day, hour, minute, second }) {
+        const days = EpochUTC.dayOfYear_(year, month, day);
+        const yearMod = year - 1900;
+        return (minute * 60 +
+            hour * 3600 +
+            days * 86400 +
+            (yearMod - 70) * 31536000 +
+            Math.floor((yearMod - 69) / 4) * 86400 -
+            Math.floor((yearMod - 1) / 100) * 86400 +
+            Math.floor((yearMod + 299) / 400) * 86400 +
+            second);
+    }
+}
+//# sourceMappingURL=EpochUTC.js.map

package/dist/time/EpochUTC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EpochUTC.js","sourceRoot":"","sources":["../../src/time/EpochUTC.ts"],"names":[],"mappings":"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"}

package/dist/time/EpochWindow.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import type { EpochUTC } from './EpochUTC.js';
+export declare class EpochWindow {
+    start: EpochUTC;
+    end: EpochUTC;
+    constructor(start: EpochUTC, end: EpochUTC);
+}

package/dist/time/EpochWindow.js

@@ -0,0 +1,31 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+export class EpochWindow {
+    start;
+    end;
+    constructor(start, end) {
+        this.start = start;
+        this.end = end;
+    }
+}
+//# sourceMappingURL=EpochWindow.js.map

package/dist/time/EpochWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EpochWindow.js","sourceRoot":"","sources":["../../src/time/EpochWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,OAAO,WAAW;IACtB,KAAK,CAAW;IAChB,GAAG,CAAW;IACd,YAAY,KAAe,EAAE,GAAa;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}

package/dist/time/TimeStamped.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import type { EpochUTC } from './EpochUTC.js';
+export declare class TimeStamped<T> {
+    /**
+     * Create a new time stamped value container at the provided epoch.
+     * @param epoch The timestamp epoch.
+     * @param value The timestamped value.
+     */
+    constructor(epoch: EpochUTC, value: T);
+    /**
+     * Timestamp epoch.
+     */
+    readonly epoch: EpochUTC;
+    /**
+     * Timestamped value.
+     */
+    readonly value: T;
+}

package/dist/time/TimeStamped.js

@@ -0,0 +1,42 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+export class TimeStamped {
+    /**
+     * Create a new time stamped value container at the provided epoch.
+     * @param epoch The timestamp epoch.
+     * @param value The timestamped value.
+     */
+    constructor(epoch, value) {
+        this.epoch = epoch;
+        this.value = value;
+    }
+    /**
+     * Timestamp epoch.
+     */
+    epoch;
+    /**
+     * Timestamped value.
+     */
+    value;
+}
+//# sourceMappingURL=TimeStamped.js.map

package/dist/time/TimeStamped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeStamped.js","sourceRoot":"","sources":["../../src/time/TimeStamped.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,OAAO,WAAW;IACtB;;;;OAIG;IACH,YAAY,KAAe,EAAE,KAAQ;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACM,KAAK,CAAW;IAEzB;;OAEG;IACM,KAAK,CAAI;CACnB"}

package/dist/time/index.d.ts

@@ -0,0 +1,8 @@
+export { Epoch } from './Epoch.js';
+export { EpochGPS } from './EpochGPS.js';
+export { EpochTAI } from './EpochTAI.js';
+export { EpochTDB } from './EpochTDB.js';
+export { EpochTT } from './EpochTT.js';
+export { EpochUTC } from './EpochUTC.js';
+export { EpochWindow } from './EpochWindow.js';
+export { TimeStamped } from './TimeStamped.js';

package/dist/time/index.js

@@ -0,0 +1,9 @@
+export { Epoch } from './Epoch.js';
+export { EpochGPS } from './EpochGPS.js';
+export { EpochTAI } from './EpochTAI.js';
+export { EpochTDB } from './EpochTDB.js';
+export { EpochTT } from './EpochTT.js';
+export { EpochUTC } from './EpochUTC.js';
+export { EpochWindow } from './EpochWindow.js';
+export { TimeStamped } from './TimeStamped.js';
+//# sourceMappingURL=index.js.map

package/dist/time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/transforms/TransformCache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+export declare class TransformCache {
+    private static readonly cache_;
+    static get(key: string): unknown;
+    static add(key: string, value: unknown): void;
+}

package/dist/transforms/TransformCache.js

@@ -0,0 +1,41 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+export class TransformCache {
+    static cache_ = new Map();
+    static get(key) {
+        const value = this.cache_.get(key);
+        return value;
+    }
+    static add(key, value) {
+        this.cache_.set(key, value);
+        // Max of 1000 items in the cache
+        if (this.cache_.size > 1000) {
+            const firstKey = this.cache_.keys().next().value;
+            if (!firstKey) {
+                return;
+            }
+            this.cache_.delete(firstKey);
+        }
+    }
+}
+//# sourceMappingURL=TransformCache.js.map

package/dist/transforms/TransformCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformCache.js","sourceRoot":"","sources":["../../src/transforms/TransformCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAU,MAAM,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEjE,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;QACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE5B,iCAAiC;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC"}

package/dist/transforms/conversions.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @author @thkruz Theodore Kruczek
+ * @description Orbital Object ToolKit (ootk) is a collection of tools for working
+ * with satellites and other orbital objects.
+ * @license AGPL-3.0-or-later
+ * @copyright (c) 2025 Kruczek Labs LLC
+ *
+ * Many of the classes are based off of the work of @david-rc-dayton and his
+ * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which
+ * is licensed under the MIT license.
+ *
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
+ */
+import { Degrees, Radians } from '../main.js';
+/**
+ * Converts radians to degrees.
+ * @param radians The value in radians to be converted.
+ * @returns The value in degrees.
+ */
+export declare function rad2deg(radians: Radians): Degrees;
+/**
+ * Converts degrees to radians.
+ * @param degrees The value in degrees to be converted.
+ * @returns The value in radians.
+ */
+export declare function deg2rad(degrees: Degrees): Radians;
+/**
+ * Converts radians to degrees latitude.
+ * @param radians The radians value to convert.
+ * @returns The corresponding degrees latitude.
+ * @throws RangeError if the radians value is outside the range [-PI/2; PI/2].
+ */
+export declare function getDegLat(radians: Radians): Degrees;
+/**
+ * Converts radians to degrees for longitude.
+ * @param radians The value in radians to be converted.
+ * @returns The converted value in degrees.
+ * @throws {RangeError} If the input radians is not within the range [-PI; PI].
+ */
+export declare function getDegLon(radians: Radians): Degrees;
+/**
+ * Converts degrees to radians for latitude.
+ * @param degrees The degrees value to convert.
+ * @returns The equivalent radians value.
+ * @throws {RangeError} If the degrees value is not within the range [-90, 90].
+ */
+export declare function getRadLat(degrees: Degrees): Radians;
+/**
+ * Converts degrees to radians.
+ * @param degrees The value in degrees to be converted.
+ * @returns The value in radians.
+ * @throws {RangeError} If the input degrees are not within the range [-180; 180].
+ */
+export declare function getRadLon(degrees: Degrees): Radians;