browser-shortcuts 0.1.0

package/dist/angular.d.cts

@@ -0,0 +1,71 @@
+import * as _angular_core from '@angular/core';
+
+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;
+
+/**
+ * App-wide keyboard, mouse and wheel shortcut dispatcher. Injected as a
+ * singleton; call {@link ShortcutsService.on} / {@link ShortcutsService.off}
+ * directly, or use {@link ShortcutsService.useShortcut} inside another
+ * injection context (e.g. a component constructor) for automatic cleanup.
+ */
+declare class ShortcutsService {
+    private manager;
+    private detach;
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /**
+     * Subscribes `callback` to `shortcut` and automatically unsubscribes when
+     * the current injection context (e.g. the injecting component) is
+     * destroyed. Must be called from an injection context.
+     */
+    useShortcut(shortcut: Keybind, callback: ShortcutListener): void;
+    /** @internal */
+    ngOnDestroy(): void;
+}
+/**
+ * Eagerly instantiates {@link ShortcutsService} so global shortcuts start
+ * listening as soon as the app bootstraps, rather than lazily on first
+ * injection.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideShortcuts()],
+ * });
+ * ```
+ */
+declare function provideShortcuts(): _angular_core.EnvironmentProviders;
+
+export { type ShortcutListener, ShortcutsService, provideShortcuts };

package/dist/angular.d.ts

@@ -0,0 +1,71 @@
+import * as _angular_core from '@angular/core';
+
+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;
+
+/**
+ * App-wide keyboard, mouse and wheel shortcut dispatcher. Injected as a
+ * singleton; call {@link ShortcutsService.on} / {@link ShortcutsService.off}
+ * directly, or use {@link ShortcutsService.useShortcut} inside another
+ * injection context (e.g. a component constructor) for automatic cleanup.
+ */
+declare class ShortcutsService {
+    private manager;
+    private detach;
+    on: (shortcut: Keybind, callback: ShortcutListener) => void;
+    off: (shortcut: Keybind, callback: ShortcutListener) => void;
+    /**
+     * Subscribes `callback` to `shortcut` and automatically unsubscribes when
+     * the current injection context (e.g. the injecting component) is
+     * destroyed. Must be called from an injection context.
+     */
+    useShortcut(shortcut: Keybind, callback: ShortcutListener): void;
+    /** @internal */
+    ngOnDestroy(): void;
+}
+/**
+ * Eagerly instantiates {@link ShortcutsService} so global shortcuts start
+ * listening as soon as the app bootstraps, rather than lazily on first
+ * injection.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideShortcuts()],
+ * });
+ * ```
+ */
+declare function provideShortcuts(): _angular_core.EnvironmentProviders;
+
+export { type ShortcutListener, ShortcutsService, provideShortcuts };

package/dist/angular.js

@@ -0,0 +1,318 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decoratorStart = (base) => {
+  var _a;
+  return [, , , __create((_a = base == null ? void 0 : base[__knownSymbol("metadata")]) != null ? _a : null)];
+};
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// 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/angular/index.ts
+import {
+  DestroyRef,
+  inject,
+  Injectable,
+  makeEnvironmentProviders,
+  APP_INITIALIZER
+} from "@angular/core";
+var _ShortcutsService_decorators, _init;
+_ShortcutsService_decorators = [Injectable({ providedIn: "root" })];
+var ShortcutsService = class {
+  constructor() {
+    this.manager = new ShortcutsManager();
+    this.detach = this.manager.attach();
+    this.on = this.manager.on;
+    this.off = this.manager.off;
+  }
+  /**
+   * Subscribes `callback` to `shortcut` and automatically unsubscribes when
+   * the current injection context (e.g. the injecting component) is
+   * destroyed. Must be called from an injection context.
+   */
+  useShortcut(shortcut, callback) {
+    const destroyRef = inject(DestroyRef);
+    this.manager.on(shortcut, callback);
+    destroyRef.onDestroy(() => this.manager.off(shortcut, callback));
+  }
+  /** @internal */
+  ngOnDestroy() {
+    this.detach();
+  }
+};
+_init = __decoratorStart(null);
+ShortcutsService = __decorateElement(_init, 0, "ShortcutsService", _ShortcutsService_decorators, ShortcutsService);
+__runInitializers(_init, 1, ShortcutsService);
+function provideShortcuts() {
+  return makeEnvironmentProviders([
+    {
+      provide: APP_INITIALIZER,
+      multi: true,
+      useFactory: () => () => inject(ShortcutsService)
+    }
+  ]);
+}
+export {
+  ShortcutsService,
+  provideShortcuts
+};
+//# sourceMappingURL=angular.js.map

package/dist/angular.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/shortcuts.ts","../src/utils/misc.ts","../src/core/shortcuts-manager.ts","../src/angular/index.ts"],"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","import type { Keybind } from '@/config';\nimport { ShortcutsManager, type ShortcutListener } from '@/core/shortcuts-manager';\nimport {\n  DestroyRef,\n  inject,\n  Injectable,\n  makeEnvironmentProviders,\n  APP_INITIALIZER,\n} from '@angular/core';\n\nexport type { ShortcutListener } from '@/core/shortcuts-manager';\n\n/**\n * App-wide keyboard, mouse and wheel shortcut dispatcher. Injected as a\n * singleton; call {@link ShortcutsService.on} / {@link ShortcutsService.off}\n * directly, or use {@link ShortcutsService.useShortcut} inside another\n * injection context (e.g. a component constructor) for automatic cleanup.\n */\n@Injectable({ providedIn: 'root' })\nexport class ShortcutsService {\n  private manager = new ShortcutsManager();\n  private detach = this.manager.attach();\n\n  on: (shortcut: Keybind, callback: ShortcutListener) => void = this.manager.on;\n  off: (shortcut: Keybind, callback: ShortcutListener) => void = this.manager.off;\n\n  /**\n   * Subscribes `callback` to `shortcut` and automatically unsubscribes when\n   * the current injection context (e.g. the injecting component) is\n   * destroyed. Must be called from an injection context.\n   */\n  useShortcut(shortcut: Keybind, callback: ShortcutListener): void {\n    const destroyRef = inject(DestroyRef);\n    this.manager.on(shortcut, callback);\n    destroyRef.onDestroy(() => this.manager.off(shortcut, callback));\n  }\n\n  /** @internal */\n  ngOnDestroy(): void {\n    this.detach();\n  }\n}\n\n/**\n * Eagerly instantiates {@link ShortcutsService} so global shortcuts start\n * listening as soon as the app bootstraps, rather than lazily on first\n * injection.\n *\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [provideShortcuts()],\n * });\n * ```\n */\nexport function provideShortcuts() {\n  return makeEnvironmentProviders([\n    {\n      provide: APP_INITIALIZER,\n      multi: true,\n      useFactory: () => () => inject(ShortcutsService),\n    },\n  ]);\n}\n"],"mappings":"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","names":[]}