@gitkraken/core-gitlens 0.6.0 → 0.7.1

package/dist/git/context.d.ts

@@ -1,14 +1,15 @@
-import type { Event } from '../utils/event.js';
-import type { Uri } from '../utils/uri.js';
-import type { CachedGitTypes } from './cache.js';
-import type { SigningErrorReason } from './errors.js';
-import type { GitRemote } from './models/remote.js';
-import type { RemoteProvider, RemoteProviderId } from './models/remoteProvider.js';
-import type { RepositoryChange } from './models/repository.js';
-import type { SearchQuery } from './models/search.js';
-import type { SigningFormat } from './models/signature.js';
-import type { GitConflictFile } from './models/staging.js';
-import type { RemoteProviderConfig } from './remotes/matcher.js';
+import { Uri } from "../utils/uri.js";
+import { Event } from "../utils/event.js";
+import { SearchQuery } from "./models/search.js";
+import { SigningErrorReason } from "./errors.js";
+import { RepositoryChange } from "./models/repository.js";
+import { SigningFormat } from "./models/signature.js";
+import { GitConflictFile } from "./models/staging.js";
+import { RemoteProviderConfig } from "./remotes/matcher.js";
+import { RemoteProvider, RemoteProviderId } from "./models/remoteProvider.js";
+import { GitRemote } from "./models/remote.js";
+import { CachedGitTypes } from "./cache.js";
+//#region ../git/src/context.d.ts
 /**
  * Context provided to sub-providers at construction time.
  * Replaces the Container dependency in the GitLens extension.
@@ -17,21 +18,21 @@ import type { RemoteProviderConfig } from './remotes/matcher.js';
  * per-call options on sub-provider methods, not hidden in a context object.
  */
 export interface GitServiceContext {
-    /**
-     * Provides default values for sub-provider options when callers omit them.
-     * If not provided, sub-providers use their own built-in defaults.
-     */
-    readonly config?: GitServiceConfig;
-    /** File system abstraction for reading files, checking stats, and listing directories. */
-    readonly fs: FileSystemProvider;
-    /** Outbound hooks for events from library to host */
-    readonly hooks?: GitServiceHooks;
-    /** Host-side remote capabilities (custom providers, sorting, repo info) */
-    readonly remotes?: RemotesProvider;
-    /** Search query preprocessing hooks (e.g., NLP → structured search). */
-    readonly searchQuery?: SearchQueryProvider;
-    /** Workspace environment (folder resolution, trust state) */
-    readonly workspace?: WorkspaceProvider;
+  /**
+   * Provides default values for sub-provider options when callers omit them.
+   * If not provided, sub-providers use their own built-in defaults.
+   */
+  readonly config?: GitServiceConfig;
+  /** File system abstraction for reading files, checking stats, and listing directories. */
+  readonly fs: FileSystemProvider;
+  /** Outbound hooks for events from library to host */
+  readonly hooks?: GitServiceHooks;
+  /** Host-side remote capabilities (custom providers, sorting, repo info) */
+  readonly remotes?: RemotesProvider;
+  /** Search query preprocessing hooks (e.g., NLP → structured search). */
+  readonly searchQuery?: SearchQueryProvider;
+  /** Workspace environment (folder resolution, trust state) */
+  readonly workspace?: WorkspaceProvider;
 }
 /**
  * Provides default values for sub-provider options when callers omit them.
@@ -45,70 +46,73 @@ export interface GitServiceContext {
  * config provider is also absent.
  */
 export interface GitServiceConfig {
-    readonly commits: {
-        /** Whether to include file details in commit/stash queries by default. */
-        readonly includeFileDetails?: boolean;
-        /** Default commit ordering for log/branch queries (e.g., `'date'`, `'author-date'`, `'topo'`). */
-        readonly ordering?: 'date' | 'author-date' | 'topo' | null;
-        /** Default maximum items for operations (0 = unlimited). */
-        readonly maxItems?: number;
-        /** Similarity threshold for rename detection (0–100). `null` uses Git's default. */
-        readonly similarityThreshold?: number | null;
-    };
-    /** File-history–specific defaults for `getLogForPath`. */
-    readonly fileHistory?: {
-        /** Whether to show commits from all branches (maps to `--all`). */
-        readonly showAllBranches?: boolean;
-        /** Whether to include merge commits (maps to `--no-merges` when false). */
-        readonly showMergeCommits?: boolean;
-        /** Whether to follow renames (maps to `--follow`). */
-        readonly followRenames?: boolean;
-    };
-    /** Search-specific defaults for `searchCommits`. */
-    readonly search?: {
-        /** Default maximum items for search results (0 = unlimited). */
-        readonly maxItems?: number;
-    };
-    /** Graph-specific configuration defaults. */
-    readonly graph?: {
-        /** Whether to keep git's commit-graph file up to date in the background after graph loads —
-         *  written when missing, periodically refreshed to cover new commits (accelerates ordered
-         *  history walks — the graph's initial load). Fed from the master switch
-         *  (`gitlens.gitOptimizations.enabled`); `false` disables the background write. */
-        readonly writeCommitGraph?: boolean;
-        /** Graph commit ordering (falls back to `commits.ordering` or `'date'`). */
-        readonly commitOrdering?: 'date' | 'author-date' | 'topo';
-        /** Whether to only follow first parent in graph. */
-        readonly onlyFollowFirstParent?: boolean;
-        /** Whether to use avatars in graph. */
-        readonly avatars?: boolean;
-        /** Maximum search items (0 = unlimited). */
-        readonly maxSearchItems?: number;
-    };
-    /** Auto-tier git-optimization (maintenance) preferences. */
-    readonly maintenance?: {
-        /** Master switch for the auto-tier optimizations (maps to `gitlens.gitOptimizations.enabled`). Defaults to `true`. */
-        readonly enabled?: boolean;
-    };
-    /** Force-push preferences. */
-    readonly push?: {
-        /** Whether to use `--force-with-lease` instead of a plain `--force` when force-pushing. Defaults to `true`. */
-        readonly useForceWithLease?: boolean;
-        /**
-         * Whether to add `--force-if-includes` when force-pushing. Only applies when `useForceWithLease` is `true`
-         * and the installed Git supports it. Defaults to `true`.
-         */
-        readonly useForceIfIncludes?: boolean;
-    };
-    /** Commit-signing preferences. */
-    readonly signing?: {
-        /**
-         * Host-level override for whether commit signing is enabled (e.g. VS Code's `git.enableCommitSigning`).
-         * When `true`, signing is treated as enabled even if the repo's `commit.gpgsign` is unset/false. It never
-         * forces signing off.
-         */
-        readonly enabled?: boolean;
-    };
+  readonly commits: {
+    /**
+     * Whether commit/stash queries include per-commit file details by default, resolved per
+     * repository so a host can defer them where loading them has proven slow.
+     */
+    readonly includeFileDetails?: (repoPath: string) => boolean;
+    /** Default commit ordering for log/branch queries (e.g., `'date'`, `'author-date'`, `'topo'`). */
+    readonly ordering?: 'date' | 'author-date' | 'topo' | null;
+    /** Default maximum items for operations (0 = unlimited). */
+    readonly maxItems?: number;
+    /** Similarity threshold for rename detection (0–100). `null` uses Git's default. */
+    readonly similarityThreshold?: number | null;
+  };
+  /** File-history–specific defaults for `getLogForPath`. */
+  readonly fileHistory?: {
+    /** Whether to show commits from all branches (maps to `--all`). */
+    readonly showAllBranches?: boolean;
+    /** Whether to include merge commits (maps to `--no-merges` when false). */
+    readonly showMergeCommits?: boolean;
+    /** Whether to follow renames (maps to `--follow`). */
+    readonly followRenames?: boolean;
+  };
+  /** Search-specific defaults for `searchCommits`. */
+  readonly search?: {
+    /** Default maximum items for search results (0 = unlimited). */
+    readonly maxItems?: number;
+  };
+  /** Graph-specific configuration defaults. */
+  readonly graph?: {
+    /** Whether to keep git's commit-graph file up to date in the background after graph loads —
+     *  written when missing, periodically refreshed to cover new commits (accelerates ordered
+     *  history walks — the graph's initial load). Fed from the master switch
+     *  (`gitlens.gitOptimizations.enabled`); `false` disables the background write. */
+    readonly writeCommitGraph?: boolean;
+    /** Graph commit ordering (falls back to `commits.ordering` or `'date'`). */
+    readonly commitOrdering?: 'date' | 'author-date' | 'topo';
+    /** Whether to only follow first parent in graph. */
+    readonly onlyFollowFirstParent?: boolean;
+    /** Whether to use avatars in graph. */
+    readonly avatars?: boolean;
+    /** Maximum search items (0 = unlimited). */
+    readonly maxSearchItems?: number;
+  };
+  /** Auto-tier git-optimization (maintenance) preferences. */
+  readonly maintenance?: {
+    /** Master switch for the auto-tier optimizations (maps to `gitlens.gitOptimizations.enabled`). Defaults to `true`. */
+    readonly enabled?: boolean;
+  };
+  /** Force-push preferences. */
+  readonly push?: {
+    /** Whether to use `--force-with-lease` instead of a plain `--force` when force-pushing. Defaults to `true`. */
+    readonly useForceWithLease?: boolean;
+    /**
+     * Whether to add `--force-if-includes` when force-pushing. Only applies when `useForceWithLease` is `true`
+     * and the installed Git supports it. Defaults to `true`.
+     */
+    readonly useForceIfIncludes?: boolean;
+  };
+  /** Commit-signing preferences. */
+  readonly signing?: {
+    /**
+     * Host-level override for whether commit signing is enabled (e.g. VS Code's `git.enableCommitSigning`).
+     * When `true`, signing is treated as enabled even if the repo's `commit.gpgsign` is unset/false. It never
+     * forces signing off.
+     */
+    readonly enabled?: boolean;
+  };
 }
 /** Git command types that can produce conflicts. */
 export type GitConflictCommand = 'merge' | 'rebase' | 'cherry-pick' | 'revert' | 'stash-apply' | 'stash-pop';
@@ -123,69 +127,69 @@ export type GitConflictCommand = 'merge' | 'rebase' | 'cherry-pick' | 'revert' |
  * `operations`) are provided by the host and forwarded unchanged.
  */
 export interface GitServiceHooks {
-    /** Cache lifecycle hooks — wired by the provider to its cache-reset emitter */
-    readonly cache?: {
-        /** Called when cache entries should be cleared */
-        onReset?(repoPath: string, ...types: CachedGitTypes[]): void;
-    };
-    /** Repository state hooks — wired by the provider to its repository-changed emitter */
-    readonly repository?: {
-        /** Called when repository state has changed */
-        onChanged?(repoPath: string, changes: RepositoryChange[]): void;
-    };
-    /** Commit lifecycle hooks */
-    readonly commits?: {
-        /**
-         * Called when a commit is signed successfully.
-         *
-         * Note: currently fired only from explicit-sign paths — the patch provider's
-         * `commit-tree -S` and the commit operation when the host signing override
-         * (`config.signing.enabled`) adds `-S`. Operations that sign implicitly via
-         * `commit.gpgsign=true` (`commit` without the override, `merge`, `pull`,
-         * `rebase`, `revert`, `cherryPick`) do not fire this hook because the
-         * library cannot cheaply confirm that signing actually occurred without an
-         * extra `git config`/`log --show-signature` call.
-         */
-        onSigned?(format: SigningFormat, source?: unknown): void;
-        /** Called when commit signing fails — fired from all signing-capable paths. */
-        onSigningFailed?(reason: SigningErrorReason, format: SigningFormat, source?: unknown): void;
-    };
-    /** Git operation hooks */
-    readonly operations?: {
-        /**
-         * Called when a git command produced a conflict.
-         * @param conflicts Optional conflicted file list. Populated for merge/rebase/cherry-pick/revert;
-         * may be absent for stash operations or when the file list couldn't be read.
-         */
-        onConflicted?(command: GitConflictCommand, conflicts?: GitConflictFile[]): void;
-        /** Called when getGitDir resolves to a non-existent .git directory or rev-parse fails */
-        onGitDirResolveFailed?(repoPath: string, gitDir: string, errorMessage: string): void;
-        /**
-         * Called when a git operation that can start a rebase begins (`'started'`, before the
-         * process runs) and again when the command exits (`'ended'`, on success and failure alike).
-         * Fired at start (not from the result) because `git rebase` exits 0 when stopping at
-         * `edit`/`break`, and fired for every pull because `pull.rebase=true` config can start
-         * a rebase the host can't predict from the arguments. The `'ended'` phase lets the host
-         * check whether the operation actually left a rebase in progress.
-         * @param repoPath The path the rebase state will appear under (the worktree path for
-         * worktree-targeted pulls)
-         */
-        onRebaseCapableOperation?(repoPath: string, command: 'rebase' | 'pull', phase: 'started' | 'ended'): void;
-    };
+  /** Cache lifecycle hooks — wired by the provider to its cache-reset emitter */
+  readonly cache?: {
+    /** Called when cache entries should be cleared */
+    onReset?(repoPath: string, ...types: CachedGitTypes[]): void;
+  };
+  /** Repository state hooks — wired by the provider to its repository-changed emitter */
+  readonly repository?: {
+    /** Called when repository state has changed */
+    onChanged?(repoPath: string, changes: RepositoryChange[]): void;
+  };
+  /** Commit lifecycle hooks */
+  readonly commits?: {
+    /**
+     * Called when a commit is signed successfully.
+     *
+     * Note: currently fired only from explicit-sign paths — the patch provider's
+     * `commit-tree -S` and the commit operation when the host signing override
+     * (`config.signing.enabled`) adds `-S`. Operations that sign implicitly via
+     * `commit.gpgsign=true` (`commit` without the override, `merge`, `pull`,
+     * `rebase`, `revert`, `cherryPick`) do not fire this hook because the
+     * library cannot cheaply confirm that signing actually occurred without an
+     * extra `git config`/`log --show-signature` call.
+     */
+    onSigned?(format: SigningFormat, source?: unknown): void;
+    /** Called when commit signing fails — fired from all signing-capable paths. */
+    onSigningFailed?(reason: SigningErrorReason, format: SigningFormat, source?: unknown): void;
+  };
+  /** Git operation hooks */
+  readonly operations?: {
+    /**
+     * Called when a git command produced a conflict.
+     * @param conflicts Optional conflicted file list. Populated for merge/rebase/cherry-pick/revert;
+     * may be absent for stash operations or when the file list couldn't be read.
+     */
+    onConflicted?(command: GitConflictCommand, conflicts?: GitConflictFile[]): void;
+    /** Called when getGitDir resolves to a non-existent .git directory or rev-parse fails */
+    onGitDirResolveFailed?(repoPath: string, gitDir: string, errorMessage: string): void;
+    /**
+     * Called when a git operation that can start a rebase begins (`'started'`, before the
+     * process runs) and again when the command exits (`'ended'`, on success and failure alike).
+     * Fired at start (not from the result) because `git rebase` exits 0 when stopping at
+     * `edit`/`break`, and fired for every pull because `pull.rebase=true` config can start
+     * a rebase the host can't predict from the arguments. The `'ended'` phase lets the host
+     * check whether the operation actually left a rebase in progress.
+     * @param repoPath The path the rebase state will appear under (the worktree path for
+     * worktree-targeted pulls)
+     */
+    onRebaseCapableOperation?(repoPath: string, command: 'rebase' | 'pull', phase: 'started' | 'ended'): void;
+  };
 }
 /**
  * Host-provided context attached to remote providers at construction time.
  * Subset of {@link RemotesProvider} — only the fields individual providers need.
  */
 export interface RemoteProviderContext {
-    /** Returns repository info (e.g., ID) from the host's integration system */
-    readonly getRepositoryInfo?: (providerId: RemoteProviderId, target: {
-        owner: string;
-        name: string;
-        project?: string;
-    }) => Promise<{
-        id: string;
-    } | undefined>;
+  /** Returns repository info (e.g., ID) from the host's integration system */
+  readonly getRepositoryInfo?: (providerId: RemoteProviderId, target: {
+    owner: string;
+    name: string;
+    project?: string;
+  }) => Promise<{
+    id: string;
+  } | undefined>;
 }
 /**
  * File system abstraction following the `workspace.fs` model.
@@ -198,26 +202,26 @@ export interface RemoteProviderContext {
  * importing Node.js `fs` or VS Code APIs directly.
  */
 export interface FileStat {
-    type: number;
-    ctime: number;
-    mtime: number;
-    size: number;
+  type: number;
+  ctime: number;
+  mtime: number;
+  size: number;
 }
 /**
  * File type bitmask matching `vscode.FileType`.
  * Values can be combined (e.g., `FileType.File | FileType.SymbolicLink`).
  */
 export declare const FileType: {
-    readonly Unknown: 0;
-    readonly File: 1;
-    readonly Directory: 2;
-    readonly SymbolicLink: 64;
+  readonly Unknown: 0;
+  readonly File: 1;
+  readonly Directory: 2;
+  readonly SymbolicLink: 64;
 };
 export type FileType = (typeof FileType)[keyof typeof FileType];
 export interface FileSystemProvider {
-    readDirectory(uri: Uri): Promise<[string, number][]>;
-    readFile(uri: Uri): Promise<Uint8Array>;
-    stat(uri: Uri): Promise<FileStat | undefined>;
+  readDirectory(uri: Uri): Promise<[string, number][]>;
+  readFile(uri: Uri): Promise<Uint8Array>;
+  stat(uri: Uri): Promise<FileStat | undefined>;
 }
 /**
  * Host-side remote capabilities: custom provider configs, sorting, and repository info.
@@ -228,30 +232,30 @@ export interface FileSystemProvider {
  * Repository info enables cross-fork PR URLs via integration API lookups.
  */
 export interface RemotesProvider {
-    /**
-     * Returns extra remote provider configurations beyond built-ins.
-     * Includes user-configured custom remotes (from settings) and
-     * cloud self-managed host integrations.
-     */
-    getCustomProviders?(repoPath: string): Promise<RemoteProviderConfig[] | undefined>;
-    /**
-     * Returns repository info from the host's integration system.
-     * Used by remote providers for cross-fork PR creation URLs.
-     * Returns `undefined` if no integration is available or connected.
-     */
-    getRepositoryInfo?(providerId: RemoteProviderId, target: {
-        owner: string;
-        name: string;
-        project?: string;
-    }): Promise<{
-        id: string;
-    } | undefined>;
-    /**
-     * Sorts remotes by priority. The host owns the full ranking policy
-     * (remote name heuristics, integration metadata, user preferences).
-     * If not provided, the library returns remotes in their original order.
-     */
-    sort?(remotes: GitRemote<RemoteProvider>[], cancellation?: AbortSignal): Promise<GitRemote<RemoteProvider>[]>;
+  /**
+   * Returns extra remote provider configurations beyond built-ins.
+   * Includes user-configured custom remotes (from settings) and
+   * cloud self-managed host integrations.
+   */
+  getCustomProviders?(repoPath: string): Promise<RemoteProviderConfig[] | undefined>;
+  /**
+   * Returns repository info from the host's integration system.
+   * Used by remote providers for cross-fork PR creation URLs.
+   * Returns `undefined` if no integration is available or connected.
+   */
+  getRepositoryInfo?(providerId: RemoteProviderId, target: {
+    owner: string;
+    name: string;
+    project?: string;
+  }): Promise<{
+    id: string;
+  } | undefined>;
+  /**
+   * Sorts remotes by priority. The host owns the full ranking policy
+   * (remote name heuristics, integration metadata, user preferences).
+   * If not provided, the library returns remotes in their original order.
+   */
+  sort?(remotes: GitRemote<RemoteProvider>[], cancellation?: AbortSignal): Promise<GitRemote<RemoteProvider>[]>;
 }
 /**
  * Provides search query preprocessing.
@@ -260,11 +264,11 @@ export interface RemotesProvider {
  * conversion before the library executes the query.
  */
 export interface SearchQueryProvider {
-    /**
-     * Pre-processes a search query before execution (e.g., converts natural language to structured search).
-     * Called by commits sub-provider before executing `searchCommits`.
-     */
-    preprocessQuery?(search: SearchQuery, source?: unknown): Promise<SearchQuery>;
+  /**
+   * Pre-processes a search query before execution (e.g., converts natural language to structured search).
+   * Called by commits sub-provider before executing `searchCommits`.
+   */
+  preprocessQuery?(search: SearchQuery, source?: unknown): Promise<SearchQuery>;
 }
 /**
  * Provides workspace environment info: folder resolution and trust state.
@@ -274,15 +278,16 @@ export interface SearchQueryProvider {
  * When `isTrusted` is absent, the workspace is assumed trusted.
  */
 export interface WorkspaceProvider {
-    /** Fires when the workspace trust state changes (e.g., user grants trust) */
-    readonly onDidChangeTrust?: Event<boolean>;
-    /** Whether the workspace is currently trusted */
-    readonly isTrusted?: boolean;
-    /** Resolves the workspace folder that contains the given repoPath */
-    getFolder(repoPath: string): {
-        path: string;
-    } | undefined;
-    /** Returns the default URI for new worktrees, given a repository path. */
-    getWorktreeDefaultUri?(repoPath: string): Uri | undefined;
+  /** Fires when the workspace trust state changes (e.g., user grants trust) */
+  readonly onDidChangeTrust?: Event<boolean>;
+  /** Whether the workspace is currently trusted */
+  readonly isTrusted?: boolean;
+  /** Resolves the workspace folder that contains the given repoPath */
+  getFolder(repoPath: string): {
+    path: string;
+  } | undefined;
+  /** Returns the default URI for new worktrees, given a repository path. */
+  getWorktreeDefaultUri?(repoPath: string): Uri | undefined;
 }
+//#endregion
 //# sourceMappingURL=context.d.ts.map

package/dist/git/context.js

@@ -1,11 +1,15 @@
+//#region ../git/src/context.ts
 /**
- * File type bitmask matching `vscode.FileType`.
- * Values can be combined (e.g., `FileType.File | FileType.SymbolicLink`).
- */
-export const FileType = {
-    Unknown: 0,
-    File: 1,
-    Directory: 2,
-    SymbolicLink: 64,
+* File type bitmask matching `vscode.FileType`.
+* Values can be combined (e.g., `FileType.File | FileType.SymbolicLink`).
+*/
+const FileType = {
+	Unknown: 0,
+	File: 1,
+	Directory: 2,
+	SymbolicLink: 64
 };
+//#endregion
+export { FileType };
+
 //# sourceMappingURL=context.js.map

package/dist/git/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/git/context.ts"],"names":[],"mappings":"AAuNA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,EAAE;CACP,CAAC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../git/src/context.ts"],"sourcesContent":["import type { Event } from '@gitlens/utils/event.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport type { CachedGitTypes } from './cache.js';\nimport type { SigningErrorReason } from './errors.js';\nimport type { GitRemote } from './models/remote.js';\nimport type { RemoteProvider, RemoteProviderId } from './models/remoteProvider.js';\nimport type { RepositoryChange } from './models/repository.js';\nimport type { SearchQuery } from './models/search.js';\nimport type { SigningFormat } from './models/signature.js';\nimport type { GitConflictFile } from './models/staging.js';\nimport type { RemoteProviderConfig } from './remotes/matcher.js';\n\n/**\n * Context provided to sub-providers at construction time.\n * Replaces the Container dependency in the GitLens extension.\n *\n * This is intentionally minimal — most configuration is passed as explicit\n * per-call options on sub-provider methods, not hidden in a context object.\n */\nexport interface GitServiceContext {\n\t/**\n\t * Provides default values for sub-provider options when callers omit them.\n\t * If not provided, sub-providers use their own built-in defaults.\n\t */\n\treadonly config?: GitServiceConfig;\n\t/** File system abstraction for reading files, checking stats, and listing directories. */\n\treadonly fs: FileSystemProvider;\n\t/** Outbound hooks for events from library to host */\n\treadonly hooks?: GitServiceHooks;\n\t/** Host-side remote capabilities (custom providers, sorting, repo info) */\n\treadonly remotes?: RemotesProvider;\n\t/** Search query preprocessing hooks (e.g., NLP → structured search). */\n\treadonly searchQuery?: SearchQueryProvider;\n\t/** Workspace environment (folder resolution, trust state) */\n\treadonly workspace?: WorkspaceProvider;\n}\n\n/**\n * Provides default values for sub-provider options when callers omit them.\n *\n * Consumers implement this backed by their own config system (e.g., VS Code settings).\n * Properties are getters so values are read fresh each time — consumers can make them\n * reactive to config changes.\n *\n * Library sub-providers check `context.config?.{property}` when the caller doesn't\n * pass the corresponding option, falling back to sensible built-in defaults if the\n * config provider is also absent.\n */\nexport interface GitServiceConfig {\n\treadonly commits: {\n\t\t/**\n\t\t * Whether commit/stash queries include per-commit file details by default, resolved per\n\t\t * repository so a host can defer them where loading them has proven slow.\n\t\t */\n\t\treadonly includeFileDetails?: (repoPath: string) => boolean;\n\t\t/** Default commit ordering for log/branch queries (e.g., `'date'`, `'author-date'`, `'topo'`). */\n\t\treadonly ordering?: 'date' | 'author-date' | 'topo' | null;\n\t\t/** Default maximum items for operations (0 = unlimited). */\n\t\treadonly maxItems?: number;\n\t\t/** Similarity threshold for rename detection (0–100). `null` uses Git's default. */\n\t\treadonly similarityThreshold?: number | null;\n\t};\n\n\t/** File-history–specific defaults for `getLogForPath`. */\n\treadonly fileHistory?: {\n\t\t/** Whether to show commits from all branches (maps to `--all`). */\n\t\treadonly showAllBranches?: boolean;\n\t\t/** Whether to include merge commits (maps to `--no-merges` when false). */\n\t\treadonly showMergeCommits?: boolean;\n\t\t/** Whether to follow renames (maps to `--follow`). */\n\t\treadonly followRenames?: boolean;\n\t};\n\n\t/** Search-specific defaults for `searchCommits`. */\n\treadonly search?: {\n\t\t/** Default maximum items for search results (0 = unlimited). */\n\t\treadonly maxItems?: number;\n\t};\n\n\t/** Graph-specific configuration defaults. */\n\treadonly graph?: {\n\t\t/** Whether to keep git's commit-graph file up to date in the background after graph loads —\n\t\t *  written when missing, periodically refreshed to cover new commits (accelerates ordered\n\t\t *  history walks — the graph's initial load). Fed from the master switch\n\t\t *  (`gitlens.gitOptimizations.enabled`); `false` disables the background write. */\n\t\treadonly writeCommitGraph?: boolean;\n\t\t/** Graph commit ordering (falls back to `commits.ordering` or `'date'`). */\n\t\treadonly commitOrdering?: 'date' | 'author-date' | 'topo';\n\t\t/** Whether to only follow first parent in graph. */\n\t\treadonly onlyFollowFirstParent?: boolean;\n\t\t/** Whether to use avatars in graph. */\n\t\treadonly avatars?: boolean;\n\t\t/** Maximum search items (0 = unlimited). */\n\t\treadonly maxSearchItems?: number;\n\t};\n\n\t/** Auto-tier git-optimization (maintenance) preferences. */\n\treadonly maintenance?: {\n\t\t/** Master switch for the auto-tier optimizations (maps to `gitlens.gitOptimizations.enabled`). Defaults to `true`. */\n\t\treadonly enabled?: boolean;\n\t};\n\n\t/** Force-push preferences. */\n\treadonly push?: {\n\t\t/** Whether to use `--force-with-lease` instead of a plain `--force` when force-pushing. Defaults to `true`. */\n\t\treadonly useForceWithLease?: boolean;\n\t\t/**\n\t\t * Whether to add `--force-if-includes` when force-pushing. Only applies when `useForceWithLease` is `true`\n\t\t * and the installed Git supports it. Defaults to `true`.\n\t\t */\n\t\treadonly useForceIfIncludes?: boolean;\n\t};\n\n\t/** Commit-signing preferences. */\n\treadonly signing?: {\n\t\t/**\n\t\t * Host-level override for whether commit signing is enabled (e.g. VS Code's `git.enableCommitSigning`).\n\t\t * When `true`, signing is treated as enabled even if the repo's `commit.gpgsign` is unset/false. It never\n\t\t * forces signing off.\n\t\t */\n\t\treadonly enabled?: boolean;\n\t};\n}\n\n/** Git command types that can produce conflicts. */\nexport type GitConflictCommand = 'merge' | 'rebase' | 'cherry-pick' | 'revert' | 'stash-apply' | 'stash-pop';\n\n/**\n * Hooks for outbound events from library to host.\n *\n * All hooks are optional — the library calls them when events occur,\n * and the host decides what to do (telemetry, logging, UI updates, etc.).\n *\n * Provider-augmented hooks (`cache`, `repository`) are wired by the provider\n * to its emitters at construction time. Pass-through hooks (`commits`,\n * `operations`) are provided by the host and forwarded unchanged.\n */\nexport interface GitServiceHooks {\n\t/** Cache lifecycle hooks — wired by the provider to its cache-reset emitter */\n\treadonly cache?: {\n\t\t/** Called when cache entries should be cleared */\n\t\tonReset?(repoPath: string, ...types: CachedGitTypes[]): void;\n\t};\n\t/** Repository state hooks — wired by the provider to its repository-changed emitter */\n\treadonly repository?: {\n\t\t/** Called when repository state has changed */\n\t\tonChanged?(repoPath: string, changes: RepositoryChange[]): void;\n\t};\n\t/** Commit lifecycle hooks */\n\treadonly commits?: {\n\t\t/**\n\t\t * Called when a commit is signed successfully.\n\t\t *\n\t\t * Note: currently fired only from explicit-sign paths — the patch provider's\n\t\t * `commit-tree -S` and the commit operation when the host signing override\n\t\t * (`config.signing.enabled`) adds `-S`. Operations that sign implicitly via\n\t\t * `commit.gpgsign=true` (`commit` without the override, `merge`, `pull`,\n\t\t * `rebase`, `revert`, `cherryPick`) do not fire this hook because the\n\t\t * library cannot cheaply confirm that signing actually occurred without an\n\t\t * extra `git config`/`log --show-signature` call.\n\t\t */\n\t\tonSigned?(format: SigningFormat, source?: unknown): void;\n\t\t/** Called when commit signing fails — fired from all signing-capable paths. */\n\t\tonSigningFailed?(reason: SigningErrorReason, format: SigningFormat, source?: unknown): void;\n\t};\n\t/** Git operation hooks */\n\treadonly operations?: {\n\t\t/**\n\t\t * Called when a git command produced a conflict.\n\t\t * @param conflicts Optional conflicted file list. Populated for merge/rebase/cherry-pick/revert;\n\t\t * may be absent for stash operations or when the file list couldn't be read.\n\t\t */\n\t\tonConflicted?(command: GitConflictCommand, conflicts?: GitConflictFile[]): void;\n\t\t/** Called when getGitDir resolves to a non-existent .git directory or rev-parse fails */\n\t\tonGitDirResolveFailed?(repoPath: string, gitDir: string, errorMessage: string): void;\n\t\t/**\n\t\t * Called when a git operation that can start a rebase begins (`'started'`, before the\n\t\t * process runs) and again when the command exits (`'ended'`, on success and failure alike).\n\t\t * Fired at start (not from the result) because `git rebase` exits 0 when stopping at\n\t\t * `edit`/`break`, and fired for every pull because `pull.rebase=true` config can start\n\t\t * a rebase the host can't predict from the arguments. The `'ended'` phase lets the host\n\t\t * check whether the operation actually left a rebase in progress.\n\t\t * @param repoPath The path the rebase state will appear under (the worktree path for\n\t\t * worktree-targeted pulls)\n\t\t */\n\t\tonRebaseCapableOperation?(repoPath: string, command: 'rebase' | 'pull', phase: 'started' | 'ended'): void;\n\t};\n}\n\n/**\n * Host-provided context attached to remote providers at construction time.\n * Subset of {@link RemotesProvider} — only the fields individual providers need.\n */\nexport interface RemoteProviderContext {\n\t/** Returns repository info (e.g., ID) from the host's integration system */\n\treadonly getRepositoryInfo?: (\n\t\tproviderId: RemoteProviderId,\n\t\ttarget: { owner: string; name: string; project?: string },\n\t) => Promise<{ id: string } | undefined>;\n}\n\n/**\n * File system abstraction following the `workspace.fs` model.\n *\n * Hosts provide an implementation backed by their platform:\n * - Desktop (Node.js): wraps `workspace.fs` or `fs/promises`\n * - Browser: wraps `workspace.fs` for virtual file systems\n *\n * Used by sub-providers that need file system access without\n * importing Node.js `fs` or VS Code APIs directly.\n */\nexport interface FileStat {\n\ttype: number;\n\tctime: number;\n\tmtime: number;\n\tsize: number;\n}\n\n/**\n * File type bitmask matching `vscode.FileType`.\n * Values can be combined (e.g., `FileType.File | FileType.SymbolicLink`).\n */\nexport const FileType = {\n\tUnknown: 0,\n\tFile: 1,\n\tDirectory: 2,\n\tSymbolicLink: 64,\n} as const;\nexport type FileType = (typeof FileType)[keyof typeof FileType];\n\nexport interface FileSystemProvider {\n\treadDirectory(uri: Uri): Promise<[string, number][]>;\n\treadFile(uri: Uri): Promise<Uint8Array>;\n\tstat(uri: Uri): Promise<FileStat | undefined>;\n}\n\n/**\n * Host-side remote capabilities: custom provider configs, sorting, and repository info.\n *\n * The host provides extra provider configs (user custom remotes, cloud self-managed hosts)\n * and the library combines them with built-in providers to build a matcher.\n * Sorting lets the host control remote priority (integration metadata, user preferences).\n * Repository info enables cross-fork PR URLs via integration API lookups.\n */\nexport interface RemotesProvider {\n\t/**\n\t * Returns extra remote provider configurations beyond built-ins.\n\t * Includes user-configured custom remotes (from settings) and\n\t * cloud self-managed host integrations.\n\t */\n\tgetCustomProviders?(repoPath: string): Promise<RemoteProviderConfig[] | undefined>;\n\n\t/**\n\t * Returns repository info from the host's integration system.\n\t * Used by remote providers for cross-fork PR creation URLs.\n\t * Returns `undefined` if no integration is available or connected.\n\t */\n\tgetRepositoryInfo?(\n\t\tproviderId: RemoteProviderId,\n\t\ttarget: { owner: string; name: string; project?: string },\n\t): Promise<{ id: string } | undefined>;\n\n\t/**\n\t * Sorts remotes by priority. The host owns the full ranking policy\n\t * (remote name heuristics, integration metadata, user preferences).\n\t * If not provided, the library returns remotes in their original order.\n\t */\n\tsort?(remotes: GitRemote<RemoteProvider>[], cancellation?: AbortSignal): Promise<GitRemote<RemoteProvider>[]>;\n}\n\n/**\n * Provides search query preprocessing.\n *\n * Hosts implement this to add capabilities like NLP → structured search\n * conversion before the library executes the query.\n */\nexport interface SearchQueryProvider {\n\t/**\n\t * Pre-processes a search query before execution (e.g., converts natural language to structured search).\n\t * Called by commits sub-provider before executing `searchCommits`.\n\t */\n\tpreprocessQuery?(search: SearchQuery, source?: unknown): Promise<SearchQuery>;\n}\n\n/**\n * Provides workspace environment info: folder resolution and trust state.\n * Used by sub-providers for workspace folder lookup and to gate operations\n * in untrusted workspaces.\n *\n * When `isTrusted` is absent, the workspace is assumed trusted.\n */\nexport interface WorkspaceProvider {\n\t/** Fires when the workspace trust state changes (e.g., user grants trust) */\n\treadonly onDidChangeTrust?: Event<boolean>;\n\n\t/** Whether the workspace is currently trusted */\n\treadonly isTrusted?: boolean;\n\n\t/** Resolves the workspace folder that contains the given repoPath */\n\tgetFolder(repoPath: string): { path: string } | undefined;\n\n\t/** Returns the default URI for new worktrees, given a repository path. */\n\tgetWorktreeDefaultUri?(repoPath: string): Uri | undefined;\n}\n"],"mappings":";;;;;AA8NA,MAAa,WAAW;CACvB,SAAS;CACT,MAAM;CACN,WAAW;CACX,cAAc;AACf"}