rx-hotkeys 3.1.1 → 4.1.0

package/README.md

@@ -4,13 +4,15 @@ rx-hotkeys is a powerful and flexible TypeScript library for managing keyboard s
 
 ## ✨ Features
 
-* **Official React Hooks**: Provides an official wrapper (`HotkeysProvider`, `useHotkeys`) for seamless, idiomatic integration with React.
+* **Official React Hooks**: Provides an official wrapper (`HotkeysProvider`, `useHotkeys`, `useScopedHotkeysContext`) for seamless, idiomatic integration with React.
 * **Fully Observable API**: Returns an RxJS `Observable` for each shortcut, allowing for powerful stream manipulation like chaining, filtering, debouncing, and merging with other streams.
 * **Flexible Shortcut Definitions**: Define shortcuts using simple, intuitive strings (e.g., `"ctrl+s"` or `"g -> i"`) in addition to the classic object-based configuration.
 * **Element-Scoped Listeners**: Attach shortcuts to specific DOM elements, so they are only active within a certain component or area, not just on the global `document`.
 * **`keyup` Event Support**: Trigger actions on key release (`keyup`) in addition to the default key press (`keydown`).
 * **Key Combinations & Sequences**: Supports both simultaneous key presses (`Ctrl+S`) and ordered key sequences (`g` -> `c`).
 * **Context Management**: Activate or deactivate groups of shortcuts based on the application's current state (e.g., "editor", "modal", "global").
+* **Stack-Based Context Management**: Natively handles nested contexts with an `enter`/`leave` API, perfect for hierarchical UIs like pages, modals, and dropdowns.
+* **Temporary Context Override**: Safely override all contexts with a high-priority temporary context, ideal for global application states like "saving" or "loading".
 * **Strict Global Shortcuts**: Option to register global shortcuts that *only* fire when no other context is active.
 * **Type-Safe Key Definitions**: Uses an exported `Keys` object based on standard `KeyboardEvent.key` values for a superior developer experience and fewer errors.
 * **Sequence Timeouts**: Optional timeout between key presses in a sequence to prevent accidental triggers.
@@ -22,40 +24,17 @@ rx-hotkeys is a powerful and flexible TypeScript library for managing keyboard s
 npm install rxjs rx-hotkeys
 ```
 
-## ⚠️ Breaking Changes (v3.0+)
+## ⚠️ Breaking Changes (v4.0+)
 
-Starting with v3.0, the API has been significantly updated for a more powerful and idiomatic RxJS experience. This is a major breaking change.
+Starting with v4.0, the context management API has been fundamentally redesigned into a more powerful and robust dual-mode system.
 
-* `addCombination` and `addSequence` no longer accept a `callback` property in their configuration.
-* They now return an **`Observable<KeyboardEvent>`**.
-* You **must** now call `.subscribe()` on the returned Observable to execute your action.
+* The old `setContext` method (which returned a boolean) has been replaced.
+* The library now offers two distinct ways to manage contexts:
+    1.  **Context Stack (`enterContext`/`leaveContext`)**: For hierarchical UI states.
+    2.  **Context Override (`setContext` returns a `restore` function)**: For temporary, global state overrides.
+* `getContext` method rename to `getActiveContext`.
 
-**Migration Example:**
-
-**Old (v2.x):**
-```typescript
-// The old way
-keyManager.addCombination({
-  id: "save",
-  keys: { key: Keys.S, ctrlKey: true },
-  callback: () => console.log("File saved!"),
-});
-```
-
-**New (v3.0+):**
-```typescript
-// The new, observable-based way
-const save$ = keyManager.addCombination({
-  id: "save",
-  keys: { key: Keys.S, ctrlKey: true }
-});
-
-const subscription = save$.subscribe(() => console.log("File saved!"));
-
-// Don't forget to unsubscribe when your component is destroyed!
-// The stream will also complete automatically if the shortcut is removed or keyManager.destroy() is called.
-// subscription.unsubscribe();
-```
+Please review the "Context Management" section below for details.
 
 ## Basic Usage
 
@@ -143,16 +122,55 @@ const submit$ = keyManager.addCombination({
 submit$.subscribe(() => console.log("Form submitted on Enter keyup!"));
 ```
 
-### 6. Manage Contexts
+### 6. Context Management
+
+You now have two powerful tools for managing contexts.
 
-Control which shortcuts are active by setting the context.
+#### A) Context Stack (`enterContext` / `leaveContext`)
+
+Use this for nested UI scopes that follow a clear hierarchy.
 
 ```typescript
-// Assuming some shortcuts are configured with context: "editor"
-keyManager.setContext("editor"); // Activates "editor" shortcuts and global shortcuts
+// A shortcut with context: "editor" will NOT be active here.
+console.log(keyManager.getActiveContext()); // null
+
+// Activate the "editor" context
+keyManager.enterContext("editor");
+// Now, pressing Ctrl+S will trigger the "saveFile" shortcut.
+console.log(keyManager.getActiveContext()); // 'editor'
+
+// Imagine opening a dropdown menu inside the editor
+keyManager.enterContext("dropdown-menu");
+console.log(keyManager.getActiveContext()); // 'dropdown-menu'
+
+// When the dropdown closes, leave its context
+keyManager.leaveContext();
+console.log(keyManager.getActiveContext()); // 'editor' (restored automatically)
+```
+
+#### B) Context Override (`setContext` and `restore`)
 
-// To activate only global shortcuts (those with no context or context: null)
-keyManager.setContext(null);
+Use this for temporary, high-priority states that should override everything else.
+
+```typescript
+async function performSave() {
+  // Set a temporary "saving" context that overrides the stack.
+  const restore = keyManager.setContext('saving');
+
+  // Any shortcuts with context: 'saving' are now active.
+  // All other shortcuts (editor, etc.) are inactive.
+  console.log(keyManager.getActiveContext()); // 'saving'
+
+  try {
+    await someAsyncSaveOperation();
+  } finally {
+    // No matter what happens, call restore() to clear the override
+    // and return control to the context stack.
+    restore();
+  }
+
+  console.log(keyManager.getActiveContext()); // e.g., 'editor' (restored from the stack)
+}
 ```
 
 ### 7. Clean Up
@@ -245,7 +263,7 @@ export function MyModal({ onClose }) {
   useScopedHotkeysContext('modal');
 
   // This hotkey will only be active when the 'modal' context is active.
-  useHotkeys('escape', onClose, { context: 'modal' });
+  useHotkeys("escape", onClose, { context: 'modal' });
 
   return (
     <div className="modal">
@@ -283,13 +301,25 @@ Registers a key sequence shortcut.
 * `config`: The `KeySequenceConfig` object.
 * Returns an `Observable<KeyboardEvent>` that emits the final `KeyboardEvent` when the sequence is completed.
 
-`setContext(contextName: string | null): boolean`
+`enterContext(contextName: string | null): void`
+
+Pushes a context onto the **context stack**. It becomes active if no override is set.
+
+`leaveContext(): string | null | undefined`
+
+Pops a context from the **context stack**, returning the context that was left.
 
-Sets the active context. Only shortcuts matching this context or global shortcuts will trigger.
+`setContext(contextName: string | null): () => void`
 
-`getContext(): string | null`
+Sets a temporary **override context**. Returns a `restore` function to clear the override.
 
-Returns the current active context name, or `null`.
+`getActiveContext(): string | null`
+
+Returns the current active context (checks for an override first, then the stack top).
+
+`onContextChange$: Observable<string | null>`
+
+A public `Observable` property that emits the active context whenever it changes.
 
 `remove(id: string): boolean`
 
@@ -322,34 +352,36 @@ A React component that provides the Hotkeys instance to its children.
 `useHotkeys(keys, callback, options?)`
 
 A React hook to register a key combination.
-* `keys: string | string[]`: The shortcut definition (e.g., `'ctrl+s'`).
+* `keys: KeyCombinationConfig["keys"]`: The shortcut definition (e.g., `'ctrl+s'`).
 * `callback: (event: KeyboardEvent) => void`: The function to execute.
 * `options?: HotkeyHookOptions`: Optional config for `preventDefault`, `context`, `target`, etc.
 
 `useSequence(sequence, callback, options?)`
 
 A React hook to register a key sequence.
-* `sequence: string | string[]`: The sequence definition (e.g., `'g -> i'`).
+* `sequence: KeySequenceConfig["sequence"]`: The sequence definition (e.g., `'g -> i'`).
 * `callback: (event: KeyboardEvent) => void`: The function to execute.
 * `options?: SequenceHookOptions`: Optional config for `preventDefault`, `context`, etc.
 
-`useScopedHotkeysContext(context)`
+`useScopedHotkeysContext(context, enabled: boolean = true)`
 
 A React hook to apply a specific context for the lifetime of the component.
 
+`useHotkeysManager(): Hotkeys`
+A hook to get direct access to the `Hotkeys` manager instance.
+
 ### Configuration Interfaces
 
 #### `KeyCombinationConfig`
 
 * `id: string` (required): Unique identifier for the shortcut.
-* `keys: string | KeyCombinationTrigger | KeyCombinationTrigger[]` (required): Defines the key(s). Can be a string (`"ctrl+s"`), a shorthand `StandardKey` (`Keys.Escape`), an object (`{ key: Keys.S, ctrlKey: true }`), or an array of these.
+* `keys: KeyCombinationTrigger | KeyCombinationTrigger[]` (required): Defines the key(s). Can be a string (`"ctrl+s"`), a shorthand `StandardKey` (`Keys.Escape`), an object (`{ key: Keys.S, ctrlKey: true }`), or an array of these.
 * `context?: string | null`: Specifies the context in which this shortcut is active. If `null` or `undefined`, it's a global shortcut.
 * `preventDefault?: boolean`: If `true`, `event.preventDefault()` will be called when the shortcut triggers. Defaults to `false`.
 * `description?: string`: An optional description for the shortcut (e.g., for help menus).
 * `strict?: boolean` (optional): If `true` and the shortcut has no `context`, it will only fire when no other context is active. Defaults to `false`.
 * `target?: HTMLElement` (optional): The DOM element to attach the listener to. Defaults to `document`.
 * `event?: "keydown" | "keyup"` (optional): The keyboard event to listen for. Defaults to `"keydown"`.
-* `callback?: (event: KeyboardEvent) => void` (**@deprecated**): This property is deprecated. Subscribe to the `Observable` returned by `addCombination` instead.
 
 #### `KeySequenceConfig`
 
@@ -362,7 +394,19 @@ A React hook to apply a specific context for the lifetime of the component.
 * `strict?: boolean` (optional): If `true` and the shortcut has no `context`, it will only fire when no other context is active.
 * `target?: HTMLElement` (optional): The DOM element to attach the listener to. Defaults to `document`.
 * `event?: "keydown" | "keyup"` (optional): The keyboard event to listen for. Defaults to `"keydown"`.
-* `callback?: (event: KeyboardEvent) => void` (**@deprecated**): This property is deprecated. Subscribe to the `Observable` returned by `addSequence` instead.
+
+```
+type KeyCombinationTrigger = {
+    key: StandardKey;
+    ctrlKey?: boolean;
+    altKey?: boolean;
+    shiftKey?: boolean;
+    metaKey?: boolean;
+} | StandardKey | string;
+```
+
+*
+*
 
 ## Key Matching & Normalization
 

package/dist/core/hotkeys.d.ts

@@ -6,10 +6,6 @@ export declare enum ShortcutTypes {
 }
 interface ShortcutConfigBase {
     id: string;
-    /**
-     * @deprecated The callback property is deprecated. `addCombination` and `addSequence` now return an Observable. Please subscribe to it instead.
-     */
-    callback?: (event: KeyboardEvent) => void;
     context?: string | null;
     preventDefault?: boolean;
     description?: string;
@@ -41,7 +37,7 @@ interface ShortcutConfigBase {
  * Defines a single key trigger, which can be a StandardKey (for simple presses like "Escape")
  * or an object specifying the main key and its modifiers (e.g., { key: Keys.S, ctrlKey: true }).
  */
-type KeyCombinationTrigger = {
+export type KeyCombinationTrigger = {
     /**
      * The main key for the combination.
      * This MUST be a value from the exported `Keys` object
@@ -57,7 +53,18 @@ type KeyCombinationTrigger = {
     altKey?: boolean;
     shiftKey?: boolean;
     metaKey?: boolean;
-} | StandardKey;
+} | StandardKey | string;
+/**
+ * A fully parsed, canonical representation of a single key trigger.
+ * All modifier keys are explicitly defined as booleans.
+ */
+interface ParsedTrigger {
+    key: StandardKey;
+    ctrlKey: boolean;
+    altKey: boolean;
+    shiftKey: boolean;
+    metaKey: boolean;
+}
 export interface KeyCombinationConfig extends ShortcutConfigBase {
     /**
      * Defines the key or key combination(s) that trigger the shortcut.
@@ -76,7 +83,7 @@ export interface KeyCombinationConfig extends ShortcutConfigBase {
      * To define multiple triggers for the same action:
      * Example: `keys: [Keys.Enter, { key: Keys.Space, ctrlKey: true }]`
      */
-    keys: KeyCombinationTrigger | KeyCombinationTrigger[] | string;
+    keys: KeyCombinationTrigger | KeyCombinationTrigger[];
 }
 export interface KeySequenceConfig extends ShortcutConfigBase {
     /**
@@ -101,6 +108,7 @@ export interface ActiveShortcut {
     id: string;
     config: ShortcutConfig;
     terminator$: Subject<void>;
+    parsedTriggers?: ParsedTrigger[];
 }
 /**
  * Manages keyboard shortcuts for web applications.
@@ -111,18 +119,32 @@ export declare class Hotkeys {
     private static readonly KEYDOWN_EVENT;
     private static readonly KEYUP_EVENT;
     private static readonly LOG_PREFIX;
+    private static readonly NO_OVERRIDE;
     private keydownStreams;
     private keyupStreams;
-    private activeContext$;
     private activeShortcuts;
     private debugMode;
+    private contextStack$;
+    private overrideContext$;
+    /**
+     * An Observable that emits the new active context name (or null) whenever it changes.
+     * The active context is the override context if one is set, otherwise it's the context
+     * from the top of the stack.
+     */
+    private readonly activeContext$;
     /**
      * Creates an instance of Hotkeys.
-     * @param initialContext - Optional initial context name. Shortcuts will only trigger if their context matches this, or if they have no context defined.
+     * @param initialContext - Optional initial context name. This forms the base of the context stack.
      * @param debugMode - Optional. If true, debug messages will be logged to the console. Defaults to false.
      * @throws Error if not in a browser environment (i.e., `document` or `performance` is undefined).
      */
     constructor(initialContext?: string | null, debugMode?: boolean);
+    /**
+     * Helper method to determine the active context based on override and stack.
+     */
+    private _resolveActiveContext;
+    private _normalizeAndParseTriggers;
+    private _normalizeSequence;
     /**
      * Gets or creates a shared event stream for a given event type and target.
      * @param eventType The type of event ("keydown" or "keyup").
@@ -131,19 +153,32 @@ export declare class Hotkeys {
      */
     private _getEventStream;
     /**
-     * Sets the active context for shortcuts.
-     * Only shortcuts matching this context (or shortcuts with no specific context defined)
-     * will be active and can be triggered.
-     * @param contextName - The name of the context (e.g., "modal", "editor", "global").
-     * Pass `null` to activate shortcuts with no context or to deactivate context-specific shortcuts.
-     * @returns `true` if the context was changed, `false` if the new context was the same as the current one.
+     * Sets a temporary, high-priority override context that takes precedence over the context stack.
+     * @param contextName The override context to activate (can be a string or `null`).
+     * @returns A `restore` function that, when called, clears the override context, reverting to the stack.
      */
-    setContext(contextName: string | null): boolean;
+    setContext(contextName: string | null): () => void;
     /**
-     * Gets the current active context.
+     * @deprecated Rename to `getActiveContext`
+     * Gets the current active context, considering any override.
      * @returns The current context name as a string, or `null` if no context is set.
      */
     getContext(): string | null;
+    /**
+     * Gets the current active context, considering any override.
+     * @returns The current context name as a string, or `null` if no context is set.
+     */
+    getActiveContext(): string | null;
+    /**
+     * Pushes a new context onto the context stack. It will become active if no override context is set.
+     * @param contextName The name of the context to enter (e.g., "modal", "editor").
+     */
+    enterContext(contextName: string | null): void;
+    /**
+     * Pops the current context from the stack.
+     * @returns The context that was just left from the stack, or `undefined` if at the base.
+     */
+    leaveContext(): string | null | undefined;
     /**
      * Enables or disables debug logging for the Hotkeys instance.
      * When enabled, various internal actions and shortcut triggers will be logged to the console.
@@ -158,10 +193,6 @@ export declare class Hotkeys {
     hasShortcut(id: string): boolean;
     /**
      * An Observable that emits the new context name (or null) whenever the active context changes.
-     * This allows external parts of the application to react to context transitions.
-     *
-     * Note: This observable benefits from the distinct check within the `setContext` method,
-     * meaning it will only emit when the context value actually changes.
      *
      * @example
      * ```typescript

package/dist/core/hotkeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotkeys.d.ts","sourceRoot":"","sources":["../../src/core/hotkeys.ts"],"names":[],"mappings":"AAAA,OAAO,EACgC,UAAU,EAC2B,OAAO,EAClF,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,KAAK,WAAW,EAAoB,MAAM,WAAW,CAAC;AAI/D,oBAAY,aAAa;IACrB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACxB;AAcD,UAAU,kBAAkB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,KAAK,qBAAqB,GAAG;IACzB;;;;;;;;;OASG;IACH,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,WAAW,CAAC;AAGhB,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,GAAG,MAAM,CAAC;CAClE;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IACzD;;;;;;;;OAQG;IACH,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,KAAK,cAAc,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AA+CD;;;;GAIG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAW;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAc;IAEhD,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,SAAS,CAAU;IAE3B;;;;;OAKG;gBACS,cAAc,GAAE,MAAM,GAAG,IAAW,EAAE,SAAS,GAAE,OAAe;IAgB5E;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAavB;;;;;;;OAOG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAkBtD;;;OAGG;IACI,UAAU,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAY1C;;;;OAIG;IACI,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAW,gBAAgB,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAEvD;IAED;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA2C7B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,iBAAiB;IAkBzB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,uBAAuB;IA+B/B,OAAO,CAAC,oBAAoB;IAe5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACI,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU,CAAC,aAAa,CAAC;IAqG9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACI,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAAC,aAAa,CAAC;IAmJxE;;;;;;OAMG;IACI,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAalC;;;;;;OAMG;IACI,kBAAkB,IAAI;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAC,EAAE;IAa/G;;;;;OAKG;IACI,OAAO,IAAI,IAAI;CAUzB"}
+{"version":3,"file":"hotkeys.d.ts","sourceRoot":"","sources":["../../src/core/hotkeys.ts"],"names":[],"mappings":"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"}