chore: update git.d.ts because of change in external deps

Author: MichaelCurrin

src/api/git.d.ts

@@ -11,10 +11,17 @@
 
 /*---------------------------------------------------------------------------------------------
  *  Copyright (c) Microsoft Corporation. All rights reserved.
- *  Licensed under the MIT License. https://github.com/microsoft/vscode/blob/master/LICENSE.txt
+ *  Licensed under the MIT License. See https://github.com/microsoft/vscode/blob/main/LICENSE.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-import { Disposable, Event, ProviderResult, Uri } from "vscode";
+import {
+  Uri,
+  Event,
+  Disposable,
+  ProviderResult,
+  Command,
+  CancellationToken,
+} from "vscode";
 export { ProviderResult } from "vscode";
 
 export interface Git {
@@ -25,6 +32,11 @@ export interface InputBox {
   value: string;
 }
 
+export const enum ForcePushMode {
+  Force,
+  ForceWithLease,
+}
+
 export const enum RefType {
   Head,
   RemoteHead,
@@ -140,13 +152,36 @@ export interface CommitOptions {
   signoff?: boolean;
   signCommit?: boolean;
   empty?: boolean;
+  noVerify?: boolean;
+  requireUserConfig?: boolean;
+  useEditor?: boolean;
+  verbose?: boolean;
+  /**
+   * string    - execute the specified command after the commit operation
+   * undefined - execute the command specified in git.postCommitCommand
+   *             after the commit operation
+   * null      - do not execute any command after the commit operation
+   */
+  postCommitCommand?: string | null;
 }
 
-export interface BranchQuery {
-  readonly remote?: boolean;
-  readonly pattern?: string;
-  readonly count?: number;
+export interface FetchOptions {
+  remote?: string;
+  ref?: string;
+  all?: boolean;
+  prune?: boolean;
+  depth?: number;
+}
+
+export interface RefQuery {
   readonly contains?: string;
+  readonly count?: number;
+  readonly pattern?: string;
+  readonly sort?: "alphabetically" | "committerdate";
+}
+
+export interface BranchQuery extends RefQuery {
+  readonly remote?: boolean;
 }
 
 export interface Repository {
@@ -171,6 +206,8 @@ export interface Repository {
   show(ref: string, path: string): Promise<string>;
   getCommit(ref: string): Promise<Commit>;
 
+  add(paths: string[]): Promise<void>;
+  revert(paths: string[]): Promise<void>;
   clean(paths: string[]): Promise<void>;
 
   apply(patch: string, reverse?: boolean): Promise<void>;
@@ -192,24 +229,37 @@ export interface Repository {
   createBranch(name: string, checkout: boolean, ref?: string): Promise<void>;
   deleteBranch(name: string, force?: boolean): Promise<void>;
   getBranch(name: string): Promise<Branch>;
-  getBranches(query: BranchQuery): Promise<Ref[]>;
+  getBranches(
+    query: BranchQuery,
+    cancellationToken?: CancellationToken
+  ): Promise<Ref[]>;
   setBranchUpstream(name: string, upstream: string): Promise<void>;
 
+  getRefs(
+    query: RefQuery,
+    cancellationToken?: CancellationToken
+  ): Promise<Ref[]>;
+
   getMergeBase(ref1: string, ref2: string): Promise<string>;
 
+  tag(name: string, upstream: string): Promise<void>;
+  deleteTag(name: string): Promise<void>;
+
   status(): Promise<void>;
   checkout(treeish: string): Promise<void>;
 
   addRemote(name: string, url: string): Promise<void>;
   removeRemote(name: string): Promise<void>;
   renameRemote(name: string, newName: string): Promise<void>;
 
+  fetch(options?: FetchOptions): Promise<void>;
   fetch(remote?: string, ref?: string, depth?: number): Promise<void>;
   pull(unshallow?: boolean): Promise<void>;
   push(
     remoteName?: string,
     branchName?: string,
-    setUpstream?: boolean
+    setUpstream?: boolean,
+    force?: ForcePushMode
   ): Promise<void>;
 
   blame(path: string): Promise<string>;
@@ -229,9 +279,16 @@ export interface RemoteSourceProvider {
   readonly icon?: string; // codicon name
   readonly supportsQuery?: boolean;
   getRemoteSources(query?: string): ProviderResult<RemoteSource[]>;
+  getBranches?(url: string): ProviderResult<string[]>;
   publishRepository?(repository: Repository): Promise<void>;
 }
 
+export interface RemoteSourcePublisher {
+  readonly name: string;
+  readonly icon?: string; // codicon name
+  publishRepository(repository: Repository): Promise<void>;
+}
+
 export interface Credentials {
   readonly username: string;
   readonly password: string;
@@ -241,6 +298,10 @@ export interface CredentialsProvider {
   getCredentials(host: Uri): ProviderResult<Credentials>;
 }
 
+export interface PostCommitCommandsProvider {
+  getCommands(repository: Repository): Command[];
+}
+
 export interface PushErrorHandler {
   handlePushError(
     repository: Repository,
@@ -252,9 +313,15 @@ export interface PushErrorHandler {
 
 export type APIState = "uninitialized" | "initialized";
 
+export interface PublishEvent {
+  repository: Repository;
+  branch?: string;
+}
+
 export interface API {
   readonly state: APIState;
   readonly onDidChangeState: Event<APIState>;
+  readonly onDidPublish: Event<PublishEvent>;
   readonly git: Git;
   readonly repositories: Repository[];
   readonly onDidOpenRepository: Event<Repository>;
@@ -263,9 +330,14 @@ export interface API {
   toGitUri(uri: Uri, ref: string): Uri;
   getRepository(uri: Uri): Repository | null;
   init(root: Uri): Promise<Repository | null>;
+  openRepository(root: Uri): Promise<Repository | null>;
 
+  registerRemoteSourcePublisher(publisher: RemoteSourcePublisher): Disposable;
   registerRemoteSourceProvider(provider: RemoteSourceProvider): Disposable;
   registerCredentialsProvider(provider: CredentialsProvider): Disposable;
+  registerPostCommitCommandsProvider(
+    provider: PostCommitCommandsProvider
+  ): Disposable;
   registerPushErrorHandler(handler: PushErrorHandler): Disposable;
 }
 
@@ -276,7 +348,7 @@ export interface GitExtension {
   /**
    * Returns a specific API version.
    *
-   * Throws error if git extension is disabled. You can listed to the
+   * Throws error if git extension is disabled. You can listen to the
    * [GitExtension.onDidChangeEnablement](#GitExtension.onDidChangeEnablement) event
    * to know when the extension becomes enabled/disabled.
    *
@@ -322,4 +394,8 @@ export const enum GitErrorCodes {
   PatchDoesNotApply = "PatchDoesNotApply",
   NoPathFound = "NoPathFound",
   UnknownPath = "UnknownPath",
+  EmptyCommitMessage = "EmptyCommitMessage",
+  BranchFastForwardRejected = "BranchFastForwardRejected",
+  BranchNotYetBorn = "BranchNotYetBorn",
+  TagConflict = "TagConflict",
 }