@johnmorrisdotca/uchusen-rockets 0.2.2 → 0.3.0

package/dist/builder.js

@@ -0,0 +1,103 @@
+// What the part builder offers. A rocket from parts of every rocket, row by row from the bottom: each row offers only what fits on the row below, a row with one answer is answered for the reader, and a change lower down carries what still fits and makes a fresh choice for the rest. So the builder can never reach a rocket that does not go together, and `check` still has the last word. Everything comes from `ROCKETS` and `PART_ENTRIES`, so a new rocket is offered with no change here. Pure.
+import { check, JOINT_TOLERANCE } from "./fit.js";
+import { partEntry, PART_ENTRIES } from "./model/registry.js";
+import { partIdOf, ROCKETS, SLOT_NAMES } from "./rockets.js";
+function framesOf() {
+    const frames = [];
+    for (const rocket of Object.values(ROCKETS))
+        for (const variant of rocket.variants) {
+            const homes = variant.slots.map((slot) => partEntry(partIdOf(variant.rocket, variant.id, slot))?.record);
+            if (homes.every(Boolean))
+                frames.push({ rocket: rocket.id, variant: variant.id, slots: variant.slots, homes: homes });
+        }
+    return frames;
+}
+/** A part can stand in a slot when it is the same kind of part and joins the same ways as the slot's own. */
+const sameShape = (part, home) => part.kind === home.kind && Boolean(part.joints.top) === Boolean(home.joints.top) && Boolean(part.joints.bottom) === Boolean(home.joints.bottom) && part.strapOn?.x === home.strapOn?.x && part.strapOn?.z === home.strapOn?.z;
+/** It sits on what is below it. */
+const fitsOn = (part, below) => {
+    if (!below)
+        return true;
+    const { top } = below.joints;
+    const { bottom } = part.joints;
+    return Boolean(top && bottom && top.kind === bottom.kind && Math.abs(top.diameter - bottom.diameter) <= JOINT_TOLERANCE);
+};
+const REAL_PARTS = () => PART_ENTRIES.map(({ record }) => record).filter((record) => record.trueTo.length > 0);
+const optionOf = (part) => ({ id: part.id, name: part.name, rocket: ROCKETS[part.rocket]?.name ?? part.rocket });
+/** The rows for these picks, from the bottom. A pick that is not offered, for a change lower down or a hostile value, gives way to the part that belongs with what is below, or else the first that fits. */
+export function builderState(picks = []) {
+    const every = framesOf();
+    const parts = REAL_PARTS();
+    const rows = [];
+    const chosen = [];
+    // Only what can still be finished is offered: nothing on any row leads to a rocket with a part missing.
+    const known = new Map();
+    const finishes = (frame, row, below, foot) => {
+        if (row >= frame.slots.length)
+            return true;
+        const key = `${frame.rocket}/${frame.variant}/${row}/${below?.id}/${foot.id}`;
+        let answer = known.get(key);
+        if (answer === undefined) {
+            answer = fitting(frame, row, below, foot).length > 0;
+            known.set(key, answer);
+        }
+        return answer;
+    };
+    const fitting = (frame, row, below, foot) => {
+        const home = frame.homes[row];
+        // a part placed rather than stacked has no joint to mix at: it stands where its own variant puts it, by its own foot
+        if (home.strapOn)
+            return frame.homes[0].id === foot.id && finishes(frame, row + 1, below, foot) ? [home] : [];
+        return parts.filter((part) => sameShape(part, home) && fitsOn(part, below) && finishes(frame, row + 1, part, foot));
+    };
+    let alive = every;
+    for (let row = 0; alive.some((frame) => frame.slots.length > row); row++) {
+        // what a part sits on is the last one stacked: one placed beside the stack, a side booster or an orbiter, holds nothing up
+        const below = chosen.findLast((part) => !part.strapOn);
+        const candidates = (frame) => {
+            if (row >= frame.slots.length)
+                return [];
+            // the bottom row offers each rocket's own foot: what stands on it is what mixes
+            if (row === 0)
+                return [frame.homes[0]];
+            return fitting(frame, row, below, chosen[0]);
+        };
+        const offered = new Map();
+        for (const frame of alive)
+            for (const part of candidates(frame))
+                offered.set(part.id, part);
+        if (offered.size === 0)
+            break;
+        const options = [...offered.values()];
+        const asked = picks[row];
+        const pick = (asked !== undefined && offered.get(asked)) ||
+            // the next part of the real vehicle that everything so far belongs to, when there is one
+            alive.flatMap((frame) => (frame.slots.length > row && chosen.every((part, i) => frame.homes[i].id === part.id) ? [frame.homes[row]] : [])).find((part) => offered.has(part.id)) ||
+            // the part that flew with what is below it, when there is one
+            (below && options.find((part) => part.rocket === below.rocket && part.trueTo.some((id) => below.trueTo.includes(id)))) ||
+            options[0];
+        chosen.push(pick);
+        // the bottom row's own frames share one foot by shape; above it a frame stays while it can take the pick
+        alive = row === 0 ? every.filter((frame) => sameShape(pick, frame.homes[0])) : alive.filter((frame) => candidates(frame).some((part) => part.id === pick.id));
+        const slots = [...new Set(alive.filter((frame) => row < frame.slots.length).map((frame) => frame.slots[row]))];
+        rows.push({ label: slots.map((slot) => SLOT_NAMES[slot] ?? slot).join(" or "), options: options.map(optionOf), chosen: pick.id, auto: options.length === 1 });
+        // a real vehicle whole: nothing goes on top of it, even where a longer one shares its shape so far
+        if (alive.some((frame) => frame.slots.length === chosen.length && frame.homes.every((home, i) => home.id === chosen[i].id)))
+            break;
+    }
+    const whole = alive.filter((frame) => frame.slots.length === chosen.length);
+    const chosenSlot = (description) => whole.find((frame) => frame.rocket === description.rocket && frame.variant === description.variant)?.slots[0] ?? "";
+    const described = whole.map((frame) => {
+        const named = Object.fromEntries(frame.slots.flatMap((slot, i) => (frame.homes[i].id === chosen[i].id ? [] : [[slot, chosen[i].id]])));
+        return { rocket: frame.rocket, variant: frame.variant, ...(Object.keys(named).length > 0 ? { parts: named } : {}) };
+    });
+    // the name of a real vehicle where these parts are one; a custom build otherwise, and it says so
+    // and, of those, the version it has most parts of, so a custom build is said the plainest way
+    const swapped = (description) => Object.keys(description.parts ?? {});
+    const reports = described
+        // a tie goes to the version of the bottom part: it is the one the reader chose first
+        .sort((a, b) => swapped(a).length - swapped(b).length || Number(swapped(a).includes(chosenSlot(a))) - Number(swapped(b).includes(chosenSlot(b))))
+        .map((description) => ({ description, report: check(description) }));
+    const best = reports.find(({ report }) => report.ok && !report.custom) ?? reports.find(({ report }) => report.ok) ?? reports[0];
+    return { rows, description: best.description, report: best.report };
+}

package/dist/data/apollosoyuz.d.ts

@@ -0,0 +1,6 @@
+import { type Figure, type Variant } from "./types.ts";
+export declare const AS_CSM_LONG: Figure<number>;
+export declare const AS_CSM_WIDE: Figure<number>;
+export declare const AS_SOYUZ_LONG: Figure<number>;
+export declare const AS_SOYUZ_WIDE: Figure<number>;
+export declare const APOLLO_SOYUZ_VARIANTS: readonly Variant[];

package/dist/data/apollosoyuz.js

@@ -0,0 +1,28 @@
+// Apollo docked to Soyuz, as flown in 1975. Apollo's sizes are from its own article and Soyuz's from the Soyuz 7K-TM article. No article read here gives the docking module's size, or the length of the three docked.
+import { blank } from "./types.js";
+const A = "wikipedia-apollo-soyuz";
+const C = "wikipedia-apollo-csm";
+const T = "wikipedia-soyuz-7k-tm";
+const m = (value, source, extra = {}) => ({ value, source, ...extra });
+export const AS_CSM_LONG = m(11, C, { note: "36.2 feet." });
+export const AS_CSM_WIDE = m(3.9, C, { note: "12.8 feet." });
+export const AS_SOYUZ_LONG = m(7.48, T);
+export const AS_SOYUZ_WIDE = m(2.72, T);
+export const APOLLO_SOYUZ_VARIANTS = [
+    {
+        id: "apollo-soyuz",
+        rocket: "apollo-soyuz",
+        name: "Apollo and Soyuz, docked",
+        status: "flown",
+        firstFlight: { value: "1975-07-15", source: A, note: "Both launched that day; they docked on the 17th, as its article says." },
+        slots: ["csm", "docking-module", "soyuz"],
+        note: "NASA's model, its flags and the countries' names painted out, in the painted look, stood on end; this package's own plain shapes in the line looks. Apollo and Soyuz are each scaled to their own sourced length and width, and the docking module, which no source read here sizes, to Apollo's scale. The whole is what those add to, so it has no figure of its own.",
+        facts: {
+            height: blank("No source read here gives the length of the three docked."),
+            diameter: AS_CSM_WIDE,
+            parts: { csm: AS_CSM_LONG, "docking-module": blank("No source read here gives its size."), soyuz: AS_SOYUZ_LONG },
+            engines: { csm: { value: "1 service propulsion engine", source: C } },
+            more: {},
+        },
+    },
+];

package/dist/data/credits.d.ts

@@ -3,7 +3,7 @@ export interface ModelCredit {
     creator: string;
     creatorUrl: string;
     sourceUrl: string;
-    licence: "CC BY 4.0";
+    licence: "CC BY 4.0" | "CC0 1.0" | "Public domain (NASA)";
     licenceUrl: string;
     /** What this package changed. */
     changes: string;
@@ -81,6 +81,24 @@ export declare const MODEL_CREDITS: {
         readonly licenceUrl: "https://creativecommons.org/licenses/by/4.0/";
         readonly changes: "The wordmark and logo removed with the texture that carried them; rescaled to the sourced height; reduced from 55,455 triangles; materials merged and renamed.";
     };
+    readonly "smithsonian-discovery": {
+        readonly title: "Orbiter, Space Shuttle, OV-103, Discovery";
+        readonly creator: "Smithsonian Institution, National Air and Space Museum";
+        readonly creatorUrl: "https://3d.si.edu/";
+        readonly sourceUrl: "https://3d.si.edu/object/3d/orbiter-space-shuttle-ov-103-discovery:d8c636ce-4ebc-11ea-b77f-2e728ce88125";
+        readonly licence: "CC0 1.0";
+        readonly licenceUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
+        readonly changes: "The agency mark, the flags, the country's name and the orbiter's name painted out of its picture; reduced from 150,000 triangles; its pictures shrunk; stood upright and scaled to the sourced length; materials renamed.";
+    };
+    readonly "nasa-shuttle-hi-res": ModelCredit;
+    readonly "nasa-shuttle-parts": ModelCredit;
+    readonly "nasa-lunar-module": ModelCredit;
+    readonly "nasa-apollo-soyuz": ModelCredit;
+    readonly "nasa-gemini": ModelCredit;
+    readonly "nasa-friendship-7": ModelCredit;
+    readonly "nasa-jupiter-c": ModelCredit;
+    readonly "nasa-iss": ModelCredit;
+    readonly "nasa-hubble": ModelCredit;
 };
 export type CreditId = keyof typeof MODEL_CREDITS;
 /** One credit as a line of text. */

package/dist/data/credits.js

@@ -1,6 +1,16 @@
-// Whose models the painted parts are made from. Each is under Creative Commons Attribution 4.0, and each assembled rocket's credits are generated from these rows, so an author is credited exactly for
+// Whose models the painted parts are made from. Each is under Creative Commons Attribution 4.0, or CC0 or public domain where the row says so, and each assembled rocket's credits are generated from these rows, so an author is credited exactly for
 // what is used. The package's code is MIT; these assets are not: see NOTICE.md.
 const LICENCE_URL = "https://creativecommons.org/licenses/by/4.0/";
+/** One of NASA's own models: its source named, with no suggestion that NASA endorses anything. See NOTICE.md for what this rests on. */
+const nasa = (title, slug, changes) => ({
+    title,
+    creator: "NASA",
+    creatorUrl: "https://science.nasa.gov/3d-resources/",
+    sourceUrl: `https://data.nasa.gov/dataset/${slug}`,
+    licence: "Public domain (NASA)",
+    licenceUrl: "https://www.nasa.gov/nasa-brand-center/images-and-media/",
+    changes,
+});
 export const MODEL_CREDITS = {
     "clarence365-block3": {
         title: "SpaceX Starship Block 3",
@@ -74,6 +84,25 @@ export const MODEL_CREDITS = {
         licenceUrl: LICENCE_URL,
         changes: "The wordmark and logo removed with the texture that carried them; rescaled to the sourced height; reduced from 55,455 triangles; materials merged and renamed.",
     },
+    "smithsonian-discovery": {
+        title: "Orbiter, Space Shuttle, OV-103, Discovery",
+        creator: "Smithsonian Institution, National Air and Space Museum",
+        creatorUrl: "https://3d.si.edu/",
+        sourceUrl: "https://3d.si.edu/object/3d/orbiter-space-shuttle-ov-103-discovery:d8c636ce-4ebc-11ea-b77f-2e728ce88125",
+        licence: "CC0 1.0",
+        licenceUrl: "https://creativecommons.org/publicdomain/zero/1.0/",
+        changes: "The agency mark, the flags, the country's name and the orbiter's name painted out of its picture; reduced from 150,000 triangles; its pictures shrunk; stood upright and scaled to the sourced length; materials renamed.",
+    },
+    "nasa-shuttle-hi-res": nasa("Shuttle (Hi-Res)", "nasa-3d-models-shuttle-hi-res", "The agency mark, the flag, the country's name and the rest of the lettering painted out of its pictures; its open bay closed with its own doors and what was inside it left out; its engines put in place; reduced; rescaled to the sourced length; stood upright; its materials made into one picture."),
+    "nasa-shuttle-parts": nasa("Shuttle Parts (Hi-Res)", "nasa-3d-models-shuttle-parts-hi-res", "Its external tank and solid rocket booster only; rescaled to the sourced lengths; stood upright; its materials made into one picture; its pictures shrunk."),
+    "nasa-lunar-module": nasa("Apollo Lunar Module", "nasa-3d-models-apollo-lunar-module", "The flag and the country's name removed with the two plates that carried them; reduced from 97,588 triangles; rescaled to the sourced height; separated into its two stages; its materials made into one picture."),
+    "nasa-apollo-soyuz": nasa("Apollo Soyuz", "nasa-3d-models-apollo-soyuz", "The flags and the countries' names painted out of its pictures; reduced from 32,996 triangles; rescaled to the sourced lengths and widths; stood on end; separated into its three craft; its materials made into one picture."),
+    "nasa-gemini": nasa("Gemini", "nasa-3d-models-gemini", "The flag and the country's name painted out of its picture; reduced from 38,840 triangles; rescaled to the sourced length; separated into adapter and capsule; its materials made into one picture."),
+    "nasa-friendship-7": nasa("Friendship 7", "nasa-3d-models-friendship-7", "Reduced from 164,622 triangles; rescaled to the sourced length and width; its materials, which NASA's copy leaves all one grey, given plain colours judged from photographs. It carried no mark to remove."),
+    "nasa-jupiter-c": nasa("Jupiter-C", "nasa-3d-models-jupiter-c", "The lettering removed with the two pictures that carried it, which are plain white here; rescaled to the sourced height; its materials made into one picture."),
+    "nasa-iss": nasa("ISS", "nasa-3d-models-iss", "Reduced from 174,440 triangles; a ball of stray pieces far above it left out; rescaled to the sourced length; its materials, which NASA's copy leaves all one grey, given plain colours judged from photographs. It carried no mark to remove."),
+    "nasa-hubble": nasa("Hubble Space Telescope", "nasa-3d-models-hubble-space-telescope", "A lettered plate painted out of its picture; rescaled to the sourced length; its materials made into one picture."),
+    // new rows go here
 };
 /** One credit as a line of text. */
 export function creditLine(id) {

package/dist/data/dragon.js

@@ -42,4 +42,39 @@ export const DRAGON_VARIANTS = [
             more: {},
         },
     },
+    {
+        id: "cargo-dragon-2",
+        rocket: "dragon",
+        name: "Cargo Dragon 2",
+        status: "flown",
+        firstFlight: said("2020-12-06", D2, { note: "CRS-21." }),
+        slots: ["trunk", "capsule"],
+        note: "The cargo version of Dragon 2. Its article gives one set of sizes for both versions, and says Cargo Dragon lacks Crew Dragon's seats, controls, life support, windows and SuperDraco abort engines. Painted by this package's own code: the licensed model shows Crew Dragon, with windows, and no model stands in for another version.",
+        facts: {
+            height: m(8.1, D2, { note: "Capsule with trunk: the article's one figure for both versions." }),
+            diameter: m(4, D2),
+            parts: {
+                trunk: blank("No source read here gives the trunk alone."),
+                capsule: m(4.5, D2),
+            },
+            engines: { capsule: said("16 Draco thrusters", D2, { note: "It has no SuperDraco abort engines." }) },
+            more: {},
+        },
+    },
+    {
+        id: "crew-dragon-inside",
+        rocket: "dragon",
+        name: "Inside Crew Dragon, cut open",
+        status: "flown",
+        firstFlight: said("2019-03-02", D2, { note: "Uncrewed test flight. First crewed flight 2020-05-30." }),
+        slots: ["capsule"],
+        note: "The capsule cut in half, with a person of 1.8 m for scale. Its article gives four seats, the three-screen panel over the two centre seats, the cargo below them and 9.3 cubic metres under pressure. No source read here gives those parts' sizes or places: they are judged from one published picture of the cabin.",
+        facts: {
+            height: m(4.5, D2, { note: "The capsule." }),
+            diameter: m(4, D2),
+            parts: { capsule: m(4.5, D2) },
+            engines: {},
+            more: { seats: { value: 4, source: D2, note: "In normal operations; 7 in an emergency evacuation." }, pressurized: { value: "9.3 cubic metres", source: D2 } },
+        },
+    },
 ];

package/dist/data/electron.d.ts

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

package/dist/data/electron.js

@@ -0,0 +1,23 @@
+// Electron as its article gives it. Its stages and fairing add to a metre less than the whole, and no source read here says what that metre is: it is drawn as the stages' interstage.
+import { blank } from "./types.js";
+const S = "wikipedia-electron";
+const m = (value, source, extra = {}) => ({ value, source, ...extra });
+const said = (value, source, extra = {}) => ({ value, source, ...extra });
+export const ELECTRON_VARIANTS = [
+    {
+        id: "electron",
+        rocket: "electron",
+        name: "Electron",
+        status: "flown",
+        firstFlight: said("2017-05-25", S),
+        slots: ["first-stage", "adapter", "second-stage", "fairing"],
+        note: "Carbon composite, as its article says, and painted black here from photographs. Its stages and fairing add to 17 m against a whole of 18 m, and no source read here says what the difference is: it is drawn as an interstage. No name or mark is drawn.",
+        facts: {
+            height: m(18, S),
+            diameter: m(1.2, S),
+            parts: { "first-stage": m(12.1, S), adapter: blank("No source read here gives it: it is what the whole leaves."), "second-stage": m(2.4, S), fairing: m(2.5, S) },
+            engines: { "first-stage": said("9 Rutherford", S), "second-stage": said("1 Rutherford", S) },
+            more: {},
+        },
+    },
+];

package/dist/data/falcon.js

@@ -61,9 +61,9 @@ export const FALCON_9_VARIANTS = [
         status: "flown",
         firstFlight: said("2015-12-22", F9, { note: "OG2 Flight 2." }),
         slots: ["first-stage", "second-stage", "fairing"],
-        note: "Blocks 3 and 4 are part of Full Thrust; Block 4 first flew on 2017-08-14, and no source read here gives it sizes of its own. So it is not listed apart.",
+        note: "Blocks 3 and 4 are part of Full Thrust. Block 4 was a transition between them and Block 5, with incremental thrust upgrades; its full design first flew on 2017-08-14. Neither the Falcon 9 article nor the Full Thrust article gives it sizes of its own, so it is not listed apart.",
         facts: {
-            height: m(69.8, F9, { note: FAIRING_NOTE, others: [{ value: 70, source: F9, note: "The same article's table of versions rounds to 70 m." }] }),
+            height: m(69.8, F9, { note: FAIRING_NOTE, others: [{ value: 70, source: F9, note: "The same article's table of versions rounds to 70 m." }, { value: 71, source: "wikipedia-falcon-9-ft", note: "The Full Thrust article's infobox says 71 m with the fairing, citing SpaceX's user's guide; its own Block 5 box says 69.8 m." }] }),
             diameter: m(3.7, F9),
             parts: { "first-stage": FIRST_STAGE_WITH_INTERSTAGE, "second-stage": SECOND_STAGE, fairing: FAIRING },
             engines: { "first-stage": said("9 Merlin 1D+", F9), "second-stage": said("1 Merlin 1D Vacuum", F9) },

package/dist/data/falcon1.d.ts

@@ -0,0 +1,4 @@
+import { type Figure, type Variant } from "./types.ts";
+export declare const FALCON_1_VARIANTS: readonly Variant[];
+/** A fairing's own width, narrower than Falcon 1's stages. */
+export declare const variantOfFairing: (id: string) => Figure;

package/dist/data/falcon1.js

@@ -0,0 +1,51 @@
+// Falcon 1 as the sources give it: SpaceX's own user's guide (2008), read directly, and Wikipedia's article, which disagree on its height. No source read here gives a stage's own length.
+import { blank } from "./types.js";
+const G = "spacex-falcon-1-guide";
+const W = "wikipedia-falcon-1";
+const m = (value, source, extra = {}) => ({ value, source, ...extra });
+const said = (value, source, extra = {}) => ({ value, source, ...extra });
+const NO_STAGE = "No source read here gives this stage's own length: it is drawn in proportion to the whole, judged from photographs.";
+export const FALCON_1_VARIANTS = [
+    {
+        id: "falcon-1",
+        rocket: "falcon-1",
+        name: "Falcon 1",
+        status: "flown",
+        firstFlight: said("2006-03-24", W, { note: "The first flight failed. The first to reach orbit was the fourth, on 2008-09-28, and the last the fifth, on 2009-07-14." }),
+        slots: ["first-stage", "second-stage", "fairing"],
+        note: "One Merlin below and one Kestrel above, in the aluminium fairing the guide gives, narrower than the stages. Its first two flights used the Merlin 1A and its last three the Merlin 1C.",
+        facts: {
+            height: m(21.3, G, { note: "70 feet, both stages with fairing and interstage.", others: [{ value: 21, source: W, note: "The article's infobox rounds to 21 m." }, { value: 22.25, source: W, note: "The same article's table of versions says 21.3 m for the Merlin 1A and 22.25 m for the Merlin 1C, with no reason given. SpaceX's guide, written in the Merlin 1C's time, says 70 feet." }] }),
+            diameter: m(1.7, W, { others: [{ value: 1.68, source: G, note: "The guide says 5.5 feet, which is 1.68 m." }] }),
+            parts: {
+                "first-stage": blank(NO_STAGE),
+                "second-stage": blank(NO_STAGE),
+                fairing: m(3.5, G, { note: "Figure 2-1 of the guide, with the 0.3 m below the separation plane. 1.54 m across." }),
+            },
+            engines: { "first-stage": said("1 Merlin 1A, then 1 Merlin 1C", W), "second-stage": said("1 Kestrel", W) },
+            more: { fairingDiameter: m(1.54, G) },
+        },
+    },
+    {
+        id: "falcon-1e",
+        rocket: "falcon-1",
+        name: "Falcon 1e (announced, never flown)",
+        status: "announced",
+        firstFlight: blank("It was announced and never flew: Falcon 1 was retired in favour of Falcon 9.", "Never flew"),
+        slots: ["first-stage", "second-stage", "fairing"],
+        note: "An enhanced Falcon 1 that SpaceX's 2008 guide describes and that was never built to fly. Its figures are announced plans. It has a longer first stage and a wider, ogive composite fairing.",
+        facts: {
+            height: m(27.4, G, { brief: "announced", note: "90 feet.", others: [{ value: 26.83, source: W, note: "The article's table of versions says 26.83 m for the proposed Falcon 1e." }] }),
+            diameter: m(1.7, W, { brief: "announced" }),
+            parts: {
+                "first-stage": blank(NO_STAGE),
+                "second-stage": blank(NO_STAGE),
+                fairing: m(4.4, G, { brief: "announced", note: "Figure 2-2 of the guide, 1.7 m across." }),
+            },
+            engines: { "first-stage": said("1 Merlin 1C", W, { brief: "announced" }), "second-stage": said("1 Kestrel", W, { brief: "announced" }) },
+            more: { fairingDiameter: m(1.7, G, { brief: "announced" }) },
+        },
+    },
+];
+/** A fairing's own width, narrower than Falcon 1's stages. */
+export const variantOfFairing = (id) => FALCON_1_VARIANTS.find((variant) => variant.id === id)?.facts.more.fairingDiameter;

package/dist/data/flight-log.d.ts

@@ -0,0 +1,18 @@
+import type { SourceId } from "./sources.ts";
+export interface LoggedFlight {
+    id: string;
+    name: string;
+    rocket: string;
+    /** The variant in this package that shows it. */
+    variant: string;
+    /** UTC, as the source gives it. */
+    date: string;
+    launch: "Success" | "Failure";
+    vehicles?: string;
+    /** The source's own words on how it came out. */
+    outcome: string;
+    source: SourceId;
+}
+export declare const FLIGHT_LOG: readonly LoggedFlight[];
+/** A rocket's flights, in order. */
+export declare const flightLogOf: (rocket: string) => readonly LoggedFlight[];

package/dist/data/flight-log.js

@@ -0,0 +1,23 @@
+export const FLIGHT_LOG = [
+    { id: "falcon-1-flight-1", name: "Falcon 1, flight 1", rocket: "falcon-1", variant: "falcon-1", date: "2006-03-24", launch: "Failure", outcome: "Engine failure at T+33 seconds, and the vehicle was lost.", source: "wikipedia-falcon-1" },
+    { id: "falcon-1-flight-2", name: "Falcon 1, flight 2", rocket: "falcon-1", variant: "falcon-1", date: "2007-03-21", launch: "Failure", outcome: "Reached 289 km and did not reach orbit: an oscillation of the second stage, and an early engine shutdown.", source: "wikipedia-falcon-1" },
+    { id: "falcon-1-flight-3", name: "Falcon 1, flight 3", rocket: "falcon-1", variant: "falcon-1", date: "2008-08-03", launch: "Failure", outcome: "The first stage recontacted the second at separation.", source: "wikipedia-falcon-1" },
+    { id: "falcon-1-flight-4", name: "Falcon 1, flight 4", rocket: "falcon-1", variant: "falcon-1", date: "2008-09-28", launch: "Success", outcome: "The first privately developed fully liquid-fuelled rocket to reach orbit, carrying a mass simulator.", source: "wikipedia-falcon-1" },
+    { id: "falcon-1-flight-5", name: "Falcon 1, flight 5", rocket: "falcon-1", variant: "falcon-1", date: "2009-07-14", launch: "Success", outcome: "Its first commercial flight, placing RazakSAT in orbit.", source: "wikipedia-falcon-1" },
+    { id: "starship-flight-1", name: "Starship flight 1", rocket: "starship", variant: "v1-flight1", date: "2023-04-20", launch: "Failure", vehicles: "Booster B7, Ship S24", outcome: "Booster: Precluded. Ship: Precluded.", source: "wikipedia-launches" },
+    { id: "starship-flight-2", name: "Starship flight 2", rocket: "starship", variant: "v1", date: "2023-11-18", launch: "Failure", vehicles: "Booster B9, Ship S25", outcome: "Booster: Failure (gulf). Ship: Precluded.", source: "wikipedia-launches" },
+    { id: "starship-flight-3", name: "Starship flight 3", rocket: "starship", variant: "v1", date: "2024-03-14", launch: "Success", vehicles: "Booster B10, Ship S28", outcome: "Booster: Failure (gulf). Ship: Failure (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-4", name: "Starship flight 4", rocket: "starship", variant: "v1", date: "2024-06-06", launch: "Success", vehicles: "Booster B11, Ship S29", outcome: "Booster: Controlled (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-5", name: "Starship flight 5", rocket: "starship", variant: "v1", date: "2024-10-13", launch: "Success", vehicles: "Booster B12, Ship S30", outcome: "Booster: Caught (OLP-1). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-6", name: "Starship flight 6", rocket: "starship", variant: "v1", date: "2024-11-19", launch: "Success", vehicles: "Booster B13, Ship S31", outcome: "Booster: Catch aborted, diverted to the ocean. Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-7", name: "Starship flight 7", rocket: "starship", variant: "v2", date: "2025-01-16", launch: "Failure", vehicles: "Booster B14-1, Ship S33", outcome: "Booster: Caught (OLP-1). Ship: Precluded.", source: "wikipedia-launches" },
+    { id: "starship-flight-8", name: "Starship flight 8", rocket: "starship", variant: "v2", date: "2025-03-06", launch: "Failure", vehicles: "Booster B15-1, Ship S34", outcome: "Booster: Caught (OLP-1). Ship: Precluded.", source: "wikipedia-launches" },
+    { id: "starship-flight-9", name: "Starship flight 9", rocket: "starship", variant: "v2", date: "2025-05-27", launch: "Failure", vehicles: "Booster B14-2, Ship S35", outcome: "Booster: Failure (gulf). Ship: Failure (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-10", name: "Starship flight 10", rocket: "starship", variant: "v2", date: "2025-08-26", launch: "Success", vehicles: "Booster B16, Ship S37", outcome: "Booster: Controlled (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-11", name: "Starship flight 11", rocket: "starship", variant: "v2", date: "2025-10-13", launch: "Success", vehicles: "Booster B15-2, Ship S38", outcome: "Booster: Controlled (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-12", name: "Starship flight 12", rocket: "starship", variant: "v3", date: "2026-05-22", launch: "Success", vehicles: "Booster B19, Ship S39", outcome: "Booster: Failure (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-13", name: "Starship flight 13", rocket: "starship", variant: "v3", date: "2026-07-24", launch: "Success", vehicles: "Booster B20, Ship S40", outcome: "Booster: Failure (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+    { id: "starship-flight-14", name: "Starship flight 14", rocket: "starship", variant: "v3", date: "2026-09-28", launch: "Success", vehicles: "Booster B21, Ship S41", outcome: "Booster: Controlled (gulf). Ship: Controlled (ocean).", source: "wikipedia-launches" },
+];
+/** A rocket's flights, in order. */
+export const flightLogOf = (rocket) => FLIGHT_LOG.filter((flight) => flight.rocket === rocket);

package/dist/data/flights.d.ts

@@ -0,0 +1,49 @@
+import { type Figure } from "./types.ts";
+import type { SourceId } from "./sources.ts";
+/** How a part stands in the picture at a phase. A picture, not a measurement: `dx` and `dy` are in heights of the whole vehicle. */
+export interface PartPose {
+    dx?: number;
+    dy?: number;
+    /** Turned this many degrees from upright. */
+    pitch?: number;
+    /** Its base stands on the ground. */
+    rest?: boolean;
+    /** It has left the picture. */
+    gone?: boolean;
+}
+/** How many engines of a part burn. `drawn` says how many flames to draw where no page says how many burned. */
+export interface FlightBurn {
+    engines: Figure;
+    drawn?: number;
+}
+export interface FlightPhase {
+    id: string;
+    name: string;
+    /** What happens, in a line. */
+    what: string;
+    /** Seconds from the flight's zero, on the page's own clock. */
+    at: Figure;
+    burns: Readonly<Record<string, FlightBurn>>;
+    pose: Readonly<Record<string, PartPose>>;
+    /** How far the ground has fallen from under the rocket, in heights of the whole vehicle. A picture. */
+    ground: number;
+    /** How much smoke and water stands on the pad, 0 to 1. A picture. */
+    smoke?: number;
+    /** 0 near the ground, 1 high up, where a flame fans out. A picture. */
+    air?: number;
+    altitude?: Figure<string>;
+    speed?: Figure<string>;
+}
+export interface Flight {
+    id: string;
+    rocket: string;
+    variant: string;
+    name: string;
+    /** Whose timing it is, and whether it was what was planned or what happened. */
+    basis: string;
+    source: SourceId;
+    /** What the picture leaves out. */
+    note?: string;
+    phases: readonly FlightPhase[];
+}
+export declare const FLIGHTS: readonly Flight[];