@tanstack/solid-hotkeys 0.11.0 → 0.12.0

package/dist/createHotkeySequence.cjs

@@ -1,107 +0,0 @@
-const require_HotkeysProvider = require('./HotkeysProvider.cjs');
-let _tanstack_hotkeys = require("@tanstack/hotkeys");
-let solid_js = require("solid-js");
-
-//#region src/createHotkeySequence.ts
-/**
-* SolidJS primitive for registering a keyboard shortcut sequence (Vim-style).
-*
-* This primitive 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 accessor function)
-* @param callback - Function to call when the sequence is completed
-* @param options - Options for the sequence behavior (or accessor function)
-*
-* @example
-* ```tsx
-* function VimEditor() {
-*   // 'g g' to go to top
-*   createHotkeySequence(['G', 'G'], () => {
-*     scrollToTop()
-*   })
-*
-*   // 'd d' to delete line
-*   createHotkeySequence(['D', 'D'], () => {
-*     deleteLine()
-*   })
-*
-*   // 'd i w' to delete inner word
-*   createHotkeySequence(['D', 'I', 'W'], () => {
-*     deleteInnerWord()
-*   }, { timeout: 500 })
-*
-*   // Same modifier on consecutive steps (bare Shift between chords is ignored)
-*   createHotkeySequence(['Shift+R', 'Shift+T'], () => {
-*     nextAction()
-*   })
-*
-*   return <div>...</div>
-* }
-* ```
-*/
-function createHotkeySequence(sequence, callback, options = {}) {
-	const defaultOptions = require_HotkeysProvider.useDefaultHotkeysOptions();
-	const manager = (0, _tanstack_hotkeys.getSequenceManager)();
-	let registration = null;
-	let lastSequenceKey = null;
-	let lastTarget = null;
-	(0, solid_js.onCleanup)(() => {
-		if (registration?.isActive) {
-			registration.unregister();
-			registration = null;
-		}
-		lastSequenceKey = null;
-		lastTarget = null;
-	});
-	(0, solid_js.createEffect)(() => {
-		const resolvedSequence = typeof sequence === "function" ? sequence() : sequence;
-		const resolvedOptions = typeof options === "function" ? options() : options;
-		const mergedOptions = {
-			...defaultOptions.hotkeySequence,
-			...resolvedOptions
-		};
-		const { target: _target, ...optionsWithoutTarget } = mergedOptions;
-		const resolvedTarget = "target" in mergedOptions ? mergedOptions.target ?? null : typeof document !== "undefined" ? document : null;
-		if (resolvedSequence.length === 0 || !resolvedTarget) {
-			if (registration?.isActive) {
-				registration.unregister();
-				registration = null;
-			}
-			lastSequenceKey = null;
-			lastTarget = null;
-			return;
-		}
-		const sequenceKey = (0, _tanstack_hotkeys.formatHotkeySequence)(resolvedSequence);
-		(0, solid_js.untrack)(() => {
-			if (registration?.isActive && lastSequenceKey === sequenceKey && lastTarget === resolvedTarget) {
-				registration.callback = callback;
-				registration.setOptions(optionsWithoutTarget);
-				return;
-			}
-			if (registration?.isActive) {
-				registration.unregister();
-				registration = null;
-			}
-			registration = manager.register(resolvedSequence, callback, {
-				...mergedOptions,
-				target: resolvedTarget
-			});
-			if (registration.isActive) {
-				registration.callback = callback;
-				registration.setOptions(optionsWithoutTarget);
-			}
-			lastSequenceKey = sequenceKey;
-			lastTarget = resolvedTarget;
-		});
-	});
-}
-
-//#endregion
-exports.createHotkeySequence = createHotkeySequence;
-//# sourceMappingURL=createHotkeySequence.cjs.map

package/dist/createHotkeySequence.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequence.cjs","names":["useDefaultHotkeysOptions"],"sources":["../src/createHotkeySequence.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from 'solid-js'\nimport { formatHotkeySequence, getSequenceManager } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n  SequenceRegistrationHandle,\n} from '@tanstack/hotkeys'\n\nexport interface CreateHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'target'\n> {\n  /**\n   * The DOM element to attach the event listener to.\n   * Can be a direct DOM element, an accessor, or null. Defaults to document.\n   */\n  target?: HTMLElement | Document | Window | null\n}\n\n/**\n * SolidJS primitive for registering a keyboard shortcut sequence (Vim-style).\n *\n * This primitive allows you to register multi-key sequences like 'g g' or 'd d'\n * that trigger 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 accessor function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or accessor function)\n *\n * @example\n * ```tsx\n * function VimEditor() {\n *   // 'g g' to go to top\n *   createHotkeySequence(['G', 'G'], () => {\n *     scrollToTop()\n *   })\n *\n *   // 'd d' to delete line\n *   createHotkeySequence(['D', 'D'], () => {\n *     deleteLine()\n *   })\n *\n *   // 'd i w' to delete inner word\n *   createHotkeySequence(['D', 'I', 'W'], () => {\n *     deleteInnerWord()\n *   }, { timeout: 500 })\n *\n *   // Same modifier on consecutive steps (bare Shift between chords is ignored)\n *   createHotkeySequence(['Shift+R', 'Shift+T'], () => {\n *     nextAction()\n *   })\n *\n *   return <div>...</div>\n * }\n * ```\n */\nexport function createHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | CreateHotkeySequenceOptions\n    | (() => CreateHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = useDefaultHotkeysOptions()\n  const manager = getSequenceManager()\n\n  let registration: SequenceRegistrationHandle | null = null\n  let lastSequenceKey: string | null = null\n  let lastTarget: HTMLElement | Document | Window | null = null\n\n  onCleanup(() => {\n    if (registration?.isActive) {\n      registration.unregister()\n      registration = null\n    }\n    lastSequenceKey = null\n    lastTarget = null\n  })\n\n  createEffect(() => {\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 CreateHotkeySequenceOptions\n\n    // Extract options without target (target is handled separately)\n    const { target: _target, ...optionsWithoutTarget } = mergedOptions\n\n    // Resolve target: when explicitly provided (even as null), use it and skip if null.\n    // When not provided, default to document. Matches createHotkey.\n    const resolvedTarget =\n      'target' in mergedOptions\n        ? (mergedOptions.target ?? null)\n        : typeof document !== 'undefined'\n          ? document\n          : null\n\n    if (resolvedSequence.length === 0 || !resolvedTarget) {\n      if (registration?.isActive) {\n        registration.unregister()\n        registration = null\n      }\n      lastSequenceKey = null\n      lastTarget = null\n      return\n    }\n\n    const sequenceKey = formatHotkeySequence(resolvedSequence)\n\n    // Untrack store mutations so that registering/updating the sequence doesn't\n    // create a circular reactive dependency when createHotkeyRegistrations\n    // subscribes to the same store.\n    untrack(() => {\n      if (\n        registration?.isActive &&\n        lastSequenceKey === sequenceKey &&\n        lastTarget === resolvedTarget\n      ) {\n        registration.callback = callback\n        registration.setOptions(optionsWithoutTarget)\n        return\n      }\n\n      if (registration?.isActive) {\n        registration.unregister()\n        registration = null\n      }\n\n      registration = manager.register(resolvedSequence, callback, {\n        ...mergedOptions,\n        target: resolvedTarget,\n      })\n\n      if (registration.isActive) {\n        registration.callback = callback\n        registration.setOptions(optionsWithoutTarget)\n      }\n\n      lastSequenceKey = sequenceKey\n      lastTarget = resolvedTarget\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiBA,kDAA0B;CACjD,MAAM,qDAA8B;CAEpC,IAAI,eAAkD;CACtD,IAAI,kBAAiC;CACrC,IAAI,aAAqD;AAEzD,+BAAgB;AACd,MAAI,cAAc,UAAU;AAC1B,gBAAa,YAAY;AACzB,kBAAe;;AAEjB,oBAAkB;AAClB,eAAa;GACb;AAEF,kCAAmB;EAEjB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAEpE,MAAM,gBAAgB;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;EAGD,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB;EAIrD,MAAM,iBACJ,YAAY,gBACP,cAAc,UAAU,OACzB,OAAO,aAAa,cAClB,WACA;AAER,MAAI,iBAAiB,WAAW,KAAK,CAAC,gBAAgB;AACpD,OAAI,cAAc,UAAU;AAC1B,iBAAa,YAAY;AACzB,mBAAe;;AAEjB,qBAAkB;AAClB,gBAAa;AACb;;EAGF,MAAM,0DAAmC,iBAAiB;AAK1D,8BAAc;AACZ,OACE,cAAc,YACd,oBAAoB,eACpB,eAAe,gBACf;AACA,iBAAa,WAAW;AACxB,iBAAa,WAAW,qBAAqB;AAC7C;;AAGF,OAAI,cAAc,UAAU;AAC1B,iBAAa,YAAY;AACzB,mBAAe;;AAGjB,kBAAe,QAAQ,SAAS,kBAAkB,UAAU;IAC1D,GAAG;IACH,QAAQ;IACT,CAAC;AAEF,OAAI,aAAa,UAAU;AACzB,iBAAa,WAAW;AACxB,iBAAa,WAAW,qBAAqB;;AAG/C,qBAAkB;AAClB,gBAAa;IACb;GACF"}

package/dist/createHotkeySequence.d.cts

@@ -1,56 +0,0 @@
-import { HotkeyCallback, HotkeySequence, SequenceOptions } from "@tanstack/hotkeys";
-
-//#region src/createHotkeySequence.d.ts
-interface CreateHotkeySequenceOptions extends Omit<SequenceOptions, 'target'> {
-  /**
-   * The DOM element to attach the event listener to.
-   * Can be a direct DOM element, an accessor, or null. Defaults to document.
-   */
-  target?: HTMLElement | Document | Window | null;
-}
-/**
- * SolidJS primitive for registering a keyboard shortcut sequence (Vim-style).
- *
- * This primitive 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 accessor function)
- * @param callback - Function to call when the sequence is completed
- * @param options - Options for the sequence behavior (or accessor function)
- *
- * @example
- * ```tsx
- * function VimEditor() {
- *   // 'g g' to go to top
- *   createHotkeySequence(['G', 'G'], () => {
- *     scrollToTop()
- *   })
- *
- *   // 'd d' to delete line
- *   createHotkeySequence(['D', 'D'], () => {
- *     deleteLine()
- *   })
- *
- *   // 'd i w' to delete inner word
- *   createHotkeySequence(['D', 'I', 'W'], () => {
- *     deleteInnerWord()
- *   }, { timeout: 500 })
- *
- *   // Same modifier on consecutive steps (bare Shift between chords is ignored)
- *   createHotkeySequence(['Shift+R', 'Shift+T'], () => {
- *     nextAction()
- *   })
- *
- *   return <div>...</div>
- * }
- * ```
- */
-declare function createHotkeySequence(sequence: HotkeySequence | (() => HotkeySequence), callback: HotkeyCallback, options?: CreateHotkeySequenceOptions | (() => CreateHotkeySequenceOptions)): void;
-//#endregion
-export { CreateHotkeySequenceOptions, createHotkeySequence };
-//# sourceMappingURL=createHotkeySequence.d.cts.map

package/dist/createHotkeySequence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequence.js","names":[],"sources":["../src/createHotkeySequence.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from 'solid-js'\nimport { formatHotkeySequence, getSequenceManager } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceOptions,\n  SequenceRegistrationHandle,\n} from '@tanstack/hotkeys'\n\nexport interface CreateHotkeySequenceOptions extends Omit<\n  SequenceOptions,\n  'target'\n> {\n  /**\n   * The DOM element to attach the event listener to.\n   * Can be a direct DOM element, an accessor, or null. Defaults to document.\n   */\n  target?: HTMLElement | Document | Window | null\n}\n\n/**\n * SolidJS primitive for registering a keyboard shortcut sequence (Vim-style).\n *\n * This primitive allows you to register multi-key sequences like 'g g' or 'd d'\n * that trigger 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 accessor function)\n * @param callback - Function to call when the sequence is completed\n * @param options - Options for the sequence behavior (or accessor function)\n *\n * @example\n * ```tsx\n * function VimEditor() {\n *   // 'g g' to go to top\n *   createHotkeySequence(['G', 'G'], () => {\n *     scrollToTop()\n *   })\n *\n *   // 'd d' to delete line\n *   createHotkeySequence(['D', 'D'], () => {\n *     deleteLine()\n *   })\n *\n *   // 'd i w' to delete inner word\n *   createHotkeySequence(['D', 'I', 'W'], () => {\n *     deleteInnerWord()\n *   }, { timeout: 500 })\n *\n *   // Same modifier on consecutive steps (bare Shift between chords is ignored)\n *   createHotkeySequence(['Shift+R', 'Shift+T'], () => {\n *     nextAction()\n *   })\n *\n *   return <div>...</div>\n * }\n * ```\n */\nexport function createHotkeySequence(\n  sequence: HotkeySequence | (() => HotkeySequence),\n  callback: HotkeyCallback,\n  options:\n    | CreateHotkeySequenceOptions\n    | (() => CreateHotkeySequenceOptions) = {},\n): void {\n  const defaultOptions = useDefaultHotkeysOptions()\n  const manager = getSequenceManager()\n\n  let registration: SequenceRegistrationHandle | null = null\n  let lastSequenceKey: string | null = null\n  let lastTarget: HTMLElement | Document | Window | null = null\n\n  onCleanup(() => {\n    if (registration?.isActive) {\n      registration.unregister()\n      registration = null\n    }\n    lastSequenceKey = null\n    lastTarget = null\n  })\n\n  createEffect(() => {\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 CreateHotkeySequenceOptions\n\n    // Extract options without target (target is handled separately)\n    const { target: _target, ...optionsWithoutTarget } = mergedOptions\n\n    // Resolve target: when explicitly provided (even as null), use it and skip if null.\n    // When not provided, default to document. Matches createHotkey.\n    const resolvedTarget =\n      'target' in mergedOptions\n        ? (mergedOptions.target ?? null)\n        : typeof document !== 'undefined'\n          ? document\n          : null\n\n    if (resolvedSequence.length === 0 || !resolvedTarget) {\n      if (registration?.isActive) {\n        registration.unregister()\n        registration = null\n      }\n      lastSequenceKey = null\n      lastTarget = null\n      return\n    }\n\n    const sequenceKey = formatHotkeySequence(resolvedSequence)\n\n    // Untrack store mutations so that registering/updating the sequence doesn't\n    // create a circular reactive dependency when createHotkeyRegistrations\n    // subscribes to the same store.\n    untrack(() => {\n      if (\n        registration?.isActive &&\n        lastSequenceKey === sequenceKey &&\n        lastTarget === resolvedTarget\n      ) {\n        registration.callback = callback\n        registration.setOptions(optionsWithoutTarget)\n        return\n      }\n\n      if (registration?.isActive) {\n        registration.unregister()\n        registration = null\n      }\n\n      registration = manager.register(resolvedSequence, callback, {\n        ...mergedOptions,\n        target: resolvedTarget,\n      })\n\n      if (registration.isActive) {\n        registration.callback = callback\n        registration.setOptions(optionsWithoutTarget)\n      }\n\n      lastSequenceKey = sequenceKey\n      lastTarget = resolvedTarget\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,qBACd,UACA,UACA,UAE0C,EAAE,EACtC;CACN,MAAM,iBAAiB,0BAA0B;CACjD,MAAM,UAAU,oBAAoB;CAEpC,IAAI,eAAkD;CACtD,IAAI,kBAAiC;CACrC,IAAI,aAAqD;AAEzD,iBAAgB;AACd,MAAI,cAAc,UAAU;AAC1B,gBAAa,YAAY;AACzB,kBAAe;;AAEjB,oBAAkB;AAClB,eAAa;GACb;AAEF,oBAAmB;EAEjB,MAAM,mBACJ,OAAO,aAAa,aAAa,UAAU,GAAG;EAChD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EAEpE,MAAM,gBAAgB;GACpB,GAAG,eAAe;GAClB,GAAG;GACJ;EAGD,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB;EAIrD,MAAM,iBACJ,YAAY,gBACP,cAAc,UAAU,OACzB,OAAO,aAAa,cAClB,WACA;AAER,MAAI,iBAAiB,WAAW,KAAK,CAAC,gBAAgB;AACpD,OAAI,cAAc,UAAU;AAC1B,iBAAa,YAAY;AACzB,mBAAe;;AAEjB,qBAAkB;AAClB,gBAAa;AACb;;EAGF,MAAM,cAAc,qBAAqB,iBAAiB;AAK1D,gBAAc;AACZ,OACE,cAAc,YACd,oBAAoB,eACpB,eAAe,gBACf;AACA,iBAAa,WAAW;AACxB,iBAAa,WAAW,qBAAqB;AAC7C;;AAGF,OAAI,cAAc,UAAU;AAC1B,iBAAa,YAAY;AACzB,mBAAe;;AAGjB,kBAAe,QAAQ,SAAS,kBAAkB,UAAU;IAC1D,GAAG;IACH,QAAQ;IACT,CAAC;AAEF,OAAI,aAAa,UAAU;AACzB,iBAAa,WAAW;AACxB,iBAAa,WAAW,qBAAqB;;AAG/C,qBAAkB;AAClB,gBAAa;IACb;GACF"}

package/dist/createHotkeySequenceRecorder.cjs

@@ -1,43 +0,0 @@
-const require_HotkeysProvider = require('./HotkeysProvider.cjs');
-let _tanstack_hotkeys = require("@tanstack/hotkeys");
-let solid_js = require("solid-js");
-let _tanstack_solid_store = require("@tanstack/solid-store");
-
-//#region src/createHotkeySequenceRecorder.ts
-/**
-* SolidJS primitive for recording multi-chord sequences (Vim-style shortcuts).
-*/
-function createHotkeySequenceRecorder(options) {
-	const defaultOptions = require_HotkeysProvider.useDefaultHotkeysOptions();
-	const resolvedOptions = typeof options === "function" ? options() : options;
-	const recorder = new _tanstack_hotkeys.HotkeySequenceRecorder({
-		...defaultOptions.hotkeySequenceRecorder,
-		...resolvedOptions
-	});
-	const isRecording = (0, _tanstack_solid_store.useSelector)(recorder.store, (state) => state.isRecording);
-	const steps = (0, _tanstack_solid_store.useSelector)(recorder.store, (state) => state.steps);
-	const recordedSequence = (0, _tanstack_solid_store.useSelector)(recorder.store, (state) => state.recordedSequence);
-	(0, solid_js.createEffect)(() => {
-		const resolved = typeof options === "function" ? options() : options;
-		recorder.setOptions({
-			...defaultOptions.hotkeySequenceRecorder,
-			...resolved
-		});
-	});
-	(0, solid_js.onCleanup)(() => {
-		recorder.destroy();
-	});
-	return {
-		isRecording,
-		steps,
-		recordedSequence,
-		startRecording: () => recorder.start(),
-		stopRecording: () => recorder.stop(),
-		cancelRecording: () => recorder.cancel(),
-		commitRecording: () => recorder.commit()
-	};
-}
-
-//#endregion
-exports.createHotkeySequenceRecorder = createHotkeySequenceRecorder;
-//# sourceMappingURL=createHotkeySequenceRecorder.cjs.map

package/dist/createHotkeySequenceRecorder.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequenceRecorder.cjs","names":["useDefaultHotkeysOptions","HotkeySequenceRecorder"],"sources":["../src/createHotkeySequenceRecorder.ts"],"sourcesContent":["import { createEffect, onCleanup } from 'solid-js'\nimport { useSelector } from '@tanstack/solid-store'\nimport { HotkeySequenceRecorder } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type {\n  HotkeySequence,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\n\nexport interface SolidHotkeySequenceRecorder {\n  isRecording: () => boolean\n  steps: () => HotkeySequence\n  recordedSequence: () => HotkeySequence | null\n  startRecording: () => void\n  stopRecording: () => void\n  cancelRecording: () => void\n  commitRecording: () => void\n}\n\n/**\n * SolidJS primitive for recording multi-chord sequences (Vim-style shortcuts).\n */\nexport function createHotkeySequenceRecorder(\n  options:\n    | HotkeySequenceRecorderOptions\n    | (() => HotkeySequenceRecorderOptions),\n): SolidHotkeySequenceRecorder {\n  const defaultOptions = useDefaultHotkeysOptions()\n\n  const resolvedOptions = typeof options === 'function' ? options() : options\n  const mergedOptions = {\n    ...defaultOptions.hotkeySequenceRecorder,\n    ...resolvedOptions,\n  } as HotkeySequenceRecorderOptions\n\n  const recorder = new HotkeySequenceRecorder(mergedOptions)\n\n  const isRecording = useSelector(recorder.store, (state) => state.isRecording)\n  const steps = useSelector(recorder.store, (state) => state.steps)\n  const recordedSequence = useSelector(\n    recorder.store,\n    (state) => state.recordedSequence,\n  )\n\n  createEffect(() => {\n    const resolved = typeof options === 'function' ? options() : options\n    recorder.setOptions({\n      ...defaultOptions.hotkeySequenceRecorder,\n      ...resolved,\n    } as HotkeySequenceRecorderOptions)\n  })\n\n  onCleanup(() => {\n    recorder.destroy()\n  })\n\n  return {\n    isRecording,\n    steps,\n    recordedSequence,\n    startRecording: () => recorder.start(),\n    stopRecording: () => recorder.stop(),\n    cancelRecording: () => recorder.cancel(),\n    commitRecording: () => recorder.commit(),\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,6BACd,SAG6B;CAC7B,MAAM,iBAAiBA,kDAA0B;CAEjD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;CAMpE,MAAM,WAAW,IAAIC,yCALC;EACpB,GAAG,eAAe;EAClB,GAAG;EACJ,CAEyD;CAE1D,MAAM,qDAA0B,SAAS,QAAQ,UAAU,MAAM,YAAY;CAC7E,MAAM,+CAAoB,SAAS,QAAQ,UAAU,MAAM,MAAM;CACjE,MAAM,0DACJ,SAAS,QACR,UAAU,MAAM,iBAClB;AAED,kCAAmB;EACjB,MAAM,WAAW,OAAO,YAAY,aAAa,SAAS,GAAG;AAC7D,WAAS,WAAW;GAClB,GAAG,eAAe;GAClB,GAAG;GACJ,CAAkC;GACnC;AAEF,+BAAgB;AACd,WAAS,SAAS;GAClB;AAEF,QAAO;EACL;EACA;EACA;EACA,sBAAsB,SAAS,OAAO;EACtC,qBAAqB,SAAS,MAAM;EACpC,uBAAuB,SAAS,QAAQ;EACxC,uBAAuB,SAAS,QAAQ;EACzC"}

package/dist/createHotkeySequenceRecorder.d.cts

@@ -1,19 +0,0 @@
-import { HotkeySequence, HotkeySequenceRecorderOptions } from "@tanstack/hotkeys";
-
-//#region src/createHotkeySequenceRecorder.d.ts
-interface SolidHotkeySequenceRecorder {
-  isRecording: () => boolean;
-  steps: () => HotkeySequence;
-  recordedSequence: () => HotkeySequence | null;
-  startRecording: () => void;
-  stopRecording: () => void;
-  cancelRecording: () => void;
-  commitRecording: () => void;
-}
-/**
- * SolidJS primitive for recording multi-chord sequences (Vim-style shortcuts).
- */
-declare function createHotkeySequenceRecorder(options: HotkeySequenceRecorderOptions | (() => HotkeySequenceRecorderOptions)): SolidHotkeySequenceRecorder;
-//#endregion
-export { SolidHotkeySequenceRecorder, createHotkeySequenceRecorder };
-//# sourceMappingURL=createHotkeySequenceRecorder.d.cts.map

package/dist/createHotkeySequenceRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequenceRecorder.js","names":[],"sources":["../src/createHotkeySequenceRecorder.ts"],"sourcesContent":["import { createEffect, onCleanup } from 'solid-js'\nimport { useSelector } from '@tanstack/solid-store'\nimport { HotkeySequenceRecorder } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type {\n  HotkeySequence,\n  HotkeySequenceRecorderOptions,\n} from '@tanstack/hotkeys'\n\nexport interface SolidHotkeySequenceRecorder {\n  isRecording: () => boolean\n  steps: () => HotkeySequence\n  recordedSequence: () => HotkeySequence | null\n  startRecording: () => void\n  stopRecording: () => void\n  cancelRecording: () => void\n  commitRecording: () => void\n}\n\n/**\n * SolidJS primitive for recording multi-chord sequences (Vim-style shortcuts).\n */\nexport function createHotkeySequenceRecorder(\n  options:\n    | HotkeySequenceRecorderOptions\n    | (() => HotkeySequenceRecorderOptions),\n): SolidHotkeySequenceRecorder {\n  const defaultOptions = useDefaultHotkeysOptions()\n\n  const resolvedOptions = typeof options === 'function' ? options() : options\n  const mergedOptions = {\n    ...defaultOptions.hotkeySequenceRecorder,\n    ...resolvedOptions,\n  } as HotkeySequenceRecorderOptions\n\n  const recorder = new HotkeySequenceRecorder(mergedOptions)\n\n  const isRecording = useSelector(recorder.store, (state) => state.isRecording)\n  const steps = useSelector(recorder.store, (state) => state.steps)\n  const recordedSequence = useSelector(\n    recorder.store,\n    (state) => state.recordedSequence,\n  )\n\n  createEffect(() => {\n    const resolved = typeof options === 'function' ? options() : options\n    recorder.setOptions({\n      ...defaultOptions.hotkeySequenceRecorder,\n      ...resolved,\n    } as HotkeySequenceRecorderOptions)\n  })\n\n  onCleanup(() => {\n    recorder.destroy()\n  })\n\n  return {\n    isRecording,\n    steps,\n    recordedSequence,\n    startRecording: () => recorder.start(),\n    stopRecording: () => recorder.stop(),\n    cancelRecording: () => recorder.cancel(),\n    commitRecording: () => recorder.commit(),\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,6BACd,SAG6B;CAC7B,MAAM,iBAAiB,0BAA0B;CAEjD,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;CAMpE,MAAM,WAAW,IAAI,uBALC;EACpB,GAAG,eAAe;EAClB,GAAG;EACJ,CAEyD;CAE1D,MAAM,cAAc,YAAY,SAAS,QAAQ,UAAU,MAAM,YAAY;CAC7E,MAAM,QAAQ,YAAY,SAAS,QAAQ,UAAU,MAAM,MAAM;CACjE,MAAM,mBAAmB,YACvB,SAAS,QACR,UAAU,MAAM,iBAClB;AAED,oBAAmB;EACjB,MAAM,WAAW,OAAO,YAAY,aAAa,SAAS,GAAG;AAC7D,WAAS,WAAW;GAClB,GAAG,eAAe;GAClB,GAAG;GACJ,CAAkC;GACnC;AAEF,iBAAgB;AACd,WAAS,SAAS;GAClB;AAEF,QAAO;EACL;EACA;EACA;EACA,sBAAsB,SAAS,OAAO;EACtC,qBAAqB,SAAS,MAAM;EACpC,uBAAuB,SAAS,QAAQ;EACxC,uBAAuB,SAAS,QAAQ;EACzC"}

package/dist/createHotkeySequences.cjs

@@ -1,112 +0,0 @@
-const require_HotkeysProvider = require('./HotkeysProvider.cjs');
-let _tanstack_hotkeys = require("@tanstack/hotkeys");
-let solid_js = require("solid-js");
-
-//#region src/createHotkeySequences.ts
-/**
-* SolidJS primitive for registering multiple keyboard shortcut sequences at once (Vim-style).
-*
-* Uses the singleton SequenceManager. Accepts a dynamic array of definitions, or accessors,
-* so you can react to variable-length lists.
-*
-* Options are merged in this order:
-* HotkeysProvider defaults < commonOptions < per-definition options
-*
-* Definitions with an empty `sequence` are skipped (no registration).
-*
-* @param sequences - Array of sequence definitions, or accessor returning them
-* @param commonOptions - Shared options for all sequences, or accessor
-*
-* @example
-* ```tsx
-* function VimPalette() {
-*   createHotkeySequences([
-*     { sequence: ['G', 'G'], callback: () => scrollToTop() },
-*     { sequence: ['D', 'D'], callback: () => deleteLine() },
-*   ])
-* }
-* ```
-*
-* @example
-* ```tsx
-* function Dynamic(props) {
-*   createHotkeySequences(
-*     () => props.items.map((item) => ({
-*       sequence: item.chords,
-*       callback: item.action,
-*       options: { enabled: item.enabled },
-*     })),
-*     { preventDefault: true },
-*   )
-* }
-* ```
-*/
-function createHotkeySequences(sequences, commonOptions = {}) {
-	const defaultOptions = require_HotkeysProvider.useDefaultHotkeysOptions();
-	const manager = (0, _tanstack_hotkeys.getSequenceManager)();
-	const registrations = /* @__PURE__ */ new Map();
-	(0, solid_js.onCleanup)(() => {
-		for (const { handle } of registrations.values()) if (handle.isActive) handle.unregister();
-		registrations.clear();
-	});
-	(0, solid_js.createEffect)(() => {
-		const resolved = typeof sequences === "function" ? sequences() : sequences;
-		const resolvedCommonOptions = typeof commonOptions === "function" ? commonOptions() : commonOptions;
-		const nextKeys = /* @__PURE__ */ new Set();
-		const prepared = [];
-		for (let i = 0; i < resolved.length; i++) {
-			const def = resolved[i];
-			const resolvedDefOptions = def.options ?? {};
-			const mergedOptions = {
-				...defaultOptions.hotkeySequence,
-				...resolvedCommonOptions,
-				...resolvedDefOptions
-			};
-			if (def.sequence.length === 0) continue;
-			const sequenceString = (0, _tanstack_hotkeys.formatHotkeySequence)(def.sequence);
-			const resolvedTarget = "target" in mergedOptions ? mergedOptions.target ?? null : typeof document !== "undefined" ? document : null;
-			if (!resolvedTarget) continue;
-			const registrationKey = `${i}:${sequenceString}`;
-			nextKeys.add(registrationKey);
-			prepared.push({
-				registrationKey,
-				def,
-				mergedOptions,
-				sequenceString,
-				resolvedTarget
-			});
-		}
-		(0, solid_js.untrack)(() => {
-			for (const [key, record] of [...registrations.entries()]) if (!nextKeys.has(key)) {
-				if (record.handle.isActive) record.handle.unregister();
-				registrations.delete(key);
-			}
-			for (const p of prepared) {
-				const existing = registrations.get(p.registrationKey);
-				if (existing?.handle.isActive && existing.target === p.resolvedTarget) {
-					existing.handle.callback = p.def.callback;
-					const { target: _target, ...optionsWithoutTarget } = p.mergedOptions;
-					existing.handle.setOptions(optionsWithoutTarget);
-					continue;
-				}
-				if (existing) {
-					if (existing.handle.isActive) existing.handle.unregister();
-					registrations.delete(p.registrationKey);
-				}
-				const { target: _target, ...optionsWithoutTarget } = p.mergedOptions;
-				const handle = manager.register(p.def.sequence, p.def.callback, {
-					...optionsWithoutTarget,
-					target: p.resolvedTarget
-				});
-				registrations.set(p.registrationKey, {
-					handle,
-					target: p.resolvedTarget
-				});
-			}
-		});
-	});
-}
-
-//#endregion
-exports.createHotkeySequences = createHotkeySequences;
-//# sourceMappingURL=createHotkeySequences.cjs.map

package/dist/createHotkeySequences.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequences.cjs","names":["useDefaultHotkeysOptions"],"sources":["../src/createHotkeySequences.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from 'solid-js'\nimport { formatHotkeySequence, getSequenceManager } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type { CreateHotkeySequenceOptions } from './createHotkeySequence'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceRegistrationHandle,\n} from '@tanstack/hotkeys'\n\n/**\n * A single sequence definition for use with `createHotkeySequences`.\n */\nexport interface CreateHotkeySequenceDefinition {\n  /** Array of hotkey strings that form the sequence */\n  sequence: HotkeySequence\n  /** The function to call when the sequence is completed */\n  callback: HotkeyCallback\n  /** Per-sequence options (merged on top of commonOptions) */\n  options?: CreateHotkeySequenceOptions\n}\n\n/**\n * SolidJS primitive for registering multiple keyboard shortcut sequences at once (Vim-style).\n *\n * Uses the singleton SequenceManager. Accepts a dynamic array of definitions, or accessors,\n * so you can react to variable-length lists.\n *\n * Options are merged in this order:\n * HotkeysProvider defaults < commonOptions < per-definition options\n *\n * Definitions with an empty `sequence` are skipped (no registration).\n *\n * @param sequences - Array of sequence definitions, or accessor returning them\n * @param commonOptions - Shared options for all sequences, or accessor\n *\n * @example\n * ```tsx\n * function VimPalette() {\n *   createHotkeySequences([\n *     { sequence: ['G', 'G'], callback: () => scrollToTop() },\n *     { sequence: ['D', 'D'], callback: () => deleteLine() },\n *   ])\n * }\n * ```\n *\n * @example\n * ```tsx\n * function Dynamic(props) {\n *   createHotkeySequences(\n *     () => props.items.map((item) => ({\n *       sequence: item.chords,\n *       callback: item.action,\n *       options: { enabled: item.enabled },\n *     })),\n *     { preventDefault: true },\n *   )\n * }\n * ```\n */\nexport function createHotkeySequences(\n  sequences:\n    | Array<CreateHotkeySequenceDefinition>\n    | (() => Array<CreateHotkeySequenceDefinition>),\n  commonOptions:\n    | CreateHotkeySequenceOptions\n    | (() => CreateHotkeySequenceOptions) = {},\n): void {\n  type RegistrationRecord = {\n    handle: SequenceRegistrationHandle\n    target: Document | HTMLElement | Window\n  }\n\n  const defaultOptions = useDefaultHotkeysOptions()\n  const manager = getSequenceManager()\n\n  const registrations = new Map<string, RegistrationRecord>()\n\n  onCleanup(() => {\n    for (const { handle } of registrations.values()) {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    }\n    registrations.clear()\n  })\n\n  createEffect(() => {\n    const resolved = typeof sequences === 'function' ? sequences() : sequences\n    const resolvedCommonOptions =\n      typeof commonOptions === 'function' ? commonOptions() : commonOptions\n\n    const nextKeys = new Set<string>()\n    const prepared: Array<{\n      registrationKey: string\n      def: CreateHotkeySequenceDefinition\n      mergedOptions: CreateHotkeySequenceOptions\n      sequenceString: string\n      resolvedTarget: Document | HTMLElement | Window\n    }> = []\n\n    for (let i = 0; i < resolved.length; i++) {\n      const def = resolved[i]!\n      const resolvedDefOptions = def.options ?? {}\n\n      const mergedOptions = {\n        ...defaultOptions.hotkeySequence,\n        ...resolvedCommonOptions,\n        ...resolvedDefOptions,\n      } as CreateHotkeySequenceOptions\n\n      if (def.sequence.length === 0) {\n        continue\n      }\n\n      const sequenceString = formatHotkeySequence(def.sequence)\n\n      const resolvedTarget =\n        'target' in mergedOptions\n          ? (mergedOptions.target ?? null)\n          : typeof document !== 'undefined'\n            ? document\n            : null\n\n      if (!resolvedTarget) {\n        continue\n      }\n\n      const registrationKey = `${i}:${sequenceString}`\n      nextKeys.add(registrationKey)\n      prepared.push({\n        registrationKey,\n        def,\n        mergedOptions,\n        sequenceString,\n        resolvedTarget,\n      })\n    }\n\n    // Untrack store mutations so that registering/updating sequences doesn't\n    // create a circular reactive dependency when createHotkeyRegistrations\n    // subscribes to the same store.\n    untrack(() => {\n      for (const [key, record] of [...registrations.entries()]) {\n        if (!nextKeys.has(key)) {\n          if (record.handle.isActive) {\n            record.handle.unregister()\n          }\n          registrations.delete(key)\n        }\n      }\n\n      for (const p of prepared) {\n        const existing = registrations.get(p.registrationKey)\n        if (existing?.handle.isActive && existing.target === p.resolvedTarget) {\n          existing.handle.callback = p.def.callback\n          const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n          existing.handle.setOptions(optionsWithoutTarget)\n          continue\n        }\n\n        if (existing) {\n          if (existing.handle.isActive) {\n            existing.handle.unregister()\n          }\n          registrations.delete(p.registrationKey)\n        }\n\n        const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n        const handle = manager.register(p.def.sequence, p.def.callback, {\n          ...optionsWithoutTarget,\n          target: p.resolvedTarget,\n        })\n        registrations.set(p.registrationKey, {\n          handle,\n          target: p.resolvedTarget,\n        })\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,sBACd,WAGA,gBAE0C,EAAE,EACtC;CAMN,MAAM,iBAAiBA,kDAA0B;CACjD,MAAM,qDAA8B;CAEpC,MAAM,gCAAgB,IAAI,KAAiC;AAE3D,+BAAgB;AACd,OAAK,MAAM,EAAE,YAAY,cAAc,QAAQ,CAC7C,KAAI,OAAO,SACT,QAAO,YAAY;AAGvB,gBAAc,OAAO;GACrB;AAEF,kCAAmB;EACjB,MAAM,WAAW,OAAO,cAAc,aAAa,WAAW,GAAG;EACjE,MAAM,wBACJ,OAAO,kBAAkB,aAAa,eAAe,GAAG;EAE1D,MAAM,2BAAW,IAAI,KAAa;EAClC,MAAM,WAMD,EAAE;AAEP,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;GACxC,MAAM,MAAM,SAAS;GACrB,MAAM,qBAAqB,IAAI,WAAW,EAAE;GAE5C,MAAM,gBAAgB;IACpB,GAAG,eAAe;IAClB,GAAG;IACH,GAAG;IACJ;AAED,OAAI,IAAI,SAAS,WAAW,EAC1B;GAGF,MAAM,6DAAsC,IAAI,SAAS;GAEzD,MAAM,iBACJ,YAAY,gBACP,cAAc,UAAU,OACzB,OAAO,aAAa,cAClB,WACA;AAER,OAAI,CAAC,eACH;GAGF,MAAM,kBAAkB,GAAG,EAAE,GAAG;AAChC,YAAS,IAAI,gBAAgB;AAC7B,YAAS,KAAK;IACZ;IACA;IACA;IACA;IACA;IACD,CAAC;;AAMJ,8BAAc;AACZ,QAAK,MAAM,CAAC,KAAK,WAAW,CAAC,GAAG,cAAc,SAAS,CAAC,CACtD,KAAI,CAAC,SAAS,IAAI,IAAI,EAAE;AACtB,QAAI,OAAO,OAAO,SAChB,QAAO,OAAO,YAAY;AAE5B,kBAAc,OAAO,IAAI;;AAI7B,QAAK,MAAM,KAAK,UAAU;IACxB,MAAM,WAAW,cAAc,IAAI,EAAE,gBAAgB;AACrD,QAAI,UAAU,OAAO,YAAY,SAAS,WAAW,EAAE,gBAAgB;AACrE,cAAS,OAAO,WAAW,EAAE,IAAI;KACjC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;AACvD,cAAS,OAAO,WAAW,qBAAqB;AAChD;;AAGF,QAAI,UAAU;AACZ,SAAI,SAAS,OAAO,SAClB,UAAS,OAAO,YAAY;AAE9B,mBAAc,OAAO,EAAE,gBAAgB;;IAGzC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;IACvD,MAAM,SAAS,QAAQ,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,UAAU;KAC9D,GAAG;KACH,QAAQ,EAAE;KACX,CAAC;AACF,kBAAc,IAAI,EAAE,iBAAiB;KACnC;KACA,QAAQ,EAAE;KACX,CAAC;;IAEJ;GACF"}

package/dist/createHotkeySequences.d.cts

@@ -1,57 +0,0 @@
-import { CreateHotkeySequenceOptions } from "./createHotkeySequence.cjs";
-import { HotkeyCallback, HotkeySequence } from "@tanstack/hotkeys";
-
-//#region src/createHotkeySequences.d.ts
-/**
- * A single sequence definition for use with `createHotkeySequences`.
- */
-interface CreateHotkeySequenceDefinition {
-  /** Array of hotkey strings that form the sequence */
-  sequence: HotkeySequence;
-  /** The function to call when the sequence is completed */
-  callback: HotkeyCallback;
-  /** Per-sequence options (merged on top of commonOptions) */
-  options?: CreateHotkeySequenceOptions;
-}
-/**
- * SolidJS primitive for registering multiple keyboard shortcut sequences at once (Vim-style).
- *
- * Uses the singleton SequenceManager. Accepts a dynamic array of definitions, or accessors,
- * so you can react to variable-length lists.
- *
- * Options are merged in this order:
- * HotkeysProvider defaults < commonOptions < per-definition options
- *
- * Definitions with an empty `sequence` are skipped (no registration).
- *
- * @param sequences - Array of sequence definitions, or accessor returning them
- * @param commonOptions - Shared options for all sequences, or accessor
- *
- * @example
- * ```tsx
- * function VimPalette() {
- *   createHotkeySequences([
- *     { sequence: ['G', 'G'], callback: () => scrollToTop() },
- *     { sequence: ['D', 'D'], callback: () => deleteLine() },
- *   ])
- * }
- * ```
- *
- * @example
- * ```tsx
- * function Dynamic(props) {
- *   createHotkeySequences(
- *     () => props.items.map((item) => ({
- *       sequence: item.chords,
- *       callback: item.action,
- *       options: { enabled: item.enabled },
- *     })),
- *     { preventDefault: true },
- *   )
- * }
- * ```
- */
-declare function createHotkeySequences(sequences: Array<CreateHotkeySequenceDefinition> | (() => Array<CreateHotkeySequenceDefinition>), commonOptions?: CreateHotkeySequenceOptions | (() => CreateHotkeySequenceOptions)): void;
-//#endregion
-export { CreateHotkeySequenceDefinition, createHotkeySequences };
-//# sourceMappingURL=createHotkeySequences.d.cts.map

package/dist/createHotkeySequences.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeySequences.js","names":[],"sources":["../src/createHotkeySequences.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from 'solid-js'\nimport { formatHotkeySequence, getSequenceManager } from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type { CreateHotkeySequenceOptions } from './createHotkeySequence'\nimport type {\n  HotkeyCallback,\n  HotkeySequence,\n  SequenceRegistrationHandle,\n} from '@tanstack/hotkeys'\n\n/**\n * A single sequence definition for use with `createHotkeySequences`.\n */\nexport interface CreateHotkeySequenceDefinition {\n  /** Array of hotkey strings that form the sequence */\n  sequence: HotkeySequence\n  /** The function to call when the sequence is completed */\n  callback: HotkeyCallback\n  /** Per-sequence options (merged on top of commonOptions) */\n  options?: CreateHotkeySequenceOptions\n}\n\n/**\n * SolidJS primitive for registering multiple keyboard shortcut sequences at once (Vim-style).\n *\n * Uses the singleton SequenceManager. Accepts a dynamic array of definitions, or accessors,\n * so you can react to variable-length lists.\n *\n * Options are merged in this order:\n * HotkeysProvider defaults < commonOptions < per-definition options\n *\n * Definitions with an empty `sequence` are skipped (no registration).\n *\n * @param sequences - Array of sequence definitions, or accessor returning them\n * @param commonOptions - Shared options for all sequences, or accessor\n *\n * @example\n * ```tsx\n * function VimPalette() {\n *   createHotkeySequences([\n *     { sequence: ['G', 'G'], callback: () => scrollToTop() },\n *     { sequence: ['D', 'D'], callback: () => deleteLine() },\n *   ])\n * }\n * ```\n *\n * @example\n * ```tsx\n * function Dynamic(props) {\n *   createHotkeySequences(\n *     () => props.items.map((item) => ({\n *       sequence: item.chords,\n *       callback: item.action,\n *       options: { enabled: item.enabled },\n *     })),\n *     { preventDefault: true },\n *   )\n * }\n * ```\n */\nexport function createHotkeySequences(\n  sequences:\n    | Array<CreateHotkeySequenceDefinition>\n    | (() => Array<CreateHotkeySequenceDefinition>),\n  commonOptions:\n    | CreateHotkeySequenceOptions\n    | (() => CreateHotkeySequenceOptions) = {},\n): void {\n  type RegistrationRecord = {\n    handle: SequenceRegistrationHandle\n    target: Document | HTMLElement | Window\n  }\n\n  const defaultOptions = useDefaultHotkeysOptions()\n  const manager = getSequenceManager()\n\n  const registrations = new Map<string, RegistrationRecord>()\n\n  onCleanup(() => {\n    for (const { handle } of registrations.values()) {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    }\n    registrations.clear()\n  })\n\n  createEffect(() => {\n    const resolved = typeof sequences === 'function' ? sequences() : sequences\n    const resolvedCommonOptions =\n      typeof commonOptions === 'function' ? commonOptions() : commonOptions\n\n    const nextKeys = new Set<string>()\n    const prepared: Array<{\n      registrationKey: string\n      def: CreateHotkeySequenceDefinition\n      mergedOptions: CreateHotkeySequenceOptions\n      sequenceString: string\n      resolvedTarget: Document | HTMLElement | Window\n    }> = []\n\n    for (let i = 0; i < resolved.length; i++) {\n      const def = resolved[i]!\n      const resolvedDefOptions = def.options ?? {}\n\n      const mergedOptions = {\n        ...defaultOptions.hotkeySequence,\n        ...resolvedCommonOptions,\n        ...resolvedDefOptions,\n      } as CreateHotkeySequenceOptions\n\n      if (def.sequence.length === 0) {\n        continue\n      }\n\n      const sequenceString = formatHotkeySequence(def.sequence)\n\n      const resolvedTarget =\n        'target' in mergedOptions\n          ? (mergedOptions.target ?? null)\n          : typeof document !== 'undefined'\n            ? document\n            : null\n\n      if (!resolvedTarget) {\n        continue\n      }\n\n      const registrationKey = `${i}:${sequenceString}`\n      nextKeys.add(registrationKey)\n      prepared.push({\n        registrationKey,\n        def,\n        mergedOptions,\n        sequenceString,\n        resolvedTarget,\n      })\n    }\n\n    // Untrack store mutations so that registering/updating sequences doesn't\n    // create a circular reactive dependency when createHotkeyRegistrations\n    // subscribes to the same store.\n    untrack(() => {\n      for (const [key, record] of [...registrations.entries()]) {\n        if (!nextKeys.has(key)) {\n          if (record.handle.isActive) {\n            record.handle.unregister()\n          }\n          registrations.delete(key)\n        }\n      }\n\n      for (const p of prepared) {\n        const existing = registrations.get(p.registrationKey)\n        if (existing?.handle.isActive && existing.target === p.resolvedTarget) {\n          existing.handle.callback = p.def.callback\n          const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n          existing.handle.setOptions(optionsWithoutTarget)\n          continue\n        }\n\n        if (existing) {\n          if (existing.handle.isActive) {\n            existing.handle.unregister()\n          }\n          registrations.delete(p.registrationKey)\n        }\n\n        const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n        const handle = manager.register(p.def.sequence, p.def.callback, {\n          ...optionsWithoutTarget,\n          target: p.resolvedTarget,\n        })\n        registrations.set(p.registrationKey, {\n          handle,\n          target: p.resolvedTarget,\n        })\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,sBACd,WAGA,gBAE0C,EAAE,EACtC;CAMN,MAAM,iBAAiB,0BAA0B;CACjD,MAAM,UAAU,oBAAoB;CAEpC,MAAM,gCAAgB,IAAI,KAAiC;AAE3D,iBAAgB;AACd,OAAK,MAAM,EAAE,YAAY,cAAc,QAAQ,CAC7C,KAAI,OAAO,SACT,QAAO,YAAY;AAGvB,gBAAc,OAAO;GACrB;AAEF,oBAAmB;EACjB,MAAM,WAAW,OAAO,cAAc,aAAa,WAAW,GAAG;EACjE,MAAM,wBACJ,OAAO,kBAAkB,aAAa,eAAe,GAAG;EAE1D,MAAM,2BAAW,IAAI,KAAa;EAClC,MAAM,WAMD,EAAE;AAEP,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;GACxC,MAAM,MAAM,SAAS;GACrB,MAAM,qBAAqB,IAAI,WAAW,EAAE;GAE5C,MAAM,gBAAgB;IACpB,GAAG,eAAe;IAClB,GAAG;IACH,GAAG;IACJ;AAED,OAAI,IAAI,SAAS,WAAW,EAC1B;GAGF,MAAM,iBAAiB,qBAAqB,IAAI,SAAS;GAEzD,MAAM,iBACJ,YAAY,gBACP,cAAc,UAAU,OACzB,OAAO,aAAa,cAClB,WACA;AAER,OAAI,CAAC,eACH;GAGF,MAAM,kBAAkB,GAAG,EAAE,GAAG;AAChC,YAAS,IAAI,gBAAgB;AAC7B,YAAS,KAAK;IACZ;IACA;IACA;IACA;IACA;IACD,CAAC;;AAMJ,gBAAc;AACZ,QAAK,MAAM,CAAC,KAAK,WAAW,CAAC,GAAG,cAAc,SAAS,CAAC,CACtD,KAAI,CAAC,SAAS,IAAI,IAAI,EAAE;AACtB,QAAI,OAAO,OAAO,SAChB,QAAO,OAAO,YAAY;AAE5B,kBAAc,OAAO,IAAI;;AAI7B,QAAK,MAAM,KAAK,UAAU;IACxB,MAAM,WAAW,cAAc,IAAI,EAAE,gBAAgB;AACrD,QAAI,UAAU,OAAO,YAAY,SAAS,WAAW,EAAE,gBAAgB;AACrE,cAAS,OAAO,WAAW,EAAE,IAAI;KACjC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;AACvD,cAAS,OAAO,WAAW,qBAAqB;AAChD;;AAGF,QAAI,UAAU;AACZ,SAAI,SAAS,OAAO,SAClB,UAAS,OAAO,YAAY;AAE9B,mBAAc,OAAO,EAAE,gBAAgB;;IAGzC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;IACvD,MAAM,SAAS,QAAQ,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,UAAU;KAC9D,GAAG;KACH,QAAQ,EAAE;KACX,CAAC;AACF,kBAAc,IAAI,EAAE,iBAAiB;KACnC;KACA,QAAQ,EAAE;KACX,CAAC;;IAEJ;GACF"}

package/dist/createHotkeys.cjs

@@ -1,112 +0,0 @@
-const require_HotkeysProvider = require('./HotkeysProvider.cjs');
-let _tanstack_hotkeys = require("@tanstack/hotkeys");
-let solid_js = require("solid-js");
-
-//#region src/createHotkeys.ts
-/**
-* SolidJS primitive for registering multiple keyboard hotkeys at once.
-*
-* Uses the singleton HotkeyManager for efficient event handling.
-* Accepts a dynamic array of hotkey definitions, making it safe to use
-* with variable-length lists.
-*
-* Options are merged in this order:
-* HotkeysProvider defaults < commonOptions < per-definition options
-*
-* @param hotkeys - Array of hotkey definitions, or accessor returning them
-* @param commonOptions - Shared options applied to all hotkeys, or accessor
-*
-* @example
-* ```tsx
-* function Editor() {
-*   createHotkeys([
-*     { hotkey: 'Mod+S', callback: () => save() },
-*     { hotkey: 'Mod+Z', callback: () => undo() },
-*     { hotkey: 'Escape', callback: () => close() },
-*   ])
-* }
-* ```
-*
-* @example
-* ```tsx
-* function MenuShortcuts(props) {
-*   createHotkeys(
-*     () => props.items.map((item) => ({
-*       hotkey: item.shortcut,
-*       callback: item.action,
-*       options: { enabled: item.enabled },
-*     })),
-*     { preventDefault: true },
-*   )
-* }
-* ```
-*/
-function createHotkeys(hotkeys, commonOptions = {}) {
-	const defaultOptions = require_HotkeysProvider.useDefaultHotkeysOptions();
-	const manager = (0, _tanstack_hotkeys.getHotkeyManager)();
-	const registrations = /* @__PURE__ */ new Map();
-	(0, solid_js.onCleanup)(() => {
-		for (const { handle } of registrations.values()) if (handle.isActive) handle.unregister();
-		registrations.clear();
-	});
-	(0, solid_js.createEffect)(() => {
-		const resolvedHotkeys = typeof hotkeys === "function" ? hotkeys() : hotkeys;
-		const resolvedCommonOptions = typeof commonOptions === "function" ? commonOptions() : commonOptions;
-		const nextKeys = /* @__PURE__ */ new Set();
-		const prepared = [];
-		for (let i = 0; i < resolvedHotkeys.length; i++) {
-			const def = resolvedHotkeys[i];
-			const resolvedDefOptions = def.options ?? {};
-			const mergedOptions = {
-				...defaultOptions.hotkey,
-				...resolvedCommonOptions,
-				...resolvedDefOptions
-			};
-			const platform = mergedOptions.platform ?? (0, _tanstack_hotkeys.detectPlatform)();
-			const hotkeyString = (0, _tanstack_hotkeys.normalizeRegisterableHotkey)(def.hotkey, platform);
-			const resolvedTarget = "target" in mergedOptions ? mergedOptions.target ?? null : typeof document !== "undefined" ? document : null;
-			if (!resolvedTarget) continue;
-			const registrationKey = `${i}:${hotkeyString}`;
-			nextKeys.add(registrationKey);
-			prepared.push({
-				registrationKey,
-				def,
-				mergedOptions,
-				hotkeyString,
-				resolvedTarget
-			});
-		}
-		(0, solid_js.untrack)(() => {
-			for (const [key, record] of [...registrations.entries()]) if (!nextKeys.has(key)) {
-				if (record.handle.isActive) record.handle.unregister();
-				registrations.delete(key);
-			}
-			for (const p of prepared) {
-				const existing = registrations.get(p.registrationKey);
-				if (existing?.handle.isActive && existing.target === p.resolvedTarget) {
-					existing.handle.callback = p.def.callback;
-					const { target: _target, ...optionsWithoutTarget } = p.mergedOptions;
-					existing.handle.setOptions(optionsWithoutTarget);
-					continue;
-				}
-				if (existing) {
-					if (existing.handle.isActive) existing.handle.unregister();
-					registrations.delete(p.registrationKey);
-				}
-				const { target: _target, ...optionsWithoutTarget } = p.mergedOptions;
-				const handle = manager.register(p.hotkeyString, p.def.callback, {
-					...optionsWithoutTarget,
-					target: p.resolvedTarget
-				});
-				registrations.set(p.registrationKey, {
-					handle,
-					target: p.resolvedTarget
-				});
-			}
-		});
-	});
-}
-
-//#endregion
-exports.createHotkeys = createHotkeys;
-//# sourceMappingURL=createHotkeys.cjs.map

package/dist/createHotkeys.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHotkeys.cjs","names":["useDefaultHotkeysOptions"],"sources":["../src/createHotkeys.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from 'solid-js'\nimport {\n  detectPlatform,\n  getHotkeyManager,\n  normalizeRegisterableHotkey,\n} from '@tanstack/hotkeys'\nimport { useDefaultHotkeysOptions } from './HotkeysProvider'\nimport type { CreateHotkeyOptions } from './createHotkey'\nimport type {\n  Hotkey,\n  HotkeyCallback,\n  HotkeyRegistrationHandle,\n  RegisterableHotkey,\n} from '@tanstack/hotkeys'\n\n/**\n * A single hotkey definition for use with `createHotkeys`.\n */\nexport interface CreateHotkeyDefinition {\n  /** The hotkey string (e.g., 'Mod+S', 'Escape') or RawHotkey object */\n  hotkey: RegisterableHotkey\n  /** The function to call when the hotkey is pressed */\n  callback: HotkeyCallback\n  /** Per-hotkey options (merged on top of commonOptions) */\n  options?: CreateHotkeyOptions\n}\n\n/**\n * SolidJS primitive for registering multiple keyboard hotkeys at once.\n *\n * Uses the singleton HotkeyManager for efficient event handling.\n * Accepts a dynamic array of hotkey definitions, making it safe to use\n * with variable-length lists.\n *\n * Options are merged in this order:\n * HotkeysProvider defaults < commonOptions < per-definition options\n *\n * @param hotkeys - Array of hotkey definitions, or accessor returning them\n * @param commonOptions - Shared options applied to all hotkeys, or accessor\n *\n * @example\n * ```tsx\n * function Editor() {\n *   createHotkeys([\n *     { hotkey: 'Mod+S', callback: () => save() },\n *     { hotkey: 'Mod+Z', callback: () => undo() },\n *     { hotkey: 'Escape', callback: () => close() },\n *   ])\n * }\n * ```\n *\n * @example\n * ```tsx\n * function MenuShortcuts(props) {\n *   createHotkeys(\n *     () => props.items.map((item) => ({\n *       hotkey: item.shortcut,\n *       callback: item.action,\n *       options: { enabled: item.enabled },\n *     })),\n *     { preventDefault: true },\n *   )\n * }\n * ```\n */\nexport function createHotkeys(\n  hotkeys:\n    | Array<CreateHotkeyDefinition>\n    | (() => Array<CreateHotkeyDefinition>),\n  commonOptions: CreateHotkeyOptions | (() => CreateHotkeyOptions) = {},\n): void {\n  type RegistrationRecord = {\n    handle: HotkeyRegistrationHandle\n    target: Document | HTMLElement | Window\n  }\n\n  const defaultOptions = useDefaultHotkeysOptions()\n  const manager = getHotkeyManager()\n\n  const registrations = new Map<string, RegistrationRecord>()\n\n  // Clean up only when this component/scope disposes — not before every effect\n  // re-run. An inner `onCleanup` inside `createEffect` runs whenever reactive\n  // deps change (e.g. dynamic hotkey list), which unregistered every hotkey and\n  // re-registered them, flooding the manager store and could freeze the tab.\n  onCleanup(() => {\n    for (const { handle } of registrations.values()) {\n      if (handle.isActive) {\n        handle.unregister()\n      }\n    }\n    registrations.clear()\n  })\n\n  createEffect(() => {\n    const resolvedHotkeys = typeof hotkeys === 'function' ? hotkeys() : hotkeys\n    const resolvedCommonOptions =\n      typeof commonOptions === 'function' ? commonOptions() : commonOptions\n\n    const nextKeys = new Set<string>()\n    const prepared: Array<{\n      registrationKey: string\n      def: CreateHotkeyDefinition\n      mergedOptions: CreateHotkeyOptions\n      hotkeyString: Hotkey\n      resolvedTarget: Document | HTMLElement | Window\n    }> = []\n\n    for (let i = 0; i < resolvedHotkeys.length; i++) {\n      const def = resolvedHotkeys[i]!\n      const resolvedDefOptions = def.options ?? {}\n\n      const mergedOptions = {\n        ...defaultOptions.hotkey,\n        ...resolvedCommonOptions,\n        ...resolvedDefOptions,\n      } as CreateHotkeyOptions\n\n      const platform = mergedOptions.platform ?? detectPlatform()\n      const hotkeyString = normalizeRegisterableHotkey(def.hotkey, platform)\n\n      const resolvedTarget =\n        'target' in mergedOptions\n          ? (mergedOptions.target ?? null)\n          : typeof document !== 'undefined'\n            ? document\n            : null\n\n      if (!resolvedTarget) {\n        continue\n      }\n\n      const registrationKey = `${i}:${hotkeyString}`\n      nextKeys.add(registrationKey)\n      prepared.push({\n        registrationKey,\n        def,\n        mergedOptions,\n        hotkeyString,\n        resolvedTarget,\n      })\n    }\n\n    // Untrack store mutations so that registering/updating hotkeys doesn't\n    // create a circular reactive dependency when createHotkeyRegistrations\n    // subscribes to the same store.\n    untrack(() => {\n      // Drop stale keys first so list index shifts don't briefly double-register\n      // the same hotkey+target (conflictBehavior: 'warn' + devtools can loop).\n      for (const [key, record] of [...registrations.entries()]) {\n        if (!nextKeys.has(key)) {\n          if (record.handle.isActive) {\n            record.handle.unregister()\n          }\n          registrations.delete(key)\n        }\n      }\n\n      for (const p of prepared) {\n        const existing = registrations.get(p.registrationKey)\n        if (existing?.handle.isActive && existing.target === p.resolvedTarget) {\n          existing.handle.callback = p.def.callback\n          const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n          existing.handle.setOptions(optionsWithoutTarget)\n          continue\n        }\n\n        if (existing) {\n          if (existing.handle.isActive) {\n            existing.handle.unregister()\n          }\n          registrations.delete(p.registrationKey)\n        }\n\n        const { target: _target, ...optionsWithoutTarget } = p.mergedOptions\n        const handle = manager.register(p.hotkeyString, p.def.callback, {\n          ...optionsWithoutTarget,\n          target: p.resolvedTarget,\n        })\n        registrations.set(p.registrationKey, {\n          handle,\n          target: p.resolvedTarget,\n        })\n      }\n    })\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,cACd,SAGA,gBAAmE,EAAE,EAC/D;CAMN,MAAM,iBAAiBA,kDAA0B;CACjD,MAAM,mDAA4B;CAElC,MAAM,gCAAgB,IAAI,KAAiC;AAM3D,+BAAgB;AACd,OAAK,MAAM,EAAE,YAAY,cAAc,QAAQ,CAC7C,KAAI,OAAO,SACT,QAAO,YAAY;AAGvB,gBAAc,OAAO;GACrB;AAEF,kCAAmB;EACjB,MAAM,kBAAkB,OAAO,YAAY,aAAa,SAAS,GAAG;EACpE,MAAM,wBACJ,OAAO,kBAAkB,aAAa,eAAe,GAAG;EAE1D,MAAM,2BAAW,IAAI,KAAa;EAClC,MAAM,WAMD,EAAE;AAEP,OAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,KAAK;GAC/C,MAAM,MAAM,gBAAgB;GAC5B,MAAM,qBAAqB,IAAI,WAAW,EAAE;GAE5C,MAAM,gBAAgB;IACpB,GAAG,eAAe;IAClB,GAAG;IACH,GAAG;IACJ;GAED,MAAM,WAAW,cAAc,mDAA4B;GAC3D,MAAM,kEAA2C,IAAI,QAAQ,SAAS;GAEtE,MAAM,iBACJ,YAAY,gBACP,cAAc,UAAU,OACzB,OAAO,aAAa,cAClB,WACA;AAER,OAAI,CAAC,eACH;GAGF,MAAM,kBAAkB,GAAG,EAAE,GAAG;AAChC,YAAS,IAAI,gBAAgB;AAC7B,YAAS,KAAK;IACZ;IACA;IACA;IACA;IACA;IACD,CAAC;;AAMJ,8BAAc;AAGZ,QAAK,MAAM,CAAC,KAAK,WAAW,CAAC,GAAG,cAAc,SAAS,CAAC,CACtD,KAAI,CAAC,SAAS,IAAI,IAAI,EAAE;AACtB,QAAI,OAAO,OAAO,SAChB,QAAO,OAAO,YAAY;AAE5B,kBAAc,OAAO,IAAI;;AAI7B,QAAK,MAAM,KAAK,UAAU;IACxB,MAAM,WAAW,cAAc,IAAI,EAAE,gBAAgB;AACrD,QAAI,UAAU,OAAO,YAAY,SAAS,WAAW,EAAE,gBAAgB;AACrE,cAAS,OAAO,WAAW,EAAE,IAAI;KACjC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;AACvD,cAAS,OAAO,WAAW,qBAAqB;AAChD;;AAGF,QAAI,UAAU;AACZ,SAAI,SAAS,OAAO,SAClB,UAAS,OAAO,YAAY;AAE9B,mBAAc,OAAO,EAAE,gBAAgB;;IAGzC,MAAM,EAAE,QAAQ,SAAS,GAAG,yBAAyB,EAAE;IACvD,MAAM,SAAS,QAAQ,SAAS,EAAE,cAAc,EAAE,IAAI,UAAU;KAC9D,GAAG;KACH,QAAQ,EAAE;KACX,CAAC;AACF,kBAAc,IAAI,EAAE,iBAAiB;KACnC;KACA,QAAQ,EAAE;KACX,CAAC;;IAEJ;GACF"}