@types/office-js-preview 1.0.317 → 1.0.318

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 Jun 2022 23:32:26 GMT
+ * Last updated: Fri, 08 Jul 2022 00:32:15 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -19644,7 +19644,24 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        lambdaInCell = "LambdaInCell"
+        lambdaInCell = "LambdaInCell",
+        /**
+        * An error caused by a `CellValue` object that is too deeply nested within another `CellValue`. Displays as error type #CALC! in Excel.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        tooDeeplyNested = "TooDeeplyNested",
+        /**
+        * An error caused by a cell's formula returning a string that exceeds the maximum of 32767 characters. Displays as error type #CALC! in Excel.
+        * Some characters, like emoji, may appear to be one character in the Excel UI but are actually processed as surrogate characters. A surrogate character counts as multiple characters toward the maximum character limit.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        textOverflow = "TextOverflow"
     }
     /**
     * Represents the value of a cell containing a #CALC! error.
@@ -19695,7 +19712,15 @@ declare namespace Excel {
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
         * @beta
         */
-        errorSubType?: CalcErrorCellValueSubType | "Unknown" | "ArrayOfArrays" | "ArrayOfRanges" | "EmptyArray" | "UnsupportedLifting" | "DataTableReferencedPendingFormula" | "TooManyCells" | "LambdaInCell";
+        errorSubType?: CalcErrorCellValueSubType | "Unknown" | "ArrayOfArrays" | "ArrayOfRanges" | "EmptyArray" | "UnsupportedLifting" | "DataTableReferencedPendingFormula" | "TooManyCells" | "LambdaInCell" | "TooDeeplyNested" | "TextOverflow";
+        /**
+        * Represents the name of the function causing the error.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        functionName?: string;
     }
     /**
     * Represents a reference to a property used by the card layout.
@@ -19706,7 +19731,7 @@ declare namespace Excel {
     */
     interface CardLayoutPropertyReference {
         /**
-        * The name of the property referenced by the card layout.
+        * Represents the name of the property referenced by the card layout.
         *
         * @remarks
         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -20838,6 +20863,14 @@ declare namespace Excel {
         */
         div0 = "Div0",
         /**
+        * Represents an `ExternalErrorCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        external = "External",
+        /**
         * Represents a `FieldErrorCellValue`.
         *
         * @remarks
@@ -20925,7 +20958,83 @@ declare namespace Excel {
     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
     * @beta
     */
-    type ErrorCellValue = BlockedErrorCellValue | BusyErrorCellValue | CalcErrorCellValue | ConnectErrorCellValue | Div0ErrorCellValue | FieldErrorCellValue | GettingDataErrorCellValue | NotAvailableErrorCellValue | NameErrorCellValue | NullErrorCellValue | NumErrorCellValue | PlaceholderErrorCellValue | RefErrorCellValue | SpillErrorCellValue | ValueErrorCellValue;
+    type ErrorCellValue = BlockedErrorCellValue | BusyErrorCellValue | CalcErrorCellValue | ConnectErrorCellValue | Div0ErrorCellValue | ExternalErrorCellValue | FieldErrorCellValue | GettingDataErrorCellValue | NotAvailableErrorCellValue | NameErrorCellValue | NullErrorCellValue | NumErrorCellValue | PlaceholderErrorCellValue | RefErrorCellValue | SpillErrorCellValue | ValueErrorCellValue;
+    /**
+    * Represents types of #EXTERNAL! errors.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    enum ExternalErrorCellValueSubType {
+        /**
+        * An unknown type of error. Displays as error type #EXTERNAL! in Excel.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        unknown = "Unknown",
+        /**
+        * An error returned by the Python interpreter as a result of running the Python code. Displays as error type #EXTERNAL! in Excel.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        pythonError = "PythonError"
+    }
+    /**
+    * Represents the value of a cell containing an #EXTERNAL! error.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    interface ExternalErrorCellValue {
+        /**
+        * Represents the type of this cell value.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        type: CellValueType.error | "Error";
+        /**
+        * Represents the value that would be returned by `Range.values` for a cell with this value.
+        * When accessed through a `valuesAsJson` property, this string value aligns with the en-US locale.
+        * When accessed through a `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        basicValue?: "#EXTERNAL!" | string;
+        /**
+        * 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 type of `ErrorCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        errorType?: ErrorCellValueType.external | "External";
+        /**
+        * Represents the type of `ExternalErrorCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        errorSubType?: ExternalErrorCellValueSubType | "Unknown" | "PythonError";
+    }
     /**
     * Represents types of #FIELD! errors.
     *
@@ -21009,6 +21118,14 @@ declare namespace Excel {
         * @beta
         */
         errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError";
+        /**
+        * Represents the field which was not found by FIELDVALUE.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        fieldName?: string;
     }
     /**
     * Represents the value of a cell containing a number with a format string. 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}.
@@ -21350,6 +21467,31 @@ declare namespace Excel {
         errorType?: ErrorCellValueType.null | "Null";
     }
     /**
+    * Represents types of #NUM! errors.
+    *
+    * @remarks
+    * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+    * @beta
+    */
+    enum NumErrorCellValueSubType {
+        /**
+        * An unknown type of error. Displays as error type #NUM! in Excel.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        unknown = "Unknown",
+        /**
+        * An error caused by a cell's formula having an array parameter with too many rows or columns. The maximum number of rows and columns in an array parameter is 1048576. Displays as error type #NUM! in Excel.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        arrayTooLarge = "ArrayTooLarge"
+    }
+    /**
     * Represents the value of a cell containing a #NUM! error.
     *
     * @remarks
@@ -21391,6 +21533,22 @@ declare namespace Excel {
         * @beta
         */
         errorType?: ErrorCellValueType.num | "Num";
+        /**
+        * Represents the type of `NumErrorCellValue`.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        errorSubType?: NumErrorCellValueSubType | "Unknown" | "ArrayTooLarge";
+        /**
+        * Represents the name of the function causing the error.
+        *
+        * @remarks
+        * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+        * @beta
+        */
+        functionName?: string;
     }
     /**
     * Represents types of #REF! errors.
@@ -32825,6 +32983,19 @@ declare namespace Excel {
          * @param name Optional. Specifies the name of the new column. If `null`, the default name will be used.
          */
         add(index?: number, values?: Array<Array<boolean | string | number>> | boolean | string | number, name?: string): Excel.TableColumn;
+        /**
+         * Adds a new column to the table.
+                    Unlike `add()`, `addAsJson()` takes any type of cell value, such as image or entity data types.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         *
+         * @param index Optional. Specifies the relative position of the new column. If null or -1, the addition happens at the end. Columns with a higher index will be shifted to the side. Zero-indexed.
+         * @param values Optional. A 2D array of cell values of the table column.
+         * @param name Optional. Specifies the name of the new column. If `null`, the default name will be used.
+         */
+        addAsJson(index?: number, values?: CellValue[][], name?: string): Excel.TableColumn;
         /**
          * Gets the number of columns in the table.
          *
@@ -33058,6 +33229,24 @@ declare namespace Excel {
          * @param alwaysInsert Optional. Specifies whether the new rows will be inserted into the table when new rows are added. If `true`, the new rows will be inserted into the table. If `false`, the new rows will be added below the table. Default is `true`.
          */
         add(index?: number, values?: Array<Array<boolean | string | number>> | boolean | string | number, alwaysInsert?: boolean): Excel.TableRow;
+        /**
+         * Adds one or more rows to the table. The returned object will be the top row of the newly added row or rows.
+                     Unlike `add()`, `addAsJson()` takes any type of cell value, such as image or entity data types.
+                    
+                     Note that unlike ranges or columns, which will adjust if new rows or columns are added before them,
+                     a `TableRow` object represents the physical location of the table row, but not the data.
+                     That is, if the data is sorted or if new rows are added, a table row will continue
+                     to point at the index for which it was created.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         *
+         * @param index Optional. Specifies the relative position of the new row. If null or -1, the addition happens at the end. Any rows below the inserted row are shifted downwards. Zero-indexed.
+         * @param values Optional. A 2D array of cell values of the table row.
+         * @param alwaysInsert Optional. Specifies whether the new rows will be inserted into the table when new rows are added. If `true`, the new rows will be inserted into the table. If `false`, the new rows will be added below the table. Default is `true`.
+         */
+        addAsJson(index?: number, values?: CellValue[][], alwaysInsert?: boolean): Excel.TableRow;
         /**
          * Delete multiple rows from a table.
                     These rows don't need to be sequential. This method will throw the `InvalidArgument` error if a chosen row has already been deleted or doesn't exist.

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.317",
+    "version": "1.0.318",
     "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": "f19ecff4c37e5e2bfe90d4e84f785282ed2b85d00355182d4fb4e0c340eea623",
+    "typesPublisherContentHash": "bf8642e42365f504fdabe3aa84a7a02ca4d53fc8dd8056c72ed6be5c0d143aeb",
     "typeScriptVersion": "4.0"
 }