@types/office-js 1.0.560 → 1.0.562

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: Thu, 20 Nov 2025 21:32:50 GMT
+ * Last updated: Fri, 12 Dec 2025 18:42:47 GMT
  * Dependencies: none
 
 # Credits

office-js/index.d.ts

@@ -30677,7 +30677,7 @@ declare namespace Excel {
      * Represents the value of a cell containing a number with a format string. Number format strings must conform to Excel guidelines. To learn more, see {@link https://support.microsoft.com/office/c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5  | Review guidelines for customizing a number format}.
      * In this scenario, the format is applied to the value and not to the cell, so the value retains its format string throughout calculation.
      *
-     * @deprecated As of [Api set: ExcelApi 1.19], use {@link https://learn.microsoft.com/javascript/api/excel/excel.doublecellvalue | DoubleCellValue} instead.
+     * @deprecated As of ExcelApi 1.19, use {@link https://learn.microsoft.com/javascript/api/excel/excel.doublecellvalue | DoubleCellValue} instead.
      *
      * @remarks
      * [Api set: ExcelApi 1.16]
@@ -30686,7 +30686,7 @@ declare namespace Excel {
         /**
          * Represents the type of this cell value.
          *
-         * @deprecated Deprecated since [Api set: ExcelApi 1.19].
+         * @deprecated Deprecated since ExcelApi 1.19.
          *
          * @remarks
          * [Api set: ExcelApi 1.16]
@@ -30695,7 +30695,7 @@ declare namespace Excel {
         /**
          * Represents the value that would be returned by `Range.values` for a cell with this value.
          *
-         * @deprecated Deprecated since [Api set: ExcelApi 1.19].
+         * @deprecated Deprecated since ExcelApi 1.19.
          *
          * @remarks
          * [Api set: ExcelApi 1.16]
@@ -30704,7 +30704,7 @@ declare namespace Excel {
         /**
          * Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
          *
-         * @deprecated Deprecated since [Api set: ExcelApi 1.19].
+         * @deprecated Deprecated since ExcelApi 1.19.
          *
          * @remarks
          * [Api set: ExcelApi 1.16]
@@ -30716,7 +30716,7 @@ declare namespace Excel {
          * Number format strings must conform to Excel guidelines.
          * To learn more, see {@link https://support.microsoft.com/office/c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5 | Review guidelines for customizing a number format}.
          *
-         * @deprecated Deprecated since [Api set: ExcelApi 1.19].
+         * @deprecated Deprecated since ExcelApi 1.19.
          *
          * @remarks
          * [Api set: ExcelApi 1.16]
@@ -32170,10 +32170,17 @@ declare namespace Excel {
     }
     /**
      *
-     * Creates and opens a new workbook.  Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
-     * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
-     * Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
-     *
+     * Creates and opens a new workbook. Optionally, the workbook can be pre-populated
+     * with a Base64-encoded .xlsx file.
+
+     * Note: Macros can be a security risk. If this API is used to create a workbook that
+     * includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog
+     * in the Excel UI. The user must select the "Trust add-in" button to proceed.
+     *
+     * Note: The `extensionHardening` Windows registry key affects the `base64File` param.
+     * The file extension defined by the param must match the real file type of the file.
+     * If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error:
+     * "This operation is not allowed due to the extension hardening policy."
      * [Api set: ExcelApi 1.8]
      *
      * @param base64File Optional. The Base64-encoded .xlsx file. The default value is null.
@@ -32365,7 +32372,6 @@ declare namespace Excel {
          *
          * When false, each `context.sync()` call creates an undo record.
          * When true, all `context.sync()` calls in a single `Excel.run` are merged into one `undo` group.
-         * 
          * @remarks
          * [Api set: ExcelApi 1.20]
          */
@@ -35781,8 +35787,7 @@ declare namespace Excel {
          */
         close(closeBehavior?: "Save" | "SkipSave"): void;
         /**
-         * Sets focus on the workbook. This will cause the grid or the currently active object
-                    to receive keyboard events.
+         * Sets focus on the workbook. This causes the Excel grid or the currently active object to receive keyboard events.
          *
          * @remarks
          * [Api set: ExcelApiDesktop 1.1]
@@ -35877,7 +35882,10 @@ declare namespace Excel {
         getSelectedRanges(): Excel.RangeAreas;
         /**
          * Inserts the specified worksheets from a source workbook into the current workbook.
-         * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
+                    
+                     The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
+                     
+                     **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
          *
          * @remarks
          * [Api set: ExcelApi 1.13]
@@ -64306,6 +64314,7 @@ declare namespace Excel {
         content: string;
         /**
          * Specifies the height of the note.
+         * Note: This property is not supported in Excel on the web.
          *
          * @remarks
          * [Api set: ExcelApi 1.18]
@@ -64313,6 +64322,7 @@ declare namespace Excel {
         height: number;
         /**
          * Specifies the visibility of the note. A value of `true` means the note is shown.
+         * Note: This property is not supported in Excel on the web.
          *
          * @remarks
          * [Api set: ExcelApi 1.18]
@@ -64320,6 +64330,7 @@ declare namespace Excel {
         visible: boolean;
         /**
          * Specifies the width of the note.
+         * Note: This property is not supported in Excel on the web.
          *
          * @remarks
          * [Api set: ExcelApi 1.18]
@@ -74108,6 +74119,7 @@ declare namespace Excel {
             content?: string;
             /**
              * Specifies the height of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -74115,6 +74127,7 @@ declare namespace Excel {
             height?: number;
             /**
              * Specifies the visibility of the note. A value of `true` means the note is shown.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -74122,6 +74135,7 @@ declare namespace Excel {
             visible?: boolean;
             /**
              * Specifies the width of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -81425,6 +81439,7 @@ declare namespace Excel {
             content?: string;
             /**
              * Specifies the height of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -81432,6 +81447,7 @@ declare namespace Excel {
             height?: number;
             /**
              * Specifies the visibility of the note. A value of `true` means the note is shown.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -81439,6 +81455,7 @@ declare namespace Excel {
             visible?: boolean;
             /**
              * Specifies the width of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -93509,6 +93526,7 @@ declare namespace Excel {
             content?: boolean;
             /**
              * For EACH ITEM in the collection: Specifies the height of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -93516,6 +93534,7 @@ declare namespace Excel {
             height?: boolean;
             /**
              * For EACH ITEM in the collection: Specifies the visibility of the note. A value of `true` means the note is shown.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -93523,6 +93542,7 @@ declare namespace Excel {
             visible?: boolean;
             /**
              * For EACH ITEM in the collection: Specifies the width of the note.
+             * Note: This property is not supported in Excel on the web.
              *
              * @remarks
              * [Api set: ExcelApi 1.18]
@@ -96554,7 +96574,7 @@ declare namespace Word {
         };
     }
     /**
-     * The data specific to content controls of type CheckBox.
+     * Represents the data specific to content controls of type `CheckBox`.
      *
      * @remarks
      * [Api set: WordApi 1.7]
@@ -102081,7 +102101,7 @@ declare namespace Word {
         toJSON(): Word.Interfaces.DocumentData;
     }
     /**
-     * The `DocumentCreated` object is the top level object created by `Application.createDocument`. A `DocumentCreated` object is a special `Document` object.
+     * The `DocumentCreated` object is the top-level object created by `Application.createDocument`. A `DocumentCreated` object is a special `Document` object.
      *
      * @remarks
      * [Api set: WordApi 1.3]
@@ -102472,7 +102492,7 @@ declare namespace Word {
         toJSON(): Word.Interfaces.DocumentPropertiesData;
     }
     /**
-     * The data specific to content controls of type `dropDownList`.
+     * Represents the data specific to content controls of type `dropDownList`.
      *
      * @remarks
      * [Api set: WordApi 1.9]
@@ -102535,7 +102555,7 @@ declare namespace Word {
         toJSON(): Word.Interfaces.DropDownListContentControlData;
     }
     /**
-     * The data specific to content controls of type `comboBox`.
+     * Represents the data specific to content controls of type `comboBox`.
      *
      * @remarks
      * [Api set: WordApi 1.9]
@@ -113692,7 +113712,7 @@ declare namespace Word {
         /** The request context associated with the object. This connects the add-in's process to the Office host application's process. */
         context: RequestContext;
         /**
-         * Represents the `Body` object of the shape. Only applies to text boxes and geometric shapes.
+         * Gets the `Body` object of the shape. Only applies to text boxes and geometric shapes.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -113762,21 +113782,21 @@ declare namespace Word {
          */
         altTextDescription: string;
         /**
-         * The geometric shape type of the shape. It will be null if isn't a geometric shape.
+         * Specifies the geometric shape type of the shape. It will be null if isn't a geometric shape.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         geometricShapeType: Word.GeometricShapeType | "LineInverse" | "Triangle" | "RightTriangle" | "Rectangle" | "Diamond" | "Parallelogram" | "Trapezoid" | "NonIsoscelesTrapezoid" | "Pentagon" | "Hexagon" | "Heptagon" | "Octagon" | "Decagon" | "Dodecagon" | "Star4" | "Star5" | "Star6" | "Star7" | "Star8" | "Star10" | "Star12" | "Star16" | "Star24" | "Star32" | "RoundRectangle" | "Round1Rectangle" | "Round2SameRectangle" | "Round2DiagonalRectangle" | "SnipRoundRectangle" | "Snip1Rectangle" | "Snip2SameRectangle" | "Snip2DiagonalRectangle" | "Plaque" | "Ellipse" | "Teardrop" | "HomePlate" | "Chevron" | "PieWedge" | "Pie" | "BlockArc" | "Donut" | "NoSmoking" | "RightArrow" | "LeftArrow" | "UpArrow" | "DownArrow" | "StripedRightArrow" | "NotchedRightArrow" | "BentUpArrow" | "LeftRightArrow" | "UpDownArrow" | "LeftUpArrow" | "LeftRightUpArrow" | "QuadArrow" | "LeftArrowCallout" | "RightArrowCallout" | "UpArrowCallout" | "DownArrowCallout" | "LeftRightArrowCallout" | "UpDownArrowCallout" | "QuadArrowCallout" | "BentArrow" | "UturnArrow" | "CircularArrow" | "LeftCircularArrow" | "LeftRightCircularArrow" | "CurvedRightArrow" | "CurvedLeftArrow" | "CurvedUpArrow" | "CurvedDownArrow" | "SwooshArrow" | "Cube" | "Can" | "LightningBolt" | "Heart" | "Sun" | "Moon" | "SmileyFace" | "IrregularSeal1" | "IrregularSeal2" | "FoldedCorner" | "Bevel" | "Frame" | "HalfFrame" | "Corner" | "DiagonalStripe" | "Chord" | "Arc" | "LeftBracket" | "RightBracket" | "LeftBrace" | "RightBrace" | "BracketPair" | "BracePair" | "Callout1" | "Callout2" | "Callout3" | "AccentCallout1" | "AccentCallout2" | "AccentCallout3" | "BorderCallout1" | "BorderCallout2" | "BorderCallout3" | "AccentBorderCallout1" | "AccentBorderCallout2" | "AccentBorderCallout3" | "WedgeRectCallout" | "WedgeRRectCallout" | "WedgeEllipseCallout" | "CloudCallout" | "Cloud" | "Ribbon" | "Ribbon2" | "EllipseRibbon" | "EllipseRibbon2" | "LeftRightRibbon" | "VerticalScroll" | "HorizontalScroll" | "Wave" | "DoubleWave" | "Plus" | "FlowChartProcess" | "FlowChartDecision" | "FlowChartInputOutput" | "FlowChartPredefinedProcess" | "FlowChartInternalStorage" | "FlowChartDocument" | "FlowChartMultidocument" | "FlowChartTerminator" | "FlowChartPreparation" | "FlowChartManualInput" | "FlowChartManualOperation" | "FlowChartConnector" | "FlowChartPunchedCard" | "FlowChartPunchedTape" | "FlowChartSummingJunction" | "FlowChartOr" | "FlowChartCollate" | "FlowChartSort" | "FlowChartExtract" | "FlowChartMerge" | "FlowChartOfflineStorage" | "FlowChartOnlineStorage" | "FlowChartMagneticTape" | "FlowChartMagneticDisk" | "FlowChartMagneticDrum" | "FlowChartDisplay" | "FlowChartDelay" | "FlowChartAlternateProcess" | "FlowChartOffpageConnector" | "ActionButtonBlank" | "ActionButtonHome" | "ActionButtonHelp" | "ActionButtonInformation" | "ActionButtonForwardNext" | "ActionButtonBackPrevious" | "ActionButtonEnd" | "ActionButtonBeginning" | "ActionButtonReturn" | "ActionButtonDocument" | "ActionButtonSound" | "ActionButtonMovie" | "Gear6" | "Gear9" | "Funnel" | "MathPlus" | "MathMinus" | "MathMultiply" | "MathDivide" | "MathEqual" | "MathNotEqual" | "CornerTabs" | "SquareTabs" | "PlaqueTabs" | "ChartX" | "ChartStar" | "ChartPlus";
         /**
-         * The height, in points, of the shape.
+         * Specifies the height, in points, of the shape.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         height: number;
         /**
-         * The percentage of shape height to vertical relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+         * Specifies the percentage of shape height to the relative vertical size (that is, the `relativeVerticalSize` property). For an inline or child shape, it can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -113797,14 +113817,14 @@ declare namespace Word {
          */
         readonly isChild: boolean;
         /**
-         * The distance, in points, from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+         * Specifies the distance, in points, from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         left: number;
         /**
-         * The relative left position as a percentage from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline or child shape, it will return 0 and can't be set.
+         * Specifies the relative left position as a percentage from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalalPosition` property). For an inline or child shape, it will return 0 and can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -113818,35 +113838,35 @@ declare namespace Word {
          */
         lockAspectRatio: boolean;
         /**
-         * The name of the shape.
+         * Specifies the name of the shape.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         name: string;
         /**
-         * The relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+         * Specifies the relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         relativeHorizontalPosition: Word.RelativeHorizontalPosition | "Margin" | "Page" | "Column" | "Character" | "LeftMargin" | "RightMargin" | "InsideMargin" | "OutsideMargin";
         /**
-         * The relative horizontal size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+         * Specifies the relative horizontal size of the shape. Use with the `widthRelative` property. For an inline or child shape, it can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         relativeHorizontalSize: Word.RelativeSize | "Margin" | "Page" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
         /**
-         * The relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
+         * Specifies the relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         relativeVerticalPosition: Word.RelativeVerticalPosition | "Margin" | "Page" | "Paragraph" | "Line" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
         /**
-         * The relative vertical size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+         * Specifies the relative vertical size of the shape. Use with the `heightRelative` property. For an inline or child shape, it can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -113860,14 +113880,14 @@ declare namespace Word {
          */
         rotation: number;
         /**
-         * The distance, in points, from the top edge of the shape to the vertical relative position (see {@link Word.RelativeVerticalPosition}). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+         * Specifies the distance, in points, from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         top: number;
         /**
-         * The relative top position as a percentage from the top edge of the shape to the vertical relative position, see {@link Word.RelativeVerticalPosition}. For an inline or child shape, it will return 0 and can't be set.
+         * Specifies the relative top position as a percentage from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline or child shape, it will return 0 and can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -113888,14 +113908,14 @@ declare namespace Word {
          */
         visible: boolean;
         /**
-         * The width, in points, of the shape.
+         * Specifies the width, in points, of the shape.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
          */
         width: number;
         /**
-         * The percentage of shape width to horizontal relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+         * Specifies the percentage of shape width to the relative horizontal size (that is, the `relativeHorizontalSize` property). For an inline or child shape, it can't be set.
          *
          * @remarks
          * [Api set: WordApiDesktop 1.2]
@@ -117711,7 +117731,7 @@ declare namespace Word {
      */
     interface ContentControlAddedEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117725,7 +117745,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117740,7 +117760,7 @@ declare namespace Word {
      */
     interface ContentControlDataChangedEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117754,7 +117774,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117769,7 +117789,7 @@ declare namespace Word {
      */
     interface ContentControlDeletedEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117783,7 +117803,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117798,7 +117818,7 @@ declare namespace Word {
      */
     interface ContentControlEnteredEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117812,7 +117832,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117827,7 +117847,7 @@ declare namespace Word {
      */
     interface ContentControlExitedEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117841,7 +117861,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117942,7 +117962,7 @@ declare namespace Word {
      */
     interface ContentControlSelectionChangedEventArgs {
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117956,7 +117976,7 @@ declare namespace Word {
          */
         ids: number[];
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.5]
@@ -117971,14 +117991,14 @@ declare namespace Word {
      */
     interface ParagraphAddedEventArgs {
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.6]
          */
         source: Word.EventSource | "Local" | "Remote";
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.6]
@@ -118000,14 +118020,14 @@ declare namespace Word {
      */
     interface ParagraphChangedEventArgs {
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.6]
          */
         source: Word.EventSource | "Local" | "Remote";
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.6]
@@ -118029,14 +118049,14 @@ declare namespace Word {
      */
     interface ParagraphDeletedEventArgs {
         /**
-         * The source of the event. It can be local or remote (through coauthoring).
+         * Specifies the source of the event. It can be local or remote (through coauthoring).
          *
          * @remarks
          * [Api set: WordApi 1.6]
          */
         source: Word.EventSource | "Local" | "Remote";
         /**
-         * The event type. See `Word.EventType` for details.
+         * Specifies the event type. See `Word.EventType` for details.
          *
          * @remarks
          * [Api set: WordApi 1.6]
@@ -119007,7 +119027,7 @@ declare namespace Word {
         mixed = "Mixed",
     }
     /**
-     * The {@link Word.Border | border} types.
+     * Represents the {@link Word.Border | border} type.
      *
      * @remarks
      * [Api set: WordApi 1.3]
@@ -143036,7 +143056,7 @@ declare namespace Word {
         /** An interface for updating data on the `Shape` object, for use in `shape.set({ ... })`. */
         interface ShapeUpdateData {
             /**
-            * Represents the `Body` object of the shape. Only applies to text boxes and geometric shapes.
+            * Gets the `Body` object of the shape. Only applies to text boxes and geometric shapes.
             *
             * @remarks
             * [Api set: WordApiDesktop 1.2]
@@ -143106,35 +143126,35 @@ declare namespace Word {
              */
             altTextDescription?: string;
             /**
-             * The geometric shape type of the shape. It will be null if isn't a geometric shape.
+             * Specifies the geometric shape type of the shape. It will be null if isn't a geometric shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             geometricShapeType?: Word.GeometricShapeType | "LineInverse" | "Triangle" | "RightTriangle" | "Rectangle" | "Diamond" | "Parallelogram" | "Trapezoid" | "NonIsoscelesTrapezoid" | "Pentagon" | "Hexagon" | "Heptagon" | "Octagon" | "Decagon" | "Dodecagon" | "Star4" | "Star5" | "Star6" | "Star7" | "Star8" | "Star10" | "Star12" | "Star16" | "Star24" | "Star32" | "RoundRectangle" | "Round1Rectangle" | "Round2SameRectangle" | "Round2DiagonalRectangle" | "SnipRoundRectangle" | "Snip1Rectangle" | "Snip2SameRectangle" | "Snip2DiagonalRectangle" | "Plaque" | "Ellipse" | "Teardrop" | "HomePlate" | "Chevron" | "PieWedge" | "Pie" | "BlockArc" | "Donut" | "NoSmoking" | "RightArrow" | "LeftArrow" | "UpArrow" | "DownArrow" | "StripedRightArrow" | "NotchedRightArrow" | "BentUpArrow" | "LeftRightArrow" | "UpDownArrow" | "LeftUpArrow" | "LeftRightUpArrow" | "QuadArrow" | "LeftArrowCallout" | "RightArrowCallout" | "UpArrowCallout" | "DownArrowCallout" | "LeftRightArrowCallout" | "UpDownArrowCallout" | "QuadArrowCallout" | "BentArrow" | "UturnArrow" | "CircularArrow" | "LeftCircularArrow" | "LeftRightCircularArrow" | "CurvedRightArrow" | "CurvedLeftArrow" | "CurvedUpArrow" | "CurvedDownArrow" | "SwooshArrow" | "Cube" | "Can" | "LightningBolt" | "Heart" | "Sun" | "Moon" | "SmileyFace" | "IrregularSeal1" | "IrregularSeal2" | "FoldedCorner" | "Bevel" | "Frame" | "HalfFrame" | "Corner" | "DiagonalStripe" | "Chord" | "Arc" | "LeftBracket" | "RightBracket" | "LeftBrace" | "RightBrace" | "BracketPair" | "BracePair" | "Callout1" | "Callout2" | "Callout3" | "AccentCallout1" | "AccentCallout2" | "AccentCallout3" | "BorderCallout1" | "BorderCallout2" | "BorderCallout3" | "AccentBorderCallout1" | "AccentBorderCallout2" | "AccentBorderCallout3" | "WedgeRectCallout" | "WedgeRRectCallout" | "WedgeEllipseCallout" | "CloudCallout" | "Cloud" | "Ribbon" | "Ribbon2" | "EllipseRibbon" | "EllipseRibbon2" | "LeftRightRibbon" | "VerticalScroll" | "HorizontalScroll" | "Wave" | "DoubleWave" | "Plus" | "FlowChartProcess" | "FlowChartDecision" | "FlowChartInputOutput" | "FlowChartPredefinedProcess" | "FlowChartInternalStorage" | "FlowChartDocument" | "FlowChartMultidocument" | "FlowChartTerminator" | "FlowChartPreparation" | "FlowChartManualInput" | "FlowChartManualOperation" | "FlowChartConnector" | "FlowChartPunchedCard" | "FlowChartPunchedTape" | "FlowChartSummingJunction" | "FlowChartOr" | "FlowChartCollate" | "FlowChartSort" | "FlowChartExtract" | "FlowChartMerge" | "FlowChartOfflineStorage" | "FlowChartOnlineStorage" | "FlowChartMagneticTape" | "FlowChartMagneticDisk" | "FlowChartMagneticDrum" | "FlowChartDisplay" | "FlowChartDelay" | "FlowChartAlternateProcess" | "FlowChartOffpageConnector" | "ActionButtonBlank" | "ActionButtonHome" | "ActionButtonHelp" | "ActionButtonInformation" | "ActionButtonForwardNext" | "ActionButtonBackPrevious" | "ActionButtonEnd" | "ActionButtonBeginning" | "ActionButtonReturn" | "ActionButtonDocument" | "ActionButtonSound" | "ActionButtonMovie" | "Gear6" | "Gear9" | "Funnel" | "MathPlus" | "MathMinus" | "MathMultiply" | "MathDivide" | "MathEqual" | "MathNotEqual" | "CornerTabs" | "SquareTabs" | "PlaqueTabs" | "ChartX" | "ChartStar" | "ChartPlus";
             /**
-             * The height, in points, of the shape.
+             * Specifies the height, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             height?: number;
             /**
-             * The percentage of shape height to vertical relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape height to the relative vertical size (that is, the `relativeVerticalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             heightRelative?: number;
             /**
-             * The distance, in points, from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             left?: number;
             /**
-             * The relative left position as a percentage from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative left position as a percentage from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -143148,35 +143168,35 @@ declare namespace Word {
              */
             lockAspectRatio?: boolean;
             /**
-             * The name of the shape.
+             * Specifies the name of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             name?: string;
             /**
-             * The relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalPosition?: Word.RelativeHorizontalPosition | "Margin" | "Page" | "Column" | "Character" | "LeftMargin" | "RightMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative horizontal size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal size of the shape. Use with the `widthRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalSize?: Word.RelativeSize | "Margin" | "Page" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
+             * Specifies the relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeVerticalPosition?: Word.RelativeVerticalPosition | "Margin" | "Page" | "Paragraph" | "Line" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative vertical size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative vertical size of the shape. Use with the `heightRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -143190,14 +143210,14 @@ declare namespace Word {
              */
             rotation?: number;
             /**
-             * The distance, in points, from the top edge of the shape to the vertical relative position (see {@link Word.RelativeVerticalPosition}). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             top?: number;
             /**
-             * The relative top position as a percentage from the top edge of the shape to the vertical relative position, see {@link Word.RelativeVerticalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative top position as a percentage from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -143211,14 +143231,14 @@ declare namespace Word {
              */
             visible?: boolean;
             /**
-             * The width, in points, of the shape.
+             * Specifies the width, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             width?: number;
             /**
-             * The percentage of shape width to horizontal relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape width to the relative horizontal size (that is, the `relativeHorizontalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -150816,7 +150836,7 @@ declare namespace Word {
         /** An interface describing the data returned by calling `shape.toJSON()`. */
         interface ShapeData {
             /**
-            * Represents the `Body` object of the shape. Only applies to text boxes and geometric shapes.
+            * Gets the `Body` object of the shape. Only applies to text boxes and geometric shapes.
             *
             * @remarks
             * [Api set: WordApiDesktop 1.2]
@@ -150886,21 +150906,21 @@ declare namespace Word {
              */
             altTextDescription?: string;
             /**
-             * The geometric shape type of the shape. It will be null if isn't a geometric shape.
+             * Specifies the geometric shape type of the shape. It will be null if isn't a geometric shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             geometricShapeType?: Word.GeometricShapeType | "LineInverse" | "Triangle" | "RightTriangle" | "Rectangle" | "Diamond" | "Parallelogram" | "Trapezoid" | "NonIsoscelesTrapezoid" | "Pentagon" | "Hexagon" | "Heptagon" | "Octagon" | "Decagon" | "Dodecagon" | "Star4" | "Star5" | "Star6" | "Star7" | "Star8" | "Star10" | "Star12" | "Star16" | "Star24" | "Star32" | "RoundRectangle" | "Round1Rectangle" | "Round2SameRectangle" | "Round2DiagonalRectangle" | "SnipRoundRectangle" | "Snip1Rectangle" | "Snip2SameRectangle" | "Snip2DiagonalRectangle" | "Plaque" | "Ellipse" | "Teardrop" | "HomePlate" | "Chevron" | "PieWedge" | "Pie" | "BlockArc" | "Donut" | "NoSmoking" | "RightArrow" | "LeftArrow" | "UpArrow" | "DownArrow" | "StripedRightArrow" | "NotchedRightArrow" | "BentUpArrow" | "LeftRightArrow" | "UpDownArrow" | "LeftUpArrow" | "LeftRightUpArrow" | "QuadArrow" | "LeftArrowCallout" | "RightArrowCallout" | "UpArrowCallout" | "DownArrowCallout" | "LeftRightArrowCallout" | "UpDownArrowCallout" | "QuadArrowCallout" | "BentArrow" | "UturnArrow" | "CircularArrow" | "LeftCircularArrow" | "LeftRightCircularArrow" | "CurvedRightArrow" | "CurvedLeftArrow" | "CurvedUpArrow" | "CurvedDownArrow" | "SwooshArrow" | "Cube" | "Can" | "LightningBolt" | "Heart" | "Sun" | "Moon" | "SmileyFace" | "IrregularSeal1" | "IrregularSeal2" | "FoldedCorner" | "Bevel" | "Frame" | "HalfFrame" | "Corner" | "DiagonalStripe" | "Chord" | "Arc" | "LeftBracket" | "RightBracket" | "LeftBrace" | "RightBrace" | "BracketPair" | "BracePair" | "Callout1" | "Callout2" | "Callout3" | "AccentCallout1" | "AccentCallout2" | "AccentCallout3" | "BorderCallout1" | "BorderCallout2" | "BorderCallout3" | "AccentBorderCallout1" | "AccentBorderCallout2" | "AccentBorderCallout3" | "WedgeRectCallout" | "WedgeRRectCallout" | "WedgeEllipseCallout" | "CloudCallout" | "Cloud" | "Ribbon" | "Ribbon2" | "EllipseRibbon" | "EllipseRibbon2" | "LeftRightRibbon" | "VerticalScroll" | "HorizontalScroll" | "Wave" | "DoubleWave" | "Plus" | "FlowChartProcess" | "FlowChartDecision" | "FlowChartInputOutput" | "FlowChartPredefinedProcess" | "FlowChartInternalStorage" | "FlowChartDocument" | "FlowChartMultidocument" | "FlowChartTerminator" | "FlowChartPreparation" | "FlowChartManualInput" | "FlowChartManualOperation" | "FlowChartConnector" | "FlowChartPunchedCard" | "FlowChartPunchedTape" | "FlowChartSummingJunction" | "FlowChartOr" | "FlowChartCollate" | "FlowChartSort" | "FlowChartExtract" | "FlowChartMerge" | "FlowChartOfflineStorage" | "FlowChartOnlineStorage" | "FlowChartMagneticTape" | "FlowChartMagneticDisk" | "FlowChartMagneticDrum" | "FlowChartDisplay" | "FlowChartDelay" | "FlowChartAlternateProcess" | "FlowChartOffpageConnector" | "ActionButtonBlank" | "ActionButtonHome" | "ActionButtonHelp" | "ActionButtonInformation" | "ActionButtonForwardNext" | "ActionButtonBackPrevious" | "ActionButtonEnd" | "ActionButtonBeginning" | "ActionButtonReturn" | "ActionButtonDocument" | "ActionButtonSound" | "ActionButtonMovie" | "Gear6" | "Gear9" | "Funnel" | "MathPlus" | "MathMinus" | "MathMultiply" | "MathDivide" | "MathEqual" | "MathNotEqual" | "CornerTabs" | "SquareTabs" | "PlaqueTabs" | "ChartX" | "ChartStar" | "ChartPlus";
             /**
-             * The height, in points, of the shape.
+             * Specifies the height, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             height?: number;
             /**
-             * The percentage of shape height to vertical relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape height to the relative vertical size (that is, the `relativeVerticalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -150921,14 +150941,14 @@ declare namespace Word {
              */
             isChild?: boolean;
             /**
-             * The distance, in points, from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             left?: number;
             /**
-             * The relative left position as a percentage from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative left position as a percentage from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -150942,35 +150962,35 @@ declare namespace Word {
              */
             lockAspectRatio?: boolean;
             /**
-             * The name of the shape.
+             * Specifies the name of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             name?: string;
             /**
-             * The relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalPosition?: Word.RelativeHorizontalPosition | "Margin" | "Page" | "Column" | "Character" | "LeftMargin" | "RightMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative horizontal size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal size of the shape. Use with the `widthRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalSize?: Word.RelativeSize | "Margin" | "Page" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
+             * Specifies the relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeVerticalPosition?: Word.RelativeVerticalPosition | "Margin" | "Page" | "Paragraph" | "Line" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";
             /**
-             * The relative vertical size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative vertical size of the shape. Use with the `heightRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -150984,14 +151004,14 @@ declare namespace Word {
              */
             rotation?: number;
             /**
-             * The distance, in points, from the top edge of the shape to the vertical relative position (see {@link Word.RelativeVerticalPosition}). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             top?: number;
             /**
-             * The relative top position as a percentage from the top edge of the shape to the vertical relative position, see {@link Word.RelativeVerticalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative top position as a percentage from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -151012,14 +151032,14 @@ declare namespace Word {
              */
             visible?: boolean;
             /**
-             * The width, in points, of the shape.
+             * Specifies the width, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             width?: number;
             /**
-             * The percentage of shape width to horizontal relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape width to the relative horizontal size (that is, the `relativeHorizontalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -154231,7 +154251,7 @@ declare namespace Word {
             name?: boolean;
         }
         /**
-         * The data specific to content controls of type CheckBox.
+         * Represents the data specific to content controls of type `CheckBox`.
          *
          * @remarks
          * [Api set: WordApi 1.7]
@@ -156673,7 +156693,7 @@ declare namespace Word {
             xmlSaveThroughXslt?: boolean;
         }
         /**
-         * The `DocumentCreated` object is the top level object created by `Application.createDocument`. A `DocumentCreated` object is a special `Document` object.
+         * The `DocumentCreated` object is the top-level object created by `Application.createDocument`. A `DocumentCreated` object is a special `Document` object.
          *
          * @remarks
          * [Api set: WordApi 1.3]
@@ -163370,7 +163390,7 @@ declare namespace Word {
              */
             $all?: boolean;
             /**
-            * Represents the `Body` object of the shape. Only applies to text boxes and geometric shapes.
+            * Gets the `Body` object of the shape. Only applies to text boxes and geometric shapes.
             *
             * @remarks
             * [Api set: WordApiDesktop 1.2]
@@ -163440,21 +163460,21 @@ declare namespace Word {
              */
             altTextDescription?: boolean;
             /**
-             * The geometric shape type of the shape. It will be null if isn't a geometric shape.
+             * Specifies the geometric shape type of the shape. It will be null if isn't a geometric shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             geometricShapeType?: boolean;
             /**
-             * The height, in points, of the shape.
+             * Specifies the height, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             height?: boolean;
             /**
-             * The percentage of shape height to vertical relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape height to the relative vertical size (that is, the `relativeVerticalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163475,14 +163495,14 @@ declare namespace Word {
              */
             isChild?: boolean;
             /**
-             * The distance, in points, from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             left?: boolean;
             /**
-             * The relative left position as a percentage from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative left position as a percentage from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163496,35 +163516,35 @@ declare namespace Word {
              */
             lockAspectRatio?: boolean;
             /**
-             * The name of the shape.
+             * Specifies the name of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             name?: boolean;
             /**
-             * The relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalPosition?: boolean;
             /**
-             * The relative horizontal size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative horizontal size of the shape. Use with the `widthRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalSize?: boolean;
             /**
-             * The relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
+             * Specifies the relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeVerticalPosition?: boolean;
             /**
-             * The relative vertical size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * Specifies the relative vertical size of the shape. Use with the `heightRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163538,14 +163558,14 @@ declare namespace Word {
              */
             rotation?: boolean;
             /**
-             * The distance, in points, from the top edge of the shape to the vertical relative position (see {@link Word.RelativeVerticalPosition}). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * Specifies the distance, in points, from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             top?: boolean;
             /**
-             * The relative top position as a percentage from the top edge of the shape to the vertical relative position, see {@link Word.RelativeVerticalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * Specifies the relative top position as a percentage from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163566,14 +163586,14 @@ declare namespace Word {
              */
             visible?: boolean;
             /**
-             * The width, in points, of the shape.
+             * Specifies the width, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             width?: boolean;
             /**
-             * The percentage of shape width to horizontal relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * Specifies the percentage of shape width to the relative horizontal size (that is, the `relativeHorizontalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163644,7 +163664,7 @@ declare namespace Word {
              */
             $all?: boolean;
             /**
-            * For EACH ITEM in the collection: Represents the `Body` object of the shape. Only applies to text boxes and geometric shapes.
+            * For EACH ITEM in the collection: Gets the `Body` object of the shape. Only applies to text boxes and geometric shapes.
             *
             * @remarks
             * [Api set: WordApiDesktop 1.2]
@@ -163714,21 +163734,21 @@ declare namespace Word {
              */
             altTextDescription?: boolean;
             /**
-             * For EACH ITEM in the collection: The geometric shape type of the shape. It will be null if isn't a geometric shape.
+             * For EACH ITEM in the collection: Specifies the geometric shape type of the shape. It will be null if isn't a geometric shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             geometricShapeType?: boolean;
             /**
-             * For EACH ITEM in the collection: The height, in points, of the shape.
+             * For EACH ITEM in the collection: Specifies the height, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             height?: boolean;
             /**
-             * For EACH ITEM in the collection: The percentage of shape height to vertical relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * For EACH ITEM in the collection: Specifies the percentage of shape height to the relative vertical size (that is, the `relativeVerticalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163749,14 +163769,14 @@ declare namespace Word {
              */
             isChild?: boolean;
             /**
-             * For EACH ITEM in the collection: The distance, in points, from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * For EACH ITEM in the collection: Specifies the distance, in points, from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             left?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative left position as a percentage from the left side of the shape to the horizontal relative position, see {@link Word.RelativeHorizontalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * For EACH ITEM in the collection: Specifies the relative left position as a percentage from the left side of the shape to the relative horizontal position (that is, the `relativeHorizontalalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163770,35 +163790,35 @@ declare namespace Word {
              */
             lockAspectRatio?: boolean;
             /**
-             * For EACH ITEM in the collection: The name of the shape.
+             * For EACH ITEM in the collection: Specifies the name of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             name?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * For EACH ITEM in the collection: Specifies the relative horizontal position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalPosition?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative horizontal size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * For EACH ITEM in the collection: Specifies the relative horizontal size of the shape. Use with the `widthRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeHorizontalSize?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
+             * For EACH ITEM in the collection: Specifies the relative vertical position of the shape. For an inline shape, it can't be set. For details, see {@link Word.RelativeVerticalPosition}.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             relativeVerticalPosition?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative vertical size of the shape. For an inline or child shape, it can't be set. For details, see {@link Word.RelativeHorizontalPosition}.
+             * For EACH ITEM in the collection: Specifies the relative vertical size of the shape. Use with the `heightRelative` property. For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163812,14 +163832,14 @@ declare namespace Word {
              */
             rotation?: boolean;
             /**
-             * For EACH ITEM in the collection: The distance, in points, from the top edge of the shape to the vertical relative position (see {@link Word.RelativeVerticalPosition}). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
+             * For EACH ITEM in the collection: Specifies the distance, in points, from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline shape, it will return 0 and can't be set. For a child shape in a canvas or group, it's relative to the top left corner.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             top?: boolean;
             /**
-             * For EACH ITEM in the collection: The relative top position as a percentage from the top edge of the shape to the vertical relative position, see {@link Word.RelativeVerticalPosition}. For an inline or child shape, it will return 0 and can't be set.
+             * For EACH ITEM in the collection: Specifies the relative top position as a percentage from the top edge of the shape to the relative vertical position (that is, the `relativeVerticalPosition` property). For an inline or child shape, it will return 0 and can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
@@ -163840,14 +163860,14 @@ declare namespace Word {
              */
             visible?: boolean;
             /**
-             * For EACH ITEM in the collection: The width, in points, of the shape.
+             * For EACH ITEM in the collection: Specifies the width, in points, of the shape.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]
              */
             width?: boolean;
             /**
-             * For EACH ITEM in the collection: The percentage of shape width to horizontal relative size, see {@link Word.RelativeSize}. For an inline or child shape, it can't be set.
+             * For EACH ITEM in the collection: Specifies the percentage of shape width to the relative horizontal size (that is, the `relativeHorizontalSize` property). For an inline or child shape, it can't be set.
              *
              * @remarks
              * [Api set: WordApiDesktop 1.2]

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.560",
+    "version": "1.0.562",
     "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": "4b210c04f6c5d1db11ed538bcc30c827a1bab3a5d4163b719797a52b67dd05b1",
+    "typesPublisherContentHash": "5e2461c2eb3fdfcda51fdc575cf6ad2b02431eb3897019f8ed765eac2230f26a",
     "typeScriptVersion": "5.2"
 }