@rushstack/rush-sdk 5.163.0 → 5.164.0

package/dist/rush-lib.d.ts

@@ -2277,6 +2277,10 @@ export declare interface _IPnpmOptionsJson extends IPackageManagerOptionsJsonBas
      * {@inheritDoc PnpmOptionsConfiguration.pnpmLockfilePolicies}
      */
     pnpmLockfilePolicies?: IPnpmLockfilePolicies;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalCatalogs}
+     */
+    globalCatalogs?: Record<string, Record<string, string>>;
 }
 
 /**
@@ -3543,6 +3547,15 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      * The default value is false.
      */
     readonly alwaysFullInstall: boolean | undefined;
+    /**
+     * The `globalCatalogs` setting provides named catalogs for organizing dependency versions.
+     * Each catalog can be referenced using the `catalog:catalogName` protocol in package.json files
+     * (e.g., `catalog:react18`). The settings are written to the `catalogs` field of the
+     * `pnpm-workspace.yaml` file that is generated by Rush during installation.
+     *
+     * PNPM documentation: https://pnpm.io/catalogs
+     */
+    readonly globalCatalogs: Record<string, Record<string, string>> | undefined;
     /**
      * (GENERATED BY RUSH-PNPM PATCH-COMMIT) When modifying this property, make sure you know what you are doing.
      *
@@ -3624,6 +3637,7 @@ export declare class RepoStateFile {
     private _pnpmShrinkwrapHash;
     private _preferredVersionsHash;
     private _packageJsonInjectedDependenciesHash;
+    private _pnpmCatalogsHash;
     private _isValid;
     private _modified;
     /**
@@ -3643,6 +3657,10 @@ export declare class RepoStateFile {
      * The hash of all preferred versions at the end of the last update.
      */
     get packageJsonInjectedDependenciesHash(): string | undefined;
+    /**
+     * The hash of the PNPM catalog definitions at the end of the last update.
+     */
+    get pnpmCatalogsHash(): string | undefined;
     /**
      * If false, the repo-state.json file is not valid and its values cannot be relied upon
      */
@@ -5099,6 +5117,11 @@ export declare class Subspace {
     contains(project: RushConfigurationProject): boolean;
     /** @internal */
     _addProject(project: RushConfigurationProject): void;
+    /**
+     * Computes a hash of the PNPM catalog definitions for this subspace.
+     * Returns undefined if no catalogs are defined.
+     */
+    getPnpmCatalogsHash(): string | undefined;
     /**
      * Returns hash value of injected dependencies in related package.json.
      * @beta

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.55.1"
+      "packageVersion": "7.55.2"
     }
   ]
 }

package/lib/api/Subspace.d.ts

@@ -168,6 +168,11 @@ export declare class Subspace {
     contains(project: RushConfigurationProject): boolean;
     /** @internal */
     _addProject(project: RushConfigurationProject): void;
+    /**
+     * Computes a hash of the PNPM catalog definitions for this subspace.
+     * Returns undefined if no catalogs are defined.
+     */
+    getPnpmCatalogsHash(): string | undefined;
     /**
      * Returns hash value of injected dependencies in related package.json.
      * @beta

package/lib/logic/DependencySpecifier.d.ts

@@ -37,7 +37,11 @@ export declare enum DependencySpecifierType {
     /**
      * A package specified using workspace protocol, e.g. "workspace:^1.2.3"
      */
-    Workspace = "Workspace"
+    Workspace = "Workspace",
+    /**
+     * A package specified using catalog protocol, e.g. "catalog:" or "catalog:react18"
+     */
+    Catalog = "Catalog"
 }
 /**
  * An NPM "version specifier" is a string that can appear as a package.json "dependencies" value.

package/lib/logic/RepoStateFile.d.ts

@@ -11,6 +11,7 @@ export declare class RepoStateFile {
     private _pnpmShrinkwrapHash;
     private _preferredVersionsHash;
     private _packageJsonInjectedDependenciesHash;
+    private _pnpmCatalogsHash;
     private _isValid;
     private _modified;
     /**
@@ -30,6 +31,10 @@ export declare class RepoStateFile {
      * The hash of all preferred versions at the end of the last update.
      */
     get packageJsonInjectedDependenciesHash(): string | undefined;
+    /**
+     * The hash of the PNPM catalog definitions at the end of the last update.
+     */
+    get pnpmCatalogsHash(): string | undefined;
     /**
      * If false, the repo-state.json file is not valid and its values cannot be relied upon
      */

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

@@ -138,6 +138,10 @@ export interface IPnpmOptionsJson extends IPackageManagerOptionsJsonBase {
      * {@inheritDoc PnpmOptionsConfiguration.pnpmLockfilePolicies}
      */
     pnpmLockfilePolicies?: IPnpmLockfilePolicies;
+    /**
+     * {@inheritDoc PnpmOptionsConfiguration.globalCatalogs}
+     */
+    globalCatalogs?: Record<string, Record<string, string>>;
 }
 /**
  * Options that are only used when the PNPM package manager is selected.
@@ -378,6 +382,15 @@ export declare class PnpmOptionsConfiguration extends PackageManagerOptionsConfi
      * The default value is false.
      */
     readonly alwaysFullInstall: boolean | undefined;
+    /**
+     * The `globalCatalogs` setting provides named catalogs for organizing dependency versions.
+     * Each catalog can be referenced using the `catalog:catalogName` protocol in package.json files
+     * (e.g., `catalog:react18`). The settings are written to the `catalogs` field of the
+     * `pnpm-workspace.yaml` file that is generated by Rush during installation.
+     *
+     * PNPM documentation: https://pnpm.io/catalogs
+     */
+    readonly globalCatalogs: Record<string, Record<string, string>> | undefined;
     /**
      * (GENERATED BY RUSH-PNPM PATCH-COMMIT) When modifying this property, make sure you know what you are doing.
      *

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

@@ -5,11 +5,17 @@ export declare class PnpmWorkspaceFile extends BaseWorkspaceFile {
      */
     readonly workspaceFilename: string;
     private _workspacePackages;
+    private _catalogs;
     /**
      * The PNPM workspace file is used to specify the location of workspaces relative to the root
      * of your PNPM install.
      */
     constructor(workspaceYamlFilename: string);
+    /**
+     * Sets the catalog definitions for the workspace.
+     * @param catalogs - A map of catalog name to package versions
+     */
+    setCatalogs(catalogs: Record<string, Record<string, string>> | undefined): void;
     /** @override */
     addPackage(packagePath: string): void;
     /** @override */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.163.0",
+  "version": "5.164.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -36,24 +36,24 @@
   "dependencies": {
     "@pnpm/lockfile.types": "~1.0.3",
     "tapable": "2.2.1",
-    "@rushstack/credential-cache": "0.1.3",
-    "@rushstack/node-core-library": "5.19.0",
-    "@rushstack/lookup-by-path": "0.8.8",
-    "@rushstack/terminal": "0.19.4",
-    "@rushstack/package-deps-hash": "4.5.6"
+    "@rushstack/lookup-by-path": "0.8.9",
+    "@rushstack/credential-cache": "0.1.4",
+    "@rushstack/package-deps-hash": "4.6.0",
+    "@rushstack/terminal": "0.19.5",
+    "@rushstack/node-core-library": "5.19.1"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.8",
     "eslint": "~9.37.0",
     "webpack": "~5.98.0",
-    "@rushstack/heft": "1.1.6",
-    "@rushstack/heft-webpack5-plugin": "1.2.6",
-    "@microsoft/rush-lib": "5.163.0",
-    "@rushstack/stream-collator": "4.1.118",
-    "local-node-rig": "1.0.0",
-    "@rushstack/ts-command-line": "5.1.4",
-    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.117"
+    "@rushstack/heft": "1.1.7",
+    "@microsoft/rush-lib": "5.164.0",
+    "@rushstack/heft-webpack5-plugin": "1.2.7",
+    "@rushstack/stream-collator": "4.1.119",
+    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.118",
+    "@rushstack/ts-command-line": "5.1.5",
+    "local-node-rig": "1.0.0"
   },
   "scripts": {
     "build": "heft build --clean",