@types/office-js 1.0.298 → 1.0.300

office-js/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.
 
 ### Additional Details
- * Last updated: Tue, 08 Nov 2022 20:51:48 GMT
+ * Last updated: Mon, 14 Nov 2022 16:32:54 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js/index.d.ts

@@ -13143,7 +13143,7 @@ declare namespace Office {
      * The `InternetHeaders` object represents custom internet headers that are preserved after the message item leaves Exchange
      * and is converted to a MIME message. These headers are stored as x-headers in the MIME message.
      *
-     * Internet headers are stored as key/value pairs on a per-item basis.
+     * Internet headers are stored as string key-value pairs on a per-item basis.
      *
      * **Note**: This object is intended for you to set and get your custom headers on a message item. To learn more, see
      * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/internet-headers | Get and set internet headers on a message in an Outlook add-in}.
@@ -13173,8 +13173,8 @@ declare namespace Office {
      */
     interface InternetHeaders {
         /**
-         * Given an array of internet header names, this method returns a dictionary containing those internet headers and their values.
-         * If the add-in requests an x-header that is not available, that x-header will not be returned in the results.
+         * Given an array of internet header names, this method returns a record containing those internet headers and their values.
+         * If the add-in requests an x-header that isn't available, that x-header will not be returned in the results.
          *
          * **Note**: This method is intended to return the values of the custom headers you set using the `setAsync` method.
          *
@@ -13188,13 +13188,14 @@ declare namespace Office {
          * @param names - The names of the internet headers to be returned.
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @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.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *                `asyncResult`, of type `Office.AsyncResult`. The string key-value pairs of internet headers are returned in the
+         *                `asyncResult.value` property. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        getAsync(names: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<InternetHeaders>) => void): void;
+        getAsync(names: string[], options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<Record<string, string>>) => void): void;
         /**
-         * Given an array of internet header names, this method returns a dictionary containing those internet headers and their values.
-         * If the add-in requests an x-header that is not available, that x-header will not be returned in the results.
+         * Given an array of internet header names, this method returns a record containing those internet headers and their values.
+         * If the add-in requests an x-header that isn't available, that x-header will not be returned in the results.
          *
          * **Note**: This method is intended to return the values of the custom headers you set using the `setAsync` method.
          *
@@ -13206,10 +13207,11 @@ declare namespace Office {
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
          * @param names - The names of the internet headers to be returned.
-         * @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.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *                `asyncResult`, of type `Office.AsyncResult`. The string key-value pairs of internet headers are returned in the
+         *                `asyncResult.value` property. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        getAsync(names: string[], callback?: (asyncResult: Office.AsyncResult<InternetHeaders>) => void): void;
+        getAsync(names: string[], callback: (asyncResult: Office.AsyncResult<Record<string, string>>) => void): void;
         /**
          * Given an array of internet header names, this method removes the specified headers from the internet header collection.
          *
@@ -13226,9 +13228,9 @@ declare namespace Office {
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
          * @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.
+         *                `asyncResult`, of type `Office.AsyncResult`. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        removeAsync(names: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<InternetHeaders>) => void): void;
+        removeAsync(names: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Given an array of internet header names, this method removes the specified headers from the internet header collection.
          *
@@ -13243,9 +13245,9 @@ declare namespace Office {
          *
          * @param names - The names of the internet headers to be removed.
          * @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.
+         *                `asyncResult`, of type `Office.AsyncResult`. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        removeAsync(names: string[], callback?: (asyncResult: Office.AsyncResult<InternetHeaders>) => void): void;
+        removeAsync(names: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Sets the specified internet headers to the specified values.
          *
@@ -13267,14 +13269,14 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
-         * @param headers - The names and corresponding values of the headers to be set. Should be a dictionary object with keys being the names of the
-         *                internet headers and values being the values of the internet headers.
+         * @param headers - The names and corresponding values of the headers to be set. This should be a record object with its keys being internet header names
+         *                and values being the corresponding header value strings.
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @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.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *                 `asyncResult`, of type `Office.AsyncResult`. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        setAsync(headers: Object, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        setAsync(headers: Record<string, string>, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Sets the specified internet headers to the specified values.
          *
@@ -13296,12 +13298,12 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
-         * @param headers - The names and corresponding values of the headers to be set. Should be a dictionary object with keys being the names of the
-         *                internet headers and values being the values of the internet headers.
-         * @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.
+         * @param headers - The names and corresponding values of the headers to be set. This should be a record object with its keys being internet header names
+         *                and values being the corresponding header value strings.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *                 `asyncResult`, of type `Office.AsyncResult`. Any errors encountered are provided in the `asyncResult.error` property.
          */
-        setAsync(headers: Object, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        setAsync(headers: Record<string, string>, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
     }
     /**
      * The item namespace is used to access the currently selected message, meeting request, or appointment.
@@ -107352,6 +107354,39 @@ declare namespace PowerPoint {
          */
         readonly tags: PowerPoint.TagCollection;
         readonly title: string;
+        /**
+         * Returns the selected shapes in the current slide of the presentation.
+                    If no shapes are selected, an empty collection is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getSelectedShapes(): PowerPoint.ShapeScopedCollection;
+        /**
+         * Returns the selected slides in the current view of the presentation.
+                    The first item in the collection is the active slide that is visible in the editing area.
+                    If no slides are selected, an empty collection is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getSelectedSlides(): PowerPoint.SlideScopedCollection;
+        /**
+         * Returns the selected {@link PowerPoint.TextRange} in the current view of the presentation.
+                    Throws an exception if no text is selected.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getSelectedTextRange(): PowerPoint.TextRange;
+        /**
+         * Returns the selected {@link PowerPoint.TextRange} in the current view of the presentation.
+                    If no text is selected, an object with an `isNullObject` property set to `true` is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getSelectedTextRangeOrNullObject(): PowerPoint.TextRange;
         /**
          * Inserts the specified slides from a presentation into the current presentation.
          *
@@ -107362,6 +107397,15 @@ declare namespace PowerPoint {
          * @param options The options that define which slides will be inserted, where the new slides will go, and which presentation's formatting will be used.
          */
         insertSlidesFromBase64(base64File: string, options?: PowerPoint.InsertSlideOptions): void;
+        /**
+         * Selects the slides in the current view of the presentation. Existing slide selection is replaced with the new selection.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param slideIds List of slide IDs to select in the presentation. If the list is empty, selection is cleared.
+         */
+        setSelectedSlides(slideIds: string[]): void;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -109268,6 +109312,15 @@ declare namespace PowerPoint {
          * [Api set: PowerPointApi 1.2]
          */
         delete(): void;
+        /**
+         * Selects the specified shapes. Existing shape selection is replaced with the new selection.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param shapeIds List of shape IDs to select in the slide. If the list is empty, the selection is cleared.
+         */
+        setSelectedShapes(shapeIds: string[]): void;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -109935,6 +109988,22 @@ declare namespace PowerPoint {
          * [Api set: PowerPointApi 1.4]
          */
         readonly paragraphFormat: PowerPoint.ParagraphFormat;
+        /**
+         * Gets or sets the length of the range that this `TextRange` represents.
+                    Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the available text from the starting point.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        length: number;
+        /**
+         * Gets or sets zero-based index, relative to the parent text frame, for the starting position of the range that this `TextRange` represents.
+                    Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the text.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        start: number;
         /**
          * Represents the plain text content of the text range.
          *
@@ -109942,6 +110011,13 @@ declare namespace PowerPoint {
          * [Api set: PowerPointApi 1.4]
          */
         text: string;
+        /**
+         * Returns the parent {@link PowerPoint.TextFrame} object that holds this `TextRange`.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentTextFrame(): PowerPoint.TextFrame;
         /**
          * Returns a `TextRange` object for the substring in the given range.
          *
@@ -109952,6 +110028,13 @@ declare namespace PowerPoint {
          * @param length Optional. The number of characters to be returned in the new text range. If length is omitted, all the characters from start to the end of the text range's last paragraph will be returned.
          */
         getSubstring(start: number, length?: number): PowerPoint.TextRange;
+        /**
+         * Selects this `TextRange` in the current view.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        setSelected(): void;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -110058,6 +110141,13 @@ declare namespace PowerPoint {
          * [Api set: PowerPointApi 1.4]
          */
         deleteText(): void;
+        /**
+         * Returns the parent {@link PowerPoint.Shape} object that holds this `TextFrame`.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentShape(): PowerPoint.Shape;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -110178,6 +110268,48 @@ declare namespace PowerPoint {
          * [Api set: PowerPointApi 1.3]
          */
         delete(): void;
+        /**
+         * Returns the parent {@link PowerPoint.Slide} object that holds this `Shape`. Throws an exception if this shape does not belong to a `Slide`.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlide(): PowerPoint.Slide;
+        /**
+         * Returns the parent {@link PowerPoint.SlideLayout} object that holds this `Shape`. Throws an exception if this shape does not belong to a `SlideLayout`.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlideLayout(): PowerPoint.SlideLayout;
+        /**
+         * Returns the parent {@link PowerPoint.SlideLayout} object that holds this `Shape`. If this shape does not belong to a `SlideLayout`, an object with an `isNullObject` property set to `true` is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlideLayoutOrNullObject(): PowerPoint.SlideLayout;
+        /**
+         * Returns the parent {@link PowerPoint.SlideMaster} object that holds this `Shape`. Throws an exception if this shape does not belong to a `SlideMaster`.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlideMaster(): PowerPoint.SlideMaster;
+        /**
+         * Returns the parent {@link PowerPoint.SlideMaster} object that holds this `Shape`. If this shape does not belong to a `SlideMaster`, an object with an `isNullObject` property set to `true` is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlideMasterOrNullObject(): PowerPoint.SlideMaster;
+        /**
+         * Returns the parent {@link PowerPoint.Slide} object that holds this `Shape`. If this shape does not belong to a `Slide`, an object with an `isNullObject` property set to `true` is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         */
+        getParentSlideOrNullObject(): PowerPoint.Slide;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -110205,6 +110337,79 @@ declare namespace PowerPoint {
         */
         toJSON(): PowerPoint.Interfaces.ShapeData;
     }
+    /**
+     * Represents a collection of shapes.
+     *
+     * @remarks
+     * [Api set: PowerPointApi 1.5]
+     */
+    class ShapeScopedCollection 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 loaded child items in this collection. */
+        readonly items: PowerPoint.Shape[];
+        /**
+         * Gets the number of shapes in the collection.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         * @returns The number of shapes in the collection.
+         */
+        getCount(): OfficeExtension.ClientResult<number>;
+        /**
+         * Gets a shape using its unique ID. An error is thrown if the shape does not exist.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param key The ID of the shape.
+         * @returns The shape with the unique ID. If such a shape does not exist, an error is thrown.
+         */
+        getItem(key: string): PowerPoint.Shape;
+        /**
+         * Gets a shape using its zero-based index in the collection. An error is thrown if the index is out of range.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param index The index of the shape in the collection.
+         * @returns The shape at the given index. An error is thrown if index is out of range.
+         */
+        getItemAt(index: number): PowerPoint.Shape;
+        /**
+         * Gets a shape using its unique ID. If such a shape does not exist, an object with an `isNullObject` property set to true is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param id The ID of the shape.
+         * @returns The shape with the unique ID. If such a shape does not exist, an object with an `isNullObject` property set to true is returned.
+         */
+        getItemOrNullObject(id: string): PowerPoint.Shape;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param options Provides options for which properties of the object to load.
+         */
+        load(options?: PowerPoint.Interfaces.ShapeScopedCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.ShapeScopedCollection;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param propertyNames A comma-delimited string or an array of strings that specify the properties to load.
+         */
+        load(propertyNames?: string | string[]): PowerPoint.ShapeScopedCollection;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param propertyNamesAndPaths `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+         */
+        load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.ShapeScopedCollection;
+        /**
+        * 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 `PowerPoint.ShapeScopedCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.ShapeScopedCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        */
+        toJSON(): PowerPoint.Interfaces.ShapeScopedCollectionData;
+    }
     /**
      * Represents the collection of slides in the presentation.
      *
@@ -110290,6 +110495,81 @@ declare namespace PowerPoint {
         */
         toJSON(): PowerPoint.Interfaces.SlideCollectionData;
     }
+    /**
+     * Represents a collection of slides in the presentation.
+     *
+     * @remarks
+     * [Api set: PowerPointApi 1.5]
+     */
+    class SlideScopedCollection 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 loaded child items in this collection. */
+        readonly items: PowerPoint.Slide[];
+        /**
+         * Gets the number of slides in the collection.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         * @returns The number of slides in the collection.
+         */
+        getCount(): OfficeExtension.ClientResult<number>;
+        /**
+         * Gets a slide using its unique ID.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param key The ID of the slide.
+         * @returns The slide with the unique ID. If such a slide does not exist, an error is thrown.
+         */
+        getItem(key: string): PowerPoint.Slide;
+        /**
+         * Gets a slide using its zero-based index in the collection.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.5]
+         *
+         * @param index The index of the slide in the collection.
+         * @returns The slide at the given index. An error is thrown if index is out of range.
+         */
+        getItemAt(index: number): PowerPoint.Slide;
+        /**
+         * Gets a slide using its unique ID. If such a slide does not exist, an object with an `isNullObject` property set to true is returned. 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: PowerPointApi 1.5]
+         *
+         * @param id The ID of the slide.
+         * @returns The slide with the unique ID.
+         */
+        getItemOrNullObject(id: string): PowerPoint.Slide;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param options Provides options for which properties of the object to load.
+         */
+        load(options?: PowerPoint.Interfaces.SlideScopedCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.SlideScopedCollection;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param propertyNames A comma-delimited string or an array of strings that specify the properties to load.
+         */
+        load(propertyNames?: string | string[]): PowerPoint.SlideScopedCollection;
+        /**
+         * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
+         *
+         * @param propertyNamesAndPaths `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+         */
+        load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.SlideScopedCollection;
+        /**
+        * 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 `PowerPoint.SlideScopedCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideScopedCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        */
+        toJSON(): PowerPoint.Interfaces.SlideScopedCollectionData;
+    }
     /**
      * Represents the collection of Slide Masters in the presentation.
      *
@@ -110532,6 +110812,22 @@ declare namespace PowerPoint {
         }
         /** An interface for updating data on the TextRange object, for use in `textRange.set({ ... })`. */
         interface TextRangeUpdateData {
+            /**
+             * Gets or sets the length of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the available text from the starting point.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            length?: number;
+            /**
+             * Gets or sets zero-based index, relative to the parent text frame, for the starting position of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the text.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            start?: number;
             /**
              * Represents the plain text content of the text range.
              *
@@ -110630,10 +110926,18 @@ declare namespace PowerPoint {
              */
             width?: number;
         }
+        /** An interface for updating data on the ShapeScopedCollection object, for use in `shapeScopedCollection.set({ ... })`. */
+        interface ShapeScopedCollectionUpdateData {
+            items?: PowerPoint.Interfaces.ShapeData[];
+        }
         /** An interface for updating data on the SlideCollection object, for use in `slideCollection.set({ ... })`. */
         interface SlideCollectionUpdateData {
             items?: PowerPoint.Interfaces.SlideData[];
         }
+        /** An interface for updating data on the SlideScopedCollection object, for use in `slideScopedCollection.set({ ... })`. */
+        interface SlideScopedCollectionUpdateData {
+            items?: PowerPoint.Interfaces.SlideData[];
+        }
         /** An interface for updating data on the SlideMasterCollection object, for use in `slideMasterCollection.set({ ... })`. */
         interface SlideMasterCollectionUpdateData {
             items?: PowerPoint.Interfaces.SlideMasterData[];
@@ -110851,6 +111155,22 @@ declare namespace PowerPoint {
         }
         /** An interface describing the data returned by calling `textRange.toJSON()`. */
         interface TextRangeData {
+            /**
+             * Gets or sets the length of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the available text from the starting point.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            length?: number;
+            /**
+             * Gets or sets zero-based index, relative to the parent text frame, for the starting position of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the text.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            start?: number;
             /**
              * Represents the plain text content of the text range.
              *
@@ -110970,10 +111290,18 @@ declare namespace PowerPoint {
              */
             width?: number;
         }
+        /** An interface describing the data returned by calling `shapeScopedCollection.toJSON()`. */
+        interface ShapeScopedCollectionData {
+            items?: PowerPoint.Interfaces.ShapeData[];
+        }
         /** An interface describing the data returned by calling `slideCollection.toJSON()`. */
         interface SlideCollectionData {
             items?: PowerPoint.Interfaces.SlideData[];
         }
+        /** An interface describing the data returned by calling `slideScopedCollection.toJSON()`. */
+        interface SlideScopedCollectionData {
+            items?: PowerPoint.Interfaces.SlideData[];
+        }
         /** An interface describing the data returned by calling `slideMasterCollection.toJSON()`. */
         interface SlideMasterCollectionData {
             items?: PowerPoint.Interfaces.SlideMasterData[];
@@ -111445,6 +111773,22 @@ declare namespace PowerPoint {
             * [Api set: PowerPointApi 1.4]
             */
             paragraphFormat?: PowerPoint.Interfaces.ParagraphFormatLoadOptions;
+            /**
+             * Gets or sets the length of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the available text from the starting point.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            length?: boolean;
+            /**
+             * Gets or sets zero-based index, relative to the parent text frame, for the starting position of the range that this `TextRange` represents.
+                        Throws an `InvalidArgument` exception when set with a negative value or if the value is greater than the length of the text.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.5]
+             */
+            start?: boolean;
             /**
              * Represents the plain text content of the text range.
              *
@@ -111610,6 +111954,88 @@ declare namespace PowerPoint {
              */
             width?: boolean;
         }
+        /**
+         * Represents a collection of shapes.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        interface ShapeScopedCollectionLoadOptions {
+            /**
+              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;
+            /**
+            * For EACH ITEM in the collection: Returns the fill formatting of this shape.
+            *
+            * @remarks
+            * [Api set: PowerPointApi 1.4]
+            */
+            fill?: PowerPoint.Interfaces.ShapeFillLoadOptions;
+            /**
+            * For EACH ITEM in the collection: Returns the line formatting of this shape.
+            *
+            * @remarks
+            * [Api set: PowerPointApi 1.4]
+            */
+            lineFormat?: PowerPoint.Interfaces.ShapeLineFormatLoadOptions;
+            /**
+            * For EACH ITEM in the collection: Returns the text frame object of this shape.
+            *
+            * @remarks
+            * [Api set: PowerPointApi 1.4]
+            */
+            textFrame?: PowerPoint.Interfaces.TextFrameLoadOptions;
+            /**
+             * For EACH ITEM in the collection: Specifies the height, in points, of the shape. Throws an `InvalidArgument` exception when set with a negative value.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            height?: boolean;
+            /**
+             * For EACH ITEM in the collection: Gets the unique ID of the shape.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.3]
+             */
+            id?: boolean;
+            /**
+             * For EACH ITEM in the collection: The distance, in points, from the left side of the shape to the left side of the slide.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            left?: boolean;
+            /**
+             * For EACH ITEM in the collection: Specifies the name of this shape.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            name?: boolean;
+            /**
+             * For EACH ITEM in the collection: The distance, in points, from the top edge of the shape to the top edge of the slide.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            top?: boolean;
+            /**
+             * For EACH ITEM in the collection: Returns the type of this shape. See {@link PowerPoint.ShapeType} for details.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            type?: boolean;
+            /**
+             * For EACH ITEM in the collection: Specifies the width, in points, of the shape. Throws an `InvalidArgument` exception when set with a negative value.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.4]
+             */
+            width?: boolean;
+        }
         /**
          * Represents the collection of slides in the presentation.
          *
@@ -111643,6 +112069,39 @@ declare namespace PowerPoint {
              */
             id?: boolean;
         }
+        /**
+         * Represents a collection of slides in the presentation.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.2]
+         */
+        interface SlideScopedCollectionLoadOptions {
+            /**
+              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;
+            /**
+            * For EACH ITEM in the collection: Gets the layout of the slide.
+            *
+            * @remarks
+            * [Api set: PowerPointApi 1.3]
+            */
+            layout?: PowerPoint.Interfaces.SlideLayoutLoadOptions;
+            /**
+            * For EACH ITEM in the collection: Gets the `SlideMaster` object that represents the slide's default content.
+            *
+            * @remarks
+            * [Api set: PowerPointApi 1.3]
+            */
+            slideMaster?: PowerPoint.Interfaces.SlideMasterLoadOptions;
+            /**
+             * For EACH ITEM in the collection: Gets the unique ID of the slide.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.2]
+             */
+            id?: boolean;
+        }
         /**
          * Represents the collection of Slide Masters in the presentation.
          *

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.298",
+    "version": "1.0.300",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "3cc3ae1044d2d824b7de1cccfb14f4e06313475eb6a71e693399bd07b259a0d8",
+    "typesPublisherContentHash": "32d8fcf891e6875e382f4d6e9f7c71ea1539f43a67bd352b6c2081a1594be476",
     "typeScriptVersion": "4.1"
 }