Configure VSCode debugger

.vscode/launch.json

@@ -0,0 +1,21 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "npm run vscode:debug",
+      // "env": { "NO_COLOR": "1" }, // If terminal does not display ANSI escapes
+      "internalConsoleOptions": "openOnFirstSessionStart",
+      "name": "Neu React Vite Runner",
+      "request": "launch",
+      "type": "node-terminal",
+      "serverReadyAction": {
+        "action": "debugWithChrome",
+        "killOnServerStop": true,
+        "pattern": "Local:.*http://localhost:([0-9]+)/",
+        "uriFormat": "http://localhost:%s",
+        "webRoot": "${workspaceFolder}${pathSeparator}react-src"
+      },
+      "postDebugTask": "npm: vscode:postdebug"
+    }
+  ]
+}

package.json

@@ -12,7 +12,9 @@
     "clean": "rimraf .tmp/ dist/ node_modules/ react-src/dist/ react-src/node_modules/",
     "lint": "npm run lint --workspaces --if-present",
     "setup": "npm ci && neu update",
-    "start": "neu run -- --window-enable-inspector"
+    "start": "neu run -- --window-enable-inspector",
+    "vscode:debug": "node scripts/debug.cjs",
+    "vscode:postdebug": "node scripts/debug.cjs --postdebug"
   },
   "devDependencies": {
     "@neutralinojs/neu": "^11.3.0",

scripts/debug.cjs

@@ -0,0 +1,35 @@
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const neuConfig = require('../neutralino.config.json');
+
+const root = path.join(__dirname, '..');
+
+const patchFile = path.join(root, neuConfig.cli.frontendLibrary.patchFile);
+const patchFileExists = fs.existsSync(patchFile);
+const backupPatchFile = path.join(path.dirname(patchFile), 'index.org.html');
+const backupPatchFileExists = fs.existsSync(backupPatchFile);
+
+const restorePatchFile = () => {
+  fs.rmSync(patchFile);
+  fs.renameSync(backupPatchFile, patchFile);
+};
+
+if (process.argv.includes('--postdebug')) {
+  if (backupPatchFileExists) restorePatchFile();
+} else {
+  if (patchFileExists) fs.cpSync(patchFile, backupPatchFile);
+  spawn(
+    'npx',
+    ['@neutralinojs/neu', 'run', '--', '--mode=cloud'],
+    //
+    // Cloud mode is a convenience to avoid the window popup. The NL_TOKEN is
+    // not consumed until the debugger attaches; all other clients are rejected
+    //
+    {
+      cwd: path.join(root),
+      stdio: 'inherit',
+      shell: true,
+    }
+  );
+}