@interstellar-tools/types 0.62.0 → 0.63.0

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

@@ -1,5 +1,5 @@
 import { DistanceInterface } from '../distance.js';
-import type { OrbitInterface } from '../orbits.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

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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,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"}
+{"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,5 +1,5 @@
 import { DistanceInterface } from '../distance.js';
-import type { OrbitInterface } from '../orbits.js';
+import type { FullOrbitInterface } from '../orbits.js';
 import type { DisplayInterface } from './display.js';
 /**
  * Represents a **comet** in the solar system simulation.
@@ -10,7 +10,8 @@ import type { DisplayInterface } from './display.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.
  *
  * **Drawing (`display`)**: colour and a scaled drawing size (not the physical
@@ -30,7 +31,7 @@ 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). */
@@ -57,12 +58,13 @@ export interface CometInterface {
  *   orbit: {
  *     a: { value: 17.834, unit: 'au' },
  *     e: 0.96714,
- *     i: 162.26,
- *     w: 111.33,
- *     om: 58.42,
+ *     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' },
  *   display: { color: '#ffffff', size: 1.2 }

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,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;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,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uFAAuF;IACvF,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;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/moons.d.ts

@@ -21,7 +21,7 @@ import type { DisplayInterface } from './display.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' },

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

@@ -25,7 +25,7 @@ import type { DisplayInterface } from './display.js';
  *   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' },
@@ -52,12 +52,12 @@ export interface PlanetInterface {
     orbit?: OrbitInterface;
     /** Physical radius of the planet in kilometres. */
     radius: DistanceInterface;
-    /** 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;
+    z?: DistanceInterface;
     /** How to draw the planet: its colour, and state a renderer computes. */
     display?: DisplayInterface;
 }

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,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,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,0CAA0C;IAC1C,CAAC,EAAE,iBAAiB,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;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

@@ -25,7 +25,7 @@ import type { DisplayInterface } from './display.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' },

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.62.0",
+  "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",