| name | verify |
| description | Drive the built DECODE sim GUI via Electron and capture screenshots — use to verify UI/game changes at the real surface (menu, HUD, in-game input). |
Verifying this app end-to-end
Two surfaces:
- Sim core (
src/sim/, src/config.ts): npm test (scripts/smoke.ts) IS the
runtime surface — it drives full worlds headlessly. Add a check per behavior change.
- GUI (menu, HUD, input, audio wiring): drive the real app via Electron.
Electron GUI drive recipe (no Playwright needed)
npm run build first; Electron loads dist/index.html (see electron/main.cjs).- Write a driver script (CJS) in the scratchpad and run
npx electron <script>.
- Gotchas (Windows, this machine):
capturePage() throws UnknownVizError unless you call
app.disableHardwareAcceleration() AND
app.commandLine.appendSwitch('disable-features', 'CalculateNativeWinOcclusion'),
and win.show(); win.focus(); before capturing.- Set
webPreferences: { backgroundThrottling: false } or rAF (the game loop) stalls.
- React: never
.click() two buttons in one executeJavaScript call — the second
handler sees stale props (state batching). One click per call, ~120 ms apart.
- Drive with
executeJavaScript: element.click() works on React buttons;
window.dispatchEvent(new KeyboardEvent('keydown', {key:'j', bubbles:true}))
reaches both the menu capture listeners and the in-game Keyboard class
(send a matching keyup to release held keys).
- Observe via DOM: hopper pips
.hopper-pip (class empty), HUD chips .chip
(text REVERSED / GATE OPEN), keycaps .keycap, and
localStorage['decodesim.settings.v1'] for persistence.
- Clean up:
localStorage.removeItem('decodesim.settings.v1') at the end so the
run doesn't leave test bindings on the user's machine.
Working example from a past session: rebind fire→J, check steal/UNBOUND, reload for
persistence, ENTER FIELD in Free Drive + Robot-centric, hold J to fire (pips empty),
press F for the REVERSED chip.
