workspace-tools 0.40.0 → 0.40.3

package/README.md

@@ -20,7 +20,7 @@ Override the `maxBuffer` value for git processes, for example if the repo is ver
 
 ### PREFERRED_WORKSPACE_MANAGER
 
-Sometimes if multiple workspace manager files are checked in, it's necessary to hint which manager is used: `npm`, `yarn`, `pnpm`, `rush`, or `lerna`.
+Sometimes if multiple workspace/monorepo manager files are checked in, it's necessary to hint which manager is used: `npm`, `yarn`, `pnpm`, `rush`, or `lerna`.
 
 ### VERBOSE
 

package/lib/getPackageInfos.d.ts

@@ -1,17 +1,17 @@
 import { PackageInfos } from "./types/PackageInfo";
 /**
- * Read all the package.json files in a monorepo. Only works for monorepos which
- * use a supported workspace manager.
- * @param cwd Start looking for the workspace manager config from here
+ * Read all the package.json files in a monorepo.
+ * Only works for monorepos which use a supported workspace/monorepo manager.
+ * @param cwd Start looking for the manager config from here
  */
 export declare function getPackageInfos(cwd: string): PackageInfos;
 /**
  * Read all the package.json files in a monorepo. Only works for monorepos which
- * use a supported workspace manager.
+ * use a supported workspace/monorepo manager.
  *
  * NOTE: As of writing, this will start promises to read all package.json files in parallel,
  * without direct concurrency control.
  *
- * @param cwd Start looking for the workspace manager config from here
+ * @param cwd Start looking for the manager config from here
  */
 export declare function getPackageInfosAsync(cwd: string): Promise<PackageInfos>;

package/lib/getPackageInfos.js

@@ -4,9 +4,9 @@ exports.getPackageInfosAsync = exports.getPackageInfos = void 0;
 const getWorkspaces_1 = require("./workspaces/getWorkspaces");
 const getPackageInfo_1 = require("./getPackageInfo");
 /**
- * Read all the package.json files in a monorepo. Only works for monorepos which
- * use a supported workspace manager.
- * @param cwd Start looking for the workspace manager config from here
+ * Read all the package.json files in a monorepo.
+ * Only works for monorepos which use a supported workspace/monorepo manager.
+ * @param cwd Start looking for the manager config from here
  */
 function getPackageInfos(cwd) {
     const packageInfos = {};
@@ -27,12 +27,12 @@ function getPackageInfos(cwd) {
 exports.getPackageInfos = getPackageInfos;
 /**
  * Read all the package.json files in a monorepo. Only works for monorepos which
- * use a supported workspace manager.
+ * use a supported workspace/monorepo manager.
  *
  * NOTE: As of writing, this will start promises to read all package.json files in parallel,
  * without direct concurrency control.
  *
- * @param cwd Start looking for the workspace manager config from here
+ * @param cwd Start looking for the manager config from here
  */
 async function getPackageInfosAsync(cwd) {
     const packageInfos = {};

package/lib/getPackagePaths.d.ts

@@ -1,10 +1,10 @@
 /**
- * Given package folder globs (such as those from package.json `workspaces`) and a workspace root
+ * Given package folder globs (such as those from package.json `workspaces`) and a monorepo root
  * directory, get absolute paths to actual package folders.
  */
 export declare function getPackagePaths(root: string, packageGlobs: string[]): string[];
 /**
- * Given package folder globs (such as those from package.json `workspaces`) and a workspace root
+ * Given package folder globs (such as those from package.json `workspaces`) and a monorepo root
  * directory, get absolute paths to actual package folders.
  */
 export declare function getPackagePathsAsync(root: string, packageGlobs: string[]): Promise<string[]>;

package/lib/getPackagePaths.js

@@ -14,7 +14,7 @@ const globOptions = {
     stats: false,
 };
 /**
- * Given package folder globs (such as those from package.json `workspaces`) and a workspace root
+ * Given package folder globs (such as those from package.json `workspaces`) and a monorepo root
  * directory, get absolute paths to actual package folders.
  */
 function getPackagePaths(root, packageGlobs) {
@@ -28,7 +28,7 @@ function getPackagePaths(root, packageGlobs) {
 }
 exports.getPackagePaths = getPackagePaths;
 /**
- * Given package folder globs (such as those from package.json `workspaces`) and a workspace root
+ * Given package folder globs (such as those from package.json `workspaces`) and a monorepo root
  * directory, get absolute paths to actual package folders.
  */
 async function getPackagePathsAsync(root, packageGlobs) {

package/lib/graph/getPackageDependencies.d.ts

@@ -5,7 +5,7 @@ export interface PackageDependenciesOptions {
     withOptionalDependencies?: boolean;
 }
 /**
- * Gets the workspace package dependencies for a given package (excluding `file:` or `npm:` versions).
+ * Gets the monorepo package dependencies for a given package (excluding `file:` or `npm:` versions).
  * It only considers `dependencies` unless options specify otherwise.
  *
  * @param info - The package information containing dependencies

package/lib/graph/getPackageDependencies.js

@@ -17,7 +17,7 @@ function isValidDependency(info, dep) {
     return !range.startsWith("npm:") && !range.startsWith("file:");
 }
 /**
- * Gets the workspace package dependencies for a given package (excluding `file:` or `npm:` versions).
+ * Gets the monorepo package dependencies for a given package (excluding `file:` or `npm:` versions).
  * It only considers `dependencies` unless options specify otherwise.
  *
  * @param info - The package information containing dependencies

package/lib/index.d.ts

@@ -22,4 +22,6 @@ export { getChangedPackages, getChangedPackagesBetweenRefs } from "./workspaces/
 export { getPackagesByFiles } from "./workspaces/getPackagesByFiles";
 export { listOfWorkspacePackageNames } from "./workspaces/listOfWorkspacePackageNames";
 export { getAllPackageJsonFiles, getAllPackageJsonFilesAsync } from "./workspaces/getAllPackageJsonFiles";
-export { getCatalogs, getCatalogVersion, isCatalogVersion } from "./workspaces/catalogs";
+export { catalogsToYaml } from "./workspaces/catalogsToYaml";
+export { getCatalogVersion, isCatalogVersion } from "./workspaces/getCatalogVersion";
+export { getCatalogs } from "./workspaces/getCatalogs";

package/lib/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCatalogVersion = exports.getCatalogVersion = exports.getCatalogs = exports.getAllPackageJsonFilesAsync = exports.getAllPackageJsonFiles = exports.listOfWorkspacePackageNames = exports.getPackagesByFiles = exports.getChangedPackagesBetweenRefs = exports.getChangedPackages = exports.getYarnWorkspaces = exports.getYarnWorkspaceRoot = exports.getRushWorkspaces = exports.getRushWorkspaceRoot = exports.getPnpmWorkspaces = exports.getPnpmWorkspaceRoot = exports.getPackageInfoAsync = exports.getPackageInfo = exports.getWorkspaceRoot = exports.getWorkspaceManagerRoot = exports.getWorkspacePackagePathsAsync = exports.getWorkspacePackagePaths = exports.getWorkspacesAsync = exports.getWorkspaces = exports.findWorkspacePath = exports.getScopedPackages = exports.searchUp = exports.isChildOf = exports.findProjectRoot = exports.findPackageRoot = exports.findGitRoot = exports.setCachingEnabled = exports.getPackageInfosAsync = exports.getPackageInfos = void 0;
+exports.getCatalogs = exports.isCatalogVersion = exports.getCatalogVersion = exports.catalogsToYaml = exports.getAllPackageJsonFilesAsync = exports.getAllPackageJsonFiles = exports.listOfWorkspacePackageNames = exports.getPackagesByFiles = exports.getChangedPackagesBetweenRefs = exports.getChangedPackages = exports.getYarnWorkspaces = exports.getYarnWorkspaceRoot = exports.getRushWorkspaces = exports.getRushWorkspaceRoot = exports.getPnpmWorkspaces = exports.getPnpmWorkspaceRoot = exports.getPackageInfoAsync = exports.getPackageInfo = exports.getWorkspaceRoot = exports.getWorkspaceManagerRoot = exports.getWorkspacePackagePathsAsync = exports.getWorkspacePackagePaths = exports.getWorkspacesAsync = exports.getWorkspaces = exports.findWorkspacePath = exports.getScopedPackages = exports.searchUp = exports.isChildOf = exports.findProjectRoot = exports.findPackageRoot = exports.findGitRoot = exports.setCachingEnabled = exports.getPackageInfosAsync = exports.getPackageInfos = void 0;
 __exportStar(require("./dependencies/index"), exports);
 var getPackageInfos_1 = require("./getPackageInfos");
 Object.defineProperty(exports, "getPackageInfos", { enumerable: true, get: function () { return getPackageInfos_1.getPackageInfos; } });
@@ -65,8 +65,11 @@ Object.defineProperty(exports, "listOfWorkspacePackageNames", { enumerable: true
 var getAllPackageJsonFiles_1 = require("./workspaces/getAllPackageJsonFiles");
 Object.defineProperty(exports, "getAllPackageJsonFiles", { enumerable: true, get: function () { return getAllPackageJsonFiles_1.getAllPackageJsonFiles; } });
 Object.defineProperty(exports, "getAllPackageJsonFilesAsync", { enumerable: true, get: function () { return getAllPackageJsonFiles_1.getAllPackageJsonFilesAsync; } });
-var catalogs_1 = require("./workspaces/catalogs");
-Object.defineProperty(exports, "getCatalogs", { enumerable: true, get: function () { return catalogs_1.getCatalogs; } });
-Object.defineProperty(exports, "getCatalogVersion", { enumerable: true, get: function () { return catalogs_1.getCatalogVersion; } });
-Object.defineProperty(exports, "isCatalogVersion", { enumerable: true, get: function () { return catalogs_1.isCatalogVersion; } });
+var catalogsToYaml_1 = require("./workspaces/catalogsToYaml");
+Object.defineProperty(exports, "catalogsToYaml", { enumerable: true, get: function () { return catalogsToYaml_1.catalogsToYaml; } });
+var getCatalogVersion_1 = require("./workspaces/getCatalogVersion");
+Object.defineProperty(exports, "getCatalogVersion", { enumerable: true, get: function () { return getCatalogVersion_1.getCatalogVersion; } });
+Object.defineProperty(exports, "isCatalogVersion", { enumerable: true, get: function () { return getCatalogVersion_1.isCatalogVersion; } });
+var getCatalogs_1 = require("./workspaces/getCatalogs");
+Object.defineProperty(exports, "getCatalogs", { enumerable: true, get: function () { return getCatalogs_1.getCatalogs; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,qDAA0E;AAAjE,kHAAA,eAAe,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAC9C,wCAAsB;AACtB,gDAA8B;AAC9B,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA;AAC1B,6CAA2B;AAC3B,iCAA6F;AAApF,oGAAA,WAAW,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAC3E,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAK1B,oEAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAC1B,4DAA+E;AAAtE,8GAAA,aAAa,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAC1C,kFAAgH;AAAvG,oIAAA,wBAAwB,OAAA;AAAE,yIAAA,6BAA6B,OAAA;AAChE,kEAA0F;AAAjF,2HAAA,uBAAuB,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AAClD,mDAAuE;AAA9D,gHAAA,cAAc,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC5C,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,sEAAoG;AAA3F,wHAAA,kBAAkB,OAAA;AAAE,mIAAA,6BAA6B,OAAA;AAC1D,sEAAqE;AAA5D,wHAAA,kBAAkB,OAAA;AAC3B,wFAAuF;AAA9E,0IAAA,2BAA2B,OAAA;AACpC,8EAA0G;AAAjG,gIAAA,sBAAsB,OAAA;AAAE,qIAAA,2BAA2B,OAAA;AAC5D,kDAAyF;AAAhF,uGAAA,WAAW,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,qDAA0E;AAAjE,kHAAA,eAAe,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAC9C,wCAAsB;AACtB,gDAA8B;AAC9B,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA;AAC1B,6CAA2B;AAC3B,iCAA6F;AAApF,oGAAA,WAAW,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAC3E,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAK1B,oEAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAC1B,4DAA+E;AAAtE,8GAAA,aAAa,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAC1C,kFAAgH;AAAvG,oIAAA,wBAAwB,OAAA;AAAE,yIAAA,6BAA6B,OAAA;AAChE,kEAA0F;AAAjF,2HAAA,uBAAuB,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AAClD,mDAAuE;AAA9D,gHAAA,cAAc,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC5C,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,0DAA4F;AAAnF,4GAAA,oBAAoB,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAChD,sEAAoG;AAA3F,wHAAA,kBAAkB,OAAA;AAAE,mIAAA,6BAA6B,OAAA;AAC1D,sEAAqE;AAA5D,wHAAA,kBAAkB,OAAA;AAC3B,wFAAuF;AAA9E,0IAAA,2BAA2B,OAAA;AACpC,8EAA0G;AAAjG,gIAAA,sBAAsB,OAAA;AAAE,qIAAA,2BAA2B,OAAA;AAC5D,8DAA6D;AAApD,gHAAA,cAAc,OAAA;AACvB,oEAAqF;AAA5E,sHAAA,iBAAiB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAC5C,wDAAuD;AAA9C,0GAAA,WAAW,OAAA"}

package/lib/paths.d.ts

@@ -14,8 +14,13 @@ export declare function findGitRoot(cwd: string): string;
  */
 export declare function findPackageRoot(cwd: string): string | undefined;
 /**
- * Starting from `cwd`, searches up the directory hierarchy for the workspace root,
- * falling back to the git root if no workspace is detected.
+ * Starting from `cwd`, searches up the directory hierarchy for the project root (workspace/monorepo
+ * manager root), falling back to the git root if no manager root is detected. Results are cached by
+ * `cwd`, and an error is thrown if no project root is found and it's not a git repo.
+ *
+ * To skip the git root fallback, use `getWorkspaceManagerRoot`. Usually the monorepo manager root
+ * is the same as the git root, but this may not be the case with multiple "monorepos" in a single
+ * git repo, or in project structures with multiple languages where the JS is not at the root.
  */
 export declare function findProjectRoot(cwd: string): string;
 /**

package/lib/paths.js

@@ -51,19 +51,24 @@ function findPackageRoot(cwd) {
 }
 exports.findPackageRoot = findPackageRoot;
 /**
- * Starting from `cwd`, searches up the directory hierarchy for the workspace root,
- * falling back to the git root if no workspace is detected.
+ * Starting from `cwd`, searches up the directory hierarchy for the project root (workspace/monorepo
+ * manager root), falling back to the git root if no manager root is detected. Results are cached by
+ * `cwd`, and an error is thrown if no project root is found and it's not a git repo.
+ *
+ * To skip the git root fallback, use `getWorkspaceManagerRoot`. Usually the monorepo manager root
+ * is the same as the git root, but this may not be the case with multiple "monorepos" in a single
+ * git repo, or in project structures with multiple languages where the JS is not at the root.
  */
 function findProjectRoot(cwd) {
     let workspaceRoot;
     try {
         workspaceRoot = (0, getWorkspaceRoot_1.getWorkspaceManagerRoot)(cwd);
+        if (!workspaceRoot) {
+            (0, logging_1.logVerboseWarning)(`Could not find workspace manager root for ${cwd}. Falling back to git root.`);
+        }
     }
     catch (err) {
-        (0, logging_1.logVerboseWarning)(`Error getting workspace root for ${cwd}`, err);
-    }
-    if (!workspaceRoot) {
-        (0, logging_1.logVerboseWarning)(`Could not find workspace root for ${cwd}. Falling back to git root.`);
+        (0, logging_1.logVerboseWarning)(`Error getting workspace manager root for ${cwd} (will fall back to git root)`, err);
     }
     return workspaceRoot || findGitRoot(cwd);
 }

package/lib/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AACpB,oEAAwE;AACxE,+BAA4B;AAC5B,uCAA8C;AAE9C;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,QAA2B,EAAE,GAAW;IAC/D,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnE,wCAAwC;IACxC,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,cAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAElC,IAAI,SAA6B,CAAC;IAElC,OAAO,CAAC,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;QACjC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,SAAS,EAAE;YACb,MAAM;SACP;QAED,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KACzB;IAED,OAAO,SAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAlBD,4BAkBC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAA,SAAG,EAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,8BAA8B,CAAC,CAAC;KAClE;IAED,OAAO,cAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAPD,kCAOC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,QAAQ,IAAI,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAHD,0CAGC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,aAAiC,CAAC;IACtC,IAAI;QACF,aAAa,GAAG,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC;KAC9C;IAAC,OAAO,GAAG,EAAE;QACZ,IAAA,2BAAiB,EAAC,oCAAoC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;KACnE;IAED,IAAI,CAAC,aAAa,EAAE;QAClB,IAAA,2BAAiB,EAAC,qCAAqC,GAAG,6BAA6B,CAAC,CAAC;KAC1F;IACD,OAAO,aAAa,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAZD,0CAYC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAa,EAAE,MAAc;IACrD,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAHD,8BAGC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AACpB,oEAAwE;AACxE,+BAA4B;AAC5B,uCAA8C;AAE9C;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,QAA2B,EAAE,GAAW;IAC/D,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnE,wCAAwC;IACxC,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,cAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAElC,IAAI,SAA6B,CAAC;IAElC,OAAO,CAAC,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;QACjC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,SAAS,EAAE;YACb,MAAM;SACP;QAED,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KACzB;IAED,OAAO,SAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAlBD,4BAkBC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAA,SAAG,EAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,8BAA8B,CAAC,CAAC;KAClE;IAED,OAAO,cAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAPD,kCAOC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,QAAQ,IAAI,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAHD,0CAGC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,aAAiC,CAAC;IACtC,IAAI;QACF,aAAa,GAAG,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,EAAE;YAClB,IAAA,2BAAiB,EAAC,6CAA6C,GAAG,6BAA6B,CAAC,CAAC;SAClG;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,IAAA,2BAAiB,EAAC,4CAA4C,GAAG,+BAA+B,EAAE,GAAG,CAAC,CAAC;KACxG;IAED,OAAO,aAAa,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAZD,0CAYC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAa,EAAE,MAAc;IACrD,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAHD,8BAGC"}

package/lib/types/Catalogs.d.ts

@@ -21,10 +21,18 @@ export interface NamedCatalogs {
  */
 export interface Catalogs {
     /**
-     * The default catalog if present.
-     * (This can't be combined with the named catalogs because "default" could be a catalog name.)
+     * The default catalog (`catalog:`) if present.
+     *
+     * Whether this is equivalent to `catalogs.default` depends on the package manager:
+     * they're the same in pnpm, but different in yarn. If there was a pnpm catalog named "default",
+     * it will be stored under this property instead (but `getCatalogVersion` supports either syntax).
      */
     default?: Catalog;
-    /** Mapping from catalog name to catalog definition, if present */
+    /**
+     * Mapping from catalog name to catalog definition, if present.
+     *
+     * (For pnpm, if there was a catalog named "default", it will be under `Catalogs.default`
+     * and omitted here.)
+     */
     named?: NamedCatalogs;
 }

package/lib/workspaces/catalogsToYaml.d.ts

@@ -0,0 +1,8 @@
+import type { Catalogs } from "../types/Catalogs";
+/**
+ * Convert catalogs to the yaml format used by yarn v4 and pnpm.
+ */
+export declare function catalogsToYaml(catalogs: Catalogs, options?: {
+    /** Number of spaces (default 2), or another indentation character */
+    indent?: number | string;
+}): string;

package/lib/workspaces/catalogsToYaml.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.catalogsToYaml = void 0;
+/**
+ * Convert catalogs to the yaml format used by yarn v4 and pnpm.
+ */
+function catalogsToYaml(catalogs, options = {}) {
+    const { named, default: defaultCatalog } = catalogs;
+    const lines = [];
+    const indent = typeof options.indent === "string" ? options.indent : " ".repeat(options.indent ?? 2);
+    if (defaultCatalog) {
+        lines.push("catalog:");
+        for (const [pkg, version] of Object.entries(defaultCatalog)) {
+            lines.push(`${indent}${pkg}: ${version}`);
+        }
+    }
+    if (named) {
+        lines.push("catalogs:");
+        for (const [catalogName, catalogEntries] of Object.entries(named)) {
+            lines.push(`${indent}${catalogName}:`);
+            for (const [pkg, version] of Object.entries(catalogEntries)) {
+                lines.push(`${indent}${indent}${pkg}: ${version}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+exports.catalogsToYaml = catalogsToYaml;
+//# sourceMappingURL=catalogsToYaml.js.map

package/lib/workspaces/catalogsToYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogsToYaml.js","sourceRoot":"","sources":["../../src/workspaces/catalogsToYaml.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,SAAgB,cAAc,CAC5B,QAAkB,EAClB,UAGI,EAAE;IAEN,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAErG,IAAI,cAAc,EAAE;QAClB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;YAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;SAC3C;KACF;IAED,IAAI,KAAK,EAAE;QACT,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACjE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;gBAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;aACpD;SACF;KACF;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AA7BD,wCA6BC"}

package/lib/workspaces/getAllPackageJsonFiles.d.ts

@@ -1,9 +1,9 @@
 /**
- * Get paths to every package.json in the workspace, given a cwd.
+ * Get paths to every package.json in the monorepo, given a cwd.
  */
 export declare function getAllPackageJsonFiles(cwd: string): string[];
 export declare function _resetPackageJsonFilesCache(): void;
 /**
- * Get paths to every package.json in the workspace, given a cwd.
+ * Get paths to every package.json in the monorepo, given a cwd.
  */
 export declare function getAllPackageJsonFilesAsync(cwd: string): Promise<string[]>;

package/lib/workspaces/getAllPackageJsonFiles.js

@@ -9,7 +9,7 @@ const getWorkspacePackagePaths_1 = require("./getWorkspacePackagePaths");
 const isCachingEnabled_1 = require("../isCachingEnabled");
 const cache = new Map();
 /**
- * Get paths to every package.json in the workspace, given a cwd.
+ * Get paths to every package.json in the monorepo, given a cwd.
  */
 function getAllPackageJsonFiles(cwd) {
     if ((0, isCachingEnabled_1.isCachingEnabled)() && cache.has(cwd)) {
@@ -25,7 +25,7 @@ function _resetPackageJsonFilesCache() {
 }
 exports._resetPackageJsonFilesCache = _resetPackageJsonFilesCache;
 /**
- * Get paths to every package.json in the workspace, given a cwd.
+ * Get paths to every package.json in the monorepo, given a cwd.
  */
 async function getAllPackageJsonFilesAsync(cwd) {
     if ((0, isCachingEnabled_1.isCachingEnabled)() && cache.has(cwd)) {

package/lib/workspaces/{catalogs.d.ts → getCatalogVersion.d.ts}

@@ -1,11 +1,4 @@
 import type { Catalogs } from "../types/Catalogs";
-/**
- * Get version catalogs, if supported by the manager (only pnpm and yarn v4 as of writing).
- * Returns undefined if no catalogs are present or the manager doesn't support them.
- * @see https://pnpm.io/catalogs
- * @see https://yarnpkg.com/features/catalogs
- */
-export declare function getCatalogs(cwd: string): Catalogs | undefined;
 /**
  * Returns true if the version starts with `catalog:`.
  */

package/lib/workspaces/{catalogs.js → getCatalogVersion.js}

@@ -1,18 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCatalogVersion = exports.isCatalogVersion = exports.getCatalogs = void 0;
-const implementations_1 = require("./implementations");
-/**
- * Get version catalogs, if supported by the manager (only pnpm and yarn v4 as of writing).
- * Returns undefined if no catalogs are present or the manager doesn't support them.
- * @see https://pnpm.io/catalogs
- * @see https://yarnpkg.com/features/catalogs
- */
-function getCatalogs(cwd) {
-    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
-    return utils?.getCatalogs?.(cwd);
-}
-exports.getCatalogs = getCatalogs;
+exports.getCatalogVersion = exports.isCatalogVersion = void 0;
 const catalogPrefix = "catalog:";
 /**
  * Returns true if the version starts with `catalog:`.
@@ -46,9 +34,17 @@ function getCatalogVersion(params) {
         throw new Error(`Dependency "${name}" uses a catalog version "${version}" but no catalogs are defined.`);
     }
     const catalogName = version.slice(catalogPrefix.length);
-    // If there's no name specified after "catalog:", use the default catalog.
-    // Otherwise use the named catalog.
-    const checkCatalog = catalogName ? catalogs.named?.[catalogName] : catalogs.default;
+    const checkCatalog = 
+    // Explicit catalog:default refers to the default catalog in pnpm, or a catalog named "default"
+    // in yarn... Check for the yarn case first or fall back to .default. (getCatalogs should have
+    // removed the named "default" catalog from namedCatalogs in managers where they're the same,
+    // and yarn install would have errored if a named catalog "default" was referenced but not defined.)
+    catalogName === "default"
+        ? catalogs.named?.default || catalogs.default
+        : // Otherwise use either the given named catalog, or the default if no name was specified
+            catalogName
+                ? catalogs.named?.[catalogName]
+                : catalogs.default;
     const catalogNameStr = catalogName ? `catalogs.${catalogName}` : "the default catalog";
     if (!checkCatalog) {
         throw new Error(`Dependency "${name}" uses a catalog version "${version}" but ${catalogNameStr} is not defined.`);
@@ -63,4 +59,4 @@ function getCatalogVersion(params) {
     return actualSpec;
 }
 exports.getCatalogVersion = getCatalogVersion;
-//# sourceMappingURL=catalogs.js.map
+//# sourceMappingURL=getCatalogVersion.js.map

package/lib/workspaces/getCatalogVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCatalogVersion.js","sourceRoot":"","sources":["../../src/workspaces/getCatalogVersion.ts"],"names":[],"mappings":";;;AAEA,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAC3C,CAAC;AAFD,4CAEC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,iBAAiB,CAAC,MAIjC;IACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE3C,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE;QAC9B,OAAO,SAAS,CAAC;KAClB;IAED,IAAI,CAAC,QAAQ,EAAE;QACb,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,6BAA6B,OAAO,gCAAgC,CAAC,CAAC;KAC1G;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,YAAY;IAChB,+FAA+F;IAC/F,8FAA8F;IAC9F,6FAA6F;IAC7F,oGAAoG;IACpG,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC7C,CAAC,CAAC,wFAAwF;YACxF,WAAW;gBACX,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC;gBAC/B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAEvF,IAAI,CAAC,YAAY,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,6BAA6B,OAAO,SAAS,cAAc,kBAAkB,CAAC,CAAC;KACnH;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,EAAE;QACf,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,6BAA6B,OAAO,UAAU,cAAc,kCAAkC,IAAI,IAAI,CAC1H,CAAC;KACH;IAED,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE;QAChC,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,8CAA8C,UAAU,4BAA4B,CACxG,CAAC;KACH;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AA/CD,8CA+CC"}

package/lib/workspaces/getCatalogs.d.ts

@@ -0,0 +1,9 @@
+import type { Catalogs } from "../types/Catalogs";
+/**
+ * Get version catalogs, if supported by the manager (only pnpm and yarn v4 as of writing).
+ * Returns undefined if no catalogs are present or the manager doesn't support them.
+ * @see https://pnpm.io/catalogs
+ * @see https://yarnpkg.com/features/catalogs
+ * @param cwd - Current working directory. It will search up from here to find the root, with caching.
+ */
+export declare function getCatalogs(cwd: string): Catalogs | undefined;

package/lib/workspaces/getCatalogs.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCatalogs = void 0;
+const implementations_1 = require("./implementations");
+/**
+ * Get version catalogs, if supported by the manager (only pnpm and yarn v4 as of writing).
+ * Returns undefined if no catalogs are present or the manager doesn't support them.
+ * @see https://pnpm.io/catalogs
+ * @see https://yarnpkg.com/features/catalogs
+ * @param cwd - Current working directory. It will search up from here to find the root, with caching.
+ */
+function getCatalogs(cwd) {
+    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
+    return utils?.getCatalogs?.(cwd);
+}
+exports.getCatalogs = getCatalogs;
+//# sourceMappingURL=getCatalogs.js.map

package/lib/workspaces/getCatalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCatalogs.js","sourceRoot":"","sources":["../../src/workspaces/getCatalogs.ts"],"names":[],"mappings":";;;AACA,uDAA0D;AAE1D;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IACzC,OAAO,KAAK,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAHD,kCAGC"}

package/lib/workspaces/getWorkspacePackageInfo.d.ts

@@ -6,7 +6,7 @@ import type { WorkspaceInfos } from "../types/WorkspaceInfo";
  * This is an internal helper used by `getWorkspaces` implementations for different managers.
  *
  * @param packagePaths Paths to packages within a monorepo
- * @returns Array of workspace package infos
+ * @returns Array of monorepo package infos
  * @internal
  */
 export declare function getWorkspacePackageInfo(packagePaths: string[]): WorkspaceInfos;
@@ -20,7 +20,7 @@ export declare function getWorkspacePackageInfo(packagePaths: string[]): Workspa
  * This is an internal helper used by `getWorkspaces` implementations for different managers.
  *
  * @param packagePaths Paths to packages within a monorepo
- * @returns Array of workspace package infos
+ * @returns Array of monorepo package infos
  * @internal
  */
 export declare function getWorkspacePackageInfoAsync(packagePaths: string[]): Promise<WorkspaceInfos>;

package/lib/workspaces/getWorkspacePackageInfo.js

@@ -16,7 +16,7 @@ const getPackageInfo_1 = require("../getPackageInfo");
  * This is an internal helper used by `getWorkspaces` implementations for different managers.
  *
  * @param packagePaths Paths to packages within a monorepo
- * @returns Array of workspace package infos
+ * @returns Array of monorepo package infos
  * @internal
  */
 function getWorkspacePackageInfo(packagePaths) {
@@ -48,7 +48,7 @@ exports.getWorkspacePackageInfo = getWorkspacePackageInfo;
  * This is an internal helper used by `getWorkspaces` implementations for different managers.
  *
  * @param packagePaths Paths to packages within a monorepo
- * @returns Array of workspace package infos
+ * @returns Array of monorepo package infos
  * @internal
  */
 async function getWorkspacePackageInfoAsync(packagePaths) {
@@ -66,7 +66,7 @@ async function getWorkspacePackageInfoAsync(packagePaths) {
             };
         }
         catch (err) {
-            (0, logging_1.logVerboseWarning)(`Error reading or parsing ${packageJsonPath} while getting workspace package info`, err);
+            (0, logging_1.logVerboseWarning)(`Error reading or parsing ${packageJsonPath} while getting monorepo package info`, err);
             return null;
         }
     });

package/lib/workspaces/getWorkspacePackageInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkspacePackageInfo.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspacePackageInfo.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,2DAAqC;AAGrC,wCAA+C;AAC/C,gEAA6D;AAC7D,sDAAmD;AAEnD;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,YAAsB;IAC5D,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,OAAO,YAAY;SAChB,GAAG,CAA8B,CAAC,aAAa,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,IAAA,+BAAc,EAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO,IAAI,CAAC,CAAC,0CAA0C;SACxD;QAED,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,IAAI,EAAE,aAAa;YACnB,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAmB,CAAC;AACvC,CAAC;AAnBD,0DAmBC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,4BAA4B,CAAC,YAAsB;IACvE,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAuC,KAAK,EAAE,aAAa,EAAE,EAAE;QAC1G,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEjE,IAAI;YACF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAU,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAgB,CAAC;YACnG,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,IAAA,yCAAmB,EAAC,WAAW,EAAE,eAAe,CAAC;aAC/D,CAAC;SACH;QAAC,OAAO,GAAG,EAAE;YACZ,IAAA,2BAAiB,EAAC,4BAA4B,eAAe,uCAAuC,EAAE,GAAG,CAAC,CAAC;YAC3G,OAAO,IAAI,CAAC;SACb;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAmB,CAAC;AACrF,CAAC;AAtBD,oEAsBC"}
+{"version":3,"file":"getWorkspacePackageInfo.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspacePackageInfo.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,2DAAqC;AAGrC,wCAA+C;AAC/C,gEAA6D;AAC7D,sDAAmD;AAEnD;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,YAAsB;IAC5D,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,OAAO,YAAY;SAChB,GAAG,CAA8B,CAAC,aAAa,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,IAAA,+BAAc,EAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO,IAAI,CAAC,CAAC,0CAA0C;SACxD;QAED,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,IAAI,EAAE,aAAa;YACnB,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAmB,CAAC;AACvC,CAAC;AAnBD,0DAmBC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,4BAA4B,CAAC,YAAsB;IACvE,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAuC,KAAK,EAAE,aAAa,EAAE,EAAE;QAC1G,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEjE,IAAI;YACF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAU,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAgB,CAAC;YACnG,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,IAAA,yCAAmB,EAAC,WAAW,EAAE,eAAe,CAAC;aAC/D,CAAC;SACH;QAAC,OAAO,GAAG,EAAE;YACZ,IAAA,2BAAiB,EAAC,4BAA4B,eAAe,sCAAsC,EAAE,GAAG,CAAC,CAAC;YAC1G,OAAO,IAAI,CAAC;SACb;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAmB,CAAC;AACrF,CAAC;AAtBD,oEAsBC"}

package/lib/workspaces/getWorkspacePackagePaths.d.ts

@@ -1,10 +1,10 @@
 /**
- * Get a list of package folder paths in the workspace. The list of included packages is based on
+ * Get a list of package folder paths in the monorepo. The list of included packages is based on
  * the manager's config file and matching package folders (which must contain package.json) on disk.
  */
 export declare function getWorkspacePackagePaths(cwd: string): string[];
 /**
- * Get a list of package folder paths in the workspace. The list of included packages is based on
+ * Get a list of package folder paths in the monorepo. The list of included packages is based on
  * the manager's config file and matching package folders (which must contain package.json) on disk.
  */
 export declare function getWorkspacePackagePathsAsync(cwd: string): Promise<string[]>;

package/lib/workspaces/getWorkspacePackagePaths.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspacePackagePathsAsync = exports.getWorkspacePackagePaths = void 0;
 const implementations_1 = require("./implementations");
 /**
- * Get a list of package folder paths in the workspace. The list of included packages is based on
+ * Get a list of package folder paths in the monorepo. The list of included packages is based on
  * the manager's config file and matching package folders (which must contain package.json) on disk.
  */
 function getWorkspacePackagePaths(cwd) {
@@ -12,7 +12,7 @@ function getWorkspacePackagePaths(cwd) {
 }
 exports.getWorkspacePackagePaths = getWorkspacePackagePaths;
 /**
- * Get a list of package folder paths in the workspace. The list of included packages is based on
+ * Get a list of package folder paths in the monorepo. The list of included packages is based on
  * the manager's config file and matching package folders (which must contain package.json) on disk.
  */
 async function getWorkspacePackagePathsAsync(cwd) {

package/lib/workspaces/getWorkspaceRoot.d.ts

@@ -1,9 +1,9 @@
 import { WorkspaceManager } from "./WorkspaceManager";
 /**
- * Get the root directory of a monorepo, defined as the directory where the workspace manager
- * config file is located.
+ * Get the root directory of a monorepo, defined as the directory where the workspace/monorepo manager
+ * config file is located. (Does not rely in any way on git, and the result is cached by `cwd`.)
  *
- * NOTE: "Workspace" here refers to the entire project, not an individual package the way it does
+ * NOTE: "Workspace" here refers to the entire project/monorepo, not an individual package the way it does
  * in e.g. npm/yarn/pnpm "workspaces."
  *
  * @param cwd Start searching from here
@@ -15,10 +15,11 @@ import { WorkspaceManager } from "./WorkspaceManager";
  */
 export declare function getWorkspaceRoot(cwd: string, preferredManager?: WorkspaceManager): string | undefined;
 /**
- * Get the root directory of a monorepo, defined as the directory where the workspace manager
- * config file is located.
+ * Get the root directory of a monorepo, defined as the directory where the workspace/monorepo manager
+ * config file is located. (Does not rely in any way on git, and the result is cached by `cwd`.)
  *
  * @param cwd Start searching from here
  * @param preferredManager Search for only this manager's config file
+ * @returns Workspace manager root directory, or undefined if not found
  */
 export declare function getWorkspaceManagerRoot(cwd: string, preferredManager?: WorkspaceManager): string | undefined;

package/lib/workspaces/getWorkspaceRoot.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspaceManagerRoot = exports.getWorkspaceRoot = void 0;
 const implementations_1 = require("./implementations");
 /**
- * Get the root directory of a monorepo, defined as the directory where the workspace manager
- * config file is located.
+ * Get the root directory of a monorepo, defined as the directory where the workspace/monorepo manager
+ * config file is located. (Does not rely in any way on git, and the result is cached by `cwd`.)
  *
- * NOTE: "Workspace" here refers to the entire project, not an individual package the way it does
+ * NOTE: "Workspace" here refers to the entire project/monorepo, not an individual package the way it does
  * in e.g. npm/yarn/pnpm "workspaces."
  *
  * @param cwd Start searching from here
@@ -21,11 +21,12 @@ function getWorkspaceRoot(cwd, preferredManager) {
 }
 exports.getWorkspaceRoot = getWorkspaceRoot;
 /**
- * Get the root directory of a monorepo, defined as the directory where the workspace manager
- * config file is located.
+ * Get the root directory of a monorepo, defined as the directory where the workspace/monorepo manager
+ * config file is located. (Does not rely in any way on git, and the result is cached by `cwd`.)
  *
  * @param cwd Start searching from here
  * @param preferredManager Search for only this manager's config file
+ * @returns Workspace manager root directory, or undefined if not found
  */
 function getWorkspaceManagerRoot(cwd, preferredManager) {
     return (0, implementations_1.getWorkspaceManagerAndRoot)(cwd, undefined, preferredManager)?.root;

package/lib/workspaces/getWorkspaceRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkspaceRoot.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaceRoot.ts"],"names":[],"mappings":";;;AACA,uDAA+D;AAE/D;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,GAAW,EAAE,gBAAmC;IAC/E,OAAO,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAFD,4CAEC;AAED;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,GAAW,EAAE,gBAAmC;IACtF,OAAO,IAAA,4CAA0B,EAAC,GAAG,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC;AAC5E,CAAC;AAFD,0DAEC"}
+{"version":3,"file":"getWorkspaceRoot.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaceRoot.ts"],"names":[],"mappings":";;;AACA,uDAA+D;AAE/D;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,GAAW,EAAE,gBAAmC;IAC/E,OAAO,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAFD,4CAEC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,GAAW,EAAE,gBAAmC;IACtF,OAAO,IAAA,4CAA0B,EAAC,GAAG,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC;AAC5E,CAAC;AAFD,0DAEC"}

package/lib/workspaces/getWorkspaces.d.ts

@@ -1,14 +1,14 @@
 import type { WorkspaceInfos } from "../types/WorkspaceInfo";
 /**
  * Get an array with names, paths, and package.json contents for each package ("workspace" in
- * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the workspace
- * manager's config file.
+ * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the
+ * workspace/monorepo manager's config file.
  */
 export declare function getWorkspaces(cwd: string): WorkspaceInfos;
 /**
  * Get an array with names, paths, and package.json contents for each package ("workspace" in
- * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the workspace
- * manager's config file.
+ * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the
+ * workspace/monorepo manager's config file.
  *
  * NOTE: As of writing, this will start promises to read all package.json files in parallel,
  * without direct concurrency control.

package/lib/workspaces/getWorkspaces.js

@@ -4,8 +4,8 @@ exports.getWorkspacesAsync = exports.getWorkspaces = void 0;
 const implementations_1 = require("./implementations");
 /**
  * Get an array with names, paths, and package.json contents for each package ("workspace" in
- * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the workspace
- * manager's config file.
+ * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the
+ * workspace/monorepo manager's config file.
  */
 function getWorkspaces(cwd) {
     const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
@@ -14,8 +14,8 @@ function getWorkspaces(cwd) {
 exports.getWorkspaces = getWorkspaces;
 /**
  * Get an array with names, paths, and package.json contents for each package ("workspace" in
- * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the workspace
- * manager's config file.
+ * npm/yarn/pnpm terms) within a monorepo. The list of included packages is based on the
+ * workspace/monorepo manager's config file.
  *
  * NOTE: As of writing, this will start promises to read all package.json files in parallel,
  * without direct concurrency control.