workspace-tools 0.32.0 → 0.34.0

package/lib/workspaces/getWorkspacePackageInfo.d.ts

@@ -1,3 +1,23 @@
 import { WorkspaceInfo } from "../types/WorkspaceInfo";
-export declare function getWorkspacePackageInfo(workspacePaths: string[]): WorkspaceInfo;
-export declare function getWorkspacePackageInfoAsync(workspacePaths: string[]): Promise<WorkspaceInfo>;
+/**
+ * Get an array with names, paths, and package.json contents for each of the given package paths
+ * within a workspace.
+ *
+ * This is an internal helper used by `getWorkspaces` implementations for different managers.
+ * (See `../getWorkspaces` for why it's named this way.)
+ * @param packagePaths Paths to packages within a workspace
+ * @returns Array of workspace package infos
+ * @internal
+ */
+export declare function getWorkspacePackageInfo(packagePaths: string[]): WorkspaceInfo;
+/**
+ * Get an array with names, paths, and package.json contents for each of the given package paths
+ * within a workspace.
+ *
+ * This is an internal helper used by `getWorkspaces` implementations for different managers.
+ * (See `../getWorkspaces` for why it's named this way.)
+ * @param packagePaths Paths to packages within a workspace
+ * @returns Array of workspace package infos
+ * @internal
+ */
+export declare function getWorkspacePackageInfoAsync(packagePaths: string[]): Promise<WorkspaceInfo>;

package/lib/workspaces/getWorkspacePackageInfo.js

@@ -6,56 +6,73 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspacePackageInfoAsync = exports.getWorkspacePackageInfo = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
-function getWorkspacePackageInfo(workspacePaths) {
-    if (!workspacePaths) {
+const promises_1 = __importDefault(require("fs/promises"));
+const logging_1 = require("../logging");
+const infoFromPackageJson_1 = require("../infoFromPackageJson");
+/**
+ * Get an array with names, paths, and package.json contents for each of the given package paths
+ * within a workspace.
+ *
+ * This is an internal helper used by `getWorkspaces` implementations for different managers.
+ * (See `../getWorkspaces` for why it's named this way.)
+ * @param packagePaths Paths to packages within a workspace
+ * @returns Array of workspace package infos
+ * @internal
+ */
+function getWorkspacePackageInfo(packagePaths) {
+    if (!packagePaths) {
         return [];
     }
-    return workspacePaths.reduce((returnValue, workspacePath) => {
+    return packagePaths
+        .map((workspacePath) => {
         let packageJson;
         const packageJsonPath = path_1.default.join(workspacePath, "package.json");
         try {
             packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, "utf-8"));
         }
-        catch {
-            return returnValue;
+        catch (err) {
+            (0, logging_1.logVerboseWarning)(`Error reading or parsing ${packageJsonPath} while getting workspace package info`, err);
+            return null;
         }
-        return [
-            ...returnValue,
-            {
-                name: packageJson.name,
-                path: workspacePath,
-                packageJson: {
-                    ...packageJson,
-                    packageJsonPath,
-                },
-            },
-        ];
-    }, []);
+        return {
+            name: packageJson.name,
+            path: workspacePath,
+            packageJson: (0, infoFromPackageJson_1.infoFromPackageJson)(packageJson, packageJsonPath),
+        };
+    })
+        .filter(Boolean);
 }
 exports.getWorkspacePackageInfo = getWorkspacePackageInfo;
-async function getWorkspacePackageInfoAsync(workspacePaths) {
-    if (!workspacePaths) {
+/**
+ * Get an array with names, paths, and package.json contents for each of the given package paths
+ * within a workspace.
+ *
+ * This is an internal helper used by `getWorkspaces` implementations for different managers.
+ * (See `../getWorkspaces` for why it's named this way.)
+ * @param packagePaths Paths to packages within a workspace
+ * @returns Array of workspace package infos
+ * @internal
+ */
+async function getWorkspacePackageInfoAsync(packagePaths) {
+    if (!packagePaths) {
         return [];
     }
-    const packageInfoPromises = workspacePaths.map(async (workspacePath) => {
-        let packageJson;
+    const workspacePkgPromises = packagePaths.map(async (workspacePath) => {
         const packageJsonPath = path_1.default.join(workspacePath, "package.json");
         try {
-            packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, "utf-8"));
+            const packageJson = JSON.parse(await promises_1.default.readFile(packageJsonPath, "utf-8"));
             return {
                 name: packageJson.name,
                 path: workspacePath,
-                packageJson: {
-                    ...packageJson,
-                    packageJsonPath,
-                },
+                packageJson: (0, infoFromPackageJson_1.infoFromPackageJson)(packageJson, packageJsonPath),
             };
         }
-        catch {
+        catch (err) {
+            (0, logging_1.logVerboseWarning)(`Error reading or parsing ${packageJsonPath} while getting workspace package info`, err);
             return null;
         }
     });
-    return (await Promise.all(packageInfoPromises)).flat().filter(Boolean);
+    return (await Promise.all(workspacePkgPromises)).filter(Boolean);
 }
 exports.getWorkspacePackageInfoAsync = getWorkspacePackageInfoAsync;
 //# sourceMappingURL=getWorkspacePackageInfo.js.map

package/lib/workspaces/getWorkspacePackageInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkspacePackageInfo.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspacePackageInfo.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AAIpB,SAAgB,uBAAuB,CAAC,cAAwB;IAC9D,IAAI,CAAC,cAAc,EAAE;QACnB,OAAO,EAAE,CAAC;KACX;IAED,OAAO,cAAc,CAAC,MAAM,CAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE;QACzE,IAAI,WAAwB,CAAC;QAC7B,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEjE,IAAI;YACF,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAgB,CAAC;SACpF;QAAC,MAAM;YACN,OAAO,WAAW,CAAC;SACpB;QAED,OAAO;YACL,GAAG,WAAW;YACd;gBACE,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE;oBACX,GAAG,WAAW;oBACd,eAAe;iBAChB;aACF;SACF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AA3BD,0DA2BC;AAEM,KAAK,UAAU,4BAA4B,CAAC,cAAwB;IACzE,IAAI,CAAC,cAAc,EAAE;QACnB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,mBAAmB,GACvB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE;QACzC,IAAI,WAAwB,CAAC;QAC7B,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEjE,IAAI;YACF,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAgB,CAAC;YACnF,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE;oBACX,GAAG,WAAW;oBACd,eAAe;iBAChB;aACF,CAAC;SACH;QAAC,MAAM;YACN,OAAO,IAAI,CAAC;SACb;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAkB,CAAC;AAC1F,CAAC;AA1BD,oEA0BC"}
+{"version":3,"file":"getWorkspacePackageInfo.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspacePackageInfo.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AACpB,2DAAqC;AAGrC,wCAA+C;AAC/C,gEAA6D;AAE7D;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,YAAsB;IAC5D,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,OAAO,YAAY;SAChB,GAAG,CAA+B,CAAC,aAAa,EAAE,EAAE;QACnD,IAAI,WAAwB,CAAC;QAC7B,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAEjE,IAAI;YACF,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAgB,CAAC;SACpF;QAAC,OAAO,GAAG,EAAE;YACZ,IAAA,2BAAiB,EAAC,4BAA4B,eAAe,uCAAuC,EAAE,GAAG,CAAC,CAAC;YAC3G,OAAO,IAAI,CAAC;SACb;QAED,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,IAAA,yCAAmB,EAAC,WAAW,EAAE,eAAe,CAAC;SAC/D,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAkB,CAAC;AACtC,CAAC;AAxBD,0DAwBC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,4BAA4B,CAAC,YAAsB;IACvE,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAwC,KAAK,EAAE,aAAa,EAAE,EAAE;QAC3G,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,CAAkB,CAAC;AACpF,CAAC;AAtBD,oEAsBC"}

package/lib/workspaces/getWorkspacePackagePaths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get a list of package folder paths in the workspace. 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
+ * 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

@@ -0,0 +1,31 @@
+"use strict";
+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
+ * the manager's config file and matching package folders (which must contain package.json) on disk.
+ */
+function getWorkspacePackagePaths(cwd) {
+    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
+    return (utils === null || utils === void 0 ? void 0 : utils.getWorkspacePackagePaths(cwd)) || [];
+}
+exports.getWorkspacePackagePaths = getWorkspacePackagePaths;
+/**
+ * Get a list of package folder paths in the workspace. 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) {
+    var _a;
+    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
+    if (!utils) {
+        return [];
+    }
+    if (!utils.getWorkspacePackagePathsAsync) {
+        const managerName = (_a = (0, implementations_1.getWorkspaceManagerAndRoot)(cwd)) === null || _a === void 0 ? void 0 : _a.manager;
+        throw new Error(`${cwd} is using ${managerName} which has not been converted to async yet`);
+    }
+    return utils.getWorkspacePackagePathsAsync(cwd);
+}
+exports.getWorkspacePackagePathsAsync = getWorkspacePackagePathsAsync;
+//# sourceMappingURL=getWorkspacePackagePaths.js.map

package/lib/workspaces/getWorkspacePackagePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkspacePackagePaths.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspacePackagePaths.ts"],"names":[],"mappings":";;;AAAA,uDAAsF;AAEtF;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,GAAW;IAClD,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IACzC,OAAO,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,wBAAwB,CAAC,GAAG,CAAC,KAAI,EAAE,CAAC;AACpD,CAAC;AAHD,4DAGC;AAED;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CAAC,GAAW;;IAC7D,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAK,EAAE;QACV,OAAO,EAAE,CAAC;KACX;IAED,IAAI,CAAC,KAAK,CAAC,6BAA6B,EAAE;QACxC,MAAM,WAAW,GAAG,MAAA,IAAA,4CAA0B,EAAC,GAAG,CAAC,0CAAE,OAAO,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,aAAa,WAAW,4CAA4C,CAAC,CAAC;KAC7F;IAED,OAAO,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAbD,sEAaC"}

package/lib/workspaces/getWorkspaceRoot.d.ts

@@ -1 +1,8 @@
-export declare function getWorkspaceRoot(cwd: string): string | undefined;
+import { WorkspaceManager } from "./WorkspaceManager";
+/**
+ * Get the root directory of a workspace/monorepo, defined as the directory where the workspace
+ * manager config file is located.
+ * @param cwd Start searching from here
+ * @param preferredManager Search for only this manager's config file
+ */
+export declare function getWorkspaceRoot(cwd: string, preferredManager?: WorkspaceManager): string | undefined;

package/lib/workspaces/getWorkspaceRoot.js

@@ -2,24 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspaceRoot = void 0;
 const implementations_1 = require("./implementations");
-const preferred = process.env.PREFERRED_WORKSPACE_MANAGER;
-function getWorkspaceRoot(cwd) {
-    const workspaceImplementation = preferred || (0, implementations_1.getWorkspaceImplementation)(cwd);
-    if (!workspaceImplementation) {
-        return;
-    }
-    switch (workspaceImplementation) {
-        case "yarn":
-            return require(`./implementations/yarn`).getYarnWorkspaceRoot(cwd);
-        case "pnpm":
-            return require(`./implementations/pnpm`).getPnpmWorkspaceRoot(cwd);
-        case "rush":
-            return require(`./implementations/rush`).getRushWorkspaceRoot(cwd);
-        case "npm":
-            return require(`./implementations/npm`).getNpmWorkspaceRoot(cwd);
-        case "lerna":
-            return require(`./implementations/lerna`).getLernaWorkspaceRoot(cwd);
-    }
+/**
+ * Get the root directory of a workspace/monorepo, defined as the directory where the workspace
+ * manager config file is located.
+ * @param cwd Start searching from here
+ * @param preferredManager Search for only this manager's config file
+ */
+function getWorkspaceRoot(cwd, preferredManager) {
+    var _a;
+    return (_a = (0, implementations_1.getWorkspaceManagerAndRoot)(cwd, undefined, preferredManager)) === null || _a === void 0 ? void 0 : _a.root;
 }
 exports.getWorkspaceRoot = getWorkspaceRoot;
 //# sourceMappingURL=getWorkspaceRoot.js.map

package/lib/workspaces/getWorkspaceRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkspaceRoot.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaceRoot.ts"],"names":[],"mappings":";;;AAAA,uDAA+D;AAI/D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,2BAAsD,CAAC;AAErF,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,uBAAuB,GAAG,SAAS,IAAI,IAAA,4CAA0B,EAAC,GAAG,CAAC,CAAC;IAE7E,IAAI,CAAC,uBAAuB,EAAE;QAC5B,OAAO;KACR;IAED,QAAQ,uBAAuB,EAAE;QAC/B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAErE,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAErE,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAErE,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,uBAAuB,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAEnE,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,yBAAyB,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;KACxE;AACH,CAAC;AAvBD,4CAuBC"}
+{"version":3,"file":"getWorkspaceRoot.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaceRoot.ts"],"names":[],"mappings":";;;AACA,uDAA+D;AAE/D;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,GAAW,EAAE,gBAAmC;;IAC/E,OAAO,MAAA,IAAA,4CAA0B,EAAC,GAAG,EAAE,SAAS,EAAE,gBAAgB,CAAC,0CAAE,IAAI,CAAC;AAC5E,CAAC;AAFD,4CAEC"}

package/lib/workspaces/getWorkspaces.d.ts

@@ -1,3 +1,19 @@
 import { WorkspaceInfo } from "../types/WorkspaceInfo";
+/**
+ * Get an array with names, paths, and package.json contents for each package in a workspace.
+ * The list of included packages is based on the workspace manager's config file.
+ *
+ * The method name is somewhat misleading due to the double meaning of "workspace", but it's retained
+ * for compatibility. "Workspace" here refers to an individual package, in the sense of the `workspaces`
+ * package.json config used by npm/yarn (instead of referring to the entire monorepo).
+ */
 export declare function getWorkspaces(cwd: string): WorkspaceInfo;
+/**
+ * Get an array with names, paths, and package.json contents for each package in a workspace.
+ * The list of included packages is based on the workspace manager's config file.
+ *
+ * The method name is somewhat misleading due to the double meaning of "workspace", but it's retained
+ * for compatibility. "Workspace" here refers to an individual package, in the sense of the `workspaces`
+ * package.json config used by npm/yarn (instead of referring to the entire monorepo).
+ */
 export declare function getWorkspacesAsync(cwd: string): Promise<WorkspaceInfo>;

package/lib/workspaces/getWorkspaces.js

@@ -2,41 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspacesAsync = exports.getWorkspaces = void 0;
 const implementations_1 = require("./implementations");
-const preferred = process.env.PREFERRED_WORKSPACE_MANAGER;
+/**
+ * Get an array with names, paths, and package.json contents for each package in a workspace.
+ * The list of included packages is based on the workspace manager's config file.
+ *
+ * The method name is somewhat misleading due to the double meaning of "workspace", but it's retained
+ * for compatibility. "Workspace" here refers to an individual package, in the sense of the `workspaces`
+ * package.json config used by npm/yarn (instead of referring to the entire monorepo).
+ */
 function getWorkspaces(cwd) {
-    const workspaceImplementation = preferred || (0, implementations_1.getWorkspaceImplementation)(cwd);
-    if (!workspaceImplementation) {
-        return [];
-    }
-    switch (workspaceImplementation) {
-        case "yarn":
-            return require(`./implementations/yarn`).getYarnWorkspaces(cwd);
-        case "pnpm":
-            return require(`./implementations/pnpm`).getPnpmWorkspaces(cwd);
-        case "rush":
-            return require(`./implementations/rush`).getRushWorkspaces(cwd);
-        case "npm":
-            return require(`./implementations/npm`).getNpmWorkspaces(cwd);
-        case "lerna":
-            return require(`./implementations/lerna`).getLernaWorkspaces(cwd);
-    }
+    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
+    return (utils === null || utils === void 0 ? void 0 : utils.getWorkspaces(cwd)) || [];
 }
 exports.getWorkspaces = getWorkspaces;
+/**
+ * Get an array with names, paths, and package.json contents for each package in a workspace.
+ * The list of included packages is based on the workspace manager's config file.
+ *
+ * The method name is somewhat misleading due to the double meaning of "workspace", but it's retained
+ * for compatibility. "Workspace" here refers to an individual package, in the sense of the `workspaces`
+ * package.json config used by npm/yarn (instead of referring to the entire monorepo).
+ */
 async function getWorkspacesAsync(cwd) {
-    const workspaceImplementation = preferred || (0, implementations_1.getWorkspaceImplementation)(cwd);
-    if (!workspaceImplementation) {
+    var _a;
+    const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
+    if (!utils) {
         return [];
     }
-    switch (workspaceImplementation) {
-        case "yarn":
-            return await require(`./implementations/yarn`).getYarnWorkspacesAsync(cwd);
-        case "npm":
-            return require(`./implementations/npm`).getNpmWorkspacesAsync(cwd);
-        case "pnpm":
-        case "rush":
-        case "lerna":
-            throw new Error(`${cwd} is using ${workspaceImplementation} which has not been converted to async yet`);
+    if (!utils.getWorkspacesAsync) {
+        const managerName = (_a = (0, implementations_1.getWorkspaceManagerAndRoot)(cwd)) === null || _a === void 0 ? void 0 : _a.manager;
+        throw new Error(`${cwd} is using ${managerName} which has not been converted to async yet`);
     }
+    return utils.getWorkspacesAsync(cwd);
 }
 exports.getWorkspacesAsync = getWorkspacesAsync;
 //# sourceMappingURL=getWorkspaces.js.map

package/lib/workspaces/getWorkspaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkspaces.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaces.ts"],"names":[],"mappings":";;;AAAA,uDAA+D;AAK/D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,2BAAsD,CAAC;AAErF,SAAgB,aAAa,CAAC,GAAW;IACvC,MAAM,uBAAuB,GAAG,SAAS,IAAI,IAAA,4CAA0B,EAAC,GAAG,CAAC,CAAC;IAE7E,IAAI,CAAC,uBAAuB,EAAE;QAC5B,OAAO,EAAE,CAAC;KACX;IAED,QAAQ,uBAAuB,EAAE;QAC/B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAElE,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAElE,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAElE,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,uBAAuB,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEhE,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,yBAAyB,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;KACrE;AACH,CAAC;AAvBD,sCAuBC;AAEM,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,uBAAuB,GAAG,SAAS,IAAI,IAAA,4CAA0B,EAAC,GAAG,CAAC,CAAC;IAE7E,IAAI,CAAC,uBAAuB,EAAE;QAC5B,OAAO,EAAE,CAAC;KACX;IAED,QAAQ,uBAAuB,EAAE;QAC/B,KAAK,MAAM;YACT,OAAO,MAAM,OAAO,CAAC,wBAAwB,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAE7E,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,uBAAuB,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAErE,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,aAAa,uBAAuB,4CAA4C,CAAC,CAAC;KAC3G;AACH,CAAC;AAnBD,gDAmBC"}
+{"version":3,"file":"getWorkspaces.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaces.ts"],"names":[],"mappings":";;;AAAA,uDAAsF;AAGtF;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IACzC,OAAO,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,aAAa,CAAC,GAAG,CAAC,KAAI,EAAE,CAAC;AACzC,CAAC;AAHD,sCAGC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CAAC,GAAW;;IAClD,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAK,EAAE;QACV,OAAO,EAAE,CAAC;KACX;IAED,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE;QAC7B,MAAM,WAAW,GAAG,MAAA,IAAA,4CAA0B,EAAC,GAAG,CAAC,0CAAE,OAAO,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,aAAa,WAAW,4CAA4C,CAAC,CAAC;KAC7F;IAED,OAAO,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAbD,gDAaC"}

package/lib/workspaces/implementations/getWorkspaceManagerAndRoot.d.ts

@@ -0,0 +1,22 @@
+import { WorkspaceManager } from "../WorkspaceManager";
+export interface WorkspaceManagerAndRoot {
+    /** Workspace manager name */
+    manager: WorkspaceManager;
+    /** Workspace root, where the manager configuration file is located */
+    root: string;
+}
+/**
+ * Get the preferred workspace manager based on `process.env.PREFERRED_WORKSPACE_MANAGER`
+ * (if valid).
+ */
+export declare function getPreferredWorkspaceManager(): WorkspaceManager | undefined;
+/**
+ * Get the workspace manager name and workspace root directory for `cwd`, with caching.
+ * Also respects the `process.env.PREFERRED_WORKSPACE_MANAGER` override, provided the relevant
+ * manager file exists.
+ * @param cwd Directory to search up from
+ * @param cache Optional override cache for testing
+ * @param preferredManager Optional override manager (if provided, only searches for this manager's file)
+ * @returns Workspace manager and root, or undefined if it can't be determined
+ */
+export declare function getWorkspaceManagerAndRoot(cwd: string, cache?: Map<string, WorkspaceManagerAndRoot | undefined>, preferredManager?: WorkspaceManager): WorkspaceManagerAndRoot | undefined;

package/lib/workspaces/implementations/getWorkspaceManagerAndRoot.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWorkspaceManagerAndRoot = exports.getPreferredWorkspaceManager = void 0;
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("../../paths");
+const workspaceCache = new Map();
+/**
+ * Files indicating the workspace root for each manager.
+ *
+ * DO NOT REORDER! The order of keys determines the precedence of the files, which is
+ * important for cases like lerna where lerna.json and e.g. yarn.lock may both exist.
+ */
+const managerFiles = {
+    // DO NOT REORDER! (see above)
+    lerna: "lerna.json",
+    rush: "rush.json",
+    yarn: "yarn.lock",
+    pnpm: "pnpm-workspace.yaml",
+    npm: "package-lock.json",
+};
+/**
+ * Get the preferred workspace manager based on `process.env.PREFERRED_WORKSPACE_MANAGER`
+ * (if valid).
+ */
+function getPreferredWorkspaceManager() {
+    const preferred = process.env.PREFERRED_WORKSPACE_MANAGER;
+    return preferred && managerFiles[preferred] ? preferred : undefined;
+}
+exports.getPreferredWorkspaceManager = getPreferredWorkspaceManager;
+/**
+ * Get the workspace manager name and workspace root directory for `cwd`, with caching.
+ * Also respects the `process.env.PREFERRED_WORKSPACE_MANAGER` override, provided the relevant
+ * manager file exists.
+ * @param cwd Directory to search up from
+ * @param cache Optional override cache for testing
+ * @param preferredManager Optional override manager (if provided, only searches for this manager's file)
+ * @returns Workspace manager and root, or undefined if it can't be determined
+ */
+function getWorkspaceManagerAndRoot(cwd, cache, preferredManager) {
+    cache = cache || workspaceCache;
+    if (cache.has(cwd)) {
+        return cache.get(cwd);
+    }
+    preferredManager = preferredManager || getPreferredWorkspaceManager();
+    const managerFile = (0, paths_1.searchUp)((preferredManager && managerFiles[preferredManager]) || Object.values(managerFiles), cwd);
+    if (managerFile) {
+        const managerFileName = path_1.default.basename(managerFile);
+        cache.set(cwd, {
+            manager: Object.keys(managerFiles).find((name) => managerFiles[name] === managerFileName),
+            root: path_1.default.dirname(managerFile),
+        });
+    }
+    else {
+        // Avoid searching again if no file was found
+        cache.set(cwd, undefined);
+    }
+    return cache.get(cwd);
+}
+exports.getWorkspaceManagerAndRoot = getWorkspaceManagerAndRoot;
+//# sourceMappingURL=getWorkspaceManagerAndRoot.js.map

package/lib/workspaces/implementations/getWorkspaceManagerAndRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkspaceManagerAndRoot.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/getWorkspaceManagerAndRoot.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,uCAAuC;AASvC,MAAM,cAAc,GAAG,IAAI,GAAG,EAA+C,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,YAAY,GAAG;IACnB,8BAA8B;IAC9B,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,qBAAqB;IAC3B,GAAG,EAAE,mBAAmB;CACzB,CAAC;AAEF;;;GAGG;AACH,SAAgB,4BAA4B;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2D,CAAC;IAC1F,OAAO,SAAS,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAHD,oEAGC;AAED;;;;;;;;GAQG;AACH,SAAgB,0BAA0B,CACxC,GAAW,EACX,KAAwD,EACxD,gBAAmC;IAEnC,KAAK,GAAG,KAAK,IAAI,cAAc,CAAC;IAChC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAClB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KACvB;IAED,gBAAgB,GAAG,gBAAgB,IAAI,4BAA4B,EAAE,CAAC;IACtE,MAAM,WAAW,GAAG,IAAA,gBAAQ,EAC1B,CAAC,gBAAgB,IAAI,YAAY,CAAC,gBAAgB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EACnF,GAAG,CACJ,CAAC;IAEF,IAAI,WAAW,EAAE;QACf,MAAM,eAAe,GAAG,cAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACnD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YACb,OAAO,EAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAwB,CAAC,IAAI,CAC7D,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,eAAe,CAChD;YACF,IAAI,EAAE,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC;SAChC,CAAC,CAAC;KACJ;SAAM;QACL,6CAA6C;QAC7C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;KAC3B;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AA9BD,gEA8BC"}

package/lib/workspaces/implementations/getWorkspaceUtilities.d.ts

@@ -0,0 +1,26 @@
+import { WorkspaceInfo } from "../../types/WorkspaceInfo";
+export interface WorkspaceUtilities {
+    /**
+     * Get an array of paths to packages in the workspace, based on the manager's config file.
+     */
+    getWorkspacePackagePaths: (cwd: string) => string[];
+    /**
+     * Get an array of paths to packages in the workspace, based on the manager's config file.
+     */
+    getWorkspacePackagePathsAsync?: (cwd: string) => Promise<string[]>;
+    /**
+     * Get an array with names, paths, and package.json contents for each package in a workspace.
+     * (See `../getWorkspaces` for why it's named this way.)
+     */
+    getWorkspaces: (cwd: string) => WorkspaceInfo;
+    /**
+     * Get an array with names, paths, and package.json contents for each package in a workspace.
+     * (See `../getWorkspaces` for why it's named this way.)
+     */
+    getWorkspacesAsync?: (cwd: string) => Promise<WorkspaceInfo>;
+}
+/**
+ * Get utility implementations for the workspace manager of `cwd`.
+ * Returns undefined if the manager can't be determined.
+ */
+export declare function getWorkspaceUtilities(cwd: string): WorkspaceUtilities | undefined;

package/lib/workspaces/implementations/getWorkspaceUtilities.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWorkspaceUtilities = void 0;
+const getWorkspaceManagerAndRoot_1 = require("./getWorkspaceManagerAndRoot");
+/**
+ * Get utility implementations for the workspace manager of `cwd`.
+ * Returns undefined if the manager can't be determined.
+ */
+function getWorkspaceUtilities(cwd) {
+    var _a;
+    const manager = (_a = (0, getWorkspaceManagerAndRoot_1.getWorkspaceManagerAndRoot)(cwd)) === null || _a === void 0 ? void 0 : _a.manager;
+    switch (manager) {
+        case "yarn":
+            return require("./yarn");
+        case "pnpm":
+            return require("./pnpm");
+        case "rush":
+            return require("./rush");
+        case "npm":
+            return require("./npm");
+        case "lerna":
+            return require("./lerna");
+    }
+}
+exports.getWorkspaceUtilities = getWorkspaceUtilities;
+//# sourceMappingURL=getWorkspaceUtilities.js.map

package/lib/workspaces/implementations/getWorkspaceUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkspaceUtilities.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/getWorkspaceUtilities.ts"],"names":[],"mappings":";;;AACA,6EAA0E;AA6B1E;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAW;;IAC/C,MAAM,OAAO,GAAG,MAAA,IAAA,uDAA0B,EAAC,GAAG,CAAC,0CAAE,OAAO,CAAC;IAEzD,QAAQ,OAAO,EAAE;QACf,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,QAAQ,CAAyB,CAAC;QAEnD,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,QAAQ,CAAyB,CAAC;QAEnD,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,QAAQ,CAAyB,CAAC;QAEnD,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,OAAO,CAAwB,CAAC;QAEjD,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,SAAS,CAA0B,CAAC;KACtD;AACH,CAAC;AAnBD,sDAmBC"}

package/lib/workspaces/implementations/index.d.ts

@@ -1,14 +1,2 @@
-export declare type WorkspaceImplementations = "yarn" | "pnpm" | "rush" | "npm" | "lerna";
-export interface ImplementationAndLockFile {
-    implementation: WorkspaceImplementations | undefined;
-    lockFile: string;
-}
-export declare function getWorkspaceImplementationAndLockFile(cwd: string, cache?: {
-    [cwd: string]: ImplementationAndLockFile;
-}): {
-    implementation: WorkspaceImplementations | undefined;
-    lockFile: string;
-} | undefined;
-export declare function getWorkspaceImplementation(cwd: string, cache?: {
-    [cwd: string]: ImplementationAndLockFile;
-}): WorkspaceImplementations | undefined;
+export { getWorkspaceManagerAndRoot, WorkspaceManagerAndRoot } from "./getWorkspaceManagerAndRoot";
+export { getWorkspaceUtilities, WorkspaceUtilities } from "./getWorkspaceUtilities";

package/lib/workspaces/implementations/index.js

@@ -1,58 +1,8 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorkspaceImplementation = exports.getWorkspaceImplementationAndLockFile = void 0;
-const path_1 = __importDefault(require("path"));
-const paths_1 = require("../../paths");
-const workspaceCache = {};
-function getWorkspaceImplementationAndLockFile(cwd, cache = workspaceCache) {
-    if (cache[cwd]) {
-        return cache[cwd];
-    }
-    const lockFile = (0, paths_1.searchUp)(["lerna.json", "rush.json", "yarn.lock", "pnpm-workspace.yaml", "package-lock.json"], cwd);
-    if (!lockFile) {
-        return;
-    }
-    switch (path_1.default.basename(lockFile)) {
-        case "lerna.json":
-            cache[cwd] = {
-                implementation: "lerna",
-                lockFile,
-            };
-            break;
-        case "yarn.lock":
-            cache[cwd] = {
-                implementation: "yarn",
-                lockFile,
-            };
-            break;
-        case "pnpm-workspace.yaml":
-            cache[cwd] = {
-                implementation: "pnpm",
-                lockFile,
-            };
-            break;
-        case "rush.json":
-            cache[cwd] = {
-                implementation: "rush",
-                lockFile,
-            };
-            break;
-        case "package-lock.json":
-            cache[cwd] = {
-                implementation: "npm",
-                lockFile,
-            };
-            break;
-    }
-    return cache[cwd];
-}
-exports.getWorkspaceImplementationAndLockFile = getWorkspaceImplementationAndLockFile;
-function getWorkspaceImplementation(cwd, cache = workspaceCache) {
-    var _a;
-    return (_a = getWorkspaceImplementationAndLockFile(cwd, cache)) === null || _a === void 0 ? void 0 : _a.implementation;
-}
-exports.getWorkspaceImplementation = getWorkspaceImplementation;
+exports.getWorkspaceUtilities = exports.getWorkspaceManagerAndRoot = void 0;
+var getWorkspaceManagerAndRoot_1 = require("./getWorkspaceManagerAndRoot");
+Object.defineProperty(exports, "getWorkspaceManagerAndRoot", { enumerable: true, get: function () { return getWorkspaceManagerAndRoot_1.getWorkspaceManagerAndRoot; } });
+var getWorkspaceUtilities_1 = require("./getWorkspaceUtilities");
+Object.defineProperty(exports, "getWorkspaceUtilities", { enumerable: true, get: function () { return getWorkspaceUtilities_1.getWorkspaceUtilities; } });
 //# sourceMappingURL=index.js.map

package/lib/workspaces/implementations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/index.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,uCAAuC;AAOvC,MAAM,cAAc,GAAiD,EAAE,CAAC;AAExE,SAAgB,qCAAqC,CACnD,GAAW,EACX,KAAK,GAAG,cAAc;IAEtB,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE;QACd,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;KACnB;IAED,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAC,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,EAAE,GAAG,CAAC,CAAC;IAErH,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO;KACR;IAED,QAAQ,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC/B,KAAK,YAAY;YACf,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,cAAc,EAAE,OAAO;gBACvB,QAAQ;aACT,CAAC;YACF,MAAM;QAER,KAAK,WAAW;YACd,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,cAAc,EAAE,MAAM;gBACtB,QAAQ;aACT,CAAC;YACF,MAAM;QAER,KAAK,qBAAqB;YACxB,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,cAAc,EAAE,MAAM;gBACtB,QAAQ;aACT,CAAC;YACF,MAAM;QAER,KAAK,WAAW;YACd,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,cAAc,EAAE,MAAM;gBACtB,QAAQ;aACT,CAAC;YACF,MAAM;QAER,KAAK,mBAAmB;YACtB,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,cAAc,EAAE,KAAK;gBACrB,QAAQ;aACT,CAAC;YACF,MAAM;KACT;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AApDD,sFAoDC;AAED,SAAgB,0BAA0B,CAAC,GAAW,EAAE,KAAK,GAAG,cAAc;;IAC5E,OAAO,MAAA,qCAAqC,CAAC,GAAG,EAAE,KAAK,CAAC,0CAAE,cAAc,CAAC;AAC3E,CAAC;AAFD,gEAEC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/index.ts"],"names":[],"mappings":";;;AAAA,2EAAmG;AAA1F,wIAAA,0BAA0B,OAAA;AACnC,iEAAoF;AAA3E,8HAAA,qBAAqB,OAAA"}

package/lib/workspaces/implementations/lerna.d.ts

@@ -1,3 +1,9 @@
 import { WorkspaceInfo } from "../../types/WorkspaceInfo";
-export declare function getLernaWorkspaceRoot(cwd: string): string;
-export declare function getLernaWorkspaces(cwd: string, ignorePatterns?: string[]): WorkspaceInfo;
+/** Get package paths for a lerna workspace. */
+export declare function getWorkspacePackagePaths(cwd: string): string[];
+/**
+ * Get an array with names, paths, and package.json contents for each package in a lerna workspace.
+ * (See `../getWorkspaces` for why it's named this way.)
+ */
+export declare function getLernaWorkspaces(cwd: string): WorkspaceInfo;
+export { getLernaWorkspaces as getWorkspaces };