@skewedaspect/sage 0.9.0-beta.7 → 0.9.0-beta.8

package/dist/interfaces/action.d.ts

@@ -4,6 +4,7 @@
 export interface DigitalAction {
     type: 'digital';
     name: string;
+    label?: string;
 }
 /**
  * Analog action (numeric)
@@ -11,6 +12,7 @@ export interface DigitalAction {
 export interface AnalogAction {
     type: 'analog';
     name: string;
+    label?: string;
     minValue?: number;
     maxValue?: number;
 }

package/dist/interfaces/binding.d.ts

@@ -25,6 +25,17 @@ export interface Context {
 export type InputDefinition = DeviceValueReaderDefinition & {
     deviceID: string;
 };
+/**
+ * Options for captureInput() — waits for the next intentional input and returns its descriptor.
+ */
+export interface CaptureInputOptions {
+    /** Device types to listen for */
+    deviceTypes: DeviceType[];
+    /** Optional filter for source types (e.g. ['key', 'button', 'axis']) */
+    sourceTypes?: ('key' | 'button' | 'axis' | 'position' | 'wheel')[];
+    /** Optional AbortSignal for cancellation or timeout */
+    signal?: AbortSignal;
+}
 /**
  * Base interface for binding definitions with object-based sources
  */

package/dist/managers/binding.d.ts

@@ -1,5 +1,5 @@
 import { GameEventBus } from "../classes/eventBus.d.ts";
-import { Binding, BindingDefinition, Context } from "../interfaces/binding.d.ts";
+import { Binding, BindingDefinition, CaptureInputOptions, Context, InputDefinition } from "../interfaces/binding.d.ts";
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { DeviceType, InputDevice, InputState } from "../interfaces/input.d.ts";
 import { Action } from "../interfaces/action.d.ts";
@@ -35,6 +35,8 @@ export declare class BindingManager implements Disposable {
     private _activeContexts;
     /** The most recent device type that produced intentional input */
     private _lastActiveDeviceType;
+    /** Active captureInput() state, or null when not capturing */
+    private _captureState;
     /** Event bus for handling game events */
     private _eventBus;
     /** Unsubscribe function for input events */
@@ -91,6 +93,19 @@ export declare class BindingManager implements Disposable {
      * @throws Error if the reader type is not supported
      */
     private _createInputSourceFromDefinition;
+    /**
+     * Evaluates an input event during capture mode. If the event matches the capture criteria,
+     * resolves the capture promise and cleans up. Otherwise does nothing and waits for the next event.
+     *
+     * @param device
+     * @param state
+     */
+    private _processCaptureInput;
+    /**
+     * Tears down capture state, deactivates the temporary context, and restores the
+     * snapshotted contexts. Does not resolve or reject — the caller handles that.
+     */
+    private _cleanupCapture;
     /**
      * Handle input from a device and process all relevant bindings.
      *
@@ -122,6 +137,15 @@ export declare class BindingManager implements Disposable {
      * or `null` if no input has been received yet.
      */
     get lastActiveDeviceType(): DeviceType | null;
+    /**
+     * Waits for the next intentional input event and returns a descriptor suitable for constructing
+     * a binding. While capturing, all normal bindings are suppressed via a temporary exclusive context.
+     * Previous context state is restored when the capture completes or is cancelled.
+     *
+     * @param options
+     * @throws Error if a capture is already in progress
+     */
+    captureInput(options: CaptureInputOptions): Promise<InputDefinition>;
     /**
      * Registers a context with specific options.
      * Updates exclusivity if the context already exists.