@types/office-js 1.0.248 → 1.0.251

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, 19 Apr 2022 21:31:36 GMT
+ * Last updated: Wed, 04 May 2022 00:01:36 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js/index.d.ts

@@ -1850,7 +1850,7 @@ declare namespace Office {
      * 
      * **Hosts**: Excel, Outlook (in preview), PowerPoint, Word
      * 
-     * `OfficeTheme` is only supported in Office on Windows.
+     * `OfficeTheme` is only supported in Office on Windows, Mac, and the web.
      */
     interface OfficeTheme {
         /**
@@ -13980,7 +13980,7 @@ declare namespace Office {
          *
          * The add-in should use the `ewsUrl` property to determine the correct URL to use when making EWS calls.
          *
-         * You can pass both the token and either an attachment identifier or item identifier to a third-party system. The third-party system uses
+         * You can pass both the token and either an attachment identifier or item identifier to an external system. That system uses
          * the token as a bearer authorization token to call the Exchange Web Services (EWS)
          * {@link https://docs.microsoft.com/exchange/client-developer/web-service-reference/getattachment-operation | GetAttachment} operation or
          * {@link https://docs.microsoft.com/exchange/client-developer/web-service-reference/getitem-operation | GetItem} operation to return an
@@ -14020,7 +14020,7 @@ declare namespace Office {
          *
          * The token is returned as a string in the `asyncResult.value` property.
          *
-         * You can pass both the token and either an attachment identifier or item identifier to a third-party system. The third-party system uses
+         * You can pass both the token and either an attachment identifier or item identifier to an external system. That system uses
          * the token as a bearer authorization token to call the Exchange Web Services (EWS)
          * {@link https://docs.microsoft.com/exchange/client-developer/web-service-reference/getattachment-operation | GetAttachment} operation or
          * {@link https://docs.microsoft.com/exchange/client-developer/web-service-reference/getitem-operation | GetItem} operation to return an
@@ -14068,7 +14068,7 @@ declare namespace Office {
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
          *
          * The `getUserIdentityTokenAsync` method returns a token that you can use to identify and 
-         * {@link https://docs.microsoft.com/office/dev/add-ins/outlook/authentication | authenticate the add-in and user with a third-party system}.
+         * {@link https://docs.microsoft.com/office/dev/add-ins/outlook/authentication | authenticate the add-in and user with an external system}.
          *
          * **Errors**:
          * 
@@ -96990,189 +96990,120 @@ declare namespace PowerPoint {
         targetSlideId?: string;
     }
     /**
-     * Represents a single tag in the slide.
-     *
-     * @remarks
-     * [Api set: PowerPointApi 1.3]
-     */
-    class Tag 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 unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         */
-        readonly key: string;
-        /**
-         * Gets the value of the tag.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         */
-        value: string;
-        /**
-         * 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.TagLoadOptions): PowerPoint.Tag;
-        /**
-         * 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.Tag;
-        /**
-         * 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?: {
-            select?: string;
-            expand?: string;
-        }): PowerPoint.Tag;
-        /**
-        * 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.Tag object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.TagData`) that contains shallow copies of any loaded child properties from the original object.
-        */
-        toJSON(): PowerPoint.Interfaces.TagData;
-    }
-    /**
-     * Represents the collection of tags.
+     * Represents the collection of shapes.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class TagCollection extends OfficeExtension.ClientObject {
+    class ShapeCollection 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.Tag[];
-        /**
-         * Adds a new tag at the end of the collection. If the `key` already exists in the collection, the value of the existing tag will be replaced with the given `value`.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         *
-         * @param key The unique ID of a tag, which is unique within this `TagCollection`. 'key' parameter is case-insensitive, but it is always capitalized when saved in the document.
-         * @param value The value of the tag.
-         */
-        add(key: string, value: string): void;
-        /**
-         * Deletes the tag with the given `key` in this collection. Does nothing if the `key` does not exist.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         *
-         * @param key The unique ID of a tag, which is unique within this `TagCollection`. `key` parameter is case-insensitive.
-         */
-        delete(key: string): void;
+        readonly items: PowerPoint.Shape[];
         /**
-         * Gets the number of tags in the collection.
+         * Gets the number of shapes in the collection.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
-         * @returns The number of tags in the collection.
+         * @returns The number of shapes in the collection.
          */
         getCount(): OfficeExtension.ClientResult<number>;
         /**
-         * Gets a tag using its unique ID. An error is thrown if the tag does not exist.
+         * Gets a shape using its unique ID. An error is thrown if the shape does not exist.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          *
-         * @param key The ID of the tag.
-         * @returns The tag with the unique ID. If such a tag does not exist, an error is thrown.
+         * @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.Tag;
+        getItem(key: string): PowerPoint.Shape;
         /**
-         * Gets a tag using its zero-based index in the collection. An error is thrown if the index is out of range.
+         * 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.3]
          *
-         * @param index The index of the tag in the collection.
-         * @returns The tag at the given index. An error is thrown if index is out of range.
+         * @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.Tag;
+        getItemAt(index: number): PowerPoint.Shape;
         /**
-         * Gets a tag using its unique ID. If such a tag does not exist, an object with an `isNullObject` property set to true is returned.
+         * 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.3]
          *
-         * @param key The ID of the tag.
-         * @returns The tag with the unique ID. If such a tag does not exist, an object with an `isNullObject` property set to true is returned.
+         * @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(key: string): PowerPoint.Tag;
+        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.TagCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.TagCollection;
+        load(options?: PowerPoint.Interfaces.ShapeCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.ShapeCollection;
         /**
          * 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.TagCollection;
+        load(propertyNames?: string | string[]): PowerPoint.ShapeCollection;
         /**
          * 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.TagCollection;
+        load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.ShapeCollection;
         /**
         * 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.TagCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.TagCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        * Whereas the original `PowerPoint.ShapeCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.ShapeCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
         */
-        toJSON(): PowerPoint.Interfaces.TagCollectionData;
+        toJSON(): PowerPoint.Interfaces.ShapeCollectionData;
     }
     /**
-     * Represents a single shape in the slide.
+     * Represents the layout of a slide.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class Shape extends OfficeExtension.ClientObject {
+    class SlideLayout 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;
         /**
-         * Returns a collection of tags in the shape.
+         * Returns a collection of shapes in the slide layout.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        readonly tags: PowerPoint.TagCollection;
+        readonly shapes: PowerPoint.ShapeCollection;
         /**
-         * Gets the unique ID of the shape.
+         * Gets the unique ID of the slide layout.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
         readonly id: string;
         /**
-         * Deletes the shape from the shape collection. Does nothing if the shape does not exist.
+         * Gets the name of the slide layout.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        delete(): void;
+        readonly name: string;
         /**
          * 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.ShapeLoadOptions): PowerPoint.Shape;
+        load(options?: PowerPoint.Interfaces.SlideLayoutLoadOptions): PowerPoint.SlideLayout;
         /**
          * 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.Shape;
+        load(propertyNames?: string | string[]): PowerPoint.SlideLayout;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -97181,111 +97112,119 @@ declare namespace PowerPoint {
         load(propertyNamesAndPaths?: {
             select?: string;
             expand?: string;
-        }): PowerPoint.Shape;
+        }): PowerPoint.SlideLayout;
         /**
         * 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.Shape object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.ShapeData`) that contains shallow copies of any loaded child properties from the original object.
+        * Whereas the original PowerPoint.SlideLayout object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideLayoutData`) that contains shallow copies of any loaded child properties from the original object.
         */
-        toJSON(): PowerPoint.Interfaces.ShapeData;
+        toJSON(): PowerPoint.Interfaces.SlideLayoutData;
     }
     /**
-     * Represents the collection of shapes.
+     * Represents the collection of layouts provided by the Slide Master for slides.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class ShapeCollection extends OfficeExtension.ClientObject {
+    class SlideLayoutCollection 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[];
+        readonly items: PowerPoint.SlideLayout[];
         /**
-         * Gets the number of shapes in the collection.
+         * Gets the number of layouts in the collection.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
-         * @returns The number of shapes in the collection.
+         * @returns The number of layouts in the collection.
          */
         getCount(): OfficeExtension.ClientResult<number>;
         /**
-         * Gets a shape using its unique ID. An error is thrown if the shape does not exist.
+         * Gets a layout using its unique ID.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          *
-         * @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.
+         * @param key The ID of the layout.
+         * @returns The layout with the unique ID. If such a layout does not exist, an error is thrown.
          */
-        getItem(key: string): PowerPoint.Shape;
+        getItem(key: string): PowerPoint.SlideLayout;
         /**
-         * Gets a shape using its zero-based index in the collection. An error is thrown if the index is out of range.
+         * Gets a layout using its zero-based index in the collection.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          *
-         * @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.
+         * @param index The index of the layout in the collection.
+         * @returns The layout at the given index. An error is thrown if index is out of range.
          */
-        getItemAt(index: number): PowerPoint.Shape;
+        getItemAt(index: number): PowerPoint.SlideLayout;
         /**
-         * 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.
+         * Gets a layout using its unique ID.  If such a layout 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.3]
          *
-         * @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.
+         * @param id The ID of the layout.
+         * @returns The layout with the unique ID.
          */
-        getItemOrNullObject(id: string): PowerPoint.Shape;
+        getItemOrNullObject(id: string): PowerPoint.SlideLayout;
         /**
          * 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.ShapeCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.ShapeCollection;
+        load(options?: PowerPoint.Interfaces.SlideLayoutCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.SlideLayoutCollection;
         /**
          * 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.ShapeCollection;
+        load(propertyNames?: string | string[]): PowerPoint.SlideLayoutCollection;
         /**
          * 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.ShapeCollection;
+        load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.SlideLayoutCollection;
         /**
         * 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.ShapeCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.ShapeCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        * Whereas the original `PowerPoint.SlideLayoutCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideLayoutCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
         */
-        toJSON(): PowerPoint.Interfaces.ShapeCollectionData;
+        toJSON(): PowerPoint.Interfaces.SlideLayoutCollectionData;
     }
     /**
-     * Represents the layout of a slide.
+     * Represents the Slide Master of a slide.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class SlideLayout extends OfficeExtension.ClientObject {
+    class SlideMaster 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;
         /**
-         * Returns a collection of shapes in the slide layout.
+         * Gets the collection of layouts provided by the Slide Master for slides.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        readonly layouts: PowerPoint.SlideLayoutCollection;
+        /**
+         * Returns a collection of shapes in the Slide Master.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
         readonly shapes: PowerPoint.ShapeCollection;
         /**
-         * Gets the unique ID of the slide layout.
+         * Gets the unique ID of the Slide Master.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
         readonly id: string;
         /**
-         * Gets the name of the slide layout.
+         * Gets the unique name of the Slide Master.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
@@ -97296,13 +97235,13 @@ declare namespace PowerPoint {
          *
          * @param options Provides options for which properties of the object to load.
          */
-        load(options?: PowerPoint.Interfaces.SlideLayoutLoadOptions): PowerPoint.SlideLayout;
+        load(options?: PowerPoint.Interfaces.SlideMasterLoadOptions): PowerPoint.SlideMaster;
         /**
          * 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.SlideLayout;
+        load(propertyNames?: string | string[]): PowerPoint.SlideMaster;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -97311,150 +97250,154 @@ declare namespace PowerPoint {
         load(propertyNamesAndPaths?: {
             select?: string;
             expand?: string;
-        }): PowerPoint.SlideLayout;
+        }): PowerPoint.SlideMaster;
         /**
         * 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.SlideLayout object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideLayoutData`) that contains shallow copies of any loaded child properties from the original object.
+        * Whereas the original PowerPoint.SlideMaster object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideMasterData`) that contains shallow copies of any loaded child properties from the original object.
         */
-        toJSON(): PowerPoint.Interfaces.SlideLayoutData;
+        toJSON(): PowerPoint.Interfaces.SlideMasterData;
     }
     /**
-     * Represents the collection of layouts provided by the Slide Master for slides.
+     * Represents a single tag in the slide.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class SlideLayoutCollection extends OfficeExtension.ClientObject {
+    class Tag 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.SlideLayout[];
-        /**
-         * Gets the number of layouts in the collection.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         * @returns The number of layouts in the collection.
-         */
-        getCount(): OfficeExtension.ClientResult<number>;
         /**
-         * Gets a layout using its unique ID.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         *
-         * @param key The ID of the layout.
-         * @returns The layout with the unique ID. If such a layout does not exist, an error is thrown.
-         */
-        getItem(key: string): PowerPoint.SlideLayout;
-        /**
-         * Gets a layout using its zero-based index in the collection.
+         * Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
-         *
-         * @param index The index of the layout in the collection.
-         * @returns The layout at the given index. An error is thrown if index is out of range.
          */
-        getItemAt(index: number): PowerPoint.SlideLayout;
+        readonly key: string;
         /**
-         * Gets a layout using its unique ID.  If such a layout 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}.
+         * Gets the value of the tag.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
-         *
-         * @param id The ID of the layout.
-         * @returns The layout with the unique ID.
          */
-        getItemOrNullObject(id: string): PowerPoint.SlideLayout;
+        value: string;
         /**
          * 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.SlideLayoutCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.SlideLayoutCollection;
+        load(options?: PowerPoint.Interfaces.TagLoadOptions): PowerPoint.Tag;
         /**
          * 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.SlideLayoutCollection;
+        load(propertyNames?: string | string[]): PowerPoint.Tag;
         /**
          * 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.SlideLayoutCollection;
+        load(propertyNamesAndPaths?: {
+            select?: string;
+            expand?: string;
+        }): PowerPoint.Tag;
         /**
         * 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.SlideLayoutCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideLayoutCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        * Whereas the original PowerPoint.Tag object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.TagData`) that contains shallow copies of any loaded child properties from the original object.
         */
-        toJSON(): PowerPoint.Interfaces.SlideLayoutCollectionData;
+        toJSON(): PowerPoint.Interfaces.TagData;
     }
     /**
-     * Represents the Slide Master of a slide.
+     * Represents the collection of tags.
      *
      * @remarks
      * [Api set: PowerPointApi 1.3]
      */
-    class SlideMaster extends OfficeExtension.ClientObject {
+    class TagCollection 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.Tag[];
         /**
-         * Gets the collection of layouts provided by the Slide Master for slides.
+         * Adds a new tag at the end of the collection. If the `key` already exists in the collection, the value of the existing tag will be replaced with the given `value`.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
+         *
+         * @param key The unique ID of a tag, which is unique within this `TagCollection`. 'key' parameter is case-insensitive, but it is always capitalized when saved in the document.
+         * @param value The value of the tag.
          */
-        readonly layouts: PowerPoint.SlideLayoutCollection;
+        add(key: string, value: string): void;
         /**
-         * Returns a collection of shapes in the Slide Master.
+         * Deletes the tag with the given `key` in this collection. Does nothing if the `key` does not exist.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
+         *
+         * @param key The unique ID of a tag, which is unique within this `TagCollection`. `key` parameter is case-insensitive.
          */
-        readonly shapes: PowerPoint.ShapeCollection;
+        delete(key: string): void;
         /**
-         * Gets the unique ID of the Slide Master.
+         * Gets the number of tags in the collection.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
+         * @returns The number of tags in the collection.
          */
-        readonly id: string;
+        getCount(): OfficeExtension.ClientResult<number>;
         /**
-         * Gets the unique name of the Slide Master.
+         * Gets a tag using its unique ID. An error is thrown if the tag does not exist.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
+         *
+         * @param key The ID of the tag.
+         * @returns The tag with the unique ID. If such a tag does not exist, an error is thrown.
          */
-        readonly name: string;
+        getItem(key: string): PowerPoint.Tag;
+        /**
+         * Gets a tag using its zero-based index in the collection. An error is thrown if the index is out of range.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         *
+         * @param index The index of the tag in the collection.
+         * @returns The tag at the given index. An error is thrown if index is out of range.
+         */
+        getItemAt(index: number): PowerPoint.Tag;
+        /**
+         * Gets a tag using its unique ID. If such a tag does not exist, an object with an `isNullObject` property set to true is returned.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         *
+         * @param key The ID of the tag.
+         * @returns The tag with the unique ID. If such a tag does not exist, an object with an `isNullObject` property set to true is returned.
+         */
+        getItemOrNullObject(key: string): PowerPoint.Tag;
         /**
          * 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.SlideMasterLoadOptions): PowerPoint.SlideMaster;
+        load(options?: PowerPoint.Interfaces.TagCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.TagCollection;
         /**
          * 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.SlideMaster;
+        load(propertyNames?: string | string[]): PowerPoint.TagCollection;
         /**
          * 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?: {
-            select?: string;
-            expand?: string;
-        }): PowerPoint.SlideMaster;
+        load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.TagCollection;
         /**
         * 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.SlideMaster object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.SlideMasterData`) that contains shallow copies of any loaded child properties from the original object.
+        * Whereas the original `PowerPoint.TagCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.TagCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
         */
-        toJSON(): PowerPoint.Interfaces.SlideMasterData;
+        toJSON(): PowerPoint.Interfaces.TagCollectionData;
     }
     /**
      * Represents a single slide of a presentation.
@@ -97534,6 +97477,63 @@ declare namespace PowerPoint {
         */
         toJSON(): PowerPoint.Interfaces.SlideData;
     }
+    /**
+     * Represents a single shape in the slide.
+     *
+     * @remarks
+     * [Api set: PowerPointApi 1.3]
+     */
+    class Shape 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;
+        /**
+         * Returns a collection of tags in the shape.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        readonly tags: PowerPoint.TagCollection;
+        /**
+         * Gets the unique ID of the shape.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        readonly id: string;
+        /**
+         * Deletes the shape from the shape collection. Does nothing if the shape does not exist.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        delete(): void;
+        /**
+         * 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.ShapeLoadOptions): PowerPoint.Shape;
+        /**
+         * 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.Shape;
+        /**
+         * 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?: {
+            select?: string;
+            expand?: string;
+        }): PowerPoint.Shape;
+        /**
+        * 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.Shape object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `PowerPoint.Interfaces.ShapeData`) that contains shallow copies of any loaded child properties from the original object.
+        */
+        toJSON(): PowerPoint.Interfaces.ShapeData;
+    }
     /**
      * Represents the collection of slides in the presentation.
      *
@@ -97710,6 +97710,14 @@ declare namespace PowerPoint {
             */
             $skip?: number;
         }
+        /** An interface for updating data on the ShapeCollection object, for use in `shapeCollection.set({ ... })`. */
+        interface ShapeCollectionUpdateData {
+            items?: PowerPoint.Interfaces.ShapeData[];
+        }
+        /** An interface for updating data on the SlideLayoutCollection object, for use in `slideLayoutCollection.set({ ... })`. */
+        interface SlideLayoutCollectionUpdateData {
+            items?: PowerPoint.Interfaces.SlideLayoutData[];
+        }
         /** An interface for updating data on the Tag object, for use in `tag.set({ ... })`. */
         interface TagUpdateData {
             /**
@@ -97724,14 +97732,6 @@ declare namespace PowerPoint {
         interface TagCollectionUpdateData {
             items?: PowerPoint.Interfaces.TagData[];
         }
-        /** An interface for updating data on the ShapeCollection object, for use in `shapeCollection.set({ ... })`. */
-        interface ShapeCollectionUpdateData {
-            items?: PowerPoint.Interfaces.ShapeData[];
-        }
-        /** An interface for updating data on the SlideLayoutCollection object, for use in `slideLayoutCollection.set({ ... })`. */
-        interface SlideLayoutCollectionUpdateData {
-            items?: PowerPoint.Interfaces.SlideLayoutData[];
-        }
         /** An interface for updating data on the SlideCollection object, for use in `slideCollection.set({ ... })`. */
         interface SlideCollectionUpdateData {
             items?: PowerPoint.Interfaces.SlideData[];
@@ -97744,37 +97744,6 @@ declare namespace PowerPoint {
         interface PresentationData {
             title?: string;
         }
-        /** An interface describing the data returned by calling `tag.toJSON()`. */
-        interface TagData {
-            /**
-             * Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
-             *
-             * @remarks
-             * [Api set: PowerPointApi 1.3]
-             */
-            key?: string;
-            /**
-             * Gets the value of the tag.
-             *
-             * @remarks
-             * [Api set: PowerPointApi 1.3]
-             */
-            value?: string;
-        }
-        /** An interface describing the data returned by calling `tagCollection.toJSON()`. */
-        interface TagCollectionData {
-            items?: PowerPoint.Interfaces.TagData[];
-        }
-        /** An interface describing the data returned by calling `shape.toJSON()`. */
-        interface ShapeData {
-            /**
-             * Gets the unique ID of the shape.
-             *
-             * @remarks
-             * [Api set: PowerPointApi 1.3]
-             */
-            id?: string;
-        }
         /** An interface describing the data returned by calling `shapeCollection.toJSON()`. */
         interface ShapeCollectionData {
             items?: PowerPoint.Interfaces.ShapeData[];
@@ -97817,6 +97786,27 @@ declare namespace PowerPoint {
              */
             name?: string;
         }
+        /** An interface describing the data returned by calling `tag.toJSON()`. */
+        interface TagData {
+            /**
+             * Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.3]
+             */
+            key?: string;
+            /**
+             * Gets the value of the tag.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.3]
+             */
+            value?: string;
+        }
+        /** An interface describing the data returned by calling `tagCollection.toJSON()`. */
+        interface TagCollectionData {
+            items?: PowerPoint.Interfaces.TagData[];
+        }
         /** An interface describing the data returned by calling `slide.toJSON()`. */
         interface SlideData {
             /**
@@ -97827,6 +97817,16 @@ declare namespace PowerPoint {
              */
             id?: string;
         }
+        /** An interface describing the data returned by calling `shape.toJSON()`. */
+        interface ShapeData {
+            /**
+             * Gets the unique ID of the shape.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.3]
+             */
+            id?: string;
+        }
         /** An interface describing the data returned by calling `slideCollection.toJSON()`. */
         interface SlideCollectionData {
             items?: PowerPoint.Interfaces.SlideData[];
@@ -97847,115 +97847,96 @@ declare namespace PowerPoint {
             title?: boolean;
         }
         /**
-         * Represents a single tag in the slide.
+         * Represents the collection of shapes.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface TagLoadOptions {
+        interface ShapeCollectionLoadOptions {
             /**
               Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
              */
             $all?: boolean;
             /**
-             * Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
-             *
-             * @remarks
-             * [Api set: PowerPointApi 1.3]
-             */
-            key?: boolean;
-            /**
-             * Gets the value of the tag.
+             * For EACH ITEM in the collection: Gets the unique ID of the shape.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            value?: boolean;
+            id?: boolean;
         }
         /**
-         * Represents the collection of tags.
+         * Represents the layout of a slide.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface TagCollectionLoadOptions {
+        interface SlideLayoutLoadOptions {
             /**
               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 unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
+             * Gets the unique ID of the slide layout.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            key?: boolean;
+            id?: boolean;
             /**
-             * For EACH ITEM in the collection: Gets the value of the tag.
+             * Gets the name of the slide layout.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            value?: boolean;
+            name?: boolean;
         }
         /**
-         * Represents a single shape in the slide.
+         * Represents the collection of layouts provided by the Slide Master for slides.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface ShapeLoadOptions {
+        interface SlideLayoutCollectionLoadOptions {
             /**
               Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
              */
             $all?: boolean;
             /**
-             * Gets the unique ID of the shape.
+             * For EACH ITEM in the collection: Gets the unique ID of the slide layout.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
             id?: boolean;
-        }
-        /**
-         * Represents the collection of shapes.
-         *
-         * @remarks
-         * [Api set: PowerPointApi 1.3]
-         */
-        interface ShapeCollectionLoadOptions {
             /**
-              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 unique ID of the shape.
+             * For EACH ITEM in the collection: Gets the name of the slide layout.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            id?: boolean;
+            name?: boolean;
         }
         /**
-         * Represents the layout of a slide.
+         * Represents the Slide Master of a slide.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface SlideLayoutLoadOptions {
+        interface SlideMasterLoadOptions {
             /**
               Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
              */
             $all?: boolean;
             /**
-             * Gets the unique ID of the slide layout.
+             * Gets the unique ID of the Slide Master.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
             id?: boolean;
             /**
-             * Gets the name of the slide layout.
+             * Gets the unique name of the Slide Master.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
@@ -97963,56 +97944,56 @@ declare namespace PowerPoint {
             name?: boolean;
         }
         /**
-         * Represents the collection of layouts provided by the Slide Master for slides.
+         * Represents a single tag in the slide.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface SlideLayoutCollectionLoadOptions {
+        interface TagLoadOptions {
             /**
               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 unique ID of the slide layout.
+             * Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            id?: boolean;
+            key?: boolean;
             /**
-             * For EACH ITEM in the collection: Gets the name of the slide layout.
+             * Gets the value of the tag.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            name?: boolean;
+            value?: boolean;
         }
         /**
-         * Represents the Slide Master of a slide.
+         * Represents the collection of tags.
          *
          * @remarks
          * [Api set: PowerPointApi 1.3]
          */
-        interface SlideMasterLoadOptions {
+        interface TagCollectionLoadOptions {
             /**
               Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
              */
             $all?: boolean;
             /**
-             * Gets the unique ID of the Slide Master.
+             * For EACH ITEM in the collection: Gets the unique ID of the tag. The `key` is unique within the owning `TagCollection` and always stored as uppercase letters within the document.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            id?: boolean;
+            key?: boolean;
             /**
-             * Gets the unique name of the Slide Master.
+             * For EACH ITEM in the collection: Gets the value of the tag.
              *
              * @remarks
              * [Api set: PowerPointApi 1.3]
              */
-            name?: boolean;
+            value?: boolean;
         }
         /**
          * Represents a single slide of a presentation.
@@ -98047,6 +98028,25 @@ declare namespace PowerPoint {
              */
             id?: boolean;
         }
+        /**
+         * Represents a single shape in the slide.
+         *
+         * @remarks
+         * [Api set: PowerPointApi 1.3]
+         */
+        interface ShapeLoadOptions {
+            /**
+              Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`) but not the navigational properties (e.g.: `Range.format.fill.color`).
+             */
+            $all?: boolean;
+            /**
+             * Gets the unique ID of the shape.
+             *
+             * @remarks
+             * [Api set: PowerPointApi 1.3]
+             */
+            id?: boolean;
+        }
         /**
          * Represents the collection of slides in the presentation.
          *

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.248",
+    "version": "1.0.251",
     "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": "86dfb3a483d4cdf29d56e97e62496931c4a064a465dfc49469b5b4469d0a9d61",
+    "typesPublisherContentHash": "ce8af17effe1ba31c7fa40afa18085a4a2b722db7f20d88f36e7d3e9de4968dd",
     "typeScriptVersion": "3.9"
 }