[office-js][office-js-preview] (UI/UX) Document TaskPaneApi 1.1 requirement set (DefinitelyTyped#73732)

Author: samantharamon

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

@@ -6885,6 +6885,23 @@ declare namespace Office {
          */
         name: string;
     }
+    /**
+     * Provides options to manage the user interface of an Office Add-in while the add-in is running.
+     *
+     * @remarks
+     *
+     * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+     */
+    interface ExtensionLifeCycle {
+        /**
+         * Gets an object that represents the task pane of an add-in.
+         *
+         * @remarks
+         *
+         * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+         */
+        taskpane: TaskPane;
+    }
     /**
      * Represents the document file associated with an Office Add-in.
      *
@@ -8574,6 +8591,37 @@ declare namespace Office {
          */
         rows: any[][];
     }
+    /**
+     * Provides methods to manage the task pane of an add-in.
+     *
+     * @remarks
+     *
+     * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+     */
+    interface TaskPane {
+        /**
+         * Sets the width of the task pane of an add-in in pixels.
+         *
+         * @remarks
+         *
+         * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+         *
+         * **Important**: The default width of the task pane of an add-in varies depending on the platform.
+         *
+         * - **Web (Excel)**: 350 px
+         *
+         * - **Web (Word)**: 330 px
+         *
+         * - **Windows**: 51 px
+         *
+         * If you pass a width beyond the minimum and maximum constraints, the task pane isn't resized and no error is shown.
+         *
+         * @param width The width of a task pane in pixels. The minimum and maximum constraints vary by platform. In Excel on the web, the width must be between
+         *              350 and 500 px (inclusive). In Word on the web, the width must be between 330 and 500 px (inclusive). In Office on Windows, the width
+         *              must be between 51 px and 50% of the client window.
+         */
+        setWidth(width: number): void;
+    }
     /**
      * Represents a bound text selection in the document.
      *

types/office-js/index.d.ts

@@ -6875,6 +6875,23 @@ declare namespace Office {
          */
         name: string;
     }
+    /**
+     * Provides options to manage the user interface of an Office Add-in while the add-in is running.
+     *
+     * @remarks
+     *
+     * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+     */
+    interface ExtensionLifeCycle {
+        /**
+         * Gets an object that represents the task pane of an add-in.
+         *
+         * @remarks
+         *
+         * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+         */
+        taskpane: TaskPane;
+    }
     /**
      * Represents the document file associated with an Office Add-in.
      *
@@ -8564,6 +8581,37 @@ declare namespace Office {
          */
         rows: any[][];
     }
+    /**
+     * Provides methods to manage the task pane of an add-in.
+     *
+     * @remarks
+     *
+     * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+     */
+    interface TaskPane {
+        /**
+         * Sets the width of the task pane of an add-in in pixels.
+         *
+         * @remarks
+         *
+         * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/task-pane-api-requirement-sets | TaskPaneApi 1.1}
+         *
+         * **Important**: The default width of the task pane of an add-in varies depending on the platform.
+         *
+         * - **Web (Excel)**: 350 px
+         *
+         * - **Web (Word)**: 330 px
+         *
+         * - **Windows**: 51 px
+         *
+         * If you pass a width beyond the minimum and maximum constraints, the task pane isn't resized and no error is shown.
+         *
+         * @param width The width of a task pane in pixels. The minimum and maximum constraints vary by platform. In Excel on the web, the width must be between
+         *              350 and 500 px (inclusive). In Word on the web, the width must be between 330 and 500 px (inclusive). In Office on Windows, the width
+         *              must be between 51 px and 50% of the client window.
+         */
+        setWidth(width: number): void;
+    }
     /**
      * Represents a bound text selection in the document.
      *