@types/office-js-preview 1.0.375 → 1.0.377

office-js-preview/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Office.js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
 
 ### Additional Details
- * Last updated: Tue, 28 Feb 2023 21:32:42 GMT
+ * Last updated: Thu, 09 Mar 2023 21:32:39 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -19898,6 +19898,63 @@ declare namespace Excel {
         referencedValues?: ReferencedValue[];
     }
     /**
+    * Represents a card layout that is best used for an array.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface EntityArrayCardLayout {
+        /**
+        * Represents the type of this layout.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        layout: EntityCardLayoutType.array | "Array";
+        /**
+        * Represents name of the property that contains the array shown in the card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        arrayProperty: string;
+        /**
+        * Represents name of the property that contains the array shown in the card. Default value is "Array".
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        displayName?: string;
+        /**
+        * Represents the count of rows which the card claims are in the array. A card may report a different number of rows than it actually has to display smaller amounts of preview data.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        rowsToReport?: number;
+        /**
+        * Represents the count of columns which the card claims are in the array. A card may report a different number of columns than it actually has to display smaller amounts of preview data.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        columnsToReport?: number;
+        /**
+        * Represents whether the first row of the array is treated as a header.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        firstRowIsHeader?: boolean;
+    }
+    /**
     * Represents types of #BLOCKED! errors.
     *
     * @remarks
@@ -20372,7 +20429,32 @@ declare namespace Excel {
     * @remarks
     * [Api set: ExcelApi 1.16]
     */
-    type CardLayout = EntityCardLayout;
+    type CardLayout = EntityCardLayout | EntityArrayCardLayout;
+    /**
+    * Types of entity card layouts.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    enum EntityCardLayoutType {
+        /**
+        * Entity layout of the entity card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        entity = "Entity",
+        /**
+        * Array layout of the entity card.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        array = "Array"
+    }
     /**
     * The compact layout properties for an entity.
     *
@@ -24953,7 +25035,7 @@ declare namespace Excel {
         propertyMetadata?: CellValuePropertyMetadata;
     }
     /**
-    * Represents an schemaless set of properties.
+    * Represents a set of properties without a schema or defined structure.
     *
     * @remarks
     * [Api set: ExcelApi 1.16]
@@ -25045,7 +25127,7 @@ declare namespace Excel {
         compact?: CompactLayout;
     }
     /**
-    * Represents a card layout best used for an entity.
+    * Represents a card layout that is best used for an array.
     *
     * @remarks
     * [Api set: ExcelApi 1.16]
@@ -25057,7 +25139,7 @@ declare namespace Excel {
         * @remarks
         * [Api set: ExcelApi 1.16]
         */
-        layout?: "Entity";
+        layout?: EntityCardLayoutType.entity | "Entity";
     }
     /**
     * Represents the types of the `ErrorCellValue` object.
@@ -27143,12 +27225,12 @@ declare namespace Excel {
     /**
      * Notifies when a worksheet is moved within a workbook.
                 
-                If a worksheet is moved from one position within the workbook to another
-                via the Excel UI, then this API will trigger an event. Note that if
-                the position of a worksheet changes as a result of moving a different worksheet,
-                then this event won't trigger for both position changes. This event only triggers
-                for the primary worksheet move, and not any worksheet position changes that occur
-                as a result of that primary move.
+                 If a worksheet is moved from one position within the workbook to another
+                 via the Excel UI, then this API will trigger an event. Note that if
+                 the position of a worksheet changes as a result of moving a different worksheet,
+                 then this event won't trigger for both position changes. This event only triggers
+                 for the primary worksheet move, and not any worksheet position changes that occur
+                 as a result of that primary move.
      *
      * @remarks
      * [Api set: ExcelApiOnline 1.1]
@@ -27735,6 +27817,115 @@ declare namespace Excel {
          */
         undo = "undo"
     }
+    /**
+     * Represents a recorded change to the task, to be used as an input parameter.
+     *
+     * @remarks
+     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+     * @beta
+     */
+    interface DocumentTaskChangeProperties {
+        /**
+         * Represents the user assigned to the task for an `assign` change action, or the user unassigned from the task for an `unassign` change action.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        assignee?: Excel.EmailIdentity;
+        /**
+         * Represents the identity of the user who made the task change.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        changedBy: Excel.EmailIdentity;
+        /**
+         * Represents the ID of the `comment` or `commentReply` to which the task change is anchored.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        commentId?: string;
+        /**
+         * Represents the creation date and time of the task change record. All dates are in UTC.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        createdDateTime?: Date;
+        /**
+         * Represents the task's due date and time. It is used for the `setSchedule` change action.
+                    It is in UTC time zone. It can be set to `null` to remove the due date and time. It should be set together with `startDateTime` to avoid conflicts.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        dueDateTime?: Date;
+        /**
+         * The unique GUID of the task change.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        id: string;
+        /**
+         * Represents the task's completion percentage. It is used for the `setPercentComplete` change action.
+                    This is a value betwen 0 and 100, where 100 represents a completed task. Changing this value to 100 also completes the associated comment. Changing the completion from 100 to a lower value reactivates the associated comment.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        percentComplete?: number;
+        /**
+         * Represents the task's priority. It is used for the `setPriority` change action.
+                    This is a value between 0 and 10, with 5 being the default priority if not set, and where 0 represents the highest priority.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        priority?: number;
+        /**
+         * Represents the task's start date and time. It is used for the `setSchedule` change action.
+                    It is in UTC time zone. It can be set to `null` to remove the start date and time. It should be set together with `dueDateTime` to avoid conflicts.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        startDateTime?: Date;
+        /**
+         * Represents the task's title. It is used for the `setTitle` change action.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        title?: string;
+        /**
+         * Represents the action type of the task change record. Some examples of action types are assign, undo, and setPriority.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        type: Excel.DocumentTaskChangeAction | "unknown" | "create" | "assign" | "unassign" | "unassignAll" | "setSchedule" | "setPercentComplete" | "setPriority" | "remove" | "restore" | "setTitle" | "undo";
+        /**
+         * Represents the `DocumentTaskChange.id` property that was undone for the `undo` change action.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        undoChangeId?: string;
+    }
     /**
      * Represents a recorded change to the task.
      *
@@ -27752,7 +27943,7 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        readonly assignee: Excel.Identity;
+        readonly assignee: Excel.EmailIdentity;
         /**
          * Represents the identity of the user who made the task change.
          *
@@ -27760,7 +27951,7 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        readonly changedBy: Excel.Identity;
+        readonly changedBy: Excel.EmailIdentity;
         /**
          * Represents the ID of the `comment` or `commentReply` to which the task change is anchored.
          *
@@ -27956,6 +28147,64 @@ declare namespace Excel {
          */
         id: string;
     }
+    /**
+     * Represents information about a user's identity.
+     *
+     * @remarks
+     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+     * @beta
+     */
+    interface EmailIdentity {
+        /**
+         * Represents the user's display name.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        displayName?: string;
+        /**
+         * Represents the user's email.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        email?: string;
+        /**
+         * Represents the user's unique ID.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        id: string;
+    }
+    /**
+     * Represents information about a task's schedule.
+     *
+     * @remarks
+     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+     * @beta
+     */
+    interface DocumentTaskSchedule {
+        /**
+         * Gets the date and time that the task is due. All dates are in UTC.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        dueDateTime: Date;
+        /**
+         * Gets the date and time that the task should start. All dates are in UTC.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        startDateTime: Date;
+    }
     /**
      * Represents a task.
      *
@@ -27989,7 +28238,7 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        readonly assignees: Excel.Identity[];
+        readonly assignees: Excel.EmailIdentity[];
         /**
          * Gets the most recent user to have completed the task.
          *
@@ -27997,7 +28246,7 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        readonly completedBy: Excel.Identity;
+        readonly completedBy: Excel.EmailIdentity;
         /**
          * Gets the date and time that the task was completed. All dates are in UTC.
          *
@@ -28013,7 +28262,7 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        readonly createdBy: Excel.Identity;
+        readonly createdBy: Excel.EmailIdentity;
         /**
          * Gets the date and time that the task was created. All dates are in UTC.
          *
@@ -28022,14 +28271,6 @@ declare namespace Excel {
          * @beta
          */
         readonly createdDateTime: Date;
-        /**
-         * Gets or sets the date and time the task is due.
-         *
-         * @remarks
-         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-         * @beta
-         */
-        dueDateTime: Date;
         /**
          * Gets the ID of the task.
          *
@@ -28055,13 +28296,13 @@ declare namespace Excel {
          */
         priority: number;
         /**
-         * Gets or sets the date and time the task starts.
+         * Gets or sets the date and time the task should start and is due.
          *
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        startDateTime: Date;
+        startAndDueDateTime: Excel.DocumentTaskSchedule;
         /**
          * Specifies title of the task.
          *
@@ -28079,7 +28320,7 @@ declare namespace Excel {
          *
          * @param assignee The identity of the user to add to the assignee list.
          */
-        assign(assignee: Excel.Identity): void;
+        assign(assignee: Excel.EmailIdentity): void;
         /**
          * Removes the given user from the list of assignees attached to the task.
          *
@@ -28089,7 +28330,7 @@ declare namespace Excel {
          *
          * @param assignee The identity of the user to remove from the assignee list.
          */
-        unassign(assignee: Excel.Identity): void;
+        unassign(assignee: Excel.EmailIdentity): void;
         /**
          * Removes all users from the list of assignees attached to the task.
          *
@@ -28260,8 +28501,8 @@ declare namespace Excel {
         /**
          * Equals comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`wholeDays`, `exclusive`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`wholeDays`, `exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28269,8 +28510,8 @@ declare namespace Excel {
         /**
          * Date is before comparator date.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`wholeDays`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`wholeDays`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28278,8 +28519,8 @@ declare namespace Excel {
         /**
          * Date is before or equal to comparator date.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`wholeDays`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`wholeDays`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28287,8 +28528,8 @@ declare namespace Excel {
         /**
          * Date is after comparator date.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`wholeDays`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`wholeDays`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28296,8 +28537,8 @@ declare namespace Excel {
         /**
          * Date is after or equal to comparator date.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`wholeDays`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`wholeDays`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28305,8 +28546,8 @@ declare namespace Excel {
         /**
          * Between `lowerBound` and `upperBound` dates.
                     
-                    Required Criteria: {`lowerBound`, `upperBound`}.
-                    Optional Criteria: {`wholeDays`, `exclusive`}.
+                     Required Criteria: {`lowerBound`, `upperBound`}.
+                     Optional Criteria: {`wholeDays`, `exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28522,8 +28763,8 @@ declare namespace Excel {
         /**
          * Equals comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`comparator`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28531,8 +28772,8 @@ declare namespace Excel {
         /**
          * Label begins with substring criterion.
                     
-                    Required Criteria: {`substring`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`substring`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28540,8 +28781,8 @@ declare namespace Excel {
         /**
          * Label ends with substring criterion.
                     
-                    Required Criteria: {`substring`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`substring`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28549,8 +28790,8 @@ declare namespace Excel {
         /**
          * Label contains substring criterion.
                     
-                    Required Criteria: {`substring`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`substring`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28558,7 +28799,7 @@ declare namespace Excel {
         /**
          * Greater than comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
+                     Required Criteria: {`comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28566,7 +28807,7 @@ declare namespace Excel {
         /**
          * Greater than or equal to comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
+                     Required Criteria: {`comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28574,7 +28815,7 @@ declare namespace Excel {
         /**
          * Less than comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
+                     Required Criteria: {`comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28582,7 +28823,7 @@ declare namespace Excel {
         /**
          * Less than or equal to comparator criterion.
                     
-                    Required Criteria: {`comparator`}.
+                     Required Criteria: {`comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28590,8 +28831,8 @@ declare namespace Excel {
         /**
          * Between `lowerBound` and `upperBound` criteria.
                     
-                    Required Criteria: {`lowerBound`, `upperBound`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`lowerBound`, `upperBound`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28904,8 +29145,8 @@ declare namespace Excel {
         /**
          * Equals comparator criterion.
                     
-                    Required Criteria: {`value`, `comparator`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`value`, `comparator`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28913,7 +29154,7 @@ declare namespace Excel {
         /**
          * Greater than comparator criterion.
                     
-                    Required Criteria: {`value`, `comparator`}.
+                     Required Criteria: {`value`, `comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28921,7 +29162,7 @@ declare namespace Excel {
         /**
          * Greater than or equal to comparator criterion.
                     
-                    Required Criteria: {`value`, `comparator`}.
+                     Required Criteria: {`value`, `comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28929,7 +29170,7 @@ declare namespace Excel {
         /**
          * Less than comparator criterion.
                     
-                    Required Criteria: {`value`, `comparator`}.
+                     Required Criteria: {`value`, `comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28937,7 +29178,7 @@ declare namespace Excel {
         /**
          * Less than or equal to comparator criterion.
                     
-                    Required Criteria: {`value`, `comparator`}.
+                     Required Criteria: {`value`, `comparator`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28945,8 +29186,8 @@ declare namespace Excel {
         /**
          * Between `lowerBound` and `upperBound` criteria.
                     
-                    Required Criteria: {`value`, `lowerBound`, `upperBound`}.
-                    Optional Criteria: {`exclusive`}.
+                     Required Criteria: {`value`, `lowerBound`, `upperBound`}.
+                     Optional Criteria: {`exclusive`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28954,7 +29195,7 @@ declare namespace Excel {
         /**
          * In top N (`threshold`) [items, percent, sum] of value category.
                     
-                    Required Criteria: {`value`, `threshold`, `selectionType`}.
+                     Required Criteria: {`value`, `threshold`, `selectionType`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -28962,7 +29203,7 @@ declare namespace Excel {
         /**
          * In bottom N (`threshold`) [items, percent, sum] of value category.
                     
-                    Required Criteria: {`value`, `threshold`, `selectionType`}.
+                     Required Criteria: {`value`, `threshold`, `selectionType`}.
          * @remarks
          * [Api set: ExcelApi 1.12]
          */
@@ -32797,9 +33038,9 @@ declare namespace Excel {
         /**
          * Occurs when a left-clicked/tapped action happens in the worksheet. This event will not be fired when clicking in the following cases:
 
-                    - The user drags the mouse for multi-selection.
+                     - The user drags the mouse for multi-selection.
 
-                    - The user selects a cell in the mode when cell arguments are selected for formula references.
+                     - The user selects a cell in the mode when cell arguments are selected for formula references.
          *
          * @remarks
          * [Api set: ExcelApi 1.10]
@@ -33773,10 +34014,10 @@ declare namespace Excel {
         set(properties: Excel.Range): void;
         /**
          * Fills a range from the current range to the destination range using the specified AutoFill logic.
-                    The destination range can be `null` or can extend the source range either horizontally or vertically.
-                    Discontiguous ranges are not supported.
+                     The destination range can be `null` or can extend the source range either horizontally or vertically.
+                     Discontiguous ranges are not supported.
                     
-                    For more information, see {@link https://support.microsoft.com/office/2e79a709-c814-4b27-8bc2-c4dc84d49464 | Use AutoFill and Flash Fill}.
+                     For more information, see {@link https://support.microsoft.com/office/2e79a709-c814-4b27-8bc2-c4dc84d49464 | Use AutoFill and Flash Fill}.
          *
          * @remarks
          * [Api set: ExcelApi 1.9, ExcelApi Preview for null `destinationRange`]
@@ -33787,10 +34028,10 @@ declare namespace Excel {
         autoFill(destinationRange?: Range | string, autoFillType?: Excel.AutoFillType): void;
         /**
          * Fills a range from the current range to the destination range using the specified AutoFill logic.
-                    The destination range can be `null` or can extend the source range either horizontally or vertically.
-                    Discontiguous ranges are not supported.
+                     The destination range can be `null` or can extend the source range either horizontally or vertically.
+                     Discontiguous ranges are not supported.
                     
-                    For more information, see {@link https://support.microsoft.com/office/2e79a709-c814-4b27-8bc2-c4dc84d49464 | Use AutoFill and Flash Fill}.
+                     For more information, see {@link https://support.microsoft.com/office/2e79a709-c814-4b27-8bc2-c4dc84d49464 | Use AutoFill and Flash Fill}.
          *
          * @remarks
          * [Api set: ExcelApi 1.9, ExcelApi Preview for null `destinationRange`]
@@ -33842,8 +34083,8 @@ declare namespace Excel {
          */
         convertToLinkedDataType(serviceID: number, languageCulture: string): void;
         /**
-         * Copies cell data or formatting from the source range or `RangeAreas` to the current range.
-                    The destination range can be a different size than the source range or `RangeAreas`. The destination will be expanded automatically if it is smaller than the source.
+         * Copies cell data or formatting from the source range or `RangeAreas` to the current range. The destination range can be a different size than the source range or `RangeAreas`. The destination is expanded automatically if it's smaller than the source.
+                    Note: Like the copy functionality in the Excel UI, if the destination range is an exact multiple greater than the source range in either rows or columns, then the source content is replicated multiple times. For example, a 2x2 range copy into a 2x6 range will result in 3 copies of the original 2x2 range.
          *
          * @remarks
          * [Api set: ExcelApi 1.9]
@@ -33855,8 +34096,8 @@ declare namespace Excel {
          */
         copyFrom(sourceRange: Range | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: boolean, transpose?: boolean): void;
         /**
-         * Copies cell data or formatting from the source range or `RangeAreas` to the current range.
-                    The destination range can be a different size than the source range or `RangeAreas`. The destination will be expanded automatically if it is smaller than the source.
+         * Copies cell data or formatting from the source range or `RangeAreas` to the current range. The destination range can be a different size than the source range or `RangeAreas`. The destination is expanded automatically if it's smaller than the source.
+                    Note: Like the copy functionality in the Excel UI, if the destination range is an exact multiple greater than the source range in either rows or columns, then the source content is replicated multiple times. For example, a 2x2 range copy into a 2x6 range will result in 3 copies of the original 2x2 range.
          *
          * @remarks
          * [Api set: ExcelApi 1.9]
@@ -38661,16 +38902,16 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-         getDataRange(): OfficeExtension.ClientResult<string>;
-         /**
-          * Gets the data source of the whole chart. If the data range is empty, then this method returns an object with its `isNullObject` property set to `true`.
+        getDataRange(): OfficeExtension.ClientResult<string>;
+        /**
+         * Gets the data source of the whole chart. If the data range is empty, then this method returns an object with its `isNullObject` property set to `true`.
                     For further information, see {@link https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties | *OrNullObject methods and properties}.
-          *
-          * @remarks
-          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-          * @beta
-          */
-         getDataRangeOrNullObject(): OfficeExtension.ClientResult<string>;        
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        getDataRangeOrNullObject(): OfficeExtension.ClientResult<string>;
         /**
          * Gets the data table on the chart. If the chart doesn't allow a data table, it will throw an exception.
          *
@@ -43334,7 +43575,7 @@ declare namespace Excel {
          */
         date: string;
         /**
-         * How specific the date should be used to keep data. For example, if the date is 2005-04-02 and the specifity is set to "month", the filter operation will keep all rows with a date in the month of April 2005.
+         * How specific the date should be used to keep data. For example, if the date is 2005-04-02 and the specificity is set to "month", the filter operation will keep all rows with a date in the month of April 2005.
          *
          * @remarks
          * [Api set: ExcelApi 1.2]
@@ -43524,6 +43765,14 @@ declare namespace Excel {
     class NumberFormatInfo extends OfficeExtension.ClientObject {
         /** The request context associated with the object. This connects the add-in's process to the Office host application's process. */
         context: RequestContext;
+        /**
+         * Gets the currency symbol for currency values. This is based on current system settings.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        readonly currencySymbol: string;
         /**
          * Gets the string used as the decimal separator for numeric values. This is based on current system settings.
          *
@@ -44282,9 +44531,9 @@ declare namespace Excel {
         /**
          * The alt text description of the PivotTable.
                     
-                    Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                    This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                    A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                     Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                     This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                     A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
          *
          * @remarks
          * [Api set: ExcelApi 1.13]
@@ -44293,9 +44542,9 @@ declare namespace Excel {
         /**
          * The alt text title of the PivotTable.
                     
-                    Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                    This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                    A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                     Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                     This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                     A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
          *
          * @remarks
          * [Api set: ExcelApi 1.13]
@@ -45648,7 +45897,7 @@ declare namespace Excel {
         descending = "Descending"
     }
     /**
-     * Aggregation function for the DataPivotField.
+     * Aggregation function for the `DataPivotHierarchy`.
      *
      * @remarks
      * [Api set: ExcelApi 1.8]
@@ -49625,7 +49874,7 @@ declare namespace Excel {
         toJSON(): Excel.Interfaces.PageBreakCollectionData;
     }
     /**
-     * Represents a collection of all the data connections that are part of the workbook or worksheet.
+     * Represents a collection of all the data connections that are part of the workbook.
      *
      * @remarks
      * [Api set: ExcelApi 1.7]
@@ -50034,7 +50283,7 @@ declare namespace Excel {
          *
          * @param assignee The assignee's user identity information.
          */
-        assignTask(assignee: Excel.Identity): Excel.DocumentTask;
+        assignTask(assignee: Excel.EmailIdentity): Excel.DocumentTask;
         /**
          * Deletes the comment and all the connected replies.
          *
@@ -50282,7 +50531,7 @@ declare namespace Excel {
          *
          * @param assignee The assignee's user identity information.
          */
-        assignTask(assignee: Excel.Identity): Excel.DocumentTask;
+        assignTask(assignee: Excel.EmailIdentity): Excel.DocumentTask;
         /**
          * Deletes the comment reply.
          *
@@ -63573,14 +63822,6 @@ declare namespace Excel {
         }
         /** An interface for updating data on the DocumentTask object, for use in `documentTask.set({ ... })`. */
         interface DocumentTaskUpdateData {
-            /**
-             * Gets or sets the date and time the task is due.
-             *
-             * @remarks
-             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-             * @beta
-             */
-            dueDateTime?: Date;
             /**
              * Specifies the completion percentage of the task. This is a value between 0 and 100, where 100 represents a completed task.
              *
@@ -63598,13 +63839,13 @@ declare namespace Excel {
              */
             priority?: number;
             /**
-             * Gets or sets the date and time the task starts.
+             * Gets or sets the date and time the task should start and is due.
              *
              * @remarks
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            startDateTime?: Date;
+            startAndDueDateTime?: Excel.DocumentTaskSchedule;
             /**
              * Specifies title of the task.
              *
@@ -66608,9 +66849,9 @@ declare namespace Excel {
             /**
              * The alt text description of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -66619,9 +66860,9 @@ declare namespace Excel {
             /**
              * The alt text title of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -68608,7 +68849,7 @@ declare namespace Excel {
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            assignee?: Excel.Identity;
+            assignee?: Excel.EmailIdentity;
             /**
              * Represents the identity of the user who made the task change.
              *
@@ -68616,7 +68857,7 @@ declare namespace Excel {
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            changedBy?: Excel.Identity;
+            changedBy?: Excel.EmailIdentity;
             /**
              * Represents the ID of the `Comment` or `CommentReply` to which the task change is anchored.
              *
@@ -68715,7 +68956,7 @@ declare namespace Excel {
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            assignees?: Excel.Identity[];
+            assignees?: Excel.EmailIdentity[];
             /**
              * Gets the most recent user to have completed the task.
              *
@@ -68723,7 +68964,7 @@ declare namespace Excel {
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            completedBy?: Excel.Identity;
+            completedBy?: Excel.EmailIdentity;
             /**
              * Gets the date and time that the task was completed. All dates are in UTC.
              *
@@ -68739,7 +68980,7 @@ declare namespace Excel {
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            createdBy?: Excel.Identity;
+            createdBy?: Excel.EmailIdentity;
             /**
              * Gets the date and time that the task was created. All dates are in UTC.
              *
@@ -68748,14 +68989,6 @@ declare namespace Excel {
              * @beta
              */
             createdDateTime?: Date;
-            /**
-             * Gets or sets the date and time the task is due.
-             *
-             * @remarks
-             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-             * @beta
-             */
-            dueDateTime?: Date;
             /**
              * Gets the ID of the task.
              *
@@ -68781,13 +69014,13 @@ declare namespace Excel {
              */
             priority?: number;
             /**
-             * Gets or sets the date and time the task starts.
+             * Gets or sets the date and time the task should start and is due.
              *
              * @remarks
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            startDateTime?: Date;
+            startAndDueDateTime?: Excel.DocumentTaskSchedule;
             /**
              * Specifies title of the task.
              *
@@ -72833,6 +73066,14 @@ declare namespace Excel {
         }
         /** An interface describing the data returned by calling `numberFormatInfo.toJSON()`. */
         interface NumberFormatInfoData {
+            /**
+             * Gets the currency symbol for currency values. This is based on current system settings.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            currencySymbol?: string;
             /**
              * Gets the string used as the decimal separator for numeric values. This is based on current system settings.
              *
@@ -73012,9 +73253,9 @@ declare namespace Excel {
             /**
              * The alt text description of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -73023,9 +73264,9 @@ declare namespace Excel {
             /**
              * The alt text title of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -75960,14 +76201,6 @@ declare namespace Excel {
              * @beta
              */
             createdDateTime?: boolean;
-            /**
-             * Gets or sets the date and time the task is due.
-             *
-             * @remarks
-             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-             * @beta
-             */
-            dueDateTime?: boolean;
             /**
              * Gets the ID of the task.
              *
@@ -75993,13 +76226,13 @@ declare namespace Excel {
              */
             priority?: boolean;
             /**
-             * Gets or sets the date and time the task starts.
+             * Gets or sets the date and time the task should start and is due.
              *
              * @remarks
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            startDateTime?: boolean;
+            startAndDueDateTime?: boolean;
             /**
              * Specifies title of the task.
              *
@@ -76069,14 +76302,6 @@ declare namespace Excel {
              * @beta
              */
             createdDateTime?: boolean;
-            /**
-             * For EACH ITEM in the collection: Gets or sets the date and time the task is due.
-             *
-             * @remarks
-             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
-             * @beta
-             */
-            dueDateTime?: boolean;
             /**
              * For EACH ITEM in the collection: Gets the ID of the task.
              *
@@ -76102,13 +76327,13 @@ declare namespace Excel {
              */
             priority?: boolean;
             /**
-             * For EACH ITEM in the collection: Gets or sets the date and time the task starts.
+             * For EACH ITEM in the collection: Gets or sets the date and time the task should start and is due.
              *
              * @remarks
              * [Api set: ExcelApi BETA (PREVIEW ONLY)]
              * @beta
              */
-            startDateTime?: boolean;
+            startAndDueDateTime?: boolean;
             /**
              * For EACH ITEM in the collection: Specifies title of the task.
              *
@@ -82117,6 +82342,14 @@ declare namespace Excel {
               Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
              */
             $all?: boolean;
+            /**
+             * Gets the currency symbol for currency values. This is based on current system settings.
+             *
+             * @remarks
+             * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+             * @beta
+             */
+            currencySymbol?: boolean;
             /**
              * Gets the string used as the decimal separator for numeric values. This is based on current system settings.
              *
@@ -82486,9 +82719,9 @@ declare namespace Excel {
             /**
              * The alt text description of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -82497,9 +82730,9 @@ declare namespace Excel {
             /**
              * The alt text title of the PivotTable.
                         
-                        Alt text provides alternative, text-based representations of the information contained in the PivotTable.
-                        This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
-                        A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
+                         Alt text provides alternative, text-based representations of the information contained in the PivotTable.
+                         This information is useful for people with vision or cognitive impairments who may not be able to see or understand the table.
+                         A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.
              *
              * @remarks
              * [Api set: ExcelApi 1.13]
@@ -118215,7 +118448,7 @@ declare namespace PowerPoint {
          * @remarks
          * [Api set: PowerPointApi 1.3]
          *
-         * @param key The ID of the tag.
+         * @param key The ID of the tag. The `key` parameter is case-sensitive.
          * @returns The tag with the unique ID. If such a tag does not exist, an error is thrown.
          */
         getItem(key: string): PowerPoint.Tag;
@@ -118235,7 +118468,7 @@ declare namespace PowerPoint {
          * @remarks
          * [Api set: PowerPointApi 1.3]
          *
-         * @param key The ID of the tag.
+         * @param key The ID of the tag. The `key` parameter is case-sensitive.
          * @returns The tag with the unique ID. If such a tag does not exist, an object with an `isNullObject` property set to true is returned.
          */
         getItemOrNullObject(key: string): PowerPoint.Tag;

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.375",
+    "version": "1.0.377",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "279a356a6f93bcaf0693b322e9031ea2a2c36e82051927e7a59cee9709a4318c",
+    "typesPublisherContentHash": "7176c843b8384af543ec345483b02f476b1303b35766ab426e6f2c7867efed34",
     "typeScriptVersion": "4.2"
 }