browser-shortcuts 0.1.0

package/dist/index.cjs

@@ -0,0 +1,260 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  IS_MAC: () => IS_MAC,
+  IS_NOT_TOUCH_DEVICE: () => IS_NOT_TOUCH_DEVICE,
+  KEYBINDS: () => shortcuts_default,
+  MOUSE_BUTTONS: () => MOUSE_BUTTONS,
+  SHORTCUTS: () => SHORTCUTS,
+  ShortcutsManager: () => ShortcutsManager,
+  buildShortcutString: () => buildShortcutString
+});
+module.exports = __toCommonJS(src_exports);
+
+// 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);
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IS_MAC,
+  IS_NOT_TOUCH_DEVICE,
+  KEYBINDS,
+  MOUSE_BUTTONS,
+  SHORTCUTS,
+  ShortcutsManager,
+  buildShortcutString
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config/shortcuts.ts","../src/utils/misc.ts","../src/core/shortcuts-manager.ts"],"sourcesContent":["export {\n  ShortcutsManager,\n  type ShortcutListener,\n} from './core/shortcuts-manager';\nexport {\n  default as KEYBINDS,\n  SHORTCUTS,\n  type Keybind,\n  type KeybindAction,\n  type Shortcut,\n} from './config/shortcuts';\nexport {\n  buildShortcutString,\n  IS_MAC,\n  IS_NOT_TOUCH_DEVICE,\n  MOUSE_BUTTONS,\n} from './utils/misc';\n","/**\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"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,114 @@
+/**
+ * Maps a keybind string (e.g. `"CTRL+SHIFT+F"`) to either the name of a
+ * {@link SHORTCUTS} entry or an inline handler.
+ *
+ * Prefer referencing a named entry in {@link SHORTCUTS} so the same action
+ * can be triggered programmatically (e.g. from a command palette) using the
+ * same {@link Shortcut} name.
+ */
+type KeybindAction = Shortcut | ((event: Event) => void);
+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";
+};
+/**
+ * Named shortcut handlers, keyed by {@link Shortcut} name. Referenced from
+ * {@link KEYBINDS} by name so the same action can be triggered from
+ * multiple bindings (or invoked directly, outside of any input event).
+ */
+declare const SHORTCUTS: {
+    toggleFullScreen: (event: Event) => void;
+    toggleGrid: (event: Event) => void;
+    toggleHelp: (event: Event) => void;
+    closeOverlay: (event: Event) => void;
+    undo: (event: Event) => void;
+    redo: (event: Event) => void;
+    delete: (event: Event) => void;
+    selectAll: (event: Event) => void;
+    copy: (event: Event) => void;
+    paste: (event: Event) => void;
+    save: (event: Event) => void;
+    zoomIn: (event: Event) => void;
+    leftMouseButton: (event: Event) => void;
+    middleMouseButton: (event: Event) => void;
+    rightMouseButton: (event: Event) => void;
+};
+/** A key combination string understood by {@link KEYBINDS}, e.g. `"CTRL+SHIFT+F"`. */
+type Keybind = keyof typeof KEYBINDS;
+/** The name of a handler registered in {@link SHORTCUTS}. */
+type Shortcut = keyof typeof SHORTCUTS;
+
+/** Callback invoked when a bound shortcut fires. */
+type ShortcutListener = (event: Event) => void;
+/**
+ * Framework-agnostic keyboard, mouse and wheel shortcut dispatcher.
+ *
+ * Listens for the most commonly used input events (`keydown`, `keyup`,
+ * `mousedown`, `mouseup`, `dblclick`, `contextmenu` and `wheel`) on a target
+ * (`window` by default), converts each into a {@link Keybind} string, and
+ * dispatches it to any listeners registered with {@link on} as well as the
+ * static bindings declared in `KEYBINDS`.
+ *
+ * Every framework adapter in this package (React, Vue, Svelte, Angular,
+ * Solid, Preact) wraps a single instance of this class in that framework's
+ * own idioms (context/provider, composable, store, service, etc.).
+ */
+declare class ShortcutsManager {
+    private listeners;
+    private target;
+    private cleanup;
+    /** Registers `callback` to run whenever `shortcut` is triggered. */
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /** Removes a `callback` previously registered with {@link on}. */
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+    private emit;
+    private triggerShortcut;
+    /**
+     * Starts listening on `target` (`window` by default). Returns a disposer
+     * that removes the listeners; safe to call multiple times.
+     */
+    attach: (target?: EventTarget) => (() => void);
+    /** Stops listening. Safe to call even if {@link attach} was never called. */
+    detach: () => void;
+}
+
+/** Whether the current platform reports itself as macOS (used to prefer `CMD` over `CTRL`). */
+declare const IS_MAC: boolean;
+/** Whether the current device supports mouse/keyboard input rather than touch only. */
+declare const IS_NOT_TOUCH_DEVICE: boolean;
+/** Names for `MouseEvent.button` values 0, 1 and 2, in that order. */
+declare const MOUSE_BUTTONS: string[];
+/**
+ * Builds a {@link Keybind} string (e.g. `"CTRL+SHIFT+F"`) from a base key
+ * name and the modifier keys held during the triggering event.
+ *
+ * @param key - The key or button name, e.g. `"F"` or `"LEFT_BUTTON"`.
+ * @param event - The DOM event the key combination is derived from.
+ */
+declare function buildShortcutString(key: string, event: KeyboardEvent | MouseEvent | WheelEvent): Keybind;
+
+export { IS_MAC, IS_NOT_TOUCH_DEVICE, KEYBINDS, type Keybind, type KeybindAction, MOUSE_BUTTONS, SHORTCUTS, type Shortcut, type ShortcutListener, ShortcutsManager, buildShortcutString };

package/dist/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Maps a keybind string (e.g. `"CTRL+SHIFT+F"`) to either the name of a
+ * {@link SHORTCUTS} entry or an inline handler.
+ *
+ * Prefer referencing a named entry in {@link SHORTCUTS} so the same action
+ * can be triggered programmatically (e.g. from a command palette) using the
+ * same {@link Shortcut} name.
+ */
+type KeybindAction = Shortcut | ((event: Event) => void);
+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";
+};
+/**
+ * Named shortcut handlers, keyed by {@link Shortcut} name. Referenced from
+ * {@link KEYBINDS} by name so the same action can be triggered from
+ * multiple bindings (or invoked directly, outside of any input event).
+ */
+declare const SHORTCUTS: {
+    toggleFullScreen: (event: Event) => void;
+    toggleGrid: (event: Event) => void;
+    toggleHelp: (event: Event) => void;
+    closeOverlay: (event: Event) => void;
+    undo: (event: Event) => void;
+    redo: (event: Event) => void;
+    delete: (event: Event) => void;
+    selectAll: (event: Event) => void;
+    copy: (event: Event) => void;
+    paste: (event: Event) => void;
+    save: (event: Event) => void;
+    zoomIn: (event: Event) => void;
+    leftMouseButton: (event: Event) => void;
+    middleMouseButton: (event: Event) => void;
+    rightMouseButton: (event: Event) => void;
+};
+/** A key combination string understood by {@link KEYBINDS}, e.g. `"CTRL+SHIFT+F"`. */
+type Keybind = keyof typeof KEYBINDS;
+/** The name of a handler registered in {@link SHORTCUTS}. */
+type Shortcut = keyof typeof SHORTCUTS;
+
+/** Callback invoked when a bound shortcut fires. */
+type ShortcutListener = (event: Event) => void;
+/**
+ * Framework-agnostic keyboard, mouse and wheel shortcut dispatcher.
+ *
+ * Listens for the most commonly used input events (`keydown`, `keyup`,
+ * `mousedown`, `mouseup`, `dblclick`, `contextmenu` and `wheel`) on a target
+ * (`window` by default), converts each into a {@link Keybind} string, and
+ * dispatches it to any listeners registered with {@link on} as well as the
+ * static bindings declared in `KEYBINDS`.
+ *
+ * Every framework adapter in this package (React, Vue, Svelte, Angular,
+ * Solid, Preact) wraps a single instance of this class in that framework's
+ * own idioms (context/provider, composable, store, service, etc.).
+ */
+declare class ShortcutsManager {
+    private listeners;
+    private target;
+    private cleanup;
+    /** Registers `callback` to run whenever `shortcut` is triggered. */
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /** Removes a `callback` previously registered with {@link on}. */
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+    private emit;
+    private triggerShortcut;
+    /**
+     * Starts listening on `target` (`window` by default). Returns a disposer
+     * that removes the listeners; safe to call multiple times.
+     */
+    attach: (target?: EventTarget) => (() => void);
+    /** Stops listening. Safe to call even if {@link attach} was never called. */
+    detach: () => void;
+}
+
+/** Whether the current platform reports itself as macOS (used to prefer `CMD` over `CTRL`). */
+declare const IS_MAC: boolean;
+/** Whether the current device supports mouse/keyboard input rather than touch only. */
+declare const IS_NOT_TOUCH_DEVICE: boolean;
+/** Names for `MouseEvent.button` values 0, 1 and 2, in that order. */
+declare const MOUSE_BUTTONS: string[];
+/**
+ * Builds a {@link Keybind} string (e.g. `"CTRL+SHIFT+F"`) from a base key
+ * name and the modifier keys held during the triggering event.
+ *
+ * @param key - The key or button name, e.g. `"F"` or `"LEFT_BUTTON"`.
+ * @param event - The DOM event the key combination is derived from.
+ */
+declare function buildShortcutString(key: string, event: KeyboardEvent | MouseEvent | WheelEvent): Keybind;
+
+export { IS_MAC, IS_NOT_TOUCH_DEVICE, KEYBINDS, type Keybind, type KeybindAction, MOUSE_BUTTONS, SHORTCUTS, type Shortcut, type ShortcutListener, ShortcutsManager, buildShortcutString };