quickbundle 0.0.0-next-5441a21 → 0.0.0-next-800b69a

package/README.md

@@ -11,11 +11,14 @@
 Quickbundle allows you to bundle a library in a **quick**, **fast** and **easy** way:
 
 - Fast build and watch mode powered by Rollup[^1] and SWC[^2].
+- Compile mode to create a standalone binary for systems that do not have Node.js installed (relies on [Node.js single executable applications feature](https://nodejs.org/api/single-executable-applications.html)).
 - Zero configuration: define the build artifacts in your `package.json`, and you're all set!
 - Support of `cjs` & `esm` module formats output.
 - Support of several loaders including JavaScript, TypeScript, JSX, JSON, and Images.
 - TypeScript's declaration file (`.d.ts`) bundling.
-- Automatic dependency inclusion (`peerDependencies` and `dependencies` are not bundled in the final output, `devDependencies` are unless they're not imported).
+- Automatic dependency inclusion:
+  - For the build/watch mode, `peerDependencies` and `dependencies` are not bundled in the final output, `devDependencies` are unless they're not imported.
+  - For the compile mode: all dependencies are included to make the code standalone.
 
 [^1]: A [module bundler](https://rollupjs.org/) optimized for better tree-shaking processing and seamless interoperability of CommonJS and ESM formats with minimal code footprint.
 
@@ -38,6 +41,9 @@ yarn add quickbundle
 
 2️⃣ Set up your package configuration (`package.json`):
 
+<details>
+<summary><strong>For building libraries</strong></summary>
+
 - When exporting exclusively ESM format:
 
 ```jsonc
@@ -53,8 +59,8 @@ yarn add quickbundle
 		},
 		"./otherModulePath": {
 			// ...
-		}
-	}
+		},
+	},
 	"scripts": {
 		"build": "quickbundle build", // Production mode (optimizes bundle)
 		"watch": "quickbundle watch", // Development mode (watches each file change)
@@ -80,8 +86,8 @@ yarn add quickbundle
 		},
 		"./otherModulePath": {
 			// ...
-		}
-	}
+		},
+	},
 	"scripts": {
 		"build": "quickbundle build", // Production mode (optimizes bundle)
 		"watch": "quickbundle watch", // Development mode (watches each file change)
@@ -90,6 +96,31 @@ yarn add quickbundle
 }
 ```
 
+</details>
+
+<details>
+<summary><strong>For compiling single executable applications</strong></summary>
+
+```jsonc
+{
+	"name": "lib", // Package name
+	"source": "./src/index.ts", // Source code entry point. Make sure that it starts with `#!/usr/bin/env node` pragme to make the binary portable for consumers who would like to use it by installing the package instead of using the generated standalone executable.
+	"bin": {
+		"your-binary-name": "./dist/index.cjs", // Binary information used to get the executable name from the key and, from the value, the build file to inject into the generated executable.
+	},
+	// "bin": "./dist/index.cjs", // Or, if the binary name follows the package name, you can define a string-based `bin` value.
+	"scripts": {
+		"build": "quickbundle compile",
+	},
+	// ...
+}
+```
+
+> [!warning] Limitations
+> TODO
+
+</details>
+
 3️⃣ Try it by running:
 
 ```bash

package/dist/index.mjs

@@ -15,7 +15,7 @@ import os from 'node:os';
 import { gzipSize } from 'gzip-size';
 
 var name = "quickbundle";
-var version = "0.0.0-next-5441a21";
+var version = "0.0.0-next-800b69a";
 
 const CWD = process.cwd();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickbundle",
-  "version": "0.0.0-next-5441a21",
+  "version": "0.0.0-next-800b69a",
   "description": "The zero-configuration transpiler and bundler for the web",
   "author": {
     "name": "Ayoub Adib",