chore: start getKeysDown

CONTRIBUTING.md

@@ -64,6 +64,7 @@ There is the structure of a JSDoc comment:
 - `@returns` for the return value description.
 - `@since` for the version when the member was added.
 - `@group` for the group of the member.
+- `@experimental` for indicate smt is in experimental phase
 
 Example:
 

src/app/app.ts

@@ -431,6 +431,32 @@ export const initApp = (opt: {
         state.events.trigger("buttonRelease", btn);
     }
 
+    // #region Pressed keys getters
+    function getKeysPressed(): Key[] {
+        return Array.from(state.keyState.pressed);
+    }
+
+    function getKeysDown(): Key[] {
+        return Array.from(state.keyState.down);
+    }
+
+    function getKeysReleased(): Key[] {
+        return Array.from(state.keyState.released);
+    }
+
+    function getButtonsPressed(): string[] {
+        return Array.from(state.buttonState.pressed);
+    }
+
+    function getButtonsDown(): string[] {
+        return Array.from(state.buttonState.down);
+    }
+
+    function getButtonsReleased(): string[] {
+        return Array.from(state.buttonState.released);
+    }
+    // #endregion
+
     function onResize(action: () => void): KEventController {
         return state.events.on("resize", action);
     }
@@ -1240,6 +1266,12 @@ export const initApp = (opt: {
         getButton,
         pressButton,
         releaseButton,
+        getKeysPressed,
+        getKeysDown,
+        getKeysReleased,
+        getButtonsPressed,
+        getButtonsDown,
+        getButtonsReleased,
         charInputted,
         onResize,
         onKeyDown,

src/types.ts

@@ -3584,6 +3584,30 @@ export interface KAPLAYCtx<
      * @group Input
      */
     releaseButton(btn: TButton): void;
+    /**
+     * Get all keys that was pressed current frame.
+     *
+     * @example
+     * ```js
+     * onMousePress(() => {
+     *     const keys = getKeysPressed();
+     *
+     *     if(keys.includes("k")) {
+     *         debug.log("You was pressing K!")
+     *     }
+     * });
+     * ```
+     *
+     * @returns A list of pressed keys.
+     * @since v3001.0.10
+     * @group Input
+     * @experimental This feature is in experimental phase, it will be fully released in v3001.1.0
+     */
+    getKeysPressed(): Key[];
+    /**
+     * Get all keys that are held down in current frame.
+     */
+    getKeysDown(): Key[];
     /**
      * Get stick axis values from a gamepad.
      *