From f39c9ff0f54af3dce395bf068d377e358ba3aec1 Mon Sep 17 00:00:00 2001
From: aryansk <aryansk@users.noreply.github.com>
Date: Sun, 23 Aug 2026 19:02:22 +0530
Subject: [PATCH] Fix Windows console window for chrome-headless-shell

Every 'npx hyperframes render' on Windows flashed a visible CMD
window for each shot (78 windows for 78 shots). chrome-headless-shell
is a console-subsystem binary, so Node's spawn shows a console
window unless windowsHide:true (CREATE_NO_WINDOW) is set.

Puppeteer-core's launch spawns the browser via child_process.spawn
without windowsHide by default. Add windowsHide:true to all
puppeteer.launch sites so the browser is hidden on Windows.

Fixes #3430
---
 packages/cli/src/beats/headlessAnalyzer.ts          |  2 ++
 packages/cli/src/capture/captureCompositionFrame.ts |  2 ++
 packages/cli/src/capture/index.ts                   |  2 ++
 packages/cli/src/commands/layout.ts                 |  2 ++
 packages/cli/src/commands/motionShot.ts             |  2 ++
 packages/cli/src/commands/validate.ts               |  2 ++
 packages/engine/src/services/browserManager.ts      | 12 ++++++++++--
 packages/producer/src/parity-harness.ts             |  2 ++
 packages/studio/vite.browser.ts                     |  2 ++
 9 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/packages/cli/src/beats/headlessAnalyzer.ts b/packages/cli/src/beats/headlessAnalyzer.ts
index e532955bfd..cc189419eb 100644
--- a/packages/cli/src/beats/headlessAnalyzer.ts
+++ b/packages/cli/src/beats/headlessAnalyzer.ts
@@ -140,6 +140,8 @@ export async function analyzeBeatsHeadless(audioBytes: Buffer): Promise<Headless
   const browser = await ensureBrowser();
   const chrome: Browser = await puppeteer.default.launch({
     headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
     executablePath: browser.executablePath,
     args: ["--no-sandbox", "--disable-dev-shm-usage", "--autoplay-policy=no-user-gesture-required"],
   });
diff --git a/packages/cli/src/capture/captureCompositionFrame.ts b/packages/cli/src/capture/captureCompositionFrame.ts
index af20c32ad2..32cdb21802 100644
--- a/packages/cli/src/capture/captureCompositionFrame.ts
+++ b/packages/cli/src/capture/captureCompositionFrame.ts
@@ -182,6 +182,8 @@ export async function openSettledCompositionPage(
   try {
     chromeBrowser = await puppeteer.default.launch({
       headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
       executablePath: browser.executablePath,
       args: buildChromeArgs(
         { ...viewport, captureMode: "screenshot" },
diff --git a/packages/cli/src/capture/index.ts b/packages/cli/src/capture/index.ts
index cdcbfd1e9c..41dbaa63df 100644
--- a/packages/cli/src/capture/index.ts
+++ b/packages/cli/src/capture/index.ts
@@ -128,6 +128,8 @@ export async function captureWebsite(
   const puppeteer = await import("puppeteer-core");
   const chromeBrowser = await puppeteer.default.launch({
     headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
     executablePath: browser.executablePath,
     protocolTimeout: captureProtocolTimeoutMs(timeout, budgetMs),
     args: [
diff --git a/packages/cli/src/commands/layout.ts b/packages/cli/src/commands/layout.ts
index 42bd3bb305..fa8ce5c43e 100644
--- a/packages/cli/src/commands/layout.ts
+++ b/packages/cli/src/commands/layout.ts
@@ -223,6 +223,8 @@ async function runLayoutAudit(
     assertWebGpuRequirement(html, requestedGpuMode, resolvedGpuMode);
     chromeBrowser = await puppeteer.default.launch({
       headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
       executablePath: browser.executablePath,
       args: buildChromeArgs(
         { width: 1920, height: 1080, captureMode: "screenshot" },
diff --git a/packages/cli/src/commands/motionShot.ts b/packages/cli/src/commands/motionShot.ts
index 31c8d08380..9665a5c799 100644
--- a/packages/cli/src/commands/motionShot.ts
+++ b/packages/cli/src/commands/motionShot.ts
@@ -293,6 +293,8 @@ async function openCompositionPage(
   assertWebGpuRequirement(html, requestedGpuMode, resolvedGpuMode);
   const browser = await puppeteer.default.launch({
     headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
     executablePath,
     args: buildChromeArgs(
       { ...size, captureMode: "screenshot" },
diff --git a/packages/cli/src/commands/validate.ts b/packages/cli/src/commands/validate.ts
index e25989d7c0..f0d5ce3762 100644
--- a/packages/cli/src/commands/validate.ts
+++ b/packages/cli/src/commands/validate.ts
@@ -428,6 +428,8 @@ async function validateInBrowser(
     assertWebGpuRequirement(html, requestedGpuMode, resolvedGpuMode);
     const chromeBrowser = await puppeteer.default.launch({
       headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
       executablePath: browser.executablePath,
       args: buildChromeArgs(
         { ...viewport, captureMode: "screenshot" },
diff --git a/packages/engine/src/services/browserManager.ts b/packages/engine/src/services/browserManager.ts
index d77ad0dcd9..66e93b3bad 100644
--- a/packages/engine/src/services/browserManager.ts
+++ b/packages/engine/src/services/browserManager.ts
@@ -77,7 +77,11 @@ async function probeHardwareWebGlInfo(
       defaultViewport: { width: 64, height: 64 },
       executablePath: options.executablePath,
       timeout: options.browserTimeout,
-    });
+      // Prevent visible console window on Windows for console-subsystem
+      // chrome-headless-shell.exe (see #3430).
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
+    } as any);
     const page = await probeBrowser.newPage();
     return await page.evaluate(() => {
       const unavailable = { hasWebGL: false, vendor: "", renderer: "" };
@@ -701,7 +705,11 @@ async function launchBrowser(
       executablePath: fingerprint.executablePath,
       timeout: fingerprint.browserTimeoutMs,
       protocolTimeout: fingerprint.protocolTimeoutMs,
-    });
+      // Prevent visible console window on Windows for console-subsystem
+      // chrome-headless-shell.exe (see #3430).
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
+    } as any);
 
     const browserVersion = await browser.version().catch(() => "unknown");
     const gpuFlags = fingerprint.args.filter(
diff --git a/packages/producer/src/parity-harness.ts b/packages/producer/src/parity-harness.ts
index e390ac81f8..3b29ad6cd9 100644
--- a/packages/producer/src/parity-harness.ts
+++ b/packages/producer/src/parity-harness.ts
@@ -314,6 +314,8 @@ async function run(): Promise<void> {
   const browser = await puppeteer.launch({
     ...browserTarget,
     headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
     defaultViewport: {
       width: options.width,
       height: options.height,
diff --git a/packages/studio/vite.browser.ts b/packages/studio/vite.browser.ts
index d2c06a9873..a614859b4e 100644
--- a/packages/studio/vite.browser.ts
+++ b/packages/studio/vite.browser.ts
@@ -103,6 +103,8 @@ async function getSharedBrowser(): Promise<import("puppeteer-core").Browser | nu
     if (!executablePath) return null;
     browser = await puppeteer.default.launch({
       headless: true,
+      // @ts-ignore -- windowsHide not in PuppeteerLaunchOptions but forwarded to spawn on Windows (see #3430)
+      windowsHide: true,
       executablePath,
       args: [
         "--no-sandbox",