@microsoft/teams-js 2.10.0-beta.3 → 2.10.1

package/README.md

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

package/dist/MicrosoftTeams.d.ts

@@ -2075,7 +2075,7 @@ export namespace videoEx {
             * @internal
             * Limited to Microsoft-internal use
             */
-        interface VideoFrame extends video.VideoFrameData {
+        interface VideoFrame extends video.VideoFrame {
                 /**
                     * @hidden
                     * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
@@ -3868,6 +3868,7 @@ export namespace app {
                 templateId?: string;
                 /**
                     * The user's role in the team.
+        
                     * Because a malicious party can run your content in a browser, this value should
                     * be used only as a hint as to the user's role, and never as proof of her role.
                     */
@@ -3879,8 +3880,13 @@ export namespace app {
         interface UserInfo {
                 /**
                     * The Azure AD object id of the current user.
-                    * Because a malicious party run your content in a browser, this value should
-                    * be used only as a hint as to who the user is and never as proof of identity.
+                    *
+                    * Because a malicious party can run your content in a browser, this value should
+                    * be used only as a optimization hint as to who the user is and never as proof of identity.
+                    * Specifically, this value should never be used to determine if a user is authorized to access
+                    * a resource; access tokens should be used for that.
+                    * See {@link authentication.getAuthToken} and {@link authentication.authenticate} for more information on access tokens.
+                    *
                     * This field is available only when the identity permission is requested in the manifest.
                     */
                 id: string;
@@ -3902,17 +3908,25 @@ export namespace app {
                     */
                 licenseType?: string;
                 /**
-                    * A value suitable for use as a login_hint when authenticating with Azure AD.
+                    * A value suitable for use when providing a login_hint to Azure Active Directory for authentication purposes.
+                    * See [Provide optional claims to your app](https://learn.microsoft.com/azure/active-directory/develop/active-directory-optional-claims#v10-and-v20-optional-claims-set)
+                    * for more information about the use of login_hint
+                    *
                     * Because a malicious party can run your content in a browser, this value should
-                    * be used only as a hint as to who the user is and never as proof of identity.
-                    * This field is available only when the identity permission is requested in the manifest.
+                    * be used only as a optimization hint as to who the user is and never as proof of identity.
+                    * Specifically, this value should never be used to determine if a user is authorized to access
+                    * a resource; access tokens should be used for that.
+                    * See {@link authentication.getAuthToken} and {@link authentication.authenticate} for more information on access tokens.
                     */
                 loginHint?: string;
                 /**
                     * 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
-                    * be used only as a hint as to who the user is and never as proof of identity.
-                    * This field is available only when the identity permission is requested in the manifest.
+        
+                    * Because a malicious party can run your content in a browser, this value should
+                    * be used only as a optimization hint as to who the user is and never as proof of identity.
+                    * Specifically, this value should never be used to determine if a user is authorized to access
+                    * a resource; access tokens should be used for that.
+                    * See {@link authentication.getAuthToken} and {@link authentication.authenticate} for more information on access tokens.
                     */
                 userPrincipalName?: string;
                 /**
@@ -3926,9 +3940,12 @@ export namespace app {
         interface TenantInfo {
                 /**
                     * The Azure AD tenant ID of the current user.
+        
                     * Because a malicious party can run your content in a browser, this value should
-                    * be used only as a hint as to who the user is and never as proof of identity.
-                    * This field is available only when the identity permission is requested in the manifest.
+                    * be used only as a optimization hint as to who the user is and never as proof of identity.
+                    * Specifically, this value should never be used to determine if a user is authorized to access
+                    * a resource; access tokens should be used for that.
+                    * See {@link authentication.getAuthToken} and {@link authentication.authenticate} for more information on access tokens.
                     */
                 id: string;
                 /**
@@ -6713,7 +6730,7 @@ export namespace video {
             * Represents a video frame
             * @beta
             */
-        interface VideoFrameData {
+        interface VideoFrame {
                 /**
                     * Video frame width
                     */
@@ -6725,7 +6742,7 @@ export namespace video {
                 /**
                     * Video frame buffer
                     */
-                videoFrameBuffer: Uint8ClampedArray;
+                data: Uint8ClampedArray;
                 /**
                     * NV12 luma stride, valid only when video frame format is NV12
                     */
@@ -6748,7 +6765,7 @@ export namespace video {
             * @beta
             */
         enum VideoFrameFormat {
-                NV12 = "NV12"
+                NV12 = 0
         }
         /**
             * Video frame configuration supplied to the host to customize the generated video frame parameters, like format
@@ -6768,17 +6785,17 @@ export namespace video {
                 /**
                     * Current video effect changed
                     */
-                EffectChanged = "EffectChanged",
+                EffectChanged = 0,
                 /**
                     * Disable the video effect
                     */
-                EffectDisabled = "EffectDisabled"
+                EffectDisabled = 1
         }
         /**
             * Video frame call back function definition
             * @beta
             */
-        type VideoFrameCallback = (frame: VideoFrameData, notifyVideoFrameProcessed: () => void, notifyError: (errorMessage: string) => void) => void;
+        type VideoFrameCallback = (frame: VideoFrame, notifyVideoFrameProcessed: () => void, notifyError: (errorMessage: string) => void) => void;
         /**
             * Predefined failure reasons for preparing the selected video effect
             * @beta
@@ -6831,56 +6848,6 @@ export namespace video {
             *
             */
         function isSupported(): boolean;
-        /**
-            * @beta
-            * Namespace to get video frames from a media stream.
-            * When the host supports this capability, developer should call {@link mediaStream.registerForVideoFrame} to get the video frames instead of {@link registerForVideoFrame} to get the video frames, callback of {@link registerForVideoFrame} will be ignored when the host supports this capability.
-            */
-        namespace mediaStream {
-                /**
-                    * @beta
-                    * Checks if video.mediaStream capability is supported by the host
-                    * @returns boolean to represent whether the video.medisStream capability is supported
-                    *
-                    * @throws Error if {@linkcode app.initialize} has not successfully completed
-                    *
-                    */
-                function isSupported(): boolean;
-                /**
-                    * @beta
-                    * Video frame data extracted from the media stream. More properties may be added in the future.
-                    */
-                type MediaStreamFrameData = {
-                        /**
-                            * The video frame from the media stream.
-                            */
-                        videoFrame: VideoFrame;
-                };
-                /**
-                    * @beta
-                    * Video effect change call back function definition.
-                    * The video app should resolve the promise to notify a successfully processed video frame.
-                    * The video app should reject the promise to notify a failure.
-                    */
-                type VideoFrameCallback = (receivedVideoFrame: MediaStreamFrameData) => Promise<VideoFrame>;
-                /**
-                    * @beta
-                    * Register to read the video frames from the media stream provided by the host.
-                    * @param frameCallback - The callback to invoke when recieve a video frame from the media stream.
-                    * @example
-                    * ```typescript
-                    * video.mediaStream.registerForVideoFrame(async (receivedVideoFrame) => {
-                    *  const { videoFrame } = receivedVideoFrame;
-                    *  try {
-                    *    return await processVideoFrame(videoFrame);
-                    *  } catch (error) {
-                    *   throw error;
-                    *  }
-                    * });
-                    * ```
-                    */
-                function registerForVideoFrame(frameCallback: VideoFrameCallback): void;
-        }
 }
 
 /**
@@ -7127,7 +7094,7 @@ export namespace call {
                     * @remarks
                     * Currently the User ID field supports the Azure AD UserPrincipalName,
                     * typically an email address, or in case of a PSTN call, it supports a pstn
-                    * mri 4:<phonenumber>.
+                    * mri 4:\<phonenumber>.
                     */
                 targets: string[];
                 /**
@@ -7596,7 +7563,7 @@ export namespace tasks {
         function submitTask(result?: string | object, appIds?: string | string[]): void;
         /**
             * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
-            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension | TaskModuleDimension.Small}
+            * otherwise uses the height and width values corresponding to {@link DialogDimension | TaskModuleDimension.Small}
             * @param taskInfo TaskInfo object from which to extract size info, if specified
             * @returns TaskInfo with height and width specified
             */

package/dist/MicrosoftTeams.js

@@ -7,7 +7,7 @@
 		exports["microsoftTeams"] = factory();
 	else
 		root["microsoftTeams"] = factory();
-})(self, () => {
+})(typeof self !== 'undefined' ? self : this, () => {
 return /******/ (() => { // webpackBootstrap
 /******/ 	var __webpack_modules__ = ({
 
@@ -1011,10 +1011,6 @@ var validOrigins = [
     'local.teams.live.com:8080',
     'local.teams.office.com',
     'local.teams.office.com:8080',
-    'msft.spoppe.com',
-    '*.sharepoint.com',
-    '*.sharepoint-df.com',
-    '*.sharepointonline.com',
     'outlook.office.com',
     'outlook-sdf.office.com',
     'outlook.office365.com',
@@ -2003,7 +1999,7 @@ var _minRuntimeConfigToUninitialize = {
 };
 
 ;// CONCATENATED MODULE: ./src/public/version.ts
-var version = "2.10.0-beta.3";
+var version = "2.10.1";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -2087,13 +2083,15 @@ function isCurrentSDKVersionAtLeast(requiredVersion) {
 }
 /**
  * @hidden
- * Helper function to identify if host client is either android or ios
+ * Helper function to identify if host client is either android, ios, or ipados
  *
  * @internal
  * Limited to Microsoft-internal use
  */
 function isHostClientMobile() {
-    return GlobalVars.hostClientType == HostClientType.android || GlobalVars.hostClientType == HostClientType.ios;
+    return (GlobalVars.hostClientType == HostClientType.android ||
+        GlobalVars.hostClientType == HostClientType.ios ||
+        GlobalVars.hostClientType == HostClientType.ipados);
 }
 /**
  * @hidden
@@ -2222,6 +2220,7 @@ var authentication;
             if (GlobalVars.hostClientType === HostClientType.desktop ||
                 GlobalVars.hostClientType === HostClientType.android ||
                 GlobalVars.hostClientType === HostClientType.ios ||
+                GlobalVars.hostClientType === HostClientType.ipados ||
                 GlobalVars.hostClientType === HostClientType.rigel ||
                 GlobalVars.hostClientType === HostClientType.teamsRoomsWindows ||
                 GlobalVars.hostClientType === HostClientType.teamsRoomsAndroid ||
@@ -7638,53 +7637,6 @@ var profile;
 })(profile || (profile = {}));
 
 ;// CONCATENATED MODULE: ./src/public/video.ts
-var video_assign = (undefined && undefined.__assign) || function () {
-    video_assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return video_assign.apply(this, arguments);
-};
-var video_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var video_generator = (undefined && undefined.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
 
 
 
@@ -7702,7 +7654,7 @@ var video;
      */
     var VideoFrameFormat;
     (function (VideoFrameFormat) {
-        VideoFrameFormat["NV12"] = "NV12";
+        VideoFrameFormat[VideoFrameFormat["NV12"] = 0] = "NV12";
     })(VideoFrameFormat = video.VideoFrameFormat || (video.VideoFrameFormat = {}));
     /**
      * Video effect change type enum
@@ -7713,11 +7665,11 @@ var video;
         /**
          * Current video effect changed
          */
-        EffectChangeType["EffectChanged"] = "EffectChanged";
+        EffectChangeType[EffectChangeType["EffectChanged"] = 0] = "EffectChanged";
         /**
          * Disable the video effect
          */
-        EffectChangeType["EffectDisabled"] = "EffectDisabled";
+        EffectChangeType[EffectChangeType["EffectDisabled"] = 1] = "EffectDisabled";
     })(EffectChangeType = video.EffectChangeType || (video.EffectChangeType = {}));
     /**
      * Predefined failure reasons for preparing the selected video effect
@@ -7746,14 +7698,10 @@ var video;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('video.newVideoFrame', 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function (videoFrame) {
+        registerHandler('video.newVideoFrame', function (videoFrame) {
             if (videoFrame) {
-                // The host may pass the VideoFrame with the old definition which has `data` instead of `videoFrameBuffer`
-                var videoFrameData = video_assign(video_assign({}, videoFrame), { videoFrameBuffer: videoFrame.videoFrameBuffer || videoFrame.data });
-                var timestamp_1 = videoFrameData.timestamp;
-                frameCallback(videoFrameData, function () {
+                var timestamp_1 = videoFrame.timestamp;
+                frameCallback(videoFrame, function () {
                     notifyVideoFrameProcessed(timestamp_1);
                 }, notifyError);
             }
@@ -7829,165 +7777,6 @@ var video;
         return ensureInitialized(runtime) && runtime.supports.video ? true : false;
     }
     video.isSupported = isSupported;
-    /**
-     * @beta
-     * Namespace to get video frames from a media stream.
-     * When the host supports this capability, developer should call {@link mediaStream.registerForVideoFrame} to get the video frames instead of {@link registerForVideoFrame} to get the video frames, callback of {@link registerForVideoFrame} will be ignored when the host supports this capability.
-     */
-    var mediaStream;
-    (function (mediaStream_1) {
-        /**
-         * @beta
-         * Checks if video.mediaStream capability is supported by the host
-         * @returns boolean to represent whether the video.medisStream capability is supported
-         *
-         * @throws Error if {@linkcode app.initialize} has not successfully completed
-         *
-         */
-        function isSupported() {
-            var _a;
-            return ensureInitialized(runtime) && isTextureStreamAvailable() && !!((_a = runtime.supports.video) === null || _a === void 0 ? void 0 : _a.mediaStream);
-        }
-        mediaStream_1.isSupported = isSupported;
-        function isTextureStreamAvailable() {
-            var _a, _b, _c, _d;
-            return (typeof window !== 'undefined' &&
-                !!(((_b = (_a = window['chrome']) === null || _a === void 0 ? void 0 : _a.webview) === null || _b === void 0 ? void 0 : _b.getTextureStream) && ((_d = (_c = window['chrome']) === null || _c === void 0 ? void 0 : _c.webview) === null || _d === void 0 ? void 0 : _d.registerTextureStream)));
-        }
-        /**
-         * @beta
-         * Register to read the video frames from the media stream provided by the host.
-         * @param frameCallback - The callback to invoke when recieve a video frame from the media stream.
-         * @example
-         * ```typescript
-         * video.mediaStream.registerForVideoFrame(async (receivedVideoFrame) => {
-         *  const { videoFrame } = receivedVideoFrame;
-         *  try {
-         *    return await processVideoFrame(videoFrame);
-         *  } catch (error) {
-         *   throw error;
-         *  }
-         * });
-         * ```
-         */
-        function registerForVideoFrame(frameCallback) {
-            var _this = this;
-            ensureInitialized(runtime, FrameContexts.sidePanel);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
-            }
-            registerHandler('video.startVideoExtensibilityVideoStream', function (mediaStreamInfo) { return video_awaiter(_this, void 0, void 0, function () {
-                var streamId, videoTrack, generator;
-                var _a, _b;
-                return video_generator(this, function (_c) {
-                    switch (_c.label) {
-                        case 0:
-                            streamId = mediaStreamInfo.streamId;
-                            return [4 /*yield*/, getInputVideoTrack(streamId)];
-                        case 1:
-                            videoTrack = _c.sent();
-                            generator = createProcessedStreamGenerator(videoTrack, frameCallback);
-                            // register the video track with processed frames back to the stream:
-                            typeof window !== 'undefined' && ((_b = (_a = window['chrome']) === null || _a === void 0 ? void 0 : _a.webview) === null || _b === void 0 ? void 0 : _b.registerTextureStream(streamId, generator));
-                            return [2 /*return*/];
-                    }
-                });
-            }); });
-            sendMessageToParent('video.mediaStream.registerForVideoFrame', [
-                {
-                    format: VideoFrameFormat.NV12,
-                },
-            ]);
-        }
-        mediaStream_1.registerForVideoFrame = registerForVideoFrame;
-        /**
-         * Get the video track from the media stream gotten from chrome.webview.getTextureStream(streamId).
-         */
-        function getInputVideoTrack(streamId) {
-            return video_awaiter(this, void 0, void 0, function () {
-                var chrome, mediaStream_2, tracks, error_1, errorMsg;
-                return video_generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0:
-                            if (typeof window === 'undefined') {
-                                throw errorNotSupportedOnPlatform;
-                            }
-                            chrome = window['chrome'];
-                            _a.label = 1;
-                        case 1:
-                            _a.trys.push([1, 3, , 4]);
-                            return [4 /*yield*/, chrome.webview.getTextureStream(streamId)];
-                        case 2:
-                            mediaStream_2 = _a.sent();
-                            tracks = mediaStream_2.getVideoTracks();
-                            if (tracks.length === 0) {
-                                throw new Error("No video track in stream ".concat(streamId));
-                            }
-                            return [2 /*return*/, tracks[0]];
-                        case 3:
-                            error_1 = _a.sent();
-                            errorMsg = "Failed to get video track from stream ".concat(streamId, ", error: ").concat(error_1);
-                            notifyError(errorMsg);
-                            throw new Error(errorMsg);
-                        case 4: return [2 /*return*/];
-                    }
-                });
-            });
-        }
-        /**
-         * The function to create a processed video track from the original video track.
-         * It reads frames from the video track and pipes them to the video frame callback to process the frames.
-         * The processed frames are then enqueued to the generator.
-         * The generator can be registered back to the media stream so that the host can get the processed frames.
-         */
-        function createProcessedStreamGenerator(videoTrack, videoFrameCallback) {
-            var processor = new MediaStreamTrackProcessor({ track: videoTrack });
-            var source = processor.readable;
-            var generator = new MediaStreamTrackGenerator({ kind: 'video' });
-            var sink = generator.writable;
-            source
-                .pipeThrough(new TransformStream({
-                transform: function (originalFrame, controller) {
-                    return video_awaiter(this, void 0, void 0, function () {
-                        var timestamp, frameProcessedByApp, processedFrame, error_2;
-                        return video_generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0:
-                                    timestamp = originalFrame.timestamp;
-                                    if (!(timestamp !== null)) return [3 /*break*/, 5];
-                                    _a.label = 1;
-                                case 1:
-                                    _a.trys.push([1, 3, , 4]);
-                                    return [4 /*yield*/, videoFrameCallback({ videoFrame: originalFrame })];
-                                case 2:
-                                    frameProcessedByApp = _a.sent();
-                                    processedFrame = new VideoFrame(frameProcessedByApp, {
-                                        // we need the timestamp to be unchanged from the oirginal frame, so we explicitly set it here.
-                                        timestamp: timestamp,
-                                    });
-                                    controller.enqueue(processedFrame);
-                                    originalFrame.close();
-                                    frameProcessedByApp.close();
-                                    return [3 /*break*/, 4];
-                                case 3:
-                                    error_2 = _a.sent();
-                                    originalFrame.close();
-                                    notifyError(error_2);
-                                    return [3 /*break*/, 4];
-                                case 4: return [3 /*break*/, 6];
-                                case 5:
-                                    notifyError('timestamp of the original video frame is null');
-                                    _a.label = 6;
-                                case 6: return [2 /*return*/];
-                            }
-                        });
-                    });
-                },
-            }))
-                .pipeTo(sink);
-            return generator;
-        }
-    })(mediaStream = video.mediaStream || (video.mediaStream = {}));
 })(video || (video = {})); //end of video namespace
 
 ;// CONCATENATED MODULE: ./src/public/search.ts
@@ -8995,7 +8784,7 @@ var tasks;
     }
     /**
      * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
-     * otherwise uses the height and width values corresponding to {@link TaskModuleDimension | TaskModuleDimension.Small}
+     * otherwise uses the height and width values corresponding to {@link DialogDimension | TaskModuleDimension.Small}
      * @param taskInfo TaskInfo object from which to extract size info, if specified
      * @returns TaskInfo with height and width specified
      */