hotkey-router 0.2.2 → 0.3.0

package/dist/validate.js

@@ -0,0 +1,106 @@
+// hotkey-router v0.3.0 | SEE LICENSE IN LICENSE
+
+
+// validate.js
+import { lookupReservation, severityIsHard } from "./reservations.js";
+import { parseComboString, listSites } from "./sites.js";
+var ALL_PLATFORMS = ["mac", "windows", "linux"];
+var ALL_BROWSERS = ["chrome", "firefox", "edge", "safari"];
+var PLATFORM_LABEL = { mac: "macOS", windows: "Windows", linux: "Linux" };
+var BROWSER_LABEL = { chrome: "Chrome", firefox: "Firefox", edge: "Edge", safari: "Safari" };
+var SITE_COL = { windows: 0, mac: 1, linux: 0 };
+function validateCombo(combo, {
+  platforms = ALL_PLATFORMS,
+  browsers = ALL_BROWSERS,
+  requirePrimary = false,
+  minModifiers = 1,
+  taken = [],
+  sites = true
+} = {}) {
+  const reasons = [];
+  const lookupKeys = {};
+  const add = (reason) => {
+    const same = reasons.find((r) => r.code === reason.code && r.message === reason.message);
+    if (same) {
+      for (const p of reason.platforms || []) if (!same.platforms?.includes(p)) same.platforms = [...same.platforms || [], p];
+      return;
+    }
+    reasons.push(reason);
+  };
+  if (typeof combo !== "string" || !combo.trim()) {
+    return { ok: false, reasons: [{ code: "invalid", severity: "error", message: "No keys were recorded." }], lookupKeys };
+  }
+  for (const platform of platforms) {
+    let parsed;
+    try {
+      parsed = parseComboString(combo, platform);
+    } catch {
+      parsed = null;
+    }
+    if (!parsed) {
+      add({ code: "invalid", severity: "error", message: "These keys could not be read.", platforms: [platform] });
+      continue;
+    }
+    if (!parsed.base) {
+      add({ code: "no-key", severity: "error", message: "Add a key to the modifiers, for example a letter or punctuation key.", platforms: [platform] });
+      continue;
+    }
+    const mods = ["ctrl", "meta", "alt", "shift"].filter((m) => parsed[m]);
+    const key = [...mods, parsed.base].join("+");
+    lookupKeys[platform] = key;
+    if (mods.length === 0) {
+      add({ code: "no-modifier", severity: "error", message: "Use at least one modifier (Ctrl, Alt, Shift or Cmd), or the key would fire while typing.", platforms: [platform] });
+    }
+    if (platform !== "mac" && mods.length === 1 && parsed.alt) {
+      add({ code: "alt-only", severity: "error", message: "Alt on its own moves focus to the browser menu when released. Add Ctrl or Shift.", platforms: [platform] });
+    }
+    const primary = platform === "mac" ? parsed.meta : parsed.ctrl;
+    if (requirePrimary && !primary) {
+      add({ code: "needs-primary", severity: "error", message: `Include ${platform === "mac" ? "Cmd" : "Ctrl"}.`, platforms: [platform] });
+    }
+    if (mods.length > 0 && mods.length < minModifiers) {
+      add({ code: "too-few-modifiers", severity: "error", message: `Use at least ${minModifiers} modifiers together.`, platforms: [platform] });
+    }
+    for (const other of taken) {
+      let otherKey = null;
+      try {
+        const o = parseComboString(other, platform);
+        if (o?.base) otherKey = [...["ctrl", "meta", "alt", "shift"].filter((m) => o[m]), o.base].join("+");
+      } catch {
+      }
+      if (otherKey === key) {
+        add({ code: "taken", severity: "error", message: "These keys are already used for something else here.", platforms: [platform], details: { combo: other } });
+      }
+    }
+    const shape = { ctrl: parsed.ctrl, meta: parsed.meta, alt: parsed.alt, shift: parsed.shift, key: parsed.base, code: null, bareModifier: null };
+    for (const browser of browsers) {
+      if (platform !== "mac" && browser === "safari") continue;
+      const hit = lookupReservation(shape, { platform, browser });
+      if (!hit) continue;
+      const where = hit.source === "system" ? PLATFORM_LABEL[platform] : `${BROWSER_LABEL[browser]} on ${PLATFORM_LABEL[platform]}`;
+      if (severityIsHard(hit.severity)) {
+        add({ code: "reserved", severity: "error", message: `${where} uses these keys (${hit.action}), so a page never sees them.`, platforms: [platform], details: { browser, action: hit.action } });
+      } else {
+        add({ code: "reserved-soft", severity: "warning", message: `${where} uses these keys in some situations (${hit.action}).`, platforms: [platform], details: { browser, action: hit.action, severity: hit.severity } });
+      }
+    }
+    if (platform === "windows" && parsed.ctrl && parsed.alt && !parsed.meta) {
+      add({ code: "altgr", severity: "warning", message: "On some keyboard layouts Ctrl+Alt acts as AltGr and types characters; those keystrokes are skipped.", platforms: [platform] });
+    }
+    if (sites) {
+      const col = SITE_COL[platform];
+      const names = [];
+      for (const site of listSites()) {
+        if (site.shortcuts.some((row) => row[col] === key)) names.push(site.name);
+      }
+      if (names.length) {
+        add({ code: "site-conflict", severity: "warning", message: `Also used by ${names.join(", ")}.`, platforms: [platform], details: { sites: names } });
+      }
+    }
+  }
+  return { ok: !reasons.some((r) => r.severity === "error"), reasons, lookupKeys };
+}
+export {
+  validateCombo
+};
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../validate.js"],
+  "sourcesContent": ["// validate.js\n// Check a hotkey before an app saves it, e.g. from a \"press your keys\"\n// recorder. Returns plain-language reasons the app can show as they are.\n//\n//   import { comboFromEvent } from 'hotkey-router'\n//   import { validateCombo } from 'hotkey-router/validate'\n//\n//   const combo = comboFromEvent(e, { useMod: true })   // 'mod+shift+code:Period'\n//   const { ok, reasons } = validateCombo(combo, { requirePrimary: true, minModifiers: 2 })\n//\n// Errors make `ok` false (the combo would not work, or breaks a rule the\n// app asked for). Warnings leave `ok` true (it works, with a caveat worth\n// telling the user: AltGr on some layouts, sites that use the same keys).\n//\n// Data: data/browser-hotkeys.json (keys the browser or OS take before the\n// page sees them) and data/site-hotkeys.runtime.json (keys popular sites use).\n\nimport { lookupReservation, severityIsHard } from './reservations.js'\nimport { parseComboString, listSites } from './sites.js'\n\nconst ALL_PLATFORMS = ['mac', 'windows', 'linux']\nconst ALL_BROWSERS = ['chrome', 'firefox', 'edge', 'safari']\nconst PLATFORM_LABEL = { mac: 'macOS', windows: 'Windows', linux: 'Linux' }\nconst BROWSER_LABEL = { chrome: 'Chrome', firefox: 'Firefox', edge: 'Edge', safari: 'Safari' }\n// Runtime site rows: [windows, mac, chromeos, action, verified]\nconst SITE_COL = { windows: 0, mac: 1, linux: 0 }\n\n/**\n * @typedef {{\n *   code: 'invalid' | 'no-key' | 'no-modifier' | 'alt-only' | 'needs-primary' |\n *         'too-few-modifiers' | 'taken' | 'reserved' | 'reserved-soft' |\n *         'altgr' | 'site-conflict',\n *   severity: 'error' | 'warning',\n *   message: string,\n *   platforms?: string[],\n *   details?: object\n * }} ComboReason\n */\n\n/**\n * @param {string} combo  hotkey string, e.g. `mod+shift+code:Period`\n * @param {{\n *   platforms?: Array<'mac' | 'windows' | 'linux'>,\n *   browsers?: Array<'chrome' | 'firefox' | 'edge' | 'safari'>,\n *   requirePrimary?: boolean,  // must include Ctrl (Cmd on macOS)\n *   minModifiers?: number,     // default 1\n *   taken?: string[],          // combos the app already uses\n *   sites?: boolean,           // warn about sites that use the keys (default true)\n * }} [opts]\n * @returns {{ ok: boolean, reasons: ComboReason[], lookupKeys: Record<string, string> }}\n */\nexport function validateCombo(combo, {\n  platforms = ALL_PLATFORMS,\n  browsers = ALL_BROWSERS,\n  requirePrimary = false,\n  minModifiers = 1,\n  taken = [],\n  sites = true,\n} = {}) {\n  /** @type {ComboReason[]} */\n  const reasons = []\n  const lookupKeys = {}\n  const add = (reason) => {\n    const same = reasons.find((r) => r.code === reason.code && r.message === reason.message)\n    if (same) {\n      for (const p of reason.platforms || []) if (!same.platforms?.includes(p)) same.platforms = [...(same.platforms || []), p]\n      return\n    }\n    reasons.push(reason)\n  }\n\n  if (typeof combo !== 'string' || !combo.trim()) {\n    return { ok: false, reasons: [{ code: 'invalid', severity: 'error', message: 'No keys were recorded.' }], lookupKeys }\n  }\n\n  for (const platform of platforms) {\n    let parsed\n    try {\n      parsed = parseComboString(combo, platform)\n    } catch {\n      parsed = null\n    }\n    if (!parsed) {\n      add({ code: 'invalid', severity: 'error', message: 'These keys could not be read.', platforms: [platform] })\n      continue\n    }\n    if (!parsed.base) {\n      add({ code: 'no-key', severity: 'error', message: 'Add a key to the modifiers, for example a letter or punctuation key.', platforms: [platform] })\n      continue\n    }\n    const mods = ['ctrl', 'meta', 'alt', 'shift'].filter((m) => parsed[m])\n    const key = [...mods, parsed.base].join('+')\n    lookupKeys[platform] = key\n\n    if (mods.length === 0) {\n      add({ code: 'no-modifier', severity: 'error', message: 'Use at least one modifier (Ctrl, Alt, Shift or Cmd), or the key would fire while typing.', platforms: [platform] })\n    }\n    if (platform !== 'mac' && mods.length === 1 && parsed.alt) {\n      add({ code: 'alt-only', severity: 'error', message: 'Alt on its own moves focus to the browser menu when released. Add Ctrl or Shift.', platforms: [platform] })\n    }\n    const primary = platform === 'mac' ? parsed.meta : parsed.ctrl\n    if (requirePrimary && !primary) {\n      add({ code: 'needs-primary', severity: 'error', message: `Include ${platform === 'mac' ? 'Cmd' : 'Ctrl'}.`, platforms: [platform] })\n    }\n    if (mods.length > 0 && mods.length < minModifiers) {\n      add({ code: 'too-few-modifiers', severity: 'error', message: `Use at least ${minModifiers} modifiers together.`, platforms: [platform] })\n    }\n\n    for (const other of taken) {\n      let otherKey = null\n      try {\n        const o = parseComboString(other, platform)\n        if (o?.base) otherKey = [...['ctrl', 'meta', 'alt', 'shift'].filter((m) => o[m]), o.base].join('+')\n      } catch { /* ignore unreadable entries */ }\n      if (otherKey === key) {\n        add({ code: 'taken', severity: 'error', message: 'These keys are already used for something else here.', platforms: [platform], details: { combo: other } })\n      }\n    }\n\n    const shape = { ctrl: parsed.ctrl, meta: parsed.meta, alt: parsed.alt, shift: parsed.shift, key: parsed.base, code: null, bareModifier: null }\n    for (const browser of browsers) {\n      if (platform !== 'mac' && browser === 'safari') continue\n      const hit = lookupReservation(shape, { platform, browser })\n      if (!hit) continue\n      const where = hit.source === 'system' ? PLATFORM_LABEL[platform] : `${BROWSER_LABEL[browser]} on ${PLATFORM_LABEL[platform]}`\n      if (severityIsHard(hit.severity)) {\n        add({ code: 'reserved', severity: 'error', message: `${where} uses these keys (${hit.action}), so a page never sees them.`, platforms: [platform], details: { browser, action: hit.action } })\n      } else {\n        add({ code: 'reserved-soft', severity: 'warning', message: `${where} uses these keys in some situations (${hit.action}).`, platforms: [platform], details: { browser, action: hit.action, severity: hit.severity } })\n      }\n    }\n\n    if (platform === 'windows' && parsed.ctrl && parsed.alt && !parsed.meta) {\n      add({ code: 'altgr', severity: 'warning', message: 'On some keyboard layouts Ctrl+Alt acts as AltGr and types characters; those keystrokes are skipped.', platforms: [platform] })\n    }\n\n    if (sites) {\n      const col = SITE_COL[platform]\n      const names = []\n      for (const site of listSites()) {\n        if (site.shortcuts.some((row) => row[col] === key)) names.push(site.name)\n      }\n      if (names.length) {\n        add({ code: 'site-conflict', severity: 'warning', message: `Also used by ${names.join(', ')}.`, platforms: [platform], details: { sites: names } })\n      }\n    }\n  }\n\n  return { ok: !reasons.some((r) => r.severity === 'error'), reasons, lookupKeys }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotkey-router",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "A tiny, deterministic keyboard routing engine for modern web apps.",
   "type": "module",
   "author": "WATT3D <WATT3D@protonmail.com>",
@@ -29,7 +29,17 @@
       "types": "./dist/types/reservations.d.ts",
       "import": "./dist/reservations.js"
     },
-    "./data/browser-hotkeys.json": "./data/browser-hotkeys.json"
+    "./sites": {
+      "types": "./dist/types/sites.d.ts",
+      "import": "./dist/sites.js"
+    },
+    "./validate": {
+      "types": "./dist/types/validate.d.ts",
+      "import": "./dist/validate.js"
+    },
+    "./data/browser-hotkeys.json": "./data/browser-hotkeys.json",
+    "./data/site-hotkeys.json": "./data/site-hotkeys.json",
+    "./data/site-hotkeys.runtime.json": "./data/site-hotkeys.runtime.json"
   },
   "sideEffects": false,
   "files": [
@@ -43,21 +53,22 @@
   "scripts": {
     "build": "node build.js",
     "build:types": "tsc -p tsconfig.types.json",
-    "prepare": "node build.js",
-    "prepublishOnly": "node build.js && npm run build:types",
+    "prepare": "node build.js && npm run build:types",
+    "prepublishOnly": "npm test",
     "test": "vitest run --environment jsdom",
     "test:watch": "vitest --environment jsdom",
     "scrape:diff": "node scripts/scrape-reservations.mjs",
-    "scrape:apply": "node scripts/scrape-reservations.mjs --apply"
+    "scrape:apply": "node scripts/scrape-reservations.mjs --apply",
+    "sites:build": "node scripts/build-site-hotkeys.cjs"
   },
   "devDependencies": {
-    "esbuild": "^0.21.0",
+    "esbuild": "^0.28.1",
     "jsdom": "^24.0.0",
     "typescript": "^5.9.3",
     "vitest": "^3.1.2"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=18"
   },
   "repository": {
     "type": "git",

package/robots.txt

@@ -1,79 +1,79 @@
-# WATT3D — AI scraping policy
-#
-# This file enumerates known AI / LLM training and inference crawlers
-# that the WATT3D AI Training Rider does not consent to. See
-# ./ADDITIONAL_TERMS.md for the legal scope and definitions.
-#
-# Honoring robots.txt is voluntary. The rider applies whether or not
-# a bot respects this file. The enumeration is non-exhaustive — bots
-# not listed here are still bound by the rider if they perform
-# Training Use as defined in ADDITIONAL_TERMS.md §1.
-
-User-agent: GPTBot
-Disallow: /
-
-User-agent: ChatGPT-User
-Disallow: /
-
-User-agent: OAI-SearchBot
-Disallow: /
-
-User-agent: anthropic-ai
-Disallow: /
-
-User-agent: ClaudeBot
-Disallow: /
-
-User-agent: Claude-Web
-Disallow: /
-
-User-agent: Claude-SearchBot
-Disallow: /
-
-User-agent: Google-Extended
-Disallow: /
-
-User-agent: Applebot-Extended
-Disallow: /
-
-User-agent: Meta-ExternalAgent
-Disallow: /
-
-User-agent: Meta-ExternalFetcher
-Disallow: /
-
-User-agent: FacebookBot
-Disallow: /
-
-User-agent: CCBot
-Disallow: /
-
-User-agent: PerplexityBot
-Disallow: /
-
-User-agent: Perplexity-User
-Disallow: /
-
-User-agent: cohere-ai
-Disallow: /
-
-User-agent: Bytespider
-Disallow: /
-
-User-agent: Amazonbot
-Disallow: /
-
-User-agent: Omgilibot
-Disallow: /
-
-User-agent: AI2Bot
-Disallow: /
-
-User-agent: Diffbot
-Disallow: /
-
-# Everyone else: full access. Search engines and human-driven crawlers
-# remain welcome.
-
-User-agent: *
-Allow: /
+# WATT3D — AI scraping policy
+#
+# This file enumerates known AI / LLM training and inference crawlers
+# that the WATT3D AI Training Rider does not consent to. See
+# ./ADDITIONAL_TERMS.md for the legal scope and definitions.
+#
+# Honoring robots.txt is voluntary. The rider applies whether or not
+# a bot respects this file. The enumeration is non-exhaustive — bots
+# not listed here are still bound by the rider if they perform
+# Training Use as defined in ADDITIONAL_TERMS.md §1.
+
+User-agent: GPTBot
+Disallow: /
+
+User-agent: ChatGPT-User
+Disallow: /
+
+User-agent: OAI-SearchBot
+Disallow: /
+
+User-agent: anthropic-ai
+Disallow: /
+
+User-agent: ClaudeBot
+Disallow: /
+
+User-agent: Claude-Web
+Disallow: /
+
+User-agent: Claude-SearchBot
+Disallow: /
+
+User-agent: Google-Extended
+Disallow: /
+
+User-agent: Applebot-Extended
+Disallow: /
+
+User-agent: Meta-ExternalAgent
+Disallow: /
+
+User-agent: Meta-ExternalFetcher
+Disallow: /
+
+User-agent: FacebookBot
+Disallow: /
+
+User-agent: CCBot
+Disallow: /
+
+User-agent: PerplexityBot
+Disallow: /
+
+User-agent: Perplexity-User
+Disallow: /
+
+User-agent: cohere-ai
+Disallow: /
+
+User-agent: Bytespider
+Disallow: /
+
+User-agent: Amazonbot
+Disallow: /
+
+User-agent: Omgilibot
+Disallow: /
+
+User-agent: AI2Bot
+Disallow: /
+
+User-agent: Diffbot
+Disallow: /
+
+# Everyone else: full access. Search engines and human-driven crawlers
+# remain welcome.
+
+User-agent: *
+Allow: /