@pptb/types 1.0.1 → 1.0.2

package/package.json

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

package/toolboxAPI.d.ts

@@ -85,6 +85,7 @@ declare namespace ToolBoxAPI {
         shell?: string;
         cwd?: string;
         env?: Record<string, string>;
+        visible?: boolean; // Whether terminal should be visible initially (default: true)
     }
 
     /**
@@ -201,6 +202,40 @@ declare namespace ToolBoxAPI {
         off: (callback: (event: any, payload: ToolBoxEventPayload) => void) => void;
     }
 
+    /**
+     * Settings namespace - context-aware tool settings
+     * All settings operations automatically use the current tool's ID
+     */
+    export interface SettingsAPI {
+        /**
+         * Get all settings for this tool
+         * @returns Promise resolving to an object with all settings (empty object if no settings exist)
+         */
+        getSettings: () => Promise<Record<string, any>>;
+
+        /**
+         * Get a specific setting by key
+         * @param key The setting key to retrieve
+         * @returns Promise resolving to the setting value, or undefined if not found
+         */
+        getSetting: (key: string) => Promise<any>;
+
+        /**
+         * Set a specific setting by key
+         * @param key The setting key to set
+         * @param value The value to store (can be any JSON-serializable value)
+         * @returns Promise that resolves when the setting is saved
+         */
+        setSetting: (key: string, value: any) => Promise<void>;
+
+        /**
+         * Set all settings (replaces entire settings object)
+         * @param settings The settings object to store
+         * @returns Promise that resolves when the settings are saved
+         */
+        setSettings: (settings: Record<string, any>) => Promise<void>;
+    }
+
     /**
      * Main ToolBox API exposed to tools via window.toolboxAPI
      */
@@ -215,6 +250,11 @@ declare namespace ToolBoxAPI {
          */
         utils: UtilsAPI;
 
+        /**
+         * Tool-specific settings (context-aware)
+         */
+        settings: SettingsAPI;
+
         /**
          * Terminal operations (context-aware)
          */