@gitkraken/core-gitlens 0.1.0

package/dist/git/watching/watchGroup.js

@@ -0,0 +1,139 @@
+import { isDescendant, relative } from '../../utils/path.js';
+import { classifyGitDirChange } from './classifyChange.js';
+import { dotGitGlobCombined, dotGitGlobCommon, dotGitGlobRoot, shouldIgnoreRepoPath } from './watcherPatterns.js';
+/**
+ * Manages filesystem watchers for a single physical `.git` directory,
+ * shared across all worktrees that reference it.
+ *
+ * Structure:
+ * - 1 common watcher: config, refs/**, info/exclude, etc.
+ * - N root watchers: one per worktree (index, HEAD, *_HEAD, etc.)
+ *
+ * For a standard (non-worktree) repo, the common and root directories
+ * are the same, but we still create separate watchers for clean separation.
+ */
+export class WatchGroup {
+    commonGitDir;
+    provider;
+    _sessions = new Map();
+    _commonWatcher;
+    _disposed = false;
+    constructor(commonGitDir, provider) {
+        this.commonGitDir = commonGitDir;
+        this.provider = provider;
+    }
+    [Symbol.dispose]() {
+        this.dispose();
+    }
+    /** Dispose the entire group (common watcher + all root watchers). */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        for (const entry of this._sessions.values()) {
+            entry.rootWatcher.dispose();
+        }
+        this._sessions.clear();
+        this._commonWatcher?.dispose();
+        this._commonWatcher = undefined;
+    }
+    get sessions() {
+        return this._sessions;
+    }
+    /** Add a session to this group. Creates the root watcher for the session's gitDir. */
+    addSession(repoPath, gitDir, hooks) {
+        if (this._disposed)
+            return;
+        if (this._sessions.has(repoPath))
+            return; // Already tracked
+        // Determine the glob pattern for the root watcher
+        const isStandard = gitDir.commonUri == null;
+        const rootPattern = isStandard ? dotGitGlobCombined : dotGitGlobRoot;
+        const rootWatcher = this.provider.createWatcher(gitDir.uri.fsPath, rootPattern, (event) => {
+            const entry = this._sessions.get(repoPath);
+            if (entry != null) {
+                this.onRootEvent(event, entry);
+            }
+        });
+        const entry = {
+            repoPath: repoPath,
+            gitDirPath: gitDir.uri.fsPath,
+            rootWatcher: rootWatcher,
+            hooks: hooks,
+        };
+        this._sessions.set(repoPath, entry);
+        // Start the common watcher if this is a worktree repo and we haven't yet.
+        // Standard repos don't need a separate common watcher because their root
+        // watcher uses dotGitGlobCombined which already covers all patterns.
+        if (!isStandard) {
+            this.ensureCommonWatcher();
+        }
+    }
+    /** Remove a session from this group. Disposes its root watcher. */
+    removeSession(repoPath) {
+        const entry = this._sessions.get(repoPath);
+        if (entry == null)
+            return;
+        entry.rootWatcher.dispose();
+        this._sessions.delete(repoPath);
+        // If no more sessions, dispose the common watcher
+        if (this._sessions.size === 0 && this._commonWatcher != null) {
+            this._commonWatcher.dispose();
+            this._commonWatcher = undefined;
+        }
+    }
+    ensureCommonWatcher() {
+        if (this._commonWatcher != null || this._disposed)
+            return;
+        this._commonWatcher = this.provider.createWatcher(this.commonGitDir, dotGitGlobCommon, (event) => {
+            this.onCommonEvent(event);
+        });
+    }
+    onCommonEvent(event) {
+        // Compute relative path from common git dir
+        if (!isDescendant(event.path, this.commonGitDir))
+            return;
+        const relativePath = relative(this.commonGitDir, event.path);
+        if (shouldIgnoreRepoPath(relativePath))
+            return;
+        // FETCH_HEAD lives in the main .git dir, not in worktree subdirs.
+        // Dispatch to all sessions so each worktree can update its last-fetched state.
+        if (relativePath === 'FETCH_HEAD') {
+            for (const entry of this._sessions.values()) {
+                entry.hooks.onFetchHeadChanged?.(entry.repoPath);
+            }
+            return;
+        }
+        const changes = classifyGitDirChange(relativePath);
+        // Dispatch to ALL sessions in the group
+        for (const entry of this._sessions.values()) {
+            if (changes != null) {
+                entry.hooks.onRepoChanged(entry.repoPath, changes);
+            }
+            // Check for special cases
+            if (relativePath === 'info/exclude') {
+                entry.hooks.onIgnoresChanged?.(entry.repoPath);
+            }
+        }
+    }
+    onRootEvent(event, entry) {
+        if (!isDescendant(event.path, entry.gitDirPath))
+            return;
+        const relativePath = relative(entry.gitDirPath, event.path);
+        if (shouldIgnoreRepoPath(relativePath))
+            return;
+        // Check for FETCH_HEAD before interpretation
+        if (relativePath === 'FETCH_HEAD') {
+            entry.hooks.onFetchHeadChanged?.(entry.repoPath);
+            return;
+        }
+        const changes = classifyGitDirChange(relativePath);
+        if (changes != null) {
+            entry.hooks.onRepoChanged(entry.repoPath, changes);
+        }
+        if (relativePath === 'info/exclude') {
+            entry.hooks.onIgnoresChanged?.(entry.repoPath);
+        }
+    }
+}
+//# sourceMappingURL=watchGroup.js.map

package/dist/git/watching/watchGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchGroup.js","sourceRoot":"","sources":["../../src/watching/watchGroup.ts"],"names":[],"mappings":"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"}

package/dist/git/watching/watchService.d.ts

@@ -0,0 +1,79 @@
+import type { UnifiedDisposable } from '../../utils/disposable.js';
+import type { Event } from '../../utils/event.js';
+import type { GitDir } from '../models/repository.js';
+import type { WatcherRepoChangeEvent } from './changeEvent.js';
+import type { GitIgnoreFilter } from './gitIgnoreFilter.js';
+import type { FileWatchingProvider } from './provider.js';
+import { RepositoryWatchSession } from './watchSession.js';
+export interface WatchServiceOptions {
+    readonly watchingProvider: FileWatchingProvider;
+    /** Default debounce for repo changes when subscriber doesn't specify. Default: 250ms */
+    readonly defaultRepoDelayMs?: number;
+    /** Default debounce for working tree changes when subscriber doesn't specify. Default: 2500ms */
+    readonly defaultWorkingTreeDelayMs?: number;
+    /** Returns a GitIgnoreFilter for a given repo. When absent or returns undefined, gitignore filtering is skipped. */
+    readonly getIgnoreFilter?: (repoPath: string, gitDirPath: string) => GitIgnoreFilter | undefined;
+}
+export interface WatchHooks {
+    /** Called when FETCH_HEAD changed (for last-fetched tracking) */
+    readonly onFetchHeadChanged?: (repoPath: string) => void;
+    /** Called when .git/info/exclude changed */
+    readonly onIgnoresChanged?: (repoPath: string) => void;
+    /** Called when .gitignore changed in the working tree (extension watches this separately) */
+    readonly onGitIgnoreChanged?: (repoPath: string) => void;
+}
+export interface WatchHandle {
+    readonly session: RepositoryWatchSession;
+    dispose(): void;
+}
+/**
+ * Global service that multiplexes repository watching across all repos.
+ *
+ * Manages:
+ * - Session map: one `RepositoryWatchSession` per repo path (ref-counted)
+ * - Watch groups: shared `.git` watchers across worktrees
+ * - Working tree watchers: per-repo filesystem watchers with gitignore filtering
+ *
+ * Sessions and watch groups are created lazily on first `subscribe()`
+ * within a session, and destroyed when the last subscriber leaves.
+ */
+export declare class RepositoryWatchService implements UnifiedDisposable {
+    private readonly _onDidChangeRepository;
+    /** Global multiplexed event for ALL watched repos */
+    get onDidChangeRepository(): Event<WatcherRepoChangeEvent>;
+    private readonly defaultRepoDelayMs?;
+    private readonly defaultWorkingTreeDelayMs?;
+    private readonly getIgnoreFilter?;
+    private readonly provider;
+    private readonly sessionMap;
+    private readonly watchGroups;
+    private readonly wtWatchers;
+    private _disposed;
+    constructor(options: WatchServiceOptions);
+    [Symbol.dispose](): void;
+    dispose(): void;
+    /**
+     * Start watching a repository. Reference-counted:
+     * same repoPath → same session (refCount++).
+     * Worktrees sharing a .git dir share the WatchGroup.
+     *
+     * Returns a handle with the session and a dispose function.
+     * Disposing the handle decrements the ref count.
+     */
+    watch(repoPath: string, gitDir: GitDir, watchHooks?: WatchHooks): WatchHandle | undefined;
+    /** Get an existing session by repo path */
+    getSession(repoPath: string): RepositoryWatchSession | undefined;
+    /** Suspend all sessions */
+    suspendAll(): void;
+    /** Resume all sessions, with optional per-session delay */
+    resumeAll(getDelay?: (session: RepositoryWatchSession) => number): void;
+    private getOrCreateWatchGroup;
+    private maybeDisposeWatchGroup;
+    private connectToWatchGroup;
+    private disconnectFromWatchGroup;
+    private startWorkingTreeWatcher;
+    private stopWorkingTreeWatcher;
+    private refreshWorkingTreeFilter;
+    private disposeSessionRecord;
+}
+//# sourceMappingURL=watchService.d.ts.map

package/dist/git/watching/watchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchService.d.ts","sourceRoot":"","sources":["../../src/watching/watchService.ts"],"names":[],"mappings":"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"}

package/dist/git/watching/watchService.js

@@ -0,0 +1,282 @@
+import { Emitter } from '../../utils/event.js';
+import { isDescendant, relative } from '../../utils/path.js';
+import { shouldIgnoreWorkingTreePath } from './watcherPatterns.js';
+import { WatchGroup } from './watchGroup.js';
+import { RepositoryWatchSession } from './watchSession.js';
+/**
+ * Global service that multiplexes repository watching across all repos.
+ *
+ * Manages:
+ * - Session map: one `RepositoryWatchSession` per repo path (ref-counted)
+ * - Watch groups: shared `.git` watchers across worktrees
+ * - Working tree watchers: per-repo filesystem watchers with gitignore filtering
+ *
+ * Sessions and watch groups are created lazily on first `subscribe()`
+ * within a session, and destroyed when the last subscriber leaves.
+ */
+export class RepositoryWatchService {
+    _onDidChangeRepository = new Emitter();
+    /** Global multiplexed event for ALL watched repos */
+    get onDidChangeRepository() {
+        return this._onDidChangeRepository.event;
+    }
+    defaultRepoDelayMs;
+    defaultWorkingTreeDelayMs;
+    getIgnoreFilter;
+    provider;
+    sessionMap = new Map();
+    watchGroups = new Map();
+    wtWatchers = new Map();
+    _disposed = false;
+    constructor(options) {
+        this.provider = options.watchingProvider;
+        this.defaultRepoDelayMs = options.defaultRepoDelayMs;
+        this.defaultWorkingTreeDelayMs = options.defaultWorkingTreeDelayMs;
+        this.getIgnoreFilter = options.getIgnoreFilter;
+    }
+    [Symbol.dispose]() {
+        this.dispose();
+    }
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        for (const record of this.sessionMap.values()) {
+            this.disposeSessionRecord(record);
+        }
+        this.sessionMap.clear();
+        for (const group of this.watchGroups.values()) {
+            group.dispose();
+        }
+        this.watchGroups.clear();
+        for (const entry of this.wtWatchers.values()) {
+            entry.watcher.dispose();
+        }
+        this.wtWatchers.clear();
+        this._onDidChangeRepository.dispose();
+    }
+    /**
+     * Start watching a repository. Reference-counted:
+     * same repoPath → same session (refCount++).
+     * Worktrees sharing a .git dir share the WatchGroup.
+     *
+     * Returns a handle with the session and a dispose function.
+     * Disposing the handle decrements the ref count.
+     */
+    watch(repoPath, gitDir, watchHooks) {
+        if (this._disposed)
+            return undefined;
+        let record = this.sessionMap.get(repoPath);
+        if (record != null) {
+            record.refCount++;
+        }
+        else {
+            const session = new RepositoryWatchSession({
+                repoPath: repoPath,
+                defaultRepoDelayMs: this.defaultRepoDelayMs,
+                defaultWorkingTreeDelayMs: this.defaultWorkingTreeDelayMs,
+                lifecycle: {
+                    onFirstRepoSubscriber: () => {
+                        const rec = this.sessionMap.get(repoPath);
+                        if (rec != null) {
+                            this.connectToWatchGroup(rec);
+                        }
+                    },
+                    onLastRepoSubscriber: () => {
+                        const rec = this.sessionMap.get(repoPath);
+                        if (rec != null) {
+                            this.disconnectFromWatchGroup(rec);
+                        }
+                    },
+                    onFirstWorkingTreeSubscriber: () => {
+                        const rec = this.sessionMap.get(repoPath);
+                        if (rec != null) {
+                            this.startWorkingTreeWatcher(rec);
+                        }
+                    },
+                    onLastWorkingTreeSubscriber: () => {
+                        this.stopWorkingTreeWatcher(repoPath);
+                    },
+                },
+                onDidFireRepoChange: (event) => {
+                    this._onDidChangeRepository.fire(event);
+                },
+            });
+            record = {
+                session: session,
+                gitDir: gitDir,
+                watchHooks: watchHooks,
+                refCount: 1,
+            };
+            this.sessionMap.set(repoPath, record);
+        }
+        const sessionRef = record.session;
+        let handleDisposed = false;
+        return {
+            session: sessionRef,
+            dispose: () => {
+                if (handleDisposed)
+                    return;
+                handleDisposed = true;
+                const rec = this.sessionMap.get(repoPath);
+                if (rec == null)
+                    return;
+                rec.refCount--;
+                if (rec.refCount <= 0) {
+                    this.sessionMap.delete(repoPath);
+                    this.disposeSessionRecord(rec);
+                }
+            },
+        };
+    }
+    /** Get an existing session by repo path */
+    getSession(repoPath) {
+        return this.sessionMap.get(repoPath)?.session;
+    }
+    /** Suspend all sessions */
+    suspendAll() {
+        for (const record of this.sessionMap.values()) {
+            record.session.suspend();
+        }
+    }
+    /** Resume all sessions, with optional per-session delay */
+    resumeAll(getDelay) {
+        for (const record of this.sessionMap.values()) {
+            const delayMs = getDelay?.(record.session);
+            record.session.resume(delayMs);
+        }
+    }
+    getOrCreateWatchGroup(commonGitDir) {
+        let group = this.watchGroups.get(commonGitDir);
+        if (group == null) {
+            group = new WatchGroup(commonGitDir, this.provider);
+            this.watchGroups.set(commonGitDir, group);
+        }
+        return group;
+    }
+    maybeDisposeWatchGroup(commonGitDir) {
+        const group = this.watchGroups.get(commonGitDir);
+        if (group == null)
+            return;
+        if (group.sessions.size === 0) {
+            group.dispose();
+            this.watchGroups.delete(commonGitDir);
+        }
+    }
+    connectToWatchGroup(record) {
+        const { session, gitDir, watchHooks } = record;
+        const commonGitDir = (gitDir.commonUri ?? gitDir.uri).fsPath;
+        const group = this.getOrCreateWatchGroup(commonGitDir);
+        const hooks = {
+            onRepoChanged: function (_repoPath, changes) {
+                session.pushRepoChanges(changes);
+            },
+            onFetchHeadChanged: function (repoPath) {
+                watchHooks?.onFetchHeadChanged?.(repoPath);
+            },
+            onIgnoresChanged: (repoPath) => {
+                this.refreshWorkingTreeFilter(repoPath);
+                watchHooks?.onIgnoresChanged?.(repoPath);
+            },
+        };
+        group.addSession(session.repoPath, gitDir, hooks);
+    }
+    disconnectFromWatchGroup(record) {
+        const { session, gitDir } = record;
+        const commonGitDir = (gitDir.commonUri ?? gitDir.uri).fsPath;
+        const group = this.watchGroups.get(commonGitDir);
+        if (group == null)
+            return;
+        group.removeSession(session.repoPath);
+        this.maybeDisposeWatchGroup(commonGitDir);
+    }
+    startWorkingTreeWatcher(record) {
+        const { session, gitDir, watchHooks } = record;
+        const repoPath = session.repoPath;
+        if (this.wtWatchers.has(repoPath))
+            return;
+        let filter;
+        if (this.getIgnoreFilter != null) {
+            filter = this.getIgnoreFilter(repoPath, gitDir.uri.fsPath);
+        }
+        // Buffer events while the gitignore filter loads, then replay
+        let filterReady = filter == null;
+        let buffered = filter != null ? [] : undefined;
+        if (filter != null) {
+            void filter
+                .ready()
+                .then(() => {
+                filterReady = true;
+                if (buffered?.length) {
+                    const paths = filterWorkingTreePaths(buffered, repoPath, filter);
+                    if (paths.length > 0) {
+                        session.pushWorkingTreeChanges(paths);
+                    }
+                }
+                buffered = undefined;
+            })
+                .catch(() => {
+                filterReady = true;
+                buffered = undefined;
+            });
+        }
+        const watcher = this.provider.createWatcher(repoPath, '**', event => {
+            // Fast noise check (node_modules, .git, .watchman-cookie-)
+            if (shouldIgnoreWorkingTreePath(event.path))
+                return;
+            // Detect .gitignore changes — refresh the filter and notify the host
+            const relativePath = isDescendant(event.path, repoPath) ? relative(repoPath, event.path) : undefined;
+            if (relativePath === '.gitignore') {
+                if (filter != null) {
+                    void filter.refresh();
+                }
+                watchHooks?.onGitIgnoreChanged?.(repoPath);
+                // Don't push .gitignore itself as a working tree change
+                return;
+            }
+            if (!filterReady) {
+                // Buffer until gitignore filter is ready
+                buffered?.push(event.path);
+                return;
+            }
+            // Gitignore filter (sync after ready)
+            if (filter != null) {
+                if (relativePath != null && filter.isIgnored(relativePath))
+                    return;
+            }
+            session.pushWorkingTreeChanges([event.path]);
+        });
+        this.wtWatchers.set(repoPath, { watcher: watcher, filter: filter });
+    }
+    stopWorkingTreeWatcher(repoPath) {
+        const entry = this.wtWatchers.get(repoPath);
+        if (entry == null)
+            return;
+        entry.watcher.dispose();
+        this.wtWatchers.delete(repoPath);
+    }
+    refreshWorkingTreeFilter(repoPath) {
+        const entry = this.wtWatchers.get(repoPath);
+        if (entry?.filter != null) {
+            void entry.filter.refresh();
+        }
+    }
+    disposeSessionRecord(record) {
+        this.disconnectFromWatchGroup(record);
+        this.stopWorkingTreeWatcher(record.session.repoPath);
+        record.session.dispose();
+    }
+}
+function filterWorkingTreePaths(absolutePaths, repoPath, filter) {
+    const result = [];
+    for (const p of absolutePaths) {
+        if (!isDescendant(p, repoPath))
+            continue;
+        const relativePath = relative(repoPath, p);
+        if (!filter.isIgnored(relativePath)) {
+            result.push(p);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=watchService.js.map

package/dist/git/watching/watchService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchService.js","sourceRoot":"","sources":["../../src/watching/watchService.ts"],"names":[],"mappings":"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"}

package/dist/git/watching/watchSession.d.ts

@@ -0,0 +1,118 @@
+import type { UnifiedDisposable } from '../../utils/disposable.js';
+import type { Event } from '../../utils/event.js';
+import type { RepositoryChange } from '../models/repository.js';
+import type { WorkingTreeChangeEvent } from './changeEvent.js';
+import { WatcherRepoChangeEvent } from './changeEvent.js';
+export interface RepositorySubscription extends UnifiedDisposable {
+    readonly onDidChange: Event<WatcherRepoChangeEvent>;
+}
+export interface WorkingTreeSubscription extends UnifiedDisposable {
+    readonly onDidChangeWorkingTree: Event<WorkingTreeChangeEvent>;
+}
+/**
+ * Lifecycle callbacks fired by the session when subscriber counts
+ * cross the 0↔1 boundary. The host (WatchService) uses these to
+ * lazily create/destroy watchers.
+ */
+export interface WatchSessionLifecycle {
+    /** Called when the first repo-change subscriber joins */
+    onFirstRepoSubscriber?(): void;
+    /** Called when the last repo-change subscriber leaves */
+    onLastRepoSubscriber?(): void;
+    /** Called when the first working-tree subscriber joins */
+    onFirstWorkingTreeSubscriber?(): void;
+    /** Called when the last working-tree subscriber leaves */
+    onLastWorkingTreeSubscriber?(): void;
+}
+export interface WatchSessionOptions {
+    readonly repoPath: string;
+    /** Default debounce for repo changes. Default: 250ms */
+    readonly defaultRepoDelayMs?: number;
+    /** Default debounce for working tree changes. Default: 2500ms */
+    readonly defaultWorkingTreeDelayMs?: number;
+    readonly lifecycle?: WatchSessionLifecycle;
+    /**
+     * Called whenever a debounced repo change event is dispatched to subscribers.
+     * Does NOT count as a subscriber — used by WatchService for
+     * global event forwarding without affecting lifecycle callbacks.
+     */
+    readonly onDidFireRepoChange?: (event: WatcherRepoChangeEvent) => void;
+}
+/**
+ * Per-repository session that owns the debounce/coalesce/suspend
+ * pipeline for both repo (.git) and working-tree changes.
+ *
+ * Multiple subscribers share the same pipeline — the shortest
+ * requested debounce delay wins.
+ */
+export declare class RepositoryWatchSession implements UnifiedDisposable {
+    readonly repoPath: string;
+    private readonly repoEmitter;
+    private readonly repoDelays;
+    private repoNextId;
+    private pendingRepoEvent;
+    private repoTimer;
+    private effectiveRepoMs;
+    private readonly defaultRepoMs;
+    private readonly wtEmitter;
+    private readonly wtDelays;
+    private wtNextId;
+    private pendingWTPaths;
+    private wtTimer;
+    private effectiveWTMs;
+    private readonly defaultWTMs;
+    private _etagWorkingTree;
+    private _suspended;
+    private _disposed;
+    private readonly lifecycle?;
+    private readonly onDidFireRepoChangeCallback?;
+    constructor(options: WatchSessionOptions);
+    [Symbol.dispose](): void;
+    dispose(): void;
+    get suspended(): boolean;
+    get hasPendingChanges(): boolean;
+    get repoSubscriberCount(): number;
+    get workingTreeSubscriberCount(): number;
+    /**
+     * Monotonic counter incremented immediately when working tree changes
+     * are pushed (before debounce). Used by `GitCommit.hasFullDetails()`
+     * to detect staleness of uncommitted commit data.
+     */
+    get etagWorkingTree(): number;
+    /**
+     * Subscribe to .git directory changes with configurable debounce.
+     * First subscribe fires `onFirstRepoSubscriber`, last dispose
+     * fires `onLastRepoSubscriber`.
+     *
+     * When multiple subscribers exist, the shortest debounce wins —
+     * all subscribers fire on the same (fastest) cadence.
+     */
+    subscribe(opts?: {
+        delayMs?: number;
+    }): RepositorySubscription;
+    subscribeToWorkingTree(opts?: {
+        delayMs?: number;
+    }): WorkingTreeSubscription;
+    suspend(): void;
+    resume(delayMs?: number): void;
+    /** Inject changes (e.g., after a git operation the caller performed). Goes through debounce + suspend. */
+    fireChange(...changes: RepositoryChange[]): void;
+    /** Immediate fire, bypassing debounce + suspend (for Closed/Opened). */
+    fireChangeImmediate(...changes: RepositoryChange[]): void;
+    /** Push interpreted repo changes into the pipeline */
+    pushRepoChanges(changes: RepositoryChange[]): void;
+    /** Push working tree file changes into the pipeline */
+    pushWorkingTreeChanges(paths: Iterable<string>): void;
+    private static minDelay;
+    private recalcRepoDelay;
+    private recalcWTDelay;
+    private flushRepo;
+    private scheduleRepoFlush;
+    private coalesceRepo;
+    private flushWT;
+    private scheduleWTFlush;
+    private coalesceWT;
+    private cancelRepoTimer;
+    private cancelWTTimer;
+}
+//# sourceMappingURL=watchSession.d.ts.map

package/dist/git/watching/watchSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchSession.d.ts","sourceRoot":"","sources":["../../src/watching/watchSession.ts"],"names":[],"mappings":"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"}