@types/office-js-preview 1.0.578 → 1.0.580

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: Fri, 28 Mar 2025 14:36:00 GMT
+ * Last updated: Mon, 07 Apr 2025 19:02:16 GMT
  * Dependencies: none
 
 # Credits

office-js-preview/index.d.ts

@@ -641,14 +641,20 @@ declare namespace Office {
         /**
          * Occurs in Outlook when an action is selected on a notification message with a defined
          * {@link https://learn.microsoft.com/javascript/api/outlook/office.notificationmessagedetails#actions | custom action}.
-         * Currently, "Dismiss" is the only supported action that fires this event.
-         *
-         * **Important**: This event can only be handled in a task pane. Function commands can't register a handler for this event.
+         * Currently, **Dismiss** is the only supported action that fires this event.
          *
          * To add an event handler for the `InfobarClicked` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
          * {@link https://learn.microsoft.com/javascript/api/outlook/office.infobarclickedeventargs?view=outlook-js-1.10 | Office.InfobarClickedEventArgs}.
          *
+         * **Important**:
+         *
+         * - This event can only be handled in a task pane. Function commands can't register a handler for this event.
+         *
+         * - Although Outlook on Mac supports the `InsightMessage` notification type, it currently doesn't support the `InfobarClicked` event.
+         * To determine when the **Dismiss** action is selected from the notification, implement a handler for the `OnInfoBarDismissClicked` event instead.
+         * For more information, see {@link https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch#supported-events | Configure your Outlook add-in for event-based activation}.
+         *
          * [Api set: Mailbox 1.10]
          */
         InfobarClicked,
@@ -12838,6 +12844,21 @@ declare namespace Office {
     interface AttachmentDetailsCompose {
         /**
          * Gets a value that indicates the attachment's type.
+         *
+         * @remarks
+         *
+         * **Important**:
+         *
+         * - In Outlook on the web and new Outlook on Windows, a message or appointment that's locally saved then attached using
+         * drag-and-drop or the **Attach Item** option is of type `Office.MailboxEnums.AttachmentType.File`. The file name extension is
+         * returned in the `name` property. However, a message or appointment that's attached using the **Forward as Attachment** option
+         * is of type `Office.MailboxEnums.AttachmentType.Item`. In this case, an extension isn't returned in the `name` property.
+         *
+         * - In classic Outlook on Windows, a message or appointment that's attached using drag-and-drop, **Attach File**, or 
+         * **Forward as Attachment** is of type `Office.MailboxEnums.AttachmentType.Item`. A file name extension isn't returned in the `name` property.
+         *
+         * - In Outlook on Mac, a message or appointment that's attached using drag-and-drop, **Attach Item**, or **Forward as Attachment** is of type
+         * `Office.MailboxEnums.AttachmentType.File`. The file name extension is returned in the `name` property.
          */
         attachmentType: MailboxEnums.AttachmentType | string;
         /**
@@ -12851,8 +12872,22 @@ declare namespace Office {
         /**
          * Gets the name of the attachment.
          *
-         * **Important**: For message or appointment items that were attached by drag-and-drop or "Attach Item",
-         * `name` includes a file extension in Outlook on Mac, but excludes the extension on the web or on Windows.
+         * @remarks
+         *
+         * **Important**:
+         *
+         * - An attachment of type `Office.MailboxEnums.AttachmentType.Item` doesn't return a file name extension in the `name` property.
+         *
+         * - In Outlook on the web and new Outlook on Windows, a message or appointment that's locally saved then attached using
+         * drag-and-drop or the **Attach Item** option is of type `Office.MailboxEnums.AttachmentType.File`. The file name extension is
+         * returned in the `name` property. However, a message or appointment that's attached using the **Forward as Attachment** option
+         * is of type `Office.MailboxEnums.AttachmentType.Item`. In this case, an extension isn't returned in the `name` property.
+         *
+         * - In classic Outlook on Windows, a message or appointment that's attached using drag-and-drop, **Attach File**, or 
+         * **Forward as Attachment** is of type `Office.MailboxEnums.AttachmentType.Item`. A file name extension isn't returned in the `name` property.
+         *
+         * - In Outlook on Mac, a message or appointment that's attached using drag-and-drop, **Attach Item**, or **Forward as Attachment** is of type
+         * `Office.MailboxEnums.AttachmentType.File`. The file name extension is returned in the `name` property.
          */
         name: string;
         /**
@@ -12903,8 +12938,9 @@ declare namespace Office {
         /**
          * Gets the name of the attachment.
          *
-         * **Important**: For message or appointment items that were attached by drag-and-drop or "Attach Item",
-         * `name` includes a file extension in Outlook on Mac, but excludes the extension on the web or on Windows.
+         * @remarks
+         *
+         * **Important**: An attachment of type `Office.MailboxEnums.AttachmentType.Item` doesn't return a file name extension in the `name` property.
          */
         name: string;
         /**
@@ -21493,6 +21529,10 @@ declare namespace Office {
          *
          * - To retrieve the JSON data, call `Office.context.mailboxitem.getInitializationContextAsync`. If you create a JSON string using
          * `JSON.stringify()` and assign it to the `contextData` property, you must parse the string using `JSON.parse()` once you retrieve it.
+         *
+         * - To prevent the task pane of a notification message from relaunching if it's already open, implement a handler for the `Office.EventType.InitializationContextChanged` event.
+         * You can then pass the {@link https://learn.microsoft.com/javascript/api/outlook/office.initializationcontextchangedeventargs?view=outlook-js-1.15&preserve-view=true | event arguments}
+         * to the `contextData` property.
          */
         contextData: any;
     }
@@ -23638,6 +23678,10 @@ declare namespace Office {
          *
          * - When you configure a button in the Smart Alerts dialog to run a function, a button for the function is also added to the ribbon or action bar of the Outlook client.
          * Use the `contextData` option to distinguish when a user runs the function from the Smart Alerts dialog.
+         *
+         * - To prevent the task pane of a Smart Alerts add-in from relaunching if it's already open, implement a handler for the `Office.EventType.InitializationContextChanged` event.
+         * You can then pass the {@link https://learn.microsoft.com/javascript/api/outlook/office.initializationcontextchangedeventargs?view=outlook-js-1.15&preserve-view=true | event arguments}
+         * to the `contextData` property.
          */
         contextData?: any;
         /**
@@ -23817,6 +23861,10 @@ declare namespace Office {
          *
          * - If you implement a task pane to open after a reported message is processed, when the `event.completed` call occurs, any task pane that's open or pinned is closed.
          *
+         * - To prevent the task pane of a spam-reporting add-in from relaunching if it's already open, implement a handler for the `Office.EventType.InitializationContextChanged` event.
+         * You can then pass the {@link https://learn.microsoft.com/javascript/api/outlook/office.initializationcontextchangedeventargs?view=outlook-js-1.15&preserve-view=true | event arguments}
+         * to the `contextData` property.
+         *
          * - To retrieve the value of the `contextData` property, you must call `Office.context.mailbox.item.getInitializationContextAsync` in the JavaScript implementation
          * of your task pane. If you create a JSON string using `JSON.stringify()` and assign it to the `contextData` property, you must parse the string using
          * `JSON.parse()` once you retrieve it.

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.578",
+    "version": "1.0.580",
     "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": "92a16fdc89a304c4b24c4a469a66d043399641535d15a78ed0428acfc28a5cb3",
-    "typeScriptVersion": "5.0",
+    "typesPublisherContentHash": "b544b621420d74839b7f9239bc4c72dfbd4b77d83bed4b7dfc25fd3c2c532bff",
+    "typeScriptVersion": "5.1",
     "nonNpm": true
 }