@arcgis/components-build-utils 4.34.0-next.8 → 4.34.0-next.81

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

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

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

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

package/dist/commands/deprecate.d.cts

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

package/dist/commands/deprecate.d.ts

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

package/dist/commands/ensure-working-tree-clean.d.cts

@@ -3,3 +3,4 @@ export declare const registerCommand: (command: Command) => undefined;
 export declare function ensureWorkingTreeClean({ cwd }?: {
     cwd?: string;
 }): void;
+export declare const readWorkingTree: (cwd?: string) => string | undefined;

package/dist/commands/ensure-working-tree-clean.d.ts

@@ -3,3 +3,4 @@ export declare const registerCommand: (command: Command) => undefined;
 export declare function ensureWorkingTreeClean({ cwd }?: {
     cwd?: string;
 }): void;
+export declare const readWorkingTree: (cwd?: string) => string | undefined;

package/dist/commands/generate-builddate.d.cts

@@ -0,0 +1,12 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;
+export type Builddate = {
+    "builddate": string;
+    "commit": string;
+    "branch": string;
+    "version": string;
+    "@arcgis/core": string;
+    "@esri/calcite-components": string;
+    "@esri/arcgis-html-sanitizer": string;
+};
+export declare function generateBuilddate(): Builddate;

package/dist/commands/generate-builddate.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const registerCommand: (command: Command) => undefined;
+export type Builddate = {
+    "builddate": string;
+    "commit": string;
+    "branch": string;
+    "version": string;
+    "@arcgis/core": string;
+    "@esri/calcite-components": string;
+    "@esri/arcgis-html-sanitizer": string;
+};
+export declare function generateBuilddate(): Builddate;

package/dist/commands/generate-info-html.d.cts

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

package/dist/commands/generate-info-html.d.ts

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

package/dist/commands/git-copy/getFileNames.d.cts

@@ -1,4 +1,4 @@
-export declare function getFileNames(sourceRelative: string, sourceRoot: string, endsWithIgnore: string[], ignore?: string[]): {
+export declare function getFileNames(sourceRelative: string, sourceRoot: string, endsWithIgnore: string[], containsIgnore: string[], ignore?: string[]): {
     filteredFiles: string[];
     rootFiles: Set<string>;
 };

package/dist/commands/git-copy/getFileNames.d.ts

@@ -1,4 +1,4 @@
-export declare function getFileNames(sourceRelative: string, sourceRoot: string, endsWithIgnore: string[], ignore?: string[]): {
+export declare function getFileNames(sourceRelative: string, sourceRoot: string, endsWithIgnore: string[], containsIgnore: string[], ignore?: string[]): {
     filteredFiles: string[];
     rootFiles: Set<string>;
 };

package/dist/commands/git-copy/index.d.cts

@@ -1,4 +1,4 @@
-export declare function copyFolderWithHistory(rawSource: string, rawDestination: string, { yes, emitPatchFiles, dryRun, dirtyCheck, addBackLinks, ignoreAlreadyExists, remote, ignore, endsWithIgnore, rename: rawRenames, dumpSizes, dumpFileSizes, updateMergeCommitTitlesFrom, }: {
+export declare function copyFolderWithHistory(rawSource: string, rawDestination: string, { yes, emitPatchFiles, dryRun, dirtyCheck, addBackLinks, ignoreAlreadyExists, remote, ignore, endsWithIgnore, containsIgnore, rename: rawRenames, dumpSizes, dumpFileSizes, updateMergeCommitTitlesFrom, }: {
     readonly yes: boolean;
     readonly emitPatchFiles: boolean;
     readonly dryRun: boolean;
@@ -8,6 +8,7 @@ export declare function copyFolderWithHistory(rawSource: string, rawDestination:
     readonly remote: string;
     readonly ignore?: string[];
     readonly endsWithIgnore?: string[];
+    readonly containsIgnore?: string[];
     readonly rename?: string[];
     readonly dumpSizes: boolean;
     readonly dumpFileSizes: boolean;

package/dist/commands/git-copy/index.d.ts

@@ -1,4 +1,4 @@
-export declare function copyFolderWithHistory(rawSource: string, rawDestination: string, { yes, emitPatchFiles, dryRun, dirtyCheck, addBackLinks, ignoreAlreadyExists, remote, ignore, endsWithIgnore, rename: rawRenames, dumpSizes, dumpFileSizes, updateMergeCommitTitlesFrom, }: {
+export declare function copyFolderWithHistory(rawSource: string, rawDestination: string, { yes, emitPatchFiles, dryRun, dirtyCheck, addBackLinks, ignoreAlreadyExists, remote, ignore, endsWithIgnore, containsIgnore, rename: rawRenames, dumpSizes, dumpFileSizes, updateMergeCommitTitlesFrom, }: {
     readonly yes: boolean;
     readonly emitPatchFiles: boolean;
     readonly dryRun: boolean;
@@ -8,6 +8,7 @@ export declare function copyFolderWithHistory(rawSource: string, rawDestination:
     readonly remote: string;
     readonly ignore?: string[];
     readonly endsWithIgnore?: string[];
+    readonly containsIgnore?: string[];
     readonly rename?: string[];
     readonly dumpSizes: boolean;
     readonly dumpFileSizes: boolean;

package/dist/commands/git-copy/utils.d.cts

@@ -5,5 +5,4 @@ export declare const gb: number;
  * Setting this decreased total run time from 1m40s to 1m05s
  */
 export declare const highWaterMark: number;
-export declare function exit(command: string): never;
 export declare const reOriginalSha: RegExp;

package/dist/commands/git-copy/utils.d.ts

@@ -5,5 +5,4 @@ export declare const gb: number;
  * Setting this decreased total run time from 1m40s to 1m05s
  */
 export declare const highWaterMark: number;
-export declare function exit(command: string): never;
 export declare const reOriginalSha: RegExp;

package/dist/commands/update-version.d.cts

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

package/dist/commands/update-version.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

@@ -1 +1,35 @@
+import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
+import { MiniPackageJson } from '../packageJson';
+/**
+ * Sets the exit code to 1 and prints the error message to stderr.
+ * This is used to indicate an error condition in the script.
+ */
 export declare function error(...messages: unknown[]): void;
+/**
+ * Console error the messages and exits the process with code 1.
+ * This is used to indicate a fatal error that cannot be recovered from.
+ */
+export declare function exit(...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.json paths in the workspace,
+ * as resolved from workspaces in root package.json
+ */
+export declare function getWorkspacesPackagePaths(includeRootPackage?: boolean): Promise<string[]>;
+type PackageWalkerItem = {
+    path: string;
+    content: MiniPackageJson;
+};
+type PackageWalkerResult<T> = {
+    path: string;
+    content: T;
+};
+/**
+ * Walks through all workspace packages, calling the callback for each.
+ * If the callback returns a non-null value, it is included in the results.
+ * If the callback returns null or undefined, that package is not included in the results.
+ */
+export declare function workspacesPackageWalker<T = void>(callback: (item: PackageWalkerItem) => Promise<T | undefined> | T | undefined, includeRootPackage?: boolean): Promise<PackageWalkerResult<T>[]>;
+export {};

package/dist/commands/utils.d.ts

@@ -1 +1,35 @@
+import { ExecSyncOptionsWithStringEncoding } from 'node:child_process';
+import { MiniPackageJson } from '../packageJson';
+/**
+ * Sets the exit code to 1 and prints the error message to stderr.
+ * This is used to indicate an error condition in the script.
+ */
 export declare function error(...messages: unknown[]): void;
+/**
+ * Console error the messages and exits the process with code 1.
+ * This is used to indicate a fatal error that cannot be recovered from.
+ */
+export declare function exit(...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.json paths in the workspace,
+ * as resolved from workspaces in root package.json
+ */
+export declare function getWorkspacesPackagePaths(includeRootPackage?: boolean): Promise<string[]>;
+type PackageWalkerItem = {
+    path: string;
+    content: MiniPackageJson;
+};
+type PackageWalkerResult<T> = {
+    path: string;
+    content: T;
+};
+/**
+ * Walks through all workspace packages, calling the callback for each.
+ * If the callback returns a non-null value, it is included in the results.
+ * If the callback returns null or undefined, that package is not included in the results.
+ */
+export declare function workspacesPackageWalker<T = void>(callback: (item: PackageWalkerItem) => Promise<T | undefined> | T | undefined, includeRootPackage?: boolean): Promise<PackageWalkerResult<T>[]>;
+export {};

package/dist/index.cjs

@@ -1,26 +1,4 @@
 "use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const node_fs = require("node:fs");
 const promises = require("node:fs/promises");
@@ -30,6 +8,7 @@ const node_url = require("node:url");
 const posix = require("node:path/posix");
 const win32 = require("node:path/win32");
 const dts = require("vite-plugin-dts");
+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
@@ -192,8 +171,9 @@ function detectPackageManager(cwd = process.cwd()) {
   return packageManager;
 }
 function vitePresetPlugin({
-  externalize = [],
-  dtsOptions = {}
+  dtsOptions = {},
+  externalize,
+  bundleIn
 } = {
   externalize: [],
   dtsOptions: {}
@@ -222,22 +202,10 @@ function vitePresetPlugin({
         userConfig = config;
       }
     },
-    /**
-     * We use a dynamic import here because of how Rollup processes and transforms imports.
-     * This dependency (rollup-plugin-node-externals) will not be bundled into the output,
-     * as specified in vite.config.ts.
-     *
-     * rollup-plugin-node-externals is an ES module, and Stencil throws an error when it encounters
-     * a require() statement for an ES module.
-     *
-     * If we used a static import, Rollup's cjs build would transform it into a require() statement,
-     * causing Stencil to throw an error. Using a dynamic import prevents this issue.
-     */
-    import("rollup-plugin-node-externals").then(
-      ({ nodeExternals }) => nodeExternals({
-        include: externalize.map(stringToStartsWithGlob)
-      })
-    ),
+    externalizeDependencies({
+      externalize,
+      bundleIn
+    }),
     dts({
       logLevel: "warn",
       // Copies .d.ts files to d.cjs file for CommonJS.
@@ -252,6 +220,7 @@ function vitePresetPlugin({
             })
           );
         }
+        await dtsOptions?.afterBuild?.(emitted);
       },
       ...dtsOptions,
       compilerOptions: {
@@ -290,13 +259,53 @@ function vitePresetPlugin({
 function shouldSkip(id) {
   return id.includes("__test") || id.includes(".e2e.") || id.includes(".spec.") || id.includes(".test.") || id.includes(".stories.");
 }
-const stringToStartsWithGlob = (option) => option ? typeof option === "string" ? new RegExp(`^${option.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}`, "u") : option : void 0;
+function externalizeDependencies(options) {
+  const packageJson = retrievePackageJson();
+  const externalDependencies = Object.keys({
+    ...packageJson.dependencies,
+    ...packageJson.peerDependencies,
+    ...packageJson.optionalDependencies
+  });
+  const bundleIn = options.bundleIn?.map(stringToStartsWithGlob) ?? [];
+  const externalize = [
+    ...options.externalize?.map(stringToStartsWithGlob) ?? [],
+    ...externalDependencies.length > 0 ? [new RegExp(`^(?:${externalDependencies.join("|")})(?:/.+)?$`, "u")] : []
+  ];
+  const isExternalized = (id) => externalize.some((regex) => regex.test(id));
+  const isBundledIn = (id) => bundleIn.some((regex) => regex.test(id));
+  const plugin = {
+    name: "@arcgis/components-build-utils:externalize-dependencies",
+    apply: "build",
+    enforce: "pre",
+    resolveId(specifier, _, { isEntry }) {
+      if (
+        // Ignore entry points
+        isEntry || // Ignore virtual modules
+        specifier.startsWith("\0") || // Ignore relative
+        specifier.startsWith(".") || path.isAbsolute(specifier)
+      ) {
+        return null;
+      }
+      if (node_module.isBuiltin(specifier)) {
+        return {
+          id: specifier.startsWith("node:") ? specifier : `node:${specifier}`,
+          external: true,
+          moduleSideEffects: false
+        };
+      }
+      return isExternalized(specifier) && !isBundledIn(specifier) ? false : null;
+    }
+  };
+  return plugin;
+}
+const stringToStartsWithGlob = (option) => typeof option === "string" ? new RegExp(`^${option.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}(?:/.+)?$`, "u") : option;
 exports.asyncFindPath = asyncFindPath;
 exports.asyncRetrievePackageJson = asyncRetrievePackageJson;
 exports.createFileIfNotExists = createFileIfNotExists;
 exports.detectPackageManager = detectPackageManager;
 exports.existsAsync = existsAsync;
 exports.exportsForTests = exportsForTests;
+exports.externalizeDependencies = externalizeDependencies;
 exports.fetchPackageLocation = fetchPackageLocation;
 exports.findPath = findPath;
 exports.getCwd = getCwd;

package/dist/index.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import posix from "node:path/posix";
 import win32 from "node:path/win32";
 import dts from "vite-plugin-dts";
+import { isBuiltin } 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
@@ -168,8 +169,9 @@ function detectPackageManager(cwd = process.cwd()) {
   return packageManager;
 }
 function vitePresetPlugin({
-  externalize = [],
-  dtsOptions = {}
+  dtsOptions = {},
+  externalize,
+  bundleIn
 } = {
   externalize: [],
   dtsOptions: {}
@@ -198,22 +200,10 @@ function vitePresetPlugin({
         userConfig = config;
       }
     },
-    /**
-     * We use a dynamic import here because of how Rollup processes and transforms imports.
-     * This dependency (rollup-plugin-node-externals) will not be bundled into the output,
-     * as specified in vite.config.ts.
-     *
-     * rollup-plugin-node-externals is an ES module, and Stencil throws an error when it encounters
-     * a require() statement for an ES module.
-     *
-     * If we used a static import, Rollup's cjs build would transform it into a require() statement,
-     * causing Stencil to throw an error. Using a dynamic import prevents this issue.
-     */
-    import("rollup-plugin-node-externals").then(
-      ({ nodeExternals }) => nodeExternals({
-        include: externalize.map(stringToStartsWithGlob)
-      })
-    ),
+    externalizeDependencies({
+      externalize,
+      bundleIn
+    }),
     dts({
       logLevel: "warn",
       // Copies .d.ts files to d.cjs file for CommonJS.
@@ -228,6 +218,7 @@ function vitePresetPlugin({
             })
           );
         }
+        await dtsOptions?.afterBuild?.(emitted);
       },
       ...dtsOptions,
       compilerOptions: {
@@ -266,7 +257,46 @@ function vitePresetPlugin({
 function shouldSkip(id) {
   return id.includes("__test") || id.includes(".e2e.") || id.includes(".spec.") || id.includes(".test.") || id.includes(".stories.");
 }
-const stringToStartsWithGlob = (option) => option ? typeof option === "string" ? new RegExp(`^${option.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}`, "u") : option : void 0;
+function externalizeDependencies(options) {
+  const packageJson = retrievePackageJson();
+  const externalDependencies = Object.keys({
+    ...packageJson.dependencies,
+    ...packageJson.peerDependencies,
+    ...packageJson.optionalDependencies
+  });
+  const bundleIn = options.bundleIn?.map(stringToStartsWithGlob) ?? [];
+  const externalize = [
+    ...options.externalize?.map(stringToStartsWithGlob) ?? [],
+    ...externalDependencies.length > 0 ? [new RegExp(`^(?:${externalDependencies.join("|")})(?:/.+)?$`, "u")] : []
+  ];
+  const isExternalized = (id) => externalize.some((regex) => regex.test(id));
+  const isBundledIn = (id) => bundleIn.some((regex) => regex.test(id));
+  const plugin = {
+    name: "@arcgis/components-build-utils:externalize-dependencies",
+    apply: "build",
+    enforce: "pre",
+    resolveId(specifier, _, { isEntry }) {
+      if (
+        // Ignore entry points
+        isEntry || // Ignore virtual modules
+        specifier.startsWith("\0") || // Ignore relative
+        specifier.startsWith(".") || path.isAbsolute(specifier)
+      ) {
+        return null;
+      }
+      if (isBuiltin(specifier)) {
+        return {
+          id: specifier.startsWith("node:") ? specifier : `node:${specifier}`,
+          external: true,
+          moduleSideEffects: false
+        };
+      }
+      return isExternalized(specifier) && !isBundledIn(specifier) ? false : null;
+    }
+  };
+  return plugin;
+}
+const stringToStartsWithGlob = (option) => typeof option === "string" ? new RegExp(`^${option.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}(?:/.+)?$`, "u") : option;
 export {
   asyncFindPath,
   asyncRetrievePackageJson,
@@ -274,6 +304,7 @@ export {
   detectPackageManager,
   existsAsync,
   exportsForTests,
+  externalizeDependencies,
   fetchPackageLocation,
   findPath,
   getCwd,

package/dist/packageJson.d.cts

@@ -9,6 +9,7 @@ export type MiniPackageJson = {
     "version": string;
     "private"?: boolean;
     "type"?: "commonjs" | "module";
+    "workspaces"?: string[];
     "publishConfig"?: {
         access?: string;
         registry?: string;
@@ -20,6 +21,7 @@ export type MiniPackageJson = {
     "peerDependenciesMeta"?: Record<string, {
         optional?: boolean;
     }>;
+    "optionalDependencies"?: Record<string, string | undefined>;
     "css.customData"?: string[];
     "customElements"?: string;
     "html.customData"?: string[];

package/dist/packageJson.d.ts

@@ -9,6 +9,7 @@ export type MiniPackageJson = {
     "version": string;
     "private"?: boolean;
     "type"?: "commonjs" | "module";
+    "workspaces"?: string[];
     "publishConfig"?: {
         access?: string;
         registry?: string;
@@ -20,6 +21,7 @@ export type MiniPackageJson = {
     "peerDependenciesMeta"?: Record<string, {
         optional?: boolean;
     }>;
+    "optionalDependencies"?: Record<string, string | undefined>;
     "css.customData"?: string[];
     "customElements"?: string;
     "html.customData"?: string[];

package/dist/vite.d.cts

@@ -2,23 +2,79 @@ import { Plugin } from 'vite';
 import { default as dts } from 'vite-plugin-dts';
 /**
  * Vite preset for all our support packages:
- * - externalizes all devDependencies (using `rollup-plugin-node-externals`)
+ * - externalizes all non-dev-dependencies
  * - generates type declarations (using `vite-plugin-dts`)
  */
-export declare function vitePresetPlugin({ externalize, dtsOptions, }?: {
-    /** The list of dependencies to externalize besides devDependencies */
-    externalize?: string[];
+export declare function vitePresetPlugin({ dtsOptions, externalize, bundleIn, }?: DependencyManagementOptions & {
     /** Additional options for `vite-plugin-dts` */
     dtsOptions?: Parameters<typeof dts>[0];
-}): [Plugin, Promise<Plugin>, Plugin];
+}): [Plugin, Plugin, Plugin];
 /**
- * By default this plugin converts string values to RegExp that only matches if
- * path is "equal" not "starts with", which is not intuitive.
+ * Options for externalizing dependencies.
+ */
+export type DependencyManagementOptions = {
+    /**
+     * Force bundle in these dependencies even if they are declared as
+     * dependencies or peerDependencies.
+     *
+     * @example
+     * This is desirable if you wish to control the version of a dependency or
+     * need to post-process the dependency in some way. Usually, you will declare
+     * such as a devDependency, but there is a use case for declaring it as a
+     * dependency instead:
+     *
+     * - If TypeScript types from the bundled in dependencies are referenced in
+     *   the `.d.ts` files of your library, you will need to declare the package
+     *   as a `dependency`, so that it is still installed on the consumer's
+     *   computer so that TypeScript can correctly resolve the types of that
+     *   library.
+     */
+    readonly bundleIn?: (RegExp | string)[];
+    /**
+     * Force externalize these dependencies, even if they are declared as
+     * devDependencies.
+     *
+     * @example
+     * This is desirable if you are sure the end user will have these dependencies
+     * available, yet do not wish to declare these as devDependencies for some
+     * technical reasons.
+     */
+    readonly externalize?: (RegExp | string)[];
+};
+/**
+ * By default, Rollup will bundle-in all dependencies.
+ *
+ * We change it as follows:
+ * Externalize all packages that are defined as
+ * "dependency" or "peerDependency" in the package.json.
+ * If you wish to bundle-in some package, define it as a "devDependency".
+ *
+ * Bundling-in packages is not recommended because:
+ * - it makes our build take longer
+ * - it pushes larger packages to NPM
+ * - user of our library is locked into the version of the package we bundled in
+ * - if user has two packages using the same library, there will be two copies
+ *   served on the page
+ * - It may break some libraries/prevent them from optimizing correctly
+ *   depending on the production/development mode, or prevent them from loading
+ *   correct code depending on browser/node.js environment.
  *
- * I.e, this would only exclude "monaco-editor", not any
- * "monaco-editor/sub-path" by default:
- * "bundleIn": ["monaco-editor"]
+ *   For example, see this statement from Lit:
+ *   https://lit.dev/docs/ssr/authoring/#:~:text=Don%27t%20bundle%20Lit,based%20on%20environment.
+ *
+ * @see {@link ./buildCdn.ts} for CDN dependency bundling details
+ *
+ * @remarks
+ * If a dependency is both a peerDependency and a devDependency, it will still
+ * be externalized (because all peerDependencies are externalized).
+ */
+export declare function externalizeDependencies(options: DependencyManagementOptions): Plugin;
+/**
+ * Convert a string value to a RegExp that matches any import specifier that
+ * starts with the given string.
  *
- * We fix it to match using "starts with" instead
+ * @example
+ * "monaco-editor" will create a regex that matches "monaco-editor" and
+ * "monaco-editor/sub-path", but not "monaco-editor-beta".
  */
-export declare const stringToStartsWithGlob: (option: RegExp | string | false | null | undefined) => RegExp | undefined;
+export declare const stringToStartsWithGlob: (option: RegExp | string) => RegExp;

package/dist/vite.d.ts

@@ -2,23 +2,79 @@ import { Plugin } from 'vite';
 import { default as dts } from 'vite-plugin-dts';
 /**
  * Vite preset for all our support packages:
- * - externalizes all devDependencies (using `rollup-plugin-node-externals`)
+ * - externalizes all non-dev-dependencies
  * - generates type declarations (using `vite-plugin-dts`)
  */
-export declare function vitePresetPlugin({ externalize, dtsOptions, }?: {
-    /** The list of dependencies to externalize besides devDependencies */
-    externalize?: string[];
+export declare function vitePresetPlugin({ dtsOptions, externalize, bundleIn, }?: DependencyManagementOptions & {
     /** Additional options for `vite-plugin-dts` */
     dtsOptions?: Parameters<typeof dts>[0];
-}): [Plugin, Promise<Plugin>, Plugin];
+}): [Plugin, Plugin, Plugin];
 /**
- * By default this plugin converts string values to RegExp that only matches if
- * path is "equal" not "starts with", which is not intuitive.
+ * Options for externalizing dependencies.
+ */
+export type DependencyManagementOptions = {
+    /**
+     * Force bundle in these dependencies even if they are declared as
+     * dependencies or peerDependencies.
+     *
+     * @example
+     * This is desirable if you wish to control the version of a dependency or
+     * need to post-process the dependency in some way. Usually, you will declare
+     * such as a devDependency, but there is a use case for declaring it as a
+     * dependency instead:
+     *
+     * - If TypeScript types from the bundled in dependencies are referenced in
+     *   the `.d.ts` files of your library, you will need to declare the package
+     *   as a `dependency`, so that it is still installed on the consumer's
+     *   computer so that TypeScript can correctly resolve the types of that
+     *   library.
+     */
+    readonly bundleIn?: (RegExp | string)[];
+    /**
+     * Force externalize these dependencies, even if they are declared as
+     * devDependencies.
+     *
+     * @example
+     * This is desirable if you are sure the end user will have these dependencies
+     * available, yet do not wish to declare these as devDependencies for some
+     * technical reasons.
+     */
+    readonly externalize?: (RegExp | string)[];
+};
+/**
+ * By default, Rollup will bundle-in all dependencies.
+ *
+ * We change it as follows:
+ * Externalize all packages that are defined as
+ * "dependency" or "peerDependency" in the package.json.
+ * If you wish to bundle-in some package, define it as a "devDependency".
+ *
+ * Bundling-in packages is not recommended because:
+ * - it makes our build take longer
+ * - it pushes larger packages to NPM
+ * - user of our library is locked into the version of the package we bundled in
+ * - if user has two packages using the same library, there will be two copies
+ *   served on the page
+ * - It may break some libraries/prevent them from optimizing correctly
+ *   depending on the production/development mode, or prevent them from loading
+ *   correct code depending on browser/node.js environment.
  *
- * I.e, this would only exclude "monaco-editor", not any
- * "monaco-editor/sub-path" by default:
- * "bundleIn": ["monaco-editor"]
+ *   For example, see this statement from Lit:
+ *   https://lit.dev/docs/ssr/authoring/#:~:text=Don%27t%20bundle%20Lit,based%20on%20environment.
+ *
+ * @see {@link ./buildCdn.ts} for CDN dependency bundling details
+ *
+ * @remarks
+ * If a dependency is both a peerDependency and a devDependency, it will still
+ * be externalized (because all peerDependencies are externalized).
+ */
+export declare function externalizeDependencies(options: DependencyManagementOptions): Plugin;
+/**
+ * Convert a string value to a RegExp that matches any import specifier that
+ * starts with the given string.
  *
- * We fix it to match using "starts with" instead
+ * @example
+ * "monaco-editor" will create a regex that matches "monaco-editor" and
+ * "monaco-editor/sub-path", but not "monaco-editor-beta".
  */
-export declare const stringToStartsWithGlob: (option: RegExp | string | false | null | undefined) => RegExp | undefined;
+export declare const stringToStartsWithGlob: (option: RegExp | string) => RegExp;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/components-build-utils",
-  "version": "4.34.0-next.8",
+  "version": "4.34.0-next.81",
   "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,14 +22,15 @@
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@commander-js/extra-typings": "^11.1.0",
-    "chalk": "^5.3.0",
-    "commander": "^11.1.0",
-    "glob": "^11.0.0",
-    "rollup-plugin-node-externals": "^8.0.0",
+    "@commander-js/extra-typings": "^14.0.0",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "fast-xml-parser": "^5.2.5",
+    "glob": "^11.0.3",
+    "semver": "^7.7.2",
     "split2": "^4.2.0",
     "tslib": "^2.8.1",
-    "vite": "^6.3.4",
-    "vite-plugin-dts": "^4.5.3"
+    "vite": "^7.0.0",
+    "vite-plugin-dts": "^4.5.4"
   }
 }

package/src/commands/run-wrapper.js

@@ -1,16 +1,6 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { join } from "node:path";
-
-const scriptPath = join(import.meta.dirname, "run.ts");
-const commandArguments = process.argv.slice(2);
-
-const child = spawn("npx", ["tsx", scriptPath, ...commandArguments], {
-  stdio: "inherit",
-  shell: true,
-});
-
-// Forward the exit code
-child.on("exit", function (code) {
-  process.exit(code);
-});
+// 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");