extension-develop 3.5.0-next.9 → 3.5.1

package/dist/module.cjs

@@ -127238,14 +127238,16 @@ var __webpack_modules__ = {
         __webpack_require__.d(__webpack_exports__, {
             Bf: ()=>getLastCDPPort,
             Ef: ()=>getInstancePorts,
-            UF: ()=>setInstancePorts
+            UF: ()=>setInstancePorts,
+            mm: ()=>getLastRDPPort
         });
         const instanceIdToRecord = new Map();
         let lastCDPPort;
+        let lastRDPPort;
         function setInstancePorts(instanceId, ports) {
             try {
                 if ('number' == typeof ports.cdpPort) lastCDPPort = ports.cdpPort;
-                if ('number' == typeof ports.rdpPort) ports.rdpPort;
+                if ('number' == typeof ports.rdpPort) lastRDPPort = ports.rdpPort;
                 if (!instanceId) return;
                 const prev = instanceIdToRecord.get(instanceId) || {};
                 instanceIdToRecord.set(instanceId, {
@@ -127261,6 +127263,9 @@ var __webpack_modules__ = {
         function getLastCDPPort() {
             return lastCDPPort;
         }
+        function getLastRDPPort() {
+            return lastRDPPort;
+        }
     },
     "./webpack/plugin-browsers/browsers-lib/messages.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         "use strict";
@@ -127874,7 +127879,7 @@ var __webpack_modules__ = {
             if (!management) {
                 if ('true' === process.env.EXTENSION_AUTHOR_MODE) return `${getLoggingPrefix('error')} No management API info received from client for ${manifestName}. Investigate.`;
             }
-            const { name = '', version: version1 = '' } = management;
+            const { version: version1 = '' } = management;
             const extensionVersion = process.env.EXTENSION_DEVELOP_VERSION || process.env.EXTENSION_CLI_VERSION || (()=>{
                 try {
                     return require1('../../../package.json').version;
@@ -127928,22 +127933,15 @@ var __webpack_modules__ = {
                     }
                 }
             } catch  {}
-            const browserLabel = effectiveBrowserLine && effectiveBrowserLine.trim().length > 0 ? effectiveBrowserLine.trim() : capitalize(String(browser || 'unknown'));
+            let browserLabel = effectiveBrowserLine && effectiveBrowserLine.trim().length > 0 ? effectiveBrowserLine.trim() : capitalize(String(browser || 'unknown'));
+            if (browserLabel && !/[a-zA-Z]/.test(browserLabel)) browserLabel = `${capitalize(String(browser || 'unknown'))} ${browserLabel}`;
             const cleanId = String(id || '').trim();
-            const urlScheme = 'firefox' === browser || 'gecko-based' === browser ? 'moz-extension' : 'chrome-extension';
-            cleanId.length;
-            (()=>{
-                if ('firefox' === browser || 'gecko-based' === browser) return 'about:debugging#/runtime/this-firefox';
-                if ('chrome' === browser || 'chromium' === browser || 'chromium-based' === browser || 'edge' === browser) return cleanId.length > 0 ? `chrome://extensions/?id=${cleanId}` : 'chrome://extensions';
-                return cleanId.length > 0 ? `${urlScheme}://${cleanId}` : '(temporary)';
-            })();
-            ('firefox' === browser || 'gecko-based' === browser) && 'true' === process.env.EXTENSION_AUTHOR_MODE && cleanId.length;
-            hostPermissions && hostPermissions.length;
-            permissions && permissions.length;
             const lines = [];
             const includeExtensionId = opts?.includeExtensionId !== false;
             const updateNotice = updateSuffix ? ` ${updateSuffix}` : '';
-            lines.push(` 🧩 ${pintor__rspack_import_3_default().brightBlue('Extension.js')} ${pintor__rspack_import_3_default().gray(`${extensionVersion}`)}${updateNotice}`, `    Browser        ${pintor__rspack_import_3_default().gray(browserLabel)}`, `    Extension      ${pintor__rspack_import_3_default().gray(version1 ? `${name} ${version1}` : name || manifestName)}`);
+            const displayName = String(manifestName);
+            const displayVersion = String(version1 || manifest.version || '');
+            lines.push(` 🧩 ${pintor__rspack_import_3_default().brightBlue('Extension.js')} ${pintor__rspack_import_3_default().gray(`${extensionVersion}`)}${updateNotice}`, `    Browser        ${pintor__rspack_import_3_default().gray(browserLabel)}`, `    Extension      ${pintor__rspack_import_3_default().gray(displayVersion ? `${displayName} ${displayVersion}` : displayName)}`);
             if (includeExtensionId) lines.push(`    Extension ID   ${pintor__rspack_import_3_default().gray(cleanId)}`);
             return lines.join('\n');
         }
@@ -128596,6 +128594,34 @@ var __webpack_modules__ = {
             else obj[key] = value;
             return obj;
         }
+        async function waitForManifest(outPath, timeoutMs = 8000) {
+            const manifestPath = `${outPath}/manifest.json`;
+            const start = Date.now();
+            while(Date.now() - start < timeoutMs){
+                try {
+                    if (external_fs_.existsSync(manifestPath)) return true;
+                } catch  {}
+                await new Promise((resolve)=>setTimeout(resolve, 150));
+            }
+            return false;
+        }
+        async function maybePrintDevBanner(args) {
+            const mode = args.compilation?.options?.mode || 'development';
+            if ('development' !== mode) return;
+            if (args.enableCdp) return;
+            const loadExtensionFlag = args.chromiumConfig.find((flag)=>flag.startsWith('--load-extension='));
+            const extensionOutputPath = (0, extension_output_path.W)(args.compilation, loadExtensionFlag);
+            if (!extensionOutputPath) return;
+            const ready = await waitForManifest(extensionOutputPath, 10000);
+            if (!ready) return;
+            await (0, banner.a)({
+                browser: args.browser,
+                outPath: extensionOutputPath,
+                hostPort: args.hostPort,
+                getInfo: async ()=>null,
+                browserVersionLine: args.browserVersionLine
+            });
+        }
         class ChromiumLaunchPlugin {
             async runOnce(compilation, opts) {
                 if (!this.logger) this.logger = {
@@ -128895,6 +128921,17 @@ var __webpack_modules__ = {
                 instance_registry.UF(this.options.instanceId, {
                     cdpPort: selectedPort
                 });
+                const enableCdp = opts?.enableCdpPostLaunch !== false;
+                await maybePrintDevBanner({
+                    compilation,
+                    chromiumConfig,
+                    browser: this.options.browser,
+                    hostPort: {
+                        host: '127.0.0.1',
+                        port: selectedPort
+                    },
+                    enableCdp
+                });
                 if (this.options.dryRun) return void logChromiumDryRun(browserBinaryLocation, chromiumConfig);
                 await this.launchWithDirectSpawn(browserBinaryLocation, chromiumConfig);
                 try {
@@ -128905,8 +128942,8 @@ var __webpack_modules__ = {
                             if (vLine && vLine.trim().length > 0) browserVersionLine = vLine.trim();
                         }
                     } catch  {}
+                    const mode = compilation?.options?.mode || 'development';
                     try {
-                        const mode = compilation?.options?.mode || 'development';
                         if ('production' === mode) {
                             const loadExtensionFlag = chromiumConfig.find((flag)=>flag.startsWith('--load-extension='));
                             const extensionOutputPath = (0, extension_output_path.W)(compilation, loadExtensionFlag);
@@ -128945,7 +128982,6 @@ var __webpack_modules__ = {
                         dryRun: this.options.dryRun,
                         browserVersionLine
                     };
-                    const enableCdp = opts?.enableCdpPostLaunch !== false;
                     if (enableCdp) {
                         const mod = await Promise.all([
                             __webpack_require__.e("215"),
@@ -129155,41 +129191,61 @@ var __webpack_modules__ = {
         }
         var external_path_ = __webpack_require__("path");
         var banner = __webpack_require__("./webpack/plugin-browsers/browsers-lib/banner.ts");
+        async function waitForManifest(outPath, timeoutMs = 8000) {
+            const manifestPath = external_path_.join(outPath, 'manifest.json');
+            const start = Date.now();
+            while(Date.now() - start < timeoutMs){
+                try {
+                    if (external_fs_.existsSync(manifestPath)) return true;
+                } catch  {}
+                await new Promise((resolve)=>setTimeout(resolve, 150));
+            }
+            return false;
+        }
         async function printRunningInDevelopmentSummary(candidateAddonPaths, browser, extensionId, browserVersionLine) {
             try {
                 let chosenPath = null;
                 for (const p of candidateAddonPaths){
+                    const isManager = /extensions\/[a-z-]+-manager/.test(String(p));
+                    const isDevtools = /extension-js-devtools/.test(String(p));
+                    const isThemePath = /extension-js-theme/.test(String(p));
+                    if (isManager || isDevtools || isThemePath) continue;
                     const mp = external_path_.join(p, 'manifest.json');
                     if (external_fs_.existsSync(mp)) {
                         const mf = JSON.parse(external_fs_.readFileSync(mp, 'utf-8'));
                         const name = mf?.name || '';
-                        if ('string' == typeof name && !/Extension\.js DevTools/i.test(name)) {
+                        const isThemeManifest = mf?.theme != null || 'theme' === String(mf?.type || '');
+                        if ('string' == typeof name && !/Extension\.js DevTools/i.test(name) && !/theme/i.test(name) && !isThemeManifest) {
                             chosenPath = p;
                             break;
                         }
                     }
                 }
                 if (!chosenPath && candidateAddonPaths.length > 0) chosenPath = candidateAddonPaths[candidateAddonPaths.length - 1];
-                if (chosenPath) {
-                    const manifestPath = external_path_.join(chosenPath, 'manifest.json');
-                    if (external_fs_.existsSync(manifestPath)) {
-                        const manifest = JSON.parse(external_fs_.readFileSync(manifestPath, 'utf-8'));
-                        await (0, banner.a)({
-                            browser,
-                            outPath: chosenPath,
-                            hostPort: {
-                                host: '127.0.0.1'
-                            },
-                            getInfo: async ()=>({
-                                    extensionId: extensionId || '(temporary)',
-                                    name: manifest.name,
-                                    version: manifest.version
-                                }),
-                            browserVersionLine
-                        });
-                    }
+                if (!chosenPath) return false;
+                const manifestPath = external_path_.join(chosenPath, 'manifest.json');
+                if (!external_fs_.existsSync(manifestPath)) {
+                    const ready = await waitForManifest(chosenPath, 10000);
+                    if (!ready) return false;
                 }
-            } catch  {}
+                const manifest = JSON.parse(external_fs_.readFileSync(manifestPath, 'utf-8'));
+                const printed = await (0, banner.a)({
+                    browser,
+                    outPath: chosenPath,
+                    hostPort: {
+                        host: '127.0.0.1'
+                    },
+                    getInfo: async ()=>({
+                            extensionId: extensionId || '(temporary)',
+                            name: manifest.name,
+                            version: manifest.version
+                        }),
+                    browserVersionLine
+                });
+                return printed;
+            } catch  {
+                return false;
+            }
         }
         function printSourceInspection(html) {
             console.log(messages.sew());
@@ -129223,6 +129279,9 @@ var __webpack_modules__ = {
             if (external_fs_.existsSync(external_path_.join(distFirefox, 'manifest.json'))) return distFirefox;
             return candidate;
         }
+        function normalizeFirefoxAddonPath(addonPath) {
+            return String(addonPath).replace(/\\/g, '/');
+        }
         async function getAddonsActorWithRetry(client, cached, tries = 40, delayMs = 250) {
             if (cached) return cached;
             let addonsActor;
@@ -129247,7 +129306,7 @@ var __webpack_modules__ = {
         }
         function computeCandidateAddonPaths(compilation, extensionsToLoad, projectContext) {
             const projectPath = compilation.options.context || projectContext || process.cwd();
-            return extensionsToLoad.map((ext)=>resolveAddonDirectory(projectPath, ext));
+            return extensionsToLoad.map((ext)=>normalizeFirefoxAddonPath(resolveAddonDirectory(projectPath, ext)));
         }
         async function waitForManagerWelcome(client) {
             for(let i = 0; i < 20; i++){
@@ -129386,6 +129445,16 @@ var __webpack_modules__ = {
         const MAX_RETRIES = 150;
         const RETRY_INTERVAL = 1000;
         class RemoteFirefox {
+            resolveRdpPort(compilation) {
+                const instanceId = this.options?.instanceId;
+                const devPort = compilation?.options?.devServer?.port;
+                const optionPort = this.options?.port;
+                const normalizedOptionPort = 'string' == typeof optionPort ? parseInt(optionPort, 10) : optionPort;
+                const basePort = normalizedOptionPort || devPort;
+                const desired = (0, shared_utils.jl)(basePort, instanceId);
+                const fromInstance = instanceId ? (0, instance_registry.Ef)(instanceId)?.rdpPort : void 0;
+                return fromInstance || (0, instance_registry.mm)() || desired;
+            }
             async connectClient(port) {
                 let lastError;
                 for (const _ of Array.from({
@@ -129422,15 +129491,13 @@ var __webpack_modules__ = {
                     return 0;
                 });
                 const extensionsToLoad = userFirst;
-                const devPort = compilation.options?.devServer?.port;
-                const optionPort = this.options?.port;
-                const normalizedOptionPort = 'string' == typeof optionPort ? parseInt(optionPort, 10) : optionPort;
-                const port = normalizedOptionPort || (devPort ? devPort + 100 : 9222);
+                const port = this.resolveRdpPort(compilation);
                 const client = await this.connectClient(port);
                 let addonsActor = await getAddonsActorWithRetry(client, this.cachedAddonsActor);
                 if (addonsActor) this.cachedAddonsActor = addonsActor;
                 const candidateAddonPaths = computeCandidateAddonPaths(compilation, extensionsToLoad);
                 for (const [index, addonPath] of candidateAddonPaths.entries()){
+                    const isManager = /extensions\/[a-z-]+-manager/.test(String(addonPath));
                     const isDevtoolsEnabled = 0 === index && Boolean(devtools);
                     try {
                         const installResponse = await installTemporaryAddon(client, String(addonsActor || ''), addonPath, isDevtoolsEnabled);
@@ -129438,7 +129505,7 @@ var __webpack_modules__ = {
                             const maybeId = installResponse?.addon?.id;
                             if ('string' == typeof maybeId && maybeId.length > 0) this.derivedExtensionId = maybeId;
                         }
-                        if (1 === index || 0 === index && /extensions\/[a-z-]+-manager/.test(String(addonPath))) await waitForManagerWelcome(client);
+                        if (isManager) await waitForManagerWelcome(client);
                     } catch (err) {
                         const message = requestErrorToMessage(err);
                         throw new Error(messages.WVu(this.options.browser, message));
@@ -129460,7 +129527,8 @@ var __webpack_modules__ = {
                     if (!this.derivedExtensionId) this.derivedExtensionId = await deriveMozExtensionId(client);
                 } catch  {}
                 this.lastInstalledAddonPath = candidateAddonPaths[0];
-                printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine);
+                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine);
+                if (!bannerPrinted) throw new Error(messages.WVu(this.options.browser, 'Failed to print runningInDevelopment banner; add-on may not be installed.'));
             }
             markNeedsReinstall() {
                 this.needsReinstall = true;
@@ -129512,10 +129580,7 @@ var __webpack_modules__ = {
             }
             async hardReloadIfNeeded(compilation, changedAssets) {
                 try {
-                    const devPort = compilation.options.devServer?.port;
-                    const optionPort = this.options?.port;
-                    const normalizedOptionPort = 'string' == typeof optionPort ? parseInt(optionPort, 10) : optionPort;
-                    const rdpPort = normalizedOptionPort || (devPort ? devPort + 100 : 9222);
+                    const rdpPort = this.resolveRdpPort(compilation);
                     const client = this.client || await this.connectClient(rdpPort);
                     const normalized = (changedAssets || []).map((n)=>String(n || '')).map((n)=>n.replace(/\\/g, '/'));
                     const isManifestChanged = normalized.includes('manifest.json');
@@ -129540,10 +129605,7 @@ var __webpack_modules__ = {
             }
             async inspectSource(compilation, opts) {
                 try {
-                    const devServerPort = compilation.options.devServer?.port;
-                    const optionPort = this.options?.port;
-                    const normalizedOptionPort = 'string' == typeof optionPort ? parseInt(optionPort, 10) : optionPort;
-                    const rdpPort = normalizedOptionPort || (devServerPort ? devServerPort + 100 : 9222);
+                    const rdpPort = this.resolveRdpPort(compilation);
                     const client = this.client || await this.connectClient(rdpPort);
                     const urlToInspect = 'string' == typeof opts.source && 'true' !== opts.source ? opts.source : opts.startingUrl;
                     const tab = await (0, source_inspect.oc)(client, urlToInspect);
@@ -129559,9 +129621,7 @@ var __webpack_modules__ = {
             async enableUnifiedLogging(opts) {
                 try {
                     if (this.loggingAttached) return;
-                    const devPort = this.options?.port;
-                    const normalized = 'string' == typeof devPort ? parseInt(devPort, 10) : devPort;
-                    const rdpPort = normalized || 9222;
+                    const rdpPort = this.resolveRdpPort();
                     const client = this.client || await this.connectClient(rdpPort);
                     await attachConsoleListeners(client);
                     const wantLevel = String(opts.level || 'info').toLowerCase();
@@ -129685,6 +129745,11 @@ var __webpack_modules__ = {
             'browser.formfill.enable': false,
             'browser.link.open_newwindow': 3,
             'browser.sessionstore.enabled': false,
+            'browser.sessionstore.resume_from_crash': false,
+            'browser.sessionstore.max_resumed_crashes': 0,
+            'browser.sessionstore.restore_on_demand': false,
+            'browser.sessionstore.resume_session_once': false,
+            'toolkit.startup.max_resumed_crashes': -1,
             'browser.shell.checkDefaultBrowser': false,
             'browser.sync.enabled': false,
             'browser.startup.page': 0,
@@ -129789,29 +129854,31 @@ var __webpack_modules__ = {
                     });
                     profilePath = tmp;
                 }
-                external_fs_.mkdirSync(profilePath, {
-                    recursive: true
-                });
-                try {
-                    const prefs = getPreferences(configOptions?.preferences || {});
-                    function serializeValue(value) {
-                        if ('string' == typeof value) return JSON.stringify(value);
-                        if ('boolean' == typeof value) return String(value);
-                        if ('number' == typeof value && Number.isFinite(value)) return String(value);
-                        return JSON.stringify(value);
-                    }
-                    function prefsToUserJs(prefsObject) {
-                        return Object.entries(prefsObject).map(([key, val])=>`user_pref(${JSON.stringify(key)}, ${serializeValue(val)});`).join('\n');
-                    }
-                    const userJsPath = external_path_.join(profilePath, 'user.js');
-                    const userJsContent = prefsToUserJs(prefs);
-                    external_fs_.writeFileSync(userJsPath, userJsContent);
-                } catch  {}
                 try {
                     const maxAgeHours = parseInt(String(process.env.EXTENSION_TMP_PROFILE_MAX_AGE_HOURS || ''), 10);
                     (0, shared_utils.CW)(base, external_path_.basename(profilePath), Number.isFinite(maxAgeHours) ? maxAgeHours : 12);
                 } catch  {}
             }
+            if (profilePath) try {
+                external_fs_.mkdirSync(profilePath, {
+                    recursive: true
+                });
+            } catch  {}
+            if (profilePath) try {
+                const prefs = getPreferences(configOptions?.preferences || {});
+                function serializeValue(value) {
+                    if ('string' == typeof value) return JSON.stringify(value);
+                    if ('boolean' == typeof value) return String(value);
+                    if ('number' == typeof value && Number.isFinite(value)) return String(value);
+                    return JSON.stringify(value);
+                }
+                function prefsToUserJs(prefsObject) {
+                    return Object.entries(prefsObject).map(([key, val])=>`user_pref(${JSON.stringify(key)}, ${serializeValue(val)});`).join('\n');
+                }
+                const userJsPath = external_path_.join(profilePath, 'user.js');
+                const userJsContent = prefsToUserJs(prefs);
+                external_fs_.writeFileSync(userJsPath, userJsContent);
+            } catch  {}
             const parts = [
                 `--binary-args="${binaryArgs.join(' ')}"`,
                 '--verbose'
@@ -129888,6 +129955,12 @@ var __webpack_modules__ = {
                 const child = (0, external_child_process_.spawn)(bin, args, {
                     stdio,
                     detached: false,
+                    env: {
+                        ...process.env,
+                        MOZ_DISABLE_AUTO_SAFE_MODE: '1',
+                        MOZ_CRASHREPORTER_DISABLE: '1',
+                        MOZ_CRASHREPORTER: '0'
+                    },
                     ...'win32' === process.platform ? {
                         windowsHide: true
                     } : {}
@@ -130825,9 +130898,11 @@ var __webpack_modules__ = {
         var path__rspack_import_0 = __webpack_require__("path");
         var fs__rspack_import_1 = __webpack_require__("fs");
         var _messages__rspack_import_2 = __webpack_require__("./webpack/plugin-css/css-lib/messages.ts");
-        var _webpack_lib_check_build_dependencies__rspack_import_3 = __webpack_require__("./webpack/webpack-lib/check-build-dependencies.ts");
-        var _webpack_lib_package_manager__rspack_import_4 = __webpack_require__("./webpack/webpack-lib/package-manager.ts");
-        var _webpack_lib_progress__rspack_import_5 = __webpack_require__("./webpack/webpack-lib/progress.ts");
+        var pintor__rspack_import_3 = __webpack_require__("pintor");
+        var pintor__rspack_import_3_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_3);
+        var _webpack_lib_check_build_dependencies__rspack_import_4 = __webpack_require__("./webpack/webpack-lib/check-build-dependencies.ts");
+        var _webpack_lib_package_manager__rspack_import_5 = __webpack_require__("./webpack/webpack-lib/package-manager.ts");
+        var _webpack_lib_progress__rspack_import_6 = __webpack_require__("./webpack/webpack-lib/progress.ts");
         function parseJsonSafe(text) {
             const s = text && 0xfeff === text.charCodeAt(0) ? text.slice(1) : text;
             return JSON.parse(s || '{}');
@@ -130931,13 +131006,13 @@ var __webpack_modules__ = {
         }
         async function execInstallWithFallback(command, options) {
             try {
-                await (0, _webpack_lib_package_manager__rspack_import_4.Qt)(command.command, command.args, {
+                await (0, _webpack_lib_package_manager__rspack_import_5.Qt)(command.command, command.args, {
                     cwd: options.cwd,
                     stdio: 'inherit'
                 });
                 return;
             } catch (error) {
-                if (options.fallbackNpmCommand && isMissingManagerError(error)) return void await (0, _webpack_lib_package_manager__rspack_import_4.Qt)(options.fallbackNpmCommand.command, options.fallbackNpmCommand.args, {
+                if (options.fallbackNpmCommand && isMissingManagerError(error)) return void await (0, _webpack_lib_package_manager__rspack_import_5.Qt)(options.fallbackNpmCommand.command, options.fallbackNpmCommand.args, {
                     cwd: options.cwd,
                     stdio: 'inherit'
                 });
@@ -130945,7 +131020,7 @@ var __webpack_modules__ = {
             }
         }
         function resolveDevelopInstallRoot() {
-            const directRoot = (0, _webpack_lib_check_build_dependencies__rspack_import_3.w1)();
+            const directRoot = (0, _webpack_lib_check_build_dependencies__rspack_import_4.w1)();
             if (directRoot) return directRoot;
             try {
                 const candidateRoot = findDevelopRootFrom(__dirname);
@@ -130964,7 +131039,7 @@ var __webpack_modules__ = {
         }
         function getOptionalInstallCommand(pm, dependencies, installBaseDir) {
             const pmName = pm.name;
-            if ('yarn' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('yarn' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 '--silent',
                 'add',
                 ...dependencies,
@@ -130972,7 +131047,7 @@ var __webpack_modules__ = {
                 installBaseDir,
                 '--optional'
             ]);
-            if ('npm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('npm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 '--silent',
                 'install',
                 ...dependencies,
@@ -130980,7 +131055,7 @@ var __webpack_modules__ = {
                 installBaseDir,
                 '--save-optional'
             ]);
-            if ('pnpm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('pnpm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'add',
                 ...dependencies,
                 '--dir',
@@ -130988,14 +131063,14 @@ var __webpack_modules__ = {
                 '--save-optional',
                 '--silent'
             ]);
-            if ('bun' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('bun' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'add',
                 ...dependencies,
                 '--cwd',
                 installBaseDir,
                 '--optional'
             ]);
-            return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 '--silent',
                 'install',
                 ...dependencies,
@@ -131019,32 +131094,32 @@ var __webpack_modules__ = {
                 '--prefix',
                 installBaseDir
             ] : [];
-            if ('yarn' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('yarn' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'install',
                 '--silent',
                 ...dirArgs
             ]);
-            if ('npm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('npm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'install',
                 '--silent',
                 ...dirArgs
             ]);
-            if ('pnpm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('pnpm' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'install',
                 '--silent',
                 ...dirArgs
             ]);
-            if ('bun' === pmName) return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            if ('bun' === pmName) return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'install',
                 ...dirArgs
             ]);
-            return (0, _webpack_lib_package_manager__rspack_import_4.tj)(pm, [
+            return (0, _webpack_lib_package_manager__rspack_import_5.tj)(pm, [
                 'install',
                 '--silent',
                 ...dirArgs
             ]);
         }
-        async function installOptionalDependencies(integration, dependencies) {
+        async function installOptionalDependencies(integration, dependencies, options) {
             if (!dependencies.length) return;
             let pm;
             let wslContext;
@@ -131052,36 +131127,44 @@ var __webpack_modules__ = {
             try {
                 installBaseDir = resolveDevelopInstallRoot();
                 if (!installBaseDir) throw new Error(_messages__rspack_import_2.eG(integration));
-                pm = (0, _webpack_lib_package_manager__rspack_import_4._c)({
+                pm = (0, _webpack_lib_package_manager__rspack_import_5._c)({
                     cwd: installBaseDir
                 });
                 wslContext = resolveWslContext(installBaseDir);
                 if (!wslContext.useWsl) pm = await preferCorepackFallback(pm);
-                const installCommand = getOptionalInstallCommand(pm, dependencies, wslContext.installDir || installBaseDir);
-                const execCommand = wrapCommandForWsl(installCommand, wslContext);
-                const fallbackNpmCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_4.sX)([
-                    '--silent',
-                    'install',
-                    ...dependencies,
-                    '--prefix',
-                    installBaseDir,
-                    '--save-optional'
-                ]);
                 const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
-                const setupMessage = _messages__rspack_import_2._j([
+                const setupMessages = _messages__rspack_import_2._j([
                     integration
                 ], integration, isAuthor);
-                const progressEnabled = !isAuthor && (0, _webpack_lib_progress__rspack_import_5.u)();
-                const progress = (0, _webpack_lib_progress__rspack_import_5.J)(setupMessage, {
-                    enabled: progressEnabled
+                const setupMessage = setupMessages[0];
+                const hasIndex = Boolean(options?.index && options?.total);
+                const setupMessageWithIndex = hasIndex ? setupMessage.replace('►►► ', `►►► [${options?.index}/${options?.total}] `) : setupMessage;
+                const progressEnabled = !isAuthor && (0, _webpack_lib_progress__rspack_import_6.u)();
+                const progress = (0, _webpack_lib_progress__rspack_import_6.J)(setupMessageWithIndex, {
+                    enabled: progressEnabled,
+                    persistLabel: true
                 });
-                if (isAuthor) console.warn(setupMessage);
-                else if (!progressEnabled) console.log(setupMessage);
+                if (isAuthor) console.warn(setupMessageWithIndex);
+                else if (!progressEnabled) console.log(setupMessageWithIndex);
                 try {
-                    await execInstallWithFallback(execCommand, {
-                        cwd: wslContext.useWsl ? void 0 : installBaseDir,
-                        fallbackNpmCommand
-                    });
+                    for (const dependency of dependencies){
+                        const installCommand = getOptionalInstallCommand(pm, [
+                            dependency
+                        ], wslContext.installDir || installBaseDir);
+                        const execCommand = wrapCommandForWsl(installCommand, wslContext);
+                        const fallbackNpmCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_5.sX)([
+                            '--silent',
+                            'install',
+                            dependency,
+                            '--prefix',
+                            installBaseDir,
+                            '--save-optional'
+                        ]);
+                        await execInstallWithFallback(execCommand, {
+                            cwd: wslContext.useWsl ? void 0 : installBaseDir,
+                            fallbackNpmCommand
+                        });
+                    }
                 } finally{
                     progress.stop();
                 }
@@ -131090,7 +131173,7 @@ var __webpack_modules__ = {
                     console.log(_messages__rspack_import_2.cr(integration));
                     const rootInstall = getRootInstallCommand(pm, wslContext.useWsl ? wslContext.installDir : void 0);
                     const rootCommand = wrapCommandForWsl(rootInstall, wslContext);
-                    const rootFallbackCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_4.sX)([
+                    const rootFallbackCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_5.sX)([
                         '--silent',
                         'install',
                         '--prefix',
@@ -131126,85 +131209,17 @@ var __webpack_modules__ = {
                 return false;
             }
         }
-        async function installOptionalDependenciesBatch(integration, dependencies, integrations) {
-            if (!dependencies.length) return;
-            let pm;
-            let wslContext;
-            let installBaseDir;
-            try {
-                installBaseDir = resolveDevelopInstallRoot();
-                if (!installBaseDir) throw new Error(_messages__rspack_import_2.eG(integration));
-                pm = (0, _webpack_lib_package_manager__rspack_import_4._c)({
-                    cwd: installBaseDir
+        async function installOptionalDependenciesBatch(plans) {
+            if (!plans.length) return;
+            console.log(`${pintor__rspack_import_3_default().gray('►►►')} Found ${pintor__rspack_import_3_default().yellow(String(plans.length))} specialized integration${1 === plans.length ? '' : 's'} needing installation...`);
+            for (const [index, plan] of plans.entries()){
+                const didInstall = await installOptionalDependencies(plan.integration, plan.dependencies, {
+                    index: index + 1,
+                    total: plans.length
                 });
-                wslContext = resolveWslContext(installBaseDir);
-                if (!wslContext.useWsl) pm = await preferCorepackFallback(pm);
-                const installCommand = getOptionalInstallCommand(pm, dependencies, wslContext.installDir || installBaseDir);
-                const execCommand = wrapCommandForWsl(installCommand, wslContext);
-                const fallbackNpmCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_4.sX)([
-                    '--silent',
-                    'install',
-                    ...dependencies,
-                    '--prefix',
-                    installBaseDir,
-                    '--save-optional'
-                ]);
-                const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
-                const setupMessage = _messages__rspack_import_2._j(integrations, integration, isAuthor);
-                const progressEnabled = !isAuthor && (0, _webpack_lib_progress__rspack_import_5.u)();
-                const progress = (0, _webpack_lib_progress__rspack_import_5.J)(setupMessage, {
-                    enabled: progressEnabled
-                });
-                if (isAuthor) console.warn(setupMessage);
-                else if (!progressEnabled) console.log(setupMessage);
-                try {
-                    await execInstallWithFallback(execCommand, {
-                        cwd: wslContext.useWsl ? void 0 : installBaseDir,
-                        fallbackNpmCommand
-                    });
-                } finally{
-                    progress.stop();
-                }
-                await new Promise((resolve)=>setTimeout(resolve, 500));
-                if (isAuthor) {
-                    console.log(_messages__rspack_import_2.cr(integration));
-                    const rootInstall = getRootInstallCommand(pm, wslContext.useWsl ? wslContext.installDir : void 0);
-                    const rootCommand = wrapCommandForWsl(rootInstall, wslContext);
-                    const rootFallbackCommand = wslContext.useWsl ? void 0 : (0, _webpack_lib_package_manager__rspack_import_4.sX)([
-                        '--silent',
-                        'install',
-                        '--prefix',
-                        installBaseDir
-                    ]);
-                    await execInstallWithFallback(rootCommand, {
-                        cwd: wslContext.useWsl ? void 0 : installBaseDir,
-                        fallbackNpmCommand: rootFallbackCommand
-                    });
-                    console.log(_messages__rspack_import_2.ys(integration));
-                }
-                return true;
-            } catch (error) {
-                console.error('[extension.js][optional-deps] debug', {
-                    platform: process.platform,
-                    execPath: process.execPath,
-                    cwd: process.cwd(),
-                    path: process.env.PATH || process.env.Path,
-                    comspec: process.env.ComSpec,
-                    systemRoot: process.env.SystemRoot,
-                    npm_execpath: process.env.npm_execpath,
-                    npm_config_user_agent: process.env.npm_config_user_agent,
-                    npm_config_prefix: process.env.npm_config_prefix,
-                    npm_config_cache: process.env.npm_config_cache,
-                    npm_config_userconfig: process.env.npm_config_userconfig,
-                    installBaseDir,
-                    wslContext,
-                    pm
-                });
-                const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
-                if (isMissingManagerError(error)) console.error(_messages__rspack_import_2.Vo(integration));
-                else console.error(_messages__rspack_import_2.DX(integration, error, isAuthor));
-                return false;
+                if (!didInstall) return false;
             }
+            return true;
         }
         function hasDependency(projectPath, dependency) {
             const findNearestPackageJsonDirectory = (startPath)=>{
@@ -131282,14 +131297,12 @@ var __webpack_modules__ = {
             return `${pintor__rspack_import_0_default().green('►►►')} ${name} installation completed.`;
         }
         function optionalToolingSetup(integrations, fallback, isAuthor) {
-            const formatList = (items)=>{
-                if (1 === items.length) return items[0];
-                if (2 === items.length) return `${items[0]} and ${items[1]}`;
-                return `${items.slice(0, -1).join(', ')}, and ${items[items.length - 1]}`;
-            };
-            const list = integrations && integrations.length > 0 ? formatList(integrations) : fallback;
+            const list = integrations && integrations.length > 0 ? integrations : [
+                fallback
+            ];
             const prefix = isAuthor ? pintor__rspack_import_0_default().brightMagenta('►►► Author says') : pintor__rspack_import_0_default().gray('►►►');
-            return `${prefix} Installing project integrations for ${list} (this is a one time operation)`;
+            const suffix = 'true' === process.env.EXTENSION_ONE_TIME_INSTALL_HINT ? ' (this is a one time operation)' : '';
+            return list.map((integration)=>`${prefix} Installing specialized dependencies for ${integration}...${suffix}`);
         }
         function optionalToolingRootInstall(integration) {
             return `${pintor__rspack_import_0_default().brightMagenta('►►► Author says')} [${integration}] Installing root dependencies for dev...`;
@@ -132291,6 +132304,7 @@ var __webpack_modules__ = {
         });
         var path__rspack_import_0 = __webpack_require__("path");
         var fs__rspack_import_1 = __webpack_require__("fs");
+        var module__rspack_import_2 = __webpack_require__("module");
         function findExtensionDevelopRoot() {
             const webpackLibDir = __dirname;
             const webpackDir = path__rspack_import_0.resolve(webpackLibDir, '..');
@@ -132312,9 +132326,20 @@ var __webpack_modules__ = {
                 throw new Error(`Failed to load build-dependencies.json: ${error.message}`);
             }
         }
+        const require1 = (0, module__rspack_import_2.createRequire)(__rslib_import_meta_url__);
         function isDependencyInstalled(dependency, packageRoot) {
             const nodeModulesPath = path__rspack_import_0.join(packageRoot, 'node_modules', dependency);
-            return fs__rspack_import_1.existsSync(nodeModulesPath);
+            if (fs__rspack_import_1.existsSync(nodeModulesPath)) return true;
+            try {
+                require1.resolve(dependency, {
+                    paths: [
+                        packageRoot
+                    ]
+                });
+                return true;
+            } catch  {
+                return false;
+            }
         }
         function areBuildDependenciesInstalled(packageRoot) {
             const dependencies = loadBuildDependencies();
@@ -132695,6 +132720,126 @@ var __webpack_modules__ = {
             return list;
         }
     },
+    "./webpack/webpack-lib/install-cache.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        "use strict";
+        __webpack_require__.d(__webpack_exports__, {
+            Q: ()=>hasInstallMarker,
+            h: ()=>writeInstallMarker
+        });
+        var path__rspack_import_0 = __webpack_require__("path");
+        var fs__rspack_import_1 = __webpack_require__("fs");
+        var crypto__rspack_import_2 = __webpack_require__("crypto");
+        var _package_json__rspack_import_3 = __webpack_require__("./package.json");
+        var _plugin_css_css_lib_integrations__rspack_import_4 = __webpack_require__("./webpack/plugin-css/css-lib/integrations.ts");
+        function getInstallCacheDir(packageRoot) {
+            return path__rspack_import_0.join(packageRoot, '.cache', 'extensionjs', 'install');
+        }
+        function getProjectKey(projectPath) {
+            return (0, crypto__rspack_import_2.createHash)('sha1').update(path__rspack_import_0.resolve(projectPath)).digest('hex');
+        }
+        function getCacheVersionPath(cacheDir) {
+            return path__rspack_import_0.join(cacheDir, 'version.json');
+        }
+        function getProjectDepsHash(projectPath) {
+            try {
+                const packageJsonPath = path__rspack_import_0.join(projectPath, 'package.json');
+                if (!fs__rspack_import_1.existsSync(packageJsonPath)) return 'no-package-json';
+                const raw = fs__rspack_import_1.readFileSync(packageJsonPath, 'utf8');
+                const parsed = JSON.parse(raw || '{}');
+                const deps = parsed?.dependencies || {};
+                const devDeps = parsed?.devDependencies || {};
+                const normalize = (input)=>{
+                    const sortedKeys = Object.keys(input).sort();
+                    const normalized = {};
+                    for (const key of sortedKeys)normalized[key] = input[key];
+                    return normalized;
+                };
+                const stable = JSON.stringify({
+                    dependencies: normalize(deps),
+                    devDependencies: normalize(devDeps)
+                });
+                return (0, crypto__rspack_import_2.createHash)('sha1').update(stable).digest('hex');
+            } catch  {
+                return 'invalid-package-json';
+            }
+        }
+        function ensureCacheVersion(cacheDir) {
+            const versionPath = getCacheVersionPath(cacheDir);
+            const expectedVersion = _package_json__rspack_import_3.rE;
+            try {
+                if (!fs__rspack_import_1.existsSync(versionPath)) return true;
+                const raw = fs__rspack_import_1.readFileSync(versionPath, 'utf8');
+                const data = JSON.parse(raw || '{}');
+                if (data?.version !== expectedVersion) {
+                    fs__rspack_import_1.rmSync(cacheDir, {
+                        recursive: true,
+                        force: true
+                    });
+                    return false;
+                }
+                return true;
+            } catch  {
+                try {
+                    fs__rspack_import_1.rmSync(cacheDir, {
+                        recursive: true,
+                        force: true
+                    });
+                } catch  {}
+                return false;
+            }
+        }
+        function getInstallMarkerPath(projectPath) {
+            const packageRoot = (0, _plugin_css_css_lib_integrations__rspack_import_4.He)();
+            if (!packageRoot) return;
+            const cacheDir = getInstallCacheDir(packageRoot);
+            return path__rspack_import_0.join(cacheDir, `${getProjectKey(projectPath)}.json`);
+        }
+        function hasInstallMarker(projectPath) {
+            const marker = getInstallMarkerPath(projectPath);
+            if (!marker) return false;
+            const cacheDir = path__rspack_import_0.dirname(marker);
+            if (!ensureCacheVersion(cacheDir)) return false;
+            if (!fs__rspack_import_1.existsSync(marker)) return false;
+            try {
+                const raw = fs__rspack_import_1.readFileSync(marker, 'utf8');
+                const data = JSON.parse(raw || '{}');
+                const depsHash = getProjectDepsHash(projectPath);
+                if (data?.depsHash !== depsHash) {
+                    fs__rspack_import_1.rmSync(marker, {
+                        force: true
+                    });
+                    return false;
+                }
+                return true;
+            } catch  {
+                try {
+                    fs__rspack_import_1.rmSync(marker, {
+                        force: true
+                    });
+                } catch  {}
+                return false;
+            }
+        }
+        function writeInstallMarker(projectPath) {
+            const marker = getInstallMarkerPath(projectPath);
+            if (!marker) return;
+            const cacheDir = path__rspack_import_0.dirname(marker);
+            try {
+                fs__rspack_import_1.mkdirSync(cacheDir, {
+                    recursive: true
+                });
+                fs__rspack_import_1.writeFileSync(getCacheVersionPath(cacheDir), JSON.stringify({
+                    version: _package_json__rspack_import_3.rE
+                }));
+                fs__rspack_import_1.writeFileSync(marker, JSON.stringify({
+                    projectPath: path__rspack_import_0.resolve(projectPath),
+                    depsHash: getProjectDepsHash(projectPath),
+                    version: _package_json__rspack_import_3.rE,
+                    ts: Date.now()
+                }));
+            } catch  {}
+        }
+    },
     "./webpack/webpack-lib/messages.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         "use strict";
         __webpack_require__.d(__webpack_exports__, {
@@ -132800,7 +132945,8 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('info')} Skipping browser runner for ${capitalizedBrowserName(browser)} (no-runner).`;
         }
         function installingRequiredDependencies() {
-            return `${getLoggingPrefix('info')} Installing required dependencies...`;
+            const suffix = 'true' === process.env.EXTENSION_ONE_TIME_INSTALL_HINT ? ' (this is a one time operation)' : '';
+            return `${getLoggingPrefix('info')} Installing general build dependencies...${suffix}`;
         }
         function installingBuildDependencies(dependencies) {
             const list = dependencies.map((dep)=>pintor__rspack_import_2_default().gray(dep)).join(', ');
@@ -132947,7 +133093,7 @@ var __webpack_modules__ = {
             return `${getLoggingPrefix('info')} Using ${pintor__rspack_import_2_default().yellow(integration)}.`;
         }
         function installingDependencies() {
-            return `${getLoggingPrefix('info')} Installing project dependencies...`;
+            return `${getLoggingPrefix('info')} Installing project dependencies... ${pintor__rspack_import_2_default().gray('(This may take a moment)')}`;
         }
         function debugDirs(manifestDir, packageJsonDir) {
             return `${getLoggingPrefix('info')} Directories\n${pintor__rspack_import_2_default().gray('MANIFEST_DIR')} ${pintor__rspack_import_2_default().underline(manifestDir)}\n${pintor__rspack_import_2_default().gray('PACKAGE_JSON_DIR')} ${pintor__rspack_import_2_default().underline(packageJsonDir)}`;
@@ -133077,44 +133223,18 @@ var __webpack_modules__ = {
             } catch  {}
             return resolveNpmCliFromNode(process.execPath);
         }
-        function resolveWindowsCmdExe() {
-            if ('win32' !== process.platform) return 'cmd.exe';
-            const comspec = process.env.ComSpec;
-            if (comspec && fs__rspack_import_0.existsSync(comspec)) return comspec;
-            const systemRoot = process.env.SystemRoot || 'C:\\Windows';
-            const fallback = path__rspack_import_1.join(systemRoot, 'System32', 'cmd.exe');
-            if (fs__rspack_import_0.existsSync(fallback)) return fallback;
-            return 'cmd.exe';
-        }
-        function formatCmdArgs(command, args) {
-            const quotedCommand = command.includes(' ') ? `"${command}"` : command;
-            const quotedArgs = args.map((arg)=>arg.includes(' ') ? `"${arg}"` : arg);
-            return `${quotedCommand} ${quotedArgs.join(' ')}`.trim();
-        }
         function isWindowsExecutablePath(value) {
             if (!value || 'win32' !== process.platform) return false;
             return /\.(cmd|bat|exe)$/i.test(value);
         }
-        function shouldUseCmdExe(command) {
-            if ('win32' !== process.platform) return false;
-            if (/\.(cmd|bat)$/i.test(command)) return true;
-            return [
-                'npm',
-                'pnpm',
-                'yarn',
-                'corepack',
-                'bun'
-            ].includes(command);
-        }
         function resolveWindowsCommandPath(command) {
             if ('win32' !== process.platform) return;
             try {
-                const cmdExe = resolveWindowsCmdExe();
-                const output = (0, child_process__rspack_import_2.execFileSync)(cmdExe, [
-                    '/d',
-                    '/s',
-                    '/c',
-                    `where ${command}`
+                const systemRoot = process.env.SystemRoot || 'C:\\Windows';
+                const whereExe = path__rspack_import_1.join(systemRoot, 'System32', 'where.exe');
+                const whereCommand = fs__rspack_import_0.existsSync(whereExe) ? whereExe : 'where';
+                const output = (0, child_process__rspack_import_2.execFileSync)(whereCommand, [
+                    command
                 ], {
                     encoding: 'utf8',
                     stdio: [
@@ -133193,10 +133313,15 @@ var __webpack_modules__ = {
             ];
             for (const candidate of candidates){
                 const resolved = resolveCommandOnPath(candidate);
-                if (resolved) return {
-                    name: candidate,
-                    execPath: resolved
-                };
+                if (resolved) {
+                    if ('win32' === process.platform && /\.(cmd|bat)$/i.test(resolved)) return {
+                        name: candidate
+                    };
+                    return {
+                        name: candidate,
+                        execPath: resolved
+                    };
+                }
             }
             const corepackPath = resolveCommandOnPath('corepack');
             if (corepackPath || canRunCorepack()) return {
@@ -133269,20 +133394,10 @@ var __webpack_modules__ = {
             };
         }
         function buildSpawnInvocation(command, args) {
-            if (!shouldUseCmdExe(command)) return {
+            return {
                 command,
                 args
             };
-            const cmdExe = resolveWindowsCmdExe();
-            return {
-                command: cmdExe,
-                args: [
-                    '/d',
-                    '/s',
-                    '/c',
-                    formatCmdArgs(command, args)
-                ]
-            };
         }
         function execInstallCommand(command, args, options) {
             const invocation = buildSpawnInvocation(command, args);
@@ -133315,6 +133430,7 @@ var __webpack_modules__ = {
         });
         var fs__rspack_import_0 = __webpack_require__("fs");
         var path__rspack_import_1 = __webpack_require__("path");
+        var _install_cache__rspack_import_2 = __webpack_require__("./webpack/webpack-lib/install-cache.ts");
         function asAbsolute(p) {
             return path__rspack_import_1.isAbsolute(p) ? p : path__rspack_import_1.resolve(p);
         }
@@ -133332,6 +133448,25 @@ var __webpack_modules__ = {
         function needsInstall(packageJsonDir) {
             const nm = getNodeModulesDir(packageJsonDir);
             try {
+                const packageJsonPath = path__rspack_import_1.join(packageJsonDir, 'package.json');
+                if (fs__rspack_import_0.existsSync(packageJsonPath)) {
+                    const raw = fs__rspack_import_0.readFileSync(packageJsonPath, 'utf-8');
+                    const packageJson = JSON.parse(raw);
+                    const depsCount = Object.keys(packageJson?.dependencies || {}).length;
+                    const devDepsCount = Object.keys(packageJson?.devDependencies || {}).length;
+                    if (depsCount + devDepsCount === 0) return false;
+                    if ((0, _install_cache__rspack_import_2.Q)(packageJsonDir)) return false;
+                    if (!fs__rspack_import_0.existsSync(nm)) return true;
+                    const deps = Object.keys(packageJson?.dependencies || {});
+                    const devDeps = Object.keys(packageJson?.devDependencies || {});
+                    if (fs__rspack_import_0.existsSync(path__rspack_import_1.join(nm, '.pnpm'))) return false;
+                    if (fs__rspack_import_0.existsSync(path__rspack_import_1.join(nm, '.modules.yaml'))) return false;
+                    const hasInstalledDep = [
+                        ...deps,
+                        ...devDeps
+                    ].some((dep)=>fs__rspack_import_0.existsSync(path__rspack_import_1.join(nm, dep)));
+                    return !hasInstalledDep;
+                }
                 return !fs__rspack_import_0.existsSync(nm) || 0 === fs__rspack_import_0.readdirSync(nm).length;
             } catch  {
                 return true;
@@ -133340,7 +133475,8 @@ var __webpack_modules__ = {
         function normalizeBrowser(browser, chromiumBinary, geckoBinary) {
             const requested = String(browser || '');
             if (chromiumBinary) {
-                if (!requested || 'chromium' === requested || 'chromium-based' === requested) return 'chromium-based';
+                if (!requested || 'chromium-based' === requested) return 'chromium-based';
+                if ('chromium' === requested) return 'chromium';
                 if ('edge' === requested) return 'edge';
                 if ('chrome' === requested) return 'chrome';
             }
@@ -133432,7 +133568,10 @@ var __webpack_modules__ = {
             return {
                 stop: ()=>{
                     clearInterval(timer);
-                    if (process.stdout.isTTY) process.stdout.write(`\r${' '.repeat(lastVisibleLength)}\r`);
+                    if (process.stdout.isTTY) {
+                        process.stdout.write(`\r${' '.repeat(lastVisibleLength)}\r`);
+                        if (options?.persistLabel) process.stdout.write(`${label}\n`);
+                    }
                 }
             };
         }
@@ -133580,7 +133719,7 @@ var __webpack_modules__ = {
     },
     "./package.json" (module) {
         "use strict";
-        module.exports = JSON.parse('{"rE":"3.5.0-next.9","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.5.1","El":{"@rspack/core":"^1.7.5","@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.1.1","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__ = {};
@@ -133930,8 +134069,10 @@ var __webpack_exports__ = {};
             const stdio = isAuthor ? 'inherit' : 'ignore';
             const progressLabel = messages.xK(dependencies);
             const progressEnabled = !isAuthor && (0, webpack_lib_progress.u)();
+            const persistLabel = 'true' === process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
             const progress = (0, webpack_lib_progress.J)(progressLabel, {
-                enabled: progressEnabled
+                enabled: progressEnabled,
+                persistLabel
             });
             if (!progressEnabled) console.log(progressLabel);
             if (isAuthor) console.warn(messages.TL('build dependencies'));
@@ -133952,14 +134093,28 @@ var __webpack_exports__ = {};
             process.chdir(originalDirectory);
         }
     }
+    var install_cache = __webpack_require__("./webpack/webpack-lib/install-cache.ts");
     function install_dependencies_getInstallArgs() {
         return [
             'install'
         ];
     }
+    async function hasDependenciesToInstall(projectPath) {
+        try {
+            const raw = await external_fs_.promises.readFile(external_path_.join(projectPath, 'package.json'), 'utf8');
+            const packageJson = JSON.parse(raw);
+            const depsCount = Object.keys(packageJson?.dependencies || {}).length;
+            const devDepsCount = Object.keys(packageJson?.devDependencies || {}).length;
+            return depsCount + devDepsCount > 0;
+        } catch (error) {
+            return true;
+        }
+    }
     async function installDependencies(projectPath) {
         const nodeModulesPath = external_path_.join(projectPath, 'node_modules');
         const originalDirectory = process.cwd();
+        const shouldInstall = await hasDependenciesToInstall(projectPath);
+        if (!shouldInstall) return;
         const progressLabel = messages.Vy();
         try {
             process.chdir(projectPath);
@@ -133977,8 +134132,10 @@ var __webpack_exports__ = {};
             const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
             const stdio = isAuthor ? 'inherit' : 'ignore';
             const progressEnabled = !isAuthor && (0, webpack_lib_progress.u)();
+            const persistLabel = 'true' === process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
             const progress = (0, webpack_lib_progress.J)(progressLabel, {
-                enabled: progressEnabled
+                enabled: progressEnabled,
+                persistLabel
             });
             if (!progressEnabled) console.log(progressLabel);
             if (isAuthor) console.warn(messages.TL('project dependencies'));
@@ -133988,6 +134145,7 @@ var __webpack_exports__ = {};
                     cwd: projectPath,
                     stdio
                 });
+                (0, install_cache.h)(projectPath);
             } finally{
                 progress.stop();
             }
@@ -134009,7 +134167,7 @@ var __webpack_exports__ = {};
             installedBuild: false,
             installedUser: false
         };
-        console.log(messages.G2());
+        if (needsBuildInstall) console.log(messages.G2());
         if (needsBuildInstall && packageRoot) await installOwnDependencies(missingBuild, packageRoot);
         if (needsUserInstall && projectPath) await installDependencies(projectPath);
         if (opts?.showRunAgainMessage !== false) console.log(messages.Z0());
@@ -134177,7 +134335,14 @@ var __webpack_exports__ = {};
             return;
         }
         const missingOptionalDeps = new Set();
+        const missingByIntegration = {};
         const usedIntegrations = [];
+        const addMissing = (integration, dependency)=>{
+            if (missingOptionalDeps.has(dependency)) return;
+            missingOptionalDeps.add(dependency);
+            if (!missingByIntegration[integration]) missingByIntegration[integration] = [];
+            missingByIntegration[integration].push(dependency);
+        };
         const usesTypeScript = (0, typescript.eE)(projectPath);
         const usesReact = (0, react.S)(projectPath);
         const usesPreact = (0, preact.K)(projectPath);
@@ -134187,31 +134352,29 @@ var __webpack_exports__ = {};
         const usesLess = (0, less.K)(projectPath);
         const usesPostCss = (0, postcss.A)(projectPath);
         if (usesTypeScript) {
-            if (!canResolveFromProject("typescript", projectPath)) {
-                missingOptionalDeps.add("typescript");
-                usedIntegrations.push('TypeScript');
-            }
+            usedIntegrations.push('TypeScript');
+            if (!canResolveFromProject("typescript", projectPath)) addMissing('TypeScript', "typescript");
         }
         if (usesReact) {
-            if (!canResolve('react-refresh', projectPath)) missingOptionalDeps.add('react-refresh');
-            if (!canResolve('@rspack/plugin-react-refresh', projectPath)) missingOptionalDeps.add('@rspack/plugin-react-refresh');
+            if (!canResolve('react-refresh', projectPath)) addMissing('React', 'react-refresh');
+            if (!canResolve('@rspack/plugin-react-refresh', projectPath)) addMissing('React', '@rspack/plugin-react-refresh');
             usedIntegrations.push('React');
         }
         if (usesPreact) {
-            if (!canResolve('@prefresh/core', projectPath)) missingOptionalDeps.add('@prefresh/core');
-            if (!canResolve('@prefresh/utils', projectPath)) missingOptionalDeps.add('@prefresh/utils');
-            if (!canResolve('@rspack/plugin-preact-refresh', projectPath)) missingOptionalDeps.add('@rspack/plugin-preact-refresh');
-            if (!canResolve('preact', projectPath)) missingOptionalDeps.add('preact');
+            if (!canResolve('@prefresh/core', projectPath)) addMissing('Preact', '@prefresh/core');
+            if (!canResolve('@prefresh/utils', projectPath)) addMissing('Preact', '@prefresh/utils');
+            if (!canResolve('@rspack/plugin-preact-refresh', projectPath)) addMissing('Preact', '@rspack/plugin-preact-refresh');
+            if (!canResolve('preact', projectPath)) addMissing('Preact', 'preact');
             usedIntegrations.push('Preact');
         }
         if (usesVue) {
-            if (!canResolve('vue-loader', projectPath)) missingOptionalDeps.add('vue-loader');
-            if (!canResolve('@vue/compiler-sfc', projectPath)) missingOptionalDeps.add('@vue/compiler-sfc');
+            if (!canResolve('vue-loader', projectPath)) addMissing('Vue', 'vue-loader');
+            if (!canResolve('@vue/compiler-sfc', projectPath)) addMissing('Vue', '@vue/compiler-sfc');
             usedIntegrations.push('Vue');
         }
         if (usesSvelte) {
-            if (!canResolveFromProject('svelte-loader', projectPath) && !canResolve('svelte-loader', projectPath)) missingOptionalDeps.add('svelte-loader');
-            if (!canResolveFromProject("typescript", projectPath)) missingOptionalDeps.add("typescript");
+            if (!canResolveFromProject('svelte-loader', projectPath) && !canResolve('svelte-loader', projectPath)) addMissing('Svelte', 'svelte-loader');
+            if (!canResolveFromProject("typescript", projectPath)) addMissing('Svelte', "typescript");
             usedIntegrations.push('Svelte');
         }
         if (usesSass) {
@@ -134221,28 +134384,32 @@ var __webpack_exports__ = {};
                     'postcss-scss',
                     'postcss-preset-env'
                 ];
-                for (const dep of postCssDeps)if (!canResolve(dep, projectPath)) missingOptionalDeps.add(dep);
-                missingOptionalDeps.add('sass-loader');
+                for (const dep of postCssDeps)if (!canResolve(dep, projectPath)) addMissing('Sass', dep);
+                addMissing('Sass', 'sass-loader');
                 usedIntegrations.push('Sass');
             }
         }
         if (usesLess) {
             if (!canResolve('less-loader', projectPath)) {
-                if (!canResolve('less', projectPath)) missingOptionalDeps.add('less');
-                missingOptionalDeps.add('less-loader');
+                if (!canResolve('less', projectPath)) addMissing('Less', 'less');
+                addMissing('Less', 'less-loader');
                 usedIntegrations.push('Less');
             }
         }
         if (!usesPostCss || canResolve('postcss-loader', projectPath) || usesSass || usesLess) {
             if (usesPostCss) usedIntegrations.push('PostCSS');
         } else {
-            if (!canResolve('postcss', projectPath)) missingOptionalDeps.add('postcss');
-            missingOptionalDeps.add('postcss-loader');
+            if (!canResolve('postcss', projectPath)) addMissing('PostCSS', 'postcss');
+            addMissing('PostCSS', 'postcss-loader');
             usedIntegrations.push('PostCSS');
         }
         if (missingOptionalDeps.size > 0) {
             const uniqueIntegrations = Array.from(new Set(usedIntegrations));
-            const didInstall = await (0, frameworks_lib_integrations.Dy)('Optional', Array.from(missingOptionalDeps), uniqueIntegrations);
+            const installPlans = uniqueIntegrations.map((integration)=>({
+                    integration,
+                    dependencies: missingByIntegration[integration] || []
+                })).filter((plan)=>plan.dependencies.length > 0);
+            const didInstall = await (0, frameworks_lib_integrations.Dy)(installPlans);
             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) {
@@ -134301,11 +134468,18 @@ var __webpack_exports__ = {};
         const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
         try {
             const shouldInstallProjectDeps = !isAuthor || buildOptions?.install !== false;
-            await ensureProjectReady(projectStructure, 'production', {
-                skipProjectInstall: isVitest || !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
-                exitOnInstall: false,
-                showRunAgainMessage: false
-            });
+            const previousOneTimeHint = process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+            process.env.EXTENSION_ONE_TIME_INSTALL_HINT = 'true';
+            try {
+                await ensureProjectReady(projectStructure, 'production', {
+                    skipProjectInstall: isVitest || !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
+                    exitOnInstall: false,
+                    showRunAgainMessage: false
+                });
+            } finally{
+                if (void 0 === previousOneTimeHint) delete process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+                else process.env.EXTENSION_ONE_TIME_INSTALL_HINT = previousOneTimeHint;
+            }
             const [{ rspack }, { merge }, { handleStatsErrors }, { default: webpackConfig }] = await Promise.all([
                 Promise.resolve(require1('@rspack/core')),
                 import("webpack-merge"),
@@ -134419,11 +134593,18 @@ var __webpack_exports__ = {};
             const debug = isAuthor;
             const { manifestDir, packageJsonDir } = (0, webpack_lib_paths.fu)(projectStructure);
             const shouldInstallProjectDeps = !isAuthor || false !== devOptions.install;
-            await ensureProjectReady(projectStructure, 'development', {
-                skipProjectInstall: !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
-                exitOnInstall: false,
-                showRunAgainMessage: false
-            });
+            const previousOneTimeHint = process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+            process.env.EXTENSION_ONE_TIME_INSTALL_HINT = 'true';
+            try {
+                await ensureProjectReady(projectStructure, 'development', {
+                    skipProjectInstall: !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
+                    exitOnInstall: false,
+                    showRunAgainMessage: false
+                });
+            } finally{
+                if (void 0 === previousOneTimeHint) delete process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+                else process.env.EXTENSION_ONE_TIME_INSTALL_HINT = previousOneTimeHint;
+            }
             if ((0, typescript.eE)(manifestDir)) await generateExtensionTypes(manifestDir, packageJsonDir);
             if (projectStructure.packageJsonPath) assertNoManagedDependencyConflicts(projectStructure.packageJsonPath, manifestDir);
             const browser = (0, webpack_lib_paths.YN)(devOptions.browser || 'chrome', devOptions.chromiumBinary, devOptions.geckoBinary || devOptions.firefoxBinary);
@@ -134432,6 +134613,7 @@ var __webpack_exports__ = {};
                 console.log(messages.SG(manifestDir, packageJsonDir));
                 console.log(messages._A(browser, devOptions.chromiumBinary, geckoBinary));
             }
+            if ('true' === process.env.EXTENSION_DEV_DRY_RUN) return;
             const { devServer } = await Promise.all([
                 __webpack_require__.e("215"),
                 __webpack_require__.e("547"),
@@ -134552,11 +134734,14 @@ var __webpack_exports__ = {};
         const safeBrowserConfig = (0, sanitize.a)(browserConfig);
         const safeCommandConfig = (0, sanitize.a)(commandConfig);
         const safePreviewOptions = (0, sanitize.a)(previewOptions);
+        const mergedGeckoBinary = safePreviewOptions.geckoBinary || safePreviewOptions.firefoxBinary || safeCommandConfig.geckoBinary || safeCommandConfig.firefoxBinary || safeBrowserConfig.geckoBinary || safeBrowserConfig.firefoxBinary;
+        const mergedChromiumBinary = safePreviewOptions.chromiumBinary || safeCommandConfig.chromiumBinary || safeBrowserConfig.chromiumBinary;
         const merged = {
             ...safeBrowserConfig,
             ...safeCommandConfig,
             ...safePreviewOptions,
-            geckoBinary: safePreviewOptions.geckoBinary || safePreviewOptions.firefoxBinary
+            chromiumBinary: mergedChromiumBinary,
+            geckoBinary: mergedGeckoBinary
         };
         const darkDefaults = (0, dark_mode.U)({
             browser,
@@ -134593,11 +134778,18 @@ var __webpack_exports__ = {};
             const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
             const debug = isAuthor;
             const shouldInstallProjectDeps = !isAuthor || false !== startOptions.install;
-            await ensureProjectReady(projectStructure, 'development', {
-                skipProjectInstall: !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
-                exitOnInstall: false,
-                showRunAgainMessage: false
-            });
+            const previousOneTimeHint = process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+            process.env.EXTENSION_ONE_TIME_INSTALL_HINT = 'true';
+            try {
+                await ensureProjectReady(projectStructure, 'development', {
+                    skipProjectInstall: !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
+                    exitOnInstall: false,
+                    showRunAgainMessage: false
+                });
+            } finally{
+                if (void 0 === previousOneTimeHint) delete process.env.EXTENSION_ONE_TIME_INSTALL_HINT;
+                else process.env.EXTENSION_ONE_TIME_INSTALL_HINT = previousOneTimeHint;
+            }
             const browser = (0, webpack_lib_paths.YN)(startOptions.browser || 'chrome', startOptions.chromiumBinary, startOptions.geckoBinary || startOptions.firefoxBinary);
             const { manifestDir, packageJsonDir } = (0, webpack_lib_paths.fu)(projectStructure);
             const commandConfig = await (0, config_loader.eY)(packageJsonDir, 'start');
@@ -134620,7 +134812,7 @@ var __webpack_exports__ = {};
                 ...commandConfig,
                 ...startOptions,
                 browser,
-                geckoBinary: startOptions.geckoBinary || startOptions.firefoxBinary,
+                geckoBinary: startOptions.geckoBinary || startOptions.firefoxBinary || browserConfig.geckoBinary || browserConfig.firefoxBinary || commandConfig.geckoBinary || commandConfig.firefoxBinary,
                 outputPath: distPath
             });
         } catch (error) {