@omnipad/core 0.4.5 → 0.6.0

package/dist/{index-CT1fDlB9.d.ts → index-Dd0aHJaA.d.ts}

@@ -28,32 +28,10 @@ interface GamepadMappingConfig {
 }
 
 /**
- * Interface defining the structure of a keyboard key mapping.
+ * Interface defining the structure of key mapping.
  * Ensures compatibility between modern web standards and legacy Flash requirements.
  */
 interface KeyMapping {
-    /**
-     * The key value, corresponding to `KeyboardEvent.key`.
-     * Represented as a string (e.g., " ", "Enter", "a").
-     */
-    key: string;
-    /**
-     * The physical key code, corresponding to `KeyboardEvent.code`.
-     * Describes the physical location of the key (e.g., "Space", "Enter", "KeyA").
-     */
-    code: string;
-    /**
-     * The legacy numerical key code, corresponding to `KeyboardEvent.keyCode`.
-     * Essential for Flash engines (AS2/AS3) running via Ruffle.
-     * e.g., 32 for Space, 13 for Enter.
-     */
-    keyCode: number;
-}
-/**
- * Unified action definition.
- * Discriminated by the 'type' field, but shares a common structure for ease of use.
- */
-interface ActionMapping {
     /** 指定动作类型：'keyboard' | 'mouse' */
     type: 'keyboard' | 'mouse';
     key?: string;
@@ -64,507 +42,1239 @@ interface ActionMapping {
     /** Fixed coordinate (0-100 percentage) */
     fixedPoint?: Vec2;
 }
+/**
+ * Standard key mapping table optimized for Ruffle/Flash environments.
+ * Categorized and ordered by keyCode in ascending order.
+ */
+declare const STANDARD_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;
+    };
+};
 /**
  * Standard collection of key mappings.
  * Allows developers to quickly retrieve mapping data using physical key codes as keys.
  */
 declare const 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;
+    };
 };
+type ActionMapping = KeyMapping | keyof typeof STANDARD_KEYS;
 
 /**
  * Defines the spatial properties of a component.
@@ -590,9 +1300,13 @@ interface LayoutBox {
      * @example 'center' will center the component on its position.
      */
     anchor?: AnchorPoint;
-    /** Rotation angle in degrees. */
     /** Z-index for layering control. */
     zIndex?: number;
+    /**
+     * CSS selector for the target element (e.g., "#game-canvas").
+     * If provided, the component switches to "Sticky" mode and positions itself relative to this element.
+     */
+    stickySelector?: string;
 }
 /**
  * Base configuration interface for all components.
@@ -600,6 +1314,7 @@ interface LayoutBox {
 interface BaseConfig {
     /**
      * Config ID (CID) used in persistent storage.
+     *
      * If omitted, a random UID will be generated during parsing.
      * If starts with '$', it points to a global static entity. (UID = CID)
      */
@@ -612,9 +1327,10 @@ interface BaseConfig {
     layout: LayoutBox;
     /**
      * Custom CSS class names or style tags.
-     * For visual decoration only; must not include layout attributes such as top/left/width/height.
+     *
+     * For visual decoration only; must not include layout attributes such as top/left/width/height while the same properties are set in `layout: LayoutBox`.
      */
-    cssClasses?: string | string[];
+    cssClass?: string;
 }
 /**
  * Configuration for a virtual keyboard/mouse button.
@@ -724,9 +1440,9 @@ interface FlatConfigItem {
     config?: Record<string, any>;
 }
 /**
- * The root structure of a Gamepad configuration file.
+ * The root structure of a OmniPad configuration file.
  */
-interface GamepadProfile {
+interface OmniPadProfile {
     /** Metadata about the profile creator and version. */
     meta: {
         name: string;
@@ -757,155 +1473,6 @@ interface ConfigTreeNode {
     children?: ConfigTreeNode[];
 }
 
-/**
- * Trait: Provides identity with a unique ID and specific entity type.
- */
-interface IIdentifiable {
-    readonly uid: string;
-    readonly type: EntityType;
-}
-/**
- * Trait: Provides lifecycle management hooks.
- */
-interface ILifecycle {
-    /**
-     * Performs cleanup, unregisters the entity, and releases resources.
-     */
-    destroy(): void;
-}
-/**
- * The core contract for any object that can be managed by the Registry.
- * Only objects implementing this interface are eligible for registration.
- */
-interface ICoreEntity extends IIdentifiable, ILifecycle {
-}
-/**
- * Trait: Enables spatial awareness for DOM/UI-related components.
- */
-interface ISpatial {
-    readonly rect: AbstractRect | null;
-    /**
-     * Dynamically obtain dimensions and position to ensure the most precise real-time screen coordinates are obtained during each interaction.
-     */
-    bindRectProvider(provider: () => AbstractRect, onMarkDirty?: () => void): void;
-    /**
-     * Trigger a cache invalidation.
-     */
-    markRectDirty(): void;
-}
-/**
- * Trait: Provides configuration management.
- */
-interface IConfigurable<TConfig> {
-    /**
-     * Retrieves a snapshot of the current configuration.
-     */
-    getConfig(): TConfig;
-    /**
-     * Subscribes to config changes.
-     * @param cb - Callback function triggered on config updates.
-     * @returns An unsubscribe function.
-     */
-    subscribeConfig(cb: (config: TConfig) => void): () => void;
-    /**
-     * Updates the internal config and notifies all subscribers.
-     * @param config - Partial configuration object to merge.
-     */
-    updateConfig(config: Partial<TConfig>): void;
-}
-/**
- * Trait: Provides state management.
- */
-interface IStateful<TState> {
-    /**
-     * Retrieves the current state snapshot.
-     */
-    getState(): TState;
-    /**
-     * Subscribes to state changes.
-     * @param cb - Callback function triggered on state updates.
-     * @returns An unsubscribe function.
-     */
-    subscribeState(cb: (state: TState) => void): () => void;
-    /**
-     * Updates the internal state and notifies all subscribers.
-     * @param state - Partial object containing updated state values.
-     */
-    setState(state: Partial<TState>): void;
-}
-/**
- * Trait: Allows resetting the entity to its idle/safe state.
- */
-interface IResettable {
-    /**
-     * Forcefully clears active states and cuts off outgoing signals.
-     */
-    reset(): void;
-}
-/**
- * Trait: Handles raw pointer input (Touch/Mouse).
- */
-interface IPointerHandler {
-    readonly activePointerId: number | null;
-    onPointerDown(e: AbstractPointerEvent): void;
-    onPointerMove(e: AbstractPointerEvent): void;
-    onPointerUp(e: AbstractPointerEvent): void;
-    onPointerCancel(e: AbstractPointerEvent): void;
-}
-/**
- * Trait: Receives and processes input signals (e.g., TargetZone).
- */
-interface ISignalReceiver {
-    /**
-     * Handles incoming signals from widgets.
-     * @param signal - The signal data containing action type and payload.
-     */
-    handleSignal(signal: InputActionSignal): void;
-}
-/**
- * Capability for an entity to receive and store external functional dependencies.
- *
- * This enables Runtime Dependency Injection (DI), allowing core logic to invoke
- * host-specific methods (such as DOM event dispatchers or custom triggers)
- * without being tightly coupled to the environment.
- */
-interface IDependencyBindable {
-    /**
-     * Binds a functional delegate by a specific identifier key.
-     *
-     * @param key - The unique lookup identifier for the dependency (e.g., 'domDispatcher').
-     * @param delegate - The function implementation provided by the adapter layer.
-     */
-    bindDelegate(key: string, delegate: AnyFunction): void;
-}
-/**
- * Contract for widgets that support programmatic control.
- *
- * This interface allows external systems—such as a Physical Gamepad Manager or
- * automation scripts—to directly drive the state and behavior of a widget,
- * bypassing native DOM pointer events.
- */
-interface IProgrammatic {
-    /**
-     * Manually triggers the 'down' (pressed) state of the widget.
-     * Primarily used for Button-type components to simulate a physical press.
-     */
-    triggerDown?(): void;
-    /**
-     * Manually triggers the 'up' (released) state of the widget.
-     * Primarily used for Button-type components to simulate a physical release.
-     */
-    triggerUp?(): void;
-    /**
-     * Manually updates the directional input vector of the widget.
-     * Primarily used for Joystick or D-Pad components.
-     *
-     * @param x - The horizontal component, normalized between -1.0 and 1.0.
-     * @param y - The vertical component, normalized between -1.0 and 1.0.
-     */
-    triggerVector?(x: number, y: number): void;
-}
-
 /**
  * =================================================================
  * 1. Constants Definition
@@ -957,16 +1524,20 @@ declare const ACTION_TYPES: {
  * 2. Type Definitions
  * =================================================================
  */
-/** * Represents an abstract bounding box, typically used as a
+/**
+ * Represents an abstract bounding box, typically used as a
  * lightweight alternative to the DOMRect interface.
  */
 interface AbstractRect {
     left: number;
+    right: number;
     top: number;
+    bottom: number;
     width: number;
     height: number;
 }
-/** * Represents abstract pointer data, providing a platform-agnostic
+/**
+ * Represents abstract pointer data, providing a platform-agnostic
  * alternative to the native PointerEvent.
  */
 interface AbstractPointerEvent {
@@ -1005,7 +1576,7 @@ type InputActionType = BuiltInActionType | (string & {});
  * Supported CSS units for layout calculation.
  * Using a constant array for runtime validation.
  */
-declare const VALID_UNITS: readonly ["px", "%", "vh", "vw", "rem", "em"];
+declare const VALID_UNITS: readonly ["px", "%", "vh", "vw", "vmin", "vmax", "rem", "em"];
 /**
  * Derived type for type safety in TS
  */
@@ -1073,4 +1644,4 @@ declare const CONTEXT: {
  */
 type AnyFunction = (...args: any[]) => void;
 
-export { type AbstractRect as A, type ButtonConfig as B, CMP_TYPES as C, type DPadConfig as D, type EntityType as E, type FlatConfigItem as F, type GamepadMappingConfig as G, type ILifecycle as H, type ICoreEntity as I, type JoystickConfig as J, type InputActionType as K, KEYS as L, type KeyMapping as M, type LayoutBox as N, type StandardButton as O, type ParsedLength as P, VALID_UNITS as Q, type WidgetType as R, type StageId as S, type TargetZoneConfig as T, type ZoneType as U, type Vec2 as V, type WidgetId as W, type ZoneId as Z, type InputActionSignal as a, type ISpatial as b, type IResettable as c, type IConfigurable as d, type IStateful as e, type IPointerHandler as f, type IProgrammatic as g, type AbstractPointerEvent as h, type InputZoneConfig as i, type IDependencyBindable as j, type AnyFunction as k, type BaseConfig as l, type ISignalReceiver as m, type TrackpadConfig as n, ACTION_TYPES as o, type ActionMapping as p, type AnchorPoint as q, type AnyConfig as r, type AnyEntityType as s, type BuiltInActionType as t, CONTEXT as u, type ConfigTreeNode as v, type CssUnit as w, type FlexibleLength as x, type GamepadProfile as y, type IIdentifiable as z };
+export { type AnyFunction as A, type BaseConfig as B, type ConfigTreeNode as C, type DPadConfig as D, type EntityType as E, type FlatConfigItem as F, type GamepadMappingConfig as G, type InputActionSignal as I, type JoystickConfig as J, KEYS as K, type LayoutBox as L, type OmniPadProfile as O, type ParsedLength as P, type StageId as S, type TargetZoneConfig as T, type Vec2 as V, type WidgetId as W, type ZoneId as Z, type AbstractRect as a, type ButtonConfig as b, type AbstractPointerEvent as c, type InputZoneConfig as d, type TrackpadConfig as e, ACTION_TYPES as f, type ActionMapping as g, type AnchorPoint as h, type AnyConfig as i, type AnyEntityType as j, type BuiltInActionType as k, CMP_TYPES as l, CONTEXT as m, type CssUnit as n, type FlexibleLength as o, type InputActionType as p, type KeyMapping as q, type StandardButton as r, VALID_UNITS as s, type WidgetType as t, type ZoneType as u };