@types/office-js 1.0.520 → 1.0.522

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: Mon, 28 Jul 2025 18:44:19 GMT
+ * Last updated: Tue, 05 Aug 2025 18:02:59 GMT
  * Dependencies: none
 
 # Credits

office-js/index.d.ts

@@ -684,6 +684,20 @@ declare namespace Office {
          * [Api set: Mailbox 1.5]
          */
         ItemChanged,
+        /**
+         * Occurs in Outlook on the web and the new Outlook on Windows when messages or file attachments in the Outlook client window are
+         * dragged then dropped into the task pane of an add-in.
+         *
+         * To add an event handler for the `ItemDraggedAndDropped` event, use the `addHandlerAsync` method of the `Mailbox` object.
+         * The event handler receives an argument of type
+         * {@link https://learn.microsoft.com/javascript/api/outlook/office.draganddropeventargs | Office.DragAndDropEventArgs}.
+         *
+         * **Important**: The `ItemDraggedAndDropped` event isn't supported in Outlook on Windows (classic) and on Mac. If the `ItemDraggedAndDropped` handler
+         * runs on these clients, an error occurs ("This event isn't supported on this platform.").
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        ItemDraggedAndDropped,
         /**
          * Triggers when a `customXmlPart` node is deleted.
          */
@@ -14342,6 +14356,176 @@ declare namespace Office {
          */
         OWAView: MailboxEnums.OWAView | "OneColumn" | "TwoColumns" | "ThreeColumns";
     }
+    /**
+     * Provides details about the mouse pointer position and the messages or file attachments being dragged and dropped into an add-in's task pane when the
+     * `Office.EventType.ItemDraggedAndDropped` event is raised.
+     *
+     * @remarks
+     *
+     * [Api set: Mailbox 1.5]
+     * 
+     * To learn more about the drag-and-drop feature and how to implement it across various Outlook clients, see
+     * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/drag-drop-items | Drag and drop messages and attachments into the task pane of an Outlook add-in}.
+     */
+    export interface DragAndDropEventArgs {
+        /**
+         * Gets the details about the mouse pointer position within an add-in's task pane and the messages or file attachments being dragged and dropped into the task pane.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        dragAndDropEventData: DragoverEventData | DropEventData;
+        /**
+         * Gets the type of the event. For details, see {@link https://learn.microsoft.com/javascript/api/office/office.eventtype | Office.EventType}.
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        type: "olkDragAndDropEvent";
+    }
+    /**
+     * Represents the `DragAndDropEventArgs.dragAndDropEventData` object when messages or file attachments are dragged over an add-in's task pane.
+     *
+     * @remarks
+     *
+     * [Api set: Mailbox 1.5]
+     *
+     * To learn more about the drag-and-drop feature and how to implement it across various Outlook clients, see
+     * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/drag-drop-items | Drag and drop messages and attachments into the task pane of an Outlook add-in}.
+     */
+    interface DragoverEventData {
+        /**
+         * Gets the x-coordinate of the mouse pointer that represents the horizontal position in pixels.
+         * The position is relative to the left edge of the Outlook on the web or the new Outlook on Windows client window.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        pageX: number;
+        /**
+         * Gets the y-coordinate of the mouse pointer that represents the vertical position in pixels.
+         * The position is relative to the top edge of the Outlook on the web or the new Outlook on Windows client window.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        pageY: number;
+        /**
+         * Gets the type of drag-and-drop event. The `dragover` event occurs when messages or file attachments are dragged over an add-in's task pane.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        type: "dragover";
+    }
+    /**
+     * Represents the `DragAndDropEventArgs.dragAndDropEventData` object when messages or file attachments are dropped into an add-in's task pane.
+     *
+     * @remarks
+     *
+     * [Api set: Mailbox 1.5]
+     *
+     * To learn more about the drag-and-drop feature and how to implement it across various Outlook clients, see
+     * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/drag-drop-items | Drag and drop messages and attachments into the task pane of an Outlook add-in}.
+     */
+    interface DropEventData {
+        /**
+         * Gets the messages or file attachments being dragged and dropped into an add-in's task pane.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        dataTransfer: DroppedItems;
+        /**
+         * Gets the x-coordinate of the mouse pointer that represents the horizontal position in pixels.
+         * The position is relative to the left edge of the Outlook on the web or the new Outlook on Windows client window.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        pageX: number;
+        /**
+         * Gets the y-coordinate of the mouse pointer that represents the vertical position in pixels.
+         * The position is relative to the top edge of the Outlook on the web or the new Outlook on Windows client window.
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        pageY: number;
+        /**
+         * Gets the type of drag-and-drop event. The `drop` event occurs when messages or file attachments are dropped into an add-in's task pane.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        type: "drop";
+    }
+    /**
+     * Provides the messages or file attachments being dragged and dropped into an add-in's task pane.
+     *
+     * @remarks
+     *
+     * [Api set: Mailbox 1.5]
+     *
+     * To learn more about the drag-and-drop feature and how to implement it across various Outlook clients, see
+     * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/drag-drop-items | Drag and drop messages and attachments into the task pane of an Outlook add-in}.
+     */
+    interface DroppedItems {
+        /**
+         * Gets an array of the messages or file attachments being dragged and dropped into an add-in's task pane.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        files: DroppedItemDetails[]
+    }
+    /**
+     * Provides the contents and details of the message or file attachment being dragged and dropped into an add-in's task pane.
+     *
+     * @remarks
+     *
+     * [Api set: Mailbox 1.5]
+     *
+     * To learn more about the drag-and-drop feature and how to implement it across various Outlook clients, see
+     * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/drag-drop-items | Drag and drop messages and attachments into the task pane of an Outlook add-in}.
+     */
+    interface DroppedItemDetails {
+        /**
+         * Gets the contents of the file being dragged and dropped.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         *
+         * For guidance on how to retrieve data from a `Blob`, see the {@link https://developer.mozilla.org/docs/Web/API/Blob | File API documentation}.
+         */
+        fileContent: Blob;
+        /**
+         * Gets the name of the file being dragged and dropped.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         */
+        name: string;
+        /**
+         * Gets the type of the file being dragged and dropped.
+         *
+         * @remarks
+         *
+         * [Api set: Mailbox 1.5]
+         *
+         * **Important**: When a message is dragged into an add-in's task pane, it's dropped as a .eml file.
+         */
+        type: string;
+    }
     /**
      * Provides the email properties of the sender or specified recipients of an email message or appointment.
      *
@@ -92459,14 +92643,14 @@ 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;
         /**
-         * Gets the data of the content control when its type is 'CheckBox'. It's `null` otherwise.
+         * Gets the data of the content control when its type is `CheckBox`. It's `null` otherwise.
          *
          * @remarks
          * [Api set: WordApi 1.7]
          */
         readonly checkboxContentControl: Word.CheckboxContentControl;
         /**
-         * Gets the data of the content control when its type is 'ComboBox'. It's `null` otherwise.
+         * Gets the data of the content control when its type is `ComboBox`. It's `null` otherwise.
          *
          * @remarks
          * [Api set: WordApi 1.9]
@@ -92480,7 +92664,7 @@ declare namespace Word {
          */
         readonly contentControls: Word.ContentControlCollection;
         /**
-         * Gets the data of the content control when its type is 'DropDownList'. It's `null` otherwise.
+         * Gets the data of the content control when its type is `DropDownList`. It's `null` otherwise.
          *
          * @remarks
          * [Api set: WordApi 1.9]
@@ -92662,7 +92846,7 @@ declare namespace Word {
          * @remarks
          * [Api set: WordApi 1.3]
          */
-        readonly subtype: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText";
+        readonly subtype: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText" | "Group";
         /**
          * Specifies a tag to identify a content control.
          *
@@ -92690,7 +92874,7 @@ declare namespace Word {
          * @remarks
          * [Api set: WordApi 1.1]
          */
-        readonly type: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText";
+        readonly type: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText" | "Group";
         /**
          * Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate properties, or another API object of the same type.
          * @param properties A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.
@@ -102429,6 +102613,11 @@ declare namespace Word {
          * [Api set: WordApi 1.1]
          */
         plainText = "PlainText",
+        /**
+         * @remarks
+         * [Api set: WordApi 1.1]
+         */
+        group = "Group",
     }
     /**
      * ContentControl appearance.
@@ -107407,7 +107596,7 @@ declare namespace Word {
         /** An interface for updating data on the `ContentControl` object, for use in `contentControl.set({ ... })`. */
         interface ContentControlUpdateData {
             /**
-             * Gets the data of the content control when its type is 'CheckBox'. It's `null` otherwise.
+             * Gets the data of the content control when its type is `CheckBox`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.7]
@@ -109407,14 +109596,14 @@ declare namespace Word {
         /** An interface describing the data returned by calling `contentControl.toJSON()`. */
         interface ContentControlData {
             /**
-             * Gets the data of the content control when its type is 'CheckBox'. It's `null` otherwise.
+             * Gets the data of the content control when its type is `CheckBox`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.7]
              */
             checkboxContentControl?: Word.Interfaces.CheckboxContentControlData;
             /**
-             * Gets the data of the content control when its type is 'ComboBox'. It's `null` otherwise.
+            * Gets the data of the content control when its type is `ComboBox`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.9]
@@ -109428,7 +109617,7 @@ declare namespace Word {
              */
             contentControls?: Word.Interfaces.ContentControlData[];
             /**
-             * Gets the data of the content control when its type is 'DropDownList'. It's `null` otherwise.
+             * Gets the data of the content control when its type is `DropDownList`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.9]
@@ -109547,7 +109736,7 @@ declare namespace Word {
              * @remarks
              * [Api set: WordApi 1.3]
              */
-            subtype?: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText";
+            subtype?: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText" | "Group";
             /**
              * Specifies a tag to identify a content control.
              *
@@ -109575,7 +109764,7 @@ declare namespace Word {
              * @remarks
              * [Api set: WordApi 1.1]
              */
-            type?: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText";
+            type?: Word.ContentControlType | "Unknown" | "RichTextInline" | "RichTextParagraphs" | "RichTextTableCell" | "RichTextTableRow" | "RichTextTable" | "PlainTextInline" | "PlainTextParagraph" | "Picture" | "BuildingBlockGallery" | "CheckBox" | "ComboBox" | "DropDownList" | "DatePicker" | "RepeatingSection" | "RichText" | "PlainText" | "Group";
         }
         /** An interface describing the data returned by calling `contentControlCollection.toJSON()`. */
         interface ContentControlCollectionData {
@@ -112396,7 +112585,7 @@ declare namespace Word {
              */
             $all?: boolean;
             /**
-             * Gets the data of the content control when its type is 'CheckBox'. It's `null` otherwise.
+             * Gets the data of the content control when its type is `CheckBox`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.7]
@@ -112569,7 +112758,7 @@ declare namespace Word {
              */
             $all?: boolean;
             /**
-             * For EACH ITEM in the collection: Gets the data of the content control when its type is 'CheckBox'. It's `null` otherwise.
+            * For EACH ITEM in the collection: Gets the data of the content control when its type is `CheckBox`. It's `null` otherwise.
              *
              * @remarks
              * [Api set: WordApi 1.7]

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.520",
+    "version": "1.0.522",
     "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": "80099809888ae7e100dfcf21138a0a08b3fc85019da7fd1a9c9570e0a9044f6a",
-    "typeScriptVersion": "5.1"
+    "typesPublisherContentHash": "ac86e1a00cfbc9eef00d3634bbcc25a3f71a092942d875d5469715c5c8d70726",
+    "typeScriptVersion": "5.2"
 }