@omnipad/core 0.4.5 → 0.6.0

package/dist/index.d.cts

@@ -1,5 +1,37 @@
-import { I as ICoreEntity, a as InputActionSignal, V as Vec2, G as GamepadMappingConfig, b as ISpatial, c as IResettable, d as IConfigurable, e as IStateful, E as EntityType, A as AbstractRect, B as ButtonConfig, f as IPointerHandler, g as IProgrammatic, h as AbstractPointerEvent, D as DPadConfig, i as InputZoneConfig, j as IDependencyBindable, k as AnyFunction, J as JoystickConfig, l as BaseConfig, T as TargetZoneConfig, m as ISignalReceiver, n as TrackpadConfig } from './index-CT1fDlB9.cjs';
-export { o as ACTION_TYPES, p as ActionMapping, q as AnchorPoint, r as AnyConfig, s as AnyEntityType, t as BuiltInActionType, C as CMP_TYPES, u as CONTEXT, v as ConfigTreeNode, w as CssUnit, F as FlatConfigItem, x as FlexibleLength, y as GamepadProfile, z as IIdentifiable, H as ILifecycle, K as InputActionType, L as KEYS, M as KeyMapping, N as LayoutBox, P as ParsedLength, S as StageId, O as StandardButton, Q as VALID_UNITS, W as WidgetId, R as WidgetType, Z as ZoneId, U as ZoneType } from './index-CT1fDlB9.cjs';
+import { I as InputActionSignal, V as Vec2, A as AnyFunction, C as ConfigTreeNode, B as BaseConfig, E as EntityType, a as AbstractRect, G as GamepadMappingConfig, O as OmniPadProfile, b as ButtonConfig, c as AbstractPointerEvent, D as DPadConfig, d as InputZoneConfig, J as JoystickConfig, T as TargetZoneConfig, e as TrackpadConfig } from './index-Dd0aHJaA.cjs';
+export { f as ACTION_TYPES, g as ActionMapping, h as AnchorPoint, i as AnyConfig, j as AnyEntityType, k as BuiltInActionType, l as CMP_TYPES, m as CONTEXT, n as CssUnit, F as FlatConfigItem, o as FlexibleLength, p as InputActionType, K as KEYS, q as KeyMapping, L as LayoutBox, P as ParsedLength, S as StageId, r as StandardButton, s as VALID_UNITS, W as WidgetId, t as WidgetType, Z as ZoneId, u as ZoneType } from './index-Dd0aHJaA.cjs';
+import { I as ICoreEntity, a as IElementObserver, S as StickyProvider, b as ISpatial, c as IResettable, d as IConfigurable, e as IStateful, f as IPointerHandler, g as IProgrammatic, h as IDependencyBindable, i as ISignalReceiver } from './sticky-CCj0ECTY.cjs';
+export { j as IIdentifiable, k as ILifecycle, l as StickyController } from './sticky-CCj0ECTY.cjs';
+
+/**
+ * A unique signature used to identify and verify that messages received via
+ * window.postMessage originate from the OmniPad system.
+ */
+declare const OMNIPAD_IPC_SIGNATURE = "__OMNIPAD_IPC_V1__";
+/**
+ * Represents the structure of a data packet used for Inter-Process Communication (IPC)
+ * between the Host (main window) and the Guest (iframe).
+ */
+interface IpcMessage {
+    /** Verification string to filter out external third-party messages */
+    signature: typeof OMNIPAD_IPC_SIGNATURE;
+    /**
+     * The broad category of the input event.
+     * Distinguishes between spatial interactions and discrete key signals.
+     */
+    type: 'pointer' | 'keyboard';
+    /**
+     * The specific event action name.
+     * Corresponds to standard browser event types like 'pointerdown', 'mousemove', 'keydown', etc.
+     */
+    action: string;
+    /**
+     * The data payload for the event.
+     * For 'pointer' type: Contains relative coordinates {x, y} and event options.
+     * For 'keyboard' type: Contains key mapping data {key, code, keyCode}.
+     */
+    payload: any;
+}
 
 /**
  * Interface for the global Registry singleton.
@@ -171,125 +203,136 @@ interface JoystickState extends InteractionState, AxisLogicState, ButtonLogicSta
 }
 
 /**
- * GamepadManager
+ * Binds a map of delegate functions to a core entity instance.
+ *
+ * @param entity - The target entity instance.
+ * @param delegates - A key-value map of functions to bind.
+ */
+declare function bindEntityDelegates(entity: any, delegates?: Record<string, AnyFunction>): void;
+/**
+ * Orchestrates environment-agnostic spatial and visibility logic for an entity.
  *
- * A singleton service that polls the browser Gamepad API via requestAnimationFrame.
- * It translates physical hardware inputs into programmatic signals sent to
- * virtual entities registered in the system.
+ * @template T - The type of the physical element (e.g., HTMLElement, Element).
+ * @param entity - The logic core entity instance (must implement ICoreEntity).
+ * @param element - The physical element target to be observed.
+ * @param observer - The unified observer singleton (RO/IO) to track the element.
+ * @param getRect - An environment-specific function to retrieve the element's current Rect.
+ * @param stickyProvider - Optional. If provided, its cache will be invalidated alongside the entity's.
  *
- * Handles:
- * 1. Button edge detection (Down/Up).
- * 2. D-Pad to vector conversion.
- * 3. Analog stick deadzone processing.
+ * @returns A cleanup function to disconnect all registered observers.
  */
-declare class GamepadManager {
-    private isRunning;
-    private config;
-    private lastButtonStates;
-    private constructor();
-    /**
-     * Retrieves the global singleton instance of the GamepadManager.
-     */
-    static getInstance(): GamepadManager;
-    /**
-     * Updates the current gamepad mapping configuration.
-     *
-     * @param config - The mapping of physical inputs to virtual component IDs (UID).
-     */
-    setConfig(config: GamepadMappingConfig[]): void;
-    /** Return the current gamepad mapping configuration. */
-    getConfig(): Readonly<GamepadMappingConfig[] | null>;
-    /**
-     * Starts the polling loop and listens for gamepad connection events.
-     */
-    start(): void;
-    /**
-     * Stops the polling loop.
-     */
-    stop(): void;
-    /**
-     * The core polling loop executing at the browser's refresh rate.
-     */
-    private loop;
-    /**
-     * Process binary button inputs with edge detection.
-     */
-    private processButtons;
-    /**
-     * Translates physical D-Pad buttons into a normalized vector.
-     */
-    private processDPad;
-    /**
-     * Process analog stick movements with deadzone logic.
-     */
-    private processAxes;
-    /**
-     * Locates a virtual entity and triggers its programmatic interface.
-     *
-     * @param uid - The Entity ID (UID) of the target.
-     * @param action - The type of trigger ('down', 'up', or 'vector').
-     * @param payload - Optional data for vector movements.
-     */
-    private triggerVirtualEntity;
-}
-
+declare function setupSpatialLogic<T>(entity: any, element: T, observer: IElementObserver<T>, getRect: (el: T) => AbstractRect, stickyProvider?: StickyProvider<T> | null): () => void;
+/**
+ * Filters out a specific dynamic child node from the tree by its ID (UID).
+ *
+ * @param children - The array of tree nodes to filter.
+ * @param dynamicWidgetId - The UID of the widget to be removed.
+ * @returns A new array excluding the specified dynamic child, or an empty array.
+ */
+declare function filterNotDynamicChildren(children: ConfigTreeNode[] | undefined, dynamicWidgetId: string): ConfigTreeNode[];
+/**
+ * Extract filtered override configurations.
+ * @param props Original Props object (e.g. Vue's props)
+ * @param skipKeys Ignore key set
+ */
+declare function getOverrideProps(props: Record<string, any>, skipKeys: Set<string>): Record<string, any>;
 /**
- * A centralized observation pool for DOM elements.
+ * Merges multiple configuration sources into a unified widget configuration object.
  *
- * This class provides a high-performance wrapper around `ResizeObserver` (RO) and
- * `IntersectionObserver` (IO). By pooling all element observations into single
- * native observer instances and utilizing `requestAnimationFrame` (rAF) throttling,
- * it significantly reduces memory footprint and prevents layout thrashing.
+ * @description
+ * This function performs a shallow merge of the provided configuration objects with a
+ * specific precedence order (Right-most takes priority). It also performs a one-level
+ * deep merge specifically for the `layout` property to ensure layout settings are
+ * preserved across different sources.
  *
- * It supports deterministic unregistration via UIDs, making it ideal for
- * framework adapters (like Vue or React) where DOM references may become unstable
- * during unmounting.
+ * **Merge Priority (Highest to Lowest):**
+ * 1. Fixed metadata (`id`, `baseType`, `parentId`) - *Guaranteed overrides*
+ * 2. `overrideProps`
+ * 3. `treeConfig`
+ * 4. `defaultProps`
+ *
+ * @param requiredType - The formal entity type (e.g., 'button', 'input-zone') assigned to `baseType`.
+ * @param uid - The unique identifier to be assigned to the `id` property.
+ * @param parentId - The unique identifier of the parent container, if any.
+ * @param defaultProps - The baseline fallback configuration.
+ * @param treeConfig - Configuration derived from the widget tree structure.
+ * @param overrideProps - Domain-specific or instance-specific property overrides.
+ *
+ * @returns A complete configuration object of type `T`.
  */
-declare class ElementObserver {
-    private _ro;
-    private _roRegistry;
-    private _elToRoCb;
-    private _io;
-    private _ioRegistry;
-    private _elToIoCb;
-    private constructor();
-    static getInstance(): ElementObserver;
-    /**
-     * Starts observing size changes for a specific element.
-     *
-     * @param uid - The unique entity ID associated with the observation.
-     * @param el - The target DOM element to observe.
-     * @param cb - Callback triggered when the element's size changes.
-     */
-    observeResize(uid: string, el: Element, cb: () => void): void;
-    /**
-     * Stops observing size changes for the entity identified by the UID.
-     *
-     * @param uid - The unique entity ID to unregister.
-     */
-    unobserveResize(uid: string): void;
-    /**
-     * Starts observing visibility (intersection) changes for a specific element.
-     *
-     * @param uid - The unique entity ID associated with the observation.
-     * @param el - The target DOM element to observe.
-     * @param cb - Callback triggered when visibility enters or exits the viewport.
-     */
-    observeIntersect(uid: string, el: Element, cb: (isIntersecting: boolean) => void): void;
-    /**
-     * Stops observing intersection changes for the entity identified by the UID.
-     *
-     * @param uid - The unique entity ID to unregister.
-     */
-    unobserveIntersect(uid: string): void;
+declare function mergeWidgetConfig<T extends BaseConfig>(requiredType: EntityType, uid: string, parentId: string | undefined, defaultProps: Record<string, any>, treeConfig: Record<string, any>, overrideProps: Record<string, any>): T;
+/**
+ * Resolves the dynamic widget instance to be rendered based on priority and exclusivity rules.
+ *
+ * This utility handles conflicts between manual components provided via slots and template
+ * components defined in the configuration. It implements a "Slot-First" strategy:
+ * 1. If slot nodes are present, the first valid node is chosen, and configuration templates are ignored.
+ * 2. If no slot nodes are present, it fallbacks to searching the configuration children for the matching UID.
+ * 3. Enforces uniqueness by ensuring only one component is rendered even if multiple are provided.
+ *
+ * @template T - The type of the node provided by the adapter (e.g., Vue VNode).
+ * @param slotNodes - An array of nodes retrieved from the dynamic widget slot.
+ * @param children - The array of child nodes from the current ConfigTreeNode.
+ * @param dynamicId - The UID assigned to the dynamic widget template.
+ * @returns An object containing the resolved node to render and its source origin.
+ */
+declare function resolveDynamicWidget<T>(slotNodes: T[], children: ConfigTreeNode[] | undefined, dynamicId: string): {
+    nodeToRender: T | ConfigTreeNode | null;
+    isFromSlot: boolean;
+};
+/**
+ * Validates that the provided node exists and is non-empty.
+ *
+ * It matches the node against the `requiredType` by checking both the protocol-level `config.baseType`
+ * and the potentially custom `type`.
+ *
+ * @param node - The configuration node to validate. Can be `undefined`.
+ * @param requiredType - The expected {@link EntityType} the node should represent.
+ *
+ * @returns The original `node` if validation passes; otherwise, `undefined`.
+ */
+declare function validateWidgetNode(node: ConfigTreeNode | undefined, requiredType: EntityType): ConfigTreeNode | undefined;
+
+/**
+ * Validates and normalizes raw JSON data into a standard OmniPadProfile.
+ * Performs structural checks and injects default metadata.
+ *
+ * @param raw - The raw JSON object from disk or network.
+ * @returns A validated OmniPadProfile object.
+ * @throws Error if the core structure is invalid.
+ */
+declare function parseProfileJson(raw: any): OmniPadProfile;
+/**
+ * The resulting structure after parsing a OmniPadProfile.
+ * Contains a map of root nodes and a runtime-ready gamepad mapping table.
+ */
+interface ParsedProfileForest {
+    /** Root nodes indexed by their original Config ID. */
+    roots: Record<string, ConfigTreeNode>;
     /**
-     * Disconnects all observers (RO and IO) associated with a specific UID.
-     * Usually called during component destruction for thorough cleanup.
-     *
-     * @param uid - The unique entity ID to fully disconnect.
+     * Processed gamepad mapping where all CIDs have been
+     * translated into unique runtime UIDs.
      */
-    disconnect(uid: string): void;
+    runtimeGamepadMappings: GamepadMappingConfig[];
 }
+/**
+ * Converts a flat OmniPadProfile into a forest of ConfigTreeNodes for runtime rendering.
+ * Automatically identifies all items without a parentId as root nodes.
+ *
+ * @param profile - The normalized profile data.
+ * @returns A record map of root nodes, keyed by their original configuration ID.
+ */
+declare function parseProfileTrees(profile: OmniPadProfile): ParsedProfileForest;
+/**
+ * Serializes the specified runtime entities into a flat OmniPadProfile.
+ * If no rootUids are provided, exports all entities currently in the registry.
+ *
+ * @param meta - Metadata for the exported profile.
+ * @param rootUid - The Entity ID of the node to be treated as the root.
+ * @param runtimeGamepadMapping - The current mapping from GamepadManager (using UIDs).
+ * @returns A flat OmniPadProfile ready for storage.
+ */
+declare function exportProfile(meta: OmniPadProfile['meta'], rootUids?: string[], runtimeGamepadMappings?: Readonly<GamepadMappingConfig[]>): OmniPadProfile;
 
 /**
  * Configures the global fallback handler for action signals.
@@ -334,51 +377,6 @@ declare class Registry implements IRegistry {
     broadcastSignal(signal: InputActionSignal): void;
 }
 
-/**
- * Global Input Manager Singleton.
- *
- * Responsible for monitoring global browser events (resize, blur, visibility)
- * and coordinating system-wide resets to prevent stuck inputs.
- */
-declare class WindowManager {
-    /** Internal flag to prevent multiple event registrations */
-    private _isListening;
-    /** A throttled version of the reset logic */
-    private throttledReset;
-    private constructor();
-    /**
-     * Retrieves the global instance of the WindowManager.
-     * Ensures uniqueness across multiple bundles or modules.
-     */
-    static getInstance(): WindowManager;
-    /**
-     * Manually triggers a system-wide input reset via Registry.
-     */
-    private handleGlobalReset;
-    private handleResizeReset;
-    private handleBlurReset;
-    private handleScrollReset;
-    private handleVisibilityChangeReset;
-    /**
-     * Initializes global safety listeners.
-     * Should be called once at the root component lifecycle (e.g., VirtualLayer).
-     */
-    init(): void;
-    /**
-     * Toggle full-screen state of the page.
-     * @param element Target HTMLElement
-     */
-    toggleFullscreen(element?: HTMLElement): Promise<void>;
-    /**
-     * Full-screen status query provided to the UI layer.
-     */
-    isFullscreen(): boolean;
-    /**
-     * Detaches all global listeners.
-     */
-    destroy(): void;
-}
-
 /**
  * Represents a callback function for the emitter.
  * @template T - The type of data being broadcasted.
@@ -689,500 +687,615 @@ declare const OmniPad: {
     };
     Keys: {
         readonly Backspace: {
+            readonly type: "keyboard";
             readonly key: "Backspace";
             readonly code: "Backspace";
             readonly keyCode: 8;
         };
         readonly Tab: {
+            readonly type: "keyboard";
             readonly key: "Tab";
             readonly code: "Tab";
             readonly keyCode: 9;
         };
         readonly Enter: {
+            readonly type: "keyboard";
             readonly key: "Enter";
             readonly code: "Enter";
             readonly keyCode: 13;
         };
         readonly ShiftLeft: {
+            readonly type: "keyboard";
             readonly key: "Shift";
             readonly code: "ShiftLeft";
             readonly keyCode: 16;
         };
         readonly ControlLeft: {
+            readonly type: "keyboard";
             readonly key: "Control";
             readonly code: "ControlLeft";
             readonly keyCode: 17;
         };
         readonly AltLeft: {
+            readonly type: "keyboard";
             readonly key: "Alt";
             readonly code: "AltLeft";
             readonly keyCode: 18;
         };
         readonly Pause: {
+            readonly type: "keyboard";
             readonly key: "Pause";
             readonly code: "Pause";
             readonly keyCode: 19;
         };
         readonly CapsLock: {
+            readonly type: "keyboard";
             readonly key: "CapsLock";
             readonly code: "CapsLock";
             readonly keyCode: 20;
         };
         readonly Escape: {
+            readonly type: "keyboard";
             readonly key: "Escape";
             readonly code: "Escape";
             readonly keyCode: 27;
         };
         readonly Space: {
+            readonly type: "keyboard";
             readonly key: " ";
             readonly code: "Space";
             readonly keyCode: 32;
         };
         readonly PageUp: {
+            readonly type: "keyboard";
             readonly key: "PageUp";
             readonly code: "PageUp";
             readonly keyCode: 33;
         };
         readonly PageDown: {
+            readonly type: "keyboard";
             readonly key: "PageDown";
             readonly code: "PageDown";
             readonly keyCode: 34;
         };
         readonly End: {
+            readonly type: "keyboard";
             readonly key: "End";
             readonly code: "End";
             readonly keyCode: 35;
         };
         readonly Home: {
+            readonly type: "keyboard";
             readonly key: "Home";
             readonly code: "Home";
             readonly keyCode: 36;
         };
         readonly ArrowLeft: {
+            readonly type: "keyboard";
             readonly key: "ArrowLeft";
             readonly code: "ArrowLeft";
             readonly keyCode: 37;
         };
         readonly ArrowUp: {
+            readonly type: "keyboard";
             readonly key: "ArrowUp";
             readonly code: "ArrowUp";
             readonly keyCode: 38;
         };
         readonly ArrowRight: {
+            readonly type: "keyboard";
             readonly key: "ArrowRight";
             readonly code: "ArrowRight";
             readonly keyCode: 39;
         };
         readonly ArrowDown: {
+            readonly type: "keyboard";
             readonly key: "ArrowDown";
             readonly code: "ArrowDown";
             readonly keyCode: 40;
         };
         readonly PrintScreen: {
+            readonly type: "keyboard";
             readonly key: "PrintScreen";
             readonly code: "PrintScreen";
             readonly keyCode: 44;
         };
         readonly Insert: {
+            readonly type: "keyboard";
             readonly key: "Insert";
             readonly code: "Insert";
             readonly keyCode: 45;
         };
         readonly Delete: {
+            readonly type: "keyboard";
             readonly key: "Delete";
             readonly code: "Delete";
             readonly keyCode: 46;
         };
         readonly Digit0: {
+            readonly type: "keyboard";
             readonly key: "0";
             readonly code: "Digit0";
             readonly keyCode: 48;
         };
         readonly Digit1: {
+            readonly type: "keyboard";
             readonly key: "1";
             readonly code: "Digit1";
             readonly keyCode: 49;
         };
         readonly Digit2: {
+            readonly type: "keyboard";
             readonly key: "2";
             readonly code: "Digit2";
             readonly keyCode: 50;
         };
         readonly Digit3: {
+            readonly type: "keyboard";
             readonly key: "3";
             readonly code: "Digit3";
             readonly keyCode: 51;
         };
         readonly Digit4: {
+            readonly type: "keyboard";
             readonly key: "4";
             readonly code: "Digit4";
             readonly keyCode: 52;
         };
         readonly Digit5: {
+            readonly type: "keyboard";
             readonly key: "5";
             readonly code: "Digit5";
             readonly keyCode: 53;
         };
         readonly Digit6: {
+            readonly type: "keyboard";
             readonly key: "6";
             readonly code: "Digit6";
             readonly keyCode: 54;
         };
         readonly Digit7: {
+            readonly type: "keyboard";
             readonly key: "7";
             readonly code: "Digit7";
             readonly keyCode: 55;
         };
         readonly Digit8: {
+            readonly type: "keyboard";
             readonly key: "8";
             readonly code: "Digit8";
             readonly keyCode: 56;
         };
         readonly Digit9: {
+            readonly type: "keyboard";
             readonly key: "9";
             readonly code: "Digit9";
             readonly keyCode: 57;
         };
         readonly KeyA: {
+            readonly type: "keyboard";
             readonly key: "a";
             readonly code: "KeyA";
             readonly keyCode: 65;
         };
         readonly KeyB: {
+            readonly type: "keyboard";
             readonly key: "b";
             readonly code: "KeyB";
             readonly keyCode: 66;
         };
         readonly KeyC: {
+            readonly type: "keyboard";
             readonly key: "c";
             readonly code: "KeyC";
             readonly keyCode: 67;
         };
         readonly KeyD: {
+            readonly type: "keyboard";
             readonly key: "d";
             readonly code: "KeyD";
             readonly keyCode: 68;
         };
         readonly KeyE: {
+            readonly type: "keyboard";
             readonly key: "e";
             readonly code: "KeyE";
             readonly keyCode: 69;
         };
         readonly KeyF: {
+            readonly type: "keyboard";
             readonly key: "f";
             readonly code: "KeyF";
             readonly keyCode: 70;
         };
         readonly KeyG: {
+            readonly type: "keyboard";
             readonly key: "g";
             readonly code: "KeyG";
             readonly keyCode: 71;
         };
         readonly KeyH: {
+            readonly type: "keyboard";
             readonly key: "h";
             readonly code: "KeyH";
             readonly keyCode: 72;
         };
         readonly KeyI: {
+            readonly type: "keyboard";
             readonly key: "i";
             readonly code: "KeyI";
             readonly keyCode: 73;
         };
         readonly KeyJ: {
+            readonly type: "keyboard";
             readonly key: "j";
             readonly code: "KeyJ";
             readonly keyCode: 74;
         };
         readonly KeyK: {
+            readonly type: "keyboard";
             readonly key: "k";
             readonly code: "KeyK";
             readonly keyCode: 75;
         };
         readonly KeyL: {
+            readonly type: "keyboard";
             readonly key: "l";
             readonly code: "KeyL";
             readonly keyCode: 76;
         };
         readonly KeyM: {
+            readonly type: "keyboard";
             readonly key: "m";
             readonly code: "KeyM";
             readonly keyCode: 77;
         };
         readonly KeyN: {
+            readonly type: "keyboard";
             readonly key: "n";
             readonly code: "KeyN";
             readonly keyCode: 78;
         };
         readonly KeyO: {
+            readonly type: "keyboard";
             readonly key: "o";
             readonly code: "KeyO";
             readonly keyCode: 79;
         };
         readonly KeyP: {
+            readonly type: "keyboard";
             readonly key: "p";
             readonly code: "KeyP";
             readonly keyCode: 80;
         };
         readonly KeyQ: {
+            readonly type: "keyboard";
             readonly key: "q";
             readonly code: "KeyQ";
             readonly keyCode: 81;
         };
         readonly KeyR: {
+            readonly type: "keyboard";
             readonly key: "r";
             readonly code: "KeyR";
             readonly keyCode: 82;
         };
         readonly KeyS: {
+            readonly type: "keyboard";
             readonly key: "s";
             readonly code: "KeyS";
             readonly keyCode: 83;
         };
         readonly KeyT: {
+            readonly type: "keyboard";
             readonly key: "t";
             readonly code: "KeyT";
             readonly keyCode: 84;
         };
         readonly KeyU: {
+            readonly type: "keyboard";
             readonly key: "u";
             readonly code: "KeyU";
             readonly keyCode: 85;
         };
         readonly KeyV: {
+            readonly type: "keyboard";
             readonly key: "v";
             readonly code: "KeyV";
             readonly keyCode: 86;
         };
         readonly KeyW: {
+            readonly type: "keyboard";
             readonly key: "w";
             readonly code: "KeyW";
             readonly keyCode: 87;
         };
         readonly KeyX: {
+            readonly type: "keyboard";
             readonly key: "x";
             readonly code: "KeyX";
             readonly keyCode: 88;
         };
         readonly KeyY: {
+            readonly type: "keyboard";
             readonly key: "y";
             readonly code: "KeyY";
             readonly keyCode: 89;
         };
         readonly KeyZ: {
+            readonly type: "keyboard";
             readonly key: "z";
             readonly code: "KeyZ";
             readonly keyCode: 90;
         };
         readonly MetaLeft: {
+            readonly type: "keyboard";
             readonly key: "Meta";
             readonly code: "MetaLeft";
             readonly keyCode: 91;
         };
         readonly ContextMenu: {
+            readonly type: "keyboard";
             readonly key: "ContextMenu";
             readonly code: "ContextMenu";
             readonly keyCode: 93;
         };
         readonly Numpad0: {
+            readonly type: "keyboard";
             readonly key: "0";
             readonly code: "Numpad0";
             readonly keyCode: 96;
         };
         readonly Numpad1: {
+            readonly type: "keyboard";
             readonly key: "1";
             readonly code: "Numpad1";
             readonly keyCode: 97;
         };
         readonly Numpad2: {
+            readonly type: "keyboard";
             readonly key: "2";
             readonly code: "Numpad2";
             readonly keyCode: 98;
         };
         readonly Numpad3: {
+            readonly type: "keyboard";
             readonly key: "3";
             readonly code: "Numpad3";
             readonly keyCode: 99;
         };
         readonly Numpad4: {
+            readonly type: "keyboard";
             readonly key: "4";
             readonly code: "Numpad4";
             readonly keyCode: 100;
         };
         readonly Numpad5: {
+            readonly type: "keyboard";
             readonly key: "5";
             readonly code: "Numpad5";
             readonly keyCode: 101;
         };
         readonly Numpad6: {
+            readonly type: "keyboard";
             readonly key: "6";
             readonly code: "Numpad6";
             readonly keyCode: 102;
         };
         readonly Numpad7: {
+            readonly type: "keyboard";
             readonly key: "7";
             readonly code: "Numpad7";
             readonly keyCode: 103;
         };
         readonly Numpad8: {
+            readonly type: "keyboard";
             readonly key: "8";
             readonly code: "Numpad8";
             readonly keyCode: 104;
         };
         readonly Numpad9: {
+            readonly type: "keyboard";
             readonly key: "9";
             readonly code: "Numpad9";
             readonly keyCode: 105;
         };
         readonly NumpadMultiply: {
+            readonly type: "keyboard";
             readonly key: "*";
             readonly code: "NumpadMultiply";
             readonly keyCode: 106;
         };
         readonly NumpadAdd: {
+            readonly type: "keyboard";
             readonly key: "+";
             readonly code: "NumpadAdd";
             readonly keyCode: 107;
         };
         readonly NumpadSubtract: {
+            readonly type: "keyboard";
             readonly key: "-";
             readonly code: "NumpadSubtract";
             readonly keyCode: 109;
         };
         readonly NumpadDecimal: {
+            readonly type: "keyboard";
             readonly key: ".";
             readonly code: "NumpadDecimal";
             readonly keyCode: 110;
         };
         readonly NumpadDivide: {
+            readonly type: "keyboard";
             readonly key: "/";
             readonly code: "NumpadDivide";
             readonly keyCode: 111;
         };
         readonly F1: {
+            readonly type: "keyboard";
             readonly key: "F1";
             readonly code: "F1";
             readonly keyCode: 112;
         };
         readonly F2: {
+            readonly type: "keyboard";
             readonly key: "F2";
             readonly code: "F2";
             readonly keyCode: 113;
         };
         readonly F3: {
+            readonly type: "keyboard";
             readonly key: "F3";
             readonly code: "F3";
             readonly keyCode: 114;
         };
         readonly F4: {
+            readonly type: "keyboard";
             readonly key: "F4";
             readonly code: "F4";
             readonly keyCode: 115;
         };
         readonly F5: {
+            readonly type: "keyboard";
             readonly key: "F5";
             readonly code: "F5";
             readonly keyCode: 116;
         };
         readonly F6: {
+            readonly type: "keyboard";
             readonly key: "F6";
             readonly code: "F6";
             readonly keyCode: 117;
         };
         readonly F7: {
+            readonly type: "keyboard";
             readonly key: "F7";
             readonly code: "F7";
             readonly keyCode: 118;
         };
         readonly F8: {
+            readonly type: "keyboard";
             readonly key: "F8";
             readonly code: "F8";
             readonly keyCode: 119;
         };
         readonly F9: {
+            readonly type: "keyboard";
             readonly key: "F9";
             readonly code: "F9";
             readonly keyCode: 120;
         };
         readonly F10: {
+            readonly type: "keyboard";
             readonly key: "F10";
             readonly code: "F10";
             readonly keyCode: 121;
         };
         readonly F11: {
+            readonly type: "keyboard";
             readonly key: "F11";
             readonly code: "F11";
             readonly keyCode: 122;
         };
         readonly F12: {
+            readonly type: "keyboard";
             readonly key: "F12";
             readonly code: "F12";
             readonly keyCode: 123;
         };
         readonly NumLock: {
+            readonly type: "keyboard";
             readonly key: "NumLock";
             readonly code: "NumLock";
             readonly keyCode: 144;
         };
         readonly ScrollLock: {
+            readonly type: "keyboard";
             readonly key: "ScrollLock";
             readonly code: "ScrollLock";
             readonly keyCode: 145;
         };
         readonly Semicolon: {
+            readonly type: "keyboard";
             readonly key: ";";
             readonly code: "Semicolon";
             readonly keyCode: 186;
         };
         readonly Equal: {
+            readonly type: "keyboard";
             readonly key: "=";
             readonly code: "Equal";
             readonly keyCode: 187;
         };
         readonly Comma: {
+            readonly type: "keyboard";
             readonly key: ",";
             readonly code: "Comma";
             readonly keyCode: 188;
         };
         readonly Minus: {
+            readonly type: "keyboard";
             readonly key: "-";
             readonly code: "Minus";
             readonly keyCode: 189;
         };
         readonly Period: {
+            readonly type: "keyboard";
             readonly key: ".";
             readonly code: "Period";
             readonly keyCode: 190;
         };
         readonly Slash: {
+            readonly type: "keyboard";
             readonly key: "/";
             readonly code: "Slash";
             readonly keyCode: 191;
         };
         readonly Backquote: {
+            readonly type: "keyboard";
             readonly key: "`";
             readonly code: "Backquote";
             readonly keyCode: 192;
         };
         readonly BracketLeft: {
+            readonly type: "keyboard";
             readonly key: "[";
             readonly code: "BracketLeft";
             readonly keyCode: 219;
         };
         readonly Backslash: {
+            readonly type: "keyboard";
             readonly key: "\\";
             readonly code: "Backslash";
             readonly keyCode: 220;
         };
         readonly BracketRight: {
+            readonly type: "keyboard";
             readonly key: "]";
             readonly code: "BracketRight";
             readonly keyCode: 221;
         };
         readonly Quote: {
+            readonly type: "keyboard";
             readonly key: "'";
             readonly code: "Quote";
             readonly keyCode: 222;
         };
+        readonly Mouse: {
+            readonly type: "mouse";
+            readonly button: 0;
+        };
+        readonly MouseLeft: {
+            readonly type: "mouse";
+            readonly button: 0;
+        };
+        readonly MouseMiddle: {
+            readonly type: "mouse";
+            readonly button: 1;
+        };
+        readonly MouseRight: {
+            readonly type: "mouse";
+            readonly button: 2;
+        };
     };
     Types: {
         readonly INPUT_ZONE: "input-zone";
@@ -1198,4 +1311,4 @@ declare const OmniPad: {
     };
 };
 
-export { AbstractPointerEvent, AbstractRect, AnyFunction, type AxisLogicState, BaseConfig, BaseEntity, ButtonConfig, ButtonCore, type ButtonLogicState, type ButtonState, type CursorState, DPadConfig, DPadCore, type DPadState, ElementObserver, EntityType, GamepadManager, GamepadMappingConfig, IConfigurable, ICoreEntity, IDependencyBindable, IPointerHandler, IProgrammatic, type IRegistry, IResettable, ISignalReceiver, ISpatial, IStateful, InputActionSignal, InputZoneConfig, InputZoneCore, type InputZoneState, type InteractionState, JoystickConfig, JoystickCore, type JoystickState, type KeyboardButtonState, type LayerState, type MouseButtonState, OmniPad, Registry, RootLayerCore, TargetZoneConfig, TargetZoneCore, TrackpadConfig, TrackpadCore, type TrackpadState, Vec2, WindowManager, setGlobalSignalHandler };
+export { AbstractPointerEvent, AbstractRect, AnyFunction, type AxisLogicState, BaseConfig, BaseEntity, ButtonConfig, ButtonCore, type ButtonLogicState, type ButtonState, ConfigTreeNode, type CursorState, DPadConfig, DPadCore, type DPadState, EntityType, GamepadMappingConfig, IConfigurable, ICoreEntity, IDependencyBindable, IElementObserver, IPointerHandler, IProgrammatic, type IRegistry, IResettable, ISignalReceiver, ISpatial, IStateful, InputActionSignal, InputZoneConfig, InputZoneCore, type InputZoneState, type InteractionState, type IpcMessage, JoystickConfig, JoystickCore, type JoystickState, type KeyboardButtonState, type LayerState, type MouseButtonState, OMNIPAD_IPC_SIGNATURE, OmniPad, OmniPadProfile, type ParsedProfileForest, Registry, RootLayerCore, StickyProvider, TargetZoneConfig, TargetZoneCore, TrackpadConfig, TrackpadCore, type TrackpadState, Vec2, bindEntityDelegates, exportProfile, filterNotDynamicChildren, getOverrideProps, mergeWidgetConfig, parseProfileJson, parseProfileTrees, resolveDynamicWidget, setGlobalSignalHandler, setupSpatialLogic, validateWidgetNode };