@pptb/types 1.0.13 → 1.0.14

package/README.md

@@ -103,6 +103,16 @@ if (filePath) {
     console.log("File saved to:", filePath);
 }
 
+// Select a folder for exporting assets
+const targetFolder = await toolboxAPI.utils.selectPath({
+    type: "folder",
+    title: "Choose export directory",
+    defaultPath: "/Users/me/Downloads",
+});
+if (!targetFolder) {
+    console.log("User canceled folder selection");
+}
+
 // Get current theme
 const theme = await toolboxAPI.utils.getCurrentTheme();
 console.log("Current theme:", theme); // "light" or "dark"
@@ -288,6 +298,12 @@ Core platform features organized into namespaces:
 
     -   Opens a save dialog and writes the content. Returns the saved file path or null if canceled
 
+-   **selectPath(options?: SelectPathOptions)**: Promise<string | null>
+
+    -   Opens a native dialog to select either a file or folder (defaults to file)
+    -   Supports custom titles, button labels, default paths, and filters when selecting files
+    -   Returns the selected path or null if the user cancels
+
 -   **getCurrentTheme()**: Promise<"light" | "dark">
 
     -   Returns the current UI theme setting

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pptb/types",
-    "version": "1.0.13",
+    "version": "1.0.14",
     "description": "TypeScript type definitions for Power Platform Tool Box API",
     "main": "index.d.ts",
     "types": "index.d.ts",

package/toolboxAPI.d.ts

@@ -27,6 +27,26 @@ declare namespace ToolBoxAPI {
         duration?: number; // Duration in milliseconds, 0 for persistent
     }
 
+    /**
+     * File dialog filter definition
+     */
+    export interface FileDialogFilter {
+        name: string;
+        extensions: string[];
+    }
+
+    /**
+     * Options for selecting a file or folder path
+     */
+    export interface SelectPathOptions {
+        type?: "file" | "folder";
+        title?: string;
+        message?: string;
+        buttonLabel?: string;
+        defaultPath?: string;
+        filters?: FileDialogFilter[];
+    }
+
     /**
      * Event types that can be emitted by the ToolBox
      */
@@ -128,17 +148,17 @@ declare namespace ToolBoxAPI {
          * Get the currently active Dataverse connection
          */
         getActiveConnection: () => Promise<DataverseConnection | null>;
-        
+
         /**
          * Get the secondary connection for multi-connection tools
          */
         getSecondaryConnection: () => Promise<DataverseConnection | null>;
-        
+
         /**
          * Get the secondary connection URL for multi-connection tools
          */
         getSecondaryConnectionUrl: () => Promise<string | null>;
-        
+
         /**
          * Get the secondary connection ID for multi-connection tools
          */
@@ -164,6 +184,11 @@ declare namespace ToolBoxAPI {
          */
         saveFile: (defaultPath: string, content: any) => Promise<string | null>;
 
+        /**
+         * Open a native dialog to select either a file or a folder and return the chosen path
+         */
+        selectPath: (options?: SelectPathOptions) => Promise<string | null>;
+
         /**
          * Get the current UI theme (light or dark)
          */