@interstellar-tools/equations 0.63.1 → 0.64.0

package/dist/categories/helpers/convert-distance-unit.d.ts

@@ -0,0 +1,58 @@
+import type { DistanceInterface, DistanceUnitAliasType, DistanceUnitType } from '@interstellar-tools/types';
+/**
+ * Meters-per-unit lookup for all canonical {@link DistanceUnitType} symbols.
+ *
+ * - **Base**: conversions are performed via **meters**.
+ * - **Astronomical unit**: `au = 149 597 870 700 m`, exact (from {@link AU_METERS}).
+ * - **Light-year**: `c × Julian year` (from {@link METERS_PER_LY}); `kly/Mly/Gly`
+ *   are powers of 10 thereof.
+ * - **Parsec**: `(648 000 / π) au` (from {@link METERS_PER_PC}); `kpc/Mpc/Gpc`
+ *   are powers of 10 thereof.
+ * - The table is frozen: it can be read, but not changed at runtime.
+ *
+ * @group Helpers
+ * @example
+ * ```ts
+ * METERS_PER.km; // 1000
+ * METERS_PER.au; // 149_597_870_700
+ * ```
+ */
+export declare const METERS_PER: Readonly<Record<DistanceUnitType, number>>;
+/**
+ * Convert a **distance** between any two {@link DistanceUnitType} units.
+ *
+ * - Uses {@link METERS_PER} with **meters** as the intermediate unit.
+ * - The `distance.unit` is expected to be **canonical**, as in the datasets.
+ * - The `targetUnit` may be a canonical unit or an alias such as `'AU'`; it is
+ *   normalized to a canonical symbol.
+ *
+ * $$
+ * \text{value}_{\text{target}}
+ * \;=\;
+ * \frac{\text{value}_{\text{in}} \cdot \mathrm{METERS\_PER}[u_{\text{in}}]}
+ *      {\mathrm{METERS\_PER}[u_{\text{out}}]}
+ * $$
+ *
+ * @param distance   Input distance `{ value, unit }` in a canonical unit.
+ * @param targetUnit Desired output unit, canonical or an alias (will be normalized).
+ * @returns          A new `{ value, unit }` where `unit` is the canonical target symbol.
+ * @throws {RangeError} If `targetUnit` is not a known unit or alias.
+ * @group Helpers
+ *
+ * @example
+ * ```ts
+ * convertDistanceUnit({ value: 1, unit: 'au' }, 'km');
+ * // → { value: 149_597_870.7, unit: 'km' }
+ *
+ * convertDistanceUnit({ value: 1, unit: 'pc' }, 'ly');
+ * // → { value: 3.2615637771674333, unit: 'ly' }
+ *
+ * // Put a dataset's semi-major axis in the unit a renderer draws in:
+ * const jupiter = PLANETS.find((p) => p.id === 'jupiter');
+ * convertDistanceUnit(jupiter.orbit.a, 'au').value;
+ * ```
+ *
+ * @see normalizeDistanceUnit
+ */
+export declare const convertDistanceUnit: (distance: DistanceInterface, targetUnit: DistanceUnitType | DistanceUnitAliasType) => DistanceInterface;
+//# sourceMappingURL=convert-distance-unit.d.ts.map

package/dist/categories/helpers/convert-distance-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-distance-unit.d.ts","sourceRoot":"","sources":["../../../src/categories/helpers/convert-distance-unit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAInC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAa9D,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,iBAAiB,EAC3B,YAAY,gBAAgB,GAAG,qBAAqB,KACnD,iBAKF,CAAC"}

package/dist/categories/helpers/convert-distance-unit.js

@@ -0,0 +1,75 @@
+import { AU_METERS, METERS_PER_LY, METERS_PER_PC } from '@interstellar-tools/constants';
+import { normalizeDistanceUnit } from './normalize-distance-unit.js';
+/**
+ * Meters-per-unit lookup for all canonical {@link DistanceUnitType} symbols.
+ *
+ * - **Base**: conversions are performed via **meters**.
+ * - **Astronomical unit**: `au = 149 597 870 700 m`, exact (from {@link AU_METERS}).
+ * - **Light-year**: `c × Julian year` (from {@link METERS_PER_LY}); `kly/Mly/Gly`
+ *   are powers of 10 thereof.
+ * - **Parsec**: `(648 000 / π) au` (from {@link METERS_PER_PC}); `kpc/Mpc/Gpc`
+ *   are powers of 10 thereof.
+ * - The table is frozen: it can be read, but not changed at runtime.
+ *
+ * @group Helpers
+ * @example
+ * ```ts
+ * METERS_PER.km; // 1000
+ * METERS_PER.au; // 149_597_870_700
+ * ```
+ */
+export const METERS_PER = Object.freeze({
+    m: 1,
+    km: 1e3,
+    au: AU_METERS,
+    ly: METERS_PER_LY,
+    kly: METERS_PER_LY * 1e3,
+    Mly: METERS_PER_LY * 1e6,
+    Gly: METERS_PER_LY * 1e9,
+    pc: METERS_PER_PC,
+    kpc: METERS_PER_PC * 1e3,
+    Mpc: METERS_PER_PC * 1e6,
+    Gpc: METERS_PER_PC * 1e9
+});
+/**
+ * Convert a **distance** between any two {@link DistanceUnitType} units.
+ *
+ * - Uses {@link METERS_PER} with **meters** as the intermediate unit.
+ * - The `distance.unit` is expected to be **canonical**, as in the datasets.
+ * - The `targetUnit` may be a canonical unit or an alias such as `'AU'`; it is
+ *   normalized to a canonical symbol.
+ *
+ * $$
+ * \text{value}_{\text{target}}
+ * \;=\;
+ * \frac{\text{value}_{\text{in}} \cdot \mathrm{METERS\_PER}[u_{\text{in}}]}
+ *      {\mathrm{METERS\_PER}[u_{\text{out}}]}
+ * $$
+ *
+ * @param distance   Input distance `{ value, unit }` in a canonical unit.
+ * @param targetUnit Desired output unit, canonical or an alias (will be normalized).
+ * @returns          A new `{ value, unit }` where `unit` is the canonical target symbol.
+ * @throws {RangeError} If `targetUnit` is not a known unit or alias.
+ * @group Helpers
+ *
+ * @example
+ * ```ts
+ * convertDistanceUnit({ value: 1, unit: 'au' }, 'km');
+ * // → { value: 149_597_870.7, unit: 'km' }
+ *
+ * convertDistanceUnit({ value: 1, unit: 'pc' }, 'ly');
+ * // → { value: 3.2615637771674333, unit: 'ly' }
+ *
+ * // Put a dataset's semi-major axis in the unit a renderer draws in:
+ * const jupiter = PLANETS.find((p) => p.id === 'jupiter');
+ * convertDistanceUnit(jupiter.orbit.a, 'au').value;
+ * ```
+ *
+ * @see normalizeDistanceUnit
+ */
+export const convertDistanceUnit = (distance, targetUnit) => {
+    const unit = normalizeDistanceUnit(targetUnit);
+    const inMeters = distance.value * METERS_PER[distance.unit];
+    return { value: inMeters / METERS_PER[unit], unit };
+};
+//# sourceMappingURL=convert-distance-unit.js.map

package/dist/categories/helpers/convert-distance-unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-distance-unit.js","sourceRoot":"","sources":["../../../src/categories/helpers/convert-distance-unit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACd,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,UAAU,GACrB,MAAM,CAAC,MAAM,CAAC;IACZ,CAAC,EAAE,CAAC;IACJ,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,aAAa;IACjB,GAAG,EAAE,aAAa,GAAG,GAAG;IACxB,GAAG,EAAE,aAAa,GAAG,GAAG;IACxB,GAAG,EAAE,aAAa,GAAG,GAAG;IACxB,EAAE,EAAE,aAAa;IACjB,GAAG,EAAE,aAAa,GAAG,GAAG;IACxB,GAAG,EAAE,aAAa,GAAG,GAAG;IACxB,GAAG,EAAE,aAAa,GAAG,GAAG;CACzB,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAA2B,EAC3B,UAAoD,EACjC,EAAE;IACrB,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC,CAAC"}

package/dist/categories/helpers/normalize-distance-unit.d.ts

@@ -0,0 +1,84 @@
+import type { DistanceUnitType } from '@interstellar-tools/types';
+/**
+ * Lookup table that **normalizes distance unit aliases** (and the canonical
+ * symbols themselves) to a single, canonical {@link DistanceUnitType}.
+ *
+ * - Canonical symbols map to themselves (`'au'` → `'au'`).
+ * - Aliases map to their symbol (`'AU'` → `'au'`, `'light-years'` → `'ly'`,
+ *   `'kiloparsecs'` → `'kpc'`).
+ * - **Case-sensitive** and exact: `'AU'` and `'Au'` are accepted, `'aU'` is not.
+ * - The table is frozen: it can be read, but not changed at runtime.
+ *
+ * @group Helpers
+ * @see normalizeDistanceUnit
+ * @see https://www.iau.org/static/resolutions/IAU2012_English.pdf (IAU 2012 B2 - astronomical unit, symbol "au")
+ */
+export declare const NORMALIZE_DISTANCE_UNIT: Readonly<{
+    readonly m: "m";
+    readonly km: "km";
+    readonly au: "au";
+    readonly ly: "ly";
+    readonly kly: "kly";
+    readonly Mly: "Mly";
+    readonly Gly: "Gly";
+    readonly pc: "pc";
+    readonly kpc: "kpc";
+    readonly Mpc: "Mpc";
+    readonly Gpc: "Gpc";
+    readonly meter: "m";
+    readonly meters: "m";
+    readonly metre: "m";
+    readonly metres: "m";
+    readonly kilometer: "km";
+    readonly kilometers: "km";
+    readonly kilometre: "km";
+    readonly kilometres: "km";
+    readonly AU: "au";
+    readonly Au: "au";
+    readonly 'astronomical-unit': "au";
+    readonly 'astronomical-units': "au";
+    readonly 'astronomical unit': "au";
+    readonly 'astronomical units': "au";
+    readonly lightyear: "ly";
+    readonly lightyears: "ly";
+    readonly 'light-year': "ly";
+    readonly 'light-years': "ly";
+    readonly kilolightyear: "kly";
+    readonly kilolightyears: "kly";
+    readonly megalightyear: "Mly";
+    readonly megalightyears: "Mly";
+    readonly gigalightyear: "Gly";
+    readonly gigalightyears: "Gly";
+    readonly parsec: "pc";
+    readonly parsecs: "pc";
+    readonly kiloparsec: "kpc";
+    readonly kiloparsecs: "kpc";
+    readonly megaparsec: "Mpc";
+    readonly megaparsecs: "Mpc";
+    readonly gigaparsec: "Gpc";
+    readonly gigaparsecs: "Gpc";
+}>;
+/**
+ * Normalize a **distance unit string** into a canonical {@link DistanceUnitType}.
+ *
+ * - Trims surrounding whitespace.
+ * - Accepts canonical symbols (`'km'`, `'au'`, `'ly'`, `'kpc'`, ...) and aliases
+ *   (`'AU'`, `'kilometres'`, `'light-years'`, `'parsecs'`, ...), using
+ *   {@link NORMALIZE_DISTANCE_UNIT} as the single source of truth.
+ * - **Case-sensitive**: `'Parsecs'` is rejected; use `'parsecs'` or `'pc'`.
+ *
+ * @param u - The input unit string. Leading/trailing whitespace is ignored.
+ * @returns The canonical {@link DistanceUnitType}.
+ * @throws {RangeError} If `u` is not a known unit or alias.
+ * @group Helpers
+ *
+ * @example
+ * ```ts
+ * normalizeDistanceUnit('AU'); // 'au'
+ * normalizeDistanceUnit(' light-years '); // 'ly'
+ * normalizeDistanceUnit('kiloparsecs'); // 'kpc'
+ * normalizeDistanceUnit('Mpc'); // 'Mpc' (already canonical)
+ * ```
+ */
+export declare const normalizeDistanceUnit: (u: string) => DistanceUnitType;
+//# sourceMappingURL=normalize-distance-unit.d.ts.map

package/dist/categories/helpers/normalize-distance-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-distance-unit.d.ts","sourceRoot":"","sources":["../../../src/categories/helpers/normalize-distance-unit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDlC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,qBAAqB,GAAI,GAAG,MAAM,KAAG,gBASjD,CAAC"}

package/dist/categories/helpers/normalize-distance-unit.js

@@ -0,0 +1,93 @@
+/**
+ * Lookup table that **normalizes distance unit aliases** (and the canonical
+ * symbols themselves) to a single, canonical {@link DistanceUnitType}.
+ *
+ * - Canonical symbols map to themselves (`'au'` → `'au'`).
+ * - Aliases map to their symbol (`'AU'` → `'au'`, `'light-years'` → `'ly'`,
+ *   `'kiloparsecs'` → `'kpc'`).
+ * - **Case-sensitive** and exact: `'AU'` and `'Au'` are accepted, `'aU'` is not.
+ * - The table is frozen: it can be read, but not changed at runtime.
+ *
+ * @group Helpers
+ * @see normalizeDistanceUnit
+ * @see https://www.iau.org/static/resolutions/IAU2012_English.pdf (IAU 2012 B2 - astronomical unit, symbol "au")
+ */
+export const NORMALIZE_DISTANCE_UNIT = Object.freeze({
+    // canonical already map to themselves:
+    m: 'm',
+    km: 'km',
+    au: 'au',
+    ly: 'ly',
+    kly: 'kly',
+    Mly: 'Mly',
+    Gly: 'Gly',
+    pc: 'pc',
+    kpc: 'kpc',
+    Mpc: 'Mpc',
+    Gpc: 'Gpc',
+    // aliases → canonical
+    meter: 'm',
+    meters: 'm',
+    metre: 'm',
+    metres: 'm',
+    kilometer: 'km',
+    kilometers: 'km',
+    kilometre: 'km',
+    kilometres: 'km',
+    AU: 'au',
+    Au: 'au',
+    'astronomical-unit': 'au',
+    'astronomical-units': 'au',
+    'astronomical unit': 'au',
+    'astronomical units': 'au',
+    lightyear: 'ly',
+    lightyears: 'ly',
+    'light-year': 'ly',
+    'light-years': 'ly',
+    kilolightyear: 'kly',
+    kilolightyears: 'kly',
+    megalightyear: 'Mly',
+    megalightyears: 'Mly',
+    gigalightyear: 'Gly',
+    gigalightyears: 'Gly',
+    parsec: 'pc',
+    parsecs: 'pc',
+    kiloparsec: 'kpc',
+    kiloparsecs: 'kpc',
+    megaparsec: 'Mpc',
+    megaparsecs: 'Mpc',
+    gigaparsec: 'Gpc',
+    gigaparsecs: 'Gpc'
+});
+/**
+ * Normalize a **distance unit string** into a canonical {@link DistanceUnitType}.
+ *
+ * - Trims surrounding whitespace.
+ * - Accepts canonical symbols (`'km'`, `'au'`, `'ly'`, `'kpc'`, ...) and aliases
+ *   (`'AU'`, `'kilometres'`, `'light-years'`, `'parsecs'`, ...), using
+ *   {@link NORMALIZE_DISTANCE_UNIT} as the single source of truth.
+ * - **Case-sensitive**: `'Parsecs'` is rejected; use `'parsecs'` or `'pc'`.
+ *
+ * @param u - The input unit string. Leading/trailing whitespace is ignored.
+ * @returns The canonical {@link DistanceUnitType}.
+ * @throws {RangeError} If `u` is not a known unit or alias.
+ * @group Helpers
+ *
+ * @example
+ * ```ts
+ * normalizeDistanceUnit('AU'); // 'au'
+ * normalizeDistanceUnit(' light-years '); // 'ly'
+ * normalizeDistanceUnit('kiloparsecs'); // 'kpc'
+ * normalizeDistanceUnit('Mpc'); // 'Mpc' (already canonical)
+ * ```
+ */
+export const normalizeDistanceUnit = (u) => {
+    const k = u.trim();
+    const v = Object.prototype.hasOwnProperty.call(NORMALIZE_DISTANCE_UNIT, k)
+        ? NORMALIZE_DISTANCE_UNIT[k]
+        : undefined;
+    if (!v)
+        throw new RangeError(`Unsupported unit: ${u}`);
+    return v;
+};
+//# sourceMappingURL=normalize-distance-unit.js.map

package/dist/categories/helpers/normalize-distance-unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-distance-unit.js","sourceRoot":"","sources":["../../../src/categories/helpers/normalize-distance-unit.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,uCAAuC;IACvC,CAAC,EAAE,GAAG;IACN,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IAEV,sBAAsB;IACtB,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;IACX,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,IAAI;IAC1B,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;CAInB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAS,EAAoB,EAAE;IACnE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,uBAAuB,CAAC,CAAyC,CAAC;QACpE,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAEvD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/index.d.ts

@@ -12,9 +12,11 @@ export * from './categories/cartography/is-on-triaxial-ellipsoid-surface.js';
 export * from './categories/cartography/planetocentric-latitude.js';
 export * from './categories/cartography/planetographic-latitude-oblate.js';
 export * from './categories/helpers/apply-matrix-3.js';
+export * from './categories/helpers/convert-distance-unit.js';
 export * from './categories/helpers/det-3.js';
 export * from './categories/helpers/mat-mul3.js';
 export * from './categories/helpers/misc.js';
+export * from './categories/helpers/normalize-distance-unit.js';
 export * from './categories/helpers/radians.js';
 export * from './categories/helpers/rot-1.js';
 export * from './categories/helpers/rot-3.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAI3E,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAIpD,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAI/D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAIpD,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAIhE,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,uCAAuC,CAAC;AAItD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,6CAA6C,CAAC;AAE5D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAI3E,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAIpD,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAI/D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAIpD,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAIhE,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,uCAAuC,CAAC;AAItD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,6CAA6C,CAAC;AAE5D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC"}

package/dist/index.js

@@ -15,9 +15,11 @@ export * from './categories/cartography/planetocentric-latitude.js';
 export * from './categories/cartography/planetographic-latitude-oblate.js';
 // categories/helpers
 export * from './categories/helpers/apply-matrix-3.js';
+export * from './categories/helpers/convert-distance-unit.js';
 export * from './categories/helpers/det-3.js';
 export * from './categories/helpers/mat-mul3.js';
 export * from './categories/helpers/misc.js';
+export * from './categories/helpers/normalize-distance-unit.js';
 export * from './categories/helpers/radians.js';
 export * from './categories/helpers/rot-1.js';
 export * from './categories/helpers/rot-3.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAEjD,yBAAyB;AAEzB,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAE3E,qBAAqB;AAErB,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAEpD,uBAAuB;AAEvB,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAE/D,8BAA8B;AAE9B,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAEpD,qBAAqB;AAErB,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAEhE,oBAAoB;AAEpB,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,uCAAuC,CAAC;AAEtD,wBAAwB;AAExB,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,6CAA6C,CAAC;AAE5D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAEjD,yBAAyB;AAEzB,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAE3E,qBAAqB;AAErB,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAEpD,uBAAuB;AAEvB,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAE/D,8BAA8B;AAE9B,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAEpD,qBAAqB;AAErB,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAEhE,oBAAoB;AAEpB,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,uCAAuC,CAAC;AAEtD,wBAAwB;AAExB,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,6CAA6C,CAAC;AAE5D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interstellar-tools/equations",
-  "version": "0.63.1",
+  "version": "0.64.0",
   "description": "Curated, well-tested orbital mechanics and dynamics formulas (e.g., Newtonian gravity, vis-viva, Kepler's 3rd law, escape/circular speeds, specific energy, specific angular momentum, peri/apoapsis radii).",
   "keywords": [
     "interstellar",
@@ -111,7 +111,7 @@
   },
   "dependencies": {
     "@interstellar-tools/constants": "^0.62.0",
-    "@interstellar-tools/temporal": "^0.60.0",
+    "@interstellar-tools/temporal": "^0.61.0",
     "@interstellar-tools/types": "^0.62.0"
   },
   "devDependencies": {