browser-shortcuts 0.1.0

package/dist/react.d.cts

@@ -0,0 +1,65 @@
+import * as react from 'react';
+
+declare const KEYBINDS: {
+    'CTRL+SHIFT+F': "toggleFullScreen";
+    'CMD+SHIFT+F': "toggleFullScreen";
+    'CTRL+SHIFT+G': "toggleGrid";
+    'CMD+SHIFT+G': "toggleGrid";
+    'CTRL+SHIFT+H': "toggleHelp";
+    'CMD+SHIFT+H': "toggleHelp";
+    ESCAPE: "closeOverlay";
+    'CTRL+Z': "undo";
+    'CMD+Z': "undo";
+    'CTRL+SHIFT+Z': "redo";
+    'CMD+SHIFT+Z': "redo";
+    'CTRL+Y': "redo";
+    DELETE: "delete";
+    BACKSPACE: "delete";
+    'CTRL+A': "selectAll";
+    'CMD+A': "selectAll";
+    'CTRL+C': "copy";
+    'CMD+C': "copy";
+    'CTRL+V': "paste";
+    'CMD+V': "paste";
+    'CTRL+S': "save";
+    'CMD+S': "save";
+    DOUBLE_LEFT_BUTTON: "zoomIn";
+    LEFT_BUTTON: "leftMouseButton";
+    MIDDLE_BUTTON: "middleMouseButton";
+    RIGHT_BUTTON: "rightMouseButton";
+};
+/** A key combination string understood by {@link KEYBINDS}, e.g. `"CTRL+SHIFT+F"`. */
+type Keybind = keyof typeof KEYBINDS;
+
+/** Callback invoked when a bound shortcut fires. */
+type ShortcutListener = (event: Event) => void;
+
+interface ShortcutsContextProps {
+    /** Registers `callback` to run whenever `shortcut` is triggered. */
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /** Removes a `callback` previously registered with {@link ShortcutsContextProps.on}. */
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+}
+declare const ShortcutsContext: react.Context<ShortcutsContextProps>;
+/**
+ * Provides global keyboard, mouse and wheel shortcut handling to its
+ * subtree via {@link ShortcutsContext}.
+ */
+declare function ShortcutsContextProvider({ children, }: {
+    children: React.ReactNode;
+}): react.JSX.Element;
+/**
+ * Subscribes `callback` to `shortcut` for as long as the calling component
+ * is mounted. Must be used within a `ShortcutsContextProvider`.
+ *
+ * @param shortcut - A key combination string, e.g. `"CTRL+SHIFT+F"`.
+ * @param callback - Invoked with the originating `Event` when the shortcut fires.
+ *
+ * @example
+ * ```tsx
+ * useShortcut('CTRL+SHIFT+F', () => setFullScreen((prev) => !prev));
+ * ```
+ */
+declare function useShortcut(shortcut: Keybind, callback: (event: Event) => void): void;
+
+export { type ShortcutListener, ShortcutsContext, type ShortcutsContextProps, ShortcutsContextProvider, useShortcut };

package/dist/react.d.ts

@@ -0,0 +1,65 @@
+import * as react from 'react';
+
+declare const KEYBINDS: {
+    'CTRL+SHIFT+F': "toggleFullScreen";
+    'CMD+SHIFT+F': "toggleFullScreen";
+    'CTRL+SHIFT+G': "toggleGrid";
+    'CMD+SHIFT+G': "toggleGrid";
+    'CTRL+SHIFT+H': "toggleHelp";
+    'CMD+SHIFT+H': "toggleHelp";
+    ESCAPE: "closeOverlay";
+    'CTRL+Z': "undo";
+    'CMD+Z': "undo";
+    'CTRL+SHIFT+Z': "redo";
+    'CMD+SHIFT+Z': "redo";
+    'CTRL+Y': "redo";
+    DELETE: "delete";
+    BACKSPACE: "delete";
+    'CTRL+A': "selectAll";
+    'CMD+A': "selectAll";
+    'CTRL+C': "copy";
+    'CMD+C': "copy";
+    'CTRL+V': "paste";
+    'CMD+V': "paste";
+    'CTRL+S': "save";
+    'CMD+S': "save";
+    DOUBLE_LEFT_BUTTON: "zoomIn";
+    LEFT_BUTTON: "leftMouseButton";
+    MIDDLE_BUTTON: "middleMouseButton";
+    RIGHT_BUTTON: "rightMouseButton";
+};
+/** A key combination string understood by {@link KEYBINDS}, e.g. `"CTRL+SHIFT+F"`. */
+type Keybind = keyof typeof KEYBINDS;
+
+/** Callback invoked when a bound shortcut fires. */
+type ShortcutListener = (event: Event) => void;
+
+interface ShortcutsContextProps {
+    /** Registers `callback` to run whenever `shortcut` is triggered. */
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /** Removes a `callback` previously registered with {@link ShortcutsContextProps.on}. */
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+}
+declare const ShortcutsContext: react.Context<ShortcutsContextProps>;
+/**
+ * Provides global keyboard, mouse and wheel shortcut handling to its
+ * subtree via {@link ShortcutsContext}.
+ */
+declare function ShortcutsContextProvider({ children, }: {
+    children: React.ReactNode;
+}): react.JSX.Element;
+/**
+ * Subscribes `callback` to `shortcut` for as long as the calling component
+ * is mounted. Must be used within a `ShortcutsContextProvider`.
+ *
+ * @param shortcut - A key combination string, e.g. `"CTRL+SHIFT+F"`.
+ * @param callback - Invoked with the originating `Event` when the shortcut fires.
+ *
+ * @example
+ * ```tsx
+ * useShortcut('CTRL+SHIFT+F', () => setFullScreen((prev) => !prev));
+ * ```
+ */
+declare function useShortcut(shortcut: Keybind, callback: (event: Event) => void): void;
+
+export { type ShortcutListener, ShortcutsContext, type ShortcutsContextProps, ShortcutsContextProvider, useShortcut };

package/dist/react.js

@@ -0,0 +1,258 @@
+'use client';
+"use client";
+
+// src/config/shortcuts.ts
+var KEYBINDS = {
+  "CTRL+SHIFT+F": "toggleFullScreen",
+  "CMD+SHIFT+F": "toggleFullScreen",
+  "CTRL+SHIFT+G": "toggleGrid",
+  "CMD+SHIFT+G": "toggleGrid",
+  "CTRL+SHIFT+H": "toggleHelp",
+  "CMD+SHIFT+H": "toggleHelp",
+  ESCAPE: "closeOverlay",
+  "CTRL+Z": "undo",
+  "CMD+Z": "undo",
+  "CTRL+SHIFT+Z": "redo",
+  "CMD+SHIFT+Z": "redo",
+  "CTRL+Y": "redo",
+  DELETE: "delete",
+  BACKSPACE: "delete",
+  "CTRL+A": "selectAll",
+  "CMD+A": "selectAll",
+  "CTRL+C": "copy",
+  "CMD+C": "copy",
+  "CTRL+V": "paste",
+  "CMD+V": "paste",
+  "CTRL+S": "save",
+  "CMD+S": "save",
+  DOUBLE_LEFT_BUTTON: "zoomIn",
+  LEFT_BUTTON: "leftMouseButton",
+  MIDDLE_BUTTON: "middleMouseButton",
+  RIGHT_BUTTON: "rightMouseButton"
+};
+var SHORTCUTS = {
+  toggleFullScreen: (event) => {
+    console.log("toggleFullScreen", event);
+  },
+  toggleGrid: (event) => {
+    console.log("toggleGrid", event);
+  },
+  toggleHelp: (event) => {
+    console.log("toggleHelp", event);
+  },
+  closeOverlay: (event) => {
+    console.log("closeOverlay", event);
+  },
+  undo: (event) => {
+    console.log("undo", event);
+  },
+  redo: (event) => {
+    console.log("redo", event);
+  },
+  delete: (event) => {
+    console.log("delete", event);
+  },
+  selectAll: (event) => {
+    console.log("selectAll", event);
+  },
+  copy: (event) => {
+    console.log("copy", event);
+  },
+  paste: (event) => {
+    console.log("paste", event);
+  },
+  save: (event) => {
+    console.log("save", event);
+  },
+  zoomIn: (event) => {
+    console.log("zoomIn", event);
+  },
+  leftMouseButton: (event) => {
+    console.log("leftMouseButton", event);
+  },
+  middleMouseButton: (event) => {
+    console.log("middleMouseButton", event);
+  },
+  rightMouseButton: (event) => {
+    console.log("rightMouseButton", event);
+  }
+};
+var shortcuts_default = KEYBINDS;
+
+// src/utils/misc.ts
+var IS_MAC = typeof navigator !== "undefined" && navigator.platform.toUpperCase().indexOf("MAC") >= 0;
+var IS_NOT_TOUCH_DEVICE = (() => {
+  if (typeof window === "undefined" || typeof navigator === "undefined") {
+    return false;
+  }
+  return !("ontouchstart" in window || navigator.maxTouchPoints > 0 || "msMaxTouchPoints" in navigator && navigator.msMaxTouchPoints > 0);
+})();
+var MOUSE_BUTTONS = ["LEFT_BUTTON", "MIDDLE_BUTTON", "RIGHT_BUTTON"];
+function buildShortcutString(key, event) {
+  return [
+    IS_MAC && event.metaKey ? "CMD" : "",
+    event.ctrlKey ? "CTRL" : "",
+    event.altKey ? "ALT" : "",
+    event.shiftKey ? "SHIFT" : "",
+    key.toUpperCase()
+  ].filter(Boolean).join("+");
+}
+
+// src/core/shortcuts-manager.ts
+var ShortcutsManager = class {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+    /** Registers `callback` to run whenever `shortcut` is triggered. */
+    this.on = (shortcut, callback) => {
+      var _a;
+      if (!this.listeners.has(shortcut)) {
+        this.listeners.set(shortcut, /* @__PURE__ */ new Set());
+      }
+      (_a = this.listeners.get(shortcut)) == null ? void 0 : _a.add(callback);
+    };
+    /** Removes a `callback` previously registered with {@link on}. */
+    this.off = (shortcut, callback) => {
+      var _a;
+      (_a = this.listeners.get(shortcut)) == null ? void 0 : _a.delete(callback);
+    };
+    this.emit = (shortcut, event) => {
+      var _a;
+      (_a = this.listeners.get(shortcut)) == null ? void 0 : _a.forEach((callback) => callback(event));
+    };
+    this.triggerShortcut = (shortcut, event) => {
+      var _a, _b;
+      this.emit(shortcut, event);
+      const action = shortcuts_default[shortcut];
+      if (action) {
+        event.preventDefault();
+        if (typeof action === "string") {
+          (_b = (_a = SHORTCUTS)[action]) == null ? void 0 : _b.call(_a, event);
+        } else {
+          action(event);
+        }
+      }
+    };
+    /**
+     * Starts listening on `target` (`window` by default). Returns a disposer
+     * that removes the listeners; safe to call multiple times.
+     */
+    this.attach = (target = window) => {
+      this.detach();
+      this.target = target;
+      const handleKeyDown = (event) => {
+        const keyboardEvent = event;
+        this.triggerShortcut(
+          buildShortcutString(keyboardEvent.key, keyboardEvent),
+          event
+        );
+      };
+      const handleKeyUp = (event) => {
+        const keyboardEvent = event;
+        this.triggerShortcut(
+          buildShortcutString(`${keyboardEvent.key}_UP`, keyboardEvent),
+          event
+        );
+      };
+      const handleMouseDown = (event) => {
+        const mouseEvent = event;
+        this.triggerShortcut(
+          buildShortcutString(MOUSE_BUTTONS[mouseEvent.button], mouseEvent),
+          event
+        );
+      };
+      const handleMouseUp = (event) => {
+        const mouseEvent = event;
+        this.triggerShortcut(
+          buildShortcutString(
+            `${MOUSE_BUTTONS[mouseEvent.button]}_UP`,
+            mouseEvent
+          ),
+          event
+        );
+      };
+      const handleDoubleClick = (event) => {
+        const mouseEvent = event;
+        this.triggerShortcut(
+          buildShortcutString(
+            `DOUBLE_${MOUSE_BUTTONS[mouseEvent.button]}`,
+            mouseEvent
+          ),
+          event
+        );
+      };
+      const handleContextMenu = (event) => {
+        this.triggerShortcut(
+          buildShortcutString("RIGHT_BUTTON", event),
+          event
+        );
+      };
+      const handleWheel = (event) => {
+        const wheelEvent = event;
+        const direction = wheelEvent.deltaY < 0 ? "WHEEL_UP" : "WHEEL_DOWN";
+        this.triggerShortcut(buildShortcutString(direction, wheelEvent), event);
+      };
+      target.addEventListener("keydown", handleKeyDown);
+      target.addEventListener("keyup", handleKeyUp);
+      target.addEventListener("mousedown", handleMouseDown);
+      target.addEventListener("mouseup", handleMouseUp);
+      target.addEventListener("dblclick", handleDoubleClick);
+      target.addEventListener("contextmenu", handleContextMenu);
+      target.addEventListener("wheel", handleWheel, { passive: true });
+      this.cleanup = () => {
+        target.removeEventListener("keydown", handleKeyDown);
+        target.removeEventListener("keyup", handleKeyUp);
+        target.removeEventListener("mousedown", handleMouseDown);
+        target.removeEventListener("mouseup", handleMouseUp);
+        target.removeEventListener("dblclick", handleDoubleClick);
+        target.removeEventListener("contextmenu", handleContextMenu);
+        target.removeEventListener("wheel", handleWheel);
+        this.target = void 0;
+        this.cleanup = void 0;
+      };
+      return this.cleanup;
+    };
+    /** Stops listening. Safe to call even if {@link attach} was never called. */
+    this.detach = () => {
+      var _a;
+      (_a = this.cleanup) == null ? void 0 : _a.call(this);
+    };
+  }
+};
+
+// src/react/index.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useLayoutEffect,
+  useState
+} from "react";
+import { jsx } from "react/jsx-runtime";
+var ShortcutsContext = createContext(
+  {}
+);
+function ShortcutsContextProvider({
+  children
+}) {
+  const [manager] = useState(() => new ShortcutsManager());
+  useLayoutEffect(() => {
+    return manager.attach();
+  }, [manager]);
+  const { on, off } = manager;
+  return /* @__PURE__ */ jsx(ShortcutsContext.Provider, { value: { on, off }, children });
+}
+function useShortcut(shortcut, callback) {
+  const { on, off } = useContext(ShortcutsContext);
+  useEffect(() => {
+    on(shortcut, callback);
+    return () => {
+      off(shortcut, callback);
+    };
+  }, [shortcut, callback, on, off]);
+}
+export {
+  ShortcutsContext,
+  ShortcutsContextProvider,
+  useShortcut
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/shortcuts.ts","../src/utils/misc.ts","../src/core/shortcuts-manager.ts","../src/react/index.tsx"],"sourcesContent":["/**\n * Maps a keybind string (e.g. `\"CTRL+SHIFT+F\"`) to either the name of a\n * {@link SHORTCUTS} entry or an inline handler.\n *\n * Prefer referencing a named entry in {@link SHORTCUTS} so the same action\n * can be triggered programmatically (e.g. from a command palette) using the\n * same {@link Shortcut} name.\n */\nexport type KeybindAction = Shortcut | ((event: Event) => void);\n\nconst KEYBINDS = {\n  'CTRL+SHIFT+F': 'toggleFullScreen',\n  'CMD+SHIFT+F': 'toggleFullScreen',\n  'CTRL+SHIFT+G': 'toggleGrid',\n  'CMD+SHIFT+G': 'toggleGrid',\n  'CTRL+SHIFT+H': 'toggleHelp',\n  'CMD+SHIFT+H': 'toggleHelp',\n  ESCAPE: 'closeOverlay',\n  'CTRL+Z': 'undo',\n  'CMD+Z': 'undo',\n  'CTRL+SHIFT+Z': 'redo',\n  'CMD+SHIFT+Z': 'redo',\n  'CTRL+Y': 'redo',\n  DELETE: 'delete',\n  BACKSPACE: 'delete',\n  'CTRL+A': 'selectAll',\n  'CMD+A': 'selectAll',\n  'CTRL+C': 'copy',\n  'CMD+C': 'copy',\n  'CTRL+V': 'paste',\n  'CMD+V': 'paste',\n  'CTRL+S': 'save',\n  'CMD+S': 'save',\n  DOUBLE_LEFT_BUTTON: 'zoomIn',\n  LEFT_BUTTON: 'leftMouseButton',\n  MIDDLE_BUTTON: 'middleMouseButton',\n  RIGHT_BUTTON: 'rightMouseButton',\n} satisfies { [key: string]: KeybindAction };\n\n/**\n * Named shortcut handlers, keyed by {@link Shortcut} name. Referenced from\n * {@link KEYBINDS} by name so the same action can be triggered from\n * multiple bindings (or invoked directly, outside of any input event).\n */\nexport const SHORTCUTS = {\n  toggleFullScreen: (event: Event) => {\n    console.log('toggleFullScreen', event);\n  },\n  toggleGrid: (event: Event) => {\n    console.log('toggleGrid', event);\n  },\n  toggleHelp: (event: Event) => {\n    console.log('toggleHelp', event);\n  },\n  closeOverlay: (event: Event) => {\n    console.log('closeOverlay', event);\n  },\n  undo: (event: Event) => {\n    console.log('undo', event);\n  },\n  redo: (event: Event) => {\n    console.log('redo', event);\n  },\n  delete: (event: Event) => {\n    console.log('delete', event);\n  },\n  selectAll: (event: Event) => {\n    console.log('selectAll', event);\n  },\n  copy: (event: Event) => {\n    console.log('copy', event);\n  },\n  paste: (event: Event) => {\n    console.log('paste', event);\n  },\n  save: (event: Event) => {\n    console.log('save', event);\n  },\n  zoomIn: (event: Event) => {\n    console.log('zoomIn', event);\n  },\n  leftMouseButton: (event: Event) => {\n    console.log('leftMouseButton', event);\n  },\n  middleMouseButton: (event: Event) => {\n    console.log('middleMouseButton', event);\n  },\n  rightMouseButton: (event: Event) => {\n    console.log('rightMouseButton', event);\n  },\n};\n\n/** A key combination string understood by {@link KEYBINDS}, e.g. `\"CTRL+SHIFT+F\"`. */\nexport type Keybind = keyof typeof KEYBINDS;\n\n/** The name of a handler registered in {@link SHORTCUTS}. */\nexport type Shortcut = keyof typeof SHORTCUTS;\n\nexport default KEYBINDS;\n","import type { Keybind } from '@/config';\n\n/** Whether the current platform reports itself as macOS (used to prefer `CMD` over `CTRL`). */\nexport const IS_MAC =\n  typeof navigator !== 'undefined' &&\n  navigator.platform.toUpperCase().indexOf('MAC') >= 0;\n\n/** Whether the current device supports mouse/keyboard input rather than touch only. */\nexport const IS_NOT_TOUCH_DEVICE = (() => {\n  if (typeof window === 'undefined' || typeof navigator === 'undefined') {\n    return false;\n  }\n  return !(\n    'ontouchstart' in window ||\n    navigator.maxTouchPoints > 0 ||\n    ('msMaxTouchPoints' in navigator &&\n      (navigator.msMaxTouchPoints as number) > 0)\n  );\n})();\n\n/** Names for `MouseEvent.button` values 0, 1 and 2, in that order. */\nexport const MOUSE_BUTTONS = ['LEFT_BUTTON', 'MIDDLE_BUTTON', 'RIGHT_BUTTON'];\n\n/**\n * Builds a {@link Keybind} string (e.g. `\"CTRL+SHIFT+F\"`) from a base key\n * name and the modifier keys held during the triggering event.\n *\n * @param key - The key or button name, e.g. `\"F\"` or `\"LEFT_BUTTON\"`.\n * @param event - The DOM event the key combination is derived from.\n */\nexport function buildShortcutString(\n  key: string,\n  event: KeyboardEvent | MouseEvent | WheelEvent,\n): Keybind {\n  return [\n    IS_MAC && event.metaKey ? 'CMD' : '',\n    event.ctrlKey ? 'CTRL' : '',\n    event.altKey ? 'ALT' : '',\n    event.shiftKey ? 'SHIFT' : '',\n    key.toUpperCase(),\n  ]\n    .filter(Boolean)\n    .join('+') as Keybind;\n}\n","import KEYBINDS, {\n  SHORTCUTS,\n  type Keybind,\n  type KeybindAction,\n  type Shortcut,\n} from '@/config/shortcuts';\nimport { buildShortcutString, MOUSE_BUTTONS } from '@/utils/misc';\n\n/** Callback invoked when a bound shortcut fires. */\nexport type ShortcutListener = (event: Event) => void;\n\n/**\n * Framework-agnostic keyboard, mouse and wheel shortcut dispatcher.\n *\n * Listens for the most commonly used input events (`keydown`, `keyup`,\n * `mousedown`, `mouseup`, `dblclick`, `contextmenu` and `wheel`) on a target\n * (`window` by default), converts each into a {@link Keybind} string, and\n * dispatches it to any listeners registered with {@link on} as well as the\n * static bindings declared in `KEYBINDS`.\n *\n * Every framework adapter in this package (React, Vue, Svelte, Angular,\n * Solid, Preact) wraps a single instance of this class in that framework's\n * own idioms (context/provider, composable, store, service, etc.).\n */\nexport class ShortcutsManager {\n  private listeners = new Map<Keybind, Set<ShortcutListener>>();\n  private target: EventTarget | undefined;\n  private cleanup: (() => void) | undefined;\n\n  /** Registers `callback` to run whenever `shortcut` is triggered. */\n  on = (shortcut: Keybind, callback: ShortcutListener): void => {\n    if (!this.listeners.has(shortcut)) {\n      this.listeners.set(shortcut, new Set());\n    }\n    this.listeners.get(shortcut)?.add(callback);\n  };\n\n  /** Removes a `callback` previously registered with {@link on}. */\n  off = (shortcut: Keybind, callback: ShortcutListener): void => {\n    this.listeners.get(shortcut)?.delete(callback);\n  };\n\n  private emit = (shortcut: Keybind, event: Event): void => {\n    this.listeners.get(shortcut)?.forEach((callback) => callback(event));\n  };\n\n  private triggerShortcut = (shortcut: Keybind, event: Event): void => {\n    this.emit(shortcut, event);\n\n    const action = KEYBINDS[shortcut] as KeybindAction | undefined;\n    if (action) {\n      event.preventDefault();\n      if (typeof action === 'string') {\n        SHORTCUTS[action as Shortcut]?.(event);\n      } else {\n        action(event);\n      }\n    }\n  };\n\n  /**\n   * Starts listening on `target` (`window` by default). Returns a disposer\n   * that removes the listeners; safe to call multiple times.\n   */\n  attach = (target: EventTarget = window): (() => void) => {\n    this.detach();\n    this.target = target;\n\n    const handleKeyDown = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      this.triggerShortcut(\n        buildShortcutString(keyboardEvent.key, keyboardEvent),\n        event,\n      );\n    };\n\n    const handleKeyUp = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      this.triggerShortcut(\n        buildShortcutString(`${keyboardEvent.key}_UP`, keyboardEvent),\n        event,\n      );\n    };\n\n    const handleMouseDown = (event: Event) => {\n      const mouseEvent = event as MouseEvent;\n      this.triggerShortcut(\n        buildShortcutString(MOUSE_BUTTONS[mouseEvent.button], mouseEvent),\n        event,\n      );\n    };\n\n    const handleMouseUp = (event: Event) => {\n      const mouseEvent = event as MouseEvent;\n      this.triggerShortcut(\n        buildShortcutString(\n          `${MOUSE_BUTTONS[mouseEvent.button]}_UP`,\n          mouseEvent,\n        ),\n        event,\n      );\n    };\n\n    const handleDoubleClick = (event: Event) => {\n      const mouseEvent = event as MouseEvent;\n      this.triggerShortcut(\n        buildShortcutString(\n          `DOUBLE_${MOUSE_BUTTONS[mouseEvent.button]}`,\n          mouseEvent,\n        ),\n        event,\n      );\n    };\n\n    const handleContextMenu = (event: Event) => {\n      this.triggerShortcut(\n        buildShortcutString('RIGHT_BUTTON', event as MouseEvent),\n        event,\n      );\n    };\n\n    const handleWheel = (event: Event) => {\n      const wheelEvent = event as WheelEvent;\n      const direction = wheelEvent.deltaY < 0 ? 'WHEEL_UP' : 'WHEEL_DOWN';\n      this.triggerShortcut(buildShortcutString(direction, wheelEvent), event);\n    };\n\n    target.addEventListener('keydown', handleKeyDown);\n    target.addEventListener('keyup', handleKeyUp);\n    target.addEventListener('mousedown', handleMouseDown);\n    target.addEventListener('mouseup', handleMouseUp);\n    target.addEventListener('dblclick', handleDoubleClick);\n    target.addEventListener('contextmenu', handleContextMenu);\n    target.addEventListener('wheel', handleWheel, { passive: true });\n\n    this.cleanup = () => {\n      target.removeEventListener('keydown', handleKeyDown);\n      target.removeEventListener('keyup', handleKeyUp);\n      target.removeEventListener('mousedown', handleMouseDown);\n      target.removeEventListener('mouseup', handleMouseUp);\n      target.removeEventListener('dblclick', handleDoubleClick);\n      target.removeEventListener('contextmenu', handleContextMenu);\n      target.removeEventListener('wheel', handleWheel);\n      this.target = undefined;\n      this.cleanup = undefined;\n    };\n\n    return this.cleanup;\n  };\n\n  /** Stops listening. Safe to call even if {@link attach} was never called. */\n  detach = (): void => {\n    this.cleanup?.();\n  };\n}\n","'use client';\n\nimport type { Keybind } from '@/config';\nimport { ShortcutsManager, type ShortcutListener } from '@/core/shortcuts-manager';\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useState,\n} from 'react';\n\nexport type { ShortcutListener } from '@/core/shortcuts-manager';\n\nexport interface ShortcutsContextProps {\n  /** Registers `callback` to run whenever `shortcut` is triggered. */\n  on: (shortcut: Keybind, callback: ShortcutListener) => void;\n  /** Removes a `callback` previously registered with {@link ShortcutsContextProps.on}. */\n  off: (shortcut: Keybind, callback: ShortcutListener) => void;\n}\n\nexport const ShortcutsContext = createContext<ShortcutsContextProps>(\n  {} as ShortcutsContextProps,\n);\n\n/**\n * Provides global keyboard, mouse and wheel shortcut handling to its\n * subtree via {@link ShortcutsContext}.\n */\nexport function ShortcutsContextProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const [manager] = useState(() => new ShortcutsManager());\n\n  useLayoutEffect(() => {\n    return manager.attach();\n  }, [manager]);\n\n  const { on, off } = manager;\n\n  return (\n    <ShortcutsContext.Provider value={{ on, off }}>\n      {children}\n    </ShortcutsContext.Provider>\n  );\n}\n\n/**\n * Subscribes `callback` to `shortcut` for as long as the calling component\n * is mounted. Must be used within a `ShortcutsContextProvider`.\n *\n * @param shortcut - A key combination string, e.g. `\"CTRL+SHIFT+F\"`.\n * @param callback - Invoked with the originating `Event` when the shortcut fires.\n *\n * @example\n * ```tsx\n * useShortcut('CTRL+SHIFT+F', () => setFullScreen((prev) => !prev));\n * ```\n */\nexport function useShortcut(\n  shortcut: Keybind,\n  callback: (event: Event) => void,\n) {\n  const { on, off } = useContext(ShortcutsContext);\n\n  useEffect(() => {\n    on(shortcut, callback);\n\n    return () => {\n      off(shortcut, callback);\n    };\n  }, [shortcut, callback, on, off]);\n}\n"],"mappings":"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","names":[]}