koin.js 1.0.14 → 1.0.15

package/dist/index.js

@@ -1447,6 +1447,40 @@ var PlayerControls = React2.memo(function PlayerControls2({
   ] });
 });
 var PlayerControls_default = PlayerControls;
+function useAnimatedVisibility({
+  exitDuration = 200,
+  onExit,
+  autoDismissMs
+} = {}) {
+  const [isVisible, setIsVisible] = React2.useState(false);
+  const [isExiting, setIsExiting] = React2.useState(false);
+  React2.useEffect(() => {
+    requestAnimationFrame(() => {
+      setIsVisible(true);
+    });
+  }, []);
+  React2.useEffect(() => {
+    if (!autoDismissMs) return;
+    const timer = setTimeout(() => {
+      triggerExit();
+    }, autoDismissMs);
+    return () => clearTimeout(timer);
+  }, [autoDismissMs]);
+  const triggerExit = React2.useCallback(() => {
+    if (isExiting) return;
+    setIsExiting(true);
+    setTimeout(() => {
+      onExit?.();
+    }, exitDuration);
+  }, [isExiting, exitDuration, onExit]);
+  const slideInRightClasses = isVisible && !isExiting ? "translate-x-0 opacity-100" : "translate-x-full opacity-0";
+  return {
+    isVisible,
+    isExiting,
+    triggerExit,
+    slideInRightClasses
+  };
+}
 var TOAST_CONFIGS = {
   success: {
     icon: lucideReact.CheckCircle,
@@ -1491,32 +1525,20 @@ var TOAST_CONFIGS = {
   }
 };
 function ToastItem({ toast, onDismiss }) {
-  const [isVisible, setIsVisible] = React2.useState(false);
-  const [isExiting, setIsExiting] = React2.useState(false);
+  const { slideInRightClasses, triggerExit } = useAnimatedVisibility({
+    exitDuration: 200,
+    onExit: () => onDismiss?.(toast.id)
+  });
   const config = TOAST_CONFIGS[toast.type];
   const IconComponent = config.icon;
-  React2.useEffect(() => {
-    requestAnimationFrame(() => {
-      setIsVisible(true);
-    });
-  }, []);
-  const handleDismiss = () => {
-    setIsExiting(true);
-    setTimeout(() => {
-      onDismiss?.(toast.id);
-    }, 200);
-  };
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
-      className: `
-        relative transition-all duration-300 ease-out
-        ${isVisible && !isExiting ? "translate-x-0 opacity-100" : "translate-x-full opacity-0"}
-      `,
+      className: `relative transition-all duration-300 ease-out ${slideInRightClasses}`,
       children: /* @__PURE__ */ jsxRuntime.jsxs(
         "div",
         {
-          className: "relative w-[320px]",
+          className: "relative w-[320px] pointer-events-auto",
           style: {
             backgroundColor: config.bgColor,
             border: `2px solid ${config.borderColor}`,
@@ -1551,7 +1573,7 @@ function ToastItem({ toast, onDismiss }) {
                 {
                   onClick: () => {
                     toast.action?.onClick();
-                    handleDismiss();
+                    triggerExit();
                   },
                   className: "flex-shrink-0 text-[9px] font-black uppercase tracking-wider px-2 py-1 transition-all hover:-translate-y-0.5 active:translate-y-0",
                   style: {
@@ -1565,7 +1587,7 @@ function ToastItem({ toast, onDismiss }) {
               /* @__PURE__ */ jsxRuntime.jsx(
                 "button",
                 {
-                  onClick: handleDismiss,
+                  onClick: triggerExit,
                   className: "flex-shrink-0 p-0.5 text-gray-500 hover:text-white transition-colors",
                   children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 14 })
                 }
@@ -1938,6 +1960,67 @@ var RecordingIndicator = React2.memo(function RecordingIndicator2({
   );
 });
 var RecordingIndicator_default = RecordingIndicator;
+var MAX_WIDTH_CLASSES = {
+  sm: "max-w-sm",
+  md: "max-w-md",
+  lg: "max-w-lg"
+};
+function ModalShell({
+  isOpen,
+  onClose,
+  title,
+  subtitle,
+  icon,
+  children,
+  footer,
+  maxWidth = "lg",
+  systemColor,
+  closeOnBackdrop = true
+}) {
+  if (!isOpen) return null;
+  const handleBackdropClick = () => {
+    if (closeOnBackdrop) {
+      onClose();
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
+        onClick: handleBackdropClick
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        className: `relative bg-gray-900 border border-retro-primary/30 rounded-xl shadow-2xl w-full ${MAX_WIDTH_CLASSES[maxWidth]} mx-4 overflow-hidden`,
+        style: systemColor ? { borderColor: `${systemColor}30` } : void 0,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("div", { style: systemColor ? { color: systemColor } : void 0, children: icon }),
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+                /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: title }),
+                subtitle && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: subtitle })
+              ] })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "button",
+              {
+                onClick: onClose,
+                className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
+                children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
+              }
+            )
+          ] }),
+          children,
+          footer && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex items-center justify-between px-6 py-4 bg-black/30 border-t border-white/10", children: footer })
+        ]
+      }
+    )
+  ] });
+}
 var ShortcutsModal = React2.memo(function ShortcutsModal2({
   isOpen,
   onClose,
@@ -1966,90 +2049,55 @@ var ShortcutsModal = React2.memo(function ShortcutsModal2({
       ]
     }
   ], [t]);
-  if (!isOpen) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(
-    "div",
+    ModalShell,
     {
-      className: "absolute inset-0 z-50 flex items-center justify-center bg-black/80 backdrop-blur-sm",
-      onClick: onClose,
-      children: /* @__PURE__ */ jsxRuntime.jsxs(
-        "div",
-        {
-          className: "max-w-sm w-full mx-4 bg-black/95 border rounded-lg overflow-hidden",
-          style: { borderColor: `${systemColor}40` },
-          onClick: (e) => e.stopPropagation(),
-          children: [
-            /* @__PURE__ */ jsxRuntime.jsxs(
-              "div",
-              {
-                className: "flex items-center justify-between px-4 py-3 border-b",
-                style: { borderColor: `${systemColor}20`, backgroundColor: `${systemColor}10` },
-                children: [
-                  /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
-                    /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Keyboard, { size: 18, style: { color: systemColor } }),
-                    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-bold text-white", children: t.modals.shortcuts.playerShortcuts })
-                  ] }),
-                  /* @__PURE__ */ jsxRuntime.jsx(
-                    "button",
-                    {
-                      onClick: onClose,
-                      className: "p-1 rounded hover:bg-white/10 transition-colors",
-                      children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 18, className: "text-white/60 hover:text-white" })
-                    }
-                  )
-                ]
-              }
-            ),
-            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 space-y-3", children: [
-              shortcuts.map(({ section, items }) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+      isOpen,
+      onClose,
+      title: t.modals.shortcuts.playerShortcuts,
+      icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Keyboard, { size: 20, style: { color: systemColor } }),
+      maxWidth: "sm",
+      systemColor,
+      footer: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-gray-500 w-full text-center", children: t.modals.shortcuts.pressEsc }),
+      children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 space-y-3", children: [
+        shortcuts.map(({ section, items }) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "h3",
+            {
+              className: "text-[10px] font-bold uppercase tracking-wider mb-1.5 opacity-60",
+              style: { color: systemColor },
+              children: section
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-1", children: items.map(({ key, description }) => /* @__PURE__ */ jsxRuntime.jsxs(
+            "div",
+            {
+              className: "flex items-center justify-between text-sm",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-white/70", children: description }),
                 /* @__PURE__ */ jsxRuntime.jsx(
-                  "h3",
+                  "kbd",
                   {
-                    className: "text-[10px] font-bold uppercase tracking-wider mb-1.5 opacity-60",
-                    style: { color: systemColor },
-                    children: section
+                    className: "px-2 py-0.5 rounded text-xs font-mono font-bold",
+                    style: {
+                      backgroundColor: `${systemColor}20`,
+                      color: systemColor,
+                      border: `1px solid ${systemColor}40`
+                    },
+                    children: key
                   }
-                ),
-                /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-1", children: items.map(({ key, description }) => /* @__PURE__ */ jsxRuntime.jsxs(
-                  "div",
-                  {
-                    className: "flex items-center justify-between text-sm",
-                    children: [
-                      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-white/70", children: description }),
-                      /* @__PURE__ */ jsxRuntime.jsx(
-                        "kbd",
-                        {
-                          className: "px-2 py-0.5 rounded text-xs font-mono font-bold",
-                          style: {
-                            backgroundColor: `${systemColor}20`,
-                            color: systemColor,
-                            border: `1px solid ${systemColor}40`
-                          },
-                          children: key
-                        }
-                      )
-                    ]
-                  },
-                  key
-                )) })
-              ] }, section)),
-              /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "pt-2 border-t border-white/10 text-xs text-white/40", children: [
-                "Game controls can be configured in ",
-                /* @__PURE__ */ jsxRuntime.jsx("strong", { className: "text-white/60", children: t.controls.keys }),
-                " settings."
-              ] })
-            ] }),
-            /* @__PURE__ */ jsxRuntime.jsx(
-              "div",
-              {
-                className: "px-4 py-2 text-center text-xs text-white/40 border-t",
-                style: { borderColor: `${systemColor}20` },
-                children: t.modals.shortcuts.pressEsc
-              }
-            )
-          ]
-        }
-      )
+                )
+              ]
+            },
+            key
+          )) })
+        ] }, section)),
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "pt-2 border-t border-white/10 text-xs text-white/40", children: [
+          "Game controls can be configured in ",
+          /* @__PURE__ */ jsxRuntime.jsx("strong", { className: "text-white/60", children: t.controls.keys }),
+          " settings."
+        ] })
+      ] })
     }
   );
 });
@@ -2646,6 +2694,39 @@ function useTouchHandlers({
     cleanup
   };
 }
+function useTouchEvents(ref, handlers, options = {}) {
+  const { cleanup, passive = false } = options;
+  const handlersRef = React2.useRef(handlers);
+  handlersRef.current = handlers;
+  const handleTouchStart = React2.useCallback((e) => {
+    handlersRef.current.onTouchStart?.(e);
+  }, []);
+  const handleTouchMove = React2.useCallback((e) => {
+    handlersRef.current.onTouchMove?.(e);
+  }, []);
+  const handleTouchEnd = React2.useCallback((e) => {
+    handlersRef.current.onTouchEnd?.(e);
+  }, []);
+  const handleTouchCancel = React2.useCallback((e) => {
+    handlersRef.current.onTouchCancel?.(e);
+  }, []);
+  React2.useEffect(() => {
+    const element = ref.current;
+    if (!element) return;
+    const listenerOptions = { passive };
+    element.addEventListener("touchstart", handleTouchStart, listenerOptions);
+    element.addEventListener("touchmove", handleTouchMove, listenerOptions);
+    element.addEventListener("touchend", handleTouchEnd, listenerOptions);
+    element.addEventListener("touchcancel", handleTouchCancel, listenerOptions);
+    return () => {
+      element.removeEventListener("touchstart", handleTouchStart);
+      element.removeEventListener("touchmove", handleTouchMove);
+      element.removeEventListener("touchend", handleTouchEnd);
+      element.removeEventListener("touchcancel", handleTouchCancel);
+      cleanup?.();
+    };
+  }, [ref, passive, cleanup, handleTouchStart, handleTouchMove, handleTouchEnd, handleTouchCancel]);
+}
 
 // src/components/VirtualController/utils/buttonStyles.ts
 var DEFAULT_FACE = {
@@ -2803,21 +2884,12 @@ var VirtualButton = React2__default.default.memo(function VirtualButton2({
     onRelease,
     onPositionChange
   });
-  React2.useEffect(() => {
-    const button = buttonRef.current;
-    if (!button) return;
-    button.addEventListener("touchstart", handleTouchStart, { passive: false });
-    button.addEventListener("touchmove", handleTouchMove, { passive: false });
-    button.addEventListener("touchend", handleTouchEnd, { passive: false });
-    button.addEventListener("touchcancel", handleTouchCancel, { passive: false });
-    return () => {
-      button.removeEventListener("touchstart", handleTouchStart);
-      button.removeEventListener("touchmove", handleTouchMove);
-      button.removeEventListener("touchend", handleTouchEnd);
-      button.removeEventListener("touchcancel", handleTouchCancel);
-      cleanup();
-    };
-  }, [handleTouchStart, handleTouchMove, handleTouchEnd, handleTouchCancel, cleanup]);
+  useTouchEvents(buttonRef, {
+    onTouchStart: handleTouchStart,
+    onTouchMove: handleTouchMove,
+    onTouchEnd: handleTouchEnd,
+    onTouchCancel: handleTouchCancel
+  }, { cleanup });
   const leftPercent = displayX / 100 * containerWidth - config.size / 2;
   const topPercent = displayY / 100 * containerHeight - config.size / 2;
   const transform = `translate3d(${leftPercent.toFixed(1)}px, ${topPercent.toFixed(1)}px, 0)`;
@@ -3493,7 +3565,7 @@ function dispatchKeyboardEvent(type, code) {
   canvas.dispatchEvent(event);
   return true;
 }
-var CENTER_TOUCH_RADIUS = 0.25;
+var CENTER_TOUCH_RADIUS = 0.35;
 var Dpad = React2__default.default.memo(function Dpad2({
   size = 180,
   x,
@@ -3667,21 +3739,12 @@ var Dpad = React2__default.default.memo(function Dpad2({
       }
     }
   }, [getKeyCode, updateVisuals, drag]);
-  React2.useEffect(() => {
-    const dpad = dpadRef.current;
-    if (!dpad) return;
-    dpad.addEventListener("touchstart", handleTouchStart, { passive: false });
-    dpad.addEventListener("touchmove", handleTouchMove, { passive: false });
-    dpad.addEventListener("touchend", handleTouchEnd, { passive: false });
-    dpad.addEventListener("touchcancel", handleTouchEnd, { passive: false });
-    return () => {
-      dpad.removeEventListener("touchstart", handleTouchStart);
-      dpad.removeEventListener("touchmove", handleTouchMove);
-      dpad.removeEventListener("touchend", handleTouchEnd);
-      dpad.removeEventListener("touchcancel", handleTouchEnd);
-      drag.clearDragTimer();
-    };
-  }, [handleTouchStart, handleTouchMove, handleTouchEnd, drag]);
+  useTouchEvents(dpadRef, {
+    onTouchStart: handleTouchStart,
+    onTouchMove: handleTouchMove,
+    onTouchEnd: handleTouchEnd,
+    onTouchCancel: handleTouchEnd
+  }, { cleanup: drag.clearDragTimer });
   const leftPx = displayX / 100 * containerWidth - size / 2;
   const topPx = displayY / 100 * containerHeight - size / 2;
   const dUp = "M 35,5 L 65,5 L 65,35 L 50,50 L 35,35 Z";
@@ -3881,6 +3944,33 @@ function ControlsHint({ isVisible }) {
     }
   );
 }
+function LockButton({
+  isLocked,
+  onToggle,
+  systemColor = "#00FF41"
+}) {
+  const Icon = isLocked ? lucideReact.Lock : lucideReact.Unlock;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      onClick: onToggle,
+      className: "fixed top-4 left-1/2 -translate-x-1/2 z-40 pointer-events-auto p-2 rounded-full backdrop-blur-sm transition-all active:scale-95",
+      style: {
+        backgroundColor: isLocked ? "rgba(0,0,0,0.6)" : `${systemColor}20`,
+        border: `1px solid ${isLocked ? "rgba(255,255,255,0.2)" : systemColor}`
+      },
+      "aria-label": isLocked ? "Unlock controls for repositioning" : "Lock controls",
+      children: /* @__PURE__ */ jsxRuntime.jsx(
+        Icon,
+        {
+          size: 18,
+          style: { color: isLocked ? "rgba(255,255,255,0.6)" : systemColor }
+        }
+      )
+    }
+  );
+}
+var LOCK_KEY = "koin-controls-locked";
 function VirtualController({
   system,
   isRunning,
@@ -3892,7 +3982,21 @@ function VirtualController({
   const [pressedButtons, setPressedButtons] = React2.useState(/* @__PURE__ */ new Set());
   const [containerSize, setContainerSize] = React2.useState({ width: 0, height: 0 });
   const [isFullscreenState, setIsFullscreenState] = React2.useState(false);
+  const [isLocked, setIsLocked] = React2.useState(true);
   const { getPosition, savePosition } = useButtonPositions();
+  React2.useEffect(() => {
+    const stored = localStorage.getItem(LOCK_KEY);
+    if (stored !== null) {
+      setIsLocked(stored === "true");
+    }
+  }, []);
+  const toggleLock = React2.useCallback(() => {
+    setIsLocked((prev) => {
+      const newValue = !prev;
+      localStorage.setItem(LOCK_KEY, String(newValue));
+      return newValue;
+    });
+  }, []);
   const layout = getLayoutForSystem(system);
   const visibleButtons = layout.buttons.filter((btn) => {
     if (isPortrait) {
@@ -4047,6 +4151,14 @@ function VirtualController({
       className: "fixed inset-0 z-30 pointer-events-none",
       style: { touchAction: "none" },
       children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          LockButton,
+          {
+            isLocked,
+            onToggle: toggleLock,
+            systemColor
+          }
+        ),
         /* @__PURE__ */ jsxRuntime.jsx(
           Dpad_default,
           {
@@ -4059,7 +4171,7 @@ function VirtualController({
             systemColor,
             isLandscape,
             customPosition: getPosition("up", isLandscape),
-            onPositionChange: (x, y) => savePosition("up", x, y, isLandscape)
+            onPositionChange: isLocked ? void 0 : (x, y) => savePosition("up", x, y, isLandscape)
           }
         ),
         memoizedButtonElements.filter(({ buttonConfig }) => !DPAD_TYPES.includes(buttonConfig.type)).map(({ buttonConfig, adjustedConfig, customPosition, width, height }) => /* @__PURE__ */ jsxRuntime.jsx(
@@ -4073,7 +4185,7 @@ function VirtualController({
             containerWidth: width,
             containerHeight: height,
             customPosition,
-            onPositionChange: (x, y) => savePosition(buttonConfig.type, x, y, isLandscape),
+            onPositionChange: isLocked ? void 0 : (x, y) => savePosition(buttonConfig.type, x, y, isLandscape),
             isLandscape,
             console: layout.console
           },
@@ -4393,6 +4505,45 @@ var GameCanvas = React2.memo(function GameCanvas2({
   ] });
 });
 var GameCanvas_default = GameCanvas;
+function useInputCapture({
+  isOpen,
+  onClose
+}) {
+  const [listeningFor, setListeningFor] = React2.useState(null);
+  const startListening = React2.useCallback((target) => {
+    setListeningFor(target);
+  }, []);
+  const stopListening = React2.useCallback(() => {
+    setListeningFor(null);
+  }, []);
+  React2.useEffect(() => {
+    if (!isOpen) {
+      setListeningFor(null);
+    }
+  }, [isOpen]);
+  React2.useEffect(() => {
+    if (!isOpen) return;
+    const handleKeyDown = (e) => {
+      if (e.code === "Escape") {
+        if (listeningFor !== null) {
+          e.preventDefault();
+          e.stopPropagation();
+          setListeningFor(null);
+        } else {
+          onClose();
+        }
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [isOpen, listeningFor, onClose]);
+  return {
+    listeningFor,
+    startListening,
+    stopListening,
+    isListening: listeningFor !== null
+  };
+}
 function getFilteredGroups(activeButtons) {
   return BUTTON_GROUPS.map((group) => ({
     ...group,
@@ -4408,7 +4559,10 @@ function ControlMapper({
 }) {
   const t = useKoinTranslation();
   const [localControls, setLocalControls] = React2.useState(controls);
-  const [listeningFor, setListeningFor] = React2.useState(null);
+  const { listeningFor, startListening, stopListening, isListening } = useInputCapture({
+    isOpen,
+    onClose
+  });
   const activeButtons = React2.useMemo(() => {
     return getConsoleButtons(system || "SNES");
   }, [system]);
@@ -4424,27 +4578,20 @@ function ControlMapper({
     }
   }, [isOpen, controls]);
   React2.useEffect(() => {
-    if (!isOpen) {
-      setListeningFor(null);
-      return;
-    }
+    if (!isOpen || !listeningFor) return;
     const handleKeyDown = (e) => {
-      if (!listeningFor) return;
+      if (e.code === "Escape") return;
       e.preventDefault();
       e.stopPropagation();
-      if (e.code === "Escape") {
-        setListeningFor(null);
-        return;
-      }
       setLocalControls((prev) => ({
         ...prev,
         [listeningFor]: e.code
       }));
-      setListeningFor(null);
+      stopListening();
     };
     window.addEventListener("keydown", handleKeyDown);
     return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [isOpen, listeningFor]);
+  }, [isOpen, listeningFor, stopListening]);
   const handleReset = () => {
     setLocalControls(defaultControls);
   };
@@ -4452,52 +4599,58 @@ function ControlMapper({
     onSave(localControls);
     onClose();
   };
-  if (!isOpen) return null;
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "div",
-      {
-        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
-        onClick: onClose
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative bg-gray-900 border border-retro-primary/30 rounded-xl shadow-2xl w-full max-w-lg mx-4 overflow-hidden", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Gamepad2, { className: "text-retro-primary", size: 24 }),
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-            /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: t.modals.controls.title }),
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: t.modals.controls.description })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx(
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    ModalShell,
+    {
+      isOpen,
+      onClose,
+      title: t.modals.controls.title,
+      subtitle: t.modals.controls.description,
+      icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Gamepad2, { className: "text-retro-primary", size: 24 }),
+      closeOnBackdrop: !isListening,
+      footer: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(
+          "button",
+          {
+            onClick: handleReset,
+            className: "flex items-center gap-2 px-4 py-2 rounded-lg text-sm text-gray-400 hover:text-white hover:bg-white/10 transition-colors",
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(lucideReact.RotateCcw, { size: 16 }),
+              t.modals.controls.reset
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsxs(
           "button",
           {
-            onClick: onClose,
-            className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
-            children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
+            onClick: handleSave,
+            className: "flex items-center gap-2 px-6 py-2 rounded-lg bg-retro-primary text-black font-bold text-sm hover:bg-retro-primary/90 transition-colors",
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Check, { size: 16 }),
+              t.modals.controls.save
+            ]
           }
         )
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-6 max-h-[400px] overflow-y-auto", children: controlGroups.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+      children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-6 max-h-[400px] overflow-y-auto", children: controlGroups.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
         /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-xs font-bold text-gray-500 uppercase tracking-wider mb-2", children: group.label }),
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-2 gap-2", children: group.buttons.map((btn) => /* @__PURE__ */ jsxRuntime.jsxs(
           "button",
           {
-            onClick: () => setListeningFor(btn),
+            onClick: () => startListening(btn),
             className: `
-                      flex items-center justify-between px-4 py-3 rounded-lg border transition-all
-                      ${listeningFor === btn ? "border-retro-primary bg-retro-primary/20 ring-2 ring-retro-primary/50" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
-                    `,
+                                        flex items-center justify-between px-4 py-3 rounded-lg border transition-all
+                                        ${listeningFor === btn ? "border-retro-primary bg-retro-primary/20 ring-2 ring-retro-primary/50" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
+                                    `,
             children: [
               /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-gray-300", children: BUTTON_LABELS[btn] }),
               /* @__PURE__ */ jsxRuntime.jsx(
                 "span",
                 {
                   className: `
-                        px-2 py-1 rounded text-xs font-mono
-                        ${listeningFor === btn ? "bg-retro-primary/30 text-retro-primary animate-pulse" : "bg-black/50 text-white"}
-                      `,
+                                            px-2 py-1 rounded text-xs font-mono
+                                            ${listeningFor === btn ? "bg-retro-primary/30 text-retro-primary animate-pulse" : "bg-black/50 text-white"}
+                                        `,
                   children: listeningFor === btn ? t.modals.controls.pressKey : formatKeyCode(localControls[btn] || "")
                 }
               )
@@ -4505,199 +4658,10 @@ function ControlMapper({
           },
           btn
         )) })
-      ] }, group.label)) }),
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 bg-black/30 border-t border-white/10", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(
-          "button",
-          {
-            onClick: handleReset,
-            className: "flex items-center gap-2 px-4 py-2 rounded-lg text-sm text-gray-400 hover:text-white hover:bg-white/10 transition-colors",
-            children: [
-              /* @__PURE__ */ jsxRuntime.jsx(lucideReact.RotateCcw, { size: 16 }),
-              t.modals.controls.reset
-            ]
-          }
-        ),
-        /* @__PURE__ */ jsxRuntime.jsxs(
-          "button",
-          {
-            onClick: handleSave,
-            className: "flex items-center gap-2 px-6 py-2 rounded-lg bg-retro-primary text-black font-bold text-sm hover:bg-retro-primary/90 transition-colors",
-            children: [
-              /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Check, { size: 16 }),
-              t.modals.controls.save
-            ]
-          }
-        )
-      ] })
-    ] })
-  ] });
-}
-function getDisplayName(id) {
-  let name = id;
-  name = name.replace(/^[0-9a-f]{4}-[0-9a-f]{4}-/i, "");
-  name = name.replace(/\s*\(.*\)\s*$/i, "");
-  name = name.replace(/\s*STANDARD GAMEPAD\s*/i, "");
-  if (/xbox/i.test(name)) {
-    if (/series/i.test(name)) return "Xbox Series Controller";
-    if (/one/i.test(name)) return "Xbox One Controller";
-    if (/360/i.test(name)) return "Xbox 360 Controller";
-    return "Xbox Controller";
-  }
-  if (/dualsense/i.test(name)) return "DualSense";
-  if (/dualshock\s*4/i.test(name)) return "DualShock 4";
-  if (/dualshock/i.test(name)) return "DualShock";
-  if (/playstation/i.test(name) || /sony/i.test(name)) return "PlayStation Controller";
-  if (/pro\s*controller/i.test(name)) return "Switch Pro Controller";
-  if (/joy-?con/i.test(name)) return "Joy-Con";
-  if (/nintendo/i.test(name)) return "Nintendo Controller";
-  return name.trim() || "Gamepad";
-}
-function detectControllerBrand(id) {
-  const lowerId = id.toLowerCase();
-  if (/xbox|xinput|microsoft/i.test(lowerId)) return "xbox";
-  if (/playstation|sony|dualshock|dualsense/i.test(lowerId)) return "playstation";
-  if (/nintendo|switch|joy-?con|pro controller/i.test(lowerId)) return "nintendo";
-  return "generic";
-}
-function toGamepadInfo(gamepad) {
-  return {
-    index: gamepad.index,
-    id: gamepad.id,
-    name: getDisplayName(gamepad.id),
-    connected: gamepad.connected,
-    buttons: gamepad.buttons.length,
-    axes: gamepad.axes.length,
-    mapping: gamepad.mapping
-  };
-}
-function useGamepad(options) {
-  const { onConnect, onDisconnect } = options || {};
-  const [gamepads, setGamepads] = React2.useState([]);
-  const rafRef = React2.useRef(null);
-  const lastStateRef = React2.useRef("");
-  const prevCountRef = React2.useRef(0);
-  const onConnectRef = React2.useRef(onConnect);
-  const onDisconnectRef = React2.useRef(onDisconnect);
-  React2.useEffect(() => {
-    onConnectRef.current = onConnect;
-    onDisconnectRef.current = onDisconnect;
-  }, [onConnect, onDisconnect]);
-  const getGamepads = React2.useCallback(() => {
-    if (typeof navigator === "undefined" || typeof navigator.getGamepads !== "function") {
-      return [];
+      ] }, group.label)) })
     }
-    const rawGamepads = navigator.getGamepads() ?? [];
-    const connected = [];
-    for (let i = 0; i < rawGamepads.length; i++) {
-      const gp = rawGamepads[i];
-      if (gp && gp.connected) {
-        connected.push(toGamepadInfo(gp));
-      }
-    }
-    return connected;
-  }, []);
-  const getRawGamepad = React2.useCallback((index) => {
-    const rawGamepads = navigator.getGamepads?.() ?? [];
-    return rawGamepads[index] ?? null;
-  }, []);
-  const refresh = React2.useCallback(() => {
-    setGamepads(getGamepads());
-  }, [getGamepads]);
-  React2.useEffect(() => {
-    if (typeof window === "undefined" || typeof navigator === "undefined") {
-      return;
-    }
-    if (typeof navigator.getGamepads !== "function") {
-      console.warn("[useGamepad] Gamepad API not supported in this browser");
-      return;
-    }
-    let isActive = true;
-    const poll = () => {
-      if (!isActive) return;
-      const current = getGamepads();
-      let hasChanged = current.length !== prevCountRef.current;
-      if (!hasChanged) {
-        for (let i = 0; i < current.length; i++) {
-          const saved = gamepads[i];
-          if (!saved || saved.id !== current[i].id || saved.connected !== current[i].connected) {
-            hasChanged = true;
-            break;
-          }
-        }
-      }
-      if (hasChanged) {
-        const prevCount = prevCountRef.current;
-        const currentCount = current.length;
-        if (currentCount > prevCount && prevCount >= 0 && onConnectRef.current) {
-          const newGamepad = current[current.length - 1];
-          onConnectRef.current(newGamepad);
-        } else if (currentCount < prevCount && prevCount > 0 && onDisconnectRef.current) {
-          onDisconnectRef.current();
-        }
-        prevCountRef.current = currentCount;
-        setGamepads(current);
-      }
-      rafRef.current = requestAnimationFrame(poll);
-    };
-    const handleConnect = (e) => {
-      console.log("[useGamepad] \u{1F3AE} Gamepad connected:", e.gamepad.id);
-      const current = getGamepads();
-      const prevCount = prevCountRef.current;
-      prevCountRef.current = current.length;
-      lastStateRef.current = current.map((g) => `${g.index}:${g.id}`).join("|");
-      setGamepads(current);
-      if (onConnectRef.current && current.length > prevCount) {
-        const newGamepad = current[current.length - 1];
-        onConnectRef.current(newGamepad);
-      }
-    };
-    const handleDisconnect = (e) => {
-      console.log("[useGamepad] \u{1F3AE} Gamepad disconnected:", e.gamepad.id);
-      const current = getGamepads();
-      const prevCount = prevCountRef.current;
-      prevCountRef.current = current.length;
-      lastStateRef.current = current.map((g) => `${g.index}:${g.id}`).join("|");
-      setGamepads(current);
-      if (onDisconnectRef.current && current.length < prevCount) {
-        onDisconnectRef.current();
-      }
-    };
-    window.addEventListener("gamepadconnected", handleConnect);
-    window.addEventListener("gamepaddisconnected", handleDisconnect);
-    rafRef.current = requestAnimationFrame(poll);
-    const initial = getGamepads();
-    if (initial.length > 0) {
-      console.log("[useGamepad] Initial gamepads found:", initial.map((g) => g.name).join(", "));
-      prevCountRef.current = initial.length;
-      setGamepads(initial);
-      lastStateRef.current = initial.map((g) => `${g.index}:${g.id}`).join("|");
-    } else {
-      prevCountRef.current = 0;
-    }
-    return () => {
-      isActive = false;
-      if (rafRef.current) {
-        cancelAnimationFrame(rafRef.current);
-      }
-      window.removeEventListener("gamepadconnected", handleConnect);
-      window.removeEventListener("gamepaddisconnected", handleDisconnect);
-    };
-  }, [getGamepads]);
-  return {
-    gamepads,
-    isAnyConnected: gamepads.length > 0,
-    connectedCount: gamepads.length,
-    getRawGamepad,
-    refresh
-  };
+  );
 }
-var STANDARD_AXIS_MAP = {
-  leftStickX: 0,
-  leftStickY: 1,
-  rightStickX: 2,
-  rightStickY: 3
-};
 function GamepadMapper({
   isOpen,
   gamepads,
@@ -4708,7 +4672,10 @@ function GamepadMapper({
   const t = useKoinTranslation();
   const [selectedPlayer, setSelectedPlayer] = React2.useState(1);
   const [bindings, setBindings] = React2.useState({});
-  const [listeningFor, setListeningFor] = React2.useState(null);
+  const { listeningFor, startListening, stopListening, isListening } = useInputCapture({
+    isOpen,
+    onClose
+  });
   const rafRef = React2.useRef(null);
   React2.useEffect(() => {
     if (isOpen) {
@@ -4743,7 +4710,7 @@ function GamepadMapper({
                 [listeningFor]: i
               }
             }));
-            setListeningFor(null);
+            stopListening();
             return;
           }
         }
@@ -4756,21 +4723,7 @@ function GamepadMapper({
         cancelAnimationFrame(rafRef.current);
       }
     };
-  }, [isOpen, listeningFor, selectedPlayer]);
-  React2.useEffect(() => {
-    if (!isOpen) return;
-    const handleKeyDown = (e) => {
-      if (e.code === "Escape") {
-        if (listeningFor) {
-          setListeningFor(null);
-        } else {
-          onClose();
-        }
-      }
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [isOpen, listeningFor, onClose]);
+  }, [isOpen, listeningFor, selectedPlayer, stopListening]);
   const handleReset = () => {
     setBindings((prev) => ({
       ...prev,
@@ -4785,127 +4738,19 @@ function GamepadMapper({
     onSave?.(bindings[selectedPlayer], selectedPlayer);
     onClose();
   };
-  if (!isOpen) return null;
   const currentBindings = bindings[selectedPlayer] ?? DEFAULT_GAMEPAD;
   const currentGamepad = gamepads.find((g) => g.index === selectedPlayer - 1);
-  currentGamepad ? detectControllerBrand(currentGamepad.id) : "generic";
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "div",
-      {
-        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
-        onClick: () => !listeningFor && onClose()
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative bg-gray-900 border border-retro-primary/30 rounded-xl shadow-2xl w-full max-w-lg mx-4 overflow-hidden", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Joystick, { className: "text-retro-primary", size: 24, style: { color: systemColor } }),
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-            /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: t.modals.gamepad.title }),
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: gamepads.length > 0 ? t.modals.gamepad.connected.replace("{{count}}", gamepads.length.toString()) : t.modals.gamepad.none })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx(
-          "button",
-          {
-            onClick: onClose,
-            className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
-            children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
-          }
-        )
-      ] }),
-      gamepads.length > 1 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-6 py-3 border-b border-white/10 bg-black/30", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-gray-400 font-medium", children: t.modals.gamepad.player }),
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-1", children: gamepads.map((gp) => /* @__PURE__ */ jsxRuntime.jsxs(
-            "button",
-            {
-              onClick: () => setSelectedPlayer(gp.index + 1),
-              className: `
-                      flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium transition-all
-                      ${selectedPlayer === gp.index + 1 ? "bg-retro-primary/20 text-retro-primary" : "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"}
-                    `,
-              style: selectedPlayer === gp.index + 1 ? {
-                backgroundColor: `${systemColor}20`,
-                color: systemColor
-              } : {},
-              children: [
-                /* @__PURE__ */ jsxRuntime.jsx(lucideReact.User, { size: 14 }),
-                "P",
-                gp.index + 1
-              ]
-            },
-            gp.index
-          )) })
-        ] }),
-        currentGamepad && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 mt-1", children: currentGamepad.name })
-      ] }),
-      gamepads.length === 1 && currentGamepad && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-2 border-b border-white/10 bg-black/30", children: /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "text-xs text-gray-400", children: [
-        currentGamepad.name,
-        " \u2022 Player 1"
-      ] }) }),
-      gamepads.length === 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-6 py-10 text-center", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative inline-block mb-4", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Joystick, { size: 56, className: "text-gray-600 animate-pulse" }),
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 -m-2 rounded-full border-2 border-dashed border-gray-600 animate-spin", style: { animationDuration: "8s" } })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-gray-300 font-medium mb-2", children: t.modals.gamepad.noController }),
-        /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-gray-500 mb-4", children: t.modals.gamepad.pressAny }),
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "inline-flex items-center gap-2 px-4 py-2 rounded-lg bg-white/5 border border-white/10", children: [
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-gray-400", children: t.modals.gamepad.waiting }),
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex gap-1", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "0ms" } }),
-            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "150ms" } }),
-            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "300ms" } })
-          ] })
-        ] })
-      ] }),
-      gamepads.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 space-y-6 max-h-[400px] overflow-y-auto", children: [
-        listeningFor && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 rounded-lg bg-black/50 border border-retro-primary/50 text-center animate-pulse", style: { borderColor: `${systemColor}50` }, children: [
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-white mb-1", children: t.modals.gamepad.pressButton.replace("{{button}}", BUTTON_LABELS[listeningFor]) }),
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: t.modals.gamepad.pressEsc })
-        ] }),
-        BUTTON_GROUPS.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-          /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-xs font-bold text-gray-500 uppercase tracking-wider mb-2", children: group.label }),
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-2 gap-2", children: group.buttons.map((btn) => /* @__PURE__ */ jsxRuntime.jsxs(
-            "button",
-            {
-              onClick: () => setListeningFor(btn),
-              disabled: !!listeningFor && listeningFor !== btn,
-              className: `
-                        flex items-center justify-between px-4 py-3 rounded-lg border transition-all
-                        disabled:opacity-50
-                        ${listeningFor === btn ? "border-retro-primary bg-retro-primary/20 ring-2 ring-retro-primary/50" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
-                      `,
-              style: listeningFor === btn ? {
-                borderColor: systemColor,
-                backgroundColor: `${systemColor}20`,
-                boxShadow: `0 0 0 2px ${systemColor}50`
-              } : {},
-              children: [
-                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-gray-300", children: BUTTON_LABELS[btn] }),
-                /* @__PURE__ */ jsxRuntime.jsx(
-                  "span",
-                  {
-                    className: `
-                          px-2 py-1 rounded text-xs font-mono
-                          ${listeningFor === btn ? "bg-retro-primary/30 text-retro-primary animate-pulse" : "bg-black/50 text-white"}
-                        `,
-                    style: listeningFor === btn ? {
-                      backgroundColor: `${systemColor}30`,
-                      color: systemColor
-                    } : {},
-                    children: listeningFor === btn ? t.controls.press : formatGamepadButton(currentBindings[btn])
-                  }
-                )
-              ]
-            },
-            btn
-          )) })
-        ] }, group.label))
-      ] }),
-      gamepads.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 bg-black/30 border-t border-white/10", children: [
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    ModalShell,
+    {
+      isOpen,
+      onClose,
+      title: t.modals.gamepad.title,
+      subtitle: gamepads.length > 0 ? t.modals.gamepad.connected.replace("{{count}}", gamepads.length.toString()) : t.modals.gamepad.none,
+      icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Joystick, { size: 24, style: { color: systemColor } }),
+      systemColor,
+      closeOnBackdrop: !isListening,
+      footer: gamepads.length > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
         /* @__PURE__ */ jsxRuntime.jsxs(
           "button",
           {
@@ -4931,9 +4776,101 @@ function GamepadMapper({
             ]
           }
         )
-      ] })
-    ] })
-  ] });
+      ] }) : void 0,
+      children: [
+        gamepads.length > 1 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-6 py-3 border-b border-white/10 bg-black/30", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-gray-400 font-medium", children: t.modals.gamepad.player }),
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-1", children: gamepads.map((gp) => /* @__PURE__ */ jsxRuntime.jsxs(
+              "button",
+              {
+                onClick: () => setSelectedPlayer(gp.index + 1),
+                className: `
+                                        flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium transition-all
+                                        ${selectedPlayer === gp.index + 1 ? "bg-retro-primary/20 text-retro-primary" : "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"}
+                                    `,
+                style: selectedPlayer === gp.index + 1 ? {
+                  backgroundColor: `${systemColor}20`,
+                  color: systemColor
+                } : {},
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(lucideReact.User, { size: 14 }),
+                  "P",
+                  gp.index + 1
+                ]
+              },
+              gp.index
+            )) })
+          ] }),
+          currentGamepad && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 mt-1", children: currentGamepad.name })
+        ] }),
+        gamepads.length === 1 && currentGamepad && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-2 border-b border-white/10 bg-black/30", children: /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "text-xs text-gray-400", children: [
+          currentGamepad.name,
+          " \u2022 Player 1"
+        ] }) }),
+        gamepads.length === 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-6 py-10 text-center", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative inline-block mb-4", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Joystick, { size: 56, className: "text-gray-600 animate-pulse" }),
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 -m-2 rounded-full border-2 border-dashed border-gray-600 animate-spin", style: { animationDuration: "8s" } })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-gray-300 font-medium mb-2", children: t.modals.gamepad.noController }),
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-gray-500 mb-4", children: t.modals.gamepad.pressAny }),
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "inline-flex items-center gap-2 px-4 py-2 rounded-lg bg-white/5 border border-white/10", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-gray-400", children: t.modals.gamepad.waiting }),
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex gap-1", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "0ms" } }),
+              /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "150ms" } }),
+              /* @__PURE__ */ jsxRuntime.jsx("div", { className: "w-1.5 h-1.5 rounded-full bg-gray-500 animate-bounce", style: { animationDelay: "300ms" } })
+            ] })
+          ] })
+        ] }),
+        gamepads.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 space-y-6 max-h-[400px] overflow-y-auto", children: [
+          listeningFor && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-4 rounded-lg bg-black/50 border border-retro-primary/50 text-center animate-pulse", style: { borderColor: `${systemColor}50` }, children: [
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-white mb-1", children: t.modals.gamepad.pressButton.replace("{{button}}", BUTTON_LABELS[listeningFor]) }),
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: t.modals.gamepad.pressEsc })
+          ] }),
+          BUTTON_GROUPS.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-xs font-bold text-gray-500 uppercase tracking-wider mb-2", children: group.label }),
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-2 gap-2", children: group.buttons.map((btn) => /* @__PURE__ */ jsxRuntime.jsxs(
+              "button",
+              {
+                onClick: () => startListening(btn),
+                disabled: !!listeningFor && listeningFor !== btn,
+                className: `
+                                            flex items-center justify-between px-4 py-3 rounded-lg border transition-all
+                                            disabled:opacity-50
+                                            ${listeningFor === btn ? "border-retro-primary bg-retro-primary/20 ring-2 ring-retro-primary/50" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
+                                        `,
+                style: listeningFor === btn ? {
+                  borderColor: systemColor,
+                  backgroundColor: `${systemColor}20`,
+                  boxShadow: `0 0 0 2px ${systemColor}50`
+                } : {},
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-gray-300", children: BUTTON_LABELS[btn] }),
+                  /* @__PURE__ */ jsxRuntime.jsx(
+                    "span",
+                    {
+                      className: `
+                                                px-2 py-1 rounded text-xs font-mono
+                                                ${listeningFor === btn ? "bg-retro-primary/30 text-retro-primary animate-pulse" : "bg-black/50 text-white"}
+                                            `,
+                      style: listeningFor === btn ? {
+                        backgroundColor: `${systemColor}30`,
+                        color: systemColor
+                      } : {},
+                      children: listeningFor === btn ? t.controls.press : formatGamepadButton(currentBindings[btn])
+                    }
+                  )
+                ]
+              },
+              btn
+            )) })
+          ] }, group.label))
+        ] })
+      ]
+    }
+  );
 }
 function CheatModal({
   isOpen,
@@ -4941,42 +4878,24 @@ function CheatModal({
   activeCheats,
   onToggle,
   onClose
-}) {
-  const t = useKoinTranslation();
-  const [copiedId, setCopiedId] = React2__default.default.useState(null);
-  if (!isOpen) return null;
-  const handleCopy = async (code, id) => {
-    await navigator.clipboard.writeText(code);
-    setCopiedId(id);
-    setTimeout(() => setCopiedId(null), 2e3);
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "div",
-      {
-        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
-        onClick: onClose
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative bg-gray-900 border border-retro-primary/30 rounded-xl shadow-2xl w-full max-w-lg mx-4 overflow-hidden", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Code, { className: "text-purple-400", size: 24 }),
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-            /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: t.modals.cheats.title }),
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: t.modals.cheats.available.replace("{{count}}", cheats.length.toString()) })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx(
-          "button",
-          {
-            onClick: onClose,
-            className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
-            children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
-          }
-        )
-      ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-2 max-h-[400px] overflow-y-auto", children: cheats.length === 0 ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "text-center py-12 text-gray-500", children: [
+}) {
+  const t = useKoinTranslation();
+  const [copiedId, setCopiedId] = React2__default.default.useState(null);
+  const handleCopy = async (code, id) => {
+    await navigator.clipboard.writeText(code);
+    setCopiedId(id);
+    setTimeout(() => setCopiedId(null), 2e3);
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    ModalShell,
+    {
+      isOpen,
+      onClose,
+      title: t.modals.cheats.title,
+      subtitle: t.modals.cheats.available.replace("{{count}}", cheats.length.toString()),
+      icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Code, { size: 24, className: "text-purple-400" }),
+      footer: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 text-center w-full", children: activeCheats.size > 0 ? t.modals.cheats.active.replace("{{count}}", activeCheats.size.toString()) : t.modals.cheats.toggleHint }),
+      children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-2 max-h-[400px] overflow-y-auto", children: cheats.length === 0 ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "text-center py-12 text-gray-500", children: [
         /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Code, { size: 48, className: "mx-auto mb-3 opacity-50" }),
         /* @__PURE__ */ jsxRuntime.jsx("p", { className: "font-medium", children: t.modals.cheats.emptyTitle }),
         /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm mt-1", children: t.modals.cheats.emptyDesc })
@@ -4986,18 +4905,18 @@ function CheatModal({
           "div",
           {
             className: `
-                    group flex items-start gap-4 p-4 rounded-lg border transition-all cursor-pointer
-                    ${isActive ? "border-purple-500/50 bg-purple-500/10" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
-                  `,
+                                    group flex items-start gap-4 p-4 rounded-lg border transition-all cursor-pointer
+                                    ${isActive ? "border-purple-500/50 bg-purple-500/10" : "border-white/10 bg-white/5 hover:border-white/20 hover:bg-white/10"}
+                                `,
             onClick: () => onToggle(cheat.id),
             children: [
               /* @__PURE__ */ jsxRuntime.jsx(
                 "div",
                 {
                   className: `
-                      flex-shrink-0 w-6 h-6 rounded border-2 flex items-center justify-center transition-all
-                      ${isActive ? "border-purple-500 bg-purple-500" : "border-gray-600 group-hover:border-gray-400"}
-                    `,
+                                        flex-shrink-0 w-6 h-6 rounded border-2 flex items-center justify-center transition-all
+                                        ${isActive ? "border-purple-500 bg-purple-500" : "border-gray-600 group-hover:border-gray-400"}
+                                    `,
                   children: isActive && /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Check, { size: 14, className: "text-white" })
                 }
               ),
@@ -5023,10 +4942,9 @@ function CheatModal({
           },
           cheat.id
         );
-      }) }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-3 bg-black/30 border-t border-white/10", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 text-center", children: activeCheats.size > 0 ? t.modals.cheats.active.replace("{{count}}", activeCheats.size.toString()) : t.modals.cheats.toggleHint }) })
-    ] })
-  ] });
+      }) })
+    }
+  );
 }
 var AUTO_SAVE_SLOT = 5;
 function formatBytes(bytes) {
@@ -5067,7 +4985,6 @@ function SaveSlotModal({
   onUpgrade
 }) {
   const t = useKoinTranslation();
-  if (!isOpen) return null;
   const isSaveMode = mode === "save";
   const allSlots = [1, 2, 3, 4, 5];
   const isUnlimited = maxSlots === -1 || maxSlots >= 5;
@@ -5082,33 +4999,17 @@ function SaveSlotModal({
   const getSlotData = (slotNum) => {
     return slots.find((s) => s.slot === slotNum);
   };
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "div",
-      {
-        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
-        onClick: onClose
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative bg-gray-900 border border-retro-primary/30 rounded-xl shadow-2xl w-full max-w-md mx-4 overflow-hidden", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-          isSaveMode ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Save, { className: "text-retro-primary", size: 24 }) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Download, { className: "text-retro-primary", size: 24 }),
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-            /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: isSaveMode ? t.modals.saveSlots.saveTitle : t.modals.saveSlots.loadTitle }),
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-400", children: isSaveMode ? t.modals.saveSlots.subtitleSave : t.modals.saveSlots.subtitleLoad })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx(
-          "button",
-          {
-            onClick: onClose,
-            className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
-            children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
-          }
-        )
-      ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-2 max-h-[400px] overflow-y-auto", children: isLoading ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col items-center justify-center py-12 text-gray-400", children: [
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    ModalShell,
+    {
+      isOpen,
+      onClose,
+      title: isSaveMode ? t.modals.saveSlots.saveTitle : t.modals.saveSlots.loadTitle,
+      subtitle: isSaveMode ? t.modals.saveSlots.subtitleSave : t.modals.saveSlots.subtitleLoad,
+      icon: isSaveMode ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Save, { className: "text-retro-primary", size: 24 }) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Download, { className: "text-retro-primary", size: 24 }),
+      maxWidth: "md",
+      footer: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 text-center w-full", children: isSaveMode ? t.modals.saveSlots.footerSave : t.modals.saveSlots.footerLoad }),
+      children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-4 space-y-2 max-h-[400px] overflow-y-auto", children: isLoading ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col items-center justify-center py-12 text-gray-400", children: [
         /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Loader2, { className: "w-8 h-8 animate-spin mb-3" }),
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm", children: t.modals.saveSlots.loading })
       ] }) : displaySlots.map((slotNum) => {
@@ -5227,10 +5128,9 @@ function SaveSlotModal({
           },
           slotNum
         );
-      }) }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-3 bg-black/30 border-t border-white/10", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-gray-500 text-center", children: isSaveMode ? t.modals.saveSlots.footerSave : t.modals.saveSlots.footerLoad }) })
-    ] })
-  ] });
+      }) })
+    }
+  );
 }
 function BiosSelectionModal({
   isOpen,
@@ -5377,36 +5277,28 @@ function SettingsModal({
   systemColor = "#00FF41"
 }) {
   const t = useKoinTranslation();
-  if (!isOpen) return null;
   const languages = [
     { code: "en", name: "English" },
     { code: "es", name: "Espa\xF1ol" },
     { code: "fr", name: "Fran\xE7ais" }
   ];
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fixed inset-0 z-50 flex items-center justify-center", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "div",
-      {
-        className: "absolute inset-0 bg-black/80 backdrop-blur-sm",
-        onClick: onClose
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative bg-gray-900 border border-white/10 rounded-xl shadow-2xl w-full max-w-sm mx-4 overflow-hidden animate-in fade-in zoom-in-95 duration-200", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between px-6 py-4 border-b border-white/10 bg-black/50", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Settings, { className: "text-white", size: 20 }),
-          /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-white", children: t.settings.title })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx(
-          "button",
-          {
-            onClick: onClose,
-            className: "p-2 rounded-lg hover:bg-white/10 text-gray-400 hover:text-white transition-colors",
-            children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 20 })
-          }
-        )
-      ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-6 space-y-6", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-3", children: [
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    ModalShell,
+    {
+      isOpen,
+      onClose,
+      title: t.settings.title,
+      icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Settings, { size: 20, className: "text-white" }),
+      maxWidth: "sm",
+      footer: /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          onClick: onClose,
+          className: "text-sm text-gray-500 hover:text-white transition-colors w-full text-center",
+          children: t.modals.shortcuts.pressEsc
+        }
+      ),
+      children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "p-6 space-y-6", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-3", children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2 text-sm font-medium text-gray-400", children: [
           /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Globe, { size: 16 }),
           /* @__PURE__ */ jsxRuntime.jsx("span", { children: t.settings.language })
@@ -5418,9 +5310,9 @@ function SettingsModal({
             {
               onClick: () => onLanguageChange(lang.code),
               className: `
-                                            flex items-center justify-between px-4 py-3 rounded-lg border transition-all
-                                            ${isActive ? "bg-white/10 border-white/20 text-white" : "bg-black/20 border-transparent text-gray-400 hover:bg-white/5 hover:text-white"}
-                                        `,
+                                        flex items-center justify-between px-4 py-3 rounded-lg border transition-all
+                                        ${isActive ? "bg-white/10 border-white/20 text-white" : "bg-black/20 border-transparent text-gray-400 hover:bg-white/5 hover:text-white"}
+                                    `,
               children: [
                 /* @__PURE__ */ jsxRuntime.jsx("span", { children: lang.name }),
                 isActive && /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Check, { size: 16, style: { color: systemColor } })
@@ -5429,17 +5321,9 @@ function SettingsModal({
             lang.code
           );
         }) })
-      ] }) }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-4 bg-black/30 border-t border-white/10 text-center", children: /* @__PURE__ */ jsxRuntime.jsx(
-        "button",
-        {
-          onClick: onClose,
-          className: "text-sm text-gray-500 hover:text-white transition-colors",
-          children: t.modals.shortcuts.pressEsc
-        }
-      ) })
-    ] })
-  ] });
+      ] }) })
+    }
+  );
 }
 function GameModals({
   controlsModalOpen,
@@ -7650,6 +7534,171 @@ var useNostalgist = ({
   ]);
   return hookReturn;
 };
+function getDisplayName(id) {
+  let name = id;
+  name = name.replace(/^[0-9a-f]{4}-[0-9a-f]{4}-/i, "");
+  name = name.replace(/\s*\(.*\)\s*$/i, "");
+  name = name.replace(/\s*STANDARD GAMEPAD\s*/i, "");
+  if (/xbox/i.test(name)) {
+    if (/series/i.test(name)) return "Xbox Series Controller";
+    if (/one/i.test(name)) return "Xbox One Controller";
+    if (/360/i.test(name)) return "Xbox 360 Controller";
+    return "Xbox Controller";
+  }
+  if (/dualsense/i.test(name)) return "DualSense";
+  if (/dualshock\s*4/i.test(name)) return "DualShock 4";
+  if (/dualshock/i.test(name)) return "DualShock";
+  if (/playstation/i.test(name) || /sony/i.test(name)) return "PlayStation Controller";
+  if (/pro\s*controller/i.test(name)) return "Switch Pro Controller";
+  if (/joy-?con/i.test(name)) return "Joy-Con";
+  if (/nintendo/i.test(name)) return "Nintendo Controller";
+  return name.trim() || "Gamepad";
+}
+function detectControllerBrand(id) {
+  const lowerId = id.toLowerCase();
+  if (/xbox|xinput|microsoft/i.test(lowerId)) return "xbox";
+  if (/playstation|sony|dualshock|dualsense/i.test(lowerId)) return "playstation";
+  if (/nintendo|switch|joy-?con|pro controller/i.test(lowerId)) return "nintendo";
+  return "generic";
+}
+function toGamepadInfo(gamepad) {
+  return {
+    index: gamepad.index,
+    id: gamepad.id,
+    name: getDisplayName(gamepad.id),
+    connected: gamepad.connected,
+    buttons: gamepad.buttons.length,
+    axes: gamepad.axes.length,
+    mapping: gamepad.mapping
+  };
+}
+function useGamepad(options) {
+  const { onConnect, onDisconnect } = options || {};
+  const [gamepads, setGamepads] = React2.useState([]);
+  const rafRef = React2.useRef(null);
+  const lastStateRef = React2.useRef("");
+  const prevCountRef = React2.useRef(0);
+  const onConnectRef = React2.useRef(onConnect);
+  const onDisconnectRef = React2.useRef(onDisconnect);
+  React2.useEffect(() => {
+    onConnectRef.current = onConnect;
+    onDisconnectRef.current = onDisconnect;
+  }, [onConnect, onDisconnect]);
+  const getGamepads = React2.useCallback(() => {
+    if (typeof navigator === "undefined" || typeof navigator.getGamepads !== "function") {
+      return [];
+    }
+    const rawGamepads = navigator.getGamepads() ?? [];
+    const connected = [];
+    for (let i = 0; i < rawGamepads.length; i++) {
+      const gp = rawGamepads[i];
+      if (gp && gp.connected) {
+        connected.push(toGamepadInfo(gp));
+      }
+    }
+    return connected;
+  }, []);
+  const getRawGamepad = React2.useCallback((index) => {
+    const rawGamepads = navigator.getGamepads?.() ?? [];
+    return rawGamepads[index] ?? null;
+  }, []);
+  const refresh = React2.useCallback(() => {
+    setGamepads(getGamepads());
+  }, [getGamepads]);
+  React2.useEffect(() => {
+    if (typeof window === "undefined" || typeof navigator === "undefined") {
+      return;
+    }
+    if (typeof navigator.getGamepads !== "function") {
+      console.warn("[useGamepad] Gamepad API not supported in this browser");
+      return;
+    }
+    let isActive = true;
+    const poll = () => {
+      if (!isActive) return;
+      const current = getGamepads();
+      let hasChanged = current.length !== prevCountRef.current;
+      if (!hasChanged) {
+        for (let i = 0; i < current.length; i++) {
+          const saved = gamepads[i];
+          if (!saved || saved.id !== current[i].id || saved.connected !== current[i].connected) {
+            hasChanged = true;
+            break;
+          }
+        }
+      }
+      if (hasChanged) {
+        const prevCount = prevCountRef.current;
+        const currentCount = current.length;
+        if (currentCount > prevCount && prevCount >= 0 && onConnectRef.current) {
+          const newGamepad = current[current.length - 1];
+          onConnectRef.current(newGamepad);
+        } else if (currentCount < prevCount && prevCount > 0 && onDisconnectRef.current) {
+          onDisconnectRef.current();
+        }
+        prevCountRef.current = currentCount;
+        setGamepads(current);
+      }
+      rafRef.current = requestAnimationFrame(poll);
+    };
+    const handleConnect = (e) => {
+      console.log("[useGamepad] \u{1F3AE} Gamepad connected:", e.gamepad.id);
+      const current = getGamepads();
+      const prevCount = prevCountRef.current;
+      prevCountRef.current = current.length;
+      lastStateRef.current = current.map((g) => `${g.index}:${g.id}`).join("|");
+      setGamepads(current);
+      if (onConnectRef.current && current.length > prevCount) {
+        const newGamepad = current[current.length - 1];
+        onConnectRef.current(newGamepad);
+      }
+    };
+    const handleDisconnect = (e) => {
+      console.log("[useGamepad] \u{1F3AE} Gamepad disconnected:", e.gamepad.id);
+      const current = getGamepads();
+      const prevCount = prevCountRef.current;
+      prevCountRef.current = current.length;
+      lastStateRef.current = current.map((g) => `${g.index}:${g.id}`).join("|");
+      setGamepads(current);
+      if (onDisconnectRef.current && current.length < prevCount) {
+        onDisconnectRef.current();
+      }
+    };
+    window.addEventListener("gamepadconnected", handleConnect);
+    window.addEventListener("gamepaddisconnected", handleDisconnect);
+    rafRef.current = requestAnimationFrame(poll);
+    const initial = getGamepads();
+    if (initial.length > 0) {
+      console.log("[useGamepad] Initial gamepads found:", initial.map((g) => g.name).join(", "));
+      prevCountRef.current = initial.length;
+      setGamepads(initial);
+      lastStateRef.current = initial.map((g) => `${g.index}:${g.id}`).join("|");
+    } else {
+      prevCountRef.current = 0;
+    }
+    return () => {
+      isActive = false;
+      if (rafRef.current) {
+        cancelAnimationFrame(rafRef.current);
+      }
+      window.removeEventListener("gamepadconnected", handleConnect);
+      window.removeEventListener("gamepaddisconnected", handleDisconnect);
+    };
+  }, [getGamepads]);
+  return {
+    gamepads,
+    isAnyConnected: gamepads.length > 0,
+    connectedCount: gamepads.length,
+    getRawGamepad,
+    refresh
+  };
+}
+var STANDARD_AXIS_MAP = {
+  leftStickX: 0,
+  leftStickY: 1,
+  rightStickX: 2,
+  rightStickY: 3
+};
 function useVolume({
   setVolume: setVolumeInHook,
   toggleMute: toggleMuteInHook
@@ -9537,27 +9586,15 @@ function AchievementPopup({
   onDismiss,
   autoDismissMs = 5e3
 }) {
-  const [isVisible, setIsVisible] = React2.useState(false);
-  const [isExiting, setIsExiting] = React2.useState(false);
-  React2.useEffect(() => {
-    requestAnimationFrame(() => {
-      setIsVisible(true);
-    });
-    const timer = setTimeout(() => {
-      handleDismiss();
-    }, autoDismissMs);
-    return () => clearTimeout(timer);
-  }, [autoDismissMs]);
-  const handleDismiss = () => {
-    setIsExiting(true);
-    setTimeout(() => {
-      onDismiss();
-    }, 300);
-  };
+  const { slideInRightClasses, triggerExit } = useAnimatedVisibility({
+    exitDuration: 300,
+    onExit: onDismiss,
+    autoDismissMs
+  });
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      className: `fixed top-4 right-4 z-[100] transition-all duration-300 ${isVisible && !isExiting ? "translate-x-0 opacity-100" : "translate-x-full opacity-0"}`,
+      className: `fixed top-4 right-4 z-[100] transition-all duration-300 ${slideInRightClasses}`,
       children: [
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 bg-gradient-to-r from-yellow-500 to-orange-500 blur-lg opacity-50 animate-pulse" }),
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative bg-gradient-to-r from-yellow-500 to-orange-500 p-[2px] rounded-lg", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-gray-900 rounded-lg p-4 flex items-center gap-4 min-w-[320px]", children: [
@@ -9594,7 +9631,7 @@ function AchievementPopup({
           /* @__PURE__ */ jsxRuntime.jsx(
             "button",
             {
-              onClick: handleDismiss,
+              onClick: triggerExit,
               className: "flex-shrink-0 text-gray-500 hover:text-white transition-colors",
               children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 18 })
             }