@genesislcap/foundation-utils 14.422.0 → 14.422.1-alpha-6f2ae99.0

package/dist/dts/shortcut-manager/shortcut-listener.d.ts

@@ -8,6 +8,7 @@ import { ShortcutManager } from './shortcut-manager';
 export declare class FoundationShortcutListener extends FASTElement {
     shortcutManager: ShortcutManager;
     private keyListener;
+    private stateSubscription;
     private isListening;
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -15,7 +16,12 @@ export declare class FoundationShortcutListener extends FASTElement {
     private addKeyListener;
     private removeKeyListener;
     private handleKeyDown;
+    private resolveShortcutManager;
+    private isShortcutManager;
     private extractKeyFromCode;
+    private getDeepActiveElement;
+    private getEventElement;
+    private isEditableContext;
     private isInputElement;
 }
 //# sourceMappingURL=shortcut-listener.d.ts.map

package/dist/dts/shortcut-manager/shortcut-listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shortcut-listener.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/shortcut-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,qBAGa,0BAA2B,SAAQ,WAAW;IAChC,eAAe,EAAE,eAAe,CAAC;IAE1D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,WAAW,CAAS;IAE5B,iBAAiB;IAKjB,oBAAoB;IAKpB,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,cAAc;CAuBvB"}
+{"version":3,"file":"shortcut-listener.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/shortcut-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,qBAGa,0BAA2B,SAAQ,WAAW;IAChC,eAAe,EAAE,eAAe,CAAC;IAE1D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,WAAW,CAAS;IAE5B,iBAAiB;IAKjB,oBAAoB;IAOpB,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;CA4CvB"}

package/dist/dts/shortcut-manager/shortcut-manager.d.ts

@@ -73,6 +73,13 @@ export interface ShortcutManager {
     isPaused: boolean;
     isPaused$: Observable<boolean>;
     isPausedSubject: BehaviorSubject<boolean>;
+    /**
+     * Register a global execution guard.
+     * @remarks Guards are evaluated before shortcut-specific canExecute checks.
+     */
+    registerExecutionGuard(id: string, guard: () => ShortcutExecutionStatus | boolean): void;
+    unregisterExecutionGuard(id: string): void;
+    clearExecutionGuards(): void;
 }
 /**
  * Default implementation of the ShortcutManager interface
@@ -84,6 +91,7 @@ export declare class DefaultShortcutManager implements ShortcutManager {
     private keyCombinationMap;
     private _isPausedSubject;
     private _activeContext;
+    private executionGuards;
     get isPaused(): boolean;
     get isPaused$(): Observable<boolean>;
     get isPausedSubject(): BehaviorSubject<boolean>;
@@ -102,6 +110,9 @@ export declare class DefaultShortcutManager implements ShortcutManager {
     setActiveContext(context: string): void;
     getActiveContext(): string | undefined;
     clearActiveContext(): void;
+    registerExecutionGuard(id: string, guard: () => ShortcutExecutionStatus | boolean): void;
+    unregisterExecutionGuard(id: string): void;
+    clearExecutionGuards(): void;
     pause(): void;
     resume(): void;
     /**
@@ -111,6 +122,8 @@ export declare class DefaultShortcutManager implements ShortcutManager {
     private normalizeShortcutDefinition;
     private createKeyCombinationKey;
     private isElementFocused;
+    private getExecutionStatus;
+    private getExecutionGuardStatus;
 }
 /**
  * A dependency injection token for the ShortcutManager interface.

package/dist/dts/shortcut-manager/shortcut-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shortcut-manager.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/shortcut-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAInD;;;KAGK;AACL,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,uBAAuB,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAE9B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAGzD,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,0BAA0B,CAAC;IAE3E,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,YAAY,IAAI,kBAAkB,EAAE,CAAC;IACrC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAC7D,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAGzE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAAC;IACvC,kBAAkB,IAAI,IAAI,CAAC;IAE3B,4BAA4B,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,kBAAkB,GAAG,SAAS,CAAC;IAClC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,cAAc,CAAqB;IAE3C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,CAEnC;IAED,IAAI,eAAe,IAAI,eAAe,CAAC,OAAO,CAAC,CAE9C;IAED,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMxD,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,0BAA0B;IAwG1E,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAqCrD,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQnD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIjC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IA+B3D,YAAY,IAAI,kBAAkB,EAAE;IASpC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAK5D,4BAA4B,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,EACf,MAAM,UAAQ,EACd,QAAQ,UAAQ,EAChB,OAAO,UAAQ,GACd,kBAAkB,GAAG,SAAS;IAqCjC,WAAW,IAAI,MAAM,EAAE;IAIvB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAIxE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMtC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvC,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,kBAAkB,IAAI,IAAI;IAI1B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,gBAAgB;CAMzB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,uEAE3B,CAAC"}
+{"version":3,"file":"shortcut-manager.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/shortcut-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAInD;;;KAGK;AACL,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,uBAAuB,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAE9B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAGzD,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,0BAA0B,CAAC;IAE3E,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,YAAY,IAAI,kBAAkB,EAAE,CAAC;IACrC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAC7D,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAGzE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAAC;IACvC,kBAAkB,IAAI,IAAI,CAAC;IAE3B,4BAA4B,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,kBAAkB,GAAG,SAAS,CAAC;IAClC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAE1C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,uBAAuB,GAAG,OAAO,GAAG,IAAI,CAAC;IACzF,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,oBAAoB,IAAI,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,eAAe,CAA8D;IAErF,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,CAEnC;IAED,IAAI,eAAe,IAAI,eAAe,CAAC,OAAO,CAAC,CAE9C;IAED,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMxD,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,0BAA0B;IAgG1E,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAqCrD,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQnD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIjC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IA6B3D,YAAY,IAAI,kBAAkB,EAAE;IASpC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAK5D,4BAA4B,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,EACf,MAAM,UAAQ,EACd,QAAQ,UAAQ,EAChB,OAAO,UAAQ,GACd,kBAAkB,GAAG,SAAS;IAqCjC,WAAW,IAAI,MAAM,EAAE;IAIvB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAIxE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMtC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvC,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,kBAAkB,IAAI,IAAI;IAI1B,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,uBAAuB,GAAG,OAAO,GAAG,IAAI;IAIxF,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI1C,oBAAoB,IAAI,IAAI;IAI5B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,uBAAuB;CAWhC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,uEAE3B,CAAC"}

package/dist/esm/shortcut-manager/shortcut-listener.js

@@ -11,6 +11,7 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
     constructor() {
         super(...arguments);
         this.keyListener = null;
+        this.stateSubscription = null;
         this.isListening = false;
     }
     connectedCallback() {
@@ -18,12 +19,17 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
         this.setupStateSubscription();
     }
     disconnectedCallback() {
+        var _a;
         super.disconnectedCallback();
+        (_a = this.stateSubscription) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.stateSubscription = null;
         this.removeKeyListener();
     }
     setupStateSubscription() {
+        var _a;
         // Subscribe to the pause state changes
-        this.shortcutManager.isPaused$.subscribe((isPaused) => {
+        (_a = this.stateSubscription) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.stateSubscription = this.shortcutManager.isPaused$.subscribe((isPaused) => {
             if (isPaused) {
                 this.removeKeyListener();
             }
@@ -51,23 +57,45 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
         this.isListening = false;
     }
     handleKeyDown(event) {
+        const manager = this.resolveShortcutManager(event);
         // Don't handle shortcuts if the service is paused
-        if (this.shortcutManager.isPaused) {
+        if (manager.isPaused) {
             return;
         }
-        // Don't handle shortcuts if user is typing in an input field
-        if (this.isInputElement(event.target)) {
+        // Don't handle shortcuts while user is typing in editable fields.
+        if (this.isEditableContext(event)) {
             return;
         }
         // Extract key from event.code with proper mapping for all key types
         const key = this.extractKeyFromCode(event.code);
-        const shortcut = this.shortcutManager.findShortcutByKeyCombination(key, event.ctrlKey, event.altKey, event.shiftKey, event.metaKey);
+        const shortcut = manager.findShortcutByKeyCombination(key, event.ctrlKey, event.altKey, event.shiftKey, event.metaKey);
         if (shortcut) {
             event.preventDefault();
             event.stopPropagation();
-            this.shortcutManager.executeShortcut(shortcut.id);
+            manager.executeShortcut(shortcut.id);
         }
     }
+    resolveShortcutManager(event) {
+        var _a, _b, _c;
+        const injectedManager = this.shortcutManager;
+        if ((_a = injectedManager.getShortcuts) === null || _a === void 0 ? void 0 : _a.call(injectedManager).length) {
+            return injectedManager;
+        }
+        const eventPath = (_c = (_b = event.composedPath) === null || _b === void 0 ? void 0 : _b.call(event)) !== null && _c !== void 0 ? _c : [];
+        for (const entry of eventPath) {
+            const candidate = entry === null || entry === void 0 ? void 0 : entry.shortcutManager;
+            if (this.isShortcutManager(candidate)) {
+                return candidate;
+            }
+        }
+        return injectedManager;
+    }
+    isShortcutManager(candidate) {
+        return (!!candidate &&
+            typeof candidate.findShortcutByKeyCombination === 'function' &&
+            typeof candidate.executeShortcut === 'function' &&
+            typeof candidate.getShortcuts === 'function');
+    }
     extractKeyFromCode(code) {
         // Handle regular letter keys (KeyA, KeyB, etc.)
         if (code.startsWith('Key')) {
@@ -109,23 +137,63 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
         };
         return specialKeyMap[code] || code.toLowerCase();
     }
+    getDeepActiveElement() {
+        var _a, _b;
+        let active = (_a = document.activeElement) !== null && _a !== void 0 ? _a : null;
+        while ((_b = active === null || active === void 0 ? void 0 : active.shadowRoot) === null || _b === void 0 ? void 0 : _b.activeElement) {
+            active = active.shadowRoot.activeElement;
+        }
+        return active;
+    }
+    getEventElement(event) {
+        var _a, _b, _c;
+        const path = (_b = (_a = event.composedPath) === null || _a === void 0 ? void 0 : _a.call(event)) !== null && _b !== void 0 ? _b : [];
+        const fromPath = path.find((entry) => entry instanceof Element);
+        return (_c = fromPath !== null && fromPath !== void 0 ? fromPath : event.target) !== null && _c !== void 0 ? _c : null;
+    }
+    isEditableContext(event) {
+        const eventElement = this.getEventElement(event);
+        if (eventElement && this.isInputElement(eventElement)) {
+            return true;
+        }
+        return this.isInputElement(this.getDeepActiveElement());
+    }
     isInputElement(element) {
+        var _a, _b;
         if (!element)
             return false;
-        const inputTypes = ['input', 'textarea', 'select'];
-        const tagName = element.tagName.toLowerCase();
-        if (inputTypes.includes(tagName)) {
+        const isEditableContent = (value) => value !== null && value !== undefined && value.toLowerCase() !== 'false';
+        if (isEditableContent(element.getAttribute('contenteditable')) || element.isContentEditable) {
             return true;
         }
-        // Check for contenteditable
-        if (element.contentEditable === 'true') {
+        // TODO: more generic way to check if the element is editable
+        const editableSelector = [
+            'input',
+            'textarea',
+            'select',
+            '[contenteditable="true"]',
+            '[contenteditable=""]',
+            '[role="textbox"]',
+            '[role="searchbox"]',
+            '[role="combobox"]',
+            'zero-text-field',
+            'rapid-text-field',
+            'zero-text-area',
+            'rapid-text-area',
+            'zero-combobox',
+            'rapid-combobox',
+        ].join(',');
+        if (element.matches(editableSelector) || !!element.closest(editableSelector)) {
             return true;
         }
-        // Check for role="textbox" or similar
         const role = element.getAttribute('role');
         if (role && ['textbox', 'searchbox', 'combobox'].includes(role)) {
             return true;
         }
+        const tagName = (_b = (_a = element.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase) === null || _b === void 0 ? void 0 : _b.call(_a);
+        if (tagName && ['input', 'textarea', 'select'].includes(tagName)) {
+            return true;
+        }
         return false;
     }
 };

package/dist/esm/shortcut-manager/shortcut-manager.js

@@ -12,6 +12,7 @@ export class DefaultShortcutManager {
         this.shortcutLookup = new Map(); // context:id -> ShortcutDefinition for quick lookups
         this.keyCombinationMap = new Map(); // key combination -> set of "context:id" strings
         this._isPausedSubject = new BehaviorSubject(false);
+        this.executionGuards = new Map();
     }
     get isPaused() {
         return this._isPausedSubject.value;
@@ -88,22 +89,12 @@ export class DefaultShortcutManager {
             keyCombinationDisplay,
             // Functions that can be directly used in AG Grid menu items
             disabled: () => {
-                if (this.isPaused)
-                    return true;
-                if (normalizedShortcut.canExecute) {
-                    const status = normalizedShortcut.canExecute();
-                    return status.disabled || false;
-                }
-                return false;
+                const status = this.getExecutionStatus(normalizedShortcut);
+                return status.disabled || false;
             },
             tooltip: () => {
-                if (this.isPaused)
-                    return 'Shortcuts are paused';
-                if (normalizedShortcut.canExecute) {
-                    const status = normalizedShortcut.canExecute();
-                    return status.tooltip;
-                }
-                return undefined;
+                const status = this.getExecutionStatus(normalizedShortcut);
+                return status.tooltip;
             },
         };
     }
@@ -157,11 +148,9 @@ export class DefaultShortcutManager {
                     return; // Don't execute if the required element is not focused
                 }
                 // Check if shortcut can be executed
-                if (shortcut.canExecute) {
-                    const executionStatus = shortcut.canExecute();
-                    if (executionStatus.disabled) {
-                        return; // Don't execute if disabled
-                    }
+                const executionStatus = this.getExecutionStatus(shortcut);
+                if (executionStatus.disabled) {
+                    return; // Don't execute if disabled
                 }
                 try {
                     shortcut.action();
@@ -239,6 +228,15 @@ export class DefaultShortcutManager {
     clearActiveContext() {
         this._activeContext = undefined;
     }
+    registerExecutionGuard(id, guard) {
+        this.executionGuards.set(id, guard);
+    }
+    unregisterExecutionGuard(id) {
+        this.executionGuards.delete(id);
+    }
+    clearExecutionGuards() {
+        this.executionGuards.clear();
+    }
     pause() {
         this._isPausedSubject.next(true);
     }
@@ -278,6 +276,29 @@ export class DefaultShortcutManager {
         }
         return false;
     }
+    getExecutionStatus(shortcut) {
+        if (this.isPaused) {
+            return { disabled: true, tooltip: 'Shortcuts are paused' };
+        }
+        const guardStatus = this.getExecutionGuardStatus();
+        if (guardStatus.disabled) {
+            return guardStatus;
+        }
+        if (shortcut.canExecute) {
+            return shortcut.canExecute();
+        }
+        return { disabled: false, tooltip: undefined };
+    }
+    getExecutionGuardStatus() {
+        for (const guard of this.executionGuards.values()) {
+            const result = guard();
+            const status = typeof result === 'boolean' ? { disabled: result } : result;
+            if (status === null || status === void 0 ? void 0 : status.disabled) {
+                return { disabled: true, tooltip: status.tooltip };
+            }
+        }
+        return { disabled: false, tooltip: undefined };
+    }
 }
 /**
  * A dependency injection token for the ShortcutManager interface.

package/dist/foundation-utils.api.json

@@ -2744,6 +2744,37 @@
               "isAbstract": false,
               "name": "clearActiveContext"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#clearExecutionGuards:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "clearExecutionGuards(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "clearExecutionGuards"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#executeShortcut:member(1)",
@@ -3357,6 +3388,79 @@
               "isAbstract": false,
               "name": "registerContext"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#registerExecutionGuard:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "registerExecutionGuard(id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", guard: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ShortcutExecutionStatus",
+                  "canonicalReference": "@genesislcap/foundation-utils!ShortcutExecutionStatus:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "id",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "guard",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "registerExecutionGuard"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#registerShortcut:member(1)",
@@ -3539,6 +3643,54 @@
               "isAbstract": false,
               "name": "setActiveContext"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#unregisterExecutionGuard:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unregisterExecutionGuard(id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "id",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "unregisterExecutionGuard"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-utils!DefaultShortcutManager#unregisterShortcut:member(1)",
@@ -17665,6 +17817,34 @@
               "parameters": [],
               "name": "clearActiveContext"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#clearExecutionGuards:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "clearExecutionGuards(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "clearExecutionGuards"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#executeShortcut:member(1)",
@@ -18239,6 +18419,76 @@
               ],
               "name": "registerContext"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#registerExecutionGuard:member(1)",
+              "docComment": "/**\n * Register a global execution guard.\n *\n * @remarks\n *\n * Guards are evaluated before shortcut-specific canExecute checks.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "registerExecutionGuard(id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", guard: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ShortcutExecutionStatus",
+                  "canonicalReference": "@genesislcap/foundation-utils!ShortcutExecutionStatus:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "id",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "guard",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "registerExecutionGuard"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#registerShortcut:member(1)",
@@ -18409,6 +18659,51 @@
               ],
               "name": "setActiveContext"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#unregisterExecutionGuard:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unregisterExecutionGuard(id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "id",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "unregisterExecutionGuard"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-utils!ShortcutManager#unregisterShortcut:member(1)",