@lytjs/common-keyboard 6.0.0

package/dist/index.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+// src/index.ts
+var MODIFIER_KEYS = /* @__PURE__ */ new Set([
+  "ctrl",
+  "shift",
+  "alt",
+  "meta"
+]);
+var SPECIAL_KEYS = {
+  enter: "Enter",
+  escape: "Escape",
+  tab: "Tab",
+  space: " ",
+  backspace: "Backspace",
+  delete: "Delete",
+  arrowup: "ArrowUp",
+  arrowdown: "ArrowDown",
+  arrowleft: "ArrowLeft",
+  arrowright: "ArrowRight",
+  home: "Home",
+  end: "End",
+  pageup: "PageUp",
+  pagedown: "PageDown",
+  f1: "F1",
+  f2: "F2",
+  f3: "F3",
+  f4: "F4",
+  f5: "F5",
+  f6: "F6",
+  f7: "F7",
+  f8: "F8",
+  f9: "F9",
+  f10: "F10",
+  f11: "F11",
+  f12: "F12"
+};
+function parseShortcut(shortcut) {
+  const parts = shortcut.toLowerCase().split("+").map((p) => p.trim());
+  const result = {
+    key: "",
+    ctrl: false,
+    shift: false,
+    alt: false,
+    meta: false
+  };
+  for (const part of parts) {
+    if (part === "ctrl" || part === "control") {
+      result.ctrl = true;
+    } else if (part === "shift") {
+      result.shift = true;
+    } else if (part === "alt") {
+      result.alt = true;
+    } else if (part === "meta" || part === "cmd" || part === "command") {
+      result.meta = true;
+    } else {
+      result.key = SPECIAL_KEYS[part] || part.toUpperCase();
+    }
+  }
+  return result;
+}
+function matchShortcut(event, shortcut) {
+  const parsed = parseShortcut(shortcut);
+  return event.ctrlKey === parsed.ctrl && event.shiftKey === parsed.shift && event.altKey === parsed.alt && event.metaKey === parsed.meta && event.key.toLowerCase() === parsed.key.toLowerCase();
+}
+function createKeySequence(keys) {
+  let currentIndex = 0;
+  return (event) => {
+    if (currentIndex >= keys.length) {
+      currentIndex = 0;
+    }
+    if (matchShortcut(event, keys[currentIndex])) {
+      currentIndex++;
+      if (currentIndex >= keys.length) {
+        currentIndex = 0;
+        return true;
+      }
+    } else {
+      currentIndex = 0;
+    }
+    return false;
+  };
+}
+
+exports.MODIFIER_KEYS = MODIFIER_KEYS;
+exports.SPECIAL_KEYS = SPECIAL_KEYS;
+exports.createKeySequence = createKeySequence;
+exports.matchShortcut = matchShortcut;
+exports.parseShortcut = parseShortcut;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @lytjs/common-keyboard\r\n * 轻量级键盘快捷键工具\r\n */\r\n\r\ndeclare const __DEV__: boolean;\r\n\r\nexport interface ParsedShortcut {\r\n  key: string;\r\n  ctrl: boolean;\r\n  shift: boolean;\r\n  alt: boolean;\r\n  meta: boolean;\r\n}\r\n\r\n/** 修饰键名称集合 */\r\nexport const MODIFIER_KEYS: Set<string> = new Set([\r\n  'ctrl',\r\n  'shift',\r\n  'alt',\r\n  'meta',\r\n]);\r\n\r\n/** 特殊键名称到 KeyboardEvent.key 的映射 */\r\nexport const SPECIAL_KEYS: Record<string, string> = {\r\n  enter: 'Enter',\r\n  escape: 'Escape',\r\n  tab: 'Tab',\r\n  space: ' ',\r\n  backspace: 'Backspace',\r\n  delete: 'Delete',\r\n  arrowup: 'ArrowUp',\r\n  arrowdown: 'ArrowDown',\r\n  arrowleft: 'ArrowLeft',\r\n  arrowright: 'ArrowRight',\r\n  home: 'Home',\r\n  end: 'End',\r\n  pageup: 'PageUp',\r\n  pagedown: 'PageDown',\r\n  f1: 'F1',\r\n  f2: 'F2',\r\n  f3: 'F3',\r\n  f4: 'F4',\r\n  f5: 'F5',\r\n  f6: 'F6',\r\n  f7: 'F7',\r\n  f8: 'F8',\r\n  f9: 'F9',\r\n  f10: 'F10',\r\n  f11: 'F11',\r\n  f12: 'F12',\r\n};\r\n\r\n/**\r\n * 解析快捷键字符串为结构化对象\r\n *\r\n * @param shortcut - 快捷键字符串，如 \"ctrl+s\", \"shift+alt+t\", \"enter\"\r\n * @returns 解析后的快捷键对象\r\n */\r\nexport function parseShortcut(shortcut: string): ParsedShortcut {\r\n  const parts = shortcut.toLowerCase().split('+').map((p) => p.trim());\r\n  const result: ParsedShortcut = {\r\n    key: '',\r\n    ctrl: false,\r\n    shift: false,\r\n    alt: false,\r\n    meta: false,\r\n  };\r\n\r\n  for (const part of parts) {\r\n    if (part === 'ctrl' || part === 'control') {\r\n      result.ctrl = true;\r\n    } else if (part === 'shift') {\r\n      result.shift = true;\r\n    } else if (part === 'alt') {\r\n      result.alt = true;\r\n    } else if (part === 'meta' || part === 'cmd' || part === 'command') {\r\n      result.meta = true;\r\n    } else {\r\n      // Resolve special keys\r\n      result.key = SPECIAL_KEYS[part] || part.toUpperCase();\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * 匹配快捷键字符串\r\n *\r\n * @param event - KeyboardEvent\r\n * @param shortcut - 快捷键字符串，如 \"ctrl+s\", \"shift+alt+t\", \"enter\"\r\n * @returns 是否匹配\r\n */\r\nexport function matchShortcut(event: KeyboardEvent, shortcut: string): boolean {\r\n  const parsed = parseShortcut(shortcut);\r\n\r\n  return (\r\n    event.ctrlKey === parsed.ctrl &&\r\n    event.shiftKey === parsed.shift &&\r\n    event.altKey === parsed.alt &&\r\n    event.metaKey === parsed.meta &&\r\n    event.key.toLowerCase() === parsed.key.toLowerCase()\r\n  );\r\n}\r\n\r\n/**\r\n * 创建一个按键序列匹配器\r\n *\r\n * @param keys - 按键序列，如 [\"ctrl\", \"k\", \"s\"] 表示先按 Ctrl+K 再按 S\r\n * @returns 匹配函数，每次调用传入 KeyboardEvent，按顺序匹配\r\n */\r\nexport function createKeySequence(\r\n  keys: string[],\r\n): (event: KeyboardEvent) => boolean {\r\n  let currentIndex = 0;\r\n\r\n  return (event: KeyboardEvent): boolean => {\r\n    if (currentIndex >= keys.length) {\r\n      currentIndex = 0;\r\n    }\r\n\r\n    if (matchShortcut(event, keys[currentIndex]!)) {\r\n      currentIndex++;\r\n      if (currentIndex >= keys.length) {\r\n        currentIndex = 0;\r\n        return true;\r\n      }\r\n    } else {\r\n      // Reset if the sequence is broken\r\n      currentIndex = 0;\r\n    }\r\n\r\n    return false;\r\n  };\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+/**
+ * @lytjs/common-keyboard
+ * 轻量级键盘快捷键工具
+ */
+interface ParsedShortcut {
+    key: string;
+    ctrl: boolean;
+    shift: boolean;
+    alt: boolean;
+    meta: boolean;
+}
+/** 修饰键名称集合 */
+declare const MODIFIER_KEYS: Set<string>;
+/** 特殊键名称到 KeyboardEvent.key 的映射 */
+declare const SPECIAL_KEYS: Record<string, string>;
+/**
+ * 解析快捷键字符串为结构化对象
+ *
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 解析后的快捷键对象
+ */
+declare function parseShortcut(shortcut: string): ParsedShortcut;
+/**
+ * 匹配快捷键字符串
+ *
+ * @param event - KeyboardEvent
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 是否匹配
+ */
+declare function matchShortcut(event: KeyboardEvent, shortcut: string): boolean;
+/**
+ * 创建一个按键序列匹配器
+ *
+ * @param keys - 按键序列，如 ["ctrl", "k", "s"] 表示先按 Ctrl+K 再按 S
+ * @returns 匹配函数，每次调用传入 KeyboardEvent，按顺序匹配
+ */
+declare function createKeySequence(keys: string[]): (event: KeyboardEvent) => boolean;
+
+export { MODIFIER_KEYS, type ParsedShortcut, SPECIAL_KEYS, createKeySequence, matchShortcut, parseShortcut };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @lytjs/common-keyboard
+ * 轻量级键盘快捷键工具
+ */
+interface ParsedShortcut {
+    key: string;
+    ctrl: boolean;
+    shift: boolean;
+    alt: boolean;
+    meta: boolean;
+}
+/** 修饰键名称集合 */
+declare const MODIFIER_KEYS: Set<string>;
+/** 特殊键名称到 KeyboardEvent.key 的映射 */
+declare const SPECIAL_KEYS: Record<string, string>;
+/**
+ * 解析快捷键字符串为结构化对象
+ *
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 解析后的快捷键对象
+ */
+declare function parseShortcut(shortcut: string): ParsedShortcut;
+/**
+ * 匹配快捷键字符串
+ *
+ * @param event - KeyboardEvent
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 是否匹配
+ */
+declare function matchShortcut(event: KeyboardEvent, shortcut: string): boolean;
+/**
+ * 创建一个按键序列匹配器
+ *
+ * @param keys - 按键序列，如 ["ctrl", "k", "s"] 表示先按 Ctrl+K 再按 S
+ * @returns 匹配函数，每次调用传入 KeyboardEvent，按顺序匹配
+ */
+declare function createKeySequence(keys: string[]): (event: KeyboardEvent) => boolean;
+
+export { MODIFIER_KEYS, type ParsedShortcut, SPECIAL_KEYS, createKeySequence, matchShortcut, parseShortcut };

package/dist/index.mjs

@@ -0,0 +1,85 @@
+// src/index.ts
+var MODIFIER_KEYS = /* @__PURE__ */ new Set([
+  "ctrl",
+  "shift",
+  "alt",
+  "meta"
+]);
+var SPECIAL_KEYS = {
+  enter: "Enter",
+  escape: "Escape",
+  tab: "Tab",
+  space: " ",
+  backspace: "Backspace",
+  delete: "Delete",
+  arrowup: "ArrowUp",
+  arrowdown: "ArrowDown",
+  arrowleft: "ArrowLeft",
+  arrowright: "ArrowRight",
+  home: "Home",
+  end: "End",
+  pageup: "PageUp",
+  pagedown: "PageDown",
+  f1: "F1",
+  f2: "F2",
+  f3: "F3",
+  f4: "F4",
+  f5: "F5",
+  f6: "F6",
+  f7: "F7",
+  f8: "F8",
+  f9: "F9",
+  f10: "F10",
+  f11: "F11",
+  f12: "F12"
+};
+function parseShortcut(shortcut) {
+  const parts = shortcut.toLowerCase().split("+").map((p) => p.trim());
+  const result = {
+    key: "",
+    ctrl: false,
+    shift: false,
+    alt: false,
+    meta: false
+  };
+  for (const part of parts) {
+    if (part === "ctrl" || part === "control") {
+      result.ctrl = true;
+    } else if (part === "shift") {
+      result.shift = true;
+    } else if (part === "alt") {
+      result.alt = true;
+    } else if (part === "meta" || part === "cmd" || part === "command") {
+      result.meta = true;
+    } else {
+      result.key = SPECIAL_KEYS[part] || part.toUpperCase();
+    }
+  }
+  return result;
+}
+function matchShortcut(event, shortcut) {
+  const parsed = parseShortcut(shortcut);
+  return event.ctrlKey === parsed.ctrl && event.shiftKey === parsed.shift && event.altKey === parsed.alt && event.metaKey === parsed.meta && event.key.toLowerCase() === parsed.key.toLowerCase();
+}
+function createKeySequence(keys) {
+  let currentIndex = 0;
+  return (event) => {
+    if (currentIndex >= keys.length) {
+      currentIndex = 0;
+    }
+    if (matchShortcut(event, keys[currentIndex])) {
+      currentIndex++;
+      if (currentIndex >= keys.length) {
+        currentIndex = 0;
+        return true;
+      }
+    } else {
+      currentIndex = 0;
+    }
+    return false;
+  };
+}
+
+export { MODIFIER_KEYS, SPECIAL_KEYS, createKeySequence, matchShortcut, parseShortcut };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * @lytjs/common-keyboard\r\n * 轻量级键盘快捷键工具\r\n */\r\n\r\ndeclare const __DEV__: boolean;\r\n\r\nexport interface ParsedShortcut {\r\n  key: string;\r\n  ctrl: boolean;\r\n  shift: boolean;\r\n  alt: boolean;\r\n  meta: boolean;\r\n}\r\n\r\n/** 修饰键名称集合 */\r\nexport const MODIFIER_KEYS: Set<string> = new Set([\r\n  'ctrl',\r\n  'shift',\r\n  'alt',\r\n  'meta',\r\n]);\r\n\r\n/** 特殊键名称到 KeyboardEvent.key 的映射 */\r\nexport const SPECIAL_KEYS: Record<string, string> = {\r\n  enter: 'Enter',\r\n  escape: 'Escape',\r\n  tab: 'Tab',\r\n  space: ' ',\r\n  backspace: 'Backspace',\r\n  delete: 'Delete',\r\n  arrowup: 'ArrowUp',\r\n  arrowdown: 'ArrowDown',\r\n  arrowleft: 'ArrowLeft',\r\n  arrowright: 'ArrowRight',\r\n  home: 'Home',\r\n  end: 'End',\r\n  pageup: 'PageUp',\r\n  pagedown: 'PageDown',\r\n  f1: 'F1',\r\n  f2: 'F2',\r\n  f3: 'F3',\r\n  f4: 'F4',\r\n  f5: 'F5',\r\n  f6: 'F6',\r\n  f7: 'F7',\r\n  f8: 'F8',\r\n  f9: 'F9',\r\n  f10: 'F10',\r\n  f11: 'F11',\r\n  f12: 'F12',\r\n};\r\n\r\n/**\r\n * 解析快捷键字符串为结构化对象\r\n *\r\n * @param shortcut - 快捷键字符串，如 \"ctrl+s\", \"shift+alt+t\", \"enter\"\r\n * @returns 解析后的快捷键对象\r\n */\r\nexport function parseShortcut(shortcut: string): ParsedShortcut {\r\n  const parts = shortcut.toLowerCase().split('+').map((p) => p.trim());\r\n  const result: ParsedShortcut = {\r\n    key: '',\r\n    ctrl: false,\r\n    shift: false,\r\n    alt: false,\r\n    meta: false,\r\n  };\r\n\r\n  for (const part of parts) {\r\n    if (part === 'ctrl' || part === 'control') {\r\n      result.ctrl = true;\r\n    } else if (part === 'shift') {\r\n      result.shift = true;\r\n    } else if (part === 'alt') {\r\n      result.alt = true;\r\n    } else if (part === 'meta' || part === 'cmd' || part === 'command') {\r\n      result.meta = true;\r\n    } else {\r\n      // Resolve special keys\r\n      result.key = SPECIAL_KEYS[part] || part.toUpperCase();\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * 匹配快捷键字符串\r\n *\r\n * @param event - KeyboardEvent\r\n * @param shortcut - 快捷键字符串，如 \"ctrl+s\", \"shift+alt+t\", \"enter\"\r\n * @returns 是否匹配\r\n */\r\nexport function matchShortcut(event: KeyboardEvent, shortcut: string): boolean {\r\n  const parsed = parseShortcut(shortcut);\r\n\r\n  return (\r\n    event.ctrlKey === parsed.ctrl &&\r\n    event.shiftKey === parsed.shift &&\r\n    event.altKey === parsed.alt &&\r\n    event.metaKey === parsed.meta &&\r\n    event.key.toLowerCase() === parsed.key.toLowerCase()\r\n  );\r\n}\r\n\r\n/**\r\n * 创建一个按键序列匹配器\r\n *\r\n * @param keys - 按键序列，如 [\"ctrl\", \"k\", \"s\"] 表示先按 Ctrl+K 再按 S\r\n * @returns 匹配函数，每次调用传入 KeyboardEvent，按顺序匹配\r\n */\r\nexport function createKeySequence(\r\n  keys: string[],\r\n): (event: KeyboardEvent) => boolean {\r\n  let currentIndex = 0;\r\n\r\n  return (event: KeyboardEvent): boolean => {\r\n    if (currentIndex >= keys.length) {\r\n      currentIndex = 0;\r\n    }\r\n\r\n    if (matchShortcut(event, keys[currentIndex]!)) {\r\n      currentIndex++;\r\n      if (currentIndex >= keys.length) {\r\n        currentIndex = 0;\r\n        return true;\r\n      }\r\n    } else {\r\n      // Reset if the sequence is broken\r\n      currentIndex = 0;\r\n    }\r\n\r\n    return false;\r\n  };\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@lytjs/common-keyboard",
+  "version": "6.0.0",
+  "description": "Lightweight keyboard shortcut utilities for LytJS",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint \"src/**/*.ts\"",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "devDependencies": {
+    "jsdom": "^26.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1,136 @@
+/**
+ * @lytjs/common-keyboard
+ * 轻量级键盘快捷键工具
+ */
+
+declare const __DEV__: boolean;
+
+export interface ParsedShortcut {
+  key: string;
+  ctrl: boolean;
+  shift: boolean;
+  alt: boolean;
+  meta: boolean;
+}
+
+/** 修饰键名称集合 */
+export const MODIFIER_KEYS: Set<string> = new Set([
+  'ctrl',
+  'shift',
+  'alt',
+  'meta',
+]);
+
+/** 特殊键名称到 KeyboardEvent.key 的映射 */
+export const SPECIAL_KEYS: Record<string, string> = {
+  enter: 'Enter',
+  escape: 'Escape',
+  tab: 'Tab',
+  space: ' ',
+  backspace: 'Backspace',
+  delete: 'Delete',
+  arrowup: 'ArrowUp',
+  arrowdown: 'ArrowDown',
+  arrowleft: 'ArrowLeft',
+  arrowright: 'ArrowRight',
+  home: 'Home',
+  end: 'End',
+  pageup: 'PageUp',
+  pagedown: 'PageDown',
+  f1: 'F1',
+  f2: 'F2',
+  f3: 'F3',
+  f4: 'F4',
+  f5: 'F5',
+  f6: 'F6',
+  f7: 'F7',
+  f8: 'F8',
+  f9: 'F9',
+  f10: 'F10',
+  f11: 'F11',
+  f12: 'F12',
+};
+
+/**
+ * 解析快捷键字符串为结构化对象
+ *
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 解析后的快捷键对象
+ */
+export function parseShortcut(shortcut: string): ParsedShortcut {
+  const parts = shortcut.toLowerCase().split('+').map((p) => p.trim());
+  const result: ParsedShortcut = {
+    key: '',
+    ctrl: false,
+    shift: false,
+    alt: false,
+    meta: false,
+  };
+
+  for (const part of parts) {
+    if (part === 'ctrl' || part === 'control') {
+      result.ctrl = true;
+    } else if (part === 'shift') {
+      result.shift = true;
+    } else if (part === 'alt') {
+      result.alt = true;
+    } else if (part === 'meta' || part === 'cmd' || part === 'command') {
+      result.meta = true;
+    } else {
+      // Resolve special keys
+      result.key = SPECIAL_KEYS[part] || part.toUpperCase();
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 匹配快捷键字符串
+ *
+ * @param event - KeyboardEvent
+ * @param shortcut - 快捷键字符串，如 "ctrl+s", "shift+alt+t", "enter"
+ * @returns 是否匹配
+ */
+export function matchShortcut(event: KeyboardEvent, shortcut: string): boolean {
+  const parsed = parseShortcut(shortcut);
+
+  return (
+    event.ctrlKey === parsed.ctrl &&
+    event.shiftKey === parsed.shift &&
+    event.altKey === parsed.alt &&
+    event.metaKey === parsed.meta &&
+    event.key.toLowerCase() === parsed.key.toLowerCase()
+  );
+}
+
+/**
+ * 创建一个按键序列匹配器
+ *
+ * @param keys - 按键序列，如 ["ctrl", "k", "s"] 表示先按 Ctrl+K 再按 S
+ * @returns 匹配函数，每次调用传入 KeyboardEvent，按顺序匹配
+ */
+export function createKeySequence(
+  keys: string[],
+): (event: KeyboardEvent) => boolean {
+  let currentIndex = 0;
+
+  return (event: KeyboardEvent): boolean => {
+    if (currentIndex >= keys.length) {
+      currentIndex = 0;
+    }
+
+    if (matchShortcut(event, keys[currentIndex]!)) {
+      currentIndex++;
+      if (currentIndex >= keys.length) {
+        currentIndex = 0;
+        return true;
+      }
+    } else {
+      // Reset if the sequence is broken
+      currentIndex = 0;
+    }
+
+    return false;
+  };
+}