@johnmorrisdotca/uchusen-rockets 0.19.0 → 0.19.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [0.19.1] - 2026-11-12
+
+- **The concept build budget holds work on CI** (MODULES-1134): `every concept builds inside the budget` failed on a shared runner at 3059 ms against 3000. On the Mac it still holds the time budget. Under `CI` it holds what does not vary, the pieces and triangles each concept builds (within 15 per cent), plus a cap of five times the budget on the time.
+
+- **The WebGL probe runs once per page, and only when a view is about to draw** (MODULES-1102): every element asked at connect, and every 3D view made another test context for the name of the renderer, each a few seconds of the main thread in software drawing, and in headless WebKit a load now and then stalled for minutes. The page now makes one test context, when the first element comes on screen, answers both questions from it (does WebGL work, does it draw in software) and lets it go at once. The hero says `3d` where WebGL works and `fallback` where it does not, as before; an element far off screen no longer asks, so it says `picture` until it nears. A test holds the count at one.
+- **The played-timeline freeze test counts the graphics card at rest** (MODULES-853). "Grid fins, legs and flaps" read 210 buffers before its forty rounds and 213 after in about one run in seven in the CI image. The three were the pad's smoke, one instanced draw kept for the flight, which reaches the card a frame or two after the first draw at ignition: a slow run moved on before it did, and a later round made it. The warm-up now holds at ignition until the count stands still, and both counts wait for the camera's glide and the left-behind craft to end. The allowance is unchanged; 15 of 15 in the CI image.
+
 ## [0.19.0] - 2026-11-11
 
 - **A tap on the build bar's Pause is no longer lost in Safari** (MODULES-1066): the playing bar redrew the button's icon and word every tenth of a second, and WebKit sends no click when the node a press began on has been replaced before the finger lifts. The bar now leaves a button, a text or the stills alone when a redraw would not change them. A test holds a press across redraws.

package/README.md

@@ -442,7 +442,7 @@ variantOf("starship", "2019").facts.diameter.value; // null
 
 ## How to cite
 
-> Morris, J. (2026). *Uchusen Rockets* (version 0.19.0) [Computer software]. https://github.com/johnmorrisdotca/uchusen-rockets
+> Morris, J. (2026). *Uchusen Rockets* (version 0.19.1) [Computer software]. https://github.com/johnmorrisdotca/uchusen-rockets
 
 GitHub's "Cite this repository" button reads [CITATION.cff](CITATION.cff) and gives BibTeX and APA. Cite the version you used (`npm ls @johnmorrisdotca/uchusen-rockets`), and credit the people behind the models and the numbers: [NOTICE.md](NOTICE.md) says who made each one and under what terms.
 
@@ -494,7 +494,7 @@ pnpm test:usage     # every way to use it (CDN, Vite, webpack, React, Vue, Svelt
 pnpm test:usage     # every way to use it (CDN, Vite, webpack, React, Vue, Svelte, Angular, iframe, TypeScript, Node), built and opened from the package as npm packs it
 pnpm docs:check     # the reference site's checks: every export documented, every example run
 pnpm test:demo      # the demo in a real browser
-pnpm dev            # the demo on http://127.0.0.1:7900/uchusen-rockets/
+pnpm dev            # the demo on http://127.0.0.1:8275/uchusen-rockets/
 pnpm screenshots    # the pictures in docs/images
 ```
 

package/dist/element/probe.d.ts

@@ -0,0 +1,15 @@
+/** What one look at the browser's WebGL said. */
+export interface GlProbe {
+    /** Whether a WebGL context can be made at all. */
+    works: boolean;
+    /** Whether the context draws in software (SwiftShader, llvmpipe, softpipe), where smooth edges cost a frame. */
+    software: boolean;
+}
+/** How many test contexts this page has made: 1 once the answer is known, 0 before it is asked for. */
+export declare function probeCount(): number;
+/**
+ * Says whether WebGL works here and whether it draws in software. The first call makes one test context and releases it at once; every later call, from any element or viewer, gets the same answer without making another.
+ *
+ * @returns The kept answer.
+ */
+export declare function glProbe(): GlProbe;

package/dist/element/probe.js

@@ -0,0 +1,46 @@
+// What the browser's WebGL is, asked once per page. A test context in software drawing takes seconds of the main thread, so the answer is kept for every element and every viewer on the page, and the context is let go the moment it has answered.
+let answer = null;
+let asked = 0;
+/** How many test contexts this page has made: 1 once the answer is known, 0 before it is asked for. */
+export function probeCount() {
+    return asked;
+}
+/**
+ * Says whether WebGL works here and whether it draws in software. The first call makes one test context and releases it at once; every later call, from any element or viewer, gets the same answer without making another.
+ *
+ * @returns The kept answer.
+ */
+export function glProbe() {
+    if (answer)
+        return answer;
+    asked++;
+    let works = false;
+    let software = false;
+    let canvas = null;
+    try {
+        canvas = document.createElement("canvas");
+        const two = canvas.getContext("webgl2");
+        const gl = two ?? canvas.getContext("webgl");
+        works = Boolean(gl);
+        if (gl) {
+            try {
+                const info = gl.getExtension("WEBGL_debug_renderer_info");
+                software = /swiftshader|llvmpipe|softpipe/i.test(info ? String(gl.getParameter(info.UNMASKED_RENDERER_WEBGL)) : "");
+            }
+            catch {
+                // The name is only a hint for smooth edges.
+            }
+            gl.getExtension("WEBGL_lose_context")?.loseContext();
+        }
+    }
+    catch {
+        works = false;
+    }
+    if (canvas) {
+        // A canvas of no size lets its drawing buffer go with it.
+        canvas.width = 0;
+        canvas.height = 0;
+    }
+    answer = { works, software };
+    return answer;
+}

package/dist/element/scene.js

@@ -31,6 +31,7 @@ import { placeNameLabels } from "./namePlace.js";
 import { plinthGroup } from "./plinth.js";
 import { PartPlumes, PlumeKit } from "./plumes.js";
 import { ThrusterLayer } from "./thrusterLayer.js";
+import { glProbe } from "./probe.js";
 import { craftJets, endQuads } from "../thrusters.js";
 /** The ships whose lamps turn the sun down in the Lit look. Kit modules stay in daylight. */
 const NIGHT_SHIPS = new Set(["fleet-ship-01", "fleet-kyotori", "fleet-drone", "fleet-ship-03", "fleet-ship-ariake", "fleet-02", "fleet-02-original", "fleet-kaminari", "fleet-emiake", "fleet-romaryu"]);
@@ -55,15 +56,8 @@ const COMPILE_MS = 4000;
 /** A change of craft, section or Fit eases the camera for this long, even in scale. */
 const SIZE_EASE_MS = 800;
 const autoRotateOf = (spin) => (spin.seconds <= 0 ? 0 : (60 / spin.seconds) * (spin.way === "cw" ? -1 : 1));
-/** A real graphics card keeps smooth edges. Software drawing spends the frame on them, and a heavy ship then misses a frame of the wait. */
-const smoothEdges = () => {
-    const canvas = document.createElement("canvas");
-    const gl = canvas.getContext("webgl2");
-    const info = gl?.getExtension("WEBGL_debug_renderer_info");
-    const name = info && gl ? String(gl.getParameter(info.UNMASKED_RENDERER_WEBGL)) : "";
-    gl?.getExtension("WEBGL_lose_context")?.loseContext();
-    return !/swiftshader|llvmpipe|softpipe/i.test(name);
-};
+/** A real graphics card keeps smooth edges. Software drawing spends the frame on them, and a heavy ship then misses a frame of the wait. The page's one WebGL probe says which this is. */
+const smoothEdges = () => !glProbe().software;
 const LINE_VERTEX = /* glsl */ `
 varying vec3 vNormal;
 varying vec2 vUv;

package/dist/element.d.ts

@@ -65,6 +65,8 @@ export declare class UchusenRocket extends HTMLBase {
     private stateNow;
     private shownAt;
     private starting;
+    /** Whether this element has asked the page's WebGL answer since it started watching. */
+    private glAsked;
     private key;
     private driven;
     private placeFrame;

package/dist/element.js

@@ -21,6 +21,7 @@ import { ROCKETS, SLOT_NAMES } from "./rockets.js";
 import { tiltMode, tiltTurn } from "./tilt.js";
 import { skyQuery } from "./element/solarGroups.js";
 import { Panel } from "./element/panel.js";
+import { glProbe } from "./element/probe.js";
 import { spinOf } from "./spin.js";
 const HTMLBase = typeof HTMLElement === "undefined" ? class {
 } : HTMLElement;
@@ -94,29 +95,13 @@ function adopt(root, css, holder) {
 const rocketSheet = { sheet: null };
 const lineupSheet = { sheet: null };
 const media = (query) => typeof matchMedia === "function" && matchMedia(query).matches;
-let webgl = null;
-function webglWorks() {
-    if (webgl !== null)
-        return webgl;
-    try {
-        const probe = document.createElement("canvas");
-        const gl = probe.getContext("webgl2") ?? probe.getContext("webgl");
-        webgl = Boolean(gl);
-        gl?.getExtension("WEBGL_lose_context")?.loseContext();
-    }
-    catch {
-        webgl = false;
-    }
-    return webgl;
-}
+/** Why the 3D view is not wanted, from what is known without making a WebGL context. Whether WebGL works is asked once, when the first element comes on screen. */
 function whyNot(mode) {
     if (mode === "drawing")
         return "off";
     const connection = navigator.connection;
     if (connection?.saveData || media("(prefers-reduced-data: reduce)"))
         return "reduced-data";
-    if (!webglWorks())
-        return "no-webgl";
     return "";
 }
 /**
@@ -154,6 +139,8 @@ export class UchusenRocket extends HTMLBase {
     stateNow = "picture";
     shownAt = 0;
     starting = false;
+    /** Whether this element has asked the page's WebGL answer since it started watching. */
+    glAsked = false;
     key = "";
     driven = null;
     placeFrame = 0;
@@ -900,7 +887,8 @@ export class UchusenRocket extends HTMLBase {
     }
     startWatching() {
         this.watch?.disconnect();
-        const reason = whyNot(this.getAttribute("mode") ?? "auto");
+        let reason = whyNot(this.getAttribute("mode") ?? "auto");
+        this.glAsked = false;
         if (reason) {
             this.setState(reason === "off" ? "picture" : "fallback", reason);
             if (reason !== "off")
@@ -916,6 +904,16 @@ export class UchusenRocket extends HTMLBase {
                 this.kickFlight();
             if (reason)
                 return;
+            if (seen.isIntersecting && !this.glAsked) {
+                // The probe makes a context, which software drawing takes seconds over: it waits until a view is about to draw, and is made once for the whole page.
+                this.glAsked = true;
+                if (!glProbe().works) {
+                    reason = "no-webgl";
+                    this.setState("fallback", reason);
+                    this.emit("uchusen-fallback", { reason });
+                    return;
+                }
+            }
             if (seen.isIntersecting) {
                 this.shownAt ||= performance.now();
                 window.clearTimeout(this.releaseTimer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/uchusen-rockets",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Uchusen Rockets 宇宙船: line drawings and 3D views of rockets, as a web component. Every variant with its own sourced sizes, a typed way to assemble a rocket from parts, stack and separate. No logos. three.js is a peer dependency.",
   "keywords": [
     "rocket",