libdragon 12.1.0 → 12.2.0

package/README.md

@@ -69,7 +69,7 @@ Download the [pre-built executable](https://github.com/anacierdem/libdragon-dock
 
 ### via NPM
 
-Install [node.js](https://nodejs.org/en/download/) (`>= 22`) and install `libdragon` as a global NPM package;
+Install [node.js](https://nodejs.org/en/download/) (`>= 24`) and install `libdragon` as a global NPM package;
 
 ```bash
 npm install -g libdragon
@@ -172,7 +172,7 @@ To be able to share your project with the library change, you just commit your c
 > [!TIP]
 > You can simply use [`development` devcontainer](#development-configuration) support to get up an running quickly if your development environment supports it.
 
-After cloning this repository on a system with node.js (`>= 18`) & docker (`>= 27.2.0`), in this repository's root do;
+After cloning this repository on a system with node.js (`>= 24`) & docker (`>= 27.2.0`), in this repository's root do;
 
 ```bash
 npm install
@@ -293,6 +293,9 @@ To create your own dev container backed project, you can use the contents of the
 
 This has everything required to develop the tool itself. Just follow "Working on this repository" section inside the devcontainer.
 
+> [!NOTE]
+> When working in this devcontainer on a Linux host, you can build and install the latest executable in `${HOME}/.local/bin` by running `npm run install-host` (in the container) to test it on your host.
+
 #### `libdragon` configuration
 
 This is an example devcontainer setup for using the libdragon toolchain to build n64 ROMs. To start building with libdragon:

package/modules/parameters.js

@@ -20,6 +20,7 @@ const { globals } = require('./globals');
  *  VENDOR_STRAT?: VendorStrategy;
  *  FILE?: string;
  *  BRANCH?: string;
+ *  CWD?: string;
  * }} CommandlineOptions
  */
 
@@ -33,6 +34,9 @@ const parseParameters = async (argv) => {
     CURRENT_ACTION: undefined,
   };
 
+  /** @type string[] */
+  let potentialExtraFlags = [];
+
   for (let i = 2; i < argv.length; i++) {
     const val = argv[i];
 
@@ -90,9 +94,15 @@ const parseParameters = async (argv) => {
       continue;
     }
 
+    if (['-C'].includes(val)) {
+      options.CWD = argv[++i];
+      continue;
+    }
+
+    // Collect unknown flags
     if (val.indexOf('-') == 0) {
-      log(chalk.red(`Invalid flag \`${val}\``));
-      process.exit(STATUS_BAD_PARAM);
+      potentialExtraFlags.push(val);
+      continue;
     }
 
     if (options.CURRENT_ACTION) {
@@ -126,6 +136,20 @@ const parseParameters = async (argv) => {
     process.exit(STATUS_BAD_PARAM);
   }
 
+  // Because of https://github.com/microsoft/vscode-cpptools/issues/14169
+  // move any unkown flags before the action to the end of the container command
+  if (
+    options.CURRENT_ACTION !== actions.exec &&
+    potentialExtraFlags.length > 0
+  ) {
+    log(chalk.red(`Invalid flag \`${potentialExtraFlags[0]}\``));
+    process.exit(STATUS_BAD_PARAM);
+  }
+
+  if (options.CURRENT_ACTION === actions.exec) {
+    options.EXTRA_PARAMS = [...options.EXTRA_PARAMS, ...potentialExtraFlags];
+  }
+
   if (
     !(
       /** @type {typeof actions[keyof actions][]} */ ([

package/modules/project-info.js

@@ -165,6 +165,8 @@ const readProjectInfo = async function (optionInfo) {
     return /** @type {NoProjectInfo} */ (optionInfo);
   }
 
+  optionInfo.options.CWD && process.chdir(optionInfo.options.CWD);
+
   const projectRoot = await findLibdragonRoot();
 
   if (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libdragon",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "description": "This is a docker wrapper for libdragon",
   "main": "index.js",
   "engines": {
@@ -17,6 +17,7 @@
     "start": "node index.js start",
     "stop": "node index.js stop",
     "pack": "node pack.mjs",
+    "install-host": "node pack.mjs --install",
     "bundle": "node bundle.mjs",
     "format": "prettier **/*.js **/*.mjs **/*.cjs --write",
     "format-check": "prettier **/*.js **/*.mjs **/*.cjs --check",