@interstellar-tools/types 0.1.1

package/README.md

@@ -0,0 +1,18 @@
+# @interstellar-tools/types
+
+## Installation
+
+- [Node.js](https://nodejs.org/) version 22.9.0 or higher
+- npm version 11.5.1 or higher
+
+::: code-group
+
+```shell [npm]
+npm i --save @interstellar-tools/types
+```
+
+```shell [yarn]
+yarn add @interstellar-tools/types
+```
+
+:::

package/dist/celestial-bodies/asteroid-belts.d.ts

@@ -0,0 +1,47 @@
+import { CartesianCoordinatesInterface } from './planets';
+/**
+ * Represents an asteroid belt within the solar system simulation.
+ *
+ * **Asteroid Belt Properties:**
+ * - **Inner and Outer Radius**: Defines the spatial boundaries of the belt in **Astronomical Units (AU)**.
+ * - **Density**: Determines the number of simulated asteroids within the belt.
+ * - **Color and Opacity**: Used for visualization.
+ * - **Orbit Path (Optional)**: Stores a precomputed path for asteroid positioning.
+ *
+ * @category Celestial Bodies
+ */
+export interface AsteroidBeltInterface {
+    /** Name of the asteroid belt. */
+    name: string;
+    /** Inner radius of the belt in Astronomical Units (AU). */
+    innerRadius: number;
+    /** Outer radius of the belt in Astronomical Units (AU). */
+    outerRadius: number;
+    /** Belt color for visualization. */
+    color: string;
+    /** Transparency level (0 = fully transparent, 1 = solid). */
+    opacity: number;
+    /** Density factor affecting how many asteroids are simulated. */
+    density: number;
+    /** Optional: Orbit path for finer asteroid positioning. */
+    orbitPath?: CartesianCoordinatesInterface[];
+}
+/**
+ * Type alias for a collection of asteroid belts.
+ *
+ * @typedef {AsteroidBeltInterface[]} AsteroidBeltsType
+ * @example
+ * ```ts
+ * const asteroidBelt: AsteroidBeltInterface = {
+ *   name: 'Main Belt',
+ *   innerRadius: 2.1,
+ *   outerRadius: 3.3,
+ *   color: '#888888',
+ *   opacity: 0.5,
+ *   density: 100,
+ * };
+ * ```
+ * @category Celestial Bodies
+ */
+export type AsteroidBeltsType = AsteroidBeltInterface[];
+//# sourceMappingURL=asteroid-belts.d.ts.map

package/dist/celestial-bodies/asteroid-belts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asteroid-belts.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroid-belts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC"}

package/dist/celestial-bodies/asteroid-belts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asteroid-belts.js.map

package/dist/celestial-bodies/asteroid-belts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asteroid-belts.js","sourceRoot":"","sources":["../../src/celestial-bodies/asteroid-belts.ts"],"names":[],"mappings":""}

package/dist/celestial-bodies/asteroids.d.ts

@@ -0,0 +1,191 @@
+import { DistanceInterface, MeasureInterface } from '../distance';
+import { Radians } from '../numeric';
+import { TemporalInterface } from '../temporal';
+import { CartesianCoordinatesInterface } from './planets';
+/**
+ * High-level **orbital class** of an asteroid (by dynamical region).
+ *
+ *
+ * ::: info
+ *
+ * These labels group objects by where they reside or co-orbit:
+ * - *Main-belt* (between Mars and Jupiter)
+ * - *Near-Earth* (perihelion near Earth’s orbit)
+ * - *Trojan* (co-orbital with a planet at L4/L5)
+ * - *Centaur* (between Jupiter and Neptune)
+ * - *Trans-Neptunian Object* (beyond Neptune)
+ *
+ * :::
+ *
+ * @category Celestial Bodies
+ */
+export type AsteroidType = 'main-belt asteroid' | 'near-earth asteroid' | 'trojan asteroid' | 'centaur' | 'trans-neptunian object';
+/**
+ * More specific **group/category** for dynamical families or special bodies.
+ *
+ *
+ * ::: info
+ *
+ * Common near-Earth subgroups: Amor / Apollo / Aten / Atira.
+ * Outer main-belt families: Cybele / Hilda. TNOs: Plutinos (2:3 resonance),
+ * "classical" Kuiper belt objects (*cubewanos*), and *scattered disk* objects.
+ *
+ * :::
+ *
+ * @category Celestial Bodies
+ */
+export type AsteroidCategory = 'dwarf planet' | 'large asteroid' | 'amor group' | 'apollo group' | 'aten group' | 'atira group' | 'cybele group' | 'hilda group' | 'jupiter trojan' | 'plutino' | 'cubewano' | 'scattered disk object';
+/**
+ * **Spectral (taxonomic) class** based on reflectance spectra & albedo.
+ *
+ *
+ * ::: info
+ *
+ * Examples:
+ * - **C** (carbonaceous, dark), **S** (stony, silicaceous), **M** (metal-rich)
+ * - **V** (Vesta-like, basaltic), **D/P** (very red/dark, outer system)
+ * - **B/F/G** (subclasses of C/X), **E** (high-albedo enstatite), **X** (degenerate group)
+ *
+ * :::
+ *
+ * @category Celestial Bodies
+ */
+export type AsteroidSpectralType = 'c-type' | 's-type' | 'v-type' | 'm-type' | 'b-type' | 'd-type' | 'p-type' | 'f-type' | 'g-type' | 'x-type' | 'e-type' | 'other';
+/**
+ * Canonical shape for an **asteroid record**: identity, dynamics, and optional
+ * visualization aides.
+ *
+ *
+ * ::: info
+ *
+ * **Orbital elements (angles & distances):**
+ *
+ * - Semi-major axis `a` should be in **astronomical units (au)** via {@link MeasureInterface}.
+ * - Eccentricity `e` for bound ellipses typically satisfies \(0 \le e < 1\).
+ * - Inclination `i`, argument of perihelion `w` (ω), and longitude of ascending node `om` (Ω)
+ *   are given in **degrees**.
+ * - True anomaly `angle` (ν) is in **radians**.
+ * - Perihelion distance \(q\) should satisfy:
+ *
+ * $$
+ * q \;=\; a\,(1 - e)
+ * $$
+ *
+ * **Period convention:** `period` is a duration (e.g., in **days**) using {@link TemporalInterface}.
+ * If you encode direction, a **negative value** indicates **counter-clockwise** in your display
+ * convention (visualization-specific; not a physical requirement).
+ *
+ * **Coordinates:** Optional `x,y,z` are distances in a chosen reference frame (e.g., ecliptic
+ * J2000). Always document the frame you use in calling code.
+ *
+ * :::
+ *
+ * @category Celestial Bodies
+ */
+export interface AsteroidInterface {
+    /** Name of the asteroid (e.g., `"Ceres"`, `"Vesta"`). */
+    name: string;
+    /** General dynamical region (e.g., main-belt, NEO, Trojan). */
+    type: AsteroidType;
+    /** Specific family/group classification (e.g., Apollo group, Plutino). */
+    category: AsteroidCategory;
+    /** Spectral/taxonomic class (composition & albedo proxy). */
+    spectralType: AsteroidSpectralType;
+    /** Star system identifier (e.g., `"Solar System"`). */
+    system: string;
+    /**
+     * **Semi-major axis** (typically in **au**).
+     *
+     * @example
+     * ```ts
+     * a: { value: 2.77, unit: 'au' }
+     * ```
+     */
+    a: MeasureInterface;
+    /**
+     * **Eccentricity** of the orbit.
+     * ::: info
+     *
+     * Elliptical orbits: \(0 \le e < 1\). Parabolic: \(e=1\). Hyperbolic: \(e>1\).
+     *
+     * :::
+     */
+    e: number;
+    /** **Inclination** \(i\) in **degrees**. */
+    i: number;
+    /** **Argument of perihelion** \( \omega \) in **degrees**. */
+    w: number;
+    /** **Longitude of ascending node** \( \Omega \) in **degrees**. */
+    om: number;
+    /** **True anomaly** \( \nu \) (current orbital position) in **radians**. */
+    angle: Radians;
+    /**
+     * **Orbital period** as a duration (e.g., in **days**).
+     * ::: info
+     *
+     * A **negative** value may be used to flag **counter-clockwise** drawing direction in UIs.
+     *
+     * :::
+     */
+    period: TemporalInterface;
+    /**
+     * **Perihelion distance** \( q = a(1-e) \) (typically in **au**).
+     * @see a
+     * @see e
+     */
+    q: number;
+    /**
+     * Optional **Cartesian coordinates** (distance values) in a specified frame.
+     * ::: info
+     *
+     * Provide the reference frame (e.g., ecliptic J2000) in calling code.
+     *
+     * :::
+     */
+    x?: DistanceInterface;
+    /** See {@link x}. */
+    y?: DistanceInterface;
+    /** See {@link x}. */
+    z?: DistanceInterface;
+    /**
+     * Optional **semi-minor axis** in **pixels** (for 2D ellipse rendering).
+     *
+     * ::: info
+     *
+     * Visualization aid only; not a physical quantity.
+     *
+     * :::
+     */
+    miA?: number;
+    /**
+     * Optional **focus offset** along X for ellipse rendering (pixels).
+     *
+     * ::: info
+     *
+     * Visualization aid only; not a physical quantity.
+     *
+     * :::
+     */
+    focus_x?: number;
+    /** Mean/characteristic **radius** (e.g., in **km**) as a distance value. */
+    radius: DistanceInterface;
+    /**
+     * Optional precomputed **orbit path** for plotting.
+     * ::: info
+     *
+     * Commonly a list of points in your rendering coordinate system.
+     *
+     * :::
+     */
+    orbitPath?: CartesianCoordinatesInterface[];
+    /** Display color (hex string, e.g., `#AABBCC`). */
+    color: string;
+    /** Visual **scale factor** (UI only; not physical size). */
+    size: number;
+}
+/**
+ * Convenience alias for a list of asteroids.
+ * @category Celestial Bodies
+ */
+export type AsteroidsType = AsteroidInterface[];
+//# sourceMappingURL=asteroids.d.ts.map

package/dist/celestial-bodies/asteroids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asteroids.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,iBAAiB,GACjB,SAAS,GACT,wBAAwB,CAAC;AAE7B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,aAAa,GACb,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,SAAS,GACT,UAAU,GACV,uBAAuB,CAAC;AAE5B;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,IAAI,EAAE,YAAY,CAAC;IAEnB,0EAA0E;IAC1E,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,6DAA6D;IAC7D,YAAY,EAAE,oBAAoB,CAAC;IAEnC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;OAOG;IACH,CAAC,EAAE,gBAAgB,CAAC;IAEpB;;;;;;;OAOG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV,4CAA4C;IAC5C,CAAC,EAAE,MAAM,CAAC;IAEV,8DAA8D;IAC9D,CAAC,EAAE,MAAM,CAAC;IAEV,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IAEX,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IAEf;;;;;;;OAOG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;;;OAIG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,qBAAqB;IACrB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,qBAAqB;IACrB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAEtB;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4EAA4E;IAC5E,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;IAE5C,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/celestial-bodies/asteroids.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asteroids.js.map

package/dist/celestial-bodies/asteroids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asteroids.js","sourceRoot":"","sources":["../../src/celestial-bodies/asteroids.ts"],"names":[],"mappings":""}

package/dist/celestial-bodies/celestial-bodies.d.ts

@@ -0,0 +1,45 @@
+import { AsteroidInterface, AsteroidsType } from './asteroids';
+import { CometInterface, CometsType } from './comets';
+import { MoonInterface, MoonsType } from './moons';
+import { PlanetInterface, PlanetsType } from './planets';
+import { StarInterface, StarsType } from './stars';
+/**
+ * Type alias representing a collection of celestial bodies.
+ *
+ * Includes:
+ * - **Stars** (`StarsType`)
+ * - **Planets** (`PlanetsType`)
+ * - **Moons** (`MoonsType`)
+ * - **Comets** (`CometsType`)
+ *
+ * @typedef {StarsType | PlanetsType | MoonsType | CometsType | AsteroidsType} CelestialBodiesType
+ *
+ * @example
+ * ```ts
+ * const celestialObjects: CelestialBodiesType = [
+ *   { name: 'Sun', type: 'star', mass: 1.989e30 },
+ *   { name: 'Earth', type: 'planet', mass: 5.972e24 }
+ * ];
+ * ```
+ * @category Celestial Bodies
+ */
+export type CelestialBodiesType = StarsType | PlanetsType | MoonsType | CometsType | AsteroidsType;
+/**
+ * Type alias representing a single celestial body.
+ *
+ * Includes:
+ * - **Stars** (`StarInterface`)
+ * - **Planets** (`PlanetInterface`)
+ * - **Moons** (`MoonInterface`)
+ * - **Comets** (`CometInterface`)
+ *
+ * @typedef {StarInterface | PlanetInterface | MoonInterface | CometInterface | AsteroidInterface} CelestialBodyType
+ *
+ * @example
+ * ```ts
+ * const earth: CelestialBodyType = { name: 'Earth', type: 'planet', mass: 5.972e24 };
+ * ```
+ * @category Celestial Bodies
+ */
+export type CelestialBodyType = StarInterface | PlanetInterface | MoonInterface | CometInterface | AsteroidInterface;
+//# sourceMappingURL=celestial-bodies.d.ts.map

package/dist/celestial-bodies/celestial-bodies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"celestial-bodies.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/celestial-bodies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,aAAa,CAAC;AAElB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,eAAe,GACf,aAAa,GACb,cAAc,GACd,iBAAiB,CAAC"}

package/dist/celestial-bodies/celestial-bodies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=celestial-bodies.js.map

package/dist/celestial-bodies/celestial-bodies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celestial-bodies.js","sourceRoot":"","sources":["../../src/celestial-bodies/celestial-bodies.ts"],"names":[],"mappings":""}

package/dist/celestial-bodies/comets.d.ts

@@ -0,0 +1,94 @@
+import { DistanceInterface, MeasureInterface } from '../distance';
+import { Radians } from '../numeric';
+import { TemporalInterface } from '../temporal';
+import { CartesianCoordinatesInterface } from './planets';
+/**
+ * Represents a **comet** in the solar system simulation.
+ *
+ * **Cometary Orbital Parameters:**
+ * - **Semi-major axis (`a`)**: Defines the **size** of the comet’s orbit in **Astronomical Units (AU)**.
+ * - **Orbital eccentricity (`e`)**: Determines how **elliptical** the orbit is ($0 = $ circular, closer to $1$ = highly elliptical).
+ * - **Inclination (`i`)**: The tilt of the orbit relative to the **ecliptic plane**, measured in **degrees**.
+ * - **Argument of perihelion (`w`)**: The angle from the **ascending node** to the **perihelion**.
+ * - **Longitude of the ascending node (`om`)**: Defines where the orbit crosses the ecliptic.
+ * - **Perihelion distance (`q`)**: The closest approach to the Sun in **AU**.
+ *
+ * **Visualization Parameters:**
+ * - **Orbit Path (`orbitPath`)**: Precomputed trajectory for rendering.
+ * - **Color (`color`)**: Used for visual representation.
+ * - **Size (`size`)**: Scaled size for display (not the actual physical size).
+ *
+ * @category Celestial Bodies
+ */
+export interface CometInterface {
+    /** Name of the comet (e.g., "Halley", "Hale-Bopp"). */
+    name: string;
+    /** Type of comet based on its orbital characteristics. */
+    type: 'periodic comet' | 'oort cloud comet' | 'short-period comet';
+    /** Category classification of the comet. */
+    category: 'halley-type comet' | 'long-period comet' | 'jupiter-family comet';
+    /** The star system where the comet is located. */
+    system: string;
+    /** Semi-major axis of the orbit in AU. */
+    a: MeasureInterface;
+    /** Orbital eccentricity (0 = circular, closer to 1 = highly elliptical). */
+    e: number;
+    /** Orbital inclination in degrees. */
+    i: number;
+    /** Argument of perihelion in degrees. */
+    w: number;
+    /** Longitude of the ascending node in degrees. */
+    om: number;
+    /** Mean anomaly at epoch in radians. */
+    angle: Radians;
+    /** Orbital period in Earth days. Negative values indicate counter clockwise orbit */
+    period: TemporalInterface;
+    /** Perihelion distance in AU. */
+    q: number;
+    /** X-coordinate in a distance-based system (optional). */
+    x?: DistanceInterface;
+    /** Y-coordinate in a distance-based system (optional). */
+    y?: DistanceInterface;
+    /** Z-coordinate in a distance-based system (optional). */
+    z?: DistanceInterface;
+    /** Semi-minor axis converted to pixels (calculated from `a` and `e`). */
+    miA?: number;
+    /** X-offset for the ellipse focus (accounts for eccentricity). */
+    focus_x?: number;
+    /** Radius of the comet (for visualization purposes). */
+    radius: DistanceInterface;
+    /** Precomputed orbital path points for visualization (optional). */
+    orbitPath?: CartesianCoordinatesInterface[];
+    /** Visual representation color. */
+    color: string;
+    /** Scaled size for visualization (not actual physical size). */
+    size: number;
+}
+/**
+ * Type alias for an array of **comets**.
+ *
+ * @typedef {CometInterface[]} CometsType
+ * @example
+ * ```ts
+ * const halley: CometInterface = {
+ *   name: 'Halley',
+ *   type: 'periodic comet',
+ *   category: 'halley-type comet',
+ *   system: 'Sun,
+ *   a: { value: 17.8, unit: 'au' },
+ *   e: 0.967,
+ *   i: 162.26,
+ *   w: 111.33,
+ *   om: 58.42,
+ *   angle: 0,
+ *   period: { value: 76, unit: 'years' },
+ *   q: 0.586,
+ *   radius: { value: 11, unit: 'km' },
+ *   color: '#ffffff',
+ *   size: 1.2
+ * };
+ * ```
+ * @category Celestial Bodies
+ */
+export type CometsType = CometInterface[];
+//# sourceMappingURL=comets.d.ts.map

package/dist/celestial-bodies/comets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comets.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/comets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;IACnE,4CAA4C;IAC5C,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;IAC7E,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,CAAC,EAAE,gBAAgB,CAAC;IACpB,4EAA4E;IAC5E,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;IACV,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iCAAiC;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;IAC5C,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC"}

package/dist/celestial-bodies/comets.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=comets.js.map

package/dist/celestial-bodies/comets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comets.js","sourceRoot":"","sources":["../../src/celestial-bodies/comets.ts"],"names":[],"mappings":""}

package/dist/celestial-bodies/galaxies.d.ts

@@ -0,0 +1,82 @@
+import { DistanceInterface } from '../distance';
+/**
+ * Represents a **black hole** at the center of a galaxy.
+ *
+ * **Black Hole Properties:**
+ * - **Mass (`mass`)**: Measured in **solar masses** ($M_\odot$).
+ * - **Schwarzschild radius (`radius`)**: Defined in **Astronomical Units (AU)**.
+ * - **Position (`x`, `y`)**: Coordinates relative to the galaxy center in **AU**.
+ *
+ * @example
+ * ```ts
+ * const sagittariusA: BlackHoleInterface = {
+ *   name: 'Sagittarius A*',
+ *   mass: 4.154e6,
+ *   radius: { value: 0.08, unit: 'au' },
+ *   x: { value: 0, unit: 'au' },
+ *   y: { value: 0, unit: 'au' }
+ * };
+ * ```
+ * @category Celestial Bodies
+ */
+export interface BlackHoleInterface {
+    /** Name of the central black hole. */
+    name: string;
+    /** Mass of the black hole in solar masses. */
+    mass: number;
+    /** Schwarzschild radius of the black hole in AU. */
+    radius: DistanceInterface;
+    /** X-coordinate relative to the galaxy center in AU. */
+    x: DistanceInterface;
+    /** Y-coordinate relative to the galaxy center in AU. */
+    y: DistanceInterface;
+}
+/**
+ * Represents a **galaxy** in the universe simulation.
+ *
+ * **Galaxy Properties:**
+ * - **Name (`name`)**: The galaxy's official designation.
+ * - **Type (`type`)**: The morphological classification (e.g., Spiral, Elliptical).
+ * - **Diameter (`diameter`)**: Measured in **light-years**.
+ * - **Distance (`distance`)**: The distance from the **Milky Way**, also in **light-years**.
+ * - **Black Hole (`blackHole`)**: The central supermassive black hole.
+ *
+ * @example
+ * ```ts
+ * const milkyWay: GalaxyInterface = {
+ *   name: 'Milky Way',
+ *   type: 'Spiral',
+ *   diameter: { value: 105700, unit: 'lightyears' },
+ *   distance: { value: 0, unit: 'lightyears' },
+ *   blackHole: sagittariusA
+ * };
+ * ```
+ * @category Celestial Bodies
+ */
+export interface GalaxyInterface {
+    /** Name of the galaxy. */
+    name: string;
+    /** Morphological classification of the galaxy. */
+    type: string;
+    /** Diameter of the galaxy in light-years. */
+    diameter: DistanceInterface;
+    /** Distance from the Milky Way in light-years. */
+    distance: DistanceInterface;
+    /** Central black hole of the galaxy. */
+    blackHole: BlackHoleInterface;
+}
+/**
+ * Type alias for a collection of **galaxies**.
+ *
+ * @typedef {GalaxyInterface[]} GalaxiesType
+ * @category Celestial Bodies
+ */
+export type GalaxiesType = GalaxyInterface[];
+/**
+ * Type alias for a collection of **black holes**.
+ *
+ * @typedef {BlackHoleInterface[]} BlackHolesType
+ * @category Celestial Bodies
+ */
+export type BlackHolesType = BlackHoleInterface[];
+//# sourceMappingURL=galaxies.d.ts.map

package/dist/celestial-bodies/galaxies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galaxies.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/galaxies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,wDAAwD;IACxD,CAAC,EAAE,iBAAiB,CAAC;IACrB,wDAAwD;IACxD,CAAC,EAAE,iBAAiB,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,wCAAwC;IACxC,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/celestial-bodies/galaxies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=galaxies.js.map

package/dist/celestial-bodies/galaxies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"galaxies.js","sourceRoot":"","sources":["../../src/celestial-bodies/galaxies.ts"],"names":[],"mappings":""}

package/dist/celestial-bodies/index.d.ts

@@ -0,0 +1,10 @@
+export * from './celestial-bodies';
+export * from './asteroids';
+export * from './comets';
+export * from './galaxies';
+export * from './moons';
+export * from './planets';
+export * from './stars';
+export * from './systems';
+export * from './asteroid-belts';
+//# sourceMappingURL=index.d.ts.map

package/dist/celestial-bodies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AAEnC,cAAc,aAAa,CAAC;AAE5B,cAAc,UAAU,CAAC;AAEzB,cAAc,YAAY,CAAC;AAE3B,cAAc,SAAS,CAAC;AAExB,cAAc,WAAW,CAAC;AAE1B,cAAc,SAAS,CAAC;AAExB,cAAc,WAAW,CAAC;AAE1B,cAAc,kBAAkB,CAAC"}

package/dist/celestial-bodies/index.js

@@ -0,0 +1,10 @@
+export * from './celestial-bodies';
+export * from './asteroids';
+export * from './comets';
+export * from './galaxies';
+export * from './moons';
+export * from './planets';
+export * from './stars';
+export * from './systems';
+export * from './asteroid-belts';
+//# sourceMappingURL=index.js.map

package/dist/celestial-bodies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AAEnC,cAAc,aAAa,CAAC;AAE5B,cAAc,UAAU,CAAC;AAEzB,cAAc,YAAY,CAAC;AAE3B,cAAc,SAAS,CAAC;AAExB,cAAc,WAAW,CAAC;AAE1B,cAAc,SAAS,CAAC;AAExB,cAAc,WAAW,CAAC;AAE1B,cAAc,kBAAkB,CAAC"}

package/dist/celestial-bodies/moons.d.ts

@@ -0,0 +1,75 @@
+import { DistanceInterface, MeasureInterface } from '../distance';
+import { Radians } from '../numeric';
+import { TemporalInterface } from '../temporal';
+import { CartesianCoordinatesInterface } from './planets';
+/**
+ * Represents a **moon** (natural satellite) orbiting a planet.
+ *
+ * **Orbital Properties:**
+ * - **Semi-major axis (`a`)**: Defines the moon’s orbit size in **Astronomical Units (AU)**.
+ * - **Orbital eccentricity (`e`)**: Determines how elliptical the orbit is ($0 =$ circular, closer to $1 =$ highly elliptical).
+ * - **Orbital period (`period`)**: Time taken for one full orbit in **Earth days**. Negative values indicate counter clockwise direction.
+ * - **True anomaly (`angle`)**: The moon’s current position in its orbit (in **radians**).
+ *
+ * **Visualization Properties:**
+ * - **Orbit Path (`orbitPath`)**: Precomputed trajectory for rendering.
+ * - **Color (`color`)**: Visual representation.
+ * - **Size (`radius`)**: Actual moon radius in **kilometers (km)**.
+ *
+ * @example
+ * ```ts
+ * const europa: MoonInterface = {
+ *   name: 'Europa',
+ *   category: 'natural satellite',
+ *   system: 'Jupiter',
+ *   a: { value: 0.00448, unit: 'au' },
+ *   e: 0.009,
+ *   period: { value: 3.55, unit: 'd' },
+ *   radius: { value: 1560.8, unit: 'km' },
+ *   color: '#a6a6a6',
+ *   angle: 0,
+ * };
+ * ```
+ * @category Celestial Bodies
+ */
+export interface MoonInterface {
+    /** Name of the moon (e.g., "Io", "Europa", "Titan"). */
+    name: string;
+    type?: undefined;
+    /** Classification of the moon. */
+    category: 'natural satellite' | 'irregular satellite' | 'retrograde satellite';
+    /** The planetary system where the moon is located (e.g., "Jupiter"). */
+    system: string;
+    /** Semi-major axis of the orbit in AU. */
+    a: MeasureInterface;
+    /** Orbital eccentricity (0 = circular, closer to 1 = highly elliptical). */
+    e: number;
+    /** Semi-minor axis converted to pixels (calculated from `a` and `e`). */
+    miA?: number;
+    /** X-offset for the ellipse focus (accounts for eccentricity). */
+    focus_x?: number;
+    /** Orbital period in Earth days. Negative values indicate counter clockwise orbit */
+    period: TemporalInterface;
+    /** Physical radius of the moon in kilometres. */
+    radius: DistanceInterface;
+    /** Visual representation color. */
+    color: string;
+    /** Current orbital position in radians (True Anomaly). */
+    angle: Radians;
+    /** X-coordinate in a distance-based system (optional). */
+    x?: DistanceInterface;
+    /** Y-coordinate in a distance-based system (optional). */
+    y?: DistanceInterface;
+    /** Z-coordinate in a distance-based system (optional). */
+    z?: DistanceInterface;
+    /** Precomputed orbital path points for visualization (optional). */
+    orbitPath?: CartesianCoordinatesInterface[];
+}
+/**
+ * Type alias for a collection of **moons**.
+ *
+ * @typedef {MoonInterface[]} MoonsType
+ * @category Celestial Bodies
+ */
+export type MoonsType = MoonInterface[];
+//# sourceMappingURL=moons.d.ts.map

package/dist/celestial-bodies/moons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moons.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/moons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EACJ,mBAAmB,GACnB,qBAAqB,GACrB,sBAAsB,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,CAAC,EAAE,gBAAgB,CAAC;IACpB,4EAA4E;IAC5E,CAAC,EAAE,MAAM,CAAC;IACV,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC"}

package/dist/celestial-bodies/moons.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=moons.js.map

package/dist/celestial-bodies/moons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moons.js","sourceRoot":"","sources":["../../src/celestial-bodies/moons.ts"],"names":[],"mappings":""}