@johnmorrisdotca/uchusen-rockets 0.2.2 → 0.4.0

package/dist/model/registry.js

@@ -3,6 +3,41 @@ import { DRAGON_VARIANTS } from "../data/dragon.js";
 import { FALCON_9_VARIANTS } from "../data/falcon.js";
 import { STARSHIP_VARIANTS } from "../data/starship.js";
 import { capsule, centreCore, DRAGON_DRAWS, falconFairing, falconFirstStage, FALCON_DRAWS, falconSecondStage, grasshopper, merlin, sideBooster, trunk } from "./falcon.js";
+import { FALCON_1_VARIANTS } from "../data/falcon1.js";
+import { SATURN_V_VARIANTS } from "../data/saturn.js";
+import { FALCON_1_BUILDS } from "./falcon1.js";
+import { SATURN_V_BUILDS } from "./saturn.js";
+import { SHUTTLE_VARIANTS } from "../data/shuttle.js";
+import { SHUTTLE_BUILDS } from "./shuttle.js";
+import { SLS_VARIANTS } from "../data/sls.js";
+import { SLS_BUILDS } from "./sls.js";
+import { NEW_GLENN_VARIANTS } from "../data/newglenn.js";
+import { NEW_GLENN_BUILDS } from "./newglenn.js";
+import { ELECTRON_VARIANTS } from "../data/electron.js";
+import { ELECTRON_BUILDS } from "./electron.js";
+import { SOYUZ_VARIANTS } from "../data/soyuz.js";
+import { SOYUZ_BUILDS } from "./soyuz.js";
+import { DRONESHIP_VARIANTS, LANDING_ZONE_VARIANTS } from "../data/landing.js";
+import { DRONESHIP_BUILDS, LANDING_ZONE_BUILDS } from "./landing.js";
+import { TOWER_VARIANTS } from "../data/tower.js";
+import { TOWER_BUILDS } from "./tower.js";
+import { LUNAR_MODULE_VARIANTS } from "../data/lunarmodule.js";
+import { LUNAR_MODULE_BUILDS } from "./lunarmodule.js";
+import { APOLLO_SOYUZ_VARIANTS } from "../data/apollosoyuz.js";
+import { APOLLO_SOYUZ_BUILDS } from "./apollosoyuz.js";
+import { GEMINI_VARIANTS } from "../data/gemini.js";
+import { GEMINI_BUILDS } from "./gemini.js";
+import { MERCURY_VARIANTS } from "../data/mercury.js";
+import { MERCURY_BUILDS } from "./mercury.js";
+import { JUPITER_C_VARIANTS } from "../data/jupiterc.js";
+import { JUPITER_C_BUILDS } from "./jupiterc.js";
+import { ISS_VARIANTS } from "../data/iss.js";
+import { ISS_BUILDS } from "./iss.js";
+import { HUBBLE_VARIANTS } from "../data/hubble.js";
+import { HUBBLE_BUILDS } from "./hubble.js";
+import { DRAGON_INSIDE_BUILDS } from "./dragoninside.js";
+import { STARBASE_VARIANTS } from "../data/starbase.js";
+import { STARBASE_BUILDS } from "./starbase.js";
 import { boosterPieces, flap, gridFin, raptor, shipPieces, STARSHIP_DRAWS } from "./starship.js";
 const blankFigure = { value: null, source: null, note: "No source gives this part's size: it is drawn from photographs." };
 const STAGE = "stage";
@@ -82,9 +117,12 @@ for (const id of Object.keys(FALCON_DRAWS)) {
 const DRAGON_FROM = {
     "dragon-1": "This package's code for the two line looks, proportions taken from ProgressTH's model; ProgressTH's model for the painted look. It shows the original Dragon 1, with solar wings, not Cargo Dragon 2.",
     "dragon-2": "This package's code for the two line looks, proportions taken from KUBAHA's model; KUBAHA's model for the painted look. It shows Crew Dragon, with windows.",
+    "cargo-dragon-2": "This package's code in every look, on Dragon 2's sourced sizes, with no windows as its article says. No licensed model shows it.",
 };
 for (const variant of DRAGON_VARIANTS) {
     const d = DRAGON_DRAWS[variant.id];
+    if (!d)
+        continue;
     const trueTo = variant.id === "dragon-2" ? [variant.id, "block-5-dragon-2"] : [variant.id];
     const joint = 3.7;
     entries.push({ record: { id: `dragon-${variant.id}-trunk`, kind: "trunk", name: `Trunk, ${variant.name}`, rocket: "dragon", trueTo, height: d.trunk, diameter: d.trunkRadius * 2, sourced: { height: variant.facts.parts.trunk, diameter: blankFigure }, joints: { bottom: { kind: "stage", y: 0, diameter: joint }, top: { kind: "stage", y: d.trunk, diameter: joint } }, painted: PAINTED[`dragon-${variant.id}-trunk`] ?? null, drawnFrom: DRAGON_FROM[variant.id] }, pieces: () => trunk(d) }, { record: { id: `dragon-${variant.id}-capsule`, kind: "capsule", name: `Capsule, ${variant.name}`, rocket: "dragon", trueTo, height: d.capsule, diameter: d.baseRadius * 2, sourced: { height: variant.facts.parts.capsule, diameter: variant.facts.diameter }, joints: { bottom: { kind: "stage", y: d.nest, diameter: joint } }, painted: PAINTED[`dragon-${variant.id}-capsule`] ?? null, drawnFrom: DRAGON_FROM[variant.id] }, pieces: () => capsule(d) });
@@ -94,11 +132,58 @@ const FH_SIDE_HEIGHT = 45.6;
 const FH_OFFSET = 4.25;
 const figure = (value, source) => ({ value, source });
 entries.push({ record: { id: "falcon-heavy-falcon-heavy-centre", kind: "first-stage", name: "Falcon Heavy centre core, with its upper stage and fairing", rocket: "falcon-heavy", trueTo: ["falcon-heavy"], height: 70, diameter: 5.2, sourced: { height: figure(70, "wikipedia-falcon-heavy"), diameter: { ...blankFigure, note: "3.7 m the core; 5.2 m the fairing." } }, joints: {}, painted: PAINTED["falcon-heavy-falcon-heavy-centre"], drawnFrom: FH_FROM }, pieces: () => centreCore(70, 1.85) }, { record: { id: "falcon-heavy-falcon-heavy-side-left", kind: "first-stage", name: "Falcon Heavy side booster, left", rocket: "falcon-heavy", trueTo: ["falcon-heavy"], height: FH_SIDE_HEIGHT, diameter: 3.7, strapOn: { x: -FH_OFFSET, z: 0 }, sourced: { height: blankFigure, diameter: figure(3.7, "wikipedia-falcon-heavy") }, joints: {}, painted: PAINTED["falcon-heavy-falcon-heavy-side-left"], drawnFrom: FH_FROM }, pieces: () => sideBooster(FH_SIDE_HEIGHT, 1.85, -1) }, { record: { id: "falcon-heavy-falcon-heavy-side-right", kind: "first-stage", name: "Falcon Heavy side booster, right", rocket: "falcon-heavy", trueTo: ["falcon-heavy"], height: FH_SIDE_HEIGHT, diameter: 3.7, strapOn: { x: FH_OFFSET, z: 0 }, sourced: { height: blankFigure, diameter: figure(3.7, "wikipedia-falcon-heavy") }, joints: {}, painted: PAINTED["falcon-heavy-falcon-heavy-side-right"], drawnFrom: FH_FROM }, pieces: () => sideBooster(FH_SIDE_HEIGHT, 1.85, 1) }, { record: { id: "grasshopper-grasshopper-vehicle", kind: "test-vehicle", name: "Grasshopper, test vehicle", rocket: "grasshopper", trueTo: ["grasshopper"], height: 32, diameter: 3.2, sourced: { height: figure(32, "wikipedia-grasshopper"), diameter: blankFigure }, joints: {}, painted: PAINTED["grasshopper-grasshopper-vehicle"], drawnFrom: "This package's code for the two line looks, proportions taken from Echo_3's low-poly model at the sourced height; that model for the painted look." }, pieces: () => grasshopper(32) });
+// ---------------------------------------------------------------------------------------------------------------------------------
+// Rockets drawn wholly by this package's code, from their tables
+const stackFacts = [...HUBBLE_VARIANTS, ...ISS_VARIANTS, ...JUPITER_C_VARIANTS, ...MERCURY_VARIANTS, ...GEMINI_VARIANTS, ...APOLLO_SOYUZ_VARIANTS, ...LUNAR_MODULE_VARIANTS, ...STARBASE_VARIANTS, ...DRAGON_VARIANTS, ...TOWER_VARIANTS, ...DRONESHIP_VARIANTS, ...LANDING_ZONE_VARIANTS, ...SOYUZ_VARIANTS, ...NEW_GLENN_VARIANTS, ...ELECTRON_VARIANTS, ...SLS_VARIANTS, ...FALCON_1_VARIANTS, ...SATURN_V_VARIANTS, ...SHUTTLE_VARIANTS];
+const stacks = [...HUBBLE_BUILDS, ...ISS_BUILDS, ...JUPITER_C_BUILDS, ...MERCURY_BUILDS, ...GEMINI_BUILDS, ...APOLLO_SOYUZ_BUILDS, ...LUNAR_MODULE_BUILDS, ...STARBASE_BUILDS, ...DRAGON_INSIDE_BUILDS, ...TOWER_BUILDS, ...DRONESHIP_BUILDS, ...LANDING_ZONE_BUILDS, ...SOYUZ_BUILDS, ...NEW_GLENN_BUILDS, ...ELECTRON_BUILDS, ...SLS_BUILDS, ...FALCON_1_BUILDS, ...SATURN_V_BUILDS, ...SHUTTLE_BUILDS];
+for (const build of stacks)
+    for (const part of build.parts) {
+        const { height, diameter } = facts(stackFacts, build.variant, part.slot);
+        entries.push({
+            record: {
+                id: `${build.rocket}-${build.variant}-${part.slot}`,
+                kind: part.kind,
+                name: part.name,
+                rocket: build.rocket,
+                trueTo: [build.variant, ...(part.alsoTrueTo ?? [])],
+                height: part.height,
+                diameter: part.diameter,
+                sourced: { height, diameter: part.sourcedDiameter ?? diameter },
+                joints: { ...(part.top ? { top: { kind: STAGE, y: part.top[0], diameter: part.top[1] } } : {}), ...(part.bottom ? { bottom: { kind: STAGE, y: part.bottom[0], diameter: part.bottom[1] } } : {}) },
+                ...(part.place ? { strapOn: part.place } : {}),
+                painted: part.painted ?? null,
+                drawnFrom: build.drawnFrom,
+            },
+            pieces: part.pieces,
+        });
+    }
 const RAPTOR_DIAMETER = { value: 1.3, source: "wikipedia-raptor", note: "The family's engine diameter." };
 const RAPTOR_LENGTH = { value: 3.1, source: "wikipedia-raptor", note: "The family's length." };
 const b3 = STARSHIP_DRAWS.v3;
 const b2 = STARSHIP_DRAWS.v2;
 entries.push(detail("raptor-sea-level", "engine", "Raptor, sea-level", 3.1, 1.24, { height: RAPTOR_LENGTH, diameter: RAPTOR_DIAMETER }, () => raptor([0, 0], 0, "sea")), detail("raptor-vacuum", "engine", "Raptor, vacuum", 4.4, 2.3, { height: blankFigure, diameter: blankFigure }, () => raptor([0, 0], 0, "vacuum")), detail("grid-fin-four", "fin", "Grid fin, Blocks 1 and 2", 0.9, 2.9, { height: blankFigure, diameter: blankFigure }, () => gridFin(90, 0, b2.radius, b2.fins.reach, b2.fins.width, b2.fins.thick, false)), detail("grid-fin-three", "fin", "Grid fin, Block 3", 0.9, 3.4, { height: blankFigure, diameter: blankFigure }, () => gridFin(90, 0, b3.radius, b3.fins.reach, b3.fins.width, b3.fins.thick, true)), detail("flap-aft", "flap", "Aft flap", 11.6, 3.8, { height: blankFigure, diameter: blankFigure }, () => [flap(b3.aft, 1)]), detail("flap-forward", "flap", "Forward flap, Blocks 2 and 3", 8.1, 4.7, { height: blankFigure, diameter: blankFigure }, () => [flap(b3.forward, 1)]), detail("merlin-sea-level", "engine", "Merlin, sea-level", 2, 0.92, { height: blankFigure, diameter: blankFigure }, () => merlin([0, 0], 0, 0.46, 2)));
+/**
+ * Every part of every rocket, each with its record: its real size in metres, the joints it mates at, and where its shape came from.
+ *
+ * @example
+ * ```ts
+ * import { PART_ENTRIES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(PART_ENTRIES.length, PART_ENTRIES[0]?.record.name);
+ * ```
+ */
 export const PART_ENTRIES = entries;
 const byId = new Map(entries.map((entry) => [entry.record.id, entry]));
+/**
+ * Finds a part by its id.
+ *
+ * @param id A part's id.
+ * @returns The part's entry, or undefined for an id that is not a part.
+ * @example
+ * ```ts
+ * import { partEntry } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(partEntry("raptor-vacuum")?.record.height, partEntry("nonsense"));
+ * ```
+ */
 export const partEntry = (id) => byId.get(id);

package/dist/model/saturn.d.ts

@@ -0,0 +1,2 @@
+import type { StackBuild } from "./stacks.ts";
+export declare const SATURN_V_BUILDS: readonly StackBuild[];

package/dist/model/saturn.js

@@ -0,0 +1,122 @@
+// Saturn V from a table of numbers: the stages' lengths and widths are sourced, and so are the F-1's and J-2's lengths and widths. Where the paint runs and how the foot is arranged are judged from photographs.
+import { blank } from "../data/types.js";
+import { deg } from "../framing.js";
+import { fins, floor, nose, pod, skirt, stripes, taper, tube } from "./kit.js";
+import { merlin } from "./falcon.js";
+const FT = 0.3048;
+const R1 = 10.06 / 2;
+const R3 = 6.6 / 2;
+const RC = 3.91 / 2;
+const NEST = 7.49 - 4.52;
+const H1 = 42.06;
+const H2 = 24.87;
+const H3 = 17.86;
+const HA = 9.45;
+const HS = 4.52;
+const HC = 3.48;
+const WHOLE = 110.64;
+const TOWER = WHOLE - (H1 + H2 + H3 + HA + HS + HC);
+const COVER = HC * 0.92;
+const F1_EXIT = (12.2 * FT) / 2;
+const F1_LONG = 18.5 * FT;
+const J2_EXIT = (6.8 * FT) / 2;
+const J2_LONG = 11.1 * FT;
+function firstStage() {
+    const foot = 5;
+    const outer = R1 * 0.63;
+    const out = [
+        tube("white", R1, foot, H1, { rings: [foot + 0.02, 18.5, 24, H1 - 3.4], welds: [11, 32] }),
+        floor(R1, foot),
+        // two wide stripes up the fuel tank, and the checks of the tank between
+        ...stripes("black", R1, foot, 18.5, [0, 180], 44),
+        ...stripes("black", R1, 18.5, 24, [90, 270], 44),
+        ...stripes("black", R1, H1 - 3.4, H1, [0, 90, 180, 270], 44),
+        ...merlin([0, 0], 0, F1_EXIT, F1_LONG),
+    ];
+    for (const az of [45, 135, 225, 315]) {
+        const at = [outer * Math.sin(deg(az)), outer * Math.cos(deg(az))];
+        out.push(...merlin(at, 0, F1_EXIT, F1_LONG));
+        // the fairing over each outer engine, and its fin
+        out.push(pod("white", [at[0] * 0.92, at[1] * 0.92], F1_EXIT * 1.08, foot * 0.72, F1_EXIT * 0.3, foot + 4, { outline: true }));
+    }
+    out.push(...fins("white", R1, [45, 135, 225, 315], [[0, foot - 1], [4.2, foot - 2.6], [4.2, foot - 1.2], [0, foot + 5]], 0.3));
+    return out;
+}
+function secondStage() {
+    const skirtTop = 5.5;
+    return [
+        ...skirt("white", R1, 0, skirtTop, { rings: [skirtTop - 0.02] }),
+        tube("white", R1, skirtTop, H2, { rings: [H2 - 0.02], welds: [11, 15, 19] }),
+        ...stripes("black", R1, skirtTop - 2.6, skirtTop, [0, 90, 180, 270], 44),
+        floor(R1, skirtTop),
+        ...merlin([0, 0], 2.1, J2_EXIT, J2_LONG),
+        ...[45, 135, 225, 315].flatMap((az) => merlin([R1 * 0.64 * Math.sin(deg(az)), R1 * 0.64 * Math.cos(deg(az))], 2.1, J2_EXIT, J2_LONG)),
+    ];
+}
+function thirdStage() {
+    const flare = 5.8;
+    return [
+        taper("white", R1, 0, R3, flare, { rings: [0.02, flare - 0.02], welds: [flare / 2] }),
+        { kind: "lathe", material: "soot", segs: 32, under: true, only: "mesh", profile: [[R3 * 0.97, flare], [R1 * 0.97, 0]] },
+        tube("white", R3, flare, H3, { rings: [H3 - 0.02], welds: [11, 14] }),
+        ...stripes("black", R3, flare, flare + 2.8, [0, 180], 60),
+        floor(R3, flare),
+        ...merlin([0, 0], flare - J2_LONG + 0.4, J2_EXIT, J2_LONG),
+    ];
+}
+function adapter() {
+    const iu = 36 * 0.0254;
+    return [
+        tube("white", R3, 0, iu, { rings: [iu - 0.02] }),
+        taper("white", R3, iu, RC, HA, { rings: [iu + 7 * FT], welds: [iu + 4.2 * FT] }),
+        floor(R3, 0),
+    ];
+}
+function serviceModule() {
+    return [
+        tube("steel", RC, NEST, NEST + HS, { rings: [NEST + 0.02, NEST + HS - 0.02], welds: [NEST + HS * 0.5] }),
+        floor(RC, NEST),
+        ...merlin([0, 0], 0, 1.1, NEST * 1.02),
+    ];
+}
+function capsule() {
+    return [
+        { kind: "lathe", material: "steel", segs: 40, body: true, outline: true, profile: [[RC, 0.3], [RC * 0.98, 0.5], [RC * 0.22, HC * 0.88], [0.25, HC * 0.94], [0.001, HC]], rings: [0.5] },
+        { kind: "lathe", material: "soot", segs: 30, under: true, profile: [[0, 0], [RC * 0.82, 0.08], [RC, 0.3]] },
+    ];
+}
+function escapeTower() {
+    const coverBase = 0.3;
+    const motorFrom = COVER + TOWER * 0.26;
+    const top = COVER + TOWER;
+    const out = [
+        { kind: "lathe", material: "white", segs: 40, body: true, outline: true, profile: [[RC + 0.03, coverBase], [RC * 0.24, COVER], [0.3, COVER + 0.3]], rings: [coverBase + 0.02] },
+        tube("white", 0.33, motorFrom, top - 2.6),
+        taper("white", 0.33, top - 2.6, 0.12, top - 1),
+        nose("red", 0.12, top - 1, top, 1.2),
+    ];
+    // the open frame between the cover and the motor
+    for (const az of [45, 135, 225, 315]) {
+        const a = deg(az);
+        const [x0, z0, x1, z1] = [0.3 * Math.sin(a), 0.3 * Math.cos(a), 0.62 * Math.sin(a), 0.62 * Math.cos(a)];
+        out.push({ kind: "lines", weight: "feature", only: "drawing", paths: [[[x1, COVER, z1], [x0, motorFrom, z0]]] });
+        out.push({ kind: "lathe", material: "red", at: [(x0 + x1) / 2, (z0 + z1) / 2], segs: 6, only: "mesh", profile: [[0.07, COVER + 0.2], [0.07, motorFrom]] });
+    }
+    return out;
+}
+export const SATURN_V_BUILDS = [
+    {
+        rocket: "saturn-v",
+        variant: "saturn-v",
+        drawnFrom: "This package's code, its lengths and widths from the sources; the paint and the foot judged from photographs. No licensed model shows it, and no flag or lettering is drawn.",
+        parts: [
+            { slot: "first-stage", kind: "first-stage", name: "S-IC, first stage, Saturn V", height: H1, diameter: R1 * 2, top: [H1, R1 * 2], sourcedDiameter: { value: 10.06, source: "wikipedia-saturn-v" }, pieces: firstStage },
+            { slot: "second-stage", kind: "second-stage", name: "S-II, second stage, Saturn V", height: H2, diameter: R1 * 2, bottom: [0, R1 * 2], top: [H2, R1 * 2], sourcedDiameter: { value: 10.06, source: "wikipedia-saturn-v" }, pieces: secondStage },
+            { slot: "third-stage", kind: "third-stage", name: "S-IVB, third stage, Saturn V", height: H3, diameter: R3 * 2, bottom: [0, R1 * 2], top: [H3, R3 * 2], sourcedDiameter: { value: 6.6, source: "wikipedia-saturn-v", note: "21 feet 8 inches. It flares to the second stage's width at its foot." }, pieces: thirdStage },
+            { slot: "adapter", kind: "adapter", name: "Instrument unit and spacecraft adapter, Saturn V", height: HA, diameter: R3 * 2, bottom: [0, R3 * 2], top: [HA, RC * 2], sourcedDiameter: { value: 6.6, source: "wikipedia-saturn-v" }, pieces: adapter },
+            { slot: "service-module", kind: "service-module", name: "Apollo service module", height: NEST + HS, diameter: RC * 2, bottom: [NEST, RC * 2], top: [NEST + HS, RC * 2], sourcedDiameter: { value: 3.91, source: "wikipedia-apollo-csm", note: "12 feet 10 inches." }, pieces: serviceModule },
+            { slot: "capsule", kind: "capsule", name: "Apollo command module", height: HC, diameter: RC * 2, bottom: [0, RC * 2], top: [HC, 0.5], sourcedDiameter: { value: 3.91, source: "wikipedia-apollo-csm", note: "12 feet 10 inches." }, pieces: capsule },
+            { slot: "escape-tower", kind: "tower", name: "Launch escape tower and its cover", height: COVER + TOWER, diameter: (RC + 0.03) * 2, bottom: [COVER, 0.5], sourcedDiameter: blank("No source read here gives it."), pieces: escapeTower },
+        ],
+    },
+];

package/dist/model/shuttle.d.ts

@@ -0,0 +1,2 @@
+import type { StackBuild } from "./stacks.ts";
+export declare const SHUTTLE_BUILDS: readonly StackBuild[];

package/dist/model/shuttle.js

@@ -0,0 +1,111 @@
+// The Space Shuttle from a table of numbers: the tank's, the boosters' and the orbiter's lengths and widths are sourced, as are the RS-25's. The orbiter's outline and how the parts stand are judged from photographs.
+import { ORBITER_SPAN, SHUTTLE_SRB_DIAMETER, SHUTTLE_TANK_DIAMETER } from "../data/shuttle.js";
+import { merlin } from "./falcon.js";
+import { floor, nose, taper, tube } from "./kit.js";
+import { strut } from "./pieces.js";
+const WHOLE = 56;
+const TANK = 46.88;
+const TANK_R = 8.41 / 2;
+const TANK_Y = WHOLE - TANK;
+const SRB = 45.46;
+const SRB_R = 3.71 / 2;
+const SRB_X = TANK_R + SRB_R + 0.65;
+const ORB = 37.24;
+const ORB_R = 2.7;
+const ORB_Y = 8.2;
+const ORB_Z = -(TANK_R + 0.9 + 2.2);
+// the engine's sourced length and exit, 168 and 90.7 inches
+const RS25_LONG = 168 * 0.0254;
+const RS25_EXIT = (90.7 * 0.0254) / 2;
+function tank() {
+    const r = TANK_R;
+    const top = [];
+    const from = TANK - 19;
+    for (let i = 0; i <= 12; i++) {
+        const t = i / 12;
+        top.push([r * Math.sqrt(Math.max(0, 1 - t ** 2.4)), from + 19 * t]);
+    }
+    top[12] = [0.001, TANK];
+    const orbiterSide = [0, 0, -r];
+    const hold = (y, x) => strut("foam", [x, y, orbiterSide[2]], [x, y, orbiterSide[2] - 0.9], 0.4, 0.4);
+    return [
+        { kind: "lathe", material: "foam", segs: 48, body: true, outline: true, profile: [[0.001, 0], [r * 0.55, 0.45], [r * 0.85, 1.5], [r, 3.4], [r, from], ...top.slice(1)], rings: [from, from - 7], welds: [10, 19] },
+        // the pipe that runs down its side, and the rods that hold the orbiter
+        { kind: "plate", material: "foam", frame: { o: [0.9, 2, -r], u: [0, 1, 0], v: [-1, 0, 0], w: [0, 0, -1] }, outline: [[0, 0], [TANK - 6, 0], [TANK - 6, 0.5], [0, 0.5]], thickness: 0.5, plain: true },
+        hold(3, 1.6),
+        hold(3, -1.6),
+        hold(27, 0),
+    ];
+}
+function booster() {
+    const r = SRB_R;
+    const shoulder = SRB - 7.4;
+    return [
+        taper("white", r * 1.4, 1, r, 3.8, { rings: [1.02] }),
+        { kind: "lathe", material: "soot", segs: 30, under: true, profile: [[0, 1], [r * 1.4, 1]] },
+        tube("white", r, 3.8, shoulder, { rings: [3.82, 12, 20, 28, shoulder - 0.02], welds: [8, 16, 24, 32] }),
+        taper("white", r, shoulder, r * 0.5, SRB - 1.4, { rings: [SRB - 4.5] }),
+        nose("white", r * 0.5, SRB - 1.4, SRB, 1.2),
+        ...merlin([0, 0], 0, r * 1.02, 3.6),
+    ];
+}
+const FLAT = { o: [0, 0, 1.3], u: [1, 0, 0], v: [0, 1, 0], w: [0, 0, 1] };
+function orbiter() {
+    const r = ORB_R;
+    const base = RS25_LONG * 0.8;
+    const span = (ORBITER_SPAN.value ?? 0) / 2;
+    const profile = [[r, base], [r, ORB - 12], [r * 0.98, ORB - 9], [r * 0.88, ORB - 6], [r * 0.66, ORB - 3], [r * 0.38, ORB - 1], [0.16, ORB - 0.2], [0.001, ORB]];
+    const belly = (y) => {
+        void y;
+        return [-Math.PI * 0.42, Math.PI * 0.42];
+    };
+    const out = [
+        { kind: "lathe", material: "white", segs: 40, body: true, outline: true, profile, rings: [ORB - 12], welds: [base + 10, base + 19] },
+        floor(r, base),
+        // the black belly and nose, in one shell just proud of the white
+        { kind: "lathe", material: "black", segs: 40, body: true, arc: belly, profile: profile.slice(0, 6).map(([a, b]) => [a * 1.012, b]) },
+        { kind: "lathe", material: "black", segs: 24, body: true, profile: [[r * 0.38 * 1.015, ORB - 1], [0.16 * 1.015, ORB - 0.2], [0.001, ORB + 0.01]] },
+        // the windscreen, the payload bay's doors, the tail and the two engine pods
+        { kind: "plate", material: "black", frame: { o: [0, ORB - 6.3, -r * 0.8], u: [1, 0, 0], v: [0, 0.94, -0.34], w: [0, -0.34, -0.94] }, outline: [[-1, 0], [1, 0], [0.8, 1.1], [-0.8, 1.1]], thickness: 0.08, plain: true },
+        { kind: "lines", weight: "feature", paths: [[[0, base + 3.6, -r - 0.01], [0, ORB - 11, -r - 0.01]], [[-1.95, base + 3.6, -1.9], [-1.95, ORB - 11, -1.9]], [[1.95, base + 3.6, -1.9], [1.95, ORB - 11, -1.9]]] },
+        { kind: "plate", material: "white", frame: { o: [0, 0, 0], u: [0, 0, -1], v: [0, 1, 0], w: [1, 0, 0] }, outline: [[r - 0.2, base], [r + 8, base + 0.2], [r + 8, base + 2.2], [r - 0.2, base + 9.2]], thickness: 0.34 },
+        { kind: "plate", material: "black", frame: { o: [0, 0, 0], u: [0, 0, -1], v: [0, 1, 0], w: [1, 0, 0] }, outline: [[r + 0.1, base + 8.7], [r + 8.02, base + 2.1], [r + 8.02, base + 2.4], [r + 0.1, base + 9.2]], thickness: 0.4, plain: true },
+        ...[1, -1].map((side) => ({ kind: "lathe", material: "white", at: [side * 2, -1.9], segs: 14, profile: [[1.05, base + 0.3], [1.05, base + 5.5], [0.82, base + 7.8], [0.3, base + 9.1], [0.001, base + 9.5]], rings: [base + 5.5] })),
+        ...merlin([0, -1.7], 0, RS25_EXIT, RS25_LONG),
+        ...merlin([-1.35, 0.7], 0, RS25_EXIT, RS25_LONG),
+        ...merlin([1.35, 0.7], 0, RS25_EXIT, RS25_LONG),
+        // the flap under the engines
+        { kind: "plate", material: "black", frame: FLAT, outline: [[-3.2, base - 1.6], [3.2, base - 1.6], [3.2, base + 0.1], [-3.2, base + 0.1]], thickness: 0.4, plain: true },
+    ];
+    // each wing: white above, black below, its leading edge black. Two plates, so each stays convex
+    for (const side of [1, -1]) {
+        const main = [[r - 0.3, base + 0.3], [span, base + 0.3], [span, base + 2], [5.1, base + 12], [r - 0.3, base + 12]];
+        const strake = [[r - 0.3, base + 12], [5.1, base + 12], [r - 0.3, base + 21]];
+        const mirrored = (points) => points.map(([u, v]) => [u * side, v]);
+        out.push({ kind: "plate", material: "white", top: "black", frame: FLAT, outline: mirrored(main), thickness: 0.6 });
+        out.push({ kind: "plate", material: "white", top: "black", frame: FLAT, outline: mirrored(strake), thickness: 0.5 });
+        const edge = (a, b) => strut("black", [a[0] * side, a[1], FLAT.o[2]], [b[0] * side, b[1], FLAT.o[2]], 0.5, 0.66);
+        out.push(edge([span - 0.3, base + 2.4], [5.1, base + 12]), edge([5.1, base + 12], [r - 0.3, base + 21]));
+    }
+    return out;
+}
+const FROM = "NASA's models for the painted look, their marks painted out. This package's code for the two line looks, from the sourced lengths and widths. The orbiter's outline and where the parts stand are judged from photographs. No name, flag or mark is drawn.";
+export const SHUTTLE_BUILDS = [
+    {
+        rocket: "space-shuttle",
+        variant: "discovery",
+        drawnFrom: "The Smithsonian's scan for the painted look, its marks painted out; this package's own orbiter for the two line looks, from the same sourced sizes.",
+        parts: [{ slot: "orbiter", kind: "orbiter", name: "Discovery, OV-103", height: ORB, diameter: ORBITER_SPAN.value ?? 0, sourcedDiameter: ORBITER_SPAN, painted: { file: "space-shuttle-discovery-orbiter.glb", credit: "smithsonian-discovery" }, pieces: orbiter }],
+    },
+    {
+        rocket: "space-shuttle",
+        variant: "stack",
+        drawnFrom: FROM,
+        parts: [
+            { slot: "external-tank", kind: "tank", name: "External tank", height: TANK, diameter: TANK_R * 2, place: { x: 0, z: 0, y: TANK_Y }, sourcedDiameter: SHUTTLE_TANK_DIAMETER, painted: { file: "space-shuttle-stack-external-tank.glb", credit: "nasa-shuttle-parts" }, pieces: tank },
+            { slot: "srb-left", kind: "solid-booster", name: "Solid rocket booster, left", height: SRB, diameter: SRB_R * 2, place: { x: -SRB_X, z: 0 }, sourcedDiameter: SHUTTLE_SRB_DIAMETER, painted: { file: "space-shuttle-stack-srb.glb", credit: "nasa-shuttle-parts" }, pieces: booster },
+            { slot: "srb-right", kind: "solid-booster", name: "Solid rocket booster, right", height: SRB, diameter: SRB_R * 2, place: { x: SRB_X, z: 0 }, sourcedDiameter: SHUTTLE_SRB_DIAMETER, painted: { file: "space-shuttle-stack-srb.glb", credit: "nasa-shuttle-parts" }, pieces: booster },
+            { slot: "orbiter", kind: "orbiter", name: "Orbiter", height: ORB, diameter: (ORBITER_SPAN.value ?? 0), place: { x: 0, z: ORB_Z, y: ORB_Y }, sourcedDiameter: ORBITER_SPAN, painted: { file: "space-shuttle-stack-orbiter.glb", credit: "nasa-shuttle-hi-res" }, pieces: orbiter },
+        ],
+    },
+];

package/dist/model/sls.d.ts

@@ -0,0 +1,2 @@
+import type { StackBuild } from "./stacks.ts";
+export declare const SLS_BUILDS: readonly StackBuild[];

package/dist/model/sls.js

@@ -0,0 +1,83 @@
+// The Space Launch System from a table of numbers: the whole, the core, the boosters, the service module and the capsule are sourced. The rest is what the whole leaves, and where the boosters stand is judged from photographs.
+import { ORION_DIAMETER, SLS_SRB_DIAMETER } from "../data/sls.js";
+import { blank } from "../data/types.js";
+import { merlin } from "./falcon.js";
+import { floor, nose, stripes, taper, tube } from "./kit.js";
+const WHOLE = 98.15;
+const CORE = 64.6;
+const CORE_R = 8.41 / 2;
+const SRB = 53.95;
+const SRB_R = 3.71 / 2;
+const SRB_X = CORE_R + SRB_R + 0.8;
+const SERVICE = 3.96;
+const CREW = 3.3;
+const ORION_R = 5.03 / 2;
+const UPPER_R = 2.55;
+const TOP = WHOLE - CORE - SERVICE - CREW;
+// the upper stage and its adapters take 15 m of what is left, judged from photographs, and the tower the rest
+const UPPER = 15.4;
+const TOWER = TOP - UPPER;
+const COVER = CREW * 0.9;
+const RS25_LONG = 168 * 0.0254;
+const RS25_EXIT = (90.7 * 0.0254) / 2;
+function core() {
+    const foot = 3.2;
+    return [
+        tube("foam", CORE_R, foot, CORE, { rings: [foot + 0.02, 7.5, 44, 50.5, CORE - 0.02], welds: [20, 34, 57] }),
+        floor(CORE_R, foot),
+        ...stripes("black", CORE_R, foot, foot + 3, [0, 90, 180, 270], 30),
+        ...[45, 135, 225, 315].flatMap((az) => merlin([1.9 * Math.sin((az * Math.PI) / 180), 1.9 * Math.cos((az * Math.PI) / 180)], 0, RS25_EXIT, RS25_LONG)),
+    ];
+}
+function booster() {
+    const r = SRB_R;
+    const shoulder = SRB - 7.6;
+    return [
+        taper("white", r * 1.4, 1, r, 3.8, { rings: [1.02] }),
+        { kind: "lathe", material: "soot", segs: 30, under: true, profile: [[0, 1], [r * 1.4, 1]] },
+        tube("white", r, 3.8, shoulder, { rings: [3.82, 13, 22, 31, 40, shoulder - 0.02], welds: [8, 17, 26, 35] }),
+        taper("white", r, shoulder, r * 0.5, SRB - 1.4, { rings: [SRB - 4.6] }),
+        nose("white", r * 0.5, SRB - 1.4, SRB, 1.2),
+        ...merlin([0, 0], 0, r * 1.02, 3.6),
+    ];
+}
+function upperStage() {
+    return [
+        taper("white", CORE_R, 0, UPPER_R, 8.2, { rings: [0.02, 8.18], welds: [4] }),
+        floor(CORE_R, 0),
+        tube("white", UPPER_R, 8.2, 12.4, { rings: [12.38] }),
+        taper("white", UPPER_R, 12.4, ORION_R, UPPER, { rings: [UPPER - 0.02] }),
+    ];
+}
+const service = () => [tube("steel", ORION_R, 0, SERVICE, { rings: [0.02, SERVICE - 0.02] }), floor(ORION_R, 0)];
+const crew = () => [
+    { kind: "lathe", material: "steel", segs: 40, body: true, outline: true, profile: [[ORION_R, 0.25], [ORION_R * 0.98, 0.45], [ORION_R * 0.42, CREW * 0.92], [0.5, CREW], [0.001, CREW]] },
+    { kind: "lathe", material: "soot", segs: 30, under: true, profile: [[0, 0], [ORION_R * 0.86, 0.08], [ORION_R, 0.25]] },
+];
+function tower() {
+    const top = COVER + TOWER;
+    return [
+        { kind: "lathe", material: "white", segs: 40, body: true, outline: true, profile: [[ORION_R * 1.02, 0.25], [ORION_R * 0.46, COVER], [0.55, COVER + 0.25]], rings: [0.27] },
+        tube("white", 0.55, COVER + 0.25, top - 2.6, { welds: [COVER + 1.4] }),
+        taper("white", 0.55, top - 2.6, 0.2, top - 0.7),
+        nose("white", 0.2, top - 0.7, top, 1.2),
+    ];
+}
+const FROM = "This package's code, from the sourced sizes; the upper stage's and the abort tower's lengths are what the whole leaves, judged from photographs. No licensed model is used, and no name, flag or mark is drawn.";
+const NONE = blank("No source read here gives it.");
+export const SLS_BUILDS = [
+    {
+        rocket: "sls",
+        variant: "block-1",
+        drawnFrom: FROM,
+        parts: [
+            { slot: "first-stage", kind: "first-stage", name: "Core stage, Space Launch System", height: CORE, diameter: CORE_R * 2, top: [CORE, CORE_R * 2], pieces: core },
+            { slot: "srb-left", kind: "solid-booster", name: "Five-segment booster, left", height: SRB, diameter: SRB_R * 2, place: { x: -SRB_X, z: 0 }, sourcedDiameter: SLS_SRB_DIAMETER, pieces: booster },
+            { slot: "srb-right", kind: "solid-booster", name: "Five-segment booster, right", height: SRB, diameter: SRB_R * 2, place: { x: SRB_X, z: 0 }, sourcedDiameter: SLS_SRB_DIAMETER, pieces: booster },
+            { slot: "upper-stage", kind: "second-stage", name: "Upper stage and its adapters, Space Launch System", height: UPPER, diameter: CORE_R * 2, bottom: [0, CORE_R * 2], top: [UPPER, ORION_R * 2], sourcedDiameter: NONE, pieces: upperStage },
+            { slot: "service-module", kind: "service-module", name: "Orion's service module", height: SERVICE, diameter: ORION_R * 2, bottom: [0, ORION_R * 2], top: [SERVICE, ORION_R * 2], sourcedDiameter: ORION_DIAMETER, pieces: service },
+            { slot: "capsule", kind: "capsule", name: "Orion's crew module", height: CREW, diameter: ORION_R * 2, bottom: [0, ORION_R * 2], top: [CREW, 1.1], sourcedDiameter: ORION_DIAMETER, pieces: crew },
+            { slot: "escape-tower", kind: "tower", name: "Orion's abort tower and its cover", height: COVER + TOWER, diameter: ORION_R * 2.04, bottom: [COVER, 1.1], sourcedDiameter: NONE, pieces: tower },
+        ],
+    },
+];

package/dist/model/soyuz.d.ts

@@ -0,0 +1,2 @@
+import type { StackBuild } from "./stacks.ts";
+export declare const SOYUZ_BUILDS: readonly StackBuild[];

package/dist/model/soyuz.js

@@ -0,0 +1,75 @@
+// Soyuz-2 from a table of numbers: the whole, the core, the boosters, the third stage and the width over the fins are sourced. Its waist, how far the boosters lean and the paint are judged from photographs.
+import { SOYUZ_BOOSTER_DIAMETER } from "../data/soyuz.js";
+import { blank } from "../data/types.js";
+import { deg } from "../framing.js";
+import { merlin } from "./falcon.js";
+import { fairingShell, floor, tube } from "./kit.js";
+import { radial, strut } from "./pieces.js";
+const WHOLE = 46.3;
+const CORE = 27.1;
+const CORE_R = 2.95 / 2;
+const WAIST = 1.05;
+const BOOST = 19.6;
+const BOOST_R = 2.68 / 2;
+const THIRD = 6.7;
+const THIRD_R = 2.66 / 2;
+const FAIRING = WHOLE - CORE - THIRD;
+const FAIRING_R = 1.65;
+const SPAN = 10.3 / 2;
+const CHAMBER = 0.34;
+/** Four chambers in a square, as one engine of this family has. */
+const chambers = (at, y, spread) => [[1, 1], [1, -1], [-1, 1], [-1, -1]].flatMap(([a, b]) => merlin([at[0] + a * spread, at[1] + b * spread], y, CHAMBER, 1.5));
+function core() {
+    const start = 1.3;
+    const shoulder = BOOST + 0.9;
+    return [
+        { kind: "lathe", material: "white", segs: 40, body: true, outline: true, profile: [[WAIST, start], [CORE_R * 0.86, shoulder * 0.55], [CORE_R, shoulder], [CORE_R, CORE - 3.6], [THIRD_R * 1.02, CORE - 2.4]], rings: [start + 0.02, shoulder, CORE - 3.6], welds: [11] },
+        floor(WAIST, start),
+        ...chambers([0, 0], 0, 0.42),
+        // the open frame between the core and the third stage
+        ...[45, 135, 225, 315].flatMap((az) => {
+            const a = deg(az);
+            const at = (r, y) => [r * Math.sin(a), y, r * Math.cos(a)];
+            return [strut("dark", at(THIRD_R * 0.96, CORE - 2.4), at(THIRD_R * 0.96, CORE), 0.12, 0.12)];
+        }),
+        { kind: "lathe", material: "dark", segs: 28, under: true, profile: [[0, CORE - 2.4], [THIRD_R, CORE - 2.4]] },
+    ];
+}
+/** A booster, leaning in to meet the core at its tip: short frusta, each a little nearer the core. `az` is where it stands, in degrees. */
+function booster(az) {
+    const a = deg(az);
+    const inward = [-Math.sin(a), -Math.cos(a)];
+    const base = 1.3;
+    const reach = WAIST + BOOST_R - CORE_R * 0.92;
+    const slope = [(inward[0] * reach) / (BOOST - base), (inward[1] * reach) / (BOOST - base)];
+    const profile = [];
+    for (let i = 0; i <= 6; i++) {
+        const t = i / 6;
+        profile.push([BOOST_R * (1 - t) ** 0.9, base + (BOOST - base) * t]);
+    }
+    profile[6] = [0.001, BOOST];
+    const out = [{ kind: "lathe", material: "white", at: [-slope[0] * base, -slope[1] * base], lean: slope, segs: 24, body: true, outline: true, profile, rings: [base + 0.02] }];
+    out.push({ kind: "lathe", material: "soot", segs: 24, under: true, profile: [[0, base], [BOOST_R, base]] });
+    out.push(...chambers([0, 0], 0, 0.42));
+    // the square fin that sticks out of its foot, whose tip gives the sourced width over the fins
+    const out0 = SPAN - (WAIST + BOOST_R);
+    out.push({ kind: "plate", material: "white", frame: radial(a), outline: [[BOOST_R - 0.1, base], [out0, base], [out0, base + 1.4], [BOOST_R - 0.1, base + 1.8]], thickness: 0.1 });
+    return out;
+}
+const third = () => [tube("white", THIRD_R, 0, THIRD, { rings: [0.02, THIRD - 0.02], welds: [THIRD * 0.5] }), floor(THIRD_R, 0), ...merlin([0, 0], -0.0, 0.5, 1)];
+const FROM = "This package's code, from the sourced whole, core, boosters, third stage and width over the fins; the waist, the boosters' lean, the fairing's length and the paint are judged from photographs. No licensed model is used, and no name or mark is drawn.";
+const STAND = WAIST + BOOST_R;
+const place = (az) => ({ x: STAND * Math.sin(deg(az)), z: STAND * Math.cos(deg(az)) });
+export const SOYUZ_BUILDS = [
+    {
+        rocket: "soyuz",
+        variant: "soyuz-2",
+        drawnFrom: FROM,
+        parts: [
+            { slot: "first-stage", kind: "first-stage", name: "Block A, the core, Soyuz-2", height: CORE, diameter: CORE_R * 2, top: [CORE, THIRD_R * 2], sourcedDiameter: { value: 2.95, source: "wikipedia-soyuz-2" }, pieces: core },
+            ...[45, 135, 225, 315].map((az, i) => ({ slot: `booster-${i + 1}`, kind: "liquid-booster", name: `Booster ${i + 1}, Soyuz-2`, height: BOOST, diameter: BOOST_R * 2, place: place(az), sourcedDiameter: SOYUZ_BOOSTER_DIAMETER, pieces: () => booster(az) })),
+            { slot: "third-stage", kind: "third-stage", name: "Block I, third stage, Soyuz-2", height: THIRD, diameter: THIRD_R * 2, bottom: [0, THIRD_R * 2], top: [THIRD, THIRD_R * 2], sourcedDiameter: { value: 2.66, source: "wikipedia-soyuz-2" }, pieces: third },
+            { slot: "fairing", kind: "fairing", name: "Fairing, Soyuz-2", height: FAIRING, diameter: FAIRING_R * 2, bottom: [0, THIRD_R * 2], sourcedDiameter: blank("No source read here gives it."), pieces: () => fairingShell("white", FAIRING_R, FAIRING, FAIRING * 0.5, 1.35, THIRD_R) },
+        ],
+    },
+];

package/dist/model/stacks.d.ts

@@ -0,0 +1,39 @@
+import type { CreditId } from "../data/credits.ts";
+import type { PartKind } from "../parts.ts";
+import type { Figure } from "../data/types.ts";
+import type { Piece } from "./pieces.ts";
+export interface StackPart {
+    slot: string;
+    kind: PartKind;
+    name: string;
+    /** Metres, as drawn. */
+    height: number;
+    /** Metres, the widest as drawn. */
+    diameter: number;
+    /** Where it mates: metres above its origin, and metres across there. */
+    top?: readonly [number, number];
+    bottom?: readonly [number, number];
+    /** It is placed rather than stacked: beside the core, or standing on what is below. */
+    place?: {
+        x: number;
+        z: number;
+        y?: number;
+    };
+    /** Its own diameter's source, when the variant's is not this part's. */
+    sourcedDiameter?: Figure;
+    /** The painted look's model, when a licensed one shows it. */
+    painted?: {
+        file: string;
+        credit: CreditId;
+    };
+    /** Other variants it is true for. */
+    alsoTrueTo?: readonly string[];
+    pieces: () => Piece[];
+}
+export interface StackBuild {
+    rocket: string;
+    variant: string;
+    /** What a reader should be told about where its shape came from. */
+    drawnFrom: string;
+    parts: readonly StackPart[];
+}

package/dist/model/stacks.js

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

package/dist/model/starbase.d.ts

@@ -0,0 +1,2 @@
+import type { StackBuild } from "./stacks.ts";
+export declare const STARBASE_BUILDS: readonly StackBuild[];