@interstellar-tools/constants 0.5.0 → 0.6.0

package/dist/bodies/stars.js

@@ -0,0 +1,111 @@
+/**
+ * Represents a dataset of well-known stars within the Milky Way.
+ *
+ * ::: info
+ *
+ * - Units: `radius` (km); galactocentric coordinates `x`,`y`,`z` (ly); orbital semi-major axis `a` (ly);
+ *   `period` in million years (Myr); orbital angles are unitless here (radians) if provided.
+ * - `color` is for visualization only.
+ * - Negative `period` may encode integration direction; the table shows raw values.
+ *
+ * :::
+ *
+ * {@include ../../../../docs/partials/stars.md}
+ *
+ * **Example item in dataset:**
+ *
+ * {@includeCode ../bodies/stars.ts#datasetStars}
+ * @group Datasets
+ * @see {@link StarsType}.
+ * @example
+ * ```ts
+ * console.log(STARS[0].name); // "Sun"
+ * ```
+ */
+export const STARS = [
+    // #region datasetStars
+    {
+        name: 'Sun',
+        type: 'G2V', // Yellow Dwarf, Main Sequence
+        category: 'star',
+        system: { name: 'Solar System', type: 'planetary system' },
+        /** Radius in km */
+        radius: { value: 696340, unit: 'km' },
+        /** Visual representation color */
+        color: '#fff5f1',
+        /** Galactic position in light-years (relative to Milky Way center) */
+        x: { value: 0, unit: 'ly' },
+        y: { value: 27000, unit: 'ly' },
+        z: { value: 20, unit: 'ly' },
+        /** Semi-major axis in light-years */
+        a: { value: 27000, unit: 'ly' },
+        /** Orbital eccentricity */
+        e: 0.07,
+        /** Initial angle in orbit */
+        angle: 1.5707963267948966,
+        /** Orbital period in million years (Myr) */
+        period: { value: -230, unit: 'Myr' }
+    },
+    // #endregion datasetStars
+    {
+        name: 'Vega',
+        type: 'A0V', // White-Blue Main Sequence
+        category: 'star',
+        system: { name: 'Lyra', type: 'stellar system' },
+        radius: { value: 2600000, unit: 'km' },
+        color: 'blue',
+        x: { value: 25.3, unit: 'ly' },
+        y: { value: 27230.011753394454, unit: 'ly' },
+        z: { value: 0, unit: 'ly' },
+        e: 0.005,
+        a: { value: 27230.011753394454, unit: 'ly' },
+        angle: 1.569867205171707,
+        period: { value: -480, unit: 'Myr' }
+    },
+    {
+        name: 'Altair',
+        type: 'A7V', // White Main Sequence
+        category: 'star',
+        system: { name: 'Aquila', type: 'stellar system' },
+        radius: { value: 1700000, unit: 'km' },
+        color: 'white',
+        x: { value: 16.7, unit: 'ly' },
+        y: { value: 27050.005155082687, unit: 'ly' },
+        z: { value: 0, unit: 'ly' },
+        e: 0.004,
+        a: { value: 27050.005155082687, unit: 'ly' },
+        angle: 1.5701789517599378,
+        period: { value: -410, unit: 'Myr' }
+    },
+    {
+        name: 'Deneb',
+        type: 'A2Ia', // White-Blue Supergiant
+        category: 'star',
+        system: { name: 'Cygnus', type: 'stellar system' },
+        radius: { value: 108000000, unit: 'km' },
+        color: 'blue-white',
+        x: { value: 2616, unit: 'ly' },
+        y: { value: 27375.280016832705, unit: 'ly' },
+        z: { value: 0, unit: 'ly' },
+        e: 0.009,
+        a: { value: 27375.280016832705, unit: 'ly' },
+        angle: 1.475524958596149,
+        period: { value: -720, unit: 'Myr' }
+    },
+    {
+        name: 'Spica',
+        type: 'B1III-IV', // Blue Giant/Subgiant
+        category: 'star',
+        system: { name: 'Virgo', type: 'stellar system' },
+        radius: { value: 73500000, unit: 'km' },
+        color: 'blue',
+        x: { value: 250, unit: 'ly' },
+        y: { value: 27201.148872795795, unit: 'ly' },
+        z: { value: 0, unit: 'ly' },
+        e: 0.006,
+        a: { value: 27201.148872795795, unit: 'ly' },
+        angle: 1.5616057972952029,
+        period: { value: -550, unit: 'Myr' }
+    }
+];
+//# sourceMappingURL=stars.js.map

package/dist/bodies/stars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stars.js","sourceRoot":"","sources":["../../src/bodies/stars.ts"],"names":[],"mappings":"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"}

package/dist/bodies/systems.d.ts

@@ -0,0 +1,27 @@
+import { SystemsType } from '@interstellar-tools/types';
+/**
+ * Predefined star systems in the galaxy.
+ *
+ * ::: info
+ *
+ * - `distance` is in light-years (ly).
+ * - `stars` lists the primary named stars in the system (referenced by name).
+ *
+ * :::
+ *
+ * {@include ../../../../docs/partials/systems.md}
+ *
+ * **Example item in dataset:**
+ *
+ * {@includeCode ../bodies/systems.ts#datasetSystems}
+ *
+ * @example
+ * ```ts
+ * console.log(SYSTEMS[0].name); // "Solar System"
+ * ```
+ * @group Datasets
+ * @see {@link SystemsType}
+ * @see https://en.wikipedia.org/wiki/Alpha_Centauri
+ */
+export declare const SYSTEMS: SystemsType;
+//# sourceMappingURL=systems.d.ts.map

package/dist/bodies/systems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systems.d.ts","sourceRoot":"","sources":["../../src/bodies/systems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,OAAO,EAAE,WAaU,CAAC"}

package/dist/bodies/systems.js

@@ -0,0 +1,39 @@
+/**
+ * Predefined star systems in the galaxy.
+ *
+ * ::: info
+ *
+ * - `distance` is in light-years (ly).
+ * - `stars` lists the primary named stars in the system (referenced by name).
+ *
+ * :::
+ *
+ * {@include ../../../../docs/partials/systems.md}
+ *
+ * **Example item in dataset:**
+ *
+ * {@includeCode ../bodies/systems.ts#datasetSystems}
+ *
+ * @example
+ * ```ts
+ * console.log(SYSTEMS[0].name); // "Solar System"
+ * ```
+ * @group Datasets
+ * @see {@link SystemsType}
+ * @see https://en.wikipedia.org/wiki/Alpha_Centauri
+ */
+export const SYSTEMS = [
+    {
+        name: 'Solar System',
+        stars: ['Sun'],
+        distance: 0
+    },
+    // #region datasetSystems
+    {
+        name: 'Alpha Centauri',
+        stars: ['Alpha Centauri A', 'Alpha Centauri B', 'Proxima Centauri'],
+        distance: 4.37
+    }
+    // #endregion datasetSystems
+];
+//# sourceMappingURL=systems.js.map

package/dist/bodies/systems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systems.js","sourceRoot":"","sources":["../../src/bodies/systems.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,CAAC,KAAK,CAAC;QACd,QAAQ,EAAE,CAAC;KACZ;IACD,yBAAyB;IACzB;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;QACnE,QAAQ,EAAE,IAAI;KACf;IACD,4BAA4B;CACE,CAAC"}

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export * from './math';
 export * from './objects';
 export * from './temporal';
 export * from './physics';
+export * from './bodies';
 //# 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;AAE3B,cAAc,WAAW,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;AAE1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -9,4 +9,5 @@ export * from './math';
 export * from './objects';
 export * from './temporal';
 export * from './physics';
+export * from './bodies';
 //# 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;AAE3B,cAAc,WAAW,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;AAE1B,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interstellar-tools/constants",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Authoritative physical and astronomical constants in SI units for consistent calculations.",
   "keywords": [
     "interstellar",
@@ -108,6 +108,9 @@
     "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\""
   },
+  "dependencies": {
+    "@interstellar-tools/types": "^0.5.0"
+  },
   "devDependencies": {
     "@types/node": "^24.0.3",
     "eslint": "^9.27.0",