# Vector Asteroids — Final Hardening / QA Report

## Static-hosting and dependency audit

- Deliverable game is a single `index.html` with all CSS and JavaScript inline.
- No external files are referenced: no images, fonts, audio files, manifests, workers, CDN links, `<script src>`, `<link rel="stylesheet">`, `fetch`, XHR, ES module imports, npm package imports, or build-step assumptions.
- Graphics are drawn with Canvas 2D.
- Audio is synthesized at runtime with Web Audio API oscillators, gains, filters, and generated noise buffers.
- High score uses defensive `localStorage` access wrapped in `try/catch`; if browser storage is blocked, the game continues with an in-memory score and displays a memory-only note.
- File is designed to work from `file://` and from a plain static host because it performs no network requests and loads no assets.

## Hardening and performance work included

- Responsive resize/orientation handling with canvas DPR scaling capped at `2` for desktop/mobile performance.
- Frame-rate independent simulation using `requestAnimationFrame` delta time capped at `0.05s` to avoid giant physics jumps after tab sleeps.
- Particle count capped at `850` to prevent runaway explosion/trail allocations.
- Keyboard input prevents browser scrolling for game keys, clears stuck keys on blur, and pauses on page visibility loss.
- Audio unlock is user-gesture driven and fails silent if `AudioContext` is unavailable or suspended.
- Saucers, bullets, asteroids, player respawn, wave progression, score, extra lives, and high-score persistence all use defensive state checks.
- Difficulty balance tuned for a showcase demo: wave asteroid count caps at 13, asteroid/saucer speed scales gradually, saucer accuracy improves over later waves, and extra ships arrive every 10,000 points.

## Manual test matrix

| Area | Steps | Expected result |
|---|---|---|
| `file://` launch | Open `index.html` directly from disk in Chrome/Edge, Firefox, and Safari where available. | Title screen appears with moving neon attract background; no network errors are required for play. |
| Static hosting | Serve the same file from any plain static host or local static file server. | Game behaves identically to `file://`; no external assets are requested. |
| Title / attract | Wait on the title screen for 30 seconds. | Starfield and vector rocks continue moving smoothly; HUD shows READY; controls and scoring are visible. |
| Start | Press Enter, Space, or click/tap `INSERT COIN / START`. | Overlay disappears; wave 1 starts; player ship appears invulnerable at center; score resets. |
| Keyboard controls | Use ←/→ or A/D, ↑ or W, ↓ or S, Space/J/K, Shift/H. | Ship rotates, thrusts with inertia/flame/trail, brakes softly, fires glowing bullets, and hyperspaces with cooldown. |
| Screen wrap | Fly through all four screen edges; observe rocks and bullets near edges. | Ship, asteroids, bullets, and particles wrap without disappearing abruptly. |
| Asteroid splitting | Shoot large asteroids, then medium asteroids, then small asteroids. | Large rocks split into medium, medium into small, small disappears; score awards 20/50/100; explosions and shake occur. |
| Wave progression | Clear all asteroids in a wave. | `WAVE CLEAR` appears, then the next wave spawns with more/faster asteroids and HUD wave increments. |
| Saucer | Play long enough for a saucer to enter. Shoot it and also allow it to fire. | Saucer hums, shoots red bullets toward the player, can be destroyed for bonus points, and despawns/reappears over time. |
| Player damage / lives | Collide with an asteroid or enemy bullet. | Ship explodes, lives decrease, thrust sound stops, and respawn waits for a safer center area with temporary shield. |
| Extra life | Reach or simulate play past 10,000 points. | Lives increase by one, `EXTRA SHIP` text appears, and bonus sound plays. |
| Pause / resume | Press P or Escape during gameplay; press again or click Resume. | Gameplay freezes, continuous sounds stop, pause overlay appears, and resume continues without time jump. |
| Game over / restart | Lose all ships, then press Enter/Space/R or click Play Again. | Clean game-over screen shows final/high score; restart begins a fresh game with reset score/lives/wave. |
| High score | Set a new high score, reload the page, then start again. | High score persists if localStorage is available; if storage is blocked, game remains playable and notes memory-only high score. |
| Audio unlock | Load page, observe status, then press any key/click/tap. Toggle M. | Status changes from unlock prompt to audio on; M mutes/unmutes; no exception if browser blocks autoplay until gesture. |
| Resize/orientation | Resize the browser and rotate a mobile/tablet viewport during title and gameplay. | Canvas fills viewport, objects remain in bounds/wrapped, HUD and touch controls remain usable. |
| Touch controls | On a touch-capable viewport, use on-screen rotate/thrust/fire/hyperspace buttons. | Buttons respond to pointer down/up/cancel and do not leave controls stuck after release. |
| Performance smoke | Play through several waves with many particles and saucer fire. | Animation remains smooth on common desktop browsers; particles do not grow without bound. |
| No-network verification | Open DevTools Network panel, reload, and play. | No asset/CDN/fetch requests should appear beyond the document itself when statically hosted. |

## Browser/API calls to verify during runtime QA

No third-party SDKs or package dependencies are used. The only browser APIs that should be verified against target browsers are stable platform APIs: Canvas 2D (`getContext`, paths, gradients, shadows), Web Audio (`AudioContext`/`webkitAudioContext`, `createOscillator`, `createGain`, `createBuffer`, `createBufferSource`, `createBiquadFilter`, `AudioParam` ramps), `requestAnimationFrame`, Pointer Events, Page Visibility, and `localStorage`.

## Known QA limitation

This report is based on source-level hardening and a manual test plan prepared for maintainers; the code cannot be executed from this build environment. A maintainer should run the matrix above on the final resolved browser targets before publishing.