@interstellar-tools/constants 0.1.1

package/README.md

@@ -0,0 +1,18 @@
+# @interstellar-tools/constants
+
+## 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/constants
+```
+
+```shell [yarn]
+yarn add @interstellar-tools/constants
+```
+
+:::

package/dist/date.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Time-scale tags used in this package.
+ *
+ * ::: info
+ *
+ * Astronomy formulas are defined in specific time scales (most commonly **TT**).
+ * JavaScript `Date` represents **UTC** only. Keep these symbols explicit to avoid ambiguity.
+ *
+ * :::
+ *
+ * @category Date
+ */
+export declare const TIME_SCALE_UTC: "UTC";
+/**
+ * @category Date
+ */
+export declare const TIME_SCALE_TT: "TT";
+/**
+ * **J2000 epoch as a UTC timestamp** for JavaScript usage.
+ *
+ * J2000 is *defined* as **JD 2451545.0 (TT)**, i.e. 2000-01-01 12:00:00 **TT**.
+ * At that epoch **TT − UTC = 64.184 s**, so the corresponding UTC instant is:
+ * **2000-01-01T11:58:55.816Z**.
+ *
+ * @example
+ * // Milliseconds from UTC midnight to J2000 (UTC):
+ * const deltaMs = +J2000_UTC - +EPOCH_2000_UTC_MIDNIGHT; // 43_135_816 ms
+ *
+ * // If you need the TT-based Julian centuries since J2000:
+ * //   T = (JD_TT - J2000_TT) / 36525
+ * // Compute JD_TT from a UTC Date using your UTC→TT→JD pipeline, then use J2000_TT.
+ * @category Date
+ */
+export declare const J2000_UTC: Date;
+/**
+ * Time scale associated with {@link J2000_UTC}.
+ * @category Date
+ */
+export declare const J2000_UTC_TIME_SCALE: "UTC";
+/**
+ * **UTC midnight at the start of 2000-01-01** (convenient calendar anchor).
+ *
+ * ::: warning
+ *
+ * This is **not** the J2000 epoch itself (which occurs 11:58:55.816 later in UTC).
+ *
+ * :::
+ *
+ * @category Date
+ */
+export declare const EPOCH_2000_UTC_MIDNIGHT: Date;
+/**
+ * Time scale associated with {@link EPOCH_2000_UTC_MIDNIGHT}.
+ * @category Date
+ */
+export declare const EPOCH_2000_UTC_MIDNIGHT_TIME_SCALE: "UTC";
+/**
+ * **J2000 epoch as a Julian Date in the TT time scale.**
+ *
+ * Defined as **JD 2451545.0 (TT)**, corresponding to 2000-01-01 12:00:00 **TT**.
+ *
+ * @example
+ * // Julian centuries since J2000 in TT:
+ * // const T = (jdTT - J2000_TT) / 36525;
+ * @category Date
+ */
+export declare const J2000_TT: 2451545;
+/**
+ * The **defining** time scale for the J2000 epoch.
+ * J2000 is conventionally specified in **Terrestrial Time** (TT).
+ *
+ * @example
+ * // When computing Julian centuries:
+ * //   T = (JD_TT - J2000_TT) / 36525
+ * @category Date
+ */
+export declare const J2000_EPOCH_TIME_SCALE: "TT";
+/**
+ * Useful offset at the J2000 epoch (for UTC↔TT conversions near that instant).
+ *
+ * - TT − UTC = **64.184 s** at 2000-01-01
+ * - Provided in both seconds and milliseconds for convenience.
+ *
+ * ::: info
+ *
+ * UTC–TT offset changes when leap seconds are introduced; this constant is
+ * specific to the J2000 epoch.
+ *
+ * :::
+ * @category Date
+ */
+export declare const TT_MINUS_UTC_AT_J2000_SECONDS = 64.184;
+/**
+ * @category Date
+ */
+export declare const TT_MINUS_UTC_AT_J2000_MS = 64184;
+//# sourceMappingURL=date.d.ts.map

package/dist/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAG,KAAc,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAG,IAAa,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,MAAuC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,OAAiB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,MAAmC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,kCAAkC,OAAiB,CAAC;AAEjE;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,EAAG,OAAkB,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,MAAgB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,SAAS,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC"}

package/dist/date.js

@@ -0,0 +1,97 @@
+/**
+ * Time-scale tags used in this package.
+ *
+ * ::: info
+ *
+ * Astronomy formulas are defined in specific time scales (most commonly **TT**).
+ * JavaScript `Date` represents **UTC** only. Keep these symbols explicit to avoid ambiguity.
+ *
+ * :::
+ *
+ * @category Date
+ */
+export const TIME_SCALE_UTC = 'UTC';
+/**
+ * @category Date
+ */
+export const TIME_SCALE_TT = 'TT';
+/**
+ * **J2000 epoch as a UTC timestamp** for JavaScript usage.
+ *
+ * J2000 is *defined* as **JD 2451545.0 (TT)**, i.e. 2000-01-01 12:00:00 **TT**.
+ * At that epoch **TT − UTC = 64.184 s**, so the corresponding UTC instant is:
+ * **2000-01-01T11:58:55.816Z**.
+ *
+ * @example
+ * // Milliseconds from UTC midnight to J2000 (UTC):
+ * const deltaMs = +J2000_UTC - +EPOCH_2000_UTC_MIDNIGHT; // 43_135_816 ms
+ *
+ * // If you need the TT-based Julian centuries since J2000:
+ * //   T = (JD_TT - J2000_TT) / 36525
+ * // Compute JD_TT from a UTC Date using your UTC→TT→JD pipeline, then use J2000_TT.
+ * @category Date
+ */
+export const J2000_UTC = new Date('2000-01-01T11:58:55.816Z');
+/**
+ * Time scale associated with {@link J2000_UTC}.
+ * @category Date
+ */
+export const J2000_UTC_TIME_SCALE = TIME_SCALE_UTC;
+/**
+ * **UTC midnight at the start of 2000-01-01** (convenient calendar anchor).
+ *
+ * ::: warning
+ *
+ * This is **not** the J2000 epoch itself (which occurs 11:58:55.816 later in UTC).
+ *
+ * :::
+ *
+ * @category Date
+ */
+export const EPOCH_2000_UTC_MIDNIGHT = new Date('2000-01-01T00:00:00Z');
+/**
+ * Time scale associated with {@link EPOCH_2000_UTC_MIDNIGHT}.
+ * @category Date
+ */
+export const EPOCH_2000_UTC_MIDNIGHT_TIME_SCALE = TIME_SCALE_UTC;
+/**
+ * **J2000 epoch as a Julian Date in the TT time scale.**
+ *
+ * Defined as **JD 2451545.0 (TT)**, corresponding to 2000-01-01 12:00:00 **TT**.
+ *
+ * @example
+ * // Julian centuries since J2000 in TT:
+ * // const T = (jdTT - J2000_TT) / 36525;
+ * @category Date
+ */
+export const J2000_TT = 2451545.0;
+/**
+ * The **defining** time scale for the J2000 epoch.
+ * J2000 is conventionally specified in **Terrestrial Time** (TT).
+ *
+ * @example
+ * // When computing Julian centuries:
+ * //   T = (JD_TT - J2000_TT) / 36525
+ * @category Date
+ */
+export const J2000_EPOCH_TIME_SCALE = TIME_SCALE_TT;
+/**
+ * Useful offset at the J2000 epoch (for UTC↔TT conversions near that instant).
+ *
+ * - TT − UTC = **64.184 s** at 2000-01-01
+ * - Provided in both seconds and milliseconds for convenience.
+ *
+ * ::: info
+ *
+ * UTC–TT offset changes when leap seconds are introduced; this constant is
+ * specific to the J2000 epoch.
+ *
+ * :::
+ * @category Date
+ */
+export const TT_MINUS_UTC_AT_J2000_SECONDS = 64.184;
+/**
+ * @category Date
+ */
+export const TT_MINUS_UTC_AT_J2000_MS = 64184;
+//# sourceMappingURL=date.js.map

package/dist/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAa,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,cAAc,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAkB,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAM,CAAC"}

package/dist/distance.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Core **astronomical distance constants** and **conversion ratios**.
+ *
+ * ## Conventions
+ * - **Meters** are the base distance unit.
+ * - **Light-year** uses the **Julian year** (exactly 365.25 d) via {@link JULIAN_YEAR_SECONDS}.
+ * - **Astronomical unit (au)** is exact per IAU 2012 B2.
+ * - **Parsec** is defined by trigonometric parallax: `pc = au / tan(1″)`.
+ *
+ * @see https://www.bipm.org/en/publications/si-brochure (SI Brochure)
+ * @see https://www.iau.org/static/resolutions/IAU2012_English.pdf (IAU 2012 B2 — astronomical unit)
+ * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year)
+ * @see https://en.wikipedia.org/wiki/Parsec (Parsec definition)
+ */
+/**
+ * Speed of light in vacuum, **exact** per SI (m·s⁻¹).
+ * @category Distance
+ */
+export declare const SPEED_OF_LIGHT_M_PER_S: 299792458;
+/**
+ *  Astronomical unit in meters, **exact** (IAU 2012 B2).
+ * @category Distance
+ */
+export declare const AU_METERS: 149597870700;
+/**
+ * Meters in one **light-year**, defined as `c × (Julian year)`.
+ *
+ * ::: info
+ *
+ * Uses {@link SPEED_OF_LIGHT_M_PER_S} × {@link JULIAN_YEAR_SECONDS}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export declare const METERS_PER_LY: number;
+/**
+ * Radians in one arcsecond: `π / 648 000`.
+ *
+ * ::: tip
+ *
+ * Convenient for expressing the exact parsec definition.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export declare const RADIANS_PER_ARCSECOND: number;
+/**
+ * Meters in one **parsec**, using the exact trigonometric definition: `pc = au / tan(1″)`.
+ *
+ * ::: info
+ *
+ * Computed as {@link AU_METERS} / tan({@link RADIANS_PER_ARCSECOND}).
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export declare const METERS_PER_PC: number;
+/**
+ * Astronomical units per light-year.
+ *
+ * ::: info
+ *
+ * Computed as {@link METERS_PER_LY} / {@link AU_METERS}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export declare const AU_PER_LY: number;
+/**
+ * Light-years per astronomical unit (reciprocal of {@link AU_PER_LY}).
+ * @category Distance
+ */
+export declare const LY_PER_AU: number;
+/**
+ * Kilometers in one astronomical unit.
+ * @category Distance
+ */
+export declare const KM_PER_AU: number;
+/**
+ * Light-years per parsec.
+ *
+ * ::: info
+ *
+ * Computed as {@link METERS_PER_PC} / {@link METERS_PER_LY}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export declare const LY_PER_PC: number;
+/**
+ * Parsecs per light-year (reciprocal of {@link LY_PER_PC}).
+ * @category Distance
+ */
+export declare const PC_PER_LY: number;
+//# sourceMappingURL=distance.d.ts.map

package/dist/distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAIH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAG,SAAoB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAG,YAAwB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,QAA+C,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,QAA8C,CAAC;AAIzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,QAA4B,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAgB,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAoB,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,QAAgC,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAgB,CAAC"}

package/dist/distance.js

@@ -0,0 +1,103 @@
+import { JULIAN_YEAR_SECONDS } from './temporal';
+/**
+ * Core **astronomical distance constants** and **conversion ratios**.
+ *
+ * ## Conventions
+ * - **Meters** are the base distance unit.
+ * - **Light-year** uses the **Julian year** (exactly 365.25 d) via {@link JULIAN_YEAR_SECONDS}.
+ * - **Astronomical unit (au)** is exact per IAU 2012 B2.
+ * - **Parsec** is defined by trigonometric parallax: `pc = au / tan(1″)`.
+ *
+ * @see https://www.bipm.org/en/publications/si-brochure (SI Brochure)
+ * @see https://www.iau.org/static/resolutions/IAU2012_English.pdf (IAU 2012 B2 — astronomical unit)
+ * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year)
+ * @see https://en.wikipedia.org/wiki/Parsec (Parsec definition)
+ */
+// Base physical/constants
+/**
+ * Speed of light in vacuum, **exact** per SI (m·s⁻¹).
+ * @category Distance
+ */
+export const SPEED_OF_LIGHT_M_PER_S = 299792458; // exact (SI)
+/**
+ *  Astronomical unit in meters, **exact** (IAU 2012 B2).
+ * @category Distance
+ */
+export const AU_METERS = 149597870700;
+/**
+ * Meters in one **light-year**, defined as `c × (Julian year)`.
+ *
+ * ::: info
+ *
+ * Uses {@link SPEED_OF_LIGHT_M_PER_S} × {@link JULIAN_YEAR_SECONDS}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export const METERS_PER_LY = SPEED_OF_LIGHT_M_PER_S * JULIAN_YEAR_SECONDS; // 9_460_730_472_580_800
+/**
+ * Radians in one arcsecond: `π / 648 000`.
+ *
+ * ::: tip
+ *
+ * Convenient for expressing the exact parsec definition.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export const RADIANS_PER_ARCSECOND = Math.PI / 648000;
+/**
+ * Meters in one **parsec**, using the exact trigonometric definition: `pc = au / tan(1″)`.
+ *
+ * ::: info
+ *
+ * Computed as {@link AU_METERS} / tan({@link RADIANS_PER_ARCSECOND}).
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export const METERS_PER_PC = AU_METERS / Math.tan(RADIANS_PER_ARCSECOND); // ≈ 3.08567758149e16
+// Helpful ratios (derive from the above to avoid drift)
+/**
+ * Astronomical units per light-year.
+ *
+ * ::: info
+ *
+ * Computed as {@link METERS_PER_LY} / {@link AU_METERS}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export const AU_PER_LY = METERS_PER_LY / AU_METERS; // ≈ 63_241.07708426628
+/**
+ * Light-years per astronomical unit (reciprocal of {@link AU_PER_LY}).
+ * @category Distance
+ */
+export const LY_PER_AU = 1 / AU_PER_LY;
+/**
+ * Kilometers in one astronomical unit.
+ * @category Distance
+ */
+export const KM_PER_AU = AU_METERS / 1000;
+/**
+ * Light-years per parsec.
+ *
+ * ::: info
+ *
+ * Computed as {@link METERS_PER_PC} / {@link METERS_PER_LY}.
+ *
+ * :::
+ *
+ * @category Distance
+ */
+export const LY_PER_PC = METERS_PER_PC / METERS_PER_LY; // ≈ 3.26156…
+/**
+ * Parsecs per light-year (reciprocal of {@link LY_PER_PC}).
+ * @category Distance
+ */
+export const PC_PER_LY = 1 / LY_PER_PC;
+//# sourceMappingURL=distance.js.map

package/dist/distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AAEH,0BAA0B;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAoB,CAAC,CAAC,aAAa;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAwB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,GAAG,mBAAmB,CAAC,CAAC,wBAAwB;AAEnG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,EAAE,GAAG,MAAO,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB;AAE/F,wDAAwD;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC,uBAAuB;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,GAAG,IAAK,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC,aAAa;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ *
+ * @showCategories
+ * @packageDocumentation
+ */
+export * from './date';
+export * from './distance';
+export * from './math';
+export * from './objects';
+export * from './temporal';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC;AAEvB,cAAc,YAAY,CAAC;AAE3B,cAAc,QAAQ,CAAC;AAEvB,cAAc,WAAW,CAAC;AAE1B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ *
+ * @showCategories
+ * @packageDocumentation
+ */
+export * from './date';
+export * from './distance';
+export * from './math';
+export * from './objects';
+export * from './temporal';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC;AAEvB,cAAc,YAAY,CAAC;AAE3B,cAAc,QAAQ,CAAC;AAEvB,cAAc,WAAW,CAAC;AAE1B,cAAc,YAAY,CAAC"}

package/dist/math.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The circle constant **τ** (tau), equal to **2π** `(≈ 6.283185307179586)`.
+ * Useful for full rotations, radians-per-turn calculations, angular velocity,
+ * and other periodic math where factors of 2 arise naturally.
+ *
+ * $$
+ * \tau = 2\pi
+ * $$
+ * $$
+ * 1\ \text{turn} = \tau\ \text{radians} = 360^\circ
+ * $$
+ * $$
+ * \theta_{\text{rad}} = t\,\tau \quad (\text{turn fraction } t \in [0,1))
+ * $$
+ * $$
+ * \theta_{\deg} = \frac{180^\circ}{\pi}\,\theta_{\text{rad}} = 360^\circ\,t
+ * $$
+ * $$
+ * \omega = 2\pi f = \tau f \quad\text{(angular frequency)}
+ * $$
+ * $$
+ * T = \frac{2\pi}{\omega} = \frac{\tau}{\omega} \quad\text{(period)}
+ * $$
+ *
+ * @readonly
+ *
+ * ::: info
+ *
+ * - Using **τ** often simplifies formulas that involve *full cycles* (e.g., Fourier analysis,
+ *   rotations, oscillator phase), eliminating stray factors of 2.
+ * - `TWO_PI` is a runtime numeric constant; do not compare floating-point results using `===`
+ *   when they involve trigonometric operations—prefer tolerance checks.
+ *
+ * :::
+ *
+ * @see https://en.wikipedia.org/wiki/Tau_(mathematics)
+ * @see https://en.wikipedia.org/wiki/Radian
+ *
+ * @example
+ * ```ts
+ * import { TWO_PI } from "./constants";
+ *
+ * // A quarter turn (π/2 radians)
+ * const quarterTurn = 0.25 * TWO_PI; // ≈ 1.5707963267948966
+ *
+ * // Point on the unit circle at 1/8 of a turn
+ * const t = 1 / 8;
+ * const angle = t * TWO_PI;  // τ/8 = π/4
+ * const x = Math.cos(angle); // ≈ 0.7071
+ * const y = Math.sin(angle); // ≈ 0.7071
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Wrap any angle (radians) to [0, τ):
+ * function wrapTau(theta: number): number {
+ *   const tau = TWO_PI;
+ *   return ((theta % tau) + tau) % tau;
+ * }
+ *
+ * // Convert turn fraction to radians:
+ * const radiansFromTurns = (turns: number) => turns * TWO_PI;
+ *
+ * // Angular frequency from frequency (Hz):
+ * const omega = (f: number) => TWO_PI * f; // ω = τ f
+ * ```
+ * @category Math
+ */
+export declare const TWO_PI: number;
+//# sourceMappingURL=math.d.ts.map

package/dist/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,MAAM,EAAE,MAAoB,CAAC"}

package/dist/math.js

@@ -0,0 +1,70 @@
+/**
+ * The circle constant **τ** (tau), equal to **2π** `(≈ 6.283185307179586)`.
+ * Useful for full rotations, radians-per-turn calculations, angular velocity,
+ * and other periodic math where factors of 2 arise naturally.
+ *
+ * $$
+ * \tau = 2\pi
+ * $$
+ * $$
+ * 1\ \text{turn} = \tau\ \text{radians} = 360^\circ
+ * $$
+ * $$
+ * \theta_{\text{rad}} = t\,\tau \quad (\text{turn fraction } t \in [0,1))
+ * $$
+ * $$
+ * \theta_{\deg} = \frac{180^\circ}{\pi}\,\theta_{\text{rad}} = 360^\circ\,t
+ * $$
+ * $$
+ * \omega = 2\pi f = \tau f \quad\text{(angular frequency)}
+ * $$
+ * $$
+ * T = \frac{2\pi}{\omega} = \frac{\tau}{\omega} \quad\text{(period)}
+ * $$
+ *
+ * @readonly
+ *
+ * ::: info
+ *
+ * - Using **τ** often simplifies formulas that involve *full cycles* (e.g., Fourier analysis,
+ *   rotations, oscillator phase), eliminating stray factors of 2.
+ * - `TWO_PI` is a runtime numeric constant; do not compare floating-point results using `===`
+ *   when they involve trigonometric operations—prefer tolerance checks.
+ *
+ * :::
+ *
+ * @see https://en.wikipedia.org/wiki/Tau_(mathematics)
+ * @see https://en.wikipedia.org/wiki/Radian
+ *
+ * @example
+ * ```ts
+ * import { TWO_PI } from "./constants";
+ *
+ * // A quarter turn (π/2 radians)
+ * const quarterTurn = 0.25 * TWO_PI; // ≈ 1.5707963267948966
+ *
+ * // Point on the unit circle at 1/8 of a turn
+ * const t = 1 / 8;
+ * const angle = t * TWO_PI;  // τ/8 = π/4
+ * const x = Math.cos(angle); // ≈ 0.7071
+ * const y = Math.sin(angle); // ≈ 0.7071
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Wrap any angle (radians) to [0, τ):
+ * function wrapTau(theta: number): number {
+ *   const tau = TWO_PI;
+ *   return ((theta % tau) + tau) % tau;
+ * }
+ *
+ * // Convert turn fraction to radians:
+ * const radiansFromTurns = (turns: number) => turns * TWO_PI;
+ *
+ * // Angular frequency from frequency (Hz):
+ * const omega = (f: number) => TWO_PI * f; // ω = τ f
+ * ```
+ * @category Math
+ */
+export const TWO_PI = 2 * Math.PI;
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC"}

package/dist/objects.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Solar radius constants (all values in **kilometres**).
+ *
+ * ## Conventions:
+ * - **Nominal radius** is an exact conversion constant (IAU 2015 B3).
+ * - **Photospheric/seismic** value follows Haberreiter–Schmutz–Kosovichev (2008),
+ *   which reconciles seismic and photospheric definitions by lowering the standard radius.
+ * - **Limb inflection offset** quantifies how the brightness–profile "edge" overestimates
+ *   the photospheric/seismic radius (~0.333 Mm).
+ * - **Transit** and **PICARD/SODISM** radii are precise observational determinations,
+ *   with quoted 1σ uncertainties where available (bandpass-dependent for PICARD).
+ */
+/**
+ *  Nominal solar radius (IAU 2015 B3), exact.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_NOMINAL_KM: 695700;
+/**
+ * Photospheric / "standard" solar radius suggested for models (HSK 2008).
+ * Reconciles seismic and photospheric definitions.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PHOTOSPHERIC_KM = 695660;
+/**
+ *
+ *   Limb–inflection minus photospheric offset (~0.333 Mm).
+ /
+export const SOLAR_RADIUS_LIMB_INFLECTION_MINUS_PHOTOSPHERIC_KM = 333;
+
+// --- SOHO/MDI Mercury transits (2003, 2006) ---
+/**
+ *  Radius from SOHO/MDI Mercury transits (2003 & 2006).
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_SOHO_MDI_MERCURY_TRANSIT_KM = 696342;
+/**
+ *  1σ uncertainty for SOHO/MDI Mercury-transit radius.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_SOHO_MDI_MERCURY_TRANSIT_UNC_KM = 65;
+/**
+ *  PICARD/SODISM radius at 535.7 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_535_7_NM_KM = 696134;
+/**
+ *  1σ uncertainty at 535.7 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_535_7_NM_UNC_KM = 261;
+/**
+ *  PICARD/SODISM radius at 607.1 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_607_1_NM_KM = 696156;
+/**
+ *  1σ uncertainty at 607.1 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_607_1_NM_UNC_KM = 145;
+/**
+ *  PICARD/SODISM radius at 782.2 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_782_2_NM_KM = 696192;
+/**
+ *  1σ uncertainty at 782.2 nm.
+ * @category Objects
+ */
+export declare const SOLAR_RADIUS_PICARD_SODISM_782_2_NM_UNC_KM = 247;
+//# sourceMappingURL=objects.d.ts.map

package/dist/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAG,MAAgB,CAAC;AAGxD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wCAAwC,SAAU,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,4CAA4C,KAAK,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,sCAAsC,SAAU,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,0CAA0C,MAAM,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,sCAAsC,SAAU,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,0CAA0C,MAAM,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,sCAAsC,SAAU,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,0CAA0C,MAAM,CAAC"}

package/dist/objects.js

@@ -0,0 +1,74 @@
+/**
+ * Solar radius constants (all values in **kilometres**).
+ *
+ * ## Conventions:
+ * - **Nominal radius** is an exact conversion constant (IAU 2015 B3).
+ * - **Photospheric/seismic** value follows Haberreiter–Schmutz–Kosovichev (2008),
+ *   which reconciles seismic and photospheric definitions by lowering the standard radius.
+ * - **Limb inflection offset** quantifies how the brightness–profile "edge" overestimates
+ *   the photospheric/seismic radius (~0.333 Mm).
+ * - **Transit** and **PICARD/SODISM** radii are precise observational determinations,
+ *   with quoted 1σ uncertainties where available (bandpass-dependent for PICARD).
+ */
+// --- IAU nominal (exact conversion constant) ---
+/**
+ *  Nominal solar radius (IAU 2015 B3), exact.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_NOMINAL_KM = 695700;
+// --- Photospheric / seismic convention (HSK 2008) ---
+/**
+ * Photospheric / "standard" solar radius suggested for models (HSK 2008).
+ * Reconciles seismic and photospheric definitions.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PHOTOSPHERIC_KM = 695660;
+/**
+ *
+ *   Limb–inflection minus photospheric offset (~0.333 Mm).
+ /
+export const SOLAR_RADIUS_LIMB_INFLECTION_MINUS_PHOTOSPHERIC_KM = 333;
+
+// --- SOHO/MDI Mercury transits (2003, 2006) ---
+/**
+ *  Radius from SOHO/MDI Mercury transits (2003 & 2006).
+ * @category Objects
+ */
+export const SOLAR_RADIUS_SOHO_MDI_MERCURY_TRANSIT_KM = 696342;
+/**
+ *  1σ uncertainty for SOHO/MDI Mercury-transit radius.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_SOHO_MDI_MERCURY_TRANSIT_UNC_KM = 65;
+// --- PICARD/SODISM (Venus transit 2012; bandpass-specific, limb-inflection definition) ---
+/**
+ *  PICARD/SODISM radius at 535.7 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_535_7_NM_KM = 696134;
+/**
+ *  1σ uncertainty at 535.7 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_535_7_NM_UNC_KM = 261;
+/**
+ *  PICARD/SODISM radius at 607.1 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_607_1_NM_KM = 696156;
+/**
+ *  1σ uncertainty at 607.1 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_607_1_NM_UNC_KM = 145;
+/**
+ *  PICARD/SODISM radius at 782.2 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_782_2_NM_KM = 696192;
+/**
+ *  1σ uncertainty at 782.2 nm.
+ * @category Objects
+ */
+export const SOLAR_RADIUS_PICARD_SODISM_782_2_NM_UNC_KM = 247;
+//# sourceMappingURL=objects.js.map

package/dist/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAgB,CAAC;AAExD,uDAAuD;AACvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAO,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,MAAO,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,EAAE,CAAC;AAE/D,4FAA4F;AAC5F;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAO,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,GAAG,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAO,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,GAAG,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAO,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,GAAG,CAAC"}

package/dist/temporal.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Core **time constants** used across the temporal utilities.
+ *
+ * ## Conventions
+ * - **Base units**: seconds and milliseconds.
+ * - **SI day**: exactly `86 400 s`.
+ * - **Julian year** (astronomy): exactly `365.25 d = 31 557 600 s`.
+ *
+ * @see https://www.bipm.org/en/publications/si-brochure (SI Brochure — second & day)
+ * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year definition)
+ *
+ * @example
+ * ```ts
+ * const hoursPerDay = SECONDS_PER_DAY / 3600; // 24
+ * const msInTwoDays = 2 * MILLISECONDS_PER_DAY; // 172_800_000
+ * const secondsInHalfJulianYear = JULIAN_YEAR_SECONDS / 2; // 15_778_800
+ * ```
+ */
+/**
+ *  Length of the **SI day** in seconds (exact).
+ * @category Temporal
+ */
+export declare const SECONDS_PER_DAY: 86400;
+/**
+ *  Milliseconds in one second (exact).
+ * @category Temporal
+ */
+export declare const MILLISECONDS_PER_SECOND: 1000;
+/**
+ * Milliseconds in one **SI day**.
+ *
+ * ::: info
+ *
+ * Computed from {@link SECONDS_PER_DAY} × {@link MILLISECONDS_PER_SECOND}.
+ *
+ * :::
+ *
+ * @category Temporal
+ */
+export declare const MILLISECONDS_PER_DAY: number;
+/**
+ *  Length of the **Julian year** in SI days (exactly 365.25).
+ * @category Temporal
+ */
+export declare const JULIAN_YEAR_DAYS: 365.25;
+/**
+ * Length of the **Julian year** in seconds.
+ *
+ * ::: info
+ *
+ * Computed as {@link SECONDS_PER_DAY} × {@link JULIAN_YEAR_DAYS} = **31 557 600 s**.
+ *
+ * :::
+ *
+ * @category Temporal
+ */
+export declare const JULIAN_YEAR_SECONDS: number;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAG,KAAe,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAG,IAAc,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAI9E;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,QAAqC,CAAC"}

package/dist/temporal.js

@@ -0,0 +1,59 @@
+/**
+ * Core **time constants** used across the temporal utilities.
+ *
+ * ## Conventions
+ * - **Base units**: seconds and milliseconds.
+ * - **SI day**: exactly `86 400 s`.
+ * - **Julian year** (astronomy): exactly `365.25 d = 31 557 600 s`.
+ *
+ * @see https://www.bipm.org/en/publications/si-brochure (SI Brochure — second & day)
+ * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year definition)
+ *
+ * @example
+ * ```ts
+ * const hoursPerDay = SECONDS_PER_DAY / 3600; // 24
+ * const msInTwoDays = 2 * MILLISECONDS_PER_DAY; // 172_800_000
+ * const secondsInHalfJulianYear = JULIAN_YEAR_SECONDS / 2; // 15_778_800
+ * ```
+ */
+/**
+ *  Length of the **SI day** in seconds (exact).
+ * @category Temporal
+ */
+export const SECONDS_PER_DAY = 86400;
+/**
+ *  Milliseconds in one second (exact).
+ * @category Temporal
+ */
+export const MILLISECONDS_PER_SECOND = 1000;
+/**
+ * Milliseconds in one **SI day**.
+ *
+ * ::: info
+ *
+ * Computed from {@link SECONDS_PER_DAY} × {@link MILLISECONDS_PER_SECOND}.
+ *
+ * :::
+ *
+ * @category Temporal
+ */
+export const MILLISECONDS_PER_DAY = SECONDS_PER_DAY * MILLISECONDS_PER_SECOND;
+// Julian year (astronomy) — EXACT 365.25 d
+/**
+ *  Length of the **Julian year** in SI days (exactly 365.25).
+ * @category Temporal
+ */
+export const JULIAN_YEAR_DAYS = 365.25;
+/**
+ * Length of the **Julian year** in seconds.
+ *
+ * ::: info
+ *
+ * Computed as {@link SECONDS_PER_DAY} × {@link JULIAN_YEAR_DAYS} = **31 557 600 s**.
+ *
+ * :::
+ *
+ * @category Temporal
+ */
+export const JULIAN_YEAR_SECONDS = SECONDS_PER_DAY * JULIAN_YEAR_DAYS; // 31_557_600
+//# sourceMappingURL=temporal.js.map

package/dist/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAc,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,GAAG,uBAAuB,CAAC;AAE9E,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAe,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC,aAAa"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@interstellar-tools/constants",
+  "version": "0.1.1",
+  "description": "constants",
+  "keywords": [
+    "constants"
+  ],
+  "homepage": "https://phun-ky.net/projects/interstellar-tools",
+  "bugs": {
+    "url": "https://github.com/phun-ky/interstellar-tools/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phun-ky/interstellar-tools.git"
+  },
+  "funding": "https://github.com/phun-ky/interstellar-tools?sponsor=1",
+  "license": "MIT",
+  "author": "Alexander Vassbotn Røyne-Helgesen <alexander@phun-ky.net>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "release": "release-it",
+    "test": "tsx --test **/__tests__/**/*.spec.ts",
+    "pretest:ci": "rm -rf coverage && mkdir -p coverage",
+    "test:ci": "glob -c \"node --import tsx --test --no-warnings --experimental-test-coverage --test-reporter=cobertura --test-reporter-destination=coverage/cobertura-coverage.xml --test-reporter=spec --test-reporter-destination=stdout\" \"**/__tests__/**/*.spec.ts\""
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.3",
+    "eslint": "^9.27.0",
+    "eslint-config-phun-ky": "^1.0.3",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=22.9.0",
+    "npm": ">=11.5.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}