@yagejs/input 0.3.0 → 0.5.0

package/dist/api.cjs

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api.ts
+var api_exports = {};
+__export(api_exports, {
+  InputManagerKey: () => InputManagerKey
+});
+module.exports = __toCommonJS(api_exports);
+
+// src/types.ts
+var import_core = require("@yagejs/core");
+var InputManagerKey = new import_core.ServiceKey("inputManager");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InputManagerKey
+});
+//# sourceMappingURL=api.cjs.map

package/dist/api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.ts","../src/types.ts"],"sourcesContent":["export { InputManagerKey } from \"./types.js\";\nexport type {\n  InputConfig,\n  GamepadInfo,\n  GamepadAxisKey,\n  PointerInfo,\n  PointerType,\n} from \"./types.js\";\n","import { ServiceKey } from \"@yagejs/core\";\nimport type { RendererAdapter, Vec2 } from \"@yagejs/core\";\nimport type { InputManager } from \"./InputManager.js\";\n\n/** Service key for the InputManager. */\nexport const InputManagerKey = new ServiceKey<InputManager>(\"inputManager\");\n\n/** Minimal camera surface needed by InputManager for pointer world-coord conversion. */\nexport interface CameraLike {\n  screenToWorld(screenX: number, screenY: number): { x: number; y: number };\n}\n\n/**\n * Minimal renderer surface needed by InputPlugin for canvas access and\n * coordinate mapping. Alias of the cross-package `RendererAdapter` contract.\n */\nexport type RendererLike = RendererAdapter;\n\n/** Configuration for the InputPlugin. */\nexport interface InputConfig {\n  /** Target element for pointer events (default: canvas from renderer, or document). */\n  target?: HTMLElement;\n  /** Action map: action name -> array of physical key codes. */\n  actions?: ActionMapDefinition;\n  /** Input groups: group name -> array of action names belonging to it. */\n  groups?: Record<string, string[]>;\n  /** Key codes to call preventDefault() on (default: none). */\n  preventDefaultKeys?: string[];\n  /**\n   * Optional override for the renderer service key. When omitted, InputPlugin\n   * auto-resolves `RendererAdapterKey` — the canonical `@yagejs/renderer`\n   * plugin registers itself under that key, so pointer events target its\n   * canvas and coordinates route through `canvasToVirtual` out of the box.\n   * Set this only if you ship a custom renderer registered under a different\n   * key.\n   */\n  rendererKey?: ServiceKey<RendererAdapter>;\n  /** Deadzone thresholds for analog inputs. */\n  deadzones?: {\n    /** Radial deadzone applied to stick magnitude (default 0.15). */\n    stick?: number;\n    /** Lower deadzone for trigger analog values (default 0.05). */\n    trigger?: number;\n  };\n  /**\n   * Trigger value at which `GamepadLT`/`GamepadRT` fire as button edges in the\n   * action map (default 0.5). Below this, the trigger remains \"released\" for\n   * `isPressed` purposes; the analog `getTrigger` value is unaffected.\n   */\n  triggerThreshold?: number;\n  /**\n   * Whether to poll `navigator.getGamepads()` each frame (default `true`).\n   * Disable to use only synthetic input via `fireGamepadButton`/`fireGamepadAxis`\n   * — useful for inspector probes that want deterministic state.\n   */\n  pollGamepads?: boolean;\n  /**\n   * Invert vertical scroll so positive `dy` means up (default `false`,\n   * matching the W3C convention where positive `deltaY` is \"scroll content\n   * down\"). Affects both `onWheel` callbacks and `WheelUp/Down` action edges.\n   */\n  wheelInvertY?: boolean;\n  /**\n   * Call `preventDefault()` on incoming wheel events so the page does not\n   * scroll. Default `false` — opt in only if your game canvas should swallow\n   * scroll. The listener is attached as `{ passive: false }` when this is\n   * enabled so `preventDefault()` actually takes effect.\n   */\n  preventDefaultWheel?: boolean;\n}\n\n/** Information about a connected gamepad. */\nexport interface GamepadInfo {\n  /** Index in `navigator.getGamepads()`. May change if pads are hot-swapped. */\n  index: number;\n  /** Browser-reported gamepad identifier (vendor + product). */\n  id: string;\n}\n\n/**\n * Named gamepad analog axis. Sticks are exposed per axis (`leftX`/`leftY`,\n * etc.); triggers (`leftTrigger`/`rightTrigger`) carry the W3C\n * `GamepadButton.value` for buttons 6/7 under standard mapping.\n */\nexport type GamepadAxisKey =\n  | \"leftX\"\n  | \"leftY\"\n  | \"rightX\"\n  | \"rightY\"\n  | \"leftTrigger\"\n  | \"rightTrigger\";\n\n/**\n * Class of physical pointer device. Sourced from `PointerEvent.pointerType` on\n * real input; defaults to `\"mouse\"` for synthetic injection.\n */\nexport type PointerType = \"mouse\" | \"pen\" | \"touch\";\n\n/**\n * Read-only view of a tracked pointer. Returned from {@link InputManager.getPointers}\n * and the per-pointer event hooks. Treat as immutable — fields reflect the\n * pointer's state at query time and are not retained between frames.\n */\nexport interface PointerInfo {\n  /** Browser-assigned `PointerEvent.pointerId`, or the synthetic id passed via `firePointer*`. */\n  readonly id: number;\n  /** Position in screen-space pixels (already routed through `canvasToVirtual` if available). */\n  readonly screenPos: Vec2;\n  /** Source device class. */\n  readonly type: PointerType;\n  /** Whether the browser flagged this as the primary pointer (`PointerEvent.isPrimary`). */\n  readonly isPrimary: boolean;\n  /** Currently-held button indices (0=left/primary, 1=middle, 2=right). */\n  readonly buttons: ReadonlySet<number>;\n  /** Convenience mirror of `buttons.size > 0`. */\n  readonly isDown: boolean;\n}\n\n/**\n * Per-event payload assembled by {@link InputPlugin} from each `PointerEvent`\n * (or by `firePointer*` for synthetic injection) and forwarded to the manager's\n * internal pointer handlers.\n *\n * @internal\n */\nexport interface PointerEventInfo {\n  id: number;\n  screenX: number;\n  screenY: number;\n  type: PointerType;\n  isPrimary: boolean;\n  /**\n   * The button whose state changed for this event. `-1` for events that don't\n   * change button state (move-only). Down/up handlers ignore `-1`.\n   */\n  button: number;\n}\n\n/** Maps action names to arrays of physical key codes. */\nexport type ActionMapDefinition = Record<string, string[]>;\n\n/** How to handle a conflict when rebinding a key already used by another action in the same group. */\nexport type InputConflictPolicy = \"replace\" | \"keep-both\" | \"reject\";\n\n/** Options for {@link InputManager.rebind}. */\nexport interface RebindOptions {\n  /** Index of the binding slot to replace. Appends if the slot does not exist. */\n  slot?: number;\n  /** How to resolve conflicts with other actions in the same group(s). Default: `\"reject\"`. */\n  conflict?: InputConflictPolicy;\n}\n\n/** Result of a {@link InputManager.rebind} call. */\nexport interface RebindResult {\n  /** Whether the rebind succeeded. */\n  ok: boolean;\n  /** Present when `ok` is false due to a conflict with `conflict: \"reject\"`. */\n  conflict?: { action: string; key: string };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAA2B;AAKpB,IAAM,kBAAkB,IAAI,uBAAyB,cAAc;","names":[]}

package/dist/api.d.cts

@@ -0,0 +1,2 @@
+export { G as GamepadAxisKey, a as GamepadInfo, I as InputConfig, d as InputManagerKey, P as PointerInfo, e as PointerType } from './api-BaItBbSe.cjs';
+import '@yagejs/core';

package/dist/api.d.ts

@@ -0,0 +1,2 @@
+export { G as GamepadAxisKey, a as GamepadInfo, I as InputConfig, d as InputManagerKey, P as PointerInfo, e as PointerType } from './api-BaItBbSe.js';
+import '@yagejs/core';

package/dist/api.js

@@ -0,0 +1,7 @@
+import {
+  InputManagerKey
+} from "./chunk-O2U7FZ7Q.js";
+export {
+  InputManagerKey
+};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-O2U7FZ7Q.js

@@ -0,0 +1,12 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/types.ts
+import { ServiceKey } from "@yagejs/core";
+var InputManagerKey = new ServiceKey("inputManager");
+
+export {
+  __name,
+  InputManagerKey
+};
+//# sourceMappingURL=chunk-O2U7FZ7Q.js.map

package/dist/chunk-O2U7FZ7Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { ServiceKey } from \"@yagejs/core\";\nimport type { RendererAdapter, Vec2 } from \"@yagejs/core\";\nimport type { InputManager } from \"./InputManager.js\";\n\n/** Service key for the InputManager. */\nexport const InputManagerKey = new ServiceKey<InputManager>(\"inputManager\");\n\n/** Minimal camera surface needed by InputManager for pointer world-coord conversion. */\nexport interface CameraLike {\n  screenToWorld(screenX: number, screenY: number): { x: number; y: number };\n}\n\n/**\n * Minimal renderer surface needed by InputPlugin for canvas access and\n * coordinate mapping. Alias of the cross-package `RendererAdapter` contract.\n */\nexport type RendererLike = RendererAdapter;\n\n/** Configuration for the InputPlugin. */\nexport interface InputConfig {\n  /** Target element for pointer events (default: canvas from renderer, or document). */\n  target?: HTMLElement;\n  /** Action map: action name -> array of physical key codes. */\n  actions?: ActionMapDefinition;\n  /** Input groups: group name -> array of action names belonging to it. */\n  groups?: Record<string, string[]>;\n  /** Key codes to call preventDefault() on (default: none). */\n  preventDefaultKeys?: string[];\n  /**\n   * Optional override for the renderer service key. When omitted, InputPlugin\n   * auto-resolves `RendererAdapterKey` — the canonical `@yagejs/renderer`\n   * plugin registers itself under that key, so pointer events target its\n   * canvas and coordinates route through `canvasToVirtual` out of the box.\n   * Set this only if you ship a custom renderer registered under a different\n   * key.\n   */\n  rendererKey?: ServiceKey<RendererAdapter>;\n  /** Deadzone thresholds for analog inputs. */\n  deadzones?: {\n    /** Radial deadzone applied to stick magnitude (default 0.15). */\n    stick?: number;\n    /** Lower deadzone for trigger analog values (default 0.05). */\n    trigger?: number;\n  };\n  /**\n   * Trigger value at which `GamepadLT`/`GamepadRT` fire as button edges in the\n   * action map (default 0.5). Below this, the trigger remains \"released\" for\n   * `isPressed` purposes; the analog `getTrigger` value is unaffected.\n   */\n  triggerThreshold?: number;\n  /**\n   * Whether to poll `navigator.getGamepads()` each frame (default `true`).\n   * Disable to use only synthetic input via `fireGamepadButton`/`fireGamepadAxis`\n   * — useful for inspector probes that want deterministic state.\n   */\n  pollGamepads?: boolean;\n  /**\n   * Invert vertical scroll so positive `dy` means up (default `false`,\n   * matching the W3C convention where positive `deltaY` is \"scroll content\n   * down\"). Affects both `onWheel` callbacks and `WheelUp/Down` action edges.\n   */\n  wheelInvertY?: boolean;\n  /**\n   * Call `preventDefault()` on incoming wheel events so the page does not\n   * scroll. Default `false` — opt in only if your game canvas should swallow\n   * scroll. The listener is attached as `{ passive: false }` when this is\n   * enabled so `preventDefault()` actually takes effect.\n   */\n  preventDefaultWheel?: boolean;\n}\n\n/** Information about a connected gamepad. */\nexport interface GamepadInfo {\n  /** Index in `navigator.getGamepads()`. May change if pads are hot-swapped. */\n  index: number;\n  /** Browser-reported gamepad identifier (vendor + product). */\n  id: string;\n}\n\n/**\n * Named gamepad analog axis. Sticks are exposed per axis (`leftX`/`leftY`,\n * etc.); triggers (`leftTrigger`/`rightTrigger`) carry the W3C\n * `GamepadButton.value` for buttons 6/7 under standard mapping.\n */\nexport type GamepadAxisKey =\n  | \"leftX\"\n  | \"leftY\"\n  | \"rightX\"\n  | \"rightY\"\n  | \"leftTrigger\"\n  | \"rightTrigger\";\n\n/**\n * Class of physical pointer device. Sourced from `PointerEvent.pointerType` on\n * real input; defaults to `\"mouse\"` for synthetic injection.\n */\nexport type PointerType = \"mouse\" | \"pen\" | \"touch\";\n\n/**\n * Read-only view of a tracked pointer. Returned from {@link InputManager.getPointers}\n * and the per-pointer event hooks. Treat as immutable — fields reflect the\n * pointer's state at query time and are not retained between frames.\n */\nexport interface PointerInfo {\n  /** Browser-assigned `PointerEvent.pointerId`, or the synthetic id passed via `firePointer*`. */\n  readonly id: number;\n  /** Position in screen-space pixels (already routed through `canvasToVirtual` if available). */\n  readonly screenPos: Vec2;\n  /** Source device class. */\n  readonly type: PointerType;\n  /** Whether the browser flagged this as the primary pointer (`PointerEvent.isPrimary`). */\n  readonly isPrimary: boolean;\n  /** Currently-held button indices (0=left/primary, 1=middle, 2=right). */\n  readonly buttons: ReadonlySet<number>;\n  /** Convenience mirror of `buttons.size > 0`. */\n  readonly isDown: boolean;\n}\n\n/**\n * Per-event payload assembled by {@link InputPlugin} from each `PointerEvent`\n * (or by `firePointer*` for synthetic injection) and forwarded to the manager's\n * internal pointer handlers.\n *\n * @internal\n */\nexport interface PointerEventInfo {\n  id: number;\n  screenX: number;\n  screenY: number;\n  type: PointerType;\n  isPrimary: boolean;\n  /**\n   * The button whose state changed for this event. `-1` for events that don't\n   * change button state (move-only). Down/up handlers ignore `-1`.\n   */\n  button: number;\n}\n\n/** Maps action names to arrays of physical key codes. */\nexport type ActionMapDefinition = Record<string, string[]>;\n\n/** How to handle a conflict when rebinding a key already used by another action in the same group. */\nexport type InputConflictPolicy = \"replace\" | \"keep-both\" | \"reject\";\n\n/** Options for {@link InputManager.rebind}. */\nexport interface RebindOptions {\n  /** Index of the binding slot to replace. Appends if the slot does not exist. */\n  slot?: number;\n  /** How to resolve conflicts with other actions in the same group(s). Default: `\"reject\"`. */\n  conflict?: InputConflictPolicy;\n}\n\n/** Result of a {@link InputManager.rebind} call. */\nexport interface RebindResult {\n  /** Whether the rebind succeeded. */\n  ok: boolean;\n  /** Present when `ok` is false due to a conflict with `conflict: \"reject\"`. */\n  conflict?: { action: string; key: string };\n}\n"],"mappings":";;;;AAAA,SAAS,kBAAkB;AAKpB,IAAM,kBAAkB,IAAI,WAAyB,cAAc;","names":[]}