@antha/input 0.1.3 → 0.3.0

package/dist/bindings/antha-menu-nav.mod.d.ts

@@ -58,12 +58,26 @@ export type MenuNavOptions = Readonly<Partial<{
      * @default {milliseconds: 60}
      */
     repeatInterval: Readonly<AnyDuration>;
+    /**
+     * The minimum input value required to trigger directional menu navigation. Helps prevent
+     * unintentional perpendicular navigation with joysticks in 2D menus.
+     *
+     * @default 0.8
+     */
+    minimumDirectionalInputValue: number;
     /**
      * Allow wrapping when navigating menu items.
      *
      * @default true
      */
     allowWrapping: boolean;
+    /**
+     * Prevent a one-dimensional nav tree from using its available axis for perpendicular
+     * navigation.
+     *
+     * @default false
+     */
+    blockPerpendicularNavigation: boolean;
 }>>;
 /**
  * State for {@link createAnthaMenuNavMod}.

package/dist/bindings/antha-menu-nav.mod.js

@@ -40,6 +40,12 @@ export var MenuNavBinding;
     MenuNavBinding["MenuSectionPrevious"] = "menu-section-previous";
     MenuNavBinding["OpenPauseMenu"] = "open-pause-menu";
 })(MenuNavBinding || (MenuNavBinding = {}));
+const directionalMenuNavBindings = [
+    MenuNavBinding.MenuUp,
+    MenuNavBinding.MenuDown,
+    MenuNavBinding.MenuLeft,
+    MenuNavBinding.MenuRight,
+];
 /**
  * Default menu nav bindings for {@link AnthaMenuNavMod}.
  *
@@ -223,7 +229,9 @@ export const defaultMenuNavOptions = {
     repeatInterval: {
         milliseconds: 60,
     },
+    minimumDirectionalInputValue: 0.8,
     allowWrapping: true,
+    blockPerpendicularNavigation: false,
 };
 /**
  * A pre-built mod that enables menu navigation. Set `isInMenu` on your game state to true to
@@ -257,6 +265,7 @@ export function createAnthaMenuNavMod(options = {}) {
             const repeatInterval = convertDuration(state.menuNavOptions.repeatInterval, {
                 milliseconds: true,
             }).milliseconds;
+            const minimumDirectionalInputValue = state.menuNavOptions.minimumDirectionalInputValue;
             const bindingsToAct = {};
             const activeMenuBindings = {};
             getObjectTypedValues(state.activeBindings).forEach((playerActiveBindings) => {
@@ -265,11 +274,13 @@ export function createAnthaMenuNavMod(options = {}) {
                         return;
                     }
                     activeMenuBindings[bindingName] = true;
-                    if (!activeBinding.actCount ||
-                        (activeBinding.holdDuration.milliseconds >= repeatThreshold &&
-                            activeBinding.holdDuration.milliseconds -
-                                activeBinding.lastActDuration.milliseconds >
-                                repeatInterval)) {
+                    if ((!directionalMenuNavBindings.includes(bindingName) ||
+                        activeBinding.value >= minimumDirectionalInputValue) &&
+                        (!activeBinding.actCount ||
+                            (activeBinding.holdDuration.milliseconds >= repeatThreshold &&
+                                activeBinding.holdDuration.milliseconds -
+                                    activeBinding.lastActDuration.milliseconds >
+                                    repeatInterval))) {
                         bindingsToAct[bindingName] = true;
                         activeBinding.actCount++;
                         activeBinding.lastActDuration = activeBinding.holdDuration;
@@ -300,6 +311,7 @@ export function createAnthaMenuNavMod(options = {}) {
             if (sectionDirection) {
                 state.navController.navigatePibling({
                     allowWrapping: state.menuNavOptions.allowWrapping,
+                    blockPerpendicularNavigation: state.menuNavOptions.blockPerpendicularNavigation,
                     direction: sectionDirection,
                 });
                 return;
@@ -319,12 +331,14 @@ export function createAnthaMenuNavMod(options = {}) {
             if (vertical) {
                 state.navController.navigate({
                     allowWrapping: state.menuNavOptions.allowWrapping,
+                    blockPerpendicularNavigation: state.menuNavOptions.blockPerpendicularNavigation,
                     direction: vertical,
                 });
             }
             if (horizontal) {
                 state.navController.navigate({
                     allowWrapping: state.menuNavOptions.allowWrapping,
+                    blockPerpendicularNavigation: state.menuNavOptions.blockPerpendicularNavigation,
                     direction: horizontal,
                 });
             }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@antha/input",
-    "version": "0.1.3",
+    "version": "0.3.0",
     "description": "An Antha mod for handling inputs.",
     "keywords": [
         "vir",
@@ -33,14 +33,14 @@
         "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@antha/gamepad-type": "^0.1.3",
+        "@antha/gamepad-type": "^0.3.0",
         "@augment-vir/assert": "^32.2.3",
         "@augment-vir/common": "^32.2.3",
         "date-vir": "^9.1.1",
-        "device-navigation": "^4.7.3",
+        "device-navigation": "^4.8.0",
         "input-device-handler": "^9.0.4",
         "object-shape-tester": "^6.15.0",
-        "vira": "^31.31.2"
+        "vira": "^31.31.4"
     },
     "devDependencies": {
         "@augment-vir/test": "^32.2.3",
@@ -51,7 +51,7 @@
         "istanbul-smart-text-reporter": "^1.1.5"
     },
     "peerDependencies": {
-        "@antha/engine": "^0.1.3",
+        "@antha/engine": "^0.3.0",
         "element-vir": ">=26"
     },
     "engines": {