@arcgis/node-toolkit 5.2.0-next.57 → 5.2.0-next.59

package/dist/packageJson.d.ts

@@ -59,6 +59,7 @@ export declare function asyncRetrievePackageJson(location?: string): Promise<Pac
  */
 export declare function fetchPackageLocation(packageName: string, cwd?: string): Promise<string>;
 /**
- * Detect if current repository/monorepo uses npm, pnpm, or yarn
+ * Find the package.json for a given package name in node_modules, and return the parsed JSON.
+ * Returns undefined if the package.json cannot be found.
  */
-export declare function detectPackageManager(cwd?: string): string;
+export declare function findPackageJson(packageName: string): PackageJson | undefined;

package/dist/packageJson.js

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { path } from "./path.js";
 import { asyncFindPath, findPath } from "./file.js";
-import { existsSync, readFileSync } from "node:fs";
+import { readFileSync } from "node:fs";
 const cachedPackageJson = {};
 const cachedPackageJsonPromises = {};
 let rootPackageJsonLocation;
@@ -43,31 +43,16 @@ async function fetchPackageLocation(packageName, cwd) {
   cachedPackageLocation[packageName] ??= result;
   return cachedPackageLocation[packageName];
 }
-function detectPackageManager(cwd = process.cwd()) {
-  let packageManager = void 0;
-  {
-    const pathParts = path.resolve(cwd).split(path.sep);
-    while (pathParts.length > 1) {
-      const packageJson = path.join(pathParts.join(path.sep), "package.json");
-      pathParts.pop();
-      if (!existsSync(packageJson)) {
-        continue;
-      }
-      const contents = JSON.parse(readFileSync(packageJson, "utf8"));
-      if (typeof contents !== "object" || Array.isArray(contents)) {
-        continue;
-      }
-      if (typeof contents.packageManager === "string") {
-        packageManager ??= contents.packageManager.match(/\w+/u)?.[0] ?? packageManager;
-      }
-    }
+function findPackageJson(packageName) {
+  const path2 = findPath(`node_modules/${packageName}/`);
+  if (!path2) {
+    return void 0;
   }
-  packageManager ??= "npm";
-  return packageManager;
+  return retrievePackageJson(path2);
 }
 export {
   asyncRetrievePackageJson,
-  detectPackageManager,
   fetchPackageLocation,
+  findPackageJson,
   retrievePackageJson
 };

package/dist/workspace.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+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.
+ */
+export declare function findRepositoryRoot(): string;
+/**
+ * Parse a version string into its components.
+ *
+ * @example
+ * ```ts
+ * const parsed = parseVersion("4.34.0-next.123");
+ * // { major: 4, minor: 34, patch: 0, prerelease: ["next", 123], majorMinorVersion: "4.34", cdnVersion: "4.34.0-next" }
+ * const parsed = parseVersion("5.2.20");
+ * // { major: 5, minor: 2, patch: 20, prerelease: [], majorMinorVersion: "5.2", cdnVersion: "5.2.20" }
+ * ```
+ */
+export declare const parseVersion: (version: string) => {
+    major: string;
+    minor: string;
+    patch: string;
+    prerelease: string[];
+    majorMinorVersion: string;
+    cdnVersion: string;
+};
+/**
+ * Get the system version from the root package.json. The system version is the version of the monorepo as a whole, and is used for deployment and publishing.
+ * The majorMinorVersion is major.minor version of the system version, and is used for deployment and publishing.
+ * 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).
+ */
+export declare function getSystemVersion(): ReturnType<typeof parseVersion> & {
+    version: string;
+};
+/**
+ * Detect if current repository/monorepo uses npm, pnpm, or yarn
+ */
+export declare function detectPackageManager(cwd?: string): string;

package/dist/workspace.js

@@ -0,0 +1,74 @@
+import { findPath } from "./file.js";
+import { retrievePackageJson } from "./packageJson.js";
+import { path } from "./path.js";
+import { existsSync, readFileSync } from "node:fs";
+let rootTargetFile = "pnpm-lock.yaml";
+function setRootTargetFile(target) {
+  rootTargetFile = target;
+}
+function findRepositoryRoot() {
+  const lockFilePath = findPath(rootTargetFile);
+  if (!lockFilePath) {
+    throw new Error(
+      `Unable to find root with target "${rootTargetFile}" from current working directory: ${process.cwd()}`
+    );
+  }
+  return path.dirname(lockFilePath);
+}
+const parseVersion = (version) => {
+  const versionParts = /^(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<prereleaseParts>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/u.exec(
+    version
+  );
+  if (!versionParts?.groups) {
+    throw new Error(`Unable to parse version "${version}"`);
+  }
+  const { major, minor, patch, prereleaseParts } = versionParts.groups;
+  const prerelease = prereleaseParts ? prereleaseParts.split(".") : [];
+  const majorMinorVersion = `${major}.${minor}`;
+  const cdnVersion = prerelease[0] ? `${majorMinorVersion}.${patch}-${prerelease[0]}` : `${majorMinorVersion}.${patch}`;
+  return {
+    major,
+    minor,
+    patch,
+    prerelease,
+    majorMinorVersion,
+    cdnVersion
+  };
+};
+function getSystemVersion() {
+  const repositoryRoot = findRepositoryRoot();
+  const version = retrievePackageJson(repositoryRoot).version;
+  if (!version) {
+    throw new Error("Root package.json does not have a version defined");
+  }
+  return { version, ...parseVersion(version) };
+}
+function detectPackageManager(cwd = process.cwd()) {
+  let packageManager = void 0;
+  {
+    const pathParts = path.resolve(cwd).split(path.sep);
+    while (pathParts.length > 1) {
+      const packageJson = path.join(pathParts.join(path.sep), "package.json");
+      pathParts.pop();
+      if (!existsSync(packageJson)) {
+        continue;
+      }
+      const contents = JSON.parse(readFileSync(packageJson, "utf8"));
+      if (typeof contents !== "object" || Array.isArray(contents)) {
+        continue;
+      }
+      if (typeof contents.packageManager === "string") {
+        packageManager ??= contents.packageManager.match(/\w+/u)?.[0] ?? packageManager;
+      }
+    }
+  }
+  packageManager ??= "npm";
+  return packageManager;
+}
+export {
+  detectPackageManager,
+  findRepositoryRoot,
+  getSystemVersion,
+  parseVersion,
+  setRootTargetFile
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/node-toolkit",
-  "version": "5.2.0-next.57",
+  "version": "5.2.0-next.59",
   "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",
@@ -12,6 +12,7 @@
     "./packageJson": "./dist/packageJson.js",
     "./vite/presetPlugin": "./dist/vite/presetPlugin.js",
     "./vite/externalizeDependenciesPlugin": "./dist/vite/externalizeDependenciesPlugin.js",
+    "./workspace": "./dist/workspace.js",
     "./package.json": "./package.json"
   },
   "files": [