@types/office-js-preview 1.0.330 → 1.0.332

office-js-preview/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Office.js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
 
 ### Additional Details
- * Last updated: Fri, 02 Sep 2022 20:32:40 GMT
+ * Last updated: Tue, 13 Sep 2022 18:26:27 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -1048,14 +1048,14 @@ declare namespace Office {
     }
     namespace AddinCommands {
         /**
-         * The `Event` object is passed as a parameter to add-in functions invoked by UI-less command buttons. The object allows the add-in to identify
+         * The `Event` object is passed as a parameter to add-in functions invoked by function command buttons. The object allows the add-in to identify
          * which button was clicked and to signal the host that it has completed its processing.
          *
          * @remarks
          *
          * See {@link https://docs.microsoft.com/javascript/api/requirement-sets/common/add-in-commands-requirement-sets | Add-in commands requirement sets} for more support information.
          *
-         * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level (Outlook)}**: Restricted
+         * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level (Outlook)}**: `Restricted`
          *
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
          */
@@ -1072,18 +1072,20 @@ declare namespace Office {
             /**
              * Indicates that the add-in has completed processing and will automatically be closed.
              *
-             * This method must be called at the end of a function which was invoked by the following.
+             * This method must be called at the end of a function which was invoked by the following:
              *
-             * - A UI-less button (i.e., an add-in command defined with an `Action` element where the `xsi:type` attribute is set to `ExecuteFunction`)
+             * - A function command button (that is, an add-in command defined with an `Action` element, where the `xsi:type` attribute is set to `ExecuteFunction`).
              *
+             * - An event defined in the {@link https://docs.microsoft.com/javascript/api/manifest/extensionpoint#launchevent | LaunchEvent extension point}.
+             * For example, an `OnMessageSend` event. 
+             * 
              * - An {@link https://docs.microsoft.com/javascript/api/manifest/event | event} defined in the
-             * {@link https://docs.microsoft.com/javascript/api/manifest/extensionpoint#events | Events extension point},
-             * e.g., an `ItemSend` event
-             *
-             * [Api set: Mailbox 1.3]
+             * {@link https://docs.microsoft.com/javascript/api/manifest/extensionpoint#events | Events extension point}. For example, an `ItemSend` event.
              *
              * @remarks
              *
+             * [Api set: Mailbox 1.3]
+             * 
              * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `Restricted`
              *
              * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
@@ -1100,20 +1102,35 @@ declare namespace Office {
          */
         interface EventCompletedOptions {
             /**
-             * When the completed method is used to signal completion of an event handler,
-             * this value indicates if the handled event should continue execution or be canceled.
-             * For example, an add-in that handles the `ItemSend` event can set `allowEvent` to `false` to cancel sending of the message.
+             * When the {@link https://docs.microsoft.com/javascript/api/office/office.addincommands.event#office-office-addincommands-event-completed-member(1) | completed method}
+             * is used to signal completion of an event handler, this value indicates if the handled event should continue execution or be canceled.
+             * For example, an add-in that handles the `OnMessageSend` or `OnAppointmentSend` event can set `allowEvent` to `false` to cancel the
+             * sending of an item. For a complete sample, see the
+             * {@link https://docs.microsoft.com/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough | Smart Alerts walkthrough}.
+             * 
+             * @remarks
+             *
+             * [Api set: Mailbox 1.8]
+             * 
+             * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level (Outlook)}**: `Restricted`
+             *
+             * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
              */
             allowEvent: boolean;
 
             /**
-             * When the completed method is used to signal completion of an event handler and if the `allowEvent` option is set to `false`,
-             * this value sets the error message that will be displayed to the user. For an example, refer to the 
+             * When the {@link https://docs.microsoft.com/javascript/api/office/office.addincommands.event#office-office-addincommands-event-completed-member(1) | completed method}
+             * is used to signal completion of an event handler and if the `allowEvent` option is set to `false`, this value sets the error message
+             * that will be displayed to the user. For an example, see the  
              * {@link https://docs.microsoft.com/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough | Smart Alerts walkthrough}.
+             *
+             * @remarks
              * 
-             * [Api set: Mailbox preview]
+             * [Api set: Mailbox 1.12]
+             * 
+             * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level (Outlook)}**: `Restricted`
              *
-             * @beta
+             * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
              */
             errorMessage?: string;
         }
@@ -83823,16 +83840,7 @@ declare namespace Word {
          *
          * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
          */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Gets the whole body, or the starting or ending point of the body, as a range.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
-         */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | Word.RangeLocation.content | "Whole" | "Start" | "End" | "After" | "Content"): Word.Range;
         /**
          * Gets reviewed text based on ChangeTrackingVersion selection.
          *
@@ -83860,17 +83868,7 @@ declare namespace Word {
          * @param breakType Required. The break type to add to the body.
          * @param insertLocation Required. The value must be 'Start' or 'End'.
          */
-        insertBreak(breakType: Word.BreakType, insertLocation: Word.InsertLocation): void;
-        /**
-         * Inserts a break at the specified location in the main document.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param breakType Required. The break type to add to the body.
-         * @param insertLocation Required. The value must be 'Start' or 'End'.
-         */
-        insertBreak(breakType: "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): void;
+        insertBreak(breakType: Word.BreakType | "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End"): void;
         /**
          * Wraps the body object with a Rich Text content control.
          *
@@ -83887,17 +83885,7 @@ declare namespace Word {
          * @param base64File Required. The base64 encoded content of a .docx file.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts a document into the body at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param base64File Required. The base64 encoded content of a .docx file.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertFileFromBase64(base64File: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts HTML at the specified location.
          *
@@ -83907,27 +83895,7 @@ declare namespace Word {
          * @param html Required. The HTML to be inserted in the document.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertHtml(html: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts HTML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param html Required. The HTML to be inserted in the document.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertHtml(html: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts a picture into the body at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param base64EncodedImage Required. The base64 encoded image to be inserted in the body.
-         * @param insertLocation Required. The value must be 'Start' or 'End'.
-         */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation): Word.InlinePicture;
+        insertHtml(html: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts a picture into the body at the specified location.
          *
@@ -83937,7 +83905,7 @@ declare namespace Word {
          * @param base64EncodedImage Required. The base64 encoded image to be inserted in the body.
          * @param insertLocation Required. The value must be 'Start' or 'End'.
          */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.InlinePicture;
+        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End"): Word.InlinePicture;
         /**
          * Inserts OOXML at the specified location.
          *
@@ -83947,17 +83915,7 @@ declare namespace Word {
          * @param ooxml Required. The OOXML to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts OOXML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param ooxml Required. The OOXML to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertOoxml(ooxml: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts a paragraph at the specified location.
          *
@@ -83967,17 +83925,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Start' or 'End'.
          */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Start' or 'End'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End"): Word.Paragraph;
         /**
          * Inserts a table with the specified number of rows and columns.
          *
@@ -83989,29 +83937,7 @@ declare namespace Word {
          * @param insertLocation Required. The value must be 'Start' or 'End'.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation, values?: string[][]): Word.Table;
-        /**
-         * Inserts a table with the specified number of rows and columns.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rowCount Required. The number of rows in the table.
-         * @param columnCount Required. The number of columns in the table.
-         * @param insertLocation Required. The value must be 'Start' or 'End'.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertTable(rowCount: number, columnCount: number, insertLocation: "Before" | "After" | "Start" | "End" | "Replace", values?: string[][]): Word.Table;
-        /**
-         * Inserts text into the body at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param text Required. Text to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.Range;
+        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", values?: string[][]): Word.Table;
         /**
          * Inserts text into the body at the specified location.
          *
@@ -84021,7 +83947,7 @@ declare namespace Word {
          * @param text Required. Text to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertText(text: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Performs a search with the specified SearchOptions on the scope of the body object. The search results are a collection of range objects.
          *
@@ -84249,15 +84175,6 @@ declare namespace Word {
          * [Api set: WordApiOnline 1.1]
          */
         getFirstOrNullObject(): Word.Comment;
-        /**
-         * Gets a comment object by its index in the collection.
-         *
-         * @remarks
-         * [Api set: WordApiOnline 1.1]
-         *
-         * @param index A number that identifies the index location of a comment object.
-         */
-        getItem(index: number): Word.Comment;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -84361,19 +84278,9 @@ declare namespace Word {
          * [Api set: WordApiOnline 1.1]
          *
          * @param text Required. The text to be inserted in to the CommentContentRange.
-         * @param insertLocation Required. The value must be 'After', 'Before', 'Replace', 'Start', or 'End'.
-         */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.CommentContentRange;
-        /**
-         * Inserts text into at the specified location. **Note**: For the modern comment, the content range tracked across context turns to empty if any revision to the comment is posted through the UI.
-         *
-         * @remarks
-         * [Api set: WordApiOnline 1.1]
-         *
-         * @param text Required. The text to be inserted in to the CommentContentRange.
-         * @param insertLocation Required. The value must be 'After', 'Before', 'Replace', 'Start', or 'End'.
+         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.CommentContentRange;
+        insertText(text: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.CommentContentRange;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -84542,15 +84449,6 @@ declare namespace Word {
          * [Api set: WordApiOnline 1.1]
          */
         getFirstOrNullObject(): Word.CommentReply;
-        /**
-         * Gets a comment reply object by its index in the collection.
-         *
-         * @remarks
-         * [Api set: WordApiOnline 1.1]
-         *
-         * @param index A number that identifies the index location of a comment reply object.
-         */
-        getItem(index: number): Word.CommentReply;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -84855,18 +84753,9 @@ declare namespace Word {
          * @remarks
          * [Api set: WordApi 1.3]
          *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Before', 'Start', 'End', 'After', or 'Content'.
-         */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Gets the whole content control, or the starting or ending point of the content control, as a range.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Before', 'Start', 'End', 'After', or 'Content'.
+         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'Before', 'After', or 'Content'.
          */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation | "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
         /**
          * Gets reviewed text based on ChangeTrackingVersion selection.
          *
@@ -84904,17 +84793,7 @@ declare namespace Word {
          * @param breakType Required. Type of break.
          * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'.
          */
-        insertBreak(breakType: Word.BreakType, insertLocation: Word.InsertLocation): void;
-        /**
-         * Inserts a break at the specified location in the main document. This method cannot be used with 'RichTextTable', 'RichTextTableRow' and 'RichTextTableCell' content controls.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param breakType Required. Type of break.
-         * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'.
-         */
-        insertBreak(breakType: "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): void;
+        insertBreak(breakType: Word.BreakType | "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After"): void;
         /**
          * Inserts a document into the content control at the specified location.
          *
@@ -84924,17 +84803,7 @@ declare namespace Word {
          * @param base64File Required. The base64 encoded content of a .docx file.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
          */
-        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts a document into the content control at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param base64File Required. The base64 encoded content of a .docx file.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
-         */
-        insertFileFromBase64(base64File: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts HTML into the content control at the specified location.
          *
@@ -84944,27 +84813,7 @@ declare namespace Word {
          * @param html Required. The HTML to be inserted in to the content control.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
          */
-        insertHtml(html: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts HTML into the content control at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param html Required. The HTML to be inserted in to the content control.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
-         */
-        insertHtml(html: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts an inline picture into the content control at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param base64EncodedImage Required. The base64 encoded image to be inserted in the content control.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
-         */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation): Word.InlinePicture;
+        insertHtml(html: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts an inline picture into the content control at the specified location.
          *
@@ -84974,7 +84823,7 @@ declare namespace Word {
          * @param base64EncodedImage Required. The base64 encoded image to be inserted in the content control.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
          */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.InlinePicture;
+        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.InlinePicture;
         /**
          * Inserts OOXML into the content control at the specified location.
          *
@@ -84984,27 +84833,7 @@ declare namespace Word {
          * @param ooxml Required. The OOXML to be inserted in to the content control.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
          */
-        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts OOXML into the content control at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param ooxml Required. The OOXML to be inserted in to the content control.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
-         */
-        insertOoxml(ooxml: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'. 'Before' and 'After' cannot be used with 'RichTextTable', 'RichTextTableRow' and 'RichTextTableCell' content controls.
-         */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
+        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts a paragraph at the specified location.
          *
@@ -85014,7 +84843,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'. 'Before' and 'After' cannot be used with 'RichTextTable', 'RichTextTableRow' and 'RichTextTableCell' content controls.
          */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After"): Word.Paragraph;
         /**
          * Inserts a table with the specified number of rows and columns into, or next to, a content control.
          *
@@ -85026,29 +84855,7 @@ declare namespace Word {
          * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'. 'Before' and 'After' cannot be used with 'RichTextTable', 'RichTextTableRow' and 'RichTextTableCell' content controls.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation, values?: string[][]): Word.Table;
-        /**
-         * Inserts a table with the specified number of rows and columns into, or next to, a content control.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rowCount Required. The number of rows in the table.
-         * @param columnCount Required. The number of columns in the table.
-         * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'. 'Before' and 'After' cannot be used with 'RichTextTable', 'RichTextTableRow' and 'RichTextTableCell' content controls.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertTable(rowCount: number, columnCount: number, insertLocation: "Before" | "After" | "Start" | "End" | "Replace", values?: string[][]): Word.Table;
-        /**
-         * Inserts text into the content control at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param text Required. The text to be inserted in to the content control.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
-         */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.Range;
+        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After", values?: string[][]): Word.Table;
         /**
          * Inserts text into the content control at the specified location.
          *
@@ -85058,7 +84865,7 @@ declare namespace Word {
          * @param text Required. The text to be inserted in to the content control.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'. 'Replace' cannot be used with 'RichTextTable' and 'RichTextTableRow' content controls.
          */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertText(text: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Performs a search with the specified SearchOptions on the scope of the content control object. The search results are a collection of range objects.
          *
@@ -85243,14 +85050,14 @@ declare namespace Word {
          */
         getFirstOrNullObject(): Word.ContentControl;
         /**
-         * Gets a content control by its index in the collection.
+         * Gets a content control by its ID.
          *
          * @remarks
          * [Api set: WordApi 1.1]
          *
-         * @param index The index.
+         * @param id The content control's ID.
          */
-        getItem(index: number): Word.ContentControl;
+        getItem(id: number): Word.ContentControl;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -86931,16 +86738,7 @@ declare namespace Word {
          *
          * @param rangeLocation Optional. The range location must be 'Whole', 'Start', or 'End'.
          */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Gets the picture, or the starting or ending point of the picture, as a range.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', or 'End'.
-         */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | "Whole" | "Start" | "End"): Word.Range;
         /**
          * Inserts a break at the specified location in the main document.
          *
@@ -86950,17 +86748,7 @@ declare namespace Word {
          * @param breakType Required. The break type to add.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertBreak(breakType: Word.BreakType, insertLocation: Word.InsertLocation): void;
-        /**
-         * Inserts a break at the specified location in the main document.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param breakType Required. The break type to add.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertBreak(breakType: "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): void;
+        insertBreak(breakType: Word.BreakType | "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): void;
         /**
          * Wraps the inline picture with a rich text content control.
          *
@@ -86977,17 +86765,7 @@ declare namespace Word {
          * @param base64File Required. The base64 encoded content of a .docx file.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts a document at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param base64File Required. The base64 encoded content of a .docx file.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertFileFromBase64(base64File: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Range;
         /**
          * Inserts HTML at the specified location.
          *
@@ -86997,27 +86775,7 @@ declare namespace Word {
          * @param html Required. The HTML to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertHtml(html: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts HTML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param html Required. The HTML to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertHtml(html: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts an inline picture at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param base64EncodedImage Required. The base64 encoded image to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Before', or 'After'.
-         */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation): Word.InlinePicture;
+        insertHtml(html: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Range;
         /**
          * Inserts an inline picture at the specified location.
          *
@@ -87027,17 +86785,7 @@ declare namespace Word {
          * @param base64EncodedImage Required. The base64 encoded image to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Before', or 'After'.
          */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.InlinePicture;
-        /**
-         * Inserts OOXML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param ooxml Required. The OOXML to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation): Word.Range;
+        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.before | Word.InsertLocation.after | "Replace" | "Before" | "After"): Word.InlinePicture;
         /**
          * Inserts OOXML at the specified location.
          *
@@ -87047,17 +86795,7 @@ declare namespace Word {
          * @param ooxml Required. The OOXML to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertOoxml(ooxml: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
+        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Range;
         /**
          * Inserts a paragraph at the specified location.
          *
@@ -87067,7 +86805,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;
         /**
          * Inserts text at the specified location.
          *
@@ -87077,17 +86815,7 @@ declare namespace Word {
          * @param text Required. Text to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts text at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param text Required. Text to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertText(text: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Range;
         /**
          * Selects the inline picture. This causes Word to scroll to the selection.
          *
@@ -87282,17 +87010,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'.
          */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Start', 'End', 'Before', or 'After'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After"): Word.Paragraph;
         /**
          * Resets the font of the bullet, number, or picture at the specified level in the list.
          *
@@ -87481,14 +87199,14 @@ declare namespace Word {
          */
         getFirstOrNullObject(): Word.List;
         /**
-         * Gets a list object by its index in the collection.
+         * Gets a list object by its ID.
          *
          * @remarks
          * [Api set: WordApi 1.3]
          *
-         * @param index A number that identifies the index location of a list object.
+         * @param id The list's ID.
          */
-        getItem(index: number): Word.List;
+        getItem(id: number): Word.List;
         /**
          * Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties.
          *
@@ -88109,16 +87827,7 @@ declare namespace Word {
          *
          * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
          */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Gets the whole paragraph, or the starting or ending point of the paragraph, as a range.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
-         */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | Word.RangeLocation.content | "Whole" | "Start" | "End" | "After" | "Content"): Word.Range;
         /**
          * Gets reviewed text based on ChangeTrackingVersion selection.
          *
@@ -88156,17 +87865,7 @@ declare namespace Word {
          * @param breakType Required. The break type to add to the document.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertBreak(breakType: Word.BreakType, insertLocation: Word.InsertLocation): void;
-        /**
-         * Inserts a break at the specified location in the main document.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param breakType Required. The break type to add to the document.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertBreak(breakType: "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): void;
+        insertBreak(breakType: Word.BreakType | "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): void;
         /**
          * Wraps the paragraph object with a rich text content control.
          *
@@ -88183,17 +87882,7 @@ declare namespace Word {
          * @param base64File Required. The base64 encoded content of a .docx file.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts a document into the paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param base64File Required. The base64 encoded content of a .docx file.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertFileFromBase64(base64File: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts HTML into the paragraph at the specified location.
          *
@@ -88203,27 +87892,7 @@ declare namespace Word {
          * @param html Required. The HTML to be inserted in the paragraph.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertHtml(html: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts HTML into the paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param html Required. The HTML to be inserted in the paragraph.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertHtml(html: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts a picture into the paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param base64EncodedImage Required. The base64 encoded image to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation): Word.InlinePicture;
+        insertHtml(html: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts a picture into the paragraph at the specified location.
          *
@@ -88233,7 +87902,7 @@ declare namespace Word {
          * @param base64EncodedImage Required. The base64 encoded image to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.InlinePicture;
+        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.InlinePicture;
         /**
          * Inserts OOXML into the paragraph at the specified location.
          *
@@ -88243,17 +87912,7 @@ declare namespace Word {
          * @param ooxml Required. The OOXML to be inserted in the paragraph.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts OOXML into the paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param ooxml Required. The OOXML to be inserted in the paragraph.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertOoxml(ooxml: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Inserts a paragraph at the specified location.
          *
@@ -88263,17 +87922,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;
         /**
          * Inserts a table with the specified number of rows and columns.
          *
@@ -88285,19 +87934,7 @@ declare namespace Word {
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation, values?: string[][]): Word.Table;
-        /**
-         * Inserts a table with the specified number of rows and columns.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rowCount Required. The number of rows in the table.
-         * @param columnCount Required. The number of columns in the table.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertTable(rowCount: number, columnCount: number, insertLocation: "Before" | "After" | "Start" | "End" | "Replace", values?: string[][]): Word.Table;
+        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;
         /**
          * Inserts text into the paragraph at the specified location.
          *
@@ -88307,17 +87944,7 @@ declare namespace Word {
          * @param text Required. Text to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
          */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts text into the paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param text Required. Text to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', or 'End'.
-         */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertText(text: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End"): Word.Range;
         /**
          * Performs a search with the specified SearchOptions on the scope of the paragraph object. The search results are a collection of range objects.
          *
@@ -88752,16 +88379,7 @@ declare namespace Word {
          *
          * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
          */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Clones the range, or gets the starting or ending point of the range as a new range.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', 'After', or 'Content'.
-         */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | Word.RangeLocation.content | "Whole" | "Start" | "End" | "After" | "Content"): Word.Range;
         /**
          * Gets reviewed text based on ChangeTrackingVersion selection.
          *
@@ -88809,17 +88427,7 @@ declare namespace Word {
          * @param breakType Required. The break type to add.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertBreak(breakType: Word.BreakType, insertLocation: Word.InsertLocation): void;
-        /**
-         * Inserts a break at the specified location in the main document.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param breakType Required. The break type to add.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertBreak(breakType: "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): void;
+        insertBreak(breakType: Word.BreakType | "Page" | "Next" | "SectionNext" | "SectionContinuous" | "SectionEven" | "SectionOdd" | "Line", insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): void;
         /**
          * Insert a comment on the range.
          *
@@ -88855,17 +88463,7 @@ declare namespace Word {
          * @param base64File Required. The base64 encoded content of a .docx file.
          * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts a document at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param base64File Required. The base64 encoded content of a .docx file.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
-         */
-        insertFileFromBase64(base64File: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.Range;
         /**
          * Inserts a footnote. The footnote reference is placed after the range.
          *
@@ -88884,17 +88482,7 @@ declare namespace Word {
          * @param html Required. The HTML to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertHtml(html: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts HTML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param html Required. The HTML to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
-         */
-        insertHtml(html: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertHtml(html: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.Range;
         /**
          * Inserts a picture at the specified location.
          *
@@ -88904,17 +88492,7 @@ declare namespace Word {
          * @param base64EncodedImage Required. The base64 encoded image to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation): Word.InlinePicture;
-        /**
-         * Inserts a picture at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.2]
-         *
-         * @param base64EncodedImage Required. The base64 encoded image to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
-         */
-        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.InlinePicture;
+        insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.InlinePicture;
         /**
          * Inserts OOXML at the specified location.
          *
@@ -88924,27 +88502,7 @@ declare namespace Word {
          * @param ooxml Required. The OOXML to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation): Word.Range;
-        /**
-         * Inserts OOXML at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param ooxml Required. The OOXML to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
-         */
-        insertOoxml(ooxml: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
+        insertOoxml(ooxml: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.Range;
         /**
          * Inserts a paragraph at the specified location.
          *
@@ -88954,7 +88512,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;
         /**
          * Inserts a table with the specified number of rows and columns.
          *
@@ -88966,29 +88524,7 @@ declare namespace Word {
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation, values?: string[][]): Word.Table;
-        /**
-         * Inserts a table with the specified number of rows and columns.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rowCount Required. The number of rows in the table.
-         * @param columnCount Required. The number of columns in the table.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertTable(rowCount: number, columnCount: number, insertLocation: "Before" | "After" | "Start" | "End" | "Replace", values?: string[][]): Word.Table;
-        /**
-         * Inserts text at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.1]
-         *
-         * @param text Required. Text to be inserted.
-         * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
-         */
-        insertText(text: string, insertLocation: Word.InsertLocation): Word.Range;
+        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;
         /**
          * Inserts text at the specified location.
          *
@@ -88998,7 +88534,7 @@ declare namespace Word {
          * @param text Required. Text to be inserted.
          * @param insertLocation Required. The value must be 'Replace', 'Start', 'End', 'Before', or 'After'.
          */
-        insertText(text: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Range;
+        insertText(text: string, insertLocation: Word.InsertLocation | "Replace" | "Start" | "End" | "Before" | "After"): Word.Range;
         /**
          * Returns a new range as the intersection of this range with another range. This range is not changed. Throws an error if the two ranges are not overlapped or adjacent.
          *
@@ -89828,29 +89364,7 @@ declare namespace Word {
          * @param columnCount Required. Number of columns to add.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        addColumns(insertLocation: Word.InsertLocation, columnCount: number, values?: string[][]): void;
-        /**
-         * Adds columns to the start or end of the table, using the first or last existing column as a template. This is applicable to uniform tables. The string values, if specified, are set in the newly inserted rows.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param insertLocation Required. It must be 'Start' or 'End', corresponding to the appropriate side of the table.
-         * @param columnCount Required. Number of columns to add.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        addColumns(insertLocation: "Before" | "After" | "Start" | "End" | "Replace", columnCount: number, values?: string[][]): void;
-        /**
-         * Adds rows to the start or end of the table, using the first or last existing row as a template. The string values, if specified, are set in the newly inserted rows.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param insertLocation Required. It must be 'Start' or 'End'.
-         * @param rowCount Required. Number of rows to add.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        addRows(insertLocation: Word.InsertLocation, rowCount: number, values?: string[][]): Word.TableRowCollection;
+        addColumns(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", columnCount: number, values?: string[][]): void;
         /**
          * Adds rows to the start or end of the table, using the first or last existing row as a template. The string values, if specified, are set in the newly inserted rows.
          *
@@ -89861,7 +89375,7 @@ declare namespace Word {
          * @param rowCount Required. Number of rows to add.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        addRows(insertLocation: "Before" | "After" | "Start" | "End" | "Replace", rowCount: number, values?: string[][]): Word.TableRowCollection;
+        addRows(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", rowCount: number, values?: string[][]): Word.TableRowCollection;
         /**
          * Autofits the table columns to the width of the window.
          *
@@ -90016,16 +89530,7 @@ declare namespace Word {
          *
          * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', or 'After'.
          */
-        getRange(rangeLocation?: Word.RangeLocation): Word.Range;
-        /**
-         * Gets the range that contains this table, or the range at the start or end of the table.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rangeLocation Optional. The range location must be 'Whole', 'Start', 'End', or 'After'.
-         */
-        getRange(rangeLocation?: "Whole" | "Start" | "End" | "Before" | "After" | "Content"): Word.Range;
+        getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | "Whole" | "Start" | "End" | "After"): Word.Range;
         /**
          * Inserts a content control on the table.
          *
@@ -90042,17 +89547,7 @@ declare namespace Word {
          * @param paragraphText Required. The paragraph text to be inserted.
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          */
-        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation): Word.Paragraph;
-        /**
-         * Inserts a paragraph at the specified location.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param paragraphText Required. The paragraph text to be inserted.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         */
-        insertParagraph(paragraphText: string, insertLocation: "Before" | "After" | "Start" | "End" | "Replace"): Word.Paragraph;
+        insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;
         /**
          * Inserts a table with the specified number of rows and columns.
          *
@@ -90064,19 +89559,7 @@ declare namespace Word {
          * @param insertLocation Required. The value must be 'Before' or 'After'.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation, values?: string[][]): Word.Table;
-        /**
-         * Inserts a table with the specified number of rows and columns.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param rowCount Required. The number of rows in the table.
-         * @param columnCount Required. The number of columns in the table.
-         * @param insertLocation Required. The value must be 'Before' or 'After'.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertTable(rowCount: number, columnCount: number, insertLocation: "Before" | "After" | "Start" | "End" | "Replace", values?: string[][]): Word.Table;
+        insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;
         /**
          * Merges the cells bounded inclusively by a first and last cell.
          *
@@ -90436,18 +89919,7 @@ declare namespace Word {
          * @param rowCount Required. Number of rows to add
          * @param values Optional. Strings to insert in the new rows, specified as a 2D array. The number of cells in each row must not exceed the number of cells in the existing row.
          */
-        insertRows(insertLocation: Word.InsertLocation, rowCount: number, values?: string[][]): Word.TableRowCollection;
-        /**
-         * Inserts rows using this row as a template. If values are specified, inserts the values into the new rows.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param insertLocation Required. Where the new rows should be inserted, relative to the current row. It must be 'Before' or 'After'.
-         * @param rowCount Required. Number of rows to add
-         * @param values Optional. Strings to insert in the new rows, specified as a 2D array. The number of cells in each row must not exceed the number of cells in the existing row.
-         */
-        insertRows(insertLocation: "Before" | "After" | "Start" | "End" | "Replace", rowCount: number, values?: string[][]): Word.TableRowCollection;
+        insertRows(insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", rowCount: number, values?: string[][]): Word.TableRowCollection;
         /**
          * Merges the row into one cell.
          *
@@ -90772,29 +90244,7 @@ declare namespace Word {
          * @param columnCount Required. Number of columns to add.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertColumns(insertLocation: Word.InsertLocation, columnCount: number, values?: string[][]): void;
-        /**
-         * Adds columns to the left or right of the cell, using the cell's column as a template. This is applicable to uniform tables. The string values, if specified, are set in the newly inserted rows.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param insertLocation Required. It must be 'Before' or 'After'.
-         * @param columnCount Required. Number of columns to add.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertColumns(insertLocation: "Before" | "After" | "Start" | "End" | "Replace", columnCount: number, values?: string[][]): void;
-        /**
-         * Inserts rows above or below the cell, using the cell's row as a template. The string values, if specified, are set in the newly inserted rows.
-         *
-         * @remarks
-         * [Api set: WordApi 1.3]
-         *
-         * @param insertLocation Required. It must be 'Before' or 'After'.
-         * @param rowCount Required. Number of rows to add.
-         * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
-         */
-        insertRows(insertLocation: Word.InsertLocation, rowCount: number, values?: string[][]): Word.TableRowCollection;
+        insertColumns(insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", columnCount: number, values?: string[][]): void;
         /**
          * Inserts rows above or below the cell, using the cell's row as a template. The string values, if specified, are set in the newly inserted rows.
          *
@@ -90805,7 +90255,7 @@ declare namespace Word {
          * @param rowCount Required. Number of rows to add.
          * @param values Optional 2D array. Cells are filled if the corresponding strings are specified in the array.
          */
-        insertRows(insertLocation: "Before" | "After" | "Start" | "End" | "Replace", rowCount: number, values?: string[][]): Word.TableRowCollection;
+        insertRows(insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", rowCount: number, values?: string[][]): Word.TableRowCollection;
         /**
          * Sets cell padding in points.
          *
@@ -91223,7 +90673,7 @@ declare namespace Word {
         plainText = "PlainText",
     }
     /**
-     * ContentControl appearance
+     * ContentControl appearance.
      *
      * @remarks
      * [Api set: WordApi 1.1]

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.330",
+    "version": "1.0.332",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "02da0d528889632af2e050454a3b6404f621c2ed70d30777c9ec6dd1286e5a1d",
+    "typesPublisherContentHash": "29267df73c9abe3630aeb248a6956997cb0fdc27cd0f7fab6e2535a35790b3e5",
     "typeScriptVersion": "4.1"
 }