@microsoft/teams-js 2.24.0-beta.0 → 2.24.0-beta.2

package/dist/MicrosoftTeams.d.ts

@@ -2948,7 +2948,7 @@ export namespace authentication {
         function initialize(): void;
         /**
             * @deprecated
-            * As of 2.0.0, this function has been deprecated in favor of a Promise-based pattern using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
+            * As of TeamsJS v2.0.0, this function has been deprecated in favor of a Promise-based pattern using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
             *
             * Registers handlers to be called with the result of an authentication flow triggered using {@link authentication.authenticate authentication.authenticate(authenticateParameters?: AuthenticateParameters): void}
             *
@@ -2984,7 +2984,7 @@ export namespace authentication {
         function authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise<string>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} instead.
             *
             * The documentation for {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} applies
             * to this function.
@@ -3011,7 +3011,7 @@ export namespace authentication {
         function getAuthToken(authTokenRequest?: AuthTokenRequestParameters): Promise<string>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link authentication.getAuthToken authentication.getAuthToken(authTokenRequest: AuthTokenRequestParameters): Promise\<string\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link authentication.getAuthToken authentication.getAuthToken(authTokenRequest: AuthTokenRequestParameters): Promise\<string\>} instead.
             *
             * The documentation {@link authentication.getAuthToken authentication.getAuthToken(authTokenRequest: AuthTokenRequestParameters): Promise\<string\>} applies to this
             * function as well. The one difference when using this function is that the result is provided in the callbacks in the `authTokenRequest` parameter
@@ -3033,7 +3033,7 @@ export namespace authentication {
         function getUser(): Promise<UserProfile>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link authentication.getUser authentication.getUser(): Promise\<UserProfile\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link authentication.getUser authentication.getUser(): Promise\<UserProfile\>} instead.
             *
             * @hidden
             * Requests the decoded Microsoft Entra user identity on behalf of the app.
@@ -3075,21 +3075,21 @@ export namespace authentication {
         function notifyFailure(result?: string): void;
         /**
             * @deprecated
-            * As of 2.0.0, this interface has been deprecated in favor of leveraging the `Promise` returned from {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
+            * As of TeamsJS v2.0.0, this interface has been deprecated in favor of leveraging the `Promise` returned from {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
             *-------------------------
             * Used in {@link AuthenticateParameters} and {@link AuthTokenRequest}
             */
         interface LegacyCallBacks {
                 /**
                     * @deprecated
-                    * As of 2.0.0, this property has been deprecated in favor of a Promise-based pattern.
+                    * As of TeamsJS v2.0.0, this property has been deprecated in favor of a Promise-based pattern.
                     *
                     * A function that is called if the request succeeds.
                     */
                 successCallback?: (result: string) => void;
                 /**
                     * @deprecated
-                    * As of 2.0.0, this property has been deprecated in favor of a Promise-based pattern.
+                    * As of TeamsJS v2.0.0, this property has been deprecated in favor of a Promise-based pattern.
                     *
                     * A function that is called if the request fails, with the reason for the failure.
                     */
@@ -3124,7 +3124,7 @@ export namespace authentication {
         }
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} and
+            * As of TeamsJS v2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} and
             * the associated {@link AuthenticatePopUpParameters} instead.
             *
             * @see {@link LegacyCallBacks}
@@ -3155,7 +3155,7 @@ export namespace authentication {
         }
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link AuthTokenRequestParameters} instead.
+            * As of TeamsJS v2.0.0, please use {@link AuthTokenRequestParameters} instead.
             */
         type AuthTokenRequest = AuthTokenRequestParameters & LegacyCallBacks;
         /**
@@ -3325,7 +3325,7 @@ export namespace authentication {
         }
         /**
             * @deprecated
-            * As of 2.0.0, this interface has been deprecated in favor of a Promise-based pattern.
+            * As of TeamsJS v2.0.0, this interface has been deprecated in favor of a Promise-based pattern.
             * @hidden
             * Describes the UserRequest. Success callback describes how a successful request is handled.
             * Failure callback describes how a failed request is handled.
@@ -3360,7 +3360,7 @@ export enum HostClientType {
         macos = "macos",
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link teamsRoomsWindows} instead.
+            * As of TeamsJS v2.0.0, please use {@link teamsRoomsWindows} instead.
             */
         rigel = "rigel",
         /** Represents the client of host, which runs on surface hub devices. */
@@ -3477,7 +3477,7 @@ export enum DialogDimension {
 }
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link DialogDimension} instead.
+    * As of TeamsJS v2.0.0, please use {@link DialogDimension} instead.
     */
 export import TaskModuleDimension = DialogDimension;
 /**
@@ -3765,7 +3765,7 @@ export interface ActionInfo {
 }
 /**
     * @deprecated
-    * As of 2.0.0, please use the {@link app.Context} interface and its updated properties instead.
+    * As of TeamsJS v2.0.0, please use the {@link app.Context} interface and its updated properties instead.
     *
     * @remarks
     * For more details about the updated {@link app.Context} interface, visit the
@@ -3777,14 +3777,14 @@ export interface ActionInfo {
 export interface Context {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link ActionInfo | app.Context.actionInfo} instead
+            * As of TeamsJS v2.0.0, please use {@link ActionInfo | app.Context.actionInfo} instead
             *
             * Common information applicable to all content actions
             */
         actionInfo?: ActionInfo;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.groupId | app.Context.team.groupId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.groupId | app.Context.team.groupId} instead
             *
             * The Office 365 group ID for the team with which the content is associated.
             * This field is available only when the identity permission is requested in the manifest.
@@ -3792,49 +3792,49 @@ export interface Context {
         groupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.internalId | app.Context.team.internalId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.internalId | app.Context.team.internalId} instead
             *
             * The Microsoft Teams ID for the team with which the content is associated.
             */
         teamId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.displayName | app.Context.team.displayName} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.displayName | app.Context.team.displayName} instead
             *
             * The name for the team with which the content is associated.
             */
         teamName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.id | app.Context.channel.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.id | app.Context.channel.id} instead
             *
             * The Microsoft Teams ID for the channel with which the content is associated.
             */
         channelId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.displayName | app.Context.channel.displayName} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.displayName | app.Context.channel.displayName} instead
             *
             * The name for the channel with which the content is associated.
             */
         channelName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.membershipType | app.Context.channel.membershipType} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.membershipType | app.Context.channel.membershipType} instead
             *
             * The type of the channel with which the content is associated.
             */
         channelType?: ChannelType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.id | app.Context.page.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.id | app.Context.page.id} instead
             *
             * The developer-defined unique ID for the entity this content points to.
             */
         entityId: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.subPageId | app.Context.page.subPageId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.subPageId | app.Context.page.subPageId} instead
             *
             * The developer-defined unique ID for the sub-entity this content points to.
             * This field should be used to restore to a specific state within an entity,
@@ -3843,7 +3843,7 @@ export interface Context {
         subEntityId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.locale | app.Context.app.locale} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.locale | app.Context.app.locale} instead
             *
             * The current locale that the user has configured for the app formatted as
             * languageId-countryId (for example, en-us).
@@ -3851,7 +3851,7 @@ export interface Context {
         locale: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.osLocaleInfo | app.Context.app.osLocaleInfo} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.osLocaleInfo | app.Context.app.osLocaleInfo} instead
             *
             * More detailed locale info from the user's OS if available. Can be used together with
             * the @microsoft/globe NPM package to ensure your app respects the user's OS date and
@@ -3861,7 +3861,7 @@ export interface Context {
         /**
             * @deprecated
             *
-            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} or
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} or
             * {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead.
             * The UPN of the current user.
             * Because a malicious party can run your content in a browser, this value should
@@ -3871,7 +3871,7 @@ export interface Context {
         upn?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TenantInfo.id | app.Context.user.tenant.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TenantInfo.id | app.Context.user.tenant.id} instead
             *
             * The Microsoft Entra tenant ID of the current user.
             * Because a malicious party can run your content in a browser, this value should
@@ -3881,77 +3881,77 @@ export interface Context {
         tid?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.theme | app.Context.app.theme} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.theme | app.Context.app.theme} instead
             *
             * The current UI theme.
             */
         theme?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.isFullScreen | app.Context.page.isFullScreen} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.isFullScreen | app.Context.page.isFullScreen} instead
             *
             * Indication whether the tab is in full-screen mode.
             */
         isFullScreen?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.type | app.Context.team.type} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.type | app.Context.team.type} instead
             *
             * The type of the team.
             */
         teamType?: TeamType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteUrl | app.Context.sharePointSite.teamSiteUrl} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.teamSiteUrl | app.Context.sharePointSite.teamSiteUrl} instead
             *
             * The root SharePoint site associated with the team.
             */
         teamSiteUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteDomain | app.Context.sharePointSite.teamSiteDomain} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.teamSiteDomain | app.Context.sharePointSite.teamSiteDomain} instead
             *
             * The domain of the root SharePoint site associated with the team.
             */
         teamSiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSitePath | app.Context.sharePointSite.teamSitePath} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.teamSitePath | app.Context.sharePointSite.teamSitePath} instead
             *
             * The relative path to the SharePoint site associated with the team.
             */
         teamSitePath?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.ownerTenantId | app.Context.channel.ownerTenantId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.ownerTenantId | app.Context.channel.ownerTenantId} instead
             *
             * The tenant ID of the host team.
             */
         hostTeamTenantId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.ownerGroupId | app.Context.channel.ownerGroupId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.ownerGroupId | app.Context.channel.ownerGroupId} instead
             *
             * The Microsoft Entra group ID of the host team.
             */
         hostTeamGroupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.relativeUrl | app.Context.channel.relativeUrl} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.relativeUrl | app.Context.channel.relativeUrl} instead
             *
             * The relative path to the SharePoint folder associated with the channel.
             */
         channelRelativeUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppHostInfo.sessionId | app.Context.app.host.sessionId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppHostInfo.sessionId | app.Context.app.host.sessionId} instead
             *
             * Unique ID for the current Teams session for use in correlating telemetry data.
             */
         sessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.userRole | app.Context.team.userRole} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.userRole | app.Context.team.userRole} instead
             *
             * The user's role in the team.
             * Because a malicious party can run your content in a browser, this value should
@@ -3960,14 +3960,14 @@ export interface Context {
         userTeamRole?: UserTeamRole;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChatInfo.id | app.Context.chat.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChatInfo.id | app.Context.chat.id} instead
             *
             * The Microsoft Teams ID for the chat with which the content is associated.
             */
         chatId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} instead
             *
             * A value suitable for use as a login_hint when authenticating with Microsoft Entra ID.
             * Because a malicious party can run your content in a browser, this value should
@@ -3977,7 +3977,7 @@ export interface Context {
         loginHint?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead
             *
             * The UPN of the current user. This may be an externally-authenticated UPN (e.g., guest users).
             * Because a malicious party run your content in a browser, this value should
@@ -3987,7 +3987,7 @@ export interface Context {
         userPrincipalName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.id | app.Context.user.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.id | app.Context.user.id} instead
             *
             * The Microsoft Entra object ID of the current user.
             * Because a malicious party run your content in a browser, this value should
@@ -3997,7 +3997,7 @@ export interface Context {
         userObjectId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.isArchived | app.Context.team.isArchived} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.isArchived | app.Context.team.isArchived} instead
             *
             * Indicates whether team is archived.
             * Apps should use this as a signal to prevent any changes to content associated with archived teams.
@@ -4005,14 +4005,14 @@ export interface Context {
         isTeamArchived?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppHostInfo.name | app.Context.app.host.name} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppHostInfo.name | app.Context.app.host.name} instead
             *
             * The name of the host client. Possible values are: Office, Orange, Outlook, Teams
             */
         hostName?: HostName;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppHostInfo.clientType | app.Context.app.host.clientType} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppHostInfo.clientType | app.Context.app.host.clientType} instead
             *
             * The type of the host client. Possible values are : android, ios, web, desktop, rigel(deprecated, use teamsRoomsWindows instead),
             * surfaceHub, teamsRoomsWindows, teamsRoomsAndroid, teamsPhones, teamsDisplays
@@ -4020,35 +4020,35 @@ export interface Context {
         hostClientType?: HostClientType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.frameContext | app.Context.page.frameContext} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.frameContext | app.Context.page.frameContext} instead
             *
             * The context where tab url is loaded (content, task, setting, remove, sidePanel)
             */
         frameContext?: FrameContexts;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context | app.Context.sharepoint} instead
+            * As of TeamsJS v2.0.0, please use {@link app.Context | app.Context.sharepoint} instead
             *
             * SharePoint context. This is only available when hosted in SharePoint.
             */
         sharepoint?: any;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TenantInfo.teamsSku | app.Context.tenant.teamsSku} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TenantInfo.teamsSku | app.Context.tenant.teamsSku} instead
             *
             * The type of license for the current users tenant.
             */
         tenantSKU?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.licenseType | app.Context.user.licenseType} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.licenseType | app.Context.user.licenseType} instead
             *
             * The license type for the current user.
             */
         userLicenseType?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.parentMessageId | app.Context.app.parentMessageId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.parentMessageId | app.Context.app.parentMessageId} instead
             *
             * The ID of the parent message from which this task module was launched.
             * This is only available in task modules launched from bot cards.
@@ -4056,126 +4056,133 @@ export interface Context {
         parentMessageId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppHostInfo.ringId | app.Context.app.host.ringId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppHostInfo.ringId | app.Context.app.host.ringId} instead
             *
             * Current ring ID
             */
         ringId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.sessionId | app.Context.app.sessionId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.sessionId | app.Context.app.sessionId} instead
             *
             * Unique ID for the current session for use in correlating telemetry data. A session corresponds to the lifecycle of an app. A new session begins upon the creation of a webview (on Teams mobile) or iframe (in Teams desktop) hosting the app, and ends when it is destroyed.
             */
         appSessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.appLaunchId | app.Context.app.appLaunchId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.appLaunchId | app.Context.app.appLaunchId} instead
             *
             * ID for the current visible app which is different for across cached sessions. Used for correlating telemetry data``
             */
         appLaunchId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.isCallingAllowed | app.Context.user.isCallingAllowed} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.isCallingAllowed | app.Context.user.isCallingAllowed} instead
             *
             * Represents whether calling is allowed for the current logged in User
             */
         isCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.isPSTNCallingAllowed | app.Context.user.isPSTNCallingAllowed} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.isPSTNCallingAllowed | app.Context.user.isPSTNCallingAllowed} instead
             *
             * Represents whether PSTN calling is allowed for the current logged in User
             */
         isPSTNCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.MeetingInfo.id | app.Context.meeting.id} instead
+            * As of TeamsJS v2.0.0, please use {@link app.MeetingInfo.id | app.Context.meeting.id} instead
             *
             * Meeting Id used by tab when running in meeting context
             */
         meetingId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ChannelInfo.defaultOneNoteSectionId | app.Context.channel.defaultOneNoteSectionId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.ChannelInfo.defaultOneNoteSectionId | app.Context.channel.defaultOneNoteSectionId} instead
             *
             * The OneNote section ID that is linked to the channel.
             */
         defaultOneNoteSectionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.isMultiWindow | app.Context.page.isMultiWindow} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.isMultiWindow | app.Context.page.isMultiWindow} instead
             *
             * Indication whether the tab is in a pop out window
             */
         isMultiWindow?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.iconPositionVertical | app.Context.app.iconPositionVertical} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.isBackgroundLoad | app.Context.page.isBackgroundLoad} instead
+            *
+            * Indication whether the tab is being loaded in the background
+            */
+        isBackgroundLoad?: boolean;
+        /**
+            * @deprecated
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.iconPositionVertical | app.Context.app.iconPositionVertical} instead
             *
             * Personal app icon y coordinate position
             */
         appIconPosition?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.PageInfo.sourceOrigin | app.Context.page.sourceOrigin} instead
+            * As of TeamsJS v2.0.0, please use {@link app.PageInfo.sourceOrigin | app.Context.page.sourceOrigin} instead
             *
             * Source origin from where the tab is opened
             */
         sourceOrigin?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.userClickTime | app.Context.app.userClickTime} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.userClickTime | app.Context.app.userClickTime} instead
             *
             * Time when the user clicked on the tab
             */
         userClickTime?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.TeamInfo.templateId | app.Context.team.templateId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.TeamInfo.templateId | app.Context.team.templateId} instead
             *
             * Team Template ID if there was a Team Template associated with the creation of the team.
             */
         teamTemplateId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.AppInfo.userFileOpenPreference | app.Context.app.userFileOpenPreference} instead
+            * As of TeamsJS v2.0.0, please use {@link app.AppInfo.userFileOpenPreference | app.Context.app.userFileOpenPreference} instead
             *
             * Where the user prefers the file to be opened from by default during file open
             */
         userFileOpenPreference?: FileOpenPreference;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.UserInfo.displayName | app.Context.user.displayName} instead
+            * As of TeamsJS v2.0.0, please use {@link app.UserInfo.displayName | app.Context.user.displayName} instead
             *
             * The address book name of the current user.
             */
         userDisplayName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteId | app.Context.sharePointSite.teamSiteId} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.teamSiteId | app.Context.sharePointSite.teamSiteId} instead
             *
             * Teamsite ID, aka sharepoint site id.
             */
         teamSiteId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySiteDomain | app.Context.sharePointSite.mySiteDomain} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.mySiteDomain | app.Context.sharePointSite.mySiteDomain} instead
             *
             * The SharePoint my site domain associated with the user.
             */
         mySiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySitePath | app.Context.sharePointSite.mySitePath} instead
+            * As of TeamsJS v2.0.0, please use {@link app.SharePointSiteInfo.mySitePath | app.Context.sharePointSite.mySitePath} instead
             *
             * The SharePoint relative path to the current users mysite
             */
         mySitePath?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.dialogParameters} instead
+            * As of TeamsJS v2.0.0, please use {@link app.Context.dialogParameters} instead
             *
             * When `processActionCommand` activates a dialog, this dialog should automatically fill in some fields with information. This information comes from M365 and is given to `processActionCommand` as `extractedParameters`.
             * App developers need to use these `extractedParameters` in their dialog.
@@ -4202,7 +4209,7 @@ export interface ShareDeepLinkParameters {
 }
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link ShareDeepLinkParameters} instead.
+    * As of TeamsJS v2.0.0, please use {@link ShareDeepLinkParameters} instead.
     */
 export interface DeepLinkParameters {
         /**
@@ -4336,7 +4343,7 @@ export interface DialogInfo {
 }
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link DialogInfo} instead.
+    * As of TeamsJS v2.0.0, please use {@link DialogInfo} instead.
     */
 export type TaskInfo = DialogInfo;
 /**
@@ -4371,7 +4378,7 @@ export interface FrameInfo {
 }
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link FrameInfo} instead.
+    * As of TeamsJS v2.0.0, please use {@link FrameInfo} instead.
     */
 export type FrameContext = FrameInfo;
 /** Represents an error that occurs during the execution of an app or integration. */
@@ -4726,6 +4733,11 @@ export namespace app {
                     * Indication whether the page is in a pop out window
                     */
                 isMultiWindow?: boolean;
+                /**
+                    * Indicates whether the page is being loaded in the background as
+                    * part of an opt-in performance enhancement.
+                    */
+                isBackgroundLoad?: boolean;
                 /**
                     * Source origin from where the page is opened
                     */
@@ -5010,10 +5022,35 @@ export namespace app {
             */
         function registerOnThemeChangeHandler(handler: themeHandler): void;
         /**
-            * open link API.
+            * This function opens deep links to other modules in the host such as chats or channels or
+            * general-purpose links (to external websites). It should not be used for navigating to your
+            * own or other apps.
             *
-            * @param deepLink - deep link.
-            * @returns Promise that will be fulfilled when the operation has completed
+            * @remarks
+            * If you need to navigate to your own or other apps, use:
+            *
+            * - {@link pages.currentApp.navigateToDefaultPage} for navigating to the default page of your own app
+            * - {@link pages.currentApp.navigateTo} for navigating to a section of your own app
+            * - {@link pages.navigateToApp} for navigating to other apps besides your own
+            *
+            * Many areas of functionality previously provided by deep links are now handled by strongly-typed functions in capabilities.
+            * If your app is using a deep link to trigger these specific components, use the strongly-typed alternatives.
+            * For example (this list is not exhaustive):
+            * - To open an app installation dialog, use the {@link appInstallDialog} capability
+            * - To start a call, use the {@link call} capability
+            * - To open a chat, use the {@link chat} capability
+            * - To open a dialog, use the {@link dialog} capability
+            * - To create a new meeting, use the {@link calendar.composeMeeting} function
+            * - To open a Stage View, use the {@link stageView} capability
+            *
+            * In each of these capabilities, you can use the `isSupported()` function to determine if the host supports that capability.
+            * When using a deep link to trigger these components, there's no way to determine whether the host supports it.
+            *
+            * For more information on crafting deep links to the host, see [Configure deep links](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/deep-links)
+            *
+            * @param deepLink The host deep link or external web URL to which to navigate
+            * @returns `Promise` that will be fulfilled when the navigation has initiated. A successful `Promise` resolution
+            * does not necessarily indicate whether the target loaded successfully.
             */
         function openLink(deepLink: string): Promise<void>;
         /**
@@ -5754,13 +5791,12 @@ export namespace pages {
             */
         function navigateCrossDomain(url: string): Promise<void>;
         /**
-            * Navigate to the given application ID and page ID, with optional parameters for a WebURL (if the application
-            * cannot be navigated to, such as if it is not installed), Channel ID (for applications installed as a channel tab),
-            * and sub-page ID (for navigating to specific content within the page). This is equivalent to navigating to
-            * a deep link with the above data, but does not require the application to build a URL or worry about different
-            * deep link formats for different hosts.
-            * @param params - Parameters for the navigation
-            * @returns a promise that will resolve if the navigation was successful
+            * Used to navigate to apps other than your own.
+            *
+            * If you are looking to navigate within your own app, use {@link pages.currentApp.navigateToDefaultPage} or {@link pages.currentApp.navigateTo}
+            *
+            * @param params Parameters for the navigation
+            * @returns a `Promise` that will resolve if the navigation was successful or reject if it was not
             */
         function navigateToApp(params: NavigateToAppParams): Promise<void>;
         /**
@@ -5790,24 +5826,24 @@ export namespace pages {
             */
         interface NavigateToAppParams {
                 /**
-                    * ID of the application to navigate to
+                    * ID of the app to navigate to
                     */
                 appId: string;
                 /**
-                    * Developer-defined ID of the Page to navigate to within the application (Formerly EntityID)
+                    * Developer-defined ID of the page to navigate to within the app (formerly called `entityId`)
                     */
                 pageId: string;
                 /**
-                    * Optional URL to open if the navigation cannot be completed within the host
+                    * Fallback URL to open if the navigation cannot be completed within the host (e.g. if the target app is not installed)
                     */
                 webUrl?: string;
                 /**
-                    * Optional developer-defined ID describing the content to navigate to within the Page. This will be passed
-                    * back to the application via the Context object.
+                    * Developer-defined ID describing the content to navigate to within the page. This ID is passed to the application
+                    * via the {@link app.PageInfo.subPageId} property on the {@link app.Context} object (retrieved by calling {@link app.getContext})
                     */
                 subPageId?: string;
                 /**
-                    * Optional ID of the Teams Channel where the application should be opened
+                    * For apps installed as a channel tab, this ID can be supplied to indicate in which Teams channel the app should be opened
                     */
                 channelId?: string;
         }
@@ -6075,16 +6111,19 @@ export namespace pages {
                 function isSupported(): boolean;
         }
         /**
-            * Provides functions for navigating without needing to specify your application ID.
+            * Provides functions for navigating within your own app
+            *
+            * @remarks
+            * If you are looking to navigate to a different app, use {@link pages.navigateToApp}.
             */
         namespace currentApp {
                 /**
-                    * Parameters for the NavigateWithinApp
+                    * Parameters provided to the {@link pages.currentApp.navigateTo} function
                     */
                 interface NavigateWithinAppParams {
                         /**
                             * The developer-defined unique ID for the page defined in the manifest or when first configuring
-                            * the page. (Known as {@linkcode Context.entityId} prior to TeamsJS v.2.0.0)
+                            * the page. (Known as {@linkcode Context.entityId} prior to TeamsJS v2.0.0)
                             */
                         pageId: string;
                         /**
@@ -6094,15 +6133,20 @@ export namespace pages {
                         subPageId?: string;
                 }
                 /**
-                    * Navigate within the currently running application with page ID, and sub-page ID (for navigating to
-                    * specific content within the page).
-                    * @param params - Parameters for the navigation
-                    * @returns a promise that will resolve if the navigation was successful
+                    * Navigate within the currently running app
+                    *
+                    * @remarks
+                    * If you are looking to navigate to a different app, use {@link pages.navigateToApp}.
+                    *
+                    * @param params Parameters for the navigation
+                    * @returns `Promise` that will resolve if the navigation was successful and reject if not
                     */
                 function navigateTo(params: NavigateWithinAppParams): Promise<void>;
                 /**
-                    * Navigate to the currently running application's first static page defined in the application
+                    * Navigate to the currently running app's first static page defined in the application
                     * manifest.
+                    *
+                    * @returns `Promise` that will resolve if the navigation was successful and reject if not
                     */
                 function navigateToDefaultPage(): Promise<void>;
                 /**
@@ -7828,7 +7872,7 @@ export namespace monetization {
         function openPurchaseExperience(planInfo?: PlanInfo): Promise<void>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
             *
             * @hidden
             * Open dialog to start user's purchase experience
@@ -8082,7 +8126,7 @@ export namespace people {
         function selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise<PeoplePickerResult[]>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link people.selectPeople people.selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise\<PeoplePickerResult[]\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link people.selectPeople people.selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise\<PeoplePickerResult[]\>} instead.
             *
             * Launches a people picker and allows the user to select one or more people from the list
             * If the app is added to personal app scope the people picker launched is org wide and if the app is added to a chat/channel, people picker launched is also limited to the members of chat/channel
@@ -8634,7 +8678,7 @@ export namespace sharing {
         export function shareWebContent(shareWebContentRequest: IShareRequest<IShareRequestContentType>): Promise<void>;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link sharing.shareWebContent sharing.shareWebContent(shareWebContentRequest: IShareRequest\<IShareRequestContentType\>): Promise\<void\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link sharing.shareWebContent sharing.shareWebContent(shareWebContentRequest: IShareRequest\<IShareRequestContentType\>): Promise\<void\>} instead.
             *
             * Feature is under development
             * Opens a share dialog for web content
@@ -9063,46 +9107,46 @@ export namespace call {
 export namespace appInitialization {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Messages} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.Messages} instead.
             */
         export import Messages = app.Messages;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.FailedReason} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.FailedReason} instead.
             */
         export import FailedReason = app.FailedReason;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.ExpectedFailureReason} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.ExpectedFailureReason} instead.
             */
         export import ExpectedFailureReason = app.ExpectedFailureReason;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.IFailedRequest} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.IFailedRequest} instead.
             */
         export import IFailedRequest = app.IFailedRequest;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.IExpectedFailureRequest} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.IExpectedFailureRequest} instead.
             */
         export import IExpectedFailureRequest = app.IExpectedFailureRequest;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.notifyAppLoaded app.notifyAppLoaded(): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.notifyAppLoaded app.notifyAppLoaded(): void} instead.
             *
             * Notifies the frame that app has loaded and to hide the loading indicator if one is shown.
             */
         function notifyAppLoaded(): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.notifySuccess app.notifySuccess(): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.notifySuccess app.notifySuccess(): void} instead.
             *
             * Notifies the frame that app initialization is successful and is ready for user interaction.
             */
         function notifySuccess(): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.notifyFailure app.notifyFailure(appInitializationFailedRequest: IFailedRequest): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.notifyFailure app.notifyFailure(appInitializationFailedRequest: IFailedRequest): void} instead.
             *
             * Notifies the frame that app initialization has failed and to show an error page in its place.
             * @param appInitializationFailedRequest - The failure request containing the reason for why the app failed
@@ -9111,7 +9155,7 @@ export namespace appInitialization {
         function notifyFailure(appInitializationFailedRequest: IFailedRequest): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.notifyExpectedFailure app.notifyExpectedFailure(expectedFailureRequest: IExpectedFailureRequest): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link app.notifyExpectedFailure app.notifyExpectedFailure(expectedFailureRequest: IExpectedFailureRequest): void} instead.
             *
             * Notifies the frame that app initialized with some expected errors.
             * @param expectedFailureRequest - The expected failure request containing the reason and an optional message
@@ -9233,7 +9277,7 @@ export namespace thirdPartyCloudStorage {
         function isSupported(): boolean;
 }
 
-/** Execute deep link on complete function type */
+/** Type of callback used to indicate when {@link executeDeepLink} completes */
 export type executeDeepLinkOnCompleteFunctionType = (status: boolean, reason?: string) => void;
 /** Callback function type */
 export type callbackFunctionType = () => void;
@@ -9249,7 +9293,7 @@ export type registerFullScreenHandlerFunctionType = (isFullScreen: boolean) => v
 export type registerOnThemeChangeHandlerFunctionType = (theme: string) => void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.initialize app.initialize(validMessageOrigins?: string[]): Promise\<void\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link app.initialize app.initialize(validMessageOrigins?: string[]): Promise\<void\>} instead.
     *
     * Initializes the library. This must be called before any other SDK calls
     * but after the frame is loaded successfully.
@@ -9260,21 +9304,21 @@ export type registerOnThemeChangeHandlerFunctionType = (theme: string) => void;
 export function initialize(callback?: callbackFunctionType, validMessageOrigins?: string[]): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link teamsCore.enablePrintCapability teamsCore.enablePrintCapability(): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link teamsCore.enablePrintCapability teamsCore.enablePrintCapability(): void} instead.
     *
     * Enable print capability to support printing page using Ctrl+P and cmd+P
     */
 export function enablePrintCapability(): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link teamsCore.print teamsCore.print(): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link teamsCore.print teamsCore.print(): void} instead.
     *
     * Default print handler
     */
 export function print(): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.getContext app.getContext(): Promise\<app.Context\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link app.getContext app.getContext(): Promise\<app.Context\>} instead.
     *
     * Retrieves the current context the frame is running in.
     *
@@ -9283,7 +9327,7 @@ export function print(): void;
 export function getContext(callback: getContextCallbackFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.registerOnThemeChangeHandler app.registerOnThemeChangeHandler(handler: registerOnThemeChangeHandlerFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link app.registerOnThemeChangeHandler app.registerOnThemeChangeHandler(handler: registerOnThemeChangeHandlerFunctionType): void} instead.
     *
     * Registers a handler for theme changes.
     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -9293,7 +9337,7 @@ export function getContext(callback: getContextCallbackFunctionType): void;
 export function registerOnThemeChangeHandler(handler: registerOnThemeChangeHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.registerFullScreenHandler pages.registerFullScreenHandler(handler: registerFullScreenHandlerFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.registerFullScreenHandler pages.registerFullScreenHandler(handler: registerFullScreenHandlerFunctionType): void} instead.
     *
     * Registers a handler for changes from or to full-screen view for a tab.
     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -9303,7 +9347,7 @@ export function registerOnThemeChangeHandler(handler: registerOnThemeChangeHandl
 export function registerFullScreenHandler(handler: registerFullScreenHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.appButton.onClick pages.appButton.onClick(handler: callbackFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.appButton.onClick pages.appButton.onClick(handler: callbackFunctionType): void} instead.
     *
     * Registers a handler for clicking the app button.
     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -9313,7 +9357,7 @@ export function registerFullScreenHandler(handler: registerFullScreenHandlerFunc
 export function registerAppButtonClickHandler(handler: callbackFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.appButton.onHoverEnter pages.appButton.onHoverEnter(handler: callbackFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.appButton.onHoverEnter pages.appButton.onHoverEnter(handler: callbackFunctionType): void} instead.
     *
     * Registers a handler for entering hover of the app button.
     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -9323,7 +9367,7 @@ export function registerAppButtonClickHandler(handler: callbackFunctionType): vo
 export function registerAppButtonHoverEnterHandler(handler: callbackFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.appButton.onHoverLeave pages.appButton.onHoverLeave(handler: callbackFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.appButton.onHoverLeave pages.appButton.onHoverLeave(handler: callbackFunctionType): void} instead.
     *
     * Registers a handler for exiting hover of the app button.
     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -9333,7 +9377,7 @@ export function registerAppButtonHoverEnterHandler(handler: callbackFunctionType
 export function registerAppButtonHoverLeaveHandler(handler: callbackFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.backStack.registerBackButtonHandler pages.backStack.registerBackButtonHandler(handler: registerBackButtonHandlerFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.backStack.registerBackButtonHandler pages.backStack.registerBackButtonHandler(handler: registerBackButtonHandlerFunctionType): void} instead.
     *
     * Registers a handler for user presses of the Team client's back button. Experiences that maintain an internal
     * navigation stack should use this handler to navigate the user back within their frame. If an app finds
@@ -9345,7 +9389,7 @@ export function registerAppButtonHoverLeaveHandler(handler: callbackFunctionType
 export function registerBackButtonHandler(handler: registerBackButtonHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link teamsCore.registerOnLoadHandler teamsCore.registerOnLoadHandler(handler: (context: LoadContext) => void): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link teamsCore.registerOnLoadHandler teamsCore.registerOnLoadHandler(handler: (context: LoadContext) => void): void} instead.
     *
     * @hidden
     * Registers a handler to be called when the page has been requested to load.
@@ -9355,7 +9399,7 @@ export function registerBackButtonHandler(handler: registerBackButtonHandlerFunc
 export function registerOnLoadHandler(handler: (context: LoadContext) => void): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link teamsCore.registerBeforeUnloadHandler teamsCore.registerBeforeUnloadHandler(handler: (readyToUnload: callbackFunctionType) => boolean): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link teamsCore.registerBeforeUnloadHandler teamsCore.registerBeforeUnloadHandler(handler: (readyToUnload: callbackFunctionType) => boolean): void} instead.
     *
     * @hidden
     * Registers a handler to be called before the page is unloaded.
@@ -9366,7 +9410,7 @@ export function registerOnLoadHandler(handler: (context: LoadContext) => void):
 export function registerBeforeUnloadHandler(handler: (readyToUnload: callbackFunctionType) => boolean): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.registerFocusEnterHandler pages.registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.registerFocusEnterHandler pages.registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void} instead.
     *
     * @hidden
     * Registers a handler when focus needs to be passed from teams to the place of choice on app.
@@ -9376,7 +9420,7 @@ export function registerBeforeUnloadHandler(handler: (readyToUnload: callbackFun
 export function registerFocusEnterHandler(handler: (navigateForward: boolean) => boolean): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.config.registerChangeConfigHandler pages.config.registerChangeConfigHandler(handler: callbackFunctionType): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.config.registerChangeConfigHandler pages.config.registerChangeConfigHandler(handler: callbackFunctionType): void} instead.
     *
     * Registers a handler for when the user reconfigurated tab.
     *
@@ -9385,7 +9429,7 @@ export function registerFocusEnterHandler(handler: (navigateForward: boolean) =>
 export function registerChangeSettingsHandler(handler: callbackFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.tabs.getTabInstances pages.tabs.getTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.tabs.getTabInstances pages.tabs.getTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
     *
     * Allows an app to retrieve for this user tabs that are owned by this app.
     * If no TabInstanceParameters are passed, the app defaults to favorite teams and favorite channels.
@@ -9396,7 +9440,7 @@ export function registerChangeSettingsHandler(handler: callbackFunctionType): vo
 export function getTabInstances(callback: getTabInstancesCallbackFunctionType, tabInstanceParameters?: TabInstanceParameters): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.tabs.getMruTabInstances pages.tabs.getMruTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.tabs.getMruTabInstances pages.tabs.getMruTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
     *
     * Allows an app to retrieve the most recently used tabs for this user.
     *
@@ -9406,7 +9450,7 @@ export function getTabInstances(callback: getTabInstancesCallbackFunctionType, t
 export function getMruTabInstances(callback: getTabInstancesCallbackFunctionType, tabInstanceParameters?: TabInstanceParameters): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.shareDeepLink pages.shareDeepLink(deepLinkParameters: DeepLinkParameters): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.shareDeepLink pages.shareDeepLink(deepLinkParameters: DeepLinkParameters): void} instead.
     *
     * Shares a deep link that a user can use to navigate back to a specific state in this page.
     *
@@ -9415,16 +9459,21 @@ export function getMruTabInstances(callback: getTabInstancesCallbackFunctionType
 export function shareDeepLink(deepLinkParameters: DeepLinkParameters): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.openLink app.openLink(deepLink: string): Promise\<void\>} instead.
+    * This function was previously used for opening various types of links. As of TeamsJS v2.0.0, it has been replaced with multiple different
+    * functions depending on the type of link:
     *
-    * Execute deep link API.
+    * - Use {@link pages.currentApp.navigateToDefaultPage} to navigate to the default page of your own app
+    * - Use {@link pages.currentApp.navigateTo} to navigate to a section of your own app
+    * - Use {@link pages.navigateToApp} to navigate to other apps besides your own
+    * - Use {@link app.openLink} for opening deep links to other parts of the host (e.g., to chats or channels) or
+    * general-purpose links (e.g., to external websites).
     *
-    * @param deepLink - deep link.
+    * @param deepLink deep link.
     */
 export function executeDeepLink(deepLink: string, onComplete?: executeDeepLinkOnCompleteFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.setCurrentFrame pages.setCurrentFrame(frameInfo: FrameInfo): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.setCurrentFrame pages.setCurrentFrame(frameInfo: FrameInfo): void} instead.
     *
     * Set the current Frame Context
     *
@@ -9433,7 +9482,7 @@ export function executeDeepLink(deepLink: string, onComplete?: executeDeepLinkOn
 export function setFrameContext(frameContext: FrameContext): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: callbackFunctionType, validMessageOrigins?: string[],): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: callbackFunctionType, validMessageOrigins?: string[],): void} instead.
     *
     * Initialize with FrameContext
     *
@@ -9448,7 +9497,7 @@ export function initializeWithFrameContext(frameContext: FrameContext, callback?
 export type onCompleteHandlerFunctionType = (status: boolean, reason?: string) => void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.returnFocus pages.returnFocus(navigateForward?: boolean): void} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.returnFocus pages.returnFocus(navigateForward?: boolean): void} instead.
     *
     * Return focus to the main Teams app. Will focus search bar if navigating foward and app bar if navigating back.
     *
@@ -9457,7 +9506,7 @@ export type onCompleteHandlerFunctionType = (status: boolean, reason?: string) =
 export function returnFocus(navigateForward?: boolean): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.tabs.navigateToTab pages.tabs.navigateToTab(tabInstance: TabInstance): Promise\<void\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.tabs.navigateToTab pages.tabs.navigateToTab(tabInstance: TabInstance): Promise\<void\>} instead.
     *
     * Navigates the Microsoft Teams app to the specified tab instance.
     *
@@ -9467,7 +9516,7 @@ export function returnFocus(navigateForward?: boolean): void;
 export function navigateToTab(tabInstance: TabInstance, onComplete?: onCompleteHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.navigateCrossDomain pages.navigateCrossDomain(url: string): Promise\<void\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.navigateCrossDomain pages.navigateCrossDomain(url: string): Promise\<void\>} instead.
     *
     * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
     * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
@@ -9481,7 +9530,7 @@ export function navigateToTab(tabInstance: TabInstance, onComplete?: onCompleteH
 export function navigateCrossDomain(url: string, onComplete?: onCompleteHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.backStack.navigateBack pages.backStack.navigateBack(): Promise\<void\>} instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.backStack.navigateBack pages.backStack.navigateBack(): Promise\<void\>} instead.
     *
     * Navigates back in the Teams client.
     * See registerBackButtonHandler for more information on when it's appropriate to use this method.
@@ -9492,7 +9541,7 @@ export function navigateBack(onComplete?: onCompleteHandlerFunctionType): void;
 
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link pages.config} namespace instead.
+    * As of TeamsJS v2.0.0, please use {@link pages.config} namespace instead.
     *
     * Namespace to interact with the settings-specific part of the SDK.
     * This object is usable only on the settings frame.
@@ -9508,35 +9557,35 @@ export namespace settings {
         type getSettingsCallbackFunctionType = (instanceSettings: Settings) => void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.Config} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.Config} instead.
             * @remarks
             * Renamed to config in pages.Config
             */
         export import Settings = pages.InstanceConfig;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.SaveEvent} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.SaveEvent} instead.
             * @remarks
             * See pages.SaveEvent
             */
         export import SaveEvent = pages.config.SaveEvent;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.RemoveEvent} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.RemoveEvent} instead.
             * @remarks
             * See pages.RemoveEvent
             */
         export import RemoveEvent = pages.config.RemoveEvent;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.SaveParameters} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.SaveParameters} instead.
             * @remarks
             * See pages.SaveParameters
             */
         export import SaveParameters = pages.config.SaveParameters;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.setValidityState pages.config.setValidityState(validityState: boolean): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.setValidityState pages.config.setValidityState(validityState: boolean): void} instead.
             *
             * Sets the validity state for the settings.
             * The initial value is false, so the user cannot save the settings until this is called with true.
@@ -9546,7 +9595,7 @@ export namespace settings {
         function setValidityState(validityState: boolean): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.getConfig pages.getConfig(): Promise\<InstanceConfig\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.getConfig pages.getConfig(): Promise\<InstanceConfig\>} instead.
             *
             * Gets the settings for the current instance.
             *
@@ -9555,7 +9604,7 @@ export namespace settings {
         function getSettings(callback: getSettingsCallbackFunctionType): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.setConfig pages.config.setConfig(instanceSettings: Config): Promise\<void\>} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.setConfig pages.config.setConfig(instanceSettings: Config): Promise\<void\>} instead.
             *
             * Sets the settings for the current instance.
             * This is an asynchronous operation; calls to getSettings are not guaranteed to reflect the changed state.
@@ -9565,7 +9614,7 @@ export namespace settings {
         function setSettings(instanceSettings: Settings, onComplete?: setSettingsOnCompleteFunctionType): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.registerOnSaveHandler pages.config.registerOnSaveHandler(handler: registerOnSaveHandlerFunctionType): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.registerOnSaveHandler pages.config.registerOnSaveHandler(handler: registerOnSaveHandlerFunctionType): void} instead.
             *
             * Registers a handler for when the user attempts to save the settings. This handler should be used
             * to create or update the underlying resource powering the content.
@@ -9577,7 +9626,7 @@ export namespace settings {
         function registerOnSaveHandler(handler: registerOnSaveHandlerFunctionType): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.registerOnRemoveHandler pages.config.registerOnRemoveHandler(handler: registerOnRemoveHandlerFunctionType): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link pages.config.registerOnRemoveHandler pages.config.registerOnRemoveHandler(handler: registerOnRemoveHandlerFunctionType): void} instead.
             *
             * Registers a handler for user attempts to remove content. This handler should be used
             * to remove the underlying resource powering the content.
@@ -9591,7 +9640,7 @@ export namespace settings {
 
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link dialog} namespace instead.
+    * As of TeamsJS v2.0.0, please use {@link dialog} namespace instead.
     *
     * Namespace to interact with the task module-specific part of the SDK.
     * This object is usable only on the content frame.
@@ -9624,7 +9673,7 @@ export namespace tasks {
         function startTask(taskInfo: TaskInfo, submitHandler?: startTaskSubmitHandlerFunctionType): IAppWindow;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link dialog.update.resize dialog.update.resize(dimensions: DialogSize): void} instead.
+            * As of TeamsJS v2.0.0, please use {@link dialog.update.resize dialog.update.resize(dimensions: DialogSize): void} instead.
             *
             * Update height/width task info properties.
             *