@genesislcap/foundation-utils 14.311.0 → 14.312.0

package/dist/custom-elements.json

@@ -127,6 +127,14 @@
             "package": "./serializers"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./shortcut-manager"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -458,126 +466,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/env/index.ts",
@@ -1036,6 +924,126 @@
         }
       ]
     },
+    {
+      "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/error/errorMap.ts",
@@ -1865,7 +1873,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/state/index.ts",
+      "path": "src/shortcut-manager/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -1873,7 +1881,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./reactive"
+            "package": "./shortcut-manager"
           }
         },
         {
@@ -1881,21 +1889,595 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./visitor"
+            "package": "./shortcut-listener"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/state/reactive.ts",
+      "path": "src/shortcut-manager/shortcut-listener.ts",
       "declarations": [
         {
-          "kind": "function",
-          "name": "reactive",
-          "return": {
-            "type": {
-              "text": ""
+          "kind": "class",
+          "description": "A custom element that listens for keyboard shortcuts.",
+          "name": "FoundationShortcutListener",
+          "members": [
+            {
+              "kind": "field",
+              "name": "shortcutManager",
+              "type": {
+                "text": "ShortcutManager"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "keyListener",
+              "type": {
+                "text": "((event: KeyboardEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "isListening",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "setupStateSubscription",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "addKeyListener",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "removeKeyListener",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "extractKeyFromCode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "code",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isInputElement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                }
+              ]
+            }
+          ],
+          "superclass": {
+            "name": "FASTElement",
+            "package": "@microsoft/fast-element"
+          },
+          "tagName": "foundation-shortcut-listener",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FoundationShortcutListener",
+          "declaration": {
+            "name": "FoundationShortcutListener",
+            "module": "src/shortcut-manager/shortcut-listener.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "foundation-shortcut-listener",
+          "declaration": {
+            "name": "FoundationShortcutListener",
+            "module": "src/shortcut-manager/shortcut-listener.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shortcut-manager/shortcut-manager.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Default implementation of the ShortcutManager interface",
+          "name": "DefaultShortcutManager",
+          "members": [
+            {
+              "kind": "field",
+              "name": "shortcuts",
+              "privacy": "private",
+              "default": "new Map<string, Map<string, ShortcutDefinition>>()"
+            },
+            {
+              "kind": "field",
+              "name": "shortcutLookup",
+              "privacy": "private",
+              "default": "new Map<string, ShortcutDefinition>()"
+            },
+            {
+              "kind": "field",
+              "name": "keyCombinationMap",
+              "privacy": "private",
+              "default": "new Map<string, Set<string>>()"
+            },
+            {
+              "kind": "field",
+              "name": "_isPausedSubject",
+              "privacy": "private",
+              "default": "new BehaviorSubject<boolean>(false)"
+            },
+            {
+              "kind": "field",
+              "name": "_activeContext",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "isPaused",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isPaused$",
+              "type": {
+                "text": "Observable<boolean>"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isPausedSubject",
+              "type": {
+                "text": "BehaviorSubject<boolean>"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "registerShortcuts",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcuts",
+                  "type": {
+                    "text": "ShortcutDefinition[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "registerShortcut",
+              "return": {
+                "type": {
+                  "text": "ShortcutRegistrationResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcut",
+                  "type": {
+                    "text": "ShortcutDefinition"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "unregisterShortcut",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "unregisterShortcutsByContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "executeShortcut",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "executeShortcutByContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getShortcuts",
+              "return": {
+                "type": {
+                  "text": "ShortcutDefinition[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getShortcutsByContext",
+              "return": {
+                "type": {
+                  "text": "ShortcutDefinition[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "findShortcutByKeyCombination",
+              "return": {
+                "type": {
+                  "text": "ShortcutDefinition | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "ctrlKey",
+                  "default": "false"
+                },
+                {
+                  "name": "altKey",
+                  "default": "false"
+                },
+                {
+                  "name": "shiftKey",
+                  "default": "false"
+                },
+                {
+                  "name": "metaKey",
+                  "default": "false"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getContexts",
+              "return": {
+                "type": {
+                  "text": "string[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getShortcutsByContextMap",
+              "return": {
+                "type": {
+                  "text": "Map<string, Map<string, ShortcutDefinition>>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "registerContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "setActiveContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "context",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getActiveContext",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "clearActiveContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "pause",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resume",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "normalizeShortcutDefinition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ShortcutDefinition"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shortcut",
+                  "type": {
+                    "text": "ShortcutDefinition"
+                  }
+                }
+              ],
+              "description": "Normalizes a shortcut definition to handle option/alt equivalence\nIf optionKey is set, altKey will also be set to true (and vice versa)"
+            },
+            {
+              "kind": "method",
+              "name": "createKeyCombinationKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "ctrlKey",
+                  "default": "false"
+                },
+                {
+                  "name": "altKey",
+                  "default": "false"
+                },
+                {
+                  "name": "shiftKey",
+                  "default": "false"
+                },
+                {
+                  "name": "metaKey",
+                  "default": "false"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isElementFocused",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "ShortcutManager",
+          "description": "A dependency injection token for the ShortcutManager interface.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DefaultShortcutManager",
+          "declaration": {
+            "name": "DefaultShortcutManager",
+            "module": "src/shortcut-manager/shortcut-manager.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ShortcutManager",
+          "declaration": {
+            "name": "ShortcutManager",
+            "module": "src/shortcut-manager/shortcut-manager.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./reactive"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./visitor"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/reactive.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "reactive",
+          "return": {
+            "type": {
+              "text": ""
             }
           },
           "parameters": [
@@ -2444,6 +3026,105 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/os-platform.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Platform detection utilities for cross-platform compatibility",
+          "name": "OperatingSystemUtils",
+          "members": [
+            {
+              "kind": "field",
+              "name": "isMacOS",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "description": "Detects if the current platform is macOS",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isWindows",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "description": "Detects if the current platform is Windows",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isLinux",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "description": "Detects if the current platform is Linux",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "getModifierSymbols",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "{\n    ctrl: string;\n    alt: string;\n    shift: string;\n    meta: string;\n  }"
+                }
+              },
+              "description": "Gets the appropriate modifier key symbols for the current platform"
+            },
+            {
+              "kind": "method",
+              "name": "formatKeyCombination",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "ctrlKey",
+                  "default": "false"
+                },
+                {
+                  "name": "altKey",
+                  "default": "false"
+                },
+                {
+                  "name": "shiftKey",
+                  "default": "false"
+                },
+                {
+                  "name": "metaKey",
+                  "default": "false"
+                }
+              ],
+              "description": "Formats a key combination with platform-appropriate symbols"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "OperatingSystemUtils",
+          "declaration": {
+            "name": "OperatingSystemUtils",
+            "module": "src/utils/os-platform.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/uuid/index.ts",