@microsoft/teams-js 2.42.0 → 2.44.0

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.42.0/js/MicrosoftTeams.min.js) or point your package manager at them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.44.0/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the library inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.42.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-kKQjKs75BOHapvR+ooLO1oHO5e6YewZT5fp0U6EgT22v+ADFCcVPHqj1cSs4iIBO"
+  src="https://res.cdn.office.net/teams-js/2.43.1/js/MicrosoftTeams.min.js"
+  integrity="sha384-7ORQy8xx1gKRnfigO9zP+eIdkANt5I5YKoTJh4P55DqdbkInsqjaevmrCNLwtkLb"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.42.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.43.1/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/esm/packages/teams-js/dts/internal/telemetry.d.ts

@@ -307,6 +307,9 @@ export declare const enum ApiName {
     Settings_SetValidityState = "settings.setValidityState",
     Sharing_History_GetContent = "sharing.history.getContent",
     Sharing_ShareWebContent = "sharing.shareWebContent",
+    ShortcutRelay_GetHostShortcuts = "shortcutRelay.getHostShortcuts",
+    ShortcutRelay_ForwardShortcutEvent = "shortcutRelay.forwardShortcutEvent",
+    ShortcutRelay_HostShortcutChanged = "shortcutRelay.hostShortcutChanged",
     StageView_Open = "stageView.open",
     StageView_Self_Close = "stageView.self.close",
     Store_OpenFullStore = "store.openFullStore",

package/dist/esm/packages/teams-js/dts/public/index.d.ts

@@ -47,3 +47,4 @@ export * as liveShare from './liveShareHost';
 export { LiveShareHost } from './liveShareHost';
 export * as marketplace from './marketplace';
 export { ISerializable } from './serializable.interface';
+export * as shortcutRelay from './shortcutRelay';

package/dist/esm/packages/teams-js/dts/public/interfaces.d.ts

@@ -1050,6 +1050,11 @@ export interface AppEligibilityInformation {
      * Education Eligibility Information for the app user
      */
     userClassification: UserClassification | null;
+    /**
+     * Describes settings available to the user.
+     * If this property is undefined, it indicates that the host is an older version that doesn't support this property.
+     */
+    settings?: AppSettings | null;
 }
 /**
  * @hidden
@@ -1081,6 +1086,28 @@ export interface UserClassificationWithEduType {
      */
     persona: Persona.Faculty | Persona.Student;
 }
+/**
+ * @hidden
+ * @beta
+ * Represents the settings set available to the user.
+ */
+export interface AppSettings {
+    /**
+     * Describes conversation settings available to the user.
+     */
+    conversationSettings?: AppConversationSettings | null;
+}
+/**
+ * @hidden
+ * @beta
+ * Represents the conversation settings available to the user.
+ */
+export interface AppConversationSettings {
+    /**
+     * Indicates OCE admin toggle
+     */
+    isOptionalConnectedExperiencesEnabled: boolean;
+}
 /**
  * @hidden
  *

package/dist/esm/packages/teams-js/dts/public/runtime.d.ts

@@ -92,6 +92,7 @@ interface IRuntimeV4 extends IBaseRuntime {
         readonly sharing?: {
             readonly history?: {};
         };
+        readonly shortcutRelay?: {};
         readonly stageView?: {
             readonly self?: {};
         };

package/dist/esm/packages/teams-js/dts/public/shortcutRelay.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
+ *
+ * This functionality is in Beta.
+ * @beta
+ * @module
+ */
+/**
+ * Data passed to the overridable shortcut handler.
+ */
+export type OverridableShortcutHandlerData = {
+    /**
+     * The matched shortcut that triggered the handler.
+     * This is a canonical form of the shortcut, e.g. "ctrl+shift+x".
+     */
+    matchedShortcut: string;
+};
+/**
+ * A handler must return `true` when it wants to **consume** the shortcut
+ * (i.e. prevent forwarding to host). Any other return value forwards it.
+ */
+export type OverridableShortcutHandler = (event: KeyboardEvent, data: OverridableShortcutHandlerData) => boolean;
+/**
+ * Replace the current overridable-shortcut handler.
+ *
+ * • Pass `undefined` to remove an existing handler.
+ * • Returns the previous handler so callers can restore it if needed.
+ *
+ * @beta
+ */
+export declare function setOverridableShortcutHandler(handler: OverridableShortcutHandler | undefined): OverridableShortcutHandler | undefined;
+/**
+ * Reset the state of the shortcut relay capability.
+ * This is useful for tests to ensure a clean state.
+ *
+ * @beta
+ */
+export declare function resetIsShortcutRelayCapabilityEnabled(): void;
+/**
+ * Enable capability to support host shortcuts.
+ *
+ * @beta
+ */
+export declare function enableShortcutRelayCapability(): Promise<void>;
+/**
+ * Checks if shortcutRelay capability is supported by the host
+ * @returns boolean to represent whether the shortcutRelay capability is supported
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+export declare function isSupported(): boolean;
+/**
+ * Allow apps to define zones where shortcuts should not be forwarded to the host.
+ * This is useful for input fields for password where shortcuts should not trigger host actions.
+ *
+ * @beta
+ */
+export declare const DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE = "data-disable-shortcuts-forwarding";

package/dist/esm/packages/teams-js/src/index.js

@@ -1 +1 @@
-export{NotificationTypes,UserSettingTypes,ViewerActionTypes}from"./private/interfaces.js";export{openFilePreview,registerCustomHandler,registerUserSettingsChangeHandler,sendCustomEvent,sendCustomMessage,uploadCustomApp}from"./private/privateAPIs.js";import*as e from"./private/logs.js";export{e as logs};import*as r from"./private/conversations.js";export{r as conversations};import*as t from"./private/copilot/copilot.js";export{t as copilot};import*as o from"./private/copilot/sidePanelInterfaces.js";export{o as sidePanelInterfaces};import*as p from"./private/externalAppAuthentication.js";export{p as externalAppAuthentication};import*as i from"./private/externalAppAuthenticationForCEA.js";export{i as externalAppAuthenticationForCEA};import*as a from"./private/externalAppCardActions.js";export{a as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as m from"./private/externalAppCardActionsForDA.js";export{m as externalAppCardActionsForDA};import*as n from"./private/externalAppCommands.js";export{n as externalAppCommands};import*as l from"./private/files.js";export{l as files};import*as c from"./private/meetingRoom.js";export{c as meetingRoom};import*as f from"./private/messageChannels/messageChannels.js";export{f as messageChannels};import*as u from"./private/nestedAppAuth/nestedAppAuthBridge.js";export{u as nestedAppAuthBridge};import*as x from"./private/notifications.js";export{x as notifications};import*as j from"./private/otherAppStateChange.js";export{j as otherAppStateChange};import*as d from"./private/remoteCamera.js";export{d as remoteCamera};import*as g from"./private/appEntity.js";export{g as appEntity};import*as b from"./private/teams/teams.js";export{b as teams};import*as v from"./private/videoEffectsEx.js";export{v as videoEffectsEx};import*as C from"./private/hostEntity/hostEntity.js";export{C as hostEntity};import*as A from"./private/store.js";export{A as store};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,RenderingSurfaces,DialogDimension as TaskModuleDimension,TeamType,UserTeamRole}from"./public/constants.js";export{ActionObjectType,EduType,ErrorCode,FileOpenPreference,SecondaryM365ContentIdName}from"./public/interfaces.js";export{AppId}from"./public/appId.js";export{EmailAddress}from"./public/emailAddress.js";export{activateChildProxyingCommunication,getCurrentFeatureFlagsState,overwriteFeatureFlagsState,setFeatureFlagsState}from"./public/featureFlags.js";export{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.js";export{ValidatedSafeString}from"./public/validatedSafeString.js";export{version}from"./public/version.js";export{enablePrintCapability,executeDeepLink,getContext,getMruTabInstances,getTabInstances,initialize,initializeWithFrameContext,print,registerAppButtonClickHandler,registerAppButtonHoverEnterHandler,registerAppButtonHoverLeaveHandler,registerBackButtonHandler,registerBeforeUnloadHandler,registerChangeSettingsHandler,registerFocusEnterHandler,registerFullScreenHandler,registerOnLoadHandler,registerOnThemeChangeHandler,setFrameContext,shareDeepLink}from"./public/publicAPIs.js";export{navigateBack,navigateCrossDomain,navigateToTab,returnFocus}from"./public/navigation.js";export{UUID}from"./public/uuidObject.js";import*as h from"./public/liveShareHost.js";export{h as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as S from"./public/authentication.js";export{S as authentication};import*as H from"./public/app/app.js";export{H as app};import*as F from"./public/appInstallDialog.js";export{F as appInstallDialog};import*as y from"./public/barCode.js";export{y as barCode};import*as T from"./public/chat.js";export{T as chat};import*as E from"./public/clipboard.js";export{E as clipboard};import*as I from"./public/dialog/dialog.js";export{I as dialog};import*as D from"./public/nestedAppAuth.js";export{D as nestedAppAuth};import*as w from"./public/geoLocation/geoLocation.js";export{w as geoLocation};import*as P from"./public/pages/pages.js";export{P as pages};import*as B from"./public/menus.js";export{B as menus};import*as k from"./public/media.js";export{k as media};import*as L from"./public/secondaryBrowser.js";export{L as secondaryBrowser};import*as M from"./public/location.js";export{M as location};import*as U from"./public/meeting/meeting.js";export{U as meeting};import*as O from"./public/monetization.js";export{O as monetization};import*as V from"./public/calendar.js";export{V as calendar};import*as z from"./public/mail/mail.js";export{z as mail};import*as W from"./public/teamsAPIs.js";export{W as teamsCore};import*as N from"./public/people.js";export{N as people};import*as R from"./public/profile.js";export{R as profile};import*as q from"./public/videoEffects.js";export{q as videoEffects};import*as G from"./public/search.js";export{G as search};import*as J from"./public/sharing/sharing.js";export{J as sharing};import*as K from"./public/stageView/stageView.js";export{K as stageView};import*as Q from"./public/visualMedia/visualMedia.js";export{Q as visualMedia};import*as X from"./public/webStorage.js";export{X as webStorage};import*as Y from"./public/call.js";export{Y as call};import*as Z from"./public/appInitialization.js";export{Z as appInitialization};import*as $ from"./public/thirdPartyCloudStorage.js";export{$ as thirdPartyCloudStorage};import*as _ from"./public/settings.js";export{_ as settings};import*as ee from"./public/tasks.js";export{ee as tasks};import*as re from"./public/marketplace.js";export{re as marketplace};
+export{NotificationTypes,UserSettingTypes,ViewerActionTypes}from"./private/interfaces.js";export{openFilePreview,registerCustomHandler,registerUserSettingsChangeHandler,sendCustomEvent,sendCustomMessage,uploadCustomApp}from"./private/privateAPIs.js";import*as e from"./private/logs.js";export{e as logs};import*as r from"./private/conversations.js";export{r as conversations};import*as t from"./private/copilot/copilot.js";export{t as copilot};import*as o from"./private/copilot/sidePanelInterfaces.js";export{o as sidePanelInterfaces};import*as p from"./private/externalAppAuthentication.js";export{p as externalAppAuthentication};import*as i from"./private/externalAppAuthenticationForCEA.js";export{i as externalAppAuthenticationForCEA};import*as a from"./private/externalAppCardActions.js";export{a as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as m from"./private/externalAppCardActionsForDA.js";export{m as externalAppCardActionsForDA};import*as n from"./private/externalAppCommands.js";export{n as externalAppCommands};import*as l from"./private/files.js";export{l as files};import*as c from"./private/meetingRoom.js";export{c as meetingRoom};import*as f from"./private/messageChannels/messageChannels.js";export{f as messageChannels};import*as u from"./private/nestedAppAuth/nestedAppAuthBridge.js";export{u as nestedAppAuthBridge};import*as x from"./private/notifications.js";export{x as notifications};import*as j from"./private/otherAppStateChange.js";export{j as otherAppStateChange};import*as d from"./private/remoteCamera.js";export{d as remoteCamera};import*as g from"./private/appEntity.js";export{g as appEntity};import*as b from"./private/teams/teams.js";export{b as teams};import*as v from"./private/videoEffectsEx.js";export{v as videoEffectsEx};import*as C from"./private/hostEntity/hostEntity.js";export{C as hostEntity};import*as A from"./private/store.js";export{A as store};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,RenderingSurfaces,DialogDimension as TaskModuleDimension,TeamType,UserTeamRole}from"./public/constants.js";export{ActionObjectType,EduType,ErrorCode,FileOpenPreference,SecondaryM365ContentIdName}from"./public/interfaces.js";export{AppId}from"./public/appId.js";export{EmailAddress}from"./public/emailAddress.js";export{activateChildProxyingCommunication,getCurrentFeatureFlagsState,overwriteFeatureFlagsState,setFeatureFlagsState}from"./public/featureFlags.js";export{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.js";export{ValidatedSafeString}from"./public/validatedSafeString.js";export{version}from"./public/version.js";export{enablePrintCapability,executeDeepLink,getContext,getMruTabInstances,getTabInstances,initialize,initializeWithFrameContext,print,registerAppButtonClickHandler,registerAppButtonHoverEnterHandler,registerAppButtonHoverLeaveHandler,registerBackButtonHandler,registerBeforeUnloadHandler,registerChangeSettingsHandler,registerFocusEnterHandler,registerFullScreenHandler,registerOnLoadHandler,registerOnThemeChangeHandler,setFrameContext,shareDeepLink}from"./public/publicAPIs.js";export{navigateBack,navigateCrossDomain,navigateToTab,returnFocus}from"./public/navigation.js";export{UUID}from"./public/uuidObject.js";import*as h from"./public/liveShareHost.js";export{h as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as S from"./public/authentication.js";export{S as authentication};import*as H from"./public/app/app.js";export{H as app};import*as F from"./public/appInstallDialog.js";export{F as appInstallDialog};import*as y from"./public/barCode.js";export{y as barCode};import*as T from"./public/chat.js";export{T as chat};import*as E from"./public/clipboard.js";export{E as clipboard};import*as I from"./public/dialog/dialog.js";export{I as dialog};import*as D from"./public/nestedAppAuth.js";export{D as nestedAppAuth};import*as w from"./public/geoLocation/geoLocation.js";export{w as geoLocation};import*as P from"./public/pages/pages.js";export{P as pages};import*as B from"./public/menus.js";export{B as menus};import*as k from"./public/media.js";export{k as media};import*as L from"./public/secondaryBrowser.js";export{L as secondaryBrowser};import*as M from"./public/location.js";export{M as location};import*as U from"./public/meeting/meeting.js";export{U as meeting};import*as O from"./public/monetization.js";export{O as monetization};import*as V from"./public/calendar.js";export{V as calendar};import*as z from"./public/mail/mail.js";export{z as mail};import*as R from"./public/teamsAPIs.js";export{R as teamsCore};import*as W from"./public/people.js";export{W as people};import*as N from"./public/profile.js";export{N as profile};import*as q from"./public/videoEffects.js";export{q as videoEffects};import*as G from"./public/search.js";export{G as search};import*as J from"./public/sharing/sharing.js";export{J as sharing};import*as K from"./public/stageView/stageView.js";export{K as stageView};import*as Q from"./public/visualMedia/visualMedia.js";export{Q as visualMedia};import*as X from"./public/webStorage.js";export{X as webStorage};import*as Y from"./public/call.js";export{Y as call};import*as Z from"./public/appInitialization.js";export{Z as appInitialization};import*as $ from"./public/thirdPartyCloudStorage.js";export{$ as thirdPartyCloudStorage};import*as _ from"./public/settings.js";export{_ as settings};import*as ee from"./public/tasks.js";export{ee as tasks};import*as re from"./public/marketplace.js";export{re as marketplace};import*as te from"./public/shortcutRelay.js";export{te as shortcutRelay};

package/dist/esm/packages/teams-js/src/public/shortcutRelay.js

@@ -0,0 +1 @@
+import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.24.4_tslib@2.6.3_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as e,callFunctionInHostAndHandleResponse as r}from"../internal/communication.js";import{registerHandler as o}from"../internal/handlers.js";import{ensureInitialized as n}from"../internal/internalAPIs.js";import{ResponseHandler as s}from"../internal/responseHandler.js";import{getApiVersionTag as i}from"../internal/telemetry.js";import{errorNotSupportedOnPlatform as a}from"./constants.js";import{runtime as c}from"./runtime.js";class h{constructor(t){this.event=t}serialize(){return{altKey:this.event.altKey,bubbles:this.event.bubbles,cancelBubble:this.event.cancelBubble,charCode:this.event.charCode,code:this.event.code,composed:this.event.composed,ctrlKey:this.event.ctrlKey,defaultPrevented:this.event.defaultPrevented,detail:this.event.detail,eventPhase:this.event.eventPhase,isComposing:this.event.isComposing,isTrusted:this.event.isTrusted,key:this.event.key,keyCode:this.event.keyCode,location:this.event.location,metaKey:this.event.metaKey,repeat:this.event.repeat,returnValue:this.event.returnValue,shiftKey:this.event.shiftKey,timeStamp:this.event.timeStamp,type:this.event.type,which:this.event.which}}}function u(t){return t.toLowerCase().split("+").sort().join("+")}function l(t,e){if(function(t){return t.ctrlKey||t.shiftKey||t.altKey||t.metaKey||!!t.key&&"escape"===t.key.toLowerCase()}(e)){const r=function(t){return[t.ctrlKey&&"ctrl",t.shiftKey&&"shift",t.altKey&&"alt",t.metaKey&&"meta",t.key.toLowerCase()].filter(Boolean).sort().join("+")}(e);if(t.has(r))return{matchedShortcut:r,isOverridable:f.has(r)}}return{matchedShortcut:void 0,isOverridable:!1}}function d(t){y.clear(),t.shortcuts.forEach((t=>{y.add(u(t))})),f.clear(),t.overridableShortcuts.forEach((t=>{f.add(u(t))}))}class v extends s{validate(t){return t&&Array.isArray(t.shortcuts)&&Array.isArray(t.overridableShortcuts)}deserialize(t){return t}}function m(t){if(t.target.closest(`[${g}]`))return;const{matchedShortcut:r,isOverridable:o}=l(y,t);if(!r)return;if(o&&p){if(p(t,{matchedShortcut:r}))return}const n=new h(t);e("shortcutRelay.forwardShortcutEvent",[n],i("v2","shortcutRelay.forwardShortcutEvent")),t.preventDefault(),t.stopImmediatePropagation()}const f=new Set,y=new Set;let p,b=!1;function w(t){if(!C())throw a;const e=p;return p=t,e}function K(){if(!C())throw a;b=!1,y.clear(),f.clear(),p=void 0,document.removeEventListener("keydown",m,{capture:!0})}function S(){return t(this,void 0,void 0,(function*(){if(!C())throw a;var t;d(yield r("shortcutRelay.getHostShortcuts",[],new v,i("v2","shortcutRelay.getHostShortcuts"))),b||document.addEventListener("keydown",m,{capture:!0}),b=!0,t=t=>{d(t)},o(i("v2","shortcutRelay.hostShortcutChanged"),"shortcutRelay.hostShortcutChanged",t)}))}function C(){return!(!n(c)||!c.supports.shortcutRelay)}const g="data-disable-shortcuts-forwarding";export{g as DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE,S as enableShortcutRelayCapability,C as isSupported,K as resetIsShortcutRelayCapabilityEnabled,w as setOverridableShortcutHandler};

package/dist/esm/packages/teams-js/src/public/version.js

@@ -1 +1 @@
-const o="2.42.0";export{o as version};
+const o="2.44.0";export{o as version};

package/dist/umd/MicrosoftTeams.js

@@ -1093,6 +1093,7 @@ __webpack_require__.d(__webpack_exports__, {
   settings: () => (/* reexport */ settings_namespaceObject),
   shareDeepLink: () => (/* reexport */ publicAPIs_shareDeepLink),
   sharing: () => (/* reexport */ sharing_namespaceObject),
+  shortcutRelay: () => (/* reexport */ shortcutRelay_namespaceObject),
   sidePanelInterfaces: () => (/* reexport */ sidePanelInterfaces_namespaceObject),
   stageView: () => (/* reexport */ stageView_namespaceObject),
   store: () => (/* reexport */ store_namespaceObject),
@@ -2037,6 +2038,17 @@ __webpack_require__.d(marketplace_namespaceObject, {
   updateCartStatus: () => (updateCartStatus)
 });
 
+// NAMESPACE OBJECT: ./src/public/shortcutRelay.ts
+var shortcutRelay_namespaceObject = {};
+__webpack_require__.r(shortcutRelay_namespaceObject);
+__webpack_require__.d(shortcutRelay_namespaceObject, {
+  DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE: () => (DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE),
+  enableShortcutRelayCapability: () => (enableShortcutRelayCapability),
+  isSupported: () => (shortcutRelay_isSupported),
+  resetIsShortcutRelayCapabilityEnabled: () => (resetIsShortcutRelayCapabilityEnabled),
+  setOverridableShortcutHandler: () => (setOverridableShortcutHandler)
+});
+
 ;// ./src/public/interfaces.ts
 /* eslint-disable @typescript-eslint/no-explicit-any*/
 /**
@@ -4632,7 +4644,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.42.0";
+const version = "2.44.0";
 
 ;// ./src/public/featureFlags.ts
 // All build feature flags are defined inside this object. Any build feature flag must have its own unique getter and setter function. This pattern allows for client apps to treeshake unused code and avoid including code guarded by this feature flags in the final bundle. If this property isn't desired, use the below runtime feature flags object.
@@ -19513,6 +19525,262 @@ function marketplace_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.marketplace ? true : false;
 }
 
+;// ./src/public/shortcutRelay.ts
+/**
+ * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
+ *
+ * This functionality is in Beta.
+ * @beta
+ * @module
+ */
+var shortcutRelay_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
+
+
+
+
+
+
+/* ------------------------------------------------------------------ */
+/* Utils                                                              */
+/* ------------------------------------------------------------------ */
+class SerializableKeyboardEvent {
+    constructor(event) {
+        this.event = event;
+    }
+    serialize() {
+        return {
+            altKey: this.event.altKey,
+            bubbles: this.event.bubbles,
+            cancelBubble: this.event.cancelBubble,
+            charCode: this.event.charCode,
+            code: this.event.code,
+            composed: this.event.composed,
+            ctrlKey: this.event.ctrlKey,
+            // currentTarget: skipped
+            defaultPrevented: this.event.defaultPrevented,
+            detail: this.event.detail,
+            eventPhase: this.event.eventPhase,
+            isComposing: this.event.isComposing,
+            isTrusted: this.event.isTrusted,
+            key: this.event.key,
+            keyCode: this.event.keyCode,
+            location: this.event.location,
+            metaKey: this.event.metaKey,
+            // path - skipped,
+            repeat: this.event.repeat,
+            returnValue: this.event.returnValue,
+            shiftKey: this.event.shiftKey,
+            // sourceCapabilities - skipped,
+            // srcElement - slipped.
+            // target - skipped.
+            timeStamp: this.event.timeStamp,
+            type: this.event.type,
+            // view - skipped
+            which: this.event.which,
+        };
+    }
+}
+/**
+ * Normalizes a shortcut string to a canonical form.
+ */
+function normalizeShortcut(shortcut) {
+    return shortcut.toLowerCase().split('+').sort().join('+');
+}
+/**
+ * Build a canonical, lower-case “ctrl+shift+x” representation of the
+ * currently pressed keys.  The array is sorted so the order in which
+ * modifiers are pressed does not matter.
+ */
+function eventToCanonicalShortcut(e) {
+    return [e.ctrlKey && 'ctrl', e.shiftKey && 'shift', e.altKey && 'alt', e.metaKey && 'meta', e.key.toLowerCase()]
+        .filter(Boolean)
+        .sort()
+        .join('+');
+}
+/**
+ * Checks if the event is a valid shortcut event.
+ * A valid shortcut event is one that has at least one modifier key pressed
+ * (ctrl, shift, alt, meta) or the Escape key.
+ */
+function isValidShortcutEvent(e) {
+    return e.ctrlKey || e.shiftKey || e.altKey || e.metaKey || (!!e.key && e.key.toLowerCase() === 'escape');
+}
+function isMatchingShortcut(shortcuts, e) {
+    if (isValidShortcutEvent(e)) {
+        const pressedShortcut = eventToCanonicalShortcut(e);
+        const isMatching = shortcuts.has(pressedShortcut);
+        if (isMatching) {
+            return {
+                matchedShortcut: pressedShortcut,
+                isOverridable: overridableShortcuts.has(pressedShortcut),
+            };
+        }
+    }
+    return {
+        matchedShortcut: undefined,
+        isOverridable: false,
+    };
+}
+function updateHostShortcuts(data) {
+    hostShortcuts.clear();
+    data.shortcuts.forEach((shortcut) => {
+        hostShortcuts.add(normalizeShortcut(shortcut));
+    });
+    overridableShortcuts.clear();
+    data.overridableShortcuts.forEach((shortcut) => {
+        overridableShortcuts.add(normalizeShortcut(shortcut));
+    });
+}
+class HostShortcutsResponseHandler extends ResponseHandler {
+    validate(response) {
+        return response && Array.isArray(response.shortcuts) && Array.isArray(response.overridableShortcuts);
+    }
+    deserialize(response) {
+        return response;
+    }
+}
+/**
+ * register a handler to be called when shortcuts are updated in the host.
+ */
+function registerOnHostShortcutChangedHandler(handler) {
+    registerHandler(getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "shortcutRelay.hostShortcutChanged" /* ApiName.ShortcutRelay_HostShortcutChanged */), "shortcutRelay.hostShortcutChanged" /* ApiName.ShortcutRelay_HostShortcutChanged */, handler);
+}
+function keydownHandler(event) {
+    // Skip if the event target is within an element that has the `data-disable-shortcuts-forwarding` attribute
+    if (event.target.closest(`[${DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE}]`)) {
+        return;
+    }
+    const { matchedShortcut, isOverridable } = isMatchingShortcut(hostShortcuts, event);
+    if (!matchedShortcut) {
+        return; // ignore unrelated events
+    }
+    if (isOverridable && overridableShortcutHandler) {
+        const shouldOverride = overridableShortcutHandler(event, { matchedShortcut });
+        if (shouldOverride) {
+            return; // Do not forward shortcut to host
+        }
+    }
+    /* Forward shortcut to host */
+    const payload = new SerializableKeyboardEvent(event);
+    callFunctionInHost("shortcutRelay.forwardShortcutEvent" /* ApiName.ShortcutRelay_ForwardShortcutEvent */, [payload], getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "shortcutRelay.forwardShortcutEvent" /* ApiName.ShortcutRelay_ForwardShortcutEvent */));
+    event.preventDefault();
+    event.stopImmediatePropagation();
+}
+/* ------------------------------------------------------------------ */
+/* In-memory                                                          */
+/* ------------------------------------------------------------------ */
+/**
+ * @hidden
+ * @internal
+ * Stores the shortcuts that can be overridden by the app.
+ */
+const overridableShortcuts = new Set();
+/**
+ * @hidden
+ * @internal
+ * Stores the shortcuts that are enabled in host.
+ * This set is populated when the host sends the list of enabled shortcuts.
+ */
+const hostShortcuts = new Set();
+/**
+ * @hidden
+ * @internal
+ * Stores the handler for overridable shortcuts.
+ */
+let overridableShortcutHandler = undefined;
+/**
+ * @hidden
+ * @internal
+ * Flag to indicate if the shortcut relay capability has been enabled, so that we do not register the event listener multiple times.
+ */
+let isShortcutRelayCapabilityEnabled = false;
+/* ------------------------------------------------------------------ */
+/* API                                                                */
+/* ------------------------------------------------------------------ */
+/**
+ * Replace the current overridable-shortcut handler.
+ *
+ * • Pass `undefined` to remove an existing handler.
+ * • Returns the previous handler so callers can restore it if needed.
+ *
+ * @beta
+ */
+function setOverridableShortcutHandler(handler) {
+    if (!shortcutRelay_isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    const previous = overridableShortcutHandler;
+    overridableShortcutHandler = handler;
+    return previous;
+}
+/**
+ * Reset the state of the shortcut relay capability.
+ * This is useful for tests to ensure a clean state.
+ *
+ * @beta
+ */
+function resetIsShortcutRelayCapabilityEnabled() {
+    if (!shortcutRelay_isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    isShortcutRelayCapabilityEnabled = false;
+    hostShortcuts.clear();
+    overridableShortcuts.clear();
+    overridableShortcutHandler = undefined;
+    document.removeEventListener('keydown', keydownHandler, { capture: true });
+}
+/**
+ * Enable capability to support host shortcuts.
+ *
+ * @beta
+ */
+function enableShortcutRelayCapability() {
+    return shortcutRelay_awaiter(this, void 0, void 0, function* () {
+        if (!shortcutRelay_isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        /* 1. Ask host for the list of enabled shortcuts */
+        const response = yield callFunctionInHostAndHandleResponse("shortcutRelay.getHostShortcuts" /* ApiName.ShortcutRelay_GetHostShortcuts */, [], new HostShortcutsResponseHandler(), getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "shortcutRelay.getHostShortcuts" /* ApiName.ShortcutRelay_GetHostShortcuts */));
+        updateHostShortcuts(response);
+        /* 2. Global key-down handler */
+        if (!isShortcutRelayCapabilityEnabled) {
+            document.addEventListener('keydown', keydownHandler, { capture: true });
+        }
+        isShortcutRelayCapabilityEnabled = true;
+        /* 3. Register handler for host shortcut updates */
+        registerOnHostShortcutChangedHandler((hostShortcuts) => {
+            updateHostShortcuts(hostShortcuts);
+        });
+    });
+}
+/**
+ * Checks if shortcutRelay capability is supported by the host
+ * @returns boolean to represent whether the shortcutRelay capability is supported
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+function shortcutRelay_isSupported() {
+    return ensureInitialized(runtime) && runtime.supports.shortcutRelay ? true : false;
+}
+/**
+ * Allow apps to define zones where shortcuts should not be forwarded to the host.
+ * This is useful for input fields for password where shortcuts should not trigger host actions.
+ *
+ * @beta
+ */
+const DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE = 'data-disable-shortcuts-forwarding';
+
 ;// ./src/public/index.ts
 
 
@@ -19597,6 +19865,8 @@ function marketplace_isSupported() {
 
 
 
+
+
 
 ;// ./src/index.ts