@theia/plugin 1.71.0-next.72 → 1.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.71.0-next.72+95c8dba0e",
+  "version": "1.71.0",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -27,10 +27,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.70.0"
+    "@theia/ext-scripts": "1.71.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "95c8dba0ee6349c6be262ac2cf383909a3b62761"
+  "gitHead": "d8a596fc99f0a8e68b466828ed162569d79e3a71"
 }

package/src/theia.d.ts

@@ -12711,6 +12711,70 @@ export module '@theia/plugin' {
         readonly description?: string;
     }
 
+    export interface SourceControlHistoryItemRef {
+        readonly id: string;
+        readonly name: string;
+        readonly description?: string;
+        readonly revision?: string;
+        readonly icon?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
+        readonly category?: string;
+    }
+
+    export interface SourceControlHistoryItemRefsChangeEvent {
+        readonly added: readonly SourceControlHistoryItemRef[];
+        readonly removed: readonly SourceControlHistoryItemRef[];
+        readonly modified: readonly SourceControlHistoryItemRef[];
+    }
+
+    export interface SourceControlHistoryOptions {
+        readonly skip?: number;
+        readonly limit?: number | { id?: string };
+        readonly historyItemRefs?: readonly string[];
+        readonly filterText?: string;
+    }
+
+    export interface SourceControlHistoryItemStatistics {
+        readonly files: number;
+        readonly insertions: number;
+        readonly deletions: number;
+    }
+
+    export interface SourceControlHistoryItem {
+        readonly id: string;
+        readonly parentIds?: readonly string[];
+        readonly subject: string;
+        readonly message?: string | MarkdownString;
+        readonly author?: string;
+        readonly authorEmail?: string;
+        readonly authorIcon?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
+        readonly displayId?: string;
+        readonly timestamp?: number;
+        readonly statistics?: SourceControlHistoryItemStatistics;
+        readonly references?: readonly SourceControlHistoryItemRef[];
+        readonly tooltip?: string | MarkdownString;
+    }
+
+    export interface SourceControlHistoryItemChange {
+        readonly uri: Uri;
+        readonly originalUri?: Uri;
+        readonly modifiedUri?: Uri;
+        readonly renameUri?: Uri;
+    }
+
+    export interface SourceControlHistoryProvider {
+        readonly currentHistoryItemRef?: SourceControlHistoryItemRef;
+        readonly currentHistoryItemRemoteRef?: SourceControlHistoryItemRef;
+        readonly currentHistoryItemBaseRef?: SourceControlHistoryItemRef;
+        readonly onDidChangeCurrentHistoryItemRefs: Event<void>;
+        readonly onDidChangeHistoryItemRefs: Event<SourceControlHistoryItemRefsChangeEvent>;
+
+        provideHistoryItemRefs(historyItemRefs: string[] | undefined, token: CancellationToken): ProviderResult<SourceControlHistoryItemRef[]>;
+        provideHistoryItems(options: SourceControlHistoryOptions, token: CancellationToken): ProviderResult<SourceControlHistoryItem[]>;
+        provideHistoryItemChanges(historyItemId: string, historyItemParentId: string | undefined, token: CancellationToken): ProviderResult<SourceControlHistoryItemChange[]>;
+        resolveHistoryItem(historyItemId: string, token: CancellationToken): ProviderResult<SourceControlHistoryItem>;
+        resolveHistoryItemRefsCommonAncestor(historyItemRefs: string[], token: CancellationToken): ProviderResult<string>;
+    }
+
     /**
      * An source control is able to provide {@link SourceControlResourceState resource states}
      * to the editor and interact with the editor in several source control related ways.
@@ -12784,6 +12848,11 @@ export module '@theia/plugin' {
          */
         actionButton?: ScmActionButton;
 
+        /**
+         * Optional history provider.
+         */
+        historyProvider?: SourceControlHistoryProvider;
+
         /**
          * Dispose this source control.
          */