@theia/plugin 1.25.0-next.5 → 1.25.0-next.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.25.0-next.5+b8fd6663938",
+  "version": "1.25.0-next.50+3dce8e68986",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -32,5 +32,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "b8fd666393866d1bd907a8035435aa74ecb7d506"
+  "gitHead": "3dce8e68986bd2ff36d52123d49e88195a6e9e59"
 }

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

@@ -2404,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.
      */
@@ -2463,6 +2481,14 @@ export module '@theia/plugin' {
      */
     export interface StatusBarItem {
 
+        /**
+         * The identifier of this item.
+         *
+         * *Note*: if no identifier was provided by the {@linkcode window.createStatusBarItem}
+         * method, the identifier will match the {@link Extension.id extension identifier}.
+         */
+        readonly id: string;
+
         /**
          * The alignment of this item.
          */
@@ -2474,6 +2500,13 @@ export module '@theia/plugin' {
          */
         readonly priority: number;
 
+        /**
+         * The name of the entry, like 'Python Language Indicator', 'Git Status' etc.
+         * Try to keep the length of the name short, yet descriptive enough that
+         * users can understand what the status bar item is about.
+         */
+        name: string | undefined;
+
         /**
          * The text to show for the entry. To set a text with icon use the following pattern in text string:
          * $(fontawesomeClassName)
@@ -2490,11 +2523,30 @@ export module '@theia/plugin' {
          */
         color: string | ThemeColor | undefined;
 
+        /**
+         * The background color for this entry.
+         *
+         * *Note*: only the following colors are supported:
+         * * `new ThemeColor('statusBarItem.errorBackground')`
+         * * `new ThemeColor('statusBarItem.warningBackground')`
+         *
+         * More background colors may be supported in the future.
+         *
+         * *Note*: when a background color is set, the statusbar may override
+         * the `color` choice to ensure the entry is readable in all themes.
+         */
+        backgroundColor: ThemeColor | undefined;
+
         /**
          * The identifier of a command to run on click.
          */
         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.
          */
@@ -5255,6 +5307,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)
@@ -6849,8 +6908,7 @@ export module '@theia/plugin' {
      * thenable.
      *
      */
-    export type ProviderResult<T> = T | undefined | PromiseLike<T | undefined>;
-
+    export type ProviderResult<T> = T | undefined | null | Thenable<T | undefined | null>;
     /**
      * A symbol kind.
      */
@@ -10883,6 +10941,11 @@ export module '@theia/plugin' {
          * Once disposed, this comment thread will be removed from visible editors and Comment Panel when appropriate.
          */
         dispose(): void;
+
+        /**
+         * Whether the thread supports reply. Defaults to true.
+         */
+        canReply: boolean;
     }
 
     /**