@johnmorrisdotca/uchusen-rockets 0.3.0 → 0.5.0

package/dist/data/flights.js

@@ -36,7 +36,7 @@ function starshipFlight(options) {
             { id: "boostback-end", name: "Boostback ends", what: "The booster falls back, steering with its grid fins.", at: time(times.boostbackEnd, source), burns: { ship: six }, pose: { booster: { ...away, pitch: 180 }, ship: { dx: 0.2, dy: 0.08 } }, ground: 1.6, air: 1 },
             { id: "booster-landing", name: "Booster's landing burn", what: "The booster lights its inner thirteen, then keeps only the inner three.", at: time(times.landing, source), burns: { booster: landingBurn, ship: six }, pose: { booster: { dx: -0.23, dy: -0.1 }, ship: { dx: 0.2, dy: 0.09 } }, ground: 0.45, air: 0.1 },
             { id: "booster-three", name: "Inner three", what: "The last of the landing burn, on the three middle engines.", at: blank("The page gives no time for this step."), burns: { booster: count(3, SH), ship: six }, pose: { booster: { dx: -0.23, dy: -0.32 }, ship: { dx: 0.2, dy: 0.1 } }, ground: 0.3, air: 0 },
-            { id: "booster-down", name: "Booster down", what: "The landing burn ends.", at: time(times.landingEnd, source), burns: { ship: six }, pose: { booster: { dx: -0.23, rest: true }, ship: { dx: 0.2, dy: 0.11 } }, ground: 0, air: 0.8 },
+            { id: "booster-down", name: "Booster down", what: "The landing burn ends.", at: time(times.landingEnd, source), burns: { ship: six }, pose: { booster: { dx: -0.23, rest: true }, ship: { dx: 0.2, dy: 0.11 } }, ground: 0, air: 0.8, ...(options.boosterSpeed ? { speed: options.boosterSpeed } : {}) },
             { id: "seco", name: "Ship's engines cut off", what: "The Ship coasts on, above the air.", at: time(times.seco, source), burns: {}, pose: { booster: { dx: -0.23, rest: true }, ship: { dx: 0.2, dy: 0.12 } }, ground: 0, ...(options.apogee ? { altitude: options.apogee } : {}) },
             { id: "entry", name: "Entry", what: "The Ship comes back into the air, belly first on its tiles.", at: time(times.entry, source), burns: {}, pose: { booster: { dx: -0.23, rest: true }, ship: { dx: 0.2, dy: 0.12, pitch: -80 } }, ground: 0 },
             ...(seconds(times.flip) <= seconds(times.shipBurn)
@@ -64,8 +64,15 @@ const FLIGHT_12 = "wikipedia-flight-12";
 const FH = "wikipedia-fh-test-flight";
 const STARLINK = "sfn-starlink-2019";
 const CRS16 = "sfn-crs-16";
+const FLIGHT_1 = "wikipedia-flight-1";
+const CASSIOPE = "sfn-cassiope";
+const ABS = "sfn-abs-eutelsat";
+const F9 = "wikipedia-falcon-9";
+const GRASSHOPPER = "wikipedia-grasshopper";
+const nineMerlin = (note) => count(9, F9, note);
+const oneMerlin = (note) => count(1, F9, note);
 const lower = (dy, extra = {}) => ({ dx: -0.26, dy, ...extra });
-export const FLIGHTS = [
+const BASE_FLIGHTS = [
     starshipFlight({
         id: "starship-flight-5",
         variant: "v1",
@@ -90,6 +97,7 @@ export const FLIGHTS = [
         stageEngines: count(3, SH, "The article's mission profile: all but three of its centre engines."),
         backEngines: count(13, SH, "The article's mission profile: ten more lit beside the three. On this flight nine of the ten lit."),
         landingBurn: count(13, FLIGHT_7, "All 13 engines ignited."),
+        apogee: { value: "146 km: where the Ship was when it was lost, 27 seconds before the planned cutoff", source: FLIGHT_7 },
         shipLanding: [],
     }),
     starshipFlight({
@@ -102,6 +110,8 @@ export const FLIGHTS = [
         stageEngines: count(5, SH, "The article's interstage section, for this booster: all but five inner engines. Its older mission profile says three."),
         backEngines: count(33, SH, "The article's propulsion section: the ascent and boostback burns use all thirty-three. The flight's page counts 28 to relight, beside the five already burning."),
         landingBurn: count(13, SH, "The inner thirteen."),
+        apogee: { value: "195 km, the highest of the Ship's orbit", source: FLIGHT_12 },
+        boosterSpeed: { value: "1,450 km/h when the booster hit the water in the Gulf, which it did not land from", source: FLIGHT_12 },
         shipLanding: [
             { id: "ship-two", name: "Three to two engines", what: "The Ship's landing burn drops to two.", at: time("+01:05:17", FLIGHT_12), burn: count(2, FLIGHT_12) },
             { id: "ship-one", name: "Two to one engine", what: "And to one, for the last seconds.", at: time("+01:05:24", FLIGHT_12), burn: count(1, FLIGHT_12) },
@@ -148,7 +158,7 @@ export const FLIGHTS = [
             { id: "entry-burn", name: "Entry burn", what: "Three engines again, to slow the fall.", at: time("+00:06:35", CRS16), burns: { "first-stage": THREE, "second-stage": UPPER }, pose: { "first-stage": lower(-0.14), "second-stage": { dx: 0.22, dy: 0.08 }, trunk: { dx: 0.22, dy: 0.08 }, capsule: { dx: 0.22, dy: 0.08 } }, ground: 0.8, air: 0.5, altitude: { value: "from about 70 to 40 km", source: "wikipedia-landing-tests", note: "The landing tests article, for the burn in general." } },
             { id: "landing-burn", name: "Landing burn", what: "Only the centre engine, just before touchdown.", at: blank("This timeline gives no time for its start."), burns: { "first-stage": ONE, "second-stage": UPPER }, pose: { "first-stage": lower(-0.3), "second-stage": { dx: 0.22, dy: 0.17 }, trunk: { dx: 0.22, dy: 0.17 }, capsule: { dx: 0.22, dy: 0.17 } }, ground: 0.22, air: 0 },
             { id: "landing", name: "Landing", what: "The planned landing, on plain ground here.", at: time("+00:08:17", CRS16), burns: { "second-stage": UPPER }, pose: { "first-stage": { dx: -0.26, rest: true }, "second-stage": { dx: 0.22, dy: 0.19 }, trunk: { dx: 0.22, dy: 0.19 }, capsule: { dx: 0.22, dy: 0.19 } }, ground: 0, air: 1 },
-            { id: "seco", name: "SECO", what: "The second stage shuts down.", at: time("+00:08:51", CRS16), burns: {}, pose: { "first-stage": { dx: -0.26, rest: true }, "second-stage": { dx: 0.22, dy: 0.11 }, trunk: { dx: 0.22, dy: 0.11 }, capsule: { dx: 0.22, dy: 0.11 } }, ground: 0 },
+            { id: "seco", name: "SECO", what: "The second stage shuts down.", at: time("+00:08:51", CRS16), burns: {}, pose: { "first-stage": { dx: -0.26, rest: true }, "second-stage": { dx: 0.22, dy: 0.11 }, trunk: { dx: 0.22, dy: 0.11 }, capsule: { dx: 0.22, dy: 0.11 } }, ground: 0, altitude: { value: "an orbit with a low point of about 124 miles (200 km) and a high point of about 223 miles (360 km), as planned", source: CRS16 } },
             { id: "dragon", name: "Dragon separates", what: "The spacecraft comes away from the second stage.", at: time("+00:09:51", CRS16), burns: {}, pose: { "first-stage": { dx: -0.26, rest: true }, "second-stage": { dx: 0.22, dy: 0.17 }, trunk: { dx: 0.22, dy: 0.25 }, capsule: { dx: 0.22, dy: 0.25 } }, ground: 0 },
         ],
     },
@@ -174,4 +184,151 @@ export const FLIGHTS = [
             { id: "side-landing", name: "Side cores land", what: "Both side cores down, side by side.", at: time("+00:07:58", FH), burns: {}, pose: { "side-left": { dx: -0.23, rest: true }, "side-right": { dx: 0.34, rest: true } }, ground: 0 },
         ],
     },
+    {
+        id: "starship-flight-1",
+        rocket: "starship",
+        variant: "v1-flight1",
+        name: "Starship flight test 1",
+        basis: "SpaceX's timeline as Wikipedia gives it, for the flight of 20 April 2023, the first of Starship. It is what happened, not a plan: the stages never separated, and the flight termination system destroyed the stack. The planned steps after that (the boostback, the landing burn, the Ship's burn and its entry) were never reached, so they are not here.",
+        source: FLIGHT_1,
+        note: "No separation, tower or flaps and fins to move: the stack stays one piece to the end. Which of the booster's engines burned after the first minute, the page does not say, so the flames drawn there are a picture.",
+        phases: [
+            { id: "ignition", name: "Ignition", what: "The booster's engines start while it is held on the pad. Three of them were stopped at ignition because the flight software did not find them healthy enough.", at: time("-00:00:06", FLIGHT_1), burns: { booster: count(30, FLIGHT_1, "Thirty-three engines, three of whose ignition was terminated: the page's words, and the sum is this package's.") }, pose: { booster: {}, ship: {} }, ground: 0, smoke: 0.7 },
+            { id: "liftoff", name: "Liftoff", what: "A successful liftoff that significantly damaged the launch pad, the page says.", at: time("+00:00:05", FLIGHT_1), burns: { booster: count(30, FLIGHT_1, "The thirty that lit.") }, pose: { booster: {}, ship: {} }, ground: 0.02, smoke: 1 },
+            { id: "max-q", name: "Max q", what: "The throttle goes down for max q, later and lower than planned.", at: time("+00:00:55", FLIGHT_1), burns: { booster: count(30, FLIGHT_1, "The thirty that lit; the page does not count the failures that came during the climb.") }, pose: { booster: {}, ship: {} }, ground: 1.6, air: 0.25 },
+            { id: "meco", name: "Most engines cut off", what: "Fires in the booster's aft end led to a loss of communication with most of its engines.", at: time("+00:02:49", FLIGHT_1), burns: { booster: { engines: blank("The page gives no count of the engines that burned here."), drawn: 3 } }, pose: { booster: {}, ship: {} }, ground: 1.6, air: 0.7 },
+            { id: "separation", name: "Separation fails", what: "The stages did not separate. The vehicle lost control and began spinning.", at: time("+00:02:52", FLIGHT_1), burns: { booster: { engines: blank("The page gives no count of the engines that burned here."), drawn: 3 } }, pose: { booster: {}, ship: {} }, ground: 1.6, air: 0.85, altitude: { value: "about 39 km, the highest it rose", source: FLIGHT_1 } },
+            { id: "termination", name: "Flight termination", what: "The flight termination system was triggered.", at: time("+00:03:10", FLIGHT_1), burns: { booster: { engines: blank("The page gives no count of the engines that burned here."), drawn: 3 } }, pose: { booster: {}, ship: {} }, ground: 1.6, air: 1 },
+            { id: "destroyed", name: "Destroyed", what: "The stack was destroyed. The booster's engines had kept firing until about four minutes in.", at: time("+00:04:01", FLIGHT_1), burns: {}, pose: { booster: {}, ship: {} }, ground: 1.6, air: 1, altitude: { value: "29 km: the height at which the page says the booster's engines were still firing, at about four minutes", source: FLIGHT_1 } },
+        ],
+    },
+    {
+        id: "falcon-9-cassiope",
+        rocket: "falcon-9",
+        variant: "v1.1",
+        name: "Falcon 9 v1.1, CASSIOPE",
+        basis: "Spaceflight Now's live coverage of 29 September 2013, the first launch of the Falcon 9 v1.1. The minutes are the live coverage's own, rounded as it said them, and they are what happened, not a plan.",
+        source: CASSIOPE,
+        note: "The page does not follow the first stage after it separates, so it leaves the picture. A fairing is drawn though the satellites went inside it: that is this version's drawing. Altitudes are the live coverage's words, in the units it used.",
+        phases: [
+            { id: "ignition", name: "Ignition", what: "The nine engines start on the pad.", at: blank("The live coverage starts at liftoff."), burns: { "first-stage": nineMerlin("The nine Merlin 1D of this version, from its page.") }, pose: {}, ground: 0, smoke: 0.7 },
+            { id: "liftoff", name: "Liftoff", what: "Liftoff of the next-generation Falcon 9, at 1600 GMT.", at: time("+00:00:00", CASSIOPE), burns: { "first-stage": nineMerlin("The nine Merlin 1D of this version, from its page.") }, pose: {}, ground: 0.02, smoke: 1 },
+            { id: "max-q", name: "Max q", what: "The rocket nears the speed of sound, in the phase of maximum aerodynamic pressure.", at: time("+00:01:00", CASSIOPE), burns: { "first-stage": nineMerlin("The nine Merlin 1D of this version, from its page.") }, pose: {}, ground: 1.6, air: 0.25 },
+            { id: "climb", name: "Two minutes", what: "Climbing, with the first stage still burning.", at: time("+00:02:00", CASSIOPE), burns: { "first-stage": nineMerlin("The nine Merlin 1D of this version, from its page.") }, pose: {}, ground: 1.6, air: 0.6, altitude: { value: "more than 20 miles", source: CASSIOPE } },
+            { id: "separation", name: "Stage separation", what: "The first stage's engines cut off and the stages separate; the second stage's engine lights for about six minutes.", at: time("+00:03:20", CASSIOPE), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": lower(-0.05), "second-stage": { dx: 0.14, dy: 0.04 }, fairing: { dx: 0.14, dy: 0.04 } }, ground: 1.6, air: 0.9 },
+            { id: "fairing", name: "Fairing separation", what: "The payload fairing has separated as planned.", at: time("+00:04:00", CASSIOPE), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": lower(-0.1, { gone: true }), "second-stage": { dx: 0.22, dy: 0.08 }, fairing: { dx: 0.4, dy: 0.2, gone: true } }, ground: 1.6, air: 1 },
+            { id: "altitude", name: "Seven minutes twenty", what: "Still burning, high above the air.", at: time("+00:07:20", CASSIOPE), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.1 }, fairing: { gone: true } }, ground: 1.6, air: 1, altitude: { value: "310 kilometers", source: CASSIOPE } },
+            { id: "seco", name: "Second stage cutoff", what: "The second stage's engine shuts down, confirmed at 1609 GMT.", at: time("+00:09:00", CASSIOPE, { note: "From the page's GMT clock: liftoff at 1600, cutoff confirmed at 1609." }), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.12 }, fairing: { gone: true } }, ground: 1.6 },
+            { id: "deploy", name: "CASSIOPE deploys", what: "The satellite is released first, at T+14:15.", at: time("+00:14:15", CASSIOPE), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.16 }, fairing: { gone: true } }, ground: 1.6, altitude: { value: "a planned orbit between 155 miles and 900 miles high", source: CASSIOPE } },
+        ],
+    },
+    {
+        id: "falcon-9-abs-eutelsat",
+        rocket: "falcon-9",
+        variant: "ft",
+        name: "Falcon 9 Full Thrust, ABS-2A and Eutelsat 117 West B",
+        basis: "Spaceflight Now's timeline for the flight of 15 June 2016, the plan as it was published before the launch. Its page does not name the version; Wikipedia's article on ABS-2A says it was a Falcon 9 Full Thrust.",
+        source: ABS,
+        note: "The page says only that the first stage would try to land on a barge in the Atlantic and gives no time for it, so the stage is not followed after it separates. The second stage burns twice, and the page gives each time.",
+        phases: [
+            { id: "ignition", name: "Ignition", what: "The nine engines start on the pad.", at: blank("The timeline starts at liftoff."), burns: { "first-stage": nineMerlin("The nine Merlin 1D+ of this version, from its page.") }, pose: {}, ground: 0, smoke: 0.7 },
+            { id: "liftoff", name: "Liftoff", what: "Nine Merlin engines at full thrust.", at: time("+00:00:00", ABS), burns: { "first-stage": nineMerlin("The nine Merlin 1D+ of this version, from its page.") }, pose: {}, ground: 0.02, smoke: 1 },
+            { id: "mach-1", name: "Mach 1", what: "The rocket reaches the speed of sound.", at: time("+00:01:13", ABS), burns: { "first-stage": nineMerlin("The nine Merlin 1D+ of this version, from its page.") }, pose: {}, ground: 1.2, air: 0.1, speed: { value: "Mach 1", source: ABS } },
+            { id: "max-q", name: "Max Q", what: "The point of maximum aerodynamic pressure.", at: time("+00:01:17", ABS), burns: { "first-stage": nineMerlin("The nine Merlin 1D+ of this version, from its page.") }, pose: {}, ground: 1.6, air: 0.25 },
+            { id: "meco", name: "MECO", what: "The nine first stage engines shut down.", at: time("+00:02:36", ABS), burns: {}, pose: {}, ground: 1.6, air: 0.8 },
+            { id: "separation", name: "Stage separation", what: "The first stage falls away. It is not followed from here.", at: time("+00:02:39", ABS), burns: {}, pose: { "first-stage": lower(-0.05), "second-stage": { dx: 0.14, dy: 0.04 }, fairing: { dx: 0.14, dy: 0.04 } }, ground: 1.6, air: 0.9 },
+            { id: "second-stage", name: "Second stage ignition", what: "The vacuum Merlin lights for about six and a half minutes, to a parking orbit.", at: time("+00:02:47", ABS), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": lower(-0.1, { gone: true }), "second-stage": { dx: 0.22, dy: 0.08 }, fairing: { dx: 0.22, dy: 0.08 } }, ground: 1.6, air: 1 },
+            { id: "fairing", name: "Fairing jettison", what: "The payload fairing comes away.", at: time("+00:03:34", ABS), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.1 }, fairing: { dx: 0.4, dy: 0.2, gone: true } }, ground: 1.6, air: 1 },
+            { id: "seco-1", name: "SECO 1", what: "The second stage shuts down in its parking orbit.", at: time("+00:09:22", ABS), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.12 }, fairing: { gone: true } }, ground: 1.6 },
+            { id: "restart", name: "Second burn", what: "The second stage's engine restarts for the burn to the transfer orbit.", at: time("+00:25:54", ABS), burns: { "second-stage": oneMerlin("The one vacuum Merlin of this version, from its page.") }, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.14 }, fairing: { gone: true } }, ground: 1.6, air: 1 },
+            { id: "seco-2", name: "SECO 2", what: "The second stage shuts down again.", at: time("+00:26:58", ABS), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.16 }, fairing: { gone: true } }, ground: 1.6 },
+            { id: "eutelsat", name: "Eutelsat 117 West B separates", what: "The first of the two satellites is released.", at: time("+00:30:29", ABS), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.18 }, fairing: { gone: true } }, ground: 1.6 },
+            { id: "abs", name: "ABS-2A separates", what: "The second satellite is released.", at: time("+00:35:29", ABS), burns: {}, pose: { "first-stage": { gone: true }, "second-stage": { dx: 0.22, dy: 0.2 }, fairing: { gone: true } }, ground: 1.6 },
+        ],
+    },
+    {
+        id: "grasshopper-hop-8",
+        rocket: "grasshopper",
+        variant: "grasshopper",
+        name: "Grasshopper's highest hop",
+        basis: "Wikipedia's table of Grasshopper's eight hops: the last, on 7 October 2013, rose 744 m in 79 seconds. The page gives the height and the length of each hop and nothing between, so the steps between are a picture.",
+        source: GRASSHOPPER,
+        note: "The page gives a hop's height and duration only, so the engine's start, its throttling and the descent have no times here. The seven earlier hops were lower (the first rose 1.8 m in 3 s) and are not played.",
+        phases: [
+            { id: "ignition", name: "Ignition", what: "The one Merlin 1D starts.", at: blank("The page gives each hop's height and length, not when its engine started."), burns: { vehicle: count(1, GRASSHOPPER, "A single Merlin-1D engine, the page says.") }, pose: {}, ground: 0, smoke: 0.5 },
+            { id: "liftoff", name: "Liftoff", what: "The hop begins.", at: time("+00:00:00", GRASSHOPPER, { note: "The start of the hop's 79 seconds." }), burns: { vehicle: count(1, GRASSHOPPER, "A single Merlin-1D engine, the page says.") }, pose: {}, ground: 0.02, smoke: 0.8 },
+            { id: "top", name: "The top of the hop", what: "The highest point.", at: blank("The page gives the height, not the moment."), burns: { vehicle: count(1, GRASSHOPPER, "A single Merlin-1D engine, the page says.") }, pose: {}, ground: 1.6, air: 0.2, altitude: { value: "744 m, the highest of its eight hops", source: GRASSHOPPER } },
+            { id: "landing", name: "Landing", what: "It comes down on its fixed legs, 79 seconds after the start.", at: time("+00:01:19", GRASSHOPPER, { note: "The hop's duration, 79 s, from its start." }), burns: {}, pose: { vehicle: { rest: true } }, ground: 0 },
+        ],
+    },
 ];
+const MOVE_SOURCES = {
+    falcon: { source: "wikipedia-landing-tests", says: "The grid fins are \"stowed on ascent and deployed on reentry\"; the landing burn comes, then the legs open, then the touchdown." },
+    superHeavy: { source: "wikipedia-super-heavy", says: "After the boostback the booster descends \"using its grid fins for minor course corrections\"." },
+    ship: { source: "wikipedia-ship", says: "The Ship \"controls its reentry with four flaps\", two aft and two forward." },
+};
+const MOVES_OF = {
+    "falcon-9-starlink-2019": ["falcon"],
+    "falcon-9-crs-16": ["falcon"],
+    "falcon-heavy-test-flight": ["falcon"],
+    "starship-flight-5": ["superHeavy", "ship"],
+    "starship-flight-7": ["superHeavy", "ship"],
+    "starship-flight-12": ["superHeavy", "ship"],
+};
+/**
+ * What turns in each flight. The pages say the Falcon 9's grid fins are "stowed on ascent and deployed on reentry" and that its legs open in the landing burn, before the touch down (Falcon 9 first-stage landing tests);
+ * that Super Heavy steers with its grid fins for minor course corrections after the boostback (Super Heavy); and that the Ship controls its reentry with four flaps, two aft and two forward (Starship). How far a group turns,
+ * and the moment inside a phase, are a picture. A painted model that is one shell has nothing here to turn: nothing is cut to fake a move.
+ */
+const ARTICULATIONS = {
+    "falcon-9-starlink-2019": { "first-stage": [["ignition", { "grid-fins": 85, legs: 0 }], ["entry-burn", { "grid-fins": 0, legs: 0 }], ["landing-burn", { "grid-fins": 0, legs: 60 }]] },
+    "falcon-9-crs-16": { "first-stage": [["ignition", { "grid-fins": 85, legs: 0 }], ["entry-burn", { "grid-fins": 0, legs: 0 }], ["landing-burn", { "grid-fins": 0, legs: 60 }]] },
+    "falcon-heavy-test-flight": { "side-left": [["side-start", { legs: 0 }], ["side-burn", { legs: 60 }]], "side-right": [["side-start", { legs: 0 }], ["side-burn", { legs: 60 }]] },
+    "starship-flight-5": {
+        booster: [["boostback-end", { "grid-fins": 10 }], ["booster-landing", { "grid-fins": -10 }], ["booster-three", { "grid-fins": 6 }], ["booster-down", { "grid-fins": 0 }]],
+        ship: [["entry", { "forward-flaps": 8, "aft-flaps": 8 }], ["flip", { "forward-flaps": 60, "aft-flaps": 20 }]],
+    },
+    "starship-flight-7": {
+        booster: [["boostback-end", { "grid-fins": 10 }], ["booster-landing", { "grid-fins": -10 }], ["booster-three", { "grid-fins": 6 }], ["booster-down", { "grid-fins": 0 }]],
+        ship: [["entry", { "forward-flaps": 8, "aft-flaps": 8 }], ["flip", { "forward-flaps": 60, "aft-flaps": 20 }]],
+    },
+    "starship-flight-12": {
+        booster: [["boostback-end", { "grid-fins": 10 }], ["booster-landing", { "grid-fins": -10 }], ["booster-three", { "grid-fins": 6 }], ["booster-down", { "grid-fins": 0 }]],
+        ship: [["entry", { "forward-flaps": 8, "aft-flaps": 8 }], ["ship-burn", { "forward-flaps": 60, "aft-flaps": 20 }]],
+    },
+};
+function articulated(flight) {
+    const rules = ARTICULATIONS[flight.id];
+    if (!rules)
+        return flight;
+    let note = flight.note ?? "";
+    note = note.replace(/No tower, catch arms or moving flaps and fins yet: /, "No tower or catch arms yet: ").replace(/No drone ship or moving legs yet: /, "No drone ship yet: ").replace(/No moving legs or fins yet: /, "").replace(/No tower, catch arms or moving flaps and fins yet\b/, "No tower or catch arms yet");
+    return {
+        ...flight,
+        note: `${note}${note ? " " : ""}Its moving parts turn where the pages say they do: how far, and the moment inside a phase, are a picture.`.trim(),
+        moves: (MOVES_OF[flight.id] ?? []).map((key) => MOVE_SOURCES[key]),
+        phases: flight.phases.map((phase) => {
+            const pose = { ...phase.pose };
+            for (const [slot, steps] of Object.entries(rules)) {
+                let angles = {};
+                for (const [id, at] of steps) {
+                    if (flight.phases.findIndex((one) => one.id === id) <= flight.phases.indexOf(phase))
+                        angles = at;
+                }
+                pose[slot] = { ...(pose[slot] ?? {}), moves: angles };
+            }
+            return { ...phase, pose };
+        }),
+    };
+}
+/**
+ * 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 const FLIGHTS = BASE_FLIGHTS.map(articulated);

package/dist/data/makers.d.ts

@@ -1,4 +1,14 @@
 import { type Figure } from "./types.ts";
+/**
+ * The groups the demo lists rockets under, by id, with the name shown for each.
+ *
+ * @example
+ * ```ts
+ * import { MAKERS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(MAKERS.spacex, Object.keys(MAKERS).length);
+ * ```
+ */
 export declare const MAKERS: {
     readonly spacex: "SpaceX";
     readonly nasa: "NASA and partners";
@@ -8,6 +18,17 @@ export declare const MAKERS: {
     readonly "us-army": "US Army";
     readonly sites: "Sites";
 };
+/**
+ * The id of a group in `MAKERS`.
+ *
+ * @example
+ * ```ts
+ * import type { MakerId } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const maker: MakerId = "nasa";
+ * console.log(maker);
+ * ```
+ */
 export type MakerId = keyof typeof MAKERS;
 export interface MadeBy {
     maker: MakerId;

package/dist/data/makers.js

@@ -1,5 +1,15 @@
 // Whose each rocket is, as its own article's infobox and first lines say, read 2026-11-02. `maker` is how the demo groups them; `by` says what the source says, with the companies that built it where it names them. The sites have no maker here: a blank, not a guess.
 import { blank } from "./types.js";
+/**
+ * The groups the demo lists rockets under, by id, with the name shown for each.
+ *
+ * @example
+ * ```ts
+ * import { MAKERS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(MAKERS.spacex, Object.keys(MAKERS).length);
+ * ```
+ */
 export const MAKERS = { spacex: "SpaceX", nasa: "NASA and partners", "blue-origin": "Blue Origin", "rocket-lab": "Rocket Lab", russia: "Russia", "us-army": "US Army", sites: "Sites" };
 const SITE = { maker: "sites", madeBy: blank("A place or a ship, not a vehicle: its maker is not read here.") };
 export const MADE_BY = {

package/dist/data/propellants.d.ts

@@ -0,0 +1,59 @@
+import type { Figure } from "./types.ts";
+/**
+ * The kinds of flame the pictures have a colour for. `neutral` is for an engine whose propellant no page read here names.
+ *
+ * @example
+ * ```ts
+ * import type { FlameKind } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const kinds: FlameKind[] = ["kerosene", "methane", "hydrogen", "solid", "hypergolic", "neutral"];
+ * console.log(kinds.length);
+ * ```
+ */
+export type FlameKind = "kerosene" | "methane" | "hydrogen" | "solid" | "hypergolic" | "neutral";
+/**
+ * What one engine burns: its name as the variants' data spells it, the propellant as its page words it (a figure with its source), and the kind of flame that picks the colour.
+ *
+ * @example
+ * ```ts
+ * import { PROPELLANTS, type EnginePropellant } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const merlin: EnginePropellant | undefined = PROPELLANTS.find((one) => one.id === "merlin");
+ * console.log(merlin?.propellant.value, merlin?.flame);
+ * ```
+ */
+export interface EnginePropellant {
+    id: string;
+    name: string;
+    /** Words that, found in a variant's engine text, say this is the engine. */
+    names: readonly string[];
+    /** Left out: any rocket. A rocket's id when the same words mean another engine elsewhere (a "solid motor"). */
+    rocket?: string;
+    propellant: Figure<string>;
+    flame: Exclude<FlameKind, "neutral">;
+}
+/**
+ * The engines whose propellant a page read here names. Each propellant is a figure with its page; the flame kind follows from it (a test holds the two together).
+ *
+ * @example
+ * ```ts
+ * import { PROPELLANTS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(PROPELLANTS.map((one) => `${one.name}: ${one.propellant.value}`));
+ * ```
+ */
+export declare const PROPELLANTS: readonly EnginePropellant[];
+/**
+ * The record of what an engine burns, found by the engine's name in a variant's engine text, or null when no page read here names it. A rocket's `rocket` makes "solid motor" mean its own.
+ *
+ * @param rocket A rocket's id.
+ * @param engineText The engine text of a part, as a variant's data words it ("9 Merlin 1D"), or null or undefined.
+ * @returns What that engine burns, or null.
+ * @example
+ * ```ts
+ * import { propellantOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(propellantOf("falcon-9", "9 Merlin 1D")?.propellant.value, propellantOf("starship", "3 sea-level and 3 vacuum"));
+ * ```
+ */
+export declare function propellantOf(rocket: string, engineText: string | null | undefined): EnginePropellant | null;

package/dist/data/propellants.js

@@ -0,0 +1,43 @@
+/**
+ * The engines whose propellant a page read here names. Each propellant is a figure with its page; the flame kind follows from it (a test holds the two together).
+ *
+ * @example
+ * ```ts
+ * import { PROPELLANTS } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(PROPELLANTS.map((one) => `${one.name}: ${one.propellant.value}`));
+ * ```
+ */
+export const PROPELLANTS = [
+    { id: "merlin", name: "Merlin", names: ["Merlin"], propellant: { value: "LOX / RP-1", source: "wikipedia-merlin", date: "2026-11-03", note: "The article's lead: \"Merlin engines use RP-1 and liquid oxygen as rocket propellants in a gas-generator power cycle.\"" }, flame: "kerosene" },
+    { id: "kestrel", name: "Kestrel", names: ["Kestrel"], propellant: { value: "LOX / RP-1", source: "wikipedia-kestrel", date: "2026-11-03", note: "The infobox, and the lead: \"an LOX/RP-1 pressure-fed rocket engine\"." }, flame: "kerosene" },
+    { id: "raptor", name: "Raptor", names: ["Raptor"], propellant: { value: "LOX / CH4", source: "wikipedia-raptor", date: "2026-11-03", note: "The infobox, and the lead: \"cryogenic liquid methane and liquid oxygen, a combination known as methalox\"." }, flame: "methane" },
+    { id: "f-1", name: "F-1", names: ["F-1"], propellant: { value: "LOX / RP-1", source: "wikipedia-f-1", date: "2026-11-03", note: "The infobox." }, flame: "kerosene" },
+    { id: "j-2", name: "J-2", names: ["J-2"], propellant: { value: "Liquid oxygen / Liquid hydrogen", source: "wikipedia-j-2", date: "2026-11-03", note: "The infobox, and the lead: \"burned cryogenic liquid hydrogen (LH2) and liquid oxygen (LOX) propellants\"." }, flame: "hydrogen" },
+    { id: "rs-25", name: "RS-25", names: ["RS-25"], propellant: { value: "LOX / LH2", source: "wikipedia-rs-25", date: "2026-11-03", note: "The infobox, and the lead: \"burns cryogenic (very low temperature) liquid hydrogen and liquid oxygen propellants\"." }, flame: "hydrogen" },
+    { id: "shuttle-srb", name: "Space Shuttle solid rocket booster", names: ["solid motor"], rocket: "space-shuttle", propellant: { value: "Ammonium perchlorate, aluminium powder and PBAN (APCP)", source: "wikipedia-shuttle-srb", date: "2026-11-03", note: "\"The primary propellants were ammonium perchlorate as the oxidizer along with aluminum powder and PBAN as fuel.\"" }, flame: "solid" },
+    { id: "sls-srb", name: "SLS solid rocket booster", names: ["solid motor"], rocket: "sls", propellant: { value: "PBAN-APCP", source: "wikipedia-sls-srb", date: "2026-11-03", note: "The infobox." }, flame: "solid" },
+    { id: "be-4", name: "BE-4", names: ["BE-4"], propellant: { value: "LOX / CH4", source: "wikipedia-be-4", date: "2026-11-03", note: "The infobox, and the lead: \"It uses liquefied methane fuel\"." }, flame: "methane" },
+    { id: "be-3", name: "BE-3", names: ["BE-3"], propellant: { value: "LOX / LH2", source: "wikipedia-be-3", date: "2026-11-03", note: "The infobox of the BE-3 and of the BE-3U." }, flame: "hydrogen" },
+    { id: "rutherford", name: "Rutherford", names: ["Rutherford"], propellant: { value: "LOX / RP-1", source: "wikipedia-rutherford", date: "2026-11-03", note: "The infobox, and the lead: \"LOX (liquid oxygen) and RP-1 (refined kerosene)\"." }, flame: "kerosene" },
+    { id: "rd-107", name: "RD-107 and RD-108", names: ["RD-107", "RD-108"], propellant: { value: "LOX / RG-1", source: "wikipedia-rd-107", date: "2026-11-03", note: "The infobox; its design section: \"liquid oxygen and highly refined kerosene (RG-1)\"." }, flame: "kerosene" },
+    { id: "lm-descent", name: "Lunar module descent engine", names: ["LM descent engine"], propellant: { value: "Aerozine 50 fuel / nitrogen tetroxide oxidizer", source: "wikipedia-lunar-module", date: "2026-11-03", note: "The article's specifications: \"DPS propellants: Aerozine 50 fuel / nitrogen tetroxide oxidizer\"." }, flame: "hypergolic" },
+];
+/**
+ * The record of what an engine burns, found by the engine's name in a variant's engine text, or null when no page read here names it. A rocket's `rocket` makes "solid motor" mean its own.
+ *
+ * @param rocket A rocket's id.
+ * @param engineText The engine text of a part, as a variant's data words it ("9 Merlin 1D"), or null or undefined.
+ * @returns What that engine burns, or null.
+ * @example
+ * ```ts
+ * import { propellantOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(propellantOf("falcon-9", "9 Merlin 1D")?.propellant.value, propellantOf("starship", "3 sea-level and 3 vacuum"));
+ * ```
+ */
+export function propellantOf(rocket, engineText) {
+    if (!engineText)
+        return null;
+    return PROPELLANTS.find((one) => (one.rocket === undefined || one.rocket === rocket) && one.names.some((name) => engineText.includes(name))) ?? null;
+}

package/dist/data/sources.d.ts

@@ -1,3 +1,14 @@
+/**
+ * A source of a figure: its title, publisher and address, the date on it where it has one, how it was read (directly, by search or cited) and its licence.
+ *
+ * @example
+ * ```ts
+ * import { SOURCES, type Source } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const source: Source = SOURCES["wikipedia-starship"];
+ * console.log(source.publisher, source.read);
+ * ```
+ */
 export interface Source {
     title: string;
     publisher: string;
@@ -7,6 +18,16 @@ export interface Source {
     read: "direct" | "search" | "cited";
     licence?: string;
 }
+/**
+ * Every source a figure can name, by id. A figure carries only an id; look the id up here for the page it came from.
+ *
+ * @example
+ * ```ts
+ * import { SOURCES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(Object.keys(SOURCES).length > 20, SOURCES["wikipedia-starship"].url);
+ * ```
+ */
 export declare const SOURCES: {
     readonly "wikipedia-starship": {
         readonly title: "SpaceX Starship (the block table and infobox, read as raw wikitext)";
@@ -248,6 +269,76 @@ export declare const SOURCES: {
         readonly read: "direct";
         readonly licence: "CC BY-SA 4.0";
     };
+    readonly "sfn-cassiope": {
+        readonly title: "The launch of the first Falcon 9 v1.1, with CASSIOPE (Spaceflight Now's live coverage, its status page)";
+        readonly publisher: "Spaceflight Now";
+        readonly url: "https://spaceflightnow.com/falcon9/006/cassiopestatus.html";
+        readonly date: "2013-09-29";
+        readonly read: "direct";
+    };
+    readonly "sfn-abs-eutelsat": {
+        readonly title: "Mission events timeline for Falcon 9's launch for ABS and Eutelsat";
+        readonly publisher: "Spaceflight Now";
+        readonly url: "https://spaceflightnow.com/2016/06/14/mission-events-timeline-for-falcon-9s-launch-for-abs-and-eutelsat/";
+        readonly date: "2016-06-14";
+        readonly read: "direct";
+    };
+    readonly "wikipedia-abs-2a": {
+        readonly title: "ABS-2A (its infobox: the rocket was a Falcon 9 Full Thrust)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/ABS-2A";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-be-4": {
+        readonly title: "Blue Origin BE-4 (the infobox)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Blue_Origin_BE-4";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-be-3": {
+        readonly title: "Blue Origin BE-3 (the infobox, for the BE-3 and the BE-3U)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Blue_Origin_BE-3";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-rutherford": {
+        readonly title: "Rutherford (rocket engine) (the infobox and the lead)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Rutherford_(rocket_engine)";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-rd-107": {
+        readonly title: "RD-107 (the infobox and its design section, for the RD-107 and the RD-108)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/RD-107";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-kestrel": {
+        readonly title: "SpaceX Kestrel (the infobox and the lead)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/SpaceX_Kestrel";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-sls-srb": {
+        readonly title: "Space Launch System Solid Rocket Booster (the infobox)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Space_Launch_System_Solid_Rocket_Booster";
+        readonly date: "2026-11-03";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
     readonly "wikipedia-shuttle-srb": {
         readonly title: "Space Shuttle Solid Rocket Booster (the infobox)";
         readonly publisher: "Wikipedia";
@@ -524,4 +615,15 @@ export declare const SOURCES: {
         readonly read: "direct";
     };
 };
+/**
+ * The id of a source in `SOURCES`.
+ *
+ * @example
+ * ```ts
+ * import type { SourceId } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const id: SourceId = "wikipedia-starship";
+ * console.log(id);
+ * ```
+ */
 export type SourceId = keyof typeof SOURCES;

package/dist/data/sources.js

@@ -1,5 +1,15 @@
 // Every source a figure may name. Plain facts are taken from these, and each figure says which one it came from. `read` is how this project read it: "direct" means the page itself, "search" that only
 // a search engine's quote of it could be read, and "cited" that it is known through another source's citation.
+/**
+ * Every source a figure can name, by id. A figure carries only an id; look the id up here for the page it came from.
+ *
+ * @example
+ * ```ts
+ * import { SOURCES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(Object.keys(SOURCES).length > 20, SOURCES["wikipedia-starship"].url);
+ * ```
+ */
 export const SOURCES = {
     "wikipedia-starship": { title: "SpaceX Starship (the block table and infobox, read as raw wikitext)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/SpaceX_Starship", date: "2026-10-31", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-super-heavy": { title: "SpaceX Super Heavy", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/SpaceX_Super_Heavy", date: "2026-10-31", read: "direct", licence: "CC BY-SA 4.0" },
@@ -32,6 +42,15 @@ export const SOURCES = {
     "wikipedia-space-shuttle": { title: "Space Shuttle (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Shuttle", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-shuttle-orbiter": { title: "Space Shuttle orbiter (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Shuttle_orbiter", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-shuttle-tank": { title: "Space Shuttle external tank (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Shuttle_external_tank", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
+    "sfn-cassiope": { title: "The launch of the first Falcon 9 v1.1, with CASSIOPE (Spaceflight Now's live coverage, its status page)", publisher: "Spaceflight Now", url: "https://spaceflightnow.com/falcon9/006/cassiopestatus.html", date: "2013-09-29", read: "direct" },
+    "sfn-abs-eutelsat": { title: "Mission events timeline for Falcon 9's launch for ABS and Eutelsat", publisher: "Spaceflight Now", url: "https://spaceflightnow.com/2016/06/14/mission-events-timeline-for-falcon-9s-launch-for-abs-and-eutelsat/", date: "2016-06-14", read: "direct" },
+    "wikipedia-abs-2a": { title: "ABS-2A (its infobox: the rocket was a Falcon 9 Full Thrust)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/ABS-2A", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-be-4": { title: "Blue Origin BE-4 (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Blue_Origin_BE-4", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-be-3": { title: "Blue Origin BE-3 (the infobox, for the BE-3 and the BE-3U)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Blue_Origin_BE-3", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-rutherford": { title: "Rutherford (rocket engine) (the infobox and the lead)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Rutherford_(rocket_engine)", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-rd-107": { title: "RD-107 (the infobox and its design section, for the RD-107 and the RD-108)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/RD-107", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-kestrel": { title: "SpaceX Kestrel (the infobox and the lead)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/SpaceX_Kestrel", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-sls-srb": { title: "Space Launch System Solid Rocket Booster (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Launch_System_Solid_Rocket_Booster", date: "2026-11-03", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-shuttle-srb": { title: "Space Shuttle Solid Rocket Booster (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Shuttle_Solid_Rocket_Booster", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-rs-25": { title: "RS-25 (the infobox and the nozzle's sizes)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/RS-25", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-sls": { title: "Space Launch System (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Launch_System", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },