@johnmorrisdotca/uchusen-rockets 0.9.0 → 0.11.0

package/dist/element.js

@@ -1,7 +1,7 @@
 // The viewer: `<uchusen-rocket rocket="starship" variant="v3" show="together" look="line">` in any page. The drawing first, then, when it comes on screen and the browser can draw WebGL, the 3D view
 // crossfading in over it; drag to turn, keyboard, tilt on phones, a slow spin, reduced motion; the drawing stays on no WebGL, Save-Data or any failure. Importing this file defines the elements. three.js is
 // loaded only when a 3D view is wanted, and a licensed model only when the painted look asks for one.
-import { build, FitError } from "./build/index.js";
+import { build, buildPart, FitError } from "./build/index.js";
 import { bellsOf, enginesWanted, pickBells } from "./engines.js";
 import { engineChart } from "./draw/plume.js";
 import { burnsOf, FlightClock, flightOf, frameAt, phaseAt, phasePosition } from "./flight.js";
@@ -9,10 +9,12 @@ 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";
 import { tiltMode, tiltTurn } from "./tilt.js";
+import { Panel } from "./element/panel.js";
 import { spinOf } from "./spin.js";
 const HTMLBase = typeof HTMLElement === "undefined" ? class {
 } : HTMLElement;
@@ -49,6 +51,17 @@ const CSS = `
 .canvas:focus-visible { outline: 2px solid currentColor; outline-offset: -2px; }
 .picture[data-state="3d"] .drawing { opacity: 0; filter: blur(2px); }
 .picture[data-state="3d"] .canvas { opacity: 1; filter: none; }
+.panel { font: 0.85rem/1.4 system-ui, sans-serif; margin-top: 0.5rem; }
+.panel .bar { display: flex; flex-wrap: wrap; gap: 0.35rem; }
+.panel button { min-height: 2rem; padding: 0.2rem 0.7rem; border: 1px solid currentColor; border-radius: 1rem; background: transparent; color: inherit; font: inherit; cursor: pointer; }
+.panel button[aria-selected="true"], .panel button[aria-pressed="true"] { background: color-mix(in srgb, currentColor 22%, transparent); box-shadow: inset 0 0 0 1px currentColor; font-weight: 600; }
+.panel button:disabled { opacity: 0.5; cursor: default; }
+.panel .body { margin-top: 0.5rem; max-height: 14rem; overflow: auto; }
+.panel .body button { margin: 0 0.35rem 0.35rem 0; }
+.panel td button.link { margin: 0; min-height: 0; padding: 0; border: 0; border-radius: 0; text-decoration: underline; text-align: left; }
+.panel table { border-collapse: collapse; width: 100%; }
+.panel th, .panel td { text-align: left; padding: 0.15rem 0.4rem; border-bottom: 1px solid color-mix(in srgb, currentColor 25%, transparent); vertical-align: top; }
+.panel p { margin: 0 0 0.5rem; }
 .tilt { position: absolute; right: 0.5rem; bottom: 0.5rem; min-height: 2rem; padding: 0.25rem 0.75rem; border: 1px solid currentColor; border-radius: 1rem; background: transparent; color: inherit; font: inherit; font-size: 0.8rem; cursor: pointer; }
 @media (prefers-reduced-motion: reduce) {
   .drawing, .canvas { filter: none !important; transition: opacity var(--uchusen-fade, 400ms) ease; }
@@ -111,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"];
+    static observedAttributes = ["rocket", "variant", "show", "look", "view", "build", "mode", "assets", "spin", "way", "label", "engines", "phase", "labels", "inspector", "beside"];
     descriptionValue = null;
     picture = null;
     holder = null;
@@ -161,6 +174,16 @@ export class UchusenRocket extends HTMLBase {
     get angle() {
         return this.viewer?.currentAngle() ?? null;
     }
+    /**
+     * Where a point of the model, in metres, is on the picture now: in CSS pixels from the element's top left, and whether it is in front and inside. A page's label that follows a part calls it each time the element
+     * says `uchusen-draw`, so the label moves as the model turns and stands still when it does not. Without a 3D view it gives null.
+     *
+     * @param point A point of the model in metres, as `labelsOf` gives them.
+     * @returns The place on the picture, or null.
+     */
+    screenPoint(point) {
+        return this.viewer?.screenPoint([point[0], point[1], point[2]]) ?? null;
+    }
     /** Lets a page choose the turn, tip, zoom and pan, as the family's `<kazoku-view-controls>` reports them in `kazoku-viewchange` (`element.drive(event.detail)`): the element's own drag, wheel, keys and spin stand down, and the 3D view and the drawing both follow. `null` takes them back. */
     drive(choice) {
         const before = this.driven;
@@ -232,6 +255,8 @@ export class UchusenRocket extends HTMLBase {
             return;
         if (name === "spin" || name === "way")
             this.viewer?.setSpin(this.spin());
+        else if (name === "labels" || name === "inspector")
+            this.syncPanel();
         else {
             // choosing what to show leaves the flight
             if (name === "show")
@@ -416,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)"));
@@ -427,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);
+                this.builtNow = build(description, { detail: this.detailFor(description), beside: this.besideOn(description) });
             }
             catch (error) {
                 this.builtNow = null;
@@ -533,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;
@@ -563,6 +593,82 @@ export class UchusenRocket extends HTMLBase {
             }
             this.emit("uchusen-change", { report: this.builtNow.report });
         }
+        this.syncPanel();
+        this.panel?.refresh();
+    }
+    /** A fleet ship is built coarse first (the first picture and the far view) and fine when the camera comes near, an inset opens or one part is shown alone: once per visit, never on a turn or a look change. */
+    fine = false;
+    detailFor(description) {
+        const fictional = ROCKETS[description.rocket]?.variants.some((v) => v.status === "fictional");
+        return fictional && !this.fine ? "coarse" : "full";
+    }
+    async upgrade() {
+        if (this.fine || !this.builtNow)
+            return;
+        const description = this.descriptionNow();
+        if (this.detailFor(description) === "full")
+            return;
+        this.fine = true;
+        try {
+            this.builtNow = build(description, { detail: "full", beside: this.besideOn(description) });
+        }
+        catch {
+            return;
+        }
+        await this.applyRocket();
+    }
+    panel = null;
+    panelFor = null;
+    /** The panel of a ship that has one: tabs, a Labels toggle and insets that open on a click. `inspector="off"` leaves it out; `labels="on"` starts with the labels showing. */
+    syncPanel() {
+        const root = this.shadowRoot;
+        if (!root)
+            return;
+        const inspector = this.builtNow?.report.variant?.inspector ?? null;
+        if (!inspector || this.getAttribute("inspector") === "off") {
+            this.panel?.el.remove();
+            this.panel = null;
+            this.panelFor = null;
+            this.viewer?.setMarks(null);
+            return;
+        }
+        if (this.panelFor !== inspector || !this.panel || !this.panel.el.isConnected) {
+            this.panel?.el.remove();
+            this.panel = new Panel(inspector, {
+                marks: (marks) => this.viewer?.setMarks(marks),
+                focus: (focus) => {
+                    void (focus ? this.upgrade() : Promise.resolve()).then(() => this.viewer?.focusOn(focus));
+                },
+                drawn: () => Boolean(this.viewer),
+                onLabels: (on) => (on ? this.setAttribute("labels", "on") : this.removeAttribute("labels")),
+                download: () => this.downloadModel(),
+                go: (rocket, variant) => {
+                    this.setAttribute("rocket", rocket);
+                    this.setAttribute("variant", variant);
+                },
+            });
+            root.appendChild(this.panel.el);
+            this.panelFor = inspector;
+        }
+        this.panel.labels(this.getAttribute("labels") === "on");
+    }
+    /** Saves the model on screen as a .glb: the whole ship, or the one part shown alone. It is made here, in the browser, from the same parts, because a fleet ship's file is far too big to ship. */
+    downloadModel() {
+        if (!this.builtNow)
+            return;
+        // always the full detail, whatever level is on screen
+        const built = build(this.descriptionNow(), { detail: "full" });
+        const { show } = this.settings(built);
+        const part = built.parts.find((p) => p.slot === show);
+        const glb = part ? buildPart(part.record.id).glb() : built.glb();
+        const bytes = glb.bytes;
+        const blob = new Blob([bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength)], { type: "model/gltf-binary" });
+        const link = document.createElement("a");
+        link.href = URL.createObjectURL(blob);
+        link.download = `${built.report.variant?.rocket ?? "rocket"}-${built.report.variant?.id ?? "model"}${part ? `-${part.slot}` : ""}.glb`;
+        link.click();
+        setTimeout(() => URL.revokeObjectURL(link.href), 4000);
+        this.emit("uchusen-download", { triangles: glb.triangles, bytes: bytes.byteLength });
     }
     lastView = "";
     applySettings() {
@@ -570,6 +676,8 @@ export class UchusenRocket extends HTMLBase {
             return;
         this.mark();
         const { look, show, viewName, angle } = this.settings(this.builtNow);
+        if (show !== "together" && show !== "apart")
+            void this.upgrade();
         if (this.viewer) {
             this.viewer.setLook(look);
             this.viewer.setShow(show);
@@ -655,6 +763,7 @@ export class UchusenRocket extends HTMLBase {
                 label: this.getAttribute("label") ?? built.report.label,
                 reducedMotion: reduced,
                 onLost: () => this.fallBack("context-lost"),
+                onNear: () => void this.upgrade(),
                 assets: assets ? `${assets.replace(/\/$/, "")}/` : defaultBase(),
                 onPainted: (state) => {
                     this.dataset.painted = state;
@@ -662,6 +771,7 @@ export class UchusenRocket extends HTMLBase {
                         this.emit("uchusen-painted", { state });
                 },
                 onFlight: () => this.noteFlight(!this.clock?.playing),
+                onDraw: () => this.dispatchEvent(new CustomEvent("uchusen-draw")),
             });
             this.viewer = made;
             window.cancelAnimationFrame(this.flightFrame);
@@ -767,7 +877,7 @@ svg { display: block; }
  * ```
  */
 export class UchusenLineup extends HTMLBase {
-    static observedAttributes = ["items", "unit", "look", "view", "show", "ruler", "labels"];
+    static observedAttributes = ["items", "unit", "look", "view", "show", "ruler", "labels", "filter", "fit", "real"];
     connectedCallback() {
         if (!this.shadowRoot)
             adopt(this.attachShadow({ mode: "open" }), LINEUP_CSS, lineupSheet);
@@ -784,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 } = lineupSvg({
+        const { svg, items: shown, real: shownReal, unit: drawnUnit } = lineupSvg({
+            real: this.getAttribute("real") === "on",
             items,
             unit,
             look: cleanLook(this.getAttribute("look")),
@@ -792,7 +903,10 @@ export class UchusenLineup extends HTMLBase {
             show: this.getAttribute("show") ?? undefined,
             ruler: this.hasAttribute("ruler"),
             labels: this.hasAttribute("labels"),
+            filter: ((value) => (value === "rockets" || value === "fleet" ? value : "all"))(this.getAttribute("filter")),
+            ...((room) => (room.length === 2 && room.every((v) => Number.isFinite(v) && v > 0) ? { fit: { width: room[0], height: room[1] } } : {}))((this.getAttribute("fit") ?? "").split(",").map(Number)),
         });
+        this.dataset.unit = String(Math.round(drawnUnit * 100) / 100);
         const template = document.createElement("template");
         template.innerHTML = svg;
         const node = template.content.firstElementChild;
@@ -802,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";
@@ -42,3 +43,17 @@ export { OPTION_ATTRIBUTES, attributesFromOptions, optionsFromAttributes, rocket
 export type { RocketOptions } from "./attrs.ts";
 export { assetPathOf, CDN, EMBED_KINDS, SITE, THREE_VERSION, embedCode, embedNote, paintedCredit } from "./embed.ts";
 export type { EmbedKind, EmbedSettings } from "./embed.ts";
+export { assemble, BUILDERS, BUILD_BUDGET_MS, COLLAR_CLASSES, COLLARS, designation, FLEET_MAKER, INSETS, isCoarse, KIT, LIVERY, mates, ROOMS, SAMPLE_SHIPS, shipLevels, shipParts, shipPieces, swapsFor, timeBuild } from "./model/fleet/kit.ts";
+export type { Assembly, BuildTime, CollarClass, CollarSpec, Inset, InsetPart, KitModule, Livery, LiveryName, ModuleKind, ModuleOptions, Placed, Port, RoomKind, RoomSpec, SeparationOptions, ShipIssue, ShipList, ShipParts, ShipPlace } from "./model/fleet/kit.ts";
+export { ENGINE_CARDS, engineTable, G0, performanceOf, PROXIMA_LY, rocketSpeed, trip } from "./model/fleet/engines.ts";
+export type { EngineCard, EngineRole, EngineRow, Performance, Trip } from "./model/fleet/engines.ts";
+export { HULL_STACKS, stackDepth } from "./model/fleet/layers.ts";
+export type { HullLayer, HullStack, HullStackName } from "./model/fleet/layers.ts";
+export { SECTIONS } from "./model/fleet/sections.ts";
+export type { Section, SectionRole } from "./model/fleet/sections.ts";
+export { arrangement, deckSummary, exploded, labelDensity, labelsOf, LEGEND, scaleBar, specBlock, titleBlock } from "./model/fleet/sheet.ts";
+export type { Arrangement, Deck, ExplodedModule, Label, LegendSymbol, ScaleBar, SpecLine, TitleBlock } from "./model/fleet/sheet.ts";
+export { FLEET_PALETTE } from "./model/fleet/palette.ts";
+export type { FleetColour } from "./model/fleet/palette.ts";
+export { FLEET_OPERATOR, GLOSSARY } from "./model/fleet/glossary.ts";
+export type { GlossaryCode } from "./model/fleet/glossary.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";
@@ -23,3 +24,10 @@ export { burnsOf, clockWords, FlightClock, flightOf, frameAt, lastPosition, phas
 export { bellsOf, enginesWanted, FLAME_SETTLE_MS, pickBells, plumeLength, ringsOf } from "./engines.js";
 export { OPTION_ATTRIBUTES, attributesFromOptions, optionsFromAttributes, rocketFromParams, rocketToParams } from "./attrs.js";
 export { assetPathOf, CDN, EMBED_KINDS, SITE, THREE_VERSION, embedCode, embedNote, paintedCredit } from "./embed.js";
+export { assemble, BUILDERS, BUILD_BUDGET_MS, COLLAR_CLASSES, COLLARS, designation, FLEET_MAKER, INSETS, isCoarse, KIT, LIVERY, mates, ROOMS, SAMPLE_SHIPS, shipLevels, shipParts, shipPieces, swapsFor, timeBuild } from "./model/fleet/kit.js";
+export { ENGINE_CARDS, engineTable, G0, performanceOf, PROXIMA_LY, rocketSpeed, trip } from "./model/fleet/engines.js";
+export { HULL_STACKS, stackDepth } from "./model/fleet/layers.js";
+export { SECTIONS } from "./model/fleet/sections.js";
+export { arrangement, deckSummary, exploded, labelDensity, labelsOf, LEGEND, scaleBar, specBlock, titleBlock } from "./model/fleet/sheet.js";
+export { FLEET_PALETTE } from "./model/fleet/palette.js";
+export { FLEET_OPERATOR, GLOSSARY } from "./model/fleet/glossary.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;