@types/office-js-preview 1.0.262 → 1.0.266

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: Fri, 22 Oct 2021 21:31:20 GMT
+ * Last updated: Mon, 01 Nov 2021 20:31:23 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -9713,13 +9713,11 @@ declare namespace Office {
          * Manages the {@link Office.SessionData | SessionData} of an item in Compose mode.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Organizer
-         *
-         * @beta
          */
         sessionData: SessionData;
         /**
@@ -12676,6 +12674,8 @@ declare namespace Office {
      * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
      *
      * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+     *
+     * @beta
      */
     interface DelayDeliveryTime {
         /**
@@ -12692,6 +12692,8 @@ declare namespace Office {
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
+         *
+         * @beta
          */
         getAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Date>) => void): void;
         /**
@@ -12706,6 +12708,8 @@ declare namespace Office {
          *
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
+         *
+         * @beta
          */
         getAsync(callback?: (asyncResult: Office.AsyncResult<Date>) => void): void;
         /**
@@ -12723,6 +12727,8 @@ declare namespace Office {
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
          *                             of type Office.AsyncResult. Any errors encountered will be provided in the `asyncResult.error` property.
+         *
+         * @beta
          */
         setAsync(datetime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
@@ -12738,6 +12744,8 @@ declare namespace Office {
          * @param datetime - The future date and time when the message should be sent.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
          *                             of type Office.AsyncResult. Any errors encountered will be provided in the `asyncResult.error` property.
+         *
+         * @beta
          */
         setAsync(datetime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
     }
@@ -14694,6 +14702,8 @@ declare namespace Office {
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
+         *
+         * @beta
          */
         delayDeliveryTime: DelayDeliveryTime;
         /**
@@ -14775,13 +14785,11 @@ declare namespace Office {
          * Manages the {@link Office.SessionData | SessionData} of an item in Compose mode.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
-         *
-         * @beta
          */
         sessionData: SessionData;
         /**
@@ -16817,6 +16825,7 @@ declare namespace Office {
          *
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter of
          *                 type `Office.AsyncResult`.
+         *
          * @beta
          */
         getAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
@@ -17147,6 +17156,8 @@ declare namespace Office {
          *
          * @remarks
          * [Api set: Mailbox preview]
+         *
+         * @beta
          */
         officeTheme: Office.OfficeTheme;
         /**
@@ -17154,6 +17165,8 @@ declare namespace Office {
          *
          * @remarks
          * [Api set: Mailbox preview]
+         *
+         * @beta
          */
         type: "officeThemeChanged";
     }
@@ -18183,20 +18196,18 @@ declare namespace Office {
      * Provides methods to  manage an item's session data.
      *
      * @remarks
-     * [Api set: Mailbox preview]
+     * [Api set: Mailbox 1.11]
      *
      * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
      *
      * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
-     *
-     * @beta
      */
     interface SessionData {
         /**
          * Clears all session data key-value pairs.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteItem`
          *
@@ -18206,15 +18217,13 @@ declare namespace Office {
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
-         *
-         * @beta
          */
         clearAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Clears all session data key-value pairs.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteItem`
          *
@@ -18222,15 +18231,13 @@ declare namespace Office {
          *
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
-         *
-         * @beta
          */
         clearAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Gets all session data key-value pairs.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteItem`
          *
@@ -18238,15 +18245,13 @@ declare namespace Office {
          *
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
-         *
-         * @beta
          */
         getAllAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Gets the session data value of the specified key.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
@@ -18255,15 +18260,13 @@ declare namespace Office {
          * @param name - The session data key.
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter of
          *                 type `Office.AsyncResult`.
-         *
-         * @beta
          */
         getAsync(name: string, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
         /**
          * Removes a session data key-value pair.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteItem`
          *
@@ -18274,15 +18277,13 @@ declare namespace Office {
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
-         *
-         * @beta
          */
         removeAsync(name: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Removes a session data key-value pair.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteItem`
          *
@@ -18291,15 +18292,13 @@ declare namespace Office {
          * @param name - The session data key.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
-         *
-         * @beta
          */
         removeAsync(name: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Sets a session data key-value pair.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
@@ -18311,15 +18310,13 @@ declare namespace Office {
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
          *                 type `Office.AsyncResult`.
-         *
-         * @beta
          */
         setAsync(name: string, value: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Sets a session data key-value pair.
          *
          * @remarks
-         * [Api set: Mailbox preview]
+         * [Api set: Mailbox 1.11]
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadItem`
          *
@@ -18329,8 +18326,6 @@ declare namespace Office {
          * @param value - The session data value as a string.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
          *                 type `Office.AsyncResult`.
-         *
-         * @beta
          */
         setAsync(name: string, value: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
     }
@@ -19068,6 +19063,47 @@ declare namespace OfficeCore {
 
 
 declare namespace Excel {
+    /**
+    * Represents a 2D array of cell values.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface ArrayCellValue {
+        /**
+        * Represents the type of this cell value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        type: CellValueType.array | "Array";
+        /**
+        * Represents the value that would be returned by `Range.values` for a cell with this value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        basicValue?: "#VALUE!";
+        /**
+        * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        basicType?: RangeValueType.error | "Error";
+        /**
+        * Represents the elements of the array. May not directly contain an `ArrayCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        elements: CellValue[][];
+    }
     /**
     * Represents types of #BLOCKED! errors.
     *
@@ -19164,7 +19200,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#BLOCKED!";
+        basicValue?: "#BLOCKED!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19172,7 +19208,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -19213,7 +19249,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive: boolean;
+        basicValue: boolean;
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19221,7 +19257,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.boolean | "Boolean";
+        basicType?: RangeValueType.boolean | "Boolean";
     }
     /**
     * Represents types of #BUSY! errors.
@@ -19279,7 +19315,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#BUSY!";
+        basicValue?: "#BUSY!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19287,7 +19323,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -19401,7 +19437,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#CALC!";
+        basicValue?: "#CALC!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19409,7 +19445,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -19435,6 +19471,14 @@ declare namespace Excel {
     * @beta
     */
     enum CellValueType {
+        /**
+        * Represents an `ArrayCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        array = "Array",
         /**
         * Represents a `BooleanCellValue`.
         *
@@ -19452,6 +19496,14 @@ declare namespace Excel {
         */
         double = "Double",
         /**
+        * Represents an `EntityCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        entity = "Entity",
+        /**
         * Represents an `EmptyCellValue`.
         *
         * @remarks
@@ -19501,6 +19553,34 @@ declare namespace Excel {
         webImage = "WebImage"
     }
     /**
+    * Represents the value in a cell.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type CellValue = ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue | ErrorCellValue | FormattedNumberCellValue | StringCellValue | ValueTypeNotAvailableCellValue | WebImageCellValue & {
+        /**
+        * Represents whether this `CellValue` will be used to overwrite a cell.
+        * When false, APIs which would use this `CellValue` to overwrite a cell will instead ignore this value without throwing an error.
+        * The default value is true.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        writable?: boolean;
+        /**
+        * Represents an explanation about why `CellValue.writable` is specified as false.
+        * Note: This string is only available if `writable` is specified as false.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        writableNote?: string;
+    };
+    /**
     * The attribution attributes object represents the set of details that can be used to describe where information came from, if the information comes from a public source.
     *
     * @remarks
@@ -19576,6 +19656,80 @@ declare namespace Excel {
         logoTargetAddress?: string;
     }
     /**
+    * Metadata about a property in `EntityCellValue.properties`.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CellValuePropertyMetadata {
+        /**
+        * Represents which features this property is excluded from.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        excludeFrom?: CellValuePropertyMetadataExclusions;
+        /**
+        * Represents the sublabel for this property shown in card view.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        sublabel?: string;
+        /**
+        * Represents attribution information to describe the source and license requirements for using this property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        attribution?: CellValueAttributionAttributes[];
+    }
+    /**
+    * Represents the exclusion of a property in `EntityCellValue.properties` from features of Excel.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface CellValuePropertyMetadataExclusions {
+        /**
+        * True represents that the property is excluded from the properties shown by card view. False and undefined represent the default behavior of including the property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        cardView?: boolean;
+        /**
+        * True represents that the property is excluded from the properties shown by auto complete. False and undefined represent the default behavior of including the property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        autoComplete?: boolean;
+        /**
+        * True represents that the property is excluded from the properties used to compare cell values during recalc. False and undefined represent the default behavior of including the property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        calcCompare?: boolean;
+        /**
+        * True represents that the property is excluded from the properties which can be accessed via the FIELDVALUE function. False and undefined represent the default behavior of including the property.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        dotNotation?: boolean;
+    }
+    /**
     * Represents types of #CONNECT! errors.
     *
     * @remarks
@@ -19743,7 +19897,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#CONNECT!";
+        basicValue?: "#CONNECT!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19751,7 +19905,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -19792,7 +19946,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#DIV/0!";
+        basicValue?: "#DIV/0!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19800,7 +19954,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -19833,7 +19987,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive: number;
+        basicValue: number;
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19841,7 +19995,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.double | "Double";
+        basicType?: RangeValueType.double | "Double";
     }
     /**
     * Represents the value of a cell that's empty and has no formulas or data.
@@ -19866,7 +20020,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "";
+        basicValue?: "";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -19874,7 +20028,60 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.empty | "Empty";
+        basicType?: RangeValueType.empty | "Empty";
+    }
+    /**
+    * Represents an schemaless set of properties.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface EntityCellValue {
+        /**
+        * Represents the type of this cell value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        type: CellValueType.entity | "Entity";
+        /**
+        * Represents the value that would be returned by `Range.values` for a cell with this value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        basicValue?: "#VALUE!";
+        /**
+        * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        basicType?: RangeValueType.error | "Error";
+        /**
+        * Represents the text shown when a cell with this value is rendered.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        text?: string;
+        /**
+        * Represents the properties of this entity and their metadata.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        properties?: {
+            [key: string]: CellValue & {
+                propertyMetadata?: CellValuePropertyMetadata;
+            };
+        };
     }
     /**
     * Represents the types of the `ErrorCellValue` object.
@@ -19941,13 +20148,13 @@ declare namespace Excel {
         */
         gettingData = "GettingData",
         /**
-        * Represents a `NaErrorCellValue`.
+        * Represents a `NotAvailableErrorCellValue`.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        na = "Na",
+        notAvailable = "NotAvailable",
         /**
         * Represents a `NameErrorCellValue`.
         *
@@ -19998,6 +20205,14 @@ declare namespace Excel {
         value = "Value"
     }
     /**
+    * Represents a cell value which contains an error.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    type ErrorCellValue = BlockedErrorCellValue | BusyErrorCellValue | CalcErrorCellValue | ConnectErrorCellValue | Div0ErrorCellValue | FieldErrorCellValue | GettingDataErrorCellValue | NotAvailableErrorCellValue | NameErrorCellValue | NullErrorCellValue | NumErrorCellValue | RefErrorCellValue | SpillErrorCellValue | ValueErrorCellValue;
+    /**
     * Represents types of #FIELD! errors.
     *
     * @remarks
@@ -20053,7 +20268,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#FIELD!";
+        basicValue?: "#FIELD!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20061,7 +20276,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20103,7 +20318,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive: number;
+        basicValue: number;
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20111,7 +20326,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.double | "Double";
+        basicType?: RangeValueType.double | "Double";
         /**
         * Returns the number format string that is used to display this value.
         * Number format strings must conform to Excel guidelines. To learn more, see {@link https://support.microsoft.com/office/review-guidelines-for-customizing-a-number-format-c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5 | Review guidelines for customizing a number format}.
@@ -20145,7 +20360,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#GETTING_DATA";
+        basicValue?: "#GETTING_DATA";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20153,7 +20368,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20170,7 +20385,7 @@ declare namespace Excel {
     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
     * @beta
     */
-    interface NaErrorCellValue {
+    interface NotAvailableErrorCellValue {
         /**
         * Represents the type of this cell value.
         *
@@ -20186,7 +20401,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#N/A!";
+        basicValue?: "#N/A!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20194,7 +20409,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20202,7 +20417,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        errorType?: ErrorCellValueType.na | "Na";
+        errorType?: ErrorCellValueType.notAvailable | "NotAvailable";
     }
     /**
     * Represents the value of a cell containing a #NAME? error.
@@ -20227,7 +20442,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#NAME?";
+        basicValue?: "#NAME?";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20235,7 +20450,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20268,7 +20483,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#NULL!";
+        basicValue?: "#NULL!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20276,7 +20491,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20309,7 +20524,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#NUM!";
+        basicValue?: "#NUM!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20317,7 +20532,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20350,7 +20565,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        vlookupColIndexGreaterThanNumCols = "VlookupColIndexGreaterThanNumCols",
+        vlookupColumnIndexGreaterThanNumColumns = "VlookupColumnIndexGreaterThanNumColumns",
         /**
         * An error caused by a row_index_num parameter of HLOOKUP that's greater than the number of rows in the table_array parameter. Displays as error type #REF! in Excel.
         *
@@ -20374,15 +20589,15 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayStartRowOutofBounds = "SubArrayStartRowOutofBounds",
+        subArrayStartRowOutOfBounds = "SubArrayStartRowOutOfBounds",
         /**
-        * An error caused by a start_col parameter of SUBARRAY being out of bounds. Displays as error type #REF! in Excel.
+        * An error caused by a start_column parameter of SUBARRAY being out of bounds. Displays as error type #REF! in Excel.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayStartColOutofBounds = "SubArrayStartColOutofBounds",
+        subArrayStartColumnOutOfBounds = "SubArrayStartColumnOutOfBounds",
         /**
         * An error caused by an end_row parameter of SUBARRAY being out of bounds. Displays as error type #REF! in Excel.
         *
@@ -20390,15 +20605,15 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayEndRowOutofBounds = "SubArrayEndRowOutofBounds",
+        subArrayEndRowOutOfBounds = "SubArrayEndRowOutOfBounds",
         /**
-        * An error caused by an end_col parameter of SUBARRAY being out of bounds. Displays as error type #REF! in Excel.
+        * An error caused by an end_column parameter of SUBARRAY being out of bounds. Displays as error type #REF! in Excel.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayEndColOutofBounds = "SubArrayEndColOutofBounds",
+        subArrayEndColumnOutOfBounds = "SubArrayEndColumnOutOfBounds",
         /**
         * An error caused by an end_row parameter of SUBARRAY preceding the start_row parameter. Displays as error type #REF! in Excel.
         *
@@ -20408,13 +20623,13 @@ declare namespace Excel {
         */
         subArrayEndRowPrecedesStartRow = "SubArrayEndRowPrecedesStartRow",
         /**
-        * An error caseud by an end_col parameter of SUBARRAY preceding the start_col parameter. Displays as error type #REF! in Excel.
+        * An error caused by an end_column parameter of SUBARRAY preceding the start_column parameter. Displays as error type #REF! in Excel.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayEndColPrecedesStartCol = "SubArrayEndColPrecedesStartCol"
+        subArrayEndColumnPrecedesStartColumn = "SubArrayEndColumnPrecedesStartColumn"
     }
     /**
     * Represents the value of a cell containing a #REF! error.
@@ -20439,7 +20654,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#REF!";
+        basicValue?: "#REF!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20447,7 +20662,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20463,7 +20678,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        errorSubType?: RefErrorCellValueSubType | "Unknown" | "VlookupColIndexGreaterThanNumCols" | "HlookupRowIndexGreaterThanNumRows" | "ExternalLinksRefNotExist" | "SubArrayStartRowOutofBounds" | "SubArrayStartColOutofBounds" | "SubArrayEndRowOutofBounds" | "SubArrayEndColOutofBounds" | "SubArrayEndRowPrecedesStartRow" | "SubArrayEndColPrecedesStartCol";
+        errorSubType?: RefErrorCellValueSubType | "Unknown" | "VlookupColumnIndexGreaterThanNumColumns" | "HlookupRowIndexGreaterThanNumRows" | "ExternalLinksRefNotExist" | "SubArrayStartRowOutOfBounds" | "SubArrayStartColumnOutOfBounds" | "SubArrayEndRowOutOfBounds" | "SubArrayEndColumnOutOfBounds" | "SubArrayEndRowPrecedesStartRow" | "SubArrayEndColumnPrecedesStartColumn";
     }
     /**
     * Represents types of #SPILL! errors.
@@ -20553,7 +20768,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#SPILL!";
+        basicValue?: "#SPILL!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20561,7 +20776,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20618,7 +20833,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive: string;
+        basicValue: string;
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20626,7 +20841,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.string | "String";
+        basicType?: RangeValueType.string | "String";
     }
     /**
     * Represents types of #VALUE! errors.
@@ -20645,13 +20860,13 @@ declare namespace Excel {
         */
         unknown = "Unknown",
         /**
-        * An error caused by a col_index_num parameter of VLOOKUP of less than 1. Displays as error type #VALUE! in Excel.
+        * An error caused by a column_index_num parameter of VLOOKUP of less than 1. Displays as error type #VALUE! in Excel.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        vlookupColIndexLessThanOne = "VlookupColIndexLessThanOne",
+        vlookupColumnIndexLessThanOne = "VlookupColumnIndexLessThanOne",
         /**
         * An error caused by VLOOKUP not finding its lookup_value parameter. Displays as error type #VALUE! in Excel.
         *
@@ -20715,7 +20930,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        subArrayStartColMissingEndColNot = "SubArrayStartColMissingEndColNot",
+        subArrayStartColumnMissingEndColumnNot = "SubArrayStartColumnMissingEndColumnNot",
         /**
         * An error caused by a `WebImageValue` with an invalid URL. Displays as error type #VALUE! in Excel.
         *
@@ -20820,7 +21035,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#VALUE!";
+        basicValue?: "#VALUE!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20828,7 +21043,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the type of `ErrorCellValue`.
         *
@@ -20844,7 +21059,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        errorSubType?: ValueErrorCellValueSubType | "Unknown" | "VlookupColIndexLessThanOne" | "VlookupResultNotFound" | "HlookupRowIndexLessThanOne" | "HlookupResultNotFound" | "CoerceStringToNumberInvalid" | "CoerceStringToBoolInvalid" | "CoerceStringToInvalidType" | "SubArrayStartRowMissingEndRowNot" | "SubArrayStartColMissingEndColNot" | "InvalidImageUrl" | "StockHistoryNonTradingDays" | "StockHistoryNotAStock" | "StockHistoryInvalidDate" | "StockHistoryEndBeforeStart" | "StockHistoryStartInFuture" | "StockHistoryInvalidEnum" | "StockHistoryOnlyDateRequested" | "StockHistoryNotFound" | "LambdaWrongParamCount";
+        errorSubType?: ValueErrorCellValueSubType | "Unknown" | "VlookupColumnIndexLessThanOne" | "VlookupResultNotFound" | "HlookupRowIndexLessThanOne" | "HlookupResultNotFound" | "CoerceStringToNumberInvalid" | "CoerceStringToBoolInvalid" | "CoerceStringToInvalidType" | "SubArrayStartRowMissingEndRowNot" | "SubArrayStartColumnMissingEndColumnNot" | "InvalidImageUrl" | "StockHistoryNonTradingDays" | "StockHistoryNotAStock" | "StockHistoryInvalidDate" | "StockHistoryEndBeforeStart" | "StockHistoryStartInFuture" | "StockHistoryInvalidEnum" | "StockHistoryOnlyDateRequested" | "StockHistoryNotFound" | "LambdaWrongParamCount";
     }
     /**
     * Represents the value of a cell containing a type of value which cannot be serialized.
@@ -20870,7 +21085,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive: boolean | number | string;
+        basicValue: boolean | number | string;
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20878,7 +21093,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType: RangeValueType | "Boolean" | "Double" | "Error" | "Empty" | "String";
+        basicType: RangeValueType | "Boolean" | "Double" | "Error" | "Empty" | "String";
     }
     /**
     * Represents the value of a cell containing an image downloaded from the internet.
@@ -20903,7 +21118,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitive?: "#VALUE!";
+        basicValue?: "#VALUE!";
         /**
         * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
         *
@@ -20911,7 +21126,7 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        primitiveType?: RangeValueType.error | "Error";
+        basicType?: RangeValueType.error | "Error";
         /**
         * Represents the URL from which the image will be downloaded.
         * This image must be hosted on a server that supports HTTPS.
@@ -38080,7 +38295,7 @@ declare namespace Excel {
          * Clears the column filter criteria of the AutoFilter.
          *
          * @remarks
-         * [Api set: ExcelApiOnline 1.1]
+         * [Api set: ExcelApi 1.14]
          *
          * @param columnIndex The zero-based column index, which represents which column filter needs to be cleared.
                      If the index value is not supported(for example, if the value is a negative number, or if the value is greater than the number of available columns in the range),
@@ -54285,7 +54500,7 @@ declare namespace Excel {
         }): FunctionResult<T>;
         /**
         * Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is passed to it.)
-        * Whereas the original FunctionResult<T> object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Interfaces.FunctionResultData<T>`) that contains shallow copies of any loaded child properties from the original object.
+        * Whereas the original `FunctionResult<T>` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Interfaces.FunctionResultData<T>`) that contains shallow copies of any loaded child properties from the original object.
         */
         toJSON(): Interfaces.FunctionResultData<T>;
     }
@@ -58046,7 +58261,9 @@ declare namespace Excel {
         accessDenied = "AccessDenied",
         apiNotFound = "ApiNotFound",
         conflict = "Conflict",
+        emptyChartSeries = "EmptyChartSeries",
         filteredRangeConflict = "FilteredRangeConflict",
+        formulaLengthExceedsLimit = "FormulaLengthExceedsLimit",
         generalException = "GeneralException",
         inactiveWorkbook = "InactiveWorkbook",
         insertDeleteConflict = "InsertDeleteConflict",
@@ -82536,7 +82753,10 @@ declare namespace Word {
          */
         readonly lists: Word.ListCollection;
         /**
-         * Get the collection of paragraph objects in the content control. Read-only.
+         * Gets the collection of paragraph objects in the content control. Read-only.
+         *
+         * **Important**: For requirement sets 1.1 and 1.2, paragraphs in tables wholly contained within this content control are not returned.
+         * From requirement set 1.3, paragraphs in such tables are also returned. 
          *
          * @remarks
          * [Api set: WordApi 1.1]
@@ -86176,6 +86396,9 @@ declare namespace Word {
         /**
          * Gets the parent body of the range. Read-only.
          *
+         * **Important**: For requirement sets 1.1 and 1.2, paragraphs in tables wholly contained within this range are not returned.
+         * From requirement set 1.3, paragraphs in such tables are also returned.
+         *
          * @remarks
          * [Api set: WordApi 1.3]
          */
@@ -96017,14 +96240,6 @@ declare namespace Word {
     /**
      * Executes a batch script that performs actions on the Word object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
      * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.
-     *
-     * @remarks
-     *
-     * In addition to this signature, the method also has the following signatures, which allow you to resume using the request context of previously created objects:
-     *
-     * run<T>(object: OfficeExtension.ClientObject, batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;
-     *
-     * run<T>(objects: OfficeExtension.ClientObject[], batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;
      */
     function run<T>(batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;
 }

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.262",
+    "version": "1.0.266",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -40,6 +40,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "159bd6cbe1379101cfb3652179a5481c3086b00b5328ec2fb5eb1ee83b301846",
+    "typesPublisherContentHash": "f60321769b6b2f67dbb1e217749b0ecdb6df989c6750d58b20198c885e960c05",
     "typeScriptVersion": "3.7"
 }