@johnmorrisdotca/wakusei-planets 0.7.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.11.0 - 2026-11-03
+
+The drag rule, checked with the family's own check.
+
+- **The surface follows the pointer, exactly** (MODULES-224): the demo tells the shared view controls the radius of the body's disc (`grab-radius`, kept up to date as the view is resized or scaled), so a drag of a few pixels moves the ground at the middle of the body by as many pixels, and the touched point stays under the pointer. New `discRadius` on `<wakusei-body>` (the disc's radius on the screen, in CSS pixels).
+- **The check** is kazoku-ui's shared `e2e/ground.mjs` (copied unchanged from its `templates/e2e-ground.mjs`): in Mars (line, realistic and painted), Venus and the Moon a drag right moves the ground right, a drag up moves it up, the arrow keys agree and Auto-turn goes the right way; exact grab is checked in painted Mars and the Moon.
+- **The documentation site is the family's of 2026-11-03** (MODULES-331): a seeded sample of its pages is read in the browser, and the guides show their pictures as real images (`![..](../images/..)`) instead of links, in English and Japanese.
+- The freeze test that counts what the page keeps now counts after two rounds of changes, not one: on a slow runner the first round was still making the rows' pictures, so the count rose once and then stayed flat (24, 24, 24 with the processor slowed four times); a real leak would keep rising.
+- **The Turn button goes the body's real way** (MODULES-203): Mars turns to the right and Venus, which turns backwards, to the left (it turned every body the same way before); a test per direction.
+
+## 0.10.0 - 2026-11-03
+
+Painted maps for five more moons.
+
+- **Tethys, Dione, Iapetus, Triton and Charon are painted** (MODULES-220), from public-domain maps: Cassini's global colour maps of Tethys, Dione and Iapetus (Paul Schenk, PIA18439, PIA18434, PIA18436), Voyager 2's global colour mosaic of Triton (PIA18668) and New Horizons' global map of Charon. Every source file is public domain by its Wikimedia Commons file page, and `NOTICE.md` has each one's credit and what was done to it, including where the map was centred (turned to match known features: Tethys's crater Odysseus, Iapetus's dark Cassini Regio; Triton's centre is from the USGS label of the same mosaic) and the unmapped north of Triton and south of Charon, which are continued smoothly from the real rows.
+- The pictures add 0.45 MB to the package (the 512 and 1024 pixel widths; the 2048 ones are fetched when a view is zoomed in), which makes the pictures 1.94 MB; the test that holds their size now allows 2 MB.
+
+## 0.9.0 - 2026-11-03
+
+The other dwarf planets.
+
+- **Ceres, Orcus, Haumea, Quaoar, Makemake, Gonggong, Eris and Sedna** (MODULES-232), in the line, realistic and painted looks (`DWARF_IDS`, `DwarfId`, `BODIES.eris`...), and the moons whose orbits are published with a date: **Vanth** (Orcus), **Hiʻiaka and Namaka** (Haumea) and **Dysnomia** (Eris). Weywot, Xiangliu and S/2015 (136472) 1 are left out: no orbit with a published phase exists.
+- **Where they are**: `heliocentric()` takes a dwarf planet too, from JPL's Small-Body Database osculating elements of June 2026, run as a plain ellipse. Against JPL Horizons on 2026-11-03 all five checked are within 0.0002 au (a test holds it). The moons' orbits are from Holler et al. 2021 (Dysnomia), Ragozzine & Brown 2009 (Hiʻiaka, Namaka) and Brown et al. 2010 (Vanth); `NOTICE.md` has the sources and says which numbers are estimates (poles that have not been measured are taken along the orbit's pole; the shaded surfaces other than Ceres's are drawn from colours alone).
+- **Haumea and Quaoar are long shapes** (1161 x 852 x 513 km, turning every 3.9 hours; 1241 x 1093 x 1023 km): the line look now draws the outline of a body with `axesKm` as the ellipse it really shows, and its features on that shape (Phobos, Deimos, Proteus, Nix and Hydra too).
+- **Ceres is painted** from Dawn's colourised global map (public domain; the incomplete colour at high latitudes is made the surface's own grey).
+- **The picker has three groups** (MODULES-204): the Sun and the planets, the dwarf planets and the well-known moons (the Moon, Phobos, Deimos, Io, Europa, Ganymede, Callisto, Enceladus, Titan, Triton, Charon), each a click away; the group follows the body chosen and the address keeps the choice. The portrait builder and the code builder have a dwarf planets group too.
+- **Tests that every body turns about its real axis the right way** (MODULES-203): the rotation rate matches the period, and the spin axis of each planet and dwarf planet makes the published axial tilt with its orbit's pole, backwards for Venus, Uranus and Pluto.
+- New entry points `@johnmorrisdotca/wakusei-planets/dwarfs` and `/moons-dwarf`; `/all` has both. `DWARF_IDS`, `DwarfId` and `HostId` (a planet or dwarf planet a moon can go round) are exported; `BODIES` and `BODY_IDS` have 12 more bodies, and the Portrait builder's order puts the dwarf planets after Pluto.
+- The painted pictures of Ceres add 0.13 MB to the package (512 and 1024 pixels wide).
+
+## 0.8.0 - 2026-11-03
+
+The portrait builder at true orbit distance.
+
+- **True orbit distance** (MODULES-283): a fourth arrangement beside row, arc and grid. Each moon is as far from its planet, and each planet from the Sun, as it really is, with the orbits drawn as circles, and the view backed off to hold them all. With a date set, every body is where it is then, seen from above the ecliptic; with none, they are lined up from the Sun along one side. `arrange: "orbit"` in the scene, `?scene=arrange:orbit~...` in the address.
+- **A link from the demo** ("At true orbit distance", under the buttons that show bodies together) opens the same bodies in the portrait builder at true orbit distance, in the look that is chosen.
+
 ## 0.7.0 - 2026-11-03
 
 The portrait builder: any bodies, one picture.

package/NOTICE.md

@@ -11,6 +11,15 @@ No picture is used by the line and shaded looks: they are drawn from numbers.
 - **Moons' orbits**: JPL Solar System Dynamics, "Planetary Satellite Mean Elements" (https://ssd.jpl.nasa.gov/sats/elem/, read 2026-11-02), made into `src/data/orbits.ts` by `scripts/make-moon-data.py`. Credit: NASA/JPL-Caltech; the elements are from R. A. Jacobson and colleagues' ephemerides cited on that page.
 - **The Moon's position**: the largest terms of the series in Jean Meeus, "Astronomical Algorithms" (2nd edition), chapter 47, written out here as numbers; the mean arguments are the standard ones.
 
+## The dwarf planets
+
+Ceres, Orcus, Haumea, Quaoar, Makemake, Gonggong, Eris and Sedna (Pluto is with the planets) and the moons Vanth, Hiʻiaka, Namaka and Dysnomia. Values read on 2026-11-03.
+
+- **Where they are**: NASA/JPL Small-Body Database, osculating elements at JD 2461200.5 (https://ssd.jpl.nasa.gov/api/sbdb.api), run as a plain ellipse (`src/data/dwarf.ts`): good for a few years either side of June 2026, and Ceres, pulled by Jupiter, drifts most.
+- **Sizes and spin**: Ceres (966.2 x 962.0 x 891.8 km) and its pole: Ermakov et al. 2017 (as listed in Wikipedia's Ceres article); its rotation: JPL SBDB (9.074170 h). Haumea: Ortiz et al. 2017, Nature 550:219 (semi-axes 1161 x 852 x 513 km), rotation 3.915341 h from Santos-Sanz et al. 2017, A&A 604:A95, pole from Kondratyev & Kornoukhov 2018, MNRAS 478:3159 (RA 282.6, Dec -13.0). Eris: radius 1163 km, Sicardy et al. 2011; it keeps one face to Dysnomia, so its rotation is Dysnomia's orbital period, Szakats et al. 2023, A&A 669:L3. Makemake: radius 715 km, Brown 2013; rotation 22.8266 h, Hromakina et al. 2019. Gonggong: radius 615 km and rotation 22.4 h, Kiss et al. 2019, Icarus. Quaoar: 1241.4 x 1093.0 x 1023.0 km and 17.6788 h, Margoti et al. 2026 and Pereira et al. 2023. Sedna: radius 453 km (Lellouch et al. 2013, TNOs are Cool IX, which allows far more) and 10.273 h, Gaudi et al. 2005. Orcus: radius 455 km, Brown & Butler 2018, rotation 13.188 h (JPL SBDB; 7 to 21 h in the literature). Wikipedia's articles on each body were the finding aid; the papers are the sources.
+- **Moons' orbits**: Dysnomia, Holler et al. 2021, Icarus 355:114130, Table 2 (arXiv 2009.13733). Hiʻiaka and Namaka, Ragozzine & Brown 2009, AJ 137:4766, Table 2 (osculating elements of 2008; the two moons pull on each other, so the position years later is rough). Vanth, Brown et al. 2010, AJ 139:2700, Table 2, solution 1 of two mirror solutions. Radii: Dysnomia 308 km (Brown & Butler 2023), Vanth 221 km (Sickafoose et al. 2018, occultation), Hiʻiaka and Namaka from the Haumea article's listed diameters (370 and 150 km). Weywot, Xiangliu and Makemake's moon S/2015 (136472) 1 are left out: no orbit with a published phase.
+- **Estimated, not measured** (the pictures say so only here): these bodies' poles are not measured, so each is drawn with its spin axis along its orbit's pole (Quaoar, Makemake, Gonggong, Sedna), along Dysnomia's orbit pole (Eris) or along the far end of Vanth's orbit pole, so that it spins forwards (Orcus). Hiʻiaka's and Namaka's spin is unknown and they are drawn still. Dysnomia and Vanth are assumed to keep one face to their planet. Every drawn feature on the line look of a dwarf planet except Ceres's Occator crater and Haumea's long axis is a generic crater, and so is each shaded (realistic) look: only the colour (from the published colour indices and albedos) and the sizes are from numbers. Ceres, Haumea and Dysnomia's shapes are from the sources above. Only Ceres has a painted look.
+
 The tests compare the Galilean moons and four planets with astronomy-engine (MIT, https://github.com/cosinekitty/astronomy), a development dependency that is never shipped.
 
 ## The Earth
@@ -44,6 +53,12 @@ NASA says its content "generally are not subject to copyright in the United Stat
 | `rhea-*.webp` | Rhea | [Rhea Color Map.jpg](https://commons.wikimedia.org/wiki/File:Rhea_Color_Map.jpg) | Public domain | NASA/JPL-Caltech/Space Science Institute/Lunar and Planetary Institute | Cassini global colour map (PIA18438), turned half way round so longitude 0 is in the middle (the source does not say where it is centred; the dark trailing side is put at 90 degrees east); the colours are false-colour (infrared, green, ultraviolet) and are turned about half way to grey |
 | `enceladus-*.webp` | Enceladus | [Enceladus Color Map.jpg](https://commons.wikimedia.org/wiki/File:Enceladus_Color_Map.jpg) | Public domain | NASA/JPL-Caltech/Space Science Institute/Lunar and Planetary Institute | Cassini global colour map (PIA18435), turned half way round the same way as Rhea's (the source does not say where it is centred; the fractured trailing terrain is put at 90 degrees east); the colours are false-colour (the blue of the tiger stripes is ultraviolet) and are turned most of the way to grey |
 | `mimas-*.webp` | Mimas | [Map of Mimas 2010-02 PIA12780.jpg](https://commons.wikimedia.org/wiki/File:Map_of_Mimas_2010-02_PIA12780.jpg) | Public domain | NASA/JPL/Space Science Institute | Cassini ISS map of February 2010 (PIA12780), cropped inside its frame and labels; Herschel is at 110 degrees west as its own scale says |
+| `ceres-*.webp` | Ceres | [PIA20354-Ceres-DwarfPlanet-MercatorMap-HAMO-20160322-0DegreeLongitude.jpg](https://commons.wikimedia.org/wiki/File:PIA20354-Ceres-DwarfPlanet-MercatorMap-HAMO-20160322-0DegreeLongitude.jpg) | Public domain | NASA/JPL-Caltech/UCLA/MPS/DLR/IDA | Dawn's colourised global map of Ceres (PIA20354, 140 m a pixel), longitude 0 in the middle as the file says (Occator's bright spots fall at 239 degrees east); the green and yellow high latitudes, where Dawn's colour coverage is incomplete (the map says so), are made the surface's own grey keeping their detail, and the last rows with no data repeat the nearest real ones; the colour is turned most of the way to grey |
+| `tethys-*.webp` | Tethys | [Tethys Color Map.jpg](https://commons.wikimedia.org/wiki/File:Tethys_Color_Map.jpg) | Public domain | NASA/JPL-Caltech/Space Science Institute/Lunar and Planetary Institute | Cassini global colour map (PIA18439, Paul Schenk), turned half way round so longitude 0 is in the middle (the source does not say where it is centred; Odysseus, at 129 degrees west, falls at 131 degrees west and the dark trailing side at 90 degrees east); the colours are enhanced (ultraviolet to infrared) and are turned about half way to grey |
+| `dione-*.webp` | Dione | [Dione Color Map.jpg](https://commons.wikimedia.org/wiki/File:Dione_Color_Map.jpg) | Public domain | NASA/JPL-Caltech/Space Science Institute/Lunar and Planetary Institute | Cassini global colour map (PIA18434), turned half way round the same way as Tethys's (the source does not say where it is centred; the dark trailing side with its wispy fractures is put at 90 degrees east); the colours are enhanced and are turned about half way to grey |
+| `iapetus-*.webp` | Iapetus | [Iapetus Color Map.jpg](https://commons.wikimedia.org/wiki/File:Iapetus_Color_Map.jpg) | Public domain | NASA/JPL-Caltech/Space Science Institute/Lunar and Planetary Institute | Cassini global colour map (PIA18436), turned half way round the same way (the source does not say where it is centred; the dark leading side, Cassini Regio, is put at 270 degrees east, 90 degrees west); the colours are enhanced and are turned a third of the way to grey |
+| `triton-*.webp` | Triton | [Triton map no grid.jpg](https://commons.wikimedia.org/wiki/File:Triton_map_no_grid.jpg) | Public domain | NASA/JPL-Caltech/Lunar & Planetary Institute (Paul Schenk; Voyager 2 images) | Voyager 2 global colour mosaic (PIA18668, 600 m a pixel, enhanced colour), as it is: USGS Astrogeology's label of the same mosaic (14138 samples wide) says the map is centred on longitude 0, east positive. Voyager never saw the north (it was in winter's dark), so the black there is continued smoothly from the colour just inside it and fades to the mean colour; the colours are turned a little under half way to grey |
+| `charon-*.webp` | Charon | [Charon map iau1803c.jpg](https://commons.wikimedia.org/wiki/File:Charon_map_iau1803c.jpg) | Public domain | NASA/Johns Hopkins University Applied Physics Laboratory/Southwest Research Institute (via the IAU) | New Horizons global map of Charon (iau1803c, no labels or grid), as it is, with longitude 0 in the middle (the source does not say; the sharp hemisphere New Horizons saw best is the one that faces Pluto, which is longitude 0); the south, in the polar night New Horizons never saw, is continued from the last real rows and fades to the mean grey |
 | `saturn-ring-2048.webp` | Saturn's rings | [Saturn's rings in visible light and radio.jpg](https://commons.wikimedia.org/wiki/File:Saturn's_rings_in_visible_light_and_radio.jpg) | Public domain | NASA / JPL / Space Science Institute | Cassini's natural-colour mosaic of the lit rings (PIA07874, from PIA06175), read along one radius into a strip of 2048 colours and opacities from 74,794 to 137,035 km. The radii are fitted to five edges the picture shows (the B ring's inner edge, the two edges of the Cassini Division, the Encke gap and the A ring's outer edge), each within 300 km. The opacity is taken from the brightness, and the colour balance is moved to match the Saturn portrait above; the F ring and the D ring are not in the picture |
 
-The package does not ship the 2048 pixel widths: `TEXTURE_FAR_BASE` fetches them from this repository by jsDelivr's GitHub address when a view is zoomed in. The 512 and 1024 pixel widths of every picture, and the ring strip, are 1.31 MB in the package (the nine of 0.2.0 were 0.53 MB). Tethys, Dione, Iapetus, Triton and Charon have no picture: Cassini's maps of the first three are not made yet, the source of Triton's map does not give its longitudes, and the only clean public-domain map of Charon is under a grid of labels, so those five keep their drawn look.
+The package does not ship the 2048 pixel widths: `TEXTURE_FAR_BASE` fetches them from this repository by jsDelivr's GitHub address when a view is zoomed in. The 512 and 1024 pixel widths of every picture, and the ring strip, are 1.94 MB in the package (the nine of 0.2.0 were 0.53 MB; Ceres adds 0.13 MB and Tethys, Dione, Iapetus, Triton and Charon 0.45 MB). Where a source does not say where its map is centred, its row says what the picture was matched to.

package/README.md

@@ -13,9 +13,9 @@ A clean line drawing, a shaded realistic drawing, or a painted surface map, with
 
 <p align="center"><a href="https://johnmorrisdotca.github.io/wakusei-planets/"><strong>Open the demo →</strong></a> · <a href="https://johnmorrisdotca.github.io/wakusei-planets/embed.html">Embed page</a> · <a href="https://johnmorrisdotca.github.io/wakusei-planets/docs/">Docs</a></p>
 
-<p align="center"><img alt="Jupiter and Saturn drawn in the realistic look, and Saturn as a line drawing" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.7.0/docs/images/hero-desk.png" width="640"></p>
+<p align="center"><img alt="Jupiter and Saturn drawn in the realistic look, and Saturn as a line drawing" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.11.0/docs/images/hero-desk.png" width="640"></p>
 
-<p align="center"><img alt="Every body at one scale, the Earth among them: each small body has a magnified picture joined by a line, and the Sun shows only its edge" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.7.0/docs/images/lineup-desk.png" width="640"></p>
+<p align="center"><img alt="Every body at one scale, the Earth among them: each small body has a magnified picture joined by a line, and the Sun shows only its edge" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.11.0/docs/images/lineup-desk.png" width="640"></p>
 
 ## One minute
 
@@ -79,7 +79,7 @@ A bundled app imports it: `import "@johnmorrisdotca/wakusei-planets/element"` (a
 
 ## Features
 
-- The Sun, the eight planets, Pluto and 25 moons, each with its real size, flattening, axial tilt, pole and rotation as data.
+- The Sun, the eight planets, Pluto, eight more dwarf planets and 29 moons, each with its real size, flattening, axial tilt, pole and rotation as data.
 - Three looks: a clean `line` drawing (an SVG string), a shaded `realistic` sphere worked out in a shader, and a `painted` surface map from public-domain imagery.
 - The sky for any date and time: a body's pole, rotation, phase and ring opening as the Earth sees it, and a planet's moons where they are then.
 - One WebGL context for the page, nothing drawn at rest, at most thirty frames a second, and everything freed when an element leaves.
@@ -109,7 +109,7 @@ Import the element once in client code, and the entry point of each body you dra
 | `realistic` | A shaded sphere drawn from the body's real colours and features, lit from the Sun's side, with the rings casting shadows. No pictures: the surface is worked out in a shader. | `three`, the body's entry point |
 | `painted` | A real surface map from public-domain NASA, USGS and JPL imagery. Small pictures first (1.31 MB for all of them in the package), a sharper one fetched when you zoom in. | `three`, the body's entry point |
 
-Every body has its real size relative to the others (`scale-to="jupiter"`), its axial tilt and its rotation. The Sun, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune and Pluto are drawn, and so are 25 moons (the Moon, Phobos and Deimos, the four Galilean moons, Saturn's seven larger moons, Uranus's five, Proteus, Triton and Nereid, Charon, Nix and Hydra). The Earth is drawn like the rest in the realistic and painted looks (NASA's Blue Marble), and its line look is [chikyu-earth](https://github.com/johnmorrisdotca/chikyu-earth)'s own globe: `import "@johnmorrisdotca/wakusei-planets/earth"` (it needs `@johnmorrisdotca/chikyu-earth` 0.10.0 or later installed). The painted looks cover the Sun, the planets from Mercury to Earth and Pluto, the Moon, the four Galilean moons, Titan, Rhea, Enceladus and Mimas, and Saturn's rings are Cassini's own picture of them.
+Every body has its real size relative to the others (`scale-to="jupiter"`), its axial tilt and its rotation. The Sun, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune and Pluto are drawn, and so are the eight other dwarf planets (Ceres, Orcus, Haumea, Quaoar, Makemake, Gonggong, Eris and Sedna; Haumea and Quaoar as the long shapes they are, and Ceres with a painted map from Dawn) and 29 moons (the Moon, Phobos and Deimos, the four Galilean moons, Saturn's seven larger moons, Uranus's five, Proteus, Triton and Nereid, Charon, Nix and Hydra, and Vanth, Hiʻiaka, Namaka and Dysnomia, the moons of the dwarf planets whose orbits are published with a date). The Earth is drawn like the rest in the realistic and painted looks (NASA's Blue Marble), and its line look is [chikyu-earth](https://github.com/johnmorrisdotca/chikyu-earth)'s own globe: `import "@johnmorrisdotca/wakusei-planets/earth"` (it needs `@johnmorrisdotca/chikyu-earth` 0.10.0 or later installed). The painted looks cover the Sun, the planets from Mercury to Earth and Pluto, Ceres, the Moon, the four Galilean moons, Saturn's Mimas, Enceladus, Tethys, Dione, Rhea, Titan and Iapetus, Triton and Charon, and Saturn's rings are Cassini's own picture of them.
 
 ## As the Earth sees it
 
@@ -273,9 +273,9 @@ A body that turns by itself and a moving sky, in HTML:
 
 ## The portrait builder
 
-<p align="center"><img alt="The Sun and the planets in an arc, painted, with their names, in the portrait builder" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.7.0/docs/images/portrait-family.png" width="640"></p>
+<p align="center"><img alt="The Sun and the planets in an arc, painted, with their names, in the portrait builder" src="https://raw.githubusercontent.com/johnmorrisdotca/wakusei-planets/v0.11.0/docs/images/portrait-family.png" width="640"></p>
 
-[The portrait builder](https://johnmorrisdotca.github.io/wakusei-planets/portrait.html) puts any bodies in one picture: drag them, size them, turn them, order them front to back, arrange them in a row, an arc or a grid (true or readable sizes, a planet's moons round it in orbit order), light them from one direction, and take the code, a PNG or an SVG. The scene is kept in the address, and every body is drawn in one WebGL scene, so the page holds one WebGL context. [The portrait builder](docs/guides/portrait-builder.md) is its guide.
+[The portrait builder](https://johnmorrisdotca.github.io/wakusei-planets/portrait.html) puts any bodies in one picture: drag them, size them, turn them, order them front to back, arrange them in a row, an arc, a grid or at true orbit distance (true or readable sizes, a planet's moons round it in orbit order), light them from one direction, and take the code, a PNG or an SVG. The scene is kept in the address, and every body is drawn in one WebGL scene, so the page holds one WebGL context. [The portrait builder](docs/guides/portrait-builder.md) is its guide.
 
 ```html
 <script type="module" src="https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets/portrait/+esm"></script>

package/dist/bodies/all.d.ts

@@ -7,6 +7,7 @@ import "./saturn.ts";
 import "./uranus.ts";
 import "./neptune.ts";
 import "./pluto.ts";
+import "./dwarfs.ts";
 import "./earth-look.ts";
 import "./moons-earth.ts";
 import "./moons-mars.ts";
@@ -15,3 +16,4 @@ import "./moons-saturn.ts";
 import "./moons-uranus.ts";
 import "./moons-neptune.ts";
 import "./moons-pluto.ts";
+import "./moons-dwarf.ts";

package/dist/bodies/all.js

@@ -7,6 +7,7 @@ import "./saturn.js";
 import "./uranus.js";
 import "./neptune.js";
 import "./pluto.js";
+import "./dwarfs.js";
 import "./earth-look.js";
 import "./moons-earth.js";
 import "./moons-mars.js";
@@ -15,3 +16,4 @@ import "./moons-saturn.js";
 import "./moons-uranus.js";
 import "./moons-neptune.js";
 import "./moons-pluto.js";
+import "./moons-dwarf.js";

package/dist/bodies/dwarfs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bodies/dwarfs.js

@@ -0,0 +1,31 @@
+import { registerLook } from "../scene/look.js";
+import { ice, rock } from "../scene/recipes.js";
+registerLook({
+    id: "ceres",
+    surface: rock({
+        dark: "#4d4a47",
+        light: "#7e7a75",
+        craters: 1.4,
+        contrast: 0.8,
+        seed: 61,
+        patches: 3,
+        extra: `
+    float occ = oval(p, 239.0, 19.8, 3.4, 3.4, 0.5);
+    col = mix(col, vec3(0.93, 0.93, 0.92), occ * 0.95);`,
+    }),
+    relief: 0.7,
+    ambient: 0.02,
+    painted: { map: "ceres", widths: [512, 1024, 2048], far: 2048 },
+});
+registerLook({ id: "orcus", surface: rock({ dark: "#6f7074", light: "#a9a9ab", craters: 0.5, contrast: 0.5, seed: 63, patches: 2.2 }), relief: 0.5, ambient: 0.02 });
+registerLook({
+    id: "haumea",
+    surface: ice({ base: "#e4e5e8", stain: "#bfc0c4", craters: 0.08, extra: "col = mix(col, vec3(0.50, 0.17, 0.12), oval(p, 40.0, 5.0, 24.0, 13.0, 0.5) * 0.85);" }),
+    relief: 0.3,
+    ambient: 0.02,
+});
+registerLook({ id: "quaoar", surface: rock({ dark: "#7d5844", light: "#b58b72", craters: 0.35, contrast: 0.4, seed: 65, patches: 2.4 }), relief: 0.5, ambient: 0.02 });
+registerLook({ id: "makemake", surface: rock({ dark: "#8e5a3c", light: "#cf9a76", craters: 0.12, contrast: 0.3, seed: 67, patches: 2.8, extra: "col = mix(col, vec3(0.45, 0.25, 0.17), oval(p, 30.0, 10.0, 34.0, 20.0, 0.45) * 0.5);" }), relief: 0.35, ambient: 0.02 });
+registerLook({ id: "gonggong", surface: rock({ dark: "#6e3524", light: "#a9604a", craters: 0.3, contrast: 0.4, seed: 69, patches: 2.5 }), relief: 0.5, ambient: 0.02 });
+registerLook({ id: "eris", surface: ice({ base: "#ece8e0", stain: "#cdc6ba", craters: 0.06 }), atmosphere: { colour: [0.9, 0.9, 0.95], strength: 0.03, power: 5 }, relief: 0.2, ambient: 0.02 });
+registerLook({ id: "sedna", surface: rock({ dark: "#6a2a1b", light: "#a24b34", craters: 0.2, contrast: 0.3, seed: 71, patches: 2.6 }), relief: 0.4, ambient: 0.02 });

package/dist/bodies/moons-dwarf.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bodies/moons-dwarf.js

@@ -0,0 +1,6 @@
+import { registerLook } from "../scene/look.js";
+import { ice, rock } from "../scene/recipes.js";
+registerLook({ id: "dysnomia", surface: rock({ dark: "#3f3d3b", light: "#6c6967", craters: 1.2, contrast: 0.8, seed: 73 }), relief: 0.8, ambient: 0.02 });
+registerLook({ id: "hiiaka", surface: ice({ base: "#e6e6e6", stain: "#c4c4c4", craters: 0.25 }), relief: 0.6, ambient: 0.02 });
+registerLook({ id: "namaka", surface: ice({ base: "#d8d8d8", stain: "#b4b4b4", craters: 0.25 }), relief: 0.6, ambient: 0.02 });
+registerLook({ id: "vanth", surface: rock({ dark: "#55514d", light: "#827d78", craters: 1.2, contrast: 0.8, seed: 75 }), relief: 0.8, ambient: 0.02 });

package/dist/bodies/moons-neptune.js

@@ -7,5 +7,6 @@ registerLook({
     atmosphere: { colour: [0.8, 0.8, 0.9], strength: 0.05, power: 5 },
     ambient: 0.025,
     relief: 0.4,
+    painted: { map: "triton", widths: [512, 1024, 2048], far: 2048 },
 });
 registerLook({ id: "nereid", surface: rock({ dark: "#6e6e6e", light: "#9b9b9b", craters: 1, seed: 40 }), relief: 0.8, ambient: 0.02 });

package/dist/bodies/moons-pluto.js

@@ -1,5 +1,5 @@
 import { registerLook } from "../scene/look.js";
 import { rock } from "../scene/recipes.js";
-registerLook({ id: "charon", surface: rock({ dark: "#756f6a", light: "#aaa29a", craters: 0.7, contrast: 0.7, seed: 41, extra: "col = mix(col, vec3(0.42, 0.20, 0.13), smoothstep(radians(52.0), radians(78.0), lat(p)) * 0.85);" }), relief: 0.6, ambient: 0.02 });
+registerLook({ id: "charon", surface: rock({ dark: "#756f6a", light: "#aaa29a", craters: 0.7, contrast: 0.7, seed: 41, extra: "col = mix(col, vec3(0.42, 0.20, 0.13), smoothstep(radians(52.0), radians(78.0), lat(p)) * 0.85);" }), relief: 0.6, ambient: 0.02, painted: { map: "charon", widths: [512, 1024, 2048], far: 2048 } });
 registerLook({ id: "nix", surface: rock({ dark: "#8d8983", light: "#c9c3b9", craters: 1, contrast: 0.7, seed: 43 }), relief: 0.7, ambient: 0.02 });
 registerLook({ id: "hydra", surface: rock({ dark: "#9e9a92", light: "#d4cec4", craters: 1, contrast: 0.7, seed: 47 }), relief: 0.7, ambient: 0.02 });

package/dist/bodies/moons-saturn.js

@@ -8,8 +8,8 @@ registerLook({
     relief: 0.3,
     painted: { map: "enceladus", widths: [512, 1024, 2048], far: 2048 },
 });
-registerLook({ id: "tethys", surface: rock({ dark: "#8f8d88", light: "#d0cec9", craters: 1.2, contrast: 0.9, seed: 14, patches: 2.2, extra: "float od = bowl(p, 232.0, 5.0, 24.0, 0.6); h += od; col *= 1.0 + 0.7 * od;" }), relief: 0.8, ambient: 0.02 });
-registerLook({ id: "dione", surface: rock({ dark: "#8c8a85", light: "#cdcbc5", craters: 1, contrast: 0.9, seed: 18, patches: 2.6 }), relief: 0.8, ambient: 0.02 });
+registerLook({ id: "tethys", surface: rock({ dark: "#8f8d88", light: "#d0cec9", craters: 1.2, contrast: 0.9, seed: 14, patches: 2.2, extra: "float od = bowl(p, 232.0, 5.0, 24.0, 0.6); h += od; col *= 1.0 + 0.7 * od;" }), relief: 0.8, ambient: 0.02, painted: { map: "tethys", widths: [512, 1024, 2048], far: 2048 } });
+registerLook({ id: "dione", surface: rock({ dark: "#8c8a85", light: "#cdcbc5", craters: 1, contrast: 0.9, seed: 18, patches: 2.6 }), relief: 0.8, ambient: 0.02, painted: { map: "dione", widths: [512, 1024, 2048], far: 2048 } });
 registerLook({ id: "rhea", surface: rock({ dark: "#8a8883", light: "#cac8c2", craters: 1.5, contrast: 0.9, seed: 24, patches: 2 }), relief: 0.85, ambient: 0.02, painted: { map: "rhea", widths: [512, 1024, 2048], far: 2048 } });
 registerLook({
     id: "titan",
@@ -31,4 +31,5 @@ registerLook({
     }),
     relief: 0.7,
     ambient: 0.02,
+    painted: { map: "iapetus", widths: [512, 1024, 2048], far: 2048 },
 });

package/dist/data/dwarf.d.ts

@@ -0,0 +1,16 @@
+import type { DwarfId } from "../facts.ts";
+import type { OrbitElements } from "./orbits.ts";
+/** The osculating heliocentric elements of one epoch. */
+export interface Osculating {
+    /** Milliseconds since 1970. */
+    epoch: number;
+    a: number;
+    e: number;
+    i: number;
+    node: number;
+    w: number;
+    m: number;
+    n: number;
+}
+export declare const DWARF_ELEMENTS: Readonly<Record<DwarfId, Osculating>>;
+export declare const DWARF_MOON_ORBITS: Record<string, OrbitElements>;

package/dist/data/dwarf.js

@@ -0,0 +1,24 @@
+const epoch = 1780963200000;
+export const DWARF_ELEMENTS = {
+    ceres: { epoch, a: 2.765552595034094, e: 0.07969229514816586, i: 10.58802780183462, node: 80.24862682043221, w: 73.29421453021587, m: 274.4193463761342, n: 0.21430445064843 },
+    orcus: { epoch, a: 39.37686537914865, e: 0.2205240628250881, i: 20.55681019612, node: 268.4053519455824, w: 73.56848606705262, m: 189.0972913554275, n: 0.003988800931399829 },
+    haumea: { epoch, a: 43.06029023650952, e: 0.1944430148898797, i: 28.20847393040364, node: 121.7860561329425, w: 240.6905472508661, m: 223.2104118812299, n: 0.003488097731816818 },
+    quaoar: { epoch, a: 43.15617622670811, e: 0.03520019261837198, i: 7.991575800732639, node: 188.9191248092036, w: 163.209046106457, m: 292.8487574842713, n: 0.003476479214379914 },
+    makemake: { epoch, a: 45.57093317300052, e: 0.1588889953992523, i: 29.02785603743067, node: 79.2948338209406, w: 297.0922733397207, m: 169.9379962048232, n: 0.003203850120050116 },
+    gonggong: { epoch, a: 66.86666567773766, e: 0.5042510000302973, i: 30.89906721170288, node: 336.8383156185827, w: 206.6232839773693, m: 111.664541568459, n: 0.001802559348482343 },
+    eris: { epoch, a: 67.93394687853566, e: 0.4382385347971672, i: 43.9258279471791, node: 36.00477044417249, w: 150.7949235840312, m: 211.774434275007, n: 0.001760247770619088 },
+    sedna: { epoch, a: 543.7195289104732, e: 0.8598824585187618, i: 11.92527582847476, node: 144.5061662673739, w: 311.0987725939751, m: 358.5956944005428, n: 7.773948799642578e-05 },
+};
+// Moons of the dwarf planets whose orbit is published with an epoch, so they can be put where they are on a date. Moons with no published phase are left out (Weywot, Xiangliu, S/2015 (136472) 1).
+// Dysnomia: Holler, Grundy, Buie & Noll (2021), "The Eris/Dysnomia system I: The orbit of Dysnomia", Icarus 355:114130, Table 2 (combined fit; epoch JD 2453979.0; the angles are to the J2000 equator;
+//   the table gives the longitude of periapsis 307 and the mean longitude 125.78, so the argument of periapsis is 307 - 126.17 and the mean anomaly 125.78 - 307). Period 15.785899 days.
+// Hiʻiaka and Namaka: Ragozzine & Brown (2009), "Orbits and Masses of the Satellites of the Dwarf Planet Haumea (2003 EL61)", AJ 137:4766, Table 2: osculating elements at HJD 2454615.0, J2000 ecliptic,
+//   the periods from their section III.1. The two moons pull on each other, so a plain ellipse from 2008 is only roughly right years later.
+// Vanth: Brown, Ragozzine, Stansberry & Fraser (2010), "The Size, Density, and Formation of the Orcus-Vanth System in the Kuiper Belt", AJ 139:2700, Table 2, solution 1 of the two mirror solutions
+//   (epoch JD 2454439.280, J2000 ecliptic, a circle). Period 9.5393 days.
+export const DWARF_MOON_ORBITS = {
+    dysnomia: { parent: "eris", frame: "j2000", epoch: 1157025600000, a: 37273, e: 0.0062, w: 180.83, m: 178.78, i: 45.49, node: 126.17, sid: 22.8051630, dw: 0, dn: 0 },
+    hiiaka: { parent: "haumea", frame: "ecliptic", epoch: 1211976000000, a: 49880, e: 0.0513, w: 154.1, m: 152.8, i: 126.356, node: 206.766, sid: 7.2783147, dw: 0, dn: 0 },
+    namaka: { parent: "haumea", frame: "ecliptic", epoch: 1211976000000, a: 25657, e: 0.249, w: 178.9, m: 178.5, i: 113.013, node: 205.016, sid: 19.6954859, dw: 0, dn: 0 },
+    vanth: { parent: "orcus", frame: "ecliptic", epoch: 1196793792000, a: 8980, e: 0, w: 0, m: 143.1, i: 90.2, node: 50.0, sid: 37.7386181, dw: 0, dn: 0 },
+};

package/dist/data/orbits.d.ts

@@ -1,8 +1,8 @@
 export interface OrbitElements {
     /** The planet it goes round. */
     parent: string;
-    /** The reference plane: the ecliptic, the planet's equator, or the Laplace plane whose pole is `pole` (right ascension, declination, degrees). */
-    frame: "ecliptic" | "equatorial" | "laplace";
+    /** The reference plane: the ecliptic, the Earth's equator of J2000, the planet's equator, or the Laplace plane whose pole is `pole` (right ascension, declination, degrees). */
+    frame: "ecliptic" | "j2000" | "equatorial" | "laplace";
     pole?: [number, number];
     /** The epoch of the elements, in milliseconds since 1970. */
     epoch: number;

package/dist/data/orbits.js

@@ -1,3 +1,6 @@
+// Made by scripts/make-moon-data.py from JPL's Planetary Satellite Mean Elements (https://ssd.jpl.nasa.gov/sats/elem/); do not edit by hand.
+// The moons of the dwarf planets are not on that page: their orbits are in dwarf.ts, from the papers it cites, and are added at the end.
+import { DWARF_MOON_ORBITS } from "./dwarf.js";
 export const ORBITS = {
     moon: { parent: "earth", frame: "ecliptic", epoch: 946728000000, a: 384400, e: 0.0554, w: 318.15, m: 135.27, i: 5.16, node: 125.08, sid: 13.1763585, dw: 0.16435, dn: -0.05299 },
     phobos: { parent: "mars", frame: "laplace", pole: [317.7, 52.9], epoch: 946728000000, a: 9375, e: 0.015, w: 216.3, m: 189.7, i: 1.1, node: 169.2, sid: 1128.8443146, dw: -0.74464, dn: -0.42853 },
@@ -24,4 +27,5 @@ export const ORBITS = {
     charon: { parent: "pluto", frame: "equatorial", epoch: 946728000000, a: 19600, e: 0, w: 0, m: 304.1, i: 0, node: 0, sid: 56.3624607, dw: 0.00000, dn: 0.00000 },
     nix: { parent: "pluto", frame: "equatorial", epoch: 946728000000, a: 49300, e: 0.015, w: 31.4, m: 338.2, i: 0, node: 0, sid: 14.4842403, dw: 0.00000, dn: 0.00000 },
     hydra: { parent: "pluto", frame: "equatorial", epoch: 946728000000, a: 65200, e: 0.009, w: 139.3, m: 335, i: 0.3, node: 114.3, sid: 9.4236471, dw: 0.00000, dn: -0.07040 },
+    ...DWARF_MOON_ORBITS,
 };

package/dist/element.d.ts

@@ -25,7 +25,7 @@ export type WakuseiState = "line" | "loading" | "still" | "live" | "lost" | "una
  * console.log(TEXTURE_BASE);
  * ```
  */
-export declare const TEXTURE_BASE = "https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets@0.7.0/dist/textures/";
+export declare const TEXTURE_BASE = "https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets@0.11.0/dist/textures/";
 /**
  * Where the sharpest surface pictures are: the files of this exact version in the repository, on jsDelivr's GitHub address. The npm package holds only the two smaller widths, so a page that
  * never zooms in never fetches them. Set `texture-far-base` on an element to serve them yourself.
@@ -37,7 +37,7 @@ export declare const TEXTURE_BASE = "https://cdn.jsdelivr.net/npm/@johnmorrisdot
  * console.log(TEXTURE_FAR_BASE);
  * ```
  */
-export declare const TEXTURE_FAR_BASE = "https://cdn.jsdelivr.net/gh/johnmorrisdotca/wakusei-planets@v0.7.0/textures/";
+export declare const TEXTURE_FAR_BASE = "https://cdn.jsdelivr.net/gh/johnmorrisdotca/wakusei-planets@v0.11.0/textures/";
 /**
  * The `<wakusei-body>` custom element: a body of the solar system, drawn in a look.
  *
@@ -59,6 +59,8 @@ export declare const TEXTURE_FAR_BASE = "https://cdn.jsdelivr.net/gh/johnmorrisd
 export declare class WakuseiBody extends HTMLElement {
     #private;
     static observedAttributes: string[];
+    /** The radius of the body's disc on the screen in CSS pixels, at the picture's own size: what `grab-radius` on the shared view controls wants for a drag that keeps the touched point under the pointer. */
+    get discRadius(): number;
     get body(): BodyId;
     get look(): Look;
     /** What the element is doing now. */

package/dist/element.js

@@ -145,6 +145,10 @@ export class WakuseiBody extends HTMLElement {
         else
             this.#resume();
     };
+    /** The radius of the body's disc on the screen in CSS pixels, at the picture's own size: what `grab-radius` on the shared view controls wants for a drag that keeps the touched point under the pointer. */
+    get discRadius() {
+        return (this.getBoundingClientRect().width / 2) * this.#fill();
+    }
     get body() {
         const id = this.getAttribute("body");
         return id !== null && id in BODIES ? id : "earth";

package/dist/embed.d.ts

@@ -61,7 +61,7 @@ export interface EmbedSettings {
     /** The package's address on the CDN, with its version. */
     cdn?: string;
 }
-/** The entry point that holds a body's shaded and painted look. */
+/** The entry point that holds a body's shaded and painted look: the body's own, `dwarfs` for the dwarf planets besides Pluto, `moons-<planet>` for a moon and `moons-dwarf` for a moon of a dwarf planet. */
 export declare function entryOf(id: BodyId): string;
 /**
  * The text that puts a body in a page, for one way of making the page. Each way is built, parsed or run by the package's tests: the plain HTML one with a script tag from jsDelivr, an ES module, a React component,

package/dist/embed.js

@@ -1,6 +1,6 @@
 // The text to put a body in a page, for each way a page is made: a script tag from a CDN, an ES module, React, Vue, Angular, Svelte, or an iframe of `embed.html`. The demo's "Put it in your page"
 // section shows these as the reader changes a choice, and the tests build or parse every one. Pure: no DOM.
-import { BODIES } from "./facts.js";
+import { BODIES, DWARF_IDS } from "./facts.js";
 import { decodeScene } from "./portrait/model.js";
 import { VERSION } from "./version.js";
 /**
@@ -17,10 +17,12 @@ export const EMBED_KINDS = ["html", "module", "react", "vue", "angular", "svelte
 const SITE = "https://johnmorrisdotca.github.io/wakusei-planets/";
 const CDN = `https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets@${VERSION}`;
 const PACKAGE = "@johnmorrisdotca/wakusei-planets";
-/** The entry point that holds a body's shaded and painted look. */
+/** The entry point that holds a body's shaded and painted look: the body's own, `dwarfs` for the dwarf planets besides Pluto, `moons-<planet>` for a moon and `moons-dwarf` for a moon of a dwarf planet. */
 export function entryOf(id) {
     const parent = BODIES[id].parent;
-    return parent === undefined ? id : `moons-${parent}`;
+    if (parent === undefined)
+        return DWARF_IDS.includes(id) ? "dwarfs" : id;
+    return DWARF_IDS.includes(parent) ? "moons-dwarf" : `moons-${parent}`;
 }
 /** The attributes of the element for these choices, in the order they are written. */
 function attributesOf(o) {

package/dist/ephemeris.d.ts

@@ -1,10 +1,10 @@
-import { type BodyId, type MoonId, type PlanetId } from "./facts.ts";
+import { type BodyId, type HostId, type MoonId } from "./facts.ts";
 import { type Vec3 } from "./vec.ts";
 /** Solve Kepler's equation for the eccentric anomaly, all in radians. */
 export declare function kepler(meanAnomaly: number, e: number): number;
 /**
- * A planet's position in the Sun's frame (J2000 ecliptic, astronomical units) at a time, from JPL's approximate elements.
- * @param planet - The planet's name.
+ * A planet's or dwarf planet's position in the Sun's frame (J2000 ecliptic, astronomical units) at a time: a planet from JPL's approximate elements, a dwarf planet from the osculating elements of one epoch (JPL's Small-Body Database).
+ * @param planet - The planet's or dwarf planet's name.
  * @param ms - The instant, in milliseconds since 1970.
  * @returns The position as x, y, z in au.
  *
@@ -16,7 +16,7 @@ export declare function kepler(meanAnomaly: number, e: number): number;
  * console.log(Math.hypot(x, y, z).toFixed(3));
  * ```
  */
-export declare function heliocentric(planet: PlanetId, ms: number): Vec3;
+export declare function heliocentric(planet: HostId, ms: number): Vec3;
 /**
  * The Moon's position from the Earth's centre (J2000 ecliptic, kilometres), from the largest terms of Meeus's lunar series.
  * @param ms - The instant, in milliseconds since 1970.
@@ -164,7 +164,7 @@ export interface System {
  * console.log(moons.map((moon) => `${moon.id} ${moon.x.toFixed(1)}`).join(", "));
  * ```
  */
-export declare function system(planet: PlanetId, time: number): System;
+export declare function system(planet: HostId, time: number): System;
 /**
  * The path one moon follows round its planet over one trip, as the Earth sees it at `time`: x, y, z in planet radii, in the viewer's frame at that moment.
  *
@@ -183,7 +183,7 @@ export declare function system(planet: PlanetId, time: number): System;
  */
 export declare function orbitPath(id: MoonId, time: number, points?: number): Float32Array;
 /** The planets' moons that are near enough to draw in a system view, nearest first, with how far each goes in planet radii. */
-export declare function nearMoons(planet: PlanetId, within?: number): {
+export declare function nearMoons(planet: HostId, within?: number): {
     id: MoonId;
     reach: number;
 }[];

package/dist/ephemeris.js

@@ -3,6 +3,7 @@
 // good to about an arc minute. The Moon: the largest terms of Meeus, "Astronomical Algorithms", chapter 47. Other moons: JPL's mean elements (data/orbits.ts).
 // Light travel time is allowed for, so a turning planet shows the face it really showed when the light left. Pure: no DOM, no three.js.
 import { ORBITS } from "./data/orbits.js";
+import { DWARF_ELEMENTS } from "./data/dwarf.js";
 import { BODIES, MOONS_OF } from "./facts.js";
 import { add, cross, DEG, dot, fromRaDec, length, OBLIQUITY, RAD, scale, sub, toEcliptic, unit, wrap360 } from "./vec.js";
 /** Milliseconds since 1970 at J2000.0 (2000-01-01 12:00 TT, taken as UTC). */
@@ -42,8 +43,8 @@ export function kepler(meanAnomaly, e) {
     return E;
 }
 /**
- * A planet's position in the Sun's frame (J2000 ecliptic, astronomical units) at a time, from JPL's approximate elements.
- * @param planet - The planet's name.
+ * A planet's or dwarf planet's position in the Sun's frame (J2000 ecliptic, astronomical units) at a time: a planet from JPL's approximate elements, a dwarf planet from the osculating elements of one epoch (JPL's Small-Body Database).
+ * @param planet - The planet's or dwarf planet's name.
  * @param ms - The instant, in milliseconds since 1970.
  * @returns The position as x, y, z in au.
  *
@@ -56,16 +57,34 @@ export function kepler(meanAnomaly, e) {
  * ```
  */
 export function heliocentric(planet, ms) {
-    const el = ELEMENTS[planet];
-    const T = centuries(ms);
-    const a = el[0] + el[6] * T;
-    const e = el[1] + el[7] * T;
-    const I = (el[2] + el[8] * T) * RAD;
-    const L = el[3] + el[9] * T;
-    const peri = el[4] + el[10] * T;
-    const node = (el[5] + el[11] * T) * RAD;
-    const w = peri * RAD - node;
-    const E = kepler((L - peri) * RAD, e);
+    let a;
+    let e;
+    let I;
+    let node;
+    let w;
+    let E;
+    const dwarf = DWARF_ELEMENTS[planet];
+    if (dwarf !== undefined) {
+        // a dwarf planet: the osculating elements of one epoch, run as a plain ellipse (good for years either side of it)
+        a = dwarf.a;
+        e = dwarf.e;
+        I = dwarf.i * RAD;
+        node = dwarf.node * RAD;
+        w = dwarf.w * RAD;
+        E = kepler((dwarf.m + (dwarf.n * (ms - dwarf.epoch)) / DAY) * RAD, e);
+    }
+    else {
+        const el = ELEMENTS[planet];
+        const T = centuries(ms);
+        a = el[0] + el[6] * T;
+        e = el[1] + el[7] * T;
+        I = (el[2] + el[8] * T) * RAD;
+        const L = el[3] + el[9] * T;
+        const peri = el[4] + el[10] * T;
+        node = (el[5] + el[11] * T) * RAD;
+        w = peri * RAD - node;
+        E = kepler((L - peri) * RAD, e);
+    }
     const x = a * (Math.cos(E) - e);
     const y = a * Math.sqrt(1 - e * e) * Math.sin(E);
     const cw = Math.cos(w);
@@ -231,6 +250,8 @@ export function moonVector(id, ms) {
 function referenceBasis(orbit) {
     if (orbit.frame === "ecliptic")
         return { x: [1, 0, 0], y: [0, 1, 0], z: [0, 0, 1] };
+    if (orbit.frame === "j2000")
+        return { x: toEcliptic([1, 0, 0]), y: toEcliptic([0, 1, 0]), z: toEcliptic([0, 0, 1]) };
     const pole = orbit.frame === "laplace" && orbit.pole !== undefined ? orbit.pole : [BODIES[orbit.parent].pole.ra, BODIES[orbit.parent].pole.dec];
     const z = fromRaDec(pole[0], pole[1]);
     const x = fromRaDec(pole[0] + 90, 0);

package/dist/facts.d.ts

@@ -10,7 +10,18 @@
  */
 export declare const PLANET_IDS: readonly ["mercury", "venus", "earth", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
 /**
- * The moons the package draws, by planet.
+ * The dwarf planets besides Pluto, nearest the Sun first (by the size of their orbits).
+ *
+ * @example
+ * ```ts
+ * import { DWARF_IDS } from "@johnmorrisdotca/wakusei-planets";
+ *
+ * console.log(DWARF_IDS.join(", "));
+ * ```
+ */
+export declare const DWARF_IDS: readonly ["ceres", "orcus", "haumea", "quaoar", "makemake", "gonggong", "eris", "sedna"];
+/**
+ * The moons the package draws, by planet or dwarf planet.
  *
  * @example
  * ```ts
@@ -27,6 +38,9 @@ export declare const MOONS_OF: {
     readonly uranus: readonly ["miranda", "ariel", "umbriel", "titania", "oberon"];
     readonly neptune: readonly ["proteus", "triton", "nereid"];
     readonly pluto: readonly ["charon", "nix", "hydra"];
+    readonly orcus: readonly ["vanth"];
+    readonly haumea: readonly ["hiiaka", "namaka"];
+    readonly eris: readonly ["dysnomia"];
 };
 /**
  * The name of a planet or of Pluto: `mercury` to `pluto`.
@@ -40,6 +54,30 @@ export declare const MOONS_OF: {
  * ```
  */
 export type PlanetId = (typeof PLANET_IDS)[number];
+/**
+ * The name of a dwarf planet besides Pluto: `ceres`, `eris`, `haumea`...
+ *
+ * @example
+ * ```ts
+ * import { DWARF_IDS, type DwarfId } from "@johnmorrisdotca/wakusei-planets";
+ *
+ * const id: DwarfId = DWARF_IDS[0];
+ * console.log(id);
+ * ```
+ */
+export type DwarfId = (typeof DWARF_IDS)[number];
+/**
+ * A body a moon can go round: a planet, Pluto or another dwarf planet.
+ *
+ * @example
+ * ```ts
+ * import { MOONS_OF, type HostId } from "@johnmorrisdotca/wakusei-planets";
+ *
+ * const host: HostId = "eris";
+ * console.log(MOONS_OF[host]);
+ * ```
+ */
+export type HostId = PlanetId | DwarfId;
 /**
  * The name of a moon the package draws, such as `moon`, `io` or `titan`.
  *
@@ -53,7 +91,7 @@ export type PlanetId = (typeof PLANET_IDS)[number];
  */
 export type MoonId = (typeof MOONS_OF)[keyof typeof MOONS_OF][number];
 /**
- * The name of a body: `sun`, a planet or a moon.
+ * The name of a body: `sun`, a planet, a dwarf planet or a moon.
  *
  * @example
  * ```ts
@@ -63,7 +101,7 @@ export type MoonId = (typeof MOONS_OF)[keyof typeof MOONS_OF][number];
  * console.log(lineSvg(id, { size: 64 }).length > 100);
  * ```
  */
-export type BodyId = "sun" | PlanetId | MoonId;
+export type BodyId = "sun" | PlanetId | DwarfId | MoonId;
 /**
  * How a body is drawn: `line` (an outline drawing), `realistic` (shaded, from the numbers) or `painted` (a real surface map).
  *
@@ -139,8 +177,8 @@ export type Feature = {
 export interface BodyFacts {
     id: BodyId;
     kind: "star" | "planet" | "dwarf-planet" | "moon";
-    /** The planet a moon goes round. */
-    parent?: PlanetId;
+    /** The planet or dwarf planet a moon goes round. */
+    parent?: HostId;
     name: {
         en: string;
         ja: string;
@@ -186,7 +224,7 @@ export interface BodyFacts {
  */
 export declare const BODIES: Readonly<Record<BodyId, BodyFacts>>;
 /**
- * Every body's name: the Sun, the planets outward, then the moons of each planet.
+ * Every body's name: the Sun, the planets outward, the dwarf planets, then the moons of each.
  *
  * @example
  * ```ts

package/dist/facts.js

@@ -12,7 +12,18 @@
  */
 export const PLANET_IDS = ["mercury", "venus", "earth", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
 /**
- * The moons the package draws, by planet.
+ * The dwarf planets besides Pluto, nearest the Sun first (by the size of their orbits).
+ *
+ * @example
+ * ```ts
+ * import { DWARF_IDS } from "@johnmorrisdotca/wakusei-planets";
+ *
+ * console.log(DWARF_IDS.join(", "));
+ * ```
+ */
+export const DWARF_IDS = ["ceres", "orcus", "haumea", "quaoar", "makemake", "gonggong", "eris", "sedna"];
+/**
+ * The moons the package draws, by planet or dwarf planet.
  *
  * @example
  * ```ts
@@ -29,6 +40,9 @@ export const MOONS_OF = {
     uranus: ["miranda", "ariel", "umbriel", "titania", "oberon"],
     neptune: ["proteus", "triton", "nereid"],
     pluto: ["charon", "nix", "hydra"],
+    orcus: ["vanth"],
+    haumea: ["hiiaka", "namaka"],
+    eris: ["dysnomia"],
 };
 const f = (id, kind, en, ja, radiusKm, flattening, tiltDeg, ra, dec, w0, rate, rotationHours, colour, more = {}) => ({
     id,
@@ -131,6 +145,17 @@ export const BODIES = {
             ...dots([[-60, 20, 6], [-100, -20, 7], [60, 40, 5]]),
         ],
     }),
+    ceres: f("ceres", "dwarf-planet", "Ceres", "ケレス", 481.05, 0.0731, 4.04, 291.42744, 66.76033, 170.65, 952.1532, 9.07417, "#7b7873", {
+        showLon: 239,
+        features: [{ kind: "circle", lon: 239, lat: 20, radius: 6 }, { kind: "circle", lon: 239, lat: 20, radius: 1.5, fill: true }, { kind: "circle", lon: 10, lat: -42, radius: 10 }, ...dots([[-60, 30, 8], [100, 15, 9], [160, -20, 7], [-120, -35, 8], [40, 45, 6], [-20, 0, 5]])],
+    }),
+    orcus: f("orcus", "dwarf-planet", "Orcus", "オルクス", 455, 0, 73.83, 142.474, 15.004, 0, 655.15, 13.188, "#9a9a9c", { features: dots([[-60, 20, 9], [40, -15, 7], [130, 30, 8], [-130, -30, 6]]) }),
+    haumea: f("haumea", "dwarf-planet", "Haumea", "ハウメア", 798, 0, 90.15, 282.6, -13, 0, 2206.6, 3.915341, "#dfe0e3", { showLon: 90, axesKm: [1161, 852, 513], features: [{ kind: "oval", lon: 40, lat: 5, rx: 22, ry: 12, fill: true }, { kind: "band", lat: 0 }, ...dots([[-80, 25, 7]])] }),
+    quaoar: f("quaoar", "dwarf-planet", "Quaoar", "クワオアー", 557.8, 0, 0, 265.4, 74.409, 0, 488.72, 17.6788, "#a3735a", { showLon: 90, axesKm: [620.7, 546.5, 511.5], features: dots([[-40, 20, 8], [70, -15, 9], [150, 35, 7], [-110, -30, 6]]) }),
+    makemake: f("makemake", "dwarf-planet", "Makemake", "マケマケ", 715, 0.01, 0, 317.92, 50.03, 0, 378.5, 22.8266, "#b87f5d", { features: [{ kind: "oval", lon: 30, lat: 10, rx: 30, ry: 18, fill: true }, ...dots([[-70, -20, 8], [120, 25, 7]])] }),
+    gonggong: f("gonggong", "dwarf-planet", "Gonggong", "ゴンゴン", 615, 0, 0, 255.383, 36.831, 0, 385.7, 22.4, "#9c4f3b", { features: dots([[-50, 10, 9], [60, -25, 8], [140, 30, 7]]) }),
+    eris: f("eris", "dwarf-planet", "Eris", "エリス", 1163, 0, 78.22, 36.17, 44.51, 0, 22.805163, 378.8616, "#e8e4dc", { features: [{ kind: "band", lat: 0 }, ...dots([[-30, 30, 8], [80, -20, 9]])] }),
+    sedna: f("sedna", "dwarf-planet", "Sedna", "セドナ", 453, 0, 0, 297.062, 74.71, 0, 840.95, 10.273, "#9a3f2b", { features: dots([[-40, 20, 9], [70, -30, 8], [150, 10, 7]]) }),
     moon: f("moon", "moon", "Moon", "月", 1737.4, 0.0012, 6.68, 269.9949, 66.5392, 38.3213, 13.17635815, 655.728, "#b8b5ae", {
         parent: "earth",
         synchronous: true,
@@ -169,9 +194,13 @@ export const BODIES = {
     charon: f("charon", "moon", "Charon", "カロン", 606, 0, 0, 132.993, -6.163, 122.695, 56.3625225, 153.2935, "#9c9189", { parent: "pluto", synchronous: true, features: [{ kind: "oval", lon: 0, lat: 76, rx: 90, ry: 14, fill: true }, { kind: "circle", lon: 40, lat: -15, radius: 12 }, ...dots([[-60, 10, 8], [120, 30, 7]])] }),
     nix: f("nix", "moon", "Nix", "ニクス", 19.3, 0.3, 0, 132.993, -6.163, 0, 14.48, 0, "#b3ada7", { parent: "pluto", axesKm: [24.9, 16.6, 15.6], features: [{ kind: "circle", lon: 0, lat: 0, radius: 18 }] }),
     hydra: f("hydra", "moon", "Hydra", "ヒドラ", 19.5, 0.4, 0, 132.993, -6.163, 0, 9.42, 0, "#c4beb6", { parent: "pluto", axesKm: [32.5, 22.5, 12.5], features: [{ kind: "circle", lon: 30, lat: 10, radius: 20 }] }),
+    vanth: f("vanth", "moon", "Vanth", "ヴァント", 221, 0, 0, 142.474, 15.004, 0, 37.738618, 228.9488, "#6e6a66", { parent: "orcus", synchronous: true, features: dots([[-50, 15, 10], [80, -20, 9], [150, 30, 8]]) }),
+    hiiaka: f("hiiaka", "moon", "Hiʻiaka", "ヒイアカ", 185, 0, 0, 282.6, -13, 0, 0, 0, "#e0e0e0", { parent: "haumea", features: dots([[-30, 20, 12], [70, -25, 10]]) }),
+    namaka: f("namaka", "moon", "Namaka", "ナマカ", 75, 0, 0, 282.6, -13, 0, 0, 0, "#d0d0d0", { parent: "haumea", features: dots([[0, 0, 14]]) }),
+    dysnomia: f("dysnomia", "moon", "Dysnomia", "ディスノミア", 308, 0, 0, 36.17, 44.51, 0, 22.805163, 378.8616, "#5a5856", { parent: "eris", synchronous: true, features: dots([[-60, 20, 10], [50, -25, 9], [140, 30, 8]]) }),
 };
 /**
- * Every body's name: the Sun, the planets outward, then the moons of each planet.
+ * Every body's name: the Sun, the planets outward, the dwarf planets, then the moons of each.
  *
  * @example
  * ```ts
@@ -180,7 +209,7 @@ export const BODIES = {
  * console.log(BODY_IDS.length, BODY_IDS[0]);
  * ```
  */
-export const BODY_IDS = ["sun", ...PLANET_IDS, ...Object.values(MOONS_OF).flat()];
+export const BODY_IDS = ["sun", ...PLANET_IDS, ...DWARF_IDS, ...Object.values(MOONS_OF).flat()];
 /** A body's polar radius as a fraction of its equatorial radius. */
 export const polarRatio = (facts) => 1 - facts.flattening;
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { BODIES, BODY_IDS, MOONS_OF, PLANET_IDS, ringReach, type BodyFacts, type BodyId, type Feature, type Look, type MoonId, type PlanetId, type RingBand } from "./facts.ts";
+export { BODIES, BODY_IDS, DWARF_IDS, MOONS_OF, PLANET_IDS, ringReach, type BodyFacts, type BodyId, type DwarfId, type Feature, type HostId, type Look, type MoonId, type PlanetId, type RingBand } from "./facts.ts";
 export { apparent, moonGeocentric, heliocentric, orbitPath, system, type Apparent, type MoonPlace, type Pose, type System } from "./ephemeris.ts";
 export { drawnTilt, portrait, type PortraitOptions } from "./pose.ts";
 export { lineSvg, mix, type LineOptions } from "./line.ts";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { BODIES, BODY_IDS, MOONS_OF, PLANET_IDS, ringReach } from "./facts.js";
+export { BODIES, BODY_IDS, DWARF_IDS, MOONS_OF, PLANET_IDS, ringReach } from "./facts.js";
 export { apparent, moonGeocentric, heliocentric, orbitPath, system } from "./ephemeris.js";
 export { drawnTilt, portrait } from "./pose.js";
 export { lineSvg, mix } from "./line.js";

package/dist/line.js

@@ -54,12 +54,15 @@ function around(lon, lat, rx, ry, steps = 28) {
     }
     return out;
 }
+/** The semi-axes of a body that is far from round, as fractions of its radius. */
+const axesOf = (facts) => (facts.axesKm === undefined ? undefined : [facts.axesKm[0] / facts.radiusKm, facts.axesKm[1] / facts.radiusKm, facts.axesKm[2] / facts.radiusKm]);
 function featurePaths(facts, pose, frame, stroke, hair) {
     const f = facts.flattening;
-    const visible = (lon, lat) => facing(pose, lon, lat, f) > 0.02;
+    const axes = axesOf(facts);
+    const visible = (lon, lat) => facing(pose, lon, lat, f, axes) > 0.02;
     const out = [];
     const draw = (pts, close, fill) => {
-        const parts = runs(pts.map((p) => surfacePoint(pose, p.lon, p.lat, f)), (_, i) => visible(pts[i].lon, pts[i].lat));
+        const parts = runs(pts.map((p) => surfacePoint(pose, p.lon, p.lat, f, axes)), (_, i) => visible(pts[i].lon, pts[i].lat));
         for (const part of parts) {
             const whole = close && part.length === pts.length;
             if (part.length < 2)
@@ -176,7 +179,7 @@ function cachedOrbit(id, time) {
 }
 function bodyGroup(id, pose, frame, o, hair, ringScale) {
     const facts = BODIES[id];
-    const sil = silhouette(pose, facts.flattening);
+    const sil = silhouette(pose, facts.flattening, axesOf(facts));
     const disc = `<ellipse cx="${n(frame.cx)}" cy="${n(frame.cy)}" rx="${n(frame.r * sil.a)}" ry="${n(frame.r * sil.b)}" transform="rotate(${n(sil.angle)} ${n(frame.cx)} ${n(frame.cy)})"`;
     const rings = ringPaths(facts, pose, frame, o.stroke, hair, ringScale);
     const dark = id === "sun" || facts.kind === "star" ? "" : nightPath(pose, frame);
@@ -227,7 +230,7 @@ export function lineSvg(id, options = {}) {
     if (options.moons === true && facts.parent === undefined && id !== "sun")
         return systemSvg(id, options, size, stroke, paper, hair, head);
     const pose = poseFor(id, options);
-    const reach = Math.max(ringReach(facts), id === "sun" ? 1.08 : 1);
+    const reach = Math.max(ringReach(facts), id === "sun" ? 1.08 : 1, ...(axesOf(facts) ?? []));
     const fit = options.fill === undefined ? 0.94 / reach : options.fill;
     const zoom = options.zoom ?? 1;
     const frame = { cx: (size / 2) * (1 - (options.panX ?? 0)), cy: (size / 2) * (1 + (options.panY ?? 0)), r: (size / 2) * fit * zoom };

package/dist/portrait/model.d.ts

@@ -108,7 +108,7 @@ export interface Resolved {
 }
 export declare const ASPECTS: readonly (readonly [string, number])[];
 export declare const MAX_ITEMS = 40;
-/** The Sun, then each planet followed by its moons nearest first: the order a layout and a row of buttons use. */
+/** The Sun, then each planet and dwarf planet followed by its moons nearest first: the order a layout and a row of buttons use. */
 export declare const ORDER: readonly BodyId[];
 export declare const rankOf: (id: BodyId) => number;
 /**
@@ -285,7 +285,7 @@ export interface Preset {
     scene: Portrait;
 }
 /**
- * Ready-made scenes to start from: a family photo of the Sun and the planets, the gas giants to scale, Jupiter and the Galileans, and the Earth and the Moon to scale.
+ * Ready-made scenes to start from: a family photo of the Sun and the planets, the gas giants to scale, Jupiter and the Galileans, the Earth and the Moon to scale (size and distance), Mars and its moons at their true distance, and the inner planets round the Sun.
  *
  * @example
  * ```ts

package/dist/portrait/model.js

@@ -1,11 +1,12 @@
 // The portrait builder's scene as plain data, and everything that can be worked out from it without a screen: where each body goes when the layout is automatic, the camera that fits them,
 // which body is under a pointer, where a dragged body snaps, the order they are drawn in, the history for undo, and the short text that keeps a scene in the address. Pure: no DOM, no three.js.
 import { ORBITS } from "../data/orbits.js";
-import { BODIES, MOONS_OF, PLANET_IDS, ringReach } from "../facts.js";
+import { heliocentric, moonVector } from "../ephemeris.js";
+import { BODIES, DWARF_IDS, MOONS_OF, PLANET_IDS, ringReach } from "../facts.js";
 export const ASPECTS = [["16:9", 16 / 9], ["4:3", 4 / 3], ["1:1", 1], ["3:4", 3 / 4]];
 export const MAX_ITEMS = 40;
-/** The Sun, then each planet followed by its moons nearest first: the order a layout and a row of buttons use. */
-export const ORDER = ["sun", ...PLANET_IDS.flatMap((planet) => [planet, ...(planet in MOONS_OF ? [...MOONS_OF[planet]].sort(byDistance) : [])])];
+/** The Sun, then each planet and dwarf planet followed by its moons nearest first: the order a layout and a row of buttons use. */
+export const ORDER = ["sun", ...[...PLANET_IDS, ...DWARF_IDS].flatMap((planet) => [planet, ...(planet in MOONS_OF ? [...MOONS_OF[planet]].sort(byDistance) : [])])];
 function byDistance(a, b) {
     return (ORBITS[a]?.a ?? 0) - (ORBITS[b]?.a ?? 0);
 }
@@ -122,6 +123,130 @@ function arrangeUnits(units, how, aspect) {
     }
     return out;
 }
+// --- the true orbit distance layout ---------------------------------------------------------------------------------------------------------------------
+const AU_KM = 149_597_870.7;
+const J2000 = Date.UTC(2000, 0, 1, 12);
+/**
+ * The orbit layout, in kilometres: the Sun (if it is in the scene) with the planets at their true distance, each planet with its moons at theirs; or each planet with its moons, side by side.
+ * With a date the bodies are where they really are, seen from above the ecliptic; without one they are in a line to the right of their centre. Sizes are true, or squeezed so the smallest can be seen.
+ */
+function orbitLayout(p) {
+    const items = p.items;
+    const ms = p.date === undefined ? undefined : Date.parse(p.date);
+    const when = ms !== undefined && Number.isFinite(ms) ? ms : undefined;
+    const index = new Map(items.map((i, k) => [i.body, k]));
+    const planetKind = (id) => BODIES[id].parent === undefined && id !== "sun";
+    const planetSpot = (id) => {
+        const v = heliocentric(id, when ?? J2000);
+        return when === undefined ? { x: Math.hypot(v[0], v[1], v[2]) * AU_KM, y: 0 } : { x: v[0] * AU_KM, y: v[1] * AU_KM };
+    };
+    const moonSpot = (id) => {
+        if (when === undefined)
+            return { x: ORBITS[id]?.a ?? 0, y: 0 };
+        const v = moonVector(id, when);
+        return { x: v[0], y: v[1] };
+    };
+    const systems = [];
+    const taken = new Set();
+    const sun = index.get("sun");
+    const attachMoons = (system, planet, at) => {
+        for (const [k, item] of items.entries()) {
+            if (BODIES[item.body].parent !== items[planet].body || taken.has(k))
+                continue;
+            const m = moonSpot(item.body);
+            system.members.push(k);
+            system.spot.set(k, { x: at.x + m.x, y: at.y + m.y });
+            system.centre.set(k, planet);
+            taken.add(k);
+        }
+    };
+    if (sun !== undefined) {
+        const system = { members: [sun], spot: new Map([[sun, { x: 0, y: 0 }]]), centre: new Map() };
+        taken.add(sun);
+        for (const [k, item] of items.entries()) {
+            if (!planetKind(item.body))
+                continue;
+            const at = planetSpot(item.body);
+            system.members.push(k);
+            system.spot.set(k, at);
+            system.centre.set(k, sun);
+            taken.add(k);
+            attachMoons(system, k, at);
+        }
+        systems.push(system);
+    }
+    for (const [k, item] of items.entries()) {
+        if (taken.has(k) || !planetKind(item.body))
+            continue;
+        const system = { members: [k], spot: new Map([[k, { x: 0, y: 0 }]]), centre: new Map() };
+        taken.add(k);
+        if (p.moons === "auto")
+            attachMoons(system, k, { x: 0, y: 0 });
+        systems.push(system);
+    }
+    for (const [k] of items.entries()) {
+        if (taken.has(k))
+            continue;
+        systems.push({ members: [k], spot: new Map([[k, { x: 0, y: 0 }]]), centre: new Map() });
+        taken.add(k);
+    }
+    // sizes: true, or squeezed against the size of the picture the distances make
+    const ids = items.map((i) => i.body);
+    let span = 0;
+    for (const system of systems) {
+        for (const k of system.members) {
+            const c = system.centre.get(k);
+            if (c === undefined)
+                continue;
+            const a = system.spot.get(k);
+            const b = system.spot.get(c);
+            span = Math.max(span, Math.hypot(a.x - b.x, a.y - b.y));
+        }
+    }
+    const biggest = Math.max(...ids.map((id) => BODIES[id].radiusKm));
+    span = Math.max(span, biggest * 8);
+    const radius = (id) => (p.scale === "true" ? BODIES[id].radiusKm : Math.max(0.014 * span, 0.06 * span * (BODIES[id].radiusKm / biggest) ** 0.4));
+    const raw = items.map((item, index2) => ({ ...item, index: index2, x: 0, y: 0, r: radius(item.body), reach: radius(item.body) * reachOf(item.body) }));
+    // the circle each body goes round its centre on reaches this far every way
+    const extent = (system) => {
+        let minX = Infinity;
+        let maxX = -Infinity;
+        let minY = Infinity;
+        let maxY = -Infinity;
+        for (const k of system.members) {
+            const a = system.spot.get(k);
+            const reach = raw[k].reach;
+            minX = Math.min(minX, a.x - reach);
+            maxX = Math.max(maxX, a.x + reach);
+            minY = Math.min(minY, a.y - reach);
+            maxY = Math.max(maxY, a.y + reach);
+            const c = system.centre.get(k);
+            if (c !== undefined) {
+                const b = system.spot.get(c);
+                const d = Math.hypot(a.x - b.x, a.y - b.y);
+                minX = Math.min(minX, b.x - d);
+                maxX = Math.max(maxX, b.x + d);
+                minY = Math.min(minY, b.y - d);
+                maxY = Math.max(maxY, b.y + d);
+            }
+        }
+        return { minX, maxX, minY, maxY };
+    };
+    const extents = systems.map(extent);
+    const units = systems.map((s, k) => ({ members: s.members, at: [], minX: extents[k].minX, maxX: extents[k].maxX, halfH: Math.max(extents[k].maxY, -extents[k].minY) }));
+    const spots = arrangeUnits(units, "row", p.aspect);
+    const reachPoints = [];
+    systems.forEach((s, k) => {
+        const dy = (extents[k].minY + extents[k].maxY) / 2;
+        for (const m of s.members) {
+            const a = s.spot.get(m);
+            raw[m].x = spots[k].ox + a.x;
+            raw[m].y = a.y - dy;
+        }
+        reachPoints.push({ x: spots[k].ox + extents[k].minX, y: extents[k].minY - dy }, { x: spots[k].ox + extents[k].maxX, y: extents[k].maxY - dy });
+    });
+    return { placed: raw, reachPoints };
+}
 /** The camera that holds every body with a margin: its centre and half-height. */
 export function fitCamera(placed, aspect, margin = 1.1, labels = false) {
     if (placed.length === 0)
@@ -161,6 +286,12 @@ export function resolve(scene) {
     if (p.layout === "manual" || p.items.length === 0) {
         return { placed: p.items.map((item, index) => ({ ...item, index, reach: item.r * reachOf(item.body) })), camera: p.camera };
     }
+    if (p.arrange === "orbit") {
+        const { placed: raw, reachPoints } = orbitLayout(p);
+        const cam = fitCamera([...raw, ...reachPoints.map((q) => ({ x: q.x, y: q.y, reach: 0 }))], p.aspect, 1.1, p.labels);
+        const k = 1 / cam.h;
+        return { placed: raw.map((it) => ({ ...it, x: (it.x - cam.x) * k, y: (it.y - cam.y) * k, r: it.r * k, reach: it.reach * k })), camera: { x: 0, y: 0, h: 1 } };
+    }
     const ids = p.items.map((item) => item.body);
     const sizes = sizesFor(ids, p.scale);
     const grouped = groups(p.items, p.moons);
@@ -561,7 +692,7 @@ export function decodeScene(text) {
 }
 const fromList = (ids, change = {}) => ids.reduce((p, id) => addBody(p, id), { ...defaultPortrait(), ...change });
 /**
- * Ready-made scenes to start from: a family photo of the Sun and the planets, the gas giants to scale, Jupiter and the Galileans, and the Earth and the Moon to scale.
+ * Ready-made scenes to start from: a family photo of the Sun and the planets, the gas giants to scale, Jupiter and the Galileans, the Earth and the Moon to scale (size and distance), Mars and its moons at their true distance, and the inner planets round the Sun.
  *
  * @example
  * ```ts
@@ -574,5 +705,7 @@ export const PRESETS = [
     { id: "family", name: { en: "Family photo", ja: "家族写真" }, scene: fromList(["sun", ...PLANET_IDS], { arrange: "arc", scale: "readable", moons: "manual", orbits: false }) },
     { id: "giants", name: { en: "Gas giants", ja: "巨大ガス惑星" }, scene: fromList(["jupiter", "saturn", "uranus", "neptune"], { arrange: "row", scale: "true", moons: "manual", bg: "gradient" }) },
     { id: "galileans", name: { en: "Jupiter and the Galileans", ja: "木星とガリレオ衛星" }, scene: fromList(["jupiter", "io", "europa", "ganymede", "callisto"], { arrange: "row", scale: "readable", moons: "auto", orbits: true }) },
-    { id: "earthmoon", name: { en: "Earth and Moon to scale", ja: "地球と月 (大きさの比)" }, scene: fromList(["earth", "moon"], { arrange: "row", scale: "true", moons: "auto", orbits: true }) },
+    { id: "earthmoon", name: { en: "Earth and Moon to scale", ja: "地球と月 (大きさと距離の比)" }, scene: fromList(["earth", "moon"], { arrange: "orbit", scale: "true", moons: "auto", orbits: true }) },
+    { id: "marsmoons", name: { en: "Mars and its moons at true distance", ja: "火星と衛星 (本当の距離)" }, scene: fromList(["mars", "phobos", "deimos"], { arrange: "orbit", scale: "readable", moons: "auto", orbits: true }) },
+    { id: "orrery", name: { en: "The inner planets round the Sun", ja: "太陽と内側の惑星 (本当の距離)" }, scene: fromList(["sun", "mercury", "venus", "earth", "mars"], { arrange: "orbit", scale: "readable", moons: "auto", orbits: true, bg: "black" }) },
 ];

package/dist/portrait/overlay.js

@@ -64,8 +64,9 @@ export function shapesOf(p, resolved, width, height, lang = "en", edit) {
     const out = { circles: [], lines: [], texts: [] };
     const byBody = new Map(resolved.placed.map((q) => [q.body, q]));
     if (p.orbits) {
+        const sun = p.arrange === "orbit" ? byBody.get("sun") : undefined;
         for (const moon of resolved.placed) {
-            const host = BODIES[moon.body].parent === undefined ? undefined : byBody.get(BODIES[moon.body].parent);
+            const host = BODIES[moon.body].parent === undefined ? (moon.body === "sun" ? undefined : sun) : byBody.get(BODIES[moon.body].parent);
             if (host === undefined)
                 continue;
             const d = Math.hypot(moon.x - host.x, moon.y - host.y) * at.scale;

package/dist/pose.d.ts

@@ -50,12 +50,14 @@ export declare const drawnTilt: (facts: BodyFacts) => number;
  * ```
  */
 export declare function portrait(id: BodyId, options?: PortraitOptions): Pose;
-/** A longitude and latitude (degrees) as a point on the body, in the viewer's frame (unit radius): x right, y up, z toward the viewer. The flattening squeezes it along the pole. */
-export declare function surfacePoint(pose: Pose, lon: number, lat: number, flattening?: number): Vec3;
+/** The semi-axes of a body that is not a spheroid, as fractions of its radius: along its longitude 0, along its east and along its pole. */
+export type Axes = readonly [number, number, number];
+/** A longitude and latitude (degrees) as a point on the body, in the viewer's frame (unit radius): x right, y up, z toward the viewer. The flattening squeezes it along the pole; `axes` shape a triaxial body instead. */
+export declare function surfacePoint(pose: Pose, lon: number, lat: number, flattening?: number, axes?: Axes): Vec3;
 /** The outward normal's z at a longitude and latitude: positive when that point faces the viewer. */
-export declare function facing(pose: Pose, lon: number, lat: number, flattening?: number): number;
-/** The silhouette of a body: its half-width, half-height along the pole's direction and the angle of the pole from straight up, clockwise, in degrees. */
-export declare function silhouette(pose: Pose, flattening: number): {
+export declare function facing(pose: Pose, lon: number, lat: number, flattening?: number, axes?: Axes): number;
+/** The silhouette of a body: its half-width, half-height along the pole's direction and the angle of the pole from straight up, clockwise, in degrees. With `axes` it is the outline of a triaxial body: its long half-width, its short one and the angle of the long one from straight right, clockwise. */
+export declare function silhouette(pose: Pose, flattening: number, axes?: Axes): {
     a: number;
     b: number;
     angle: number;

package/dist/pose.js

@@ -43,26 +43,40 @@ export function portrait(id, options = {}) {
     const light = unit([-Math.sin(phase) * Math.cos(lift), Math.sin(lift), Math.cos(phase) * Math.cos(lift)]);
     return { pole, meridian, light };
 }
-/** A longitude and latitude (degrees) as a point on the body, in the viewer's frame (unit radius): x right, y up, z toward the viewer. The flattening squeezes it along the pole. */
-export function surfacePoint(pose, lon, lat, flattening = 0) {
+/** A longitude and latitude (degrees) as a point on the body, in the viewer's frame (unit radius): x right, y up, z toward the viewer. The flattening squeezes it along the pole; `axes` shape a triaxial body instead. */
+export function surfacePoint(pose, lon, lat, flattening = 0, axes) {
     const cl = Math.cos(lat * RAD);
     const east = cross(pose.pole, pose.meridian);
-    const x = cl * Math.cos(lon * RAD);
-    const y = cl * Math.sin(lon * RAD);
-    const z = Math.sin(lat * RAD) * (1 - flattening);
+    const x = cl * Math.cos(lon * RAD) * (axes?.[0] ?? 1);
+    const y = cl * Math.sin(lon * RAD) * (axes?.[1] ?? 1);
+    const z = Math.sin(lat * RAD) * (axes?.[2] ?? 1 - flattening);
     return [pose.meridian[0] * x + east[0] * y + pose.pole[0] * z, pose.meridian[1] * x + east[1] * y + pose.pole[1] * z, pose.meridian[2] * x + east[2] * y + pose.pole[2] * z];
 }
 /** The outward normal's z at a longitude and latitude: positive when that point faces the viewer. */
-export function facing(pose, lon, lat, flattening = 0) {
+export function facing(pose, lon, lat, flattening = 0, axes) {
     const cl = Math.cos(lat * RAD);
     const east = cross(pose.pole, pose.meridian);
-    const x = cl * Math.cos(lon * RAD);
-    const y = cl * Math.sin(lon * RAD);
-    const z = Math.sin(lat * RAD) / (1 - flattening);
+    const x = (cl * Math.cos(lon * RAD)) / (axes?.[0] ?? 1);
+    const y = (cl * Math.sin(lon * RAD)) / (axes?.[1] ?? 1);
+    const z = Math.sin(lat * RAD) / (axes?.[2] ?? 1 - flattening);
     return pose.meridian[2] * x + east[2] * y + pose.pole[2] * z;
 }
-/** The silhouette of a body: its half-width, half-height along the pole's direction and the angle of the pole from straight up, clockwise, in degrees. */
-export function silhouette(pose, flattening) {
+/** The silhouette of a body: its half-width, half-height along the pole's direction and the angle of the pole from straight up, clockwise, in degrees. With `axes` it is the outline of a triaxial body: its long half-width, its short one and the angle of the long one from straight right, clockwise. */
+export function silhouette(pose, flattening, axes) {
+    if (axes !== undefined) {
+        const east = cross(pose.pole, pose.meridian);
+        const cols = [
+            [pose.meridian[0] * axes[0], pose.meridian[1] * axes[0]],
+            [east[0] * axes[1], east[1] * axes[1]],
+            [pose.pole[0] * axes[2], pose.pole[1] * axes[2]],
+        ];
+        const sxx = cols.reduce((t, c) => t + c[0] * c[0], 0);
+        const syy = cols.reduce((t, c) => t + c[1] * c[1], 0);
+        const sxy = cols.reduce((t, c) => t + c[0] * c[1], 0);
+        const mean = (sxx + syy) / 2;
+        const spread = Math.sqrt(((sxx - syy) / 2) ** 2 + sxy * sxy);
+        return { a: Math.sqrt(mean + spread), b: Math.sqrt(Math.max(0, mean - spread)), angle: -0.5 * Math.atan2(2 * sxy, sxx - syy) * DEG };
+    }
     const c = 1 - flattening;
     const s = pose.pole[2];
     return { a: 1, b: Math.sqrt(c * c * (1 - s * s) + s * s), angle: Math.atan2(pose.pole[0], pose.pole[1]) * DEG };

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.11.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.7.0";
+export const VERSION = "0.11.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/wakusei-planets",
-  "version": "0.7.0",
+  "version": "0.11.0",
   "description": "Wakusei Planets 惑星 — The Sun, planets and moons for the web: each as a clean line drawing, a shaded realistic drawing or a painted surface map, with real sizes, axial tilt and rotation as data, and positions of the moons for any date and time. SVG for the lines, three.js (optional) for the rest.",
   "keywords": [
     "planets",
@@ -119,6 +119,11 @@
       "import": "./dist/bodies/pluto.js",
       "default": "./dist/bodies/pluto.js"
     },
+    "./dwarfs": {
+      "types": "./dist/bodies/dwarfs.d.ts",
+      "import": "./dist/bodies/dwarfs.js",
+      "default": "./dist/bodies/dwarfs.js"
+    },
     "./moons-earth": {
       "types": "./dist/bodies/moons-earth.d.ts",
       "import": "./dist/bodies/moons-earth.js",
@@ -154,6 +159,11 @@
       "import": "./dist/bodies/moons-pluto.js",
       "default": "./dist/bodies/moons-pluto.js"
     },
+    "./moons-dwarf": {
+      "types": "./dist/bodies/moons-dwarf.d.ts",
+      "import": "./dist/bodies/moons-dwarf.js",
+      "default": "./dist/bodies/moons-dwarf.js"
+    },
     "./package.json": "./package.json",
     "./earth": {
       "types": "./dist/bodies/earth.d.ts",