Function matchKeybindingPress

src/tinykeys.ts:203–239

(
	event: KeyboardEvent,
	[requiredModifiers, optionalModifiers, key]: KeybindingPress,
)

 * This tells us if a single keyboard event matches a single keybinding press.
 */
export function matchKeybindingPress(
	event: KeyboardEvent,
	[requiredModifiers, optionalModifiers, key]: KeybindingPress,
): boolean {
	const hasAltGraph = requiredModifiers.includes("AltGraph")
	// prettier-ignore
	return !(
		// Allow either the `event.key` or the `event.code`
		// MDN event.key: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key
		// MDN event.code: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/code
		(
			key instanceof RegExp ? !(key.test(event.key) || key.test(event.code)) :
			(key.toUpperCase() !== event.key.toUpperCase() &&
			key !== event.code)
		) ||

		// Ensure all required modifiers in the keybinding are pressed.
		requiredModifiers.find(mod => {
			return !getModifierState(event, mod)
		}) ||

		// KEYBINDING_MODIFIER_KEYS (Shift/Control/etc) change the meaning of a
		// keybinding. So if they are pressed but aren't part of the current
		// keybinding press, then we don't have a match.
		KEYBINDING_MODIFIER_KEYS.find(mod => {
			return (
				!requiredModifiers.includes(mod) &&
				!optionalModifiers.includes(mod) &&
				key !== mod &&
				getModifierState(event, mod) &&
				// When AltGraph is required, its alias modifiers (e.g. Alt, Control)
				// being active is expected — don't treat them as unexpected modifiers.
				!(hasAltGraph && ALT_GRAPH_ALIASES.includes(mod))
			);
		})
	)
}

/**
 * Creates an event listener for handling keybindings.