@johnmorrisdotca/uchusen-rockets 0.2.2 → 0.4.0

package/dist/crossfade.d.ts

@@ -1,6 +1,48 @@
-/** The drawing stays at least this long after it first comes on screen. */
+/**
+ * The drawing stays at least this long after it first comes on screen.
+ *
+ * @example
+ * ```ts
+ * import { DRAWING_HOLD_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(DRAWING_HOLD_MS);
+ * ```
+ */
 export declare const DRAWING_HOLD_MS = 1200;
+/**
+ * How long the drawing and the 3D view cross-fade, in milliseconds.
+ *
+ * @example
+ * ```ts
+ * import { CROSSFADE_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(CROSSFADE_MS);
+ * ```
+ */
 export declare const CROSSFADE_MS = 1500;
+/**
+ * How long the cross-fade lasts for a reader who asked for reduced motion, in milliseconds.
+ *
+ * @example
+ * ```ts
+ * import { REDUCED_FADE_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(REDUCED_FADE_MS);
+ * ```
+ */
 export declare const REDUCED_FADE_MS = 400;
-/** How long to wait, once the 3D view is ready at `readyAt`, before it takes over from a drawing first seen at `shownAt` (0 under reduced motion). */
+/**
+ * How long to wait, once the 3D view is ready at `readyAt`, before it takes over from a drawing first seen at `shownAt` (0 under reduced motion).
+ *
+ * @param shownAt When the drawing first came on screen, in milliseconds.
+ * @param readyAt When the 3D view became ready, on the same clock.
+ * @param reducedMotion True when the reader asked for reduced motion.
+ * @returns The milliseconds to wait before the 3D view takes over.
+ * @example
+ * ```ts
+ * import { revealDelay } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(revealDelay(0, 300, false), revealDelay(0, 300, true));
+ * ```
+ */
 export declare function revealDelay(shownAt: number, readyAt: number, reducedMotion: boolean): number;

package/dist/crossfade.js

@@ -1,9 +1,51 @@
 // The change from a rocket's drawing to its 3D view: the drawing stays a moment even when the 3D view is ready sooner, then a slow crossfade; under reduced motion, a plain short fade. Pure.
-/** The drawing stays at least this long after it first comes on screen. */
+/**
+ * The drawing stays at least this long after it first comes on screen.
+ *
+ * @example
+ * ```ts
+ * import { DRAWING_HOLD_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(DRAWING_HOLD_MS);
+ * ```
+ */
 export const DRAWING_HOLD_MS = 1200;
+/**
+ * How long the drawing and the 3D view cross-fade, in milliseconds.
+ *
+ * @example
+ * ```ts
+ * import { CROSSFADE_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(CROSSFADE_MS);
+ * ```
+ */
 export const CROSSFADE_MS = 1500;
+/**
+ * How long the cross-fade lasts for a reader who asked for reduced motion, in milliseconds.
+ *
+ * @example
+ * ```ts
+ * import { REDUCED_FADE_MS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(REDUCED_FADE_MS);
+ * ```
+ */
 export const REDUCED_FADE_MS = 400;
-/** How long to wait, once the 3D view is ready at `readyAt`, before it takes over from a drawing first seen at `shownAt` (0 under reduced motion). */
+/**
+ * How long to wait, once the 3D view is ready at `readyAt`, before it takes over from a drawing first seen at `shownAt` (0 under reduced motion).
+ *
+ * @param shownAt When the drawing first came on screen, in milliseconds.
+ * @param readyAt When the 3D view became ready, on the same clock.
+ * @param reducedMotion True when the reader asked for reduced motion.
+ * @returns The milliseconds to wait before the 3D view takes over.
+ * @example
+ * ```ts
+ * import { revealDelay } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(revealDelay(0, 300, false), revealDelay(0, 300, true));
+ * ```
+ */
 export function revealDelay(shownAt, readyAt, reducedMotion) {
     if (reducedMotion)
         return 0;

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

@@ -1,13 +1,34 @@
+/**
+ * The credit for one licensed model: its title, its creator and their page, where it came from, its licence and what this package changed.
+ *
+ * @example
+ * ```ts
+ * import { MODEL_CREDITS, type ModelCredit } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const credit: ModelCredit = MODEL_CREDITS["clarence365-block3"];
+ * console.log(credit.creator, credit.licence);
+ * ```
+ */
 export interface ModelCredit {
     title: string;
     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;
 }
+/**
+ * Every licensed model this package paints with, by credit id. A painted rocket must carry the credit of the parts that are showing; `embedCode` writes it for you.
+ *
+ * @example
+ * ```ts
+ * import { MODEL_CREDITS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(Object.keys(MODEL_CREDITS).length > 10);
+ * ```
+ */
 export declare const MODEL_CREDITS: {
     readonly "clarence365-block3": {
         readonly title: "SpaceX Starship Block 3";
@@ -81,7 +102,47 @@ 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;
 };
+/**
+ * The id of one model's credit in `MODEL_CREDITS`.
+ *
+ * @example
+ * ```ts
+ * import type { CreditId } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const id: CreditId = "clarence365-block3";
+ * console.log(id);
+ * ```
+ */
 export type CreditId = keyof typeof MODEL_CREDITS;
-/** One credit as a line of text. */
+/**
+ * One credit as a line of text.
+ *
+ * @param id The id of a credit in `MODEL_CREDITS`.
+ * @returns The credit as one line of text.
+ * @example
+ * ```ts
+ * import { creditLine } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(creditLine("clarence365-block3"));
+ * ```
+ */
 export declare function creditLine(id: CreditId): string;

package/dist/data/credits.js

@@ -1,6 +1,26 @@
-// 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,
+});
+/**
+ * Every licensed model this package paints with, by credit id. A painted rocket must carry the credit of the parts that are showing; `embedCode` writes it for you.
+ *
+ * @example
+ * ```ts
+ * import { MODEL_CREDITS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(Object.keys(MODEL_CREDITS).length > 10);
+ * ```
+ */
 export const MODEL_CREDITS = {
     "clarence365-block3": {
         title: "SpaceX Starship Block 3",
@@ -74,8 +94,38 @@ 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. */
+/**
+ * One credit as a line of text.
+ *
+ * @param id The id of a credit in `MODEL_CREDITS`.
+ * @returns The credit as one line of text.
+ * @example
+ * ```ts
+ * import { creditLine } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(creditLine("clarence365-block3"));
+ * ```
+ */
 export function creditLine(id) {
     const c = MODEL_CREDITS[id];
     return `"${c.title}" by ${c.creator} (${c.sourceUrl}), ${c.licence} (${c.licenceUrl}). ${c.changes}`;

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,50 @@
+import type { SourceId } from "./sources.ts";
+/**
+ * One flight from the flight log: its name, the rocket and variant that show it, the date, whether the launch succeeded, the source's own words on the outcome, and the source.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHT_LOG, type LoggedFlight } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const flight: LoggedFlight | undefined = FLIGHT_LOG[0];
+ * console.log(flight?.name, flight?.launch);
+ * ```
+ */
+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;
+}
+/**
+ * The flights this package keeps a record of, each from a named source. Use `flightLogOf` for one rocket.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHT_LOG } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(FLIGHT_LOG.length > 0);
+ * ```
+ */
+export declare const FLIGHT_LOG: readonly LoggedFlight[];
+/**
+ * A rocket's flights, in order.
+ *
+ * @param rocket A rocket's id, such as `falcon-1`.
+ * @returns That rocket's logged flights, in order. It is empty for a rocket with none.
+ * @example
+ * ```ts
+ * import { flightLogOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(flightLogOf("falcon-1").map((flight) => flight.name));
+ * ```
+ */
+export declare const flightLogOf: (rocket: string) => readonly LoggedFlight[];

package/dist/data/flight-log.js

@@ -0,0 +1,44 @@
+/**
+ * The flights this package keeps a record of, each from a named source. Use `flightLogOf` for one rocket.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHT_LOG } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(FLIGHT_LOG.length > 0);
+ * ```
+ */
+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.
+ *
+ * @param rocket A rocket's id, such as `falcon-1`.
+ * @returns That rocket's logged flights, in order. It is empty for a rocket with none.
+ * @example
+ * ```ts
+ * import { flightLogOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(flightLogOf("falcon-1").map((flight) => flight.name));
+ * ```
+ */
+export const flightLogOf = (rocket) => FLIGHT_LOG.filter((flight) => flight.rocket === rocket);

package/dist/data/flights.d.ts

@@ -0,0 +1,101 @@
+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.
+ *
+ * @example
+ * ```ts
+ * import type { PartPose } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const pose: PartPose = { dx: 0.2, dy: -0.1, pitch: 12 };
+ * console.log(pose);
+ * ```
+ */
+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.
+ *
+ * @example
+ * ```ts
+ * import type { FlightBurn } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const burn: FlightBurn = { engines: { value: null, source: null, brief: "not given" }, drawn: 9 };
+ * console.log(burn);
+ * ```
+ */
+export interface FlightBurn {
+    engines: Figure;
+    drawn?: number;
+}
+/**
+ * One phase of a flight: its id and name, what happens, when (a figure with its source), how many engines burn, how each part stands, and how far the ground has fallen away. The poses and the smoke are a picture, not a measurement.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHTS, type FlightPhase } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const phase: FlightPhase | undefined = FLIGHTS[0]?.phases[0];
+ * console.log(phase?.name, phase?.what);
+ * ```
+ */
+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>;
+}
+/**
+ * A flight, from a published timeline: its rocket and variant, whose timing it is, its source and its phases in order.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHTS, type Flight } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const flight: Flight | undefined = FLIGHTS[0];
+ * console.log(flight?.name, flight?.phases.length);
+ * ```
+ */
+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[];
+}
+/**
+ * Every flight the package can play, one for each variant that has a timeline. Use `flightOf` to find one.
+ *
+ * @example
+ * ```ts
+ * import { FLIGHTS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(FLIGHTS.map((flight) => `${flight.rocket}:${flight.variant}`));
+ * ```
+ */
+export declare const FLIGHTS: readonly Flight[];