@rushstack/rush-sdk 5.91.0 → 5.92.0

package/lib/index.js

@@ -1,190 +1 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-const path = __importStar(require("path"));
-const node_core_library_1 = require("@rushstack/node-core-library");
-const RUSH_LIB_NAME = '@microsoft/rush-lib';
-const verboseEnabled = typeof process !== 'undefined' && process.env.RUSH_SDK_DEBUG === '1';
-const terminal = new node_core_library_1.Terminal(new node_core_library_1.ConsoleTerminalProvider({
-    verboseEnabled
-}));
-function _require(moduleName) {
-    if (typeof __non_webpack_require__ === 'function') {
-        // If this library has been bundled with Webpack, we need to call the real `require` function
-        // that doesn't get turned into a `__webpack_require__` statement.
-        // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement
-        // during bundling.
-        return __non_webpack_require__(moduleName);
-    }
-    else {
-        return require(moduleName);
-    }
-}
-// SCENARIO 1:  Rush's PluginManager has initialized "rush-sdk" with Rush's own instance of rush-lib.
-// The Rush host process will assign "global.___rush___rushLibModule" before loading the plugin.
-let rushLibModule = global.___rush___rushLibModule || global.___rush___rushLibModuleFromInstallAndRunRush;
-let errorMessage = '';
-// SCENARIO 2:  The project importing "rush-sdk" has installed its own instance of "rush-lib"
-// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.
-if (rushLibModule === undefined) {
-    const importingPath = (_a = module === null || module === void 0 ? void 0 : module.parent) === null || _a === void 0 ? void 0 : _a.filename;
-    if (importingPath) {
-        const callerPackageFolder = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);
-        if (callerPackageFolder !== undefined) {
-            const callerPackageJson = _require(path.join(callerPackageFolder, 'package.json'));
-            // Does the caller properly declare a dependency on rush-lib?
-            if ((callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||
-                (callerPackageJson.devDependencies &&
-                    callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||
-                (callerPackageJson.peerDependencies &&
-                    callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)) {
-                // Try to resolve rush-lib from the caller's folder
-                terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);
-                try {
-                    rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);
-                }
-                catch (error) {
-                    // If we fail to resolve it, ignore the error
-                    terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);
-                }
-                // If two different libraries invoke `rush-sdk`, and one of them provides "rush-lib"
-                // then the first version to be loaded wins.  We do not support side-by-side instances of "rush-lib".
-                if (rushLibModule !== undefined) {
-                    // to track which scenario is active and how it got initialized.
-                    global.___rush___rushLibModule = rushLibModule;
-                    terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);
-                }
-            }
-        }
-    }
-}
-// SCENARIO 3:  A tool or script depends on "rush-sdk", and is meant to be used inside a monorepo folder.
-// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.
-if (rushLibModule === undefined) {
-    try {
-        const rushJsonPath = tryFindRushJsonLocation(process.cwd());
-        if (!rushJsonPath) {
-            throw new Error('Unable to find rush.json in the current folder or its parent folders.\n' +
-                'This tool is meant to be invoked from a working directory inside a Rush repository.');
-        }
-        const monorepoRoot = path.dirname(rushJsonPath);
-        const rushJson = node_core_library_1.JsonFile.load(rushJsonPath);
-        const { rushVersion } = rushJson;
-        const installRunNodeModuleFolder = path.join(monorepoRoot, `common/temp/install-run/@microsoft+rush@${rushVersion}`);
-        try {
-            // First, try to load the version of "rush-lib" that was installed by install-run-rush.js
-            terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);
-            rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
-        }
-        catch (e) {
-            let installAndRunRushStderrContent = '';
-            try {
-                const installAndRunRushJSPath = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');
-                terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');
-                const installAndRuhRushProcess = node_core_library_1.Executable.spawnSync('node', [installAndRunRushJSPath, '--help'], {
-                    stdio: 'pipe'
-                });
-                installAndRunRushStderrContent = installAndRuhRushProcess.stderr;
-                if (installAndRuhRushProcess.status !== 0) {
-                    throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);
-                }
-                // Retry to load "rush-lib" after install-run-rush run
-                terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`);
-                rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
-            }
-            catch (e) {
-                console.error(`${installAndRunRushStderrContent}`);
-                throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);
-            }
-        }
-        if (rushLibModule !== undefined) {
-            // to track which scenario is active and how it got initialized.
-            global.___rush___rushLibModuleFromInstallAndRunRush = rushLibModule;
-            terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);
-        }
-    }
-    catch (e) {
-        // no-catch
-        errorMessage = e.message;
-    }
-}
-if (rushLibModule === undefined) {
-    // This error indicates that a project is trying to import "@rushstack/rush-sdk", but the Rush engine
-    // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add "@microsoft/rush-lib"
-    // to the devDependencies for your project.
-    console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:
-${errorMessage}
-`);
-    process.exit(1);
-}
-// Based on TypeScript's __exportStar()
-for (const property in rushLibModule) {
-    if (property !== 'default' && !exports.hasOwnProperty(property)) {
-        const rushLibModuleForClosure = rushLibModule;
-        // Based on TypeScript's __createBinding()
-        Object.defineProperty(exports, property, {
-            enumerable: true,
-            get: function () {
-                return rushLibModuleForClosure[property];
-            }
-        });
-    }
-}
-/**
- * Require `@microsoft/rush-lib` under the specified folder path.
- */
-function requireRushLibUnderFolderPath(folderPath) {
-    const rushLibModulePath = node_core_library_1.Import.resolveModule({
-        modulePath: RUSH_LIB_NAME,
-        baseFolderPath: folderPath
-    });
-    return _require(rushLibModulePath);
-}
-/**
- * Find the rush.json location and return the path, or undefined if a rush.json can't be found.
- *
- * @privateRemarks
- * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.
- */
-function tryFindRushJsonLocation(startingFolder) {
-    let currentFolder = startingFolder;
-    // Look upwards at parent folders until we find a folder containing rush.json
-    for (let i = 0; i < 10; ++i) {
-        const rushJsonFilename = path.join(currentFolder, 'rush.json');
-        if (node_core_library_1.FileSystem.exists(rushJsonFilename)) {
-            return rushJsonFilename;
-        }
-        const parentFolder = path.dirname(currentFolder);
-        if (parentFolder === currentFolder) {
-            break;
-        }
-        currentFolder = parentFolder;
-    }
-    return undefined;
-}
-//# sourceMappingURL=index.js.map
+module.exports = require("../lib-shim/index")._rushSdk_loadInternalModule("index");

package/lib/logic/Autoinstaller.d.ts

@@ -0,0 +1,21 @@
+import { RushConfiguration } from '../api/RushConfiguration';
+interface IAutoinstallerOptions {
+    autoinstallerName: string;
+    rushConfiguration: RushConfiguration;
+    restrictConsoleOutput?: boolean;
+}
+export declare class Autoinstaller {
+    readonly name: string;
+    private readonly _rushConfiguration;
+    private readonly _restrictConsoleOutput;
+    constructor(options: IAutoinstallerOptions);
+    get folderFullPath(): string;
+    get shrinkwrapFilePath(): string;
+    get packageJsonPath(): string;
+    static validateName(autoinstallerName: string): void;
+    prepareAsync(): Promise<void>;
+    update(): void;
+    private _logIfConsoleOutputIsNotRestricted;
+}
+export {};
+//# sourceMappingURL=Autoinstaller.d.ts.map

package/lib/logic/Autoinstaller.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/Autoinstaller");

package/lib/logic/ChangeFiles.d.ts

@@ -0,0 +1,33 @@
+import { IChangelog } from '../api/Changelog';
+import { RushConfiguration } from '../api/RushConfiguration';
+/**
+ * This class represents the collection of change files existing in the repo and provides operations
+ * for those change files.
+ */
+export declare class ChangeFiles {
+    /**
+     * Change file path relative to changes folder.
+     */
+    private _files;
+    private _changesPath;
+    constructor(changesPath: string);
+    /**
+     * Validate if the newly added change files match the changed packages.
+     */
+    static validate(newChangeFilePaths: string[], changedPackages: string[], rushConfiguration: RushConfiguration): void;
+    static getChangeComments(newChangeFilePaths: string[]): Map<string, string[]>;
+    /**
+     * Get the array of absolute paths of change files.
+     */
+    getFiles(): string[];
+    /**
+     * Get the path of changes folder.
+     */
+    getChangesPath(): string;
+    /**
+     * Delete all change files
+     */
+    deleteAll(shouldDelete: boolean, updatedChangelogs?: IChangelog[]): number;
+    private _deleteFiles;
+}
+//# sourceMappingURL=ChangeFiles.d.ts.map

package/lib/logic/ChangeFiles.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/ChangeFiles");

package/lib/logic/ChangeManager.d.ts

@@ -0,0 +1,39 @@
+import { IPackageJson } from '@rushstack/node-core-library';
+import { IChangeInfo } from '../api/ChangeManagement';
+import { RushConfiguration } from '../api/RushConfiguration';
+import { RushConfigurationProject } from '../api/RushConfigurationProject';
+import { VersionPolicyConfiguration } from '../api/VersionPolicyConfiguration';
+import { PrereleaseToken } from './PrereleaseToken';
+/**
+ * The class manages change files and controls how changes logged by change files
+ * can be applied to package.json and change logs.
+ */
+export declare class ChangeManager {
+    private _prereleaseToken;
+    private _orderedChanges;
+    private _allPackages;
+    private _allChanges;
+    private _changeFiles;
+    private _rushConfiguration;
+    private _projectsToExclude;
+    constructor(rushConfiguration: RushConfiguration, projectsToExclude?: Set<string> | undefined);
+    /**
+     * Load changes from change files
+     * @param changesPath - location of change files
+     * @param prereleaseToken - prerelease token
+     * @param includeCommitDetails - whether commit details need to be included in changes
+     */
+    load(changesPath: string, prereleaseToken?: PrereleaseToken, includeCommitDetails?: boolean): void;
+    hasChanges(): boolean;
+    get packageChanges(): IChangeInfo[];
+    get allPackages(): Map<string, RushConfigurationProject>;
+    validateChanges(versionConfig: VersionPolicyConfiguration): void;
+    /**
+     * Apply changes to package.json
+     * @param shouldCommit - If the value is true, package.json will be updated.
+     * If the value is false, package.json and change logs will not be updated. It will only do a dry-run.
+     */
+    apply(shouldCommit: boolean): Map<string, IPackageJson> | undefined;
+    updateChangelog(shouldCommit: boolean): void;
+}
+//# sourceMappingURL=ChangeManager.d.ts.map

package/lib/logic/ChangeManager.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/ChangeManager");

package/lib/logic/ChangelogGenerator.d.ts

@@ -0,0 +1,46 @@
+import { JsonSchema } from '@rushstack/node-core-library';
+import { IChangeRequests } from './PublishUtilities';
+import { IChangeInfo } from '../api/ChangeManagement';
+import { IChangelog } from '../api/Changelog';
+import { RushConfigurationProject } from '../api/RushConfigurationProject';
+import { RushConfiguration } from '../api/RushConfiguration';
+export declare class ChangelogGenerator {
+    /**
+     * The JSON Schema for Changelog file (changelog.schema.json).
+     */
+    static readonly jsonSchema: JsonSchema;
+    /**
+     * Updates the appropriate changelogs with the given changes.
+     */
+    static updateChangelogs(allChanges: IChangeRequests, allProjects: Map<string, RushConfigurationProject>, rushConfiguration: RushConfiguration, shouldCommit: boolean): IChangelog[];
+    /**
+     * Fully regenerate the markdown files based on the current json files.
+     */
+    static regenerateChangelogs(allProjects: Map<string, RushConfigurationProject>, rushConfiguration: RushConfiguration): void;
+    /**
+     * Updates an individual changelog for a single project.
+     */
+    static updateIndividualChangelog(change: IChangeInfo, projectFolder: string, shouldCommit: boolean, rushConfiguration: RushConfiguration, isLockstepped?: boolean, isMain?: boolean): IChangelog | undefined;
+    /**
+     * Loads the changelog json from disk, or creates a new one if there isn't one.
+     */
+    private static _getChangelog;
+    /**
+     * Translates the given changelog json object into a markdown string.
+     */
+    private static _translateToMarkdown;
+    /**
+     * Helper to return the comments string to be appends to the markdown content.
+     */
+    private static _getChangeComments;
+    /**
+     * Changelogs should only be generated for publishable projects.
+     * Do not update changelog or delete the change files for prerelease. Save them for the official release.
+     * Unless the package is a hotfix, in which case do delete the change files.
+     *
+     * @param project
+     * @param allChanges
+     */
+    private static _shouldUpdateChangeLog;
+}
+//# sourceMappingURL=ChangelogGenerator.d.ts.map

package/lib/logic/ChangelogGenerator.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/ChangelogGenerator");

package/lib/logic/CredentialCache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @beta
+ */
+export interface ICredentialCacheEntry {
+    expires?: Date;
+    credential: string;
+    credentialMetadata?: object;
+}
+/**
+ * @beta
+ */
+export interface ICredentialCacheOptions {
+    supportEditing: boolean;
+}
+/**
+ * @beta
+ */
+export declare class CredentialCache {
+    private readonly _cacheFilePath;
+    private readonly _cacheEntries;
+    private _modified;
+    private _disposed;
+    private _supportsEditing;
+    private readonly _lockfile;
+    private constructor();
+    static initializeAsync(options: ICredentialCacheOptions): Promise<CredentialCache>;
+    static usingAsync(options: ICredentialCacheOptions, doActionAsync: (credentialCache: CredentialCache) => Promise<void> | void): Promise<void>;
+    setCacheEntry(cacheId: string, entry: ICredentialCacheEntry): void;
+    tryGetCacheEntry(cacheId: string): ICredentialCacheEntry | undefined;
+    deleteCacheEntry(cacheId: string): void;
+    trimExpiredEntries(): void;
+    saveIfModifiedAsync(): Promise<void>;
+    dispose(): void;
+    private _validate;
+}
+//# sourceMappingURL=CredentialCache.d.ts.map

package/lib/logic/CredentialCache.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/CredentialCache");

package/lib/logic/DependencyAnalyzer.d.ts

@@ -0,0 +1,34 @@
+import { CommonVersionsConfiguration } from '../api/CommonVersionsConfiguration';
+import { RushConfiguration } from '../api/RushConfiguration';
+export interface IDependencyAnalysis {
+    /**
+     * The common versions configuration from the repo's rush configuration.
+     */
+    commonVersionsConfiguration: CommonVersionsConfiguration;
+    /**
+     * A map of all direct dependencies that only have a single semantic version specifier,
+     * unless the variant has the {@link CommonVersionsConfiguration.implicitlyPreferredVersions} option
+     * set to `false`.
+     */
+    implicitlyPreferredVersionByPackageName: Map<string, string>;
+    /**
+     * A map of dependency name to the set of version specifiers used in the repo.
+     */
+    allVersionsByPackageName: Map<string, Set<string>>;
+}
+export declare class DependencyAnalyzer {
+    private static _dependencyAnalyzerByRushConfiguration;
+    private _rushConfiguration;
+    private _analysisByVariant;
+    private constructor();
+    static forRushConfiguration(rushConfiguration: RushConfiguration): DependencyAnalyzer;
+    getAnalysis(variant?: string): IDependencyAnalysis;
+    /**
+     * Generates the {@link IDependencyAnalysis} for a variant.
+     *
+     * @remarks
+     * The result of this function is not cached.
+     */
+    private _getAnalysisInternal;
+}
+//# sourceMappingURL=DependencyAnalyzer.d.ts.map

package/lib/logic/DependencyAnalyzer.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/DependencyAnalyzer");

package/lib/logic/DependencySpecifier.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The parsed format of a provided version specifier.
+ */
+export declare enum DependencySpecifierType {
+    /**
+     * A git repository
+     */
+    Git = "Git",
+    /**
+     * A tagged version, e.g. "example@latest"
+     */
+    Tag = "Tag",
+    /**
+     * A specific version number, e.g. "example@1.2.3"
+     */
+    Version = "Version",
+    /**
+     * A version range, e.g. "example@2.x"
+     */
+    Range = "Range",
+    /**
+     * A local .tar.gz, .tar or .tgz file
+     */
+    File = "File",
+    /**
+     * A local directory
+     */
+    Directory = "Directory",
+    /**
+     * An HTTP url to a .tar.gz, .tar or .tgz file
+     */
+    Remote = "Remote",
+    /**
+     * A package alias, e.g. "npm:other-package@^1.2.3"
+     */
+    Alias = "Alias",
+    /**
+     * A package specified using workspace protocol, e.g. "workspace:^1.2.3"
+     */
+    Workspace = "Workspace"
+}
+/**
+ * An NPM "version specifier" is a string that can appear as a package.json "dependencies" value.
+ * Example version specifiers: `^1.2.3`, `file:./blah.tgz`, `npm:other-package@~1.2.3`, and so forth.
+ * A "dependency specifier" is the version specifier information, combined with the dependency package name.
+ */
+export declare class DependencySpecifier {
+    /**
+     * The dependency package name, i.e. the key from a "dependencies" key/value table.
+     */
+    readonly packageName: string;
+    /**
+     * The dependency version specifier, i.e. the value from a "dependencies" key/value table.
+     * Example values: `^1.2.3`, `file:./blah.tgz`, `npm:other-package@~1.2.3`
+     */
+    readonly versionSpecifier: string;
+    /**
+     * The type of the `versionSpecifier`.
+     */
+    readonly specifierType: DependencySpecifierType;
+    /**
+     * If `specifierType` is `alias`, then this is the parsed target dependency.
+     * For example, if version specifier i `"npm:other-package@^1.2.3"` then this is the parsed object for
+     * `other-package@^1.2.3`.
+     */
+    readonly aliasTarget: DependencySpecifier | undefined;
+    constructor(packageName: string, versionSpecifier: string);
+    static getDependencySpecifierType(specifierType: string): DependencySpecifierType;
+}
+//# sourceMappingURL=DependencySpecifier.d.ts.map

package/lib/logic/DependencySpecifier.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/DependencySpecifier");

package/lib/logic/EventHooksManager.d.ts

@@ -0,0 +1,10 @@
+import { Event } from '../api/EventHooks';
+import { RushConfiguration } from '../api/RushConfiguration';
+export declare class EventHooksManager {
+    private _rushConfiguration;
+    private _eventHooks;
+    private _commonTempFolder;
+    constructor(rushConfiguration: RushConfiguration);
+    handle(event: Event, isDebug: boolean, ignoreHooks: boolean): void;
+}
+//# sourceMappingURL=EventHooksManager.d.ts.map

package/lib/logic/EventHooksManager.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/EventHooksManager");

package/lib/logic/Git.d.ts

@@ -0,0 +1,103 @@
+import gitInfo from 'git-repo-info';
+import { ITerminal } from '@rushstack/node-core-library';
+import { RushConfiguration } from '../api/RushConfiguration';
+import { IGitStatusEntry } from './GitStatusParser';
+export declare const DEFAULT_GIT_TAG_SEPARATOR: string;
+export interface IGetBlobOptions {
+    blobSpec: string;
+    repositoryRoot: string;
+}
+export declare class Git {
+    private readonly _rushConfiguration;
+    private _checkedGitPath;
+    private _gitPath;
+    private _checkedGitInfo;
+    private _gitInfo;
+    private _gitEmailResult;
+    private _gitHooksPath;
+    constructor(rushConfiguration: RushConfiguration);
+    /**
+     * Returns the path to the Git binary if found. Otherwise, return undefined.
+     */
+    get gitPath(): string | undefined;
+    getGitPathOrThrow(): string;
+    /**
+     * Returns true if the Git binary can be found.
+     */
+    isGitPresent(): boolean;
+    /**
+     * Returns true if the Git binary was found and the current path is under a Git working tree.
+     * @param repoInfo - If provided, do the check based on this Git repo info. If not provided,
+     * the result of `this.getGitInfo()` is used.
+     */
+    isPathUnderGitWorkingTree(repoInfo?: gitInfo.GitRepoInfo): boolean;
+    /**
+     * If a Git email address is configured and is nonempty, this returns it.
+     * Otherwise, undefined is returned.
+     */
+    tryGetGitEmail(): string | undefined;
+    /**
+     * If a Git email address is configured and is nonempty, this returns it.
+     * Otherwise, configuration instructions are printed to the console,
+     * and AlreadyReportedError is thrown.
+     */
+    getGitEmail(): string;
+    /**
+     * Get the folder where Git hooks should go for the current working tree.
+     * Returns undefined if the current path is not under a Git working tree.
+     */
+    getHooksFolder(): string | undefined;
+    isHooksPathDefault(): boolean;
+    getConfigHooksPath(): string;
+    /**
+     * Get information about the current Git working tree.
+     * Returns undefined if rush.json is not under a Git working tree.
+     */
+    getGitInfo(): Readonly<gitInfo.GitRepoInfo> | undefined;
+    getMergeBase(targetBranch: string, terminal: ITerminal, shouldFetch?: boolean): string;
+    getBlobContent({ blobSpec, repositoryRoot }: IGetBlobOptions): string;
+    /**
+     * @param pathPrefix - An optional path prefix "git diff"s should be filtered by.
+     * @returns
+     * An array of paths of repo-root-relative paths of files that are different from
+     * those in the provided {@param targetBranch}. If a {@param pathPrefix} is provided,
+     * this function only returns results under the that path.
+     */
+    getChangedFiles(targetBranch: string, terminal: ITerminal, skipFetch?: boolean, pathPrefix?: string): string[];
+    /**
+     * Gets the remote default branch that maps to the provided repository url.
+     * This method is used by 'Rush change' to find the default remote branch to compare against.
+     * If repository url is not provided or if there is no match, returns the default remote's
+     * default branch 'origin/main'.
+     * If there are more than one matches, returns the first remote's default branch.
+     *
+     * @param rushConfiguration - rush configuration
+     */
+    getRemoteDefaultBranch(): string;
+    hasUncommittedChanges(): boolean;
+    hasUnstagedChanges(): boolean;
+    /**
+     * The list of files changed but not committed
+     */
+    getUncommittedChanges(): ReadonlyArray<string>;
+    getTagSeparator(): string;
+    getGitStatus(): Iterable<IGitStatusEntry>;
+    /**
+     * Git remotes can use different URL syntaxes; this converts them all to a normalized HTTPS
+     * representation for matching purposes.  IF THE INPUT IS NOT ALREADY HTTPS, THE OUTPUT IS
+     * NOT NECESSARILY A VALID GIT URL.
+     *
+     * @example
+     * `git@github.com:ExampleOrg/ExampleProject.git` --> `https://github.com/ExampleOrg/ExampleProject`
+     */
+    static normalizeGitUrlForComparison(gitUrl: string): string;
+    private _tryGetGitEmail;
+    private _tryGetGitHooksPath;
+    private _tryFetchRemoteBranch;
+    private _fetchRemoteBranch;
+    /**
+     * @internal
+     */
+    _executeGitCommandAndCaptureOutput(gitPath: string, args: string[], repositoryRoot?: string): string;
+}
+//# sourceMappingURL=Git.d.ts.map

package/lib/logic/Git.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/Git");

package/lib/logic/GitStatusParser.d.ts

@@ -0,0 +1,42 @@
+export interface IGitStatusEntryBase {
+    kind: 'untracked' | 'changed' | 'unmerged' | 'renamed' | 'copied';
+    path: string;
+}
+export interface IUntrackedGitStatusEntry extends IGitStatusEntryBase {
+    kind: 'untracked';
+}
+export declare type GitStatusChangeType = 'added' | 'deleted' | 'modified' | 'renamed' | 'copied' | 'type-changed';
+export interface IChangedGitStatusEntryFields {
+    stagedChangeType: GitStatusChangeType | undefined;
+    unstagedChangeType: GitStatusChangeType | undefined;
+    isInSubmodule: boolean;
+    headFileMode: string;
+    indexFileMode: string;
+    worktreeFileMode: string;
+    headObjectName: string;
+    indexObjectName: string;
+}
+export interface IChangedGitStatusEntry extends IGitStatusEntryBase, IChangedGitStatusEntryFields {
+    kind: 'changed';
+}
+export interface IRenamedOrCopiedGitStatusEntry extends IGitStatusEntryBase, IChangedGitStatusEntryFields {
+    kind: 'renamed' | 'copied';
+    renameOrCopyScore: number;
+    originalPath: string;
+}
+export interface IUnmergedGitStatusEntry extends IGitStatusEntryBase {
+    kind: 'unmerged';
+    stagedChangeType: GitStatusChangeType | undefined;
+    unstagedChangeType: GitStatusChangeType | undefined;
+    isInSubmodule: boolean;
+    stage1FileMode: string;
+    stage2FileMode: string;
+    stage3FileMode: string;
+    worktreeFileMode: string;
+    stage1ObjectName: string;
+    stage2ObjectName: string;
+    stage3ObjectName: string;
+}
+export declare type IGitStatusEntry = IUntrackedGitStatusEntry | IChangedGitStatusEntry | IRenamedOrCopiedGitStatusEntry | IUnmergedGitStatusEntry;
+export declare function parseGitStatus(gitStatusOutput: string): Iterable<IGitStatusEntry>;
+//# sourceMappingURL=GitStatusParser.d.ts.map

package/lib/logic/GitStatusParser.js

@@ -0,0 +1 @@
+module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("logic/GitStatusParser");