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

package/dist/test-utils/itForwardsRootId.d.ts

@@ -0,0 +1,15 @@
+import { ReactElement } from 'react';
+
+export interface RootAutomationAttrs {
+    id: string;
+    'data-testid': string;
+}
+export declare const defaultRootAutomationAttrs: RootAutomationAttrs;
+/**
+ * Registers a unit test that verifies a component forwards `id` and `data-testid` to the DOM.
+ *
+ * @example
+ * itForwardsRootId((attrs) => <Button {...attrs}>Save</Button>);
+ */
+export declare function itForwardsRootId(renderComponent: (attrs: RootAutomationAttrs) => ReactElement): void;
+//# sourceMappingURL=itForwardsRootId.d.ts.map

package/dist/test-utils/itForwardsRootId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itForwardsRootId.d.ts","sourceRoot":"","sources":["../../src/test-utils/itForwardsRootId.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,mBAGxC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,YAAY,GAC5D,IAAI,CAMN"}

package/dist/test-utils/rootAttributes.d.ts

@@ -0,0 +1,22 @@
+/** Shared id used in component root-attribute compliance tests */
+export declare const COMPONENT_ROOT_ID = "impact-ui-component-root-id";
+/** Shared data-testid used in component root-attribute compliance tests */
+export declare const COMPONENT_ROOT_TEST_ID = "impact-ui-component-root";
+/**
+ * Asserts that an element with the given `id` exists in the document.
+ * Returns the element for further assertions.
+ */
+export declare function expectElementWithId(id?: string): HTMLElement;
+/**
+ * Asserts that an element with the given `data-testid` exists in the document.
+ */
+export declare function expectElementWithTestId(testId?: string): HTMLElement;
+/**
+ * Asserts both `id` and `data-testid` are present on the same root element.
+ */
+export declare function expectRootAttributes(options?: {
+    id?: string;
+    testId?: string;
+    element?: HTMLElement | null;
+}): HTMLElement;
+//# sourceMappingURL=rootAttributes.d.ts.map

package/dist/test-utils/rootAttributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootAttributes.d.ts","sourceRoot":"","sources":["../../src/test-utils/rootAttributes.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAE/D,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,GAAE,MAA0B,GAAG,WAAW,CAO/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,MAA+B,GAAG,WAAW,CAU5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE;IACP,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACzB,GACL,WAAW,CAab"}

package/dist/types/index.d.ts

@@ -1,6 +1,8 @@
 import { ReactNode, CSSProperties } from 'react';
 
 export interface BaseComponentProps {
+    /** Stable DOM id for automation and aria references */
+    id?: string;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;
@@ -17,4 +19,6 @@ export interface AriaProps {
     'aria-hidden'?: boolean;
     role?: string;
 }
+/** Common root props: layout + automation + accessibility */
+export type RootComponentProps = BaseComponentProps & Partial<AriaProps>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AACpE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAGnD,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AACpE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAGnD,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/utils/assetBase.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Absolute URL for an asset on the asset CDN.
+ *
+ * @param relativePath - Path after the prod prefix, e.g. `clientLogos/briscoe.webp`, `icons/close.svg`
+ */
+export declare function getAssetUrl(relativePath: string): string;
+//# sourceMappingURL=assetBase.d.ts.map

package/dist/utils/assetBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetBase.d.ts","sourceRoot":"","sources":["../../src/utils/assetBase.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOxD"}

package/dist/utils/assetBase.js

@@ -0,0 +1,14 @@
+const DEFAULT_IMPACT_UI_ASSET_BASE = "https://impact-kit.devs.iaproducts.ai/api/v1/files/uploads/impact-ui/prod";
+function stripTrailingSlashes(s) {
+  return s.replace(/\/+$/, "");
+}
+function getAssetUrl(relativePath) {
+  const base = stripTrailingSlashes(
+    DEFAULT_IMPACT_UI_ASSET_BASE
+  );
+  const path = relativePath.replace(/^\/+/, "");
+  return `${base}/${path}`;
+}
+export {
+  getAssetUrl
+};

package/dist/utils/debounce.d.ts

@@ -1,10 +1,14 @@
+export interface DebouncedFunction<T extends (...args: Parameters<T>) => void> {
+    (...args: Parameters<T>): void;
+    cancel: () => void;
+}
 /**
  * Creates a debounced function that delays invoking func until after delay milliseconds
  * have elapsed since the last time the debounced function was invoked.
  *
  * @param func - The function to debounce
  * @param delay - The number of milliseconds to delay
- * @returns A debounced version of the function
+ * @returns A debounced version of the function with a cancel method
  *
  * @example
  * const debouncedSearch = debounce((query: string) => {
@@ -12,6 +16,7 @@
  * }, 300);
  *
  * debouncedSearch('hello'); // Will only execute after 300ms of no calls
+ * debouncedSearch.cancel(); // Cancels any pending invocation
  */
-export declare const debounce: <T extends (...args: Parameters<T>) => void>(func: T, delay: number) => ((...args: Parameters<T>) => void);
+export declare const debounce: <T extends (...args: Parameters<T>) => void>(func: T, delay: number) => DebouncedFunction<T>;
 //# sourceMappingURL=debounce.d.ts.map

package/dist/utils/debounce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EACjE,MAAM,CAAC,EACP,OAAO,MAAM,KACZ,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAWnC,CAAC"}
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI;IAC3E,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EACjE,MAAM,CAAC,EACP,OAAO,MAAM,KACZ,iBAAiB,CAAC,CAAC,CAoBrB,CAAC"}

package/dist/utils/debounce.js

@@ -1,6 +1,6 @@
 const debounce = (func, delay) => {
   let timeoutId;
-  return (...args) => {
+  const debouncedFn = (...args) => {
     if (timeoutId !== void 0) {
       clearTimeout(timeoutId);
     }
@@ -8,6 +8,13 @@ const debounce = (func, delay) => {
       func(...args);
     }, delay);
   };
+  debouncedFn.cancel = () => {
+    if (timeoutId !== void 0) {
+      clearTimeout(timeoutId);
+      timeoutId = void 0;
+    }
+  };
+  return debouncedFn;
 };
 export {
   debounce

package/dist/utils/pickRootDomAttributes.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import { AriaProps, BaseComponentProps } from '../types';
+
+export interface RootDomAttributeProps extends Pick<BaseComponentProps, 'id' | 'data-testid' | 'className' | 'style'>, Partial<AriaProps> {
+}
+type PickableProps = RootDomAttributeProps & {
+    children?: ReactNode;
+};
+/**
+ * Extracts root DOM attributes (`id`, `data-testid`, `className`, `style`, common `aria-*`, `role`)
+ * from component props so they can be applied to the outermost interactive element.
+ */
+export declare function pickRootDomAttributes<T extends PickableProps>(props: T): {
+    root: RootDomAttributeProps;
+    rest: Omit<T, keyof PickableProps>;
+};
+export {};
+//# sourceMappingURL=pickRootDomAttributes.d.ts.map

package/dist/utils/pickRootDomAttributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickRootDomAttributes.d.ts","sourceRoot":"","sources":["../../src/utils/pickRootDomAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAW9D,MAAM,WAAW,qBACf,SACE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC,EACtE,OAAO,CAAC,SAAS,CAAC;CAAG;AAEzB,KAAK,aAAa,GAAG,qBAAqB,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EAC3D,KAAK,EAAE,CAAC,GACP;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,aAAa,CAAC,CAAA;CAAE,CAmBrE"}

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

@@ -0,0 +1,34 @@
+import { ShortcutRegistration, ShortcutSummary } from './types';
+
+export declare class ShortcutManager {
+    private static instance;
+    private registrations;
+    private activeScopes;
+    private sequenceBuffer;
+    private sequenceTimer;
+    private listenerAttached;
+    private debug;
+    private sequenceTimeout;
+    private constructor();
+    static getInstance(options?: {
+        debug?: boolean;
+        sequenceTimeout?: number;
+    }): ShortcutManager;
+    static resetInstance(): void;
+    private attachListener;
+    private handleKeyDown;
+    private matchesRegistration;
+    private resetSequence;
+    private getActiveRegistrations;
+    register(registration: ShortcutRegistration): void;
+    unregister(id: string): void;
+    isRegistered(id: string): boolean;
+    enableScope(name: string): void;
+    disableScope(name: string): void;
+    isScopeActive(name: string): boolean;
+    getAllShortcuts(): ShortcutSummary[];
+    getShortcutsByScope(scope: string): Omit<ShortcutSummary, 'scope'>[];
+    setDebug(enabled: boolean): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ShortcutManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutManager.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/ShortcutManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkB,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmBrF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IAEvD,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAA4B;IAEnD,OAAO;IAMP,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,aAAa,CAuBnB;IAEF,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,sBAAsB;IAI9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,GAAG,IAAI;IAYlD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC,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;CAShB"}

package/dist/utils/shortcuts/ShortcutManager.js

@@ -0,0 +1,159 @@
+import { DEFAULT_SEQUENCE_TIMEOUT, 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;
+}
+function isBlacklisted(keys) {
+  return BROWSER_SHORTCUT_BLACKLIST.has(normalizeShortcutString(keys));
+}
+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.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 (this.debug) {
+          console.log("[ShortcutManager] matched", reg.id, reg.keys);
+        }
+        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.attachListener();
+  }
+  static getInstance(options) {
+    if (!_ShortcutManager.instance) {
+      _ShortcutManager.instance = new _ShortcutManager(options);
+    }
+    return _ShortcutManager.instance;
+  }
+  static resetInstance() {
+    var _a;
+    (_a = _ShortcutManager.instance) == null ? void 0 : _a.destroy();
+    _ShortcutManager.instance = null;
+  }
+  attachListener() {
+    if (this.listenerAttached || typeof document === "undefined") return;
+    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;
+    }
+  }
+  getActiveRegistrations() {
+    return [...this.registrations.values()].filter((r) => this.isScopeActive(r.scope ?? "global"));
+  }
+  register(registration) {
+    if (isBlacklisted(registration.keys)) {
+      console.warn(
+        `[ShortcutManager] Skipping blacklisted shortcut: ${registration.keys} (${registration.id})`
+      );
+      return;
+    }
+    const parsed = parseShortcutString(registration.keys);
+    this.registrations.set(registration.id, { ...registration, parsed });
+  }
+  unregister(id) {
+    this.registrations.delete(id);
+  }
+  isRegistered(id) {
+    return this.registrations.has(id);
+  }
+  enableScope(name) {
+    this.activeScopes.add(name);
+  }
+  disableScope(name) {
+    if (name === "global") return;
+    this.activeScopes.delete(name);
+  }
+  isScopeActive(name) {
+    return name === "global" || this.activeScopes.has(name);
+  }
+  getAllShortcuts() {
+    return [...this.registrations.values()].map((r) => ({
+      id: r.id,
+      keys: r.keys,
+      scope: r.scope ?? "global",
+      description: r.description ?? "",
+      priority: r.priority ?? 0
+    }));
+  }
+  getShortcutsByScope(scope) {
+    return this.getAllShortcuts().filter((s) => s.scope === scope).map(({ id, keys, description, priority }) => ({
+      id,
+      keys,
+      description,
+      priority
+    }));
+  }
+  setDebug(enabled) {
+    this.debug = enabled;
+  }
+  destroy() {
+    if (this.listenerAttached && typeof document !== "undefined") {
+      document.removeEventListener("keydown", this.handleKeyDown, true);
+      this.listenerAttached = false;
+    }
+    this.registrations.clear();
+    this.activeScopes = /* @__PURE__ */ new Set(["global"]);
+    this.resetSequence();
+  }
+};
+_ShortcutManager.instance = null;
+let ShortcutManager = _ShortcutManager;
+export {
+  ShortcutManager
+};

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

@@ -0,0 +1,10 @@
+/** Canonical key aliases for shortcut parsing and matching. */
+export declare const KEY_ALIASES: Record<string, string>;
+/**
+ * Browser-reserved chords we refuse to register (warn and skip).
+ * Values are normalized shortcut strings without platform mod resolution.
+ */
+export declare const BROWSER_SHORTCUT_BLACKLIST: Set<string>;
+/** Default ms between keys in a sequence chord (e.g. `g i`). */
+export declare const DEFAULT_SEQUENCE_TIMEOUT = 1000;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/shortcuts/constants.js

@@ -0,0 +1,46 @@
+const KEY_ALIASES = {
+  esc: "escape",
+  escape: "escape",
+  space: " ",
+  spacebar: " ",
+  enter: "enter",
+  return: "enter",
+  tab: "tab",
+  backspace: "backspace",
+  delete: "delete",
+  del: "delete",
+  up: "arrowup",
+  down: "arrowdown",
+  left: "arrowleft",
+  right: "arrowright",
+  arrowup: "arrowup",
+  arrowdown: "arrowdown",
+  arrowleft: "arrowleft",
+  arrowright: "arrowright",
+  home: "home",
+  end: "end",
+  pageup: "pageup",
+  pagedown: "pagedown",
+  plus: "+",
+  minus: "-"
+};
+const BROWSER_SHORTCUT_BLACKLIST = /* @__PURE__ */ new Set([
+  "mod+r",
+  "mod+w",
+  "mod+t",
+  "mod+n",
+  "mod+shift+t",
+  "ctrl+r",
+  "ctrl+w",
+  "ctrl+t",
+  "ctrl+n",
+  "ctrl+shift+t",
+  "f5",
+  "f12"
+]);
+const DEFAULT_SEQUENCE_TIMEOUT = 1e3;
+export {
+  BROWSER_SHORTCUT_BLACKLIST,
+  DEFAULT_SEQUENCE_TIMEOUT,
+  KEY_ALIASES
+};

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

@@ -0,0 +1,3 @@
+/** Human-readable platform-aware label for UI badges. */
+export declare function formatShortcutDisplay(keys: string): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/shortcuts/format.js

@@ -0,0 +1,27 @@
+import { parseShortcutString } from "./parse.js";
+import { isMac } from "./platform.js";
+function formatCombo(combo) {
+  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");
+  const displayKey = key.length === 1 ? key.toUpperCase() : key.charAt(0).toUpperCase() + key.slice(1);
+  if (key) parts.push(displayKey);
+  return parts.join(isMac ? "" : "+");
+}
+function formatShortcutDisplay(keys) {
+  const parsed = parseShortcutString(keys);
+  if (parsed.type === "sequence") {
+    return parsed.steps.map(formatCombo).join(" then ");
+  }
+  return formatCombo(parsed.combo);
+}
+export {
+  formatShortcutDisplay
+};

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

@@ -0,0 +1,8 @@
+export { BROWSER_SHORTCUT_BLACKLIST, DEFAULT_SEQUENCE_TIMEOUT, KEY_ALIASES } from './constants';
+export { formatShortcutDisplay } from './format';
+export { matchShortcut, normalizeKey, normalizedPhysicalKey } from './match';
+export { isMac } from './platform';
+export { normalizeShortcutString, parseShortcutString } from './parse';
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,9 @@
+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;
+/** 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

@@ -0,0 +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"}

package/dist/utils/shortcuts/match.js

@@ -0,0 +1,52 @@
+import { KEY_ALIASES } from "./constants.js";
+import { isMac } from "./platform.js";
+function normalizeKey(key) {
+  const lower = key.toLowerCase();
+  return KEY_ALIASES[lower] ?? lower;
+}
+function normalizedPhysicalKey(code) {
+  if (!code.startsWith("Key")) return "";
+  return code.slice(3).toLowerCase();
+}
+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;
+  if (event.altKey) {
+    const physical = normalizedPhysicalKey(event.code);
+    if (physical === expectedKey) return true;
+  }
+  return false;
+}
+function matchShortcut(event, combo) {
+  if (!modifiersMatch(event, combo)) return false;
+  return keyMatch(event, combo.key);
+}
+export {
+  matchShortcut,
+  normalizeKey,
+  normalizedPhysicalKey
+};

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

@@ -0,0 +1,10 @@
+import { ParsedShortcut } from './types';
+
+/**
+ * Parse a shortcut string into chord or sequence structure.
+ * `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). */
+export declare function normalizeShortcutString(keys: string): string;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/shortcuts/parse.js

@@ -0,0 +1,50 @@
+import { KEY_ALIASES } from "./constants.js";
+function normalizeToken(token) {
+  const lower = token.trim().toLowerCase();
+  return KEY_ALIASES[lower] ?? lower;
+}
+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
+  };
+  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);
+  }
+  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))
+    };
+  }
+  return { type: "chord", combo: parseComboPart(trimmed) };
+}
+function normalizeShortcutString(keys) {
+  return keys.trim().toLowerCase().replace(/\s+/g, " ");
+}
+export {
+  normalizeShortcutString,
+  parseShortcutString
+};

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

@@ -0,0 +1,2 @@
+export declare const isMac: boolean;
+//# sourceMappingURL=platform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/platform.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,SAC+E,CAAC"}

package/dist/utils/shortcuts/platform.js

@@ -0,0 +1,5 @@
+const MAC_PATTERN = /Mac|iPod|iPhone|iPad/;
+const isMac = typeof navigator !== "undefined" && MAC_PATTERN.test(navigator.platform || navigator.userAgent);
+export {
+  isMac
+};

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shortcuts.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.test.d.ts","sourceRoot":"","sources":["../../../src/utils/shortcuts/shortcuts.test.ts"],"names":[],"mappings":""}