[office-js][office-js-preview] (Outlook) Clarify attachment types and extensions (DefinitelyTyped#72357)

Author: samantharamon

types/office-js-preview/index.d.ts

@@ -12844,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;
         /**
@@ -12857,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;
         /**
@@ -12909,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;
         /**

types/office-js/index.d.ts

@@ -12757,6 +12757,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;
         /**
@@ -12770,8 +12785,23 @@ 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 Item**, or 
+         * **Forward as Attachment** is of type `Office.MailboxEnums.AttachmentType.Item`. A file name extension isn't returned in the `name` property.
+         * A calendar item that's attached 
+         *
+         * - 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;
         /**
@@ -12822,8 +12852,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;
         /**