@types/office-js 1.0.521 → 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, 04 Aug 2025 23:02:18 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.
      *

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.521",
+    "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": "3f658806bee7d044b8a98c6fd6166c479beaab8b68034bf34b06b5b87c1335c1",
+    "typesPublisherContentHash": "ac86e1a00cfbc9eef00d3634bbcc25a3f71a092942d875d5469715c5c8d70726",
     "typeScriptVersion": "5.2"
 }