@diffenderfer-games/hub 2.0.0-next.0 → 2.0.0-next.1

package/src/globals.ts

@@ -1,110 +1,115 @@
-/**
- * Page-wide singletons across client versions (plan §4.4). One page often
- * runs two client builds: the game's bundled copy and the host's injected
- * `/_hub/hub.js`. The input system, daily challenges and the realtime API
- * must exist once per page, so each is registered here with the version that
- * created it and a small `api` number that changes only when the
- * cross-bundle shape does.
- *
- * - Same `api`: the first creator wins and everyone shares it.
- * - Different `api`: the caller decides who owns the page (see
- *   {@link claimSingleton}'s `onMismatch`); the mismatch is logged once with the fix.
- * - The v1 names (`window.__HUB_INPUT__`, `__HUB_DAILY__`, `__HUB_RT__`) stay as
- *   aliases while vendored v1 copies are still around.
- */
-
-/** A page-wide singleton's name. */
-export type SingletonName = 'input' | 'daily' | 'rt';
-
-/** One registered singleton. */
-export interface SingletonRecord {
-  /** The client version that created it. */
-  readonly version: string;
-  /** Its cross-bundle shape number. */
-  readonly api: number;
-  /** The instance itself; another bundle's object, so callers check it before use. */
-  // eslint-disable-next-line no-restricted-syntax -- trust boundary: the instance may come from another bundle on the page
-  readonly instance: unknown;
-}
-
-/** The registry on `window.__DG__`. */
-export type DgGlobals = { [K in SingletonName]?: SingletonRecord };
-
-/** The v1 window names, kept as aliases. */
-export const LEGACY_GLOBAL_NAMES = { input: '__HUB_INPUT__', daily: '__HUB_DAILY__', rt: '__HUB_RT__' } as const satisfies Record<SingletonName, string>;
-
-declare global {
-  interface Window {
-    __DG__?: DgGlobals;
-    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
-    __HUB_INPUT__?: unknown;
-    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
-    __HUB_DAILY__?: unknown;
-    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
-    __HUB_RT__?: unknown;
-  }
-}
-
-/** How to claim a singleton. */
-export interface SingletonClaim<T> {
-  readonly name: SingletonName;
-  /** This bundle's client version. */
-  readonly version: string;
-  /** This bundle's shape number for the singleton. */
-  readonly api: number;
-  /** Make the instance when nobody has yet. */
-  readonly create: () => T;
-  /** Whether a registered instance is usable as `T` (it may come from another bundle). */
-  // eslint-disable-next-line no-restricted-syntax -- trust boundary: checks another bundle's object
-  readonly isInstance: (candidate: unknown) => candidate is T;
-  /**
-   * The registered one has a different `api`: return `true` to replace it
-   * with this bundle's instance, `false` to keep it (then `create` makes a
-   * private instance for this bundle only). Default: keep it.
-   */
-  readonly onMismatch?: (registered: SingletonRecord) => boolean;
-}
-
-const warnedMismatches = new Set<SingletonName>();
-
-/** The page registry, created on first use (`undefined` outside a browser). */
-function registryOf(page: Window | undefined): DgGlobals | undefined {
-  if (page === undefined) {
-    return undefined;
-  }
-  page.__DG__ ??= {};
-  return page.__DG__;
-}
-
-/** Register (or join) a page-wide singleton and return the instance this bundle should use. */
-export function claimSingleton<T>(claim: SingletonClaim<T>): T {
-  const page = typeof window === 'undefined' ? undefined : window;
-  const registry = registryOf(page);
-  if (page === undefined || registry === undefined) {
-    return claim.create();
-  }
-  const registered = registry[claim.name];
-  if (registered !== undefined && claim.isInstance(registered.instance)) {
-    if (registered.api === claim.api) {
-      return registered.instance;
-    }
-    if (!warnedMismatches.has(claim.name)) {
-      warnedMismatches.add(claim.name);
-      // eslint-disable-next-line no-console -- the plan's one-time warning to the game developer, with the fix
-      console.warn(`[hub] two clients on this page disagree on "${claim.name}" (v${registered.version} api ${String(registered.api)}, v${claim.version} api ${String(claim.api)}). Fix: npm update @diffenderfer-games/hub`);
-    }
-    if (claim.onMismatch?.(registered) !== true) {
-      return claim.create();
-    }
-  } else {
-    const legacy = page[LEGACY_GLOBAL_NAMES[claim.name]];
-    if (registered === undefined && claim.isInstance(legacy)) {
-      // A v1 vendored copy got there first: share it, as v1 bundles did.
-      return legacy;
-    }
-  }
-  const instance = claim.create();
-  registry[claim.name] = { version: claim.version, api: claim.api, instance };
-  page[LEGACY_GLOBAL_NAMES[claim.name]] = instance;
-  return instance;
-}
+/**
+ * Page-wide singletons across client versions (plan §4.4). One page often
+ * runs two client builds: the game's bundled copy and the host's injected
+ * `/_hub/hub.js`. The input system, daily challenges and the realtime API
+ * must exist once per page, so each is registered here with the version that
+ * created it and a small `api` number that changes only when the
+ * cross-bundle shape does.
+ *
+ * - Same `api`: the first creator wins and everyone shares it.
+ * - Different `api`: the caller decides who owns the page (see
+ *   {@link claimSingleton}'s `onMismatch`); the mismatch is logged once with the fix.
+ * - The v1 names (`window.__HUB_INPUT__`, `__HUB_DAILY__`, `__HUB_RT__`) stay as
+ *   aliases while vendored v1 copies are still around.
+ */
+
+/** A page-wide singleton's name. */
+export type SingletonName = 'input' | 'daily' | 'rt';
+
+/** One registered singleton. */
+export interface SingletonRecord {
+  /** The client version that created it. */
+  readonly version: string;
+  /** Its cross-bundle shape number. */
+  readonly api: number;
+  /** The instance itself; another bundle's object, so callers check it before use. */
+  // eslint-disable-next-line no-restricted-syntax -- trust boundary: the instance may come from another bundle on the page
+  readonly instance: unknown;
+}
+
+/** The registry on `window.__DG__`. */
+export type DgGlobals = { [K in SingletonName]?: SingletonRecord };
+
+/** The version recorded for a singleton adopted from a v1 (vendored) client, which predates the registry. */
+export const V1_CLIENT_VERSION = 'v1';
+
+/** The v1 window names, kept as aliases. */
+export const LEGACY_GLOBAL_NAMES = { input: '__HUB_INPUT__', daily: '__HUB_DAILY__', rt: '__HUB_RT__' } as const satisfies Record<SingletonName, string>;
+
+declare global {
+  interface Window {
+    __DG__?: DgGlobals;
+    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
+    __HUB_INPUT__?: unknown;
+    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
+    __HUB_DAILY__?: unknown;
+    // eslint-disable-next-line no-restricted-syntax -- trust boundary: set by any bundle on the page, including v1 copies
+    __HUB_RT__?: unknown;
+  }
+}
+
+/** How to claim a singleton. */
+export interface SingletonClaim<T> {
+  readonly name: SingletonName;
+  /** This bundle's client version. */
+  readonly version: string;
+  /** This bundle's shape number for the singleton. */
+  readonly api: number;
+  /** Make the instance when nobody has yet. */
+  readonly create: () => T;
+  /** Whether a registered instance is usable as `T` (it may come from another bundle). */
+  // eslint-disable-next-line no-restricted-syntax -- trust boundary: checks another bundle's object
+  readonly isInstance: (candidate: unknown) => candidate is T;
+  /**
+   * The registered one has a different `api`: return `true` to replace it
+   * with this bundle's instance, `false` to keep it (then `create` makes a
+   * private instance for this bundle only). Default: keep it.
+   */
+  readonly onMismatch?: (registered: SingletonRecord) => boolean;
+}
+
+const warnedMismatches = new Set<SingletonName>();
+
+/** The page registry, created on first use (`undefined` outside a browser). */
+function registryOf(page: Window | undefined): DgGlobals | undefined {
+  if (page === undefined) {
+    return undefined;
+  }
+  page.__DG__ ??= {};
+  return page.__DG__;
+}
+
+/** Register (or join) a page-wide singleton and return the instance this bundle should use. */
+export function claimSingleton<T>(claim: SingletonClaim<T>): T {
+  const page = typeof window === 'undefined' ? undefined : window;
+  const registry = registryOf(page);
+  if (page === undefined || registry === undefined) {
+    return claim.create();
+  }
+  const registered = registry[claim.name];
+  if (registered !== undefined && claim.isInstance(registered.instance)) {
+    if (registered.api === claim.api) {
+      return registered.instance;
+    }
+    if (!warnedMismatches.has(claim.name)) {
+      warnedMismatches.add(claim.name);
+      // eslint-disable-next-line no-console -- the plan's one-time warning to the game developer, with the fix
+      console.warn(`[hub] two clients on this page disagree on "${claim.name}" (v${registered.version} api ${String(registered.api)}, v${claim.version} api ${String(claim.api)}). Fix: npm update @diffenderfer-games/hub`);
+    }
+    if (claim.onMismatch?.(registered) !== true) {
+      return claim.create();
+    }
+  } else {
+    const legacy = page[LEGACY_GLOBAL_NAMES[claim.name]];
+    if (registered === undefined && claim.isInstance(legacy)) {
+      // A v1 vendored copy got there first: share it, as v1 bundles did, and
+      // record it so later bundles (and diagnostics) see which client owns it.
+      registry[claim.name] = { version: V1_CLIENT_VERSION, api: claim.api, instance: legacy };
+      return legacy;
+    }
+  }
+  const instance = claim.create();
+  registry[claim.name] = { version: claim.version, api: claim.api, instance };
+  page[LEGACY_GLOBAL_NAMES[claim.name]] = instance;
+  return instance;
+}

package/src/index.ts

@@ -1,50 +1,50 @@
-/**
- * `@diffenderfer-games/hub`: the hub client for games on diffenderfer.games.
- *
- * ```ts
- * import { hub } from '@diffenderfer-games/hub';
- *
- * const { user } = await hub.me();
- * await hub.putSave('auto', { level: 7, gold: 120 });
- * await hub.submitScore('highscore', 9001, { title: 'High Score' });
- * ```
- *
- * In a hosted game the slug and API base are detected from the page; use
- * {@link createHub} for others. Every call rejects with a {@link HubError}
- * when it fails, except the fire-and-forget analytics (`recordPlay`,
- * `heartbeat`, `event`). When the hub can't be reached, reads come from an
- * offline cache and writes are queued until it is back.
- *
- * The page-wide namespaces hang off `hub` as lazy getters (`hub.input`,
- * `hub.daily`, `hub.social`, `hub.mp`, `hub.rooms`, `hub.race`), and each has
- * its own entry (`@diffenderfer-games/hub/input`, ...) for games that want
- * only that part.
- *
- * @packageDocumentation
- */
-export { createHub, Hub, hub } from './core/hub';
-export {
-  ContentRejectedError,
-  HubError,
-  OfflineError,
-  UNSUPPORTED_BY_HUB,
-  type HubErrorCode,
-  type HubErrorDetails,
-} from './core/errors';
-export type { SyncConflict, SyncResult } from './core/connection';
-export type { AuthResponse, ProfileUpdate, StatResult } from './core/hub-progress';
-export type { GrantBundle, TradeBundle, TradeId, TradeListOptions, TradeNoteOptions } from './core/hub-economy';
-export type { HubMenuControl } from './core/menu-control';
-export type { QueueOp, QueueOpInput, QueuedScoreOptions, ProfilePatch } from './core/offline/queue';
-export type { BufferedEvent } from './core/offline/events';
-export type { EndpointFields, EndpointName, EndpointReply } from './core/rest/endpoint-types';
-export { CLIENT_VERSION_HEADER } from './core/rest/rest-client';
-export type { ClientSupport } from './core/version/hub-version';
-export { HUB_CLIENT_VERSION } from './core/version/client-version.gen';
-export type * from './core/types';
-export * from './daily';
-export * from './input';
-export type * from './social';
-export type * from './mp';
-export type * from './race';
-export type * from './rooms';
+/**
+ * `@diffenderfer-games/hub`: the hub client for games on diffenderfer.games.
+ *
+ * ```ts
+ * import { hub } from '@diffenderfer-games/hub';
+ *
+ * const { user } = await hub.me();
+ * await hub.putSave('auto', { level: 7, gold: 120 });
+ * await hub.submitScore('highscore', 9001, { title: 'High Score' });
+ * ```
+ *
+ * In a hosted game the slug and API base are detected from the page; use
+ * {@link createHub} for others. Every call rejects with a {@link HubError}
+ * when it fails, except the fire-and-forget analytics (`recordPlay`,
+ * `heartbeat`, `event`). When the hub can't be reached, reads come from an
+ * offline cache and writes are queued until it is back.
+ *
+ * The page-wide namespaces hang off `hub` as lazy getters (`hub.input`,
+ * `hub.daily`, `hub.social`, `hub.mp`, `hub.rooms`, `hub.race`), and each has
+ * its own entry (`@diffenderfer-games/hub/input`, ...) for games that want
+ * only that part.
+ *
+ * @packageDocumentation
+ */
+export { createHub, Hub, hub } from './core/hub';
+export {
+  ContentRejectedError,
+  HubError,
+  OfflineError,
+  UNSUPPORTED_BY_HUB,
+  type HubErrorCode,
+  type HubErrorDetails,
+} from './core/errors';
+export type { SyncConflict, SyncResult } from './core/connection';
+export type { AuthResponse, ProfileUpdate, StatResult } from './core/hub-progress';
+export type { GrantBundle, TradeBundle, TradeId, TradeListOptions, TradeNoteOptions } from './core/hub-economy';
+export type { HubMenuControl } from './core/menu-control';
+export type { QueueOp, QueueOpInput, QueuedScoreOptions, ProfilePatch } from './core/offline/queue';
+export type { BufferedEvent } from './core/offline/events';
+export type { EndpointFields, EndpointName, EndpointReply } from './core/rest/endpoint-types';
+export { CLIENT_VERSION_HEADER } from './core/rest/rest-client';
+export type { ClientSupport } from './core/version/hub-version';
+export { HUB_CLIENT_VERSION } from './core/version/client-version.gen';
+export type * from './core/types';
+export * from './daily';
+export * from './input';
+export type * from './social';
+export type * from './mp';
+export type * from './race';
+export type * from './rooms';

package/src/input/device-state.ts

@@ -1,146 +1,146 @@
-/**
- * The raw state of every input device, updated by DOM events and sampled once
- * per frame: held keys and mouse buttons, the pointer, movement and wheel
- * accumulators, one-frame pulses, on-screen sticks and buttons, and gamepads.
- */
-import { AXIS_DEADZONE, readGamepads } from './gamepad';
-
-/** An on-screen stick's output, -1..1 per axis. */
-export interface StickOutput {
-  outX: number;
-  outY: number;
-}
-
-/** A 2D accumulator. */
-interface Delta {
-  dx: number;
-  dy: number;
-}
-
-/** Keys that scroll the page; cancelled during play (not while typing). */
-const SCROLL_KEYS = new Set([' ', 'arrowup', 'arrowdown', 'arrowleft', 'arrowright']);
-
-/** Input types that don't take text (buttons, checkboxes, sliders…). */
-const NON_TEXT_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'checkbox', 'radio', 'range', 'color', 'file', 'image']);
-
-/** Whether typing in `target` owns Space and the arrow keys. */
-export function isTypingTarget(target: EventTarget | null): boolean {
-  if (!(target instanceof HTMLElement)) {
-    return false;
-  }
-  if (target.isContentEditable || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement) {
-    return true;
-  }
-  return target instanceof HTMLInputElement && !NON_TEXT_INPUT_TYPES.has(target.type);
-}
-
-/** What the device state reports back to the input system. */
-export interface DeviceStateEvents {
-  /** The mouse moved or clicked: it is the active pointer. */
-  onMouseActivity(): void;
-  /** A gamepad connected (`true`) or disconnected (`false`). */
-  onGamepadConnection(isConnected: boolean): void;
-  /** Whether keydown should cancel scrolling keys (a game defined its inputs). */
-  shouldCancelScrollKeys(): boolean;
-}
-
-/** Raw device state for one page. */
-export class DeviceState {
-  readonly heldKeys = new Set<string>();
-  readonly heldMouseButtons = new Set<number>();
-  readonly pressedVirtualButtons = new Set<string>();
-  readonly sticks = new Map<string, StickOutput>();
-  pointerX = 0;
-  pointerY = 0;
-  readonly movement: Delta = { dx: 0, dy: 0 };
-  readonly wheel: Delta = { dx: 0, dy: 0 };
-  gamepads: Gamepad[] = [];
-  frame = 0;
-  private readonly pulseFrames = new Map<string, number>();
-
-  /** Fire a one-frame pulse (`tap`, `mouse:dbl`). */
-  pulse(name: string): void {
-    this.pulseFrames.set(name, this.frame);
-  }
-
-  /** Whether a pulse fired this frame or the last. */
-  isPulseActive(name: string): boolean {
-    const firedAt = this.pulseFrames.get(name);
-    return firedAt === this.frame || firedAt === this.frame - 1;
-  }
-
-  /** Poll the gamepads. Returns whether any are connected and whether any moved. */
-  pollGamepads(): { isConnected: boolean; hasActivity: boolean } {
-    this.gamepads = readGamepads();
-    const hasActivity = this.gamepads.some((pad) => pad.buttons.some((button) => button.pressed || button.value > 0.5)
-      || pad.axes.some((axis) => Math.abs(axis) > AXIS_DEADZONE));
-    return { isConnected: this.gamepads.length > 0, hasActivity };
-  }
-
-  /** End-of-frame decay of the relative accumulators. */
-  decay(): void {
-    this.movement.dx = 0;
-    this.movement.dy = 0;
-    this.wheel.dx *= 0.6;
-    this.wheel.dy *= 0.6;
-  }
-
-  /** Release everything held (focus loss, hidden tab), so nothing sticks. */
-  releaseAll(): void {
-    this.heldKeys.clear();
-    this.heldMouseButtons.clear();
-    this.pressedVirtualButtons.clear();
-    for (const stick of this.sticks.values()) {
-      stick.outX = 0;
-      stick.outY = 0;
-    }
-  }
-
-  /** Wire the DOM listeners that feed this state. */
-  listen(events: DeviceStateEvents): void {
-    if (typeof window === 'undefined') {
-      return;
-    }
-    window.addEventListener('keydown', (event) => {
-      const key = event.key.toLowerCase();
-      this.heldKeys.add(key);
-      if (events.shouldCancelScrollKeys() && SCROLL_KEYS.has(key) && !isTypingTarget(event.target)) {
-        event.preventDefault();
-      }
-    });
-    window.addEventListener('keyup', (event) => this.heldKeys.delete(event.key.toLowerCase()));
-    window.addEventListener('mousemove', (event) => {
-      this.movement.dx += event.movementX;
-      this.movement.dy += event.movementY;
-      this.pointerX = event.clientX;
-      this.pointerY = event.clientY;
-      events.onMouseActivity();
-    });
-    window.addEventListener('mousedown', (event) => {
-      this.heldMouseButtons.add(event.button);
-      events.onMouseActivity();
-    });
-    window.addEventListener('mouseup', (event) => this.heldMouseButtons.delete(event.button));
-    window.addEventListener('dblclick', () => {
-      this.pulse('mouse:dbl');
-    });
-    window.addEventListener('wheel', (event) => {
-      this.wheel.dx += Math.sign(event.deltaX);
-      this.wheel.dy += Math.sign(event.deltaY);
-    }, { passive: true });
-    window.addEventListener('blur', () => {
-      this.releaseAll();
-    });
-    document.addEventListener('visibilitychange', () => {
-      if (document.hidden) {
-        this.releaseAll();
-      }
-    });
-    window.addEventListener('gamepadconnected', () => {
-      events.onGamepadConnection(true);
-    });
-    window.addEventListener('gamepaddisconnected', () => {
-      events.onGamepadConnection(false);
-    });
-  }
-}
+/**
+ * The raw state of every input device, updated by DOM events and sampled once
+ * per frame: held keys and mouse buttons, the pointer, movement and wheel
+ * accumulators, one-frame pulses, on-screen sticks and buttons, and gamepads.
+ */
+import { AXIS_DEADZONE, readGamepads } from './gamepad';
+
+/** An on-screen stick's output, -1..1 per axis. */
+export interface StickOutput {
+  outX: number;
+  outY: number;
+}
+
+/** A 2D accumulator. */
+interface Delta {
+  dx: number;
+  dy: number;
+}
+
+/** Keys that scroll the page; cancelled during play (not while typing). */
+const SCROLL_KEYS = new Set([' ', 'arrowup', 'arrowdown', 'arrowleft', 'arrowright']);
+
+/** Input types that don't take text (buttons, checkboxes, sliders…). */
+const NON_TEXT_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'checkbox', 'radio', 'range', 'color', 'file', 'image']);
+
+/** Whether typing in `target` owns Space and the arrow keys. */
+export function isTypingTarget(target: EventTarget | null): boolean {
+  if (!(target instanceof HTMLElement)) {
+    return false;
+  }
+  if (target.isContentEditable || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement) {
+    return true;
+  }
+  return target instanceof HTMLInputElement && !NON_TEXT_INPUT_TYPES.has(target.type);
+}
+
+/** What the device state reports back to the input system. */
+export interface DeviceStateEvents {
+  /** The mouse moved or clicked: it is the active pointer. */
+  onMouseActivity(): void;
+  /** A gamepad connected (`true`) or disconnected (`false`). */
+  onGamepadConnection(isConnected: boolean): void;
+  /** Whether keydown should cancel scrolling keys (a game defined its inputs). */
+  shouldCancelScrollKeys(): boolean;
+}
+
+/** Raw device state for one page. */
+export class DeviceState {
+  readonly heldKeys = new Set<string>();
+  readonly heldMouseButtons = new Set<number>();
+  readonly pressedVirtualButtons = new Set<string>();
+  readonly sticks = new Map<string, StickOutput>();
+  pointerX = 0;
+  pointerY = 0;
+  readonly movement: Delta = { dx: 0, dy: 0 };
+  readonly wheel: Delta = { dx: 0, dy: 0 };
+  gamepads: Gamepad[] = [];
+  frame = 0;
+  private readonly pulseFrames = new Map<string, number>();
+
+  /** Fire a one-frame pulse (`tap`, `mouse:dbl`). */
+  pulse(name: string): void {
+    this.pulseFrames.set(name, this.frame);
+  }
+
+  /** Whether a pulse fired this frame or the last. */
+  isPulseActive(name: string): boolean {
+    const firedAt = this.pulseFrames.get(name);
+    return firedAt === this.frame || firedAt === this.frame - 1;
+  }
+
+  /** Poll the gamepads. Returns whether any are connected and whether any moved. */
+  pollGamepads(): { isConnected: boolean; hasActivity: boolean } {
+    this.gamepads = readGamepads();
+    const hasActivity = this.gamepads.some((pad) => pad.buttons.some((button) => button.pressed || button.value > 0.5)
+      || pad.axes.some((axis) => Math.abs(axis) > AXIS_DEADZONE));
+    return { isConnected: this.gamepads.length > 0, hasActivity };
+  }
+
+  /** End-of-frame decay of the relative accumulators. */
+  decay(): void {
+    this.movement.dx = 0;
+    this.movement.dy = 0;
+    this.wheel.dx *= 0.6;
+    this.wheel.dy *= 0.6;
+  }
+
+  /** Release everything held (focus loss, hidden tab), so nothing sticks. */
+  releaseAll(): void {
+    this.heldKeys.clear();
+    this.heldMouseButtons.clear();
+    this.pressedVirtualButtons.clear();
+    for (const stick of this.sticks.values()) {
+      stick.outX = 0;
+      stick.outY = 0;
+    }
+  }
+
+  /** Wire the DOM listeners that feed this state. */
+  listen(events: DeviceStateEvents): void {
+    if (typeof window === 'undefined') {
+      return;
+    }
+    window.addEventListener('keydown', (event) => {
+      const key = event.key.toLowerCase();
+      this.heldKeys.add(key);
+      if (events.shouldCancelScrollKeys() && SCROLL_KEYS.has(key) && !isTypingTarget(event.target)) {
+        event.preventDefault();
+      }
+    });
+    window.addEventListener('keyup', (event) => this.heldKeys.delete(event.key.toLowerCase()));
+    window.addEventListener('mousemove', (event) => {
+      this.movement.dx += event.movementX;
+      this.movement.dy += event.movementY;
+      this.pointerX = event.clientX;
+      this.pointerY = event.clientY;
+      events.onMouseActivity();
+    });
+    window.addEventListener('mousedown', (event) => {
+      this.heldMouseButtons.add(event.button);
+      events.onMouseActivity();
+    });
+    window.addEventListener('mouseup', (event) => this.heldMouseButtons.delete(event.button));
+    window.addEventListener('dblclick', () => {
+      this.pulse('mouse:dbl');
+    });
+    window.addEventListener('wheel', (event) => {
+      this.wheel.dx += Math.sign(event.deltaX);
+      this.wheel.dy += Math.sign(event.deltaY);
+    }, { passive: true });
+    window.addEventListener('blur', () => {
+      this.releaseAll();
+    });
+    document.addEventListener('visibilitychange', () => {
+      if (document.hidden) {
+        this.releaseAll();
+      }
+    });
+    window.addEventListener('gamepadconnected', () => {
+      events.onGamepadConnection(true);
+    });
+    window.addEventListener('gamepaddisconnected', () => {
+      events.onGamepadConnection(false);
+    });
+  }
+}