@azure/communication-react 1.5.1-alpha-202211250013.0 → 1.5.1-alpha-202301250013

package/dist/communication-react.d.ts

@@ -26,6 +26,7 @@ import { CallClientOptions } from '@azure/communication-calling';
 import { CallDirection } from '@azure/communication-calling';
 import { CallEndReason } from '@azure/communication-calling';
 import { CallerInfo } from '@azure/communication-calling';
+import { CallKind } from '@azure/communication-calling';
 import { CallState as CallState_2 } from '@azure/communication-calling';
 import { ChatClient } from '@azure/communication-chat';
 import { ChatClientOptions } from '@azure/communication-chat';
@@ -50,10 +51,8 @@ import { IButtonProps } from '@fluentui/react';
 import { IButtonStyles } from '@fluentui/react';
 import { IContextualMenuItem } from '@fluentui/react';
 import { IContextualMenuItemStyles } from '@fluentui/react';
+import { IContextualMenuProps } from '@fluentui/react';
 import { IContextualMenuStyles } from '@fluentui/react';
-import { IDropdownOption } from '@fluentui/react';
-import { IDropdownStyles } from '@fluentui/react';
-import { IIconProps } from '@fluentui/react';
 import { ILinkStyles } from '@fluentui/react';
 import { IMessageBarProps } from '@fluentui/react';
 import { IncomingCall } from '@azure/communication-calling';
@@ -67,6 +66,7 @@ import { LatestMediaDiagnostics } from '@azure/communication-calling';
 import { LatestNetworkDiagnostics } from '@azure/communication-calling';
 import type { MediaDiagnosticChangedEventArgs } from '@azure/communication-calling';
 import { MediaStreamType } from '@azure/communication-calling';
+import { MicrosoftTeamsUserIdentifier } from '@azure/communication-common';
 import { MicrosoftTeamsUserKind } from '@azure/communication-common';
 import type { NetworkDiagnosticChangedEventArgs } from '@azure/communication-calling';
 import { PartialTheme } from '@fluentui/react';
@@ -291,10 +291,6 @@ export declare type AzureCommunicationCallAdapterOptions = {
      * {@link CallComposite}. The true role of the user will be synced with ACS services when a Rooms call starts.
      */
     roleHint?: Role;
-    /**
-     * Optional feature flags to be enabled in the CallAdapter.
-     */
-    features?: CallAdapterOptionalFeatures;
 };
 
 /**
@@ -709,6 +705,10 @@ export declare interface CallAdapterCallOperations {
      * @beta
      */
     sendDtmfTone(dtmfTone: DtmfTone_2): Promise<void>;
+    /**
+     * Continues into a call when the browser version is not supported.
+     */
+    allowUnsupportedBrowserVersion(): void;
 }
 
 /**
@@ -735,16 +735,17 @@ export declare type CallAdapterClientState = {
      * Environment information about system the adapter is made on
      */
     environmentInfo?: EnvironmentInfo;
-    /**
-     * Optional features that are to be enabled through the adapter.
-     */
-    features?: CallAdapterOptionalFeatures;
     /**
      * Use this to hint the role of the user when the role is not available before a Rooms call is started. This value
      * should be obtained using the Rooms API. This role will determine permissions in the configuration page of the
      * {@link CallComposite}. The true role of the user will be synced with ACS services when a Rooms call starts.
      */
     roleHint?: Role;
+    /**
+     * State to track whether the local participant's camera is on. To be used when creating a custom
+     * control bar with the CallComposite.
+     */
+    cameraStatus?: 'On' | 'Off';
 };
 
 /**
@@ -831,18 +832,6 @@ export declare interface CallAdapterDeviceManagement {
  */
 export declare type CallAdapterLocator = TeamsMeetingLinkLocator | GroupCallLocator | /* @conditional-compile-remove(rooms) */ RoomCallLocator | /* @conditional-compile-remove(teams-adhoc-call) */ /* @conditional-compile-remove(PSTN-calls) */ CallParticipantsLocator;
 
-/**
- * options object to enable opt in features for the CallAdapter
- *
- * @beta
- */
-export declare type CallAdapterOptionalFeatures = {
-    /**
-     * Feature flag for enabling the unsupported environment logic in the CallAdapter.
-     */
-    unsupportedEnvironment?: boolean;
-};
-
 /**
  * {@link CommonCallAdapter} state.
  *
@@ -976,6 +965,7 @@ export declare interface CallAdapterSubscribers {
 export declare type CallAdapterUiState = {
     isLocalPreviewMicrophoneEnabled: boolean;
     page: CallCompositePage;
+    unsupportedBrowserVersionsAllowed?: boolean;
 };
 
 /**
@@ -1204,15 +1194,11 @@ export declare type CallCompositeOptions = {
      */
     callControls?: boolean | CallControlOptions;
     /**
-     * Device permission restrictions for your call.
-     * Require device permissions to be set or have them as optional or not required to start a call
+     * Device permissions check options for your call.
+     * Here you can choose what device permissions you prompt the user for,
+     * as well as what device permissions must be accepted before starting a call.
      */
-    devicePermissions?: DevicePermissionRestrictions;
-    /**
-     * Opt in call readiness feature for your call
-     * Setting this to `true` will add call readiness features to the call experience
-     */
-    callReadinessOptedIn?: boolean;
+    deviceChecks?: DeviceCheckOptions;
     /**
      * Callback you may provide to supply users with further steps to troubleshoot why they have been
      * unable to grant your site the required permissions for the call.
@@ -1257,6 +1243,10 @@ export declare type CallCompositeOptions = {
      * if this is not supplied, the composite will not show a unsupported browser page.
      */
     onEnvironmentInfoTroubleshootingClick?: () => void;
+    /**
+     * Remote participant video tile menu options
+     */
+    remoteVideoTileMenu?: RemoteVideoTileMenuOptions;
 };
 
 /**
@@ -1326,10 +1316,22 @@ export declare interface CallCompositeStrings {
      * Label for camera dropdown.
      */
     cameraLabel: string;
+    /**
+     * Label for when there are no cameras present on configuration screen.
+     */
+    noCamerasLabel: string;
     /**
      * Label for sound dropdown.
      */
     soundLabel: string;
+    /**
+     * Label for when no microphones were found on the configuration screen
+     */
+    noMicrophonesLabel: string;
+    /**
+     * Label for when no speakers were found on the configuration screen.
+     */
+    noSpeakersLabel: string;
     /**
      * Error shown when camera access is blocked by the browser.
      */
@@ -1590,6 +1592,50 @@ export declare interface CallCompositeStrings {
      * Label disaplayed on the lobby screen during a 1:1 outbound call.
      */
     outboundCallingNoticeString: string;
+    /**
+     * Notice to be announced by narrator when a participant joins a call
+     */
+    participantJoinedNoticeString: string;
+    /**
+     * Notice to be announced by narrator when a participant joins a call
+     */
+    twoParticipantJoinedNoticeString: string;
+    /**
+     * Notice to be announced by narrator when a participant joins a call
+     */
+    threeParticipantJoinedNoticeString: string;
+    /**
+     * Notice to be announced by narrator when a participant leaves a call
+     */
+    participantLeftNoticeString: string;
+    /**
+     * Notice to be announced by narrator when 2 participants leave a call
+     */
+    twoParticipantLeftNoticeString: string;
+    /**
+     * Notice to be announced by narrator when 3 participants leave a call
+     */
+    threeParticipantLeftNoticeString: string;
+    /**
+     * string to be used to announce a change in participant if they have no displayName
+     */
+    unnamedParticipantString: string;
+    /**
+     * string to be used to announce when more than 3 participants have joined at the same time.
+     */
+    manyParticipantsJoined: string;
+    /**
+     * string to be used to announce when more than 3 participants have left at the same time.
+     */
+    manyParticipantsLeft: string;
+    /**
+     * string to be used to announce when multiple unnamed participants have joined at the same time.
+     */
+    manyUnnamedParticipantsJoined: string;
+    /**
+     * string to be used to announce when multiple unnamed participants have left at the same time.
+     */
+    manyUnnamedParticipantsLeft: string;
 }
 
 /**
@@ -1851,7 +1897,7 @@ export declare interface CallState {
     /**
      * Type of the call.
      */
-    type: 'Teams' | 'ACS';
+    kind: CallKind;
     /**
      * Proxy of {@link @azure/communication-calling#Call.callerInfo}.
      */
@@ -2218,6 +2264,10 @@ export declare interface CallWithChatAdapterManagement {
      * @beta
      */
     sendDtmfTone: (dtmfTone: DtmfTone_2) => Promise<void>;
+    /**
+     * Continues into a call when the browser version is not supported.
+     */
+    allowUnsupportedBrowserVersion(): void;
 }
 
 /**
@@ -2296,6 +2346,14 @@ export declare interface CallWithChatAdapterUiState {
      * @beta
      */
     fileUploads?: FileUploadsUiState;
+    /**
+     * State to track whether the end user has opted in to using a
+     * out of date version of a supported browser. Allows the user
+     * to start a call in this state.
+     *
+     * @beta
+     */
+    unsupportedBrowserVersionsAllowed?: boolean;
 }
 
 /**
@@ -2426,10 +2484,11 @@ export declare type CallWithChatCompositeOptions = {
      */
     fileSharing?: FileSharingOptions;
     /**
-     * Device permission restrictions for your call.
-     * Require device permissions to be set or have them as optional or not required to start a call
+     * Device permissions check options for your call.
+     * Here you can choose what device permissions you prompt the user for,
+     * as well as what device permissions must be accepted before starting a call.
      */
-    devicePermissions?: DevicePermissionRestrictions;
+    deviceChecks?: DeviceCheckOptions;
     /**
      * Callback you may provide to supply users with further steps to troubleshoot why they have been
      * unable to grant your site the required permissions for the call.
@@ -2462,10 +2521,18 @@ export declare type CallWithChatCompositeOptions = {
      */
     onNetworkingTroubleShootingClick?: () => void;
     /**
-     * Opt in call readiness feature for your call
-     * setting this to True will add call readiness feature in call experience
+     * Callback you may provide to supply users with a provided page to showcase supported browsers by ACS.
+     *
+     * @example
+     * ```ts
+     * onBrowserTroubleShootingClick?: () =>
+     *  window.open('https://contoso.com/browser-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a unsupported browser page.
      */
-    callReadinessOptedIn?: boolean;
+    onEnvironmentInfoTroubleshootingClick?: () => void;
 };
 
 /**
@@ -2728,28 +2795,28 @@ export declare type CallWithChatEvent = 'callError' | 'chatError' | 'callEnded'
  * Component to allow Contoso to help their end user with their devices should their permissions be blocked
  * by their browsers settings.
  */
-export declare const CameraAndMicrophoneDomainPermissions: (props: CameraAndMicrophoneDomainPermissionsProps) => JSX.Element;
+export declare const CameraAndMicrophoneSitePermissions: (props: CameraAndMicrophoneSitePermissionsProps) => JSX.Element;
 
 /**
  * @beta
- * Props for CameraAndMicrophoneDomainPermissions component.
+ * Props for CameraAndMicrophoneSitePermissions component.
  */
-export declare interface CameraAndMicrophoneDomainPermissionsProps extends CommonDomainPermissionsProps {
+export declare interface CameraAndMicrophoneSitePermissionsProps extends CommonSitePermissionsProps {
     /** Icon name for the camera icon */
     cameraIconName?: string;
     /** Icon name for the microphone icon */
     microphoneIconName?: string;
     /** Icon name for the central icon between the camera and microphone icons */
     connectorIconName?: string;
-    /** Strings for use with the {@link CameraAndMicrophoneDomainPermissions} */
-    strings?: CameraAndMicrophoneDomainPermissionsStrings;
+    /** Strings for use with the {@link CameraAndMicrophoneSitePermissions} */
+    strings?: CameraAndMicrophoneSitePermissionsStrings;
 }
 
 /**
  * @beta
- * Strings for CameraAndMicrophoneDomainPermissions component.
+ * Strings for CameraAndMicrophoneSitePermissions component.
  */
-export declare type CameraAndMicrophoneDomainPermissionsStrings = DomainPermissionsStrings;
+export declare type CameraAndMicrophoneSitePermissionsStrings = SitePermissionsStrings;
 
 /**
  * A button to turn camera on / off.
@@ -2893,24 +2960,24 @@ export declare interface CameraButtonStyles extends ControlBarButtonStyles {
  *
  * @beta
  */
-export declare const CameraDomainPermissions: (props: CameraDomainPermissionsProps) => JSX.Element;
+export declare const CameraSitePermissions: (props: CameraSitePermissionsProps) => JSX.Element;
 
 /**
  * @beta
- * Props for CameraDomainPermissions component.
+ * Props for CameraSitePermissions component.
  */
-export declare interface CameraDomainPermissionsProps extends CommonDomainPermissionsProps {
+export declare interface CameraSitePermissionsProps extends CommonSitePermissionsProps {
     /** Icon name for the camera icon */
     cameraIconName?: string;
-    /** Strings for use with the {@link CameraDomainPermissions} */
-    strings?: CameraDomainPermissionsStrings;
+    /** Strings for use with the {@link CameraSitePermissions} */
+    strings?: CameraSitePermissionsStrings;
 }
 
 /**
  * @beta
- * Strings for CameraDomainPermissions component.
+ * Strings for CameraSitePermissions component.
  */
-export declare type CameraDomainPermissionsStrings = DomainPermissionsStrings;
+export declare type CameraSitePermissionsStrings = SitePermissionsStrings;
 
 /**
  * {@link ChatComposite} Adapter interface.
@@ -3533,19 +3600,32 @@ export declare interface CommonCallingHandlers {
     onStartCall: (participants: (CommunicationUserIdentifier | PhoneNumberIdentifier | UnknownIdentifier)[], options?: StartCallOptions) => void;
 }
 
+/**
+ * Return intersect properties of 2 types
+ *
+ * @public
+ */
+export declare type CommonProperties<A, B> = {
+    [P in keyof A & keyof B]: A[P] extends B[P] ? P : never;
+}[keyof A & keyof B];
+
 /**
  * @beta
- * Props for DomainPermissions components.
+ * Props for SitePermissions components.
  */
-export declare interface CommonDomainPermissionsProps {
+export declare interface CommonSitePermissionsProps {
     /**
      * Name of application calling experience is in.
      */
     appName: string;
     /**
-     * Type of the Domain Permissions component.
+     * Kind of the Site Permissions component.
+     */
+    kind: 'request' | 'denied' | 'check';
+    /**
+     * Type of the browser used, the Site permission component will show different guidance text based on the browser type
      */
-    type: 'request' | 'denied' | 'check';
+    browserHint?: 'safari' | 'unset';
     /**
      * Action to be taken by the more help link. Possible to send to external page or show other modal.
      * If this is not provided the button will not be shown.
@@ -3557,20 +3637,11 @@ export declare interface CommonDomainPermissionsProps {
      */
     onContinueAnywayClick?: () => void;
     /**
-     * Styles for DomainPermissions component.
+     * Styles for SitePermissions component.
      */
-    styles?: DomainPermissionsStyles;
+    styles?: SitePermissionsStyles;
 }
 
-/**
- * Return intersect properties of 2 types
- *
- * @public
- */
-export declare type CommonProperties<A, B> = {
-    [P in keyof A & keyof B]: A[P] extends B[P] ? P : never;
-}[keyof A & keyof B];
-
 /**
  * A Chat or Calling participant's state, as reflected in the UI.
  *
@@ -3750,26 +3821,36 @@ export declare interface ComponentStrings {
     videoTile: VideoTileStrings;
     /** Strings for HoldButton */
     holdButton: HoldButtonStrings;
-    /** Strings for a domain permission request prompt */
-    CameraAndMicrophoneDomainPermissionsRequest: DomainPermissionsStrings;
-    /** Strings for a domain permission request prompt */
-    CameraDomainPermissionsRequest: DomainPermissionsStrings;
-    /** Strings for a domain permission request prompt */
-    MicrophoneDomainPermissionsRequest: DomainPermissionsStrings;
-    /** Strings for a domain permission generic checking prompt */
-    CameraAndMicrophoneDomainPermissionsCheck: DomainPermissionsStrings;
-    /** Strings for a domain permission generic checking prompt */
-    CameraDomainPermissionsCheck: DomainPermissionsStrings;
-    /** Strings for a domain permission generic checking prompt */
-    MicrophoneDomainPermissionsCheck: DomainPermissionsStrings;
-    /** Strings for a domain permission denied prompt */
-    CameraAndMicrophoneDomainPermissionsDenied: DomainPermissionsStrings;
-    /** Strings for a domain permission denied prompt */
-    CameraDomainPermissionsDenied: DomainPermissionsStrings;
-    /** Strings for a domain permission denied prompt */
-    MicrophoneDomainPermissionsDenied: DomainPermissionsStrings;
+    /** Strings for a site's permission request prompt */
+    CameraAndMicrophoneSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission request prompt */
+    CameraSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission request prompt */
+    MicrophoneSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    CameraAndMicrophoneSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    CameraSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    MicrophoneSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    CameraAndMicrophoneSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    CameraAndMicrophoneSitePermissionsDeniedSafari: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    CameraSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    MicrophoneSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    CameraSitePermissionsDeniedSafari: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    MicrophoneSitePermissionsDeniedSafari: SitePermissionsStrings;
     /** Strings for unsupported browser UI */
     UnsupportedBrowser: UnsupportedBrowserStrings;
+    /** Strings for unsupported browser version UI */
+    UnsupportedBrowserVersion: UnsupportedBrowserVersionStrings;
+    /** Strings for unsupported browser version UI */
+    UnsupportedOperatingSystem: UnsupportedOperatingSystemStrings;
     /** Strings for BrowserPemissionDenied */
     BrowserPermissionDenied: BrowserPermissionDeniedStrings;
     /** Strings for BrowserPemissionDeniedIOS */
@@ -4081,7 +4162,7 @@ export declare interface ControlBarProps {
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator, alternateCallerId, options }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator, alternateCallerId }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
 
 /**
  * Create a {@link CallAdapter} using the provided {@link StatefulCallClient}.
@@ -4130,21 +4211,6 @@ export declare const createAzureCommunicationChatAdapter: ({ endpoint: endpointU
  */
 export declare const createAzureCommunicationChatAdapterFromClient: (chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => Promise<ChatAdapter>;
 
-/**
- * @beta
- */
-export declare const createAzureCommunicationTeamsCallAdapter: ({ userId, credential, locator, alternateCallerId }: AzureCommunicationCallAdapterArgs) => Promise<TeamsCallAdapter>;
-
-/**
- * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
- *
- * Useful if you want to keep a reference to {@link StatefulCallClient}.
- * Consider using {@link createAzureCommunicationCallAdapter} for a simpler API.
- *
- * @beta
- */
-export declare const createAzureCommunicationTeamsCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator) => Promise<TeamsCallAdapter>;
-
 /**
  * Create the default implementation of {@link CallingHandlers} for teams call.
  *
@@ -4202,6 +4268,21 @@ export declare const createStatefulCallClient: (args: StatefulCallClientArgs, op
  */
 export declare const createStatefulChatClient: (args: StatefulChatClientArgs, options?: StatefulChatClientOptions | undefined) => StatefulChatClient;
 
+/**
+ * @beta
+ */
+export declare const createTeamsCallAdapter: ({ userId, credential, locator }: TeamsCallAdapterArgs) => Promise<TeamsCallAdapter>;
+
+/**
+ * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
+ *
+ * Useful if you want to keep a reference to {@link StatefulCallClient}.
+ * Consider using {@link createAzureCommunicationCallAdapter} for a simpler API.
+ *
+ * @beta
+ */
+export declare const createTeamsCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator) => Promise<TeamsCallAdapter>;
+
 /**
  * Object returned after creating a local or remote VideoStream.
  * This contains helper functions to manipulate the render of the stream.
@@ -4501,14 +4582,19 @@ export declare const DEFAULT_COMPONENT_ICONS: {
     SendBoxSendHovered: JSX.Element;
     VideoTileMicOff: JSX.Element;
     DialpadBackspace: JSX.Element;
-    DomainPermissionsSparkle: JSX.Element;
-    DomainPermissionCamera: JSX.Element;
-    DomainPermissionMic: JSX.Element;
-    DomainPermissionCameraDenied: JSX.Element;
-    DomainPermissionMicDenied: JSX.Element;
-    UnsupportedBrowserWarning: JSX.Element;
+    SitePermissionsSparkle: JSX.Element;
+    SitePermissionCamera: JSX.Element;
+    SitePermissionMic: JSX.Element;
+    SitePermissionCameraDenied: JSX.Element;
+    SitePermissionMicDenied: JSX.Element;
+    UnsupportedEnvironmentWarning: JSX.Element;
     BrowserPermissionDeniedError: JSX.Element;
     VideoTilePinned: JSX.Element;
+    VideoTileMoreOptions: JSX.Element;
+    VideoTileScaleFit: JSX.Element;
+    VideoTileScaleFill: JSX.Element;
+    PinParticipant: JSX.Element;
+    UnpinParticipant: JSX.Element;
 };
 
 /**
@@ -4597,16 +4683,44 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     HoldCallButton: JSX.Element;
     ResumeCall: JSX.Element;
     DialpadBackspace: JSX.Element;
-    DomainPermissionsSparkle: JSX.Element;
-    DomainPermissionCamera: JSX.Element;
-    DomainPermissionMic: JSX.Element;
-    DomainPermissionCameraDenied: JSX.Element;
-    DomainPermissionMicDenied: JSX.Element;
-    UnsupportedBrowserWarning: JSX.Element;
+    SitePermissionsSparkle: JSX.Element;
+    SitePermissionCamera: JSX.Element;
+    SitePermissionMic: JSX.Element;
+    SitePermissionCameraDenied: JSX.Element;
+    SitePermissionMicDenied: JSX.Element;
+    UnsupportedEnvironmentWarning: JSX.Element;
     BrowserPermissionDeniedError: JSX.Element;
     VideoTilePinned: JSX.Element;
+    VideoTileMoreOptions: JSX.Element;
+    VideoTileScaleFit: JSX.Element;
+    VideoTileScaleFill: JSX.Element;
+    PinParticipant: JSX.Element;
+    UnpinParticipant: JSX.Element;
 };
 
+/**
+ * Device Checks.
+ * Choose whether or not to block starting a call depending on camera and microphone permission options.
+ *
+ * @beta
+ */
+export declare interface DeviceCheckOptions {
+    /**
+     * Camera Permission prompts for your call.
+     * 'required' - requires the permission to be allowed before permitting the user join the call.
+     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
+     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
+     */
+    camera: 'required' | 'optional' | 'doNotPrompt';
+    /**
+     * Microphone permission prompts for your call.
+     * 'required' - requires the permission to be allowed before permitting the user join the call.
+     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
+     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
+     */
+    microphone: 'required' | 'optional' | 'doNotPrompt';
+}
+
 /**
  * This type is meant to encapsulate all the state inside {@link @azure/communication-calling#DeviceManager}. For
  * optional parameters they may not be available until permission is granted by the user. The cameras, microphones,
@@ -4662,95 +4776,6 @@ export declare type DeviceManagerState = {
     unparentedViews: LocalVideoStreamState[];
 };
 
-/**
- * A dropdown to trigger device permission prompt
- *
- * @internal
- */
-export declare const _DevicePermissionDropdown: (props: _DevicePermissionDropdownProps) => JSX.Element;
-
-/**
- * Props for {@link _DevicePermissionDropdown}.
- *
- * @internal
- */
-export declare interface _DevicePermissionDropdownProps {
-    /**
-     * icon shown in dropdown placeholder
-     */
-    icon?: JSX.Element;
-    /**
-     * Dropdown content
-     */
-    options?: IDropdownOption[];
-    /**
-     * Ask for permissions of devices.
-     *
-     * @remarks
-     * Browser permission window will pop up if permissions are not granted yet
-     *
-     * @param constrain - Define constraints for accessing local devices {@link @azure/communication-calling#PermissionConstraints }
-     */
-    askDevicePermission?(constrain: _PermissionConstraints): Promise<void>;
-    /**
-     * Optional callback when component is clicked
-     */
-    onClick?: () => void;
-    /**
-     * Define constraints for accessing local devices  {@link @azure/communication-calling#PermissionConstraints }
-     */
-    constrain?: _PermissionConstraints;
-    /**
-     * Strings for devicepermissiondropdown
-     */
-    strings?: _DevicePermissionDropdownStrings;
-    /**
-     * Styles for devicepermissiondropdown
-     */
-    styles?: Partial<IDropdownStyles>;
-}
-
-/**
- * Strings of {@link DevicePermissionDropdown} that can be overridden.
- *
- * @internal
- */
-export declare interface _DevicePermissionDropdownStrings {
-    /**
-     * dropdown label
-     */
-    label?: string;
-    /**
-     * dropdown placeholder
-     */
-    placeHolderText: string;
-    /** string for action button  */
-    actionButtonContent?: string;
-}
-
-/**
- * Device Permission restrictions.
- * Be able to start a call depending on camera and microphone permission options.
- *
- * @beta
- */
-export declare interface DevicePermissionRestrictions {
-    /**
-     * Camera Permission prompts for your call.
-     * 'required' - requires the permission to be allowed before permitting the user join the call.
-     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
-     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
-     */
-    camera: 'required' | 'optional' | 'doNotPrompt';
-    /**
-     * Microphone permission prompts for your call.
-     * 'required' - requires the permission to be allowed before permitting the user join the call.
-     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
-     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
-     */
-    microphone: 'required' | 'optional' | 'doNotPrompt';
-}
-
 /**
  * A button to open a menu that controls device options.
  *
@@ -4988,45 +5013,6 @@ export declare interface Disposable {
     dispose(): void;
 }
 
-/**
- * @beta
- * Strings for DomainPermissions component
- */
-export declare type DomainPermissionsStrings = {
-    /**
-     * Main text string.
-     */
-    primaryText?: string;
-    /**
-     * Subtext string.
-     */
-    secondaryText?: string;
-    /**
-     * More help link string.
-     */
-    linkText?: string;
-    /**
-     * Primary button text string.
-     */
-    primaryButtonText?: string;
-    /**
-     * Aria label describing the content of the container
-     */
-    ariaLabel?: string;
-};
-
-/**
- * Fluent styles for {@link DomainPermissionsContainer}.
- *
- * @beta
- */
-export declare interface DomainPermissionsStyles extends BaseCustomStyles {
-    /** Styles for the primary button. */
-    primaryButton?: IButtonStyles;
-    /** Styles for the help troubleshooting link text. */
-    troubleshootingLink?: ILinkStyles;
-}
-
 /**
  * DTMF tone for PSTN calls.
  *
@@ -5202,6 +5188,10 @@ export declare interface ErrorBarStrings {
      * Message shown when microphone can be enumerated but access is blocked by the system.
      */
     callMicrophoneAccessDenied: string;
+    /**
+     * Message shown when microphone can be enumerated but access is blocked by the system, for safari browsers
+     */
+    callMicrophoneAccessDeniedSafari: string;
     /**
      * Message shown when microphone is muted by the system (not by local or remote participants)
      */
@@ -5224,6 +5214,10 @@ export declare interface ErrorBarStrings {
      * Message shown when camera can be enumerated but access is blocked by the system.
      */
     callCameraAccessDenied: string;
+    /**
+     * Message shown when camera can be enumerated but access is blocked by the system, for safari browsers
+     */
+    callCameraAccessDeniedSafari: string;
     /**
      * Message shown when local video fails to start because camera is already in use by
      * another applciation.
@@ -5499,7 +5493,7 @@ export declare const fromFlatCommunicationIdentifier: (id: string) => Communicat
  *
  * @public
  */
-export declare type GetCallingSelector<Component extends (props: any) => JSX.Element | undefined> = AreEqual<Component, typeof VideoGallery> extends true ? VideoGallerySelector : AreEqual<Component, typeof DevicesButton> extends true ? DevicesButtonSelector : AreEqual<Component, typeof MicrophoneButton> extends true ? MicrophoneButtonSelector : AreEqual<Component, typeof CameraButton> extends true ? CameraButtonSelector : AreEqual<Component, typeof ScreenShareButton> extends true ? ScreenShareButtonSelector : AreEqual<Component, typeof ParticipantList> extends true ? ParticipantListSelector : AreEqual<Component, typeof ParticipantsButton> extends true ? ParticipantsButtonSelector : AreEqual<Component, typeof EndCallButton> extends true ? EmptySelector : AreEqual<Component, typeof ErrorBar> extends true ? CallErrorBarSelector : AreEqual<Component, typeof Dialpad> extends true ? EmptySelector : AreEqual<Component, typeof HoldButton> extends true ? HoldButtonSelector : AreEqual<Component, typeof _DevicePermissionDropdown> extends true ? EmptySelector : undefined;
+export declare type GetCallingSelector<Component extends (props: any) => JSX.Element | undefined> = AreEqual<Component, typeof VideoGallery> extends true ? VideoGallerySelector : AreEqual<Component, typeof DevicesButton> extends true ? DevicesButtonSelector : AreEqual<Component, typeof MicrophoneButton> extends true ? MicrophoneButtonSelector : AreEqual<Component, typeof CameraButton> extends true ? CameraButtonSelector : AreEqual<Component, typeof ScreenShareButton> extends true ? ScreenShareButtonSelector : AreEqual<Component, typeof ParticipantList> extends true ? ParticipantListSelector : AreEqual<Component, typeof ParticipantsButton> extends true ? ParticipantsButtonSelector : AreEqual<Component, typeof EndCallButton> extends true ? EmptySelector : AreEqual<Component, typeof ErrorBar> extends true ? CallErrorBarSelector : AreEqual<Component, typeof Dialpad> extends true ? EmptySelector : AreEqual<Component, typeof HoldButton> extends true ? HoldButtonSelector : undefined;
 
 /**
  * Get the selector for a specified component.
@@ -6491,24 +6485,24 @@ export declare interface MicrophoneButtonStyles extends ControlBarButtonStyles {
  *
  * @beta
  */
-export declare const MicrophoneDomainPermissions: (props: MicrophoneDomainPermissionsProps) => JSX.Element;
+export declare const MicrophoneSitePermissions: (props: MicrophoneSitePermissionsProps) => JSX.Element;
 
 /**
  * @beta
- * Props for MicrophoneDomainPermissions component.
+ * Props for MicrophoneSitePermissions component.
  */
-export declare interface MicrophoneDomainPermissionsProps extends CommonDomainPermissionsProps {
+export declare interface MicrophoneSitePermissionsProps extends CommonSitePermissionsProps {
     /** Icon name for the microphone icon */
     microphoneIconName?: string;
-    /** Strings for use with the {@link MicrophoneDomainPermissions} */
-    strings?: MicrophoneDomainPermissionsStrings;
+    /** Strings for use with the {@link MicrophoneSitePermissions} */
+    strings?: MicrophoneSitePermissionsStrings;
 }
 
 /**
  * @beta
- * Strings for MicrophoneDomainPermissions component.
+ * Strings for MicrophoneSitePermissions component.
  */
-export declare type MicrophoneDomainPermissionsStrings = DomainPermissionsStrings;
+export declare type MicrophoneSitePermissionsStrings = SitePermissionsStrings;
 
 /**
  * Payload for {@link DiagnosticChangedEventListner} where there is a change in a network diagnostic.
@@ -6645,8 +6639,6 @@ export declare interface ParticipantItemStrings {
     mutedIconLabel: string;
     /** placeholder text for participants who does not have a display name*/
     displayNamePlaceholder?: string;
-    /** String shown when `participantState` is `Connecting` */
-    participantStateConnecting?: string;
     /** String shown when `participantState` is `Ringing` */
     participantStateRinging?: string;
     /** String shown when `participantState` is `Hold` */
@@ -6908,6 +6900,10 @@ export declare interface ParticipantsButtonStrings {
      * Label of menu button to mute all participants
      */
     muteAllButtonLabel: string;
+    /**
+     * Narrator announcement for when the invite link has been copied by the user to the clipboard
+     */
+    copyInviteLinkActionedAriaLabel: string;
 }
 
 /**
@@ -6954,16 +6950,6 @@ export declare type ParticipantsRemovedListener = (event: {
  */
 export declare type ParticipantState = 'Idle' | 'Connecting' | 'Ringing' | 'Connected' | 'Hold' | 'InLobby' | 'EarlyMedia' | 'Disconnected';
 
-/**
- * Define constraints for accessing local devices  {@link @azure/communication-calling#PermissionConstraints }
- *
- * @internal
- */
-export declare type _PermissionConstraints = {
-    audio: boolean;
-    video: boolean;
-};
-
 /**
  * An array of key value pairs that stores each sender's display name and last read message
  *
@@ -7063,6 +7049,20 @@ export declare interface RemoteVideoStreamState {
     view?: VideoStreamRendererViewState;
 }
 
+/**
+ * Menu options for remote video tiles in {@link VideoGallery}.
+ *
+ * @beta
+ */
+export declare interface RemoteVideoTileMenuOptions {
+    /**
+     * If set to true, remote video tiles in the VideoGallery will not have menu options
+     *
+     * @defaultValue false
+     */
+    isHidden?: boolean;
+}
+
 /**
  * @beta
  * The role of a call participant.
@@ -7293,6 +7293,45 @@ export declare interface SendBoxStylesProps extends BaseCustomStyles {
     systemMessage?: IStyle;
 }
 
+/**
+ * @beta
+ * Strings for SitePermissions component
+ */
+export declare type SitePermissionsStrings = {
+    /**
+     * Main text string.
+     */
+    primaryText?: string;
+    /**
+     * Subtext string.
+     */
+    secondaryText?: string;
+    /**
+     * More help link string.
+     */
+    linkText?: string;
+    /**
+     * Primary button text string.
+     */
+    primaryButtonText?: string;
+    /**
+     * Aria label describing the content of the container
+     */
+    ariaLabel?: string;
+};
+
+/**
+ * Fluent styles for {@link SitePermissionsContainer}.
+ *
+ * @beta
+ */
+export declare interface SitePermissionsStyles extends BaseCustomStyles {
+    /** Styles for the primary button. */
+    primaryButton?: IButtonStyles;
+    /** Styles for the help troubleshooting link text. */
+    troubleshootingLink?: ILinkStyles;
+}
+
 /**
  * Defines the methods that allow CallClient {@link @azure/communication-calling#CallClient} to be used statefully.
  * The interface provides access to proxied state and also allows registering a handler for state change events. For
@@ -7424,7 +7463,7 @@ export declare type StatefulCallClientArgs = {
      * UserId from SDK. This is provided for developer convenience to easily access the userId from the
      * state. It is not used by StatefulCallClient.
      */
-    userId: CommunicationUserIdentifier;
+    userId: CommunicationUserIdentifier | /* @conditional-compile-remove(teams-identity-support) */ MicrosoftTeamsUserIdentifier;
     /**
      * A phone number in E.164 format that will be used to represent the callers identity. This number is required
      * to start a PSTN call.
@@ -7603,6 +7642,17 @@ export declare interface TeamsCallAdapter extends CommonCallAdapter {
     startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): TeamsCall | undefined;
 }
 
+/**
+ * Arguments for creating the Azure Communication Services implementation of {@link TeamsCallAdapter}.
+ *
+ * @beta
+ */
+export declare type TeamsCallAdapterArgs = {
+    userId: MicrosoftTeamsUserIdentifier;
+    credential: CommunicationTokenCredential;
+    locator: TeamsMeetingLinkLocator;
+};
+
 /**
  * Object containing all the teams call handlers required for calling components.
  *
@@ -7795,22 +7845,22 @@ export declare interface TypingIndicatorStylesProps extends BaseCustomStyles {
 }
 
 /**
- * UI to display to the user that the browser they are using is not supported by calling application.
+ * UI to display to the user that the browser they are using is not supported by Azure Communications Calling service.
  *
  * @beta
  */
 export declare const UnsupportedBrowser: (props: UnsupportedBrowserProps) => JSX.Element;
 
 /**
- * props for UnsupportedBrowser UI
+ * props for {@link UnsupportedBrowser} UI
  *
  * @beta
  */
 export declare interface UnsupportedBrowserProps {
-    /** Handler to perform a action when the help link is actioned */
+    /** Handler to perform an action when the help link is actioned */
     onTroubleshootingClick?: () => void;
     /** String overrides for the component */
-    strings: UnsupportedBrowserStrings;
+    strings?: UnsupportedBrowserStrings;
 }
 
 /**
@@ -7823,8 +7873,79 @@ export declare interface UnsupportedBrowserStrings {
     primaryText: string;
     /** String for the secondary text */
     secondaryText: string;
-    /** String for the help link */
-    moreHelpLink: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
+}
+
+/**
+ * UI to display to the user that the browser version they are using is out of date
+ * and not supported by Azure Communications Calling service.
+ *
+ * @beta
+ */
+export declare const UnsupportedBrowserVersion: (props: UnsupportedBrowserVersionProps) => JSX.Element;
+
+/**
+ * props for {@link UnsupportedBrowserVersion} UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserVersionProps {
+    /** Handler to perform an action when the help link is actioned */
+    onTroubleshootingClick?: () => void;
+    /** String overrides for the component */
+    strings?: UnsupportedBrowserVersionStrings;
+    /** Handler to allow user to continue into the call */
+    onContinueAnywayClick?: () => void;
+}
+
+/**
+ * Strings for UnsupportedBrowser component
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserVersionStrings {
+    /** String for the primary text */
+    primaryText: string;
+    /** String for the secondary text */
+    secondaryText: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
+    /** String for continue without updating button */
+    continueAnywayButtonText?: string;
+}
+
+/**
+ * UI to display to the user that the operating system they are using is not supported by Azure Communications Calling service.
+ *
+ * @beta
+ */
+export declare const UnsupportedOperatingSystem: (props: UnsupportedOperatingSystemProps) => JSX.Element;
+
+/**
+ * Props for {@link UnsupportedOperatingSystem} UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedOperatingSystemProps {
+    /** Handler to perform a action when the help link is actioned */
+    onTroubleshootingClick?: () => void;
+    /** String overrides for the component */
+    strings?: UnsupportedOperatingSystemStrings;
+}
+
+/**
+ * Strings for UnsupportedBrowser component
+ *
+ * @beta
+ */
+export declare interface UnsupportedOperatingSystemStrings {
+    /** String for the primary text */
+    primaryText: string;
+    /** String for the secondary text */
+    secondaryText: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
 }
 
 /**
@@ -7883,22 +8004,6 @@ export declare const useAzureCommunicationCallWithChatAdapter: (args: Partial<Az
  */
 export declare const useAzureCommunicationChatAdapter: (args: Partial<AzureCommunicationChatAdapterArgs>, afterCreate?: ((adapter: ChatAdapter) => Promise<ChatAdapter>) | undefined, beforeDispose?: ((adapter: ChatAdapter) => Promise<void>) | undefined) => ChatAdapter | undefined;
 
-/**
- * A custom React hook to simplify the creation of {@link TeamsCallAdapter}.
- *
- * Similar to {@link createTeamsAzureCommunicationCallAdapter}, but takes care of asynchronous
- * creation of the adapter internally.
- *
- * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
- * as they are created. The adapter is only created when all arguments are defined.
- *
- * Note that you must memoize the arguments to avoid recreating adapter on each render.
- * See storybook for typical usage examples.
- *
- * @beta
- */
-export declare const useAzureCommunicationTeamsCallAdapter: (args: Partial<AzureCommunicationCallAdapterArgs>, afterCreate?: ((adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>) | undefined, beforeDispose?: ((adapter: TeamsCallAdapter) => Promise<void>) | undefined) => TeamsCallAdapter | undefined;
-
 /**
  * Hook to obtain {@link @azure/communication-calling#Call} from the provider.
  *
@@ -8009,6 +8114,22 @@ export declare const useSelector: <ParamT extends Selector | undefined>(selector
  */
 export declare const useTeamsCall: () => undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall;
 
+/**
+ * A custom React hook to simplify the creation of {@link TeamsCallAdapter}.
+ *
+ * Similar to {@link createTeamsAzureCommunicationCallAdapter}, but takes care of asynchronous
+ * creation of the adapter internally.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ *
+ * Note that you must memoize the arguments to avoid recreating adapter on each render.
+ * See storybook for typical usage examples.
+ *
+ * @beta
+ */
+export declare const useTeamsCallAdapter: (args: Partial<TeamsCallAdapterArgs>, afterCreate?: ((adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>) | undefined, beforeDispose?: ((adapter: TeamsCallAdapter) => Promise<void>) | undefined) => TeamsCallAdapter | undefined;
+
 /**
  * Hook to obtain {@link @azure/communication-calling#TeamsCallAgent} from the provider.
  *
@@ -8125,6 +8246,24 @@ export declare interface VideoGalleryProps {
      * Camera control information for button to switch cameras.
      */
     localVideoCameraCycleButtonProps?: LocalVideoCameraCycleButtonProps;
+    /**
+     * List of pinned participant userIds.
+     */
+    pinnedParticipants?: string[];
+    /**
+     * This callback will be called when a participant video tile is pinned.
+     */
+    onPinParticipant?: (userId: string) => void;
+    /**
+     * This callback will be called when a participant video tile is un-pinned.
+     */
+    onUnpinParticipant?: (userId: string) => void;
+    /**
+     * Options for showing the remote video tile menu.
+     *
+     * @defaultValue \{ kind: 'contextual' \}
+     */
+    remoteVideoTileMenuOptions?: false | VideoTileContextualMenuProps | VideoTileDrawerMenuProps;
 }
 
 /**
@@ -8172,6 +8311,8 @@ export declare interface VideoGalleryStream {
     isMirrored?: boolean;
     /** Render element of the video stream */
     renderElement?: HTMLElement;
+    /** Scaling mode of the video stream */
+    scalingMode?: ViewScalingMode;
 }
 
 /**
@@ -8194,6 +8335,14 @@ export declare interface VideoGalleryStrings {
     localVideoSelectedDescription: string;
     /** placeholder text for participants who does not have a display name*/
     displayNamePlaceholder: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participants video to fit in frame */
+    fitRemoteParticipantToFrame: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participants video to fill the frame */
+    fillRemoteParticipantFrame: string;
+    /** Menu text shown in Video Tile contextual menu for pinning a remote participant's video tile */
+    pinParticipantForMe: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participant's video tile */
+    unpinParticipantForMe: string;
 }
 
 /**
@@ -8252,16 +8401,34 @@ export declare interface VideoStreamRendererViewState {
 export declare const VideoTile: (props: VideoTileProps) => JSX.Element;
 
 /**
+ * Properties for showing contextual menu for remote {@link VideoTile} components in {@link VideoGallery}.
+ *
  * @beta
- * MenuItems to be diplayed in video tile in the contextual/drawer menu
  */
-export declare type VideoTileMenuItems = Array<{
-    key: string;
-    ariaLabel?: string;
-    text: string;
-    onClick: () => void;
-    iconProps: IIconProps;
-}>;
+export declare interface VideoTileContextualMenuProps {
+    /**
+     * The menu property kind
+     */
+    kind: 'contextual';
+}
+
+/**
+ * Properties for showing drawer menu on remote {@link VideoTile} long touch in {@link VideoGallery}.
+ *
+ * @beta
+ */
+export declare interface VideoTileDrawerMenuProps {
+    /**
+     * The menu property kind
+     */
+    kind: 'drawer';
+    /**
+     * The optional id property provided on an element that the drawer menu should render within when a
+     * remote participant video tile Drawer is shown. If an id is not provided, then a drawer menu will
+     * render within the VideoGallery component.
+     */
+    hostId?: string;
+}
 
 /**
  * Props for {@link VideoTile}.
@@ -8301,10 +8468,6 @@ export declare interface VideoTileProps {
      * Whether the video is muted or not.
      */
     isMuted?: boolean;
-    /**
-     * Display custom menu items in the VideoTile's contextual menu.
-     */
-    menuItems?: VideoTileMenuItems;
     /**
      * If true, the video tile will show the pin icon.
      */
@@ -8343,6 +8506,16 @@ export declare interface VideoTileProps {
      */
     participantState?: ParticipantState;
     strings?: VideoTileStrings;
+    /**
+     * Display custom menu items in the VideoTile's contextual menu.
+     * Uses Fluent UI ContextualMenu.
+     * An ellipses icon will be displayed to open the contextual menu if this prop is defined.
+     */
+    contextualMenu?: IContextualMenuProps;
+    /**
+     * Callback triggered by video tile on touch and hold.
+     */
+    onLongTouch?: () => void;
 }
 
 /**
@@ -8350,7 +8523,6 @@ export declare interface VideoTileProps {
  * @beta
  */
 export declare interface VideoTileStrings {
-    participantStateConnecting: string;
     participantStateRinging: string;
     participantStateHold: string;
 }