routie dev init since i didn't adhere to any proper guidance up until now

2026-04-29 22:27:29 -06:00
commit e1dabb71e2
15301 changed files with 3562618 additions and 0 deletions
@@ -0,0 +1,110 @@
+// Utilities
+import { normalizeKey } from "./key-aliases.js";
+import { consoleWarn, includes } from "../../util/index.js"; // Types
+class ParseError extends Error {}
+
+/**
+ * Splits a single combination string into individual key parts.
+ * Grammar:
+ *
+ * sequence   = alternate *('-' alternate)
+ * alternate  = combo *('/' combo)
+ * combo      = key *(('+' | '_') key)
+ * key        = /./ *(/[^-/+_ ]/)
+ *
+ */
+export function parseKeyCombination(input) {
+  let pos = 0;
+  try {
+    const result = parseSequence();
+    if (!atEnd()) {
+      throw new ParseError(`Unexpected character '${peek()}' at position ${pos}`);
+    }
+    return result;
+  } catch (err) {
+    if (err instanceof ParseError) {
+      consoleWarn(`Invalid hotkey combination: ${err.message}\n  ${input}\n  ${' '.repeat(pos)}^`);
+      return '';
+    } else {
+      throw err;
+    }
+  }
+  function peek(ahead = 0) {
+    return pos + ahead < input.length ? input[pos + ahead] : null;
+  }
+  function consume() {
+    if (pos >= input.length) {
+      throw new ParseError('Unexpected end of input');
+    }
+    return input[pos++];
+  }
+  function atEnd() {
+    return pos >= input.length;
+  }
+
+  // sequence = alternate *('-' alternate)
+  function parseSequence() {
+    const parts = [parseAlternate()];
+    while (peek() === '-') {
+      consume();
+      parts.push(parseAlternate());
+    }
+    if (parts.length === 1) return parts[0];
+    return {
+      type: 'sequence',
+      parts
+    };
+  }
+
+  // alternate = combo *('/' combo)
+  function parseAlternate() {
+    const parts = [parseCombo()];
+    while (peek() === '/') {
+      consume();
+      parts.push(parseCombo());
+    }
+    if (parts.length === 1) return parts[0];
+    return {
+      type: 'alternate',
+      parts
+    };
+  }
+
+  // combo = key *(('+' | '_') key)
+  function parseCombo() {
+    const keys = [parseKey()];
+    while (includes(['+', '_'], peek())) {
+      consume();
+      keys.push(parseKey());
+    }
+    if (keys.length === 1) return keys[0];
+    return {
+      type: 'combo',
+      parts: keys
+    };
+  }
+
+  // key = /./ *(/[^-/+_ ]/)
+  function parseKey() {
+    const ch = peek();
+    if (ch == null) {
+      throw new ParseError('Unexpected end of input');
+    }
+    const next = peek(1);
+    if (isSep(ch) && next != null && !isSep(next)) {
+      throw new ParseError(`Unexpected separator '${ch}' at position ${pos}`);
+    }
+    const first = consume();
+    // separator keys are always a single character
+    if (isSep(first)) return first;
+    const chars = [first];
+    while (!atEnd() && !isSep(peek()) && peek() !== ' ') {
+      chars.push(consume());
+    }
+    return normalizeKey(chars.join(''));
+  }
+}
+function isSep(char) {
+  return includes(['-', '/', '+', '_'], char);
+}
+//# sourceMappingURL=hotkey-parsing.js.map