@nx/esbuild 21.4.0-canary.20250808-c60258e → 21.4.0-canary.20250812-d2a0593

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/esbuild",
-  "version": "21.4.0-canary.20250808-c60258e",
+  "version": "21.4.0-canary.20250812-d2a0593",
   "private": false,
   "description": "The Nx Plugin for esbuild contains executors and generators that support building applications using esbuild",
   "repository": {
@@ -31,15 +31,15 @@
     "migrations": "./migrations.json"
   },
   "dependencies": {
-    "@nx/devkit": "21.4.0-canary.20250808-c60258e",
-    "@nx/js": "21.4.0-canary.20250808-c60258e",
+    "@nx/devkit": "21.4.0-canary.20250812-d2a0593",
+    "@nx/js": "21.4.0-canary.20250812-d2a0593",
     "tinyglobby": "^0.2.12",
     "picocolors": "^1.1.0",
     "tsconfig-paths": "^4.1.2",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "nx": "21.4.0-canary.20250808-c60258e"
+    "nx": "21.4.0-canary.20250812-d2a0593"
   },
   "peerDependencies": {
     "esbuild": ">=0.19.2 <1.0.0"

package/src/executors/esbuild/esbuild.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild.impl.d.ts","sourceRoot":"","sources":["../../../../../../packages/esbuild/src/executors/esbuild/esbuild.impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmBlD,OAAO,EACL,sBAAsB,EAEvB,MAAM,UAAU,CAAC;AAwBlB,wBAAuB,eAAe,CACpC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,eAAe;aAmEuB,OAAO;cAAY,MAAM;aA6GzE;AAkED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"esbuild.impl.d.ts","sourceRoot":"","sources":["../../../../../../packages/esbuild/src/executors/esbuild/esbuild.impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmBlD,OAAO,EACL,sBAAsB,EAEvB,MAAM,UAAU,CAAC;AAwBlB,wBAAuB,eAAe,CACpC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,eAAe;aAqEuB,OAAO;cAAY,MAAM;aA6GzE;AAkED,eAAe,eAAe,CAAC"}

package/src/executors/esbuild/esbuild.impl.js

@@ -45,10 +45,12 @@ async function* esbuildExecutor(_options, context) {
         }
         const cpjOptions = {
             ...options,
+            format: options.format,
             // TODO(jack): make types generate with esbuild
             skipTypings: true,
             generateLockfile: true,
-            outputFileExtensionForCjs: (0, build_esbuild_options_1.getOutExtension)('cjs', options),
+            outputFileExtensionForCjs: (0, build_esbuild_options_1.getOutExtension)('cjs', options, context),
+            outputFileExtensionForEsm: (0, build_esbuild_options_1.getOutExtension)('esm', options, context),
             excludeLibsInPackageJson: !options.thirdParty,
             // TODO(jack): Remove the need to pass updateBuildableProjectDepsInPackageJson option when overrideDependencies or extraDependencies are passed.
             // Add this back to fix a regression.

package/src/executors/esbuild/lib/build-esbuild-options.d.ts

@@ -8,7 +8,7 @@ export declare function buildEsbuildOptions(format: 'cjs' | 'esm', options: Norm
  * @param context ExecutorContext
  */
 export declare function createPathsFromTsConfigReferences(context: ExecutorContext): Record<string, string[]>;
-export declare function getOutExtension(format: 'cjs' | 'esm', options: Pick<NormalizedEsBuildExecutorOptions, 'userDefinedBuildOptions'>): '.cjs' | '.mjs' | '.js';
+export declare function getOutExtension(format: 'cjs' | 'esm', options: Pick<NormalizedEsBuildExecutorOptions, 'userDefinedBuildOptions'>, context?: ExecutorContext): '.cjs' | '.mjs' | '.js';
 export declare function getOutfile(format: 'cjs' | 'esm', options: NormalizedEsBuildExecutorOptions, context: ExecutorContext): string;
-export declare function getRegisterFileContent(project: ProjectGraphProjectNode, paths: Record<string, string[]>, mainFile: string, outExtension?: string): string;
+export declare function getRegisterFileContent(project: ProjectGraphProjectNode, paths: Record<string, string[]>, mainFile: string, outExtension?: string, format?: 'cjs' | 'esm'): string;
 //# sourceMappingURL=build-esbuild-options.d.ts.map

package/src/executors/esbuild/lib/build-esbuild-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-esbuild-options.d.ts","sourceRoot":"","sources":["../../../../../../../packages/esbuild/src/executors/esbuild/lib/build-esbuild-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,OAAO,EACL,eAAe,EAGf,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gCAAgC,EAAE,MAAM,WAAW,CAAC;AAO7D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAuGtB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAmE1B;AAoDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,IAAI,CAAC,gCAAgC,EAAE,yBAAyB,CAAC,GACzE,MAAM,GAAG,MAAM,GAAG,KAAK,CAYzB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,eAAe,UASzB;AAiDD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAQ,UAqFrB"}
+{"version":3,"file":"build-esbuild-options.d.ts","sourceRoot":"","sources":["../../../../../../../packages/esbuild/src/executors/esbuild/lib/build-esbuild-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,OAAO,EACL,eAAe,EAGf,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gCAAgC,EAAE,MAAM,WAAW,CAAC;AAO7D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CA6GtB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAmE1B;AAoDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,IAAI,CAAC,gCAAgC,EAAE,yBAAyB,CAAC,EAC1E,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,GAAG,MAAM,GAAG,KAAK,CAazB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,eAAe,UASzB;AAkDD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAQ,EACpB,MAAM,GAAE,KAAK,GAAG,KAAa,UAyI9B"}

package/src/executors/esbuild/lib/build-esbuild-options.js

@@ -14,7 +14,7 @@ const path_1 = require("path");
 const ESM_FILE_EXTENSION = '.js';
 const CJS_FILE_EXTENSION = '.cjs';
 function buildEsbuildOptions(format, options, context) {
-    const outExtension = getOutExtension(format, options);
+    const outExtension = getOutExtension(format, options, context);
     const esbuildOptions = {
         ...options.userDefinedBuildOptions,
         entryNames: options.outputHashing === 'all' ? '[dir]/[name].[hash]' : '[dir]/[name]',
@@ -60,7 +60,7 @@ function buildEsbuildOptions(format, options, context) {
     }
     else if (options.platform === 'node' && format === 'cjs') {
         // When target platform Node and target format is CJS, then also transpile workspace libs used by the app.
-        // Provide a `require` override in the main entry file so workspace libs can be loaded when running the app.
+        // Provide a loader override in the main entry file so workspace libs can be loaded when running the app.
         const paths = options.isTsSolutionSetup
             ? createPathsFromTsConfigReferences(context)
             : getTsConfigCompilerPaths(context);
@@ -71,7 +71,7 @@ function buildEsbuildOptions(format, options, context) {
         });
         esbuildOptions.entryPoints = [
             // Write a main entry file that registers workspace libs and then calls the user-defined main.
-            writeTmpEntryWithRequireOverrides(paths, outExtension, options, context),
+            writeTmpEntryWithRequireOverrides(paths, outExtension, options, context, format),
             ...entryPointsFromProjects.map((f) => {
                 /**
                  * Maintain same directory structure as the workspace, so that other workspace libs may be used by the project.
@@ -187,7 +187,7 @@ function getProjectEntryPoint(projectPkgJson, projectPath) {
     }
     return entryPoint;
 }
-function getOutExtension(format, options) {
+function getOutExtension(format, options, context) {
     const userDefinedExt = options.userDefinedBuildOptions?.outExtension?.['.js'];
     // Allow users to change the output extensions from default CJS and ESM extensions.
     // CJS -> .js
@@ -201,12 +201,12 @@ function getOutExtension(format, options) {
                 : CJS_FILE_EXTENSION;
 }
 function getOutfile(format, options, context) {
-    const ext = getOutExtension(format, options);
+    const ext = getOutExtension(format, options, context);
     const candidate = (0, devkit_1.joinPathFragments)(context.target.options.outputPath, options.outputFileName);
     const { dir, name } = path.parse(candidate);
     return `${dir}/${name}${ext}`;
 }
-function writeTmpEntryWithRequireOverrides(paths, outExtension, options, context) {
+function writeTmpEntryWithRequireOverrides(paths, outExtension, options, context, format = 'cjs') {
     const project = context.projectGraph?.nodes[context.projectName];
     // Write a temp main entry source that registers workspace libs.
     const tmpPath = path.join(context.root, 'tmp', project.name);
@@ -214,7 +214,7 @@ function writeTmpEntryWithRequireOverrides(paths, outExtension, options, context
     const { name: mainFileName, dir: mainPathRelativeToDist } = path.parse(options.main);
     const mainWithRequireOverridesInPath = path.join(tmpPath, `main-with-require-overrides.js`);
     const mainFile = `./${path.join(mainPathRelativeToDist, `${mainFileName}${outExtension}`)}`;
-    (0, fs_1.writeFileSync)(mainWithRequireOverridesInPath, getRegisterFileContent(project, paths, mainFile, outExtension));
+    (0, fs_1.writeFileSync)(mainWithRequireOverridesInPath, getRegisterFileContent(project, paths, mainFile, outExtension, format));
     let mainWithRequireOverridesOutPath;
     if (options.outputFileName) {
         mainWithRequireOverridesOutPath = path.parse(options.outputFileName).name;
@@ -232,7 +232,7 @@ function writeTmpEntryWithRequireOverrides(paths, outExtension, options, context
         out: mainWithRequireOverridesOutPath,
     };
 }
-function getRegisterFileContent(project, paths, mainFile, outExtension = '.js') {
+function getRegisterFileContent(project, paths, mainFile, outExtension = '.js', format = 'cjs') {
     mainFile = (0, devkit_1.normalizePath)(mainFile);
     // Sort by longest prefix so imports match the most specific path.
     const sortedKeys = Object.keys(paths).sort((a, b) => getPrefixLength(b) - getPrefixLength(a));
@@ -250,7 +250,59 @@ function getRegisterFileContent(project, paths, mainFile, outExtension = '.js')
         acc.push({ module: k, exactMatch, pattern });
         return acc;
     }, []);
-    return `
+    if (format === 'esm') {
+        return `
+/**
+ * IMPORTANT: Do not modify this file.
+ * This file allows the app to run without bundling in workspace libraries.
+ * Must be contained in the ".nx" folder inside the output path.
+ */
+import { pathToFileURL } from 'node:url';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const distPath = __dirname;
+const manifest = ${JSON.stringify(manifest)};
+
+// Resolver for workspace libs
+const originalResolve = import.meta.resolve;
+if (originalResolve) {
+  import.meta.resolve = function(specifier, parent) {
+    const matchingEntry = manifest.find(
+      (entry) => specifier === entry.module || specifier.startsWith(entry.module + '/')
+    );
+    
+    if (matchingEntry) {
+      if (matchingEntry.exactMatch) {
+        const candidate = join(distPath, matchingEntry.exactMatch);
+        if (existsSync(candidate)) {
+          return pathToFileURL(candidate).href;
+        }
+      } else {
+        const re = new RegExp(matchingEntry.module.replace(/\\*$/, "(?<rest>.*)"));
+        const match = specifier.match(re);
+        if (match?.groups) {
+          const candidate = join(distPath, matchingEntry.pattern.replace("*", ""), match.groups.rest);
+          if (existsSync(candidate)) {
+            return pathToFileURL(candidate).href;
+          }
+        }
+      }
+    }
+    
+    return originalResolve.call(this, specifier, parent);
+  };
+}
+
+// Call the user-defined main.
+await import(pathToFileURL(join(distPath, '${mainFile}')).href);
+`;
+    }
+    else {
+        return `
 /**
  * IMPORTANT: Do not modify this file.
  * This file allows the app to run without bundling in workspace libraries.
@@ -306,6 +358,7 @@ function isFile(s) {
 // Call the user-defined main.
 module.exports = require('${mainFile}');
 `;
+    }
 }
 function getPrefixLength(pattern) {
     const prefixIfWildcard = pattern.substring(0, pattern.indexOf('*')).length;
@@ -317,8 +370,12 @@ function getPrefixLength(pattern) {
     return prefixIfWildcard || prefixWithoutWildcard;
 }
 function getTsConfigCompilerPaths(context) {
+    const rootTsConfigPath = getRootTsConfigPath(context);
+    if (!rootTsConfigPath) {
+        return {};
+    }
     const tsconfigPaths = require('tsconfig-paths');
-    const tsConfigResult = tsconfigPaths.loadConfig(getRootTsConfigPath(context));
+    const tsConfigResult = tsconfigPaths.loadConfig(rootTsConfigPath);
     if (tsConfigResult.resultType !== 'success') {
         throw new Error('Cannot load tsconfig file');
     }
@@ -331,5 +388,5 @@ function getRootTsConfigPath(context) {
             return tsConfigPath;
         }
     }
-    throw new Error('Could not find a root tsconfig.json or tsconfig.base.json file.');
+    return null;
 }