@omnipad/core 0.5.0 → 0.6.1

package/dist/index.d.ts

@@ -1,7 +1,37 @@
-import { I as InputActionSignal, V as Vec2, E as EntityType, A as AbstractRect, B as ButtonConfig, a as AbstractPointerEvent, D as DPadConfig, b as InputZoneConfig, c as AnyFunction, J as JoystickConfig, d as BaseConfig, T as TargetZoneConfig, e as TrackpadConfig } from './index-DVegtw8s.js';
-export { f as ACTION_TYPES, g as ActionMapping, h as AnchorPoint, i as AnyConfig, j as AnyEntityType, k as BuiltInActionType, C as CMP_TYPES, l as CONTEXT, m as ConfigTreeNode, n as CssUnit, F as FlatConfigItem, o as FlexibleLength, G as GamepadMappingConfig, p as InputActionType, K as KEYS, q as KeyMapping, L as LayoutBox, O as OmniPadProfile, 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-DVegtw8s.js';
-import { I as ICoreEntity, a as ISpatial, b as IResettable, c as IConfigurable, d as IStateful, e as IPointerHandler, f as IProgrammatic, g as IDependencyBindable, h as ISignalReceiver } from './traits-dAndzyWS.js';
-export { i as IIdentifiable, j as ILifecycle } from './traits-dAndzyWS.js';
+import { I as InputActionSignal, V as Vec2, A as AnyFunction, C as ConfigTreeNode, B as BaseConfig, E as EntityType, a as AbstractRect, O as OmniPadProfile, G as GamepadMappingConfig, b as ButtonConfig, c as AbstractPointerEvent, D as DPadConfig, d as InputZoneConfig, J as JoystickConfig, T as TargetZoneConfig, e as TrackpadConfig } from './index-Dd0aHJaA.js';
+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.js';
+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-d_z_GU83.js';
+export { j as IIdentifiable, k as ILifecycle, l as StickyController } from './sticky-d_z_GU83.js';
+
+/**
+ * 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.
@@ -172,6 +202,168 @@ interface DPadState extends InteractionState, AxisLogicState {
 interface JoystickState extends InteractionState, AxisLogicState, ButtonLogicState {
 }
 
+/**
+ * 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.
+ *
+ * @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.
+ *
+ * @returns A cleanup function to disconnect all registered observers.
+ */
+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>;
+/**
+ * Merges multiple configuration sources into a unified widget configuration object.
+ *
+ * @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.
+ *
+ * **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 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;
+
+/**
+ * @deprecated Use validateProfile() instead.
+ * This function will be removed in v0.7.0.
+ *
+ * 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;
+/**
+ * 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 validateProfile(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 {
+    meta: OmniPadProfile['meta'];
+    /** Root nodes indexed by their original Config ID. */
+    roots: Record<string, ConfigTreeNode>;
+    /**
+     * Processed gamepad mapping where all CIDs have been
+     * translated into unique runtime UIDs.
+     */
+    runtimeGamepadMappings: GamepadMappingConfig[];
+}
+/**
+ * @deprecated Use parseProfileForest() instead.
+ * This function will be removed in v0.7.0.
+ *
+ * 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;
+/**
+ * [Recommended Entry Point]
+ * Parses raw input (JSON string or object) into a fully resolved Profile Forest.
+ *
+ * This function orchestrates:
+ * 1. JSON string parsing (if needed)
+ * 2. Structural validation & Security hardening
+ * 3. Flat-to-tree transformation & ID resolution
+ *
+ * @param raw - The raw profile data (JSON string or object).
+ * @returns A hierarchical forest structure and resolved gamepad mappings.
+ * @throws Error if parsing or validation fails.
+ */
+declare function parseProfileForest(raw: string | 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.
  *
@@ -525,500 +717,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";
@@ -1034,4 +1341,4 @@ declare const OmniPad: {
     };
 };
 
-export { AbstractPointerEvent, AbstractRect, AnyFunction, type AxisLogicState, BaseConfig, BaseEntity, ButtonConfig, ButtonCore, type ButtonLogicState, type ButtonState, type CursorState, DPadConfig, DPadCore, type DPadState, EntityType, 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, 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, parseProfileForest, parseProfileJson, parseProfileTrees, resolveDynamicWidget, setGlobalSignalHandler, setupSpatialLogic, validateProfile, validateWidgetNode };