@types/office-js-preview 1.0.668 → 1.0.670

office-js-preview/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for office-js-preview (https://github.com
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
 
 ### 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-preview/index.d.ts

@@ -32093,7 +32093,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]
@@ -32102,7 +32102,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]
@@ -32111,7 +32111,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]
@@ -32120,7 +32120,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]
@@ -32132,7 +32132,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]
@@ -34625,10 +34625,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.
@@ -34800,11 +34807,11 @@ declare namespace Excel {
     class RequestContext extends OfficeCore.RequestContext {
         constructor(url?: string | Session, invocation?: {
             invocationId: number;
-            isInCFSyncScenario: boolean;
+            isInSyncExecution: boolean;
         });
         setInvocation(invocation: {
             invocationId: number;
-            isInCFSyncScenario: boolean;
+            isInSyncExecution: boolean;
         }): void;
         readonly workbook: Workbook;
         readonly application: Application;
@@ -34827,7 +34834,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]
          */
@@ -39860,6 +39866,66 @@ declare namespace Excel {
         */
         toJSON(): Excel.Interfaces.IterativeCalculationData;
     }
+    /**
+     * Specifies the type of autorun event.
+     *
+     * @remarks
+     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+     * @beta
+     */
+    enum AutorunEventType {
+        /**
+         * The autorun event type is unknown.
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         */
+        unknown = "Unknown",
+        /**
+         * The autorun event type is triggered when the document is saved.
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         */
+        onDocumentSave = "OnDocumentSave",
+        /**
+         * The autorun event type is triggered when the document is saved as a new file.
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         */
+        onDocumentSaveAs = "OnDocumentSaveAs"
+    }
+    /**
+     * Specifies the options for completing an autorun event.
+     *
+     * @remarks
+     * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+     * @beta
+     */
+    interface AutorunEventCompletedOptions {
+        /**
+         * Specifies whether to allow the event to proceed. The default value is `false`.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        allowEvent: boolean;
+        /**
+         * Specifies the type of autorun event to be completed if allowed. The default value is `unknown`.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        autorunEventType: Excel.AutorunEventType | "Unknown" | "OnDocumentSave" | "OnDocumentSaveAs";
+        /**
+         * If provided, specifies an optional error message if the event isn't allowed to proceed. The default value is "" (empty string).
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         */
+        message?: string;
+    }
     /**
      * Workbook is the top level object which contains related workbook objects such as worksheets, tables, and ranges.
                 To learn more about the workbook object model, read {@link https://learn.microsoft.com/office/dev/add-ins/excel/excel-add-ins-workbooks | Work with workbooks using the Excel JavaScript API}.
@@ -40139,6 +40205,16 @@ declare namespace Excel {
         set(properties: Interfaces.WorkbookUpdateData, options?: OfficeExtension.UpdateOptions): void;
         /** Sets multiple properties on the object at the same time, based on an existing loaded object. */
         set(properties: Excel.Workbook): void;
+        /**
+         * Notifies the host application that the add-in's code has finished running in an autorun event.
+         *
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         * @beta
+         *
+         * @param AutorunEventCompletedOptions Required. Options for completing the autorun event.
+         */
+        autorunEventCompleted(AutorunEventCompletedOptions: Excel.AutorunEventCompletedOptions): void;
         /**
          * Close current workbook.
          *
@@ -40158,8 +40234,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]
@@ -40254,7 +40329,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]
@@ -45290,35 +45368,35 @@ declare namespace Excel {
      */
     enum TableSource {
         /**
-         * External data source (such as Microsoft SharePoint Foundation).
+         * An external data source, such as Microsoft SharePoint Foundation.
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
         external = "External",
         /**
-         * An Excel range object.
+         * A range object in this worksheet.
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
         range = "Range",
         /**
-         * XML data source.
+         * An XML data source.
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
         xml = "Xml",
         /**
-         * Query data source.
+         * A Power Query query data source.
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
         query = "Query",
         /**
-         * Power Pivot model.
+         * A Power Pivot model.
          * @remarks
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
@@ -66334,7 +66412,13 @@ declare namespace Excel {
          * [Api set: ExcelApi BETA (PREVIEW ONLY)]
          * @beta
          */
-        externalCodeServiceDiffResultReceived = "ExternalCodeServiceDiffResultReceived"
+        externalCodeServiceDiffResultReceived = "ExternalCodeServiceDiffResultReceived",
+        /**
+         * AugmentationLoopUploadStatusChanged represents the type of event registered when the upload status of the augmentation loop changes.
+         * @remarks
+         * [Api set: ExcelApi BETA (PREVIEW ONLY)]
+         */
+        augmentationLoopUploadStatusChanged = "AugmentationLoopUploadStatusChanged"
     }
     /**
      * @remarks
@@ -69276,6 +69360,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]
@@ -69283,6 +69368,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]
@@ -69290,6 +69376,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]
@@ -79271,6 +79358,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]
@@ -79278,6 +79366,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]
@@ -79285,6 +79374,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]
@@ -86969,6 +87059,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]
@@ -86976,6 +87067,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]
@@ -86983,6 +87075,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]
@@ -99738,6 +99831,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]
@@ -99745,6 +99839,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]
@@ -99752,6 +99847,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]
@@ -102869,7 +102965,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]
@@ -108940,7 +109036,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]
@@ -109331,7 +109427,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]
@@ -109394,7 +109490,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]
@@ -120675,7 +120771,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]
@@ -120745,21 +120841,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]
@@ -120780,14 +120876,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]
@@ -120801,35 +120897,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]
@@ -120843,14 +120939,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]
@@ -120871,14 +120967,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]
@@ -124783,7 +124879,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]
@@ -124797,7 +124893,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]
@@ -124812,7 +124908,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]
@@ -124826,7 +124922,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]
@@ -124841,7 +124937,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]
@@ -124855,7 +124951,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]
@@ -124870,7 +124966,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]
@@ -124884,7 +124980,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]
@@ -124899,7 +124995,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]
@@ -124913,7 +125009,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]
@@ -125014,7 +125110,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]
@@ -125028,7 +125124,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]
@@ -125043,14 +125139,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]
@@ -125072,14 +125168,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]
@@ -125101,14 +125197,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]
@@ -125147,7 +125243,7 @@ declare namespace Word {
          */
         commentDetails: Word.CommentDetail[];
         /**
-         * 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 BETA (PREVIEW ONLY)]
@@ -125155,7 +125251,7 @@ declare namespace Word {
          */
         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 BETA (PREVIEW ONLY)]
@@ -126233,7 +126329,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]
@@ -151693,7 +151789,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]
@@ -151763,35 +151859,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]
@@ -151805,35 +151901,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]
@@ -151847,14 +151943,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]
@@ -151868,14 +151964,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]
@@ -159568,7 +159664,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]
@@ -159638,21 +159734,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]
@@ -159673,14 +159769,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]
@@ -159694,35 +159790,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]
@@ -159736,14 +159832,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]
@@ -159764,14 +159860,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]
@@ -163007,7 +163103,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]
@@ -165555,7 +165651,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]
@@ -172300,7 +172396,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]
@@ -172370,21 +172466,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]
@@ -172405,14 +172501,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]
@@ -172426,35 +172522,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]
@@ -172468,14 +172564,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]
@@ -172496,14 +172592,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]
@@ -172574,7 +172670,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]
@@ -172644,21 +172740,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]
@@ -172679,14 +172775,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]
@@ -172700,35 +172796,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]
@@ -172742,14 +172838,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]
@@ -172770,14 +172866,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-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.668",
+    "version": "1.0.670",
     "description": "TypeScript definitions for office-js-preview",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -46,7 +46,7 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {},
-    "typesPublisherContentHash": "bb6fe4b9767f1027f964f853bad0ed394331756d824a4207ac4304ac0cb1505a",
+    "typesPublisherContentHash": "0287982a183ca08ca2e883defbd95e4f77e6a1b9fcf6dfed7269343116724a2b",
     "typeScriptVersion": "5.2",
     "nonNpm": true
 }