@johnmorrisdotca/chikyu-earth 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.0
+
+The shared-controls integration is documented and covered in every motion preference, and the future of the
+country data is written down.
+
+- The README's new Controls section has the kazoku-ui snippet and the exact yaw/tilt/zoom/pan mapping. The browser
+  suite now proves reduced motion leaves the globe still, as well as Auto-turn continuing after a zoom.
+- Inspected chizu 1.5.1 from npm: `@johnmorrisdotca/chizu/world` is Miller-projected canvas data centred on 155°E,
+  not longitude/latitude, so chikyu keeps its own Natural Earth 1:110m outlines and d3-geo.
+  [docs/chizu-proposal.md](docs/chizu-proposal.md) proposes the `world-geo` export that would let it share chizu's
+  data later.
+- The demo and test servers move to this work's port block, 8200–8299.
+
 ## 0.2.0
 
 The globe now uses the family's shared view controls.

package/README.md

@@ -44,6 +44,32 @@ Centre it yourself instead:
 <chikyu-earth center="139.7,35.7" style="thick" graticule></chikyu-earth>
 ```
 
+## Controls
+
+The shared [kazoku-ui view controls](https://github.com/johnmorrisdotca/kazoku-ui) supply every hand and button:
+drag to turn, tilt up to either pole, zoom, pan, touch pinch, Front and Fit. Chikyu does not draw its own zoom,
+rotate or drag controls.
+
+```html
+<div id="globe" tabindex="0"><chikyu-earth size="420"></chikyu-earth></div>
+<kazoku-view-controls id="controls" for="globe" address tilt-max="90" speed="0.004178" autoplay></kazoku-view-controls>
+```
+
+```ts
+import "@johnmorrisdotca/kazoku-ui/view-controls/define";
+
+const earth = document.querySelector("chikyu-earth");
+document.getElementById("controls").addEventListener("kazoku-viewchange", (event) => {
+  const { yaw, tilt, zoom, panX, panY, final } = event.detail;
+  earth.setView({ yaw, tilt, zoom, panX, panY }, final);
+});
+```
+
+The mapping is `rotate([lambda0 + yaw, phi0 - tilt])`, `scale(baseScale * zoom)` and
+`translate([cx + panX, cy + panY])`, where `lambda0` and `phi0` are the home centre. Front returns to that home
+view. Auto-turn's `0.004178` degrees a second is 360° per sidereal day; kazoku-ui leaves it still for a reader who
+prefers reduced motion, and a drag or zoom never stops or resets it.
+
 ## Draw one as a string
 
 `globe()` returns the SVG markup, so a server, a build step or a test can draw the same globe with no DOM:
@@ -91,4 +117,5 @@ To refresh the outlines after a Natural Earth or kuni update, run `pnpm countrie
 ## The rest
 
 [CONTRIBUTING.md](CONTRIBUTING.md) · [docs/](docs/index.md) · [NOTICE.md](NOTICE.md) ·
-[CHANGELOG.md](CHANGELOG.md) · MIT licence. Projection by d3-geo; shared view controls by kazoku-ui.
+[CHANGELOG.md](CHANGELOG.md) · MIT licence. No third-party dependencies except d3-geo; shared view controls are
+John Morris's kazoku-ui (MIT).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/chikyu-earth",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Chikyu Earth 地球: a line-drawn globe with country outlines that turns at the Earth's own rate and opens centred on where you are. Country codes and names come from kuni; the outlines are Natural Earth's, drawn with d3-geo. SVG, no canvas.",
   "keywords": [
     "earth",