quickbundle 2.2.0 → 2.3.0

package/README.md

@@ -34,6 +34,33 @@ yarn add quickbundle
 
 2️⃣ Set up your package configuration (`package.json`):
 
+-   When exporting both CommonJS (CJS) and ECMAScript Modules (ESM) format:
+
+```jsonc
+{
+	"name": "lib", // Package name
+	"exports": {
+		".": {
+			"source": "src/index.ts(x)?", // Source code entrypoint
+			"types": "./dist/index.d.ts", // Typing output file (if defined, can increase build time)
+			"import": "./dist/index.mjs", // ESM output file (matches when the package is loaded via import or import() consumer side)
+			"require": "./dist/index.cjs", // CommonJS output file (matches when the module is loaded via require() consumer side)
+			"default": "./dist/index.mjs", // The generic fallback that always matches (this condition should always come last). By default, Quickbundle will always output ESM format for the `default` field. However, take care: if both `import` and `default` fields are defined, provide the same file path, as the `import` field export instruction will be the only one considered to define the output file path.
+		},
+		"./otherSubModule": {
+			// ...
+		}
+	}
+	"scripts": {
+		"build": "quickbundle build", // Production mode (optimizes bundle)
+		"watch": "quickbundle watch", // Development mode (watches each file change)
+	},
+	// ...
+}
+```
+
+-   When exporting exclusively ESM format:
+
 ```jsonc
 {
 	"name": "lib", // Package name
@@ -41,8 +68,10 @@ yarn add quickbundle
 		".": {
 			"source": "src/index.ts(x)?", // Source code entrypoint
 			"types": "./dist/index.d.ts", // Typing output file (if defined, can increase build time)
-			"import": "./dist/index.mjs", // ESM output file
-			"require": "./dist/index.cjs" // CommonJS output file
+			"default": "./dist/index.js", // The generic fallback that always matches (this condition should always come last). By default, Quickbundle will always output ESM format for the `default` field. However, take care: if both `import` and `default` fields are defined, provide the same file path, as the `import` field export instruction will be the only one considered to define the output file path.
+		},
+		"./otherSubModule": {
+			// ...
 		}
 	}
 	"scripts": {

package/dist/index.js

@@ -69,6 +69,7 @@ const createConfigurations = (options = {
         throw new Error("Invalid package entry points contract. Use the recommended [`exports` field](https://nodejs.org/api/packages.html#package-entry-points) instead and, for TypeScript-based projects, update the `tsconfig.json` file to resolve it properly (`moduleResolution` must be set to `Bundler` (or `NodeNext`)).");
     }
     const outputEntryPointFields = [
+        "default",
         "import",
         "require",
         "types"
@@ -127,14 +128,18 @@ const getPlugins = (...customPlugins)=>{
 };
 const createMainConfig = (entryPoints, options)=>{
     const { minification, sourceMaps } = options;
+    const esmInput = entryPoints.import ?? entryPoints.default;
+    if (entryPoints.import && entryPoints.default && entryPoints.import !== entryPoints.default) {
+        throw new Error("Both `import` and `default` export fields have been defined but with different values. To preserve proper `default` field resolution on the consumer side, make sure to provide the same file path for both fields, as the `import` field export instruction will be the only one considered to define the output file path.");
+    }
     const output = [
         entryPoints.require && {
             file: entryPoints.require,
             format: "cjs",
             sourcemap: sourceMaps
         },
-        entryPoints.import && {
-            file: entryPoints.import,
+        esmInput && {
+            file: esmInput,
             format: "es",
             sourcemap: sourceMaps
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickbundle",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "The zero-configuration transpiler and bundler for the web",
   "author": {
     "name": "Ayoub Adib",