SCREEN STACK            back to front

  html  #191414                     theme body colour
   │                                on html ONLY — an opaque body
   │                                background hides the stars
   ├─ canvas#mss-stars      z -2    @bg/layers/stars.js
   │    · star field                client code, imported not copied
   │    · shooting star  X         own canvas, own GL context
   │
   ├─ canvas#stage         z  1     src/eclipse.js
   │    · the eclipse rebuild       sky transparent → stars show
   │                          D    body disc opaque → occults them
   │
   ├─ img#reference        z  2     @art/hero-planet.svg
   │    · the original       S     off / 50% / full
   │
   └─ .tag / this panel    z  3+    O


INSIDE THE ECLIPSE SHADER   one quad, one draw call
  painted top to bottom · press a key to drop a layer

  transparent                            starts at alpha 0
     click a row to drop it · click S to solo it
   ▼
  sRGB → linear → gl_FragColor
  compositing matches the SVG's space;
  three converts back on output

  the body disc is the only OPAQUE layer — drop it (5)
  to see the three blooms it normally hides
  the arcs are masked by a falloff on the FLARE, not
  the body: white-hot by the flare, a thread at the right


WHERE THE CODE LIVES

  eclipse.html
   └─ src/eclipse.js          stage: renderer, ortho
       │                      camera 1:1 on 1905x1286,
       │                      y DOWN so Figma numbers
       │                      transfer verbatim
       │
       ├─ src/objects/eclipse.js   the artwork
       │
       ├─ @bg/layers/stars.js  ─┐  ~/scylladb-site-mss
       └─ @art/hero-planet.svg ─┘  CLIENT REPO, read-only
                                  aliased in
                                  vite.eclipse.config.mjs


KEYS   S reference   D rebuild   X shooting star
       G replay the entrance — limb 12s, atmosphere 6s
       O this panel   R all layers back on
       V back to the composition + replay
       ├─ animated, and the entrance has brought it up
       ◌  animated, on, not reached yet
       ┄  STATIC — no envelope, on from frame zero
       ·  kept for comparison, not in the composition
       1..9 0 - + * . ⏎   drop / restore one shader layer
       / all on → all off → back to your selection
       what you switch off is remembered across reloads

  5 6 7 8 are the body disc pulled apart: the flat
  silhouette and the three bands of its limb ramp.
  All four on = the single disc it was, exactly.
  u sits on the silhouette: a rotating fbm cloud shell,
  lit ONLY by a 3D crescent thrown from the flare.

  ENTRANCE GROUPS
    6 7 8   wipe from the flare 12s + folder fade 6s
    9 0 -   folder fade 8s, starting 1s in
    1 2 3   staggered, 0-3.5s / 1-5s / 2-6s
    + * . ⏎ the flare folder, its own clock, at 2.0s
    i k j   the band builds outward: fine 0.3s with the
            diagonals, wash 1.0s, wide 1.8s — 3.6s fade
    c e     cine tail, on the afterglow at 2.32s