@johnmorrisdotca/uchusen-rockets 0.10.0 → 0.11.0

package/dist/element/scene.d.ts

@@ -92,6 +92,8 @@ export declare class RocketViewer {
     private settled;
     private marks;
     private markHost;
+    /** The words that say what stands beside the craft: its name and length, under its foot. */
+    private besideEl;
     private focusing;
     private nearSaid;
     private nearAt;
@@ -189,6 +191,9 @@ export declare class RocketViewer {
     private wake;
     /** Labels on the parts: each follows its part as the model turns, hides with its part, and gives way to a label drawn before it that it would cover. Null takes them away. */
     setMarks(marks: readonly ViewerMark[] | null): void;
+    private hostOfMarks;
+    /** What stands beside the craft is named: a caption under its foot, kept inside the picture. */
+    private placeBeside;
     /** Put the labels where their parts are now. */
     private placeMarks;
     /** Show only some slots and fly to look at them: an inset. Null puts the ship back as it was. */

package/dist/element/scene.js

@@ -14,6 +14,7 @@ import { pixelRatioFor } from "../pixels.js";
 import { MATERIALS } from "../model/materials.js";
 import { paintGlow, paintSky, paintSteel, paintTiles } from "./paint.js";
 import { flightBounds, frameAt } from "../flight.js";
+import { besideLabel } from "../beside.js";
 import { GroundKit } from "./ground.js";
 import { PartPlumes, PlumeKit } from "./plumes.js";
 const IDLE_STOP_MS = 90_000;
@@ -142,6 +143,8 @@ export class RocketViewer {
     settled = Promise.resolve();
     marks = [];
     markHost = null;
+    /** The words that say what stands beside the craft: its name and length, under its foot. */
+    besideEl = null;
     focusing = false;
     nearSaid = false;
     nearAt = 0;
@@ -237,7 +240,7 @@ export class RocketViewer {
         this.renderer.shadowMap.enabled = this.shadows;
         this.sun.castShadow = this.shadows;
         const places = built.placesOf(show);
-        for (const part of built.parts) {
+        for (const part of [...built.parts, ...built.beside]) {
             const source = gltf.scene.getObjectByName(part.slot);
             if (!source)
                 continue;
@@ -247,11 +250,13 @@ export class RocketViewer {
             holder.add(code);
             const view = {
                 slot: part.slot,
+                beside: built.beside.includes(part),
                 holder,
                 code,
                 model: null,
-                modelFile: part.record.painted?.file ?? null,
-                ownNozzle: Boolean(part.record.painted?.ownNozzle),
+                // the stack beside it is this package's own paint in every look: a licensed model shows only with its credit, which is the craft's
+                modelFile: built.beside.includes(part) ? null : (part.record.painted?.file ?? null),
+                ownNozzle: !built.beside.includes(part) && Boolean(part.record.painted?.ownNozzle),
                 modelState: "none",
                 nozzleShown: false,
                 faces: [],
@@ -292,7 +297,8 @@ export class RocketViewer {
             this.setFlight(this.clockNow);
         }
         this.canvas.dataset.ready = "true";
-        this.canvas.dataset.parts = this.parts.map((part) => part.slot).join(" ");
+        this.canvas.dataset.parts = this.parts.filter((part) => !part.beside).map((part) => part.slot).join(" ");
+        this.canvas.dataset.beside = built.beside.length ? "on" : "off";
         this.drivenDirty = this.driven !== null;
         this.wake();
         await this.settled;
@@ -606,6 +612,9 @@ export class RocketViewer {
                 this.ground = new GroundKit();
                 this.scene.add(this.ground.group);
             }
+            for (const part of this.parts)
+                if (part.beside)
+                    part.holder.visible = false;
             const { min, max } = this.boundsNow();
             this.ground.fit(this.built.boundsOf("together").max[0] * 2.4 + 4, Math.max(Math.abs(min[0]), Math.abs(max[0])));
             this.ground.group.visible = true;
@@ -707,7 +716,7 @@ export class RocketViewer {
             this.options.onPainted("");
             return;
         }
-        const states = this.parts.map((part) => (part.modelFile ? part.modelState : "code"));
+        const states = this.parts.filter((part) => !part.beside).map((part) => (part.modelFile ? part.modelState : "code"));
         const state = states.some((s) => s === "loading" || s === "none") ? "loading" : states.every((s) => s === "ready") ? "model" : states.includes("ready") ? "mixed" : "code";
         this.canvas.dataset.painted = state;
         this.options.onPainted(state);
@@ -1106,18 +1115,13 @@ export class RocketViewer {
             el.remove();
         this.marks = [];
         if (!marks || marks.length === 0) {
-            this.markHost?.remove();
-            this.markHost = null;
+            if (!this.besideEl) {
+                this.markHost?.remove();
+                this.markHost = null;
+            }
             return;
         }
-        if (!this.markHost) {
-            const host = document.createElement("div");
-            host.className = "marks";
-            host.setAttribute("aria-hidden", "true");
-            host.style.cssText = "position:absolute;inset:0;overflow:hidden;pointer-events:none;font:11px/1.2 system-ui,sans-serif";
-            this.holder.appendChild(host);
-            this.markHost = host;
-        }
+        this.hostOfMarks();
         for (const mark of marks) {
             const el = document.createElement("span");
             el.dataset.mark = mark.id;
@@ -1125,11 +1129,52 @@ export class RocketViewer {
             el.style.cssText = mark.numbered
                 ? "position:absolute;left:0;top:0;width:22px;height:22px;margin:-11px 0 0 -11px;border-radius:50%;background:#f2c14e;color:#0b111b;font-weight:700;text-align:center;line-height:22px;will-change:transform;display:none"
                 : "position:absolute;left:0;top:0;padding:1px 5px;border-left:2px solid #f2c14e;color:#e6edf6;background:rgba(11,17,27,0.72);white-space:nowrap;will-change:transform;display:none";
-            this.markHost.appendChild(el);
+            this.hostOfMarks().appendChild(el);
             this.marks.push({ mark, el });
         }
         this.wake();
     }
+    hostOfMarks() {
+        if (!this.markHost) {
+            const host = document.createElement("div");
+            host.className = "marks";
+            host.setAttribute("aria-hidden", "true");
+            host.style.cssText = "position:absolute;inset:0;overflow:hidden;pointer-events:none;font:11px/1.2 system-ui,sans-serif";
+            this.holder.appendChild(host);
+            this.markHost = host;
+        }
+        return this.markHost;
+    }
+    /** What stands beside the craft is named: a caption under its foot, kept inside the picture. */
+    placeBeside() {
+        const view = this.parts.find((part) => part.beside);
+        if (!view) {
+            this.besideEl?.remove();
+            this.besideEl = null;
+            return;
+        }
+        if (!this.besideEl) {
+            const el = document.createElement("span");
+            el.dataset.besideLabel = "";
+            el.textContent = besideLabel();
+            el.style.cssText = "position:absolute;left:0;top:0;padding:1px 5px;color:#e6edf6;background:rgba(11,17,27,0.72);white-space:nowrap;will-change:transform;display:none";
+            this.hostOfMarks().appendChild(el);
+            this.besideEl = el;
+        }
+        const el = this.besideEl;
+        if (!view.holder.visible || this.clockNow) {
+            el.style.display = "none";
+            return;
+        }
+        const width = this.canvas.clientWidth;
+        const height = this.canvas.clientHeight;
+        const point = new Vector3(view.holder.position.x, view.holder.position.y, view.holder.position.z).project(this.camera);
+        const w = besideLabel().length * 6.2 + 12;
+        const x = Math.min(Math.max(((point.x + 1) / 2) * width - w / 2, 4), Math.max(4, width - w - 4));
+        const y = Math.min(((1 - point.y) / 2) * height + 6, height - 20);
+        el.style.display = point.z < 1 ? "block" : "none";
+        el.style.transform = `translate(${Math.round(x)}px,${Math.round(y)}px)`;
+    }
     /** Put the labels where their parts are now. */
     placeMarks() {
         if (this.marks.length === 0)
@@ -1282,6 +1327,7 @@ export class RocketViewer {
             this.syncSizes();
             this.renderer.render(this.scene, this.camera);
             this.placeMarks();
+            this.placeBeside();
             if (this.options.onNear && !this.nearSaid && this.nearAt > 0 && this.camera.position.distanceTo(this.controls.target) < this.nearAt) {
                 this.nearSaid = true;
                 this.options.onNear();

package/dist/element.d.ts

@@ -144,6 +144,8 @@ export declare class UchusenRocket extends HTMLBase {
     private flightStep;
     /** Tells the page where the timeline is: at once for a new phase or a stop, otherwise at most 8 times a second. */
     private noteFlight;
+    /** Whether Starship stands beside it: `beside="on"`, and never beside Starship itself. */
+    private besideOn;
     /** Whether the engines are lit: `engines="on"`, and never for a reader who asked for reduced motion. */
     private engineLights;
     /** Hands the 3D view what the attributes say about the engines, and its reader's motion setting. */

package/dist/element.js

@@ -9,6 +9,7 @@ import { defineUchusenFlight, UchusenFlight } from "./flightbar.js";
 import { lineupSvg } from "./build/lineup.js";
 import { CROSSFADE_MS, REDUCED_FADE_MS, revealDelay } from "./crossfade.js";
 import { cleanView, turnedBy, VIEWS } from "./framing.js";
+import { canBeside } from "./beside.js";
 import { cleanShow } from "./layout.js";
 import { cleanLook } from "./looks.js";
 import { ROCKETS, SLOT_NAMES } from "./rockets.js";
@@ -123,7 +124,7 @@ function whyNot(mode) {
  * ```
  */
 export class UchusenRocket extends HTMLBase {
-    static observedAttributes = ["rocket", "variant", "show", "look", "view", "build", "mode", "assets", "spin", "way", "label", "engines", "phase", "labels", "inspector"];
+    static observedAttributes = ["rocket", "variant", "show", "look", "view", "build", "mode", "assets", "spin", "way", "label", "engines", "phase", "labels", "inspector", "beside"];
     descriptionValue = null;
     picture = null;
     holder = null;
@@ -440,6 +441,10 @@ export class UchusenRocket extends HTMLBase {
         this.dataset.phase = this.flightState.active ? this.flightState.phase : "";
         this.emit("uchusen-flight", this.flightState);
     }
+    /** Whether Starship stands beside it: `beside="on"`, and never beside Starship itself. */
+    besideOn(description) {
+        return this.getAttribute("beside") === "on" && canBeside(description.rocket);
+    }
     /** Whether the engines are lit: `engines="on"`, and never for a reader who asked for reduced motion. */
     engineLights() {
         return enginesWanted(this.getAttribute("engines"), media("(prefers-reduced-motion: reduce)"));
@@ -451,11 +456,11 @@ export class UchusenRocket extends HTMLBase {
     }
     update() {
         const description = this.descriptionNow();
-        const key = JSON.stringify(description);
+        const key = `${JSON.stringify(description)}|${this.besideOn(description)}`;
         if (key !== this.key || !this.builtNow) {
             this.key = key;
             try {
-                this.builtNow = build(description, { detail: this.detailFor(description) });
+                this.builtNow = build(description, { detail: this.detailFor(description), beside: this.besideOn(description) });
             }
             catch (error) {
                 this.builtNow = null;
@@ -557,6 +562,7 @@ export class UchusenRocket extends HTMLBase {
         const { look, show, viewName } = this.settings(this.builtNow);
         this.dataset.look = look;
         this.dataset.engines = this.engineLights() ? "on" : "off";
+        this.dataset.beside = this.builtNow.beside.length ? "on" : "off";
         this.dataset.flight = this.flight?.id ?? "";
         this.dataset.show = show;
         this.dataset.viewAngle = viewName;
@@ -604,7 +610,7 @@ export class UchusenRocket extends HTMLBase {
             return;
         this.fine = true;
         try {
-            this.builtNow = build(description, { detail: "full" });
+            this.builtNow = build(description, { detail: "full", beside: this.besideOn(description) });
         }
         catch {
             return;
@@ -871,7 +877,7 @@ svg { display: block; }
  * ```
  */
 export class UchusenLineup extends HTMLBase {
-    static observedAttributes = ["items", "unit", "look", "view", "show", "ruler", "labels", "filter", "fit"];
+    static observedAttributes = ["items", "unit", "look", "view", "show", "ruler", "labels", "filter", "fit", "real"];
     connectedCallback() {
         if (!this.shadowRoot)
             adopt(this.attachShadow({ mode: "open" }), LINEUP_CSS, lineupSheet);
@@ -888,7 +894,8 @@ export class UchusenLineup extends HTMLBase {
         const raw = Number.parseFloat(this.getAttribute("unit") ?? "3");
         const unit = Number.isFinite(raw) && raw > 0 && raw <= 100 ? raw : 3;
         const items = (this.getAttribute("items") ?? "").split(",").map((item) => item.trim()).filter(Boolean);
-        const { svg, items: shown, unit: drawnUnit } = lineupSvg({
+        const { svg, items: shown, real: shownReal, unit: drawnUnit } = lineupSvg({
+            real: this.getAttribute("real") === "on",
             items,
             unit,
             look: cleanLook(this.getAttribute("look")),
@@ -909,6 +916,7 @@ export class UchusenLineup extends HTMLBase {
             child.remove();
         root.appendChild(node);
         this.dataset.count = String(shown.length);
+        this.dataset.real = String(shownReal.length);
     }
 }
 /**

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export type { Angle, Framing, Vec3, ViewChoice, ViewName } from "./framing.ts";
 export { cleanLook, DEFAULT_LOOK, LOOK_NAMES, LOOKS } from "./looks.ts";
 export type { Look, LookName } from "./looks.ts";
 export { cleanShow, placesFor, showsOf } from "./layout.ts";
+export { BESIDE_ROCKET, besideBounds, besideLabel, besideLayout, canBeside } from "./beside.ts";
 export type { Place, ShowName } from "./layout.ts";
 export { CROSSFADE_MS, DRAWING_HOLD_MS, REDUCED_FADE_MS, revealDelay } from "./crossfade.ts";
 export { MAX_PIXELS, MAX_RATIO, MAX_SIDE, pixelRatioFor } from "./pixels.ts";

package/dist/index.js

@@ -12,6 +12,7 @@ export { check } from "./fit.js";
 export { axesOf, cleanView, DEFAULT_VIEW, directionOf, FOV_DEG, frameFor, PICTURE_H, PICTURE_W, turnedBy, VIEW_NAMES, VIEWS } from "./framing.js";
 export { cleanLook, DEFAULT_LOOK, LOOK_NAMES, LOOKS } from "./looks.js";
 export { cleanShow, placesFor, showsOf } from "./layout.js";
+export { BESIDE_ROCKET, besideBounds, besideLabel, besideLayout, canBeside } from "./beside.js";
 export { CROSSFADE_MS, DRAWING_HOLD_MS, REDUCED_FADE_MS, revealDelay } from "./crossfade.js";
 export { MAX_PIXELS, MAX_RATIO, MAX_SIDE, pixelRatioFor } from "./pixels.js";
 export { tiltMode, tiltTurn } from "./tilt.js";

package/dist/journey/bodies.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A place a trip can start or end at: the Earth, the Moon or a planet, with what the arithmetic needs.
+ *
+ * @example
+ * ```ts
+ * import type { Stop } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * const mars: Stop = { id: "mars", name: { en: "Mars", ja: "火星" }, kind: "planet", radiusKm: 3396.19, colour: "#c76a3f" };
+ * console.log(mars.name.en);
+ * ```
+ */
+export interface Stop {
+    id: string;
+    name: {
+        en: string;
+        ja: string;
+    };
+    kind: "star" | "planet" | "dwarf-planet" | "moon";
+    /** The planet a moon goes round. */
+    parent?: string;
+    /** The equatorial radius, km. */
+    radiusKm: number;
+    /** The gravitational parameter, km^3/s^2. Left out, the journey's own table (`GM_KM3_S2`) is used. */
+    muKm3s2?: number;
+    /** The sidereal orbital period, days. Left out, the journey's own table (`PERIOD_DAYS`) is used. */
+    periodDays?: number;
+    /** The body's mean colour, `#rrggbb`. */
+    colour: string;
+}
+/**
+ * Where the stops are, and what they are. The journey's core takes one of these and imports nothing.
+ *
+ * @example
+ * ```ts
+ * import type { BodySource } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * const empty: BodySource = { stops: [], positionAu: () => [0, 0, 0], offsetKm: () => [0, 0, 0] };
+ * console.log(empty.stops.length);
+ * ```
+ */
+export interface BodySource {
+    stops: readonly Stop[];
+    /** A planet's position round the Sun (ecliptic, astronomical units) at a time in milliseconds since 1970. */
+    positionAu(id: string, ms: number): readonly [number, number, number];
+    /** A moon's position from its planet's centre (ecliptic, kilometres) at a time. */
+    offsetKm(id: string, ms: number): readonly [number, number, number];
+}

package/dist/journey/bodies.js

@@ -0,0 +1,2 @@
+// What the journey needs to know about a place, and where it is. The package depends on no ephemeris: a page hands it a `BodySource`, and `demo/journey-bodies.ts` makes one from wakusei-planets. Pure types.
+export {};

package/dist/journey/constants.d.ts

@@ -0,0 +1,115 @@
+/**
+ * The speed of light, metres a second (exact, by definition of the metre).
+ *
+ * @example
+ * ```ts
+ * import { C } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(C);
+ * ```
+ */
+export declare const C = 299792458;
+/**
+ * One standard gravity, metres a second squared (exact, by definition).
+ *
+ * @example
+ * ```ts
+ * import { G0 } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(G0);
+ * ```
+ */
+export declare const G0 = 9.80665;
+/**
+ * One astronomical unit, metres (exact, IAU 2012).
+ *
+ * @example
+ * ```ts
+ * import { AU_M } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(AU_M);
+ * ```
+ */
+export declare const AU_M = 149597870700;
+/**
+ * One astronomical unit, kilometres.
+ *
+ * @example
+ * ```ts
+ * import { AU_KM } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(AU_KM);
+ * ```
+ */
+export declare const AU_KM: number;
+/**
+ * A day, seconds.
+ *
+ * @example
+ * ```ts
+ * import { DAY_S } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(DAY_S);
+ * ```
+ */
+export declare const DAY_S = 86400;
+/**
+ * A Julian year, seconds.
+ *
+ * @example
+ * ```ts
+ * import { YEAR_S } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(YEAR_S);
+ * ```
+ */
+export declare const YEAR_S = 31557600;
+/**
+ * A light year, metres.
+ *
+ * @example
+ * ```ts
+ * import { LY_M } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(LY_M);
+ * ```
+ */
+export declare const LY_M: number;
+/**
+ * Gravitational parameters (GM), cubic kilometres a second squared. NASA/JPL: "Planetary Satellite Physical Parameters" and "Planetary Physical Parameters"
+ * (https://ssd.jpl.nasa.gov/), read 2026-11-04. The Sun's is the IAU 2015 nominal value.
+ *
+ * @example
+ * ```ts
+ * import { GM_KM3_S2 } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(GM_KM3_S2.earth, GM_KM3_S2.moon);
+ * ```
+ */
+export declare const GM_KM3_S2: Readonly<Record<string, number>>;
+/**
+ * Sidereal orbital periods, days (NASA's planetary fact sheets, https://nssdc.gsfc.nasa.gov/planetary/factsheet/).
+ *
+ * @example
+ * ```ts
+ * import { PERIOD_DAYS } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(PERIOD_DAYS.mars);
+ * ```
+ */
+export declare const PERIOD_DAYS: Readonly<Record<string, number>>;
+/**
+ * The height of the circular parking orbit round each kind of body, kilometres: 185 km above the Earth (Apollo's), 100 km above the Moon (Apollo's), 200 km above any other body.
+ *
+ * @example
+ * ```ts
+ * import { PARKING_ALTITUDE_KM } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(PARKING_ALTITUDE_KM.earth);
+ * ```
+ */
+export declare const PARKING_ALTITUDE_KM: {
+    readonly earth: 185;
+    readonly moon: 100;
+    readonly other: 200;
+};

package/dist/journey/constants.js

@@ -0,0 +1,134 @@
+// The constants a trip needs, each with where it is from. Metres and seconds unless the name says otherwise. Pure.
+/**
+ * The speed of light, metres a second (exact, by definition of the metre).
+ *
+ * @example
+ * ```ts
+ * import { C } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(C);
+ * ```
+ */
+export const C = 299_792_458;
+/**
+ * One standard gravity, metres a second squared (exact, by definition).
+ *
+ * @example
+ * ```ts
+ * import { G0 } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(G0);
+ * ```
+ */
+export const G0 = 9.80665;
+/**
+ * One astronomical unit, metres (exact, IAU 2012).
+ *
+ * @example
+ * ```ts
+ * import { AU_M } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(AU_M);
+ * ```
+ */
+export const AU_M = 149_597_870_700;
+/**
+ * One astronomical unit, kilometres.
+ *
+ * @example
+ * ```ts
+ * import { AU_KM } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(AU_KM);
+ * ```
+ */
+export const AU_KM = AU_M / 1000;
+/**
+ * A day, seconds.
+ *
+ * @example
+ * ```ts
+ * import { DAY_S } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(DAY_S);
+ * ```
+ */
+export const DAY_S = 86_400;
+/**
+ * A Julian year, seconds.
+ *
+ * @example
+ * ```ts
+ * import { YEAR_S } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(YEAR_S);
+ * ```
+ */
+export const YEAR_S = 31_557_600;
+/**
+ * A light year, metres.
+ *
+ * @example
+ * ```ts
+ * import { LY_M } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(LY_M);
+ * ```
+ */
+export const LY_M = C * YEAR_S;
+/**
+ * Gravitational parameters (GM), cubic kilometres a second squared. NASA/JPL: "Planetary Satellite Physical Parameters" and "Planetary Physical Parameters"
+ * (https://ssd.jpl.nasa.gov/), read 2026-11-04. The Sun's is the IAU 2015 nominal value.
+ *
+ * @example
+ * ```ts
+ * import { GM_KM3_S2 } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(GM_KM3_S2.earth, GM_KM3_S2.moon);
+ * ```
+ */
+export const GM_KM3_S2 = {
+    sun: 132_712_440_018,
+    mercury: 22_031.868,
+    venus: 324_858.592,
+    earth: 398_600.4418,
+    moon: 4_902.800,
+    mars: 42_828.375,
+    jupiter: 126_686_534,
+    saturn: 37_931_187,
+    uranus: 5_793_939,
+    neptune: 6_836_529,
+    pluto: 869.6,
+};
+/**
+ * Sidereal orbital periods, days (NASA's planetary fact sheets, https://nssdc.gsfc.nasa.gov/planetary/factsheet/).
+ *
+ * @example
+ * ```ts
+ * import { PERIOD_DAYS } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(PERIOD_DAYS.mars);
+ * ```
+ */
+export const PERIOD_DAYS = {
+    mercury: 87.969,
+    venus: 224.701,
+    earth: 365.256,
+    mars: 686.98,
+    jupiter: 4332.589,
+    saturn: 10759.22,
+    uranus: 30685.4,
+    neptune: 60189,
+    pluto: 90560,
+};
+/**
+ * The height of the circular parking orbit round each kind of body, kilometres: 185 km above the Earth (Apollo's), 100 km above the Moon (Apollo's), 200 km above any other body.
+ *
+ * @example
+ * ```ts
+ * import { PARKING_ALTITUDE_KM } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(PARKING_ALTITUDE_KM.earth);
+ * ```
+ */
+export const PARKING_ALTITUDE_KM = { earth: 185, moon: 100, other: 200 };

package/dist/journey/countdown.d.ts

@@ -0,0 +1,49 @@
+import type { Trip } from "./trip.ts";
+/**
+ * The engine preheat bar before ignition: ten segments and a percent. It fills from 13 seconds before lift-off to 3 seconds before, and is full after.
+ * @param missionS Mission seconds from lift-off (negative before).
+ * @returns The percent (0 to 100), how many of the ten segments are full, and how full the next one is (0 to 1).
+ * @example
+ * ```ts
+ * import { preheat } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(preheat(-8.5));
+ * ```
+ */
+export declare function preheat(missionS: number): {
+    percent: number;
+    full: number;
+    partial: number;
+};
+/**
+ * The ignition count: IGNITION IN 3, 2, 1, then 0 from lift-off, with how far round the ring dial has gone.
+ * @param missionS Mission seconds from lift-off (negative before).
+ * @returns The number to show (3, 2, 1 or 0) and the ring's sweep (0 to 1).
+ * @example
+ * ```ts
+ * import { ignition } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * console.log(ignition(-2.2), ignition(0));
+ * ```
+ */
+export declare function ignition(missionS: number): {
+    count: number;
+    ring: number;
+};
+/**
+ * The timer before and during the braking burn: DECELERATION BURN IN until it starts, DECELERATION COMPLETE IN while it runs, nothing after.
+ * @param trip A planned trip.
+ * @param missionS Mission seconds from lift-off.
+ * @returns Which timer, and its seconds; or null when there is none to show.
+ * @example
+ * ```ts no-run
+ * import { burnTimer, type Trip } from "@johnmorrisdotca/uchusen-rockets/journey";
+ *
+ * declare const trip: Trip;
+ * console.log(burnTimer(trip, 10));
+ * ```
+ */
+export declare function burnTimer(trip: Trip, missionS: number): {
+    kind: "burn-in" | "complete-in";
+    seconds: number;
+} | null;