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

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/scan-dist.d.cts

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

package/dist/commands/utils/github-actions-utils.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-utils.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-utils.d.cts}

@@ -1,4 +1,3 @@
-export declare const npmRegistry = "https://registry.npmjs.org/";
 /**
  * Fetch all published versions for a package.
  */
@@ -20,7 +19,13 @@ 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<{

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

@@ -1,4 +1,3 @@
-export declare const npmRegistry = "https://registry.npmjs.org/";
 /**
  * Fetch all published versions for a package.
  */
@@ -20,7 +19,13 @@ 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<{

package/dist/commands/{utils.d.cts → utils/utils.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,7 +10,6 @@ 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;
 /**
@@ -63,4 +62,9 @@ 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 getStagedFiles(options?: Partial<ExecSyncOptionsWithStringEncoding>): string[];
+export declare function getModifiedFiles(options?: Partial<ExecSyncOptionsWithStringEncoding>): string[];
+export declare function commitStagedFiles(messages: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
+export declare function pushCommits(options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
 export {};

package/dist/commands/{utils.d.ts → utils/utils.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,7 +10,6 @@ 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;
 /**
@@ -63,4 +62,9 @@ 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 getStagedFiles(options?: Partial<ExecSyncOptionsWithStringEncoding>): string[];
+export declare function getModifiedFiles(options?: Partial<ExecSyncOptionsWithStringEncoding>): string[];
+export declare function commitStagedFiles(messages: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
+export declare function pushCommits(options?: Partial<ExecSyncOptionsWithStringEncoding>): void;
 export {};

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 shSync(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
+export declare function sh(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 shSync(command: string, options?: Partial<ExecSyncOptionsWithStringEncoding>): string;
+export declare function sh(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 shSync(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
@@ -340,7 +374,7 @@ exports.isPosix = isPosix;
 exports.normalizePath = normalizePath;
 exports.path = path;
 exports.retrievePackageJson = retrievePackageJson;
-exports.sh = sh;
+exports.sh = shSync;
 exports.toPosixPathSeparators = toPosixPathSeparators;
 exports.toSystemPathSeparators = toSystemPathSeparators;
 exports.vitePresetPlugin = vitePresetPlugin;

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, shSync as 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, shSync as 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 shSync(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
@@ -317,7 +351,7 @@ export {
   normalizePath,
   path,
   retrievePackageJson,
-  sh,
+  shSync as sh,
   toPosixPathSeparators,
   toSystemPathSeparators,
   vitePresetPlugin

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

@@ -13,6 +13,7 @@ export type MiniPackageJson = {
     "publishConfig"?: {
         access?: string;
         registry?: string;
+        provenance?: boolean;
     };
     "files"?: string[];
     "dependencies"?: Record<string, string | undefined>;
@@ -32,8 +33,9 @@ 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.

package/dist/packageJson.d.ts

@@ -13,6 +13,7 @@ export type MiniPackageJson = {
     "publishConfig"?: {
         access?: string;
         registry?: string;
+        provenance?: boolean;
     };
     "files"?: string[];
     "dependencies"?: Record<string, string | undefined>;
@@ -32,8 +33,9 @@ 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/components-build-utils",
-  "version": "5.0.0-next.13",
+  "version": "5.0.0-next.131",
   "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",
@@ -22,6 +22,7 @@
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
+    "@actions/core": "^1.11.0",
     "@commander-js/extra-typings": "^14.0.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",
@@ -33,7 +34,7 @@
     "semver": "^7.7.2",
     "split2": "^4.2.0",
     "tslib": "^2.8.1",
-    "vite": "^7.0.0",
+    "vite": "^7.2.2",
     "vite-plugin-dts": "^4.5.4"
   }
 }