Default sequenceTimeout to Infinity (no timeout)

Sequences no longer auto-submit by default. Users can still set a
finite timeout if desired. Updated doc comments to reflect new default.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ryan-williams

README.md

@@ -107,7 +107,7 @@ Wrap your app to enable the hotkeys system:
   storageKey: 'use-kbd',      // localStorage key for user overrides (default)
   modalTrigger: '?',          // Open shortcuts modal (default; false to disable)
   omnibarTrigger: 'meta+k',   // Open omnibar (default; false to disable)
-  sequenceTimeout: 1000,      // ms before sequence times out (default)
+  sequenceTimeout: Infinity,  // ms before sequence times out (default: no timeout)
 }}>
   {children}
 </HotkeysProvider>

src/HotkeysProvider.tsx

@@ -13,7 +13,7 @@ export interface HotkeysConfig {
   /** Storage key for persisting user binding overrides */
   storageKey?: string
 
-  /** Timeout in ms before a sequence auto-submits (default: DEFAULT_SEQUENCE_TIMEOUT) */
+  /** Timeout in ms before a sequence auto-submits (default: Infinity, no timeout) */
   sequenceTimeout?: number
 
   /** When true, keys with conflicts are disabled (default: true) */

src/constants.ts

@@ -1,8 +1,8 @@
 /**
- * Default timeout in milliseconds before a key sequence auto-submits.
- * Used when no explicit `sequenceTimeout` is provided.
+ * Default timeout for key sequences (no timeout).
+ * Set to a finite number (ms) to auto-submit sequences after that duration.
  */
-export const DEFAULT_SEQUENCE_TIMEOUT = 1000
+export const DEFAULT_SEQUENCE_TIMEOUT = Infinity
 
 /**
  * Reserved action IDs for built-in UI components.

src/types.ts

@@ -74,9 +74,9 @@ export interface RecordHotkeyOptions {
   onShiftTab?: () => void
   /** Prevent default on captured keys (default: true) */
   preventDefault?: boolean
-  /** Timeout in ms before sequence is submitted (default: DEFAULT_SEQUENCE_TIMEOUT).
+  /** Timeout in ms before sequence is submitted (default: Infinity, no timeout).
    * Set to 0 for immediate submit (no sequences - first key press is captured).
-   * Set to Infinity for no auto-submit (user must explicitly commit via Enter/Tab). */
+   * Set to a finite number for auto-submit after that duration. */
   sequenceTimeout?: number
   /** When true, pause the auto-submit timeout (useful for conflict warnings). Default: false */
   pauseTimeout?: boolean

src/useHotkeys.ts

@@ -29,7 +29,7 @@ export interface UseHotkeysOptions {
   stopPropagation?: boolean
   /** Enable hotkeys even when focused on input/textarea/select (default: false) */
   enableOnFormTags?: boolean
-  /** Timeout in ms for sequences (default: DEFAULT_SEQUENCE_TIMEOUT) */
+  /** Timeout in ms for sequences (default: Infinity, no timeout) */
   sequenceTimeout?: number
   /** What happens on timeout: 'submit' executes current sequence, 'cancel' resets (default: 'submit') */
   onTimeout?: 'submit' | 'cancel'