@yagejs/input 0.2.0 → 0.4.0

package/dist/api-CTGj55Rb.d.cts

@@ -0,0 +1,208 @@
+import { Vec2, ServiceKey, RendererAdapter } from '@yagejs/core';
+
+/** Central input state manager. Resolved via DI with InputManagerKey. */
+declare class InputManager {
+    private pressedKeys;
+    private justPressedKeys;
+    private justReleasedKeys;
+    private holdStart;
+    private syntheticPressedActions;
+    private syntheticActionStarts;
+    private actionMap;
+    private defaultBindings;
+    private groups;
+    private actionGroups;
+    private disabledGroups;
+    private pointerScreenPos;
+    private pointerDownState;
+    private pressedMouseButtons;
+    private gamepadButtons;
+    private gamepadAxes;
+    private camera;
+    private elapsedMs;
+    private listenResolve;
+    /** Whether any key mapped to this action is currently held. */
+    isPressed(action: string): boolean;
+    /** Whether any key mapped to this action was pressed this frame. */
+    isJustPressed(action: string): boolean;
+    /** Whether any key mapped to this action was released this frame. */
+    isJustReleased(action: string): boolean;
+    /** Returns true if any key bound to the action exists in the given set. */
+    private anyKeyInSet;
+    /** Milliseconds the action has been held. Returns 0 if not held. */
+    getHoldDuration(action: string): number;
+    /** Whether the action has been held for at least `minTime` ms. */
+    isHeldFor(action: string, minTime: number): boolean;
+    /** Returns -1, 0, or 1 based on negative/positive action states. */
+    getAxis(negative: string, positive: string): number;
+    /** Returns a Vec2 from four directional actions. Not normalized. */
+    getVector(left: string, right: string, up: string, down: string): Vec2;
+    /** Pointer position in world coordinates (via Camera), or screen coords if no camera. */
+    getPointerPosition(): Vec2;
+    /** Raw pointer position in screen coordinates. */
+    getPointerScreenPosition(): Vec2;
+    /** Whether any pointer button is currently held. */
+    isPointerDown(): boolean;
+    /** Replace the entire action map and store it as the default for {@link resetBindings}. */
+    setActionMap(actions: ActionMapDefinition): void;
+    /** Add a key binding to an action. Creates the action if it doesn't exist. */
+    bindKey(action: string, key: string): void;
+    /** Remove a key binding from an action. */
+    unbindKey(action: string, key: string): void;
+    /** Returns the current key bindings for an action, or an empty array if unmapped. */
+    getBindings(action: string): readonly string[];
+    /** Returns all action names that have the given key bound. */
+    getActionsForKey(key: string): string[];
+    /**
+     * Rebind a key to an action with optional conflict detection.
+     * Conflicts are only detected between actions sharing at least one group.
+     */
+    rebind(action: string, key: string, opts?: RebindOptions): RebindResult;
+    /**
+     * Finds the first action that uses the given key AND shares at least one
+     * group with the target action. Ungrouped actions never conflict.
+     */
+    private findConflictInGroups;
+    /** Reset bindings to defaults. If an action name is provided, only reset that action. */
+    resetBindings(action?: string): void;
+    /** Export the current bindings as a plain object for serialization. */
+    exportBindings(): ActionMapDefinition;
+    /** Load bindings from a plain object. Resets to defaults first, then overlays the provided map. */
+    loadBindings(map: ActionMapDefinition): void;
+    /** Configure input groups. Group name -> array of action names. */
+    setGroups(groups: Record<string, string[]>): void;
+    /** Enable a group by name. */
+    enableGroup(name: string): void;
+    /** Disable a group by name. Actions only in disabled groups become inactive. */
+    disableGroup(name: string): void;
+    /** Set exactly these groups as active; all others are disabled. */
+    setActiveGroups(names: string[]): void;
+    /** Whether a group is currently enabled. Returns true for unknown group names. */
+    isGroupEnabled(name: string): boolean;
+    /** Get all configured group names. */
+    getGroups(): string[];
+    /** Get the action names belonging to a group. Returns empty array for unknown groups. */
+    getGroupActions(name: string): readonly string[];
+    /** Returns true if the action is ungrouped or any of its groups is enabled. */
+    private isActionEnabled;
+    /** Returns a promise that resolves with the next key code pressed. Intercepts the key. */
+    listenForNextKey(): Promise<string | null>;
+    /** Cancel an active {@link listenForNextKey}. Resolves the pending promise with `null`. */
+    cancelListen(): void;
+    /** Public wrapper for synthetic key-down injection. */
+    fireKeyDown(code: string): void;
+    /** Public wrapper for synthetic key-up injection. */
+    fireKeyUp(code: string): void;
+    /** Public wrapper for synthetic pointer movement. */
+    firePointerMove(screenX: number, screenY: number): void;
+    /** Public wrapper for synthetic pointer-button presses. */
+    firePointerDown(button?: 0 | 1 | 2): void;
+    /** Public wrapper for synthetic pointer-button releases. */
+    firePointerUp(button?: 0 | 1 | 2): void;
+    /** Store synthetic gamepad button state. */
+    fireGamepadButton(idx: number, pressed: boolean): void;
+    /** Store synthetic gamepad axis state. */
+    fireGamepadAxis(idx: number, value: number): void;
+    /** Inject a one-frame synthetic action pulse. */
+    fireAction(name: string): void;
+    /** Release all synthetic and physical input state. */
+    clearAll(): void;
+    /** Release any pressed pointer buttons without touching keyboard state. */
+    clearPointerButtons(): void;
+    /** Snapshot of current held input state for inspector tooling. */
+    snapshotState(): {
+        keys: string[];
+        actions: string[];
+        mouse: {
+            x: number;
+            y: number;
+            buttons: number[];
+            down: boolean;
+        };
+        gamepad: {
+            buttons: number[];
+            axes: Array<{
+                index: number;
+                value: number;
+            }>;
+        };
+    };
+    /** @internal */
+    _onKeyDown(code: string): void;
+    /** @internal */
+    _onKeyUp(code: string): void;
+    /** @internal */
+    _onPointerMove(screenX: number, screenY: number): void;
+    /** @internal */
+    _onPointerDown(): void;
+    /** @internal */
+    _onPointerUp(): void;
+    /** @internal Clear per-frame justPressed/justReleased flags. */
+    _clearFrameState(): void;
+    /** Set camera for pointer world-coord conversion. */
+    setCamera(camera: CameraLike): void;
+    /** Clear the camera reference (e.g. on scene exit). */
+    clearCamera(): void;
+    /** Get all configured action names. */
+    getActionNames(): string[];
+    /** @internal Advance the elapsed game-time clock. Called by InputPollSystem. */
+    _advanceTime(dtMs: number): void;
+}
+
+/** Service key for the InputManager. */
+declare const InputManagerKey: ServiceKey<InputManager>;
+/** Minimal camera surface needed by InputManager for pointer world-coord conversion. */
+interface CameraLike {
+    screenToWorld(screenX: number, screenY: number): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Minimal renderer surface needed by InputPlugin for canvas access and
+ * coordinate mapping. Alias of the cross-package `RendererAdapter` contract.
+ */
+type RendererLike = RendererAdapter;
+/** Configuration for the InputPlugin. */
+interface InputConfig {
+    /** Target element for pointer events (default: canvas from renderer, or document). */
+    target?: HTMLElement;
+    /** Action map: action name -> array of physical key codes. */
+    actions?: ActionMapDefinition;
+    /** Input groups: group name -> array of action names belonging to it. */
+    groups?: Record<string, string[]>;
+    /** Key codes to call preventDefault() on (default: none). */
+    preventDefaultKeys?: string[];
+    /**
+     * Optional override for the renderer service key. When omitted, InputPlugin
+     * auto-resolves `RendererAdapterKey` — the canonical `@yagejs/renderer`
+     * plugin registers itself under that key, so pointer events target its
+     * canvas and coordinates route through `canvasToVirtual` out of the box.
+     * Set this only if you ship a custom renderer registered under a different
+     * key.
+     */
+    rendererKey?: ServiceKey<RendererAdapter>;
+}
+/** Maps action names to arrays of physical key codes. */
+type ActionMapDefinition = Record<string, string[]>;
+/** How to handle a conflict when rebinding a key already used by another action in the same group. */
+type InputConflictPolicy = "replace" | "keep-both" | "reject";
+/** Options for {@link InputManager.rebind}. */
+interface RebindOptions {
+    /** Index of the binding slot to replace. Appends if the slot does not exist. */
+    slot?: number;
+    /** How to resolve conflicts with other actions in the same group(s). Default: `"reject"`. */
+    conflict?: InputConflictPolicy;
+}
+/** Result of a {@link InputManager.rebind} call. */
+interface RebindResult {
+    /** Whether the rebind succeeded. */
+    ok: boolean;
+    /** Present when `ok` is false due to a conflict with `conflict: "reject"`. */
+    conflict?: {
+        action: string;
+        key: string;
+    };
+}
+
+export { type ActionMapDefinition as A, type CameraLike as C, type InputConfig as I, type RebindOptions as R, type InputConflictPolicy as a, InputManager as b, InputManagerKey as c, type RebindResult as d, type RendererLike as e };

package/dist/api-CTGj55Rb.d.ts

@@ -0,0 +1,208 @@
+import { Vec2, ServiceKey, RendererAdapter } from '@yagejs/core';
+
+/** Central input state manager. Resolved via DI with InputManagerKey. */
+declare class InputManager {
+    private pressedKeys;
+    private justPressedKeys;
+    private justReleasedKeys;
+    private holdStart;
+    private syntheticPressedActions;
+    private syntheticActionStarts;
+    private actionMap;
+    private defaultBindings;
+    private groups;
+    private actionGroups;
+    private disabledGroups;
+    private pointerScreenPos;
+    private pointerDownState;
+    private pressedMouseButtons;
+    private gamepadButtons;
+    private gamepadAxes;
+    private camera;
+    private elapsedMs;
+    private listenResolve;
+    /** Whether any key mapped to this action is currently held. */
+    isPressed(action: string): boolean;
+    /** Whether any key mapped to this action was pressed this frame. */
+    isJustPressed(action: string): boolean;
+    /** Whether any key mapped to this action was released this frame. */
+    isJustReleased(action: string): boolean;
+    /** Returns true if any key bound to the action exists in the given set. */
+    private anyKeyInSet;
+    /** Milliseconds the action has been held. Returns 0 if not held. */
+    getHoldDuration(action: string): number;
+    /** Whether the action has been held for at least `minTime` ms. */
+    isHeldFor(action: string, minTime: number): boolean;
+    /** Returns -1, 0, or 1 based on negative/positive action states. */
+    getAxis(negative: string, positive: string): number;
+    /** Returns a Vec2 from four directional actions. Not normalized. */
+    getVector(left: string, right: string, up: string, down: string): Vec2;
+    /** Pointer position in world coordinates (via Camera), or screen coords if no camera. */
+    getPointerPosition(): Vec2;
+    /** Raw pointer position in screen coordinates. */
+    getPointerScreenPosition(): Vec2;
+    /** Whether any pointer button is currently held. */
+    isPointerDown(): boolean;
+    /** Replace the entire action map and store it as the default for {@link resetBindings}. */
+    setActionMap(actions: ActionMapDefinition): void;
+    /** Add a key binding to an action. Creates the action if it doesn't exist. */
+    bindKey(action: string, key: string): void;
+    /** Remove a key binding from an action. */
+    unbindKey(action: string, key: string): void;
+    /** Returns the current key bindings for an action, or an empty array if unmapped. */
+    getBindings(action: string): readonly string[];
+    /** Returns all action names that have the given key bound. */
+    getActionsForKey(key: string): string[];
+    /**
+     * Rebind a key to an action with optional conflict detection.
+     * Conflicts are only detected between actions sharing at least one group.
+     */
+    rebind(action: string, key: string, opts?: RebindOptions): RebindResult;
+    /**
+     * Finds the first action that uses the given key AND shares at least one
+     * group with the target action. Ungrouped actions never conflict.
+     */
+    private findConflictInGroups;
+    /** Reset bindings to defaults. If an action name is provided, only reset that action. */
+    resetBindings(action?: string): void;
+    /** Export the current bindings as a plain object for serialization. */
+    exportBindings(): ActionMapDefinition;
+    /** Load bindings from a plain object. Resets to defaults first, then overlays the provided map. */
+    loadBindings(map: ActionMapDefinition): void;
+    /** Configure input groups. Group name -> array of action names. */
+    setGroups(groups: Record<string, string[]>): void;
+    /** Enable a group by name. */
+    enableGroup(name: string): void;
+    /** Disable a group by name. Actions only in disabled groups become inactive. */
+    disableGroup(name: string): void;
+    /** Set exactly these groups as active; all others are disabled. */
+    setActiveGroups(names: string[]): void;
+    /** Whether a group is currently enabled. Returns true for unknown group names. */
+    isGroupEnabled(name: string): boolean;
+    /** Get all configured group names. */
+    getGroups(): string[];
+    /** Get the action names belonging to a group. Returns empty array for unknown groups. */
+    getGroupActions(name: string): readonly string[];
+    /** Returns true if the action is ungrouped or any of its groups is enabled. */
+    private isActionEnabled;
+    /** Returns a promise that resolves with the next key code pressed. Intercepts the key. */
+    listenForNextKey(): Promise<string | null>;
+    /** Cancel an active {@link listenForNextKey}. Resolves the pending promise with `null`. */
+    cancelListen(): void;
+    /** Public wrapper for synthetic key-down injection. */
+    fireKeyDown(code: string): void;
+    /** Public wrapper for synthetic key-up injection. */
+    fireKeyUp(code: string): void;
+    /** Public wrapper for synthetic pointer movement. */
+    firePointerMove(screenX: number, screenY: number): void;
+    /** Public wrapper for synthetic pointer-button presses. */
+    firePointerDown(button?: 0 | 1 | 2): void;
+    /** Public wrapper for synthetic pointer-button releases. */
+    firePointerUp(button?: 0 | 1 | 2): void;
+    /** Store synthetic gamepad button state. */
+    fireGamepadButton(idx: number, pressed: boolean): void;
+    /** Store synthetic gamepad axis state. */
+    fireGamepadAxis(idx: number, value: number): void;
+    /** Inject a one-frame synthetic action pulse. */
+    fireAction(name: string): void;
+    /** Release all synthetic and physical input state. */
+    clearAll(): void;
+    /** Release any pressed pointer buttons without touching keyboard state. */
+    clearPointerButtons(): void;
+    /** Snapshot of current held input state for inspector tooling. */
+    snapshotState(): {
+        keys: string[];
+        actions: string[];
+        mouse: {
+            x: number;
+            y: number;
+            buttons: number[];
+            down: boolean;
+        };
+        gamepad: {
+            buttons: number[];
+            axes: Array<{
+                index: number;
+                value: number;
+            }>;
+        };
+    };
+    /** @internal */
+    _onKeyDown(code: string): void;
+    /** @internal */
+    _onKeyUp(code: string): void;
+    /** @internal */
+    _onPointerMove(screenX: number, screenY: number): void;
+    /** @internal */
+    _onPointerDown(): void;
+    /** @internal */
+    _onPointerUp(): void;
+    /** @internal Clear per-frame justPressed/justReleased flags. */
+    _clearFrameState(): void;
+    /** Set camera for pointer world-coord conversion. */
+    setCamera(camera: CameraLike): void;
+    /** Clear the camera reference (e.g. on scene exit). */
+    clearCamera(): void;
+    /** Get all configured action names. */
+    getActionNames(): string[];
+    /** @internal Advance the elapsed game-time clock. Called by InputPollSystem. */
+    _advanceTime(dtMs: number): void;
+}
+
+/** Service key for the InputManager. */
+declare const InputManagerKey: ServiceKey<InputManager>;
+/** Minimal camera surface needed by InputManager for pointer world-coord conversion. */
+interface CameraLike {
+    screenToWorld(screenX: number, screenY: number): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Minimal renderer surface needed by InputPlugin for canvas access and
+ * coordinate mapping. Alias of the cross-package `RendererAdapter` contract.
+ */
+type RendererLike = RendererAdapter;
+/** Configuration for the InputPlugin. */
+interface InputConfig {
+    /** Target element for pointer events (default: canvas from renderer, or document). */
+    target?: HTMLElement;
+    /** Action map: action name -> array of physical key codes. */
+    actions?: ActionMapDefinition;
+    /** Input groups: group name -> array of action names belonging to it. */
+    groups?: Record<string, string[]>;
+    /** Key codes to call preventDefault() on (default: none). */
+    preventDefaultKeys?: string[];
+    /**
+     * Optional override for the renderer service key. When omitted, InputPlugin
+     * auto-resolves `RendererAdapterKey` — the canonical `@yagejs/renderer`
+     * plugin registers itself under that key, so pointer events target its
+     * canvas and coordinates route through `canvasToVirtual` out of the box.
+     * Set this only if you ship a custom renderer registered under a different
+     * key.
+     */
+    rendererKey?: ServiceKey<RendererAdapter>;
+}
+/** Maps action names to arrays of physical key codes. */
+type ActionMapDefinition = Record<string, string[]>;
+/** How to handle a conflict when rebinding a key already used by another action in the same group. */
+type InputConflictPolicy = "replace" | "keep-both" | "reject";
+/** Options for {@link InputManager.rebind}. */
+interface RebindOptions {
+    /** Index of the binding slot to replace. Appends if the slot does not exist. */
+    slot?: number;
+    /** How to resolve conflicts with other actions in the same group(s). Default: `"reject"`. */
+    conflict?: InputConflictPolicy;
+}
+/** Result of a {@link InputManager.rebind} call. */
+interface RebindResult {
+    /** Whether the rebind succeeded. */
+    ok: boolean;
+    /** Present when `ok` is false due to a conflict with `conflict: "reject"`. */
+    conflict?: {
+        action: string;
+        key: string;
+    };
+}
+
+export { type ActionMapDefinition as A, type CameraLike as C, type InputConfig as I, type RebindOptions as R, type InputConflictPolicy as a, InputManager as b, InputManagerKey as c, type RebindResult as d, type RendererLike as e };

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 { InputConfig } from \"./types.js\";\n","import { ServiceKey } from \"@yagejs/core\";\nimport type { RendererAdapter } 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}\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 { I as InputConfig, c as InputManagerKey } from './api-CTGj55Rb.cjs';
+import '@yagejs/core';

package/dist/api.d.ts

@@ -0,0 +1,2 @@
+export { I as InputConfig, c as InputManagerKey } from './api-CTGj55Rb.js';
+import '@yagejs/core';

package/dist/api.js

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

package/dist/api.js.map

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

package/dist/chunk-CYWOKPMI.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-CYWOKPMI.js.map

package/dist/chunk-CYWOKPMI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { ServiceKey } from \"@yagejs/core\";\nimport type { RendererAdapter } 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}\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":[]}