@tanstack/angular-hotkeys 0.5.0 → 0.6.0

package/dist/hotkeys-provider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hotkeys-provider.cjs","names":["InjectionToken"],"sources":["../src/hotkeys-provider.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core'\nimport type { HotkeyRecorderOptions } from '@tanstack/hotkeys'\nimport type { InjectHotkeyOptions } from './injectHotkey'\nimport type { InjectHotkeySequenceOptions } from './injectHotkeySequence'\nimport type { StaticProvider } from '@angular/core'\n\nexport interface HotkeysProviderOptions {\n  hotkey?: Partial<InjectHotkeyOptions>\n  hotkeyRecorder?: Partial<HotkeyRecorderOptions>\n  hotkeySequence?: Partial<InjectHotkeySequenceOptions>\n}\n\nexport interface HotkeysContextValue {\n  readonly defaultOptions: HotkeysProviderOptions\n}\n\nexport const HOTKEYS_INJECTION_TOKEN = new InjectionToken<HotkeysContextValue>(\n  'HOTKEYS_INJECTION_TOKEN',\n  {\n    providedIn: 'root',\n    factory: () => ({ defaultOptions: {} }),\n  },\n)\n\nexport function provideHotkeys(\n  defaultOptions: HotkeysProviderOptions,\n): StaticProvider {\n  return {\n    provide: HOTKEYS_INJECTION_TOKEN,\n    useValue: { defaultOptions },\n  }\n}\n\nexport function injectHotkeysContext(): HotkeysContextValue {\n  return inject(HOTKEYS_INJECTION_TOKEN)\n}\n\nexport function injectDefaultHotkeysOptions(): HotkeysProviderOptions {\n  return injectHotkeysContext().defaultOptions\n}\n"],"mappings":";;;AAgBA,MAAa,0BAA0B,IAAIA,6BACzC,2BACA;CACE,YAAY;CACZ,gBAAgB,EAAE,gBAAgB,EAAE,EAAE;CACvC,CACF;AAED,SAAgB,eACd,gBACgB;AAChB,QAAO;EACL,SAAS;EACT,UAAU,EAAE,gBAAgB;EAC7B;;AAGH,SAAgB,uBAA4C;AAC1D,kCAAc,wBAAwB;;AAGxC,SAAgB,8BAAsD;AACpE,QAAO,sBAAsB,CAAC"}
+{"version":3,"file":"hotkeys-provider.cjs","names":["InjectionToken"],"sources":["../src/hotkeys-provider.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core'\nimport type {\n  HotkeyRecorderOptions,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\nimport type { InjectHotkeyOptions } from './injectHotkey'\nimport type { InjectHotkeySequenceOptions } from './injectHotkeySequence'\nimport type { StaticProvider } from '@angular/core'\n\nexport interface HotkeysProviderOptions {\n  hotkey?: Partial<InjectHotkeyOptions>\n  hotkeyRecorder?: Partial<HotkeyRecorderOptions>\n  hotkeySequenceRecorder?: Partial<HotkeySequenceRecorderOptions>\n  hotkeySequence?: Partial<InjectHotkeySequenceOptions>\n}\n\nexport interface HotkeysContextValue {\n  readonly defaultOptions: HotkeysProviderOptions\n}\n\nexport const HOTKEYS_INJECTION_TOKEN = new InjectionToken<HotkeysContextValue>(\n  'HOTKEYS_INJECTION_TOKEN',\n  {\n    providedIn: 'root',\n    factory: () => ({ defaultOptions: {} }),\n  },\n)\n\nexport function provideHotkeys(\n  defaultOptions: HotkeysProviderOptions,\n): StaticProvider {\n  return {\n    provide: HOTKEYS_INJECTION_TOKEN,\n    useValue: { defaultOptions },\n  }\n}\n\nexport function injectHotkeysContext(): HotkeysContextValue {\n  return inject(HOTKEYS_INJECTION_TOKEN)\n}\n\nexport function injectDefaultHotkeysOptions(): HotkeysProviderOptions {\n  return injectHotkeysContext().defaultOptions\n}\n"],"mappings":";;;AAoBA,MAAa,0BAA0B,IAAIA,6BACzC,2BACA;CACE,YAAY;CACZ,gBAAgB,EAAE,gBAAgB,EAAE,EAAE;CACvC,CACF;AAED,SAAgB,eACd,gBACgB;AAChB,QAAO;EACL,SAAS;EACT,UAAU,EAAE,gBAAgB;EAC7B;;AAGH,SAAgB,uBAA4C;AAC1D,kCAAc,wBAAwB;;AAGxC,SAAgB,8BAAsD;AACpE,QAAO,sBAAsB,CAAC"}

package/dist/hotkeys-provider.d.cts

@@ -1,12 +1,13 @@
 import { InjectHotkeyOptions } from "./injectHotkey.cjs";
 import { InjectHotkeySequenceOptions } from "./injectHotkeySequence.cjs";
-import { HotkeyRecorderOptions } from "@tanstack/hotkeys";
+import { HotkeyRecorderOptions, HotkeySequenceRecorderOptions } from "@tanstack/hotkeys";
 import { InjectionToken, StaticProvider } from "@angular/core";
 
 //#region src/hotkeys-provider.d.ts
 interface HotkeysProviderOptions {
   hotkey?: Partial<InjectHotkeyOptions>;
   hotkeyRecorder?: Partial<HotkeyRecorderOptions>;
+  hotkeySequenceRecorder?: Partial<HotkeySequenceRecorderOptions>;
   hotkeySequence?: Partial<InjectHotkeySequenceOptions>;
 }
 interface HotkeysContextValue {

package/dist/hotkeys-provider.d.ts

@@ -1,12 +1,13 @@
 import { InjectHotkeyOptions } from "./injectHotkey.js";
 import { InjectHotkeySequenceOptions } from "./injectHotkeySequence.js";
-import { HotkeyRecorderOptions } from "@tanstack/hotkeys";
+import { HotkeyRecorderOptions, HotkeySequenceRecorderOptions } from "@tanstack/hotkeys";
 import { InjectionToken, StaticProvider } from "@angular/core";
 
 //#region src/hotkeys-provider.d.ts
 interface HotkeysProviderOptions {
   hotkey?: Partial<InjectHotkeyOptions>;
   hotkeyRecorder?: Partial<HotkeyRecorderOptions>;
+  hotkeySequenceRecorder?: Partial<HotkeySequenceRecorderOptions>;
   hotkeySequence?: Partial<InjectHotkeySequenceOptions>;
 }
 interface HotkeysContextValue {

package/dist/hotkeys-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotkeys-provider.js","names":[],"sources":["../src/hotkeys-provider.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core'\nimport type { HotkeyRecorderOptions } from '@tanstack/hotkeys'\nimport type { InjectHotkeyOptions } from './injectHotkey'\nimport type { InjectHotkeySequenceOptions } from './injectHotkeySequence'\nimport type { StaticProvider } from '@angular/core'\n\nexport interface HotkeysProviderOptions {\n  hotkey?: Partial<InjectHotkeyOptions>\n  hotkeyRecorder?: Partial<HotkeyRecorderOptions>\n  hotkeySequence?: Partial<InjectHotkeySequenceOptions>\n}\n\nexport interface HotkeysContextValue {\n  readonly defaultOptions: HotkeysProviderOptions\n}\n\nexport const HOTKEYS_INJECTION_TOKEN = new InjectionToken<HotkeysContextValue>(\n  'HOTKEYS_INJECTION_TOKEN',\n  {\n    providedIn: 'root',\n    factory: () => ({ defaultOptions: {} }),\n  },\n)\n\nexport function provideHotkeys(\n  defaultOptions: HotkeysProviderOptions,\n): StaticProvider {\n  return {\n    provide: HOTKEYS_INJECTION_TOKEN,\n    useValue: { defaultOptions },\n  }\n}\n\nexport function injectHotkeysContext(): HotkeysContextValue {\n  return inject(HOTKEYS_INJECTION_TOKEN)\n}\n\nexport function injectDefaultHotkeysOptions(): HotkeysProviderOptions {\n  return injectHotkeysContext().defaultOptions\n}\n"],"mappings":";;;AAgBA,MAAa,0BAA0B,IAAI,eACzC,2BACA;CACE,YAAY;CACZ,gBAAgB,EAAE,gBAAgB,EAAE,EAAE;CACvC,CACF;AAED,SAAgB,eACd,gBACgB;AAChB,QAAO;EACL,SAAS;EACT,UAAU,EAAE,gBAAgB;EAC7B;;AAGH,SAAgB,uBAA4C;AAC1D,QAAO,OAAO,wBAAwB;;AAGxC,SAAgB,8BAAsD;AACpE,QAAO,sBAAsB,CAAC"}
+{"version":3,"file":"hotkeys-provider.js","names":[],"sources":["../src/hotkeys-provider.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core'\nimport type {\n  HotkeyRecorderOptions,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\nimport type { InjectHotkeyOptions } from './injectHotkey'\nimport type { InjectHotkeySequenceOptions } from './injectHotkeySequence'\nimport type { StaticProvider } from '@angular/core'\n\nexport interface HotkeysProviderOptions {\n  hotkey?: Partial<InjectHotkeyOptions>\n  hotkeyRecorder?: Partial<HotkeyRecorderOptions>\n  hotkeySequenceRecorder?: Partial<HotkeySequenceRecorderOptions>\n  hotkeySequence?: Partial<InjectHotkeySequenceOptions>\n}\n\nexport interface HotkeysContextValue {\n  readonly defaultOptions: HotkeysProviderOptions\n}\n\nexport const HOTKEYS_INJECTION_TOKEN = new InjectionToken<HotkeysContextValue>(\n  'HOTKEYS_INJECTION_TOKEN',\n  {\n    providedIn: 'root',\n    factory: () => ({ defaultOptions: {} }),\n  },\n)\n\nexport function provideHotkeys(\n  defaultOptions: HotkeysProviderOptions,\n): StaticProvider {\n  return {\n    provide: HOTKEYS_INJECTION_TOKEN,\n    useValue: { defaultOptions },\n  }\n}\n\nexport function injectHotkeysContext(): HotkeysContextValue {\n  return inject(HOTKEYS_INJECTION_TOKEN)\n}\n\nexport function injectDefaultHotkeysOptions(): HotkeysProviderOptions {\n  return injectHotkeysContext().defaultOptions\n}\n"],"mappings":";;;AAoBA,MAAa,0BAA0B,IAAI,eACzC,2BACA;CACE,YAAY;CACZ,gBAAgB,EAAE,gBAAgB,EAAE,EAAE;CACvC,CACF;AAED,SAAgB,eACd,gBACgB;AAChB,QAAO;EACL,SAAS;EACT,UAAU,EAAE,gBAAgB;EAC7B;;AAGH,SAAgB,uBAA4C;AAC1D,QAAO,OAAO,wBAAwB;;AAGxC,SAAgB,8BAAsD;AACpE,QAAO,sBAAsB,CAAC"}

package/dist/index.cjs

@@ -7,6 +7,7 @@ const require_injectHeldKeys = require('./injectHeldKeys.cjs');
 const require_injectHeldKeyCodes = require('./injectHeldKeyCodes.cjs');
 const require_injectKeyHold = require('./injectKeyHold.cjs');
 const require_injectHotkeyRecorder = require('./injectHotkeyRecorder.cjs');
+const require_injectHotkeySequenceRecorder = require('./injectHotkeySequenceRecorder.cjs');
 
 exports.HOTKEYS_INJECTION_TOKEN = require_hotkeys_provider.HOTKEYS_INJECTION_TOKEN;
 exports.injectDefaultHotkeysOptions = require_hotkeys_provider.injectDefaultHotkeysOptions;
@@ -15,6 +16,7 @@ exports.injectHeldKeys = require_injectHeldKeys.injectHeldKeys;
 exports.injectHotkey = require_injectHotkey.injectHotkey;
 exports.injectHotkeyRecorder = require_injectHotkeyRecorder.injectHotkeyRecorder;
 exports.injectHotkeySequence = require_injectHotkeySequence.injectHotkeySequence;
+exports.injectHotkeySequenceRecorder = require_injectHotkeySequenceRecorder.injectHotkeySequenceRecorder;
 exports.injectHotkeys = require_injectHotkeys.injectHotkeys;
 exports.injectHotkeysContext = require_hotkeys_provider.injectHotkeysContext;
 exports.injectKeyHold = require_injectKeyHold.injectKeyHold;

package/dist/index.d.cts

@@ -6,5 +6,6 @@ import { injectHeldKeys } from "./injectHeldKeys.cjs";
 import { injectHeldKeyCodes } from "./injectHeldKeyCodes.cjs";
 import { injectKeyHold } from "./injectKeyHold.cjs";
 import { AngularHotkeyRecorder, injectHotkeyRecorder } from "./injectHotkeyRecorder.cjs";
+import { AngularHotkeySequenceRecorder, injectHotkeySequenceRecorder } from "./injectHotkeySequenceRecorder.cjs";
 export * from "@tanstack/hotkeys";
-export { AngularHotkeyRecorder, HOTKEYS_INJECTION_TOKEN, HotkeysContextValue, HotkeysProviderOptions, InjectHotkeyDefinition, InjectHotkeyOptions, InjectHotkeySequenceOptions, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };
+export { AngularHotkeyRecorder, AngularHotkeySequenceRecorder, HOTKEYS_INJECTION_TOKEN, HotkeysContextValue, HotkeysProviderOptions, InjectHotkeyDefinition, InjectHotkeyOptions, InjectHotkeySequenceOptions, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeySequenceRecorder, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };

package/dist/index.d.ts

@@ -6,5 +6,6 @@ import { injectHeldKeys } from "./injectHeldKeys.js";
 import { injectHeldKeyCodes } from "./injectHeldKeyCodes.js";
 import { injectKeyHold } from "./injectKeyHold.js";
 import { AngularHotkeyRecorder, injectHotkeyRecorder } from "./injectHotkeyRecorder.js";
+import { AngularHotkeySequenceRecorder, injectHotkeySequenceRecorder } from "./injectHotkeySequenceRecorder.js";
 export * from "@tanstack/hotkeys";
-export { AngularHotkeyRecorder, HOTKEYS_INJECTION_TOKEN, HotkeysContextValue, HotkeysProviderOptions, InjectHotkeyDefinition, InjectHotkeyOptions, InjectHotkeySequenceOptions, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };
+export { AngularHotkeyRecorder, AngularHotkeySequenceRecorder, HOTKEYS_INJECTION_TOKEN, HotkeysContextValue, HotkeysProviderOptions, InjectHotkeyDefinition, InjectHotkeyOptions, InjectHotkeySequenceOptions, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeySequenceRecorder, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };

package/dist/index.js

@@ -6,7 +6,8 @@ import { injectHeldKeys } from "./injectHeldKeys.js";
 import { injectHeldKeyCodes } from "./injectHeldKeyCodes.js";
 import { injectKeyHold } from "./injectKeyHold.js";
 import { injectHotkeyRecorder } from "./injectHotkeyRecorder.js";
+import { injectHotkeySequenceRecorder } from "./injectHotkeySequenceRecorder.js";
 
 export * from "@tanstack/hotkeys"
 
-export { HOTKEYS_INJECTION_TOKEN, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };
+export { HOTKEYS_INJECTION_TOKEN, injectDefaultHotkeysOptions, injectHeldKeyCodes, injectHeldKeys, injectHotkey, injectHotkeyRecorder, injectHotkeySequence, injectHotkeySequenceRecorder, injectHotkeys, injectHotkeysContext, injectKeyHold, provideHotkeys };

package/dist/injectHotkeySequence.cjs

@@ -9,6 +9,11 @@ let _angular_core = require("@angular/core");
 * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger
 * when the full sequence is pressed within a timeout.
 *
+* Each step may include modifiers. You can chain the same modifier across
+* steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,
+* Control, Alt, or Meta pressed alone) are ignored while matching—they do not
+* advance the sequence or reset progress.
+*
 * @param sequence - Array of hotkey strings that form the sequence (or getter function)
 * @param callback - Function to call when the sequence is completed
 * @param options - Options for the sequence behavior (or getter function)
@@ -23,6 +28,7 @@ let _angular_core = require("@angular/core");
 *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))
 *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))
 *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })
+*     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))
 *   }
 * }
 * ```

package/dist/injectHotkeySequence.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"injectHotkeySequence.cjs","names":["injectDefaultHotkeysOptions"],"sources":["../src/injectHotkeySequence.ts"],"sourcesContent":["import { effect } from '@angular/core'\nimport { getSequenceManager } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n} from '@tanstack/hotkeys'\n\nexport interface InjectHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'enabled'\n> {\n  /** Whether the sequence is enabled. Defaults to true. */\n  enabled?: boolean\n}\n\n/**\n * Angular inject-based API for registering a keyboard shortcut sequence (Vim-style).\n *\n * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger\n * when the full sequence is pressed within a timeout.\n *\n * @param sequence - Array of hotkey strings that form the sequence (or getter function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or getter function)\n *\n * @example\n * ```ts\n * @Component({ ... })\n * export class VimEditorComponent {\n *   lastSequence = signal<string | null>(null)\n *\n *   constructor() {\n *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))\n *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))\n *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })\n *   }\n * }\n * ```\n */\nexport function injectHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | InjectHotkeySequenceOptions\n    | (() => InjectHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = injectDefaultHotkeysOptions()\n\n  effect((onCleanup) => {\n    // Resolve reactive values\n    const resolvedSequence =\n      typeof sequence === 'function' ? sequence() : sequence\n    const resolvedOptions = typeof options === 'function' ? options() : options\n\n    const mergedOptions = {\n      ...defaultOptions.hotkeySequence,\n      ...resolvedOptions,\n    } as InjectHotkeySequenceOptions\n\n    const { enabled = true, ...sequenceOptions } = mergedOptions\n\n    if (!enabled || resolvedSequence.length === 0) {\n      return\n    }\n\n    const manager = getSequenceManager()\n\n    // Pass through options; default target to document when not provided\n    const registerOptions: SequenceOptions = {\n      ...sequenceOptions,\n      enabled: true,\n      target:\n        sequenceOptions.target ??\n        (typeof document !== 'undefined' ? document : undefined),\n    }\n\n    const handle = manager.register(resolvedSequence, callback, registerOptions)\n\n    onCleanup(() => {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiBA,sDAA6B;AAEpD,4BAAQ,cAAc;EAEpB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAOpE,MAAM,EAAE,UAAU,MAAM,GAAG,oBALL;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;AAID,MAAI,CAAC,WAAW,iBAAiB,WAAW,EAC1C;EAGF,MAAM,qDAA8B;EAGpC,MAAM,kBAAmC;GACvC,GAAG;GACH,SAAS;GACT,QACE,gBAAgB,WACf,OAAO,aAAa,cAAc,WAAW;GACjD;EAED,MAAM,SAAS,QAAQ,SAAS,kBAAkB,UAAU,gBAAgB;AAE5E,kBAAgB;AACd,OAAI,OAAO,SACT,QAAO,YAAY;IAErB;GACF"}
+{"version":3,"file":"injectHotkeySequence.cjs","names":["injectDefaultHotkeysOptions"],"sources":["../src/injectHotkeySequence.ts"],"sourcesContent":["import { effect } from '@angular/core'\nimport { getSequenceManager } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n} from '@tanstack/hotkeys'\n\nexport interface InjectHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'enabled'\n> {\n  /** Whether the sequence is enabled. Defaults to true. */\n  enabled?: boolean\n}\n\n/**\n * Angular inject-based API for registering a keyboard shortcut sequence (Vim-style).\n *\n * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger\n * when the full sequence is pressed within a timeout.\n *\n * Each step may include modifiers. You can chain the same modifier across\n * steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,\n * Control, Alt, or Meta pressed alone) are ignored while matching—they do not\n * advance the sequence or reset progress.\n *\n * @param sequence - Array of hotkey strings that form the sequence (or getter function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or getter function)\n *\n * @example\n * ```ts\n * @Component({ ... })\n * export class VimEditorComponent {\n *   lastSequence = signal<string | null>(null)\n *\n *   constructor() {\n *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))\n *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))\n *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })\n *     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))\n *   }\n * }\n * ```\n */\nexport function injectHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | InjectHotkeySequenceOptions\n    | (() => InjectHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = injectDefaultHotkeysOptions()\n\n  effect((onCleanup) => {\n    // Resolve reactive values\n    const resolvedSequence =\n      typeof sequence === 'function' ? sequence() : sequence\n    const resolvedOptions = typeof options === 'function' ? options() : options\n\n    const mergedOptions = {\n      ...defaultOptions.hotkeySequence,\n      ...resolvedOptions,\n    } as InjectHotkeySequenceOptions\n\n    const { enabled = true, ...sequenceOptions } = mergedOptions\n\n    if (!enabled || resolvedSequence.length === 0) {\n      return\n    }\n\n    const manager = getSequenceManager()\n\n    // Pass through options; default target to document when not provided\n    const registerOptions: SequenceOptions = {\n      ...sequenceOptions,\n      enabled: true,\n      target:\n        sequenceOptions.target ??\n        (typeof document !== 'undefined' ? document : undefined),\n    }\n\n    const handle = manager.register(resolvedSequence, callback, registerOptions)\n\n    onCleanup(() => {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiBA,sDAA6B;AAEpD,4BAAQ,cAAc;EAEpB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAOpE,MAAM,EAAE,UAAU,MAAM,GAAG,oBALL;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;AAID,MAAI,CAAC,WAAW,iBAAiB,WAAW,EAC1C;EAGF,MAAM,qDAA8B;EAGpC,MAAM,kBAAmC;GACvC,GAAG;GACH,SAAS;GACT,QACE,gBAAgB,WACf,OAAO,aAAa,cAAc,WAAW;GACjD;EAED,MAAM,SAAS,QAAQ,SAAS,kBAAkB,UAAU,gBAAgB;AAE5E,kBAAgB;AACd,OAAI,OAAO,SACT,QAAO,YAAY;IAErB;GACF"}

package/dist/injectHotkeySequence.d.cts

@@ -11,6 +11,11 @@ interface InjectHotkeySequenceOptions extends Omit<SequenceOptions, 'enabled'> {
  * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger
  * when the full sequence is pressed within a timeout.
  *
+ * Each step may include modifiers. You can chain the same modifier across
+ * steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,
+ * Control, Alt, or Meta pressed alone) are ignored while matching—they do not
+ * advance the sequence or reset progress.
+ *
  * @param sequence - Array of hotkey strings that form the sequence (or getter function)
  * @param callback - Function to call when the sequence is completed
  * @param options - Options for the sequence behavior (or getter function)
@@ -25,6 +30,7 @@ interface InjectHotkeySequenceOptions extends Omit<SequenceOptions, 'enabled'> {
  *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))
  *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))
  *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })
+ *     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))
  *   }
  * }
  * ```

package/dist/injectHotkeySequence.d.ts

@@ -11,6 +11,11 @@ interface InjectHotkeySequenceOptions extends Omit<SequenceOptions, 'enabled'> {
  * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger
  * when the full sequence is pressed within a timeout.
  *
+ * Each step may include modifiers. You can chain the same modifier across
+ * steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,
+ * Control, Alt, or Meta pressed alone) are ignored while matching—they do not
+ * advance the sequence or reset progress.
+ *
  * @param sequence - Array of hotkey strings that form the sequence (or getter function)
  * @param callback - Function to call when the sequence is completed
  * @param options - Options for the sequence behavior (or getter function)
@@ -25,6 +30,7 @@ interface InjectHotkeySequenceOptions extends Omit<SequenceOptions, 'enabled'> {
  *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))
  *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))
  *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })
+ *     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))
  *   }
  * }
  * ```

package/dist/injectHotkeySequence.js

@@ -9,6 +9,11 @@ import { effect } from "@angular/core";
 * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger
 * when the full sequence is pressed within a timeout.
 *
+* Each step may include modifiers. You can chain the same modifier across
+* steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,
+* Control, Alt, or Meta pressed alone) are ignored while matching—they do not
+* advance the sequence or reset progress.
+*
 * @param sequence - Array of hotkey strings that form the sequence (or getter function)
 * @param callback - Function to call when the sequence is completed
 * @param options - Options for the sequence behavior (or getter function)
@@ -23,6 +28,7 @@ import { effect } from "@angular/core";
 *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))
 *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))
 *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })
+*     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))
 *   }
 * }
 * ```

package/dist/injectHotkeySequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectHotkeySequence.js","names":[],"sources":["../src/injectHotkeySequence.ts"],"sourcesContent":["import { effect } from '@angular/core'\nimport { getSequenceManager } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n} from '@tanstack/hotkeys'\n\nexport interface InjectHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'enabled'\n> {\n  /** Whether the sequence is enabled. Defaults to true. */\n  enabled?: boolean\n}\n\n/**\n * Angular inject-based API for registering a keyboard shortcut sequence (Vim-style).\n *\n * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger\n * when the full sequence is pressed within a timeout.\n *\n * @param sequence - Array of hotkey strings that form the sequence (or getter function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or getter function)\n *\n * @example\n * ```ts\n * @Component({ ... })\n * export class VimEditorComponent {\n *   lastSequence = signal<string | null>(null)\n *\n *   constructor() {\n *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))\n *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))\n *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })\n *   }\n * }\n * ```\n */\nexport function injectHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | InjectHotkeySequenceOptions\n    | (() => InjectHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = injectDefaultHotkeysOptions()\n\n  effect((onCleanup) => {\n    // Resolve reactive values\n    const resolvedSequence =\n      typeof sequence === 'function' ? sequence() : sequence\n    const resolvedOptions = typeof options === 'function' ? options() : options\n\n    const mergedOptions = {\n      ...defaultOptions.hotkeySequence,\n      ...resolvedOptions,\n    } as InjectHotkeySequenceOptions\n\n    const { enabled = true, ...sequenceOptions } = mergedOptions\n\n    if (!enabled || resolvedSequence.length === 0) {\n      return\n    }\n\n    const manager = getSequenceManager()\n\n    // Pass through options; default target to document when not provided\n    const registerOptions: SequenceOptions = {\n      ...sequenceOptions,\n      enabled: true,\n      target:\n        sequenceOptions.target ??\n        (typeof document !== 'undefined' ? document : undefined),\n    }\n\n    const handle = manager.register(resolvedSequence, callback, registerOptions)\n\n    onCleanup(() => {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiB,6BAA6B;AAEpD,SAAQ,cAAc;EAEpB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAOpE,MAAM,EAAE,UAAU,MAAM,GAAG,oBALL;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;AAID,MAAI,CAAC,WAAW,iBAAiB,WAAW,EAC1C;EAGF,MAAM,UAAU,oBAAoB;EAGpC,MAAM,kBAAmC;GACvC,GAAG;GACH,SAAS;GACT,QACE,gBAAgB,WACf,OAAO,aAAa,cAAc,WAAW;GACjD;EAED,MAAM,SAAS,QAAQ,SAAS,kBAAkB,UAAU,gBAAgB;AAE5E,kBAAgB;AACd,OAAI,OAAO,SACT,QAAO,YAAY;IAErB;GACF"}
+{"version":3,"file":"injectHotkeySequence.js","names":[],"sources":["../src/injectHotkeySequence.ts"],"sourcesContent":["import { effect } from '@angular/core'\nimport { getSequenceManager } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n} from '@tanstack/hotkeys'\n\nexport interface InjectHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'enabled'\n> {\n  /** Whether the sequence is enabled. Defaults to true. */\n  enabled?: boolean\n}\n\n/**\n * Angular inject-based API for registering a keyboard shortcut sequence (Vim-style).\n *\n * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger\n * when the full sequence is pressed within a timeout.\n *\n * Each step may include modifiers. You can chain the same modifier across\n * steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,\n * Control, Alt, or Meta pressed alone) are ignored while matching—they do not\n * advance the sequence or reset progress.\n *\n * @param sequence - Array of hotkey strings that form the sequence (or getter function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or getter function)\n *\n * @example\n * ```ts\n * @Component({ ... })\n * export class VimEditorComponent {\n *   lastSequence = signal<string | null>(null)\n *\n *   constructor() {\n *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))\n *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))\n *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })\n *     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))\n *   }\n * }\n * ```\n */\nexport function injectHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | InjectHotkeySequenceOptions\n    | (() => InjectHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = injectDefaultHotkeysOptions()\n\n  effect((onCleanup) => {\n    // Resolve reactive values\n    const resolvedSequence =\n      typeof sequence === 'function' ? sequence() : sequence\n    const resolvedOptions = typeof options === 'function' ? options() : options\n\n    const mergedOptions = {\n      ...defaultOptions.hotkeySequence,\n      ...resolvedOptions,\n    } as InjectHotkeySequenceOptions\n\n    const { enabled = true, ...sequenceOptions } = mergedOptions\n\n    if (!enabled || resolvedSequence.length === 0) {\n      return\n    }\n\n    const manager = getSequenceManager()\n\n    // Pass through options; default target to document when not provided\n    const registerOptions: SequenceOptions = {\n      ...sequenceOptions,\n      enabled: true,\n      target:\n        sequenceOptions.target ??\n        (typeof document !== 'undefined' ? document : undefined),\n    }\n\n    const handle = manager.register(resolvedSequence, callback, registerOptions)\n\n    onCleanup(() => {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiB,6BAA6B;AAEpD,SAAQ,cAAc;EAEpB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAOpE,MAAM,EAAE,UAAU,MAAM,GAAG,oBALL;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;AAID,MAAI,CAAC,WAAW,iBAAiB,WAAW,EAC1C;EAGF,MAAM,UAAU,oBAAoB;EAGpC,MAAM,kBAAmC;GACvC,GAAG;GACH,SAAS;GACT,QACE,gBAAgB,WACf,OAAO,aAAa,cAAc,WAAW;GACjD;EAED,MAAM,SAAS,QAAQ,SAAS,kBAAkB,UAAU,gBAAgB;AAE5E,kBAAgB;AACd,OAAI,OAAO,SACT,QAAO,YAAY;IAErB;GACF"}

package/dist/injectHotkeySequenceRecorder.cjs

@@ -0,0 +1,58 @@
+const require_hotkeys_provider = require('./hotkeys-provider.cjs');
+let _tanstack_hotkeys = require("@tanstack/hotkeys");
+let _angular_core = require("@angular/core");
+
+//#region src/injectHotkeySequenceRecorder.ts
+/**
+* Angular inject-based API for recording multi-chord sequences.
+*/
+function injectHotkeySequenceRecorder(options) {
+	const defaultOptions = require_hotkeys_provider.injectDefaultHotkeysOptions();
+	const destroyRef = (0, _angular_core.inject)(_angular_core.DestroyRef);
+	const recorderSignal = (0, _angular_core.computed)(() => (0, _angular_core.untracked)(() => {
+		const resolvedOptions = typeof options === "function" ? options() : options;
+		return new _tanstack_hotkeys.HotkeySequenceRecorder({
+			...defaultOptions.hotkeySequenceRecorder,
+			...resolvedOptions
+		});
+	}));
+	const recorderStore = (0, _angular_core.computed)(() => (0, _angular_core.untracked)(() => recorderSignal().store));
+	const isRecording = injectLazyStore(recorderStore, (state) => state.isRecording);
+	const steps = injectLazyStore(recorderStore, (state) => state.steps);
+	const recordedSequence = injectLazyStore(recorderStore, (state) => state.recordedSequence);
+	(0, _angular_core.effect)(() => {
+		const resolved = typeof options === "function" ? options() : options;
+		recorderSignal().setOptions({
+			...defaultOptions.hotkeySequenceRecorder,
+			...resolved
+		});
+	});
+	destroyRef.onDestroy(() => {
+		recorderSignal().destroy();
+	});
+	return {
+		isRecording,
+		steps,
+		recordedSequence,
+		startRecording: () => recorderSignal().start(),
+		stopRecording: () => recorderSignal().stop(),
+		cancelRecording: () => recorderSignal().cancel(),
+		commitRecording: () => recorderSignal().commit()
+	};
+}
+function injectLazyStore(storeSignal, selector) {
+	const slice = (0, _angular_core.linkedSignal)(() => selector(storeSignal().get()));
+	(0, _angular_core.effect)((onCleanup) => {
+		const currentStore = storeSignal();
+		slice.set(selector(currentStore.get()));
+		const { unsubscribe } = currentStore.subscribe((s) => {
+			slice.set(selector(s));
+		});
+		onCleanup(() => unsubscribe());
+	});
+	return slice.asReadonly();
+}
+
+//#endregion
+exports.injectHotkeySequenceRecorder = injectHotkeySequenceRecorder;
+//# sourceMappingURL=injectHotkeySequenceRecorder.cjs.map

package/dist/injectHotkeySequenceRecorder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectHotkeySequenceRecorder.cjs","names":["injectDefaultHotkeysOptions","DestroyRef","HotkeySequenceRecorder"],"sources":["../src/injectHotkeySequenceRecorder.ts"],"sourcesContent":["import {\n  DestroyRef,\n  computed,\n  effect,\n  inject,\n  linkedSignal,\n  untracked,\n} from '@angular/core'\nimport { HotkeySequenceRecorder } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type { Atom, ReadonlyAtom } from '@tanstack/angular-store'\nimport type { Signal } from '@angular/core'\nimport type {\n  HotkeySequence,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\n\nexport interface AngularHotkeySequenceRecorder {\n  readonly isRecording: () => boolean\n  readonly steps: () => HotkeySequence\n  readonly recordedSequence: () => HotkeySequence | null\n  readonly startRecording: () => void\n  readonly stopRecording: () => void\n  readonly cancelRecording: () => void\n  readonly commitRecording: () => void\n}\n\n/**\n * Angular inject-based API for recording multi-chord sequences.\n */\nexport function injectHotkeySequenceRecorder(\n  options:\n    | HotkeySequenceRecorderOptions\n    | (() => HotkeySequenceRecorderOptions),\n): AngularHotkeySequenceRecorder {\n  const defaultOptions = injectDefaultHotkeysOptions()\n  const destroyRef = inject(DestroyRef)\n\n  const recorderSignal = computed(() =>\n    untracked(() => {\n      const resolvedOptions =\n        typeof options === 'function' ? options() : options\n\n      const mergedOptions = {\n        ...defaultOptions.hotkeySequenceRecorder,\n        ...resolvedOptions,\n      } as HotkeySequenceRecorderOptions\n\n      return new HotkeySequenceRecorder(mergedOptions)\n    }),\n  )\n\n  const recorderStore = computed(() => untracked(() => recorderSignal().store))\n  const isRecording = injectLazyStore(\n    recorderStore,\n    (state) => state.isRecording,\n  )\n  const steps = injectLazyStore(recorderStore, (state) => state.steps)\n  const recordedSequence = injectLazyStore(\n    recorderStore,\n    (state) => state.recordedSequence,\n  )\n\n  effect(() => {\n    const resolved = typeof options === 'function' ? options() : options\n    recorderSignal().setOptions({\n      ...defaultOptions.hotkeySequenceRecorder,\n      ...resolved,\n    } as HotkeySequenceRecorderOptions)\n  })\n\n  destroyRef.onDestroy(() => {\n    recorderSignal().destroy()\n  })\n\n  return {\n    isRecording,\n    steps,\n    recordedSequence,\n    startRecording: () => recorderSignal().start(),\n    stopRecording: () => recorderSignal().stop(),\n    cancelRecording: () => recorderSignal().cancel(),\n    commitRecording: () => recorderSignal().commit(),\n  }\n}\n\nfunction injectLazyStore<TState, TSelected = NoInfer<TState>>(\n  storeSignal: Signal<Atom<TState> | ReadonlyAtom<TState>>,\n  selector: (state: NoInfer<TState>) => TSelected,\n): Signal<TSelected> {\n  const slice = linkedSignal(() => selector(storeSignal().get()))\n\n  effect((onCleanup) => {\n    const currentStore = storeSignal()\n    slice.set(selector(currentStore.get()))\n    const { unsubscribe } = currentStore.subscribe((s) => {\n      slice.set(selector(s))\n    })\n    onCleanup(() => unsubscribe())\n  })\n\n  return slice.asReadonly()\n}\n"],"mappings":";;;;;;;;AA8BA,SAAgB,6BACd,SAG+B;CAC/B,MAAM,iBAAiBA,sDAA6B;CACpD,MAAM,uCAAoBC,yBAAW;CAErC,MAAM,sFACY;EACd,MAAM,kBACJ,OAAO,YAAY,aAAa,SAAS,GAAG;AAO9C,SAAO,IAAIC,yCALW;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ,CAE+C;GAChD,CACH;CAED,MAAM,qFAA+C,gBAAgB,CAAC,MAAM,CAAC;CAC7E,MAAM,cAAc,gBAClB,gBACC,UAAU,MAAM,YAClB;CACD,MAAM,QAAQ,gBAAgB,gBAAgB,UAAU,MAAM,MAAM;CACpE,MAAM,mBAAmB,gBACvB,gBACC,UAAU,MAAM,iBAClB;AAED,iCAAa;EACX,MAAM,WAAW,OAAO,YAAY,aAAa,SAAS,GAAG;AAC7D,kBAAgB,CAAC,WAAW;GAC1B,GAAG,eAAe;GAClB,GAAG;GACJ,CAAkC;GACnC;AAEF,YAAW,gBAAgB;AACzB,kBAAgB,CAAC,SAAS;GAC1B;AAEF,QAAO;EACL;EACA;EACA;EACA,sBAAsB,gBAAgB,CAAC,OAAO;EAC9C,qBAAqB,gBAAgB,CAAC,MAAM;EAC5C,uBAAuB,gBAAgB,CAAC,QAAQ;EAChD,uBAAuB,gBAAgB,CAAC,QAAQ;EACjD;;AAGH,SAAS,gBACP,aACA,UACmB;CACnB,MAAM,8CAA2B,SAAS,aAAa,CAAC,KAAK,CAAC,CAAC;AAE/D,4BAAQ,cAAc;EACpB,MAAM,eAAe,aAAa;AAClC,QAAM,IAAI,SAAS,aAAa,KAAK,CAAC,CAAC;EACvC,MAAM,EAAE,gBAAgB,aAAa,WAAW,MAAM;AACpD,SAAM,IAAI,SAAS,EAAE,CAAC;IACtB;AACF,kBAAgB,aAAa,CAAC;GAC9B;AAEF,QAAO,MAAM,YAAY"}

package/dist/injectHotkeySequenceRecorder.d.cts

@@ -0,0 +1,19 @@
+import { HotkeySequence, HotkeySequenceRecorderOptions } from "@tanstack/hotkeys";
+
+//#region src/injectHotkeySequenceRecorder.d.ts
+interface AngularHotkeySequenceRecorder {
+  readonly isRecording: () => boolean;
+  readonly steps: () => HotkeySequence;
+  readonly recordedSequence: () => HotkeySequence | null;
+  readonly startRecording: () => void;
+  readonly stopRecording: () => void;
+  readonly cancelRecording: () => void;
+  readonly commitRecording: () => void;
+}
+/**
+ * Angular inject-based API for recording multi-chord sequences.
+ */
+declare function injectHotkeySequenceRecorder(options: HotkeySequenceRecorderOptions | (() => HotkeySequenceRecorderOptions)): AngularHotkeySequenceRecorder;
+//#endregion
+export { AngularHotkeySequenceRecorder, injectHotkeySequenceRecorder };
+//# sourceMappingURL=injectHotkeySequenceRecorder.d.cts.map

package/dist/injectHotkeySequenceRecorder.d.ts

@@ -0,0 +1,19 @@
+import { HotkeySequence, HotkeySequenceRecorderOptions } from "@tanstack/hotkeys";
+
+//#region src/injectHotkeySequenceRecorder.d.ts
+interface AngularHotkeySequenceRecorder {
+  readonly isRecording: () => boolean;
+  readonly steps: () => HotkeySequence;
+  readonly recordedSequence: () => HotkeySequence | null;
+  readonly startRecording: () => void;
+  readonly stopRecording: () => void;
+  readonly cancelRecording: () => void;
+  readonly commitRecording: () => void;
+}
+/**
+ * Angular inject-based API for recording multi-chord sequences.
+ */
+declare function injectHotkeySequenceRecorder(options: HotkeySequenceRecorderOptions | (() => HotkeySequenceRecorderOptions)): AngularHotkeySequenceRecorder;
+//#endregion
+export { AngularHotkeySequenceRecorder, injectHotkeySequenceRecorder };
+//# sourceMappingURL=injectHotkeySequenceRecorder.d.ts.map

package/dist/injectHotkeySequenceRecorder.js

@@ -0,0 +1,58 @@
+import { injectDefaultHotkeysOptions } from "./hotkeys-provider.js";
+import { HotkeySequenceRecorder } from "@tanstack/hotkeys";
+import { DestroyRef, computed, effect, inject, linkedSignal, untracked } from "@angular/core";
+
+//#region src/injectHotkeySequenceRecorder.ts
+/**
+* Angular inject-based API for recording multi-chord sequences.
+*/
+function injectHotkeySequenceRecorder(options) {
+	const defaultOptions = injectDefaultHotkeysOptions();
+	const destroyRef = inject(DestroyRef);
+	const recorderSignal = computed(() => untracked(() => {
+		const resolvedOptions = typeof options === "function" ? options() : options;
+		return new HotkeySequenceRecorder({
+			...defaultOptions.hotkeySequenceRecorder,
+			...resolvedOptions
+		});
+	}));
+	const recorderStore = computed(() => untracked(() => recorderSignal().store));
+	const isRecording = injectLazyStore(recorderStore, (state) => state.isRecording);
+	const steps = injectLazyStore(recorderStore, (state) => state.steps);
+	const recordedSequence = injectLazyStore(recorderStore, (state) => state.recordedSequence);
+	effect(() => {
+		const resolved = typeof options === "function" ? options() : options;
+		recorderSignal().setOptions({
+			...defaultOptions.hotkeySequenceRecorder,
+			...resolved
+		});
+	});
+	destroyRef.onDestroy(() => {
+		recorderSignal().destroy();
+	});
+	return {
+		isRecording,
+		steps,
+		recordedSequence,
+		startRecording: () => recorderSignal().start(),
+		stopRecording: () => recorderSignal().stop(),
+		cancelRecording: () => recorderSignal().cancel(),
+		commitRecording: () => recorderSignal().commit()
+	};
+}
+function injectLazyStore(storeSignal, selector) {
+	const slice = linkedSignal(() => selector(storeSignal().get()));
+	effect((onCleanup) => {
+		const currentStore = storeSignal();
+		slice.set(selector(currentStore.get()));
+		const { unsubscribe } = currentStore.subscribe((s) => {
+			slice.set(selector(s));
+		});
+		onCleanup(() => unsubscribe());
+	});
+	return slice.asReadonly();
+}
+
+//#endregion
+export { injectHotkeySequenceRecorder };
+//# sourceMappingURL=injectHotkeySequenceRecorder.js.map

package/dist/injectHotkeySequenceRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectHotkeySequenceRecorder.js","names":[],"sources":["../src/injectHotkeySequenceRecorder.ts"],"sourcesContent":["import {\n  DestroyRef,\n  computed,\n  effect,\n  inject,\n  linkedSignal,\n  untracked,\n} from '@angular/core'\nimport { HotkeySequenceRecorder } from '@tanstack/hotkeys'\nimport { injectDefaultHotkeysOptions } from './hotkeys-provider'\nimport type { Atom, ReadonlyAtom } from '@tanstack/angular-store'\nimport type { Signal } from '@angular/core'\nimport type {\n  HotkeySequence,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\n\nexport interface AngularHotkeySequenceRecorder {\n  readonly isRecording: () => boolean\n  readonly steps: () => HotkeySequence\n  readonly recordedSequence: () => HotkeySequence | null\n  readonly startRecording: () => void\n  readonly stopRecording: () => void\n  readonly cancelRecording: () => void\n  readonly commitRecording: () => void\n}\n\n/**\n * Angular inject-based API for recording multi-chord sequences.\n */\nexport function injectHotkeySequenceRecorder(\n  options:\n    | HotkeySequenceRecorderOptions\n    | (() => HotkeySequenceRecorderOptions),\n): AngularHotkeySequenceRecorder {\n  const defaultOptions = injectDefaultHotkeysOptions()\n  const destroyRef = inject(DestroyRef)\n\n  const recorderSignal = computed(() =>\n    untracked(() => {\n      const resolvedOptions =\n        typeof options === 'function' ? options() : options\n\n      const mergedOptions = {\n        ...defaultOptions.hotkeySequenceRecorder,\n        ...resolvedOptions,\n      } as HotkeySequenceRecorderOptions\n\n      return new HotkeySequenceRecorder(mergedOptions)\n    }),\n  )\n\n  const recorderStore = computed(() => untracked(() => recorderSignal().store))\n  const isRecording = injectLazyStore(\n    recorderStore,\n    (state) => state.isRecording,\n  )\n  const steps = injectLazyStore(recorderStore, (state) => state.steps)\n  const recordedSequence = injectLazyStore(\n    recorderStore,\n    (state) => state.recordedSequence,\n  )\n\n  effect(() => {\n    const resolved = typeof options === 'function' ? options() : options\n    recorderSignal().setOptions({\n      ...defaultOptions.hotkeySequenceRecorder,\n      ...resolved,\n    } as HotkeySequenceRecorderOptions)\n  })\n\n  destroyRef.onDestroy(() => {\n    recorderSignal().destroy()\n  })\n\n  return {\n    isRecording,\n    steps,\n    recordedSequence,\n    startRecording: () => recorderSignal().start(),\n    stopRecording: () => recorderSignal().stop(),\n    cancelRecording: () => recorderSignal().cancel(),\n    commitRecording: () => recorderSignal().commit(),\n  }\n}\n\nfunction injectLazyStore<TState, TSelected = NoInfer<TState>>(\n  storeSignal: Signal<Atom<TState> | ReadonlyAtom<TState>>,\n  selector: (state: NoInfer<TState>) => TSelected,\n): Signal<TSelected> {\n  const slice = linkedSignal(() => selector(storeSignal().get()))\n\n  effect((onCleanup) => {\n    const currentStore = storeSignal()\n    slice.set(selector(currentStore.get()))\n    const { unsubscribe } = currentStore.subscribe((s) => {\n      slice.set(selector(s))\n    })\n    onCleanup(() => unsubscribe())\n  })\n\n  return slice.asReadonly()\n}\n"],"mappings":";;;;;;;;AA8BA,SAAgB,6BACd,SAG+B;CAC/B,MAAM,iBAAiB,6BAA6B;CACpD,MAAM,aAAa,OAAO,WAAW;CAErC,MAAM,iBAAiB,eACrB,gBAAgB;EACd,MAAM,kBACJ,OAAO,YAAY,aAAa,SAAS,GAAG;AAO9C,SAAO,IAAI,uBALW;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ,CAE+C;GAChD,CACH;CAED,MAAM,gBAAgB,eAAe,gBAAgB,gBAAgB,CAAC,MAAM,CAAC;CAC7E,MAAM,cAAc,gBAClB,gBACC,UAAU,MAAM,YAClB;CACD,MAAM,QAAQ,gBAAgB,gBAAgB,UAAU,MAAM,MAAM;CACpE,MAAM,mBAAmB,gBACvB,gBACC,UAAU,MAAM,iBAClB;AAED,cAAa;EACX,MAAM,WAAW,OAAO,YAAY,aAAa,SAAS,GAAG;AAC7D,kBAAgB,CAAC,WAAW;GAC1B,GAAG,eAAe;GAClB,GAAG;GACJ,CAAkC;GACnC;AAEF,YAAW,gBAAgB;AACzB,kBAAgB,CAAC,SAAS;GAC1B;AAEF,QAAO;EACL;EACA;EACA;EACA,sBAAsB,gBAAgB,CAAC,OAAO;EAC9C,qBAAqB,gBAAgB,CAAC,MAAM;EAC5C,uBAAuB,gBAAgB,CAAC,QAAQ;EAChD,uBAAuB,gBAAgB,CAAC,QAAQ;EACjD;;AAGH,SAAS,gBACP,aACA,UACmB;CACnB,MAAM,QAAQ,mBAAmB,SAAS,aAAa,CAAC,KAAK,CAAC,CAAC;AAE/D,SAAQ,cAAc;EACpB,MAAM,eAAe,aAAa;AAClC,QAAM,IAAI,SAAS,aAAa,KAAK,CAAC,CAAC;EACvC,MAAM,EAAE,gBAAgB,aAAa,WAAW,MAAM;AACpD,SAAM,IAAI,SAAS,EAAE,CAAC;IACtB;AACF,kBAAgB,aAAa,CAAC;GAC9B;AAEF,QAAO,MAAM,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/angular-hotkeys",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Angular adapter for TanStack Hotkeys",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -42,7 +42,7 @@
   ],
   "dependencies": {
     "@tanstack/angular-store": "^0.9.2",
-    "@tanstack/hotkeys": "0.4.2"
+    "@tanstack/hotkeys": "0.5.0"
   },
   "peerDependencies": {
     "@angular/common": ">=19.0.0",

package/src/hotkeys-provider.ts

@@ -1,5 +1,8 @@
 import { InjectionToken, inject } from '@angular/core'
-import type { HotkeyRecorderOptions } from '@tanstack/hotkeys'
+import type {
+  HotkeyRecorderOptions,
+  HotkeySequenceRecorderOptions,
+} from '@tanstack/hotkeys'
 import type { InjectHotkeyOptions } from './injectHotkey'
 import type { InjectHotkeySequenceOptions } from './injectHotkeySequence'
 import type { StaticProvider } from '@angular/core'
@@ -7,6 +10,7 @@ import type { StaticProvider } from '@angular/core'
 export interface HotkeysProviderOptions {
   hotkey?: Partial<InjectHotkeyOptions>
   hotkeyRecorder?: Partial<HotkeyRecorderOptions>
+  hotkeySequenceRecorder?: Partial<HotkeySequenceRecorderOptions>
   hotkeySequence?: Partial<InjectHotkeySequenceOptions>
 }
 

package/src/index.ts

@@ -12,3 +12,4 @@ export * from './injectHeldKeys'
 export * from './injectHeldKeyCodes'
 export * from './injectKeyHold'
 export * from './injectHotkeyRecorder'
+export * from './injectHotkeySequenceRecorder'

package/src/injectHotkeySequence.ts

@@ -21,6 +21,11 @@ export interface InjectHotkeySequenceOptions extends Omit<
  * Allows you to register multi-key sequences like 'g g' or 'd d' that trigger
  * when the full sequence is pressed within a timeout.
  *
+ * Each step may include modifiers. You can chain the same modifier across
+ * steps (e.g. `Shift+R` then `Shift+T`). Modifier-only keydown events (Shift,
+ * Control, Alt, or Meta pressed alone) are ignored while matching—they do not
+ * advance the sequence or reset progress.
+ *
  * @param sequence - Array of hotkey strings that form the sequence (or getter function)
  * @param callback - Function to call when the sequence is completed
  * @param options - Options for the sequence behavior (or getter function)
@@ -35,6 +40,7 @@ export interface InjectHotkeySequenceOptions extends Omit<
  *     injectHotkeySequence(['G', 'G'], () => this.lastSequence.set('gg → Go to top'))
  *     injectHotkeySequence(['D', 'D'], () => this.lastSequence.set('dd → Delete line'))
  *     injectHotkeySequence(['C', 'I', 'W'], () => this.lastSequence.set('ciw'), { timeout: 500 })
+ *     injectHotkeySequence(['Shift+R', 'Shift+T'], () => this.lastSequence.set('⇧R⇧T'))
  *   }
  * }
  * ```

package/src/injectHotkeySequenceRecorder.ts

@@ -0,0 +1,103 @@
+import {
+  DestroyRef,
+  computed,
+  effect,
+  inject,
+  linkedSignal,
+  untracked,
+} from '@angular/core'
+import { HotkeySequenceRecorder } from '@tanstack/hotkeys'
+import { injectDefaultHotkeysOptions } from './hotkeys-provider'
+import type { Atom, ReadonlyAtom } from '@tanstack/angular-store'
+import type { Signal } from '@angular/core'
+import type {
+  HotkeySequence,
+  HotkeySequenceRecorderOptions,
+} from '@tanstack/hotkeys'
+
+export interface AngularHotkeySequenceRecorder {
+  readonly isRecording: () => boolean
+  readonly steps: () => HotkeySequence
+  readonly recordedSequence: () => HotkeySequence | null
+  readonly startRecording: () => void
+  readonly stopRecording: () => void
+  readonly cancelRecording: () => void
+  readonly commitRecording: () => void
+}
+
+/**
+ * Angular inject-based API for recording multi-chord sequences.
+ */
+export function injectHotkeySequenceRecorder(
+  options:
+    | HotkeySequenceRecorderOptions
+    | (() => HotkeySequenceRecorderOptions),
+): AngularHotkeySequenceRecorder {
+  const defaultOptions = injectDefaultHotkeysOptions()
+  const destroyRef = inject(DestroyRef)
+
+  const recorderSignal = computed(() =>
+    untracked(() => {
+      const resolvedOptions =
+        typeof options === 'function' ? options() : options
+
+      const mergedOptions = {
+        ...defaultOptions.hotkeySequenceRecorder,
+        ...resolvedOptions,
+      } as HotkeySequenceRecorderOptions
+
+      return new HotkeySequenceRecorder(mergedOptions)
+    }),
+  )
+
+  const recorderStore = computed(() => untracked(() => recorderSignal().store))
+  const isRecording = injectLazyStore(
+    recorderStore,
+    (state) => state.isRecording,
+  )
+  const steps = injectLazyStore(recorderStore, (state) => state.steps)
+  const recordedSequence = injectLazyStore(
+    recorderStore,
+    (state) => state.recordedSequence,
+  )
+
+  effect(() => {
+    const resolved = typeof options === 'function' ? options() : options
+    recorderSignal().setOptions({
+      ...defaultOptions.hotkeySequenceRecorder,
+      ...resolved,
+    } as HotkeySequenceRecorderOptions)
+  })
+
+  destroyRef.onDestroy(() => {
+    recorderSignal().destroy()
+  })
+
+  return {
+    isRecording,
+    steps,
+    recordedSequence,
+    startRecording: () => recorderSignal().start(),
+    stopRecording: () => recorderSignal().stop(),
+    cancelRecording: () => recorderSignal().cancel(),
+    commitRecording: () => recorderSignal().commit(),
+  }
+}
+
+function injectLazyStore<TState, TSelected = NoInfer<TState>>(
+  storeSignal: Signal<Atom<TState> | ReadonlyAtom<TState>>,
+  selector: (state: NoInfer<TState>) => TSelected,
+): Signal<TSelected> {
+  const slice = linkedSignal(() => selector(storeSignal().get()))
+
+  effect((onCleanup) => {
+    const currentStore = storeSignal()
+    slice.set(selector(currentStore.get()))
+    const { unsubscribe } = currentStore.subscribe((s) => {
+      slice.set(selector(s))
+    })
+    onCleanup(() => unsubscribe())
+  })
+
+  return slice.asReadonly()
+}