astraeus 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (407) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/LICENSE +21 -0
  3. package/NOTICE +14 -0
  4. package/README.md +108 -2
  5. package/data/ephemerides/planets/planets.json +1 -0
  6. package/data/moons/jupiter.json +3097 -0
  7. package/data/moons/neptune.json +517 -0
  8. package/data/moons/pluto.json +189 -0
  9. package/data/moons/saturn.json +7677 -0
  10. package/data/moons/uranus.json +825 -0
  11. package/data/orbits/callisto.json +192 -0
  12. package/data/orbits/charon.json +96 -0
  13. package/data/orbits/dione.json +102 -0
  14. package/data/orbits/enceladus.json +102 -0
  15. package/data/orbits/europa.json +189 -0
  16. package/data/orbits/ganymede.json +186 -0
  17. package/data/orbits/iapetus.json +102 -0
  18. package/data/orbits/io.json +181 -0
  19. package/data/orbits/mimas.json +170 -0
  20. package/data/orbits/rhea.json +170 -0
  21. package/data/orbits/tethys.json +170 -0
  22. package/data/orbits/titan.json +170 -0
  23. package/data/orbits/triton.json +230 -0
  24. package/data/rings/jupiter.json +24 -0
  25. package/data/rings/neptune.json +73 -0
  26. package/data/rings/saturn.json +69 -0
  27. package/data/rings/uranus.json +80 -0
  28. package/licenses/ERFA.txt +50 -0
  29. package/licenses/orbjs-MIT.txt +21 -0
  30. package/licenses/python-sgp4.txt +20 -0
  31. package/package.json +45 -4
  32. package/src/api/bodies.d.ts +40 -0
  33. package/src/api/bodies.js +35 -0
  34. package/src/api/data.d.ts +24 -0
  35. package/src/api/data.js +34 -0
  36. package/src/api/errors.d.ts +7 -0
  37. package/src/api/errors.js +9 -0
  38. package/src/api/index.d.ts +8 -0
  39. package/src/api/index.js +6 -0
  40. package/src/api/mount.d.ts +15 -0
  41. package/src/api/mount.js +26 -0
  42. package/src/api/scene.d.ts +76 -0
  43. package/src/api/scene.js +194 -0
  44. package/src/app/AnchorLabels.d.ts +17 -0
  45. package/src/app/AnchorLabels.js +46 -0
  46. package/src/app/App.d.ts +13 -0
  47. package/src/app/App.js +379 -0
  48. package/src/app/AstraeusScene.d.ts +133 -0
  49. package/src/app/AstraeusScene.js +47 -0
  50. package/src/app/AtmosphereGlow.d.ts +6 -0
  51. package/src/app/AtmosphereGlow.js +38 -0
  52. package/src/app/BodyMesh.d.ts +14 -0
  53. package/src/app/BodyMesh.js +20 -0
  54. package/src/app/BodySetLabels.d.ts +17 -0
  55. package/src/app/BodySetLabels.js +98 -0
  56. package/src/app/BodySetView.d.ts +50 -0
  57. package/src/app/BodySetView.js +206 -0
  58. package/src/app/BodyView.d.ts +37 -0
  59. package/src/app/BodyView.js +58 -0
  60. package/src/app/CameraController.d.ts +51 -0
  61. package/src/app/CameraController.js +163 -0
  62. package/src/app/DebugOverlay.d.ts +58 -0
  63. package/src/app/DebugOverlay.js +72 -0
  64. package/src/app/DeveloperSettings.d.ts +80 -0
  65. package/src/app/DeveloperSettings.js +40 -0
  66. package/src/app/FeatureMarkers.d.ts +76 -0
  67. package/src/app/FeatureMarkers.js +205 -0
  68. package/src/app/FrameRateSection.d.ts +16 -0
  69. package/src/app/FrameRateSection.js +35 -0
  70. package/src/app/KeplerPoints.d.ts +18 -0
  71. package/src/app/KeplerPoints.js +64 -0
  72. package/src/app/LayeredRender.d.ts +14 -0
  73. package/src/app/LayeredRender.js +35 -0
  74. package/src/app/OrbitSetView.d.ts +65 -0
  75. package/src/app/OrbitSetView.js +519 -0
  76. package/src/app/PathView.d.ts +135 -0
  77. package/src/app/PathView.js +574 -0
  78. package/src/app/PointsView.d.ts +103 -0
  79. package/src/app/PointsView.js +552 -0
  80. package/src/app/RingView.d.ts +34 -0
  81. package/src/app/RingView.js +96 -0
  82. package/src/app/SceneLabels.d.ts +22 -0
  83. package/src/app/SceneLabels.js +81 -0
  84. package/src/app/SettingControls.d.ts +32 -0
  85. package/src/app/SettingControls.js +19 -0
  86. package/src/app/SkyView.d.ts +63 -0
  87. package/src/app/SkyView.js +237 -0
  88. package/src/app/StoryMarkers.d.ts +38 -0
  89. package/src/app/StoryMarkers.js +81 -0
  90. package/src/app/TrackedBodyView.d.ts +36 -0
  91. package/src/app/TrackedBodyView.js +175 -0
  92. package/src/app/addressNavigation.d.ts +17 -0
  93. package/src/app/addressNavigation.js +16 -0
  94. package/src/app/bodyDraw.d.ts +118 -0
  95. package/src/app/bodyDraw.js +171 -0
  96. package/src/app/bodyMetrics.d.ts +19 -0
  97. package/src/app/bodyMetrics.js +85 -0
  98. package/src/app/bodySet.d.ts +113 -0
  99. package/src/app/bodySet.js +79 -0
  100. package/src/app/catalogueItem.d.ts +9 -0
  101. package/src/app/catalogueItem.js +17 -0
  102. package/src/app/ephemerisProvenance.d.ts +2 -0
  103. package/src/app/ephemerisProvenance.js +1 -0
  104. package/src/app/experienceDefinition.d.ts +265 -0
  105. package/src/app/experienceDefinition.js +257 -0
  106. package/src/app/floatingOrigin.d.ts +14 -0
  107. package/src/app/floatingOrigin.js +32 -0
  108. package/src/app/frameStats.d.ts +28 -0
  109. package/src/app/frameStats.js +68 -0
  110. package/src/app/keplerShader.d.ts +45 -0
  111. package/src/app/keplerShader.js +112 -0
  112. package/src/app/lighting.d.ts +9 -0
  113. package/src/app/lighting.js +24 -0
  114. package/src/app/metricReadouts.d.ts +10 -0
  115. package/src/app/metricReadouts.js +67 -0
  116. package/src/app/mission.d.ts +78 -0
  117. package/src/app/mission.js +80 -0
  118. package/src/app/pathRules.d.ts +52 -0
  119. package/src/app/pathRules.js +104 -0
  120. package/src/app/planetNeeds.d.ts +3 -0
  121. package/src/app/planetNeeds.js +6 -0
  122. package/src/app/renderCoordinates.d.ts +13 -0
  123. package/src/app/renderCoordinates.js +14 -0
  124. package/src/app/sceneBodies.d.ts +42 -0
  125. package/src/app/sceneBodies.js +58 -0
  126. package/src/app/sceneBodySets.d.ts +5 -0
  127. package/src/app/sceneBodySets.js +45 -0
  128. package/src/app/sceneCamera.d.ts +34 -0
  129. package/src/app/sceneCamera.js +110 -0
  130. package/src/app/sceneContentsHooks.d.ts +102 -0
  131. package/src/app/sceneContentsHooks.js +127 -0
  132. package/src/app/sceneDebug.d.ts +55 -0
  133. package/src/app/sceneDebug.js +76 -0
  134. package/src/app/sceneFrame.d.ts +175 -0
  135. package/src/app/sceneFrame.js +272 -0
  136. package/src/app/sceneFraming.d.ts +57 -0
  137. package/src/app/sceneFraming.js +99 -0
  138. package/src/app/sceneHooks.d.ts +28 -0
  139. package/src/app/sceneHooks.js +68 -0
  140. package/src/app/sceneLayout.d.ts +59 -0
  141. package/src/app/sceneLayout.js +97 -0
  142. package/src/app/sceneLights.d.ts +13 -0
  143. package/src/app/sceneLights.js +13 -0
  144. package/src/app/scenePicking.d.ts +97 -0
  145. package/src/app/scenePicking.js +102 -0
  146. package/src/app/scenePointer.d.ts +15 -0
  147. package/src/app/scenePointer.js +35 -0
  148. package/src/app/sceneSky.d.ts +9 -0
  149. package/src/app/sceneSky.js +17 -0
  150. package/src/app/sceneTargets.d.ts +34 -0
  151. package/src/app/sceneTargets.js +58 -0
  152. package/src/app/skyModel.d.ts +62 -0
  153. package/src/app/skyModel.js +114 -0
  154. package/src/app/style.css +206 -0
  155. package/src/app/useBodyTexture.d.ts +2 -0
  156. package/src/app/useBodyTexture.js +25 -0
  157. package/src/app/viewLink.d.ts +48 -0
  158. package/src/app/viewLink.js +117 -0
  159. package/src/app/viewUp.d.ts +24 -0
  160. package/src/app/viewUp.js +36 -0
  161. package/src/assets/bodies/earth.d.ts +18 -0
  162. package/src/assets/bodies/earth.js +33 -0
  163. package/src/assets/bodies/galileanMoons.d.ts +9 -0
  164. package/src/assets/bodies/galileanMoons.js +18 -0
  165. package/src/assets/bodies/io.d.ts +9 -0
  166. package/src/assets/bodies/io.js +12 -0
  167. package/src/assets/bodies/jupiter.d.ts +19 -0
  168. package/src/assets/bodies/jupiter.js +33 -0
  169. package/src/assets/bodies/jupiterMoonCatalogue.d.ts +3 -0
  170. package/src/assets/bodies/jupiterMoonCatalogue.js +4 -0
  171. package/src/assets/bodies/jupiterRings.d.ts +3 -0
  172. package/src/assets/bodies/jupiterRings.js +4 -0
  173. package/src/assets/bodies/mars.d.ts +15 -0
  174. package/src/assets/bodies/mars.js +29 -0
  175. package/src/assets/bodies/mercury.d.ts +15 -0
  176. package/src/assets/bodies/mercury.js +29 -0
  177. package/src/assets/bodies/moon.d.ts +16 -0
  178. package/src/assets/bodies/moon.js +30 -0
  179. package/src/assets/bodies/outerPlanetCatalogues.d.ts +11 -0
  180. package/src/assets/bodies/outerPlanetCatalogues.js +12 -0
  181. package/src/assets/bodies/planetSystemMaps.d.ts +18 -0
  182. package/src/assets/bodies/planetSystemMaps.js +65 -0
  183. package/src/assets/bodies/sun.d.ts +21 -0
  184. package/src/assets/bodies/sun.js +32 -0
  185. package/src/assets/bodies/swiftTuttle.d.ts +12 -0
  186. package/src/assets/bodies/swiftTuttle.js +13 -0
  187. package/src/assets/bodies/venus.d.ts +20 -0
  188. package/src/assets/bodies/venus.js +37 -0
  189. package/src/assets/catalogue.d.ts +37 -0
  190. package/src/assets/catalogue.js +106 -0
  191. package/src/assets/compositions.d.ts +52 -0
  192. package/src/assets/compositions.js +91 -0
  193. package/src/assets/licence.d.ts +44 -0
  194. package/src/assets/licence.js +20 -0
  195. package/src/assets/moonCatalogue.d.ts +47 -0
  196. package/src/assets/moonCatalogue.js +79 -0
  197. package/src/assets/orbitLook.d.ts +94 -0
  198. package/src/assets/orbitLook.js +46 -0
  199. package/src/assets/pictures.d.ts +17 -0
  200. package/src/assets/pictures.js +23 -0
  201. package/src/assets/rings.d.ts +31 -0
  202. package/src/assets/rings.js +45 -0
  203. package/src/assets/sky.d.ts +91 -0
  204. package/src/assets/sky.js +139 -0
  205. package/src/assets/stars/hyg-v42-naked-eye.json +1 -0
  206. package/src/assets/textures/earth-bmng-july-4k.jpg +0 -0
  207. package/src/assets/textures/jupiter-2k.jpg +0 -0
  208. package/src/assets/textures/mars-2k.jpg +0 -0
  209. package/src/assets/textures/mercury-2k.jpg +0 -0
  210. package/src/assets/textures/moon-lroc-2k.jpg +0 -0
  211. package/src/assets/textures/neptune-2k.jpg +0 -0
  212. package/src/assets/textures/saturn-2k.jpg +0 -0
  213. package/src/assets/textures/sun-2k.jpg +0 -0
  214. package/src/assets/textures/uranus-2k.jpg +0 -0
  215. package/src/assets/textures/venus-2k-balanced.jpg +0 -0
  216. package/src/assets/visual.d.ts +56 -0
  217. package/src/assets/visual.js +1 -0
  218. package/src/core/astronomyAdapter.d.ts +13 -0
  219. package/src/core/astronomyAdapter.js +88 -0
  220. package/src/core/bodies/earth.d.ts +7 -0
  221. package/src/core/bodies/earth.js +38 -0
  222. package/src/core/bodies/index.d.ts +16 -0
  223. package/src/core/bodies/index.js +45 -0
  224. package/src/core/bodies/io.d.ts +54 -0
  225. package/src/core/bodies/io.js +120 -0
  226. package/src/core/bodies/jupiter.d.ts +8 -0
  227. package/src/core/bodies/jupiter.js +40 -0
  228. package/src/core/bodies/jupiterData.d.ts +2 -0
  229. package/src/core/bodies/jupiterData.js +9 -0
  230. package/src/core/bodies/jupiterMoons.d.ts +31 -0
  231. package/src/core/bodies/jupiterMoons.js +44 -0
  232. package/src/core/bodies/mars.d.ts +6 -0
  233. package/src/core/bodies/mars.js +34 -0
  234. package/src/core/bodies/mercury.d.ts +6 -0
  235. package/src/core/bodies/mercury.js +32 -0
  236. package/src/core/bodies/moon.d.ts +3 -0
  237. package/src/core/bodies/moon.js +36 -0
  238. package/src/core/bodies/moonSystem.d.ts +98 -0
  239. package/src/core/bodies/moonSystem.js +151 -0
  240. package/src/core/bodies/outerPlanetData.d.ts +7 -0
  241. package/src/core/bodies/outerPlanetData.js +19 -0
  242. package/src/core/bodies/outerPlanets.d.ts +23 -0
  243. package/src/core/bodies/outerPlanets.js +68 -0
  244. package/src/core/bodies/planetMoons.d.ts +28 -0
  245. package/src/core/bodies/planetMoons.js +86 -0
  246. package/src/core/bodies/planetRecords.d.ts +8 -0
  247. package/src/core/bodies/planetRecords.js +19 -0
  248. package/src/core/bodies/planetTrajectory.d.ts +10 -0
  249. package/src/core/bodies/planetTrajectory.js +31 -0
  250. package/src/core/bodies/sun.d.ts +3 -0
  251. package/src/core/bodies/sun.js +25 -0
  252. package/src/core/bodies/swiftTuttle.d.ts +46 -0
  253. package/src/core/bodies/swiftTuttle.js +104 -0
  254. package/src/core/bodies/venus.d.ts +6 -0
  255. package/src/core/bodies/venus.js +34 -0
  256. package/src/core/body.d.ts +45 -0
  257. package/src/core/body.js +8 -0
  258. package/src/core/bodyOrientation.d.ts +8 -0
  259. package/src/core/bodyOrientation.js +92 -0
  260. package/src/core/chebyshev.d.ts +12 -0
  261. package/src/core/chebyshev.js +38 -0
  262. package/src/core/chebyshevEphemeris.d.ts +93 -0
  263. package/src/core/chebyshevEphemeris.js +344 -0
  264. package/src/core/chebyshevSeries.d.ts +30 -0
  265. package/src/core/chebyshevSeries.js +89 -0
  266. package/src/core/clock.d.ts +28 -0
  267. package/src/core/clock.js +98 -0
  268. package/src/core/elementsBody.d.ts +94 -0
  269. package/src/core/elementsBody.js +201 -0
  270. package/src/core/ephemerisGroup.d.ts +36 -0
  271. package/src/core/ephemerisGroup.js +51 -0
  272. package/src/core/events.d.ts +9 -0
  273. package/src/core/events.js +18 -0
  274. package/src/core/fieldReaders.d.ts +14 -0
  275. package/src/core/fieldReaders.js +32 -0
  276. package/src/core/iauRotation.d.ts +59 -0
  277. package/src/core/iauRotation.js +72 -0
  278. package/src/core/illumination.d.ts +9 -0
  279. package/src/core/illumination.js +54 -0
  280. package/src/core/keplerAnomaly.d.ts +2 -0
  281. package/src/core/keplerAnomaly.js +8 -0
  282. package/src/core/keplerElements.d.ts +35 -0
  283. package/src/core/keplerElements.js +87 -0
  284. package/src/core/listedOrbitGroup.d.ts +64 -0
  285. package/src/core/listedOrbitGroup.js +221 -0
  286. package/src/core/moonTrajectory.d.ts +11 -0
  287. package/src/core/moonTrajectory.js +28 -0
  288. package/src/core/orbitGroup.d.ts +41 -0
  289. package/src/core/orbitGroup.js +141 -0
  290. package/src/core/orbitPeriod.d.ts +25 -0
  291. package/src/core/orbitPeriod.js +58 -0
  292. package/src/core/planetModels.d.ts +7 -0
  293. package/src/core/planetModels.js +43 -0
  294. package/src/core/planetSeries.d.ts +26 -0
  295. package/src/core/planetSeries.js +22 -0
  296. package/src/core/pointGroup.d.ts +51 -0
  297. package/src/core/pointGroup.js +49 -0
  298. package/src/core/provenance.d.ts +9 -0
  299. package/src/core/provenance.js +14 -0
  300. package/src/core/referenceCenters.d.ts +6 -0
  301. package/src/core/referenceCenters.js +55 -0
  302. package/src/core/sampledTrajectory.d.ts +28 -0
  303. package/src/core/sampledTrajectory.js +127 -0
  304. package/src/core/satelliteMeanElements.d.ts +78 -0
  305. package/src/core/satelliteMeanElements.js +81 -0
  306. package/src/core/scalePolicy.d.ts +44 -0
  307. package/src/core/scalePolicy.js +58 -0
  308. package/src/core/state.d.ts +30 -0
  309. package/src/core/state.js +66 -0
  310. package/src/core/stateResolver.d.ts +16 -0
  311. package/src/core/stateResolver.js +126 -0
  312. package/src/core/sunCentredSources.d.ts +61 -0
  313. package/src/core/sunCentredSources.js +179 -0
  314. package/src/core/timeScale.d.ts +28 -0
  315. package/src/core/timeScale.js +81 -0
  316. package/src/core/timeWindow.d.ts +33 -0
  317. package/src/core/timeWindow.js +112 -0
  318. package/src/core/trajectory.d.ts +13 -0
  319. package/src/core/trajectory.js +1 -0
  320. package/src/core/twoBodyAdapter.d.ts +30 -0
  321. package/src/core/twoBodyAdapter.js +45 -0
  322. package/src/experiences/apollo11/spacecraftMetrics.d.ts +34 -0
  323. package/src/experiences/apollo11/spacecraftMetrics.js +142 -0
  324. package/src/experiences/settingsFields.d.ts +8 -0
  325. package/src/experiences/settingsFields.js +12 -0
  326. package/src/experiences/showers/showerChoice.d.ts +25 -0
  327. package/src/experiences/showers/showerChoice.js +19 -0
  328. package/src/shell/AstraeusShell.d.ts +66 -0
  329. package/src/shell/AstraeusShell.js +223 -0
  330. package/src/shell/Collapsible.d.ts +23 -0
  331. package/src/shell/Collapsible.js +43 -0
  332. package/src/shell/ControlsDrawer.d.ts +16 -0
  333. package/src/shell/ControlsDrawer.js +18 -0
  334. package/src/shell/InfoPanel.d.ts +13 -0
  335. package/src/shell/InfoPanel.js +20 -0
  336. package/src/shell/Label.d.ts +10 -0
  337. package/src/shell/Label.js +15 -0
  338. package/src/shell/MetricVisual.d.ts +5 -0
  339. package/src/shell/MetricVisual.js +114 -0
  340. package/src/shell/MoonFamilyPanel.d.ts +16 -0
  341. package/src/shell/MoonFamilyPanel.js +28 -0
  342. package/src/shell/ObjectControls.d.ts +13 -0
  343. package/src/shell/ObjectControls.js +18 -0
  344. package/src/shell/ProvenanceBadge.d.ts +5 -0
  345. package/src/shell/ProvenanceBadge.js +9 -0
  346. package/src/shell/ScaleControl.d.ts +14 -0
  347. package/src/shell/ScaleControl.js +99 -0
  348. package/src/shell/Sources.d.ts +9 -0
  349. package/src/shell/Sources.js +9 -0
  350. package/src/shell/StoryPanelView.d.ts +18 -0
  351. package/src/shell/StoryPanelView.js +24 -0
  352. package/src/shell/SwitchControl.d.ts +24 -0
  353. package/src/shell/SwitchControl.js +26 -0
  354. package/src/shell/TimelineBar.css +120 -0
  355. package/src/shell/TimelineBar.d.ts +48 -0
  356. package/src/shell/TimelineBar.js +76 -0
  357. package/src/shell/TopBar.css +74 -0
  358. package/src/shell/TopBar.d.ts +28 -0
  359. package/src/shell/TopBar.js +14 -0
  360. package/src/shell/bodyFeatures.d.ts +51 -0
  361. package/src/shell/bodyFeatures.js +24 -0
  362. package/src/shell/bootLoader.d.ts +17 -0
  363. package/src/shell/bootLoader.js +73 -0
  364. package/src/shell/controls.css +108 -0
  365. package/src/shell/embedded.css +36 -0
  366. package/src/shell/embedded.d.ts +2 -0
  367. package/src/shell/embedded.js +15 -0
  368. package/src/shell/experience.d.ts +72 -0
  369. package/src/shell/experience.js +1 -0
  370. package/src/shell/infoModel.d.ts +43 -0
  371. package/src/shell/infoModel.js +80 -0
  372. package/src/shell/metrics.d.ts +202 -0
  373. package/src/shell/metrics.js +224 -0
  374. package/src/shell/moonFamilies.d.ts +51 -0
  375. package/src/shell/moonFamilies.js +34 -0
  376. package/src/shell/objectModel.d.ts +18 -0
  377. package/src/shell/objectModel.js +34 -0
  378. package/src/shell/phone.css +179 -0
  379. package/src/shell/phoneLayout.d.ts +29 -0
  380. package/src/shell/phoneLayout.js +48 -0
  381. package/src/shell/scaleModel.d.ts +16 -0
  382. package/src/shell/scaleModel.js +42 -0
  383. package/src/shell/storyPanels.d.ts +69 -0
  384. package/src/shell/storyPanels.js +134 -0
  385. package/src/shell/style.css +378 -0
  386. package/src/shell/timelineGlow.d.ts +43 -0
  387. package/src/shell/timelineGlow.js +86 -0
  388. package/src/shell/timelineModel.d.ts +65 -0
  389. package/src/shell/timelineModel.js +153 -0
  390. package/src/shell/topBarIcons.d.ts +13 -0
  391. package/src/shell/topBarIcons.js +15 -0
  392. package/src/shell/useDrawerSwipe.d.ts +22 -0
  393. package/src/shell/useDrawerSwipe.js +35 -0
  394. package/src/shell/useDrawers.d.ts +11 -0
  395. package/src/shell/useDrawers.js +29 -0
  396. package/src/shell/useStoryPanels.d.ts +19 -0
  397. package/src/shell/useStoryPanels.js +55 -0
  398. package/src/shell/useSwipeToDismiss.d.ts +6 -0
  399. package/src/shell/useSwipeToDismiss.js +46 -0
  400. package/src/synthetic/syntheticDefinition.d.ts +5 -0
  401. package/src/synthetic/syntheticDefinition.js +183 -0
  402. package/src/synthetic/syntheticEccentricDefinition.d.ts +18 -0
  403. package/src/synthetic/syntheticEccentricDefinition.js +50 -0
  404. package/src/synthetic/syntheticListedDefinition.d.ts +20 -0
  405. package/src/synthetic/syntheticListedDefinition.js +135 -0
  406. package/src/synthetic/syntheticRingDefinition.d.ts +20 -0
  407. package/src/synthetic/syntheticRingDefinition.js +215 -0
Binary file
Binary file
@@ -0,0 +1,56 @@
1
+ import type { TextureRef } from "./licence.js";
2
+ import type { RingSystem } from "./rings.js";
3
+ export interface BodyMaterialConfig {
4
+ readonly color: string;
5
+ readonly roughness: number;
6
+ readonly metalness: number;
7
+ /** Self-light added to the lit colour; both or neither. */
8
+ readonly emissive?: string;
9
+ readonly emissiveIntensity?: number;
10
+ }
11
+ export interface AtmosphereConfig {
12
+ readonly color: string;
13
+ readonly intensity?: number;
14
+ readonly power?: number;
15
+ readonly scale?: number;
16
+ }
17
+ /**
18
+ * How a body looks. Appearance only: it never feeds position, orientation or any metric.
19
+ * A sphere is drawn at its mapped mean radius, or as a spheroid when the definition carries
20
+ * both an equatorial and a polar radius.
21
+ */
22
+ export interface BodyVisual {
23
+ /** A star at interplanetary distance is a marker until a star renderer exists. */
24
+ readonly kind: "sphere" | "marker";
25
+ /** Sphere only; absent means a flat colour from the material. */
26
+ readonly texture?: TextureRef;
27
+ readonly material: BodyMaterialConfig;
28
+ /** Presentation-only yaw about the body's pole, aligning the image to the body-fixed axes. */
29
+ readonly textureYawRad?: number;
30
+ readonly atmosphere?: AtmosphereConfig;
31
+ /**
32
+ * Draw a self-bright (unlit) sphere at the body's drawn radius as well, so a star reads as a body when it is close and as its marker
33
+ * and glow when it is not. Appearance only.
34
+ */
35
+ readonly emissive?: boolean;
36
+ /**
37
+ * A soft halo drawn round the body on top of everything else in the scene, so it reads at any zoom, even among a dense group of dots.
38
+ * `sizePx` is its least width on screen, `brightness` its strength (0 to 2) and `scale` (default 2.5) how many times the body's projected diameter it spans at least, so close up it frames the disc; the viewer can change all three live. A body with a halo draws no marker dot: the halo is its marker.
39
+ */
40
+ readonly glow?: {
41
+ readonly sizePx: number;
42
+ readonly brightness: number;
43
+ readonly scale?: number;
44
+ };
45
+ /** Marker kind: the screen size of the dot. */
46
+ readonly marker?: {
47
+ readonly sizePx: number;
48
+ };
49
+ /** Flat ring bands in the body's equator plane, at their real radii; an experience opts in through its visual overrides. */
50
+ readonly rings?: RingSystem;
51
+ /** This body's own lights in its render pass. */
52
+ readonly light?: {
53
+ readonly ambient: number;
54
+ readonly directional: number;
55
+ };
56
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,13 @@
1
+ import { type PlanetId } from "./planetSeries.js";
2
+ export type { PlanetId };
3
+ export interface AstronomyAdapter {
4
+ moonPositionKm(timeUtcMs: number): Float64Array;
5
+ earthPositionFromSunKm(timeUtcMs: number): Float64Array;
6
+ sunPositionFromEarthKm(timeUtcMs: number): Float64Array;
7
+ earthFixedToEqjMatrix(timeUtcMs: number): Float64Array;
8
+ /** Planet position about the Sun in EQJ km (VSOP87A); throws for a planet the adapter has no model for. */
9
+ planetPositionFromSunKm(planet: PlanetId, timeUtcMs: number): Float64Array;
10
+ /** Days of terrestrial time since J2000 (JD 2451545.0 TT), the epoch the IAU rotation models count from. */
11
+ daysSinceJ2000Tt(timeUtcMs: number): number;
12
+ }
13
+ export declare function createOrbAstronomyAdapter(): AstronomyAdapter;
@@ -0,0 +1,88 @@
1
+ import { Luna } from "@lizard-isana/orb/src/orb-luna.js";
2
+ import { transformationMatrix, transform, makeState } from "@lizard-isana/orb/frames";
3
+ import { AstroInstant } from "@lizard-isana/orb/time";
4
+ import { earthEpv00, sunEpv00 } from "@lizard-isana/orb/models/earth-epv00";
5
+ import { assertUtcUnixMs } from "./state.js";
6
+ import { isPlanetId, planetModels } from "./planetSeries.js";
7
+ const AU_KM = 149_597_870.7;
8
+ const J2000_TT_JD = 2_451_545.0;
9
+ function instantAt(timeUtcMs) {
10
+ assertUtcUnixMs(timeUtcMs);
11
+ return AstroInstant.fromUnixMs(timeUtcMs);
12
+ }
13
+ function finiteVector(values, label) {
14
+ const result = Float64Array.from(values);
15
+ if (result.length !== 3 || [...result].some((component) => !Number.isFinite(component))) {
16
+ throw new TypeError(`${label} provider returned an invalid vector`);
17
+ }
18
+ return result;
19
+ }
20
+ export function createOrbAstronomyAdapter() {
21
+ const moon = new Luna();
22
+ return Object.freeze({
23
+ moonPositionKm(timeUtcMs) {
24
+ const instant = instantAt(timeUtcMs);
25
+ const date = new Date(timeUtcMs);
26
+ const ecliptic = moon.xyz(date);
27
+ if (ecliptic.coordinate_keywords !== "ecliptic rectangular"
28
+ || ecliptic.center_keywords !== "earth"
29
+ || ecliptic.unit_keywords !== "km") {
30
+ throw new TypeError("Orb lunar result changed its documented Earth-centered km contract");
31
+ }
32
+ const state = makeState({
33
+ t: instant,
34
+ frame: "ecliptic-of-date",
35
+ center: "earth",
36
+ r: [ecliptic.x, ecliptic.y, ecliptic.z],
37
+ });
38
+ const eqj = transform(state, { frame: "equatorial-j2000" });
39
+ if (eqj.center !== "earth")
40
+ throw new TypeError("Orb lunar transform changed its center");
41
+ return finiteVector(eqj.r, "Moon");
42
+ },
43
+ earthPositionFromSunKm(timeUtcMs) {
44
+ const state = earthEpv00.state(instantAt(timeUtcMs));
45
+ if (state.frame !== "equatorial-j2000" || state.center !== "sun") {
46
+ throw new TypeError("Orb Earth EPV00 result changed its EQJ/Sun-centered contract");
47
+ }
48
+ return finiteVector(state.r, "Earth EPV00");
49
+ },
50
+ sunPositionFromEarthKm(timeUtcMs) {
51
+ const state = sunEpv00.state(instantAt(timeUtcMs));
52
+ if (state.frame !== "equatorial-j2000" || state.center !== "earth") {
53
+ throw new TypeError("Orb Sun EPV00 result changed its EQJ/Earth-centered contract");
54
+ }
55
+ return finiteVector(state.r, "Sun EPV00");
56
+ },
57
+ planetPositionFromSunKm(planet, timeUtcMs) {
58
+ const instant = instantAt(timeUtcMs);
59
+ if (!isPlanetId(planet))
60
+ throw new RangeError(`the astronomy adapter has no model for planet "${planet}"`);
61
+ const model = planetModels()[planet];
62
+ const ecliptic = model.xyz(new Date(timeUtcMs));
63
+ if (ecliptic.coordinate_keywords !== "ecliptic rectangular j2000" || ecliptic.unit_keywords !== "au") {
64
+ throw new TypeError("Orb VSOP87A result changed its heliocentric ecliptic-J2000 au contract");
65
+ }
66
+ const state = makeState({
67
+ t: instant,
68
+ frame: "ecliptic-j2000",
69
+ center: "sun",
70
+ r: [ecliptic.x * AU_KM, ecliptic.y * AU_KM, ecliptic.z * AU_KM],
71
+ });
72
+ const eqj = transform(state, { frame: "equatorial-j2000" });
73
+ if (eqj.center !== "sun")
74
+ throw new TypeError("Orb VSOP87A transform changed its center");
75
+ return finiteVector(eqj.r, `${planet} VSOP87A`);
76
+ },
77
+ daysSinceJ2000Tt(timeUtcMs) {
78
+ const [jd1, jd2] = instantAt(timeUtcMs).jd2parts("tt");
79
+ const days = (jd1 - J2000_TT_JD) + jd2;
80
+ if (!Number.isFinite(days))
81
+ throw new TypeError("Orb terrestrial time conversion returned a non-finite value");
82
+ return days;
83
+ },
84
+ earthFixedToEqjMatrix(timeUtcMs) {
85
+ return Float64Array.from(transformationMatrix("ecef", "equatorial-j2000", instantAt(timeUtcMs)));
86
+ },
87
+ });
88
+ }
@@ -0,0 +1,7 @@
1
+ import type { CelestialBodyDefinition, EphemerisRecord } from "../body.js";
2
+ /**
3
+ * Provenance for the engine's own Earth, the ephemeris equivalent of a trajectory's Provenance.
4
+ * The measured sample residuals live in docs/ASTRONOMY_VALIDATION.md and are not repeated here.
5
+ */
6
+ export declare const EARTH_EPHEMERIS: EphemerisRecord;
7
+ export declare const EARTH: CelestialBodyDefinition;
@@ -0,0 +1,38 @@
1
+ import { createProvenance } from "../provenance.js";
2
+ /**
3
+ * Provenance for the engine's own Earth, the ephemeris equivalent of a trajectory's Provenance.
4
+ * The measured sample residuals live in docs/ASTRONOMY_VALIDATION.md and are not repeated here.
5
+ */
6
+ export const EARTH_EPHEMERIS = {
7
+ provenance: createProvenance({
8
+ sourceType: "ephemeris",
9
+ sources: [
10
+ "@lizard-isana/orb 3.1.1 frames: IAU 2006 precession, IAU 2000B nutation, IAU 1982 Greenwich sidereal time",
11
+ "@lizard-isana/orb EPV00 model (ERFA, fitted to JPL DE405) for Earth–Sun geometry",
12
+ ],
13
+ accuracy: "Its rotation follows the IAU models listed. The Sun direction was checked against JPL Horizons (DE441) samples; the sample maxima are not a guaranteed bound for every date.",
14
+ notes: "Body size is the volumetric mean radius (NASA NSSDC fact sheet).",
15
+ }),
16
+ knownLimitations: ["Earth's orientation leaves out polar motion."],
17
+ };
18
+ export const EARTH = Object.freeze({
19
+ id: "earth",
20
+ label: "Earth",
21
+ // Volumetric mean radius in km from the NASA NSSDC Earth fact sheet.
22
+ radiusKm: 6371.0,
23
+ gmKm3S2: 398_600.4418,
24
+ parentId: "sun",
25
+ orientation: "ecef",
26
+ accuracy: Object.freeze({
27
+ dimensions: createProvenance({
28
+ sourceType: "observed",
29
+ sources: ["NASA NSSDC Earth fact sheet (volumetric mean radius)"],
30
+ accuracy: "Mean radius only; Earth is drawn as a sphere and its flattening is not modelled.",
31
+ notes: "Gravitational parameter matches the @lizard-isana/orb 3.1.1 table (a test asserts it).",
32
+ }),
33
+ position: EARTH_EPHEMERIS.provenance,
34
+ // The EPV00 model's stated validity.
35
+ validUtc: Object.freeze({ startUtcMs: Date.UTC(1900, 0, 1), endUtcMs: Date.UTC(2100, 0, 1) }),
36
+ orientationLimitations: EARTH_EPHEMERIS.knownLimitations,
37
+ }),
38
+ });
@@ -0,0 +1,16 @@
1
+ import type { CelestialBodyDefinition, StateSourceBinding } from "../body.js";
2
+ export { EARTH, EARTH_EPHEMERIS } from "./earth.js";
3
+ export { MOON, MOON_EPHEMERIS } from "./moon.js";
4
+ export { SUN } from "./sun.js";
5
+ export { SWIFT_TUTTLE, SWIFT_TUTTLE_SAMPLING } from "./swiftTuttle.js";
6
+ export { IO } from "./io.js";
7
+ export { CALLISTO, EUROPA, GANYMEDE } from "./jupiterMoons.js";
8
+ export { JUPITER, JUPITER_EPHEMERIS, JUPITER_ROTATION } from "./jupiter.js";
9
+ export { MARS, MARS_EPHEMERIS, MARS_ROTATION } from "./mars.js";
10
+ export { MERCURY, MERCURY_EPHEMERIS, MERCURY_ROTATION } from "./mercury.js";
11
+ export { NEPTUNE, PLUTO, SATURN, URANUS } from "./outerPlanets.js";
12
+ export { VENUS, VENUS_EPHEMERIS, VENUS_ROTATION } from "./venus.js";
13
+ /** Every body the engine knows, defined once. */
14
+ export declare const BUILT_IN_BODIES: readonly CelestialBodyDefinition[];
15
+ /** One state source per non-root body; the Sun is the root and has none. */
16
+ export declare const BUILT_IN_BINDINGS: readonly StateSourceBinding[];
@@ -0,0 +1,45 @@
1
+ import { MoonTrajectory } from "../moonTrajectory.js";
2
+ import { createPlanetSunTrajectory } from "./planetTrajectory.js";
3
+ import { createEarthSunTrajectory } from "../sunCentredSources.js";
4
+ import { EARTH } from "./earth.js";
5
+ import { MOON } from "./moon.js";
6
+ import { IO, IO_BINDING } from "./io.js";
7
+ import { CALLISTO, EUROPA, GANYMEDE, MAPPED_MOON_BINDINGS } from "./jupiterMoons.js";
8
+ import { JUPITER, JUPITER_ROTATION } from "./jupiter.js";
9
+ import { MARS, MARS_ROTATION } from "./mars.js";
10
+ import { MERCURY, MERCURY_ROTATION } from "./mercury.js";
11
+ import { NEPTUNE, NEPTUNE_ROTATION, PLUTO, SATURN, SATURN_ROTATION, URANUS, URANUS_ROTATION } from "./outerPlanets.js";
12
+ import { PLANET_MOON_BINDINGS, PLANET_MOON_DEFINITIONS, PLUTO_BINDING } from "./planetMoons.js";
13
+ import { SUN } from "./sun.js";
14
+ import { SWIFT_TUTTLE, SWIFT_TUTTLE_BINDING } from "./swiftTuttle.js";
15
+ import { VENUS, VENUS_ROTATION } from "./venus.js";
16
+ export { EARTH, EARTH_EPHEMERIS } from "./earth.js";
17
+ export { MOON, MOON_EPHEMERIS } from "./moon.js";
18
+ export { SUN } from "./sun.js";
19
+ export { SWIFT_TUTTLE, SWIFT_TUTTLE_SAMPLING } from "./swiftTuttle.js";
20
+ export { IO } from "./io.js";
21
+ export { CALLISTO, EUROPA, GANYMEDE } from "./jupiterMoons.js";
22
+ export { JUPITER, JUPITER_EPHEMERIS, JUPITER_ROTATION } from "./jupiter.js";
23
+ export { MARS, MARS_EPHEMERIS, MARS_ROTATION } from "./mars.js";
24
+ export { MERCURY, MERCURY_EPHEMERIS, MERCURY_ROTATION } from "./mercury.js";
25
+ export { NEPTUNE, PLUTO, SATURN, URANUS } from "./outerPlanets.js";
26
+ export { VENUS, VENUS_EPHEMERIS, VENUS_ROTATION } from "./venus.js";
27
+ /** Every body the engine knows, defined once. */
28
+ export const BUILT_IN_BODIES = Object.freeze([SUN, EARTH, MOON, MERCURY, VENUS, MARS, JUPITER, IO, EUROPA, GANYMEDE, CALLISTO, SATURN, URANUS, NEPTUNE, PLUTO, ...PLANET_MOON_DEFINITIONS, SWIFT_TUTTLE]);
29
+ /** One state source per non-root body; the Sun is the root and has none. */
30
+ export const BUILT_IN_BINDINGS = Object.freeze([
31
+ Object.freeze({ body: EARTH.id, create: createEarthSunTrajectory }),
32
+ Object.freeze({ body: MOON.id, create: (adapter) => new MoonTrajectory(adapter) }),
33
+ Object.freeze({ body: MERCURY.id, create: (adapter) => createPlanetSunTrajectory("mercury", MERCURY_ROTATION, adapter) }),
34
+ Object.freeze({ body: VENUS.id, create: (adapter) => createPlanetSunTrajectory("venus", VENUS_ROTATION, adapter) }),
35
+ Object.freeze({ body: MARS.id, create: (adapter) => createPlanetSunTrajectory("mars", MARS_ROTATION, adapter) }),
36
+ Object.freeze({ body: JUPITER.id, create: (adapter) => createPlanetSunTrajectory("jupiter", JUPITER_ROTATION, adapter) }),
37
+ Object.freeze({ body: SATURN.id, create: (adapter) => createPlanetSunTrajectory("saturn", SATURN_ROTATION, adapter) }),
38
+ Object.freeze({ body: URANUS.id, create: (adapter) => createPlanetSunTrajectory("uranus", URANUS_ROTATION, adapter) }),
39
+ Object.freeze({ body: NEPTUNE.id, create: (adapter) => createPlanetSunTrajectory("neptune", NEPTUNE_ROTATION, adapter) }),
40
+ PLUTO_BINDING,
41
+ IO_BINDING,
42
+ ...MAPPED_MOON_BINDINGS,
43
+ ...PLANET_MOON_BINDINGS,
44
+ SWIFT_TUTTLE_BINDING,
45
+ ]);
@@ -0,0 +1,54 @@
1
+ import type { CelestialBodyDefinition, StateSourceBinding } from "../body.js";
2
+ import type { Trajectory } from "../trajectory.js";
3
+ import { trueAnomalyFromMean } from "../keplerAnomaly.js";
4
+ export { trueAnomalyFromMean };
5
+ /**
6
+ * Io's mean orbital elements about Jupiter, J2000 epoch (2000-01-01 12:00 TDB), referred to the local Laplace plane, from the JPL Solar
7
+ * System Dynamics "Planetary Satellite Mean Elements" table (https://ssd.jpl.nasa.gov/sats/elem/, ephemeris JUP365, row for Io 501): read from
8
+ * `data/orbits/io.json`, the one record (T-078; T-116 removed the copy of these numbers that lived here). The table's own warning: these are "not
9
+ * intended for ephemeris computation".
10
+ */
11
+ export declare const IO_MEAN_ELEMENTS: Readonly<{
12
+ epochTdb: string;
13
+ semiMajorAxisKm: number;
14
+ eccentricity: number;
15
+ argumentOfPeriapsisDeg: number;
16
+ meanAnomalyDeg: number;
17
+ inclinationDeg: number;
18
+ nodeDeg: number;
19
+ periodDays: number;
20
+ /** The table's period of the apsides (years); the table's P is the anomalistic period, the time for M to advance 360 degrees. */
21
+ apsisPeriodYears: number;
22
+ /** Pole of the Laplace plane, degrees: the table's R.A. and Dec. columns. Tilt to Jupiter's equator is 0.0. */
23
+ laplacePoleRaDeg: number;
24
+ laplacePoleDecDeg: number;
25
+ citation: `${string} (${string}), Io, ${string}, Laplace frame, read ${string}`;
26
+ }>;
27
+ /** J2000 (2000-01-01 12:00 TDB) in UTC: TDB is taken as TT, and TT - UTC was 64.184 s then. A 64 s error would move Io about 1100 km. */
28
+ export declare const IO_EPOCH_UTC_MS: number;
29
+ /** Io's period about Jupiter, days: the sidereal period the mean elements give (about 1.769). */
30
+ export declare const IO_PERIOD_DAYS: number;
31
+ /**
32
+ * The sidereal period, days. The table's P is anomalistic (M advances 360 degrees in it) and its periapsis moves once round per
33
+ * `apsisPeriodYears`; the table gives no sign for that motion. The retrograde sign gives 1.7691 d, the known sidereal period (the Horizons
34
+ * header for Io says about 1.77 d); the prograde sign gives 1.756 d, which put Io hundreds of thousands of km from Horizons. A fixed-ellipse
35
+ * two-body orbit cannot precess, so it takes the sidereal period to keep Io's mean longitude right.
36
+ */
37
+ export declare function siderealPeriodDays(anomalisticDays: number, apsisPeriodYears: number): number;
38
+ /** The semi-major axis whose two-body period about Jupiter's GM equals `periodDays`. */
39
+ export declare function periodConsistentSemiMajorAxisKm(gmKm3S2: number, periodDays: number): number;
40
+ /** Io about Jupiter from the mean elements by unperturbed two-body motion, tidally locked (near side towards Jupiter). */
41
+ export declare function createIoTrajectory(): Trajectory;
42
+ /** The dates the mean-element model was compared over (T-078); not the dates Io is valid for now (the fits). */
43
+ export declare const IO_MEAN_ELEMENT_VALID_UTC: Readonly<{
44
+ startUtcMs: number;
45
+ endUtcMs: number;
46
+ }>;
47
+ /** The largest Jupiter-centred distance from Horizons over the six compared dates (tests/jupiterIo.test.ts asserts this). */
48
+ export declare const IO_MAX_ERROR_KM = 9388;
49
+ export declare const IO_DIAMETER_KM = 3642.98;
50
+ export declare const IO_EPHEMERIS_LIMITATIONS: readonly string[];
51
+ export declare const IO_TIDAL_LOCK_LIMITATION = "Io's orientation is an approximate tidal lock keeping its near side towards Jupiter, with no libration.";
52
+ export declare const IO: CelestialBodyDefinition;
53
+ /** Io's position comes from the core curve fits (JPL Horizons, O-025 Decision 3); the mean-element model above is kept as the record T-078 measured. */
54
+ export declare const IO_BINDING: StateSourceBinding;
@@ -0,0 +1,120 @@
1
+ import { moonOrientationFromOrbit } from "../bodyOrientation.js";
2
+ import { createProvenance } from "../provenance.js";
3
+ import { assertUtcUnixMs, createState } from "../state.js";
4
+ import { createTwoBodyTrajectory } from "../sunCentredSources.js";
5
+ import { createOrbTwoBodyAdapter } from "../twoBodyAdapter.js";
6
+ import { JUPITER } from "./jupiter.js";
7
+ import { trueAnomalyFromMean } from "../keplerAnomaly.js";
8
+ import { fittedMoonPosition, IO_FITTED_BINDING, JUPITER_MOON_FIT_SPAN } from "./jupiterMoons.js";
9
+ import ioRecord from "../../../data/orbits/io.json";
10
+ export { trueAnomalyFromMean };
11
+ const DEGREES = Math.PI / 180;
12
+ const ORIENTATION_SAMPLE_SECONDS = 1800;
13
+ /**
14
+ * Io's mean orbital elements about Jupiter, J2000 epoch (2000-01-01 12:00 TDB), referred to the local Laplace plane, from the JPL Solar
15
+ * System Dynamics "Planetary Satellite Mean Elements" table (https://ssd.jpl.nasa.gov/sats/elem/, ephemeris JUP365, row for Io 501): read from
16
+ * `data/orbits/io.json`, the one record (T-078; T-116 removed the copy of these numbers that lived here). The table's own warning: these are "not
17
+ * intended for ephemeris computation".
18
+ */
19
+ export const IO_MEAN_ELEMENTS = Object.freeze({
20
+ epochTdb: ioRecord.epoch.tdb,
21
+ semiMajorAxisKm: ioRecord.elements.semiMajorAxisKm,
22
+ eccentricity: ioRecord.elements.eccentricity,
23
+ argumentOfPeriapsisDeg: ioRecord.elements.argumentOfPeriapsisDeg,
24
+ meanAnomalyDeg: ioRecord.elements.meanAnomalyDeg,
25
+ inclinationDeg: ioRecord.elements.inclinationDeg,
26
+ nodeDeg: ioRecord.elements.nodeDeg,
27
+ periodDays: ioRecord.elements.periodDays,
28
+ /** The table's period of the apsides (years); the table's P is the anomalistic period, the time for M to advance 360 degrees. */
29
+ apsisPeriodYears: ioRecord.elements.apsisPeriodYears,
30
+ /** Pole of the Laplace plane, degrees: the table's R.A. and Dec. columns. Tilt to Jupiter's equator is 0.0. */
31
+ laplacePoleRaDeg: ioRecord.plane.poleRaDeg,
32
+ laplacePoleDecDeg: ioRecord.plane.poleDecDeg,
33
+ citation: `${ioRecord.source.title} (${ioRecord.source.url}), Io, ${ioRecord.source.ephemeris}, Laplace frame, read ${ioRecord.source.accessed}`,
34
+ });
35
+ /** J2000 (2000-01-01 12:00 TDB) in UTC: TDB is taken as TT, and TT - UTC was 64.184 s then. A 64 s error would move Io about 1100 km. */
36
+ export const IO_EPOCH_UTC_MS = Date.UTC(2000, 0, 1, 12, 0, 0) - 64_184;
37
+ /** Io's period about Jupiter, days: the sidereal period the mean elements give (about 1.769). */
38
+ export const IO_PERIOD_DAYS = siderealPeriodDays(IO_MEAN_ELEMENTS.periodDays, IO_MEAN_ELEMENTS.apsisPeriodYears);
39
+ /**
40
+ * The sidereal period, days. The table's P is anomalistic (M advances 360 degrees in it) and its periapsis moves once round per
41
+ * `apsisPeriodYears`; the table gives no sign for that motion. The retrograde sign gives 1.7691 d, the known sidereal period (the Horizons
42
+ * header for Io says about 1.77 d); the prograde sign gives 1.756 d, which put Io hundreds of thousands of km from Horizons. A fixed-ellipse
43
+ * two-body orbit cannot precess, so it takes the sidereal period to keep Io's mean longitude right.
44
+ */
45
+ export function siderealPeriodDays(anomalisticDays, apsisPeriodYears) {
46
+ return 1 / (1 / anomalisticDays - 1 / (apsisPeriodYears * 365.25));
47
+ }
48
+ /** The semi-major axis whose two-body period about Jupiter's GM equals `periodDays`. */
49
+ export function periodConsistentSemiMajorAxisKm(gmKm3S2, periodDays) {
50
+ const meanMotion = (2 * Math.PI) / (periodDays * 86_400);
51
+ return Math.cbrt(gmKm3S2 / (meanMotion * meanMotion));
52
+ }
53
+ /** Io about Jupiter from the mean elements by unperturbed two-body motion, tidally locked (near side towards Jupiter). */
54
+ export function createIoTrajectory() {
55
+ const elements = IO_MEAN_ELEMENTS;
56
+ const gm = JUPITER.gmKm3S2;
57
+ const adapter = createOrbTwoBodyAdapter([JUPITER]);
58
+ // Laplace plane = the plane with pole (ra, dec), node reference on the EQJ equator at ra + 90 deg; as an EQJ-plane orbit that is
59
+ // inclination 90 - dec and node ra + 90, with the table's argument of periapsis measured from that reference.
60
+ const inner = createTwoBodyTrajectory({
61
+ body: "io",
62
+ center: "jupiter",
63
+ plane: "EQJ",
64
+ epochUtcMs: IO_EPOCH_UTC_MS,
65
+ elements: {
66
+ semiMajorAxisKm: periodConsistentSemiMajorAxisKm(gm, siderealPeriodDays(elements.periodDays, elements.apsisPeriodYears)),
67
+ eccentricity: elements.eccentricity,
68
+ inclinationDeg: 90 - elements.laplacePoleDecDeg + elements.inclinationDeg,
69
+ raanDeg: elements.laplacePoleRaDeg + 90 + elements.nodeDeg,
70
+ argumentOfPeriapsisDeg: elements.argumentOfPeriapsisDeg,
71
+ trueAnomalyDeg: trueAnomalyFromMean(elements.meanAnomalyDeg * DEGREES, elements.eccentricity) / DEGREES,
72
+ },
73
+ }, adapter);
74
+ const positionAt = (timeUtcMs) => Float64Array.from(inner.stateAt(timeUtcMs, "jupiter").positionKm);
75
+ return Object.freeze({
76
+ body: "io",
77
+ stateAt(timeUtcMs, center = "jupiter") {
78
+ assertUtcUnixMs(timeUtcMs);
79
+ if (center !== "jupiter")
80
+ throw new RangeError(`Io is Jupiter-centred; centre "${center}" is not offered, the state resolver recentres it`);
81
+ const position = positionAt(timeUtcMs);
82
+ const orientation = moonOrientationFromOrbit(position, positionAt(timeUtcMs - ORIENTATION_SAMPLE_SECONDS * 1000), positionAt(timeUtcMs + ORIENTATION_SAMPLE_SECONDS * 1000));
83
+ return createState({ body: "io", center: "jupiter", timeUtcMs, positionKm: position, orientation });
84
+ },
85
+ });
86
+ }
87
+ /** The dates the mean-element model was compared over (T-078); not the dates Io is valid for now (the fits). */
88
+ export const IO_MEAN_ELEMENT_VALID_UTC = Object.freeze({ startUtcMs: Date.UTC(1969, 6, 21), endUtcMs: Date.UTC(2030, 5, 1) });
89
+ const HORIZONS_PHYSICAL = "JPL Horizons satellite physical properties for Io 501 (https://ssd.jpl.nasa.gov/api/horizons.api, header archived in tests/fixtures/io-horizons-source.txt), read 2026-10-12";
90
+ /** The largest Jupiter-centred distance from Horizons over the six compared dates (tests/jupiterIo.test.ts asserts this). */
91
+ export const IO_MAX_ERROR_KM = 9388;
92
+ export const IO_DIAMETER_KM = 3642.98;
93
+ export const IO_EPHEMERIS_LIMITATIONS = Object.freeze([
94
+ `Largest sampled difference from Horizons is about ${IO_MAX_ERROR_KM.toLocaleString("en-US")} km, ${(IO_MAX_ERROR_KM / IO_DIAMETER_KM).toFixed(1)} Io diameters; the position is an approximate demonstration, not an ephemeris. It is nearest right at the J2000 epoch (about 0.8 thousand km) and grows with distance from it.`,
95
+ "Io moves on one unperturbed ellipse: the precession of its periapsis and the resonance with Europa and Ganymede are not modelled, only the mean longitude is kept right by using the sidereal period.",
96
+ "The source table says its mean elements are not intended for ephemeris computation.",
97
+ "No velocity is modelled for Io, so it has no speed readout.",
98
+ ]);
99
+ export const IO_TIDAL_LOCK_LIMITATION = "Io's orientation is an approximate tidal lock keeping its near side towards Jupiter, with no libration.";
100
+ export const IO = Object.freeze({
101
+ id: "io",
102
+ label: "Io",
103
+ radiusKm: 1821.49,
104
+ gmKm3S2: 5959.9155,
105
+ parentId: "jupiter",
106
+ orientation: "tidal-lock",
107
+ accuracy: Object.freeze({
108
+ dimensions: createProvenance({
109
+ sourceType: "observed",
110
+ sources: [HORIZONS_PHYSICAL],
111
+ accuracy: "Mean radius 1821.49 km and GM 5959.9155 km^3/s^2 as printed in the Horizons header; Io is drawn as a sphere.",
112
+ notes: "Gravitational parameter in km^3/s^2.",
113
+ }),
114
+ position: fittedMoonPosition("Io", 0.0994),
115
+ validUtc: JUPITER_MOON_FIT_SPAN,
116
+ orientationLimitations: Object.freeze([IO_TIDAL_LOCK_LIMITATION]),
117
+ }),
118
+ });
119
+ /** Io's position comes from the core curve fits (JPL Horizons, O-025 Decision 3); the mean-element model above is kept as the record T-078 measured. */
120
+ export const IO_BINDING = IO_FITTED_BINDING;
@@ -0,0 +1,8 @@
1
+ import type { CelestialBodyDefinition } from "../body.js";
2
+ import type { IauRotationElements } from "../iauRotation.js";
3
+ export declare const JUPITER_EPHEMERIS: import("../body.js").EphemerisRecord;
4
+ /** Jupiter pole and prime meridian from the IAU 2015 report: degrees, pole per Julian century, W per day, from J2000 TDB. */
5
+ export declare const JUPITER_ROTATION: IauRotationElements;
6
+ /** Jupiter is gaseous and its cloud bands rotate at different rates, so no single prime meridian fits the whole map. */
7
+ export declare const JUPITER_BAND_LIMITATION = "Jupiter's cloud bands rotate at different rates, so any prime meridian is approximate: the texture's orientation is a visual stand-in, not a measured longitude.";
8
+ export declare const JUPITER: CelestialBodyDefinition;
@@ -0,0 +1,40 @@
1
+ import { createProvenance } from "../provenance.js";
2
+ import { IAU_REPORT, PLANET_VALIDATED_UTC, planetEphemeris, ROTATION_LIMITATION } from "./planetRecords.js";
3
+ export const JUPITER_EPHEMERIS = planetEphemeris("Jupiter", "at most 1269 km (0.33 arcsec) from Horizons", ["The largest sampled difference from the Horizons body centre is about 1.3 thousand km, larger than the inner planets because the series is fitted to the planet as a system."]);
4
+ /** Jupiter pole and prime meridian from the IAU 2015 report: degrees, pole per Julian century, W per day, from J2000 TDB. */
5
+ export const JUPITER_ROTATION = Object.freeze({
6
+ poleRaDeg: [268.056595, -0.006499],
7
+ poleDecDeg: [64.495303, 0.002413],
8
+ primeMeridianDeg: [284.95, 870.5360000],
9
+ citation: IAU_REPORT,
10
+ });
11
+ /** Jupiter is gaseous and its cloud bands rotate at different rates, so no single prime meridian fits the whole map. */
12
+ export const JUPITER_BAND_LIMITATION = "Jupiter's cloud bands rotate at different rates, so any prime meridian is approximate: the texture's orientation is a visual stand-in, not a measured longitude.";
13
+ export const JUPITER = Object.freeze({
14
+ id: "jupiter",
15
+ label: "Jupiter",
16
+ radiusKm: 69911,
17
+ equatorialRadiusKm: 71492,
18
+ polarRadiusKm: 66854,
19
+ gmKm3S2: 126_686_531.9,
20
+ parentId: "sun",
21
+ orientation: "iau-rotation",
22
+ accuracy: Object.freeze({
23
+ dimensions: createProvenance({
24
+ sourceType: "observed",
25
+ sources: [
26
+ "NASA NSSDC Jupiter fact sheet (https://nssdc.gsfc.nasa.gov/planetary/factsheet/jupiterfact.html), read 2026-10-12",
27
+ "JPL Horizons physical data for Jupiter (gravitational parameter), read 2026-10-12",
28
+ ],
29
+ accuracy: "Fact-sheet volumetric mean radius and the 1-bar equatorial and polar radii; the 6.5% flattening is drawn as a spheroid. The cloud-top level is not a solid surface.",
30
+ notes: "Gravitational parameter in km^3/s^2 from the Horizons physical-data header.",
31
+ }),
32
+ position: JUPITER_EPHEMERIS.provenance,
33
+ validUtc: PLANET_VALIDATED_UTC,
34
+ orientationLimitations: Object.freeze([
35
+ ROTATION_LIMITATION,
36
+ JUPITER_BAND_LIMITATION,
37
+ `Constants: ${IAU_REPORT}.`,
38
+ ]),
39
+ }),
40
+ });
@@ -0,0 +1,2 @@
1
+ export declare const JUPITER_MOON_CATALOGUE_FILE: unknown;
2
+ export declare const JUPITER_RING_FILE: unknown;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Jupiter's core data files as they are read (O-025 Decision 8: moon data is core): the moon list by family (data/moons/jupiter.json,
3
+ * T-097) and the ring bands (data/rings/jupiter.json). Raw JSON: src/assets parses and checks them (layer rule: assets reach data
4
+ * through core).
5
+ */
6
+ import moonCatalogueFile from "../../../data/moons/jupiter.json";
7
+ import ringFile from "../../../data/rings/jupiter.json";
8
+ export const JUPITER_MOON_CATALOGUE_FILE = moonCatalogueFile;
9
+ export const JUPITER_RING_FILE = ringFile;
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Jupiter's moons from the core curve-fit set (`data/ephemerides/jupiter-moons/`, JPL Horizons, T-096): Jupiter is one configuration of the
3
+ * generic moon-system loader (`moonSystem.ts`, O-033 T-116), the bindings of the four mapped moons, and the names the Jupiter experience and its
4
+ * tests already use. Core data: any experience may load it; which bodies it shows is the experience's choice (O-025 Decision 8).
5
+ */
6
+ import type { BodyId, StateSourceBinding } from "../body.js";
7
+ import type { TimeBounds } from "../trajectory.js";
8
+ import { chunksNeeded, type MoonSystemLoad } from "./moonSystem.js";
9
+ /** The span the committed fits cover (T-096: 2010-01-01 to 2030-01-01 TDB, chunked per calendar year). */
10
+ export declare const JUPITER_MOON_FIT_SPAN: TimeBounds;
11
+ export declare const JUPITER_MOON_FIT_SOURCE: string;
12
+ export declare const JUPITER_MOON_SYSTEM: import("./moonSystem.js").MoonSystem;
13
+ export { chunksNeeded };
14
+ export type JupiterMoonLoad = MoonSystemLoad;
15
+ /** The loaded set; throws before `loadJupiterMoons` resolved rather than drawing a moon from nothing. */
16
+ export declare const jupiterMoonEphemeris: () => import("../chebyshevEphemeris.js").ChebyshevEphemeris;
17
+ /** Hands in a set built elsewhere (tests read the committed chunks from disk). */
18
+ export declare const installJupiterMoonEphemeris: (ephemeris: import("../chebyshevEphemeris.js").ChebyshevEphemeris | null) => void;
19
+ export declare const loadJupiterMoons: (load: MoonSystemLoad) => Promise<import("../chebyshevEphemeris.js").ChebyshevEphemeris>;
20
+ export declare const osculatingPeriodMs: (ephemeris: import("../chebyshevEphemeris.js").ChebyshevEphemeris, body: BodyId, timeUtcMs: number) => number;
21
+ export declare const FITTED_MOON_TIDAL_LOCK: string;
22
+ /** What every mapped Jupiter moon's record says about its position, with its own worst figure from T-096. */
23
+ export declare const fittedMoonPosition: (label: string, worstM: number) => ReturnType<typeof import("../provenance.js").createProvenance>;
24
+ /** The Galilean moons turn synchronously: their prime meridians are the IAU records saved with their orbits (`data/orbits/`), the one source. */
25
+ export declare const IO_ROTATION: import("../iauRotation.js").IauRotationElements;
26
+ export declare const EUROPA: import("../body.js").CelestialBodyDefinition;
27
+ export declare const GANYMEDE: import("../body.js").CelestialBodyDefinition;
28
+ export declare const CALLISTO: import("../body.js").CelestialBodyDefinition;
29
+ /** Io's binding is in `io.ts` with its definition; the three below are the same pattern. */
30
+ export declare const IO_FITTED_BINDING: StateSourceBinding;
31
+ export declare const MAPPED_MOON_BINDINGS: readonly StateSourceBinding[];
@@ -0,0 +1,44 @@
1
+ import { iauElementsFromRecord } from "../iauRotation.js";
2
+ import { JUPITER } from "./jupiter.js";
3
+ import { chunksNeeded, createMoonSystem, MOON_FIT_SPAN, moonFitSource } from "./moonSystem.js";
4
+ import json1 from "../../../data/orbits/callisto.json";
5
+ const { rotation: callistoRotation } = json1;
6
+ import json2 from "../../../data/orbits/europa.json";
7
+ const { rotation: europaRotation } = json2;
8
+ import json3 from "../../../data/orbits/ganymede.json";
9
+ const { rotation: ganymedeRotation } = json3;
10
+ import json4 from "../../../data/orbits/io.json";
11
+ const { rotation: ioRotation } = json4;
12
+ /** The span the committed fits cover (T-096: 2010-01-01 to 2030-01-01 TDB, chunked per calendar year). */
13
+ export const JUPITER_MOON_FIT_SPAN = MOON_FIT_SPAN;
14
+ export const JUPITER_MOON_FIT_SOURCE = moonFitSource("Jupiter");
15
+ export const JUPITER_MOON_SYSTEM = createMoonSystem({
16
+ centre: "jupiter",
17
+ centreLabel: "Jupiter",
18
+ centreGmKm3S2: JUPITER.gmKm3S2,
19
+ ephemerisName: "jup365_merged",
20
+ fitSource: JUPITER_MOON_FIT_SOURCE
21
+ });
22
+ export { chunksNeeded };
23
+ /** The loaded set; throws before `loadJupiterMoons` resolved rather than drawing a moon from nothing. */
24
+ export const jupiterMoonEphemeris = JUPITER_MOON_SYSTEM.ephemeris;
25
+ /** Hands in a set built elsewhere (tests read the committed chunks from disk). */
26
+ export const installJupiterMoonEphemeris = JUPITER_MOON_SYSTEM.install;
27
+ export const loadJupiterMoons = JUPITER_MOON_SYSTEM.load;
28
+ export const osculatingPeriodMs = JUPITER_MOON_SYSTEM.osculatingPeriodMs;
29
+ export const FITTED_MOON_TIDAL_LOCK = JUPITER_MOON_SYSTEM.tidalLockNote;
30
+ /** What every mapped Jupiter moon's record says about its position, with its own worst figure from T-096. */
31
+ export const fittedMoonPosition = JUPITER_MOON_SYSTEM.position;
32
+ /** The Galilean moons turn synchronously: their prime meridians are the IAU records saved with their orbits (`data/orbits/`), the one source. */
33
+ export const IO_ROTATION = iauElementsFromRecord(ioRotation);
34
+ const jupiterMoon = (id, label, radiusKm, gmKm3S2, worstM, header) => JUPITER_MOON_SYSTEM.mappedMoon({ id, label, radiusKm, gmKm3S2, worstM, header });
35
+ export const EUROPA = jupiterMoon("europa", "Europa", 1560.8, 3202.7121, 0.0755, "Mean radius (km) = 1560.8 +- 0.3, GM (km^3/s^2) = 3202.7121 +- 0.0054");
36
+ export const GANYMEDE = jupiterMoon("ganymede", "Ganymede", 2631.2, 9887.8328, 0.0662, "Mean radius (km) = 2631.2 +- 1.7, GM (km^3/s^2) = 9887.8328 +- 0.0074");
37
+ export const CALLISTO = jupiterMoon("callisto", "Callisto", 2410.3, 7179.2834, 0.0521, "Mean radius (km) = 2410.3 +- 1.5, GM (km^3/s^2) = 7179.2834 +- 0.0097");
38
+ /** Io's binding is in `io.ts` with its definition; the three below are the same pattern. */
39
+ export const IO_FITTED_BINDING = JUPITER_MOON_SYSTEM.binding("io", IO_ROTATION);
40
+ export const MAPPED_MOON_BINDINGS = Object.freeze([
41
+ JUPITER_MOON_SYSTEM.binding(EUROPA.id, iauElementsFromRecord(europaRotation)),
42
+ JUPITER_MOON_SYSTEM.binding(GANYMEDE.id, iauElementsFromRecord(ganymedeRotation)),
43
+ JUPITER_MOON_SYSTEM.binding(CALLISTO.id, iauElementsFromRecord(callistoRotation)),
44
+ ]);
@@ -0,0 +1,6 @@
1
+ import type { CelestialBodyDefinition } from "../body.js";
2
+ import type { IauRotationElements } from "../iauRotation.js";
3
+ export declare const MARS_EPHEMERIS: import("../body.js").EphemerisRecord;
4
+ /** Mars pole and prime meridian from the IAU 2015 report: degrees, pole per Julian century, W per day, from J2000 TDB. */
5
+ export declare const MARS_ROTATION: IauRotationElements;
6
+ export declare const MARS: CelestialBodyDefinition;