astraeus-data 0.9.1 → 0.9.3

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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,14 @@
2
2
 
3
3
  Versions follow [semantic versioning](https://semver.org). It is released together with `astraeus`, with the same version number.
4
4
 
5
+ ## 0.9.3 (2026-11-20)
6
+
7
+ No changes to the pictures, data or this package's code. Released with `astraeus` 0.9.3 to keep the version numbers together; the `astraeus` peer stays `>=0.9.0 <0.10.0`.
8
+
9
+ ## 0.9.2 (2026-11-17)
10
+
11
+ - Added: the subpath `astraeus-data/milky-way` exports `milkyWaySource`, a source holding the Milky Way picture alone, so a sky-only app's build copies that picture and not the moon and Venus maps. The main export (`dataSource`, `PICTURES`) and every picture file and licence record are unchanged. The `astraeus` peer stays `>=0.9.0 <0.10.0`.
12
+
5
13
  ## 0.9.1 (2026-11-12)
6
14
 
7
15
  No changes to the pictures, data or this package's code. Released with `astraeus` 0.9.1 to keep the version numbers together; the `astraeus` peer stays `>=0.9.0 <0.10.0`.
package/README.md CHANGED
@@ -19,4 +19,17 @@ import { dataSource as saturnMoons } from "astraeus-data-saturn";
19
19
  mount(element, new Scene().addBody(saturn).addBody(titan), { data: [pictures, saturnMoons] });
20
20
  ```
21
21
 
22
+ ## The Milky Way alone
23
+
24
+ A sky-only app (stars, constellations, no moons) can take the Milky Way picture without the moon and Venus maps. Import `milkyWaySource` from the `astraeus-data/milky-way` subpath; a build then copies that one picture:
25
+
26
+ ```ts
27
+ import { mount, Scene } from "astraeus";
28
+ import { milkyWaySource } from "astraeus-data/milky-way";
29
+
30
+ mount(element, new Scene(), { data: [milkyWaySource] });
31
+ ```
32
+
33
+ It gives the sky exactly the Milky Way that `dataSource` does, with the same licence record, and provides no bodies. The main export `astraeus-data` is unchanged.
34
+
22
35
  Every picture carries its licence record (`PICTURES[name].licence`); `NOTICE` lists them. Most are NASA/JPL or USGS public-domain or credit-required work; the Milky Way is CC BY 4.0.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "astraeus-data",
3
- "version": "0.9.1",
3
+ "version": "0.9.3",
4
4
  "description": "Pictures and place lists for the Astraeus engine: maps of the moons, the 8k Venus map, the Milky Way and the tagged surface places of 24 bodies. Optional; the engine draws without them.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -24,6 +24,10 @@
24
24
  "types": "./src/index.d.ts",
25
25
  "import": "./src/index.js"
26
26
  },
27
+ "./milky-way": {
28
+ "types": "./src/milkyWay.d.ts",
29
+ "import": "./src/milkyWay.js"
30
+ },
27
31
  "./bodies/*": "./data/bodies/*",
28
32
  "./package.json": "./package.json"
29
33
  },
@@ -0,0 +1,9 @@
1
+ import type { AssetLicence, DataSource, TextureRef } from "astraeus";
2
+ export declare const MILKY_WAY_LICENCE: AssetLicence;
3
+ /** The Milky Way picture the engine draws behind the stars, with its licence. */
4
+ export declare const MILKY_WAY_PICTURE: TextureRef;
5
+ /**
6
+ * Hand this to `mount(element, scene, { data: [milkyWaySource] })` to give the sky its Milky Way and nothing else: a build copies this one picture,
7
+ * not the moon and Venus maps that `astraeus-data`'s main export carries. It provides no bodies.
8
+ */
9
+ export declare const milkyWaySource: DataSource;
@@ -0,0 +1,15 @@
1
+ const milkyWayUrl = new URL("./textures/milky-way.jpg", import.meta.url).href;
2
+ export const MILKY_WAY_LICENCE = Object.freeze({
3
+ source: "Milky Way 360 equirectangular rendering with foreground stars removed (Wikimedia Commons), Kevinmloch, bsrender, from Gaia EDR3",
4
+ url: "https://commons.wikimedia.org/wiki/File:Milky_Way_360_equirectangular_rendering_with_foreground_stars_removed.png",
5
+ licence: "CC BY-SA 4.0",
6
+ attribution: "Milky Way render by Kevinmloch (bsrender) from Gaia EDR3, ESA/Gaia/DPAC, CC BY-SA 4.0. The 8000x4000 original was resized to 3840x1920 by Wikimedia Commons and re-encoded as JPEG here; no other change (it is dimmed when drawn, not in the file).",
7
+ accessed: "2026-10-29",
8
+ });
9
+ /** The Milky Way picture the engine draws behind the stars, with its licence. */
10
+ export const MILKY_WAY_PICTURE = Object.freeze({ url: milkyWayUrl, widthPx: 3840, heightPx: 1920, licence: MILKY_WAY_LICENCE });
11
+ /**
12
+ * Hand this to `mount(element, scene, { data: [milkyWaySource] })` to give the sky its Milky Way and nothing else: a build copies this one picture,
13
+ * not the moon and Venus maps that `astraeus-data`'s main export carries. It provides no bodies.
14
+ */
15
+ export const milkyWaySource = Object.freeze({ name: "astraeus-data/milky-way", provides: [], pictures: Object.freeze({ "milky-way": MILKY_WAY_PICTURE }) });
package/src/pictures.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { MILKY_WAY_PICTURE } from "./milkyWay.js";
1
2
  const callistoUrl = new URL("./textures/callisto-2k.jpg", import.meta.url).href;
2
3
  const charonUrl = new URL("./textures/charon-2k.jpg", import.meta.url).href;
3
4
  const dioneUrl = new URL("./textures/dione-4k.jpg", import.meta.url).href;
@@ -7,7 +8,6 @@ const ganymedeUrl = new URL("./textures/ganymede-2k.jpg", import.meta.url).href;
7
8
  const iapetusUrl = new URL("./textures/iapetus-4k.jpg", import.meta.url).href;
8
9
  const ioUrl = new URL("./textures/io-2k.jpg", import.meta.url).href;
9
10
  const mimasUrl = new URL("./textures/mimas-4k.jpg", import.meta.url).href;
10
- const milkyWayUrl = new URL("./textures/milky-way.jpg", import.meta.url).href;
11
11
  const plutoUrl = new URL("./textures/pluto-4k.jpg", import.meta.url).href;
12
12
  const rheaUrl = new URL("./textures/rhea-4k.jpg", import.meta.url).href;
13
13
  const tethysUrl = new URL("./textures/tethys-4k.jpg", import.meta.url).href;
@@ -34,13 +34,6 @@ const IO_TEXTURE_LICENCE = Object.freeze({
34
34
  attribution: "Io texture: USGS Astrogeology Science Center; NASA/JPL Galileo and Voyager missions",
35
35
  accessed: "2026-10-12",
36
36
  });
37
- const MILKY_WAY_LICENCE = Object.freeze({
38
- source: "Milky Way 360 equirectangular rendering with foreground stars removed (Wikimedia Commons), Kevinmloch, bsrender, from Gaia EDR3",
39
- url: "https://commons.wikimedia.org/wiki/File:Milky_Way_360_equirectangular_rendering_with_foreground_stars_removed.png",
40
- licence: "CC BY-SA 4.0",
41
- attribution: "Milky Way render by Kevinmloch (bsrender) from Gaia EDR3, ESA/Gaia/DPAC, CC BY-SA 4.0. The 8000x4000 original was resized to 3840x1920 by Wikimedia Commons and re-encoded as JPEG here; no other change (it is dimmed when drawn, not in the file).",
42
- accessed: "2026-10-29",
43
- });
44
37
  // Europa, Ganymede and Callisto (donor commit 84f8d3e, 2048x1024 maps copied byte for byte).
45
38
  const galileanAccessed = "2026-10-18";
46
39
  const EUROPA_TEXTURE_LICENCE = Object.freeze({
@@ -92,7 +85,7 @@ export const PICTURES = Object.freeze({
92
85
  triton: picture(tritonUrl, 4096, 2048, nasa("Triton", `NASA/JPL-Caltech/Lunar & Planetary Institute Map of Triton (PIA18668), Voyager 2 simple-cylindrical colour map via the public-domain Wikimedia copy; donor file 14,138x7,069 (donor README); ${RESIZE}`, "https://pds-rings.seti.org/press_releases/pages/PIA18xxx/PIA18668.html", "NASA/JPL-Caltech/Lunar & Planetary Institute")),
93
86
  charon: picture(charonUrl, 1024, 512, nasa("Charon", "USGS Astrogeology, Charon New Horizons LORRI MVIC Global Mosaic 300 m (Jul 2017), 1024 px preview JPG (byte-identical to the donor's charon-2k.jpg; no donor README entry, source recorded by Astraeus)", "https://astrogeology.usgs.gov/", "New Horizons team; NASA, JHUAPL, SwRI, LPI; USGS Astrogeology 2017", "USGS use constraint: please cite authors")),
94
87
  "venus-8k": picture(venus8kUrl, 8192, 4096, VENUS_LICENCE),
95
- "milky-way": picture(milkyWayUrl, 3840, 1920, MILKY_WAY_LICENCE),
88
+ "milky-way": MILKY_WAY_PICTURE,
96
89
  });
97
90
  /** The bodies that gain a map from this package (the others in `PICTURES` are the sky and Venus's wide-screen file). */
98
91
  export const PICTURED_BODIES = Object.freeze(["io", "europa", "ganymede", "callisto", "mimas", "enceladus", "tethys", "dione", "rhea", "titan", "iapetus", "triton", "pluto", "charon"]);