@johnmorrisdotca/wakusei-planets 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0
+
+The first release. The package, to the family's standard from the start: a demo and an embed page on GitHub Pages, a documentation site in English and Japanese, a README with every way to use it (each one tested), the shared release workflow with its freeze test.
+
+- Line drawings, as SVG strings and as `<wakusei-body look="line">`, of the Sun, Mercury, Venus, Mars, Jupiter, Saturn (with its rings), Uranus (with its rings), Neptune and Pluto, and of the Moon, Phobos and Deimos, the Galilean moons, Saturn's seven larger moons, Uranus's five, Neptune's Proteus, Triton and Nereid, and Pluto's Charon, Nix and Hydra: real relative sizes, axial tilt and rotation as data.
+- The Earth, through a thin adapter over chikyu-earth's own globe (`/earth`, chikyu-earth an optional peer): its line globe, and its Earth from space when the body is live. No second copy.
+- Shaded realistic drawings with three.js through kazoku-ui's shared renderer, each body its own optional entry point: bands, spots, craters, caps and the Pluto heart worked out in a shader, rings that cast shadows, the Sun's glow.
+- The sky for a date and time: a body's pole, rotation, phase and ring opening as the Earth sees it, and a planet's moons on their orbits where they are then (JPL elements, Meeus for the Moon), worked out about once a second and carried forward between.
+- One WebGL context per page, nothing drawn at rest, thirty frames a second at most, canvas within 4096 pixels a side and 6 MP, everything freed, no drawing out of sight, reduced motion respected, a lost context recovers; tested by `pnpm test:freeze` and a soak.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Morris
+
+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.

package/NOTICE.md

@@ -0,0 +1,24 @@
+# Notice
+
+Wakusei Planets is original work by John Morris, under the MIT licence in `LICENSE`.
+
+## The numbers
+
+No picture is used by the line and shaded looks: they are drawn from numbers.
+
+- **Sizes, flattening, axial tilt, poles and rotation**: the IAU Working Group on Cartographic Coordinates and Rotational Elements, B. A. Archinal et al. (2018), "Report of the IAU Working Group on Cartographic Coordinates and Rotational Elements: 2015", Celestial Mechanics and Dynamical Astronomy 130:22, and NASA's planetary and satellite fact sheets (https://nssdc.gsfc.nasa.gov/planetary/factsheet/, read 2026-11-02). Facts are not copyrightable; the values were typed from these sources.
+- **Planet positions**: JPL Solar System Dynamics, "Keplerian Elements for Approximate Positions of the Major Planets", Table 1, 1800 AD to 2050 AD (https://ssd.jpl.nasa.gov/planets/approx_pos.html, read 2026-11-02; Pluto from the same page's earlier edition). NASA/JPL content is not subject to copyright in the United States; credit: NASA/JPL-Caltech.
+- **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 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
+
+The Earth is drawn by chikyu-earth (MIT, by John Morris; https://github.com/johnmorrisdotca/chikyu-earth), an optional peer dependency: its own NOTICE.md has the terms of its outlines and its NASA pictures.
+
+## Surface pictures
+
+None yet. When the painted looks arrive, each picture will be listed here with its source and licence, checked per file.
+
+NASA says its content "generally are not subject to copyright in the United States" and asks for acknowledgement (https://www.nasa.gov/nasa-brand-center/images-and-media/). This package is not endorsed by NASA and uses none of NASA's insignia or logotype.

package/README.md

@@ -1,3 +1,215 @@
-# Temporary Holding Version
+<h1 align="center">Wakusei Planets <sub>惑星</sub></h1>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center"><strong>The Sun, the planets and their moons, for the web.</strong><br>
+A clean line drawing, a shaded realistic drawing, or (soon) a painted surface map, with each body's real size, axial tilt and rotation as data, and a planet's moons where they are at any date and time.</p>
+
+<p align="center">
+  <a href="https://github.com/johnmorrisdotca/wakusei-planets/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/johnmorrisdotca/wakusei-planets/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="./LICENSE"><img alt="MIT licence" src="https://img.shields.io/badge/licence-MIT-2f5d4a"></a>
+  <img alt="TypeScript" src="https://img.shields.io/badge/types-TypeScript-3178c6">
+</p>
+
+<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="docs/images/hero-desk.png" width="640"></p>
+
+## One minute
+
+```sh
+npm install @johnmorrisdotca/wakusei-planets
+```
+
+A page with no build step needs one tag. `look="line"` is an SVG and needs nothing else:
+
+```html
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Wakusei Planets from jsDelivr</title>
+    <script type="module" src="https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets/element/+esm"></script>
+  </head>
+  <body>
+    <wakusei-body body="saturn" look="line" size="320"></wakusei-body>
+  </body>
+</html>
+```
+
+The same tag with the shared [kazoku-ui](https://github.com/johnmorrisdotca/kazoku-ui) controls, which turn, tip, zoom and pan the body:
+
+```html
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Wakusei Planets with the shared controls</title>
+    <script type="module">
+      import "https://cdn.jsdelivr.net/npm/@johnmorrisdotca/kazoku-ui/view-controls/define/+esm";
+      import "https://cdn.jsdelivr.net/npm/@johnmorrisdotca/wakusei-planets/element/+esm";
+
+      const body = document.querySelector("wakusei-body");
+      document.querySelector("kazoku-view-controls").addEventListener("kazoku-viewchange", (event) => {
+        body.setView(event.detail);
+      });
+    </script>
+  </head>
+  <body>
+    <div id="view" tabindex="0">
+      <wakusei-body body="saturn" look="line" size="420"></wakusei-body>
+    </div>
+    <kazoku-view-controls for="view" address controls="advanced" tilt-max="90" speed="0"></kazoku-view-controls>
+  </body>
+</html>
+```
+
+A bundled app imports it: `import "@johnmorrisdotca/wakusei-planets/element"` (and `import { lineSvg } from "@johnmorrisdotca/wakusei-planets"` for the SVG string, which needs no browser). For the shaded look add the body's own entry point, `import "@johnmorrisdotca/wakusei-planets/jupiter"`, and `three` (an optional peer).
+
+## Three looks
+
+| Look | What it is | Needs |
+|---|---|---|
+| `line` | A clean outline drawing with the body's key features: bands, craters, rings and their gaps, caps, the dark side dashed off. An SVG. | nothing |
+| `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 imagery. Small pictures first, sharper when you zoom in. | arriving in a later version |
+
+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 [chikyu-earth](https://github.com/johnmorrisdotca/chikyu-earth)'s own globe, not a second copy: `import "@johnmorrisdotca/wakusei-planets/earth"` (it needs `@johnmorrisdotca/chikyu-earth` installed). The painted looks follow.
+
+## As the Earth sees it
+
+Give a body a `time` and it is drawn as the sky shows it then: its pole and rotation, how far the rings are open (Saturn's rings are edge-on in March 2025), the phase of the Moon or Venus, the Sun's direction.
+
+```html
+<wakusei-body body="saturn" look="realistic" time="2026-11-02T12:00:00Z"></wakusei-body>
+```
+
+## Every way to use it
+
+| How | Where |
+|---|---|
+| A script tag from jsDelivr or unpkg, a shaded body from a CDN | [CDN guide](docs/guides/html-and-cdn.md) |
+| An ES module in Vite or webpack, only the bodies you need | [bundlers guide](docs/guides/bundlers.md) |
+| React, Vue, Svelte, Angular; Next.js, Nuxt, SvelteKit | [frameworks guide](docs/guides/frameworks.md) |
+| An `<iframe>` of the embed page, no script of your own | [iframe guide](docs/guides/embed-in-an-iframe.md) |
+| TypeScript types, an SVG string on a server, Node | [TypeScript and Node guide](docs/guides/typescript-and-node.md) |
+| The looks, the entry points, one WebGL context | [looks and bodies](docs/guides/looks-and-bodies.md) |
+| Moons where they are on a date, time that runs fast | [moons and time](docs/guides/moons-and-time.md) |
+| Something does not appear | [troubleshooting](docs/guides/troubleshooting.md) |
+
+The guides are also in Japanese (日本語), one language to a page: [docs/guides/ja/](docs/guides/ja/getting-started.md).
+
+In React, with the browser-only import where a server render never reaches it:
+
+```tsx
+import { useEffect } from "react";
+
+export function WakuseiBody({ body = "saturn", look = "line" }: { body?: string; look?: "line" | "realistic" }) {
+  useEffect(() => {
+    // The element needs a browser, so it is imported here, never at the top of the file: a server render never reaches an effect.
+    void import("@johnmorrisdotca/wakusei-planets/element");
+    void import("@johnmorrisdotca/wakusei-planets/all");
+  }, []);
+  return <wakusei-body body={body} look={look} />;
+}
+```
+
+Vue, Svelte and Angular components, the Vite and webpack setups and an `<iframe>` are in the guides, each one built and opened in a browser by `pnpm test:usage`.
+
+## Light by design
+
+A page full of bodies stays light: one WebGL context for the page through kazoku-ui's shared renderer (the body in focus is live, the others are pictures), nothing drawn while nothing changes, at most thirty frames a second while it moves, a canvas held to 4096 pixels a side and six million pixels, everything freed when an element leaves, no drawing out of sight or in a hidden tab, no movement for a reader who prefers reduced motion, and a lost WebGL context coming back by itself. The tests count draws, animation frames, contexts and GPU objects at rest and over many changes (`pnpm test:freeze`, and a soak with `pnpm test:soak`).
+
+## The element
+
+| Attribute | What it does | Default |
+| --- | --- | --- |
+| `body` | The body's name. | `earth` |
+| `look` | `line`, `realistic` or `painted`. | `line` |
+| `size` | The width in pixels. | `320` |
+| `time` | `now` or an ISO date: the body as the Earth sees it then. Left out, a portrait. | portrait |
+| `moons` | A planet with its moons on their orbits (with a date). | off |
+| `rate` | Simulated seconds for each real second. | `1` |
+| `turn` | A portrait turns this many degrees a second. | `0` |
+| `tilt`, `pitch`, `phase`, `meridian` | A portrait's pose in degrees. | the body's own |
+| `scale-to` | Draw to scale with another body. | fills its box |
+| `live` | `always`, `hover` or `off`: when a shaded body takes the page's one WebGL context. | `always` |
+| `lang` | `en` or `ja` for names and labels. | `en` |
+
+The pure side has no DOM: `BODIES`, `apparent(id, time)`, `system(planet, time)`, `orbitPath`, `portrait` and `lineSvg(id, options)`.
+
+## The data
+
+Sizes, flattening, poles and rotation are the IAU's and NASA's; planet positions are JPL's approximate elements; the Moon's are Meeus's largest terms; the other moons are JPL's mean elements. Nothing is fetched at run time, and no picture is used by the line and shaded looks. See [NOTICE.md](NOTICE.md).
+
+## The name
+
+Wakusei (惑星, わくせい) is Japanese for a planet.
+
+## The family
+
+<!-- family:start (made by scripts/family-readme.mjs from scripts/family-template.mjs; change those, not this) -->
+Wakusei Planets is one of thirty-four packages, each made for the same site, each at
+[github.com/johnmorrisdotca](https://github.com/johnmorrisdotca) or [github.com/spxis](https://github.com/spxis). The code of every one is MIT.
+
+**Games — board**
+
+- [Domino](https://github.com/johnmorrisdotca/domino) (ドミノ): dominoes and Mexican Train. [Demo](https://johnmorrisdotca.github.io/domino/).
+- [Gunjin](https://github.com/johnmorrisdotca/gunjin) (軍人): five hidden-rank strategy games with pass-the-device play. [Demo](https://johnmorrisdotca.github.io/gunjin/).
+- [Narabe](https://github.com/johnmorrisdotca/narabe) (並べ): one rules engine for abstract board games, from gomoku and Reversi to Go and checkers. [Demo](https://johnmorrisdotca.github.io/narabe/).
+- [Sugoroku](https://github.com/johnmorrisdotca/sugoroku) (双六): backgammon and its variants, with the doubling cube and match play. [Demo](https://johnmorrisdotca.github.io/sugoroku/).
+- [Tenka](https://github.com/johnmorrisdotca/tenka) (天下): world conquest for two to six, on a map of the real world. [Demo](https://johnmorrisdotca.github.io/tenka/).
+
+**Games — cards & tiles**
+
+- [Hitotsu](https://github.com/johnmorrisdotca/hitotsu) (一つ): a colour-card shedding game for two to eight, with the house rules people play. [Demo](https://johnmorrisdotca.github.io/hitotsu/).
+- [Jarajara](https://github.com/johnmorrisdotca/jarajara) (ジャラジャラ): mahjong tiles drawn as SVG, stacked layouts, and the matching solitaire Awase. [Demo](https://johnmorrisdotca.github.io/jarajara/).
+- [Kumimoji](https://github.com/johnmorrisdotca/kumimoji) (組み文字): a crossword tile race, in English and Japanese kana. [Demo](https://johnmorrisdotca.github.io/kumimoji/).
+- [Toranpu](https://github.com/johnmorrisdotca/toranpu) (トランプ): a deck of playing cards, card games with computer players, and solitaires. [Demo](https://johnmorrisdotca.github.io/toranpu/).
+
+**Games — puzzles**
+
+- [Houseki](https://github.com/johnmorrisdotca/houseki) (宝石): gem and stone matching puzzles: falling triplets, stone collapse, colour chains and gem swap. [Demo](https://johnmorrisdotca.github.io/houseki/).
+- [Jirai](https://github.com/johnmorrisdotca/jirai) (地雷): minesweeper on shaped grids with verified no-guess boards. [Demo](https://johnmorrisdotca.github.io/jirai/).
+- [Karakuri](https://github.com/johnmorrisdotca/karakuri) (からくり): eight hyper-casual puzzle games, some of them physics: draw a shield, pull pins, cut ropes, slide blocks, pour tubes. [Demo](https://johnmorrisdotca.github.io/karakuri/).
+- [Kazu](https://github.com/johnmorrisdotca/kazu) (数): grid number puzzles: Sudoku and its variants, Futoshiki and Skyscrapers. [Demo](https://johnmorrisdotca.github.io/kazu/).
+- [Kyuubu](https://github.com/johnmorrisdotca/kyuubu) (キューブ): a turning cube for the browser, 2×2 to 7×7, with record solves to replay. [Demo](https://johnmorrisdotca.github.io/kyuubu/).
+- [Meikyuu](https://github.com/johnmorrisdotca/meikyuu) (迷宮): mazes on squares, hexagons, triangles and circles, made from a seed and drawn through with a finger or the mouse. [Demo](https://johnmorrisdotca.github.io/meikyuu/).
+- [Suido](https://github.com/johnmorrisdotca/suido) (水道): a pipe puzzle: turn the pieces until the water reaches every drain. [Demo](https://johnmorrisdotca.github.io/suido/).
+- [Tobiishi](https://github.com/johnmorrisdotca/tobiishi) (飛び石): peg solitaire with nine boards and seeded solvable challenges. [Demo](https://johnmorrisdotca.github.io/tobiishi/).
+- [Tsunagi](https://github.com/johnmorrisdotca/tsunagi) (繋ぎ): a line-joining logic puzzle whose every level has exactly one answer. [Demo](https://johnmorrisdotca.github.io/tsunagi/).
+
+**Games — dice & random**
+
+- [Korokoro](https://github.com/johnmorrisdotca/korokoro) (コロコロ): dice, with notation, exact odds, real sounds and the dice of many games. [Demo](https://johnmorrisdotca.github.io/korokoro/).
+- [Tane](https://github.com/johnmorrisdotca/tane) (種): seeded random numbers and daily seeds, the same in every browser and on every server. [Demo](https://johnmorrisdotca.github.io/tane/).
+
+**Language**
+
+- [Bushu](https://github.com/johnmorrisdotca/bushu) (部首): find a kanji by the parts it is made of. [Demo](https://johnmorrisdotca.github.io/bushu/).
+- [Hikidashi](https://github.com/johnmorrisdotca/hikidashi) (引き出し): a drawer of small Japanese text tools: era dates, kanji numerals, readings and sentence difficulty. [Demo](https://johnmorrisdotca.github.io/hikidashi/).
+- [Kotoba](https://github.com/johnmorrisdotca/kotoba) (言葉): word lists and word-game rules in English, French, German and Japanese. [Demo](https://johnmorrisdotca.github.io/kotoba/).
+
+**Geography & data**
+
+- [address-plus](https://github.com/johnmorrisdotca/address-plus) (アドレスプラス): parse and format addresses in the United States, Canada, Japan, Australia, France, Germany and the United Kingdom. [Demo](https://johnmorrisdotca.github.io/address-plus/).
+- [Chikyu Earth](https://github.com/johnmorrisdotca/chikyu-earth) (地球): a line-drawn globe that turns at the Earth's own rate, with an optional realistic Earth from space and markers for any place. [Demo](https://johnmorrisdotca.github.io/chikyu-earth/).
+- [Chizu](https://github.com/johnmorrisdotca/chizu) (地図): maps of the world and of countries' regions, in English and Japanese, with a quiz and callouts. [Demo](https://johnmorrisdotca.github.io/chizu/).
+- [Hata](https://github.com/johnmorrisdotca/hata) (旗): country and regional flags as SVG, at their true proportions and keyed by ISO code. [Demo](https://johnmorrisdotca.github.io/hata/).
+- [Kuni](https://github.com/johnmorrisdotca/kuni) (国): countries and their regions, with ISO codes and names in English and Japanese. [Demo](https://johnmorrisdotca.github.io/kuni/).
+- [Wakusei Planets](https://github.com/johnmorrisdotca/wakusei-planets) (惑星): the Sun, the planets and their moons, as line drawings, shaded drawings and painted surface maps, with their real sizes, tilt and rotation. [Demo](https://johnmorrisdotca.github.io/wakusei-planets/).
+
+**Sports**
+
+- [Dougu Sports](https://github.com/johnmorrisdotca/dougu-sports) (道具): sports emblems as SVG: trophies, medals, crests, and the ball and gear of every sport, with optional 3D turning. [Demo](https://johnmorrisdotca.github.io/dougu-sports/).
+- [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
+- [Senshu Jerseys](https://github.com/johnmorrisdotca/senshu-jerseys) (選手): sports jerseys, sweaters, kits, caps, helmets and retired-number banners as SVG, front and back, with optional 2.5D turning. [Demo](https://johnmorrisdotca.github.io/senshu-jerseys/).
+- [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
+
+**Developer tools**
+
+- [REST in Pieces](https://github.com/spxis/rest-in-pieces) (レスト・イン・ピーシーズ): seeded test data and REST APIs for frontend development, with latency and error drills. [Demo](https://spxis.github.io/rest-in-pieces/).
+
+
+**This package is Wakusei Planets.** The demos of all thirty-four share one header and footer, so each links the rest.
+<!-- family:end -->

package/dist/bodies/all.d.ts

@@ -0,0 +1,15 @@
+import "./sun.ts";
+import "./mercury.ts";
+import "./venus.ts";
+import "./mars.ts";
+import "./jupiter.ts";
+import "./saturn.ts";
+import "./uranus.ts";
+import "./neptune.ts";
+import "./pluto.ts";
+import "./moons-mars.ts";
+import "./moons-jupiter.ts";
+import "./moons-saturn.ts";
+import "./moons-uranus.ts";
+import "./moons-neptune.ts";
+import "./moons-pluto.ts";

package/dist/bodies/all.js

@@ -0,0 +1,15 @@
+import "./sun.js";
+import "./mercury.js";
+import "./venus.js";
+import "./mars.js";
+import "./jupiter.js";
+import "./saturn.js";
+import "./uranus.js";
+import "./neptune.js";
+import "./pluto.js";
+import "./moons-mars.js";
+import "./moons-jupiter.js";
+import "./moons-saturn.js";
+import "./moons-uranus.js";
+import "./moons-neptune.js";
+import "./moons-pluto.js";

package/dist/bodies/earth.d.ts

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

package/dist/bodies/earth.js

@@ -0,0 +1,23 @@
+import { delegates } from "../scene/store.js";
+// The Earth is drawn by chikyu-earth's own elements, not a second copy of them: the line globe with the countries, and the Earth from space with the real Sun, clouds and night lights.
+// chikyu-earth is an optional peer, loaded only when an Earth is drawn.
+const CENTRE = "10,20";
+delegates.set("earth", {
+    async line({ center, size }) {
+        await import("@johnmorrisdotca/chikyu-earth/element");
+        const globe = document.createElement("chikyu-earth");
+        globe.setAttribute("center", center || CENTRE);
+        globe.setAttribute("look", "line");
+        globe.setAttribute("size", String(size));
+        return globe;
+    },
+    async live({ center, time, textureBase }) {
+        await import("@johnmorrisdotca/chikyu-earth/realistic/element");
+        const earth = document.createElement("chikyu-earth-realistic");
+        earth.setAttribute("center", center || CENTRE);
+        earth.setAttribute("time", time);
+        if (textureBase !== null)
+            earth.setAttribute("texture-base", textureBase);
+        return earth;
+    },
+});

package/dist/bodies/jupiter.d.ts

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

package/dist/bodies/jupiter.js

@@ -0,0 +1,21 @@
+import { registerLook } from "../scene/look.js";
+import { gas } from "../scene/recipes.js";
+registerLook({
+    id: "jupiter",
+    surface: gas({
+        stops: [[-90, "#6f685f"], [-70, "#8f8070"], [-58, "#b9a48a"], [-48, "#a98d72"], [-40, "#e2d3bb"], [-32, "#b58b6c"], [-26, "#e5d6bf"], [-19, "#b2704f"], [-12, "#c98a62"], [-6, "#ecdcbc"], [0, "#efdfb8"], [6, "#e8d4ae"], [10, "#a96b4d"], [16, "#b97c58"], [21, "#e9dac0"], [27, "#b9916f"], [33, "#ead9bf"], [40, "#a98873"], [50, "#d2bfa2"], [60, "#a49080"], [70, "#8a7b6e"], [90, "#6c6560"]],
+        turbulence: 0.05,
+        streaks: 0.22,
+        plateau: 0.22,
+        extra: `
+    float spot = oval(p, -20.0, -22.0, 9.5, 6.0, 0.55);
+    float halo = oval(p, -20.0, -22.0, 14.0, 9.0, 0.5) - spot;
+    vec3 spotCol = mix(vec3(0.70, 0.31, 0.20), vec3(0.86, 0.52, 0.36), fbm(p * 16.0 + 2.0));
+    col = mix(col, col * 0.78, clamp(halo, 0.0, 1.0) * 0.5);
+    col = mix(col, spotCol, spot);
+    float oval2 = oval(p, -70.0, -33.0, 3.0, 2.2, 0.5);
+    col = mix(col, vec3(0.93, 0.88, 0.80), oval2 * 0.8);`,
+    }),
+    atmosphere: { colour: [0.75, 0.7, 0.62], strength: 0.12, power: 3.5 },
+    limb: 0.45,
+});

package/dist/bodies/mars.d.ts

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

package/dist/bodies/mars.js

@@ -0,0 +1,24 @@
+import { registerLook } from "../scene/look.js";
+registerLook({
+    id: "mars",
+    surface: `
+vec4 surface(vec3 p) {
+  float h = craters(p, 4.0, 0.4, 2.0) * 0.8 + craters(p, 12.0, 0.4, 9.0) * 0.4;
+  float la = lat(p);
+  float dk = smoothstep(0.5, 0.64, fbm(p * 2.1 + 7.0) + 0.14 * (1.0 - abs(la + 0.3) * 1.7));
+  dk = max(dk, oval(p, 70.0, 8.0, 16.0, 11.0, 0.6) * 0.95);
+  vec3 col = mix(vec3(0.80, 0.47, 0.26), vec3(0.34, 0.20, 0.15), dk * 0.85);
+  col = mix(col, vec3(0.88, 0.62, 0.40), oval(p, 70.0, -42.0, 9.0, 9.0, 0.6) * 0.6);
+  col *= 0.9 + 0.22 * fbm(p * 11.0);
+  col *= 1.0 + 0.7 * h;
+  float valles = (1.0 - smoothstep(0.0, 0.03, abs(la + 0.12 + 0.05 * sin(lon(p) * 2.0)))) * oval(p, -75.0, -10.0, 35.0, 12.0, 0.5);
+  col = mix(col, vec3(0.30, 0.17, 0.13), valles * 0.7);
+  float wob = (fbm(p * 7.0) - 0.5) * 0.14;
+  float cap = smoothstep(radians(79.0), radians(83.0), abs(la) + wob);
+  col = mix(col, vec3(0.96, 0.96, 0.98), cap);
+  return vec4(col, h);
+}`,
+    atmosphere: { colour: [0.85, 0.6, 0.45], strength: 0.16, power: 4 },
+    relief: 0.7,
+    ambient: 0.03,
+});

package/dist/bodies/mercury.d.ts

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

package/dist/bodies/mercury.js

@@ -0,0 +1,8 @@
+import { registerLook } from "../scene/look.js";
+import { rock } from "../scene/recipes.js";
+registerLook({
+    id: "mercury",
+    surface: rock({ dark: "#4f4a46", light: "#a6a09a", craters: 0.9, contrast: 0.8, seed: 2, patches: 1.8, extra: "col *= 1.0 + 0.5 * smoothstep(0.05, 0.25, h);" }),
+    relief: 0.9,
+    ambient: 0.03,
+});

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

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

package/dist/bodies/moons-earth.js

@@ -0,0 +1,36 @@
+import { registerLook } from "../scene/look.js";
+import { rock } from "../scene/recipes.js";
+registerLook({
+    id: "moon",
+    surface: rock({
+        dark: "#77746f",
+        light: "#b9b5ad",
+        craters: 0.65,
+        contrast: 0.5,
+        seed: 3,
+        patches: 3,
+        extra: `
+    float edge = (fbm(p * 7.0 + 2.0) - 0.5) * 0.35;
+    float m = 0.0;
+    m = max(m, oval(p, -15.0 + 6.0 * edge, 35.0, 24.0, 15.0, 0.35 + edge));
+    m = max(m, oval(p, 18.0, 28.0, 11.0, 9.0, 0.4));
+    m = max(m, oval(p, 31.0, 8.0, 14.0, 11.0, 0.4));
+    m = max(m, oval(p, 59.0, 17.0, 8.0, 7.0, 0.4));
+    m = max(m, oval(p, 52.0, -4.0, 10.0, 10.0, 0.4));
+    m = max(m, oval(p, -16.0, -21.0, 11.0, 8.0, 0.4));
+    m = max(m, oval(p, -39.0, -24.0, 6.0, 6.0, 0.4));
+    m = max(m, oval(p, -57.0, 12.0, 14.0, 26.0, 0.4 + edge));
+    m = max(m, oval(p, 4.0, 13.0, 7.0, 6.0, 0.4));
+    m = max(m, oval(p, 35.0, -15.0, 6.0, 6.0, 0.4));
+    m = max(m, oval(p, 0.0, 58.0, 40.0, 5.0, 0.5) * 0.75);
+    m *= 0.85 + 0.3 * fbm(p * 5.0);
+    col = mix(col, vec3(0.31, 0.31, 0.33), clamp(m, 0.0, 1.0) * 0.92);
+    h *= 1.0 - clamp(m, 0.0, 1.0) * 0.75;
+    float tycho = acos(clamp(dot(p, dirOf(-11.0, -43.0)), -1.0, 1.0));
+    float ray = smoothstep(1.0, 0.04, tycho) * (0.35 + 0.65 * smoothstep(0.5, 0.8, fbm(vec3(atan(p.z + 0.68, p.y + 0.2) * 2.4, tycho * 3.0, 1.7))));
+    col = mix(col, vec3(0.95, 0.94, 0.92), ray * 0.45 * smoothstep(0.02, 0.2, tycho) * (1.0 - m));
+    col = mix(col, vec3(0.97), smoothstep(0.035, 0.0, tycho) * 0.8);`,
+    }),
+    relief: 0.8,
+    ambient: 0.02,
+});

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

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

package/dist/bodies/moons-jupiter.js

@@ -0,0 +1,27 @@
+import { registerLook } from "../scene/look.js";
+import { ice, rock } from "../scene/recipes.js";
+registerLook({
+    id: "io",
+    surface: `
+vec4 surface(vec3 p) {
+  float n = fbm(p * 3.0 + 1.0);
+  float m = fbm(p * 9.0 + 4.0);
+  vec3 col = mix(vec3(0.93, 0.83, 0.34), vec3(0.98, 0.93, 0.62), n);
+  col = mix(col, vec3(0.86, 0.46, 0.17), smoothstep(0.52, 0.74, m) * 0.75);
+  col = mix(col, vec3(0.96, 0.96, 0.92), smoothstep(0.68, 0.85, fbm(p * 5.0 + 8.0)) * 0.65);
+  float c = -craters(p, 6.5, 1.0, 21.0);
+  col = mix(col, vec3(0.20, 0.12, 0.07), smoothstep(0.06, 0.26, c) * 0.8);
+  float pele = oval(p, -90.0, -18.0, 13.0, 13.0, 0.5) - oval(p, -90.0, -18.0, 6.0, 6.0, 0.5);
+  col = mix(col, vec3(0.78, 0.2, 0.1), clamp(pele, 0.0, 1.0) * 0.55);
+  return vec4(col, 0.0);
+}`,
+    ambient: 0.02,
+});
+registerLook({ id: "europa", surface: ice({ base: "#e9e0cd", stain: "#a2623e", cracks: 0.85, craters: 0.2 }), ambient: 0.02, relief: 0.4 });
+registerLook({
+    id: "ganymede",
+    surface: rock({ dark: "#5f5448", light: "#b6aa99", craters: 0.9, contrast: 0.9, seed: 12, patches: 3.4, extra: "col = mix(col, vec3(0.30, 0.25, 0.21), oval(p, -140.0, 20.0, 38.0, 50.0, 0.4) * 0.7); col += vec3(0.28) * smoothstep(0.05, 0.2, -h) * 0.6;" }),
+    relief: 0.6,
+    ambient: 0.02,
+});
+registerLook({ id: "callisto", surface: rock({ dark: "#3f3832", light: "#7d7265", craters: 1.8, contrast: 0.9, seed: 21, patches: 3.2, extra: "col += vec3(0.4, 0.4, 0.42) * smoothstep(0.05, 0.22, -h);" }), relief: 0.9, ambient: 0.02 });

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

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

package/dist/bodies/moons-mars.js

@@ -0,0 +1,4 @@
+import { registerLook } from "../scene/look.js";
+import { rock } from "../scene/recipes.js";
+registerLook({ id: "phobos", surface: rock({ dark: "#4d4844", light: "#8a847d", craters: 2, contrast: 1.2, seed: 8, extra: "h += bowl(p, -49.0, 1.0, 22.0, 0.45); col *= 1.0 + 0.5 * bowl(p, -49.0, 1.0, 22.0, 0.45);" }), relief: 1, ambient: 0.02 });
+registerLook({ id: "deimos", surface: rock({ dark: "#6d665f", light: "#a39a8f", craters: 0.9, contrast: 0.6, seed: 4, patches: 3 }), relief: 0.7, ambient: 0.02 });

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

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

package/dist/bodies/moons-neptune.js

@@ -0,0 +1,11 @@
+import { registerLook } from "../scene/look.js";
+import { ice, rock } from "../scene/recipes.js";
+registerLook({ id: "proteus", surface: rock({ dark: "#45433f", light: "#6f6c68", craters: 1.8, contrast: 0.9, seed: 33 }), relief: 0.9, ambient: 0.02 });
+registerLook({
+    id: "triton",
+    surface: ice({ base: "#e8d8cb", stain: "#8b6f62", craters: 0.2, extra: "col = mix(col, vec3(0.95, 0.88, 0.84), smoothstep(radians(-20.0), radians(-60.0), lat(p)) * 0.8); float cant = fbm(p * 14.0); col *= 0.92 + 0.16 * cant;" }),
+    atmosphere: { colour: [0.8, 0.8, 0.9], strength: 0.05, power: 5 },
+    ambient: 0.025,
+    relief: 0.4,
+});
+registerLook({ id: "nereid", surface: rock({ dark: "#6e6e6e", light: "#9b9b9b", craters: 1, seed: 40 }), relief: 0.8, ambient: 0.02 });

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

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

package/dist/bodies/moons-pluto.js

@@ -0,0 +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: "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.d.ts

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

package/dist/bodies/moons-saturn.js

@@ -0,0 +1,32 @@
+import { registerLook } from "../scene/look.js";
+import { cloud, ice, rock } from "../scene/recipes.js";
+registerLook({ id: "mimas", surface: rock({ dark: "#7f7d79", light: "#bebcb7", craters: 1.7, contrast: 1, seed: 6, extra: "float hs = bowl(p, -110.0, 0.0, 33.0, 0.7); h += hs; col *= 1.0 + 0.9 * hs;" }), relief: 1, ambient: 0.02 });
+registerLook({
+    id: "enceladus",
+    surface: ice({ base: "#f4f7fa", stain: "#c3cfd9", craters: 0.35, extra: "float tiger = oval(p, 0.0, -80.0, 170.0, 14.0, 0.5) * (1.0 - smoothstep(0.0, 0.04, abs(fbm(p * vec3(4.0, 4.0, 14.0)) - 0.5))); col = mix(col, vec3(0.45, 0.72, 0.85), tiger * 0.85);" }),
+    ambient: 0.03,
+    relief: 0.3,
+});
+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: "rhea", surface: rock({ dark: "#8a8883", light: "#cac8c2", craters: 1.5, contrast: 0.9, seed: 24, patches: 2 }), relief: 0.85, ambient: 0.02 });
+registerLook({
+    id: "titan",
+    surface: cloud({ light: "#ecbe6c", dark: "#b8802f", swirl: 0.7 }),
+    atmosphere: { colour: [0.92, 0.66, 0.3], strength: 0.65, power: 2.3 },
+    limb: 0.3,
+    ambient: 0.06,
+});
+registerLook({
+    id: "iapetus",
+    surface: rock({
+        dark: "#7e7a73",
+        light: "#d9d6d0",
+        craters: 1,
+        contrast: 0.8,
+        seed: 30,
+        extra: "float lead = smoothstep(-0.15, 0.35, cos(lon(p) + 1.5708)) * (1.0 - smoothstep(0.75, 0.95, abs(lat(p)) / 1.5708 * 1.2)); col = mix(col, vec3(0.20, 0.15, 0.12), lead * 0.9);",
+    }),
+    relief: 0.7,
+    ambient: 0.02,
+});

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

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

package/dist/bodies/moons-uranus.js

@@ -0,0 +1,7 @@
+import { registerLook } from "../scene/look.js";
+import { rock } from "../scene/recipes.js";
+registerLook({ id: "miranda", surface: rock({ dark: "#6f6d69", light: "#b3b1ac", craters: 0.8, contrast: 0.8, seed: 9, patches: 4.5, extra: "col = mix(col, col * 1.25, oval(p, 30.0, -55.0, 40.0, 25.0, 0.4) * 0.5);" }), relief: 0.9, ambient: 0.02 });
+registerLook({ id: "ariel", surface: rock({ dark: "#8a8883", light: "#c6c3bc", craters: 0.8, contrast: 0.7, seed: 13, patches: 3, extra: "float v = 1.0 - smoothstep(0.0, 0.02, abs(fbm(p * 6.0 + 2.0) - 0.5)); col = mix(col, vec3(0.9), v * 0.35);" }), relief: 0.7, ambient: 0.02 });
+registerLook({ id: "umbriel", surface: rock({ dark: "#4f4c49", light: "#7f7c77", craters: 1.2, contrast: 0.9, seed: 16, extra: "col = mix(col, vec3(0.85), (oval(p, 270.0, 8.0, 8.0, 8.0, 0.5) - oval(p, 270.0, 8.0, 4.0, 4.0, 0.5)) * 0.8);" }), relief: 0.8, ambient: 0.02 });
+registerLook({ id: "titania", surface: rock({ dark: "#7d7972", light: "#bdb8af", craters: 0.9, contrast: 0.8, seed: 19 }), relief: 0.8, ambient: 0.02 });
+registerLook({ id: "oberon", surface: rock({ dark: "#625b55", light: "#9c948b", craters: 1.4, contrast: 0.9, seed: 22 }), relief: 0.85, ambient: 0.02 });

package/dist/bodies/neptune.d.ts

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

package/dist/bodies/neptune.js

@@ -0,0 +1,18 @@
+import { registerLook } from "../scene/look.js";
+import { gas } from "../scene/recipes.js";
+registerLook({
+    id: "neptune",
+    surface: gas({
+        stops: [[-90, "#2b45b4"], [-60, "#3153c6"], [-35, "#2a47b6"], [-15, "#3a60d4"], [0, "#2e4ebf"], [20, "#3c61d3"], [45, "#3050c0"], [90, "#3a5ccf"]],
+        turbulence: 0.022,
+        streaks: 0.1,
+        extra: `
+    float spot = oval(p, -30.0, -22.0, 11.0, 6.5, 0.5);
+    col = mix(col, vec3(0.10, 0.17, 0.46), spot * 0.9);
+    float cirrus = smoothstep(0.6, 0.8, fbm(vec3(p.xy * 3.0, p.z * 30.0) + 8.0)) * smoothstep(0.5, 0.0, abs(degrees(la) + 38.0) / 10.0);
+    col = mix(col, vec3(0.86, 0.9, 1.0), clamp(cirrus + oval(p, -8.0, -28.0, 7.0, 2.0, 0.6) * 0.8, 0.0, 1.0) * 0.55);`,
+    }),
+    atmosphere: { colour: [0.35, 0.5, 0.95], strength: 0.42, power: 2.8 },
+    limb: 0.3,
+    ambient: 0.05,
+});

package/dist/bodies/pluto.d.ts

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

package/dist/bodies/pluto.js

@@ -0,0 +1,21 @@
+import { registerLook } from "../scene/look.js";
+import { rock } from "../scene/recipes.js";
+registerLook({
+    id: "pluto",
+    surface: rock({
+        dark: "#5f4033",
+        light: "#c9a784",
+        craters: 0.35,
+        contrast: 0.6,
+        seed: 5,
+        patches: 2.6,
+        extra: `
+    col = mix(col, vec3(0.20, 0.10, 0.09), oval(p, 105.0, -6.0, 55.0, 14.0, 0.6) * 0.88);
+    float heart = clamp(oval(p, 178.0, 20.0, 23.0, 27.0, 0.35) + oval(p, 226.0, 24.0, 21.0, 20.0, 0.5) * 0.75 + oval(p, 205.0, -10.0, 13.0, 30.0, 0.5) * 0.6, 0.0, 1.0);
+    col = mix(col, vec3(0.95, 0.90, 0.82), heart * 0.92);
+    h *= 1.0 - heart;`,
+    }),
+    atmosphere: { colour: [0.6, 0.7, 0.9], strength: 0.12, power: 5 },
+    relief: 0.4,
+    ambient: 0.025,
+});

package/dist/bodies/saturn.d.ts

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