@forgeax/engine-input 0.1.19 → 0.1.21

package/dist/input-snapshot.d.ts

@@ -307,12 +307,14 @@ export interface InputSnapshot {
 export interface InputBackend {
     /**
      * Produce one frame's worth of input data and reset the per-frame
-     * accumulators (movement delta + up-edge set). Held-key state and
-     * held-button state survive across calls.
+     * accumulators (movement delta + edge sets). Held-key state and
+     * held-button state survive across calls. Browser producers latch edge
+     * transitions when events arrive, so a down+up sequence between two scans
+     * remains observable instead of being lost to the held-state projection.
      *
      * Contract notes:
      * - `downKeys` is the held-key set as of the call (held across frames)
-     * - `upKeys` is the up-edge set since the previous sample (cleared
+     * - `upKeys` is the release-edge set since the previous sample (cleared
      *   after the call so the edge appears in exactly one frame)
      * - `buttons` is the held-button slot tuple `[b0, b1, b2]`
      * - `movementX` / `movementY` are the accumulated PointerLock delta
@@ -349,7 +351,15 @@ export interface InputBackendSample {
     readonly downCodes?: ReadonlySet<string>;
     /** One-frame physical code release edges, when the producer has them. */
     readonly upCodes?: ReadonlySet<string>;
+    /** Logical key press edges latched since the previous frame-start scan. */
+    readonly pressedKeys?: ReadonlySet<string>;
+    /** Physical code press edges latched since the previous frame-start scan. */
+    readonly pressedCodes?: ReadonlySet<string>;
     readonly buttons: readonly [boolean, boolean, boolean];
+    /** Mouse button press edges latched since the previous frame-start scan. */
+    readonly pressedButtons?: readonly [boolean, boolean, boolean];
+    /** Mouse button release edges latched since the previous frame-start scan. */
+    readonly releasedButtons?: readonly [boolean, boolean, boolean];
     readonly movementX: number;
     readonly movementY: number;
     /** Latest canvas-pixel mouse position; absent for non-pointer backends. */

package/dist/input-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-snapshot.d.ts","sourceRoot":"","sources":["../src/input-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"input-snapshot.d.ts","sourceRoot":"","sources":["../src/input-snapshot.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-input",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -31,8 +31,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-ecs": "0.1.19",
-    "@forgeax/engine-plugin": "0.1.19"
+    "@forgeax/engine-ecs": "0.1.21",
+    "@forgeax/engine-plugin": "0.1.21"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/browser-backend-edge-latch.test.ts

@@ -0,0 +1,154 @@
+import { Update, World } from '@forgeax/engine-ecs';
+import { describe, expect, it } from 'vitest';
+import { attachBrowserInputBackend } from '../browser-backend';
+import { INPUT_BACKEND_KEY, InputFrameStartScan } from '../frame-start-scan-system';
+import { INPUT_SNAPSHOT_RESOURCE_KEY, snapshotFromSample } from '../input-snapshot';
+
+type Listener = (event: Event) => void;
+
+function buildEnvironment(): {
+  readonly backend: ReturnType<typeof attachBrowserInputBackend>['backend'];
+  fire(target: 'canvas' | 'document' | 'window', kind: string, event: Event): void;
+} {
+  const listeners = new Map<string, Map<string, Set<Listener>>>();
+  const target = (name: string) => ({
+    addEventListener(kind: string, listener: Listener): void {
+      let byKind = listeners.get(name);
+      if (byKind === undefined) {
+        byKind = new Map();
+        listeners.set(name, byKind);
+      }
+      let handlers = byKind.get(kind);
+      if (handlers === undefined) {
+        handlers = new Set();
+        byKind.set(kind, handlers);
+      }
+      handlers.add(listener);
+    },
+    removeEventListener(kind: string, listener: Listener): void {
+      listeners.get(name)?.get(kind)?.delete(listener);
+    },
+  });
+  const canvas = {
+    ...target('canvas'),
+    width: 800,
+    height: 600,
+    style: { touchAction: '' },
+    getBoundingClientRect: () => ({ left: 0, top: 0, width: 800, height: 600 }) as DOMRect,
+    requestPointerLock: () => {},
+    setPointerCapture: () => {},
+  } as unknown as HTMLCanvasElement;
+  const document = {
+    ...target('document'),
+    hasFocus: () => true,
+    visibilityState: 'visible',
+    pointerLockElement: null,
+    exitPointerLock: () => {},
+  } as unknown as Document;
+  const window = target('window') as unknown as Window;
+  const handle = attachBrowserInputBackend(canvas, { document, window });
+  return {
+    backend: handle.backend,
+    fire(targetName, kind, event) {
+      for (const listener of listeners.get(targetName)?.get(kind) ?? []) listener(event);
+    },
+  };
+}
+
+function keyEvent(key: string, code: string, repeat = false): Event {
+  return { key, code, repeat } as unknown as Event;
+}
+
+function pointerEvent(type: 'pointerdown' | 'pointerup', button: 0 | 1 | 2): Event {
+  return {
+    pointerId: 1,
+    pointerType: 'mouse',
+    button,
+    clientX: 100,
+    clientY: 100,
+    pressure: type === 'pointerdown' ? 0.5 : 0,
+    movementX: 0,
+    movementY: 0,
+  } as unknown as Event;
+}
+
+describe('browser input edge latch', () => {
+  it('preserves key and mouse down/up transitions that arrive between scans', () => {
+    const env = buildEnvironment();
+    env.fire('window', 'keydown', keyEvent('a', 'KeyA'));
+    env.fire('window', 'keyup', keyEvent('a', 'KeyA'));
+    env.fire('canvas', 'pointerdown', pointerEvent('pointerdown', 0));
+    env.fire('canvas', 'pointerup', pointerEvent('pointerup', 0));
+
+    const sample = env.backend.sample();
+    expect(sample.downKeys.has('a')).toBe(false);
+    expect(sample.upKeys.has('a')).toBe(true);
+    expect(sample.pressedKeys?.has('a')).toBe(true);
+    expect(sample.downCodes?.has('KeyA')).toBe(false);
+    expect(sample.upCodes?.has('KeyA')).toBe(true);
+    expect(sample.pressedCodes?.has('KeyA')).toBe(true);
+    expect(sample.buttons).toEqual([false, false, false]);
+    expect(sample.pressedButtons).toEqual([true, false, false]);
+    expect(sample.releasedButtons).toEqual([true, false, false]);
+
+    const next = env.backend.sample();
+    expect(next.upKeys.size).toBe(0);
+    expect(next.pressedKeys?.size).toBe(0);
+    expect(next.upCodes?.size).toBe(0);
+    expect(next.pressedCodes?.size).toBe(0);
+    expect(next.pressedButtons).toEqual([false, false, false]);
+    expect(next.releasedButtons).toEqual([false, false, false]);
+  });
+
+  it('does not synthesize a second press for repeated keydown events', () => {
+    const env = buildEnvironment();
+    env.fire('window', 'keydown', keyEvent('w', 'KeyW'));
+    expect(env.backend.sample().pressedKeys?.has('w')).toBe(true);
+
+    env.fire('window', 'keydown', keyEvent('w', 'KeyW', true));
+    const repeated = env.backend.sample();
+    expect(repeated.downKeys.has('w')).toBe(true);
+    expect(repeated.pressedKeys?.has('w')).toBe(false);
+  });
+
+  it('lets snapshot and frame-start scan consume the latched edges exactly once', () => {
+    const sample = {
+      downKeys: new Set<string>(),
+      upKeys: new Set(['a']),
+      downCodes: new Set<string>(),
+      upCodes: new Set(['KeyA']),
+      pressedKeys: new Set(['a']),
+      pressedCodes: new Set(['KeyA']),
+      buttons: [false, false, false] as const,
+      pressedButtons: [true, false, false] as const,
+      releasedButtons: [true, false, false] as const,
+      movementX: 0,
+      movementY: 0,
+      wheelDelta: 0,
+      focused: true,
+      pointerLocked: false,
+    };
+    const direct = snapshotFromSample(sample);
+    expect(direct.keyboard.justPressed('a')).toBe(true);
+    expect(direct.keyboard.justPressedCode('KeyA')).toBe(true);
+    expect(direct.mouse.justPressed(0)).toBe(true);
+    expect(direct.mouse.justReleased(0)).toBe(true);
+    expect(direct.mouse.button(0)).toBe(false);
+
+    let calls = 0;
+    const world = new World();
+    world.insertResource(INPUT_BACKEND_KEY, {
+      sample: () => {
+        calls += 1;
+        return sample;
+      },
+      detach: () => {},
+    });
+    world.addSystem(Update, InputFrameStartScan).unwrap();
+    world.update(0).unwrap();
+    const scanned = world.getResource<typeof direct>(INPUT_SNAPSHOT_RESOURCE_KEY);
+    expect(calls).toBe(1);
+    expect(scanned.keyboard.justPressed('a')).toBe(true);
+    expect(scanned.mouse.justReleased(0)).toBe(true);
+  });
+});

package/src/__tests__/browser-backend-focus-loss.test.ts

@@ -179,7 +179,11 @@ describe('browser-backend focus loss', () => {
     const cancelled = env.backend.sample();
     expect(cancelled.downKeys.size).toBe(0);
     expect(cancelled.downCodes?.size).toBe(0);
+    expect(cancelled.pressedKeys?.size).toBe(0);
+    expect(cancelled.pressedCodes?.size).toBe(0);
     expect(cancelled.buttons).toEqual([false, false, false]);
+    expect(cancelled.pressedButtons).toEqual([false, false, false]);
+    expect(cancelled.releasedButtons).toEqual([false, false, false]);
     expect(cancelled.focusReset).toBe(true);
     expect(cancelled.pointerLocked).toBe(false);
     expect(cancelled.pointers).toBeUndefined();

package/src/__tests__/browser-backend-lock-error.test.ts

@@ -1,7 +1,7 @@
-// browser-backend-lock-error.test.ts -- M1 w4: onLockError unit tests.
+// browser-backend-lock-error.test.ts -- M3 pointer-lock failure unit tests.
 //
-// Covers: W3C rejection → onLockError (no longer silently swallowed),
-// provider reject → onLockError + providerLocked rollback.
+// Covers: W3C rejection / pointerlockerror → onLockError (no longer silently
+// swallowed), provider reject → onLockError + providerLocked rollback.
 //
 // charter awareness:
 //   P3 explicit failure -- lock failures must produce structured signals,
@@ -84,14 +84,28 @@ describe('browser-backend-lock-error.test.ts (w4)', () => {
       }
 
       // Wait for microtask to resolve promise rejection.
-      return vi.waitFor(
-        () => {
-          expect(lockErrorCalls.length).toBe(1);
-          expect(lockErrorCalls[0]?.path).toBe('w3c');
-          expect(lockErrorCalls[0]?.cause).toBe(rejectionError);
-        },
-        { timeout: 200 },
-      );
+      return vi
+        .waitFor(
+          () => {
+            expect(lockErrorCalls.length).toBe(1);
+            expect(lockErrorCalls[0]?.path).toBe('w3c');
+            expect(lockErrorCalls[0]?.cause).toBe(rejectionError);
+          },
+          { timeout: 200 },
+        )
+        .then(async () => {
+          const browserEvent = new Event('pointerlockerror');
+          const errorHandlers = listeners.get('document')?.get('pointerlockerror');
+          for (const handler of errorHandlers ?? []) handler(browserEvent);
+          await vi.waitFor(
+            () => {
+              expect(lockErrorCalls.length).toBe(2);
+              expect(lockErrorCalls[1]?.path).toBe('w3c');
+              expect(lockErrorCalls[1]?.cause).toBe(browserEvent);
+            },
+            { timeout: 200 },
+          );
+        });
     });
 
     it('W3C rejection without onLockError provided does NOT throw (backend is resilient)', () => {

package/src/__tests__/browser-backend-lock-gate.test.ts

@@ -17,6 +17,7 @@ import { attachBrowserInputBackend } from '../browser-backend';
 function buildEnvForClickTest(opts?: {
   hostPredicate?: (() => boolean) | undefined;
   lockProvider?: { requestLock: () => void; exitLock: () => void } | undefined;
+  focus?: boolean | undefined;
 }): {
   backend: ReturnType<typeof attachBrowserInputBackend>['backend'];
   fireClick(): void;
@@ -68,7 +69,7 @@ function buildEnvForClickTest(opts?: {
   const doc = {
     ...makeTarget('document'),
     hasFocus() {
-      return true;
+      return opts?.focus ?? true;
     },
     visibilityState: 'visible',
     get pointerLockElement() {
@@ -144,6 +145,12 @@ describe('browser-backend-lock-gate.test.ts (w2)', () => {
       expect(env.backend.sample().pointerLocked).toBe(false); // pointerlockchange not fired yet
     });
 
+    it('does not add a silent focus gate to a trusted click', () => {
+      const env = buildEnvForClickTest({ focus: false, hostPredicate: () => true });
+      env.fireClick();
+      expect(env.requestPointerLockCalls.count).toBe(1);
+    });
+
     it('gameGate=true (default), hostPredicate=false -> no lock', () => {
       const env = buildEnvForClickTest({
         hostPredicate: () => false,

package/src/__tests__/browser-edge-latch.browser.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { userEvent } from 'vitest/browser';
+import { attachBrowserInputBackend } from '../browser-backend';
+
+describe('browser edge latch (real Chromium)', () => {
+  it('keeps trusted low-frequency down/up edges until the next sample', async () => {
+    const canvas = document.createElement('canvas');
+    canvas.width = 320;
+    canvas.height = 200;
+    canvas.tabIndex = 0;
+    document.body.append(canvas);
+    const handle = attachBrowserInputBackend(canvas, {
+      pointerLockAllowed: () => false,
+    });
+    try {
+      // This is a real Playwright user click. The gate is disabled so the
+      // fixture does not request a browser pointer lock as a side effect.
+      await userEvent.click(canvas);
+      handle.backend.sample();
+
+      // A single user-level key interaction produces both DOM events before
+      // the deliberately delayed frame-start sample.
+      await userEvent.keyboard('a');
+      const sample = handle.backend.sample();
+      expect(sample.downKeys.has('a')).toBe(false);
+      expect(sample.upKeys.has('a')).toBe(true);
+      expect(sample.pressedKeys?.has('a')).toBe(true);
+      expect(sample.downCodes?.has('KeyA')).toBe(false);
+      expect(sample.upCodes?.has('KeyA')).toBe(true);
+      expect(sample.pressedCodes?.has('KeyA')).toBe(true);
+
+      const next = handle.backend.sample();
+      expect(next.pressedKeys?.size).toBe(0);
+      expect(next.upKeys.size).toBe(0);
+      expect(next.pressedCodes?.size).toBe(0);
+      expect(next.upCodes?.size).toBe(0);
+    } finally {
+      handle();
+      canvas.remove();
+    }
+  });
+});

package/src/__tests__/composite-backend.test.ts

@@ -257,6 +257,24 @@ describe('CompositeInputBackend merge semantics', () => {
     expect(s.upKeys.has('a')).toBe(true);
   });
 
+  it('clearInjected drops pending press/release latches without ghost edges', () => {
+    const inner = fakeInner();
+    const c = makeCompositeBackend(inner);
+    c.press('w');
+    c.setButton(0, true);
+    c.release('w');
+    c.setButton(0, false);
+    c.clearInjected();
+
+    const sample = c.sample();
+    expect(sample.downKeys.size).toBe(0);
+    expect(sample.upKeys.size).toBe(0);
+    expect(sample.pressedKeys).toBeUndefined();
+    expect(sample.buttons).toEqual([false, false, false]);
+    expect(sample.pressedButtons).toBeUndefined();
+    expect(sample.releasedButtons).toBeUndefined();
+  });
+
   it('forwards setPointerLockAllowed and detach to inner', () => {
     let allowed: boolean | undefined;
     let detached = false;

package/src/__tests__/input-snapshot.test.ts

@@ -47,6 +47,25 @@ describe('keyboard snapshot edges', () => {
     expect(snap.keyboard.downCode('KeyA')).toBe(true);
     expect(snap.keyboard.justPressedCode('KeyA')).toBe(true);
   });
+
+  it('uses producer-latched press edges even when held state is already released', () => {
+    const snap = snapshotFromSample({
+      ...sample([], ['a'], [], ['KeyA']),
+      pressedKeys: new Set(['a']),
+      pressedCodes: new Set(['KeyA']),
+    });
+
+    expect(snap.keyboard.down('a')).toBe(false);
+    expect(snap.keyboard.up('a')).toBe(true);
+    expect(snap.keyboard.justPressed('a')).toBe(true);
+    expect(snap.keyboard.downCode('KeyA')).toBe(false);
+    expect(snap.keyboard.upCode('KeyA')).toBe(true);
+    expect(snap.keyboard.justPressedCode('KeyA')).toBe(true);
+
+    const next = snapshotFromSample(sample([]), undefined, undefined, snap);
+    expect(next.keyboard.justPressed('a')).toBe(false);
+    expect(next.keyboard.up('a')).toBe(false);
+  });
 });
 
 describe('empty backend sample ownership', () => {
@@ -93,4 +112,20 @@ describe('mouse snapshot edges', () => {
     expect(released.mouse.button(0)).toBe(false);
     expect(released.mouse.justReleased(0)).toBe(true);
   });
+
+  it('preserves a producer-latched button tap between frame-start scans', () => {
+    const tap = snapshotFromSample({
+      ...sample([]),
+      pressedButtons: [true, false, false],
+      releasedButtons: [true, false, false],
+    });
+
+    expect(tap.mouse.button(0)).toBe(false);
+    expect(tap.mouse.justPressed(0)).toBe(true);
+    expect(tap.mouse.justReleased(0)).toBe(true);
+
+    const next = snapshotFromSample(sample([]), undefined, undefined, tap);
+    expect(next.mouse.justPressed(0)).toBe(false);
+    expect(next.mouse.justReleased(0)).toBe(false);
+  });
 });

package/src/__tests__/pointer-lock.browser.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from 'vitest';
+import { userEvent } from 'vitest/browser';
+import { attachBrowserInputBackend } from '../browser-backend';
+
+describe('pointer lock recovery (real Chromium)', () => {
+  it('attempts a trusted click even when hasFocus is false and contains rejection/error events', async () => {
+    const canvas = document.createElement('canvas');
+    canvas.dataset.testid = 'pointer-lock-target';
+    document.body.append(canvas);
+    const originalFocus = Object.getOwnPropertyDescriptor(document, 'hasFocus');
+    const originalRequest = Object.getOwnPropertyDescriptor(canvas, 'requestPointerLock');
+    const errors: Array<{ path: 'w3c' | 'provider'; cause: unknown }> = [];
+    const unhandled: unknown[] = [];
+    let requestCalls = 0;
+    const rejection = new DOMException('Pointer lock denied', 'NotAllowedError');
+    Object.defineProperty(document, 'hasFocus', {
+      configurable: true,
+      value: () => false,
+    });
+    Object.defineProperty(canvas, 'requestPointerLock', {
+      configurable: true,
+      value: () => {
+        requestCalls += 1;
+        return Promise.reject(rejection);
+      },
+    });
+    const onUnhandled = (event: PromiseRejectionEvent): void => {
+      event.preventDefault();
+      unhandled.push(event.reason);
+    };
+    window.addEventListener('unhandledrejection', onUnhandled);
+    const handle = attachBrowserInputBackend(canvas, {
+      onLockError: (detail) => errors.push(detail),
+    });
+    try {
+      // userEvent delegates to Playwright's locator click, preserving the
+      // trusted user-activation boundary required by Pointer Lock.
+      await userEvent.click(canvas);
+      await new Promise((resolve) => setTimeout(resolve, 0));
+      expect(requestCalls).toBe(1);
+      expect(errors[0]).toMatchObject({ path: 'w3c', cause: rejection });
+      expect(unhandled).toEqual([]);
+
+      const browserEvent = new Event('pointerlockerror');
+      document.dispatchEvent(browserEvent);
+      expect(errors[1]).toMatchObject({ path: 'w3c', cause: browserEvent });
+      expect(handle.backend.sample().pointerLocked).toBe(false);
+    } finally {
+      handle();
+      window.removeEventListener('unhandledrejection', onUnhandled);
+      if (originalFocus === undefined) delete (document as { hasFocus?: unknown }).hasFocus;
+      else Object.defineProperty(document, 'hasFocus', originalFocus);
+      if (originalRequest === undefined)
+        delete (canvas as { requestPointerLock?: unknown }).requestPointerLock;
+      else Object.defineProperty(canvas, 'requestPointerLock', originalRequest);
+      canvas.remove();
+    }
+  });
+});