impact-ui 4.0.12-alpha.2 → 4.0.13-alpha.1

package/dist/mcp-component-registry.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-09-08T12:19:09.118Z",
+  "generatedAt": "2026-09-11T11:28:56.317Z",
   "components": {
     "Menu": {
       "title": "Components/Menu",

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

@@ -1 +1 @@
-{"version":3,"file":"ShortcutManager.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/ShortcutManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,oBAAoB,EAEpB,eAAe,EAChB,MAAM,SAAS,CAAC;AAYjB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IAEvD,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAuC;IAE3D,OAAO;IAOP,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAO5F,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa,CA6CnB;IAEF,QAAQ,CAAC,YAAY,EAAE,oBAAoB,GAAG,IAAI;IAuBlD;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO;IAe1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAS5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYhC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC,eAAe,IAAI,eAAe,EAAE;IAUpC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE;IAWpE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,QAAQ;CAajB"}
+{"version":3,"file":"ShortcutManager.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/ShortcutManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAkB,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAYrF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IAEvD,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAuC;IAE3D,OAAO;IAOP,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAO5F,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa,CA2CnB;IAEF,QAAQ,CAAC,YAAY,EAAE,oBAAoB,GAAG,IAAI;IAuBlD;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO;IAe1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAS5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYhC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC,eAAe,IAAI,eAAe,EAAE;IAUpC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE;IAWpE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,QAAQ;CAajB"}

package/dist/utils/shortcuts/ShortcutManager.js

@@ -19,9 +19,7 @@ const _ShortcutManager = class _ShortcutManager {
       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 }));
+      const sequenceEntries = active.filter((e) => e.parsed.isSequence && (e.allowInInput === true || !isInInput)).map((e) => ({ ...e, steps: e.parsed.combos }));
       if (sequenceEntries.length > 0 || this._sequenceTracker.hasActiveSequences) {
         const seqMatch = this._sequenceTracker.advance(event, sequenceEntries);
         if (seqMatch) {
@@ -35,11 +33,12 @@ const _ShortcutManager = class _ShortcutManager {
         }
       }
       const comboEntries = active.filter(
-        (e) => e.parsed.type === "chord" && (e.allowInInput === true || !isInInput)
+        (e) => !e.parsed.isSequence && (e.allowInInput === true || !isInInput)
       );
       for (const entry of comboEntries) {
-        if (entry.parsed.type !== "chord") continue;
-        if (matchShortcut(event, entry.parsed.combo)) {
+        const combo = entry.parsed.combos[0];
+        if (!combo) continue;
+        if (matchShortcut(event, combo)) {
           if (entry.preventDefault !== false) event.preventDefault();
           this.debugLog(event, entry);
           entry.handler(event);

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

@@ -1,7 +1,7 @@
 interface FormatOptions {
     separator?: string;
 }
-/** Human-readable platform-aware label for UI badges. */
+/** Human-readable platform-aware label for UI badges (JS-compatible output). */
 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":"AAuBA,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAOvF"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/format.ts"],"names":[],"mappings":"AAuCA,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAQvF"}

package/dist/utils/shortcuts/format.js

@@ -1,5 +1,18 @@
 import { parseShortcutString } from "./parse.js";
 import { isMac } from "./platform.js";
+const MAC_SYMBOLS = {
+  meta: "⌘",
+  ctrl: "⌃",
+  alt: "⌥",
+  shift: "⇧"
+};
+const WIN_SYMBOLS = {
+  meta: "Win",
+  ctrl: "Ctrl",
+  alt: "Alt",
+  shift: "Shift"
+};
+const MODIFIER_ORDER = ["ctrl", "alt", "shift", "meta"];
 const SPECIAL_KEY_DISPLAY = {
   arrowup: "↑",
   arrowdown: "↓",
@@ -17,27 +30,16 @@ function formatKey(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) {
-    parts.push(isMac ? "⌘" : "Ctrl");
-  } else {
-    if (modifiers.ctrl) parts.push(isMac ? "⌃" : "Ctrl");
-    if (modifiers.meta) parts.push("⌘");
-  }
-  if (modifiers.alt) parts.push(isMac ? "⌥" : "Alt");
-  if (modifiers.shift) parts.push(isMac ? "⇧" : "Shift");
-  if (key) parts.push(formatKey(key));
-  return parts.join(separator);
+function formatCombo(combo, symbols, separator) {
+  const modParts = MODIFIER_ORDER.filter((m) => combo.modifiers.has(m)).map((m) => symbols[m]);
+  const keyPart = formatKey(combo.key);
+  return [...modParts, keyPart].join(separator);
 }
 function formatShortcutDisplay(keys, options = {}) {
+  const symbols = isMac ? MAC_SYMBOLS : WIN_SYMBOLS;
   const separator = options.separator ?? (isMac ? "" : "+");
   const parsed = parseShortcutString(keys);
-  if (parsed.type === "sequence") {
-    return parsed.steps.map((c) => formatCombo(c, separator)).join(" then ");
-  }
-  return formatCombo(parsed.combo, separator);
+  return parsed.combos.map((combo) => formatCombo(combo, symbols, separator)).join(" then ");
 }
 export {
   formatShortcutDisplay

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

@@ -6,5 +6,5 @@ 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';
+export type { Modifier, ParsedShortcut, ShortcutBinding, ShortcutCombo, ShortcutRegistration, 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,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"}
+{"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,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC"}

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

@@ -4,6 +4,9 @@ import { ShortcutCombo } from './types';
 export declare function normalizeKey(key: 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? */
+/**
+ * Test whether a KeyboardEvent matches a ShortcutCombo exactly
+ * (same modifiers, no more / no fewer, and matching key).
+ */
 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,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"}
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/match.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvD,+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;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAcjF"}

package/dist/utils/shortcuts/match.js

@@ -1,5 +1,4 @@
 import { KEY_ALIASES } from "./constants.js";
-import { isMac } from "./platform.js";
 function normalizeKey(key) {
   const lower = key.toLowerCase();
   return KEY_ALIASES[lower] ?? lower;
@@ -54,40 +53,24 @@ function normalizedPhysicalKey(code) {
   }
   return null;
 }
-function modifiersMatch(event, combo) {
-  const wantsMod = combo.modifiers.mod;
-  const modPressed = isMac ? event.metaKey : event.ctrlKey;
-  const wantsCtrl = combo.modifiers.ctrl;
-  const wantsMeta = combo.modifiers.meta;
-  const wantsAlt = combo.modifiers.alt;
-  const wantsShift = combo.modifiers.shift;
-  if (wantsMod) {
-    if (!modPressed) return false;
-    if (wantsAlt && !event.altKey) return false;
-    if (wantsShift && !event.shiftKey) return false;
-    if (!wantsAlt && event.altKey) return false;
-    if (!wantsShift && event.shiftKey) return false;
-    if (wantsCtrl && !event.ctrlKey) return false;
-    if (wantsMeta && !event.metaKey) return false;
-    return true;
-  }
-  if (wantsCtrl !== event.ctrlKey) return false;
-  if (wantsMeta !== event.metaKey) return false;
-  if (wantsAlt !== event.altKey) return false;
-  if (wantsShift !== event.shiftKey) return false;
-  return true;
-}
-function keyMatch(event, expectedKey) {
-  if (!expectedKey) return true;
-  const normalized = normalizeKey(event.key);
-  if (normalized === expectedKey) return true;
-  const physical = normalizedPhysicalKey(event.code);
-  if (physical !== null && physical === expectedKey) return true;
-  return false;
+function getActiveModifiers(event) {
+  const mods = /* @__PURE__ */ new Set();
+  if (event.ctrlKey) mods.add("ctrl");
+  if (event.metaKey) mods.add("meta");
+  if (event.altKey) mods.add("alt");
+  if (event.shiftKey) mods.add("shift");
+  return mods;
 }
 function matchShortcut(event, combo) {
-  if (!modifiersMatch(event, combo)) return false;
-  return keyMatch(event, combo.key);
+  const pressed = getActiveModifiers(event);
+  if (pressed.size !== combo.modifiers.size) return false;
+  for (const mod of combo.modifiers) {
+    if (!pressed.has(mod)) return false;
+  }
+  const fromKey = normalizeKey(event.key);
+  if (fromKey === combo.key) return true;
+  const fromCode = normalizedPhysicalKey(event.code);
+  return fromCode !== null && fromCode === combo.key;
 }
 export {
   matchShortcut,

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

@@ -1,13 +1,13 @@
 import { ParsedShortcut } from './types';
 
 /**
- * Parse a shortcut string into chord or sequence structure.
- * `mod+k` → chord; `g i` → sequence of two single-key chords.
+ * Parse a shortcut string into the JS-compatible `{ isSequence, combos }` shape.
+ * `mod+k` → single combo (mod resolved to ctrl/meta); `g i` → sequence.
  */
-export declare function parseShortcutString(keys: string): ParsedShortcut;
+export declare function parseShortcutString(shortcutStr: string): ParsedShortcut;
 /**
  * Normalize shortcut string for blacklist / dedup / comparison.
- * Parses, sorts modifiers alphabetically, and reconstructs.
+ * Modifiers are sorted alphabetically; `mod` is already platform-resolved.
  */
-export declare function normalizeShortcutString(keys: string): string;
+export declare function normalizeShortcutString(shortcutStr: 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;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB5D"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,cAAc,EAAiB,MAAM,SAAS,CAAC;AA8CvE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAYvE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQnE"}

package/dist/utils/shortcuts/parse.js

@@ -1,62 +1,48 @@
 import { KEY_ALIASES } from "./constants.js";
-function normalizeToken(token) {
-  const lower = token.trim().toLowerCase();
-  return KEY_ALIASES[lower] ?? lower;
+import { isMac } from "./platform.js";
+const MODIFIER_SET = /* @__PURE__ */ new Set(["ctrl", "meta", "alt", "shift", "mod"]);
+function resolveModifier(mod) {
+  if (mod === "mod") return isMac ? "meta" : "ctrl";
+  return mod;
 }
-function parseComboPart(part) {
-  const tokens = part.split("+").map((t) => t.trim().toLowerCase()).filter(Boolean);
-  const modifiers = {
-    ctrl: false,
-    meta: false,
-    alt: false,
-    shift: false,
-    mod: false
-  };
+function canonicalModifierToken(token) {
+  if (token === "control") return "ctrl";
+  if (token === "cmd" || token === "command") return "meta";
+  if (token === "option") return "alt";
+  if (MODIFIER_SET.has(token)) return token;
+  return null;
+}
+function parseCombo(comboStr) {
+  const parts = comboStr.toLowerCase().split("+").map((p) => p.trim()).filter(Boolean);
+  const modifiers = /* @__PURE__ */ new Set();
   let key = "";
-  for (const token of tokens) {
-    if (token === "mod") modifiers.mod = true;
-    else if (token === "ctrl" || token === "control") modifiers.ctrl = true;
-    else if (token === "meta" || token === "cmd" || token === "command") modifiers.meta = true;
-    else if (token === "alt" || token === "option") modifiers.alt = true;
-    else if (token === "shift") modifiers.shift = true;
-    else key = normalizeToken(token);
+  for (const part of parts) {
+    const modToken = canonicalModifierToken(part);
+    if (modToken !== null) {
+      modifiers.add(resolveModifier(modToken));
+    } else {
+      key = KEY_ALIASES[part] ?? part;
+    }
   }
   return { modifiers, key };
 }
-function parseShortcutString(keys) {
-  const trimmed = keys.trim();
-  if (trimmed.includes(" ") && !trimmed.includes("+")) {
-    const parts = trimmed.split(/\s+/).filter(Boolean);
-    return {
-      type: "sequence",
-      steps: parts.map((p) => parseComboPart(p))
-    };
-  }
-  if (/\s+\S/.test(trimmed) && trimmed.includes("+")) {
-    const parts = trimmed.split(/\s+/).filter(Boolean);
-    return {
-      type: "sequence",
-      steps: parts.map((p) => parseComboPart(p))
-    };
+function parseShortcutString(shortcutStr) {
+  const trimmed = shortcutStr.trim();
+  const parts = trimmed.split(/\s+/).filter(Boolean);
+  if (parts.length <= 1) {
+    return { isSequence: false, combos: [parseCombo(parts[0] ?? "")] };
   }
-  return { type: "chord", combo: parseComboPart(trimmed) };
+  return {
+    isSequence: true,
+    combos: parts.map(parseCombo)
+  };
 }
-function normalizeShortcutString(keys) {
-  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();
+function normalizeShortcutString(shortcutStr) {
+  const parsed = parseShortcutString(shortcutStr);
+  return parsed.combos.map((combo) => {
+    const mods = [...combo.modifiers].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);
+  }).join(" ");
 }
 export {
   normalizeShortcutString,

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

@@ -1,22 +1,23 @@
+/** Platform modifier after `mod` is resolved at parse time. */
+export type Modifier = 'ctrl' | 'meta' | 'alt' | 'shift';
+/**
+ * A single key combination (e.g. Mod+Shift+K).
+ * JS-compatible: `modifiers` is a Set (no unresolved `mod` token).
+ */
 export interface ShortcutCombo {
-    modifiers: {
-        ctrl: boolean;
-        meta: boolean;
-        alt: boolean;
-        shift: boolean;
-        mod: boolean;
-    };
+    modifiers: Set<Modifier>;
+    /** Normalized lowercase key (e.g. 'k', 'enter', 'arrowup') */
     key: string;
 }
-export interface ShortcutSequence {
-    type: 'sequence';
-    steps: ShortcutCombo[];
+/**
+ * Parsed shortcut — single combo or sequence of combos.
+ * JS-compatible shape used by consumers of the previous JS package.
+ */
+export interface ParsedShortcut {
+    isSequence: boolean;
+    /** Single-element for simple chords; multi for sequences like `g i` */
+    combos: ShortcutCombo[];
 }
-export interface ShortcutChord {
-    type: 'chord';
-    combo: ShortcutCombo;
-}
-export type ParsedShortcut = ShortcutSequence | ShortcutChord;
 export interface ShortcutRegistration {
     id: string;
     keys: 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;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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,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.12-alpha.2",
+  "version": "4.0.13-alpha.1",
   "description": "Impact Analytics UI library",
   "type": "module",
   "main": "./dist/components/index.js",