@interstellar-tools/constants 0.1.1 → 0.2.0

package/README.md

@@ -5,14 +5,6 @@
 - [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/distance.d.ts

@@ -8,7 +8,7 @@
  * - **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://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)
  */

package/dist/distance.js

@@ -9,7 +9,7 @@ import { JULIAN_YEAR_SECONDS } from './temporal';
  * - **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://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)
  */

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export * from './distance';
 export * from './math';
 export * from './objects';
 export * from './temporal';
+export * from './physics';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAE3B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -8,4 +8,5 @@ export * from './distance';
 export * from './math';
 export * from './objects';
 export * from './temporal';
+export * from './physics';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAE3B,cAAc,WAAW,CAAC"}

package/dist/math.d.ts

@@ -29,7 +29,7 @@
  * - 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.
+ *   when they involve trigonometric operations-prefer tolerance checks.
  *
  * :::
  *

package/dist/math.js

@@ -29,7 +29,7 @@
  * - 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.
+ *   when they involve trigonometric operations-prefer tolerance checks.
  *
  * :::
  *

package/dist/physics.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Gravitational constant **G** in SI units.
+ *
+ * Numerical value from CODATA 2018: `6.67430 × 10⁻¹¹ m³·kg⁻¹·s⁻²` (relative standard uncertainty 2.2e-5).
+ * Use this for Newtonian gravity calculations:
+ *
+ * $$
+ * F = G\,\frac{m_1 m_2}{r^2}
+ * $$
+ *
+ * @type {number}
+ * @default 6.67430e-11
+ *
+ * @see https://physics.nist.gov/cgi-bin/cuu/Value?bg
+ * @see https://en.wikipedia.org/wiki/Gravitational_constant
+ *
+ * @example
+ * ```ts
+ * // Standard gravitational parameter (mu) for Earth:
+ * const M_earth = 5.97219e24; // kg
+ * const mu_earth = G_SI * M_earth; // ≈ 3.986004e14 m^3/s^2
+ * ```
+ */
+export declare const G_SI: number;
+//# sourceMappingURL=physics.d.ts.map

package/dist/physics.d.ts.map

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

package/dist/physics.js

@@ -0,0 +1,25 @@
+/**
+ * Gravitational constant **G** in SI units.
+ *
+ * Numerical value from CODATA 2018: `6.67430 × 10⁻¹¹ m³·kg⁻¹·s⁻²` (relative standard uncertainty 2.2e-5).
+ * Use this for Newtonian gravity calculations:
+ *
+ * $$
+ * F = G\,\frac{m_1 m_2}{r^2}
+ * $$
+ *
+ * @type {number}
+ * @default 6.67430e-11
+ *
+ * @see https://physics.nist.gov/cgi-bin/cuu/Value?bg
+ * @see https://en.wikipedia.org/wiki/Gravitational_constant
+ *
+ * @example
+ * ```ts
+ * // Standard gravitational parameter (mu) for Earth:
+ * const M_earth = 5.97219e24; // kg
+ * const mu_earth = G_SI * M_earth; // ≈ 3.986004e14 m^3/s^2
+ * ```
+ */
+export const G_SI = 6.6743e-11;
+//# sourceMappingURL=physics.js.map

package/dist/physics.js.map

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

package/dist/temporal.d.ts

@@ -6,7 +6,7 @@
  * - **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://www.bipm.org/en/publications/si-brochure (SI Brochure - second & day)
  * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year definition)
  *
  * @example

package/dist/temporal.js

@@ -6,7 +6,7 @@
  * - **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://www.bipm.org/en/publications/si-brochure (SI Brochure - second & day)
  * @see https://en.wikipedia.org/wiki/Julian_year_(astronomy) (Julian year definition)
  *
  * @example
@@ -38,7 +38,7 @@ export const MILLISECONDS_PER_SECOND = 1000;
  * @category Temporal
  */
 export const MILLISECONDS_PER_DAY = SECONDS_PER_DAY * MILLISECONDS_PER_SECOND;
-// Julian year (astronomy) — EXACT 365.25 d
+// Julian year (astronomy) - EXACT 365.25 d
 /**
  *  Length of the **Julian year** in SI days (exactly 365.25).
  * @category Temporal

package/package.json

@@ -1,9 +1,81 @@
 {
   "name": "@interstellar-tools/constants",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "constants",
   "keywords": [
-    "constants"
+    "interstellar",
+    "tools",
+    "near",
+    "earth",
+    "objects",
+    "planets",
+    "orbit",
+    "rotation",
+    "stars",
+    "star",
+    "sun",
+    "planet",
+    "earth",
+    "moon",
+    "mercury",
+    "venus",
+    "mars",
+    "tellus",
+    "gaia",
+    "jupiter",
+    "saturn",
+    "neptune",
+    "pluto",
+    "dwarf",
+    "planets",
+    "trajectory",
+    "asteroids",
+    "comets",
+    "collision",
+    "satellite",
+    "satellites",
+    "sky map",
+    "nasa",
+    "jpl",
+    "esa",
+    "astrodynamics",
+    "orbital-mechanics",
+    "celestial-mechanics",
+    "two-body",
+    "n-body",
+    "gravity",
+    "newtonian-gravity",
+    "newtons-law-of-gravitation",
+    "gravitational-constant",
+    "G_SI",
+    "standard-gravitational-parameter",
+    "gravitational-parameter",
+    "mu",
+    "gravitational-force",
+    "gravitational-acceleration",
+    "specific-mechanical-energy",
+    "vis-viva",
+    "kepler-period",
+    "keplers-third-law",
+    "orbital-speed",
+    "trajectory",
+    "orbit",
+    "satellite",
+    "simulation",
+    "numerics",
+    "si-units",
+    "vector3",
+    "vec3",
+    "vector-math",
+    "typescript",
+    "javascript",
+    "interstellar-tools",
+    "spaceflight",
+    "space-dynamics",
+    "heliocentric",
+    "leo",
+    "geo",
+    "earth-sun"
   ],
   "homepage": "https://phun-ky.net/projects/interstellar-tools",
   "bugs": {