@genesislcap/foundation-utils 14.422.2-alpha-10a89d0.0 → 14.422.2-alpha-1f9504f.0

package/dist/custom-elements.json

@@ -250,6 +250,208 @@
         }
       ]
     },
+    {
+      "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  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": "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": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./editable-elements"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/data/inMemoryDatabase.ts",
@@ -448,126 +650,6 @@
         }
       ]
     },
-    {
-      "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/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./design-system"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/directives/index.ts",
@@ -591,21 +673,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./base64"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/decorators/index.ts",
@@ -659,6 +726,21 @@
         }
       ]
     },
+    {
+      "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",
@@ -2703,15 +2785,134 @@
               "description": "Handle route changes by updating the pathName observable"
             },
             {
-              "kind": "method",
-              "name": "destroy",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Clean up route detection listeners and polling."
+              "kind": "method",
+              "name": "destroy",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Clean up route detection listeners and polling."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RouteUtil",
+          "declaration": {
+            "name": "RouteUtil",
+            "module": "src/route/route.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/serializers/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./json"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shortcut-manager/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./shortcut-manager"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "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_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, 'message'> & { message?: string }"
+              }
             }
           ]
         }
@@ -2719,48 +2920,50 @@
       "exports": [
         {
           "kind": "js",
-          "name": "RouteUtil",
+          "name": "SHORTCUT_BLOCKED_EVENT",
           "declaration": {
-            "name": "RouteUtil",
-            "module": "src/route/route.ts"
+            "name": "SHORTCUT_BLOCKED_EVENT",
+            "module": "src/shortcut-manager/shortcut-events.ts"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/serializers/index.ts",
-      "declarations": [],
-      "exports": [
+        },
         {
           "kind": "js",
-          "name": "*",
+          "name": "SHORTCUT_BLOCKED_DEFAULT_MESSAGE",
           "declaration": {
-            "name": "*",
-            "package": "./json"
+            "name": "SHORTCUT_BLOCKED_DEFAULT_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/shortcut-manager/index.ts",
-      "declarations": [],
-      "exports": [
+        },
         {
           "kind": "js",
-          "name": "*",
+          "name": "SHORTCUT_BLOCKED_INPUT_MESSAGE",
           "declaration": {
-            "name": "*",
-            "package": "./shortcut-manager"
+            "name": "SHORTCUT_BLOCKED_INPUT_MESSAGE",
+            "module": "src/shortcut-manager/shortcut-events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "*",
+          "name": "SHORTCUT_BLOCKED_PAUSED_MESSAGE",
           "declaration": {
-            "name": "*",
-            "package": "./shortcut-listener"
+            "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"
           }
         }
       ]
@@ -2790,6 +2993,15 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "stateSubscription",
+              "type": {
+                "text": "Subscription | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "isListening",
@@ -2845,6 +3057,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 +3124,12 @@
                   "type": {
                     "text": "HTMLElement | null"
                   }
+                },
+                {
+                  "name": "editableSelector",
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ]
             }
@@ -2932,6 +3202,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",
@@ -3199,6 +3498,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 +3698,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"
+                }
+              }
             }
           ]
         },