spacemap 0.1.0 → 0.1.2

package/README.md

@@ -7,24 +7,53 @@ Distances are kilometres and angles are degrees throughout. Objects are named
 by their export id — `naif-399` for Earth, `spkid-20000004` for Vesta,
 `norad_satcat-25544` for the ISS.
 
-Licensed MPL-2.0. No key, no quota for now. The credit line the map draws is
-not removable: the imagery it shows requires attribution. Some body textures
-are licensed for non-commercial use only.
+No key, no quota for now.
+
+## Licensing
+
+The code is MPL-2.0. The data and imagery the map fetches keep the terms of
+their sources, which is why the credit line the map draws is not removable:
+these license require attribution.
+
+Every surface map and panorama is ranked by its terms, and the SDK draws only
+what a page may use:
+
+- **Open** imagery is free for any use, commercial included. It is the default
+  and all a map draws unless asked otherwise.
+- **Non-commercial** imagery is licensed for educational and non-commercial
+  use: the Uranus map, and the Huygens descent panorama of Titan. A page that
+  is not commercial turns it on:
+
+  ```js
+  const map = await createMap({ container: '#map', includeNonCommercial: true });
+  ```
+
+  Asking for it is accepting its terms, and the credit line naming each author
+  is part of those terms. Without the flag Uranus renders in a flat fallback
+  colour, and the Huygens stop is a place on Titan with no panorama to open.
+
+- **Site-only** imagery is licensed to spacemap.co alone and never reaches the
+  SDK.
 
 ## Getting it
 
-As one script that carries everything it needs — `spacemap.js`, an ES module,
-next to `spacemap.iife.js` for pages that want a global instead:
+As one script that carries everything it needs, from the CDN or copied next to
+your page:
 
 ```html
 <div id="map" style="height: 500px"></div>
 <script type="module">
-	import { createMap } from './spacemap.js';
+	import { createMap } from 'https://cdn.jsdelivr.net/npm/spacemap@0.1.2/dist/spacemap.js';
 	const map = await createMap({ container: '#map' });
 </script>
 ```
 
-Or from npm, where three.js is yours to provide:
+`spacemap.iife.js` next to it defines a `spacemap` global instead, for pages
+without modules. Pin the version you tested: a published version never changes,
+and an `integrity` attribute with the file's `sha384` digest keeps the page from
+running anything else.
+
+Or from npm, where you also need to provide three.js:
 
 ```sh
 npm install spacemap three
@@ -167,6 +196,8 @@ map.addSurfaceCircle({ body: 'naif-499', center: { lon: 77.5, lat: 18.4 }, radiu
 
 `boxRing`, `smallCircle` and `graticule`, the flat map's helpers, make point
 lists these take; `circlePoints` does the same for a circle in space.
+`groundDistanceM` and `bearingDeg` measure between any two places on a body,
+given its radius.
 
 Every drawing answers `remove()` and `setVisible()`, a shape answers
 `setAnchor()` and `setPoints()`, and `map.clearDrawings()` takes them all away
@@ -435,6 +466,19 @@ A rover's panorama from the inside, with arrows along its traverse. The
 three-dimensional part is all the SDK draws; the date, the place, a list to
 pick from or a map of the traverse are the page's to build.
 
+Which bodies have panoramas, and where each one stands, can be read before a
+view exists — what a page picking one for the reader needs, since `createPanorama`
+opens the body's first unless told which:
+
+```js
+import { fetchPanoramaIndex, fetchPanoramas } from 'spacemap';
+
+await fetchPanoramaIndex(); // every body with coverage, and the missions on it
+const entries = await fetchPanoramas('naif-499'); // every panorama on Mars
+const pick = entries[(Math.random() * entries.length) | 0];
+const view = await createPanorama({ container: '#panorama', body: 'naif-499', at: pick.id });
+```
+
 ```js
 const view = await createPanorama({
 	container: '#panorama',

package/THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,65 @@
+This bundle carries the following packages, under their own licences.
+
+========================================================================
+satellite.js 7.0.0 — MIT
+========================================================================
+
+MIT License
+
+Copyright (C) 2013 Shashwat Kandadai, UCSC Jack Baskin School of Engineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+========================================================================
+svelte 5.56.1 — MIT
+========================================================================
+
+Copyright (c) 2016-2025 [Svelte Contributors](https://github.com/sveltejs/svelte/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+========================================================================
+three 0.183.2 — MIT
+========================================================================
+
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.