@rushstack/rush-sdk 5.78.1 → 5.79.0

package/dist/rush-lib.d.ts

@@ -1241,11 +1241,11 @@ export declare interface IPhasedCommand extends IRushCommand {
  */
 export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBase {
     /**
-     * The store resolution method for PNPM to use
+     * {@inheritDoc PnpmOptionsConfiguration.pnpmStore}
      */
     pnpmStore?: PnpmStoreOptions;
     /**
-     * Should PNPM fail if peer dependencies aren't installed?
+     * {@inheritDoc PnpmOptionsConfiguration.strictPeerDependencies}
      */
     strictPeerDependencies?: boolean;
     /**
@@ -1256,6 +1256,52 @@ export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBas
      * {@inheritDoc PnpmOptionsConfiguration.useWorkspaces}
      */
     useWorkspaces?: boolean;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalOverrides}
+     */
+    globalOverrides?: Record<string, string>;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalPeerDependencyRules}
+     */
+    globalPeerDependencyRules?: IPnpmPeerDependencyRules;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalPackageExtensions}
+     */
+    globalPackageExtensions?: Record<string, IPnpmPackageExtension>;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalNeverBuiltDependencies}
+     */
+    globalNeverBuiltDependencies?: string[];
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalAllowedDeprecatedVersions}
+     */
+    globalAllowedDeprecatedVersions?: Record<string, string>;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.unsupportedPackageJsonSettings}
+     */
+    unsupportedPackageJsonSettings?: unknown;
+}
+
+declare interface IPnpmPackageExtension {
+    dependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: IPnpmPeerDependenciesMeta;
+}
+
+declare interface IPnpmPeerDependenciesMeta {
+    [packageName: string]: {
+        optional?: boolean;
+    };
+}
+
+/**
+ * @beta
+ */
+declare interface IPnpmPeerDependencyRules {
+    ignoreMissing?: string[];
+    allowAny?: string[];
+    allowedVersions?: Record<string, string>;
 }
 
 declare interface IRawRepoState {
@@ -1350,6 +1396,7 @@ declare interface IRushGitPolicyJson {
     sampleEmail?: string;
     versionBumpCommitMessage?: string;
     changeLogUpdateCommitMessage?: string;
+    changefilesCommitMessage?: string;
     tagSeparator?: string;
 }
 
@@ -2042,6 +2089,8 @@ export declare class PhasedCommandHooks {
 
 /**
  * Options that are only used when the PNPM package manager is selected.
+ * Use this class to load "common/config/rush/pnpm-config.json" file,
+ * or, load json from "pnpmOptions" field in "rush.json" for legacy support.
  *
  * @remarks
  * It is valid to define these options in rush.json even if the PNPM package manager
@@ -2050,6 +2099,7 @@ export declare class PhasedCommandHooks {
  * @public
  */
 export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfigurationBase {
+    private static _jsonSchema;
     /**
      * The method used to resolve the store used by PNPM.
      *
@@ -2099,11 +2149,92 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      * If true, then Rush will use the workspaces feature to install and link packages when invoking PNPM.
      *
      * @remarks
-     * The default value is false.  (For now.)
+     * The default value is true.  (For now.)
      */
     readonly useWorkspaces: boolean;
+    /**
+     * The "globalOverrides" setting provides a simple mechanism for overriding version selections
+     * for all dependencies of all projects in the monorepo workspace.  The settings are copied
+     * into the `pnpm.overrides` field of the `common/temp/package.json` file that is generated
+     * by Rush during installation.
+     *
+     * Order of precedence: `.pnpmfile.cjs` has the highest precedence, followed by
+     * `unsupportedPackageJsonSettings`, `globalPeerDependencyRules`, `globalPackageExtensions`,
+     * and `globalOverrides` has lowest precedence.
+     *
+     * PNPM documentation: https://pnpm.io/package_json#pnpmoverrides
+     */
+    readonly globalOverrides: Record<string, string> | undefined;
+    /**
+     * The `globalPeerDependencyRules` setting provides various settings for suppressing validation errors
+     * that are reported during installation with `strictPeerDependencies=true`.  The settings are copied
+     * into the `pnpm.peerDependencyRules` field of the `common/temp/package.json` file that is generated
+     * by Rush during installation.
+     *
+     * Order of precedence: `.pnpmfile.cjs` has the highest precedence, followed by
+     * `unsupportedPackageJsonSettings`, `globalPeerDependencyRules`, `globalPackageExtensions`,
+     * and `globalOverrides` has lowest precedence.
+     *
+     * https://pnpm.io/package_json#pnpmpeerdependencyrules
+     */
+    readonly globalPeerDependencyRules: IPnpmPeerDependencyRules | undefined;
+    /**
+     * The `globalPackageExtension` setting provides a way to patch arbitrary package.json fields
+     * for any PNPM dependency of the monorepo.  The settings are copied into the `pnpm.packageExtensions`
+     * field of the `common/temp/package.json` file that is generated by Rush during installation.
+     * The `globalPackageExtension` setting has similar capabilities as `.pnpmfile.cjs` but without
+     * the downsides of an executable script (nondeterminism, unreliable caching, performance concerns).
+     *
+     * Order of precedence: `.pnpmfile.cjs` has the highest precedence, followed by
+     * `unsupportedPackageJsonSettings`, `globalPeerDependencyRules`, `globalPackageExtensions`,
+     * and `globalOverrides` has lowest precedence.
+     *
+     * PNPM documentation: https://pnpm.io/package_json#pnpmpackageextensions
+     */
+    readonly globalPackageExtensions: Record<string, IPnpmPackageExtension> | undefined;
+    /**
+     * The `globalNeverBuiltDependencies` setting suppresses the `preinstall`, `install`, and `postinstall`
+     * lifecycle events for the specified NPM dependencies.  This is useful for scripts with poor practices
+     * such as downloading large binaries without retries or attempting to invoke OS tools such as
+     * a C++ compiler.  (PNPM's terminology refers to these lifecycle events as "building" a package;
+     * it has nothing to do with build system operations such as `rush build` or `rushx build`.)
+     * The settings are copied into the `pnpm.neverBuiltDependencies` field of the `common/temp/package.json`
+     * file that is generated by Rush during installation.
+     *
+     * PNPM documentation: https://pnpm.io/package_json#pnpmneverbuiltdependencies
+     */
+    readonly globalNeverBuiltDependencies: string[] | undefined;
+    /**
+     * The `globalAllowedDeprecatedVersions` setting suppresses installation warnings for package
+     * versions that the NPM registry reports as being deprecated.  This is useful if the
+     * deprecated package is an indirect dependency of an external package that has not released a fix.
+     * The settings are copied into the `pnpm.allowedDeprecatedVersions` field of the `common/temp/package.json`
+     * file that is generated by Rush during installation.
+     *
+     * PNPM documentation: https://pnpm.io/package_json#pnpmalloweddeprecatedversions
+     *
+     * If you are working to eliminate a deprecated version, it's better to specify `allowedDeprecatedVersions`
+     * in the package.json file for individual Rush projects.
+     */
+    readonly globalAllowedDeprecatedVersions: Record<string, string> | undefined;
+    /**
+     * (USE AT YOUR OWN RISK)  This is a free-form property bag that will be copied into
+     * the `common/temp/package.json` file that is generated by Rush during installation.
+     * This provides a way to experiment with new PNPM features.  These settings will override
+     * any other Rush configuration associated with a given JSON field except for `.pnpmfile.cjs`.
+     *
+     * USAGE OF THIS SETTING IS NOT SUPPORTED BY THE RUSH MAINTAINERS AND MAY CAUSE RUSH
+     * TO MALFUNCTION.  If you encounter a missing PNPM setting that you believe should
+     * be supported, please create a GitHub issue or PR.  Note that Rush does not aim to
+     * support every possible PNPM setting, but rather to promote a battle-tested installation
+     * strategy that is known to provide a good experience for large teams with lots of projects.
+     */
+    readonly unsupportedPackageJsonSettings: unknown | undefined;
+    private constructor();
+    /** @internal */
+    static loadFromJsonFileOrThrow(jsonFilename: string, commonTempFolder: string): PnpmOptionsConfiguration;
     /** @internal */
-    constructor(json: _IPnpmOptionsJson, commonTempFolder: string);
+    static loadFromJsonObject(json: _IPnpmOptionsJson, commonTempFolder: string): PnpmOptionsConfiguration;
 }
 
 /**
@@ -2310,6 +2441,7 @@ export declare class RushConfiguration {
     private _gitSampleEmail;
     private _gitVersionBumpCommitMessage;
     private _gitChangeLogUpdateCommitMessage;
+    private _gitChangefilesCommitMessage;
     private _gitTagSeparator;
     private _hotfixChangeEnabled;
     private _repositoryUrls;
@@ -2582,6 +2714,11 @@ export declare class RushConfiguration {
      * The commit message to use when committing change log files 'rush version'
      */
     get gitChangeLogUpdateCommitMessage(): string | undefined;
+    /**
+     * [Part of the "gitPolicy" feature.]
+     * The commit message to use when committing change log files 'rush version'
+     */
+    get gitChangefilesCommitMessage(): string | undefined;
     /**
      * [Part of the "gitPolicy" feature.]
      * The separator between package name and version in git tag.
@@ -3086,6 +3223,10 @@ export declare class RushConstants {
      * Experiments configuration file.
      */
     static readonly experimentsFilename: string;
+    /**
+     * Pnpm configuration file
+     */
+    static readonly pnpmConfigFilename: string;
     /**
      * Rush plugins configuration file name.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.78.1",
+  "version": "5.79.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "tapable": "2.2.1"
   },
   "devDependencies": {
-    "@microsoft/rush-lib": "5.78.1",
+    "@microsoft/rush-lib": "5.79.0",
     "@rushstack/eslint-config": "3.0.1",
     "@rushstack/heft": "0.47.10",
     "@rushstack/heft-node-rig": "1.10.12",