@johnmorrisdotca/uchusen-rockets 0.19.1 → 0.20.0

package/dist/data/countries.d.ts

@@ -0,0 +1,51 @@
+import type { MakerId } from "./makers.ts";
+import { type Figure } from "./types.ts";
+/**
+ * Every country code that ISO 3166-1 assigns, two capital letters each, in order.
+ *
+ * @example
+ * ```ts
+ * import { COUNTRY_CODES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(COUNTRY_CODES.length, COUNTRY_CODES.includes("JP"));
+ * ```
+ */
+export declare const COUNTRY_CODES: readonly ["AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"];
+/**
+ * An ISO 3166-1 alpha-2 country code.
+ *
+ * @example
+ * ```ts
+ * import type { CountryCode } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * const japan: CountryCode = "JP";
+ * console.log(japan);
+ * ```
+ */
+export type CountryCode = (typeof COUNTRY_CODES)[number];
+/** By rocket id: the built ones and the planned ones. A ship of the SPX fleet is the package's own design and has none (see `countryOf`). */
+export declare const ROCKET_COUNTRIES: Readonly<Record<string, Figure<CountryCode>>>;
+/**
+ * Each maker group's country as an ISO 3166-1 alpha-2 code with its source. The SPX fleet is this package's own design, and the sites are a group of places, not one maker: both are blank.
+ *
+ * @example
+ * ```ts
+ * import { MAKER_COUNTRIES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(MAKER_COUNTRIES.spacex.value, MAKER_COUNTRIES.fleet.value);
+ * ```
+ */
+export declare const MAKER_COUNTRIES: Readonly<Record<MakerId, Figure<CountryCode>>>;
+/**
+ * A rocket's country, as an ISO 3166-1 alpha-2 code with its source, or a blank that says why there is none: a craft of several countries or an international body, or a ship of the SPX fleet.
+ *
+ * @param rocket A rocket's id, built or planned.
+ * @returns The figure: `value` is the code, or null.
+ * @example
+ * ```ts
+ * import { countryOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(countryOf("falcon-9").value, countryOf("iss").value, countryOf("iss").brief);
+ * ```
+ */
+export declare function countryOf(rocket: string): Figure<CountryCode>;

package/dist/data/countries.js

@@ -0,0 +1,91 @@
+import { blank } from "./types.js";
+/**
+ * Every country code that ISO 3166-1 assigns, two capital letters each, in order.
+ *
+ * @example
+ * ```ts
+ * import { COUNTRY_CODES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(COUNTRY_CODES.length, COUNTRY_CODES.includes("JP"));
+ * ```
+ */
+export const COUNTRY_CODES = [
+    "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ",
+    "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR",
+    "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP",
+    "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS",
+    "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS",
+    "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW",
+    "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW",
+];
+const us = (source, note) => ({ value: "US", source, ...(note ? { note } : {}) });
+const SPACEX = "SpaceX, whose headquarters are at Starbase, Texas, United States.";
+/** By rocket id: the built ones and the planned ones. A ship of the SPX fleet is the package's own design and has none (see `countryOf`). */
+export const ROCKET_COUNTRIES = {
+    starship: us("wikipedia-spacex", SPACEX),
+    "falcon-9": us("wikipedia-falcon-9"),
+    "falcon-heavy": us("wikipedia-falcon-heavy"),
+    dragon: us("wikipedia-dragon-2"),
+    grasshopper: us("wikipedia-spacex", SPACEX),
+    "falcon-1": us("wikipedia-falcon-1"),
+    "saturn-v": us("wikipedia-saturn-v"),
+    "space-shuttle": us("wikipedia-space-shuttle"),
+    sls: us("wikipedia-sls"),
+    "new-glenn": us("wikipedia-new-glenn"),
+    electron: blank("Its source names two countries of origin, New Zealand and the United States.", "two countries"),
+    soyuz: { value: "RU", source: "wikipedia-soyuz-2" },
+    "lunar-module": us("wikipedia-lunar-module"),
+    "apollo-soyuz": blank("Flown by NASA and the Soviet space program together.", "two countries"),
+    gemini: us("wikipedia-gemini"),
+    mercury: us("wikipedia-mercury"),
+    "jupiter-c": us("wikipedia-jupiter-c"),
+    iss: blank("Built and run by the space agencies of several countries.", "international"),
+    hubble: blank("A NASA and ESA space telescope.", "international"),
+    tiangong: { value: "CN", source: "wikipedia-tiangong" },
+    roadster: us("wikipedia-roadster-in-space"),
+    droneship: us("wikipedia-asds", "Based at Port Canaveral, the Port of Long Beach and the Port of Brownsville."),
+    "landing-zone": us("wikipedia-lz", "At Cape Canaveral Space Force Station; Landing Zone 4 is at Vandenberg."),
+    "launch-tower": us("wikipedia-starbase", "The tower at Starbase, Texas."),
+    starbase: us("wikipedia-starbase"),
+    "vulcan-centaur": us("wikipedia-vulcan"),
+    "ariane-6": blank("Its source gives its origin as European multi-national.", "international"),
+};
+/**
+ * Each maker group's country as an ISO 3166-1 alpha-2 code with its source. The SPX fleet is this package's own design, and the sites are a group of places, not one maker: both are blank.
+ *
+ * @example
+ * ```ts
+ * import { MAKER_COUNTRIES } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(MAKER_COUNTRIES.spacex.value, MAKER_COUNTRIES.fleet.value);
+ * ```
+ */
+export const MAKER_COUNTRIES = {
+    spacex: us("wikipedia-spacex"),
+    nasa: us("wikipedia-nasa"),
+    "blue-origin": us("wikipedia-blue-origin"),
+    "rocket-lab": us("wikipedia-rocket-lab", "Headquartered in Long Beach, California; founded in Auckland, New Zealand."),
+    russia: { value: "RU", source: "wikipedia-soyuz-2" },
+    "us-army": us("wikipedia-jupiter-c"),
+    china: { value: "CN", source: "wikipedia-tiangong" },
+    fleet: blank("The SPX fleet is this package's own design.", "none"),
+    sites: blank("A group of places, not one maker.", "none"),
+};
+const FLEET = blank("A ship of the SPX fleet, this package's own design.", "none");
+/**
+ * A rocket's country, as an ISO 3166-1 alpha-2 code with its source, or a blank that says why there is none: a craft of several countries or an international body, or a ship of the SPX fleet.
+ *
+ * @param rocket A rocket's id, built or planned.
+ * @returns The figure: `value` is the code, or null.
+ * @example
+ * ```ts
+ * import { countryOf } from "@johnmorrisdotca/uchusen-rockets";
+ *
+ * console.log(countryOf("falcon-9").value, countryOf("iss").value, countryOf("iss").brief);
+ * ```
+ */
+export function countryOf(rocket) {
+    if (Object.hasOwn(ROCKET_COUNTRIES, rocket))
+        return ROCKET_COUNTRIES[rocket];
+    return rocket.startsWith("fleet-") ? FLEET : blank("Not read for this id.");
+}

package/dist/data/credits.d.ts

@@ -142,6 +142,42 @@ export declare const MODEL_CREDITS: {
     readonly "nasa-curiosity": ModelCredit;
     readonly "nasa-hete": ModelCredit;
     readonly "nasa-grease-gun": ModelCredit;
+    readonly "the86guy-roadster": {
+        readonly title: "2008 Roadster";
+        readonly creator: "the 86 guy";
+        readonly creatorUrl: "https://sketchfab.com/the_86_guy";
+        readonly sourceUrl: "https://sketchfab.com/3d-models/2008-tesla-roadster-317dabbe5e824948a92091f7bd39c2de";
+        readonly licence: "CC BY 4.0";
+        readonly licenceUrl: "https://creativecommons.org/licenses/by/4.0/";
+        readonly changes: "Reduced from 502,492 triangles; the badges, lettering and dial faces removed with the materials that carried them; the roof panel, the lamps' insides and the wheel nuts left out; rescaled to the sourced length; the bonnet made bare carbon; materials merged and renamed.";
+    };
+    readonly "metarex4d-roadster": {
+        readonly title: "Roadster 2020";
+        readonly creator: "metarex.4d";
+        readonly creatorUrl: "https://sketchfab.com/metarex.4d";
+        readonly sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-2020-1fbf29e297bd4a17ac39a00a378441d8";
+        readonly licence: "CC BY 4.0";
+        readonly licenceUrl: "https://creativecommons.org/licenses/by/4.0/";
+        readonly changes: "Reduced from 608,850 triangles; the badge on the nose, the lettering on the tail and the marks on the wheels and the steering wheel removed; its textures left out; rescaled to the sourced wheelbase; repainted in the first generation's red; materials merged and renamed.";
+    };
+    readonly "gmmichaelonearth-roadster": {
+        readonly title: "Roadster 2.0 (Will be enchanced soon)";
+        readonly creator: "Michael (gmmichaelonearth)";
+        readonly creatorUrl: "https://sketchfab.com/gmmichaelonearth";
+        readonly sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-20-will-be-enchanced-soon-8d5da3904e434fc3830edf558cb9014d";
+        readonly licence: "CC BY 4.0";
+        readonly licenceUrl: "https://creativecommons.org/licenses/by/4.0/";
+        readonly changes: "Reduced from 552,876 triangles; the wheels' middle caps, which carry a mark, removed; its body's picture shrunk and its white made the first generation's red; rescaled to the sourced wheelbase; materials merged and renamed. Its wheels are minchou19's, credited on their own.";
+    };
+    readonly "minchou19-wheels": {
+        readonly title: "Roadster fly wheels";
+        readonly creator: "minchou19";
+        readonly creatorUrl: "https://sketchfab.com/minchou19";
+        readonly sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-fly-wheels-31a0476f5fd14fc282e799b8ae4ae4f3";
+        readonly licence: "CC BY 4.0";
+        readonly licenceUrl: "https://creativecommons.org/licenses/by/4.0/";
+        readonly changes: "Used as Michael's model has them, on its second-generation Roadster: their middle caps, which carry a mark, removed; reduced; rescaled with the car; materials merged and renamed.";
+    };
 };
 /**
  * The id of one model's credit in `MODEL_CREDITS`.

package/dist/data/credits.js

@@ -134,6 +134,42 @@ export const MODEL_CREDITS = {
     "nasa-curiosity": nasa("Curiosity Rover (Detailed)", "https://science.nasa.gov/3d-resources/curiosity-rover-detailed/", "Only the arm's two links, its tool turret and a swivel kept, from NASA's printable parts (STL, no textures); painted by this package; moved and scaled to the drone's arms. No mark was on it."),
     "nasa-hete": nasa("High Energy Transient Explorer", "https://science.nasa.gov/3d-resources/high-energy-transient-explorer/", "Its body kept as the drone's equipment block, turned and scaled; its materials made into one picture with this package's own. No mark was on it."),
     "nasa-grease-gun": nasa("Grease Gun", "https://science.nasa.gov/3d-resources/grease-gun/", "Scaled from millimetres to the drone's welding tool and given a welding nozzle of this package's own; its materials made into one picture. No mark was on it."),
+    "the86guy-roadster": {
+        title: "2008 Roadster",
+        creator: "the 86 guy",
+        creatorUrl: "https://sketchfab.com/the_86_guy",
+        sourceUrl: "https://sketchfab.com/3d-models/2008-tesla-roadster-317dabbe5e824948a92091f7bd39c2de",
+        licence: "CC BY 4.0",
+        licenceUrl: LICENCE_URL,
+        changes: "Reduced from 502,492 triangles; the badges, lettering and dial faces removed with the materials that carried them; the roof panel, the lamps' insides and the wheel nuts left out; rescaled to the sourced length; the bonnet made bare carbon; materials merged and renamed.",
+    },
+    "metarex4d-roadster": {
+        title: "Roadster 2020",
+        creator: "metarex.4d",
+        creatorUrl: "https://sketchfab.com/metarex.4d",
+        sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-2020-1fbf29e297bd4a17ac39a00a378441d8",
+        licence: "CC BY 4.0",
+        licenceUrl: LICENCE_URL,
+        changes: "Reduced from 608,850 triangles; the badge on the nose, the lettering on the tail and the marks on the wheels and the steering wheel removed; its textures left out; rescaled to the sourced wheelbase; repainted in the first generation's red; materials merged and renamed.",
+    },
+    "gmmichaelonearth-roadster": {
+        title: "Roadster 2.0 (Will be enchanced soon)",
+        creator: "Michael (gmmichaelonearth)",
+        creatorUrl: "https://sketchfab.com/gmmichaelonearth",
+        sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-20-will-be-enchanced-soon-8d5da3904e434fc3830edf558cb9014d",
+        licence: "CC BY 4.0",
+        licenceUrl: LICENCE_URL,
+        changes: "Reduced from 552,876 triangles; the wheels' middle caps, which carry a mark, removed; its body's picture shrunk and its white made the first generation's red; rescaled to the sourced wheelbase; materials merged and renamed. Its wheels are minchou19's, credited on their own.",
+    },
+    "minchou19-wheels": {
+        title: "Roadster fly wheels",
+        creator: "minchou19",
+        creatorUrl: "https://sketchfab.com/minchou19",
+        sourceUrl: "https://sketchfab.com/3d-models/tesla-roadster-fly-wheels-31a0476f5fd14fc282e799b8ae4ae4f3",
+        licence: "CC BY 4.0",
+        licenceUrl: LICENCE_URL,
+        changes: "Used as Michael's model has them, on its second-generation Roadster: their middle caps, which carry a mark, removed; reduced; rescaled with the car; materials merged and renamed.",
+    },
     // new rows go here
 };
 /**

package/dist/data/falcon.js

@@ -1,4 +1,5 @@
 // Falcon 9 and Falcon Heavy as the sources give them. r/SpaceX's SpaceX-API (Apache-2.0, archived in 2024) has one row per rocket, not per version, read from its repository's docs. A blank stays blank.
+import { ROADSTER_FLIGHT } from "./roadster.js";
 import { blank } from "./types.js";
 const F9 = "wikipedia-falcon-9";
 const V10 = "wikipedia-falcon-9-v1-0";
@@ -121,21 +122,32 @@ export const FALCON_9_VARIANTS = [
         },
     },
 ];
+const FALCON_HEAVY = {
+    id: "falcon-heavy",
+    rocket: "falcon-heavy",
+    name: "Falcon Heavy",
+    status: "flown",
+    firstFlight: said("2018-02-06", FH, { note: "The test flight." }),
+    slots: ["centre", "side-left", "side-right"],
+    note: "The painted model is one merged mesh. Its side boosters separate by their own connected pieces, and its centre core, upper stage and fairing are one continuous shell, so they stay one part: nothing is cut to fake a separation. Low detail: a low-poly model.",
+    facts: {
+        height: m(70, FH, { others: [{ value: 70, source: API, note: "SpaceX-API says the same." }] }),
+        diameter: m(12.2, FH, { brief: "across the three cores; 3.7 m each" }),
+        parts: { centre: m(70, FH), "side-left": blank("No source read here gives a side booster's height."), "side-right": blank("No source read here gives a side booster's height.") },
+        engines: { centre: said("9 Merlin 1D, and 1 vacuum Merlin above", FH), "side-left": said("9 Merlin 1D", FH), "side-right": said("9 Merlin 1D", FH) },
+        more: { engines: num(27, FH, { note: "On the three cores." }) },
+    },
+};
 export const FALCON_HEAVY_VARIANTS = [
+    FALCON_HEAVY,
     {
-        id: "falcon-heavy",
-        rocket: "falcon-heavy",
-        name: "Falcon Heavy",
-        status: "flown",
-        firstFlight: said("2018-02-06", FH, { note: "The test flight." }),
-        slots: ["centre", "side-left", "side-right"],
-        note: "The painted model is one merged mesh. Its side boosters separate by their own connected pieces, and its centre core, upper stage and fairing are one continuous shell, so they stay one part: nothing is cut to fake a separation. Low detail: a low-poly model.",
-        facts: {
-            height: m(70, FH, { others: [{ value: 70, source: API, note: "SpaceX-API says the same." }] }),
-            diameter: m(12.2, FH, { brief: "across the three cores; 3.7 m each" }),
-            parts: { centre: m(70, FH), "side-left": blank("No source read here gives a side booster's height."), "side-right": blank("No source read here gives a side booster's height.") },
-            engines: { centre: said("9 Merlin 1D, and 1 vacuum Merlin above", FH), "side-left": said("9 Merlin 1D", FH), "side-right": said("9 Merlin 1D", FH) },
-            more: { engines: num(27, FH, { note: "On the three cores." }) },
-        },
+        ...FALCON_HEAVY,
+        id: ROADSTER_FLIGHT.id,
+        name: ROADSTER_FLIGHT.name,
+        firstFlight: ROADSTER_FLIGHT.firstFlight,
+        slots: ["centre", "side-left", "side-right", "car", "starman"],
+        partIds: { "side-left": "falcon-heavy-falcon-heavy-side-left", "side-right": "falcon-heavy-falcon-heavy-side-right" },
+        note: `${ROADSTER_FLIGHT.note} ${FALCON_HEAVY.note}`,
+        facts: { ...FALCON_HEAVY.facts, parts: { ...FALCON_HEAVY.facts.parts, ...ROADSTER_FLIGHT.payload } },
     },
 ];

package/dist/data/makers.js

@@ -31,6 +31,7 @@ export const MADE_BY = {
     mercury: { maker: "nasa", madeBy: { value: "NASA; built by McDonnell Aircraft", source: "wikipedia-mercury" } },
     "jupiter-c": { maker: "us-army", madeBy: { value: "Designed by the US Army Ballistic Missile Agency; built by Chrysler", source: "wikipedia-jupiter-c" } },
     iss: { maker: "nasa", madeBy: { value: "Its US segment built by NASA, ESA, JAXA and CSA, its Russian segment developed by Roscosmos", source: "wikipedia-iss" } },
+    roadster: { maker: "spacex", madeBy: { value: "Launched by SpaceX on Falcon Heavy's test flight", source: "wikipedia-roadster-in-space" } },
     hubble: { maker: "nasa", madeBy: { value: "NASA's Great Observatories program; operated by STScI; built by Lockheed Martin and Perkin-Elmer", source: "wikipedia-hubble" } },
     tiangong: { maker: "china", madeBy: { value: "China Manned Space Agency; its modules built by the China Academy of Space Technology", source: "wikipedia-tiangong" } },
     "fleet-ship-01": { maker: "fleet", madeBy: { value: "SPX", source: "uchusen-design" } },

package/dist/data/roadster.d.ts

@@ -0,0 +1,13 @@
+import { type Figure, type Variant } from "./types.ts";
+export declare const ROADSTER_VARIANTS: readonly Variant[];
+/** Falcon Heavy as it flew on its test flight: the Roadster and Starman on its upper stage, inside the fairing. */
+export declare const ROADSTER_FLIGHT: {
+    readonly id: "test-flight";
+    readonly name: "Test flight, with the Roadster";
+    readonly firstFlight: Figure<string>;
+    readonly note: "The test flight's payload: the Roadster, with Starman at the wheel, on the upper stage inside the fairing. Together, the fairing hides them, as it did; apart, or in space, they show. The car was mounted inclined above its payload adapter; here it stands level where the fairing begins, and the adapter is not drawn. In space the upper stage it stayed on is not drawn either: in the painted model it is one shell with the centre core.";
+    readonly payload: {
+        readonly car: Figure<number>;
+        readonly starman: Figure<number>;
+    };
+};

package/dist/data/roadster.js

@@ -0,0 +1,73 @@
+// The Roadster, the car that a Falcon Heavy carried on its test flight with Starman at the wheel, and two models of the second generation of the same car, which has not flown. The first generation's
+// sizes are its own article's; the second generation's article gives only its wheelbase and an approximate width. The flight's date, mass and orbit are the launched car's own article's.
+import { blank } from "./types.js";
+const SPACE = "wikipedia-roadster-in-space";
+const FIRST = "wikipedia-roadster-first-generation";
+const SECOND = "wikipedia-roadster-second-generation";
+const m = (value, source, extra = {}) => ({ value, source, ...extra });
+/** Starman: a mannequin in a pressure suit, in the driver's seat. No source gives his size: he is drawn at a grown man's size, seated. */
+const STARMAN = blank("A mannequin in a pressure suit, in the driver's seat. No source read here gives its size.", "not given");
+const SECOND_FACTS = {
+    height: blank("No source read here gives its height. The model, at the sourced wheelbase, stands 1.1 m.", "not given"),
+    diameter: m(2, SECOND, { brief: "about", note: "About 79 in, the article's own approximate width. The model, at the sourced wheelbase, is 1.85 m across." }),
+    parts: { car: blank("No source read here gives its height."), starman: STARMAN },
+    engines: {},
+    more: {},
+    sizes: { Wheelbase: m(2.825, SECOND, { note: "111.2 in. The model is scaled to it." }) },
+};
+const SECOND_NOTE = "The second generation has not flown: it was shown as a prototype and has not been produced. Starman sits in it for comparison only. Its length and height have no source here: the model is scaled to the sourced wheelbase. Painted in the first generation's red, so the three compare under one light.";
+export const ROADSTER_VARIANTS = [
+    {
+        id: "first-generation",
+        rocket: "roadster",
+        name: "First generation, the one in space",
+        status: "flown",
+        firstWord: "Launched",
+        firstFlight: { value: "2018-02-06", source: SPACE, note: "20:45 UTC, on Falcon Heavy's test flight, FH-001, from Kennedy LC-39A." },
+        slots: ["car", "starman"],
+        note: "The car that flew, with Starman at the wheel, roof off, its bonnet bare carbon. Its article calls it a 2010 car of the first generation; the model is its author's 2008 car of the same generation, scaled to the generation's sourced length, and the years' small differences are not drawn. Starman is this package's own plain shapes in every look; no source gives his size.",
+        facts: {
+            height: m(1.127, FIRST, { note: "44.4 in, with its roof on. It flew with the roof off: the model, without it, stands 1.07 m." }),
+            diameter: m(1.873, FIRST, { note: "73.7 in, its width." }),
+            parts: { car: blank("The sourced height is the whole car's, with its roof on."), starman: STARMAN },
+            engines: {},
+            more: {
+                mass: m(1300, SPACE, { brief: "about", note: "About 1,300 kg launched; about 5,900 kg with the upper stage it stayed on." }),
+                perihelion: m(0.98613, SPACE, { note: "In astronomical units, epoch 1 May 2018." }),
+                aphelion: m(1.6637, SPACE, { note: "In astronomical units, epoch 1 May 2018." }),
+                period: m(1.525, SPACE, { note: "In years round the Sun." }),
+            },
+            sizes: { Length: m(3.946, FIRST, { note: "155.4 in. The model is scaled to it." }), Wheelbase: m(2.352, FIRST, { note: "92.6 in." }) },
+        },
+    },
+    {
+        id: "second-generation",
+        rocket: "roadster",
+        name: "Second generation, not flown",
+        status: "announced",
+        firstWord: "Shown",
+        firstFlight: { value: "2017-11-16", source: SECOND, brief: "shown, not flown", note: "Shown as a prototype. It has not been produced and has not flown." },
+        slots: ["car", "starman"],
+        note: SECOND_NOTE,
+        facts: SECOND_FACTS,
+    },
+    {
+        id: "second-generation-2",
+        rocket: "roadster",
+        name: "Second generation, another model",
+        status: "announced",
+        firstWord: "Shown",
+        firstFlight: { value: "2017-11-16", source: SECOND, brief: "shown, not flown", note: "Shown as a prototype. It has not been produced and has not flown." },
+        slots: ["car", "starman"],
+        note: `${SECOND_NOTE} A second model of the same car, by another author, its wheels by a third.`,
+        facts: SECOND_FACTS,
+    },
+];
+/** Falcon Heavy as it flew on its test flight: the Roadster and Starman on its upper stage, inside the fairing. */
+export const ROADSTER_FLIGHT = {
+    id: "test-flight",
+    name: "Test flight, with the Roadster",
+    firstFlight: { value: "2018-02-06", source: SPACE, note: "20:45 UTC, FH-001, from Kennedy LC-39A." },
+    note: "The test flight's payload: the Roadster, with Starman at the wheel, on the upper stage inside the fairing. Together, the fairing hides them, as it did; apart, or in space, they show. The car was mounted inclined above its payload adapter; here it stands level where the fairing begins, and the adapter is not drawn. In space the upper stage it stayed on is not drawn either: in the painted model it is one shell with the centre core.",
+    payload: { car: blank("The car's own height is in the Roadster's facts."), starman: STARMAN },
+};

package/dist/data/sources.d.ts

@@ -427,6 +427,38 @@ export declare const SOURCES: {
         readonly read: "direct";
         readonly licence: "CC BY-SA 4.0";
     };
+    readonly "wikipedia-spacex": {
+        readonly title: "SpaceX (the infobox: its headquarters)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/SpaceX";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-nasa": {
+        readonly title: "NASA (the infobox and first lines: an agency of the United States government)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/NASA";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-blue-origin": {
+        readonly title: "Blue Origin (the infobox: its headquarters)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Blue_Origin";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-rocket-lab": {
+        readonly title: "Rocket Lab (the infobox: its headquarters and where it was founded)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Rocket_Lab";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
     readonly "wikipedia-asds": {
         readonly title: "Autonomous spaceport drone ship";
         readonly publisher: "Wikipedia";
@@ -698,6 +730,30 @@ export declare const SOURCES: {
         readonly read: "direct";
         readonly licence: "CC BY-SA 4.0";
     };
+    readonly "wikipedia-roadster-in-space": {
+        readonly title: "The Roadster launched on Falcon Heavy's test flight (the infobox, and its background and trajectory sections)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Elon_Musk%27s_Tesla_Roadster";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-roadster-first-generation": {
+        readonly title: "The Roadster, first generation (the infobox)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Tesla_Roadster_(first_generation)";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
+    readonly "wikipedia-roadster-second-generation": {
+        readonly title: "The Roadster, second generation (the infobox and its history)";
+        readonly publisher: "Wikipedia";
+        readonly url: "https://en.wikipedia.org/wiki/Tesla_Roadster_(second_generation)";
+        readonly date: "2026-11-11";
+        readonly read: "direct";
+        readonly licence: "CC BY-SA 4.0";
+    };
     readonly "wikipedia-discovery": {
         readonly title: "Space Shuttle Discovery (the infobox)";
         readonly publisher: "Wikipedia";

package/dist/data/sources.js

@@ -62,6 +62,10 @@ export const SOURCES = {
     "wikipedia-soyuz-2": { title: "Soyuz-2 (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Soyuz-2", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-vulcan": { title: "Vulcan Centaur (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Vulcan_Centaur", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-ariane-6": { title: "Ariane 6 (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Ariane_6", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-spacex": { title: "SpaceX (the infobox: its headquarters)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/SpaceX", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-nasa": { title: "NASA (the infobox and first lines: an agency of the United States government)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/NASA", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-blue-origin": { title: "Blue Origin (the infobox: its headquarters)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Blue_Origin", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-rocket-lab": { title: "Rocket Lab (the infobox: its headquarters and where it was founded)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Rocket_Lab", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-asds": { title: "Autonomous spaceport drone ship", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Autonomous_spaceport_drone_ship", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-lz": { title: "Landing Zones 1 and 2", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Landing_Zones_1_and_2", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-slc-4": { title: "Vandenberg Space Launch Complex 4", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_4", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
@@ -96,6 +100,9 @@ export const SOURCES = {
     "wikipedia-tranquility": { title: "Tranquility (ISS module) (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Tranquility_(ISS_module)", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-cupola": { title: "Cupola (ISS module) (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Cupola_(ISS_module)", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-leonardo": { title: "Leonardo (ISS module) (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Leonardo_(ISS_module)", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-roadster-in-space": { title: "The Roadster launched on Falcon Heavy's test flight (the infobox, and its background and trajectory sections)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Elon_Musk%27s_Tesla_Roadster", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-roadster-first-generation": { title: "The Roadster, first generation (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Tesla_Roadster_(first_generation)", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
+    "wikipedia-roadster-second-generation": { title: "The Roadster, second generation (the infobox and its history)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Tesla_Roadster_(second_generation)", date: "2026-11-11", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-discovery": { title: "Space Shuttle Discovery (the infobox)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Space_Shuttle_Discovery", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-falcon-heavy": { title: "Falcon Heavy", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Falcon_Heavy", date: "2026-10-31", read: "direct", licence: "CC BY-SA 4.0" },
     "wikipedia-flight-5": { title: "Starship flight test 5 (its flight timeline, read as raw wikitext)", publisher: "Wikipedia", url: "https://en.wikipedia.org/wiki/Starship_flight_test_5", date: "2026-11-02", read: "direct", licence: "CC BY-SA 4.0" },

package/dist/element/flag.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What the element takes from hata's `/load` entry: a flag's SVG by its code. Written out here, so no type of this package reaches the optional peer.
+ *
+ * @example
+ * ```ts
+ * import type { FlagSource } from "@johnmorrisdotca/uchusen-rockets/element";
+ *
+ * const none: FlagSource = { flag: () => Promise.resolve(null) };
+ * console.log(await none.flag("US"));
+ * ```
+ */
+export interface FlagSource {
+    flag(code: string, options?: {
+        shape?: "4:3" | "1:1" | "round";
+    }): Promise<string | null>;
+}
+/**
+ * Where the flags come from, if a page wants to hand them over itself (before the first element with `flags` connects): a module with hata's `flag(code, { shape })`, such as one that imports only the flags the page shows.
+ *
+ * @param load Returns hata's `/load` entry, or a module with the same `flag`, as a promise.
+ * @example
+ * ```ts no-run
+ * import { setFlagLoader } from "@johnmorrisdotca/uchusen-rockets/element";
+ *
+ * setFlagLoader(() => import("@johnmorrisdotca/hata/load"));
+ * ```
+ */
+export declare function setFlagLoader(load: () => Promise<FlagSource>): void;
+/** A country's flag at 4:3 as SVG markup, or null when hata is not there, failed to load or has no flag for the code. It never rejects. */
+export declare function flagSvg(code: string): Promise<string | null>;

package/dist/element/flag.js

@@ -0,0 +1,23 @@
+// A country's flag for the `flags` attribute, from @johnmorrisdotca/hata, an optional peer loaded only when a flag is first wanted. Without it, or when it fails to load, there is no flag and nothing is logged.
+let loader = () => import("@johnmorrisdotca/hata/load");
+let loaded;
+/**
+ * Where the flags come from, if a page wants to hand them over itself (before the first element with `flags` connects): a module with hata's `flag(code, { shape })`, such as one that imports only the flags the page shows.
+ *
+ * @param load Returns hata's `/load` entry, or a module with the same `flag`, as a promise.
+ * @example
+ * ```ts no-run
+ * import { setFlagLoader } from "@johnmorrisdotca/uchusen-rockets/element";
+ *
+ * setFlagLoader(() => import("@johnmorrisdotca/hata/load"));
+ * ```
+ */
+export function setFlagLoader(load) {
+    loader = load;
+    loaded = undefined;
+}
+/** A country's flag at 4:3 as SVG markup, or null when hata is not there, failed to load or has no flag for the code. It never rejects. */
+export function flagSvg(code) {
+    loaded ??= loader().catch(() => null);
+    return loaded.then((hata) => (hata ? hata.flag(code, { shape: "4:3" }) : null)).catch(() => null);
+}

package/dist/element/scene.d.ts

@@ -216,6 +216,13 @@ export declare class RocketViewer {
     private offScreen;
     /** The words added to a floating name when that craft is outside the frame. Empty adds nothing. */
     setOffScreen(text: string | null): void;
+    /** The direction towards the Sun, in the craft's own frame, when a page gives one; null keeps the showroom light. */
+    private sunFrom;
+    /** One light from the Sun's real direction, as in space: the far side dark, with at most a faint fill. Null puts the showroom light back. */
+    setSun(direction: readonly [number, number, number] | null): void;
+    /** The key light comes from the Sun when there is one, else from the showroom's upper front. */
+    private keyDirection;
+    private aimKey;
     /** Open space lets a craft leave the frame. Wrap, the older float, brings it back on the other side. */
     private edgesOpen;
     setEdges(open: boolean): void;

package/dist/element/scene.js

@@ -421,6 +421,31 @@ export class RocketViewer {
         this.offScreen = next;
         this.wake();
     }
+    /** The direction towards the Sun, in the craft's own frame, when a page gives one; null keeps the showroom light. */
+    sunFrom = null;
+    /** One light from the Sun's real direction, as in space: the far side dark, with at most a faint fill. Null puts the showroom light back. */
+    setSun(direction) {
+        const before = this.sunFrom;
+        this.sunFrom = direction ? new Vector3(...direction) : null;
+        this.canvas.dataset.sun = this.sunFrom ? "on" : "off";
+        if (before === this.sunFrom || (before && this.sunFrom && before.equals(this.sunFrom)))
+            return;
+        this.nightSide();
+        this.aimKey();
+        this.wake();
+    }
+    /** The key light comes from the Sun when there is one, else from the showroom's upper front. */
+    keyDirection() {
+        return (this.sunFrom ?? new Vector3(3, 5, 4)).clone().normalize();
+    }
+    aimKey() {
+        if (this.shadows && this.built) {
+            this.fitShadow();
+            return;
+        }
+        this.sun.position.copy(this.sun.target.position).addScaledVector(this.keyDirection(), 7);
+        this.sun.target.updateMatrixWorld();
+    }
     /** Open space lets a craft leave the frame. Wrap, the older float, brings it back on the other side. */
     edgesOpen = false;
     setEdges(open) {
@@ -1075,6 +1100,15 @@ export class RocketViewer {
     /** The Lit look of a named SPX ship is the night side. Daylight stays the default, so lamps glow in the sun, and a kit module stays in daylight. */
     nightSide() {
         const night = this.shipNight && this.lightsMode !== "off" && this.glowOn;
+        if (this.sunFrom && !night) {
+            // in space there is one light: the Sun, a little stronger than the showroom's key, and next to nothing from anywhere else
+            this.sun.intensity = 2.4;
+            this.rim.intensity = 0;
+            this.fill.intensity = 0;
+            this.sky.intensity = 0.03;
+            this.scene.environmentIntensity = 0.06;
+            return;
+        }
         this.sun.intensity = night ? 0.16 : 1.6;
         this.rim.intensity = night ? 0.04 : 1.1;
         this.fill.intensity = night ? 0.03 : 0.35;
@@ -1601,7 +1635,7 @@ export class RocketViewer {
         const { min, max } = this.built.boundsOf(this.show);
         const centre = new Vector3((min[0] + max[0]) / 2, (min[1] + max[1]) / 2, (min[2] + max[2]) / 2);
         const radius = Math.max(1, Math.hypot(max[0] - min[0], max[1] - min[1], max[2] - min[2]) / 2);
-        const direction = new Vector3(3, 5, 4).normalize();
+        const direction = this.keyDirection();
         this.sun.position.copy(centre).addScaledVector(direction, radius * 2);
         this.sun.target.position.copy(centre);
         const shadow = this.sun.shadow;