@arcgis/components-build-utils 5.0.0-next.13 → 5.0.0-next.130

package/dist/commands/compare-rss.d.cts

@@ -1,10 +1,10 @@
 import { Command } from 'commander';
 /**
  * !important
- * The class makes a TLS request to qawebgis
- * You need to make sure node trusts the certificate authority that signed the certificate used by qawebgis.esri.com
+ * The class makes a TLS request to webgis
+ * You need to make sure node trusts the certificate authority that signed the certificate used by webgis.esri.com
  *
  * Include your certificate authority in the NODE_EXTRA_CA_CERTS environment variable
- * Reference: https://qawebgis.esri.com/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
+ * Reference: https://webgis.esri.com/webgis/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
  */
 export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/compare-rss.d.ts

@@ -1,10 +1,10 @@
 import { Command } from 'commander';
 /**
  * !important
- * The class makes a TLS request to qawebgis
- * You need to make sure node trusts the certificate authority that signed the certificate used by qawebgis.esri.com
+ * The class makes a TLS request to webgis
+ * You need to make sure node trusts the certificate authority that signed the certificate used by webgis.esri.com
  *
  * Include your certificate authority in the NODE_EXTRA_CA_CERTS environment variable
- * Reference: https://qawebgis.esri.com/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
+ * Reference: https://webgis.esri.com/webgis/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
  */
 export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/migrate-repo-issues/devtopia.d.cts

@@ -7,10 +7,10 @@ export interface Issue {
     };
 }
 declare class Devtopia {
-    readonly owner: string;
-    readonly name: string;
     private issuesPerPage;
     constructor(owner: string, name: string);
+    readonly owner: string;
+    readonly name: string;
     /**
      * Requests to github graphql server
      */

package/dist/commands/migrate-repo-issues/devtopia.d.ts

@@ -7,10 +7,10 @@ export interface Issue {
     };
 }
 declare class Devtopia {
-    readonly owner: string;
-    readonly name: string;
     private issuesPerPage;
     constructor(owner: string, name: string);
+    readonly owner: string;
+    readonly name: string;
     /**
      * Requests to github graphql server
      */

package/dist/commands/migrate-repo-issues/zentopia.d.cts

@@ -1,4 +1,4 @@
-import { Issue } from './devtopia';
+import { Issue } from './devtopia.ts';
 export type IssueWithZenhub = {
     gitHubId: string;
     zenhubId: string;
@@ -30,17 +30,17 @@ export type IssueWithZenhub = {
  * You need to make sure node trusts the certificate authority that signed the certificate used by zentopia.esri.com
  *
  * Include your certificate authority in the NODE_EXTRA_CA_CERTS environment variable
- * Reference: https://qawebgis.esri.com/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
+ * Reference: https://webgis.esri.com/webgis/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
  */
 declare class Zentopia {
-    readonly repoId: number;
-    readonly workspaceId: string;
-    readonly token?: string | undefined;
     private _issueIdCache;
     private _pipelinesCache?;
     private _sprintsCache?;
     private _releasesCache?;
-    constructor(repoId: number, workspaceId: string, token?: string | undefined);
+    constructor(repoId: number, workspaceId: string, token?: string);
+    readonly repoId: number;
+    readonly workspaceId: string;
+    readonly token?: string;
     /**
      * Requests to graphql server
      */

package/dist/commands/migrate-repo-issues/zentopia.d.ts

@@ -1,4 +1,4 @@
-import { Issue } from './devtopia';
+import { Issue } from './devtopia.ts';
 export type IssueWithZenhub = {
     gitHubId: string;
     zenhubId: string;
@@ -30,17 +30,17 @@ export type IssueWithZenhub = {
  * You need to make sure node trusts the certificate authority that signed the certificate used by zentopia.esri.com
  *
  * Include your certificate authority in the NODE_EXTRA_CA_CERTS environment variable
- * Reference: https://qawebgis.esri.com/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
+ * Reference: https://webgis.esri.com/webgis/components/devops/troubleshoot/troubleshoot#certificate-verification-failure
  */
 declare class Zentopia {
-    readonly repoId: number;
-    readonly workspaceId: string;
-    readonly token?: string | undefined;
     private _issueIdCache;
     private _pipelinesCache?;
     private _sprintsCache?;
     private _releasesCache?;
-    constructor(repoId: number, workspaceId: string, token?: string | undefined);
+    constructor(repoId: number, workspaceId: string, token?: string);
+    readonly repoId: number;
+    readonly workspaceId: string;
+    readonly token?: string;
     /**
      * Requests to graphql server
      */

package/dist/commands/publish.d.cts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/publish.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/run.d.cts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/dist/commands/run.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/dist/commands/scan-dist.d.cts

@@ -1,5 +1,5 @@
 import { Command } from '@commander-js/extra-typings';
-import { PackageWalkerItem } from './utils';
+import { PackageWalkerItem } from './utils/commands.ts';
 export declare const registerCommand: (command: Command) => undefined;
 export declare function scanDist({ blocklistedNames }: {
     blocklistedNames?: string[];

package/dist/commands/scan-dist.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@commander-js/extra-typings';
-import { PackageWalkerItem } from './utils';
+import { PackageWalkerItem } from './utils/commands.ts';
 export declare const registerCommand: (command: Command) => undefined;
 export declare function scanDist({ blocklistedNames }: {
     blocklistedNames?: string[];

package/dist/commands/update-core-dep.d.cts

@@ -0,0 +1,2 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/update-core-dep.d.ts

@@ -0,0 +1,2 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/{utils.d.cts → utils/commands.d.cts}

@@ -1,5 +1,5 @@
 import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
-import { MiniPackageJson } from '../packageJson';
+import { MiniPackageJson } from '../../packageJson.ts';
 /**
  * Sets the exit code to 1 and prints the error message to stderr.
  * This is used to indicate an error condition in the script.
@@ -10,14 +10,7 @@ export declare function error(...messages: unknown[]): void;
  * This is used to indicate a fatal error that cannot be recovered from.
  */
 export declare function errorAndExit(...messages: unknown[]): never;
-export declare function sh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
 export declare function findRepositoryRoot(): string;
-export declare function isURL(source: string): boolean;
-/**
- * Returns a list of all package paths in the workspace,
- * as resolved from workspaces in root package.json
- */
-export declare function getWorkspacesPackagePaths(includeRootPackage?: boolean): Promise<string[]>;
 export type PackageWalkerItem = PackageWalkerResult<MiniPackageJson>;
 type PackageWalkerResult<T> = {
     /**
@@ -63,4 +56,6 @@ export declare function getAffectedPackages(changed: Iterable<string>, options?:
  * Helper to check if an error is a SIGINT (interrupt) error.
  */
 export declare function isSigint(err: unknown): boolean;
+export declare function getBranchName(): string;
+export declare function pushCommits(options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
 export {};

package/dist/commands/{utils.d.ts → utils/commands.d.ts}

@@ -1,5 +1,5 @@
 import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
-import { MiniPackageJson } from '../packageJson';
+import { MiniPackageJson } from '../../packageJson.ts';
 /**
  * Sets the exit code to 1 and prints the error message to stderr.
  * This is used to indicate an error condition in the script.
@@ -10,14 +10,7 @@ export declare function error(...messages: unknown[]): void;
  * This is used to indicate a fatal error that cannot be recovered from.
  */
 export declare function errorAndExit(...messages: unknown[]): never;
-export declare function sh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
 export declare function findRepositoryRoot(): string;
-export declare function isURL(source: string): boolean;
-/**
- * Returns a list of all package paths in the workspace,
- * as resolved from workspaces in root package.json
- */
-export declare function getWorkspacesPackagePaths(includeRootPackage?: boolean): Promise<string[]>;
 export type PackageWalkerItem = PackageWalkerResult<MiniPackageJson>;
 type PackageWalkerResult<T> = {
     /**
@@ -63,4 +56,6 @@ export declare function getAffectedPackages(changed: Iterable<string>, options?:
  * Helper to check if an error is a SIGINT (interrupt) error.
  */
 export declare function isSigint(err: unknown): boolean;
+export declare function getBranchName(): string;
+export declare function pushCommits(options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
 export {};

package/dist/commands/utils/github-actions.d.cts

@@ -0,0 +1,8 @@
+export declare const markdownLog: string[];
+export declare function addKeyValueToOutput(key: string, value: string[] | string): void;
+export declare function addMarkdownToOutput(key?: string): void;
+export declare function addHeadingToSummary(text: string, level?: 1 | 2 | 3): void;
+export declare function addLineToSummary(text: string): void;
+export declare function addListToSummary(items: string[], ordered?: boolean): void;
+export declare function addNewlineToSummary(): void;
+export declare function writeSummary(): void;

package/dist/commands/utils/github-actions.d.ts

@@ -0,0 +1,8 @@
+export declare const markdownLog: string[];
+export declare function addKeyValueToOutput(key: string, value: string[] | string): void;
+export declare function addMarkdownToOutput(key?: string): void;
+export declare function addHeadingToSummary(text: string, level?: 1 | 2 | 3): void;
+export declare function addLineToSummary(text: string): void;
+export declare function addListToSummary(items: string[], ordered?: boolean): void;
+export declare function addNewlineToSummary(): void;
+export declare function writeSummary(): void;

package/dist/commands/{npm-utils.d.cts → utils/npm.d.cts}

@@ -1,4 +1,4 @@
-export declare const npmRegistry = "https://registry.npmjs.org/";
+import { MiniPackageJson } from '../../packageJson.ts';
 /**
  * Fetch all published versions for a package.
  */
@@ -20,10 +20,24 @@ export declare function isVersionDeprecated(pkgName: string, version: string, op
  * Request npm deprecation for the `package@range` specification
  */
 export declare function deprecate(pkgSpec: string, options: {
-    authToken?: string;
     message: string;
     verbose: boolean;
 }): Promise<{
     stdout?: string;
     error?: unknown;
 }>;
+export declare function undeprecate(pkgSpec: string, options: {
+    message: string;
+    verbose: boolean;
+}): Promise<{
+    stdout?: string;
+    error?: unknown;
+}>;
+/**
+ * Get the necessary env variables and command line args to authenticate against a given registry.
+ */
+export declare function getRegistryEnvAndArgs(packageName: string, registryPath: string): {
+    args: string[];
+    env: Record<string, string>;
+};
+export declare function isPackageAlreadyPublished(packageJson: MiniPackageJson): boolean;

package/dist/commands/{npm-utils.d.ts → utils/npm.d.ts}

@@ -1,4 +1,4 @@
-export declare const npmRegistry = "https://registry.npmjs.org/";
+import { MiniPackageJson } from '../../packageJson.ts';
 /**
  * Fetch all published versions for a package.
  */
@@ -20,10 +20,24 @@ export declare function isVersionDeprecated(pkgName: string, version: string, op
  * Request npm deprecation for the `package@range` specification
  */
 export declare function deprecate(pkgSpec: string, options: {
-    authToken?: string;
     message: string;
     verbose: boolean;
 }): Promise<{
     stdout?: string;
     error?: unknown;
 }>;
+export declare function undeprecate(pkgSpec: string, options: {
+    message: string;
+    verbose: boolean;
+}): Promise<{
+    stdout?: string;
+    error?: unknown;
+}>;
+/**
+ * Get the necessary env variables and command line args to authenticate against a given registry.
+ */
+export declare function getRegistryEnvAndArgs(packageName: string, registryPath: string): {
+    args: string[];
+    env: Record<string, string>;
+};
+export declare function isPackageAlreadyPublished(packageJson: MiniPackageJson): boolean;

package/dist/commands/workspaces-list.d.cts

@@ -0,0 +1,2 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/commands/workspaces-list.d.ts

@@ -0,0 +1,2 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;

package/dist/file.d.cts

@@ -1,6 +1,8 @@
+import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
 export declare const existsAsync: (file: string) => Promise<boolean>;
 /** Wrapper for execSync to execute shell commands */
-export declare const sh: (command: string, cwd?: string) => string;
+export declare function sh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
+export declare function asyncSh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): Promise<string>;
 export declare function createFileIfNotExists(filePath: string, content: string): Promise<void>;
 /**
  * Climb the directory tree upward, until found a directory that contains the

package/dist/file.d.ts

@@ -1,6 +1,8 @@
+import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
 export declare const existsAsync: (file: string) => Promise<boolean>;
 /** Wrapper for execSync to execute shell commands */
-export declare const sh: (command: string, cwd?: string) => string;
+export declare function sh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
+export declare function asyncSh(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): Promise<string>;
 export declare function createFileIfNotExists(filePath: string, content: string): Promise<void>;
 /**
  * Climb the directory tree upward, until found a directory that contains the

package/dist/index.cjs

@@ -24,16 +24,46 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const node_fs = require("node:fs");
 const promises = require("node:fs/promises");
-const node_child_process = require("node:child_process");
 const path$1 = require("path");
 const node_url = require("node:url");
+const node_child_process = require("node:child_process");
+const node_util = require("node:util");
 const node_module = require("node:module");
 const existsAsync = async (file) => (
   // Using un-promisified version because promises version creates exceptions
   // which interferes with debugging when "Pause on caught exceptions" is enabled
   await new Promise((resolve2) => node_fs.access(file, promises.constants.F_OK, (error) => resolve2(!error)))
 );
-const sh = (command, cwd) => node_child_process.execSync(command.trim(), { encoding: "utf8", cwd }).trim();
+function sh(command, options = {}) {
+  try {
+    const normalizedOptions = { encoding: "utf8", ...options };
+    return node_child_process.execSync(command.trim(), normalizedOptions).trim();
+  } catch (error) {
+    makeExecErrorReadable(error);
+    throw error;
+  }
+}
+function makeExecErrorReadable(error) {
+  if (error instanceof Error && error.stack && "output" in error && Array.isArray(error.output) && "status" in error) {
+    const stackIndex = error.stack.indexOf("\n    at ");
+    if (stackIndex !== -1) {
+      const output = error.output.filter(Boolean).join("\n").trim();
+      const newHeader = `${node_util.styleText("red", error.message)} (exit code: ${String(error.status)})
+${output}`;
+      const oldStackFrames = error.stack.substring(stackIndex);
+      error.stack = `Error: ${newHeader}${oldStackFrames}`;
+    }
+    Object.defineProperties(error, {
+      output: { enumerable: false },
+      stdout: { enumerable: false },
+      stderr: { enumerable: false },
+      signal: { enumerable: false },
+      status: { enumerable: false },
+      pid: { enumerable: false },
+      stdio: { enumerable: false }
+    });
+  }
+}
 async function createFileIfNotExists(filePath, content) {
   await promises.mkdir(path$1.dirname(filePath), { recursive: true });
   if (!await existsAsync(filePath)) {
@@ -43,7 +73,7 @@ async function createFileIfNotExists(filePath, content) {
 function findPath(target, startDirectory = process.cwd()) {
   const resolvedStartDirectory = startDirectory.startsWith("file:///") ? path$1.dirname(node_url.fileURLToPath(startDirectory)) : path$1.resolve(startDirectory);
   const parentPath = resolvedStartDirectory.split(path$1.sep);
-  while (parentPath.length > 2) {
+  while (parentPath.length > searchStopIndex) {
     const fullPath = path$1.join(
       ...path$1.sep === "/" ? ["/"] : [],
       ...parentPath,
@@ -56,10 +86,11 @@ function findPath(target, startDirectory = process.cwd()) {
   }
   return void 0;
 }
+const searchStopIndex = 0;
 async function asyncFindPath(target, startDirectory = process.cwd()) {
   const resolvedStartDirectory = startDirectory.startsWith("file:///") ? path$1.dirname(node_url.fileURLToPath(startDirectory)) : path$1.resolve(startDirectory);
   const parentPath = resolvedStartDirectory.split(path$1.sep);
-  while (parentPath.length > 2) {
+  while (parentPath.length > searchStopIndex) {
     const fullPath = path$1.join(
       ...path$1.sep === "/" ? ["/"] : [],
       ...parentPath,
@@ -132,13 +163,16 @@ const path = isPosix ? path$1.posix : {
 const cachedPackageJson = {};
 const cachedPackageJsonPromises = {};
 let rootPackageJsonLocation;
-function retrievePackageJson(location) {
+function retrievePackageJson(location, cache = true) {
   const packageJsonPath = location ? path.resolve(location, "package.json") : rootPackageJsonLocation ??= findPath("package.json");
-  cachedPackageJson[packageJsonPath] ??= JSON.parse(node_fs.readFileSync(packageJsonPath, "utf-8"));
-  return cachedPackageJson[packageJsonPath];
+  if (cache) {
+    cachedPackageJson[packageJsonPath] ??= JSON.parse(node_fs.readFileSync(packageJsonPath, "utf-8"));
+    return cachedPackageJson[packageJsonPath];
+  }
+  return JSON.parse(node_fs.readFileSync(packageJsonPath, "utf-8"));
 }
-async function asyncRetrievePackageJson(location = getCwd()) {
-  const packageJsonPath = path.resolve(location, "package.json");
+async function asyncRetrievePackageJson(location) {
+  const packageJsonPath = location ? path.resolve(location, "package.json") : rootPackageJsonLocation ??= findPath("package.json");
   if (packageJsonPath in cachedPackageJson) {
     return cachedPackageJson[packageJsonPath];
   }
@@ -212,7 +246,7 @@ function vitePresetPlugin({
           build: {
             // REFACTOR: get this from tsconfig
             // It's a best practice to let the final bundler down-level as needed.
-            target: target ?? "es2022"
+            target: target ?? "es2024"
           },
           define: env.mode === "test" ? {
             "process.env.ESRI_INTERNAL": true

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-export { existsAsync, sh, createFileIfNotExists, findPath, asyncFindPath } from './file';
-export { gitIgnoreFileToGlobs, gitIgnoreToGlob } from './glob';
-export { isPosix, toPosixPathSeparators, normalizePath, toSystemPathSeparators, getCwd, path } from './path';
-export { type MiniPackageJson, retrievePackageJson, asyncRetrievePackageJson, fetchPackageLocation, detectPackageManager, } from './packageJson';
-export { vitePresetPlugin, type DependencyManagementOptions, externalizeDependencies } from './vite';
+export { existsAsync, sh, createFileIfNotExists, findPath, asyncFindPath } from './file.ts';
+export { gitIgnoreFileToGlobs, gitIgnoreToGlob } from './glob.ts';
+export { isPosix, toPosixPathSeparators, normalizePath, toSystemPathSeparators, getCwd, path } from './path.ts';
+export { type MiniPackageJson, retrievePackageJson, asyncRetrievePackageJson, fetchPackageLocation, detectPackageManager, } from './packageJson.ts';
+export { vitePresetPlugin, type DependencyManagementOptions, externalizeDependencies } from './vite.ts';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { existsAsync, sh, createFileIfNotExists, findPath, asyncFindPath } from './file';
-export { gitIgnoreFileToGlobs, gitIgnoreToGlob } from './glob';
-export { isPosix, toPosixPathSeparators, normalizePath, toSystemPathSeparators, getCwd, path } from './path';
-export { type MiniPackageJson, retrievePackageJson, asyncRetrievePackageJson, fetchPackageLocation, detectPackageManager, } from './packageJson';
-export { vitePresetPlugin, type DependencyManagementOptions, externalizeDependencies } from './vite';
+export { existsAsync, sh, createFileIfNotExists, findPath, asyncFindPath } from './file.ts';
+export { gitIgnoreFileToGlobs, gitIgnoreToGlob } from './glob.ts';
+export { isPosix, toPosixPathSeparators, normalizePath, toSystemPathSeparators, getCwd, path } from './path.ts';
+export { type MiniPackageJson, retrievePackageJson, asyncRetrievePackageJson, fetchPackageLocation, detectPackageManager, } from './packageJson.ts';
+export { vitePresetPlugin, type DependencyManagementOptions, externalizeDependencies } from './vite.ts';

package/dist/index.js

@@ -1,15 +1,45 @@
 import { access, existsSync, readFileSync } from "node:fs";
 import { constants, mkdir, writeFile, readFile } from "node:fs/promises";
-import { execSync } from "node:child_process";
 import { dirname, resolve, sep, join, posix, win32 } from "path";
 import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import { styleText } from "node:util";
 import { builtinModules } from "node:module";
 const existsAsync = async (file) => (
   // Using un-promisified version because promises version creates exceptions
   // which interferes with debugging when "Pause on caught exceptions" is enabled
   await new Promise((resolve2) => access(file, constants.F_OK, (error) => resolve2(!error)))
 );
-const sh = (command, cwd) => execSync(command.trim(), { encoding: "utf8", cwd }).trim();
+function sh(command, options = {}) {
+  try {
+    const normalizedOptions = { encoding: "utf8", ...options };
+    return execSync(command.trim(), normalizedOptions).trim();
+  } catch (error) {
+    makeExecErrorReadable(error);
+    throw error;
+  }
+}
+function makeExecErrorReadable(error) {
+  if (error instanceof Error && error.stack && "output" in error && Array.isArray(error.output) && "status" in error) {
+    const stackIndex = error.stack.indexOf("\n    at ");
+    if (stackIndex !== -1) {
+      const output = error.output.filter(Boolean).join("\n").trim();
+      const newHeader = `${styleText("red", error.message)} (exit code: ${String(error.status)})
+${output}`;
+      const oldStackFrames = error.stack.substring(stackIndex);
+      error.stack = `Error: ${newHeader}${oldStackFrames}`;
+    }
+    Object.defineProperties(error, {
+      output: { enumerable: false },
+      stdout: { enumerable: false },
+      stderr: { enumerable: false },
+      signal: { enumerable: false },
+      status: { enumerable: false },
+      pid: { enumerable: false },
+      stdio: { enumerable: false }
+    });
+  }
+}
 async function createFileIfNotExists(filePath, content) {
   await mkdir(dirname(filePath), { recursive: true });
   if (!await existsAsync(filePath)) {
@@ -19,7 +49,7 @@ async function createFileIfNotExists(filePath, content) {
 function findPath(target, startDirectory = process.cwd()) {
   const resolvedStartDirectory = startDirectory.startsWith("file:///") ? dirname(fileURLToPath(startDirectory)) : resolve(startDirectory);
   const parentPath = resolvedStartDirectory.split(sep);
-  while (parentPath.length > 2) {
+  while (parentPath.length > searchStopIndex) {
     const fullPath = join(
       ...sep === "/" ? ["/"] : [],
       ...parentPath,
@@ -32,10 +62,11 @@ function findPath(target, startDirectory = process.cwd()) {
   }
   return void 0;
 }
+const searchStopIndex = 0;
 async function asyncFindPath(target, startDirectory = process.cwd()) {
   const resolvedStartDirectory = startDirectory.startsWith("file:///") ? dirname(fileURLToPath(startDirectory)) : resolve(startDirectory);
   const parentPath = resolvedStartDirectory.split(sep);
-  while (parentPath.length > 2) {
+  while (parentPath.length > searchStopIndex) {
     const fullPath = join(
       ...sep === "/" ? ["/"] : [],
       ...parentPath,
@@ -108,13 +139,16 @@ const path = isPosix ? posix : {
 const cachedPackageJson = {};
 const cachedPackageJsonPromises = {};
 let rootPackageJsonLocation;
-function retrievePackageJson(location) {
+function retrievePackageJson(location, cache = true) {
   const packageJsonPath = location ? path.resolve(location, "package.json") : rootPackageJsonLocation ??= findPath("package.json");
-  cachedPackageJson[packageJsonPath] ??= JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-  return cachedPackageJson[packageJsonPath];
+  if (cache) {
+    cachedPackageJson[packageJsonPath] ??= JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    return cachedPackageJson[packageJsonPath];
+  }
+  return JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 }
-async function asyncRetrievePackageJson(location = getCwd()) {
-  const packageJsonPath = path.resolve(location, "package.json");
+async function asyncRetrievePackageJson(location) {
+  const packageJsonPath = location ? path.resolve(location, "package.json") : rootPackageJsonLocation ??= findPath("package.json");
   if (packageJsonPath in cachedPackageJson) {
     return cachedPackageJson[packageJsonPath];
   }
@@ -188,7 +222,7 @@ function vitePresetPlugin({
           build: {
             // REFACTOR: get this from tsconfig
             // It's a best practice to let the final bundler down-level as needed.
-            target: target ?? "es2022"
+            target: target ?? "es2024"
           },
           define: env.mode === "test" ? {
             "process.env.ESRI_INTERNAL": true

package/dist/monorepoConfig.d.cts

@@ -0,0 +1 @@
+export * from '../../../../monorepo.config.ts';

package/dist/monorepoConfig.d.ts

@@ -0,0 +1 @@
+export * from '../../../../monorepo.config.ts';

package/dist/packageJson.d.cts

@@ -9,10 +9,10 @@ export type MiniPackageJson = {
     "version": string;
     "private"?: boolean;
     "type"?: "commonjs" | "module";
-    "workspaces"?: string[];
     "publishConfig"?: {
         access?: string;
         registry?: string;
+        provenance?: boolean;
     };
     "files"?: string[];
     "dependencies"?: Record<string, string | undefined>;
@@ -32,14 +32,15 @@ export type MiniPackageJson = {
         deployBuilds?: Record<string, unknown>;
     };
 };
-export declare function retrievePackageJson(location?: string): MiniPackageJson;
+export declare function retrievePackageJson(location?: string, cache?: boolean): MiniPackageJson;
 export declare function asyncRetrievePackageJson(location?: string): Promise<MiniPackageJson>;
+export declare function asyncWritePackageJson(location: string, content: MiniPackageJson): Promise<string>;
 /**
  * Returns an absolute path to the root of a package in node_modules, without
  * trailing slash.
  */
 export declare function fetchPackageLocation(packageName: string, cwd?: string): Promise<string>;
 /**
- * Detect if current repository/monorepo uses npm, yarn or pnpm
+ * Detect if current repository/monorepo uses npm, pnpm, or yarn
  */
 export declare function detectPackageManager(cwd?: string): string;

package/dist/packageJson.d.ts

@@ -9,10 +9,10 @@ export type MiniPackageJson = {
     "version": string;
     "private"?: boolean;
     "type"?: "commonjs" | "module";
-    "workspaces"?: string[];
     "publishConfig"?: {
         access?: string;
         registry?: string;
+        provenance?: boolean;
     };
     "files"?: string[];
     "dependencies"?: Record<string, string | undefined>;
@@ -32,14 +32,15 @@ export type MiniPackageJson = {
         deployBuilds?: Record<string, unknown>;
     };
 };
-export declare function retrievePackageJson(location?: string): MiniPackageJson;
+export declare function retrievePackageJson(location?: string, cache?: boolean): MiniPackageJson;
 export declare function asyncRetrievePackageJson(location?: string): Promise<MiniPackageJson>;
+export declare function asyncWritePackageJson(location: string, content: MiniPackageJson): Promise<string>;
 /**
  * Returns an absolute path to the root of a package in node_modules, without
  * trailing slash.
  */
 export declare function fetchPackageLocation(packageName: string, cwd?: string): Promise<string>;
 /**
- * Detect if current repository/monorepo uses npm, yarn or pnpm
+ * Detect if current repository/monorepo uses npm, pnpm, or yarn
  */
 export declare function detectPackageManager(cwd?: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/components-build-utils",
-  "version": "5.0.0-next.13",
+  "version": "5.0.0-next.130",
   "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",
@@ -18,11 +18,13 @@
     "dist/"
   ],
   "bin": {
-    "awc": "src/commands/run-wrapper.js"
+    "awc": "src/commands/run.ts"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
+    "@actions/core": "^1.11.0",
     "@commander-js/extra-typings": "^14.0.0",
+    "@pnpm/workspace.read-manifest": "^1000.2.7",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",
     "fast-glob": "^3.3.3",
@@ -30,10 +32,10 @@
     "glob": "^11.0.3",
     "ora": "^8.2.0",
     "p-limit": "^7.1.1",
-    "semver": "^7.7.2",
+    "semver": "^7.7.3",
     "split2": "^4.2.0",
     "tslib": "^2.8.1",
-    "vite": "^7.0.0",
+    "vite": "^7.2.2",
     "vite-plugin-dts": "^4.5.4"
   }
 }

package/src/commands/run.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { Command } from "@commander-js/extra-typings";
+import fs from "node:fs";
+
+interface CommandModule {
+  registerCommand: (program: Command) => void;
+}
+
+const program = new Command();
+
+program.name("components-build-utils").description("Util scripts for working with monorepo components");
+
+const commandsDirectory = import.meta.dirname;
+
+/**
+ * If CLI is called with a specific command, only load that command.
+ * Otherwise, load all.
+ */
+const commandName = process.argv[2];
+const commandsToLoad =
+  commandName !== undefined && commandName !== "help" && !commandName.startsWith("-")
+    ? [`${commandName}.ts`]
+    : fs.readdirSync(commandsDirectory);
+// Load all commands in the ./commands directory
+Promise.all(
+  commandsToLoad.map(async (file) => {
+    if (!file.endsWith(".ts")) {
+      return;
+    }
+    let command: CommandModule;
+    try {
+      command = (await import(`./${file}`)) as CommandModule;
+    } catch {
+      console.error(`error: unknown command: ${file.slice(0, -".ts".length)}`);
+      process.exit(1);
+    }
+    if (typeof command.registerCommand === "function") {
+      command.registerCommand(program);
+    }
+  }),
+)
+  .then(() => program.parse())
+  .catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });

package/src/commands/run-wrapper.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-// Register tsx's TypeScript loader that will do on the fly transpilation of any
-// imported .ts file
-import "tsx";
-// This still has to be async import until native TS support in Node 24
-await import("./run.ts");