@yagejs/input 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,166 +1,6 @@
-import { Vec2, ServiceKey, RendererAdapter, Plugin, EngineContext, SystemScheduler } from '@yagejs/core';
-
-/** Central input state manager. Resolved via DI with InputManagerKey. */
-declare class InputManager {
-    private pressedKeys;
-    private justPressedKeys;
-    private justReleasedKeys;
-    private holdStart;
-    private actionMap;
-    private defaultBindings;
-    private groups;
-    private actionGroups;
-    private disabledGroups;
-    private pointerScreenPos;
-    private pointerDownState;
-    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;
-    /** @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;
-    };
-}
+import { Plugin, EngineContext, SystemScheduler } from '@yagejs/core';
+import { I as InputConfig } from './api-BaItBbSe.js';
+export { A as ActionMapDefinition, C as CameraLike, G as GamepadAxisKey, a as GamepadInfo, b as InputConflictPolicy, c as InputManager, d as InputManagerKey, P as PointerInfo, e as PointerType, R as RebindOptions, f as RebindResult, g as RendererLike } from './api-BaItBbSe.js';
 
 /** Input plugin — wires keyboard and pointer listeners, registers InputManager. */
 declare class InputPlugin implements Plugin {
@@ -180,4 +20,4 @@ declare class InputPlugin implements Plugin {
 /** Returns a human-readable display name for a `KeyboardEvent.code` or mouse key string. */
 declare function getKeyDisplayName(code: string): string;
 
-export { type ActionMapDefinition, type CameraLike, type InputConfig, type InputConflictPolicy, InputManager, InputManagerKey, InputPlugin, type RebindOptions, type RebindResult, type RendererLike, getKeyDisplayName };
+export { InputConfig, InputPlugin, getKeyDisplayName };