@types/office-js 1.0.263 → 1.0.266

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: Wed, 15 Jun 2022 19:01:36 GMT
+ * Last updated: Tue, 28 Jun 2022 23:32:26 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js/index.d.ts

@@ -1459,9 +1459,15 @@ declare namespace Office {
          *
          * **Hosts**: Excel, OneNote, Outlook, PowerPoint, Word
          * 
-         * **Important**: In Outlook, this API is not supported if the add-in is loaded in an Outlook.com or Gmail mailbox. 
-         *
          * **Requirement set**: {@link https://docs.microsoft.com/javascript/api/requirement-sets/common/identity-api-requirement-sets | IdentityAPI 1.3}
+         * 
+         * **Important**: In Outlook, this API isn't supported if the add-in is loaded in an Outlook.com or Gmail mailbox.
+         * 
+         * **Note**: In an Outlook event-based activation add-in, this API is supported in Outlook on Windows starting from version 2111 (build 14701.20000).
+         * To retrieve an access token in older builds, use 
+         * {@link https://docs.microsoft.com/javascript/api/office-runtime/officeruntime.auth?view=common-js#office-runtime-officeruntime-auth-getaccesstoken-member(1) | 
+         * OfficeRuntime.auth.getAccessToken} instead. For more information, see 
+         * {@link https://docs.microsoft.com/office/dev/add-ins/outlook/use-sso-in-event-based-activation | Enable single sign-on (SSO) in Outlook add-ins that use event-based activation}.
          *
          * @param options - Optional. Accepts an `AuthOptions` object to define sign-on behaviors.
          * @returns Promise to the access token.
@@ -10616,9 +10622,9 @@ declare namespace Office {
         *
         * - Windows: 500 members
         *
-        * - Mac: 100 members
+        * - Classic Mac UI: 100 members
         *
-        * - Other: No limit
+        * - New Mac UI, web browser, Android: No limit
         *
         * *Compose mode*
         *
@@ -10654,9 +10660,9 @@ declare namespace Office {
         *
         * - Windows: 500 members
         *
-        * - Mac: 100 members
+        * - Classic Mac UI: 100 members
         *
-        * - Other: No limit
+        * - New Mac UI, web browser, Android: No limit
         *
         * *Compose mode*
         *
@@ -10928,9 +10934,9 @@ declare namespace Office {
          *
          * - Windows: 500 members
          *
-         * - Mac: 100 members
+         * - Classic Mac UI: 100 members
          *
-         * - Other: No limit
+         * - New Mac UI, web browser, Android: No limit
          *
          * @remarks
          *
@@ -10976,9 +10982,9 @@ declare namespace Office {
          *
          * - Windows: 500 members
          *
-         * - Mac: 100 members
+         * - Classic Mac UI: 100 members
          *
-         * - Other: No limit
+         * - New Mac UI, web browser, Android: No limit
          *
          * @remarks
          *
@@ -15551,11 +15557,11 @@ declare namespace Office {
          *
          * - Windows: 500 members
          *
-         * - Mac: 100 members
+         * - Classic Mac UI: 100 members
          *
          * - Web browser: 20 members
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          *
@@ -15849,11 +15855,11 @@ declare namespace Office {
          *
          * - Windows: 500 members
          *
-         * - Mac: 100 members
+         * - Classic Mac UI: 100 members
          *
          * - Web browser: 20 members
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          *
@@ -16802,9 +16808,9 @@ declare namespace Office {
          * - Windows: 100 recipients.
          * **Note**: Can call API repeatedly but the maximum number of recipients in the target field on the item is 500 recipients.
          *
-         * - Mac, web browser: 100 recipients
+         * - Classic Mac UI, web browser: 100 recipients
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]
@@ -16840,9 +16846,9 @@ declare namespace Office {
          * - Windows: 100 recipients.
          * **Note**: Can call API repeatedly but the maximum number of recipients in the target field on the item is 500 recipients.
          *
-         * - Mac, web browser: 100 recipients
+         * - Classic Mac UI, web browser: 100 recipients
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]
@@ -16866,14 +16872,9 @@ declare namespace Office {
          * When the call completes, the `asyncResult.value` property will contain an array of {@link Office.EmailAddressDetails | EmailAddressDetails}
          * objects. Collection size limits:
          *
-         * - Windows, Mac, web browser: 500 members
-         *
-         * - Other: No limit
+         * - Windows, classic Mac UI, web browser: 500 members
          *
-         * **Important**: In Outlook on the web, if a user created a new message by activating a contact's email address link from their contact or
-         * profile card, your add-in's `getAsync` call currently won't return a value in the `displayName` property of the
-         * associated `EmailAddressDetails` object. For more details, refer to the
-         * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]
@@ -16882,6 +16883,24 @@ declare namespace Office {
          * 
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          * 
+         * **Important**: In Outlook on the web and on Windows, if a user creates a new message by activating a contact's email address link from their contact
+         * or profile card, your add-in's `Recipients.getAsync` call returns the contact's email address in the `displayName` property of the associated
+         * `EmailAddressDetails` object instead of the contact's saved name. For more details, refer to the
+         * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
+         * 
+         * **Important**: The `getAsync` method only returns recipients resolved by the Outlook client. A resolved recipient has the following characteristics.
+         * 
+         * - If the recipient has a saved entry in the sender's address book, Outlook resolves the email address to the recipient's saved display name.
+         * 
+         * - A Teams meeting status icon appears before the recipient's name or email address.
+         * 
+         * - A semicolon appears after the recipient's name or email address.
+         * 
+         * - The recipient's name or email address is underlined or enclosed in a box.
+         * 
+         * To resolve an email address once it's added to a mail item, the sender must use the **Tab** key or select a suggested contact or email address from 
+         * the auto-complete list.
+         * 
          * @param options - An object literal that contains one or more of the following properties.
          *        `asyncContext`: Developers can provide any object they wish to access in the callback method.
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
@@ -16894,14 +16913,9 @@ declare namespace Office {
          * When the call completes, the `asyncResult.value` property will contain an array of {@link Office.EmailAddressDetails | EmailAddressDetails}
          * objects. Collection size limits:
          *
-         * - Windows, Mac, web browser: 500 members
-         *
-         * - Other: No limit
+         * - Windows, classic Mac UI, web browser: 500 members
          *
-         * **Important**: In Outlook on the web, if a user created a new message by activating a contact's email address link from their contact or
-         * profile card, your add-in's `getAsync` call currently won't return a value in the `displayName` property of the
-         * associated `EmailAddressDetails` object. For more details, refer to the
-         * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]
@@ -16910,6 +16924,24 @@ declare namespace Office {
          * 
          * **{@link https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
+         * **Important**: In Outlook on the web and on Windows, if a user creates a new message by activating a contact's email address link from their contact
+         * or profile card, your add-in's `Recipients.getAsync` call returns the contact's email address in the `displayName` property of the associated
+         * `EmailAddressDetails` object instead of the contact's saved name. For more details, refer to the
+         * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
+         * 
+         * **Important**: The `getAsync` method only returns recipients resolved by the Outlook client. A resolved recipient has the following characteristics.
+         * 
+         * - If the recipient has a saved entry in the sender's address book, Outlook resolves the email address to the recipient's saved display name.
+         * 
+         * - A Teams meeting status icon appears before the recipient's name or email address.
+         * 
+         * - A semicolon appears after the recipient's name or email address.
+         * 
+         * - The recipient's name or email address is underlined or enclosed in a box.
+         * 
+         * To resolve an email address once it's added to a mail item, the sender must use the **Tab** key or select a suggested contact or email address from 
+         * the auto-complete list.
+         * 
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter
          *                 of type `Office.AsyncResult`. The `value` property of the result is an array of `EmailAddressDetails` objects.
          */
@@ -16929,9 +16961,12 @@ declare namespace Office {
          *
          * Maximum number that can be set:
          *
-         * - Windows, Mac, web browser: 100 recipients
+         * - Windows: 100 recipients.
+         * **Note**: Can call API repeatedly but the maximum number of recipients in the target field on the item is 500 recipients.
+         *
+         * - Classic Mac UI, web browser: 100 recipients
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]
@@ -16967,9 +17002,12 @@ declare namespace Office {
          *
          * Maximum number that can be set:
          *
-         * - Windows, Mac, web browser: 100 recipients
+         * - Windows: 100 recipients.
+         * **Note**: Can call API repeatedly but the maximum number of recipients in the target field on the item is 500 recipients.
+         *
+         * - Classic Mac UI, web browser: 100 recipients
          *
-         * - Other: No limit
+         * - New Mac UI, Android: No limit
          *
          * @remarks
          * [Api set: Mailbox 1.1]

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.263",
+    "version": "1.0.266",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "0d8be1ddd61cfabd84913fc5207a6f0c7aa3423c45962333b3bb93bb35970223",
+    "typesPublisherContentHash": "0ed2d9c97fc5f0d41dbb1a23226ff853bd56f0cae874222fb3ef74c97248d56f",
     "typeScriptVersion": "4.0"
 }