Carried over from https://github.com/NotRexed/Hookshot/pull/2886.
Cherry-picked source: 157985b00e5481ec8751298c571591920d5f2894.
Resolve rename/context conflicts without changing feature behaviour.
Keep measured configurations in the PR description, not the shared table.

Assisted-by: OpenAI GPT-6 Astra
Co-Authored-By: OpenAI GPT-6 Astra <[email protected]>

@@ -3304,2 +3307,2 @@
-            const float a = col_x[col] + (col == kCtlPrimary ? 0 : 3 * s), b = col_x[col + 1] - (keyboard ? 0 : 3 * s);
-            const std::string v = keyboard ? keys_text(ctl.button) : disabled ? "-" : pad_name(host->binding(HOS_BIND_PAD, ctl.button, col));
+            const bool keyboard = col == kCtlKeyboard, toggle = col == kCtlToggle;
+            const bool disabled = (keys && !keyboard) || (toggle && ctl.button >= HOS_SW_N);

@@ -11,6 +11,7 @@
    while one of the game's own menus is open (host/oot_menu.c: hos_mouse_game_menu each frame it runs), its clicks and
    wheel for that menu (hos_mouse_game_pointer). */
 #include "hos.h"
+void hos_input_clear_toggles(void);

@@ -189,6 +190,7 @@ static void gm_cursor_off(HWND w) {
    back, if the window still has the focus */
 static void menus_mouse(HWND w, int insert_open, int game_open) {
     const int was = menu_open || game_menu_open, now = insert_open || game_open, game_was = game_menu_open;
+    if ((insert_open && !menu_open) || (game_open && !game_was)) hos_input_clear_toggles();

@@ -1088,1 +1093,4 @@
         const int menu_open = rx_option(1, 0);
+        static HoldToggle toggles;
+        const uint64_t enabled = (uint32_t)rx_option(HOS_OPT_HOLD_TOGGLE, 0);
+        const int reset = InterlockedExchange(&toggle_reset, 0) || menu_open || (enabled && !game_in_front());

@@ -55,2 +55,4 @@
    90, 120, 144, 165, 240, 6 Uncapped; a change applies in play) */
 enum { HOS_OPT_FPS_CAP = 53 };
+/* Hold-to-toggle's enabled Switch buttons, 1 << HOS_SW_*. Off (zero) by default; the existing option callback. */
+enum { HOS_OPT_HOLD_TOGGLE = 54 };

@@ -3304,2 +3307,2 @@
-            const float a = col_x[col] + (col == kCtlPrimary ? 0 : 3 * s), b = col_x[col + 1] - (keyboard ? 0 : 3 * s);
-            const std::string v = keyboard ? keys_text(ctl.button) : disabled ? "-" : pad_name(host->binding(HOS_BIND_PAD, ctl.button, col));
+            const bool keyboard = col == kCtlKeyboard, toggle = col == kCtlToggle;
+            const bool disabled = (keys && !keyboard) || (toggle && ctl.button >= HOS_SW_N);

@@ -1088,1 +1093,4 @@
         const int menu_open = rx_option(1, 0);
+        static HoldToggle toggles;
+        const uint64_t enabled = (uint32_t)rx_option(HOS_OPT_HOLD_TOGGLE, 0);
+        const int reset = InterlockedExchange(&toggle_reset, 0) || menu_open || (enabled && !game_in_front());

@@ -1089,0 +1096,4 @@
+        const int reset = InterlockedExchange(&toggle_reset, 0) || menu_open || (enabled && !game_in_front());
+        /* Pause/map must release shield/aim before the game's menu reads input. */
+        const uint64_t pause = buttons & ~toggles.previous & ((1ULL << B_PLUS) | (1ULL << B_MINUS));
+        buttons = hold_toggle_apply(&toggles, buttons, enabled, reset || pause);