@theia/plugin 1.24.0 → 1.25.0-next.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.24.0",
+  "version": "1.25.0-next.10+2a8f93e7737",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -32,5 +32,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "70603e7c7bb73170ec598972ca8fa3aafd6ca97a"
+  "gitHead": "2a8f93e77373fc202c9e389186ef729d3c64f3a9"
 }

package/src/theia-proposed.d.ts

@@ -642,6 +642,11 @@ export module '@theia/plugin' {
          */
         contextValue?: string;
 
+        /**
+         * Accessibility information used when screen reader interacts with this timeline item.
+         */
+        accessibilityInformation?: AccessibilityInformation;
+
         /**
          * @param label A human-readable string describing the timeline item
          * @param timestamp A timestamp (in milliseconds since 1 January 1970 00:00:00) for when the timeline item occurred

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.
@@ -2180,6 +2191,11 @@ export module '@theia/plugin' {
          */
         matchOnDetail: boolean;
 
+        /*
+         * An optional flag to maintain the scroll position of the quick pick when the quick pick items are updated. Defaults to false.
+         */
+        keepScrollPosition?: boolean;
+
         /**
          * Active items. This can be read and updated by the extension.
          */
@@ -2388,6 +2404,24 @@ export module '@theia/plugin' {
         export function getCommands(filterInternal?: boolean): PromiseLike<string[]>;
     }
 
+    /**
+     * Accessibility information which controls screen reader behavior.
+     */
+    export interface AccessibilityInformation {
+        /**
+         * Label to be read out by a screen reader once the item has focus.
+         */
+        readonly label: string;
+
+        /**
+         * Role of the widget which defines how a screen reader interacts with it.
+         * The role should be set in special cases when for example a tree-like element behaves like a checkbox.
+         * If role is not specified the editor will pick the appropriate role automatically.
+         * More about aria roles can be found here https://w3c.github.io/aria/#widget_roles
+         */
+        readonly role?: string;
+    }
+
     /**
      * Represents an action that is shown with a message.
      */
@@ -2479,6 +2513,11 @@ export module '@theia/plugin' {
          */
         command: string | Command | undefined;
 
+        /**
+         * Accessibility information used when a screen reader interacts with this StatusBar item.
+         */
+        accessibilityInformation: AccessibilityInformation | undefined;
+
         /**
          * Shows the entry in the status bar.
          */
@@ -4211,36 +4250,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
@@ -5232,6 +5278,13 @@ export module '@theia/plugin' {
          */
         contextValue?: string;
 
+        /**
+         * Accessibility information used when screen reader interacts with this tree item.
+         * Generally, a TreeItem has no need to set the `role` of the accessibilityInformation;
+         * however, there are cases where a TreeItem is not displayed in a tree-like way where setting the `role` may make sense.
+         */
+        accessibilityInformation?: AccessibilityInformation;
+
         /**
          * @param label A human-readable string describing this item
          * @param collapsibleState [TreeItemCollapsibleState](#TreeItemCollapsibleState) of the tree item. Default is [TreeItemCollapsibleState.None](#TreeItemCollapsibleState.None)
@@ -7902,7 +7955,7 @@ export module '@theia/plugin' {
      *
      * A code action can be any command that is [known](#commands.getCommands) to the system.
      */
-    export interface CodeActionProvider {
+    export interface CodeActionProvider<T extends CodeAction = CodeAction> {
         /**
          * Provide commands for the given document and range.
          *
@@ -7914,12 +7967,7 @@ export module '@theia/plugin' {
          * @return An array of commands, quick fixes, or refactorings or a thenable of such. The lack of a result can be
          * signaled by returning `undefined`, `null`, or an empty array.
          */
-        provideCodeActions(
-            document: TextDocument,
-            range: Range | Selection,
-            context: CodeActionContext,
-            token: CancellationToken | undefined
-        ): ProviderResult<(Command | CodeAction)[]>;
+        provideCodeActions(document: TextDocument, range: Range | Selection, context: CodeActionContext, token: CancellationToken | undefined): ProviderResult<(Command | T)[]>;
 
         /**
          * Given a code action fill in its `edit`-property. Changes to
@@ -7935,7 +7983,7 @@ export module '@theia/plugin' {
          * @return The resolved code action or a thenable that resolves to such. It is OK to return the given
          * `item`. When no result is returned, the given `item` will be used.
          */
-        resolveCodeAction?(codeAction: CodeAction, token: CancellationToken | undefined): ProviderResult<CodeAction>;
+        resolveCodeAction?(codeAction: T, token: CancellationToken | undefined): ProviderResult<T>;
     }
 
     /**