diff --git a/docs/STRATA.md b/docs/STRATA.md index ce20091..1ca4543 100644 --- a/docs/STRATA.md +++ b/docs/STRATA.md @@ -155,6 +155,26 @@ text. `?bench=30` runs for 30 seconds. Nothing is sent anywhere. CI that a run finishes and shows its card on both profiles (it keeps no numbers: headless Chromium draws on the CPU). +### The loading shell + +The page loads behind the Strata web kit's loading shell +(`strata/web/strata-kit/strata-loader.js`, vendored from Strata at the commit in +`strata/web/strata-kit/PIN`; `strata/web/strata-kit/update.sh ` re-vendors it). It shows +the trailer's first frame (the one on ) as a blurred backdrop and real progress with the size ("0.5 of 1.3 MB"). The loader streams +the `.wasm` and hands its bytes to the engine, so nothing downloads twice. If +env-lib-cpp can't run (no WebGL 2, the renderer fails, the engine stops, a lost +WebGL context does not come back), the shell says why, and plays the trailer instead (the still under `prefers-reduced-motion`). +A device that draws under 12 frames a second is offered the clip without +losing the live view (not in automated browsers or `?bench` runs). + +`strata/web/strata-boot.js` bridges this classic (non-`MODULARIZE`) build to the +loader: emcc's script tag sits inert in `