quickbundle 0.0.0-next-da5d78a → 0.0.0-next-386ba5d

package/README.md

@@ -113,7 +113,7 @@ yarn add quickbundle
 	"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 to get the executable name from the key and, from the value, the bundled file to generate from the source code and inject into the executable. The generated executable will be located in the same folder as the bundled file and, by default, dependending on the current operating system running the `compile` command, the executable will be named either `your-binary-name.exe` on Windows or `your-binary-name` on Linux and macOS.
+		"your-binary-name": "./dist/index.cjs", // Binary information to get the executable name from the key and, from the value, the bundled file to generate from the source code and inject into the executable. The generated executable will be located in the same folder as the bundled file and, by default, dependending on the current operating system running the `compile` command, the executable will be named either `your-binary-name.exe` on Windows or `your-binary-name` on Linux and macOS. For cross-compilation output, check the `Patterns` section.
 	},
 	// "bin": "./dist/index.cjs", // Or, if the binary name follows the package name, you can define a string-based `bin` value.
 	"scripts": {
@@ -173,21 +173,21 @@ Enabling source map generation is needed only if a build is [obfuscated (minifie
 
 ### Cross compilation to other platforms
 
-By default, the `compile` command embeds the runtime at the origin of its execution which means it generates executables compatible only with machines running the same operating system and processor architecture.
+By default, the `compile` command embeds the runtime at the origin of its execution which means it generates executables compatible only with machines running the same operating system, processor architecture, and Node.js version.
 
-However, Quickbundle provides the ability to target a different operating system or processor architecture (also known as cross compilation):
+However, Quickbundle provides the ability to target a different operating system, processor architecture, or Node.js version (also known as cross-compilation):
 
 ```bash
-quickbundle compile --runtime node-v23.1.0-darwin-arm64 # Embeds Node v23 runtime built for macOS ARM64 target
-quickbundle compile --runtime node-v23.1.0-darwin-x64 # Embeds Node v23 runtime built for macOS X64 target
-quickbundle compile --runtime node-v23.1.0-linux-arm64 # Embeds Node v23 runtime built for Linux ARM64 target
-quickbundle compile --runtime node-v23.1.0-linux-x64 # Embeds Node v23 runtime built for Linux X64 target
-quickbundle compile --runtime node-v23.1.0-win-arm64 # Embeds Node v23 runtime built for Windows ARM64 target
-quickbundle compile --runtime node-v23.1.0-win-x64 # Embeds Node v23 runtime built for Windows X64 target
+quickbundle compile --target node-v23.1.0-darwin-arm64 # Embeds Node v23 runtime built for macOS ARM64 target
+quickbundle compile --target node-v23.1.0-darwin-x64 # Embeds Node v23 runtime built for macOS X64 target
+quickbundle compile --target node-v23.1.0-linux-arm64 # Embeds Node v23 runtime built for Linux ARM64 target
+quickbundle compile --target node-v23.1.0-linux-x64 # Embeds Node v23 runtime built for Linux X64 target
+quickbundle compile --target node-v23.1.0-win-arm64 # Embeds Node v23 runtime built for Windows ARM64 target
+quickbundle compile --target node-v23.1.0-win-x64 # Embeds Node v23 runtime built for Windows X64 target
 ```
 
 > [!note]
-> The accepted runtime input are the one listed in [https://nodejs.org/download/release/vx.y.z](https://nodejs.org/download/release/latest/) with the following format `node-vx.y.z-(darwin|linux|win)-(arm64|x64|x86)`.
+> The accepted target input follows the `node-vx.y.z-(darwin|linux|win)-(arm64|x64|x86)` format (for an exhaustive view, check available filenames in [https://nodejs.org/download/release/vx.y.z](https://nodejs.org/download/release/latest/)).
 
 <br>
 

package/dist/index.mjs

@@ -19,7 +19,7 @@ import os from 'node:os';
 import { gzipSize } from 'gzip-size';
 
 var name = "quickbundle";
-var version = "0.0.0-next-da5d78a";
+var version = "0.0.0-next-386ba5d";
 
 /**
  * Resolve a relative path from the Quickbundle node modules directory.
@@ -393,12 +393,12 @@ const createCompileCommand = (program)=>{
         name: "compile",
         description: "Compiles the source code into a self-contained executable"
     }).option({
-        key: "runtimeInput",
+        key: "targetInput",
         name: {
-            long: "runtime",
-            short: "r"
+            long: "target",
+            short: "t"
         },
-        description: "Set a different runtime target than the one available in the local machine running the command.",
+        description: "Set a different cross-compilation target",
         defaultValue: "local"
     }).task({
         key: "config",
@@ -412,24 +412,28 @@ const createCompileCommand = (program)=>{
         }
     }).task({
         key: "osType",
-        label ({ runtimeInput }) {
-            return `Get runtime \`${runtimeInput}\``;
+        label ({ targetInput }) {
+            return `Get \`${targetInput}\` runtime`;
         },
-        async handler ({ runtimeInput }) {
-            if (runtimeInput === "local") {
+        async handler ({ targetInput }) {
+            if (targetInput === "local") {
                 await copyFile(process.execPath, TEMPORARY_RUNTIME_PATH);
                 return getOsType(os.type());
             }
-            const matchedRuntimeParts = matchRuntimeParts(runtimeInput);
+            const matchedRuntimeParts = matchRuntimeParts(targetInput);
             if (!matchedRuntimeParts) {
                 throw new Error("Invalid `runtime` flag input. The accepted targets are the one listed in https://nodejs.org/download/release/ with the following format `node-vx.y.z-(darwin|linux|win)-(arm64|x64|x86)`.");
             }
             const osType = getOsType(matchedRuntimeParts.os);
             const extension = osType === "windows" ? "zip" : "tar.gz";
-            await download(`https://nodejs.org/download/release/${matchedRuntimeParts.version}/${runtimeInput}.${extension}`, TEMPORARY_DOWNLOAD_PATH);
+            await download(`https://nodejs.org/download/release/${matchedRuntimeParts.version}/${targetInput}.${extension}`, TEMPORARY_DOWNLOAD_PATH);
+            console.log(TEMPORARY_DOWNLOAD_PATH, {
+                directoryPath: dirname(TEMPORARY_RUNTIME_PATH),
+                filename: basename(TEMPORARY_RUNTIME_PATH)
+            });
             await unzip({
                 path: TEMPORARY_DOWNLOAD_PATH,
-                targetArchivePath: osType === "windows" ? join(runtimeInput, "node.exe") : join(runtimeInput, "bin", "node")
+                targetArchivePath: osType === "windows" ? join(targetInput, "node.exe") : join(targetInput, "bin", "node")
             }, {
                 directoryPath: dirname(TEMPORARY_RUNTIME_PATH),
                 filename: basename(TEMPORARY_RUNTIME_PATH)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickbundle",
-  "version": "0.0.0-next-da5d78a",
+  "version": "0.0.0-next-386ba5d",
   "description": "The zero-configuration transpiler and bundler for the web",
   "author": {
     "name": "Ayoub Adib",