@microsoft/teams-js 2.52.0 → 2.53.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.52.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.53.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.52.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-j4GNIru3mNYN+q8XdBRVyvbUx+0U867Cy90v6H61tpIZoR2pUq+bZDZmmpT8N7VG"
+  src="https://res.cdn.office.net/teams-js/2.53.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-UFKwOGC8ix6vOFFC4vH8hSpjwkQXZmSjCx8aaxwhbtm+6joQdNvD7b4pPk82cYAD"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.52.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.53.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

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

@@ -1,8 +1,6 @@
 /**
  * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
  *
- * This functionality is in Beta.
- * @beta
  * @module
  */
 /**
@@ -26,20 +24,17 @@ export type OverridableShortcutHandler = (event: KeyboardEvent, data: Overridabl
  * • 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>;
 /**
@@ -48,13 +43,11 @@ export declare function enableShortcutRelayCapability(): Promise<void>;
  *
  * @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/public/shortcutRelay.js

@@ -1 +1 @@
-import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_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};
+import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_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()||!!t.key&&/^F\d+$/i.test(t.key)}(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:y.has(r)}}return{matchedShortcut:void 0,isOverridable:!1}}function d(t){f.clear(),t.shortcuts.forEach(t=>{f.add(u(t))}),y.clear(),t.overridableShortcuts.forEach(t=>{y.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(`[${C}]`))return;const{matchedShortcut:r,isOverridable:o}=l(f,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 y=new Set,f=new Set;let p,b=!1;function w(t){if(!k())throw a;const e=p;return p=t,e}function K(){if(!k())throw a;b=!1,f.clear(),y.clear(),p=void 0,document.removeEventListener("keydown",m,{capture:!0})}function S(){return t(this,void 0,void 0,function*(){if(!k())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 k(){return!(!n(c)||!c.supports.shortcutRelay)}const C="data-disable-shortcuts-forwarding";export{C as DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE,S as enableShortcutRelayCapability,k as isSupported,K as resetIsShortcutRelayCapabilityEnabled,w as setOverridableShortcutHandler};

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

@@ -1 +1 @@
-const o="2.52.0";export{o as version};
+const o="2.53.0";export{o as version};

package/dist/umd/MicrosoftTeams.js

@@ -4679,7 +4679,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.52.0";
+const version = "2.53.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.
@@ -20349,8 +20349,6 @@ function marketplace_isSupported() {
 /**
  * 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) {
@@ -20429,10 +20427,15 @@ function eventToCanonicalShortcut(e) {
 /**
  * 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.
+ * (ctrl, shift, alt, meta), the Escape key, or a function key (F1–F24).
  */
 function isValidShortcutEvent(e) {
-    return e.ctrlKey || e.shiftKey || e.altKey || e.metaKey || (!!e.key && e.key.toLowerCase() === 'escape');
+    return (e.ctrlKey ||
+        e.shiftKey ||
+        e.altKey ||
+        e.metaKey ||
+        (!!e.key && e.key.toLowerCase() === 'escape') ||
+        (!!e.key && /^F\d+$/i.test(e.key)));
 }
 function isMatchingShortcut(shortcuts, e) {
     if (isValidShortcutEvent(e)) {
@@ -20532,7 +20535,6 @@ let isShortcutRelayCapabilityEnabled = false;
  * • 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()) {
@@ -20546,7 +20548,6 @@ function setOverridableShortcutHandler(handler) {
  * Reset the state of the shortcut relay capability.
  * This is useful for tests to ensure a clean state.
  *
- * @beta
  */
 function resetIsShortcutRelayCapabilityEnabled() {
     if (!shortcutRelay_isSupported()) {
@@ -20561,7 +20562,6 @@ function resetIsShortcutRelayCapabilityEnabled() {
 /**
  * Enable capability to support host shortcuts.
  *
- * @beta
  */
 function enableShortcutRelayCapability() {
     return shortcutRelay_awaiter(this, void 0, void 0, function* () {
@@ -20588,7 +20588,6 @@ function enableShortcutRelayCapability() {
  *
  * @throws Error if {@link app.initialize} has not successfully completed
  *
- * @beta
  */
 function shortcutRelay_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.shortcutRelay ? true : false;
@@ -20597,7 +20596,6 @@ function shortcutRelay_isSupported() {
  * 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';