@rushstack/rush-sdk 5.143.0-pr5009.0 → 5.143.0-pr5027.0

package/lib/logic/base/BaseWorkspaceFile.d.ts

@@ -0,0 +1,31 @@
+export interface IWorkspaceFileSaveOptions {
+    /**
+     * If there is an existing file, and the contents have not changed, then
+     * don't write anything; this preserves the old timestamp.
+     */
+    onlyIfChanged?: boolean;
+    /**
+     * Creates the folder recursively using FileSystem.ensureFolder()
+     * Defaults to false.
+     */
+    ensureFolderExists?: boolean;
+}
+/**
+ * This class is a parser for pnpm's pnpm-workspace.yaml file format.
+ */
+export declare abstract class BaseWorkspaceFile {
+    protected _alreadyWarnedSpecs: Set<string>;
+    /**
+     * Serializes and saves the workspace file to specified location
+     */
+    save(filePath: string, options: IWorkspaceFileSaveOptions): void;
+    /**
+     * Adds a package path to the workspace file.
+     *
+     * @virtual
+     */
+    abstract addPackage(packagePath: string): void;
+    /** @virtual */
+    protected abstract serialize(): string;
+}
+//# sourceMappingURL=BaseWorkspaceFile.d.ts.map

package/lib/logic/base/BaseWorkspaceFile.js

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

package/lib/logic/installManager/RushInstallManager.d.ts

@@ -0,0 +1,77 @@
+import { BaseInstallManager } from '../base/BaseInstallManager';
+import type { IInstallManagerOptions } from '../base/BaseInstallManagerTypes';
+import type { BaseShrinkwrapFile } from '../base/BaseShrinkwrapFile';
+import type { RushGlobalFolder } from '../../api/RushGlobalFolder';
+import type { RushConfiguration } from '../..';
+import type { PurgeManager } from '../PurgeManager';
+import type { Subspace } from '../../api/Subspace';
+/**
+ * The "noMtime" flag is new in tar@4.4.1 and not available yet for \@types/tar.
+ * As a temporary workaround, augment the type.
+ */
+declare module 'tar' {
+    interface CreateOptions {
+        /**
+         * "Set to true to omit writing mtime values for entries. Note that this prevents using other
+         * mtime-based features like tar.update or the keepNewer option with the resulting tar archive."
+         */
+        noMtime?: boolean;
+    }
+}
+/**
+ * This class implements common logic between "rush install" and "rush update".
+ */
+export declare class RushInstallManager extends BaseInstallManager {
+    private _tempProjectHelper;
+    constructor(rushConfiguration: RushConfiguration, rushGlobalFolder: RushGlobalFolder, purgeManager: PurgeManager, options: IInstallManagerOptions);
+    /**
+     * Regenerates the common/package.json and all temp_modules projects.
+     * If shrinkwrapFile is provided, this function also validates whether it contains
+     * everything we need to install and returns true if so; in all other cases,
+     * the return value is false.
+     *
+     * @override
+     */
+    prepareCommonTempAsync(subspace: Subspace, shrinkwrapFile: BaseShrinkwrapFile | undefined): Promise<{
+        shrinkwrapIsUpToDate: boolean;
+        shrinkwrapWarnings: string[];
+    }>;
+    private _revertWorkspaceNotation;
+    private _validateRushProjectTarballIntegrityAsync;
+    /**
+     * Check whether or not the install is already valid, and therefore can be skipped.
+     *
+     * @override
+     */
+    protected canSkipInstallAsync(lastModifiedDate: Date, subspace: Subspace, variant: string | undefined): Promise<boolean>;
+    /**
+     * Runs "npm/pnpm/yarn install" in the "common/temp" folder.
+     *
+     * @override
+     */
+    protected installAsync(cleanInstall: boolean, subspace: Subspace): Promise<void>;
+    protected postInstallAsync(subspace: Subspace): Promise<void>;
+    /**
+     * This is a workaround for a bug introduced in NPM 5 (and still unfixed as of NPM 5.5.1):
+     * https://github.com/npm/npm/issues/19006
+     *
+     * The regression is that "npm install" sets the package.json "version" field for the
+     * @rush-temp projects to a value like "file:projects/example.tgz", when it should be "0.0.0".
+     * This causes linking to fail later, when read-package-tree tries to parse the bad version.
+     * The error looks like this:
+     *
+     * ERROR: Failed to parse package.json for foo: Invalid version: "file:projects/example.tgz"
+     *
+     * Our workaround is to rewrite the package.json files for each of the @rush-temp projects
+     * in the node_modules folder, after "npm install" completes.
+     */
+    private _fixupNpm5RegressionAsync;
+    /**
+     * Checks for temp projects that exist in the shrinkwrap file, but don't exist
+     * in rush.json.  This might occur, e.g. if a project was recently deleted or renamed.
+     *
+     * @returns true if orphans were found, or false if everything is okay
+     */
+    private _findMissingTempProjects;
+}
+//# sourceMappingURL=RushInstallManager.d.ts.map

package/lib/logic/installManager/RushInstallManager.js

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

package/lib/logic/installManager/WorkspaceInstallManager.d.ts

@@ -0,0 +1,46 @@
+import { BaseInstallManager } from '../base/BaseInstallManager';
+import type { IInstallManagerOptions } from '../base/BaseInstallManagerTypes';
+import type { BaseShrinkwrapFile } from '../base/BaseShrinkwrapFile';
+import type { PnpmShrinkwrapFile } from '../pnpm/PnpmShrinkwrapFile';
+import type { Subspace } from '../../api/Subspace';
+export interface IPnpmModules {
+    hoistedDependencies: {
+        [dep in string]: {
+            [depPath in string]: string;
+        };
+    };
+}
+/**
+ * This class implements common logic between "rush install" and "rush update".
+ */
+export declare class WorkspaceInstallManager extends BaseInstallManager {
+    /**
+     * @override
+     */
+    doInstallAsync(): Promise<void>;
+    /**
+     * Regenerates the common/temp/package.json and related workspace files.
+     * If shrinkwrapFile is provided, this function also validates whether it contains
+     * everything we need to install and returns true if so; in all other cases,
+     * the return value is false.
+     *
+     * @override
+     */
+    protected prepareCommonTempAsync(subspace: Subspace, shrinkwrapFile: (PnpmShrinkwrapFile & BaseShrinkwrapFile) | undefined): Promise<{
+        shrinkwrapIsUpToDate: boolean;
+        shrinkwrapWarnings: string[];
+    }>;
+    private _getPackageExtensionChecksum;
+    protected canSkipInstallAsync(lastModifiedDate: Date, subspace: Subspace, variant: string | undefined): Promise<boolean>;
+    /**
+     * Runs "pnpm install" in the common folder.
+     */
+    protected installAsync(cleanInstall: boolean, subspace: Subspace): Promise<void>;
+    protected postInstallAsync(subspace: Subspace): Promise<void>;
+    /**
+     * Used when invoking the NPM tool.  Appends the common configuration options
+     * to the command-line.
+     */
+    protected pushConfigurationArgs(args: string[], options: IInstallManagerOptions, subspace: Subspace): void;
+}
+//# sourceMappingURL=WorkspaceInstallManager.d.ts.map

package/lib/logic/installManager/WorkspaceInstallManager.js

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

package/lib/logic/installManager/doBasicInstallAsync.d.ts

@@ -0,0 +1,17 @@
+import type { ITerminal } from '@rushstack/terminal';
+import type { RushConfiguration } from '../../api/RushConfiguration';
+import type { RushGlobalFolder } from '../../api/RushGlobalFolder';
+import type { IInstallManagerOptions } from '../base/BaseInstallManagerTypes';
+import type { Subspace } from '../../api/Subspace';
+export interface IRunInstallOptions {
+    afterInstallAsync?: IInstallManagerOptions['afterInstallAsync'];
+    beforeInstallAsync?: IInstallManagerOptions['beforeInstallAsync'];
+    rushConfiguration: RushConfiguration;
+    rushGlobalFolder: RushGlobalFolder;
+    isDebug: boolean;
+    terminal: ITerminal;
+    variant: string | undefined;
+    subspace: Subspace;
+}
+export declare function doBasicInstallAsync(options: IRunInstallOptions): Promise<void>;
+//# sourceMappingURL=doBasicInstallAsync.d.ts.map

package/lib/logic/installManager/doBasicInstallAsync.js

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

package/lib/logic/npm/NpmLinkManager.d.ts

@@ -0,0 +1,12 @@
+import { BaseLinkManager } from '../base/BaseLinkManager';
+export declare class NpmLinkManager extends BaseLinkManager {
+    protected _linkProjectsAsync(): Promise<void>;
+    /**
+     * This is called once for each local project from Rush.json.
+     * @param project             The local project that we will create symlinks for
+     * @param commonRootPackage   The common/temp/package.json package
+     * @param commonPackageLookup A dictionary for finding packages under common/temp/node_modules
+     */
+    private _linkProject;
+}
+//# sourceMappingURL=NpmLinkManager.d.ts.map

package/lib/logic/npm/NpmLinkManager.js

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

package/lib/logic/npm/NpmPackage.d.ts

@@ -0,0 +1,86 @@
+import type readPackageTree from 'read-package-tree';
+import { BasePackage } from '../base/BasePackage';
+/**
+ * Used by the linking algorithm when doing NPM package resolution.
+ */
+export interface IResolveOrCreateResult {
+    found: BasePackage | undefined;
+    parentForCreate: BasePackage | undefined;
+}
+/**
+ * The type of dependency; used by IPackageDependency.
+ */
+export declare enum PackageDependencyKind {
+    Normal = 0,
+    /**
+     * The dependency was listed in the optionalDependencies section of package.json.
+     */
+    Optional = 1,
+    /**
+     * The dependency should be a symlink to a project that is locally built by Rush..
+     */
+    LocalLink = 2
+}
+export interface IPackageDependency {
+    /**
+     * The name of the dependency
+     */
+    name: string;
+    /**
+     * The requested version, which may be a pattern such as "^1.2.3"
+     */
+    versionRange: string;
+    /**
+     * The kind of dependency
+     */
+    kind: PackageDependencyKind;
+}
+export declare class NpmPackage extends BasePackage {
+    /**
+     * Names of packages that we explicitly depend on.  The actual dependency
+     * package may be found in this.children, or possibly in this.children of
+     * one of the parents.
+     * If a dependency is listed in the "optionalDependencies" section of package.json
+     * then its name here will be prepended with a "?" character, which means that Rush
+     * will not report an error if the module cannot be found in the Common folder.
+     */
+    dependencies: IPackageDependency[];
+    private constructor();
+    /**
+     * Used by "npm link" when creating a Package object that represents symbolic links to be created.
+     */
+    static createLinkedNpmPackage(name: string, version: string | undefined, dependencies: IPackageDependency[], folderPath: string): NpmPackage;
+    /**
+     * Used by "npm link" to simulate a temp project that is missing from the common/node_modules
+     * folder (e.g. because it was added after the shrinkwrap file was regenerated).
+     * @param packageJsonFilename - Filename of the source package.json
+     *        Example: `C:\MyRepo\common\temp\projects\project1\package.json`
+     * @param targetFolderName - Filename where it should have been installed
+     *        Example: `C:\MyRepo\common\temp\node_modules\@rush-temp\project1`
+     */
+    static createVirtualTempPackage(packageJsonFilename: string, installFolderName: string): NpmPackage;
+    /**
+     * Recursive constructs a tree of NpmPackage objects using information returned
+     * by the "read-package-tree" library.
+     */
+    static createFromNpm(npmPackage: readPackageTree.Node): NpmPackage;
+    /**
+     * Searches the node_modules hierarchy for the nearest matching package with the
+     * given name.  Note that the nearest match may have an incompatible version.
+     * If a match is found, then the "found" result will not be undefined.
+     * In either case, the parentForCreate result indicates where the missing
+     * dependency can be added, i.e. if the requested dependency was not found
+     * or was found with an incompatible version.
+     *
+     * "cyclicSubtreeRoot" is a special optional parameter that specifies a different
+     * root for the tree; the decoupledLocalDependencies feature uses this to isolate
+     * certain devDependencies in their own subtree.
+     */
+    resolveOrCreate(dependencyName: string, cyclicSubtreeRoot?: NpmPackage): IResolveOrCreateResult;
+    /**
+     * Searches the node_modules hierarchy for the nearest matching package with the
+     * given name.  If no match is found, then undefined is returned.
+     */
+    resolve(dependencyName: string): NpmPackage | undefined;
+}
+//# sourceMappingURL=NpmPackage.d.ts.map

package/lib/logic/npm/NpmPackage.js

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

package/lib/logic/operations/BuildPlanPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { ITerminal } from '@rushstack/terminal';
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+export declare class BuildPlanPlugin implements IPhasedCommandPlugin {
+    private readonly _terminal;
+    constructor(terminal: ITerminal);
+    apply(hooks: PhasedCommandHooks): void;
+}
+//# sourceMappingURL=BuildPlanPlugin.d.ts.map

package/lib/logic/operations/BuildPlanPlugin.js

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

package/lib/logic/operations/ConsoleTimelinePlugin.d.ts

@@ -0,0 +1,26 @@
+import type { ITerminal } from '@rushstack/terminal';
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+import type { IExecutionResult } from './IOperationExecutionResult';
+import type { CobuildConfiguration } from '../../api/CobuildConfiguration';
+/**
+ * Phased command plugin that emits a timeline to the console.
+ */
+export declare class ConsoleTimelinePlugin implements IPhasedCommandPlugin {
+    private readonly _terminal;
+    constructor(terminal: ITerminal);
+    apply(hooks: PhasedCommandHooks): void;
+}
+/**
+ * @internal
+ */
+export interface IPrintTimelineParameters {
+    terminal: ITerminal;
+    result: IExecutionResult;
+    cobuildConfiguration: CobuildConfiguration | undefined;
+}
+/**
+ * Print a more detailed timeline and analysis of CPU usage for the build.
+ * @internal
+ */
+export declare function _printTimeline({ terminal, result, cobuildConfiguration }: IPrintTimelineParameters): void;
+//# sourceMappingURL=ConsoleTimelinePlugin.d.ts.map

package/lib/logic/operations/ConsoleTimelinePlugin.js

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

package/lib/logic/operations/IPCOperationRunner.d.ts

@@ -0,0 +1,34 @@
+import type { IPhase } from '../../api/CommandLineConfiguration';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
+import type { IOperationRunner, IOperationRunnerContext } from './IOperationRunner';
+import { OperationStatus } from './OperationStatus';
+export interface IIPCOperationRunnerOptions {
+    phase: IPhase;
+    project: RushConfigurationProject;
+    name: string;
+    shellCommand: string;
+    persist: boolean;
+    requestRun: (requestor?: string) => void;
+}
+/**
+ * Runner that hosts a long-lived process to which it communicates via IPC.
+ */
+export declare class IPCOperationRunner implements IOperationRunner {
+    readonly name: string;
+    readonly cacheable: boolean;
+    readonly reportTiming: boolean;
+    readonly silent: boolean;
+    readonly warningsAreAllowed: boolean;
+    private readonly _rushConfiguration;
+    private readonly _shellCommand;
+    private readonly _workingDirectory;
+    private readonly _persist;
+    private readonly _requestRun;
+    private _ipcProcess;
+    private _processReadyPromise;
+    constructor(options: IIPCOperationRunnerOptions);
+    executeAsync(context: IOperationRunnerContext): Promise<OperationStatus>;
+    getConfigHash(): string;
+    shutdownAsync(): Promise<void>;
+}
+//# sourceMappingURL=IPCOperationRunner.d.ts.map

package/lib/logic/operations/IPCOperationRunner.js

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

package/lib/logic/operations/IPCOperationRunnerPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+/**
+ * Plugin that implements compatible phases via IPC to a long-lived watch process.
+ */
+export declare class IPCOperationRunnerPlugin implements IPhasedCommandPlugin {
+    apply(hooks: PhasedCommandHooks): void;
+}
+//# sourceMappingURL=IPCOperationRunnerPlugin.d.ts.map

package/lib/logic/operations/IPCOperationRunnerPlugin.js

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

package/lib/logic/operations/PnpmSyncCopyOperationPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { ITerminal } from '@rushstack/terminal';
+import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+export declare class PnpmSyncCopyOperationPlugin implements IPhasedCommandPlugin {
+    private readonly _terminal;
+    constructor(terminal: ITerminal);
+    apply(hooks: PhasedCommandHooks): void;
+}
+//# sourceMappingURL=PnpmSyncCopyOperationPlugin.d.ts.map

package/lib/logic/operations/PnpmSyncCopyOperationPlugin.js

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

package/lib/logic/pnpm/PnpmLinkManager.d.ts

@@ -0,0 +1,18 @@
+import { BaseLinkManager } from '../base/BaseLinkManager';
+export declare class PnpmLinkManager extends BaseLinkManager {
+    private readonly _pnpmVersion;
+    /**
+     * @override
+     */
+    createSymlinksForProjectsAsync(force: boolean): Promise<void>;
+    protected _linkProjectsAsync(): Promise<void>;
+    /**
+     * This is called once for each local project from Rush.json.
+     * @param project             The local project that we will create symlinks for
+     * @param rushLinkJson        The common/temp/rush-link.json output file
+     */
+    private _linkProjectAsync;
+    private _getPathToLocalInstallationAsync;
+    private _createLocalPackageForDependency;
+}
+//# sourceMappingURL=PnpmLinkManager.d.ts.map

package/lib/logic/pnpm/PnpmLinkManager.js

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

package/lib/logic/pnpm/PnpmShrinkwrapFile.d.ts

@@ -8,11 +8,6 @@ import type { RushConfigurationProject } from '../../api/RushConfigurationProjec
 import { PnpmProjectShrinkwrapFile } from './PnpmProjectShrinkwrapFile';
 import type { PackageManagerOptionsConfigurationBase } from '../base/BasePackageManagerOptionsConfiguration';
 import type { Subspace } from '../../api/Subspace';
-import type { Lockfile, PackageSnapshot, ProjectSnapshot } from '@pnpm/lockfile.types';
-export declare enum ShrinkwrapFileMajorVersion {
-    V6 = 6,
-    V9 = 9
-}
 export interface IPeerDependenciesMetaYaml {
     optional?: boolean;
 }
@@ -24,10 +19,10 @@ export interface IPnpmV8VersionSpecifier {
     version: string;
     specifier: string;
 }
-export type IPnpmV9VersionSpecifier = string;
-export type IPnpmVersionSpecifier = IPnpmV7VersionSpecifier | IPnpmV8VersionSpecifier | IPnpmV9VersionSpecifier;
-export interface IPnpmShrinkwrapDependencyYaml extends Omit<PackageSnapshot, 'resolution'> {
-    resolution: {
+export type IPnpmVersionSpecifier = IPnpmV7VersionSpecifier | IPnpmV8VersionSpecifier;
+export interface IPnpmShrinkwrapDependencyYaml {
+    /** Information about the resolved package */
+    resolution?: {
         /** The directory this package should clone, for injected dependencies */
         directory?: string;
         /** The hash of the tarball, to ensure archive integrity */
@@ -35,51 +30,101 @@ export interface IPnpmShrinkwrapDependencyYaml extends Omit<PackageSnapshot, 're
         /** The name of the tarball, if this was from a TGZ file */
         tarball?: string;
     };
+    /** The list of bundled dependencies in this package */
+    bundledDependencies?: ReadonlyArray<string>;
+    /** The list of dependencies and the resolved version */
+    dependencies?: Record<string, IPnpmVersionSpecifier>;
+    /** The list of optional dependencies and the resolved version */
+    optionalDependencies?: Record<string, IPnpmVersionSpecifier>;
+    /** The list of peer dependencies and the resolved version */
+    peerDependencies?: Record<string, IPnpmVersionSpecifier>;
+    /**
+     * Used to indicate optional peer dependencies, as described in this RFC:
+     * https://github.com/yarnpkg/rfcs/blob/master/accepted/0000-optional-peer-dependencies.md
+     */
+    peerDependenciesMeta?: Record<string, IPeerDependenciesMetaYaml>;
+    /** The name of the package, if the package is a local tarball */
+    name?: string;
+    /** If this is an optional dependency */
+    optional?: boolean;
+    /** The values of process.platform supported by this package */
+    os?: readonly string[];
+    /** The values of process.arch supported by this package */
+    cpu?: readonly string[];
+    /** The libc runtimes supported by this package */
+    libc?: readonly string[];
 }
-export type IPnpmShrinkwrapImporterYaml = ProjectSnapshot;
-export interface IPnpmShrinkwrapYaml extends Lockfile {
+export interface IPnpmShrinkwrapImporterYaml {
+    /** The list of resolved version numbers for direct dependencies */
+    dependencies?: Record<string, IPnpmVersionSpecifier>;
+    /** The list of resolved version numbers for dev dependencies */
+    devDependencies?: Record<string, IPnpmVersionSpecifier>;
+    /** The list of resolved version numbers for optional dependencies */
+    optionalDependencies?: Record<string, IPnpmVersionSpecifier>;
+    /** The list of metadata for dependencies declared inside dependencies, optionalDependencies, and devDependencies. */
+    dependenciesMeta?: Record<string, IDependenciesMetaYaml>;
     /**
-     * This interface represents the raw pnpm-lock.YAML file
-     * Example:
-     *  {
-     *    "dependencies": {
-     *      "@rush-temp/project1": "file:./projects/project1.tgz"
-     *    },
-     *    "packages": {
-     *      "file:projects/library1.tgz": {
-     *        "dependencies: {
-     *          "markdown": "0.5.0"
-     *        },
-     *        "name": "@rush-temp/library1",
-     *        "resolution": {
-     *          "tarball": "file:projects/library1.tgz"
-     *        },
-     *        "version": "0.0.0"
-     *      },
-     *      "markdown/0.5.0": {
-     *        "resolution": {
-     *          "integrity": "sha1-KCBbVlqK51kt4gdGPWY33BgnIrI="
-     *        }
-     *      }
-     *    },
-     *    "registry": "http://localhost:4873/",
-     *    "shrinkwrapVersion": 3,
-     *    "specifiers": {
-     *      "@rush-temp/project1": "file:./projects/project1.tgz"
-     *    }
-     *  }
+     * The list of specifiers used to resolve dependency versions
+     *
+     * @remarks
+     * This has been removed in PNPM v8
      */
+    specifiers?: Record<string, IPnpmVersionSpecifier>;
+}
+/**
+ * This interface represents the raw pnpm-lock.YAML file
+ * Example:
+ *  {
+ *    "dependencies": {
+ *      "@rush-temp/project1": "file:./projects/project1.tgz"
+ *    },
+ *    "packages": {
+ *      "file:projects/library1.tgz": {
+ *        "dependencies: {
+ *          "markdown": "0.5.0"
+ *        },
+ *        "name": "@rush-temp/library1",
+ *        "resolution": {
+ *          "tarball": "file:projects/library1.tgz"
+ *        },
+ *        "version": "0.0.0"
+ *      },
+ *      "markdown/0.5.0": {
+ *        "resolution": {
+ *          "integrity": "sha1-KCBbVlqK51kt4gdGPWY33BgnIrI="
+ *        }
+ *      }
+ *    },
+ *    "registry": "http://localhost:4873/",
+ *    "shrinkwrapVersion": 3,
+ *    "specifiers": {
+ *      "@rush-temp/project1": "file:./projects/project1.tgz"
+ *    }
+ *  }
+ */
+export interface IPnpmShrinkwrapYaml {
+    /** The version of the lockfile format */
+    lockfileVersion?: string | number;
     /** The list of resolved version numbers for direct dependencies */
-    dependencies?: Record<string, string>;
-    /** The list of specifiers used to resolve direct dependency versions */
-    specifiers?: Record<string, string>;
+    dependencies: Record<string, string>;
+    /** The list of importers for local workspace projects */
+    importers: Record<string, IPnpmShrinkwrapImporterYaml>;
+    /** The description of the solved graph */
+    packages: Record<string, IPnpmShrinkwrapDependencyYaml>;
     /** URL of the registry which was used */
-    registry?: string;
+    registry: string;
+    /** The list of specifiers used to resolve direct dependency versions */
+    specifiers: Record<string, string>;
+    /** The list of override version number for dependencies */
+    overrides?: {
+        [dependency: string]: string;
+    };
+    /** The checksum of package extensions fields for extending dependencies */
+    packageExtensionsChecksum?: string;
 }
 export interface ILoadFromFileOptions {
     withCaching?: boolean;
 }
-export declare function parsePnpm9DependencyKey(dependencyName: string, versionSpecifier: IPnpmVersionSpecifier): DependencySpecifier | undefined;
 /**
  * Given an encoded "dependency key" from the PNPM shrinkwrap file, this parses it into an equivalent
  * DependencySpecifier.
@@ -103,7 +148,6 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     private readonly _integrities;
     private _pnpmfileConfiguration;
     private constructor();
-    static getLockfileV9PackageId(name: string, version: string): string;
     static loadFromFile(shrinkwrapYamlFilePath: string, { withCaching }?: ILoadFromFileOptions): PnpmShrinkwrapFile | undefined;
     static loadFromString(shrinkwrapContent: string): PnpmShrinkwrapFile;
     getShrinkwrapHash(experimentsConfig?: IExperimentsJson): string;

package/lib/logic/pnpm/PnpmWorkspaceFile.d.ts

@@ -0,0 +1,18 @@
+import { BaseWorkspaceFile } from '../base/BaseWorkspaceFile';
+export declare class PnpmWorkspaceFile extends BaseWorkspaceFile {
+    /**
+     * The filename of the workspace file.
+     */
+    readonly workspaceFilename: string;
+    private _workspacePackages;
+    /**
+     * The PNPM workspace file is used to specify the location of workspaces relative to the root
+     * of your PNPM install.
+     */
+    constructor(workspaceYamlFilename: string);
+    /** @override */
+    addPackage(packagePath: string): void;
+    /** @override */
+    protected serialize(): string;
+}
+//# sourceMappingURL=PnpmWorkspaceFile.d.ts.map

package/lib/logic/pnpm/PnpmWorkspaceFile.js

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

package/lib/utilities/InteractiveUpgradeUI.d.ts

@@ -0,0 +1,22 @@
+/// <reference path="../../src/npm-check-typings.d.ts" />
+import type * as NpmCheck from 'npm-check';
+export interface IUIGroup {
+    title: string;
+    bgColor?: string;
+    filter: {
+        mismatch?: boolean;
+        bump?: undefined | 'major' | 'minor' | 'patch' | 'nonSemver';
+        notInstalled?: boolean;
+    };
+}
+export interface IDepsToUpgradeAnswers {
+    packages: NpmCheck.INpmCheckPackage[];
+}
+export interface IUpgradeInteractiveDepChoice {
+    value: NpmCheck.INpmCheckPackage;
+    name: string | string[];
+    short: string;
+}
+export declare const UI_GROUPS: IUIGroup[];
+export declare const upgradeInteractive: (pkgs: NpmCheck.INpmCheckPackage[]) => Promise<IDepsToUpgradeAnswers>;
+//# sourceMappingURL=InteractiveUpgradeUI.d.ts.map

package/lib/utilities/InteractiveUpgradeUI.js

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