@tanstack/hotkeys 0.9.0 → 0.10.0

package/dist/sequence-manager.cjs

@@ -1,441 +0,0 @@
-const require_constants = require('./constants.cjs');
-const require_platform = require('./platform.cjs');
-const require__keyboard_event = require('./_keyboard-event.cjs');
-const require_parse = require('./parse.cjs');
-const require_format = require('./format.cjs');
-const require__match = require('./_match.cjs');
-const require_match = require('./match.cjs');
-const require__recording_guard = require('./_recording-guard.cjs');
-const require__registration = require('./_registration.cjs');
-const require__event_target = require('./_event-target.cjs');
-let _tanstack_store = require("@tanstack/store");
-
-//#region src/sequence-manager.ts
-/**
-* Default timeout between keys in a sequence (in milliseconds).
-* Exported for consumers that display sequence state (e.g. devtools).
-*/
-const DEFAULT_SEQUENCE_TIMEOUT = 1e3;
-let sequenceIdCounter = 0;
-/**
-* Generates a unique ID for sequence registrations.
-*/
-function generateSequenceId() {
-	return `sequence_${++sequenceIdCounter}`;
-}
-/**
-* Manages keyboard sequence matching for Vim-style shortcuts.
-*
-* This class allows registering multi-key sequences like 'g g' or 'd d'
-* that trigger callbacks when the full sequence is pressed within
-* a configurable timeout.
-*
-* Modifier-only `keydown` / `keyup` events (Shift, Control, Alt, or Meta
-* alone) are not processed: they neither match a step nor reset progress.
-* That supports chained modifier chords (e.g. `Shift+R` then `Shift+T`) when
-* the user presses a modifier alone between steps.
-*
-* @example
-* ```ts
-* const matcher = SequenceManager.getInstance()
-*
-* // Register 'g g' to go to top
-* const unregister = matcher.register(['G', 'G'], (event, context) => {
-*   scrollToTop()
-* }, { timeout: 500 })
-*
-* // Later, to unregister:
-* unregister()
-* ```
-*/
-/**
-* Builds a devtools view from an internal registration.
-*/
-function toRegistrationView(reg) {
-	const len = reg.parsedSequence.length;
-	const inProgress = reg.currentIndex > 0 && reg.currentIndex < len;
-	return {
-		id: reg.id,
-		sequence: reg.sequence,
-		options: reg.options,
-		target: reg.target,
-		triggerCount: reg.triggerCount,
-		hasFired: reg.hasFired,
-		matchedStepCount: inProgress ? reg.currentIndex : 0,
-		partialMatchLastKeyTime: inProgress ? reg.lastKeyTime : 0
-	};
-}
-var SequenceManager = class SequenceManager {
-	static #instance = null;
-	#registrations = /* @__PURE__ */ new Map();
-	#targetListeners = /* @__PURE__ */ new Map();
-	#targetRegistrations = /* @__PURE__ */ new Map();
-	#platform;
-	constructor() {
-		this.registrations = new _tanstack_store.Store(/* @__PURE__ */ new Map());
-		this.#platform = require_platform.detectPlatform();
-	}
-	/**
-	* Gets the singleton instance of SequenceManager.
-	*/
-	static getInstance() {
-		if (!SequenceManager.#instance) SequenceManager.#instance = new SequenceManager();
-		return SequenceManager.#instance;
-	}
-	/**
-	* Resets the singleton instance. Useful for testing.
-	*/
-	static resetInstance() {
-		if (SequenceManager.#instance) {
-			SequenceManager.#instance.destroy();
-			SequenceManager.#instance = null;
-		}
-	}
-	#syncRegistrationView(registration) {
-		this.registrations.setState((prev) => new Map(prev).set(registration.id, toRegistrationView(registration)));
-	}
-	/**
-	* Registers a hotkey sequence handler.
-	*
-	* @param sequence - Array of hotkey strings that form the sequence
-	* @param callback - Function to call when the sequence is completed
-	* @param options - Options for the sequence behavior
-	* @returns A handle to update or unregister the sequence
-	*/
-	register(sequence, callback, options = {}) {
-		if (sequence.length === 0) throw new Error("Sequence must contain at least one hotkey");
-		const id = generateSequenceId();
-		const platform = options.platform ?? this.#platform;
-		const parsedSequence = sequence.map((hotkey) => require_parse.parseHotkey(hotkey, platform));
-		const target = options.target ?? (typeof document !== "undefined" ? document : {});
-		const conflictBehavior = options.conflictBehavior ?? "warn";
-		const conflictingRegistration = this.#findConflictingSequence(parsedSequence, target);
-		if (conflictingRegistration) require__registration.handleConflict(conflictingRegistration.id, require_format.formatHotkeySequence(sequence), conflictBehavior, (regId) => this.#unregister(regId));
-		const firstStep = parsedSequence[0];
-		const resolvedIgnoreInputs = options.ignoreInputs ?? require__registration.getDefaultIgnoreInputs(firstStep);
-		const registration = {
-			id,
-			sequence,
-			parsedSequence,
-			callback,
-			options: {
-				...require__registration.defaultHotkeyOptions,
-				timeout: DEFAULT_SEQUENCE_TIMEOUT,
-				...options,
-				platform,
-				ignoreInputs: resolvedIgnoreInputs
-			},
-			target,
-			currentIndex: 0,
-			lastKeyTime: 0,
-			triggerCount: 0,
-			hasFired: false
-		};
-		this.#registrations.set(id, registration);
-		this.registrations.setState((prev) => new Map(prev).set(id, toRegistrationView(registration)));
-		if (!this.#targetRegistrations.has(target)) this.#targetRegistrations.set(target, /* @__PURE__ */ new Set());
-		this.#targetRegistrations.get(target).add(id);
-		this.#ensureListenersForTarget(target);
-		const manager = this;
-		return {
-			get id() {
-				return id;
-			},
-			get isActive() {
-				return manager.#registrations.has(id);
-			},
-			get callback() {
-				return manager.#registrations.get(id)?.callback ?? callback;
-			},
-			set callback(newCallback) {
-				const reg = manager.#registrations.get(id);
-				if (reg) reg.callback = newCallback;
-			},
-			setOptions: (newOptions) => {
-				const reg = manager.#registrations.get(id);
-				if (reg && !require__registration.optionsEqual(reg.options, {
-					...reg.options,
-					...newOptions
-				})) {
-					reg.options = {
-						...reg.options,
-						...newOptions
-					};
-					manager.registrations.setState((prev) => new Map(prev).set(id, toRegistrationView(reg)));
-				}
-			},
-			unregister: () => {
-				manager.#unregister(id);
-			}
-		};
-	}
-	/**
-	* Unregisters a sequence by its registration ID.
-	*/
-	#unregister(id) {
-		const registration = this.#registrations.get(id);
-		if (!registration) return;
-		const target = registration.target;
-		this.#registrations.delete(id);
-		this.registrations.setState((prev) => {
-			const next = new Map(prev);
-			next.delete(id);
-			return next;
-		});
-		const targetRegs = this.#targetRegistrations.get(target);
-		if (targetRegs) {
-			targetRegs.delete(id);
-			if (targetRegs.size === 0) this.#removeListenersForTarget(target);
-		}
-	}
-	/**
-	* Ensures event listeners are attached for a specific target.
-	*/
-	#ensureListenersForTarget(target) {
-		if (typeof document === "undefined") return;
-		if (this.#targetListeners.has(target)) return;
-		const keydownHandler = this.#createTargetKeyDownHandler(target);
-		const keyupHandler = this.#createTargetKeyUpHandler(target);
-		target.addEventListener("keydown", keydownHandler);
-		target.addEventListener("keyup", keyupHandler);
-		this.#targetListeners.set(target, {
-			keydown: keydownHandler,
-			keyup: keyupHandler
-		});
-	}
-	/**
-	* Removes event listeners for a specific target.
-	*/
-	#removeListenersForTarget(target) {
-		if (typeof document === "undefined") return;
-		const listeners = this.#targetListeners.get(target);
-		if (!listeners) return;
-		target.removeEventListener("keydown", listeners.keydown);
-		target.removeEventListener("keyup", listeners.keyup);
-		this.#targetListeners.delete(target);
-		this.#targetRegistrations.delete(target);
-	}
-	/**
-	* Creates a keydown handler for a specific target.
-	*/
-	#createTargetKeyDownHandler(target) {
-		return (event) => {
-			this.#processTargetEvent(event, target, "keydown");
-		};
-	}
-	/**
-	* Creates a keyup handler for a specific target.
-	*/
-	#createTargetKeyUpHandler(target) {
-		return (event) => {
-			this.#processTargetEvent(event, target, "keyup");
-		};
-	}
-	/**
-	* Processes keyboard events for a specific target and event type.
-	*/
-	#processTargetEvent(event, target, eventType) {
-		if (require__recording_guard.isRecordingEvent(event)) {
-			for (const id of this.#targetRegistrations.get(target) ?? []) {
-				const registration = this.#registrations.get(id);
-				if (registration && registration.currentIndex > 0) {
-					registration.currentIndex = 0;
-					this.#syncRegistrationView(registration);
-				}
-			}
-			return;
-		}
-		if (event.type === "keydown" && event.repeat || require__keyboard_event.normalizeKeyboardEvent(event).isComposing) return;
-		if (require_parse.isModifierKey(require_constants.normalizeKeyName(event.key))) return;
-		const targetRegs = this.#targetRegistrations.get(target);
-		if (!targetRegs) return;
-		const now = Date.now();
-		const candidates = /* @__PURE__ */ new Map();
-		let bestScore = 0;
-		registrationIds: for (const id of targetRegs) {
-			const registration = this.#registrations.get(id);
-			if (!registration) continue;
-			if (!require__event_target.isEventForTarget(event, target)) continue;
-			if (!registration.options.enabled) continue;
-			if (registration.options.ignoreInputs !== false) {
-				if (require__event_target.shouldIgnoreInputEvent(event, target, registration.target)) continue registrationIds;
-			}
-			if (registration.options.eventType !== eventType) continue;
-			const timeout = registration.options.timeout ?? 1e3;
-			if (registration.currentIndex > 0 && now - registration.lastKeyTime > timeout) {
-				registration.currentIndex = 0;
-				this.#syncRegistrationView(registration);
-			}
-			const expectedHotkey = registration.parsedSequence[registration.currentIndex];
-			if (!expectedHotkey) continue;
-			let match = require__match.matchKeyboardEvent(event, expectedHotkey, registration.options.platform);
-			let nextIndex = registration.currentIndex + 1;
-			if (!match.matched && registration.currentIndex > 0) {
-				match = require__match.matchKeyboardEvent(event, registration.parsedSequence[0], registration.options.platform);
-				nextIndex = 1;
-			}
-			candidates.set(id, {
-				score: match.score,
-				nextIndex
-			});
-			bestScore = Math.max(bestScore, match.score);
-		}
-		for (const [id, candidate] of candidates) {
-			const registration = this.#registrations.get(id);
-			if (!registration || !registration.options.enabled) continue;
-			if (candidate.score > 0 && candidate.score === bestScore) {
-				registration.lastKeyTime = now;
-				registration.currentIndex = candidate.nextIndex;
-				if (registration.currentIndex >= registration.parsedSequence.length) {
-					if (registration.options.preventDefault) event.preventDefault();
-					if (registration.options.stopPropagation) event.stopPropagation();
-					const context = {
-						hotkey: registration.sequence.join(" "),
-						parsedHotkey: registration.parsedSequence[registration.parsedSequence.length - 1]
-					};
-					registration.triggerCount++;
-					registration.hasFired = true;
-					registration.currentIndex = 0;
-					this.#syncRegistrationView(registration);
-					registration.callback(event, context);
-				} else this.#syncRegistrationView(registration);
-			} else if (registration.currentIndex > 0) {
-				registration.currentIndex = 0;
-				this.#syncRegistrationView(registration);
-			}
-		}
-	}
-	/**
-	* Compares resolved step identities without changing the supplied sequence strings.
-	*/
-	#findConflictingSequence(parsedSequence, target) {
-		for (const registration of this.#registrations.values()) if (registration.target === target && registration.parsedSequence.length === parsedSequence.length && parsedSequence.every((step, index) => require_match.areHotkeysEqual(step, registration.parsedSequence[index]))) return registration;
-		return null;
-	}
-	/**
-	* Resets all sequence progress.
-	*/
-	resetAll() {
-		for (const registration of this.#registrations.values()) {
-			registration.currentIndex = 0;
-			registration.lastKeyTime = 0;
-			this.#syncRegistrationView(registration);
-		}
-	}
-	/**
-	* Triggers a sequence's callback programmatically from devtools.
-	* Creates a synthetic KeyboardEvent from the last key in the sequence.
-	*
-	* @param id - The registration ID to trigger
-	* @returns True if the registration was found and triggered
-	*/
-	triggerSequence(id) {
-		const registration = this.#registrations.get(id);
-		if (!registration) return false;
-		const lastParsed = registration.parsedSequence[registration.parsedSequence.length - 1];
-		if (!lastParsed) return false;
-		const syntheticEvent = new KeyboardEvent(registration.options.eventType ?? "keydown", {
-			...lastParsed.code !== void 0 ? { code: lastParsed.code } : { key: lastParsed.key },
-			ctrlKey: lastParsed.ctrl,
-			shiftKey: lastParsed.shift,
-			altKey: lastParsed.alt,
-			metaKey: lastParsed.meta,
-			bubbles: true,
-			cancelable: true
-		});
-		registration.triggerCount++;
-		registration.hasFired = true;
-		this.#syncRegistrationView(registration);
-		const context = {
-			hotkey: registration.sequence.join(" "),
-			parsedHotkey: lastParsed
-		};
-		registration.callback(syntheticEvent, context);
-		return true;
-	}
-	/**
-	* Gets the number of registered sequences.
-	*/
-	getRegistrationCount() {
-		return this.#registrations.size;
-	}
-	/**
-	* Destroys the manager and removes all listeners.
-	*/
-	destroy() {
-		for (const target of this.#targetListeners.keys()) this.#removeListenersForTarget(target);
-		this.#registrations.clear();
-		this.registrations.setState(() => /* @__PURE__ */ new Map());
-	}
-};
-/**
-* Gets the singleton SequenceManager instance.
-* Convenience function for accessing the manager.
-*/
-function getSequenceManager() {
-	return SequenceManager.getInstance();
-}
-/**
-* Creates a simple sequence matcher for one-off use.
-*
-* This is a low-level helper that does not support ignoreInputs, target,
-* or other HotkeyOptions. Callers must handle input filtering themselves
-* if attaching to document.
-*
-* @param sequence - The sequence of hotkeys to match
-* @param options - Options including timeout
-* @returns An object with match() and reset() methods
-*
-* @example
-* ```ts
-* const matcher = createSequenceMatcher(['G', 'G'], { timeout: 500 })
-*
-* document.addEventListener('keydown', (event) => {
-*   if (matcher.match(event)) {
-*     console.log('Sequence matched!')
-*   }
-* })
-* ```
-*/
-function createSequenceMatcher(sequence, options = {}) {
-	const platform = options.platform ?? require_platform.detectPlatform();
-	const timeout = options.timeout ?? 1e3;
-	const parsedSequence = sequence.map((hotkey) => require_parse.parseHotkey(hotkey, platform));
-	let currentIndex = 0;
-	let lastKeyTime = 0;
-	return {
-		match(event) {
-			if (event.type === "keydown" && event.repeat || require__keyboard_event.normalizeKeyboardEvent(event, platform).isComposing || require_parse.isModifierKey(require_constants.normalizeKeyName(event.key))) return false;
-			const now = Date.now();
-			if (currentIndex > 0 && now - lastKeyTime > timeout) currentIndex = 0;
-			const expected = parsedSequence[currentIndex];
-			if (!expected) return false;
-			if (require_match.matchesKeyboardEvent(event, expected, platform)) {
-				lastKeyTime = now;
-				currentIndex++;
-				if (currentIndex >= parsedSequence.length) {
-					currentIndex = 0;
-					return true;
-				}
-			} else if (currentIndex > 0) if (require_match.matchesKeyboardEvent(event, parsedSequence[0], platform)) {
-				currentIndex = 1;
-				lastKeyTime = now;
-			} else currentIndex = 0;
-			return false;
-		},
-		reset() {
-			currentIndex = 0;
-			lastKeyTime = 0;
-		},
-		getProgress() {
-			return currentIndex;
-		}
-	};
-}
-
-//#endregion
-exports.DEFAULT_SEQUENCE_TIMEOUT = DEFAULT_SEQUENCE_TIMEOUT;
-exports.SequenceManager = SequenceManager;
-exports.createSequenceMatcher = createSequenceMatcher;
-exports.getSequenceManager = getSequenceManager;
-//# sourceMappingURL=sequence-manager.cjs.map

package/dist/sequence-manager.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sequence-manager.cjs","names":["#instance","Store","#platform","detectPlatform","parseHotkey","#findConflictingSequence","formatHotkeySequence","#unregister","getDefaultIgnoreInputs","defaultHotkeyOptions","#registrations","#targetRegistrations","#ensureListenersForTarget","optionsEqual","#removeListenersForTarget","#targetListeners","#createTargetKeyDownHandler","#createTargetKeyUpHandler","#processTargetEvent","isRecordingEvent","#syncRegistrationView","normalizeKeyboardEvent","isModifierKey","normalizeKeyName","isEventForTarget","shouldIgnoreInputEvent","matchKeyboardEvent","areHotkeysEqual","matchesKeyboardEvent"],"sources":["../src/sequence-manager.ts"],"sourcesContent":["import { Store } from '@tanstack/store'\nimport { isRecordingEvent } from './_recording-guard'\nimport { formatHotkeySequence } from './format'\nimport { detectPlatform } from './platform'\nimport { normalizeKeyName } from './constants'\nimport { isModifierKey, parseHotkey } from './parse'\nimport { areHotkeysEqual, matchesKeyboardEvent } from './match'\nimport { matchKeyboardEvent } from './_match'\nimport { normalizeKeyboardEvent } from './_keyboard-event'\nimport {\n  defaultHotkeyOptions,\n  getDefaultIgnoreInputs,\n  handleConflict,\n  optionsEqual,\n} from './_registration'\nimport { isEventForTarget, shouldIgnoreInputEvent } from './_event-target'\nimport type { HotkeyOptions } from './hotkey-manager'\nimport type {\n  Hotkey,\n  HotkeyCallback,\n  HotkeyCallbackContext,\n  ParsedHotkey,\n} from './hotkey.types'\n\nexport type Target = HTMLElement | Document | Window\n\n/**\n * Options for hotkey sequence matching.\n * Extends HotkeyOptions but excludes requireReset (not applicable to sequences).\n */\nexport interface SequenceOptions extends Omit<HotkeyOptions, 'requireReset'> {\n  /** Timeout between keys in milliseconds. Default: 1000 */\n  timeout?: number\n}\n\n/**\n * A sequence of hotkeys for Vim-style shortcuts.\n *\n * Each element is one step (a `Hotkey` string). Steps may include modifiers;\n * the same modifier can appear on consecutive steps (e.g. `Shift+R` then\n * `Shift+T`). Modifier-only key events do not advance or reset matching—see\n * `SequenceManager`. Automatic keydown repeats and IME composition are also ignored.\n *\n * @example\n * ```ts\n * const gotoTop: HotkeySequence = ['G', 'G']  // gg\n * const deleteLine: HotkeySequence = ['D', 'D']  // dd\n * const deleteWord: HotkeySequence = ['D', 'I', 'W']  // diw\n * const chainedShift: HotkeySequence = ['Shift+R', 'Shift+T']\n * ```\n */\nexport type HotkeySequence = Array<Hotkey>\n\n/**\n * Default timeout between keys in a sequence (in milliseconds).\n * Exported for consumers that display sequence state (e.g. devtools).\n */\nexport const DEFAULT_SEQUENCE_TIMEOUT = 1000\n\nlet sequenceIdCounter = 0\n\n/**\n * Generates a unique ID for sequence registrations.\n */\nfunction generateSequenceId(): string {\n  return `sequence_${++sequenceIdCounter}`\n}\n\n/**\n * View of a sequence registration for devtools display.\n * Progress fields reflect an in-progress match (between first key and completion or timeout).\n */\nexport interface SequenceRegistrationView {\n  id: string\n  sequence: HotkeySequence\n  options: SequenceOptions\n  target: Target\n  triggerCount: number\n  /** Whether this sequence has been triggered at least once. */\n  hasFired: boolean\n  /** Steps matched in the current attempt (0 when idle or just completed). */\n  matchedStepCount: number\n  /** `Date.now()` when the last step in the current attempt matched; 0 if none. */\n  partialMatchLastKeyTime: number\n}\n\n/**\n * Internal representation of a sequence registration.\n */\nexport interface SequenceRegistration {\n  id: string\n  sequence: HotkeySequence\n  parsedSequence: Array<ParsedHotkey>\n  callback: HotkeyCallback\n  options: SequenceOptions\n  target: Target\n  currentIndex: number\n  lastKeyTime: number\n  triggerCount: number\n  hasFired: boolean\n}\n\n/**\n * A handle returned from SequenceManager.register() that allows updating\n * the callback and options without re-registering the sequence.\n *\n * @example\n * ```ts\n * const handle = manager.register(['G', 'G'], callback, options)\n *\n * handle.callback = newCallback\n * handle.setOptions({ timeout: 500 })\n * handle.unregister()\n * ```\n */\nexport interface SequenceRegistrationHandle {\n  readonly id: string\n  readonly isActive: boolean\n  callback: HotkeyCallback\n  setOptions: (options: Partial<SequenceOptions>) => void\n  unregister: () => void\n}\n\n/**\n * Manages keyboard sequence matching for Vim-style shortcuts.\n *\n * This class allows registering multi-key sequences like 'g g' or 'd d'\n * that trigger callbacks when the full sequence is pressed within\n * a configurable timeout.\n *\n * Modifier-only `keydown` / `keyup` events (Shift, Control, Alt, or Meta\n * alone) are not processed: they neither match a step nor reset progress.\n * That supports chained modifier chords (e.g. `Shift+R` then `Shift+T`) when\n * the user presses a modifier alone between steps.\n *\n * @example\n * ```ts\n * const matcher = SequenceManager.getInstance()\n *\n * // Register 'g g' to go to top\n * const unregister = matcher.register(['G', 'G'], (event, context) => {\n *   scrollToTop()\n * }, { timeout: 500 })\n *\n * // Later, to unregister:\n * unregister()\n * ```\n */\n/**\n * Builds a devtools view from an internal registration.\n */\nfunction toRegistrationView(\n  reg: SequenceRegistration,\n): SequenceRegistrationView {\n  const len = reg.parsedSequence.length\n  const inProgress = reg.currentIndex > 0 && reg.currentIndex < len\n  return {\n    id: reg.id,\n    sequence: reg.sequence,\n    options: reg.options,\n    target: reg.target,\n    triggerCount: reg.triggerCount,\n    hasFired: reg.hasFired,\n    matchedStepCount: inProgress ? reg.currentIndex : 0,\n    partialMatchLastKeyTime: inProgress ? reg.lastKeyTime : 0,\n  }\n}\n\nexport class SequenceManager {\n  static #instance: SequenceManager | null = null\n\n  /**\n   * The TanStack Store containing sequence registration views for devtools.\n   * Subscribe to this to observe registration changes.\n   */\n  readonly registrations: Store<Map<string, SequenceRegistrationView>> =\n    new Store(new Map())\n\n  #registrations: Map<string, SequenceRegistration> = new Map()\n  #targetListeners: Map<\n    Target,\n    {\n      keydown: (event: KeyboardEvent) => void\n      keyup: (event: KeyboardEvent) => void\n    }\n  > = new Map()\n  #targetRegistrations: Map<Target, Set<string>> = new Map()\n  #platform: 'mac' | 'windows' | 'linux'\n\n  private constructor() {\n    this.#platform = detectPlatform()\n  }\n\n  /**\n   * Gets the singleton instance of SequenceManager.\n   */\n  static getInstance(): SequenceManager {\n    if (!SequenceManager.#instance) {\n      SequenceManager.#instance = new SequenceManager()\n    }\n    return SequenceManager.#instance\n  }\n\n  /**\n   * Resets the singleton instance. Useful for testing.\n   */\n  static resetInstance(): void {\n    if (SequenceManager.#instance) {\n      SequenceManager.#instance.destroy()\n      SequenceManager.#instance = null\n    }\n  }\n\n  #syncRegistrationView(registration: SequenceRegistration): void {\n    this.registrations.setState((prev) =>\n      new Map(prev).set(registration.id, toRegistrationView(registration)),\n    )\n  }\n\n  /**\n   * Registers a hotkey sequence handler.\n   *\n   * @param sequence - Array of hotkey strings that form the sequence\n   * @param callback - Function to call when the sequence is completed\n   * @param options - Options for the sequence behavior\n   * @returns A handle to update or unregister the sequence\n   */\n  register(\n    sequence: HotkeySequence,\n    callback: HotkeyCallback,\n    options: SequenceOptions = {},\n  ): SequenceRegistrationHandle {\n    if (sequence.length === 0) {\n      throw new Error('Sequence must contain at least one hotkey')\n    }\n\n    const id = generateSequenceId()\n    const platform = options.platform ?? this.#platform\n    const parsedSequence = sequence.map((hotkey) =>\n      parseHotkey(hotkey, platform),\n    )\n\n    // Resolve target: default to document if not provided or null\n    const target: Target =\n      options.target ??\n      (typeof document !== 'undefined' ? document : ({} as Document))\n\n    // Resolve conflict behavior\n    const conflictBehavior = options.conflictBehavior ?? 'warn'\n\n    // Check for existing registrations with the same sequence and target\n    const conflictingRegistration = this.#findConflictingSequence(\n      parsedSequence,\n      target,\n    )\n\n    if (conflictingRegistration) {\n      handleConflict(\n        conflictingRegistration.id,\n        formatHotkeySequence(sequence),\n        conflictBehavior,\n        (regId) => this.#unregister(regId),\n      )\n    }\n\n    const firstStep = parsedSequence[0]!\n    const resolvedIgnoreInputs =\n      options.ignoreInputs ?? getDefaultIgnoreInputs(firstStep)\n\n    const baseOptions = {\n      ...defaultHotkeyOptions,\n      timeout: DEFAULT_SEQUENCE_TIMEOUT,\n      ...options,\n      platform,\n      ignoreInputs: resolvedIgnoreInputs,\n    }\n\n    const registration: SequenceRegistration = {\n      id,\n      sequence,\n      parsedSequence,\n      callback,\n      options: baseOptions,\n      target,\n      currentIndex: 0,\n      lastKeyTime: 0,\n      triggerCount: 0,\n      hasFired: false,\n    }\n\n    this.#registrations.set(id, registration)\n    this.registrations.setState((prev) =>\n      new Map(prev).set(id, toRegistrationView(registration)),\n    )\n\n    // Track registration for this target\n    if (!this.#targetRegistrations.has(target)) {\n      this.#targetRegistrations.set(target, new Set())\n    }\n    this.#targetRegistrations.get(target)!.add(id)\n\n    // Ensure listeners are attached for this target\n    this.#ensureListenersForTarget(target)\n\n    const manager = this\n    const handle: SequenceRegistrationHandle = {\n      get id() {\n        return id\n      },\n      get isActive() {\n        return manager.#registrations.has(id)\n      },\n      get callback() {\n        const reg = manager.#registrations.get(id)\n        return reg?.callback ?? callback\n      },\n      set callback(newCallback: HotkeyCallback) {\n        const reg = manager.#registrations.get(id)\n        if (reg) {\n          reg.callback = newCallback\n        }\n      },\n      setOptions: (newOptions: Partial<SequenceOptions>) => {\n        const reg = manager.#registrations.get(id)\n        if (\n          reg &&\n          !optionsEqual(reg.options, { ...reg.options, ...newOptions })\n        ) {\n          reg.options = { ...reg.options, ...newOptions }\n          manager.registrations.setState((prev) =>\n            new Map(prev).set(id, toRegistrationView(reg)),\n          )\n        }\n      },\n      unregister: () => {\n        manager.#unregister(id)\n      },\n    }\n\n    return handle\n  }\n\n  /**\n   * Unregisters a sequence by its registration ID.\n   */\n  #unregister(id: string): void {\n    const registration = this.#registrations.get(id)\n    if (!registration) {\n      return\n    }\n\n    const target = registration.target\n\n    this.#registrations.delete(id)\n    this.registrations.setState((prev) => {\n      const next = new Map(prev)\n      next.delete(id)\n      return next\n    })\n\n    // Remove from target registrations tracking\n    const targetRegs = this.#targetRegistrations.get(target)\n    if (targetRegs) {\n      targetRegs.delete(id)\n      if (targetRegs.size === 0) {\n        this.#removeListenersForTarget(target)\n      }\n    }\n  }\n\n  /**\n   * Ensures event listeners are attached for a specific target.\n   */\n  #ensureListenersForTarget(target: Target): void {\n    if (typeof document === 'undefined') {\n      return // SSR safety\n    }\n\n    if (this.#targetListeners.has(target)) {\n      return\n    }\n\n    const keydownHandler = this.#createTargetKeyDownHandler(target)\n    const keyupHandler = this.#createTargetKeyUpHandler(target)\n\n    target.addEventListener('keydown', keydownHandler as EventListener)\n    target.addEventListener('keyup', keyupHandler as EventListener)\n\n    this.#targetListeners.set(target, {\n      keydown: keydownHandler,\n      keyup: keyupHandler,\n    })\n  }\n\n  /**\n   * Removes event listeners for a specific target.\n   */\n  #removeListenersForTarget(target: Target): void {\n    if (typeof document === 'undefined') {\n      return\n    }\n\n    const listeners = this.#targetListeners.get(target)\n    if (!listeners) {\n      return\n    }\n\n    target.removeEventListener('keydown', listeners.keydown as EventListener)\n    target.removeEventListener('keyup', listeners.keyup as EventListener)\n\n    this.#targetListeners.delete(target)\n    this.#targetRegistrations.delete(target)\n  }\n\n  /**\n   * Creates a keydown handler for a specific target.\n   */\n  #createTargetKeyDownHandler(target: Target): (event: KeyboardEvent) => void {\n    return (event: KeyboardEvent) => {\n      this.#processTargetEvent(event, target, 'keydown')\n    }\n  }\n\n  /**\n   * Creates a keyup handler for a specific target.\n   */\n  #createTargetKeyUpHandler(target: Target): (event: KeyboardEvent) => void {\n    return (event: KeyboardEvent) => {\n      this.#processTargetEvent(event, target, 'keyup')\n    }\n  }\n\n  /**\n   * Processes keyboard events for a specific target and event type.\n   */\n  #processTargetEvent(\n    event: KeyboardEvent,\n    target: Target,\n    eventType: 'keydown' | 'keyup',\n  ): void {\n    if (isRecordingEvent(event)) {\n      for (const id of this.#targetRegistrations.get(target) ?? []) {\n        const registration = this.#registrations.get(id)\n        if (registration && registration.currentIndex > 0) {\n          registration.currentIndex = 0\n          this.#syncRegistrationView(registration)\n        }\n      }\n      return\n    }\n    if (\n      (event.type === 'keydown' && event.repeat) ||\n      normalizeKeyboardEvent(event).isComposing\n    ) {\n      return\n    }\n    // Skip modifier-only events so pressing e.g. Shift before Shift+C does not reset the sequence.\n    if (isModifierKey(normalizeKeyName(event.key))) {\n      return\n    }\n\n    const targetRegs = this.#targetRegistrations.get(target)\n    if (!targetRegs) {\n      return\n    }\n\n    const now = Date.now()\n    // Score eligible next steps (or restarts) before advancing any sequence.\n    const candidates = new Map<string, { score: number; nextIndex: number }>()\n    let bestScore = 0\n\n    registrationIds: for (const id of targetRegs) {\n      const registration = this.#registrations.get(id)\n      if (!registration) {\n        continue\n      }\n\n      if (!isEventForTarget(event, target)) {\n        continue\n      }\n\n      if (!registration.options.enabled) {\n        continue\n      }\n\n      // Check if we should ignore input elements (defaults to true)\n      if (registration.options.ignoreInputs !== false) {\n        if (shouldIgnoreInputEvent(event, target, registration.target)) {\n          continue registrationIds\n        }\n      }\n\n      // Only process registrations that listen for this event type\n      if (registration.options.eventType !== eventType) {\n        continue\n      }\n\n      const timeout = registration.options.timeout ?? DEFAULT_SEQUENCE_TIMEOUT\n\n      // Check if sequence has timed out\n      if (\n        registration.currentIndex > 0 &&\n        now - registration.lastKeyTime > timeout\n      ) {\n        registration.currentIndex = 0\n        this.#syncRegistrationView(registration)\n      }\n\n      const expectedHotkey =\n        registration.parsedSequence[registration.currentIndex]\n      if (!expectedHotkey) {\n        continue\n      }\n\n      let match = matchKeyboardEvent(\n        event,\n        expectedHotkey,\n        registration.options.platform,\n      )\n      let nextIndex = registration.currentIndex + 1\n      if (!match.matched && registration.currentIndex > 0) {\n        match = matchKeyboardEvent(\n          event,\n          registration.parsedSequence[0]!,\n          registration.options.platform,\n        )\n        nextIndex = 1\n      }\n      candidates.set(id, { score: match.score, nextIndex })\n      bestScore = Math.max(bestScore, match.score)\n    }\n\n    for (const [id, candidate] of candidates) {\n      const registration = this.#registrations.get(id)\n      if (!registration || !registration.options.enabled) continue\n      if (candidate.score > 0 && candidate.score === bestScore) {\n        registration.lastKeyTime = now\n        registration.currentIndex = candidate.nextIndex\n\n        if (registration.currentIndex >= registration.parsedSequence.length) {\n          if (registration.options.preventDefault) {\n            event.preventDefault()\n          }\n          if (registration.options.stopPropagation) {\n            event.stopPropagation()\n          }\n\n          const context: HotkeyCallbackContext = {\n            hotkey: registration.sequence.join(' ') as Hotkey,\n            parsedHotkey:\n              registration.parsedSequence[\n                registration.parsedSequence.length - 1\n              ]!,\n          }\n\n          registration.triggerCount++\n          registration.hasFired = true\n          registration.currentIndex = 0\n\n          this.#syncRegistrationView(registration)\n\n          registration.callback(event, context)\n        } else {\n          this.#syncRegistrationView(registration)\n        }\n      } else if (registration.currentIndex > 0) {\n        // A mismatched or weaker candidate cannot carry stale progress forward.\n        registration.currentIndex = 0\n        this.#syncRegistrationView(registration)\n      }\n    }\n  }\n\n  /**\n   * Compares resolved step identities without changing the supplied sequence strings.\n   */\n  #findConflictingSequence(\n    parsedSequence: Array<ParsedHotkey>,\n    target: Target,\n  ): SequenceRegistration | null {\n    for (const registration of this.#registrations.values()) {\n      if (\n        registration.target === target &&\n        registration.parsedSequence.length === parsedSequence.length &&\n        parsedSequence.every((step, index) =>\n          areHotkeysEqual(step, registration.parsedSequence[index]!),\n        )\n      ) {\n        return registration\n      }\n    }\n    return null\n  }\n\n  /**\n   * Resets all sequence progress.\n   */\n  resetAll(): void {\n    for (const registration of this.#registrations.values()) {\n      registration.currentIndex = 0\n      registration.lastKeyTime = 0\n      this.#syncRegistrationView(registration)\n    }\n  }\n\n  /**\n   * Triggers a sequence's callback programmatically from devtools.\n   * Creates a synthetic KeyboardEvent from the last key in the sequence.\n   *\n   * @param id - The registration ID to trigger\n   * @returns True if the registration was found and triggered\n   */\n  triggerSequence(id: string): boolean {\n    const registration = this.#registrations.get(id)\n    if (!registration) {\n      return false\n    }\n\n    const lastParsed =\n      registration.parsedSequence[registration.parsedSequence.length - 1]\n    if (!lastParsed) {\n      return false\n    }\n\n    const syntheticEvent = new KeyboardEvent(\n      registration.options.eventType ?? 'keydown',\n      {\n        ...(lastParsed.code !== undefined\n          ? { code: lastParsed.code }\n          : { key: lastParsed.key }),\n        ctrlKey: lastParsed.ctrl,\n        shiftKey: lastParsed.shift,\n        altKey: lastParsed.alt,\n        metaKey: lastParsed.meta,\n        bubbles: true,\n        cancelable: true,\n      },\n    )\n\n    registration.triggerCount++\n    registration.hasFired = true\n\n    this.#syncRegistrationView(registration)\n\n    const context: HotkeyCallbackContext = {\n      hotkey: registration.sequence.join(' ') as Hotkey,\n      parsedHotkey: lastParsed,\n    }\n\n    registration.callback(syntheticEvent, context)\n\n    return true\n  }\n\n  /**\n   * Gets the number of registered sequences.\n   */\n  getRegistrationCount(): number {\n    return this.#registrations.size\n  }\n\n  /**\n   * Destroys the manager and removes all listeners.\n   */\n  destroy(): void {\n    for (const target of this.#targetListeners.keys()) {\n      this.#removeListenersForTarget(target)\n    }\n    this.#registrations.clear()\n    this.registrations.setState(() => new Map())\n  }\n}\n\n/**\n * Gets the singleton SequenceManager instance.\n * Convenience function for accessing the manager.\n */\nexport function getSequenceManager(): SequenceManager {\n  return SequenceManager.getInstance()\n}\n\n/**\n * Creates a simple sequence matcher for one-off use.\n *\n * This is a low-level helper that does not support ignoreInputs, target,\n * or other HotkeyOptions. Callers must handle input filtering themselves\n * if attaching to document.\n *\n * @param sequence - The sequence of hotkeys to match\n * @param options - Options including timeout\n * @returns An object with match() and reset() methods\n *\n * @example\n * ```ts\n * const matcher = createSequenceMatcher(['G', 'G'], { timeout: 500 })\n *\n * document.addEventListener('keydown', (event) => {\n *   if (matcher.match(event)) {\n *     console.log('Sequence matched!')\n *   }\n * })\n * ```\n */\nexport function createSequenceMatcher(\n  sequence: HotkeySequence,\n  options: { timeout?: number; platform?: 'mac' | 'windows' | 'linux' } = {},\n): {\n  match: (event: KeyboardEvent) => boolean\n  reset: () => void\n  getProgress: () => number\n} {\n  const platform = options.platform ?? detectPlatform()\n  const timeout = options.timeout ?? DEFAULT_SEQUENCE_TIMEOUT\n  const parsedSequence = sequence.map((hotkey) => parseHotkey(hotkey, platform))\n\n  let currentIndex = 0\n  let lastKeyTime = 0\n\n  return {\n    match(event: KeyboardEvent): boolean {\n      // These events are not sequence steps and must not refresh the timeout.\n      if (\n        (event.type === 'keydown' && event.repeat) ||\n        normalizeKeyboardEvent(event, platform).isComposing ||\n        isModifierKey(normalizeKeyName(event.key))\n      ) {\n        return false\n      }\n      const now = Date.now()\n\n      if (currentIndex > 0 && now - lastKeyTime > timeout) {\n        currentIndex = 0\n      }\n\n      const expected = parsedSequence[currentIndex]\n      if (!expected) {\n        return false\n      }\n\n      if (matchesKeyboardEvent(event, expected, platform)) {\n        lastKeyTime = now\n        currentIndex++\n\n        if (currentIndex >= parsedSequence.length) {\n          currentIndex = 0\n          return true\n        }\n      } else if (currentIndex > 0) {\n        if (matchesKeyboardEvent(event, parsedSequence[0]!, platform)) {\n          currentIndex = 1\n          lastKeyTime = now\n        } else {\n          currentIndex = 0\n        }\n      }\n\n      return false\n    },\n\n    reset(): void {\n      currentIndex = 0\n      lastKeyTime = 0\n    },\n\n    getProgress(): number {\n      return currentIndex\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/sequence-manager.d.cts

@@ -1,172 +0,0 @@
-import { Hotkey, HotkeyCallback, ParsedHotkey } from "./hotkey.types.cjs";
-import { HotkeyOptions } from "./hotkey-manager.cjs";
-import { Store } from "@tanstack/store";
-
-//#region src/sequence-manager.d.ts
-type Target = HTMLElement | Document | Window;
-/**
- * Options for hotkey sequence matching.
- * Extends HotkeyOptions but excludes requireReset (not applicable to sequences).
- */
-interface SequenceOptions extends Omit<HotkeyOptions, 'requireReset'> {
-  /** Timeout between keys in milliseconds. Default: 1000 */
-  timeout?: number;
-}
-/**
- * A sequence of hotkeys for Vim-style shortcuts.
- *
- * Each element is one step (a `Hotkey` string). Steps may include modifiers;
- * the same modifier can appear on consecutive steps (e.g. `Shift+R` then
- * `Shift+T`). Modifier-only key events do not advance or reset matching—see
- * `SequenceManager`. Automatic keydown repeats and IME composition are also ignored.
- *
- * @example
- * ```ts
- * const gotoTop: HotkeySequence = ['G', 'G']  // gg
- * const deleteLine: HotkeySequence = ['D', 'D']  // dd
- * const deleteWord: HotkeySequence = ['D', 'I', 'W']  // diw
- * const chainedShift: HotkeySequence = ['Shift+R', 'Shift+T']
- * ```
- */
-type HotkeySequence = Array<Hotkey>;
-/**
- * Default timeout between keys in a sequence (in milliseconds).
- * Exported for consumers that display sequence state (e.g. devtools).
- */
-declare const DEFAULT_SEQUENCE_TIMEOUT = 1000;
-/**
- * View of a sequence registration for devtools display.
- * Progress fields reflect an in-progress match (between first key and completion or timeout).
- */
-interface SequenceRegistrationView {
-  id: string;
-  sequence: HotkeySequence;
-  options: SequenceOptions;
-  target: Target;
-  triggerCount: number;
-  /** Whether this sequence has been triggered at least once. */
-  hasFired: boolean;
-  /** Steps matched in the current attempt (0 when idle or just completed). */
-  matchedStepCount: number;
-  /** `Date.now()` when the last step in the current attempt matched; 0 if none. */
-  partialMatchLastKeyTime: number;
-}
-/**
- * Internal representation of a sequence registration.
- */
-interface SequenceRegistration {
-  id: string;
-  sequence: HotkeySequence;
-  parsedSequence: Array<ParsedHotkey>;
-  callback: HotkeyCallback;
-  options: SequenceOptions;
-  target: Target;
-  currentIndex: number;
-  lastKeyTime: number;
-  triggerCount: number;
-  hasFired: boolean;
-}
-/**
- * A handle returned from SequenceManager.register() that allows updating
- * the callback and options without re-registering the sequence.
- *
- * @example
- * ```ts
- * const handle = manager.register(['G', 'G'], callback, options)
- *
- * handle.callback = newCallback
- * handle.setOptions({ timeout: 500 })
- * handle.unregister()
- * ```
- */
-interface SequenceRegistrationHandle {
-  readonly id: string;
-  readonly isActive: boolean;
-  callback: HotkeyCallback;
-  setOptions: (options: Partial<SequenceOptions>) => void;
-  unregister: () => void;
-}
-declare class SequenceManager {
-  #private;
-  /**
-   * The TanStack Store containing sequence registration views for devtools.
-   * Subscribe to this to observe registration changes.
-   */
-  readonly registrations: Store<Map<string, SequenceRegistrationView>>;
-  private constructor();
-  /**
-   * Gets the singleton instance of SequenceManager.
-   */
-  static getInstance(): SequenceManager;
-  /**
-   * Resets the singleton instance. Useful for testing.
-   */
-  static resetInstance(): void;
-  /**
-   * Registers a hotkey sequence handler.
-   *
-   * @param sequence - Array of hotkey strings that form the sequence
-   * @param callback - Function to call when the sequence is completed
-   * @param options - Options for the sequence behavior
-   * @returns A handle to update or unregister the sequence
-   */
-  register(sequence: HotkeySequence, callback: HotkeyCallback, options?: SequenceOptions): SequenceRegistrationHandle;
-  /**
-   * Resets all sequence progress.
-   */
-  resetAll(): void;
-  /**
-   * Triggers a sequence's callback programmatically from devtools.
-   * Creates a synthetic KeyboardEvent from the last key in the sequence.
-   *
-   * @param id - The registration ID to trigger
-   * @returns True if the registration was found and triggered
-   */
-  triggerSequence(id: string): boolean;
-  /**
-   * Gets the number of registered sequences.
-   */
-  getRegistrationCount(): number;
-  /**
-   * Destroys the manager and removes all listeners.
-   */
-  destroy(): void;
-}
-/**
- * Gets the singleton SequenceManager instance.
- * Convenience function for accessing the manager.
- */
-declare function getSequenceManager(): SequenceManager;
-/**
- * Creates a simple sequence matcher for one-off use.
- *
- * This is a low-level helper that does not support ignoreInputs, target,
- * or other HotkeyOptions. Callers must handle input filtering themselves
- * if attaching to document.
- *
- * @param sequence - The sequence of hotkeys to match
- * @param options - Options including timeout
- * @returns An object with match() and reset() methods
- *
- * @example
- * ```ts
- * const matcher = createSequenceMatcher(['G', 'G'], { timeout: 500 })
- *
- * document.addEventListener('keydown', (event) => {
- *   if (matcher.match(event)) {
- *     console.log('Sequence matched!')
- *   }
- * })
- * ```
- */
-declare function createSequenceMatcher(sequence: HotkeySequence, options?: {
-  timeout?: number;
-  platform?: 'mac' | 'windows' | 'linux';
-}): {
-  match: (event: KeyboardEvent) => boolean;
-  reset: () => void;
-  getProgress: () => number;
-};
-//#endregion
-export { DEFAULT_SEQUENCE_TIMEOUT, HotkeySequence, SequenceManager, SequenceOptions, SequenceRegistration, SequenceRegistrationHandle, SequenceRegistrationView, Target, createSequenceMatcher, getSequenceManager };
-//# sourceMappingURL=sequence-manager.d.cts.map