workspace-tools 0.38.4 → 0.38.6

package/lib/paths.d.ts

@@ -18,4 +18,7 @@ export declare function findPackageRoot(cwd: string): string | undefined;
  * falling back to the git root if no workspace is detected.
  */
 export declare function findProjectRoot(cwd: string): string;
+/**
+ * Determines if `child` path is a subdirectory of `parent` path.
+ */
 export declare function isChildOf(child: string, parent: string): boolean;

package/lib/paths.js

@@ -57,7 +57,7 @@ exports.findPackageRoot = findPackageRoot;
 function findProjectRoot(cwd) {
     let workspaceRoot;
     try {
-        workspaceRoot = (0, getWorkspaceRoot_1.getWorkspaceRoot)(cwd);
+        workspaceRoot = (0, getWorkspaceRoot_1.getWorkspaceManagerRoot)(cwd);
     }
     catch (err) {
         (0, logging_1.logVerboseWarning)(`Error getting workspace root for ${cwd}`, err);
@@ -68,6 +68,9 @@ function findProjectRoot(cwd) {
     return workspaceRoot || findGitRoot(cwd);
 }
 exports.findProjectRoot = findProjectRoot;
+/**
+ * Determines if `child` path is a subdirectory of `parent` path.
+ */
 function isChildOf(child, parent) {
     const relativePath = path_1.default.relative(child, parent);
     return /^[.\/\\]+$/.test(relativePath);

package/lib/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AACpB,oEAAiE;AACjE,+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,mCAAgB,EAAC,GAAG,CAAC,CAAC;KACvC;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,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;;;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"}

package/lib/tsdoc-metadata.json

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

package/lib/types/Catalogs.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Mapping from package name to package version.
+ * @see https://pnpm.io/catalogs#default-catalog
+ * @see https://yarnpkg.com/features/catalogs#basic-usage
+ */
+export interface Catalog {
+    [packageName: string]: string;
+}
+/**
+ * Mapping from catalog name (non-default) to catalog definition
+ * @see https://pnpm.io/catalogs#named-catalogs
+ * @see https://yarnpkg.com/features/catalogs#named-catalogs
+ */
+export interface NamedCatalogs {
+    [catalogName: string]: Catalog;
+}
+/**
+ * Package version catalogs
+ * @see https://pnpm.io/catalogs
+ * @see https://yarnpkg.com/features/catalogs
+ */
+export interface Catalogs {
+    /**
+     * The default catalog if present.
+     * (This can't be combined with the named catalogs because "default" could be a catalog name.)
+     */
+    default?: Catalog;
+    /** Mapping from catalog name to catalog definition, if present */
+    named?: NamedCatalogs;
+}

package/lib/types/Catalogs.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Catalogs.js.map

package/lib/types/Catalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalogs.js","sourceRoot":"","sources":["../../src/types/Catalogs.ts"],"names":[],"mappings":""}

package/lib/types/PackageInfo.d.ts

@@ -1,6 +1,9 @@
+import type { Catalog, NamedCatalogs } from "./Catalogs";
+/** Contents of `package.json`, plus the `packageJsonPath` */
 export interface PackageInfo {
-    name: string;
+    /** Absolute path to this package.json file */
     packageJsonPath: string;
+    name: string;
     version: string;
     dependencies?: {
         [dep: string]: string;
@@ -25,7 +28,22 @@ export interface PackageInfo {
         directory?: string;
     };
     [key: string]: any;
+    /**
+     * Workspace info, only in the root package.json for certain managers.
+     * If an array of strings, it's a list of workspace package patterns.
+     */
+    workspaces?: string[] | {
+        /** List of workspace package patterns */
+        packages: string[];
+        nohoist?: string[];
+        /** `midgard-yarn-strict` catalog definition (yarn4/pnpm use yaml config) */
+        catalog?: Catalog;
+        /** `midgard-yarn-strict` named catalog definition (yarn4/pnpm use yaml config) */
+        catalogs?: NamedCatalogs;
+        [key: string]: any;
+    };
 }
+/** Mapping from package name to info (`package.json`) for packages within a monorepo. */
 export interface PackageInfos {
     [pkgName: string]: PackageInfo;
 }

package/lib/types/WorkspaceInfo.d.ts

@@ -1,13 +1,22 @@
 import { PackageInfo } from "./PackageInfo";
 /**
- * Array with names, paths, and package.json contents for each package in a workspace.
+ * Info about a single package ("workspace" in npm/yarn/pnpm terms) within a monorepo.
  *
- * 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).
+ * Ideally this should be called just `WorkspaceInfo`, but that name was previously used for the
+ * aggregate type.
  */
-export type WorkspaceInfo = {
+export interface WorkspacePackageInfo {
+    /** Package name */
     name: string;
+    /** Absolute path to the package root */
     path: string;
+    /** `package.json` contents + path */
     packageJson: PackageInfo;
-}[];
+}
+/**
+ * Array with names, paths, and package.json contents for each package ("workspace" in
+ * npm/yarn/pnpm terms) within a monorepo.
+ */
+export type WorkspaceInfos = WorkspacePackageInfo[];
+/** @deprecated Use `WorkspaceInfos` */
+export type WorkspaceInfo = WorkspaceInfos;

package/lib/workspaces/catalogs.d.ts

@@ -0,0 +1,33 @@
+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:`.
+ */
+export declare function isCatalogVersion(version: string): boolean;
+/**
+ * Given a dependency package name and a version spec string, if the version starts with `catalog:`,
+ * look up the actual version spec (not the final resolved version) from the given catalogs.
+ *
+ * Throws an error if there's anything invalid about the catalog spec (no catalogs defined,
+ * no matching catalog, catalog doesn't contain `name`, recursive catalog version).
+ *
+ * Returns undefined if the version doesn't start with `catalog:`.
+ * @see https://pnpm.io/catalogs
+ * @see https://yarnpkg.com/features/catalogs
+ *
+ * @param name - Dependency package name
+ * @param version - Dependency version spec, e.g. `catalog:my-catalog` or `catalog:`,
+ * or some non-catalog spec like `^1.2.3`
+ * @returns Actual version spec from the catalog, or undefined if not a catalog version
+ */
+export declare function getCatalogVersion(params: {
+    name: string;
+    version: string;
+    catalogs: Catalogs | undefined;
+}): string | undefined;

package/lib/workspaces/catalogs.js

@@ -0,0 +1,66 @@
+"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;
+const catalogPrefix = "catalog:";
+/**
+ * Returns true if the version starts with `catalog:`.
+ */
+function isCatalogVersion(version) {
+    return version.startsWith(catalogPrefix);
+}
+exports.isCatalogVersion = isCatalogVersion;
+/**
+ * Given a dependency package name and a version spec string, if the version starts with `catalog:`,
+ * look up the actual version spec (not the final resolved version) from the given catalogs.
+ *
+ * Throws an error if there's anything invalid about the catalog spec (no catalogs defined,
+ * no matching catalog, catalog doesn't contain `name`, recursive catalog version).
+ *
+ * Returns undefined if the version doesn't start with `catalog:`.
+ * @see https://pnpm.io/catalogs
+ * @see https://yarnpkg.com/features/catalogs
+ *
+ * @param name - Dependency package name
+ * @param version - Dependency version spec, e.g. `catalog:my-catalog` or `catalog:`,
+ * or some non-catalog spec like `^1.2.3`
+ * @returns Actual version spec from the catalog, or undefined if not a catalog version
+ */
+function getCatalogVersion(params) {
+    const { name, version, catalogs } = params;
+    if (!isCatalogVersion(version)) {
+        return undefined;
+    }
+    if (!catalogs) {
+        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 catalogNameStr = catalogName ? `catalogs.${catalogName}` : "the default catalog";
+    if (!checkCatalog) {
+        throw new Error(`Dependency "${name}" uses a catalog version "${version}" but ${catalogNameStr} is not defined.`);
+    }
+    const actualSpec = checkCatalog[name];
+    if (!actualSpec) {
+        throw new Error(`Dependency "${name}" uses a catalog version "${version}", but ${catalogNameStr} doesn't define a version for "${name}".`);
+    }
+    if (isCatalogVersion(actualSpec)) {
+        throw new Error(`Dependency "${name}" resolves to a recursive catalog version "${actualSpec}", which is not supported.`);
+    }
+    return actualSpec;
+}
+exports.getCatalogVersion = getCatalogVersion;
+//# sourceMappingURL=catalogs.js.map

package/lib/workspaces/catalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../src/workspaces/catalogs.ts"],"names":[],"mappings":";;;AACA,uDAA0D;AAE1D;;;;;GAKG;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;AAED,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,0EAA0E;IAC1E,mCAAmC;IACnC,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACpF,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;AAvCD,8CAuCC"}

package/lib/workspaces/findWorkspacePath.d.ts

@@ -1,9 +1,9 @@
-import { WorkspaceInfo } from "../types/WorkspaceInfo";
+import type { WorkspaceInfos } from "../types/WorkspaceInfo";
 /**
- * Find the path for a particular package name from an array of info about packages within a workspace.
- * (See `../getWorkspaces` for why it's named this way.)
- * @param workspaces Array of info about packages within a workspace
+ * Find the path for a particular package name from an array of info about packages ("workspaces"
+ * in npm/yarn/pnpm terms) within a monorepo.
+ * @param workspaces Array of info about packages within a monorepo
  * @param packageName Package name to find
  * @returns Package path if found, or undefined
  */
-export declare function findWorkspacePath(workspaces: WorkspaceInfo, packageName: string): string | undefined;
+export declare function findWorkspacePath(workspaces: WorkspaceInfos, packageName: string): string | undefined;

package/lib/workspaces/findWorkspacePath.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findWorkspacePath = void 0;
 /**
- * Find the path for a particular package name from an array of info about packages within a workspace.
- * (See `../getWorkspaces` for why it's named this way.)
- * @param workspaces Array of info about packages within a workspace
+ * Find the path for a particular package name from an array of info about packages ("workspaces"
+ * in npm/yarn/pnpm terms) within a monorepo.
+ * @param workspaces Array of info about packages within a monorepo
  * @param packageName Package name to find
  * @returns Package path if found, or undefined
  */

package/lib/workspaces/findWorkspacePath.js.map

@@ -1 +1 @@
-{"version":3,"file":"findWorkspacePath.js","sourceRoot":"","sources":["../../src/workspaces/findWorkspacePath.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,UAAyB,EAAE,WAAmB;IAC9E,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,IAAI,CAAC;AACnE,CAAC;AAFD,8CAEC"}
+{"version":3,"file":"findWorkspacePath.js","sourceRoot":"","sources":["../../src/workspaces/findWorkspacePath.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,UAA0B,EAAE,WAAmB;IAC/E,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,IAAI,CAAC;AACnE,CAAC;AAFD,8CAEC"}

package/lib/workspaces/getWorkspacePackageInfo.d.ts

@@ -1,23 +1,26 @@
-import { WorkspaceInfo } from "../types/WorkspaceInfo";
+import type { WorkspaceInfos } from "../types/WorkspaceInfo";
 /**
  * Get an array with names, paths, and package.json contents for each of the given package paths
- * within a workspace.
+ * ("workspace" paths in npm/yarn/pnpm terms) within a monorepo.
  *
  * 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
+ *
+ * @param packagePaths Paths to packages within a monorepo
  * @returns Array of workspace package infos
  * @internal
  */
-export declare function getWorkspacePackageInfo(packagePaths: string[]): WorkspaceInfo;
+export declare function getWorkspacePackageInfo(packagePaths: string[]): WorkspaceInfos;
 /**
  * Get an array with names, paths, and package.json contents for each of the given package paths
- * within a workspace.
+ * ("workspace" paths in npm/yarn/pnpm terms) within a monorepo.
+ *
+ * NOTE: As of writing, this will start promises to read all package.json files in parallel,
+ * without direct concurrency control.
  *
  * 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
+ *
+ * @param packagePaths Paths to packages within a monorepo
  * @returns Array of workspace package infos
  * @internal
  */
-export declare function getWorkspacePackageInfoAsync(packagePaths: string[]): Promise<WorkspaceInfo>;
+export declare function getWorkspacePackageInfoAsync(packagePaths: string[]): Promise<WorkspaceInfos>;

package/lib/workspaces/getWorkspacePackageInfo.js

@@ -5,17 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspacePackageInfoAsync = exports.getWorkspacePackageInfo = void 0;
 const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
 const promises_1 = __importDefault(require("fs/promises"));
 const logging_1 = require("../logging");
 const infoFromPackageJson_1 = require("../infoFromPackageJson");
+const getPackageInfo_1 = require("../getPackageInfo");
 /**
  * Get an array with names, paths, and package.json contents for each of the given package paths
- * within a workspace.
+ * ("workspace" paths in npm/yarn/pnpm terms) within a monorepo.
  *
  * 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
+ *
+ * @param packagePaths Paths to packages within a monorepo
  * @returns Array of workspace package infos
  * @internal
  */
@@ -25,19 +25,14 @@ function getWorkspacePackageInfo(packagePaths) {
     }
     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 (err) {
-            (0, logging_1.logVerboseWarning)(`Error reading or parsing ${packageJsonPath} while getting workspace package info`, err);
-            return null;
+        const packageJson = (0, getPackageInfo_1.getPackageInfo)(workspacePath);
+        if (!packageJson) {
+            return null; // getPackageInfo already logged a warning
         }
         return {
             name: packageJson.name,
             path: workspacePath,
-            packageJson: (0, infoFromPackageJson_1.infoFromPackageJson)(packageJson, packageJsonPath),
+            packageJson,
         };
     })
         .filter(Boolean);
@@ -45,11 +40,14 @@ function getWorkspacePackageInfo(packagePaths) {
 exports.getWorkspacePackageInfo = getWorkspacePackageInfo;
 /**
  * Get an array with names, paths, and package.json contents for each of the given package paths
- * within a workspace.
+ * ("workspace" paths in npm/yarn/pnpm terms) within a monorepo.
+ *
+ * NOTE: As of writing, this will start promises to read all package.json files in parallel,
+ * without direct concurrency control.
  *
  * 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
+ *
+ * @param packagePaths Paths to packages within a monorepo
  * @returns Array of workspace package infos
  * @internal
  */

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;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"}
+{"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"}

package/lib/workspaces/getWorkspaceRoot.d.ts

@@ -1,8 +1,24 @@
 import { WorkspaceManager } from "./WorkspaceManager";
 /**
- * Get the root directory of a workspace/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 manager
+ * config file is located.
+ *
+ * NOTE: "Workspace" here refers to the entire project, not an individual package the way it does
+ * in e.g. npm/yarn/pnpm "workspaces."
+ *
  * @param cwd Start searching from here
  * @param preferredManager Search for only this manager's config file
+ *
+ * @deprecated Renamed to `getWorkspaceManagerRoot` to align "workspace" terminology with npm/yarn/pnpm.
+ * In most cases, you should use `findProjectRoot` instead since it falls back to the git root if no
+ * workspace manager is found (single-package projects).
  */
 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.
+ *
+ * @param cwd Start searching from here
+ * @param preferredManager Search for only this manager's config file
+ */
+export declare function getWorkspaceManagerRoot(cwd: string, preferredManager?: WorkspaceManager): string | undefined;

package/lib/workspaces/getWorkspaceRoot.js

@@ -1,15 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorkspaceRoot = void 0;
+exports.getWorkspaceManagerRoot = exports.getWorkspaceRoot = void 0;
 const implementations_1 = require("./implementations");
 /**
- * Get the root directory of a workspace/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 manager
+ * config file is located.
+ *
+ * NOTE: "Workspace" here refers to the entire project, not an individual package the way it does
+ * in e.g. npm/yarn/pnpm "workspaces."
+ *
  * @param cwd Start searching from here
  * @param preferredManager Search for only this manager's config file
+ *
+ * @deprecated Renamed to `getWorkspaceManagerRoot` to align "workspace" terminology with npm/yarn/pnpm.
+ * In most cases, you should use `findProjectRoot` instead since it falls back to the git root if no
+ * workspace manager is found (single-package projects).
  */
 function getWorkspaceRoot(cwd, preferredManager) {
-    return (0, implementations_1.getWorkspaceManagerAndRoot)(cwd, undefined, preferredManager)?.root;
+    return getWorkspaceManagerRoot(cwd, preferredManager);
 }
 exports.getWorkspaceRoot = getWorkspaceRoot;
+/**
+ * Get the root directory of a 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 getWorkspaceManagerRoot(cwd, preferredManager) {
+    return (0, implementations_1.getWorkspaceManagerAndRoot)(cwd, undefined, preferredManager)?.root;
+}
+exports.getWorkspaceManagerRoot = getWorkspaceManagerRoot;
 //# 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":";;;AACA,uDAA+D;AAE/D;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,GAAW,EAAE,gBAAmC;IAC/E,OAAO,IAAA,4CAA0B,EAAC,GAAG,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC;AAC5E,CAAC;AAFD,4CAEC"}
+{"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"}

package/lib/workspaces/getWorkspaces.d.ts

@@ -1,19 +1,16 @@
-import { WorkspaceInfo } from "../types/WorkspaceInfo";
+import type { WorkspaceInfos } 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).
+ * 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.
  */
-export declare function getWorkspaces(cwd: string): WorkspaceInfo;
+export declare function getWorkspaces(cwd: string): WorkspaceInfos;
 /**
- * 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.
+ * 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.
  *
- * 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).
+ * NOTE: As of writing, this will start promises to read all package.json files in parallel,
+ * without direct concurrency control.
  */
-export declare function getWorkspacesAsync(cwd: string): Promise<WorkspaceInfo>;
+export declare function getWorkspacesAsync(cwd: string): Promise<WorkspaceInfos>;

package/lib/workspaces/getWorkspaces.js

@@ -3,12 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkspacesAsync = exports.getWorkspaces = void 0;
 const implementations_1 = require("./implementations");
 /**
- * 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).
+ * 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.
  */
 function getWorkspaces(cwd) {
     const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);
@@ -16,12 +13,12 @@ function 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.
+ * 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.
  *
- * 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).
+ * NOTE: As of writing, this will start promises to read all package.json files in parallel,
+ * without direct concurrency control.
  */
 async function getWorkspacesAsync(cwd) {
     const utils = (0, implementations_1.getWorkspaceUtilities)(cwd);

package/lib/workspaces/getWorkspaces.js.map

@@ -1 +1 @@
-{"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,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,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,IAAA,4CAA0B,EAAC,GAAG,CAAC,EAAE,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"}
+{"version":3,"file":"getWorkspaces.js","sourceRoot":"","sources":["../../src/workspaces/getWorkspaces.ts"],"names":[],"mappings":";;;AAAA,uDAAsF;AAGtF;;;;GAIG;AACH,SAAgB,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,IAAA,uCAAqB,EAAC,GAAG,CAAC,CAAC;IACzC,OAAO,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,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,IAAA,4CAA0B,EAAC,GAAG,CAAC,EAAE,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/getWorkspaceUtilities.d.ts

@@ -1,23 +1,30 @@
-import { WorkspaceInfo } from "../../types/WorkspaceInfo";
+import type { Catalogs } from "../../types/Catalogs";
+import type { WorkspaceInfos } from "../../types/WorkspaceInfo";
 export interface WorkspaceUtilities {
     /**
-     * Get an array of paths to packages in the workspace, based on the manager's config file.
+     * Get an array of paths to packages ("workspaces") in the monorepo, 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.
+     * Get an array of paths to packages ("workspaces") in the monorepo, 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.)
+     * Get an array with names, paths, and package.json contents for each package ("workspace")
+     * in a monorepo.
      */
-    getWorkspaces: (cwd: string) => WorkspaceInfo;
+    getWorkspaces: (cwd: string) => WorkspaceInfos;
     /**
-     * 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.)
+     * Get an array with names, paths, and package.json contents for each package ("workspace")
+     * in a monorepo.
      */
-    getWorkspacesAsync?: (cwd: string) => Promise<WorkspaceInfo>;
+    getWorkspacesAsync: (cwd: string) => Promise<WorkspaceInfos>;
+    /**
+     * Get version catalogs, if supported by the manager (only pnpm and yarn v4 as of writing).
+     */
+    getCatalogs?: (cwd: string) => Catalogs | undefined;
 }
 /**
  * Get utility implementations for the workspace manager of `cwd`.

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

@@ -1 +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,IAAA,uDAA0B,EAAC,GAAG,CAAC,EAAE,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"}
+{"version":3,"file":"getWorkspaceUtilities.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/getWorkspaceUtilities.ts"],"names":[],"mappings":";;;AAEA,6EAA0E;AAmC1E;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAW;IAC/C,MAAM,OAAO,GAAG,IAAA,uDAA0B,EAAC,GAAG,CAAC,EAAE,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,2 +1,2 @@
-export { getWorkspaceManagerAndRoot, WorkspaceManagerAndRoot } from "./getWorkspaceManagerAndRoot";
-export { getWorkspaceUtilities, WorkspaceUtilities } from "./getWorkspaceUtilities";
+export { getWorkspaceManagerAndRoot, type WorkspaceManagerAndRoot } from "./getWorkspaceManagerAndRoot";
+export { getWorkspaceUtilities, type WorkspaceUtilities } from "./getWorkspaceUtilities";

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workspaces/implementations/index.ts"],"names":[],"mappings":";;;AAAA,2EAAwG;AAA/F,wIAAA,0BAA0B,OAAA;AACnC,iEAAyF;AAAhF,8HAAA,qBAAqB,OAAA"}