ugly-game 0.5.2 → 0.5.3

package/dist/input/browserBackend.d.ts

@@ -27,6 +27,10 @@ export declare class BrowserRawBackend {
     private paused;
     constructor(opts: BrowserBackendOpts);
     setPaused(p: boolean): void;
+    /** Drop every held key / mouse button / touch. Called when the window can no longer observe releases (blur,
+     *  tab hidden, pointer-lock lost) so a key held across the disruption can't stick "on" and drive the avatar
+     *  forever. Public so a host can force it (e.g. right before opening a modal that steals focus). */
+    releaseHeld(): void;
     private on;
     private cursor;
     private gesture;

package/dist/input/browserBackend.js

@@ -36,6 +36,10 @@ export class BrowserRawBackend {
     paused = false; // while a menu is open: suspend gameplay input + don't grab pointer lock
     constructor(opts) { this.target = opts.target; this.pointerLock = opts.pointerLock ?? false; this.attach(); }
     setPaused(p) { this.paused = p; }
+    /** Drop every held key / mouse button / touch. Called when the window can no longer observe releases (blur,
+     *  tab hidden, pointer-lock lost) so a key held across the disruption can't stick "on" and drive the avatar
+     *  forever. Public so a host can force it (e.g. right before opening a modal that steals focus). */
+    releaseHeld() { this.keysDown.clear(); this.touches.clear(); this.pointerButtons.clear(); }
     on(el, type, fn, o) {
         const handler = fn;
         el.addEventListener(type, handler, o);
@@ -54,7 +58,21 @@ export class BrowserRawBackend {
         this.on(window, 'keydown', (e) => { if (!this.keysDown.has(e.code))
             this.edges.add('key:' + e.code); this.keysDown.add(e.code); });
         this.on(window, 'keyup', (e) => { this.keysDown.delete(e.code); });
-        this.on(window, 'blur', () => { this.keysDown.clear(); this.touches.clear(); this.pointerButtons.clear(); });
+        // RELEASE ALL held input whenever the window can no longer see the keys being let go. `blur` alone is not
+        // enough: on macOS an app-switch (Cmd+Tab) delivers the keyup to the background, and the reliable page-side
+        // signal is `visibilitychange`→hidden (blur can be missed). Losing pointer lock (Esc / menu) is the same
+        // hazard. Without this a movement key held at switch-time stays in keysDown and the avatar walks that way
+        // forever ("stuck always going backward"). We clear ONLY on the disruptive edge — never when the tab becomes
+        // visible again or when lock is ACQUIRED, which would wrongly drop a key the player is legitimately holding.
+        this.on(window, 'blur', () => { this.releaseHeld(); });
+        const onHidden = () => { if (document.hidden)
+            this.releaseHeld(); };
+        const onUnlock = () => { if (document.pointerLockElement !== this.target)
+            this.releaseHeld(); };
+        document.addEventListener('visibilitychange', onHidden);
+        document.addEventListener('pointerlockchange', onUnlock);
+        this.disposers.push(() => { document.removeEventListener('visibilitychange', onHidden); });
+        this.disposers.push(() => { document.removeEventListener('pointerlockchange', onUnlock); });
         this.on(this.target, 'wheel', (e) => { this.pwheel += e.deltaY; e.preventDefault(); }, { passive: false });
         this.on(this.target, 'contextmenu', (e) => { e.preventDefault(); });
         this.on(this.target, 'pointerdown', (e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-game",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "type": "module",
   "exports": {
     ".": {