@theia/plugin 1.25.0-next.0 → 1.25.0-next.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.25.0-next.0+96bee85f846",
+  "version": "1.25.0-next.3+3893fdec2fc",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -32,5 +32,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "96bee85f8464a60c96355de118d0757daaad20cc"
+  "gitHead": "3893fdec2fc07766da986e12b62457a897b3b64e"
 }

package/src/theia.d.ts

@@ -496,6 +496,17 @@ export module '@theia/plugin' {
          */
         appendPlaceholder(value: string | ((snippet: SnippetString) => any), number?: number): SnippetString;
 
+        /**
+         * Builder-function that appends a choice (`${1|a,b,c|}`) to
+         * the {@linkcode SnippetString.value value} of this snippet string.
+         *
+         * @param values The values for choices - the array of strings
+         * @param number The number of this tabstop, defaults to an auto-increment
+         * value starting at 1.
+         * @return This snippet string.
+         */
+        appendChoice(values: string[], number?: number): SnippetString;
+
         /**
          * Builder-function that appends a variable (`${VAR}`) to
          * the [`value`](#SnippetString.value) of this snippet string.
@@ -4211,36 +4222,43 @@ export module '@theia/plugin' {
 
         /**
          * Shows a selection list.
-         * @param items
-         * @param options
-         * @param token
+         *
+         * @param items An array of strings, or a promise that resolves to an array of strings.
+         * @param options Configures the behavior of the selection list.
+         * @param token A token that can be used to signal cancellation.
+         * @return A promise that resolves to the selection or `undefined`.
          */
-        export function showQuickPick(items: string[] | PromiseLike<string[]>, options: QuickPickOptions, token?: CancellationToken): PromiseLike<string | undefined>;
+        export function showQuickPick(readonly items: string[] | PromiseLike<readonly string[]>, options: QuickPickOptions, token?: CancellationToken): PromiseLike<string | undefined>;
 
         /**
-         * Shows a selection list with multiple selection allowed.
+         * Shows a selection list allowing multiple selections.
+         *
+         * @param items An array of strings, or a promise that resolves to an array of strings.
+         * @param options Configures the behavior of the selection list.
+         * @param token A token that can be used to signal cancellation.
+         * @return A promise that resolves to the selected items or `undefined`.
          */
-        export function showQuickPick(
-            items: string[] | PromiseLike<string[]>,
-            options: QuickPickOptions & { canPickMany: true },
-            token?: CancellationToken
-        ): PromiseLike<string[] | undefined>;
+        export function showQuickPick(readonly items: string[] | PromiseLike<readonly string[]>, options: QuickPickOptions & { canPickMany: true }, token?: CancellationToken): PromiseLike<string[] | undefined>;
 
         /**
          * Shows a selection list.
-         * @param items
-         * @param options
-         * @param token
+         *
+         * @param items An array of items, or a promise that resolves to an array of items.
+         * @param options Configures the behavior of the selection list.
+         * @param token A token that can be used to signal cancellation.
+         * @return A promise that resolves to the selected item or `undefined`.
          */
-        export function showQuickPick<T extends QuickPickItem>(items: T[] | PromiseLike<T[]>, options: QuickPickOptions, token?: CancellationToken): PromiseLike<T | undefined>;
+        export function showQuickPick<T extends QuickPickItem>(items: readonly T[] | PromiseLike<readonly T[]>, options: QuickPickOptions, token?: CancellationToken): PromiseLike<T | undefined>;
 
         /**
-         * Shows a selection list with multiple selection allowed.
+         * Shows a selection list allowing multiple selections.
+         *
+         * @param items An array of items, or a promise that resolves to an array of items.
+         * @param options Configures the behavior of the selection list.
+         * @param token A token that can be used to signal cancellation.
+         * @return A promise that resolves to the selected items or `undefined`.
          */
-        export function showQuickPick<T extends QuickPickItem>(items: T[] | PromiseLike<T[]>,
-            options: QuickPickOptions & { canPickMany: true },
-            token?: CancellationToken
-        ): PromiseLike<T[] | undefined>;
+        export function showQuickPick<T extends QuickPickItem>(items: readonly T[] | PromiseLike<readonly T[]>, options: QuickPickOptions & { canPickMany: true }, token?: CancellationToken): PromiseLike<T[] | undefined>;
 
         /**
          * Creates a [QuickPick](#QuickPick) to let the user pick an item from a list