qunitx-cli 0.19.3 → 0.21.0

package/dist/cli.js

@@ -38,10 +38,11 @@ var init_find_chrome = __esm({
 });
 
 // lib/utils/kill-process-group.ts
+import { spawnSync } from "node:child_process";
 function killProcessGroup(pid) {
   try {
     if (process.platform === "win32") {
-      process.kill(pid, "SIGKILL");
+      spawnSync("taskkill", ["/F", "/T", "/PID", String(pid)], { stdio: "ignore" });
     } else {
       process.kill(-pid, "SIGKILL");
     }
@@ -92,12 +93,17 @@ async function cleanupBrowserDir(dirPath) {
   }
   const dirName = dirPath.split("/").pop();
   await killAllReferencingProcesses(dirPath, dirName);
-  const deadline = Date.now() + 5e3;
+  const deadline = Date.now() + CLEANUP_DEADLINE_MS;
   while (Date.now() < deadline) {
-    const removed = await fs.rm(dirPath, { recursive: true, force: true }).then(() => true).catch(() => false);
+    const removed = await fs.rm(dirPath, { recursive: true, force: true }).then(
+      () => fs.access(dirPath).then(
+        () => false,
+        () => true
+      )
+    ).catch(() => false);
     if (removed) return;
     await killAllReferencingProcesses(dirPath, dirName);
-    await new Promise((resolve) => setTimeout(resolve, 50));
+    await new Promise((resolve) => setTimeout(resolve, CLEANUP_RETRY_MS));
   }
   if (!await fs.access(dirPath).then(() => true).catch(() => false))
     return;
@@ -117,8 +123,11 @@ async function cleanupBrowserDir(dirPath) {
     })
   );
 }
+var CLEANUP_DEADLINE_MS, CLEANUP_RETRY_MS;
 var init_cleanup_browser_dir = __esm({
   "lib/utils/cleanup-browser-dir.ts"() {
+    CLEANUP_DEADLINE_MS = 5e3;
+    CLEANUP_RETRY_MS = 50;
   }
 });
 
@@ -191,8 +200,11 @@ var init_chromium_args = __esm({
       // ── Sandbox / rendering ──────────────────────────────────────────────────────
       "--no-sandbox",
       // required in most CI/container environments
-      "--disable-gpu",
-      // no GPU in headless; avoids GPU process startup
+      // SwiftShader software WebGL: needed on Linux CI (containerised, no GPU).
+      // Omit on macOS — Chrome uses Metal natively; SwiftShader crashes the renderer
+      // process on macOS arm64, causing "Target page, context or browser has been closed".
+      // Omit on Windows — ANGLE/D3D11 is available and SwiftShader is not needed.
+      ...process.platform === "linux" ? ["--enable-unsafe-swiftshader"] : [],
       // ── Window / UI ──────────────────────────────────────────────────────────────
       "--window-size=1440,900",
       "--hide-scrollbars",
@@ -299,7 +311,13 @@ var init_chrome_prelaunch = __esm({
         else if (arg === "--watch" || arg === "-w") flags.watchFromArgv = true;
         return flags;
       },
-      { browserFromArgv: "chromium", openFromArgv: false, watchFromArgv: false }
+      // QUNITX_BROWSER env var seeds the default so prelaunch is skipped for firefox/webkit
+      // even when --browser is not passed on the command line (e.g. browser-compat CI).
+      {
+        browserFromArgv: process.env.QUNITX_BROWSER || "chromium",
+        openFromArgv: false,
+        watchFromArgv: false
+      }
     ));
     openWatchMode = openFromArgv && watchFromArgv;
     earlyChrome = null;
@@ -310,7 +328,7 @@ var init_chrome_prelaunch = __esm({
       });
     }
     perfLog("chrome-prelaunch.ts: module evaluated");
-    prelaunchPromise = isRunCommand && browserFromArgv === "chromium" ? findChrome().then((chromePath) => {
+    prelaunchPromise = isRunCommand && browserFromArgv === "chromium" && process.platform !== "darwin" ? findChrome().then((chromePath) => {
       perfLog("chrome-prelaunch.ts: findChrome resolved", chromePath);
       return preLaunchChrome(chromePath, CHROMIUM_ARGS, !openWatchMode);
     }).then((info) => {
@@ -472,10 +490,11 @@ function dumpYaml({
   expected,
   message,
   stack,
+  source,
   at
 }) {
   return `name: ${dumpString(name, "")}
-` + yamlLine("actual", actual) + yamlLine("expected", expected) + (message !== null ? yamlLine("message", message) : "") + (stack !== null ? yamlLine("stack", stack) : "") + (at !== null ? yamlLine("at", at) : "");
+` + yamlLine("actual", actual) + yamlLine("expected", expected) + (message !== null ? yamlLine("message", message) : "") + (stack !== null ? yamlLine("stack", stack) : "") + (source !== null ? yamlLine("source", source) : "") + (at !== null ? yamlLine("at", at) : "");
 }
 var NEEDS_QUOTING;
 var init_dump_yaml = __esm({
@@ -498,8 +517,205 @@ var init_indent_string = __esm({
   }
 });
 
+// lib/utils/source-map-decoder.ts
+function readVLQ(s, pos) {
+  let accumulated = 0;
+  let shift = 0;
+  let digit;
+  do {
+    digit = BASE64_LOOKUP[s.charCodeAt(pos++)];
+    accumulated |= (digit & 31) << shift;
+    shift += 5;
+  } while (digit & 32);
+  return [accumulated & 1 ? -(accumulated >>> 1) : accumulated >>> 1, pos];
+}
+function decodeMappings(mappings) {
+  let sourceIndex = 0, sourceLine = 0, sourceCol = 0;
+  return mappings.split(";").map((lineStr) => {
+    const segments = [];
+    let generatedCol = 0;
+    let pos = 0;
+    while (pos < lineStr.length) {
+      if (lineStr[pos] === ",") {
+        pos++;
+        continue;
+      }
+      let delta;
+      [delta, pos] = readVLQ(lineStr, pos);
+      generatedCol += delta;
+      if (pos >= lineStr.length || lineStr[pos] === ",") continue;
+      [delta, pos] = readVLQ(lineStr, pos);
+      sourceIndex += delta;
+      [delta, pos] = readVLQ(lineStr, pos);
+      sourceLine += delta;
+      [delta, pos] = readVLQ(lineStr, pos);
+      sourceCol += delta;
+      if (pos < lineStr.length && lineStr[pos] !== ",") [, pos] = readVLQ(lineStr, pos);
+      segments.push({ generatedCol, sourceIndex, sourceLine, sourceCol });
+    }
+    return segments;
+  });
+}
+function parseSourceMap(json, outDir) {
+  const map = JSON.parse(json);
+  return {
+    segmentsByLine: decodeMappings(map.mappings),
+    sources: map.sources ?? [],
+    sourceRoot: map.sourceRoot ?? "",
+    outDir,
+    sourcesContent: map.sourcesContent ?? []
+  };
+}
+function base64DecodeUtf8(b64) {
+  const binary = atob(b64);
+  return UTF8.decode(Uint8Array.from(binary, (c) => c.charCodeAt(0)));
+}
+function extractInlineSourceMap(bundle, outDir) {
+  if (!bundle) return null;
+  const text = typeof bundle === "string" ? bundle : UTF8.decode(bundle);
+  const match = text.match(
+    /\/\/# sourceMappingURL=data:application\/json;base64,([A-Za-z0-9+/=]+)/
+  );
+  if (!match) return null;
+  try {
+    return parseSourceMap(base64DecodeUtf8(match[1]), outDir);
+  } catch {
+    return null;
+  }
+}
+function normalizePosix(p) {
+  const abs = p.startsWith("/");
+  const parts = p.split("/");
+  const out = [];
+  for (const part of parts) {
+    if (part === "..") out.pop();
+    else if (part !== "" && part !== ".") out.push(part);
+  }
+  return (abs ? "/" : "") + out.join("/");
+}
+function posixResolve(base, relative) {
+  if (relative.startsWith("/")) return normalizePosix(relative);
+  return normalizePosix(base + "/" + relative);
+}
+function toAbsolutePath(raw, outDir, sourceRoot) {
+  if (raw.startsWith("file://")) return raw.slice(7);
+  if (raw.startsWith("/")) return raw;
+  const base = sourceRoot ? normalizePosix(outDir + "/" + sourceRoot) : outDir;
+  return posixResolve(base, raw);
+}
+function lookupPosition(decoder, generatedLine, generatedCol) {
+  const segments = decoder.segmentsByLine[generatedLine - 1];
+  if (!segments?.length) return null;
+  const col0 = generatedCol - 1;
+  let lo = 0, hi = segments.length - 1, best = -1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    if (segments[mid].generatedCol <= col0) {
+      best = mid;
+      lo = mid + 1;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  if (best === -1) return null;
+  const { sourceIndex, sourceLine, sourceCol } = segments[best];
+  const rawSource = decoder.sources[sourceIndex];
+  if (!rawSource) return null;
+  const content = decoder.sourcesContent[sourceIndex];
+  const sourceText = content ? content.split("\n", sourceLine + 1)[sourceLine]?.trim() || null : null;
+  return {
+    absolutePath: toAbsolutePath(rawSource, decoder.outDir, decoder.sourceRoot),
+    line: sourceLine + 1,
+    // 0-based → 1-based
+    col: sourceCol + 1,
+    // 0-based → 1-based
+    sourceText
+  };
+}
+function parseFrameLocation(s) {
+  const colSep = s.lastIndexOf(":");
+  if (colSep < 0) return null;
+  const colStr = s.slice(colSep + 1);
+  if (!/^\d+$/.test(colStr)) return null;
+  const lineSep = s.lastIndexOf(":", colSep - 1);
+  if (lineSep < 0) return null;
+  const lineStr = s.slice(lineSep + 1, colSep);
+  if (!/^\d+$/.test(lineStr)) return null;
+  return { url: s.slice(0, lineSep), line: +lineStr, col: +colStr };
+}
+function isBundleUrl(url) {
+  const normalized = url.startsWith("async ") ? url.slice(6) : url;
+  return /^https?:\/\//.test(normalized) && /\/(tests|filtered-tests)\.js$/.test(normalized);
+}
+function isNodeModulesPath(absolutePath) {
+  return absolutePath.includes("/node_modules/") || absolutePath.includes("\\node_modules\\");
+}
+function makeDisplayPath(absolutePath, projectRoot) {
+  const prefix = projectRoot + "/";
+  return absolutePath.startsWith(prefix) ? absolutePath.slice(prefix.length) : absolutePath;
+}
+function tryResolve(urlLineCol, decoder, projectRoot) {
+  const loc = parseFrameLocation(urlLineCol);
+  if (!loc || !isBundleUrl(loc.url)) return null;
+  const orig = lookupPosition(decoder, loc.line, loc.col);
+  if (!orig) return null;
+  const display = `${makeDisplayPath(orig.absolutePath, projectRoot)}:${orig.line}:${orig.col}`;
+  return {
+    display,
+    userPath: isNodeModulesPath(orig.absolutePath) ? null : display,
+    sourceText: orig.sourceText
+  };
+}
+function resolveFrame(frame, decoder, projectRoot) {
+  const chromeName = frame.match(/^(\s*at\s+)(.*?)\s+\(([^)]+)\)\s*$/);
+  if (chromeName) {
+    const r = tryResolve(chromeName[3], decoder, projectRoot);
+    return r ? {
+      resolved: `${chromeName[1]}${chromeName[2]} (${r.display})`,
+      userPath: r.userPath,
+      sourceText: r.sourceText
+    } : null;
+  }
+  const chromeAnon = frame.match(/^(\s*at\s+(?:async\s+)?)(.+)/);
+  if (chromeAnon) {
+    const r = tryResolve(chromeAnon[2], decoder, projectRoot);
+    return r ? { resolved: `${chromeAnon[1]}${r.display}`, userPath: r.userPath, sourceText: r.sourceText } : null;
+  }
+  const gecko = frame.match(/^([^@]*)@(.+)$/);
+  if (gecko) {
+    const r = tryResolve(gecko[2], decoder, projectRoot);
+    return r ? { resolved: `${gecko[1]}@${r.display}`, userPath: r.userPath, sourceText: r.sourceText } : null;
+  }
+  return null;
+}
+function resolveStack(stack, decoder, projectRoot) {
+  let firstUserFrame = null;
+  let firstUserSourceText = null;
+  const resolvedLines = stack.split("\n").map((frame) => {
+    const result = resolveFrame(frame, decoder, projectRoot);
+    if (!result) return frame;
+    if (!firstUserFrame && result.userPath) {
+      firstUserFrame = result.userPath;
+      firstUserSourceText = result.sourceText;
+    }
+    return result.resolved;
+  });
+  return { resolvedStack: resolvedLines.join("\n"), firstUserFrame, firstUserSourceText };
+}
+var BASE64, BASE64_LOOKUP, UTF8;
+var init_source_map_decoder = __esm({
+  "lib/utils/source-map-decoder.ts"() {
+    BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    BASE64_LOOKUP = new Uint8Array(128);
+    [...BASE64].forEach((ch, i) => {
+      BASE64_LOOKUP[ch.charCodeAt(0)] = i;
+    });
+    UTF8 = new TextDecoder();
+  }
+});
+
 // lib/tap/display-test-result.ts
-function TAPDisplayTestResult(COUNTER, details) {
+function TAPDisplayTestResult(COUNTER, details, decoder, projectRoot) {
   COUNTER.testCount++;
   if (details.status === "skipped") {
     COUNTER.skipCount++;
@@ -519,6 +735,19 @@ function TAPDisplayTestResult(COUNTER, details) {
       if (!assertion.passed && assertion.todo === false) {
         COUNTER.errorCount = (COUNTER.errorCount ?? 0) + 1;
         process.stdout.write("  ---\n");
+        let stackStr = assertion.stack?.trim() || null;
+        let atStr = extractStackAt(assertion.stack);
+        let sourceText = null;
+        if (decoder && projectRoot && assertion.stack) {
+          const { resolvedStack, firstUserFrame, firstUserSourceText } = resolveStack(
+            assertion.stack,
+            decoder,
+            projectRoot
+          );
+          stackStr = resolvedStack.trim() || null;
+          atStr = firstUserFrame;
+          sourceText = firstUserSourceText;
+        }
         process.stdout.write(
           indentString(
             dumpYaml({
@@ -526,10 +755,9 @@ function TAPDisplayTestResult(COUNTER, details) {
               actual: assertion.actual !== null && typeof assertion.actual === "object" ? JSON.parse(JSON.stringify(assertion.actual, getCircularReplacer())) : assertion.actual,
               expected: assertion.expected !== null && typeof assertion.expected === "object" ? JSON.parse(JSON.stringify(assertion.expected, getCircularReplacer())) : assertion.expected,
               message: assertion.message || null,
-              // Trim leading/trailing whitespace: Chrome stacks start with "    at ..."
-              // (4 spaces per frame) which would otherwise render as "stack:     at ..." in YAML.
-              stack: assertion.stack?.trim() || null,
-              at: extractStackAt(assertion.stack)
+              stack: stackStr,
+              source: sourceText,
+              at: atStr
             }),
             4
           )
@@ -573,6 +801,7 @@ var init_display_test_result = __esm({
   "lib/tap/display-test-result.ts"() {
     init_dump_yaml();
     init_indent_string();
+    init_source_map_decoder();
   }
 });
 
@@ -703,8 +932,8 @@ var init_http = __esm({
         });
       }
       /** Registers a GET route handler. */
-      get(path7, handler) {
-        this.#registerRouteHandler("GET", path7, handler);
+      get(path10, handler) {
+        this.#registerRouteHandler("GET", path10, handler);
       }
       /**
        * Starts listening on the given port (0 = OS-assigned).
@@ -735,32 +964,32 @@ var init_http = __esm({
         });
       }
       /** Registers a POST route handler. */
-      post(path7, handler) {
-        this.#registerRouteHandler("POST", path7, handler);
+      post(path10, handler) {
+        this.#registerRouteHandler("POST", path10, handler);
       }
       /** Registers a DELETE route handler. */
-      delete(path7, handler) {
-        this.#registerRouteHandler("DELETE", path7, handler);
+      delete(path10, handler) {
+        this.#registerRouteHandler("DELETE", path10, handler);
       }
       /** Registers a PUT route handler. */
-      put(path7, handler) {
-        this.#registerRouteHandler("PUT", path7, handler);
+      put(path10, handler) {
+        this.#registerRouteHandler("PUT", path10, handler);
       }
       /** Adds a middleware function to the chain. */
       use(middleware) {
         this.middleware.push(middleware);
       }
-      #registerRouteHandler(method, path7, handler) {
+      #registerRouteHandler(method, path10, handler) {
         if (!this.routes[method]) {
           this.routes[method] = {};
         }
-        const paramNames = this.#extractParamNames(path7);
-        this.routes[method][path7] = {
-          path: path7,
+        const paramNames = this.#extractParamNames(path10);
+        this.routes[method][path10] = {
+          path: path10,
           handler,
           paramNames,
-          isWildcard: path7 === "/*",
-          compiledRegex: paramNames.length > 0 ? new RegExp(`^${this.#buildRegexPattern(path7, paramNames)}$`) : null
+          isWildcard: path10 === "/*",
+          compiledRegex: paramNames.length > 0 ? new RegExp(`^${this.#buildRegexPattern(path10, paramNames)}$`) : null
         };
       }
       #handleRequest(req, res) {
@@ -798,11 +1027,11 @@ var init_http = __esm({
           return null;
         }
         return routes[url] || Object.values(routes).find((route) => {
-          const { path: path7, isWildcard } = route;
-          if (!isWildcard && !path7.includes(":")) {
+          const { path: path10, isWildcard } = route;
+          if (!isWildcard && !path10.includes(":")) {
             return false;
           }
-          if (isWildcard || this.#matchPathSegments(path7, url)) {
+          if (isWildcard || this.#matchPathSegments(path10, url)) {
             if (route.compiledRegex) {
               const regexMatches = route.compiledRegex.exec(url);
               if (regexMatches) {
@@ -812,10 +1041,10 @@ var init_http = __esm({
             return true;
           }
           return false;
-        }) || routes["/*"] || null;
+        }) || null;
       }
-      #matchPathSegments(path7, url) {
-        const pathSegments = path7.split("/");
+      #matchPathSegments(path10, url) {
+        const pathSegments = path10.split("/");
         const urlSegments = url.split("/");
         if (pathSegments.length !== urlSegments.length) {
           return false;
@@ -832,14 +1061,14 @@ var init_http = __esm({
         }
         return true;
       }
-      #buildRegexPattern(path7, _paramNames) {
-        let regexPattern = path7.replace(/:[^/]+/g, "([^/]+)");
+      #buildRegexPattern(path10, _paramNames) {
+        let regexPattern = path10.replace(/:[^/]+/g, "([^/]+)");
         regexPattern = regexPattern.replace(/\//g, "\\/");
         return regexPattern;
       }
-      #extractParamNames(path7) {
+      #extractParamNames(path10) {
         const paramRegex = /:(\w+)/g;
-        const paramMatches = path7.match(paramRegex);
+        const paramMatches = path10.match(paramRegex);
         return paramMatches ? paramMatches.map((match) => match.slice(1)) : [];
       }
       #extractParams(route, _url) {
@@ -856,9 +1085,9 @@ var init_http = __esm({
 
 // lib/setup/web-server.ts
 import fs8 from "node:fs";
-import path4 from "node:path";
+import path5 from "node:path";
 function setupWebServer(config, cachedContent) {
-  const STATIC_FILES_PATH = path4.join(config.projectRoot, config.output);
+  const STATIC_FILES_PATH = path5.resolve(config.projectRoot, config.output);
   const server = new HTTPServer();
   const mainHTMLWithReplacedAssets = replaceAssetPaths(
     cachedContent.mainHTML.html,
@@ -902,7 +1131,7 @@ function setupWebServer(config, cachedContent) {
           );
         }
         config._resetTestTimeout?.();
-        TAPDisplayTestResult(config.COUNTER, details);
+        TAPDisplayTestResult(config.COUNTER, details, config._sourceMapDecoder, config.projectRoot);
       } else if (event === "done") {
         config._phase = "done";
         config._lastQUnitResult = qunitResult ?? null;
@@ -919,7 +1148,26 @@ function setupWebServer(config, cachedContent) {
       }
     });
   });
-  server.get("/tests.js", (_req, res) => {
+  server.get("/tests.js", async (_req, res) => {
+    if (cachedContent._activeRebuild) {
+      await cachedContent._activeRebuild.catch(() => {
+      });
+      if (!cachedContent.allTestCode) {
+        config._lastQUnitResult = {
+          totalTests: 0,
+          finishedTests: 0,
+          failedTests: 0,
+          currentTest: null
+        };
+        config._testRunDone?.();
+        config._testRunDone = null;
+        res.writeHead(200, {
+          "Content-Type": "application/javascript",
+          "Cache-Control": "no-store"
+        });
+        return void res.end();
+      }
+    }
     const bytes = cachedContent.allTestCode?.length ?? null;
     config.debug && process.stdout.write(
       `# [HTTPServer] GET /tests.js \u2192 ${bytes !== null ? `${bytes} bytes` : "NOT READY (allTestCode is null)"}
@@ -927,10 +1175,9 @@ function setupWebServer(config, cachedContent) {
     );
     if (bytes === null) {
       res.writeHead(503, { "Content-Type": "application/javascript", "Cache-Control": "no-store" });
-      res.end(
+      return void res.end(
         'console.error("[qunitx] /tests.js requested before bundle was built \u2014 allTestCode is null");'
       );
-      return;
     }
     config._onTestsJsServed?.();
     res.writeHead(200, {
@@ -948,10 +1195,9 @@ function setupWebServer(config, cachedContent) {
     );
     if (bytes === null) {
       res.writeHead(503, { "Content-Type": "application/javascript", "Cache-Control": "no-store" });
-      res.end(
+      return res.end(
         'console.error("[qunitx] /filtered-tests.js requested before bundle was built \u2014 filteredTestCode is null");'
       );
-      return;
     }
     config._onTestsJsServed?.();
     res.writeHead(200, {
@@ -961,39 +1207,59 @@ function setupWebServer(config, cachedContent) {
     });
     res.end(cachedContent.filteredTestCode);
   });
-  server.get("/", (_req, res) => {
+  server.get("/", async (_req, res) => {
+    await cachedContent._activeRebuild?.catch(() => {
+    });
     if (cachedContent._buildError) {
       const htmlContent = buildErrorHTML(cachedContent._buildError);
       res.writeHead(200, HTML_HEADERS);
       res.end(htmlContent);
-      saveHTML(`${config.projectRoot}/${config.output}/index.html`, htmlContent);
-      return;
+      if (cachedContent._activeRebuild) {
+        config._lastQUnitResult = {
+          totalTests: 0,
+          finishedTests: 0,
+          failedTests: 0,
+          currentTest: null
+        };
+        config._testRunDone?.();
+        config._testRunDone = null;
+      }
+      return saveHTML(
+        path5.join(path5.resolve(config.projectRoot, config.output), "index.html"),
+        htmlContent
+      );
     }
     if (cachedContent._noTestsWarning) {
       res.writeHead(200, HTML_HEADERS);
-      res.end(buildNoTestsHTML(cachedContent._noTestsWarning));
-      return;
+      return res.end(buildNoTestsHTML(cachedContent._noTestsWarning));
     }
     res.writeHead(200, HTML_HEADERS);
     res.end(mainIndexHTML);
-    saveHTML(`${config.projectRoot}/${config.output}/index.html`, mainIndexHTML);
+    saveHTML(
+      path5.join(path5.resolve(config.projectRoot, config.output), "index.html"),
+      mainIndexHTML
+    );
   });
   server.get("/qunitx.html", (_req, res) => {
     if (cachedContent._buildError) {
       const htmlContent = buildErrorHTML(cachedContent._buildError);
       res.writeHead(200, HTML_HEADERS);
       res.end(htmlContent);
-      saveHTML(`${config.projectRoot}/${config.output}/qunitx.html`, htmlContent);
-      return;
+      return saveHTML(
+        path5.join(path5.resolve(config.projectRoot, config.output), "qunitx.html"),
+        htmlContent
+      );
     }
     if (cachedContent._noTestsWarning) {
       res.writeHead(200, HTML_HEADERS);
-      res.end(buildNoTestsHTML(cachedContent._noTestsWarning));
-      return;
+      return res.end(buildNoTestsHTML(cachedContent._noTestsWarning));
     }
     res.writeHead(200, HTML_HEADERS);
     res.end(mainQunitxHTML);
-    saveHTML(`${config.projectRoot}/${config.output}/qunitx.html`, mainQunitxHTML);
+    saveHTML(
+      path5.join(path5.resolve(config.projectRoot, config.output), "qunitx.html"),
+      mainQunitxHTML
+    );
   });
   server.get("/*", (req, res) => {
     const possibleDynamicHTML = cachedContent.dynamicContentHTMLs[`${config.projectRoot}${req.path}`];
@@ -1005,13 +1271,13 @@ function setupWebServer(config, cachedContent) {
       );
       res.writeHead(200, HTML_HEADERS);
       res.end(htmlContent);
-      saveHTML(`${config.projectRoot}/${config.output}${req.path}`, htmlContent);
+      saveHTML(path5.join(path5.resolve(config.projectRoot, config.output), req.path), htmlContent);
       return;
     }
     const url = req.url;
     const requestStartedAt = Date.now();
     const filePath = (url.endsWith("/") ? [STATIC_FILES_PATH, url, "index.html"] : [STATIC_FILES_PATH, url]).join("");
-    const contentType = req.headers.accept?.includes("text/html") ? MIME_TYPES.html : MIME_TYPES[path4.extname(filePath).substring(1).toLowerCase()] || MIME_TYPES.html;
+    const contentType = req.headers.accept?.includes("text/html") ? MIME_TYPES.html : MIME_TYPES[path5.extname(filePath).substring(1).toLowerCase()] || MIME_TYPES.html;
     const stream = fs8.createReadStream(filePath);
     stream.on("open", () => {
       res.writeHead(200, { "Content-Type": contentType });
@@ -1036,44 +1302,35 @@ function replaceAssetPaths(html, htmlPath, projectRoot) {
   const assetPaths = findInternalAssetsFromHTML(html);
   const htmlDirectory = htmlPath.split("/").slice(0, -1).join("/");
   return assetPaths.reduce((result, assetPath) => {
-    const normalizedFullAbsolutePath = path4.normalize(`${htmlDirectory}/${assetPath}`);
+    const normalizedFullAbsolutePath = path5.normalize(`${htmlDirectory}/${assetPath}`);
     return result.replace(assetPath, normalizedFullAbsolutePath.replace(projectRoot, "."));
   }, html);
 }
 function testRuntimeToInject(config, groupId) {
   const groupIdPart = groupId !== void 0 ? `, groupId: ${groupId}` : "";
   return `<script>
-    window.testTimeout = 0;
-    setInterval(() => {
-      window.testTimeout = window.testTimeout + 1000;
-    }, 1000);
-
     (function() {
-      // wsOpenStatus: true once the WebSocket 'open' event fires (or immediately for static files).
-      // testsLoaded: true once tests.js has executed and dispatched 'qunitx:tests-ready'.
-      // Both must be true before setupQUnit() is called, ensuring QUnit.start() only runs
-      // after all test modules are registered.
-      let wsOpenStatus = window.location.protocol === 'file:';
-      let testsLoaded = false;
-
-      function maybeStart() {
-        if (wsOpenStatus && testsLoaded) setupQUnit();
-      }
-
-      // tests.js (loaded as an async external script) dispatches this event after registering
-      // all test modules. Decoupled from WS so Chrome can compile tests.js in a background
-      // thread while the main thread handles the WebSocket handshake.
-      window.addEventListener('qunitx:tests-ready', function() {
-        testsLoaded = true;
-        maybeStart();
+      // setupQUnit runs exactly once, after both the WebSocket is open and tests.js has loaded.
+      // Promise.all is naturally idempotent \u2014 resolving a Promise a second time is a no-op,
+      // so WebKit firing WS error after open (causing a retry that re-opens) cannot double-start.
+      let resolveWsReady = () => {};
+      const wsReadyPromise = window.location.protocol === 'file:'
+        ? Promise.resolve()
+        : new Promise(resolve => { resolveWsReady = resolve; });
+
+      // { once: true } auto-removes the listener after the first fire.
+      const testsReadyPromise = new Promise(resolve => {
+        window.addEventListener('qunitx:tests-ready', resolve, { once: true });
       });
 
-      // For static files (file:// protocol) there is no WebSocket server.
-      // wsOpenStatus is already true above; setupQUnit fires when tests load.
+      Promise.all([wsReadyPromise, testsReadyPromise]).then(setupQUnit);
+
+      // For static files (file:// protocol) there is no WebSocket server; wsReadyPromise
+      // is already resolved above, so setupQUnit fires as soon as tests load.
       if (window.location.protocol === 'file:') return;
 
       let wsRetryCount = 0;
-      const WS_MAX_RETRIES = Math.ceil(${config.timeout} / 10); // retry for the full test timeout window
+      const WS_MAX_RETRIES = Math.ceil(${config.timeout} / ${WS_RETRY_INTERVAL_MS}); // retry for the full test timeout window
 
       function setupWebSocket() {
         try {
@@ -1085,14 +1342,13 @@ function testRuntimeToInject(config, groupId) {
         }
 
         window.socket.addEventListener('open', function() {
-          wsOpenStatus = true;
+          resolveWsReady();
           // Notify Node.js that the WS socket is open. This fires immediately (< 1 s) because
           // this runtime script is tiny \u2014 tests.js background compilation hasn't finished yet.
           // Node.js uses this to distinguish "WS never connected" from "WS connected but bundle slow".
           if (navigator.webdriver) {
             window.socket.send(JSON.stringify({ event: 'wsOpen'${groupIdPart} }));
           }
-          maybeStart();
         });
         window.socket.addEventListener('error', function() {
           retryOrFail();
@@ -1112,10 +1368,9 @@ function testRuntimeToInject(config, groupId) {
         wsRetryCount++;
         if (wsRetryCount > WS_MAX_RETRIES) {
           console.log('WebSocket connection failed after ' + WS_MAX_RETRIES + ' retries');
-          window.testTimeout = ${config.timeout};
           return;
         }
-        window.setTimeout(setupWebSocket, 10);
+        window.setTimeout(setupWebSocket, ${WS_RETRY_INTERVAL_MS});
       }
 
       setupWebSocket();
@@ -1149,8 +1404,6 @@ function testRuntimeToInject(config, groupId) {
           // "no tests registered" warning (not a failure), so this gives a fast, clean result.
           window.QUNIT_RESULT = { totalTests: 0, finishedTests: 0, failedTests: 0, currentTest: null };
           window.socket.send(JSON.stringify({ event: 'done', details: { passed: 0, failed: 0, runtime: 0 } }));
-        } else {
-          window.testTimeout = ${config.timeout};
         }
         return;
       }
@@ -1165,7 +1418,6 @@ function testRuntimeToInject(config, groupId) {
         window.QUNIT_RESULT.currentTest = details.fullName.join(' | ');
       });
       window.QUnit.on('testEnd', (details) => { // NOTE: https://github.com/qunitjs/qunit/blob/master/src/html-reporter/diff.js
-        window.testTimeout = 0;
         window.QUNIT_RESULT.finishedTests++;
         if (details.status === 'failed') window.QUNIT_RESULT.failedTests++;
         window.QUNIT_RESULT.currentTest = null;
@@ -1182,16 +1434,10 @@ function testRuntimeToInject(config, groupId) {
       window.QUnit.done((details) => {
         if (navigator.webdriver) {
           window.socket.send(JSON.stringify({ event: 'done', details: details, qunitResult: window.QUNIT_RESULT, abort: window.abortQUnit }, getCircularReplacer()));
-          // Do NOT set testTimeout here. The WS 'done' event (testsDone promise) is the
-          // canonical completion signal for Playwright runs. waitForFunction is reserved
-          // for true timeouts (test hangs) where testTimeout increments naturally via setInterval.
-          // Setting testTimeout after done caused a race: under CI load, waitForFunction could
-          // win before Node.js processed the WS done message, dropping all testEnd events.
-        } else {
-          window.testTimeout = ${config.timeout};
         }
       });
 
+      window.QUnit.config.testTimeout = ${config.timeout};
       window.QUnit.start();
     }
   </script>`;
@@ -1292,8 +1538,8 @@ function buildNoTestsHTML(files) {
         var retries = 0;
         function connect() {
           var ws = new WebSocket(\`ws://\${location.hostname}:\${location.port}\`);
-          ws.addEventListener('message', function (e) { if (e.data === 'refresh') location.reload(true); });
-          ws.addEventListener('close', function () { if (retries++ < 120) setTimeout(connect, 1000); });
+          ws.addEventListener('message', function (e) { if (e.data === 'refresh' && !navigator.webdriver) location.reload(true); });
+          ws.addEventListener('close', function () { if (retries++ < ${WATCH_WS_RECONNECT_MAX_RETRIES}) setTimeout(connect, ${WATCH_WS_RECONNECT_INTERVAL_MS}); });
           ws.addEventListener('error', function () { ws.close(); });
         }
         connect();
@@ -1394,8 +1640,8 @@ function buildErrorHTML(buildError) {
         var retries = 0;
         function connect() {
           var ws = new WebSocket(\`ws://\${location.hostname}:\${location.port}\`);
-          ws.addEventListener('message', function (e) { if (e.data === 'refresh') location.reload(true); });
-          ws.addEventListener('close', function () { if (retries++ < 120) setTimeout(connect, 1000); });
+          ws.addEventListener('message', function (e) { if (e.data === 'refresh' && !navigator.webdriver) location.reload(true); });
+          ws.addEventListener('close', function () { if (retries++ < ${WATCH_WS_RECONNECT_MAX_RETRIES}) setTimeout(connect, ${WATCH_WS_RECONNECT_INTERVAL_MS}); });
           ws.addEventListener('error', function () { ws.close(); });
         }
         connect();
@@ -1424,26 +1670,26 @@ function registerGroupRoutes(server, groupConfig, groupCachedContent, groupId) {
   server.get(`/group-${groupId}/`, (_req, res) => {
     if (groupCachedContent._buildError) {
       res.writeHead(200, HTML_HEADERS);
-      res.end(buildErrorHTML(groupCachedContent._buildError));
-      return;
+      return res.end(buildErrorHTML(groupCachedContent._buildError));
     }
     if (groupCachedContent._noTestsWarning) {
       res.writeHead(200, HTML_HEADERS);
-      res.end(buildNoTestsHTML(groupCachedContent._noTestsWarning));
-      return;
+      return res.end(buildNoTestsHTML(groupCachedContent._noTestsWarning));
     }
     res.writeHead(200, HTML_HEADERS);
     res.end(mainGroupHTML);
-    saveHTML(`${groupConfig.projectRoot}/${groupConfig.output}/index.html`, mainGroupHTML);
+    saveHTML(
+      path5.join(path5.resolve(groupConfig.projectRoot, groupConfig.output), "index.html"),
+      mainGroupHTML
+    );
   });
   server.get(`/group-${groupId}/tests.js`, (_req, res) => {
     const bytes = groupCachedContent.allTestCode?.length ?? null;
     if (bytes === null) {
       res.writeHead(503, { "Content-Type": "application/javascript", "Cache-Control": "no-store" });
-      res.end(
+      return res.end(
         'console.error("[qunitx] /tests.js requested before bundle was built \u2014 allTestCode is null");'
       );
-      return;
     }
     groupConfig._onTestsJsServed?.();
     res.writeHead(200, {
@@ -1495,7 +1741,7 @@ function setupGroupWSHandler(server, groupConfigs) {
           );
         }
         config._resetTestTimeout?.();
-        TAPDisplayTestResult(config.COUNTER, details);
+        TAPDisplayTestResult(config.COUNTER, details, config._sourceMapDecoder, config.projectRoot);
       } else if (event === "done") {
         config._phase = "done";
         config._lastQUnitResult = qunitResult ?? null;
@@ -1529,10 +1775,10 @@ function registerSharedStaticHandler(server, groupConfigs) {
       res.end("Not found");
       return;
     }
-    const STATIC_FILES_PATH = path4.join(groupConfig.projectRoot, groupConfig.output);
+    const STATIC_FILES_PATH = path5.resolve(groupConfig.projectRoot, groupConfig.output);
     const subPath = match[2] || "/";
     const filePath = (subPath.endsWith("/") ? [STATIC_FILES_PATH, subPath, "index.html"] : [STATIC_FILES_PATH, subPath]).join("");
-    const contentType = req.headers.accept?.includes("text/html") ? MIME_TYPES.html : MIME_TYPES[path4.extname(filePath).substring(1).toLowerCase()] || MIME_TYPES.html;
+    const contentType = req.headers.accept?.includes("text/html") ? MIME_TYPES.html : MIME_TYPES[path5.extname(filePath).substring(1).toLowerCase()] || MIME_TYPES.html;
     const stream = fs8.createReadStream(filePath);
     stream.on("open", () => {
       res.writeHead(200, { "Content-Type": contentType });
@@ -1544,7 +1790,7 @@ function registerSharedStaticHandler(server, groupConfigs) {
     });
   });
 }
-var fsPromise, HTML_HEADERS, NOT_FOUND_HTML;
+var fsPromise, HTML_HEADERS, WATCH_WS_RECONNECT_INTERVAL_MS, WATCH_WS_RECONNECT_MAX_RETRIES, WS_RETRY_INTERVAL_MS, NOT_FOUND_HTML;
 var init_web_server = __esm({
   "lib/setup/web-server.ts"() {
     init_find_internal_assets_from_html();
@@ -1554,6 +1800,9 @@ var init_web_server = __esm({
     init_http();
     fsPromise = fs8.promises;
     HTML_HEADERS = { "Content-Type": "text/html", "Cache-Control": "no-store" };
+    WATCH_WS_RECONNECT_INTERVAL_MS = 1e3;
+    WATCH_WS_RECONNECT_MAX_RETRIES = 120;
+    WS_RETRY_INTERVAL_MS = 10;
     NOT_FOUND_HTML = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -1599,13 +1848,23 @@ async function launchBrowser(config) {
     );
     if (prelaunch) {
       const connectStart = Date.now();
-      const browser = await playwrightCore2.chromium.connectOverCDP({
-        endpointURL: prelaunch.cdpEndpoint
-      });
-      perfLog(`browser.js: connectOverCDP took ${Date.now() - connectStart}ms`);
-      return browser;
+      try {
+        const browser = await playwrightCore2.chromium.connectOverCDP({
+          endpointURL: prelaunch.cdpEndpoint,
+          // Short timeout: if Chrome isn't CDP-ready within 5s (e.g. resource contention on
+          // slow CI runners with many concurrent pre-launches), fall back to chromium.launch().
+          timeout: 5e3
+        });
+        perfLog(`browser.js: connectOverCDP took ${Date.now() - connectStart}ms`);
+        return browser;
+      } catch {
+        perfLog(
+          `browser.js: connectOverCDP failed after ${Date.now() - connectStart}ms \u2014 falling back to chromium.launch()`
+        );
+        await shutdownPrelaunch();
+      }
     }
-    const executablePath = await findChrome();
+    const executablePath = process.platform !== "darwin" ? await findChrome() : null;
     const launchOptions = {
       args: CHROMIUM_ARGS,
       headless: true,
@@ -1637,12 +1896,9 @@ async function setupBrowser(config, cachedContent, existingBrowser = null, share
       perfLog(`browser.js: newPage (shared server) took ${Date.now() - setupStart}ms`);
       return [sharedServer, existingBrowser, newPage2];
     }
-    const [newServer, resolvedBrowser] = await Promise.all([
-      setupWebServer(config, cachedContent),
-      Promise.resolve(existingBrowser)
-    ]);
+    const newServer = setupWebServer(config, cachedContent);
     perfLog(`browser.js: setupWebServer took ${Date.now() - setupStart}ms`);
-    const activeBrowser = resolvedBrowser ?? await launchBrowser(config);
+    const activeBrowser = existingBrowser ?? await launchBrowser(config);
     const pageStart = Date.now();
     const isHeadedWatchMode = config.open === true && config.watch;
     const getPage = isHeadedWatchMode ? () => activeBrowser.contexts()[0]?.pages()[0] ?? activeBrowser.newPage() : () => activeBrowser.newPage();
@@ -1704,9 +1960,11 @@ var init_browser = __esm({
 
 // lib/utils/open-output-in-browser.ts
 import { spawn as spawn2 } from "node:child_process";
+import path6 from "node:path";
+import { pathToFileURL } from "node:url";
 async function openOutputInBrowser(config) {
   try {
-    const outputFile = config.watch ? `http://localhost:${config.port}` : `file://${config.projectRoot}/${config.output}/index.html`;
+    const outputFile = config.watch ? `http://localhost:${config.port}` : pathToFileURL(path6.join(path6.resolve(config.projectRoot, config.output), "index.html")).href;
     if (typeof config.open === "string") {
       spawnDetached(config.open, [outputFile]);
       return;
@@ -1752,9 +2010,10 @@ var init_time_counter = __esm({
 });
 
 // lib/utils/run-user-module.ts
+import { pathToFileURL as pathToFileURL2 } from "node:url";
 async function runUserModule(modulePath, params, scriptPosition) {
   try {
-    const func = await import(modulePath);
+    const func = await import(pathToFileURL2(modulePath).href);
     if (func) {
       func.default ? await func.default(params) : typeof func === "function" ? await func(params) : null;
     }
@@ -1797,8 +2056,14 @@ var init_display_final_result = __esm({
 
 // lib/commands/run/tests-in-browser.ts
 import fs9 from "node:fs/promises";
-import path5 from "node:path";
+import path7 from "node:path";
 import esbuild from "esbuild";
+function toEsbuildImportPath(filePath) {
+  const rel = path7.relative(process.cwd(), filePath);
+  const normalized = rel.replace(/\\/g, "/");
+  if (path7.isAbsolute(rel)) return filePath.replace(/\\/g, "/");
+  return normalized.startsWith(".") ? normalized : "./" + normalized;
+}
 function deriveBuildErrorType(error) {
   const msgs = error?.errors ?? [];
   const text = msgs[0]?.text ?? (error instanceof Error ? error.message : String(error));
@@ -1834,13 +2099,14 @@ async function buildTestBundle(config, cachedContent) {
     console.log("# [buildTestBundle] fsTree is empty \u2014 skipping build (no test files found)");
     return;
   }
-  const outfile = `${projectRoot}/${output}/tests.js`;
-  await fs9.mkdir(`${projectRoot}/${output}`, { recursive: true });
-  const sourcemap = config.debug ? "inline" : config.watch ? "linked" : false;
+  const outDir = path7.resolve(projectRoot, output);
+  const outfile = path7.join(outDir, "tests.js");
+  await fs9.mkdir(outDir, { recursive: true });
+  const sourcemap = "inline";
   const needsDisk = true;
   const buildOptions = {
     stdin: {
-      contents: allTestFilePaths.map((filePath) => `import "${filePath}";`).join(""),
+      contents: allTestFilePaths.map((filePath) => `import "${toEsbuildImportPath(filePath)}";`).join(""),
       resolveDir: process.cwd()
     },
     // Allow test files outside the project root (e.g. /tmp/my-test.ts) to import
@@ -1867,29 +2133,28 @@ async function buildTestBundle(config, cachedContent) {
       config.watch ? buildIncrementally(buildOptions, allTestFilePaths.join("\0"), cachedContent, needsDisk) : buildWithOverlayfsRetry(buildOptions, needsDisk),
       Promise.all(
         cachedContent.htmlPathsToRunTests.map(async (htmlPath) => {
-          const targetPath = `${config.projectRoot}/${config.output}${htmlPath}`;
+          const targetPath = path7.join(outDir, htmlPath);
           if (htmlPath !== "/") {
             await fs9.rm(targetPath, { force: true, recursive: true });
-            await fs9.mkdir(targetPath.split("/").slice(0, -1).join("/"), { recursive: true });
+            await fs9.mkdir(path7.dirname(targetPath), { recursive: true });
           }
         })
       )
     ]);
     cachedContent.allTestCode = allTestCode;
+    config._sourceMapDecoder = extractInlineSourceMap(allTestCode, outDir);
   } catch (error) {
     cachedContent._buildError = {
       type: deriveBuildErrorType(error),
       formatted: formatBuildErrors(error)
     };
-    await fs9.writeFile(
-      `${projectRoot}/${output}/index.html`,
-      buildErrorHTML(cachedContent._buildError)
-    );
+    await fs9.writeFile(path7.join(outDir, "index.html"), buildErrorHTML(cachedContent._buildError));
     throw error;
   }
 }
 async function runTestsInBrowser(config, cachedContent = {}, connections, targetTestFilesToFilter) {
   const { projectRoot, output } = config;
+  const outDir = path7.resolve(projectRoot, output);
   const allTestFilePaths = Object.keys(config.fsTree);
   const runHasFilter = !!targetTestFilesToFilter;
   if (!config._groupMode) {
@@ -1907,18 +2172,23 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
     const preBuildPromise = cachedContent._preBuildPromise;
     cachedContent._preBuildPromise = null;
     if (!cachedContent.allTestCode) {
-      await (preBuildPromise ?? buildTestBundle(config, cachedContent));
+      if (preBuildPromise) {
+        cachedContent._activeRebuild = preBuildPromise;
+      } else {
+        await buildTestBundle(config, cachedContent);
+      }
     }
-    if (!cachedContent.allTestCode) {
+    if (!cachedContent.allTestCode && !cachedContent._activeRebuild) {
       return connections;
     }
     if (runHasFilter) {
-      const outputPath = `${projectRoot}/${output}/filtered-tests.js`;
+      const outputPath = path7.join(outDir, "filtered-tests.js");
       cachedContent.filteredTestCode = await buildFilteredTests(
         targetTestFilesToFilter,
         outputPath,
         config
       );
+      config._sourceMapDecoder = extractInlineSourceMap(cachedContent.filteredTestCode, outDir);
     }
     const TIME_COUNTER = timeCounter();
     if (runHasFilter) {
@@ -1930,6 +2200,17 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
         )
       );
     }
+    if (cachedContent._activeRebuild) {
+      await cachedContent._activeRebuild.catch(() => {
+      });
+      cachedContent._activeRebuild = null;
+      if (!cachedContent.allTestCode) {
+        config.watch && cachedContent._buildError && console.log(
+          `# esbuild Bundle Error: ${cachedContent._buildError.formatted}`.split("\n").join("\n# ")
+        );
+        return connections;
+      }
+    }
     const TIME_TAKEN = TIME_COUNTER.stop();
     if (!config._groupMode) {
       if (config.COUNTER.testCount === 0 && !cachedContent._buildError) {
@@ -1941,7 +2222,7 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
         console.log(
           `# Warning: 0 tests registered \u2014 no QUnit test cases found in ${allTestFilePaths.length} ${fileWord}`
         );
-        fs9.writeFile(`${projectRoot}/${output}/index.html`, buildNoTestsHTML(displayFiles)).catch(
+        fs9.writeFile(path7.join(outDir, "index.html"), buildNoTestsHTML(displayFiles)).catch(
           () => {
           }
         );
@@ -1961,6 +2242,7 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
       }
     }
   } catch (error) {
+    cachedContent._activeRebuild = null;
     config.lastFailedTestFiles = config.lastRanTestFiles;
     const exception = new BundleError(error);
     if (!cachedContent._buildError && error.errors?.length) {
@@ -1969,7 +2251,7 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
         formatted: formatBuildErrors(error)
       };
       fs9.writeFile(
-        `${projectRoot}/${output}/qunitx.html`,
+        path7.join(outDir, "qunitx.html"),
         buildErrorHTML(cachedContent._buildError)
       ).catch(
         (err) => config.debug && process.stderr.write(`# [qunitx] writeFile qunitx.html: ${err.message}
@@ -1985,12 +2267,12 @@ async function runTestsInBrowser(config, cachedContent = {}, connections, target
   return connections;
 }
 function buildFilteredTests(filteredTests, outputPath, config) {
-  const sourcemap = config.debug ? "inline" : config.watch ? "linked" : false;
-  const needsDisk = sourcemap === "linked" || Boolean(config.open);
+  const sourcemap = "inline";
+  const needsDisk = Boolean(config.open);
   return buildWithOverlayfsRetry(
     {
       stdin: {
-        contents: filteredTests.map((filePath) => `import "${filePath}";`).join(""),
+        contents: filteredTests.map((filePath) => `import "${filePath.replace(/\\/g, "/")}";`).join(""),
         resolveDir: process.cwd()
       },
       nodePaths: ANCESTOR_NODE_MODULES,
@@ -2060,9 +2342,9 @@ async function runTestInsideHTMLFile(filePath, { page, server, browser }, config
   let wsConnected = false;
   try {
     console.log("#", blue(`QUnitX running: http://localhost:${config.port}${filePath}`));
-    const navMs = config.timeout + 1e4;
-    const startupMs = Math.max(config.timeout * 3, navMs);
-    const testsJsMs = Math.max(config.timeout * 4, navMs);
+    const navMs = config.timeout + NAV_GRACE_MS;
+    const startupMs = Math.max(config.timeout * STARTUP_TIMEOUT_FACTOR, navMs);
+    const testsJsMs = Math.max(config.timeout * TESTS_JS_TIMEOUT_FACTOR, navMs);
     let resolveTestRace;
     const testRaceResult = new Promise((resolve) => {
       resolveTestRace = resolve;
@@ -2080,7 +2362,7 @@ async function runTestInsideHTMLFile(filePath, { page, server, browser }, config
     config._resetTestTimeout = () => {
       wsConnected = true;
       clearTimeout(timeoutHandle);
-      timeoutHandle = setTimeout(resolveTestRace, config.timeout);
+      timeoutHandle = setTimeout(resolveTestRace, config.timeout + TEST_STALL_BUFFER_MS);
     };
     const targetUrl = `http://localhost:${config.port}${filePath}`;
     const navOptions = { timeout: navMs, waitUntil: "commit" };
@@ -2150,7 +2432,7 @@ async function failOnNonWatchMode(watchMode = false, connections = {}, groupMode
     process.exit(1);
   }
 }
-async function flushConsoleHandlers(handlers, deadline = Date.now() + 2e3) {
+async function flushConsoleHandlers(handlers, deadline = Date.now() + CONSOLE_FLUSH_TIMEOUT_MS) {
   if (!handlers || handlers.size === 0 || Date.now() >= deadline) return;
   await Promise.allSettled([...handlers]);
   return flushConsoleHandlers(handlers, deadline);
@@ -2160,7 +2442,7 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
     cachedContent._buildError = null;
     cachedContent._noTestsWarning = null;
   });
-  const { projectRoot, debug, watch, browser } = groupConfigs[0];
+  const { projectRoot, debug, browser } = groupConfigs[0];
   const activeGroups = groupConfigs.reduce(
     (acc, groupConfig, groupIndex) => {
       const files = Object.keys(groupConfig.fsTree);
@@ -2181,10 +2463,10 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
     );
   await Promise.all(
     activeGroups.map(
-      (group) => fs9.mkdir(`${group.config.projectRoot}/${group.config.output}`, { recursive: true })
+      (group) => fs9.mkdir(path7.resolve(group.config.projectRoot, group.config.output), { recursive: true })
     )
   );
-  const sourcemap = debug ? "inline" : watch ? "linked" : false;
+  const sourcemap = "inline";
   const groupEntryPlugin = {
     name: "group-entry-loader",
     setup(build) {
@@ -2195,12 +2477,13 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
       build.onLoad({ filter: /.*/, namespace: "group-entry" }, (args) => {
         const slotIndex = parseInt(args.path.replace("group-entry-", ""));
         return {
-          contents: activeGroups[slotIndex].files.map((filePath) => `import "${filePath}";`).join(""),
+          contents: activeGroups[slotIndex].files.map((filePath) => `import "${toEsbuildImportPath(filePath)}";`).join(""),
           resolveDir: process.cwd()
         };
       });
     }
   };
+  const esbuildOutdir = path7.join(projectRoot, "tmp");
   const buildOptions = {
     entryPoints: activeGroups.map((_, slotIndex) => ({
       in: `group-entry-${slotIndex}`,
@@ -2212,7 +2495,7 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
     logLevel: "silent",
     // outdir only labels the paths in outputFiles[].path — nothing is written to disk
     // (write:false). Use projectRoot/tmp as a stable sentinel; mkdir is not required.
-    outdir: path5.join(projectRoot, "tmp"),
+    outdir: esbuildOutdir,
     keepNames: true,
     legalComments: "none",
     target: esbuildTarget(browser),
@@ -2238,8 +2521,17 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
         const slotIndex = parseInt(match[1]);
         const isMap = Boolean(match[2]);
         const { config, cachedContent } = activeGroups[slotIndex];
-        const destPath = `${config.projectRoot}/${config.output}/tests.js${isMap ? ".map" : ""}`;
-        if (!isMap) cachedContent.allTestCode = Buffer.from(outputFile.contents);
+        const destPath = path7.join(
+          path7.resolve(config.projectRoot, config.output),
+          "tests.js" + (isMap ? ".map" : "")
+        );
+        if (!isMap) {
+          cachedContent.allTestCode = Buffer.from(outputFile.contents);
+          config._sourceMapDecoder = extractInlineSourceMap(
+            cachedContent.allTestCode,
+            esbuildOutdir
+          );
+        }
         return fs9.writeFile(destPath, outputFile.contents);
       })
     );
@@ -2249,7 +2541,10 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
     await Promise.all(
       activeGroups.map((group) => {
         group.cachedContent._buildError = buildError;
-        return fs9.writeFile(`${group.config.projectRoot}/${group.config.output}/index.html`, errorHtml).catch(
+        return fs9.writeFile(
+          path7.join(path7.resolve(group.config.projectRoot, group.config.output), "index.html"),
+          errorHtml
+        ).catch(
           (err) => debug && process.stderr.write(`# [qunitx] writeFile index.html: ${err.message}
 `)
         );
@@ -2258,7 +2553,7 @@ async function buildAllGroupBundles(groupConfigs, groupCachedContents) {
     throw error;
   }
 }
-var BundleError, ancestorNodeModules, ANCESTOR_NODE_MODULES, RETRY_DELAY_MS, MAX_RETRIES, EMPTY_BUNDLE_THRESHOLD, GROUP_OUTPUT_REGEX;
+var BundleError, ancestorNodeModules, ANCESTOR_NODE_MODULES, RETRY_DELAY_MS, MAX_RETRIES, EMPTY_BUNDLE_THRESHOLD, NAV_GRACE_MS, STARTUP_TIMEOUT_FACTOR, TESTS_JS_TIMEOUT_FACTOR, CONSOLE_FLUSH_TIMEOUT_MS, TEST_STALL_BUFFER_MS, GROUP_OUTPUT_REGEX;
 var init_tests_in_browser = __esm({
   "lib/commands/run/tests-in-browser.ts"() {
     init_color();
@@ -2267,6 +2562,7 @@ var init_tests_in_browser = __esm({
     init_run_user_module();
     init_display_final_result();
     init_web_server();
+    init_source_map_decoder();
     BundleError = class extends Error {
       constructor(message) {
         super(message);
@@ -2274,13 +2570,18 @@ var init_tests_in_browser = __esm({
         this.message = `esbuild Bundle Error: ${message}`.split("\n").join("\n# ");
       }
     };
-    ancestorNodeModules = (dir) => dir.split(path5.sep).map(
-      (_, i, parts) => path5.join(parts.slice(0, parts.length - i).join(path5.sep) || path5.sep, "node_modules")
+    ancestorNodeModules = (dir) => dir.split(path7.sep).map(
+      (_, i, parts) => path7.join(parts.slice(0, parts.length - i).join(path7.sep) || path7.sep, "node_modules")
     );
     ANCESTOR_NODE_MODULES = ancestorNodeModules(process.cwd());
     RETRY_DELAY_MS = 100;
     MAX_RETRIES = 3;
     EMPTY_BUNDLE_THRESHOLD = 500;
+    NAV_GRACE_MS = 1e4;
+    STARTUP_TIMEOUT_FACTOR = 3;
+    TESTS_JS_TIMEOUT_FACTOR = 4;
+    CONSOLE_FLUSH_TIMEOUT_MS = 2e3;
+    TEST_STALL_BUFFER_MS = 5e3;
     GROUP_OUTPUT_REGEX = /group-(\d+)\.js(\.map)?$/;
   }
 });
@@ -2288,7 +2589,7 @@ var init_tests_in_browser = __esm({
 // lib/setup/file-watcher.ts
 import fs10 from "node:fs";
 import { stat, lstat } from "node:fs/promises";
-import path6 from "node:path";
+import path8 from "node:path";
 function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFunc) {
   const extensions = config.extensions || ["js", "ts"];
   const readyPromises = [];
@@ -2297,16 +2598,20 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
   const symlinkPollers = /* @__PURE__ */ new Map();
   function trackSymlink(filePath) {
     if (symlinkPollers.has(filePath)) return;
-    const handler = (curr) => {
+    const handler = (curr, prev) => {
       if (curr.nlink === 0) {
         fs10.unwatchFile(filePath, handler);
         symlinkPollers.delete(filePath);
         if (filePath in config.fsTree) {
           handleWatchEvent(config, extensions, "unlink", filePath, onEventFunc, onFinishFunc);
         }
+      } else if ((process.platform === "win32" || process.platform === "darwin") && curr.mtimeMs !== prev.mtimeMs) {
+        if (filePath in config.fsTree) {
+          handleWatchEvent(config, extensions, "change", filePath, onEventFunc, onFinishFunc);
+        }
       }
     };
-    fs10.watchFile(filePath, { interval: 500, persistent: false }, handler);
+    fs10.watchFile(filePath, { interval: SYMLINK_POLL_INTERVAL_MS, persistent: false }, handler);
     symlinkPollers.set(filePath, () => fs10.unwatchFile(filePath, handler));
   }
   function untrackSymlink(filePath) {
@@ -2315,18 +2620,23 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
   }
   for (const watchPath of testFileLookupPaths) {
     let ready = false;
-    const lastChangeMs = {};
+    const lastEventMs = {};
+    const seenMtimeMs = {};
     const childWatcher = fs10.watch(watchPath, { recursive: true }, async (eventType, filename) => {
       if (!ready || !filename) return;
-      const fullPath = filename === path6.basename(watchPath) ? watchPath : path6.join(watchPath, filename);
+      const fullPath = filename === path8.basename(watchPath) ? watchPath : path8.join(watchPath, filename);
       if (eventType === "change") {
-        if (!config._building) {
-          const now = Date.now();
-          const last = lastChangeMs[fullPath] ?? 0;
-          if (now - last < CHANGE_DEDUPE_MS) {
-            if (!config._lastBuildEndMs || config._lastBuildEndMs <= last) return;
-          }
-          lastChangeMs[fullPath] = now;
+        const now = Date.now();
+        const last = lastEventMs[fullPath] ?? 0;
+        lastEventMs[fullPath] = now;
+        try {
+          const { mtimeMs } = await stat(fullPath);
+          const prevMtime = seenMtimeMs[fullPath] ?? 0;
+          seenMtimeMs[fullPath] = mtimeMs;
+          if (now - last < CHANGE_DEDUPE_MS && mtimeMs > 0 && mtimeMs === prevMtime) return;
+          if (config._lastBuildEndMs && mtimeMs < Math.floor(config._lastBuildEndMs / 1e3) * 1e3)
+            return;
+        } catch {
         }
         return handleWatchEvent(config, extensions, "change", fullPath, onEventFunc, onFinishFunc);
       }
@@ -2343,8 +2653,8 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
       }
       handleWatchEvent(config, extensions, event, fullPath, onEventFunc, onFinishFunc);
     });
-    const parentDir = path6.dirname(watchPath);
-    const watchedBasename = path6.basename(watchPath);
+    const parentDir = path8.dirname(watchPath);
+    const watchedBasename = path8.basename(watchPath);
     let parentUnlinkFired = false;
     const parentWatcher = fs10.watch(parentDir, async (eventType, filename) => {
       if (!ready || filename !== watchedBasename || eventType !== "rename") return;
@@ -2396,18 +2706,20 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
   };
 }
 async function classifyRenameEvent(fullPath, fsTree) {
-  for (const delay of [0, 50]) {
+  for (const delay of [0, OVERLAYFS_RENAME_RETRY_MS]) {
     if (delay) await new Promise((resolve) => setTimeout(resolve, delay));
     try {
       const statResult = await stat(fullPath);
-      return statResult.isDirectory() ? "addDir" : "add";
+      if (statResult.isDirectory()) return "addDir";
+      return fsTree && fullPath in fsTree ? "change" : "add";
     } catch {
     }
   }
   if (!fsTree) return null;
   if (fullPath in fsTree) return "unlink";
-  const dirPrefix = fullPath + "/";
-  return Object.keys(fsTree).some((trackedPath) => trackedPath.startsWith(dirPrefix)) ? "unlinkDir" : null;
+  return Object.keys(fsTree).some(
+    (trackedPath) => trackedPath.startsWith(fullPath + "/") || trackedPath.startsWith(fullPath + "\\")
+  ) ? "unlinkDir" : null;
 }
 function handleWatchEvent(config, extensions, event, filePath, onEventFunc, onFinishFunc) {
   if (event !== "unlinkDir" && !extensions.some((ext) => filePath.endsWith(`.${ext}`)))
@@ -2447,15 +2759,15 @@ function handleWatchEvent(config, extensions, event, filePath, onEventFunc, onFi
     }
   });
 }
-function mutateFSTree(fsTree, event, path7) {
+function mutateFSTree(fsTree, event, filePath) {
   if (event === "add") {
-    fsTree[path7] = null;
+    fsTree[filePath] = null;
   } else if (event === "unlink") {
-    delete fsTree[path7];
+    delete fsTree[filePath];
   } else if (event === "unlinkDir") {
-    const dirPrefix = path7.endsWith("/") ? path7 : path7 + "/";
     for (const treePath of Object.keys(fsTree)) {
-      if (treePath.startsWith(dirPrefix)) delete fsTree[treePath];
+      if (treePath.startsWith(filePath + "/") || treePath.startsWith(filePath + "\\"))
+        delete fsTree[treePath];
     }
   }
 }
@@ -2464,11 +2776,13 @@ function colorEvent(event) {
   if (event === "add" || event === "addDir") return green("ADDED:");
   return red("REMOVED:");
 }
-var CHANGE_DEDUPE_MS;
+var CHANGE_DEDUPE_MS, SYMLINK_POLL_INTERVAL_MS, OVERLAYFS_RENAME_RETRY_MS;
 var init_file_watcher = __esm({
   "lib/setup/file-watcher.ts"() {
     init_color();
     CHANGE_DEDUPE_MS = 10;
+    SYMLINK_POLL_INTERVAL_MS = 500;
+    OVERLAYFS_RENAME_RETRY_MS = 50;
   }
 });
 
@@ -2549,24 +2863,27 @@ var init_keyboard_events = __esm({
 
 // lib/setup/write-output-static-files.ts
 import fs11 from "node:fs/promises";
+import path9 from "node:path";
 async function writeOutputStaticFiles({ projectRoot, output }, cachedContent) {
   const staticHTMLPromises = Object.keys(cachedContent.staticHTMLs).map(async (staticHTMLKey) => {
-    const htmlRelativePath = staticHTMLKey.replace(`${projectRoot}/`, "");
-    await ensureFolderExists(`${projectRoot}/${output}/${htmlRelativePath}`);
+    const htmlRelativePath = path9.relative(projectRoot, staticHTMLKey);
+    const outDir = path9.resolve(projectRoot, output);
+    await ensureFolderExists(path9.join(outDir, htmlRelativePath));
     await fs11.writeFile(
-      `${projectRoot}/${output}/${htmlRelativePath}`,
+      path9.join(outDir, htmlRelativePath),
       cachedContent.staticHTMLs[staticHTMLKey]
     );
   });
   const assetPromises = Array.from(cachedContent.assets).map(async (assetAbsolutePath) => {
-    const assetRelativePath = assetAbsolutePath.replace(`${projectRoot}/`, "");
-    await ensureFolderExists(`${projectRoot}/${output}/${assetRelativePath}`);
-    await fs11.copyFile(assetAbsolutePath, `${projectRoot}/${output}/${assetRelativePath}`);
+    const assetRelativePath = path9.relative(projectRoot, assetAbsolutePath);
+    const outDir = path9.resolve(projectRoot, output);
+    await ensureFolderExists(path9.join(outDir, assetRelativePath));
+    await fs11.copyFile(assetAbsolutePath, path9.join(outDir, assetRelativePath));
   });
   await Promise.all(staticHTMLPromises.concat(assetPromises));
 }
 async function ensureFolderExists(assetPath) {
-  await fs11.mkdir(assetPath.split("/").slice(0, -1).join("/"), { recursive: true });
+  await fs11.mkdir(path9.dirname(assetPath), { recursive: true });
 }
 var init_write_output_static_files = __esm({
   "lib/setup/write-output-static-files.ts"() {
@@ -2585,7 +2902,11 @@ import fs12 from "node:fs/promises";
 import { normalize } from "node:path";
 import { availableParallelism } from "node:os";
 async function run(config) {
-  const cachedContent = await buildCachedContent(config, config.htmlPaths);
+  const browserPromise = config.watch ? null : launchBrowser(config);
+  const [cachedContent, timings] = await Promise.all([
+    buildCachedContent(config, config.htmlPaths),
+    config.watch ? Promise.resolve(null) : readTimingCache(config.projectRoot)
+  ]);
   if (config.watch) {
     const preBuildPromise = buildTestBundle(config, cachedContent);
     preBuildPromise.catch(() => {
@@ -2595,7 +2916,7 @@ async function run(config) {
       setupBrowser(config, cachedContent),
       writeOutputStaticFiles(config, cachedContent)
     ]);
-    config.expressApp = connections.server;
+    config.webServer = connections.server;
     setupKeyboardEvents(config, cachedContent, connections);
     const isHeadedWatchMode = config.open === true && config.watch;
     if (config.open && !isHeadedWatchMode) {
@@ -2614,7 +2935,10 @@ async function run(config) {
       throw error;
     }
     if (isHeadedWatchMode && (cachedContent._buildError || cachedContent._noTestsWarning)) {
-      await connections.page.goto(`http://localhost:${config.port}/`, { waitUntil: "commit", timeout: 5e3 }).catch(() => {
+      await connections.page.goto(`http://localhost:${config.port}/`, {
+        waitUntil: "commit",
+        timeout: WATCH_NAV_TIMEOUT_MS
+      }).catch(() => {
       });
     }
     if (config.watch) {
@@ -2631,6 +2955,10 @@ async function run(config) {
                 `# Rerun triggered: ${event} \u2192 ${file.replace(`${config.projectRoot}/`, "")}`
               );
             }
+            const rebuildPromise = buildTestBundle(config, cachedContent);
+            rebuildPromise.catch(() => {
+            });
+            cachedContent._preBuildPromise = rebuildPromise;
             return await runTestsInBrowser(config, cachedContent, connections);
           }
           if (config.debug) {
@@ -2643,7 +2971,10 @@ async function run(config) {
         async (_path, _event) => {
           connections.server.publish("refresh");
           if (isHeadedWatchMode && (cachedContent._buildError || cachedContent._noTestsWarning)) {
-            await connections.page.goto(`http://localhost:${config.port}/`, { waitUntil: "commit", timeout: 5e3 }).catch(() => {
+            await connections.page.goto(`http://localhost:${config.port}/`, {
+              waitUntil: "commit",
+              timeout: WATCH_NAV_TIMEOUT_MS
+            }).catch(() => {
             });
           }
         }
@@ -2654,8 +2985,7 @@ async function run(config) {
   } else {
     const allFiles = Object.keys(config.fsTree);
     const groupCount = Math.min(allFiles.length, availableParallelism());
-    const timings = await readTimingCache(config.projectRoot);
-    const { groups, weights } = await splitIntoGroups(allFiles, groupCount, timings);
+    const { groups, weights } = await splitIntoGroups(allFiles, groupCount, timings ?? {});
     config.COUNTER = {
       testCount: 0,
       failCount: 0,
@@ -2687,7 +3017,7 @@ async function run(config) {
 `
     );
     const [browser] = await Promise.all([
-      launchBrowser(config),
+      browserPromise,
       sharedServer ? bindServerToPort(sharedServer, config).then(
         () => groupConfigs.forEach((gc, i) => {
           gc.port = config.port;
@@ -2708,7 +3038,7 @@ async function run(config) {
     const wallTimes = /* @__PURE__ */ new Map();
     const GROUP_TIMEOUT_MS = 3 * 60 * 1e3;
     const keepAlive = setInterval(() => {
-    }, 1e4);
+    }, KEEP_ALIVE_INTERVAL_MS);
     const groupResults = await Promise.allSettled(
       groupConfigs.map((groupConfig, i) => {
         const groupTimeout = new Promise((_, reject) => {
@@ -2734,7 +3064,7 @@ async function run(config) {
             browser,
             sharedServer
           );
-          groupConfig.expressApp = connections.server;
+          groupConfig.webServer = connections.server;
           if (config.before) {
             await runUserModule(`${process.cwd()}/${config.before}`, groupConfig, "before");
           }
@@ -2749,7 +3079,7 @@ async function run(config) {
               Promise.race([
                 connections.page.close(),
                 new Promise((resolve) => {
-                  const pageCloseTimeoutId = setTimeout(resolve, 1e4);
+                  const pageCloseTimeoutId = setTimeout(resolve, PAGE_CLOSE_GRACE_MS);
                   pageCloseTimeoutId.unref();
                 })
               ]).catch(() => {
@@ -2783,15 +3113,14 @@ async function run(config) {
       (err) => config.debug && process.stderr.write(`# [qunitx] persistTimings: ${err.message}
 `)
     );
-    printFileTimings(fileTimes, config.projectRoot);
+    if (config.debug) printFileTimings(fileTimes, config.projectRoot);
     if (config.after) {
       await runUserModule(`${process.cwd()}/${config.after}`, config.COUNTER, "after");
     }
-    const exitTimer = setTimeout(() => process.exit(exitCode), 5e3);
+    const exitTimer = setTimeout(() => process.exit(exitCode), STDOUT_FLUSH_GRACE_MS);
     exitTimer.unref();
     process.stdout.write("\n", async () => {
       clearTimeout(exitTimer);
-      clearInterval(keepAlive);
       await Promise.all([
         sharedServer?.close().catch(
           (err) => config.debug && process.stderr.write(`# [qunitx] server.close: ${err.message}
@@ -2803,6 +3132,7 @@ async function run(config) {
         )
       ]);
       await shutdownPrelaunch();
+      clearInterval(keepAlive);
       process.exit(exitCode);
     });
   }
@@ -2931,6 +3261,7 @@ function normalizeInternalAssetPathFromHTML(projectRoot, assetPath, htmlPath) {
   const currentDirectory = htmlPath ? htmlPath.split("/").slice(0, -1).join("/") : projectRoot;
   return assetPath.startsWith("./") ? normalize(`${currentDirectory}/${assetPath.slice(2)}`) : normalize(`${currentDirectory}/${assetPath}`);
 }
+var WATCH_NAV_TIMEOUT_MS, PAGE_CLOSE_GRACE_MS, STDOUT_FLUSH_GRACE_MS, KEEP_ALIVE_INTERVAL_MS;
 var init_run = __esm({
   "lib/commands/run.ts"() {
     init_browser();
@@ -2950,6 +3281,10 @@ var init_run = __esm({
     init_display_final_result();
     init_read_template();
     init_html();
+    WATCH_NAV_TIMEOUT_MS = 5e3;
+    PAGE_CLOSE_GRACE_MS = 1e4;
+    STDOUT_FLUSH_GRACE_MS = 5e3;
+    KEEP_ALIVE_INTERVAL_MS = 1e4;
   }
 });
 
@@ -2964,7 +3299,7 @@ init_color();
 var package_default = {
   name: "qunitx-cli",
   type: "module",
-  version: "0.19.3",
+  version: "0.21.0",
   description: "Browser runner for QUnitx: run your qunitx tests in google-chrome",
   author: "Izel Nakri",
   license: "MIT",
@@ -3019,12 +3354,10 @@ var package_default = {
     ws: "^8.20.0"
   },
   devDependencies: {
-    cors: "^2.8.6",
-    express: "^5.2.1",
     "js-yaml": "^4.1.1",
-    prettier: "^3.8.2",
-    qunitx: "^1.2.7",
-    typescript: "^6.0.2"
+    prettier: "^3.8.3",
+    qunitx: "^1.2.8",
+    typescript: "^6.0.3"
   },
   volta: {
     node: "24.14.0"
@@ -3082,9 +3415,9 @@ import process2 from "node:process";
 
 // lib/utils/path-exists.ts
 import fs2 from "node:fs/promises";
-async function pathExists(path7) {
+async function pathExists(path10) {
   try {
-    await fs2.access(path7);
+    await fs2.access(path10);
     return true;
   } catch {
     return false;
@@ -3156,7 +3489,7 @@ async function writeTestsHTML(projectRoot, config, oldPackageJSON) {
         const targetDirectory = path2.dirname(targetPath);
         const _targetOutputPath = path2.relative(
           targetDirectory,
-          `${projectRoot}/${config.output}/tests.js`
+          path2.join(path2.resolve(projectRoot, config.output), "tests.js")
         );
         const testHTMLTemplate = testHTMLTemplateBuffer.replace(
           "{{applicationName}}",
@@ -3202,17 +3535,17 @@ function pathToModuleName(filePath) {
 async function generateTestFiles() {
   const projectRoot = await findProjectRoot();
   const moduleName = pathToModuleName(process.argv[3]);
-  const path7 = process.argv[3].endsWith(".js") || process.argv[3].endsWith(".ts") ? `${projectRoot}/${process.argv[3]}` : `${projectRoot}/${process.argv[3]}.js`;
-  if (await pathExists(path7)) {
-    console.log(`${path7} already exists!`);
+  const path10 = process.argv[3].endsWith(".js") || process.argv[3].endsWith(".ts") ? `${projectRoot}/${process.argv[3]}` : `${projectRoot}/${process.argv[3]}.js`;
+  if (await pathExists(path10)) {
+    console.log(`${path10} already exists!`);
     return;
   }
   const testJSContent = await readTemplate("test.js");
-  const targetFolderPaths = path7.split("/");
+  const targetFolderPaths = path10.split("/");
   targetFolderPaths.pop();
   await fs5.mkdir(targetFolderPaths.join("/"), { recursive: true });
-  await fs5.writeFile(path7, testJSContent.replace("{{moduleName}}", moduleName));
-  console.log(green(`${path7} written`));
+  await fs5.writeFile(path10, testJSContent.replace("{{moduleName}}", moduleName));
+  console.log(green(`${path10} written`));
 }
 
 // lib/setup/config.ts
@@ -3313,23 +3646,25 @@ function setupTestFilePaths(_projectRoot, inputs2) {
   });
   return result.map((metaItem) => metaItem.input);
 }
-function pathIsFile(path7) {
-  const inputs2 = path7.split("/");
+function pathIsFile(path10) {
+  const inputs2 = path10.split("/");
   return inputs2[inputs2.length - 1].includes(".");
 }
 function pathIsIncludedInPaths(paths, targetPath) {
-  return paths.some((path7) => {
-    if (path7 === targetPath) {
+  return paths.some((path10) => {
+    if (path10 === targetPath) {
       return false;
     }
-    return matchesGlob(targetPath.input, buildGlobFormat(path7));
+    return matchesGlob(targetPath.input, buildGlobFormat(path10));
   });
 }
-function buildGlobFormat(path7) {
-  return path7.isFile ? path7.input : `${path7.input}/**`;
+function buildGlobFormat(path10) {
+  return path10.isFile ? path10.input : `${path10.input}/**`;
 }
 
 // lib/utils/parse-cli-flags.ts
+import path4 from "node:path";
+var FALLBACK_TIMEOUT_MS = 1e4;
 function parseCliFlags(projectRoot) {
   const providedFlags = process.argv.slice(2).reduce(
     (result, arg) => {
@@ -3344,7 +3679,7 @@ function parseCliFlags(projectRoot) {
       } else if (arg.startsWith("--failfast") || arg.startsWith("--failFast")) {
         return Object.assign(result, { failFast: parseBoolean(arg.split("=")[1]) });
       } else if (arg.startsWith("--timeout")) {
-        return Object.assign(result, { timeout: Number(arg.split("=")[1]) || 1e4 });
+        return Object.assign(result, { timeout: Number(arg.split("=")[1]) || FALLBACK_TIMEOUT_MS });
       } else if (arg.startsWith("--output")) {
         return Object.assign(result, { output: arg.split("=")[1] });
       } else if (arg.endsWith(".html")) {
@@ -3381,12 +3716,22 @@ function parseCliFlags(projectRoot) {
         return result;
       }
       result.inputs.add(
-        arg.startsWith(projectRoot) || arg.startsWith("/") ? arg : `${process.cwd()}/${arg}`
+        arg.startsWith(projectRoot) || arg.startsWith("/") ? arg : path4.join(process.cwd(), arg)
       );
       return result;
     },
     { inputs: /* @__PURE__ */ new Set([]) }
   );
+  if (!providedFlags.browser && process.env.QUNITX_BROWSER) {
+    const envBrowser = process.env.QUNITX_BROWSER;
+    if (!["chromium", "firefox", "webkit"].includes(envBrowser)) {
+      console.error(
+        `Invalid QUNITX_BROWSER value: "${envBrowser}". Must be one of: chromium, firefox, webkit`
+      );
+      process.exit(1);
+    }
+    providedFlags.browser = envBrowser;
+  }
   return { ...providedFlags, inputs: Array.from(providedFlags.inputs) };
 }
 function parseBoolean(result, defaultValue = true) {