feat(web): add browser build for TDK Pinball

Expose the existing Macroquad game as a static WASM website while preserving native desktop behavior. Native-only simulation/file-export code and the per-user filesystem save path are now separated from the browser build. The browser version uses a small WASM-only storage support crate and a Macroquad-compatible JavaScript plugin to persist the same JSON settings and high scores in localStorage. Browser audio decoding starts in an owned background coroutine so the game can render its original loading/attract screens while the embedded sounds finish loading. The checked-in web bundle contains the optimized WASM, centered black HTML shell, and build/serve instructions. Test Plan: - `just test` -- passed, 135 tests - `just clippy` -- passed - `cargo clippy --target wasm32-unknown-unknown -- -D warnings` -- passed - `cargo +nightly fmt --check` and web-storage format check -- passed - `just web-build` -- passed; packaged WASM matches the production artifact - Browser smoke test at `http://127.0.0.1:8000/` -- rendered the centered game, started gameplay, opened settings, and restored a changed language from browser storage in a fresh page with no runtime errors
2026-08-29 14:32:41 +02:00
parent c2f1443436
commit b079cfa196
16 changed files with 523 additions and 89 deletions
@@ -0,0 +1,69 @@
+"use strict";
+
+(function registerStoragePlugin() {
+  const storageKey = "tdkpin.save.v1";
+  const encoder = new TextEncoder();
+  const decoder = new TextDecoder();
+  let lastRevision = 0;
+
+  function browserStorage() {
+    try {
+      return window.localStorage;
+    } catch (_error) {
+      return null;
+    }
+  }
+
+  function sendSavedDataToRust() {
+    wasm_exports.tdkpin_browser_storage_clear();
+    const storage = browserStorage();
+    let saved = null;
+    try {
+      saved = storage?.getItem(storageKey);
+    } catch (_error) {
+      saved = null;
+    }
+    if (saved !== null && saved !== undefined) {
+      for (const byte of encoder.encode(saved)) {
+        wasm_exports.tdkpin_browser_storage_push(byte);
+      }
+    }
+    wasm_exports.tdkpin_browser_storage_finish();
+  }
+
+  function flushRustSave() {
+    const revision = wasm_exports.tdkpin_browser_storage_save_revision();
+    if (revision === lastRevision) {
+      return;
+    }
+
+    const bytes = new Uint8Array(
+      wasm_exports.tdkpin_browser_storage_save_length(),
+    );
+    for (let index = 0; index < bytes.length; index += 1) {
+      bytes[index] = wasm_exports.tdkpin_browser_storage_save_byte(index);
+    }
+
+    const storage = browserStorage();
+    try {
+      storage?.setItem(storageKey, decoder.decode(bytes));
+    } catch (_error) {
+      // Private browsing or a full quota should not stop the game loop.
+    }
+    wasm_exports.tdkpin_browser_storage_save_ack();
+    lastRevision = revision;
+  }
+
+  function onInit() {
+    sendSavedDataToRust();
+    lastRevision = wasm_exports.tdkpin_browser_storage_save_revision();
+    window.setInterval(flushRustSave, 50);
+    window.addEventListener("beforeunload", flushRustSave);
+  }
+
+  miniquad_add_plugin({
+    name: "tdkpin_storage",
+    on_init: onInit,
+    version: 1,
+  });
+})();