@interstellar-tools/types 0.61.2 → 0.63.0

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

@@ -1,12 +1,11 @@
-import { CartesianCoordinatesInterface } from './planets.js';
+import type { DisplayInterface } from './display.js';
 /**
  * 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.
+ * - **Drawing (`display`)**: colour, opacity, and density (how many asteroids to draw); see
+ *   {@link DisplayInterface}.
  *
  * @group Celestial Bodies
  */
@@ -21,14 +20,8 @@ export interface AsteroidBeltInterface {
     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[];
+    /** How to draw the belt: colour, opacity and density, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Type alias for a collection of asteroid belts.
@@ -42,9 +35,7 @@ export interface AsteroidBeltInterface {
  *   parent: 'sun',
  *   innerRadius: 2.1,
  *   outerRadius: 3.3,
- *   color: '#888888',
- *   opacity: 0.5,
- *   density: 100,
+ *   display: { color: '#888888', opacity: 0.5, density: 100 }
  * }];
  * ```
  * @group Celestial Bodies

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

@@ -1 +1 @@
-{"version":3,"file":"asteroid-belts.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroid-belts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"asteroid-belts.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroid-belts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC"}

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

@@ -1,6 +1,6 @@
 import { DistanceInterface } from '../distance.js';
-import type { OrbitInterface } from '../orbits.js';
-import { CartesianCoordinatesInterface } from './planets.js';
+import type { FullOrbitInterface } from '../orbits.js';
+import type { DisplayInterface } from './display.js';
 /**
  * High-level **orbital class** of an asteroid (by dynamical region).
  *
@@ -70,9 +70,8 @@ export type AsteroidSpectralType = 'c-type' | 's-type' | 'v-type' | 'm-type' | '
  * q \;=\; a\,(1 - e)
  * $$
  *
- * **Period convention:** `period` is a duration (e.g., in **days**).
- * If you encode direction, a **negative value** indicates **counter-clockwise** in your display
- * convention (visualization-specific; not a physical requirement).
+ * **Period convention:** `period` is a positive duration (e.g., in **days**).
+ * A retrograde orbit (`i > 90°`) has `retrograde: true`.
  *
  * **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.
@@ -95,7 +94,7 @@ export interface AsteroidInterface {
     /** Id of the star the asteroid orbits (e.g., `'sun'`). */
     parent: string;
     /** Orbit around the parent, with all elements including `i`, `w`, `om` and `q`. */
-    orbit: Required<OrbitInterface>;
+    orbit: FullOrbitInterface;
     /**
      * Optional **Cartesian coordinates** (distance values) in a specified frame.
      * ::: info
@@ -109,41 +108,10 @@ export interface AsteroidInterface {
     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;
+    /** How to draw the asteroid: its colour and drawn size, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Convenience alias for a list of asteroids.

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

@@ -1 +1 @@
-{"version":3,"file":"asteroids.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;;;;;;;;;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,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IAEX,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,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IAEf,mFAAmF;IACnF,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAEhC;;;;;;;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"}
+{"version":3,"file":"asteroids.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/asteroids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IAEX,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,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IAEf,mFAAmF;IACnF,KAAK,EAAE,kBAAkB,CAAC;IAE1B;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,qBAAqB;IACrB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,qBAAqB;IACrB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAEtB,4EAA4E;IAC5E,MAAM,EAAE,iBAAiB,CAAC;IAE1B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC"}

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

@@ -1,6 +1,6 @@
 import { DistanceInterface } from '../distance.js';
-import type { OrbitInterface } from '../orbits.js';
-import { CartesianCoordinatesInterface } from './planets.js';
+import type { FullOrbitInterface } from '../orbits.js';
+import type { DisplayInterface } from './display.js';
 /**
  * Represents a **comet** in the solar system simulation.
  *
@@ -10,13 +10,12 @@ import { CartesianCoordinatesInterface } from './planets.js';
  * - **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**.
+ * - **Perihelion distance (`q`)**: The closest approach to the Sun, as a distance.
+ * - **Direction (`retrograde`)**: `true` when `i > 90°`, like Halley's comet.
  * - **Angle (`angle`)**: The **true anomaly** at J2000, as for every other body.
  *
- * **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).
+ * **Drawing (`display`)**: colour and a scaled drawing size (not the physical
+ * `radius`), and state a renderer computes; see {@link DisplayInterface}.
  *
  * @group Celestial Bodies
  */
@@ -32,25 +31,17 @@ export interface CometInterface {
     /** Id of the star the comet orbits (e.g., `'sun'`). */
     parent: string;
     /** Orbit around the parent, with all elements including `i`, `w`, `om` and `q`. */
-    orbit: Required<OrbitInterface>;
+    orbit: FullOrbitInterface;
     /** 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;
+    /** How to draw the comet: its colour and drawn size, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Type alias for an array of **comets**.
@@ -67,16 +58,16 @@ export interface CometInterface {
  *   orbit: {
  *     a: { value: 17.834, unit: 'au' },
  *     e: 0.96714,
- *     i: 162.26,
- *     w: 111.33,
- *     om: 58.42,
- *     angle: 0.669857 as Radians,
+ *     i: 162.26 as DegreesType,
+ *     w: 111.33 as DegreesType,
+ *     om: 58.42 as DegreesType,
+ *     angle: 2.97966 as Radians,
  *     period: { value: 27576, unit: 'd' },
- *     q: 0.586
+ *     retrograde: true,
+ *     q: { value: 0.586, unit: 'au' }
  *   },
  *   radius: { value: 11, unit: 'km' },
- *   color: '#ffffff',
- *   size: 1.2
+ *   display: { color: '#ffffff', size: 1.2 }
  * }];
  * ```
  * @group Celestial Bodies

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

@@ -1 +1 @@
-{"version":3,"file":"comets.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/comets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,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,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC"}
+{"version":3,"file":"comets.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/comets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,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,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,KAAK,EAAE,kBAAkB,CAAC;IAC1B,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uFAAuF;IACvF,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Represents **2D coordinates**, for example a point on a drawn orbit.
+ *
+ * @property {number} x - The x-coordinate.
+ * @property {number} y - The y-coordinate.
+ *
+ * @example
+ * ```ts
+ * const position: CartesianCoordinatesInterface = { x: 100, y: 200 };
+ * ```
+ * @group Celestial Bodies
+ */
+export interface CartesianCoordinatesInterface {
+    x: number;
+    y: number;
+}
+/**
+ * How a body is **drawn**: everything about rendering, kept apart from its
+ * physical data and its `orbit`.
+ *
+ * It holds two kinds of values:
+ *
+ * - **Hints from the datasets**: `color` on every body, `size` on comets and
+ *   asteroids, `opacity` and `density` on asteroid belts.
+ * - **State a renderer computes** and keeps on the body, so it doesn't have to
+ *   recompute it every frame: `semiMinorAxis`, `focusOffsetX` and
+ *   `orbitPath`. The datasets never set these.
+ *
+ * The computed distances are in whatever unit the renderer uses for
+ * `orbit.a` (for example au), measured in the orbit's plane with the parent
+ * body at the origin and periapsis along +x.
+ *
+ * @example
+ * ```ts
+ * // Drawing an orbit: compute once, keep it on the body
+ * const a = convertDistance(body.orbit.a, 'au').value;
+ * const { e } = body.orbit;
+ *
+ * body.display = {
+ *   ...body.display,
+ *   semiMinorAxis: a * Math.sqrt(1 - e ** 2),
+ *   focusOffsetX: a * e
+ * };
+ * ```
+ * @group Celestial Bodies
+ */
+export interface DisplayInterface {
+    /** Colour to draw the body in, as a hex string (`#rrggbb`) or a CSS colour name. */
+    color?: string;
+    /** Scaled size for drawing, not the physical size (see `radius`). */
+    size?: number;
+    /** Transparency, from 0 (invisible) to 1 (solid). */
+    opacity?: number;
+    /** How densely to fill an area, e.g. how many asteroids to draw in a belt. */
+    density?: number;
+    /** Semi-minor axis of the orbit, $b = a\sqrt{1 - e^2}$, computed by a renderer. */
+    semiMinorAxis?: number;
+    /** Distance from the ellipse's centre to its focus, $c = a e$, computed by a renderer. */
+    focusOffsetX?: number;
+    /** Points along the drawn orbit, computed by a renderer. */
+    orbitPath?: CartesianCoordinatesInterface[];
+}
+//# sourceMappingURL=display.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,6BAA6B;IAC5C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;CAC7C"}

package/dist/celestial-bodies/display.js

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

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

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

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

@@ -1,6 +1,7 @@
 export * from './celestial-bodies.js';
 export * from './asteroids.js';
 export * from './comets.js';
+export * from './display.js';
 export * from './galaxies.js';
 export * from './moons.js';
 export * from './planets.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,aAAa,CAAC;AAE5B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC;AAE7B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,qBAAqB,CAAC"}

package/dist/celestial-bodies/index.js

@@ -1,6 +1,7 @@
 export * from './celestial-bodies.js';
 export * from './asteroids.js';
 export * from './comets.js';
+export * from './display.js';
 export * from './galaxies.js';
 export * from './moons.js';
 export * from './planets.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,aAAa,CAAC;AAE5B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/celestial-bodies/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC;AAE7B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAE7B,cAAc,qBAAqB,CAAC"}

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

@@ -1,16 +1,15 @@
 import { DistanceInterface } from '../distance.js';
 import type { OrbitInterface } from '../orbits.js';
-import { CartesianCoordinatesInterface } from './planets.js';
+import type { DisplayInterface } from './display.js';
 /**
  * Represents a **moon** (natural satellite) orbiting a planet.
  *
  * A moon always has a `parent` (its planet) and an `orbit` around it; see
  * {@link OrbitInterface}.
  *
- * **Visualization Properties:**
- * - **Orbit Path (`orbitPath`)**: Precomputed trajectory for rendering.
- * - **Color (`color`)**: Visual representation.
+ * **Physical and drawing properties:**
  * - **Size (`radius`)**: Actual moon radius in **kilometers (km)**.
+ * - **Drawing (`display`)**: colour, and state a renderer computes; see {@link DisplayInterface}.
  *
  * @example
  * ```ts
@@ -22,11 +21,11 @@ import { CartesianCoordinatesInterface } from './planets.js';
  *   orbit: {
  *     a: { value: 0.00448, unit: 'au' },
  *     e: 0.009,
- *     period: { value: -3.551, unit: 'd' },
+ *     period: { value: 3.551, unit: 'd' },
  *     angle: 0 as Radians
  *   },
  *   radius: { value: 1560.8, unit: 'km' },
- *   color: '#a6a6a6'
+ *   display: { color: '#a6a6a6' }
  * };
  * ```
  * @group Celestial Bodies
@@ -43,22 +42,16 @@ export interface MoonInterface {
     parent: string;
     /** Orbit around the parent planet. */
     orbit: OrbitInterface;
-    /** 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;
     /** Physical radius of the moon in kilometres. */
     radius: DistanceInterface;
-    /** Visual representation color. */
-    color: string;
     /** 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[];
+    /** How to draw the moon: its colour, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Type alias for a collection of **moons**.

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

@@ -1 +1 @@
-{"version":3,"file":"moons.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/moons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EACN,mBAAmB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;IACvE,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,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"}
+{"version":3,"file":"moons.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/moons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EACN,mBAAmB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;IACvE,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC"}

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

@@ -1,21 +1,6 @@
 import { DistanceInterface } from '../distance.js';
 import type { OrbitInterface } from '../orbits.js';
-/**
- * Represents **2D coordinates** for planetary positioning.
- *
- * @property {number} x - The x-coordinate.
- * @property {number} y - The y-coordinate.
- *
- * @example
- * ```ts
- * const position: CartesianCoordinatesInterface = { x: 100, y: 200 };
- * ```
- * @group Celestial Bodies
- */
-export interface CartesianCoordinatesInterface {
-    x: number;
-    y: number;
-}
+import type { DisplayInterface } from './display.js';
 /**
  * Represents a **planet** or **planetoid**.
  *
@@ -26,7 +11,7 @@ export interface CartesianCoordinatesInterface {
  * **Classification & Visualization:**
  * - **Type (`type`)**: Scientific classification of the planet (e.g., **terrestrial, gas giant, ice planet**).
  * - **Category (`category`)**: Defines whether the object is a **planet** or a **planetoid**.
- * - **Color (`color`)**: Used for visual representation in simulations.
+ * - **Drawing (`display`)**: colour, and state a renderer computes; see {@link DisplayInterface}.
  * - **Size (`radius`)**: Physical planet radius in **kilometers (km)**.
  *
  * @example
@@ -36,15 +21,15 @@ export interface CartesianCoordinatesInterface {
  *   name: 'Earth',
  *   type: 'terrestrial planet',
  *   category: 'planet',
- *   color: '#4287f5',
  *   parent: 'sun',
  *   orbit: {
  *     a: { value: 1.0, unit: 'au' },
  *     e: 0.0167,
- *     period: { value: -365.256, unit: 'd' },
+ *     period: { value: 365.256, unit: 'd' },
  *     angle: 1.753 as Radians
  *   },
  *   radius: { value: 6371, unit: 'km' },
+ *   display: { color: '#4287f5' },
  *   x: { value: 0, unit: 'au' },
  *   y: { value: 1, unit: 'au' },
  *   z: { value: 0, unit: 'au' }
@@ -61,26 +46,20 @@ export interface PlanetInterface {
     type: 'chthonian planet' | 'carbon planet' | 'coreless planet' | 'desert planet' | 'gas dwarf' | 'gas giant' | 'helium planet' | 'hycean planet' | 'ice giant' | 'ice planet' | 'iron planet' | 'lava planet' | 'ocean planet' | 'proto planet' | 'puffy planet' | 'super-puff' | 'silicate planet' | 'terrestrial planet';
     /** Defines whether the object is a planet or a planetoid. */
     category: 'planet' | 'planetoid';
-    /** Visual representation color. */
-    color: string;
     /** Id of the star, system or galaxy the planet is bound to. */
     parent?: string;
     /** Orbit around the parent. */
     orbit?: OrbitInterface;
     /** Physical radius of the planet in kilometres. */
     radius: DistanceInterface;
-    /** Semi-minor axis of the orbit (calculated from `a` and `e`). */
-    miA?: number;
-    /** X-offset for the ellipse focus (accounts for eccentricity). */
-    focus_x?: number;
-    /** X-coordinate in the parent's frame. */
-    x: DistanceInterface;
+    /** X-coordinate in the parent's frame. Optional: a rogue planet or an exoplanet may have no known position. */
+    x?: DistanceInterface;
     /** Y-coordinate in the parent's frame. */
-    y: DistanceInterface;
+    y?: DistanceInterface;
     /** Z-coordinate in the parent's frame. */
-    z: DistanceInterface;
-    /** Precomputed orbital path points for visualization (optional). */
-    orbitPath?: CartesianCoordinatesInterface[];
+    z?: DistanceInterface;
+    /** How to draw the planet: its colour, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Type alias for a collection of **planets**.

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

@@ -1 +1 @@
-{"version":3,"file":"planets.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/planets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,6BAA6B;IAC5C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EACA,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,WAAW,GACX,YAAY,GACZ,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,oBAAoB,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC"}
+{"version":3,"file":"planets.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/planets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EACA,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,WAAW,GACX,YAAY,GACZ,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,oBAAoB,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,+GAA+G;IAC/G,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,yEAAyE;IACzE,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC"}

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

@@ -1,6 +1,6 @@
 import { DistanceInterface } from '../distance.js';
 import type { OrbitInterface } from '../orbits.js';
-import { CartesianCoordinatesInterface } from './planets.js';
+import type { DisplayInterface } from './display.js';
 /**
  * Represents a **star**.
  *
@@ -12,7 +12,7 @@ import { CartesianCoordinatesInterface } from './planets.js';
  * **Classification & Visualization:**
  * - **Type (`type`)**: Spectral classification of the star (e.g., `'G2V'`).
  * - **Category (`category`)**: Defined as `'star'`.
- * - **Color (`color`)**: Used for visual representation.
+ * - **Drawing (`display`)**: colour, and state a renderer computes; see {@link DisplayInterface}.
  *
  * @example
  * ```ts
@@ -25,11 +25,11 @@ import { CartesianCoordinatesInterface } from './planets.js';
  *   orbit: {
  *     a: { value: 27230, unit: 'ly' },
  *     e: 0.005,
- *     period: { value: -480, unit: 'Myr' },
+ *     period: { value: 480, unit: 'Myr' },
  *     angle: 1.5699 as Radians
  *   },
  *   radius: { value: 2600000, unit: 'km' },
- *   color: 'blue'
+ *   display: { color: 'blue' }
  * };
  * ```
  * @group Celestial Bodies
@@ -51,20 +51,14 @@ export interface StarInterface {
     mass?: number;
     /** Physical radius of the star. */
     radius: DistanceInterface;
-    /** Visual representation color. */
-    color: string;
-    /** Semi-minor axis of the orbit (calculated from `a` and `e`). */
-    miA?: number;
-    /** X-offset for the ellipse focus (accounts for eccentricity). */
-    focus_x?: number;
     /** X-coordinate in the parent's frame. */
     x?: DistanceInterface;
     /** Y-coordinate in the parent's frame. */
     y?: DistanceInterface;
     /** Z-coordinate in the parent's frame. */
     z?: DistanceInterface;
-    /** Precomputed orbital path points for visualization (optional). */
-    orbitPath?: CartesianCoordinatesInterface[];
+    /** How to draw the star: its colour, and state a renderer computes. */
+    display?: DisplayInterface;
 }
 /**
  * Type alias for a collection of **stars**.

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

@@ -1 +1 @@
-{"version":3,"file":"stars.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/stars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,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"}
+{"version":3,"file":"stars.d.ts","sourceRoot":"","sources":["../../src/celestial-bodies/stars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,0CAA0C;IAC1C,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC"}

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

@@ -34,7 +34,7 @@ export type SystemKindType = 'planetary' | 'binary' | 'multiple' | 'cluster';
  *   orbit: {
  *     a: { value: 503, unit: 'au' },
  *     e: 0.5,
- *     period: { value: -547, unit: 'kyr' },
+ *     period: { value: 547, unit: 'kyr' },
  *     angle: Math.PI as Radians
  *   }
  * };

package/dist/distance.d.ts

@@ -58,17 +58,19 @@ export type DistanceUnitType = 'm' | 'km' | 'au' | 'ly' | 'kly' | 'Mly' | 'Gly'
  *
  * ### Typical flow
  * 1) Accept `DistanceUnitAliasType | DistanceUnitType` at your API boundary.
- * 2) Normalize to `DistanceUnitType` (e.g., via `normalizeDistanceUnit`).
+ * 2) Normalize to `DistanceUnitType` with `normalizeDistanceUnit` from
+ *    `@interstellar-tools/equations`, or convert directly with `convertDistanceUnit`.
  * 3) Perform calculations using canonical units only.
  *
  * @example
  * ```ts
- * // Assuming `normalizeDistanceUnit` and `NORMALIZE_DISTANCE_UNIT` are defined:
- * normalizeDistanceUnit('AU');           // 'au'
- * normalizeDistanceUnit('lightyears');   // 'ly'
+ * import { normalizeDistanceUnit } from '@interstellar-tools/equations';
+ *
+ * normalizeDistanceUnit('AU'); // 'au'
+ * normalizeDistanceUnit('lightyears'); // 'ly'
  * normalizeDistanceUnit('kilolightyears'); // 'kly'
- * normalizeDistanceUnit('parsecs');      // 'pc'
- * normalizeDistanceUnit('Mpc');          // 'Mpc' (already canonical)
+ * normalizeDistanceUnit('parsecs'); // 'pc'
+ * normalizeDistanceUnit('Mpc'); // 'Mpc' (already canonical)
  * ```
  *
  * @see DistanceUnitType for the canonical symbol set.
@@ -81,6 +83,8 @@ export type DistanceUnitAliasType = 'meter' | 'meters' | 'metre' | 'metres' | 'k
 /**
  * Represents a measurement with an associated unit.
  *
+ * @deprecated Use {@link DistanceInterface}, which is identical. `MeasureInterface` will be
+ * removed in 2.0.
  * @extends ValueInterface
  * @property {DistanceUnitType} unit - The unit of measurement.
  *
@@ -101,7 +105,7 @@ export interface MeasureInterface extends ValueInterface {
  *
  * @example
  * ```ts
- * const distanceToAlphaCentauri: DistanceInterface = { value: 4.367, unit: 'lightyears' };
+ * const distanceToAlphaCentauri: DistanceInterface = { value: 4.367, unit: 'ly' };
  * ```
  * @group Distance
  */

package/dist/distance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,gBAAgB,GACxB,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,qBAAqB,GAE7B,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GAER,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GAEZ,IAAI,GACJ,IAAI,GACJ,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GAEpB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,KAAK,GACL,eAAe,GACf,gBAAgB,GAChB,KAAK,GACL,eAAe,GACf,gBAAgB,GAChB,KAAK,GAEL,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,aAAa,GACb,KAAK,GACL,YAAY,GACZ,aAAa,GACb,KAAK,GACL,YAAY,GACZ,aAAa,GACb,KAAK,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,IAAI,EAAE,gBAAgB,CAAC;CACxB"}
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,gBAAgB,GACxB,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,qBAAqB,GAE7B,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GAER,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GAEZ,IAAI,GACJ,IAAI,GACJ,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GAEpB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,KAAK,GACL,eAAe,GACf,gBAAgB,GAChB,KAAK,GACL,eAAe,GACf,gBAAgB,GAChB,KAAK,GAEL,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,aAAa,GACb,KAAK,GACL,YAAY,GACZ,aAAa,GACb,KAAK,GACL,YAAY,GACZ,aAAa,GACb,KAAK,CAAC;AAEV;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,IAAI,EAAE,gBAAgB,CAAC;CACxB"}

package/dist/orbits.d.ts

@@ -1,5 +1,5 @@
-import type { MeasureInterface } from './distance.js';
-import type { Radians } from './numeric.js';
+import type { DistanceInterface } from './distance.js';
+import type { DegreesType, Radians } from './numeric.js';
 import type { TemporalInterface } from './temporal.js';
 /**
  * Clohessy–Wiltshire / Hill relative-motion **state vector** in the LVLH frame.
@@ -102,9 +102,11 @@ export type CwStateDerivative = readonly [
  *   B), each carries its own orbit. Both share `e`, `period` and `angle`, their
  *   periapses point in opposite directions, and their semi-major axes split by
  *   mass ratio: $a_1 = a \, m_2 / (m_1 + m_2)$, where $a$ is their separation.
- * - **Direction**: a negative `period` indicates a counter-clockwise orbit.
+ * - **Direction**: `period` is always a positive duration. A retrograde orbit,
+ *   moving against its parent's rotation, has `retrograde: true`; a renderer
+ *   can use `retrograde ? -1 : 1` as the direction of travel.
  * - `i`, `w`, `om` and `q` are only given where the dataset has them (comets and
- *   asteroids).
+ *   asteroids). Where `i` is given, `retrograde` is set exactly when `i > 90°`.
  *
  * :::
  *
@@ -113,7 +115,7 @@ export type CwStateDerivative = readonly [
  * const earthOrbit: OrbitInterface = {
  *   a: { value: 1.0, unit: 'au' },
  *   e: 0.0167,
- *   period: { value: -365.256, unit: 'd' },
+ *   period: { value: 365.256, unit: 'd' },
  *   angle: 1.753 as Radians
  * };
  * ```
@@ -121,20 +123,38 @@ export type CwStateDerivative = readonly [
  */
 export interface OrbitInterface {
     /** Semi-major axis of this body's orbit around the parent's centre of mass. */
-    a: MeasureInterface;
+    a: DistanceInterface;
     /** Orbital eccentricity (0 = circular, closer to 1 = highly elliptical). */
     e: number;
-    /** Orbital period. Negative values indicate counter clockwise direction. */
+    /** Orbital period, always positive. See `retrograde` for the direction. */
     period: TemporalInterface;
+    /** `true` for a retrograde orbit. Omitted for the usual prograde orbits. */
+    retrograde?: boolean;
     /** Current orbital position at J2000 in radians (true anomaly). */
     angle: Radians;
+    /** Orbital inclination in degrees, as catalogues give it. */
+    i?: DegreesType;
+    /** Argument of periapsis in degrees. */
+    w?: DegreesType;
+    /** Longitude of the ascending node in degrees. */
+    om?: DegreesType;
+    /** Periapsis distance $q = a(1 - e)$. */
+    q?: DistanceInterface;
+}
+/**
+ * An {@link OrbitInterface} with every orientation element given: `i`, `w`,
+ * `om` and `q`. Comets and asteroids carry these.
+ *
+ * @group Orbits
+ */
+export interface FullOrbitInterface extends OrbitInterface {
     /** Orbital inclination in degrees. */
-    i?: number;
+    i: DegreesType;
     /** Argument of periapsis in degrees. */
-    w?: number;
+    w: DegreesType;
     /** Longitude of the ascending node in degrees. */
-    om?: number;
-    /** Periapsis distance $q = a(1 - e)$ in the unit of `a`. */
-    q?: number;
+    om: DegreesType;
+    /** Periapsis distance $q = a(1 - e)$. */
+    q: DistanceInterface;
 }
 //# sourceMappingURL=orbits.d.ts.map

package/dist/orbits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orbits.d.ts","sourceRoot":"","sources":["../src/orbits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS;IAC7B,0CAA0C;IAC1C,CAAC,EAAE,MAAM;IACT,kDAAkD;IAClD,CAAC,EAAE,MAAM;IACT,oDAAoD;IACpD,CAAC,EAAE,MAAM;IACT,yDAAyD;IACzD,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS;IACvC,yDAAyD;IACzD,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM;IACb,qEAAqE;IACrE,KAAK,EAAE,MAAM;IACb,qEAAqE;IACrE,KAAK,EAAE,MAAM;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,CAAC,EAAE,gBAAgB,CAAC;IACpB,4EAA4E;IAC5E,CAAC,EAAE,MAAM,CAAC;IACV,4EAA4E;IAC5E,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ"}
+{"version":3,"file":"orbits.d.ts","sourceRoot":"","sources":["../src/orbits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS;IAC7B,0CAA0C;IAC1C,CAAC,EAAE,MAAM;IACT,kDAAkD;IAClD,CAAC,EAAE,MAAM;IACT,oDAAoD;IACpD,CAAC,EAAE,MAAM;IACT,yDAAyD;IACzD,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS;IACvC,yDAAyD;IACzD,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM;IACb,qEAAqE;IACrE,KAAK,EAAE,MAAM;IACb,qEAAqE;IACrE,KAAK,EAAE,MAAM;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,CAAC,EAAE,iBAAiB,CAAC;IACrB,4EAA4E;IAC5E,CAAC,EAAE,MAAM,CAAC;IACV,2EAA2E;IAC3E,MAAM,EAAE,iBAAiB,CAAC;IAC1B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,CAAC,CAAC,EAAE,WAAW,CAAC;IAChB,wCAAwC;IACxC,CAAC,CAAC,EAAE,WAAW,CAAC;IAChB,kDAAkD;IAClD,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,yCAAyC;IACzC,CAAC,CAAC,EAAE,iBAAiB,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,sCAAsC;IACtC,CAAC,EAAE,WAAW,CAAC;IACf,wCAAwC;IACxC,CAAC,EAAE,WAAW,CAAC;IACf,kDAAkD;IAClD,EAAE,EAAE,WAAW,CAAC;IAChB,yCAAyC;IACzC,CAAC,EAAE,iBAAiB,CAAC;CACtB"}

package/dist/temporal.d.ts

@@ -86,11 +86,11 @@ export interface TemporalInterface extends ValueInterface {
  * Represents a **time step measurement** in simulation, restricted to days.
  *
  * @extends ValueInterface
- * @property {'day'} unit - The unit is always **days**.
+ * @property {'d'} unit - The unit is always **days** (`'d'`).
  *
  * @example
  * ```ts
- * const timeStep: TimeStepInterface = { value: 1, unit: 'day' };
+ * const timeStep: TimeStepInterface = { value: 1, unit: 'd' };
  * ```
  * @group Temporal
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interstellar-tools/types",
-  "version": "0.61.2",
+  "version": "0.63.0",
   "description": "Shared TypeScript types (e.g., 3D tuples, equation result interfaces) used across the monorepo to keep APIs predictable and safe.",
   "keywords": [
     "types",