ootk 4.0.8 → 5.0.0

package/src/smoothing/ExponentialSmoothing.ts

@@ -15,7 +15,7 @@
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
  */
 
-import { EpochUTC } from 'ootk-core';
+import { EpochUTC } from '../main.js';
 
 // / Exponential data smoothing methods.
 export class ExponentialSmoothing {

package/src/time/Epoch.ts

@@ -0,0 +1,128 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Seconds } from '../main.js';
+import { secondsPerDay } from '../utils/constants.js';
+
+// / Base class for [Epoch] data.
+export class Epoch {
+  /*
+   * Create a new [Epoch] object given the number of seconds elapsed since the
+   * [posix] epoch _(`1970-01-01T00:00:00.000`)_ in the [Epoch] time scale.
+   */
+  constructor(public posix: Seconds) {
+    if (posix < 0) {
+      throw new Error('Epoch cannot be negative');
+    }
+  }
+
+  toString(): string {
+    return this.toDateTime().toISOString();
+  }
+
+  // / Convert this to an Excel spreadsheet string.
+  toExcelString(): string {
+    return this.toString().substring(0, 19);
+  }
+
+  // / Return the difference _(s)_ between this and another [epoch]/
+  difference(epoch: Epoch): Seconds {
+    return this.posix - epoch.posix as Seconds;
+  }
+
+  // / Check if this has the same timestamp as the provided [epoch].
+  equals(epoch: Epoch): boolean {
+    return this.posix === epoch.posix;
+  }
+
+  // / Convert to a [DateTime] object.
+  toDateTime(): Date {
+    return new Date(this.posix * 1000);
+  }
+
+  toEpochYearAndDay(): { epochYr: string; epochDay: string } {
+    const currentDateObj = this.toDateTime();
+    const epochYear = currentDateObj.getUTCFullYear().toString().slice(2, 4);
+    const epochDay = this.getDayOfYear_(currentDateObj);
+    const timeOfDay = (currentDateObj.getUTCHours() * 60 + currentDateObj.getUTCMinutes()) / 1440;
+    const epochDayStr = (epochDay + timeOfDay).toFixed(8).padStart(12, '0');
+
+    return {
+      epochYr: epochYear,
+      epochDay: epochDayStr,
+    };
+  }
+
+  private getDayOfYear_(date: Date): number {
+    const dayCount = [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334] as const;
+    const mn = date.getUTCMonth();
+    const dn = date.getUTCDate();
+    let dayOfYear = (dayCount[mn] as number) + dn;
+
+    if (mn > 1 && this.isLeapYear_(date)) {
+      dayOfYear++;
+    }
+
+    return dayOfYear;
+  }
+
+  private isLeapYear_(dateIn: Date) {
+    const year = dateIn.getUTCFullYear();
+
+    if ((year & 3) !== 0) {
+      return false;
+    }
+
+    return year % 100 !== 0 || year % 400 === 0;
+  }
+
+  // / Convert to Julian date.
+  toJulianDate(): number {
+    return this.posix / secondsPerDay + 2440587.5;
+  }
+
+  // / Convert to Julian centuries.
+  toJulianCenturies(): number {
+    return (this.toJulianDate() - 2451545) / 36525;
+  }
+
+  // / Check if this is later than the [other] epoch.
+  operatorGreaterThan(other: Epoch): boolean {
+    return this.posix > other.posix;
+  }
+
+  // / Check if this is later or the same as the [other] epoch.
+  operatorGreaterThanOrEqual(other: Epoch): boolean {
+    return this.posix >= other.posix;
+  }
+
+  // / Check if this is earlier than the [other] epoch.
+  operatorLessThan(other: Epoch): boolean {
+    return this.posix < other.posix;
+  }
+
+  // / Check if this is earlier or the same as the [other] epoch.
+  operatorLessThanOrEqual(other: Epoch): boolean {
+    return this.posix <= other.posix;
+  }
+}

package/src/time/EpochGPS.ts

@@ -0,0 +1,76 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Seconds } from '../main.js';
+import { DataHandler } from '../data/DataHandler.js';
+import { secondsPerWeek } from '../utils/constants.js';
+import type { EpochUTC } from './EpochUTC.js';
+// / Global Positioning System _(GPS)_ formatted epoch.
+export class EpochGPS {
+  /**
+   * Create a new GPS epoch given the [week] since reference epoch, and number
+   * of [seconds] into the [week].
+   * @param week Number of weeks since the GPS reference epoch.
+   * @param seconds Number of seconds into the week.
+   * @param reference Reference should always be EpochUTC.fromDateTimeString('1980-01-06T00:00:00.000Z').
+   */
+  constructor(public week: number, public seconds: number, reference: EpochUTC) {
+    if (week < 0) {
+      throw new Error('GPS week must be non-negative.');
+    }
+    if (seconds < 0 || seconds >= secondsPerWeek) {
+      throw new Error('GPS seconds must be within a week.');
+    }
+
+    // TODO: #9 Set EpochGPS.reference statically without circular dependency.
+    EpochGPS.reference = reference;
+  }
+
+  // / Number of weeks since the GPS reference epoch.
+  static reference: EpochUTC;
+
+  // / GPS leap second difference from TAI/UTC offsets.
+  static offset = 19 as Seconds;
+
+  // / Get GPS week accounting for 10-bit rollover.
+  get week10Bit(): number {
+    return this.week % 2 ** 10;
+  }
+
+  // / Get GPS week accounting for 13-bit rollover.
+  get week13Bit(): number {
+    return this.week % 2 ** 13;
+  }
+
+  toString(): string {
+    return `${this.week}:${this.seconds.toFixed(3)}`;
+  }
+
+  // / Convert this to a UTC epoch.
+  toUTC(): EpochUTC {
+    const init = EpochGPS.reference.roll((this.week * secondsPerWeek + this.seconds) as Seconds);
+    const ls = DataHandler.getInstance().getLeapSeconds(init.toJulianDate());
+
+    return init.roll(-(ls - EpochGPS.offset) as Seconds);
+  }
+}

package/src/time/EpochTAI.ts

@@ -0,0 +1,27 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Epoch } from './Epoch.js';
+
+/** Represents an Epoch in International Atomic Time (TAI). */
+export class EpochTAI extends Epoch { }

package/src/time/EpochTDB.ts

@@ -0,0 +1,27 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Epoch } from './Epoch.js';
+
+/** Represents an Epoch in TDB (Barycentric Dynamical Time). */
+export class EpochTDB extends Epoch { }

package/src/time/EpochTT.ts

@@ -0,0 +1,27 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Epoch } from './Epoch.js';
+
+/** Represents a Terrestrial Time (TT) epoch. */
+export class EpochTT extends Epoch { }

package/src/time/EpochUTC.ts

@@ -0,0 +1,188 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Seconds } from '../main.js';
+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';
+
+type FromDateParams = {
+  year: number;
+  month: number;
+  day: number;
+  hour?: number;
+  minute?: number;
+  second?: number;
+};
+
+type DateToPosixParams = {
+  year: number;
+  month: number;
+  day: number;
+  hour: number;
+  minute: number;
+  second: number;
+};
+
+export class EpochUTC extends Epoch {
+  static now() {
+    return new EpochUTC(new Date().getTime() / 1000 as Seconds);
+  }
+
+  static fromDate({ year, month, day, hour = 0, minute = 0, second = 0 }: FromDateParams) {
+    return new EpochUTC(EpochUTC.dateToPosix_({ year, month, day, hour, minute, second }));
+  }
+
+  static fromDateTime(dt: Date) {
+    return new EpochUTC(dt.getTime() / 1000 as Seconds);
+  }
+
+  static fromDateTimeString(dateTimeString: string): EpochUTC {
+    const dts = dateTimeString.trim().toUpperCase().endsWith('Z') ? dateTimeString : `${dateTimeString}Z`;
+
+    return new EpochUTC(new Date(dts).getTime() / 1000 as Seconds);
+  }
+
+  static fromJ2000TTSeconds(seconds: Seconds): EpochUTC {
+    const tInit = new EpochUTC(seconds + 946728000 as Seconds);
+    const ls = DataHandler.getInstance().getLeapSeconds(tInit.toJulianDate());
+
+    return tInit.roll(-32.184 - ls as Seconds);
+  }
+
+  static fromDefinitiveString(definitiveString: string): EpochUTC {
+    const fields = definitiveString.trim().split(' ') as [string, string];
+    const dateFields = fields[0].split('/') as [string, string];
+    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 as Seconds);
+  }
+
+  roll(seconds: Seconds): EpochUTC {
+    return new EpochUTC(this.posix + seconds as Seconds);
+  }
+
+  toMjd(): number {
+    return this.toJulianDate() - 2400000.5;
+  }
+
+  toMjdGsfc(): number {
+    return this.toMjd() - 29999.5;
+  }
+
+  toTAI(): EpochTAI {
+    const ls = DataHandler.getInstance().getLeapSeconds(this.toJulianDate());
+
+    return new EpochTAI(this.posix + ls as Seconds);
+  }
+
+  toTT(): EpochTT {
+    return new EpochTT(this.toTAI().posix + 32.184 as Seconds);
+  }
+
+  toTDB(): EpochTDB {
+    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) as Seconds;
+
+    return new EpochTDB(tt.posix + seconds as Seconds);
+  }
+
+  toGPS(): EpochGPS {
+    const referenceTime = EpochUTC.fromDateTimeString('1980-01-06T00:00:00.000Z');
+    const ls = DataHandler.getInstance().getLeapSeconds(this.toJulianDate());
+    const delta = this.roll(ls - EpochGPS.offset as Seconds).difference(referenceTime);
+    const week = delta / secondsPerWeek;
+    const weekFloor = Math.floor(week);
+    const seconds = (week - weekFloor) * secondsPerWeek;
+
+    return new EpochGPS(weekFloor, seconds, referenceTime);
+  }
+
+  gmstAngle(): number {
+    const t = this.toJulianCenturies();
+    const seconds = evalPoly(t, EpochUTC.gmstPoly_);
+    let result = ((seconds / 240) * DEG2RAD) % TAU;
+
+    if (result < 0) {
+      result += TAU;
+    }
+
+    return result;
+  }
+
+  gmstAngleDegrees(): number {
+    return this.gmstAngle() * RAD2DEG;
+  }
+
+  private static readonly gmstPoly_: Float64Array = new Float64Array([
+    -6.2e-6,
+    0.093104,
+    876600 * 3600 + 8640184.812866,
+    67310.54841,
+  ]);
+
+  private static readonly dayOfYearLookup_: number[][] = [
+    [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334],
+    [0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335],
+  ] as const;
+
+  private static isLeapYear_(year: number): boolean {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+  }
+
+  private static dayOfYear_(year: number, month: number, day: number): number {
+    const dex = EpochUTC.isLeapYear_(year) ? 1 : 0;
+    const dayOfYearArray = EpochUTC.dayOfYearLookup_[dex] as number[];
+    const daysBeforeCurrentMonth = dayOfYearArray[month - 1] as number;
+
+    return daysBeforeCurrentMonth + day - 1;
+  }
+
+  private static dateToPosix_({ year, month, day, hour, minute, second }: DateToPosixParams): Seconds {
+    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
+    ) as Seconds;
+  }
+}

package/src/time/EpochWindow.ts

@@ -0,0 +1,33 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import type { EpochUTC } from './EpochUTC.js';
+
+export class EpochWindow {
+  start: EpochUTC;
+  end: EpochUTC;
+  constructor(start: EpochUTC, end: EpochUTC) {
+    this.start = start;
+    this.end = end;
+  }
+}

package/src/time/TimeStamped.ts

@@ -0,0 +1,50 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import type { EpochUTC } from './EpochUTC.js';
+
+/**
+ * Time stamped value container.
+ * TODO: #10 Is TimeStamped class needed?
+ */
+export 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) {
+    this.epoch = epoch;
+    this.value = value;
+  }
+
+  /**
+   * Timestamp epoch.
+   */
+  readonly epoch: EpochUTC;
+
+  /**
+   * Timestamped value.
+   */
+  readonly value: T;
+}

package/src/time/index.ts

@@ -0,0 +1,31 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+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/src/transforms/TransformCache.ts

@@ -0,0 +1,46 @@
+/**
+ * @author Theodore Kruczek.
+ * @license MIT
+ * @copyright (c) 2022-2025 Theodore Kruczek Permission is
+ * hereby granted, free of charge, to any person obtaining a copy of this
+ * software and associated documentation files (the "Software"), to deal in the
+ * Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export class TransformCache {
+  private static readonly cache_: Map<string, unknown> = new Map();
+
+  static get(key: string): unknown {
+    const value = this.cache_.get(key);
+
+    return value;
+  }
+  static add(key: string, value: unknown) {
+    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);
+    }
+  }
+}