@genesislcap/foundation-utils 15.71.1-alpha-71cb16e4d3.0 → 15.73.0-FUI-2628.4

package/dist/custom-elements.json

@@ -260,7 +260,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/directives/index.ts",
+      "path": "src/decorators/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -268,217 +268,45 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./sync"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
+            "package": "./renderOnChange"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/design-system/design-system.ts",
+      "path": "src/decorators/renderOnChange.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "assureDesignSystem",
-          "return": {
-            "type": {
-              "text": "DesignSystemModule"
-            }
-          },
-          "parameters": [
-            {
-              "name": "module",
-              "type": {
-                "text": "DesignSystemModule"
-              }
-            }
-          ],
-          "description": "assureDesignSystem.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystem",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystemPrefix",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
+          "name": "renderOnChange",
           "parameters": [
             {
-              "name": "element",
+              "name": "target",
               "type": {
-                "text": "HTMLElement"
+                "text": "FASTElement & { render(): void }"
               },
-              "description": "The starting HTML element"
+              "description": "The target to define the property change handler on."
             },
             {
-              "name": "fallbackPrefix",
+              "name": "name",
               "type": {
                 "text": "string"
               },
-              "description": "The prefix to fallback to if the provider is not available"
+              "description": "The property name."
             }
           ],
-          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
           "privacy": "public"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "assureDesignSystem",
-          "declaration": {
-            "name": "assureDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystem",
-          "declaration": {
-            "name": "getCurrentDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystemPrefix",
-          "declaration": {
-            "name": "getCurrentDesignSystemPrefix",
-            "module": "src/design-system/design-system.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/editable-elements.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
-          "type": {
-            "text": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]"
-          },
-          "default": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]",
-          "description": "Base selectors treated as editable context regardless of design system.\nIncludes native controls, contenteditable, and ARIA-editable roles."
-        },
-        {
-          "kind": "variable",
-          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
-          "type": {
-            "text": "Record<\n  EditableDesignSystemPrefix,\n  readonly string[]\n>"
-          },
-          "default": "{\n  rapid: buildDesignSystemEditableSelectors('rapid'),\n  zero: buildDesignSystemEditableSelectors('zero'),\n}",
-          "description": "Design-system specific editable host selectors."
-        },
-        {
-          "kind": "function",
-          "name": "buildEditableElementSelector",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          },
-          "parameters": [
-            {
-              "name": "designSystems",
-              "type": {
-                "text": "readonly EditableDesignSystemPrefix[]"
-              }
-            },
-            {
-              "name": "customEditableSelectors",
-              "default": "[]",
-              "type": {
-                "text": "readonly string[]"
-              }
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
-          "declaration": {
-            "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
-          "declaration": {
-            "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "buildEditableElementSelector",
-          "declaration": {
-            "name": "buildEditableElementSelector",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./design-system"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "renderOnChange",
           "declaration": {
-            "name": "*",
-            "package": "./editable-elements"
+            "name": "renderOnChange",
+            "module": "src/decorators/renderOnChange.ts"
           }
         }
       ]
@@ -617,58 +445,288 @@
               ]
             },
             {
-              "kind": "method",
-              "name": "onBeforeUpdate",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
+              "kind": "method",
+              "name": "onBeforeUpdate",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "Listener<DatabaseEvent.BeforeUpdate<T>>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onAfterUpdate",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "Listener<DatabaseEvent.AfterUpdate<T>>"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "InMemoryDatabase",
+          "declaration": {
+            "name": "InMemoryDatabase",
+            "module": "src/data/inMemoryDatabase.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/data/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./inMemoryDatabase"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/design-system.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "assureDesignSystem",
+          "return": {
+            "type": {
+              "text": "DesignSystemModule"
+            }
+          },
+          "parameters": [
+            {
+              "name": "module",
+              "type": {
+                "text": "DesignSystemModule"
+              }
+            }
+          ],
+          "description": "assureDesignSystem.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystem",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystemPrefix",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assureDesignSystem",
+          "declaration": {
+            "name": "assureDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystem",
+          "declaration": {
+            "name": "getCurrentDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystemPrefix",
+          "declaration": {
+            "name": "getCurrentDesignSystemPrefix",
+            "module": "src/design-system/design-system.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/editable-elements.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
+          "type": {
+            "text": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]"
+          },
+          "default": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]",
+          "description": "Base selectors treated as editable context regardless of design system.\nIncludes native controls, contenteditable, and ARIA-editable roles."
+        },
+        {
+          "kind": "variable",
+          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+          "type": {
+            "text": "Record<\n  EditableDesignSystemPrefix,\n  readonly string[]\n>"
+          },
+          "default": "{\n  rapid: buildDesignSystemEditableSelectors('rapid'),\n  zero: buildDesignSystemEditableSelectors('zero'),\n}",
+          "description": "Design-system specific editable host selectors."
+        },
+        {
+          "kind": "function",
+          "name": "buildEditableElementSelector",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "designSystems",
+              "type": {
+                "text": "readonly EditableDesignSystemPrefix[]"
+              }
+            },
+            {
+              "name": "customEditableSelectors",
+              "default": "[]",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "isEditableKeyboardEvent",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "KeyboardEvent"
               },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "Listener<DatabaseEvent.BeforeUpdate<T>>"
-                  }
-                }
-              ]
+              "description": "The keyboard event."
             },
             {
-              "kind": "method",
-              "name": "onAfterUpdate",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
+              "name": "editableSelector",
+              "default": "DEFAULT_EDITABLE_ELEMENT_SELECTOR",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "Listener<DatabaseEvent.AfterUpdate<T>>"
-                  }
-                }
-              ]
+              "description": "CSS selector for editable elements. Defaults to the base selectors plus\nrapid editable hosts."
             }
-          ]
+          ],
+          "description": "Whether a keyboard event comes from an editable element, i.e. the user is typing.",
+          "privacy": "public"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "InMemoryDatabase",
+          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
           "declaration": {
-            "name": "InMemoryDatabase",
-            "module": "src/data/inMemoryDatabase.ts"
+            "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
+            "module": "src/design-system/editable-elements.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+          "declaration": {
+            "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+            "module": "src/design-system/editable-elements.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildEditableElementSelector",
+          "declaration": {
+            "name": "buildEditableElementSelector",
+            "module": "src/design-system/editable-elements.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isEditableKeyboardEvent",
+          "declaration": {
+            "name": "isEditableKeyboardEvent",
+            "module": "src/design-system/editable-elements.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/data/index.ts",
+      "path": "src/design-system/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -676,29 +734,22 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./inMemoryDatabase"
+            "package": "./design-system"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
-      "declarations": [],
-      "exports": [
+        },
         {
           "kind": "js",
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./base64"
+            "package": "./editable-elements"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/decorators/index.ts",
+      "path": "src/directives/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -706,45 +757,30 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./renderOnChange"
+            "package": "./sync"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/decorators/renderOnChange.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "renderOnChange",
-          "parameters": [
-            {
-              "name": "target",
-              "type": {
-                "text": "FASTElement & { render(): void }"
-              },
-              "description": "The target to define the property change handler on."
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The property name."
-            }
-          ],
-          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
-          "privacy": "public"
-        }
-      ],
+      "path": "src/encoding/index.ts",
+      "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "renderOnChange",
+          "name": "*",
           "declaration": {
-            "name": "renderOnChange",
-            "module": "src/decorators/renderOnChange.ts"
+            "name": "*",
+            "package": "./base64"
           }
         }
       ]
@@ -3063,6 +3099,14 @@
             "name": "*",
             "package": "./shortcut-events"
           }
+        },
+        {
+          "kind": "js",
+          "name": "extractKeyFromCode",
+          "declaration": {
+            "name": "extractKeyFromCode",
+            "module": "./shortcut-keyboard"
+          }
         }
       ]
     },
@@ -3202,6 +3246,41 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shortcut-manager/shortcut-keyboard.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "extractKeyFromCode",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "code",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Maps `KeyboardEvent.code` to the shortcut key string used by ShortcutManager.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "extractKeyFromCode",
+          "declaration": {
+            "name": "extractKeyFromCode",
+            "module": "src/shortcut-manager/shortcut-keyboard.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shortcut-manager/shortcut-listener.ts",
@@ -3259,34 +3338,6 @@
                 }
               ]
             },
-            {
-              "kind": "method",
-              "name": "extractKeyFromCode",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "code",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getDeepActiveElement",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Element | null"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "getEventElement",
@@ -3304,54 +3355,6 @@
                   }
                 }
               ]
-            },
-            {
-              "kind": "method",
-              "name": "isEditableContext",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                },
-                {
-                  "name": "editableSelector",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "isInputElement",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "element",
-                  "type": {
-                    "text": "HTMLElement | null"
-                  }
-                },
-                {
-                  "name": "editableSelector",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
             }
           ],
           "superclass": {

package/dist/dts/design-system/editable-elements.d.ts

@@ -9,4 +9,16 @@ export declare const BASE_EDITABLE_ELEMENT_SELECTORS: readonly ["input", "textar
  */
 export declare const DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS: Record<EditableDesignSystemPrefix, readonly string[]>;
 export declare function buildEditableElementSelector(designSystems: readonly EditableDesignSystemPrefix[], customEditableSelectors?: readonly string[]): string;
+/**
+ * Whether a keyboard event comes from an editable element, i.e. the user is typing.
+ * @remarks Checks the innermost event target (through shadow roots), then the deep active element.
+ * An element counts as editable when it is `contenteditable` or matches / is nested in an element
+ * matching `editableSelector`. Pass `shortcutManager.getEditableSelector()` to use the selector
+ * configured via `configureEditableContext`.
+ * @param event - The keyboard event.
+ * @param editableSelector - CSS selector for editable elements. Defaults to the base selectors plus
+ * rapid editable hosts.
+ * @public
+ */
+export declare function isEditableKeyboardEvent(event: KeyboardEvent, editableSelector?: string): boolean;
 //# sourceMappingURL=editable-elements.d.ts.map

package/dist/dts/design-system/editable-elements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editable-elements.d.ts","sourceRoot":"","sources":["../../../src/design-system/editable-elements.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,MAAM,CAAC;AAW1D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,uKAIlC,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,wCAAwC,EAAE,MAAM,CAC3D,0BAA0B,EAC1B,SAAS,MAAM,EAAE,CAIlB,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,SAAS,0BAA0B,EAAE,EACpD,uBAAuB,GAAE,SAAS,MAAM,EAAO,GAC9C,MAAM,CASR"}
+{"version":3,"file":"editable-elements.d.ts","sourceRoot":"","sources":["../../../src/design-system/editable-elements.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,MAAM,CAAC;AAW1D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,uKAIlC,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,wCAAwC,EAAE,MAAM,CAC3D,0BAA0B,EAC1B,SAAS,MAAM,EAAE,CAIlB,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,SAAS,0BAA0B,EAAE,EACpD,uBAAuB,GAAE,SAAS,MAAM,EAAO,GAC9C,MAAM,CASR;AAsCD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,gBAAgB,GAAE,MAA0C,GAC3D,OAAO,CAKT"}

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

@@ -1,4 +1,5 @@
 export * from './shortcut-manager';
 export * from './shortcut-listener';
 export * from './shortcut-events';
+export { extractKeyFromCode } from './shortcut-keyboard';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Maps `KeyboardEvent.code` to the shortcut key string used by ShortcutManager.
+ * @remarks Use with `ShortcutManager.findShortcutByKeyCombination(extractKeyFromCode(event.code), ...)`.
+ * @public
+ */
+export declare function extractKeyFromCode(code: string): string;
+//# sourceMappingURL=shortcut-keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut-keyboard.d.ts","sourceRoot":"","sources":["../../../src/shortcut-manager/shortcut-keyboard.ts"],"names":[],"mappings":"AA8BA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBvD"}

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

@@ -14,10 +14,6 @@ export declare class FoundationShortcutListener extends FASTElement {
     private addKeyListener;
     private removeKeyListener;
     private handleKeyDown;
-    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;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,WAAW,CAAS;IAE5B,iBAAiB;IAKjB,oBAAoB;IAKpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;CAYvB"}
+{"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;AAKrE,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,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/esm/design-system/editable-elements.js

@@ -28,3 +28,46 @@ export function buildEditableElementSelector(designSystems, customEditableSelect
     const customSelectors = customEditableSelectors.filter(Boolean);
     return Array.from(new Set([...BASE_EDITABLE_ELEMENT_SELECTORS, ...designSystemSelectors, ...customSelectors])).join(',');
 }
+const DEFAULT_EDITABLE_ELEMENT_SELECTOR = buildEditableElementSelector(['rapid']);
+const ELEMENT_NODE = 1;
+const isElement = (value) => (value === null || value === void 0 ? void 0 : value.nodeType) === ELEMENT_NODE;
+function 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 : [];
+    return (_c = path.find(isElement)) !== null && _c !== void 0 ? _c : (isElement(event.target) ? event.target : null);
+}
+function 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;
+}
+const isEditableAttributeValue = (value) => value !== null && value.toLowerCase() !== 'false';
+function isEditableElement(element, editableSelector) {
+    if (!element)
+        return false;
+    if (isEditableAttributeValue(element.getAttribute('contenteditable')) ||
+        element.isContentEditable) {
+        return true;
+    }
+    if (!editableSelector)
+        return false;
+    return element.matches(editableSelector) || !!element.closest(editableSelector);
+}
+/**
+ * Whether a keyboard event comes from an editable element, i.e. the user is typing.
+ * @remarks Checks the innermost event target (through shadow roots), then the deep active element.
+ * An element counts as editable when it is `contenteditable` or matches / is nested in an element
+ * matching `editableSelector`. Pass `shortcutManager.getEditableSelector()` to use the selector
+ * configured via `configureEditableContext`.
+ * @param event - The keyboard event.
+ * @param editableSelector - CSS selector for editable elements. Defaults to the base selectors plus
+ * rapid editable hosts.
+ * @public
+ */
+export function isEditableKeyboardEvent(event, editableSelector = DEFAULT_EDITABLE_ELEMENT_SELECTOR) {
+    return (isEditableElement(getEventElement(event), editableSelector) ||
+        isEditableElement(getDeepActiveElement(), editableSelector));
+}

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

@@ -1,3 +1,4 @@
 export * from './shortcut-manager';
 export * from './shortcut-listener';
 export * from './shortcut-events';
+export { extractKeyFromCode } from './shortcut-keyboard';

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

@@ -0,0 +1,49 @@
+const specialKeyMap = {
+    Space: 'space',
+    Enter: 'enter',
+    Escape: 'escape',
+    Tab: 'tab',
+    Backspace: 'backspace',
+    Delete: 'delete',
+    Insert: 'insert',
+    Home: 'home',
+    End: 'end',
+    PageUp: 'pageup',
+    PageDown: 'pagedown',
+    ArrowUp: 'arrowup',
+    ArrowDown: 'arrowdown',
+    ArrowLeft: 'arrowleft',
+    ArrowRight: 'arrowright',
+    F1: 'f1',
+    F2: 'f2',
+    F3: 'f3',
+    F4: 'f4',
+    F5: 'f5',
+    F6: 'f6',
+    F7: 'f7',
+    F8: 'f8',
+    F9: 'f9',
+    F10: 'f10',
+    F11: 'f11',
+    F12: 'f12',
+};
+/**
+ * Maps `KeyboardEvent.code` to the shortcut key string used by ShortcutManager.
+ * @remarks Use with `ShortcutManager.findShortcutByKeyCombination(extractKeyFromCode(event.code), ...)`.
+ * @public
+ */
+export function extractKeyFromCode(code) {
+    if (!code) {
+        return '';
+    }
+    // Handle regular letter keys (KeyA, KeyB, etc.)
+    if (code.startsWith('Key')) {
+        return code.replace('Key', '').toLowerCase();
+    }
+    // Handle digit keys (Digit0, Digit1, etc.)
+    if (code.startsWith('Digit')) {
+        return code.replace('Digit', '');
+    }
+    // Handle special keys with direct mapping
+    return specialKeyMap[code] || code.toLowerCase();
+}

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

@@ -1,7 +1,9 @@
 import { __decorate } from "tslib";
 import { customElement, FASTElement } from '@microsoft/fast-element';
 import { inject } from '@microsoft/fast-foundation';
+import { isEditableKeyboardEvent } from '../design-system/editable-elements';
 import { emitShortcutBlockedEvent } from './shortcut-events';
+import { extractKeyFromCode } from './shortcut-keyboard';
 import { ShortcutManager } from './shortcut-manager';
 /**
  * A custom element that listens for keyboard shortcuts.
@@ -44,13 +46,13 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
         const eventTarget = (_a = this.getEventElement(event)) !== null && _a !== void 0 ? _a : this;
         const hasModifier = event.ctrlKey || event.altKey || event.shiftKey || event.metaKey;
         // Extract key from event.code with proper mapping for all key types
-        const key = this.extractKeyFromCode(event.code);
+        const key = extractKeyFromCode(event.code);
         const shortcut = manager.findShortcutByKeyCombination(key, event.ctrlKey, event.altKey, event.shiftKey, event.metaKey);
         if (!shortcut) {
             return;
         }
         // Don't handle shortcuts while user is typing in editable fields.
-        if (this.isEditableContext(event, editableSelector)) {
+        if (isEditableKeyboardEvent(event, editableSelector)) {
             if (hasModifier && shortcut.emitBlockedEvent !== false) {
                 emitShortcutBlockedEvent({
                     shortcutId: shortcut.id,
@@ -67,79 +69,12 @@ let FoundationShortcutListener = class FoundationShortcutListener extends FASTEl
             manager.executeShortcut(shortcut.id, eventTarget);
         }
     }
-    extractKeyFromCode(code) {
-        // Handle regular letter keys (KeyA, KeyB, etc.)
-        if (code.startsWith('Key')) {
-            return code.replace('Key', '').toLowerCase();
-        }
-        // Handle digit keys (Digit0, Digit1, etc.)
-        if (code.startsWith('Digit')) {
-            return code.replace('Digit', '');
-        }
-        // Handle special keys with direct mapping
-        const specialKeyMap = {
-            Space: 'space',
-            Enter: 'enter',
-            Escape: 'escape',
-            Tab: 'tab',
-            Backspace: 'backspace',
-            Delete: 'delete',
-            Insert: 'insert',
-            Home: 'home',
-            End: 'end',
-            PageUp: 'pageup',
-            PageDown: 'pagedown',
-            ArrowUp: 'arrowup',
-            ArrowDown: 'arrowdown',
-            ArrowLeft: 'arrowleft',
-            ArrowRight: 'arrowright',
-            F1: 'f1',
-            F2: 'f2',
-            F3: 'f3',
-            F4: 'f4',
-            F5: 'f5',
-            F6: 'f6',
-            F7: 'f7',
-            F8: 'f8',
-            F9: 'f9',
-            F10: 'f10',
-            F11: 'f11',
-            F12: 'f12',
-        };
-        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, editableSelector) {
-        const eventElement = this.getEventElement(event);
-        if (eventElement && this.isInputElement(eventElement, editableSelector)) {
-            return true;
-        }
-        return this.isInputElement(this.getDeepActiveElement(), editableSelector);
-    }
-    isInputElement(element, editableSelector) {
-        if (!element)
-            return false;
-        const isEditableContent = (value) => value !== null && value !== undefined && value.toLowerCase() !== 'false';
-        if (isEditableContent(element.getAttribute('contenteditable')) || element.isContentEditable) {
-            return true;
-        }
-        if (!editableSelector)
-            return false;
-        return element.matches(editableSelector) || !!element.closest(editableSelector);
-    }
 };
 __decorate([
     inject(ShortcutManager)

package/dist/foundation-utils.api.json

@@ -6930,6 +6930,51 @@
             "endIndex": 2
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!extractKeyFromCode:function(1)",
+          "docComment": "/**\n * Maps `KeyboardEvent.code` to the shortcut key string used by ShortcutManager.\n *\n * @remarks\n *\n * Use with `ShortcutManager.findShortcutByKeyCombination(extractKeyFromCode(event.code), ...)`.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function extractKeyFromCode(code: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/shortcut-manager/shortcut-keyboard.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "code",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "extractKeyFromCode"
+        },
         {
           "kind": "Enum",
           "canonicalReference": "@genesislcap/foundation-utils!FontStyle:enum",
@@ -10134,6 +10179,68 @@
           "parameters": [],
           "name": "isDev"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!isEditableKeyboardEvent:function(1)",
+          "docComment": "/**\n * Whether a keyboard event comes from an editable element, i.e. the user is typing.\n *\n * @remarks\n *\n * Checks the innermost event target (through shadow roots), then the deep active element. An element counts as editable when it is `contenteditable` or matches / is nested in an element matching `editableSelector`. Pass `shortcutManager.getEditableSelector()` to use the selector configured via `configureEditableContext`.\n *\n * @param event - The keyboard event.\n *\n * @param editableSelector - CSS selector for editable elements. Defaults to the base selectors plus rapid editable hosts.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isEditableKeyboardEvent(event: "
+            },
+            {
+              "kind": "Reference",
+              "text": "KeyboardEvent",
+              "canonicalReference": "!KeyboardEvent:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", editableSelector?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/design-system/editable-elements.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "event",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "editableSelector",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "isEditableKeyboardEvent"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!isFeatureActivated:function(1)",

package/dist/foundation-utils.d.ts

@@ -761,6 +761,13 @@ declare type EventListener_2<T = any> = (data: T) => void;
  */
 export declare type EventName = 'input' | 'change' | 'default';
 
+/**
+ * Maps `KeyboardEvent.code` to the shortcut key string used by ShortcutManager.
+ * @remarks Use with `ShortcutManager.findShortcutByKeyCombination(extractKeyFromCode(event.code), ...)`.
+ * @public
+ */
+export declare function extractKeyFromCode(code: string): string;
+
 /**
  * An enum of possible font styles.
  * @public
@@ -856,11 +863,7 @@ export declare class FoundationShortcutListener extends FASTElement {
     private addKeyListener;
     private removeKeyListener;
     private handleKeyDown;
-    private extractKeyFromCode;
-    private getDeepActiveElement;
     private getEventElement;
-    private isEditableContext;
-    private isInputElement;
 }
 
 /** @public */
@@ -1112,6 +1115,19 @@ export declare const inSymphonyDesktop: () => boolean;
  */
 export declare const isDev: () => boolean;
 
+/**
+ * Whether a keyboard event comes from an editable element, i.e. the user is typing.
+ * @remarks Checks the innermost event target (through shadow roots), then the deep active element.
+ * An element counts as editable when it is `contenteditable` or matches / is nested in an element
+ * matching `editableSelector`. Pass `shortcutManager.getEditableSelector()` to use the selector
+ * configured via `configureEditableContext`.
+ * @param event - The keyboard event.
+ * @param editableSelector - CSS selector for editable elements. Defaults to the base selectors plus
+ * rapid editable hosts.
+ * @public
+ */
+export declare function isEditableKeyboardEvent(event: KeyboardEvent, editableSelector?: string): boolean;
+
 /**
  * Returns true when `feature.<name>` is present in the current URL query string.
  * @public

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "15.71.1-alpha-71cb16e4d3.0",
+  "version": "15.73.0-FUI-2628.4",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,17 +29,17 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/genx": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/ts-builder": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/uvu-playwright-builder": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/vite-builder": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/webpack-builder": "15.71.1-alpha-71cb16e4d3.0",
+    "@genesislcap/foundation-testing": "15.73.0-FUI-2628.4",
+    "@genesislcap/genx": "15.73.0-FUI-2628.4",
+    "@genesislcap/ts-builder": "15.73.0-FUI-2628.4",
+    "@genesislcap/uvu-playwright-builder": "15.73.0-FUI-2628.4",
+    "@genesislcap/vite-builder": "15.73.0-FUI-2628.4",
+    "@genesislcap/webpack-builder": "15.73.0-FUI-2628.4",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "15.71.1-alpha-71cb16e4d3.0",
-    "@genesislcap/foundation-logger": "15.71.1-alpha-71cb16e4d3.0",
+    "@genesislcap/expression-builder": "15.73.0-FUI-2628.4",
+    "@genesislcap/foundation-logger": "15.73.0-FUI-2628.4",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",