vuetify/lib/composables/hotkey/hotkey-parsing.js

Vue Material Component Framework

// 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