impact-ui 4.0.0-alpha.21 → 4.0.0-alpha.23

package/dist/utils/shortcuts/ShortcutManager.js

@@ -1,14 +1,7 @@
-import { DEFAULT_SEQUENCE_TIMEOUT, BROWSER_SHORTCUT_BLACKLIST } from "./constants.js";
+import { DEFAULT_SEQUENCE_TIMEOUT, MODIFIER_KEYS, INPUT_ELEMENTS, BROWSER_SHORTCUT_BLACKLIST } from "./constants.js";
 import { matchShortcut } from "./match.js";
 import { parseShortcutString, normalizeShortcutString } from "./parse.js";
-function isInputFocused() {
-  const el = document.activeElement;
-  if (!el) return false;
-  const tag = el.tagName.toLowerCase();
-  if (tag === "input" || tag === "textarea" || tag === "select") return true;
-  if (el.isContentEditable) return true;
-  return false;
-}
+import { SequenceTracker } from "./sequence.js";
 function isBlacklisted(keys) {
   return BROWSER_SHORTCUT_BLACKLIST.has(normalizeShortcutString(keys));
 }
@@ -16,32 +9,47 @@ const _ShortcutManager = class _ShortcutManager {
   constructor(options) {
     this.registrations = /* @__PURE__ */ new Map();
     this.activeScopes = /* @__PURE__ */ new Set(["global"]);
-    this.sequenceBuffer = [];
-    this.sequenceTimer = null;
     this.listenerAttached = false;
     this.debug = false;
     this.sequenceTimeout = DEFAULT_SEQUENCE_TIMEOUT;
+    this._sortedCache = null;
     this.handleKeyDown = (event) => {
-      const candidates = this.getActiveRegistrations().sort(
-        (a, b) => (b.priority ?? 0) - (a.priority ?? 0)
-      );
-      for (const reg of candidates) {
-        if (!reg.allowInInput && isInputFocused()) continue;
-        const matched = this.matchesRegistration(event, reg);
-        if (!matched) continue;
-        if (reg.preventDefault !== false) {
-          event.preventDefault();
-          event.stopPropagation();
+      if (MODIFIER_KEYS.has(event.key)) return;
+      const target = event.target;
+      const isInInput = INPUT_ELEMENTS.has(target.tagName) || target.isContentEditable;
+      const sorted = this.getSorted();
+      const active = sorted.filter((e) => this.isScopeActive(e.scope ?? "global"));
+      const sequenceEntries = active.filter(
+        (e) => e.parsed.type === "sequence" && (e.allowInInput === true || !isInInput)
+      ).map((e) => ({ ...e, steps: e.parsed.steps }));
+      if (sequenceEntries.length > 0 || this._sequenceTracker.hasActiveSequences) {
+        const seqMatch = this._sequenceTracker.advance(event, sequenceEntries);
+        if (seqMatch) {
+          if (seqMatch.preventDefault !== false) event.preventDefault();
+          this.debugLog(event, seqMatch);
+          seqMatch.handler(event);
+          if (!seqMatch.propagate) return;
         }
-        if (this.debug) {
-          console.log("[ShortcutManager] matched", reg.id, reg.keys);
+        if (this._sequenceTracker.hasActiveSequences) {
+          return;
+        }
+      }
+      const comboEntries = active.filter(
+        (e) => e.parsed.type === "chord" && (e.allowInInput === true || !isInInput)
+      );
+      for (const entry of comboEntries) {
+        if (entry.parsed.type !== "chord") continue;
+        if (matchShortcut(event, entry.parsed.combo)) {
+          if (entry.preventDefault !== false) event.preventDefault();
+          this.debugLog(event, entry);
+          entry.handler(event);
+          if (!entry.propagate) return;
         }
-        reg.handler(event);
-        return;
       }
     };
     if (options == null ? void 0 : options.debug) this.debug = options.debug;
     if (options == null ? void 0 : options.sequenceTimeout) this.sequenceTimeout = options.sequenceTimeout;
+    this._sequenceTracker = new SequenceTracker(this.sequenceTimeout);
     this.attachListener();
   }
   static getInstance(options) {
@@ -60,41 +68,13 @@ const _ShortcutManager = class _ShortcutManager {
     document.addEventListener("keydown", this.handleKeyDown, true);
     this.listenerAttached = true;
   }
-  matchesRegistration(event, reg) {
-    const parsed = reg.parsed;
-    if (parsed.type === "chord") {
-      return matchShortcut(event, parsed.combo);
-    }
-    const step = parsed.steps[this.sequenceBuffer.length];
-    if (!step) {
-      this.resetSequence();
-      return false;
-    }
-    if (!matchShortcut(event, step)) {
-      this.resetSequence();
-      return false;
-    }
-    this.sequenceBuffer.push(reg.keys);
-    if (this.sequenceTimer) clearTimeout(this.sequenceTimer);
-    this.sequenceTimer = setTimeout(() => {
-      this.resetSequence();
-    }, this.sequenceTimeout);
-    if (this.sequenceBuffer.length < parsed.steps.length) {
-      event.preventDefault();
-      return false;
-    }
-    this.resetSequence();
-    return true;
-  }
-  resetSequence() {
-    this.sequenceBuffer = [];
-    if (this.sequenceTimer) {
-      clearTimeout(this.sequenceTimer);
-      this.sequenceTimer = null;
+  getSorted() {
+    if (!this._sortedCache) {
+      this._sortedCache = [...this.registrations.values()].sort(
+        (a, b) => (b.priority ?? 0) - (a.priority ?? 0)
+      );
     }
-  }
-  getActiveRegistrations() {
-    return [...this.registrations.values()].filter((r) => this.isScopeActive(r.scope ?? "global"));
+    return this._sortedCache;
   }
   register(registration) {
     if (isBlacklisted(registration.keys)) {
@@ -103,21 +83,59 @@ const _ShortcutManager = class _ShortcutManager {
       );
       return;
     }
+    if (this.registrations.has(registration.id)) {
+      this.unregister(registration.id);
+    }
     const parsed = parseShortcutString(registration.keys);
     this.registrations.set(registration.id, { ...registration, parsed });
+    this._sortedCache = null;
+    if (this.debug) {
+      console.log(
+        `[ShortcutManager] Registered "${registration.id}" → ${registration.keys} (scope: ${registration.scope ?? "global"})`
+      );
+    }
+  }
+  /**
+   * Programmatically invoke a registered shortcut handler by its id.
+   * Returns true if the shortcut was found and fired, false otherwise.
+   */
+  trigger(id, event) {
+    const entry = this.registrations.get(id);
+    if (!entry) return false;
+    if (entry.preventDefault !== false && event) event.preventDefault();
+    if (this.debug) {
+      console.log(`[ShortcutManager] Programmatic trigger "${id}" (${entry.keys})`);
+    }
+    entry.handler(event);
+    return true;
   }
   unregister(id) {
-    this.registrations.delete(id);
+    if (this.registrations.delete(id)) {
+      this._sortedCache = null;
+      if (this.debug) {
+        console.log(`[ShortcutManager] Unregistered "${id}"`);
+      }
+    }
   }
   isRegistered(id) {
     return this.registrations.has(id);
   }
   enableScope(name) {
     this.activeScopes.add(name);
+    if (this.debug) {
+      console.log(`[ShortcutManager] Scope enabled: "${name}"`);
+    }
   }
   disableScope(name) {
-    if (name === "global") return;
+    if (name === "global") {
+      console.warn('[ShortcutManager] The "global" scope cannot be disabled.');
+      return;
+    }
     this.activeScopes.delete(name);
+    this._sequenceTracker.reset();
+    if (this.debug) {
+      console.log(`[ShortcutManager] Scope disabled: "${name}"`);
+    }
   }
   isScopeActive(name) {
     return name === "global" || this.activeScopes.has(name);
@@ -149,7 +167,21 @@ const _ShortcutManager = class _ShortcutManager {
     }
     this.registrations.clear();
     this.activeScopes = /* @__PURE__ */ new Set(["global"]);
-    this.resetSequence();
+    this._sequenceTracker.reset();
+    this._sortedCache = null;
+  }
+  debugLog(event, entry) {
+    if (!this.debug) return;
+    console.log(
+      `[ShortcutManager] Triggered "${entry.id}" (${entry.keys}) — scope: ${entry.scope ?? "global"}, priority: ${entry.priority ?? 0}`,
+      {
+        key: event.key,
+        ctrl: event.ctrlKey,
+        meta: event.metaKey,
+        alt: event.altKey,
+        shift: event.shiftKey
+      }
+    );
   }
 };
 _ShortcutManager.instance = null;

package/dist/utils/shortcuts/constants.d.ts

@@ -1,3 +1,5 @@
+export declare const MODIFIER_KEYS: Set<string>;
+export declare const INPUT_ELEMENTS: Set<string>;
 /** Canonical key aliases for shortcut parsing and matching. */
 export declare const KEY_ALIASES: Record<string, string>;
 /**

package/dist/utils/shortcuts/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/constants.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyB9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,aAarC,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,OAAO,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,aAA+C,CAAC;AAE1E,eAAO,MAAM,cAAc,aAA2C,CAAC;AAEvE,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0B9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,aAoBrC,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,OAAO,CAAC"}

package/dist/utils/shortcuts/constants.js

@@ -1,3 +1,5 @@
+const MODIFIER_KEYS = /* @__PURE__ */ new Set(["Control", "Alt", "Shift", "Meta"]);
+const INPUT_ELEMENTS = /* @__PURE__ */ new Set(["INPUT", "TEXTAREA", "SELECT"]);
 const KEY_ALIASES = {
   esc: "escape",
   escape: "escape",
@@ -9,6 +11,7 @@ const KEY_ALIASES = {
   backspace: "backspace",
   delete: "delete",
   del: "delete",
+  ins: "insert",
   up: "arrowup",
   down: "arrowdown",
   left: "arrowleft",
@@ -29,18 +32,27 @@ const BROWSER_SHORTCUT_BLACKLIST = /* @__PURE__ */ new Set([
   "mod+w",
   "mod+t",
   "mod+n",
+  "mod+q",
+  "mod+l",
+  "mod+d",
   "mod+shift+t",
   "ctrl+r",
   "ctrl+w",
   "ctrl+t",
   "ctrl+n",
+  "ctrl+q",
+  "ctrl+l",
+  "ctrl+d",
   "ctrl+shift+t",
   "f5",
+  "f11",
   "f12"
 ]);
 const DEFAULT_SEQUENCE_TIMEOUT = 1e3;
 export {
   BROWSER_SHORTCUT_BLACKLIST,
   DEFAULT_SEQUENCE_TIMEOUT,
-  KEY_ALIASES
+  INPUT_ELEMENTS,
+  KEY_ALIASES,
+  MODIFIER_KEYS
 };

package/dist/utils/shortcuts/format.d.ts

@@ -1,3 +1,7 @@
+interface FormatOptions {
+    separator?: string;
+}
 /** Human-readable platform-aware label for UI badges. */
-export declare function formatShortcutDisplay(keys: string): string;
+export declare function formatShortcutDisplay(keys: string, options?: FormatOptions): string;
+export {};
 //# sourceMappingURL=format.d.ts.map

package/dist/utils/shortcuts/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/format.ts"],"names":[],"mappings":"AAwBA,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/format.ts"],"names":[],"mappings":"AAuBA,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,yDAAyD;AACzD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAOR"}

package/dist/utils/shortcuts/format.js

@@ -1,6 +1,23 @@
 import { parseShortcutString } from "./parse.js";
 import { isMac } from "./platform.js";
-function formatCombo(combo) {
+const SPECIAL_KEY_DISPLAY = {
+  arrowup: "↑",
+  arrowdown: "↓",
+  arrowleft: "←",
+  arrowright: "→",
+  enter: "↵",
+  escape: "Esc",
+  backspace: "⌫",
+  delete: "⌦",
+  tab: "⇥",
+  " ": "Space"
+};
+function formatKey(key) {
+  if (SPECIAL_KEY_DISPLAY[key]) return SPECIAL_KEY_DISPLAY[key];
+  if (key.length === 1) return key.toUpperCase();
+  return key.charAt(0).toUpperCase() + key.slice(1);
+}
+function formatCombo(combo, separator) {
   const parts = [];
   const { modifiers, key } = combo;
   if (modifiers.mod) {
@@ -11,16 +28,16 @@ function formatCombo(combo) {
   }
   if (modifiers.alt) parts.push(isMac ? "⌥" : "Alt");
   if (modifiers.shift) parts.push(isMac ? "⇧" : "Shift");
-  const displayKey = key.length === 1 ? key.toUpperCase() : key.charAt(0).toUpperCase() + key.slice(1);
-  if (key) parts.push(displayKey);
-  return parts.join(isMac ? "" : "+");
+  if (key) parts.push(formatKey(key));
+  return parts.join(separator);
 }
-function formatShortcutDisplay(keys) {
+function formatShortcutDisplay(keys, options = {}) {
+  const separator = options.separator ?? (isMac ? "" : "+");
   const parsed = parseShortcutString(keys);
   if (parsed.type === "sequence") {
-    return parsed.steps.map(formatCombo).join(" then ");
+    return parsed.steps.map((c) => formatCombo(c, separator)).join(" then ");
   }
-  return formatCombo(parsed.combo);
+  return formatCombo(parsed.combo, separator);
 }
 export {
   formatShortcutDisplay

package/dist/utils/shortcuts/index.d.ts

@@ -1,8 +1,10 @@
-export { BROWSER_SHORTCUT_BLACKLIST, DEFAULT_SEQUENCE_TIMEOUT, KEY_ALIASES } from './constants';
+export { BROWSER_SHORTCUT_BLACKLIST, DEFAULT_SEQUENCE_TIMEOUT, INPUT_ELEMENTS, KEY_ALIASES, MODIFIER_KEYS, } from './constants';
 export { formatShortcutDisplay } from './format';
 export { matchShortcut, normalizeKey, normalizedPhysicalKey } from './match';
 export { isMac } from './platform';
 export { normalizeShortcutString, parseShortcutString } from './parse';
+export { SequenceTracker } from './sequence';
+export type { SequenceEntry } from './sequence';
 export { ShortcutManager } from './ShortcutManager';
 export type { ParsedShortcut, ShortcutBinding, ShortcutChord, ShortcutCombo, ShortcutRegistration, ShortcutSequence, ShortcutSummary, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/shortcuts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/utils/shortcuts/match.d.ts

@@ -2,8 +2,8 @@ import { ShortcutCombo } from './types';
 
 /** Normalize KeyboardEvent.key to canonical lowercase form. */
 export declare function normalizeKey(key: string): string;
-/** Map physical key code to logical key (fixes macOS Option+letter). */
-export declare function normalizedPhysicalKey(code: string): string;
+/** Map `KeyboardEvent.code` to normalized key (fixes macOS Option+letter). */
+export declare function normalizedPhysicalKey(code: string): string | null;
 /** Low-level test: does this keyboard event match the combo? */
 export declare function matchShortcut(event: KeyboardEvent, combo: ShortcutCombo): boolean;
 //# sourceMappingURL=match.d.ts.map

package/dist/utils/shortcuts/match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/match.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAwCD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAGjF"}
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/match.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsDjE;AAsCD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAGjF"}

package/dist/utils/shortcuts/match.js

@@ -5,8 +5,54 @@ function normalizeKey(key) {
   return KEY_ALIASES[lower] ?? lower;
 }
 function normalizedPhysicalKey(code) {
-  if (!code.startsWith("Key")) return "";
-  return code.slice(3).toLowerCase();
+  if (!code) return null;
+  if (code.startsWith("Key") && code.length === 4) {
+    return code.slice(3).toLowerCase();
+  }
+  if (code.startsWith("Digit")) {
+    return code.slice(5);
+  }
+  const physicalMap = {
+    Space: " ",
+    Minus: "-",
+    Equal: "=",
+    Backquote: "`",
+    BracketLeft: "[",
+    BracketRight: "]",
+    Backslash: "\\",
+    Semicolon: ";",
+    Quote: "'",
+    Comma: ",",
+    Period: ".",
+    Slash: "/",
+    IntlBackslash: "\\",
+    NumpadDecimal: ".",
+    NumpadDivide: "/",
+    NumpadMultiply: "*",
+    NumpadSubtract: "-",
+    NumpadAdd: "+",
+    NumpadEnter: "enter",
+    ArrowUp: "arrowup",
+    ArrowDown: "arrowdown",
+    ArrowLeft: "arrowleft",
+    ArrowRight: "arrowright",
+    Enter: "enter",
+    Escape: "escape",
+    Tab: "tab",
+    Backspace: "backspace",
+    Delete: "delete",
+    Insert: "insert",
+    Home: "home",
+    End: "end",
+    PageUp: "pageup",
+    PageDown: "pagedown"
+  };
+  if (physicalMap[code]) return physicalMap[code];
+  if (code.startsWith("Numpad") && code.length === 7) {
+    const ch = code.slice(6);
+    if (/^\d$/.test(ch)) return ch;
+  }
+  return null;
 }
 function modifiersMatch(event, combo) {
   const wantsMod = combo.modifiers.mod;
@@ -35,10 +81,8 @@ function keyMatch(event, expectedKey) {
   if (!expectedKey) return true;
   const normalized = normalizeKey(event.key);
   if (normalized === expectedKey) return true;
-  if (event.altKey) {
-    const physical = normalizedPhysicalKey(event.code);
-    if (physical === expectedKey) return true;
-  }
+  const physical = normalizedPhysicalKey(event.code);
+  if (physical !== null && physical === expectedKey) return true;
   return false;
 }
 function matchShortcut(event, combo) {

package/dist/utils/shortcuts/parse.d.ts

@@ -5,6 +5,9 @@ import { ParsedShortcut } from './types';
  * `mod+k` → chord; `g i` → sequence of two single-key chords.
  */
 export declare function parseShortcutString(keys: string): ParsedShortcut;
-/** Normalize shortcut string for blacklist / comparison (lowercase, trim). */
+/**
+ * Normalize shortcut string for blacklist / dedup / comparison.
+ * Parses, sorts modifiers alphabetically, and reconstructs.
+ */
 export declare function normalizeShortcutString(keys: string): string;
 //# sourceMappingURL=parse.d.ts.map

package/dist/utils/shortcuts/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AAmC7D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmBhE;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AAmC7D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmBhE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

package/dist/utils/shortcuts/parse.js

@@ -42,7 +42,21 @@ function parseShortcutString(keys) {
   return { type: "chord", combo: parseComboPart(trimmed) };
 }
 function normalizeShortcutString(keys) {
-  return keys.trim().toLowerCase().replace(/\s+/g, " ");
+  const parsed = parseShortcutString(keys);
+  function normCombo(combo) {
+    const mods = [];
+    if (combo.modifiers.mod) mods.push("mod");
+    if (combo.modifiers.ctrl) mods.push("ctrl");
+    if (combo.modifiers.meta) mods.push("meta");
+    if (combo.modifiers.alt) mods.push("alt");
+    if (combo.modifiers.shift) mods.push("shift");
+    mods.sort();
+    return mods.length > 0 ? [...mods, combo.key].join("+") : combo.key;
+  }
+  if (parsed.type === "sequence") {
+    return parsed.steps.map(normCombo).join(" ");
+  }
+  return normCombo(parsed.combo);
 }
 export {
   normalizeShortcutString,

package/dist/utils/shortcuts/sequence.d.ts

@@ -0,0 +1,18 @@
+import { ShortcutCombo } from './types';
+
+export interface SequenceEntry {
+    id: string;
+    steps: ShortcutCombo[];
+}
+export declare class SequenceTracker {
+    private _timeout;
+    private _progress;
+    private _timer;
+    constructor(timeout?: number);
+    advance<T extends SequenceEntry>(event: KeyboardEvent, entries: T[]): T | null;
+    reset(): void;
+    get hasActiveSequences(): boolean;
+    private _startTimer;
+    private _clearTimer;
+}
+//# sourceMappingURL=sequence.d.ts.map

package/dist/utils/shortcuts/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/sequence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,MAAM,CAA8C;gBAEhD,OAAO,SAAO;IAI1B,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IAyC9E,KAAK,IAAI,IAAI;IAKb,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/utils/shortcuts/sequence.js

@@ -0,0 +1,60 @@
+import { matchShortcut } from "./match.js";
+class SequenceTracker {
+  constructor(timeout = 1e3) {
+    this._progress = /* @__PURE__ */ new Map();
+    this._timer = null;
+    this._timeout = timeout;
+  }
+  advance(event, entries) {
+    this._clearTimer();
+    let matched = null;
+    let anyActive = false;
+    for (const entry of entries) {
+      const step = this._progress.get(entry.id) ?? 0;
+      const combo = entry.steps[step];
+      if (!combo) {
+        this._progress.delete(entry.id);
+        continue;
+      }
+      if (matchShortcut(event, combo)) {
+        const nextStep = step + 1;
+        if (nextStep >= entry.steps.length) {
+          matched = entry;
+          this._progress.delete(entry.id);
+        } else {
+          this._progress.set(entry.id, nextStep);
+          anyActive = true;
+        }
+      } else {
+        this._progress.delete(entry.id);
+      }
+    }
+    if (matched) {
+      this.reset();
+      return matched;
+    }
+    if (anyActive) {
+      this._startTimer();
+    }
+    return null;
+  }
+  reset() {
+    this._progress.clear();
+    this._clearTimer();
+  }
+  get hasActiveSequences() {
+    return this._progress.size > 0;
+  }
+  _startTimer() {
+    this._timer = setTimeout(() => this.reset(), this._timeout);
+  }
+  _clearTimer() {
+    if (this._timer !== null) {
+      clearTimeout(this._timer);
+      this._timer = null;
+    }
+  }
+}
+export {
+  SequenceTracker
+};

package/dist/utils/shortcuts/types.d.ts

@@ -27,6 +27,7 @@ export interface ShortcutRegistration {
     priority?: number;
     description?: string;
     preventDefault?: boolean;
+    propagate?: boolean;
 }
 export interface ShortcutBinding {
     keys: string;
@@ -39,6 +40,7 @@ export interface ShortcutBinding {
     priority?: number;
     description?: string;
     preventDefault?: boolean;
+    propagate?: boolean;
 }
 export interface ShortcutSummary {
     id: string;

package/dist/utils/shortcuts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impact-ui",
-  "version": "4.0.0-alpha.21",
+  "version": "4.0.0-alpha.23",
   "description": "Impact Analytics UI library",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -121,8 +121,10 @@
     "@mui/types": "^7.1.3",
     "@mui/x-date-pickers": "^5.0.0-alpha.4",
     "@storybook/addon-a11y": "^10.2.15",
+    "@storybook/addon-docs": "^10.2.15",
     "@storybook/addon-vitest": "^10.2.15",
     "@storybook/react-vite": "^10.2.15",
+    "@storybook/test": "^8.6.15",
     "@testing-library/jest-dom": "^6.2.0",
     "@testing-library/react": "^12.1.2",
     "@testing-library/user-event": "^14.6.1",
@@ -182,6 +184,7 @@
     "vite": "^5.0.11",
     "vite-plugin-css-injected-by-js": "^4.0.1",
     "vite-plugin-dts": "^3.7.0",
+    "vite-plugin-svgr": "^5.2.0",
     "vitest": "^4.0.18",
     "vitest-axe": "^0.1.0"
   },
@@ -221,6 +224,9 @@
     }
   },
   "dependencies": {
+    "@dnd-kit/core": "^6.2.0",
+    "@dnd-kit/sortable": "^9.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
     "@tiptap/extension-highlight": "^2.26.1",
     "@tiptap/extension-image": "^2.26.1",
     "@tiptap/extension-link": "^2.26.1",
@@ -231,9 +237,6 @@
     "@tiptap/starter-kit": "^2.26.1",
     "@tiptap/suggestion": "^2.26.1",
     "dompurify": "^3.2.7",
-    "@dnd-kit/core": "^6.2.0",
-    "@dnd-kit/sortable": "^9.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
     "emoji-picker-react": "^4.14.0",
     "prosemirror-model": "^1.25.3",
     "prosemirror-state": "^1.4.3",