@types/office-js 1.0.463 → 1.0.465

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: Wed, 05 Feb 2025 23:02:38 GMT
+ * Last updated: Mon, 10 Feb 2025 20:04:01 GMT
  * Dependencies: none
 
 # Credits

office-js/index.d.ts

@@ -21869,6 +21869,52 @@ declare namespace OfficeCore {
 
 
 declare namespace Excel {
+    /**
+     * Represents an unknown cell control.
+     * This represents a control that was added in a future version of Excel, and the current version of Excel doesn't know how to display this control.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]    
+     */
+    interface UnknownCellControl {
+        type: CellControlType.unknown;
+    }
+    /**
+     * Represents an empty cell control.
+     * This represents the state where a cell does not have a control.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]  
+     */
+    interface EmptyCellControl {
+        type: CellControlType.empty;
+    }
+    /**
+     * Represents the result of a query that resulted in multiple cell controls.
+     * If the result has multiple controls, then they can't be represented as a single result.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]  
+     */
+    interface MixedCellControl {
+        type: CellControlType.mixed;
+    }
+    /**
+     * Represents a checkbox. This is a cell control that allows a user to toggle the boolean value in a cell.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]  
+     */
+    interface CheckboxCellControl {
+        type: CellControlType.checkbox;
+    }
+    /**
+     * Represents an interactable control inside of a cell.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]  
+     */
+    type CellControl = UnknownCellControl | EmptyCellControl | MixedCellControl | CheckboxCellControl;
     /**
      * Represents a 2D array of cell values.
      *
@@ -30572,6 +30618,39 @@ declare namespace Excel {
          */
         type: "WorkbookAutoSaveSettingChanged";
     }
+    /**
+     * Represents the type of cell control.
+     *
+     * @remarks
+     * [Api set: ExcelApi 1.18]
+     */
+    enum CellControlType {
+        /**
+         * Type representing an unknown control.
+                    This represents a control that was added in a future version of Excel, and the current version of Excel doesn't know how to display this control.
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        unknown = "Unknown",
+        /**
+         * Type representing an empty control.
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        empty = "Empty",
+        /**
+         * Type representing a query that results in a mix of control results.
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        mixed = "Mixed",
+        /**
+         * Type representing a checkbox control.
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        checkbox = "Checkbox"
+    }
     /**
      * Represents the direction that existing or remaining cells in a worksheet will shift when cells are inserted into or deleted from a worksheet.
      *
@@ -32049,6 +32128,13 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         readonly names: Excel.NamedItemCollection;
+        /**
+         * Returns a collection of all the notes objects in the workbook.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        readonly notes: Excel.NoteCollection;
         /**
          * Represents a collection of PivotTableStyles associated with the workbook.
          *
@@ -32535,6 +32621,13 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.4]
          */
         readonly names: Excel.NamedItemCollection;
+        /**
+         * Returns a collection of all the notes objects in the worksheet.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        readonly notes: Excel.NoteCollection;
         /**
          * Gets the `PageLayout` object of the worksheet.
          *
@@ -33724,6 +33817,14 @@ declare namespace Excel {
          * [Api set: ExcelApi 1.1]
          */
         readonly columnIndex: number;
+        /**
+         * Accesses the cell control applied to this range.
+                    If the range has multiple cell controls, this returns `EmptyCellControl`.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        control: CellControl;
         /**
          * Represents the formula in A1-style notation. If a cell has no formula, its value is returned instead.
          *
@@ -33979,7 +34080,16 @@ declare namespace Excel {
          *
          * @param applyTo Optional. Determines the type of clear action. See `Excel.ClearApplyTo` for details.
          */
-        clear(applyTo?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks"): void;
+        clear(applyTo?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"): void;
+        /**
+         * Clears the values of the cells in the range, with special consideration given to cells containing controls.
+                    If the range contains only blank values and controls set to their default value, then the values and control formatting are removed.
+                    Otherwise, this sets the cells with controls to their default value and clears the values of the other cells in the range.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        clearOrResetContents(): void;
         /**
          * Converts the range cells with data types into text.
          *
@@ -34886,7 +34996,16 @@ declare namespace Excel {
          *
          * @param applyTo Optional. Determines the type of clear action. See `Excel.ClearApplyTo` for details. Default is "All".
          */
-        clear(applyTo?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks"): void;
+        clear(applyTo?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"): void;
+        /**
+         * Clears the values of the cells in the ranges, with special consideration given to cells containing controls.
+                    If the ranges contain only blank values and controls set to their default value, then the values and control formatting are removed.
+                    Otherwise, this sets the cells with controls to their default value and clears the values of the other cells in the ranges.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        clearOrResetContents(): void;
         /**
          * Converts all cells in the `RangeAreas` with data types into text.
          *
@@ -35045,6 +35164,13 @@ declare namespace Excel {
          * @param valuesOnly Whether to only consider cells with values as used cells.
          */
         getUsedRangeAreasOrNullObject(valuesOnly?: boolean): Excel.RangeAreas;
+        /**
+         * Selects the specified range areas in the Excel UI.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        select(): void;
         /**
          * Sets the `RangeAreas` to be recalculated when the next recalculation occurs.
          *
@@ -35407,6 +35533,28 @@ declare namespace Excel {
          */
         weight?: boolean;
     }
+    /**
+     * Represents a sequence of one or more characters that share the same font attributes in a cell. Can be used as the `textRuns` properties of `getCellProperties` or the `textRuns` input parameter of `setCellProperties`.
+     * 
+     * @remarks
+     * [Api set: ExcelApi 1.18]
+     */
+    interface RangeTextRun {
+        /**
+         * The font attributes (such as font name, font size, and color) applied to this text run.
+         * 
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        font?: Excel.CellPropertiesFont;
+        /**
+         * The text of this text run.
+         * 
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */        
+        text: string;
+    }
     /**
      * Represents the `format.protection` properties of `getCellProperties`, `getRowProperties`, and `getColumnProperties`, or the `format.protection` input parameter of `setCellProperties`, `setRowProperties`, and `setColumnProperties`.
      *
@@ -54417,7 +54565,15 @@ declare namespace Excel {
          * @remarks
          * [Api set: ExcelApi 1.7]
          */
-        removeHyperlinks = "RemoveHyperlinks"
+        removeHyperlinks = "RemoveHyperlinks",
+        /**
+         * Sets all cells in the range to their default state.
+                    Cells with cell controls are set to the default value defined by each control.
+                    Cells without cell controls are set to blank.
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        resetContents = "ResetContents"
     }
     /**
      * Represents the format options for a data bar axis.
@@ -59218,6 +59374,182 @@ declare namespace Excel {
         */
         toJSON(): Excel.Interfaces.NamedSheetViewCollectionData;
     }
+    /**
+     * Represents a collection of note objects that are part of the workbook.
+     *
+     * @remarks
+     * [Api set: ExcelApi 1.18]
+     */
+    class NoteCollection 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: Excel.Note[];
+        /**
+         * Adds a new note with the given content on the given cell.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         *
+         * @param cellAddress The cell to which the note is added. This can be a `Range` object or a string such as "A1". If the string is invalid, or the range is not a single cell, an `InvalidCellAddress` error is thrown.
+         * @param content The text of the note.
+         */
+        add(cellAddress: Range | string, content: any): Excel.Note;
+        /**
+         * Gets the number of notes in the collection.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        getCount(): OfficeExtension.ClientResult<number>;
+        /**
+         * Gets a note by its cell address.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         *
+         * @param key The cell address of the note.
+         * @returns The note with the given cell address. If there is no note with the given cell address, then the `ItemNotFound` error is thrown.
+         */
+        getItem(key: string): Excel.Note;
+        /**
+         * Gets a note from the collection based on its position.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         *
+         * @param index The index value of the note to be retrieved. Zero-indexed.
+         */
+        getItemAt(index: number): Excel.Note;
+        /**
+         * Gets a note by its cell address.
+                    If the note object does not exist, then this method returns an object with its `isNullObject` property set to `true`.
+                    For further information, see {@link https://learn.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties  | *OrNullObject methods and properties}.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         *
+         * @param key The cell address of the note.
+         * @returns The note with the given cell address or null object.
+         */
+        getItemOrNullObject(key: string): Excel.Note;
+        /**
+         * 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?: Excel.Interfaces.NoteCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions): Excel.NoteCollection;
+        /**
+         * 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[]): Excel.NoteCollection;
+        /**
+         * 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): Excel.NoteCollection;
+        /**
+        * 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's passed to it.)
+        * Whereas the original `Excel.NoteCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Excel.Interfaces.NoteCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+        */
+        toJSON(): Excel.Interfaces.NoteCollectionData;
+    }
+    /**
+     * Represents a note in the workbook or worksheet.
+     *
+     * @remarks
+     * [Api set: ExcelApi 1.18]
+     */
+    class Note 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 author of the note.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        readonly authorName: string;
+        /**
+         * Gets or sets the text of the note.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        content: string;
+        /**
+         * Specifies the height of the note.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        height: number;
+        /**
+         * Specifies the visibility of the note. A value of `true` means the note is shown.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        visible: boolean;
+        /**
+         * Specifies the width of the note.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        width: number;
+        /**
+         * Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate properties, or another API object of the same type.
+         * @param properties A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.
+         * @param options Provides an option to suppress errors if the properties object tries to set any read-only properties.
+         */
+        set(properties: Interfaces.NoteUpdateData, options?: OfficeExtension.UpdateOptions): void;
+        /** Sets multiple properties on the object at the same time, based on an existing loaded object. */
+        set(properties: Excel.Note): void;
+        /**
+         * Deletes the note.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        delete(): void;
+        /**
+         * Gets the cell where this note is located.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        getLocation(): Excel.Range;
+        /**
+         * 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?: Excel.Interfaces.NoteLoadOptions): Excel.Note;
+        /**
+         * 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[]): Excel.Note;
+        /**
+         * 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;
+        }): Excel.Note;
+        /**
+        * 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's passed to it.)
+        * Whereas the original `Excel.Note` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Excel.Interfaces.NoteData`) that contains shallow copies of any loaded child properties from the original object.
+        */
+        toJSON(): Excel.Interfaces.NoteData;
+    }
     /**
      * An object containing the result of a function-evaluation operation
      *
@@ -63294,6 +63626,14 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.2]
              */
             columnHidden?: boolean;
+            /**
+             * Accesses the cell control applied to this range.
+                        If the range has multiple cell controls, this returns `EmptyCellControl`.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            control?: CellControl;
             /**
              * Represents the formula in A1-style notation. If a cell has no formula, its value is returned instead.
              *
@@ -67943,6 +68283,41 @@ declare namespace Excel {
         interface NamedSheetViewCollectionUpdateData {
             items?: Excel.Interfaces.NamedSheetViewData[];
         }
+        /** An interface for updating data on the `NoteCollection` object, for use in `noteCollection.set({ ... })`. */
+        interface NoteCollectionUpdateData {
+            items?: Excel.Interfaces.NoteData[];
+        }
+        /** An interface for updating data on the `Note` object, for use in `note.set({ ... })`. */
+        interface NoteUpdateData {
+            /**
+             * Gets or sets the text of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            content?: string;
+            /**
+             * Specifies the height of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            height?: number;
+            /**
+             * Specifies the visibility of the note. A value of `true` means the note is shown.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            visible?: boolean;
+            /**
+             * Specifies the width of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            width?: number;
+        }
         /** An interface describing the data returned by calling `allowEditRange.toJSON()`. */
         interface AllowEditRangeData {
             /**
@@ -68168,6 +68543,13 @@ declare namespace Excel {
             */
             names?: Excel.Interfaces.NamedItemData[];
             /**
+            * Returns a collection of all the notes objects in the workbook.
+            *
+            * @remarks
+            * [Api set: ExcelApi 1.18]
+            */
+            notes?: Excel.Interfaces.NoteData[];
+            /**
             * Represents a collection of PivotTableStyles associated with the workbook.
             *
             * @remarks
@@ -68369,6 +68751,13 @@ declare namespace Excel {
             */
             names?: Excel.Interfaces.NamedItemData[];
             /**
+            * Returns a collection of all the notes objects in the worksheet.
+            *
+            * @remarks
+            * [Api set: ExcelApi 1.18]
+            */
+            notes?: Excel.Interfaces.NoteData[];
+            /**
             * Gets the `PageLayout` object of the worksheet.
             *
             * @remarks
@@ -68622,6 +69011,14 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             columnIndex?: number;
+            /**
+             * Accesses the cell control applied to this range.
+                        If the range has multiple cell controls, this returns `EmptyCellControl`.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            control?: CellControl;
             /**
              * Represents the formula in A1-style notation. If a cell has no formula, its value is returned instead.
              *
@@ -74564,6 +74961,48 @@ declare namespace Excel {
         interface NamedSheetViewCollectionData {
             items?: Excel.Interfaces.NamedSheetViewData[];
         }
+        /** An interface describing the data returned by calling `noteCollection.toJSON()`. */
+        interface NoteCollectionData {
+            items?: Excel.Interfaces.NoteData[];
+        }
+        /** An interface describing the data returned by calling `note.toJSON()`. */
+        interface NoteData {
+            /**
+             * Gets the author of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            authorName?: string;
+            /**
+             * Gets or sets the text of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            content?: string;
+            /**
+             * Specifies the height of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            height?: number;
+            /**
+             * Specifies the visibility of the note. A value of `true` means the note is shown.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            visible?: boolean;
+            /**
+             * Specifies the width of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            width?: number;
+        }
         /** An interface describing the data returned by calling `functionResult.toJSON()`. */
         interface FunctionResultData<T> {
             /**
@@ -75454,6 +75893,14 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             columnIndex?: boolean;
+            /**
+             * Accesses the cell control applied to this range.
+                        If the range has multiple cell controls, this returns `EmptyCellControl`.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            control?: boolean;
             /**
              * Represents the formula in A1-style notation. If a cell has no formula, its value is returned instead.
              *
@@ -83737,6 +84184,14 @@ declare namespace Excel {
              * [Api set: ExcelApi 1.1]
              */
             columnIndex?: boolean;
+            /**
+             * For EACH ITEM in the collection: Accesses the cell control applied to this range.
+                        If the range has multiple cell controls, this returns `EmptyCellControl`.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            control?: boolean;
             /**
              * For EACH ITEM in the collection: Represents the formula in A1-style notation. If a cell has no formula, its value is returned instead.
              *
@@ -85701,6 +86156,100 @@ declare namespace Excel {
              */
             name?: boolean;
         }
+        /**
+         * Represents a collection of note objects that are part of the workbook.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        interface NoteCollectionLoadOptions {
+            /**
+              Specifying `$all` for the load options loads all the scalar properties (such as `Range.address`) but not the navigational properties (such as `Range.format.fill.color`).
+             */
+            $all?: boolean;
+            /**
+             * For EACH ITEM in the collection: Gets the author of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            authorName?: boolean;
+            /**
+             * For EACH ITEM in the collection: Gets or sets the text of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            content?: boolean;
+            /**
+             * For EACH ITEM in the collection: Specifies the height of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            height?: boolean;
+            /**
+             * For EACH ITEM in the collection: Specifies the visibility of the note. A value of `true` means the note is shown.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            visible?: boolean;
+            /**
+             * For EACH ITEM in the collection: Specifies the width of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            width?: boolean;
+        }
+        /**
+         * Represents a note in the workbook or worksheet.
+         *
+         * @remarks
+         * [Api set: ExcelApi 1.18]
+         */
+        interface NoteLoadOptions {
+            /**
+              Specifying `$all` for the load options loads all the scalar properties (such as `Range.address`) but not the navigational properties (such as `Range.format.fill.color`).
+             */
+            $all?: boolean;
+            /**
+             * Gets the author of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            authorName?: boolean;
+            /**
+             * Gets or sets the text of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            content?: boolean;
+            /**
+             * Specifies the height of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            height?: boolean;
+            /**
+             * Specifies the visibility of the note. A value of `true` means the note is shown.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            visible?: boolean;
+            /**
+             * Specifies the width of the note.
+             *
+             * @remarks
+             * [Api set: ExcelApi 1.18]
+             */
+            width?: boolean;
+        }
         /**
          * An object containing the result of a function-evaluation operation
          *
@@ -87365,7 +87914,7 @@ declare namespace Word {
         toJSON(): Word.Interfaces.CommentReplyCollectionData;
     }
     /**
-     * Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.
+     * Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, checkbox, dropdown list, and combo box content controls are supported.
      *
      * @remarks
      * [Api set: WordApi 1.1]
@@ -87921,7 +88470,7 @@ declare namespace Word {
         toJSON(): Word.Interfaces.ContentControlData;
     }
     /**
-     * Contains a collection of {@link Word.ContentControl} objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.
+     * Contains a collection of {@link Word.ContentControl} objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, checkbox, dropdown list, and combo box content controls are supported.
      *
      * @remarks
      * [Api set: WordApi 1.1]
@@ -88118,11 +88667,11 @@ declare namespace Word {
          */
         track(): Word.ContentControlListItem;
         /**
-         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect.
+         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You'll need to call `context.sync()` before the memory release takes effect.
          */
         untrack(): Word.ContentControlListItem;
         /**
-        * 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.)
+        * 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's passed to it.)
         * Whereas the original `Word.ContentControlListItem` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Word.Interfaces.ContentControlListItemData`) that contains shallow copies of any loaded child properties from the original object.
         */
         toJSON(): Word.Interfaces.ContentControlListItemData;
@@ -88177,11 +88726,11 @@ declare namespace Word {
          */
         track(): Word.ContentControlListItemCollection;
         /**
-         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect.
+         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You'll need to call `context.sync()` before the memory release takes effect.
          */
         untrack(): Word.ContentControlListItemCollection;
         /**
-        * 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.)
+        * 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's passed to it.)
         * Whereas the original `Word.ContentControlListItemCollection` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Word.Interfaces.ContentControlListItemCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
         */
         toJSON(): Word.Interfaces.ContentControlListItemCollectionData;
@@ -89665,11 +90214,11 @@ declare namespace Word {
          */
         track(): Word.DropDownListContentControl;
         /**
-         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect.
+         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You'll need to call `context.sync()` before the memory release takes effect.
          */
         untrack(): Word.DropDownListContentControl;
         /**
-        * 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.)
+        * 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's passed to it.)
         * Whereas the original `Word.DropDownListContentControl` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Word.Interfaces.DropDownListContentControlData`) that contains shallow copies of any loaded child properties from the original object.
         */
         toJSON(): Word.Interfaces.DropDownListContentControlData;
@@ -89728,11 +90277,11 @@ declare namespace Word {
          */
         track(): Word.ComboBoxContentControl;
         /**
-         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect.
+         * Release the memory associated with this object, if it has previously been tracked. This call is shorthand for {@link https://learn.microsoft.com/javascript/api/office/officeextension.clientrequestcontext#office-officeextension-clientrequestcontext-trackedobjects-member | context.trackedObjects.remove(thisObject)}. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You'll need to call `context.sync()` before the memory release takes effect.
          */
         untrack(): Word.ComboBoxContentControl;
         /**
-        * 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.)
+        * 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's passed to it.)
         * Whereas the original `Word.ComboBoxContentControl` object is an API object, the `toJSON` method returns a plain JavaScript object (typed as `Word.Interfaces.ComboBoxContentControlData`) that contains shallow copies of any loaded child properties from the original object.
         */
         toJSON(): Word.Interfaces.ComboBoxContentControlData;
@@ -96211,51 +96760,62 @@ declare namespace Word {
         evenPages = "EvenPages",
     }
     /**
+     * Represents the types of body objects.
+     *
      * @remarks
      * [Api set: WordApi 1.3]
      */
     enum BodyType {
         /**
+         * Unknown body type.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         unknown = "Unknown",
         /**
+         * Main document body.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         mainDoc = "MainDoc",
         /**
+         * Section body.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         section = "Section",
         /**
+         * Header body.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         header = "Header",
         /**
+         * Footer body.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         footer = "Footer",
         /**
+         * Table cell body.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         tableCell = "TableCell",
         /**
+         * Footnote body.
          * @remarks
          * [Api set: WordApi 1.5]
          */
         footnote = "Footnote",
         /**
+         * Endnote body.
          * @remarks
          * [Api set: WordApi 1.5]
          */
         endnote = "Endnote",
         /**
+         * Note body e.g., endnote, footnote.
          * @remarks
          * [Api set: WordApi 1.5]
          */
@@ -96364,6 +96924,8 @@ declare namespace Word {
         svg = "Svg",
     }
     /**
+     * Represents the location of a range. You can get range by calling getRange on different objects such as {@link Word.Paragraph} and {@link Word.ContentControl}.
+     *
      * @remarks
      * [Api set: WordApi 1.3]
      */
@@ -96375,25 +96937,25 @@ declare namespace Word {
          */
         whole = "Whole",
         /**
-         * The starting point of the object. For content control, it is the point after the opening tag.
+         * The starting point of the object. For content control, it's the point after the opening tag.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         start = "Start",
         /**
-         * The ending point of the object. For paragraph, it is the point before the EOP. For content control, it is the point before the closing tag.
+         * The ending point of the object. For paragraph, it's the point before the EOP (end of paragraph). For content control, it's the point before the closing tag.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         end = "End",
         /**
-         * For content control only. It is the point before the opening tag.
+         * For content control only. It's the point before the opening tag.
          * @remarks
          * [Api set: WordApi 1.3]
          */
         before = "Before",
         /**
-         * The point after the object. If the object is a paragraph content control or table content control, it is the point after the EOP or Table characters.
+         * The point after the object. If the object is a paragraph content control or table content control, it's the point after the EOP or Table characters.
          * @remarks
          * [Api set: WordApi 1.3]
          */
@@ -103385,7 +103947,7 @@ declare namespace Word {
             id?: boolean;
         }
         /**
-         * Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.
+         * Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, checkbox, dropdown list, and combo box content controls are supported.
          *
          * @remarks
          * [Api set: WordApi 1.1]
@@ -103558,7 +104120,7 @@ declare namespace Word {
             type?: boolean;
         }
         /**
-         * Contains a collection of {@link Word.ContentControl} objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.
+         * Contains a collection of {@link Word.ContentControl} objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, checkbox, dropdown list, and combo box content controls are supported.
          *
          * @remarks
          * [Api set: WordApi 1.1]

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.463",
+    "version": "1.0.465",
     "description": "TypeScript definitions for office-js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
     "license": "MIT",
@@ -46,6 +46,6 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {},
-    "typesPublisherContentHash": "8356151dea0f375209c20b0ac2443dcf0639ad79434d4057eccbd961db1c9dc4",
+    "typesPublisherContentHash": "9c20920bcf9deb6576f1d2d7734a26cb9f784325d564d61aef4c6087466d71bb",
     "typeScriptVersion": "5.0"
 }