@theia/plugin 1.43.1 → 1.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.43.1",
+  "version": "1.45.0",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -27,10 +27,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.43.1"
+    "@theia/ext-scripts": "1.45.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "df48285b7d3340e0109e89ffdb0f437ba6710378"
+  "gitHead": "2b20a60a0f9b54b19838a0f71760989a19622495"
 }

package/src/theia.d.ts

@@ -1909,6 +1909,14 @@ export module '@theia/plugin' {
          */
         tabSize?: number | string;
 
+        /**
+         * The number of spaces to insert when {@link TextEditorOptions.insertSpaces insertSpaces} is true.
+         *
+         * When getting a text editor's options, this property will always be a number (resolved).
+         * When setting a text editor's options, this property is optional and it can be a number or `"tabSize"`.
+         */
+        indentSize?: number | string;
+
         /**
          * When pressing Tab insert {@link TextEditorOptions.tabSize n} spaces.
          * When getting a text editor's options, this property will always be a boolean (resolved).
@@ -7720,6 +7728,12 @@ export module '@theia/plugin' {
          */
         export const isTelemetryEnabled: boolean;
 
+        /**
+         * An {@link Event} which fires when the default shell changes. This fires with the new
+         * shell path.
+         */
+        export const onDidChangeShell: Event<string>;
+
         /**
          * An {@link Event} which fires when the user enabled or disables telemetry.
          * `true` if the user has enabled telemetry or `false` if the user has disabled telemetry.
@@ -7747,7 +7761,9 @@ export module '@theia/plugin' {
         export const remoteName: string | undefined;
 
         /**
-         * The detected default shell for the extension host.
+         * The detected default shell for the extension host, this is overridden by the
+         * `terminal.integrated.defaultProfile` setting for the extension host's platform. Note that in
+         * environments that do not support a shell the value is the empty string.
          */
         export const shell: string;
 
@@ -8038,6 +8054,43 @@ export module '@theia/plugin' {
         unIndentedLinePattern?: RegExp;
     }
 
+    export enum SyntaxTokenType {
+        /**
+         * Everything except tokens that are part of comments, string literals and regular expressions.
+         */
+        Other = 0,
+        /**
+         * A comment.
+         */
+        Comment = 1,
+        /**
+         * A string literal.
+         */
+        String = 2,
+        /**
+         * A regular expression.
+         */
+        RegEx = 3
+    }
+
+    /**
+     * Describes pairs of strings where the close string will be automatically inserted when typing the opening string.
+     */
+    export interface AutoClosingPair {
+        /**
+         * The string that will trigger the automatic insertion of the closing string.
+         */
+        open: string;
+        /**
+         * The closing string that will be automatically inserted when typing the opening string.
+         */
+        close: string;
+        /**
+         * A set of tokens where the pair should not be auto closed.
+         */
+        notIn?: SyntaxTokenType[];
+    }
+
     /**
      * The language configuration interfaces defines the contract between extensions
      * and various editor features, like automatic bracket insertion, automatic indentation etc.
@@ -8077,6 +8130,10 @@ export module '@theia/plugin' {
          */
         onEnterRules?: OnEnterRule[];
 
+        /**
+         * The language's auto closing pairs.
+         */
+        autoClosingPairs?: AutoClosingPair[];
     }
 
     /**
@@ -10001,6 +10058,24 @@ export module '@theia/plugin' {
          */
         static readonly SourceFixAll: CodeActionKind;
 
+        /**
+         * Base kind for all code actions applying to the entire notebook's scope. CodeActionKinds using
+         * this should always begin with `notebook.`
+         *
+         * This requires that new CodeActions be created for it and contributed via extensions.
+         * Pre-existing kinds can not just have the new `notebook.` prefix added to them, as the functionality
+         * is unique to the full-notebook scope.
+         *
+         * Notebook CodeActionKinds can be initialized as either of the following (both resulting in `notebook.source.xyz`):
+         * - `const newKind =  CodeActionKind.Notebook.append(CodeActionKind.Source.append('xyz').value)`
+         * - `const newKind =  CodeActionKind.Notebook.append('source.xyz')`
+         *
+         * Example Kinds/Actions:
+         * - `notebook.source.organizeImports` (might move all imports to a new top cell)
+         * - `notebook.source.normalizeVariableNames` (might rename all variables to a standardized casing format)
+         */
+        static readonly Notebook: CodeActionKind;
+
         private constructor(value: string);
 
         /**
@@ -16373,6 +16448,37 @@ export module '@theia/plugin' {
          */
         location?: Location;
 
+        /**
+         * Context value of the test item. This can be used to contribute message-
+         * specific actions to the test peek view. The value set here can be found
+         * in the `testMessage` property of the following `menus` contribution points:
+         *
+         * - `testing/message/context` - context menu for the message in the results tree
+         * - `testing/message/content` - a prominent button overlaying editor content where
+         *    the message is displayed.
+         *
+         * For example:
+         *
+         * ```json
+         * "contributes": {
+         *   "menus": {
+         *     "testing/message/content": [
+         *       {
+         *         "command": "extension.deleteCommentThread",
+         *         "when": "testMessage == canApplyRichDiff"
+         *       }
+         *     ]
+         *   }
+         * }
+         * ```
+         *
+         * The command will be called with an object containing:
+         * - `test`: the {@link TestItem} the message is associated with, *if* it
+         *    is still present in the {@link TestController.items} collection.
+         * - `message`: the {@link TestMessage} instance.
+         */
+        contextValue?: string;
+
         /**
          * Creates a new TestMessage that will present as a diff in the editor.
          * @param message Message to display to the user.