jquery · mgol · Mar 11, 2024 · Feb 24, 2024 · Feb 29, 2024 · Mar 2, 2024
diff --git a/.gitignore b/.gitignore
@@ -9,13 +9,16 @@
 .sizecache.json
 yarn.lock
 .eslintcache
+tmp
 
 npm-debug.log*
 
 # Ignore everything in `dist` folder except for
 # the ESLint config & package.json files
 /dist/*
 !/dist/package.json
+!/dist/jquery.bundler-require-wrapper.js
+!/dist/jquery.bundler-require-wrapper.slim.js
 
 # Ignore everything in the `dist-module` folder except for the ESLint config,
 # package.json & Node module wrapper files

diff --git a/build/fixtures/README.md b/build/fixtures/README.md
@@ -120,6 +120,8 @@ If you need to use jQuery in a file that's not an ECMAScript module, you can use
 const $ = require( "jquery" );
 ```
 
+The CommonJS module _does not_ expose named `$` & `jQuery` exports.
+
 #### Individual modules
 
 jQuery is authored in ECMAScript modules; it's also possible to use them directly. They are contained in the `src/` folder; inspect the package contents to see what's there. Full file names are required, including the `.js` extension.

diff --git a/build/release/dist.js b/build/release/dist.js
@@ -17,6 +17,8 @@ module.exports = function( Release, files, complete ) {
 		"LICENSE.txt",
 		"AUTHORS.txt",
 		"dist/package.json",
+		"dist/jquery.bundler-require-wrapper.js",
+		"dist/jquery.bundler-require-wrapper.slim.js",
 		"dist-module/package.json",
 		"dist-module/jquery.node-module-wrapper.js",
 		"dist-module/jquery.node-module-wrapper.slim.js"

diff --git a/build/tasks/node_smoke_tests.js b/build/tasks/node_smoke_tests.js
@@ -5,8 +5,8 @@ const util = require( "node:util" );
 const exec = util.promisify( require( "node:child_process" ).exec );
 const verifyNodeVersion = require( "./lib/verifyNodeVersion" );
 
-const allowedLibraryTypes = [ "regular", "factory" ];
-const allowedSourceTypes = [ "commonjs", "module" ];
+const allowedLibraryTypes = new Set( [ "regular", "factory" ] );
+const allowedSourceTypes = new Set( [ "commonjs", "module", "dual" ] );
 
 if ( !verifyNodeVersion() ) {
 	return;
@@ -19,8 +19,8 @@ if ( !verifyNodeVersion() ) {
 // each other, e.g. so that they don't share the `require` cache.
 
 async function runTests( { libraryType, sourceType, module } ) {
-	if ( !allowedLibraryTypes.includes( libraryType ) ||
-			!allowedSourceTypes.includes( sourceType ) ) {
+	if ( !allowedLibraryTypes.has( libraryType ) ||
+			!allowedSourceTypes.has( sourceType ) ) {
 		throw new Error( `Incorrect libraryType or sourceType value; passed: ${
 			libraryType
 		} ${ sourceType } "${ module }"` );
@@ -127,6 +127,28 @@ async function runDefaultTests() {
 			libraryType: "factory",
 			sourceType: "module",
 			module: "./dist-module/jquery.factory.slim.module.js"
+		} ),
+
+		runTests( {
+			libraryType: "regular",
+			sourceType: "dual",
+			module: "jquery"
+		} ),
+		runTests( {
+			libraryType: "regular",
+			sourceType: "dual",
+			module: "jquery/slim"
+		} ),
+
+		runTests( {
+			libraryType: "factory",
+			sourceType: "dual",
+			module: "jquery/factory"
+		} ),
+		runTests( {
+			libraryType: "factory",
+			sourceType: "dual",
+			module: "jquery/factory-slim"
 		} )
 	] );
 }

diff --git a/dist-module/jquery.node-module-wrapper.js b/dist-module/jquery.node-module-wrapper.js
@@ -1,4 +1,5 @@
+// Node.js is able to import from a CommonJS module in an ESM one.
 import jQuery from "../dist/jquery.js";
-const $ = jQuery;
-export { jQuery, $ };
+
+export { jQuery, jQuery as $ };
 export default jQuery;
diff --git a/dist-module/jquery.node-module-wrapper.slim.js b/dist-module/jquery.node-module-wrapper.slim.js
@@ -1,4 +1,5 @@
+// Node.js is able to import from a CommonJS module in an ESM one.
 import jQuery from "../dist/jquery.slim.js";
-const $ = jQuery;
-export { jQuery, $ };
+
+export { jQuery, jQuery as $ };
 export default jQuery;
diff --git a/dist/jquery.bundler-require-wrapper.js b/dist/jquery.bundler-require-wrapper.js
@@ -0,0 +1,5 @@
+"use strict";
+
+// Bundlers are able to synchronously require an ESM module from a CommonJS one.
+const { jQuery } = require( "../dist-module/jquery.module.js" );
+module.exports = jQuery;
diff --git a/dist/jquery.bundler-require-wrapper.slim.js b/dist/jquery.bundler-require-wrapper.slim.js
@@ -0,0 +1,5 @@
+"use strict";
+
+// Bundlers are able to synchronously require an ESM module from a CommonJS one.
+const { jQuery } = require( "../dist-module/jquery.slim.module.js" );
+module.exports = jQuery;
diff --git a/eslint.config.js b/eslint.config.js
@@ -10,6 +10,7 @@ export default [
 		// See https://github.com/eslint/eslint/discussions/17412
 		ignores: [
 			"external",
+			"**/tmp",
 			"test/data/json_obj.js"
 		]
 	},
@@ -18,8 +19,8 @@ export default [
 		files: [
 			"eslint.config.js",
 			"Gruntfile.cjs",
-			"test/node_smoke_tests/commonjs/**",
-			"test/node_smoke_tests/module/**",
+			"test/bundler_smoke_tests/**/*",
+			"test/node_smoke_tests/**",
 			"test/promises_aplus_adapters/**",
 			"test/middleware-mockserver.cjs"
 		],
@@ -260,8 +261,8 @@ export default [
 
 	{
 		files: [
-			"test/node_smoke_tests/commonjs/**",
-			"test/node_smoke_tests/module/**",
+			"test/bundler_smoke_tests/**",
+			"test/node_smoke_tests/**",
 			"test/promises_aplus_adapters/**",
 			"test/middleware-mockserver.cjs"
 		],
@@ -317,7 +318,25 @@ export default [
 
 		languageOptions: {
 			globals: {
-				...globals.browser,
+				...globals.es2021,
+				define: false,
+				module: false,
+				Symbol: false
+			}
+		}
+	},
+
+	{
+		files: [
+			"dist/jquery.bundler-require-wrapper.js",
+			"dist/jquery.bundler-require-wrapper.slim.js",
+			"dist-module/jquery.node-module-wrapper.js",
+			"dist-module/jquery.node-module-wrapper.slim.js"
+		],
+
+		languageOptions: {
+			globals: {
+				...globals.node,
 				...globals.es2021,
 				define: false,
 				module: false,