@genesislcap/foundation-utils 14.426.0 → 14.426.1-alpha-79840b9.0

package/dist/custom-elements.json

@@ -555,22 +555,81 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
-      "declarations": [],
+      "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  ShortcutDesignSystemPrefix,\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 ShortcutDesignSystemPrefix[]"
+              }
+            },
+            {
+              "name": "customEditableSelectors",
+              "default": "[]",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ]
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
           "declaration": {
-            "name": "*",
-            "package": "./design-system"
+            "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/directives/index.ts",
+      "path": "src/design-system/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -578,7 +637,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./sync"
+            "package": "./design-system"
           }
         },
         {
@@ -586,7 +645,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./when-else"
+            "package": "./editable-elements"
           }
         }
       ]
@@ -644,6 +703,44 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/encoding/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./base64"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/env/index.ts",
@@ -1119,21 +1216,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./base64"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/error/errorMap.ts",
@@ -2762,6 +2844,150 @@
             "name": "*",
             "package": "./shortcut-listener"
           }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./shortcut-events"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shortcut-manager/shortcut-events.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_EVENT",
+          "type": {
+            "text": "string"
+          },
+          "default": "'foundation-shortcut-blocked'"
+        },
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_DEFAULT_TITLE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'Shortcut blocked'"
+        },
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_DEFAULT_MESSAGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'This shortcut is currently unavailable in this context.'"
+        },
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_INPUT_MESSAGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'This shortcut is unavailable while typing in an input field.'"
+        },
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_PAUSED_MESSAGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'Shortcuts are paused.'"
+        },
+        {
+          "kind": "variable",
+          "name": "SHORTCUT_BLOCKED_ELEMENT_FOCUS_MESSAGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'This shortcut is unavailable in the current focus context.'"
+        },
+        {
+          "kind": "function",
+          "name": "emitShortcutBlockedEvent",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "detail",
+              "type": {
+                "text": "Omit<ShortcutBlockedEventDetail, 'blockedMessage'> & {\n    blockedMessage?: ShortcutBlockedMessage;\n  }"
+              }
+            },
+            {
+              "name": "target",
+              "optional": true,
+              "type": {
+                "text": "EventTarget | null"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_EVENT",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_EVENT",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_DEFAULT_TITLE",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_DEFAULT_TITLE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_DEFAULT_MESSAGE",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_DEFAULT_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_INPUT_MESSAGE",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_INPUT_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_PAUSED_MESSAGE",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_PAUSED_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SHORTCUT_BLOCKED_ELEMENT_FOCUS_MESSAGE",
+          "declaration": {
+            "name": "SHORTCUT_BLOCKED_ELEMENT_FOCUS_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "emitShortcutBlockedEvent",
+          "declaration": {
+            "name": "emitShortcutBlockedEvent",
+            "module": "src/shortcut-manager/shortcut-events.ts"
+          }
         }
       ]
     },
@@ -2799,11 +3025,6 @@
               "privacy": "private",
               "default": "false"
             },
-            {
-              "kind": "method",
-              "name": "setupStateSubscription",
-              "privacy": "private"
-            },
             {
               "kind": "method",
               "name": "addKeyListener",
@@ -2845,6 +3066,58 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "getDeepActiveElement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Element | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getEventElement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Element | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "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",
@@ -2860,6 +3133,12 @@
                   "type": {
                     "text": "HTMLElement | null"
                   }
+                },
+                {
+                  "name": "editableSelector",
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ]
             }
@@ -2932,6 +3211,35 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "executionGuards",
+              "privacy": "private",
+              "default": "new Map<string, () => ShortcutExecutionStatus | boolean>()"
+            },
+            {
+              "kind": "field",
+              "name": "editableContextConfig",
+              "type": {
+                "text": "Required<ShortcutEditableContextConfig>"
+              },
+              "privacy": "private",
+              "default": "{\n    ...DEFAULT_SHORTCUT_EDITABLE_CONTEXT_CONFIG,\n  }"
+            },
+            {
+              "kind": "field",
+              "name": "editableSelector",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "blockedMessageConfig",
+              "type": {
+                "text": "Required<ShortcutBlockedMessageConfig>"
+              },
+              "privacy": "private",
+              "default": "{\n    ...DEFAULT_SHORTCUT_BLOCKED_MESSAGE_CONFIG,\n  }"
+            },
             {
               "kind": "field",
               "name": "isPaused",
@@ -3044,6 +3352,56 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "eventTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "EventTarget | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "shouldEmitBlockedEvent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcut",
+                  "optional": true,
+                  "type": {
+                    "text": "ShortcutDefinition"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "resolveBlockedMessage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ShortcutBlockedMessage"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcut",
+                  "type": {
+                    "text": "ShortcutDefinition | undefined"
+                  }
+                },
+                {
+                  "name": "fallback",
+                  "type": {
+                    "text": "ShortcutBlockedMessage"
+                  }
                 }
               ]
             },
@@ -3067,6 +3425,13 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "eventTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "EventTarget | null"
+                  }
                 }
               ]
             },
@@ -3199,6 +3564,118 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "registerExecutionGuard",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "guard",
+                  "type": {
+                    "text": "() => ShortcutExecutionStatus | boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "unregisterExecutionGuard",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "clearExecutionGuards",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "configureEditableContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "config",
+                  "default": "{}",
+                  "type": {
+                    "text": "ShortcutEditableContextConfig"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getEditableContextConfig",
+              "return": {
+                "type": {
+                  "text": "Required<ShortcutEditableContextConfig>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getEditableSelector",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "configureBlockedMessages",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "config",
+                  "default": "{}",
+                  "type": {
+                    "text": "ShortcutBlockedMessageConfig"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getBlockedMessages",
+              "return": {
+                "type": {
+                  "text": "Required<ShortcutBlockedMessageConfig>"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "pause",
@@ -3287,6 +3764,44 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "getExecutionStatus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ShortcutExecutionStatus"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcut",
+                  "type": {
+                    "text": "ShortcutDefinition"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getExecutionGuardStatus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ShortcutExecutionStatus"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "refreshEditableSelector",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             }
           ]
         },

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

@@ -0,0 +1,12 @@
+import { ShortcutDesignSystemPrefix } from '../shortcut-manager/shortcut-manager';
+/**
+ * Base selectors treated as editable context regardless of design system.
+ * Includes native controls, contenteditable, and ARIA-editable roles.
+ */
+export declare const BASE_EDITABLE_ELEMENT_SELECTORS: readonly ["input", "textarea", "select", "[contenteditable=\"true\"]", "[contenteditable=\"\"]", "[role=\"textbox\"]", "[role=\"searchbox\"]", "[role=\"combobox\"]"];
+/**
+ * Design-system specific editable host selectors.
+ */
+export declare const DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS: Record<ShortcutDesignSystemPrefix, readonly string[]>;
+export declare function buildEditableElementSelector(designSystems: readonly ShortcutDesignSystemPrefix[], customEditableSelectors?: readonly string[]): string;
+//# sourceMappingURL=editable-elements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editable-elements.d.ts","sourceRoot":"","sources":["../../../src/design-system/editable-elements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAWlF;;;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"}

package/dist/dts/design-system/index.d.ts

@@ -1,2 +1,3 @@
 export * from './design-system';
+export * from './editable-elements';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/design-system/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/design-system/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/design-system/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}