extension-develop 3.3.1 → 3.3.3-mext.0

package/dist/module.js

@@ -128318,7 +128318,6 @@ var __webpack_modules__ = {
             f: ()=>ChromiumLaunchPlugin
         });
         var external_fs_ = __webpack_require__("fs");
-        var external_child_process_ = __webpack_require__("child_process");
         var external_chrome_location2_ = __webpack_require__("chrome-location2");
         var external_chrome_location2_default = /*#__PURE__*/ __webpack_require__.n(external_chrome_location2_);
         var external_chromium_location_ = __webpack_require__("chromium-location");
@@ -128440,6 +128439,7 @@ var __webpack_modules__ = {
             ];
             return baseFlags;
         }
+        var external_child_process_ = __webpack_require__("child_process");
         function setupProcessSignalHandlers(browser, child, cleanupInstance) {
             const cleanup = ()=>{
                 try {
@@ -128492,6 +128492,86 @@ var __webpack_modules__ = {
             console.log(messages.E8B(chromiumConfig.join(' ')));
         }
         var extension_output_path = __webpack_require__("./webpack/plugin-browsers/run-chromium/chromium-launch/extension-output-path.ts");
+        function isWslEnv() {
+            return Boolean(String(process.env.WSL_DISTRO_NAME || '').trim() || String(process.env.WSL_INTEROP || '').trim() || String(process.env.WSLENV || '').trim());
+        }
+        function normalizeBinaryPathForWsl(input) {
+            let value = String(input || '').trim();
+            if (!value) return value;
+            if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+            if (!isWslEnv()) return value;
+            if (/^[a-zA-Z]:[\\/]/.test(value)) {
+                const drive = value[0].toLowerCase();
+                const rest = value.slice(2).replace(/\\/g, '/').replace(/^\/+/, '');
+                return `/mnt/${drive}/${rest}`;
+            }
+            return value;
+        }
+        function resolveWslWindowsBinary(browser) {
+            if (!isWslEnv()) return null;
+            const chromeCandidates = [
+                '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe',
+                '/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'
+            ];
+            const chromiumCandidates = [
+                '/mnt/c/Program Files/Chromium/Application/chrome.exe',
+                '/mnt/c/Program Files (x86)/Chromium/Application/chrome.exe'
+            ];
+            const edgeCandidates = [
+                '/mnt/c/Program Files/Microsoft/Edge/Application/msedge.exe',
+                '/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
+            ];
+            const candidates = 'edge' === browser ? edgeCandidates : 'chromium' === browser || 'chromium-based' === browser ? [
+                ...chromiumCandidates,
+                ...chromeCandidates
+            ] : chromeCandidates;
+            for (const candidate of candidates)if (external_fs_.existsSync(candidate)) return candidate;
+            return null;
+        }
+        async function spawnChromiumProcess(opts) {
+            const { binary, launchArgs, stdio, browser, logger } = opts;
+            const isWin = 'win32' === process.platform;
+            const spawnOnce = async (bin)=>{
+                const child = (0, external_child_process_.spawn)(bin, launchArgs, {
+                    stdio,
+                    detached: false,
+                    ...isWin ? {
+                        windowsHide: true
+                    } : {},
+                    ...isWin && /\s/.test(bin) ? {
+                        shell: true
+                    } : {},
+                    ...'win32' !== process.platform && {
+                        group: process.getgid?.()
+                    }
+                });
+                await new Promise((resolve, reject)=>{
+                    const handleError = (error)=>{
+                        child.removeListener('spawn', handleSpawn);
+                        reject(error);
+                    };
+                    const handleSpawn = ()=>{
+                        child.removeListener('error', handleError);
+                        resolve();
+                    };
+                    child.once('error', handleError);
+                    child.once('spawn', handleSpawn);
+                });
+                return child;
+            };
+            try {
+                return await spawnOnce(binary);
+            } catch (error) {
+                if (isWslEnv()) {
+                    const fallback = resolveWslWindowsBinary(browser);
+                    if (fallback && fallback !== binary) {
+                        logger?.warn?.('[plugin-browsers] WSL detected: retrying with Windows browser binary.');
+                        return await spawnOnce(fallback);
+                    }
+                }
+                throw error;
+            }
+        }
         function _define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -128539,11 +128619,24 @@ var __webpack_modules__ = {
                 const browser = this.options?.browser;
                 let browserBinaryLocation = null;
                 let printedGuidance = false;
+                const normalizePath = (p)=>{
+                    if (!p) return null;
+                    const normalized = normalizeBinaryPathForWsl(p);
+                    return normalized || null;
+                };
                 try {
                     const resolved = output_binaries_resolver.kI(compilation, 'chromium' === browser || 'chromium-based' === browser ? 'chromium' : 'edge' === browser ? 'edge' : 'chrome');
-                    if (resolved && external_fs_.existsSync(resolved)) browserBinaryLocation = resolved;
+                    const normalized = normalizePath(resolved || null);
+                    if (normalized && external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
                 } catch  {}
-                const skipDetection = Boolean(browserBinaryLocation);
+                let skipDetection = Boolean(browserBinaryLocation);
+                if (!browserBinaryLocation && isWslEnv()) {
+                    const wslFallback = resolveWslWindowsBinary(browser);
+                    if (wslFallback) {
+                        browserBinaryLocation = wslFallback;
+                        skipDetection = true;
+                    }
+                }
                 const getBrowserVersionLine = (bin)=>{
                     try {
                         if ('edge' === browser) return (0, external_edge_location_.getEdgeVersion)(bin, {
@@ -128575,25 +128668,28 @@ var __webpack_modules__ = {
                                 const located = (0, external_chrome_location2_.locateChromeOrExplain)({
                                     allowFallback: true
                                 });
-                                if (located && external_fs_.existsSync(located)) {
-                                    const versionLine = getBrowserVersionLine(located);
-                                    if (looksOfficialChrome(versionLine)) {
+                                const normalized = normalizePath(located || null);
+                                if (normalized && external_fs_.existsSync(normalized)) {
+                                    const versionLine = getBrowserVersionLine(normalized);
+                                    if (looksOfficialChrome(versionLine) && !isWslEnv()) {
                                         this.printEnhancedPuppeteerInstallHint(compilation, getInstallGuidanceText(), browser);
                                         printedGuidance = true;
                                         browserBinaryLocation = null;
-                                    } else browserBinaryLocation = located;
+                                    } else browserBinaryLocation = normalized;
                                 } else browserBinaryLocation = null;
                             } catch (err) {
                                 let candidate = external_chrome_location2_default()(true) || null;
-                                if (candidate) {
-                                    const versionLine = getBrowserVersionLine(candidate);
-                                    if (looksOfficialChrome(versionLine)) {
+                                const normalized = normalizePath(candidate || null);
+                                if (normalized) {
+                                    const versionLine = getBrowserVersionLine(normalized);
+                                    if (looksOfficialChrome(versionLine) && !isWslEnv()) {
                                         this.printEnhancedPuppeteerInstallHint(compilation, getInstallGuidanceText(), browser);
                                         printedGuidance = true;
                                         candidate = null;
                                     }
                                 }
-                                browserBinaryLocation = candidate;
+                                browserBinaryLocation = normalized;
+                                if (!browserBinaryLocation) browserBinaryLocation = resolveWslWindowsBinary(browser);
                                 if (!browserBinaryLocation) throw err;
                             }
                         } catch (e) {
@@ -128606,25 +128702,40 @@ var __webpack_modules__ = {
                         console.log(messages.GqE(browser));
                         browserBinaryLocation = this.options?.chromiumBinary || null;
                         if (this.options?.chromiumBinary) {
-                            if (!external_fs_.existsSync(String(this.options.chromiumBinary))) {
+                            const normalized = normalizePath(String(this.options.chromiumBinary));
+                            if (!normalized || !external_fs_.existsSync(normalized)) {
                                 console.error(messages.Spm(String(this.options.chromiumBinary)));
                                 process.exit(1);
                             }
+                            browserBinaryLocation = normalized;
                         }
                         if (!browserBinaryLocation && !skipDetection) try {
                             const p = external_chromium_location_default()();
-                            if (p && 'string' == typeof p && external_fs_.existsSync(p)) browserBinaryLocation = p;
+                            const normalized = normalizePath(p || null);
+                            if (normalized && 'string' == typeof normalized) {
+                                if (external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
+                            }
                         } catch  {}
+                        if (!browserBinaryLocation) browserBinaryLocation = resolveWslWindowsBinary(browser);
                         break;
                     case 'edge':
                         console.log(messages.GqE(browser));
                         try {
                             const override = String(process.env.EDGE_BINARY || '').trim();
-                            if (override) if (external_fs_.existsSync(override)) browserBinaryLocation = override;
-                            else throw new Error('EDGE_BINARY points to a non-existent path');
-                            else {
-                                browserBinaryLocation = external_edge_location_default()();
+                            if (override) {
+                                const normalized = normalizePath(override);
+                                if (normalized && external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
+                                else throw new Error('EDGE_BINARY points to a non-existent path');
+                            } else {
+                                const located = external_edge_location_default()();
+                                const normalized = normalizePath(located || null);
+                                browserBinaryLocation = normalized;
                                 if (!browserBinaryLocation || !external_fs_.existsSync(String(browserBinaryLocation))) {
+                                    const fallback = resolveWslWindowsBinary(browser);
+                                    if (fallback) {
+                                        browserBinaryLocation = fallback;
+                                        break;
+                                    }
                                     const guidance = (()=>{
                                         try {
                                             return (0, external_edge_location_.getInstallGuidance)();
@@ -128647,28 +128758,38 @@ var __webpack_modules__ = {
                                     return 'npx playwright install msedge';
                                 }
                             })();
-                            this.printEnhancedPuppeteerInstallHint(compilation, guidance, 'edge');
-                            printedGuidance = true;
-                            browserBinaryLocation = null;
-                            if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Chromium launch failed');
-                            process.exit(1);
+                            const fallback = resolveWslWindowsBinary(browser);
+                            if (fallback) browserBinaryLocation = fallback;
+                            else {
+                                this.printEnhancedPuppeteerInstallHint(compilation, guidance, 'edge');
+                                printedGuidance = true;
+                                browserBinaryLocation = null;
+                            }
+                            if (!browserBinaryLocation) if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Chromium launch failed');
+                            else process.exit(1);
                         }
                         break;
                     case 'chromium-based':
                         browserBinaryLocation = this.options?.chromiumBinary || null;
                         if (this.options?.chromiumBinary) {
-                            if (!external_fs_.existsSync(String(this.options.chromiumBinary))) {
+                            const normalized = normalizePath(String(this.options.chromiumBinary));
+                            if (!normalized || !external_fs_.existsSync(normalized)) {
                                 console.error(messages.Spm(String(this.options.chromiumBinary)));
                                 process.exit(1);
                             }
+                            browserBinaryLocation = normalized;
                         } else {
                             console.error(messages.nek());
                             process.exit(1);
                         }
                         if (!browserBinaryLocation && !skipDetection) try {
                             const p = external_chromium_location_default()();
-                            if (p && 'string' == typeof p && external_fs_.existsSync(p)) browserBinaryLocation = p;
+                            const normalized = normalizePath(p || null);
+                            if (normalized && 'string' == typeof normalized) {
+                                if (external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
+                            }
                         } catch  {}
+                        if (!browserBinaryLocation) browserBinaryLocation = resolveWslWindowsBinary(browser);
                         break;
                     default:
                         try {
@@ -128676,25 +128797,28 @@ var __webpack_modules__ = {
                                 const located = (0, external_chrome_location2_.locateChromeOrExplain)({
                                     allowFallback: true
                                 });
-                                if (located && external_fs_.existsSync(located)) {
-                                    const versionLine = getBrowserVersionLine(located);
-                                    if (looksOfficialChrome(versionLine)) {
+                                const normalized = normalizePath(located || null);
+                                if (normalized && external_fs_.existsSync(normalized)) {
+                                    const versionLine = getBrowserVersionLine(normalized);
+                                    if (looksOfficialChrome(versionLine) && !isWslEnv()) {
                                         this.printEnhancedPuppeteerInstallHint(compilation, getInstallGuidanceText(), browser);
                                         printedGuidance = true;
                                         browserBinaryLocation = null;
-                                    } else browserBinaryLocation = located;
+                                    } else browserBinaryLocation = normalized;
                                 } else browserBinaryLocation = null;
                             } catch (err) {
                                 let candidate = external_chrome_location2_default()(true) || null;
-                                if (candidate) {
-                                    const versionLine = getBrowserVersionLine(candidate);
-                                    if (looksOfficialChrome(versionLine)) {
+                                const normalized = normalizePath(candidate || null);
+                                if (normalized) {
+                                    const versionLine = getBrowserVersionLine(normalized);
+                                    if (looksOfficialChrome(versionLine) && !isWslEnv()) {
                                         this.printEnhancedPuppeteerInstallHint(compilation, getInstallGuidanceText(), browser);
                                         printedGuidance = true;
                                         candidate = null;
                                     }
                                 }
-                                browserBinaryLocation = candidate;
+                                browserBinaryLocation = normalized;
+                                if (!browserBinaryLocation) browserBinaryLocation = resolveWslWindowsBinary(browser);
                                 if (!browserBinaryLocation) throw err;
                             }
                         } catch (e) {
@@ -128707,8 +128831,10 @@ var __webpack_modules__ = {
                 if (!browserBinaryLocation || !external_fs_.existsSync(browserBinaryLocation)) {
                     try {
                         const resolved = output_binaries_resolver.kI(compilation, 'chromium' === browser || 'chromium-based' === browser ? 'chromium' : 'edge' === browser ? 'edge' : 'chrome');
-                        if (resolved && external_fs_.existsSync(resolved)) browserBinaryLocation = resolved;
+                        const normalized = normalizePath(resolved || null);
+                        if (normalized && external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
                     } catch  {}
+                    if (!browserBinaryLocation) browserBinaryLocation = resolveWslWindowsBinary(browser);
                     if (!browserBinaryLocation || !external_fs_.existsSync(browserBinaryLocation)) {
                         if ('chromium' === browser || 'chromium-based' === browser) {
                             const chromiumGuidance = (()=>{
@@ -128827,13 +128953,14 @@ var __webpack_modules__ = {
                     ...chromeFlags
                 ];
                 const stdio = 'ignore';
+                const normalizedBinary = normalizeBinaryPathForWsl(binary);
                 try {
-                    const child = (0, external_child_process_.spawn)(`${binary}`, launchArgs, {
+                    const child = await spawnChromiumProcess({
+                        binary: normalizedBinary,
+                        launchArgs,
                         stdio,
-                        detached: false,
-                        ...'win32' !== process.platform && {
-                            group: process.getgid?.()
-                        }
+                        browser: this.options.browser,
+                        logger: this.logger
                     });
                     if ('true' === process.env.EXTENSION_AUTHOR_MODE) this.logger.debug?.('[plugin-browsers] Final Chrome flags:', launchArgs.join(' '));
                     child.on('close', (code)=>{
@@ -128931,13 +129058,13 @@ var __webpack_modules__ = {
             c: ()=>FirefoxLaunchPlugin
         });
         var external_fs_ = __webpack_require__("fs");
-        var external_child_process_ = __webpack_require__("child_process");
         var external_firefox_location2_ = __webpack_require__("firefox-location2");
         var external_firefox_location2_default = /*#__PURE__*/ __webpack_require__.n(external_firefox_location2_);
         var messages = __webpack_require__("./webpack/plugin-browsers/browsers-lib/messages.ts");
         var output_binaries_resolver = __webpack_require__("./webpack/plugin-browsers/browsers-lib/output-binaries-resolver.ts");
         var shared_utils = __webpack_require__("./webpack/plugin-browsers/browsers-lib/shared-utils.ts");
         var instance_registry = __webpack_require__("./webpack/plugin-browsers/browsers-lib/instance-registry.ts");
+        var external_child_process_ = __webpack_require__("child_process");
         function setupFirefoxProcessHandlers(browser, childRef, cleanupInstance) {
             let isCleaningUp = false;
             const attemptCleanup = async ()=>{
@@ -129717,6 +129844,64 @@ var __webpack_modules__ = {
                 }
             }
         }
+        function isWslEnv() {
+            return Boolean(String(process.env.WSL_DISTRO_NAME || '').trim() || String(process.env.WSL_INTEROP || '').trim() || String(process.env.WSLENV || '').trim());
+        }
+        function normalizeBinaryPathForWsl(input) {
+            let value = String(input || '').trim();
+            if (!value) return value;
+            if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+            if (!isWslEnv()) return value;
+            if (/^[a-zA-Z]:[\\/]/.test(value)) {
+                const drive = value[0].toLowerCase();
+                const rest = value.slice(2).replace(/\\/g, '/').replace(/^\/+/, '');
+                return `/mnt/${drive}/${rest}`;
+            }
+            return value;
+        }
+        function resolveWslWindowsBinary() {
+            if (!isWslEnv()) return null;
+            const candidates = [
+                '/mnt/c/Program Files/Mozilla Firefox/firefox.exe',
+                '/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'
+            ];
+            for (const candidate of candidates)if (external_fs_.existsSync(candidate)) return candidate;
+            return null;
+        }
+        async function spawnFirefoxProcess(opts) {
+            const { binary, args, stdio, fallbackBinary, logger } = opts;
+            const spawnOnce = async (bin)=>{
+                const child = (0, external_child_process_.spawn)(bin, args, {
+                    stdio,
+                    detached: false,
+                    ...'win32' === process.platform ? {
+                        windowsHide: true
+                    } : {}
+                });
+                await new Promise((resolve, reject)=>{
+                    const handleError = (error)=>{
+                        child.removeListener('spawn', handleSpawn);
+                        reject(error);
+                    };
+                    const handleSpawn = ()=>{
+                        child.removeListener('error', handleError);
+                        resolve();
+                    };
+                    child.once('error', handleError);
+                    child.once('spawn', handleSpawn);
+                });
+                return child;
+            };
+            try {
+                return await spawnOnce(binary);
+            } catch (error) {
+                if (isWslEnv() && fallbackBinary && fallbackBinary !== binary) {
+                    logger?.warn?.('[plugin-browsers] WSL detected: retrying with Windows Firefox binary.');
+                    return await spawnOnce(fallbackBinary);
+                }
+                throw error;
+            }
+        }
         function firefox_launch_define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -129779,42 +129964,65 @@ var __webpack_modules__ = {
                     return;
                 }
                 let browserBinaryLocation = (0, output_binaries_resolver.kI)(compilation, 'firefox') || null;
-                const skipDetection = Boolean(browserBinaryLocation);
+                if (browserBinaryLocation) {
+                    const normalized = normalizeBinaryPathForWsl(browserBinaryLocation);
+                    browserBinaryLocation = normalized && external_fs_.existsSync(normalized) ? normalized : null;
+                }
+                let skipDetection = Boolean(browserBinaryLocation);
                 const engineBased = 'gecko-based' === this.host.browser || 'firefox-based' === this.host.browser;
-                try {
-                    if (this.host.geckoBinary && 'string' == typeof this.host.geckoBinary) if (external_fs_.existsSync(this.host.geckoBinary)) browserBinaryLocation = this.host.geckoBinary;
-                    else {
-                        console.error(messages.DhR(this.host.geckoBinary));
-                        process.exit(1);
+                if (!browserBinaryLocation && !engineBased && isWslEnv()) {
+                    const wslFallback = resolveWslWindowsBinary();
+                    if (wslFallback) {
+                        browserBinaryLocation = wslFallback;
+                        skipDetection = true;
                     }
-                    else if (!skipDetection) if (engineBased) {
+                }
+                try {
+                    if (this.host.geckoBinary && 'string' == typeof this.host.geckoBinary) {
+                        const normalized = normalizeBinaryPathForWsl(this.host.geckoBinary);
+                        if (normalized && external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
+                        else {
+                            console.error(messages.DhR(this.host.geckoBinary));
+                            process.exit(1);
+                        }
+                    } else if (!skipDetection) if (engineBased) {
                         console.error(messages.jk4());
                         process.exit(1);
-                    } else browserBinaryLocation = external_firefox_location2_default()(true);
+                    } else {
+                        const located = external_firefox_location2_default()(true);
+                        const normalized = located ? normalizeBinaryPathForWsl(located) : null;
+                        if (normalized && external_fs_.existsSync(normalized)) browserBinaryLocation = normalized;
+                    }
                 } catch (_error) {
                     console.error(this.host.geckoBinary ? messages.DhR(this.host.geckoBinary) : messages.jk4());
                     process.exit(1);
                 }
                 if (!browserBinaryLocation || !browserBinaryLocation.trim() || !external_fs_.existsSync(browserBinaryLocation)) {
                     const fallback = (0, output_binaries_resolver.kI)(compilation, 'firefox');
-                    if (fallback && external_fs_.existsSync(fallback)) browserBinaryLocation = fallback;
+                    const normalizedFallback = fallback ? normalizeBinaryPathForWsl(fallback) : null;
+                    if (normalizedFallback && external_fs_.existsSync(normalizedFallback)) browserBinaryLocation = normalizedFallback;
                     else if (engineBased || this.host.geckoBinary) {
                         console.error(this.host.geckoBinary ? messages.DhR(this.host.geckoBinary) : messages.jk4());
                         process.exit(1);
                     } else {
-                        const guidance = (()=>{
-                            try {
-                                return (0, external_firefox_location2_.getInstallGuidance)();
-                            } catch  {
-                                return 'npx @puppeteer/browsers install firefox';
-                            }
-                        })();
-                        this.printInstallHint(compilation, guidance);
-                        if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox not installed or binary path not found');
-                        process.exit(1);
+                        const wslFallback = resolveWslWindowsBinary();
+                        if (wslFallback) browserBinaryLocation = wslFallback;
+                        else {
+                            const guidance = (()=>{
+                                try {
+                                    return (0, external_firefox_location2_.getInstallGuidance)();
+                                } catch  {
+                                    return 'npx @puppeteer/browsers install firefox';
+                                }
+                            })();
+                            this.printInstallHint(compilation, guidance);
+                            if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox not installed or binary path not found');
+                            process.exit(1);
+                        }
                     }
                 }
                 const binaryPath = browserBinaryLocation;
+                const wslFallbackBinary = isWslEnv() && !engineBased ? resolveWslWindowsBinary() : null;
                 try {
                     this.host.browserVersionLine = (0, external_firefox_location2_.getFirefoxVersion)(binaryPath, {
                         allowExec: true
@@ -129864,12 +130072,12 @@ var __webpack_modules__ = {
                         'pipe',
                         'pipe'
                     ];
-                    this.child = (0, external_child_process_.spawn)(binary, args, {
+                    this.child = await spawnFirefoxProcess({
+                        binary,
+                        args,
                         stdio,
-                        detached: false,
-                        ...isWin ? {
-                            windowsHide: true
-                        } : {}
+                        fallbackBinary: wslFallbackBinary,
+                        logger: this.ctx.logger
                     });
                     this.wireChildLifecycle(compilation, debugPort, desiredDebugPort);
                     const ctrl = await setupRdpAfterLaunch({
@@ -129902,12 +130110,12 @@ var __webpack_modules__ = {
                         'pipe',
                         'pipe'
                     ];
-                    this.child = (0, external_child_process_.spawn)(binaryPath, args, {
+                    this.child = await spawnFirefoxProcess({
+                        binary: binaryPath,
+                        args,
                         stdio,
-                        detached: false,
-                        ...isWin ? {
-                            windowsHide: true
-                        } : {}
+                        fallbackBinary: wslFallbackBinary,
+                        logger: this.ctx.logger
                     });
                     this.wireChildLifecycle(compilation, debugPort, desiredDebugPort);
                 }
@@ -130596,6 +130804,7 @@ var __webpack_modules__ = {
         "use strict";
         __webpack_require__.d(__webpack_exports__, {
             Dy: ()=>installOptionalDependenciesBatch,
+            He: ()=>resolveDevelopInstallRoot,
             tm: ()=>installOptionalDependencies,
             ws: ()=>hasDependency
         });
@@ -130608,6 +130817,25 @@ var __webpack_modules__ = {
             const s = text && 0xfeff === text.charCodeAt(0) ? text.slice(1) : text;
             return JSON.parse(s || '{}');
         }
+        function resolveDevelopRootFromDir(dir) {
+            try {
+                const packageJsonPath = path__rspack_import_0.join(dir, 'package.json');
+                if (!fs__rspack_import_1.existsSync(packageJsonPath)) return;
+                const pkg = parseJsonSafe(fs__rspack_import_1.readFileSync(packageJsonPath, 'utf8'));
+                if (pkg?.name === 'extension-develop') return dir;
+            } catch  {}
+        }
+        function findDevelopRootFrom(startDir) {
+            let currentDir = startDir;
+            const maxDepth = 6;
+            for(let i = 0; i < maxDepth; i++){
+                const root = resolveDevelopRootFromDir(currentDir);
+                if (root) return root;
+                const parent = path__rspack_import_0.dirname(currentDir);
+                if (parent === currentDir) break;
+                currentDir = parent;
+            }
+        }
         function isFromPnpx() {
             if (process.env.npm_config_user_agent?.includes('pnpm')) return 'pnpm';
             return false;
@@ -130634,19 +130862,41 @@ var __webpack_modules__ = {
         }
         async function resolvePackageManager() {
             const envPm = getPackageManagerFromEnv();
-            if (envPm) return envPm;
-            return 'npm';
+            if (envPm && commandExists(envPm)) return envPm;
+            const candidates = [
+                'pnpm',
+                'yarn',
+                'npm'
+            ];
+            for (const candidate of candidates)if (commandExists(candidate)) return candidate;
+            throw new Error(_messages__rspack_import_3.Vo('Optional'));
+        }
+        function commandExists(command) {
+            try {
+                const result = (0, child_process__rspack_import_2.spawnSync)(command, [
+                    '-v'
+                ], {
+                    stdio: 'ignore'
+                });
+                return 0 === result.status;
+            } catch  {
+                return false;
+            }
         }
         function resolveDevelopInstallRoot() {
             const directRoot = (0, _webpack_lib_check_build_dependencies__rspack_import_4.w1)();
             if (directRoot) return directRoot;
+            try {
+                const candidateRoot = findDevelopRootFrom(__dirname);
+                if (candidateRoot) return candidateRoot;
+            } catch  {}
             try {
                 const pkgPath = require.resolve('extension-develop/package.json', {
                     paths: [
-                        process.cwd()
+                        __dirname
                     ]
                 });
-                return path__rspack_import_0.dirname(pkgPath);
+                return resolveDevelopRootFromDir(path__rspack_import_0.dirname(pkgPath));
             } catch  {
                 return;
             }
@@ -130734,7 +130984,8 @@ var __webpack_modules__ = {
             if (!dependencies.length) return;
             try {
                 const pm = await resolvePackageManager();
-                const installBaseDir = resolveDevelopInstallRoot() || process.cwd();
+                const installBaseDir = resolveDevelopInstallRoot();
+                if (!installBaseDir) throw new Error(_messages__rspack_import_3.eG(integration));
                 const installCommand = getOptionalInstallCommand(pm, dependencies, installBaseDir);
                 const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
                 console.log(_messages__rspack_import_3._j([
@@ -130754,16 +131005,19 @@ var __webpack_modules__ = {
                     });
                     console.log(_messages__rspack_import_3.ys(integration));
                 }
+                return true;
             } catch (error) {
                 const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
                 console.error(_messages__rspack_import_3.DX(integration, error, isAuthor));
+                return false;
             }
         }
         async function installOptionalDependenciesBatch(integration, dependencies, integrations) {
             if (!dependencies.length) return;
             try {
                 const pm = await resolvePackageManager();
-                const installBaseDir = resolveDevelopInstallRoot() || process.cwd();
+                const installBaseDir = resolveDevelopInstallRoot();
+                if (!installBaseDir) throw new Error(_messages__rspack_import_3.eG(integration));
                 const installCommand = getOptionalInstallCommand(pm, dependencies, installBaseDir);
                 const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
                 console.log(_messages__rspack_import_3._j(integrations, integration, isAuthor));
@@ -130781,9 +131035,11 @@ var __webpack_modules__ = {
                     });
                     console.log(_messages__rspack_import_3.ys(integration));
                 }
+                return true;
             } catch (error) {
                 const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
                 console.error(_messages__rspack_import_3.DX(integration, error, isAuthor));
+                return false;
             }
         }
         function hasDependency(projectPath, dependency) {
@@ -130836,8 +131092,10 @@ var __webpack_modules__ = {
             DX: ()=>optionalInstallFailed,
             Jv: ()=>youAreAllSet,
             Se: ()=>missingSassDependency,
+            Vo: ()=>optionalInstallManagerMissing,
             _j: ()=>optionalToolingSetup,
             cr: ()=>optionalToolingRootInstall,
+            eG: ()=>optionalInstallRootMissing,
             fD: ()=>cssConfigsDetected,
             uo: ()=>cssIntegrationsEnabled,
             ys: ()=>optionalToolingReady,
@@ -130874,6 +131132,22 @@ var __webpack_modules__ = {
             const prefix = isAuthor ? pintor__rspack_import_0_default().brightMagenta('ERROR Author says') : pintor__rspack_import_0_default().red('ERROR');
             return `${prefix} [${integration}] Failed to install dependencies.\n${pintor__rspack_import_0_default().red(String(error?.message || error))}`;
         }
+        function optionalInstallRootMissing(integration) {
+            const prefix = pintor__rspack_import_0_default().red('ERROR');
+            return [
+                `${prefix} [${integration}] Failed to locate the extension-develop runtime.`,
+                'Optional tooling must install into the extension-develop package, not the user project.',
+                'Reinstall Extension.js or run the command from a valid Extension.js installation.'
+            ].join('\n');
+        }
+        function optionalInstallManagerMissing(integration) {
+            const prefix = pintor__rspack_import_0_default().red('ERROR');
+            return [
+                `${prefix} [${integration}] No supported package manager found in PATH.`,
+                'Install pnpm, npm, or yarn and retry.',
+                'If you use pnpm, ensure it is available in your environment (e.g. corepack or PATH).'
+            ].join('\n');
+        }
         function missingSassDependency() {
             const prefix = pintor__rspack_import_0_default().red('►►►');
             return [
@@ -130925,7 +131199,8 @@ var __webpack_modules__ = {
                     'less',
                     'less-loader'
                 ];
-                await (0, _css_lib_integrations__rspack_import_3.tm)('LESS', lessDependencies);
+                const didInstall = await (0, _css_lib_integrations__rspack_import_3.tm)('LESS', lessDependencies);
+                if (!didInstall) throw new Error('[LESS] Optional dependencies failed to install.');
                 console.log(_css_lib_messages__rspack_import_2.Jv('LESS'));
                 process.exit(0);
             }
@@ -131050,7 +131325,8 @@ var __webpack_modules__ = {
                         'postcss',
                         'postcss-loader'
                     ];
-                    await (0, _css_lib_integrations__rspack_import_5.tm)('PostCSS', postCssDependencies);
+                    const didInstall = await (0, _css_lib_integrations__rspack_import_5.tm)('PostCSS', postCssDependencies);
+                    if (!didInstall) throw new Error('[PostCSS] Optional dependencies failed to install.');
                 }
                 console.log(_css_lib_messages__rspack_import_4.Jv('PostCSS'));
                 process.exit(0);
@@ -131173,11 +131449,13 @@ var __webpack_modules__ = {
                     'postcss-scss',
                     'postcss-preset-env'
                 ];
-                await (0, _css_lib_integrations__rspack_import_4.tm)('PostCSS', postCssDependencies);
+                const didInstallPostCss = await (0, _css_lib_integrations__rspack_import_4.tm)('PostCSS', postCssDependencies);
+                if (!didInstallPostCss) throw new Error('[PostCSS] Optional dependencies failed to install.');
                 const sassDependencies = [
                     'sass-loader'
                 ];
-                await (0, _css_lib_integrations__rspack_import_4.tm)('SASS', sassDependencies);
+                const didInstallSass = await (0, _css_lib_integrations__rspack_import_4.tm)('SASS', sassDependencies);
+                if (!didInstallSass) throw new Error('[SASS] Optional dependencies failed to install.');
                 console.log(_css_lib_messages__rspack_import_3.Jv('SASS'));
                 process.exit(0);
             }
@@ -131386,7 +131664,8 @@ var __webpack_modules__ = {
                     '@rspack/plugin-preact-refresh',
                     'preact'
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_2.tm)('Preact', preactDependencies);
+                const didInstall = await (0, _frameworks_lib_integrations__rspack_import_2.tm)('Preact', preactDependencies);
+                if (!didInstall) throw new Error('[Preact] Optional dependencies failed to install.');
                 console.log(_js_frameworks_lib_messages__rspack_import_1.Jv('Preact'));
                 process.exit(0);
             }
@@ -131449,7 +131728,8 @@ var __webpack_modules__ = {
                     'react-refresh',
                     '@rspack/plugin-react-refresh'
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_4.tm)('React', reactDependencies);
+                const didInstall = await (0, _frameworks_lib_integrations__rspack_import_4.tm)('React', reactDependencies);
+                if (!didInstall) throw new Error('[React] Optional dependencies failed to install.');
                 console.log(_js_frameworks_lib_messages__rspack_import_3.Jv('React'));
                 process.exit(0);
             }
@@ -131528,11 +131808,13 @@ var __webpack_modules__ = {
                 const typeScriptDependencies = [
                     "typescript"
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_2.tm)('TypeScript', typeScriptDependencies);
+                const didInstallTs = await (0, _frameworks_lib_integrations__rspack_import_2.tm)('TypeScript', typeScriptDependencies);
+                if (!didInstallTs) throw new Error('[TypeScript] Optional dependencies failed to install.');
                 const svelteDependencies = [
                     'svelte-loader'
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_2.tm)('Svelte', svelteDependencies);
+                const didInstallSvelte = await (0, _frameworks_lib_integrations__rspack_import_2.tm)('Svelte', svelteDependencies);
+                if (!didInstallSvelte) throw new Error('[Svelte] Optional dependencies failed to install.');
                 console.log(_js_frameworks_lib_messages__rspack_import_1.Jv('Svelte'));
                 process.exit(0);
             }
@@ -131547,7 +131829,8 @@ var __webpack_modules__ = {
                 const typeScriptDependencies = [
                     "typescript"
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_2.tm)('TypeScript', typeScriptDependencies);
+                const didInstallTs = await (0, _frameworks_lib_integrations__rspack_import_2.tm)('TypeScript', typeScriptDependencies);
+                if (!didInstallTs) throw new Error('[TypeScript] Optional dependencies failed to install.');
                 console.log(_js_frameworks_lib_messages__rspack_import_1.Jv('TypeScript'));
                 process.exit(0);
             }
@@ -131789,7 +132072,8 @@ var __webpack_modules__ = {
                     'vue-loader',
                     '@vue/compiler-sfc'
                 ];
-                await (0, _frameworks_lib_integrations__rspack_import_3.tm)('Vue', vueDependencies);
+                const didInstall = await (0, _frameworks_lib_integrations__rspack_import_3.tm)('Vue', vueDependencies);
+                if (!didInstall) throw new Error('[Vue] Optional dependencies failed to install.');
                 console.log(_js_frameworks_lib_messages__rspack_import_2.Jv('Vue'));
                 process.exit(0);
             }
@@ -132767,7 +133051,7 @@ var __webpack_modules__ = {
     },
     "./package.json" (module) {
         "use strict";
-        module.exports = JSON.parse('{"rE":"3.3.1","El":{"@rspack/core":"^1.7.2","@rspack/dev-server":"^1.1.5","@swc/core":"^1.15.8","@swc/helpers":"^0.5.18","adm-zip":"^0.5.16","browser-extension-manifest-fields":"^2.2.1","case-sensitive-paths-webpack-plugin":"^2.4.0","chrome-location2":"4.0.0","chromium-location":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^17.2.3","edge-location":"2.2.0","firefox-location2":"3.0.0","go-git-it":"^5.0.3","ignore":"^7.0.5","loader-utils":"^3.3.1","magic-string":"^0.30.21","parse5":"^8.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","schema-utils":"^4.3.3","tiny-glob":"^0.2.9","unique-names-generator":"^4.7.1","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.19.0"}}');
+        module.exports = JSON.parse('{"rE":"3.3.3-mext.0","El":{"@rspack/core":"^1.7.2","@rspack/dev-server":"^1.1.5","@swc/core":"^1.15.8","@swc/helpers":"^0.5.18","adm-zip":"^0.5.16","browser-extension-manifest-fields":"^2.2.1","case-sensitive-paths-webpack-plugin":"^2.4.0","chrome-location2":"4.0.0","chromium-location":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^17.2.3","edge-location":"2.2.0","firefox-location2":"3.0.0","go-git-it":"^5.0.3","ignore":"^7.0.5","loader-utils":"^3.3.1","magic-string":"^0.30.21","parse5":"^8.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","schema-utils":"^4.3.3","tiny-glob":"^0.2.9","unique-names-generator":"^4.7.1","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.19.0"}}');
     }
 };
 var __webpack_module_cache__ = {};
@@ -133218,6 +133502,7 @@ var __webpack_exports__ = {};
             installedUser: needsUserInstall
         };
     }
+    var integrations = __webpack_require__("./webpack/plugin-css/css-lib/integrations.ts");
     var external_pintor_ = __webpack_require__("pintor");
     var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
     var external_crypto_ = __webpack_require__("crypto");
@@ -133279,7 +133564,7 @@ var __webpack_exports__ = {};
         }
     }
     function getPreflightMarkerPath(projectPath) {
-        const packageRoot = (0, check_build_dependencies.w1)();
+        const packageRoot = (0, integrations.He)();
         if (!packageRoot) return;
         const cacheDir = getPreflightCacheDir(packageRoot);
         return external_path_.join(cacheDir, `${getProjectKey(projectPath)}.json`);
@@ -133334,13 +133619,13 @@ var __webpack_exports__ = {};
     var vue = __webpack_require__("./webpack/plugin-js-frameworks/js-tools/vue.ts");
     var svelte = __webpack_require__("./webpack/plugin-js-frameworks/js-tools/svelte.ts");
     var typescript = __webpack_require__("./webpack/plugin-js-frameworks/js-tools/typescript.ts");
-    var integrations = __webpack_require__("./webpack/plugin-js-frameworks/frameworks-lib/integrations.ts");
+    var frameworks_lib_integrations = __webpack_require__("./webpack/plugin-js-frameworks/frameworks-lib/integrations.ts");
     var sass = __webpack_require__("./webpack/plugin-css/css-tools/sass.ts");
     var less = __webpack_require__("./webpack/plugin-css/css-tools/less.ts");
     var postcss = __webpack_require__("./webpack/plugin-css/css-tools/postcss.ts");
     var js_frameworks_lib_messages = __webpack_require__("./webpack/plugin-js-frameworks/js-frameworks-lib/messages.ts");
     function getResolutionPaths(projectPath) {
-        const extensionRoot = (0, check_build_dependencies.w1)();
+        const extensionRoot = (0, integrations.He)();
         const paths = [
             projectPath || void 0,
             extensionRoot || void 0,
@@ -133439,9 +133724,13 @@ var __webpack_exports__ = {};
         }
         if (missingOptionalDeps.size > 0) {
             const uniqueIntegrations = Array.from(new Set(usedIntegrations));
-            await (0, integrations.Dy)('Optional', Array.from(missingOptionalDeps), uniqueIntegrations);
+            const didInstall = await (0, frameworks_lib_integrations.Dy)('Optional', Array.from(missingOptionalDeps), uniqueIntegrations);
+            if (!didInstall) throw new Error('[Optional] Optional dependencies failed to install.');
             if (opts?.showRunAgainMessage !== false && 'true' === process.env.EXTENSION_AUTHOR_MODE) console.log(js_frameworks_lib_messages.Q2(uniqueIntegrations));
-            if (opts?.exitOnInstall !== false) process.exit(0);
+            if (opts?.exitOnInstall !== false) {
+                writePreflightMarker(projectPath);
+                process.exit(0);
+            }
         }
         writePreflightMarker(projectPath);
     }

package/package.json

@@ -22,7 +22,7 @@
     "dist"
   ],
   "name": "extension-develop",
-  "version": "3.3.1",
+  "version": "3.3.3-mext.0",
   "description": "Develop, build, preview, and package Extension.js projects.",
   "author": {
     "name": "Cezar Augusto",