@types/office-js-preview 1.0.390 → 1.0.392

office-js-preview/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-preview.
 
 ### Additional Details
- * Last updated: Tue, 06 Jun 2023 23:02:52 GMT
+ * Last updated: Tue, 13 Jun 2023 23:02:50 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -1550,13 +1550,19 @@ declare namespace Office {
          * 
          * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/identity-api-requirement-sets | IdentityAPI 1.3}
          *
-         * **Important**: In Outlook, this API isn't supported in the following scenarios.
+         * **Important**:
+         *
+         * - In Outlook, this API isn't supported in the following scenarios.
+         *
+         *   - If the add-in is loaded in an Outlook.com or Gmail mailbox.
          *
-         * - If the add-in is loaded in an Outlook.com or Gmail mailbox.
+         *   - If the add-in is loaded in Outlook on the web in the Safari browser. This results in error 13001 ("The user is not signed into Office").
          *
-         * - If the add-in is loaded in Outlook on the web in the Safari browser. This results in error 13001 ("The user is not signed into Office").
+         * - In Outlook on the web, if you use the
+         * {@link https://learn.microsoft.com/javascript/api/office/office.ui#office-office-ui-displaydialogasync-member(1) | displayDialogAsync}
+         * method to open a dialog, you must close the dialog before you can call `getAccessToken`.
          *
-         * **Note**: In an Outlook event-based activation add-in, this API is supported in Outlook on Windows starting from Version 2111 (Build 14701.20000).
+         * - 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://learn.microsoft.com/javascript/api/office-runtime/officeruntime.auth?view=common-js-preview#office-runtime-officeruntime-auth-getaccesstoken-member(1) |
          * OfficeRuntime.auth.getAccessToken} instead. For more information, see 
@@ -19745,8 +19751,15 @@ declare namespace OfficeExtension {
         readonly debugInfo: RequestContextDebugInfo;
     }
 
+    /**
+     * Specifies options for a session of a Visio diagram embedded in a SharePoint page. Called by constructor of `EmbeddedSession`.
+	 * For more information, see {@link https://learn.microsoft.com/office/dev/add-ins/reference/overview/visio-javascript-reference-overview | Visio JavaScript API overview}.
+     */
     interface EmbeddedOptions {
         sessionKey?: string,
+		/*
+		* The iframe element that hosts the Visio diagram.
+		*/
         container?: HTMLElement,
         id?: string;
         timeoutInMilliseconds?: number;
@@ -19754,8 +19767,15 @@ declare namespace OfficeExtension {
         width?: string;
     }
 
+    /**
+     * Represents a session of a Visio diagram embedded in a SharePoint page. 
+	 * For more information, see {@link https://learn.microsoft.com/office/dev/add-ins/reference/overview/visio-javascript-reference-overview | Visio JavaScript API overview}.
+     */
     class EmbeddedSession {
         constructor(url: string, options?: EmbeddedOptions);
+		/**
+		* Initializes the session.
+		*/
         public init(): Promise<any>;
     }
 
@@ -19921,13 +19941,25 @@ declare namespace OfficeExtension {
         remove(handler: (args: T) => Promise<any>): void;
     }
 
+    /**
+    * Enables the removal of an event handler. Returned by the `EventHandlers.add` method.
+	*
+	* **Note**: The same {@link OfficeExtension.ClientRequestContext | RequestContext} object that the handler was added in must be used when removing the handler.
+    * More information can be found in {@link https://learn.microsoft.com/office/dev/add-ins/excel/excel-add-ins-events#remove-an-event-handler | Remove an event handler}.
+    */
     class EventHandlerResult<T> {
         constructor(context: ClientRequestContext, handlers: EventHandlers<T>, handler: (args: T) => Promise<any>);
         /** The request context associated with the object */
         context: ClientRequestContext;
+		/**
+		* Removes the handler from the event.
+		*/
         remove(): void;
     }
 
+    /**
+	* Used by Office to construct event handlers. Do not call in your code.
+	*/
     interface EventInfo<T> {
         registerFunc: (callback: (args: any) => void) => Promise<any>;
         unregisterFunc: (callback: (args: any) => void) => Promise<any>;

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.390",
+    "version": "1.0.392",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "4132ee09f0f1aa62aff386a27be22dd3368ff1dd3ea773aaefacf70199b41ad0",
+    "typesPublisherContentHash": "d1594d9b07c6dc9f5d7d3485f09c19a9482348312886cbc25db0997c0659239a",
     "typeScriptVersion": "4.3"
 }