@arcgis/node-toolkit 5.2.0-next.112 → 5.2.0-next.114

package/dist/workspace.d.ts

@@ -1,8 +1,9 @@
+import { type PackageJson } from "./packageJson.ts";
 /**
  * Set the target file to use when finding the root of the repository.
  * By default, it looks for the pnpm-lock.yaml file, but you can specify a different target file if needed.
  *
- * @public
+ * @internal
  * @param target
  */
 export declare function setRootTargetFile(target: string): void;
@@ -10,21 +11,54 @@ export declare function setRootTargetFile(target: string): void;
  * Locate the root directory by finding a target file.
  * By default, it looks for the pnpm-lock.yaml file, but you can call setRootTargetFile to specify a different target file if needed.
  *
- * @public
+ * @internal
  */
 export declare function findRepositoryRoot(): string;
+/** @internal */
+export type PackageWalkerItem = {
+    /** @internal */
+    packagePath: string;
+    /** @internal */
+    manifest: PackageJson;
+};
+/**
+ * @internal
+ * @param item
+ */
+type PackageWalkerCallback<T> = (item: PackageWalkerItem) => T;
+/** @internal */
+type WorkspacePackagesWalkerOptions = {
+    /**
+     * Whether to include the root package. By default, it is not included.
+     *
+     * @internal
+     */
+    includeRootPackage?: boolean;
+    /**
+     * The repository root. By default, it is the directory containing pnpm-lock.yaml.
+     *
+     * @internal
+     */
+    repositoryRoot?: string;
+};
+/**
+ * Walk all pnpm workspace packages and collect non-null callback results.
+ *
+ * @internal
+ */
+export declare function workspacePackagesWalker<T>(callback: PackageWalkerCallback<T>, { includeRootPackage, repositoryRoot }?: WorkspacePackagesWalkerOptions): Promise<NonNullable<Awaited<T>>[]>;
 /**
  * Get the path to the Turbo CLI. This allows us to directly invoke it without incurring the overhead of going through
  * the package manager.
  *
- * @public
+ * @internal
  * @param repositoryRoot
  */
 export declare function getTurboPath(repositoryRoot?: string): string;
 /**
  * Parse a version string into its components.
  *
- * @public
+ * @internal
  * @param version
  * @example
  * ```ts
@@ -48,7 +82,7 @@ export declare const parseVersion: (version: string) => {
  * The cdnVersion is the system version without any pre-release or build metadata, and is used for deployment and publishing
  * (e.g. 1.2.3-next.4 becomes 1.2.3-next and 5.2.1 stays 5.2.1).
  *
- * @public
+ * @internal
  */
 export declare function getSystemVersion(): ReturnType<typeof parseVersion> & {
     version: string;
@@ -56,7 +90,8 @@ export declare function getSystemVersion(): ReturnType<typeof parseVersion> & {
 /**
  * Detect if current repository/monorepo uses npm, pnpm, or yarn
  *
- * @public
+ * @internal
  * @param cwd
  */
 export declare function detectPackageManager(cwd?: string): string;
+export {};

package/dist/workspace.js

@@ -1,7 +1,10 @@
+import { readWorkspaceManifest } from "@pnpm/workspace.read-manifest";
 import { findPath } from "./file.js";
-import { retrievePackageJson } from "./packageJson.js";
+import { retrievePackageJson, asyncRetrievePackageJson } from "./packageJson.js";
 import { path } from "./path.js";
 import { existsSync, readFileSync } from "node:fs";
+import { styleText } from "node:util";
+import { glob } from "tinyglobby";
 let rootTargetFile = "pnpm-lock.yaml";
 function setRootTargetFile(target) {
   rootTargetFile = target;
@@ -15,6 +18,52 @@ function findRepositoryRoot() {
   }
   return path.dirname(lockFilePath);
 }
+async function getWorkspacePackagePaths(includeRootPackage = true, repositoryRoot = findRepositoryRoot()) {
+  const packagePatterns = (await readWorkspaceManifest(repositoryRoot))?.packages ?? [];
+  const packageJsonPatterns = packagePatterns.map((packagePattern) => `${packagePattern}/package.json`);
+  if (includeRootPackage) {
+    packageJsonPatterns.push("package.json");
+  }
+  const packageJsonPaths = await glob(packageJsonPatterns, {
+    dot: true,
+    onlyFiles: true,
+    absolute: false,
+    cwd: repositoryRoot,
+    followSymbolicLinks: false
+  });
+  return packageJsonPaths.map((packageJsonPath) => path.dirname(packageJsonPath));
+}
+async function workspacePackagesWalker(callback, { includeRootPackage = false, repositoryRoot = findRepositoryRoot() } = {}) {
+  const packagePaths = await getWorkspacePackagePaths(includeRootPackage, repositoryRoot);
+  const results = [];
+  try {
+    await Promise.all(
+      packagePaths.map(async (packagePath) => {
+        try {
+          const manifest = await asyncRetrievePackageJson(path.join(repositoryRoot, packagePath));
+          if (!manifest) {
+            console.error(styleText("red", `Failed to read package manifest at ${packagePath}, skipping.`));
+            return;
+          }
+          const output = await callback({ packagePath, manifest }) ?? void 0;
+          if (output !== void 0) {
+            results.push(output);
+          }
+        } catch (error) {
+          console.error(styleText("red", `Error processing package ${packagePath}:`));
+          console.error(error);
+          throw error;
+        }
+      })
+    );
+  } catch (error) {
+    console.error(String(error));
+    const workspaceError = new Error("Error occurred during workspace package walking.");
+    workspaceError.stack = "";
+    throw workspaceError;
+  }
+  return results;
+}
 function getTurboPath(repositoryRoot = findRepositoryRoot()) {
   return path.join(repositoryRoot, "node_modules/turbo/bin/turbo");
 }
@@ -74,5 +123,6 @@ export {
   getSystemVersion,
   getTurboPath,
   parseVersion,
-  setRootTargetFile
+  setRootTargetFile,
+  workspacePackagesWalker
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/node-toolkit",
-  "version": "5.2.0-next.112",
+  "version": "5.2.0-next.114",
   "description": "Collection of common internal build-time patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "type": "module",
@@ -23,7 +23,9 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
+    "@pnpm/workspace.read-manifest": "^1000.2.10",
     "@types/node": "~24.11.2",
+    "tinyglobby": "~0.2.17",
     "tslib": "^2.8.1",
     "typescript": "~6.0.3",
     "vite": "^7.3.2",