Emu: official upstream CI build 54633535; keyboard fire Z/X/Alt for Mac

macOS captures Ctrl+Arrow at the OS level (Mission Control/App Exposé),
so the emulator's Ctrl fire key can't be held while steering with the
arrows. ARCADE-PATCH now maps Z, X and Alt/Option to the external
trigger (capture-phase, so nothing types into the Atari; modifier
combos like Cmd+Z pass through untouched).

Bundle swapped from the locally-built 27d37558 to the official upstream
GitHub-CI artifact of 54633535, which includes the fix for silent
deep-link download failures (our issue #86).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: tsemachh

README.md

@@ -41,8 +41,8 @@ commit, and the service worker cache is busted on every deploy.
 The emulator under `emu/` is **[AltirraSDL](https://github.com/ilmenit/AltirraSDL)**
 by Jakub Dębski, a portable fork of **[Altirra](https://www.virtualdub.org/altirra.html)**
 by Avery Lee, licensed **GPLv2** (see [`emu/LICENSE`](emu/LICENSE)). The
-vendored bundle is built from upstream commit
-[`27d37558`](https://github.com/ilmenit/AltirraSDL/commit/27d37558); its
+vendored bundle is the official upstream CI build of commit
+[`54633535`](https://github.com/ilmenit/AltirraSDL/commit/54633535); its
 corresponding source is the upstream repository at that commit. Our
 modifications to the emulator's host page (the ARCADE-PATCH block injected
 into `emu/index.html`, source in
@@ -68,8 +68,12 @@ launches:
 - **TILT toggle + `?tilt=1`** — device-orientation steering (extra
   sensitivity on forward/back so the screen stays visible while
   accelerating).
-- **AUTO FIRE slide switch** — pulses the trigger at ~11 Hz via
-  `ATWasmSetJoystick`.
+- **AUTO FIRE slide switch** — native in-core auto-fire
+  (`ATWasmSetAutoFire`) with an ~11 Hz `ATWasmSetJoystick` fallback on
+  older bundles.
+- **Keyboard fire: Z / X / Alt(Option)** — macOS grabs Ctrl+Arrow
+  (Mission Control), so the emulator's Ctrl fire key can't be held
+  while steering; these alternates work on every desktop OS.
 - **`?tv=1`** — smart-TV remote controls (CE-HTML/HbbTV key codes):
   D-pad → joystick, OK → fire, Red/Green/Yellow → START/SELECT/OPTION,
   Blue → auto-fire, Play/Pause → pause, Back → picker. Open the picker

emu/AltirraSDL.js

@@ -508,6 +508,41 @@
       padding: 0 16px;
     }
 
+    #library-fetch-error {
+      position: absolute;
+      inset: 0;
+      z-index: 30;
+      display: none;
+      align-items: center;
+      justify-content: center;
+      padding: 24px;
+      background: rgba(8, 10, 14, .92);
+      color: #f5f7fa;
+      text-align: center;
+    }
+    #library-fetch-error.active { display: flex; }
+    #library-fetch-error .error-card { max-width: 520px; }
+    #library-fetch-error .error-title {
+      margin-bottom: 10px;
+      font-size: 1.25rem;
+      font-weight: 700;
+    }
+    #library-fetch-error .error-detail {
+      margin-bottom: 18px;
+      color: #c9ced8;
+      overflow-wrap: anywhere;
+    }
+    #library-fetch-retry {
+      padding: 9px 18px;
+      border: 1px solid #7aa2f7;
+      border-radius: 5px;
+      background: #315a9f;
+      color: #fff;
+      cursor: pointer;
+      font: inherit;
+      font-weight: 600;
+    }
+
     /* ── Log panel ───────────────────────────────────────────────── */
     #log {
       flex: 0 0 auto;
@@ -1432,7 +1467,7 @@
     <h1><a id="brand"
            href="https://github.com/ilmenit/AltirraSDL"
            target="_blank" rel="noopener"
-           title="AltirraSDL 4.50 · build 27d3755 (2026-07-18 21:12 UTC) — open the GitHub project in a new tab">AltirraSDL</a></h1>
+           title="AltirraSDL 4.50 · build 54633535 (2026-08-01 09:11 UTC) — open the GitHub project in a new tab">AltirraSDL</a></h1>
     <!-- Lobby: navigate back to a curated software library / catalog
          page.  Hidden by default so a self-hosted bundle (no
          `config.json`, or no `lobbyUrl` field) doesn't show a button
@@ -1531,6 +1566,18 @@ <h1><a id="brand"
       <div class="play-ring" aria-hidden="true"></div>
       <div class="play-label">Click to play</div>
     </div>
+    <div id="library-fetch-error" role="alertdialog" aria-modal="true"
+         aria-labelledby="library-fetch-error-title">
+      <div class="error-card">
+        <div class="error-title" id="library-fetch-error-title">
+          Game download failed
+        </div>
+        <div class="error-detail" id="library-fetch-error-detail">
+          Check your connection and try again.
+        </div>
+        <button id="library-fetch-retry" type="button">Retry download</button>
+      </div>
+    </div>
   </div>
 
   <div id="log" class="hidden">
@@ -1898,7 +1945,7 @@ <h2 id="fw-title">Download standard Atari ROMs?</h2>
     build.  See src/AltirraSDL/cmake/wasm_lib_deeplink.js for the
     contract.
   -->
-  <script src="wasm_lib_deeplink.js?v=27d3755"></script>
+  <script src="wasm_lib_deeplink.js?v=54633535"></script>
 
   <script>
   (() => {
@@ -7209,6 +7256,22 @@ <h2 id="fw-title">Download standard Atari ROMs?</h2>
       arguments: __wasmCliArgs,
       print:    (t) => appendLog('[stdout] ' + t),
       printErr: (t) => appendLog('[stderr] ' + t),
+      onLibraryFetchError: (failures) => {
+        const overlay = document.getElementById('library-fetch-error');
+        const detail = document.getElementById('library-fetch-error-detail');
+        const retry = document.getElementById('library-fetch-retry');
+        const names = (failures || []).map((failure) => failure.path);
+        if (detail) {
+          detail.textContent = names.length
+            ? 'Could not download ' + names.join(', ')
+              + '. Check your connection and try again.'
+            : 'Check your connection and try again.';
+        }
+        if (retry) retry.onclick = () => window.location.reload();
+        if (overlay) overlay.classList.add('active');
+        if (retry) retry.focus();
+        statusEl.textContent = 'Game download failed';
+      },
       // Emscripten calls setStatus with messages like "Downloading
       // data... (1234567/10485760)" while the .wasm is still in flight.
       // Rewrite the prefix so non-technical users see what's actually
@@ -7318,8 +7381,8 @@ <h2 id="fw-title">Download standard Atari ROMs?</h2>
         // opens the File Manager the bar shows real numbers
         // immediately rather than "checking…" for a frame.
         refreshStorageInfo();
-        jlog('runtime ready, build=27d3755',
-             '(2026-07-18 21:12 UTC)');
+        jlog('runtime ready, build=54633535',
+             '(2026-08-01 09:11 UTC)');
         // Log what's on disk after IDBFS syncfs completed so we can
         // confirm uploads survive reloads.  readdir throws if the
         // dir doesn't exist yet — swallow.
@@ -8021,6 +8084,42 @@ <h2 id="fw-title">Download standard Atari ROMs?</h2>
       }, true);
     })();
 
+    // ---- desktop keyboard fire: Z / X / Alt(Option) ---------------------
+    // The emulator's keyboard fire is Ctrl, but macOS grabs Ctrl+Arrow at
+    // the OS level (Mission Control / App Exposé) before the browser ever
+    // sees it — you can't hold fire while steering. Offer triggers no OS
+    // touches: Z, X, and Alt/Option (on Mac laptops the right Option sits
+    // directly beside the arrow cluster). Capture-phase + stop so SDL
+    // never types the letter into the Atari; skipped with a modifier held
+    // (Cmd+Z stays undo) and in TV mode (own handler above).
+    if (params.get('tv') !== '1') (function () {
+      var kbFire = false;
+      function isFireKey(e) {
+        return e.code === 'KeyZ' || e.code === 'KeyX' || e.key === 'Alt';
+      }
+      function setKbFire(down) {
+        if (kbFire === down) return;
+        kbFire = down;
+        // Auto-fire ON holds the external trigger steady — never release it
+        var afHold = afBtn && afBtn.classList.contains('on');
+        ext.fire = down || !!afHold;
+        pushExt();
+      }
+      document.addEventListener('keydown', function (e) {
+        if (e.metaKey || e.ctrlKey) return;
+        if (!isFireKey(e)) return;
+        e.preventDefault(); e.stopImmediatePropagation();
+        setKbFire(true);
+      }, true);
+      document.addEventListener('keyup', function (e) {
+        if (!isFireKey(e)) return;
+        e.preventDefault(); e.stopImmediatePropagation();
+        setKbFire(false);
+      }, true);
+      // Alt+Tab / app switch can eat the keyup — never leave fire stuck
+      window.addEventListener('blur', function () { setKbFire(false); });
+    })();
+
     // ---- ?fs=1 : tap enters fullscreen ---------------------------------
     // Android Chrome rejects fullscreen requests made from start-of-touch
     // events (pointerdown/touchstart) — only end-of-gesture events carry

emu/AltirraSDL.wasm

@@ -1003,26 +1003,49 @@
       }
 
       function doFetch(reasonLabel) {
-        return fetch(url, { cache: 'no-cache' })
-          .then(function (r) {
-            // Compact status-only message — the outer .catch logs the
-            // full URL alongside, so duplicating it here would just
-            // produce "... at URL — HTTP 404 for URL".
-            if (!r.ok) throw new Error('HTTP ' + r.status);
-            var freshETag = r.headers.get('etag');
-            return r.arrayBuffer().then(function (buf) {
-              writeFile(buf, freshETag);
-              if (reasonLabel === 'refetch') refetched++; else fetched++;
+        var maxAttempts = 3;
+
+        function fetchAttempt(attempt) {
+          return fetch(url, { cache: 'no-cache' })
+            .then(function (r) {
+              // Compact status-only message — the outer .catch logs the
+              // full URL alongside, so duplicating it here would just
+              // produce "... at URL — HTTP 404 for URL".
+              if (!r.ok) {
+                var httpError = new Error('HTTP ' + r.status);
+                httpError.httpStatus = r.status;
+                throw httpError;
+              }
+              var freshETag = r.headers.get('etag');
+              return r.arrayBuffer().then(function (buf) {
+                writeFile(buf, freshETag);
+                if (reasonLabel === 'refetch') refetched++; else fetched++;
+              });
+            }).catch(function (err) {
+              var status = err && err.httpStatus;
+              var retryable = !status || status === 408 || status === 425
+                || status === 429 || status >= 500;
+              if (retryable && attempt < maxAttempts) {
+                var delay = attempt === 1 ? 400 : 1200;
+                log('fetch attempt ' + attempt + ' failed for', e.rel,
+                    '— retrying in ' + delay + 'ms:',
+                    err && err.message ? err.message : err);
+                return new Promise(function (resolve) {
+                  setTimeout(resolve, delay);
+                }).then(function () { return fetchAttempt(attempt + 1); });
+              }
+
+              // Include the full URL — when self-hosters report "fetch
+              // failed", the actual URL the browser tried is the single
+              // most useful debug breadcrumb (404 from the wrong path is
+              // the #1 cause; HTTP status alone doesn't pinpoint that).
+              log('fetch failed for', e.rel, 'at', url, '—',
+                  err && err.message ? err.message : err);
+              throw err;
             });
-          })
-          .catch(function (err) {
-            // Include the full URL — when self-hosters report "fetch
-            // failed", the actual URL the browser tried is the single
-            // most useful debug breadcrumb (404 from the wrong path is
-            // the #1 cause; HTTP status alone doesn't pinpoint that).
-            log('fetch failed for', e.rel, 'at', url, '—',
-                err && err.message ? err.message : err);
-          });
+        }
+
+        return fetchAttempt(1);
       }
 
       if (onDiskSize <= 0) {
@@ -1085,7 +1108,32 @@
     }));
 
     var totalCount = entries.length + fwEntries.length;
-    Promise.all(promises).then(function () {
+    Promise.all(promises.map(function (promise, index) {
+      return promise.then(function () { return null; }, function (err) {
+        var allEntries = entries.concat(fwEntries);
+        return {
+          path: allEntries[index].rel,
+          message: err && err.message ? err.message : String(err),
+        };
+      });
+    })).then(function (failures) {
+      failures = failures.filter(function (failure) { return failure; });
+      if (failures.length) {
+        log('startup blocked: ' + failures.length
+            + ' requested file(s) could not be downloaded');
+        if (typeof Module.onLibraryFetchError === 'function') {
+          try { Module.onLibraryFetchError(failures); } catch (e) {
+            log('onLibraryFetchError failed —',
+                e && e.message ? e.message : e);
+          }
+        }
+        // Deliberately retain the run dependency.  Starting with CLI
+        // paths that do not exist drops an empty Atari into Self Test,
+        // which hides the actual download error from the user.  The
+        // error UI offers a reload that retries the complete startup.
+        return;
+      }
+
       log('lib+firmware: ' + fetched + ' fetched + ' + refetched
           + ' refetched + ' + cached + ' cached / ' + totalCount
           + ' file(s)'

emu/index.html

@@ -465,6 +465,42 @@
       }, true);
     })();
 
+    // ---- desktop keyboard fire: Z / X / Alt(Option) ---------------------
+    // The emulator's keyboard fire is Ctrl, but macOS grabs Ctrl+Arrow at
+    // the OS level (Mission Control / App Exposé) before the browser ever
+    // sees it — you can't hold fire while steering. Offer triggers no OS
+    // touches: Z, X, and Alt/Option (on Mac laptops the right Option sits
+    // directly beside the arrow cluster). Capture-phase + stop so SDL
+    // never types the letter into the Atari; skipped with a modifier held
+    // (Cmd+Z stays undo) and in TV mode (own handler above).
+    if (params.get('tv') !== '1') (function () {
+      var kbFire = false;
+      function isFireKey(e) {
+        return e.code === 'KeyZ' || e.code === 'KeyX' || e.key === 'Alt';
+      }
+      function setKbFire(down) {
+        if (kbFire === down) return;
+        kbFire = down;
+        // Auto-fire ON holds the external trigger steady — never release it
+        var afHold = afBtn && afBtn.classList.contains('on');
+        ext.fire = down || !!afHold;
+        pushExt();
+      }
+      document.addEventListener('keydown', function (e) {
+        if (e.metaKey || e.ctrlKey) return;
+        if (!isFireKey(e)) return;
+        e.preventDefault(); e.stopImmediatePropagation();
+        setKbFire(true);
+      }, true);
+      document.addEventListener('keyup', function (e) {
+        if (!isFireKey(e)) return;
+        e.preventDefault(); e.stopImmediatePropagation();
+        setKbFire(false);
+      }, true);
+      // Alt+Tab / app switch can eat the keyup — never leave fire stuck
+      window.addEventListener('blur', function () { setKbFire(false); });
+    })();
+
     // ---- ?fs=1 : tap enters fullscreen ---------------------------------
     // Android Chrome rejects fullscreen requests made from start-of-touch
     // events (pointerdown/touchstart) — only end-of-gesture events carry