@theia/plugin 1.25.0-next.17 → 1.25.0-next.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.25.0-next.17+e6b57ba4eda",
+  "version": "1.25.0-next.20+c78d302e4cd",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -32,5 +32,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "e6b57ba4edabf797f3b4e67bc2968cdb8cc25b1e"
+  "gitHead": "c78d302e4cddfec1acbe60933fc3ac3ec6f0932d"
 }

package/src/theia.d.ts

@@ -2481,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.
          */
@@ -2492,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)
@@ -2508,6 +2523,20 @@ 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.
          */