@theia/plugin 1.28.0-next.3 → 1.28.0-next.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.28.0-next.3+70350c13127",
+  "version": "1.28.0-next.30+0e52a3cd1d7",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -32,5 +32,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "70350c1312798a7d190fbd45c596d10e48a3c869"
+  "gitHead": "0e52a3cd1d744a021afb2a42724cf95f9f20b454"
 }

package/src/theia.d.ts

@@ -2300,6 +2300,11 @@ export module '@theia/plugin' {
      * Options for configuration behavior of the quick pick
      */
     export interface QuickPickOptions {
+        /**
+         * An optional string that represents the title of the quick pick.
+         */
+        title?: string;
+
         /**
          * A flag to include the description when filtering
          */
@@ -2932,6 +2937,13 @@ export module '@theia/plugin' {
          */
         env?: { [key: string]: string | null };
 
+        /**
+         * A message to write to the terminal on first launch. Note that this is not sent to the
+         * process, but rather written directly to the terminal. This supports escape sequences such
+         * as setting text style.
+         */
+        message?: string;
+
         /**
          * Terminal attributes. Can be useful to apply some implementation specific information.
          */
@@ -6882,6 +6894,13 @@ export module '@theia/plugin' {
          */
         parameters: ParameterInformation[];
 
+        /**
+         * The index of the active parameter.
+         *
+         * If provided, this is used in place of SignatureHelp.activeParameter.
+         */
+        activeParameter?: number;
+
         /**
          * Creates a new signature information object.
          *
@@ -9602,6 +9621,11 @@ export module '@theia/plugin' {
          * A string to show as place holder in the input box to guide the user.
          */
         placeholder: string;
+
+        /**
+         * Controls whether the input box is visible (default is true).
+         */
+        visible: boolean;
     }
 
     interface QuickDiffProvider {
@@ -9844,6 +9868,20 @@ export module '@theia/plugin' {
         // Properties: see details [here](https://microsoft.github.io/debug-adapter-protocol/specification#Base_Protocol_ProtocolMessage).
     }
 
+    /**
+     * A DebugProtocolBreakpoint is an opaque stand-in type for the [Breakpoint](https://microsoft.github.io/debug-adapter-protocol/specification#Types_Breakpoint) type defined in the Debug Adapter Protocol.
+     */
+    export interface DebugProtocolBreakpoint {
+        // Properties: see details [here](https://microsoft.github.io/debug-adapter-protocol/specification#Types_Breakpoint)
+    }
+
+    /**
+     * A DebugProtocolSource is an opaque stand-in type for the [Source](https://microsoft.github.io/debug-adapter-protocol/specification#Types_Source) type defined in the Debug Adapter Protocol.
+     */
+    export interface DebugProtocolSource {
+        // Properties: see details [here](https://microsoft.github.io/debug-adapter-protocol/specification#Types_Source)
+    }
+
     /**
      * Configuration for a debug session.
      */
@@ -9903,6 +9941,15 @@ export module '@theia/plugin' {
          * Send a custom request to the debug adapter.
          */
         customRequest(command: string, args?: any): Thenable<any>;
+
+        /**
+         * Maps a breakpoint in the editor to the corresponding Debug Adapter Protocol (DAP) breakpoint that
+         * is managed by the debug adapter of the debug session. If no DAP breakpoint exists (either because
+         * the editor breakpoint was not yet registered or because the debug adapter is not interested in the
+         * breakpoint), the value undefined is returned.
+         * @param breakpoint a Breakpoint in the editor.
+         */
+        getDebugProtocolBreakpoint(breakpoint: Breakpoint): PromiseLike<DebugProtocolBreakpoint | undefined>
     }
 
     /**
@@ -10378,6 +10425,16 @@ export module '@theia/plugin' {
          */
         export function registerDebugAdapterDescriptorFactory(debugType: string, factory: DebugAdapterDescriptorFactory): Disposable;
 
+        /**
+         * Converts a "Source" descriptor object received via the Debug Adapter Protocol into a Uri that can be used to load its contents.
+         * If the source descriptor is based on a path, a file Uri is returned. If the source descriptor uses a reference number, a
+         * specific debug Uri (scheme 'debug') is constructed that requires a corresponding ContentProvider and a running debug session
+         * If the "Source" descriptor has insufficient information for creating the Uri, an error is thrown.
+         * @param source An object conforming to the Source type defined in the Debug Adapter Protocol.
+         * @param session An optional debug session that will be used when the source descriptor uses a reference number to load the contents from an active debug session.
+         */
+        export function asDebugSourceUri(source: DebugProtocolSource, session?: DebugSession): Uri;
+
         /**
          * Register a {@link DebugConfigurationProvider debug configuration provider} for a specific debug type.
          * The optional {@link DebugConfigurationProviderTriggerKind triggerKind} can be used to specify when the `provideDebugConfigurations` method of the provider is triggered.