extension-develop 3.1.1 → 3.2.0-next.11

package/dist/module.js

@@ -127144,11 +127144,11 @@ var __webpack_modules__ = {
             }
         }
         const printedKeys = new Set();
-        function readUpdateMessageOnce() {
-            const message = process.env.EXTENSION_CLI_UPDATE_MESSAGE;
-            if (!message) return null;
-            delete process.env.EXTENSION_CLI_UPDATE_MESSAGE;
-            return message;
+        function readUpdateSuffixOnce() {
+            const suffix = process.env.EXTENSION_CLI_UPDATE_SUFFIX;
+            if (!suffix) return null;
+            delete process.env.EXTENSION_CLI_UPDATE_SUFFIX;
+            return suffix;
         }
         function keyFor(browser, outPath, hp) {
             const host = (hp?.host || '127.0.0.1').toString();
@@ -127160,6 +127160,7 @@ var __webpack_modules__ = {
             if (printedKeys.has(k)) return false;
             const info = await opts.getInfo() || null;
             const manifestPath = external_path_.join(opts.outPath, 'manifest.json');
+            const updateSuffix = readUpdateSuffixOnce();
             if (!external_fs_.existsSync(manifestPath)) return false;
             const manifest = JSON.parse(external_fs_.readFileSync(manifestPath, 'utf-8'));
             const extensionId = info?.extensionId || opts.fallback?.extensionId || '(temporary)';
@@ -127175,9 +127176,7 @@ var __webpack_modules__ = {
                 }
             };
             console.log(messages.io8());
-            console.log(messages.e_P(manifest, opts.browser, message, opts.browserVersionLine));
-            const updateMessage = readUpdateMessageOnce();
-            if (updateMessage) console.log(updateMessage);
+            console.log(messages.e_P(manifest, opts.browser, message, opts.browserVersionLine, updateSuffix || void 0));
             console.log(messages.io8());
             markBannerPrinted();
             process.env.EXTENSION_CLI_BANNER_PRINTED = 'true';
@@ -127188,6 +127187,7 @@ var __webpack_modules__ = {
             const k = keyFor(opts.browser, opts.outPath);
             if (printedKeys.has(k)) return false;
             const browserLabel = opts.browserVersionLine && opts.browserVersionLine.trim().length > 0 ? opts.browserVersionLine.trim() : String(opts.browser || 'unknown');
+            const updateSuffix = readUpdateSuffixOnce();
             try {
                 const manifestPath = external_path_.join(opts.outPath, 'manifest.json');
                 const manifest = JSON.parse(external_fs_.readFileSync(manifestPath, 'utf-8'));
@@ -127202,9 +127202,7 @@ var __webpack_modules__ = {
                         }
                     };
                     console.log(messages.io8());
-                    console.log(messages.e_P(manifest, opts.browser, message, browserLabel));
-                    const updateMessage = readUpdateMessageOnce();
-                    if (updateMessage) console.log(updateMessage);
+                    console.log(messages.e_P(manifest, opts.browser, message, browserLabel, updateSuffix || void 0));
                     console.log(messages.io8());
                 } else {
                     const message = {
@@ -127217,16 +127215,12 @@ var __webpack_modules__ = {
                         }
                     };
                     console.log(messages.io8());
-                    console.log(messages.e_P(manifest, opts.browser, message, browserLabel));
-                    const updateMessage = readUpdateMessageOnce();
-                    if (updateMessage) console.log(updateMessage);
+                    console.log(messages.e_P(manifest, opts.browser, message, browserLabel, updateSuffix || void 0));
                     console.log(messages.io8());
                 }
             } catch  {
                 console.log(messages.io8());
                 console.log(webpack_lib_messages.Al(opts.outPath, browserLabel));
-                const updateMessage = readUpdateMessageOnce();
-                if (updateMessage) console.log(updateMessage);
                 console.log(messages.io8());
             }
             markBannerPrinted();
@@ -127428,6 +127422,11 @@ var __webpack_modules__ = {
             const maybe = error?.message;
             return String(maybe || error);
         }
+        function isWsl() {
+            const hasEnv = Boolean(String(process.env.WSL_DISTRO_NAME || '').trim() || String(process.env.WSL_INTEROP || '').trim() || String(process.env.WSLENV || '').trim());
+            if (hasEnv) return true;
+            return false;
+        }
         function capitalizedBrowserName(browser) {
             return `${browser.charAt(0).toUpperCase() + browser.slice(1)}`;
         }
@@ -127474,7 +127473,12 @@ var __webpack_modules__ = {
         }
         function browserNotInstalledError(browser, browserBinaryLocation) {
             const isUnreachable = 'null' == browserBinaryLocation ? `Browser ${capitalizedBrowserName(browser)} is not installed\n` : `Can't find the path for browser ${capitalizedBrowserName(browser)}\n`;
-            return `${getLoggingPrefix('error')} ${isUnreachable}Either install the missing browser or choose a different one via ${pintor__rspack_import_0_default().blue('--browser')} ${pintor__rspack_import_0_default().gray('<chrome|edge|firefox>')}.\n\n${pintor__rspack_import_0_default().red('NOT FOUND')} ${pintor__rspack_import_0_default().underline(browserBinaryLocation || capitalizedBrowserName(browser) + 'BROWSER')}`;
+            const wslHint = (()=>{
+                if (!isWsl()) return '';
+                const example = '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe';
+                return `\n\n${getLoggingPrefix('info')} WSL detected\n- Install a Linux browser in WSL, or\n- Provide a Windows binary path via ${pintor__rspack_import_0_default().blue('--chromium-binary')} ${pintor__rspack_import_0_default().gray(`\"${example}\"`)}\n  (Tip: a shell alias like ${pintor__rspack_import_0_default().gray('google-chrome=...')} won't be used by Extension.js; use a real path or wrapper script.)`;
+            })();
+            return `${getLoggingPrefix('error')} ${isUnreachable}Either install the missing browser or choose a different one via ${pintor__rspack_import_0_default().blue('--browser')} ${pintor__rspack_import_0_default().gray('<chrome|edge|firefox>')}.\n\n${pintor__rspack_import_0_default().red('NOT FOUND')} ${pintor__rspack_import_0_default().underline(browserBinaryLocation || capitalizedBrowserName(browser) + 'BROWSER')}` + wslHint;
         }
         function browserLaunchError(browser, error) {
             return `${getLoggingPrefix('error')} Error launching ${capitalizedBrowserName(browser)}:\n${pintor__rspack_import_0_default().red(errorDetail(error))}`;
@@ -127835,7 +127839,7 @@ var __webpack_modules__ = {
         function firefoxRdpClientFailedToGetMainHTML() {
             return `${getLoggingPrefix('error')} Failed to get Firefox main HTML`;
         }
-        function runningInDevelopment(manifest, browser, message, browserVersionLine) {
+        function runningInDevelopment(manifest, browser, message, browserVersionLine, updateSuffix) {
             const capitalize = (str)=>str.charAt(0).toUpperCase() + str.slice(1);
             const manifestName = manifest.name || 'Extension.js';
             const { hostPermissions, permissions } = manifest;
@@ -127859,7 +127863,7 @@ var __webpack_modules__ = {
                 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 extensionVersion = process.env.EXTENSION_CLI_VERSION || (()=>{
+            const extensionVersion = process.env.EXTENSION_DEVELOP_VERSION || process.env.EXTENSION_CLI_VERSION || (()=>{
                 try {
                     return require1('../../../package.json').version;
                 } catch  {
@@ -127925,7 +127929,8 @@ var __webpack_modules__ = {
             hostPermissions && hostPermissions.length;
             permissions && permissions.length;
             const lines = [];
-            lines.push(` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')} ${pintor__rspack_import_0_default().gray(`${extensionVersion}`)}`, `    Browser        ${pintor__rspack_import_0_default().gray(browserLabel)}`, `    Extension      ${pintor__rspack_import_0_default().gray(version1 ? `${name} ${version1}` : name || manifestName)}`, `    Extension ID   ${pintor__rspack_import_0_default().gray(cleanId)}`);
+            const updateNotice = updateSuffix ? ` ${updateSuffix}` : '';
+            lines.push(` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')} ${pintor__rspack_import_0_default().gray(`${extensionVersion}`)}${updateNotice}`, `    Browser        ${pintor__rspack_import_0_default().gray(browserLabel)}`, `    Extension      ${pintor__rspack_import_0_default().gray(version1 ? `${name} ${version1}` : name || manifestName)}`, `    Extension ID   ${pintor__rspack_import_0_default().gray(cleanId)}`);
             return lines.join('\n');
         }
         function emptyLine() {
@@ -128522,7 +128527,11 @@ var __webpack_modules__ = {
                         await this.launchChromium(stats.compilation);
                         this.didLaunch = true;
                         this.logger.info(messages.ACl(this.options.browser, stats.compilation.options.mode));
-                    } catch  {}
+                    } catch (error) {
+                        try {
+                            this.logger.error(messages._D4(this.options.browser, error));
+                        } catch  {}
+                    }
                 });
             }
             async launchChromium(compilation, opts) {
@@ -129595,6 +129604,7 @@ var __webpack_modules__ = {
             const excludeFlags = configOptions.excludeBrowserFlags || [];
             const filteredFlags = (browserFlags || []).filter((flag)=>excludeFlags.every((ex)=>!String(flag).startsWith(ex)));
             if (filteredFlags.length > 0) binaryArgs.push(...filteredFlags);
+            if (configOptions.startingUrl && !configOptions.noOpen) binaryArgs.push(String(configOptions.startingUrl));
             const outPath = compilation.options.output?.path || external_path_.resolve(process.cwd(), 'dist/firefox');
             const distRoot = external_path_.dirname(outPath);
             const useSystemProfile = 'true' === String(process.env.EXTENSION_USE_SYSTEM_PROFILE || process.env.EXTJS_USE_SYSTEM_PROFILE || '').toLowerCase().trim();
@@ -130594,7 +130604,6 @@ var __webpack_modules__ = {
         var child_process__rspack_import_2 = __webpack_require__("child_process");
         var pintor__rspack_import_3 = __webpack_require__("pintor");
         var pintor__rspack_import_3_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_3);
-        var package_manager_detector__rspack_import_4 = __webpack_require__("package-manager-detector");
         function parseJsonSafe(text) {
             const s = text && 0xfeff === text.charCodeAt(0) ? text.slice(1) : text;
             return JSON.parse(s || '{}');
@@ -130609,20 +130618,35 @@ var __webpack_modules__ = {
         }
         function getPackageManagerFromEnv() {
             const ua = process.env.npm_config_user_agent;
-            if (!ua) return;
-            if (ua.includes('pnpm')) return 'pnpm';
-            if (ua.includes('yarn')) return 'yarn';
-            if (ua.includes('bun')) return 'bun';
-            if (ua.includes('npm')) return 'npm';
+            if (ua) {
+                if (ua.includes('pnpm')) return 'pnpm';
+                if (ua.includes('yarn')) return 'yarn';
+                if (ua.includes('bun')) return 'bun';
+                if (ua.includes('npm')) return 'npm';
+            }
+            const execPath = process.env.npm_execpath || process.env.NPM_EXEC_PATH;
+            if (execPath) {
+                if (execPath.includes('pnpm')) return 'pnpm';
+                if (execPath.includes('yarn')) return 'yarn';
+                if (execPath.includes('bun')) return 'bun';
+                if (execPath.includes('npm')) return 'npm';
+            }
+        }
+        function getLogPrefix(type) {
+            if ('true' === process.env.EXTENSION_AUTHOR_MODE) {
+                const base = 'error' === type ? 'ERROR Author says' : '►►► Author says';
+                return pintor__rspack_import_3_default().brightMagenta(base);
+            }
+            return 'error' === type ? pintor__rspack_import_3_default().red('ERROR') : pintor__rspack_import_3_default().gray('►►►');
         }
         async function resolvePackageManager() {
             const envPm = getPackageManagerFromEnv();
             if (envPm) return envPm;
-            return (0, package_manager_detector__rspack_import_4.detect)();
+            return 'npm';
         }
         function getOptionalInstallCommand(pm, dependencies) {
             const quotedDir = JSON.stringify(__dirname);
-            const pmName = 'string' == typeof pm ? pm : pm?.name;
+            const pmName = pm;
             if ('yarn' === pmName) return `yarn --silent add ${dependencies.join(' ')} --cwd ${quotedDir} --optional`;
             if ('npm' === pmName || isFromNpx()) return `npm --silent install ${dependencies.join(' ')} --prefix ${quotedDir} --save-optional`;
             if (isFromPnpx()) return `pnpm --silent add ${dependencies.join(' ')} --prefix ${quotedDir} --save-optional`;
@@ -130630,7 +130654,7 @@ var __webpack_modules__ = {
             return `${fallback} --silent install ${dependencies.join(' ')} --cwd ${quotedDir} --optional`;
         }
         function getRootInstallCommand(pm) {
-            const pmName = 'string' == typeof pm ? pm : pm?.name;
+            const pmName = pm;
             if ('yarn' === pmName) return "yarn install --silent";
             if ('npm' === pmName || isFromNpx()) return "npm install --silent";
             if (isFromPnpx()) return "pnpm install --silent";
@@ -130638,7 +130662,7 @@ var __webpack_modules__ = {
         }
         function formatToolingLabel(integrations, fallback) {
             const list = integrations && integrations.length > 0 ? integrations.join('/') : fallback;
-            return `Setting up ${list} tooling...`;
+            return `${getLogPrefix('info')} Setting up ${list} tooling...`;
         }
         async function installOptionalDependencies(integration, dependencies) {
             if (!dependencies.length) return;
@@ -130660,7 +130684,7 @@ var __webpack_modules__ = {
                     console.log(`${pintor__rspack_import_3_default().brightMagenta('►►► Author says')} ${integration} tooling ready.`);
                 }
             } catch (error) {
-                console.error(`[${integration}] Failed to install dependencies.`, error);
+                console.error(`${getLogPrefix('error')} [${integration}] Failed to install dependencies.\n${pintor__rspack_import_3_default().red(String(error?.message || error))}`);
             }
         }
         async function installOptionalDependenciesBatch(integration, dependencies, integrations) {
@@ -130681,7 +130705,7 @@ var __webpack_modules__ = {
                     console.log(`${pintor__rspack_import_3_default().brightMagenta('►►► Author says')} ${integration} tooling ready.`);
                 }
             } catch (error) {
-                console.error(`[${integration}] Failed to install dependencies.`, error);
+                console.error(`${getLogPrefix('error')} [${integration}] Failed to install dependencies.\n${pintor__rspack_import_3_default().red(String(error?.message || error))}`);
             }
         }
         function hasDependency(projectPath, dependency) {
@@ -130751,7 +130775,7 @@ var __webpack_modules__ = {
             return `${pintor__rspack_import_0_default().gray('►►►')} Using ${pintor__rspack_import_0_default().brightBlue(name)}...`;
         }
         function youAreAllSet(name) {
-            return `${pintor__rspack_import_0_default().green('►►►')} ${name} installation completed. Run again to proceed.`;
+            return `${pintor__rspack_import_0_default().green('►►►')} ${name} installation completed.`;
         }
         function missingSassDependency() {
             const prefix = pintor__rspack_import_0_default().red('►►►');
@@ -131197,7 +131221,7 @@ var __webpack_modules__ = {
             return `${pintor__rspack_import_0_default().gray('►►►')} Using ${pintor__rspack_import_0_default().brightBlue(name)}...`;
         }
         function youAreAllSet(name) {
-            return `${pintor__rspack_import_0_default().green('►►►')} ${name} installation completed. Run again to proceed.`;
+            return `${pintor__rspack_import_0_default().green('►►►')} ${name} installation completed.`;
         }
         function optionalDepsReady(integrations) {
             const list = integrations.length > 0 ? integrations.map((name)=>pintor__rspack_import_0_default().yellow(name)).join(', ') : pintor__rspack_import_0_default().gray('optional');
@@ -132076,6 +132100,7 @@ var __webpack_modules__ = {
     "./webpack/webpack-lib/messages.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         "use strict";
         __webpack_require__.d(__webpack_exports__, {
+            $3: ()=>buildCommandFailed,
             AC: ()=>debugOutputPath,
             Al: ()=>runningInProduction,
             BT: ()=>treeWithSourceFiles,
@@ -132089,6 +132114,7 @@ var __webpack_modules__ = {
             I: ()=>buildWebpack,
             IV: ()=>packagingSourceFiles,
             Ke: ()=>installingDependenciesFailed,
+            Px: ()=>buildDependenciesInstallError,
             RB: ()=>cantInstallDependencies,
             SG: ()=>debugDirs,
             Ud: ()=>downloadingText,
@@ -132108,7 +132134,10 @@ var __webpack_modules__ = {
             ng: ()=>writingTypeDefinitions,
             tQ: ()=>fetchingProjectPath,
             tc: ()=>invalidRemoteZip,
+            um: ()=>buildDependenciesInstallFailed,
             v_: ()=>writingTypeDefinitionsError,
+            vo: ()=>buildDependenciesManualInstall,
+            xK: ()=>installingBuildDependencies,
             yp: ()=>noCompanionExtensionsResolved,
             zM: ()=>unpackagedSuccessfully
         });
@@ -132171,6 +132200,20 @@ var __webpack_modules__ = {
         function installingRequiredDependencies() {
             return `${getLoggingPrefix('info')} Installing required dependencies...`;
         }
+        function installingBuildDependencies(dependencies) {
+            const list = dependencies.map((dep)=>pintor__rspack_import_2_default().gray(dep)).join(', ');
+            return `${getLoggingPrefix('info')} Installing build dependencies: ${list}`;
+        }
+        function buildDependenciesInstallFailed(command, args, code) {
+            return `${getLoggingPrefix('error')} Failed to install build dependencies.\n${pintor__rspack_import_2_default().gray(command)} ${pintor__rspack_import_2_default().gray(args.join(' '))}\n${pintor__rspack_import_2_default().red(`exit code ${pintor__rspack_import_2_default().gray(String(code))}`)}`;
+        }
+        function buildDependenciesInstallError(error) {
+            return `${getLoggingPrefix('error')} Error installing build dependencies.\n${pintor__rspack_import_2_default().red(String(error?.message || error))}`;
+        }
+        function buildDependenciesManualInstall(dependencies, dependenciesMap) {
+            const list = dependencies.map((dep)=>`- ${pintor__rspack_import_2_default().gray(`${dep}@${dependenciesMap[dep]}`)}`).join('\n');
+            return `${getLoggingPrefix('warn')} Please install the following build dependencies manually:\n${list}`;
+        }
         function dependenciesInstalledRunAgain() {
             return `${getLoggingPrefix('success')} Dependencies installed. Run the command again to proceed.`;
         }
@@ -132333,6 +132376,13 @@ var __webpack_modules__ = {
         function configLoadingError(configPath, error) {
             return `${pintor__rspack_import_2_default().red('ERROR')} ${pintor__rspack_import_2_default().brightBlue('config load failed')}\n${fmt.label('PATH')} ${fmt.val(configPath)}\n` + pintor__rspack_import_2_default().red(fmt.truncate(error, 1200));
         }
+        function buildCommandFailed(error) {
+            const message = (()=>{
+                if (error instanceof Error && error.message) return error.message;
+                return String(error || 'Unknown error');
+            })();
+            return `${getLoggingPrefix('error')} Build failed.\n${pintor__rspack_import_2_default().red(fmt.truncate(message, 1200))}`;
+        }
         function managedDependencyConflict(duplicates, userPackageJsonPath) {
             const list = duplicates.map((d)=>`- ${pintor__rspack_import_2_default().yellow(d)}`).join('\n');
             return `${getLoggingPrefix('error')} Your project declares dependencies that are managed by ${pintor__rspack_import_2_default().blue('Extension.js')} and referenced in ${pintor__rspack_import_2_default().underline('extension.config.js')}\n${pintor__rspack_import_2_default().red('This can cause version conflicts and break the development/build process.')}\n\n${pintor__rspack_import_2_default().gray('Managed dependencies (remove these from your package.json):')}\n${list}\n\n${pintor__rspack_import_2_default().gray('PATH')} ${pintor__rspack_import_2_default().underline(userPackageJsonPath)}\nIf you need a different version, open an issue so we can consider bundling it safely.\nOperation aborted.`;
@@ -132474,10 +132524,6 @@ var __webpack_modules__ = {
         "use strict";
         module.exports = require("child_process");
     },
-    chokidar (module) {
-        "use strict";
-        module.exports = require("chokidar");
-    },
     "chrome-location2" (module) {
         "use strict";
         module.exports = require("chrome-location2");
@@ -132534,10 +132580,6 @@ var __webpack_modules__ = {
         "use strict";
         module.exports = require("os");
     },
-    "package-manager-detector" (module) {
-        "use strict";
-        module.exports = require("package-manager-detector");
-    },
     "parse5-utilities" (module) {
         "use strict";
         module.exports = require("parse5-utilities");
@@ -132584,7 +132626,7 @@ var __webpack_modules__ = {
     },
     "./package.json" (module) {
         "use strict";
-        module.exports = JSON.parse('{"rE":"3.1.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","chokidar":"^5.0.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","package-manager-detector":"^1.6.0","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.2.0-next.11","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__ = {};
@@ -132930,20 +132972,28 @@ var __webpack_exports__ = {};
         return Object.keys(dependencies).filter((dep)=>!isDependencyInstalled(dep, packageRoot));
     }
     const external_cross_spawn_namespaceObject = require("cross-spawn");
-    var external_package_manager_detector_ = __webpack_require__("package-manager-detector");
-    async function getInstallCommand(packageRoot) {
-        const hasPnpmLock = external_fs_.existsSync(external_path_.join(packageRoot, 'pnpm-lock.yaml'));
-        const hasYarnLock = external_fs_.existsSync(external_path_.join(packageRoot, 'yarn.lock'));
-        const hasNpmLock = external_fs_.existsSync(external_path_.join(packageRoot, 'package-lock.json'));
+    function detectPackageManagerFromEnv() {
+        const userAgent = process.env.npm_config_user_agent || '';
+        if (userAgent.includes('pnpm')) return 'pnpm';
+        if (userAgent.includes('yarn')) return 'yarn';
+        if (userAgent.includes('npm')) return 'npm';
+        const execPath = process.env.npm_execpath || process.env.NPM_EXEC_PATH || '';
+        if (execPath.includes('pnpm')) return 'pnpm';
+        if (execPath.includes('yarn')) return 'yarn';
+        execPath.includes('npm');
+        return 'npm';
+    }
+    function getInstallCommandForPath(cwd) {
+        const hasPnpmLock = external_fs_.existsSync(external_path_.join(cwd, 'pnpm-lock.yaml'));
+        const hasYarnLock = external_fs_.existsSync(external_path_.join(cwd, 'yarn.lock'));
+        const hasNpmLock = external_fs_.existsSync(external_path_.join(cwd, 'package-lock.json'));
         if (hasPnpmLock) return 'pnpm';
         if (hasYarnLock) return 'yarn';
         if (hasNpmLock) return 'npm';
-        const pm = await (0, external_package_manager_detector_.detect)({
-            cwd: packageRoot
-        });
-        if (pm?.name === 'yarn') return 'yarn';
-        if (pm?.name === 'pnpm') return 'pnpm';
-        return 'npm';
+        return detectPackageManagerFromEnv();
+    }
+    async function getInstallCommand(packageRoot) {
+        return getInstallCommandForPath(packageRoot);
     }
     function getInstallArgs(command, dependencies, dependenciesMap) {
         const depsWithVersions = dependencies.map((dep)=>`${dep}@${dependenciesMap[dep]}`);
@@ -132974,41 +133024,29 @@ var __webpack_exports__ = {};
             const command = await getInstallCommand(packageRoot);
             const installArgs = getInstallArgs(command, dependencies, dependenciesMap);
             const stdio = 'true' === process.env.EXTENSION_AUTHOR_MODE ? 'inherit' : 'ignore';
-            console.log(`Installing build dependencies: ${dependencies.join(', ')}`);
+            console.log(messages.xK(dependencies));
             const child = (0, external_cross_spawn_namespaceObject.spawn)(command, installArgs, {
                 stdio
             });
             await new Promise((resolve, reject)=>{
                 child.on('close', (code)=>{
-                    if (0 !== code) reject(new Error(`Failed to install build dependencies: ${command} ${installArgs.join(' ')} (exit code ${code})`));
+                    if (0 !== code) reject(new Error(messages.um(command, installArgs, code)));
                     else resolve();
                 });
                 child.on('error', (error)=>{
-                    reject(new Error(`Failed to install build dependencies: ${error.message}`));
+                    reject(error);
                 });
             });
         } catch (error) {
-            console.error(`Error installing build dependencies: ${error.message}`);
-            console.error('Please install the following dependencies manually:', dependencies.map((dep)=>`  ${dep}@${dependenciesMap[dep]}`).join('\n'));
+            console.error(messages.Px(error));
+            console.error(messages.vo(dependencies, dependenciesMap));
             process.exit(1);
         } finally{
             process.chdir(originalDirectory);
         }
     }
     async function install_dependencies_getInstallCommand() {
-        const cwd = process.cwd();
-        const hasPnpmLock = external_fs_.existsSync(external_path_.join(cwd, 'pnpm-lock.yaml'));
-        const hasYarnLock = external_fs_.existsSync(external_path_.join(cwd, 'yarn.lock'));
-        const hasNpmLock = external_fs_.existsSync(external_path_.join(cwd, 'package-lock.json'));
-        if (hasPnpmLock) return 'pnpm';
-        if (hasYarnLock) return 'yarn';
-        if (hasNpmLock) return 'npm';
-        const pm = await (0, external_package_manager_detector_.detect)({
-            cwd
-        });
-        if (pm?.name === 'yarn') return 'yarn';
-        if (pm?.name === 'pnpm') return 'pnpm';
-        return 'npm';
+        return getInstallCommandForPath(process.cwd());
     }
     function install_dependencies_getInstallArgs() {
         return [
@@ -133301,19 +133339,14 @@ var __webpack_exports__ = {};
         const shouldExitOnError = (buildOptions?.exitOnError ?? true) && !isVitest;
         const browser = (0, paths.YN)(buildOptions?.browser || 'chrome', buildOptions?.chromiumBinary, buildOptions?.geckoBinary || buildOptions?.firefoxBinary);
         const { manifestDir, packageJsonDir } = (0, paths.fu)(projectStructure);
+        const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
         try {
-            const depsResult = await ensureProjectReady(projectStructure, 'production', {
-                skipProjectInstall: isVitest || !projectStructure.packageJsonPath,
-                exitOnInstall: true
+            const shouldInstallProjectDeps = !isAuthor || buildOptions?.install !== false;
+            await ensureProjectReady(projectStructure, 'production', {
+                skipProjectInstall: isVitest || !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
+                exitOnInstall: false,
+                showRunAgainMessage: false
             });
-            if (depsResult.installed) return {
-                browser,
-                total_assets: 0,
-                total_bytes: 0,
-                largest_asset_bytes: 0,
-                warnings_count: 0,
-                errors_count: 0
-            };
             const [{ rspack }, { merge }, { handleStatsErrors }, { default: webpackConfig }] = await Promise.all([
                 import("@rspack/core"),
                 import("webpack-merge"),
@@ -133323,7 +133356,7 @@ var __webpack_exports__ = {};
                     __webpack_require__.e("547")
                 ]).then(__webpack_require__.bind(__webpack_require__, "./webpack/webpack-config.ts"))
             ]);
-            const debug = 'true' === process.env.EXTENSION_AUTHOR_MODE;
+            const debug = isAuthor;
             if (projectStructure.packageJsonPath) assertNoManagedDependencyConflicts(projectStructure.packageJsonPath, manifestDir);
             const commandConfig = await (0, config_loader.eY)(manifestDir, 'build');
             const distPath = (0, paths.q4)(packageJsonDir, browser);
@@ -133383,7 +133416,9 @@ var __webpack_exports__ = {};
             });
             return summary;
         } catch (error) {
-            if ('true' === process.env.EXTENSION_AUTHOR_MODE) console.error(error);
+            const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
+            if (isAuthor) console.error(error);
+            else console.error(messages.$3(error));
             if (!shouldExitOnError) throw error;
             process.exit(1);
         }
@@ -133391,17 +133426,141 @@ var __webpack_exports__ = {};
     const promises_namespaceObject = require("fs/promises");
     async function generateExtensionTypes(manifestDir, packageJsonDir) {
         const extensionEnvFile = external_path_.join(packageJsonDir, 'extension-env.d.ts');
-        const typePath = 'extension';
+        const { dependencies, devDependencies, peerDependencies, optionalDependencies } = await readPackageJson(packageJsonDir);
+        const hasDependency = (name)=>Boolean(dependencies[name] || devDependencies[name] || peerDependencies[name] || optionalDependencies[name]);
+        const usesReact = hasDependency('react') || hasDependency('@types/react');
+        const usesReactDom = hasDependency('react-dom') || hasDependency('@types/react-dom');
+        const usesSvelte = hasDependency('svelte');
+        const frameworkTypeRefs = [
+            usesReact ? '/// <reference types="react" />' : '',
+            usesReactDom ? '/// <reference types="react-dom" />' : '',
+            usesSvelte ? '/// <reference types="svelte" />' : ''
+        ].filter(Boolean).join('\n');
         const fileContent = `\
 // Required Extension.js types for TypeScript projects.
 // This file is auto-generated and should not be excluded.
-// If you need additional types, consider creating a new *.d.ts file and
-// referencing it in the "include" array of your tsconfig.json file.
-// See https://www.typescriptlang.org/tsconfig#include for more information.
-/// <reference types="${typePath}/types" />
+//
+/// <reference types="webextension-polyfill" />
+/// <reference types="node" />
+/// <reference types="chrome" />
+${frameworkTypeRefs}
+
+declare global {
+  // Align types with Extension.js runtime: we provide the browser global via
+  // webextension-polyfill in Chromium, and it's natively available in Firefox.
+  const browser: typeof import('webextension-polyfill')
+
+  type ExtensionBrowser =
+    | 'chrome'
+    | 'edge'
+    | 'firefox'
+    | 'chromium-based'
+    | 'gecko-based'
 
-// Polyfill types for browser.* APIs
-/// <reference types="${typePath}/types/polyfill" />
+  type ExtensionMode = 'development' | 'production'
+
+  interface ExtensionEnv {
+    EXTENSION_BROWSER: ExtensionBrowser
+    EXTENSION_MODE: ExtensionMode
+    EXTENSION_PUBLIC_BROWSER: ExtensionBrowser
+    EXTENSION_PUBLIC_MODE: ExtensionMode
+    EXTENSION_PUBLIC_DESCRIPTION_TEXT: string
+    EXTENSION_PUBLIC_LLM_API_KEY: string
+    EXTENSION_AUTHOR_MODE: string
+    EXTENSION_PUBLIC_AUTHOR_MODE: string
+  }
+
+  namespace NodeJS {
+    interface ProcessEnv extends ExtensionEnv {
+      [key: string]: string | undefined
+    }
+  }
+
+  interface ImportMetaEnv extends ExtensionEnv {
+    [key: string]: string | undefined
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv
+    readonly webpackHot?: {
+      accept: (module?: string | string[], callback?: () => void) => void
+      dispose: (callback: () => void) => void
+    }
+    url: string
+  }
+
+  interface Window {
+    /**
+     * @deprecated
+     * @description
+     * This is how Extension.js used to inject the shadow root into the window object.
+     * Use the shadowRoot reference from the content script instead.
+     */
+    __EXTENSION_SHADOW_ROOT__: ShadowRoot
+  }
+}
+
+// Asset imports (CSS modules + static images)
+type CSSContentData = Readonly<Record<string, string>>
+type CSSModuleData = Readonly<Record<string, string>>
+
+declare module '*.css' {
+  const content: CSSContentData
+  export default content
+}
+
+declare module '*.module.css' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.scss' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.sass' {
+  const content: CSSModuleData
+  export default content
+}
+
+declare module '*.png' {
+  const content: string
+  export default content
+}
+declare module '*.jpg' {
+  const content: string
+  export default content
+}
+declare module '*.jpeg' {
+  const content: string
+  export default content
+}
+declare module '*.gif' {
+  const content: string
+  export default content
+}
+declare module '*.webp' {
+  const content: string
+  export default content
+}
+declare module '*.avif' {
+  const content: string
+  export default content
+}
+declare module '*.ico' {
+  const content: string
+  export default content
+}
+declare module '*.bmp' {
+  const content: string
+  export default content
+}
+declare module '*.svg' {
+  // Use any to avoid conflicts with SVGR or other SVG loaders.
+  const content: any
+  export default content
+}
+
+export {}
 `;
         try {
             await promises_namespaceObject.access(extensionEnvFile);
@@ -133418,16 +133577,38 @@ var __webpack_exports__ = {};
             }
         }
     }
+    async function readPackageJson(projectPath) {
+        const packageJsonPath = external_path_.join(projectPath, 'package.json');
+        try {
+            const content = await promises_namespaceObject.readFile(packageJsonPath, 'utf8');
+            const parsed = JSON.parse(content) || {};
+            return {
+                dependencies: parsed.dependencies || {},
+                devDependencies: parsed.devDependencies || {},
+                peerDependencies: parsed.peerDependencies || {},
+                optionalDependencies: parsed.optionalDependencies || {}
+            };
+        } catch  {
+            return {
+                dependencies: {},
+                devDependencies: {},
+                peerDependencies: {},
+                optionalDependencies: {}
+            };
+        }
+    }
     async function extensionDev(pathOrRemoteUrl, devOptions) {
         const projectStructure = await getProjectStructure(pathOrRemoteUrl);
         try {
-            const debug = 'true' === process.env.EXTENSION_AUTHOR_MODE;
+            const isAuthor = 'true' === process.env.EXTENSION_AUTHOR_MODE;
+            const debug = isAuthor;
             const { manifestDir, packageJsonDir } = (0, paths.fu)(projectStructure);
-            const depsResult = await ensureProjectReady(projectStructure, 'development', {
-                skipProjectInstall: !projectStructure.packageJsonPath,
-                exitOnInstall: true
+            const shouldInstallProjectDeps = !isAuthor || false !== devOptions.install;
+            await ensureProjectReady(projectStructure, 'development', {
+                skipProjectInstall: !projectStructure.packageJsonPath || !shouldInstallProjectDeps,
+                exitOnInstall: false,
+                showRunAgainMessage: false
             });
-            if (depsResult.installed) return;
             if ((0, typescript.eE)(manifestDir)) await generateExtensionTypes(manifestDir, packageJsonDir);
             if (projectStructure.packageJsonPath) assertNoManagedDependencyConflicts(projectStructure.packageJsonPath, manifestDir);
             const browser = (0, paths.YN)(devOptions.browser || 'chrome', devOptions.chromiumBinary, devOptions.geckoBinary || devOptions.firefoxBinary);
@@ -133592,12 +133773,14 @@ var __webpack_exports__ = {};
     async function extensionStart(pathOrRemoteUrl, startOptions) {
         const projectStructure = await getProjectStructure(pathOrRemoteUrl);
         try {
-            const debug = 'true' === process.env.EXTENSION_AUTHOR_MODE;
-            const depsResult = await ensureProjectReady(projectStructure, 'development', {
-                skipProjectInstall: !projectStructure.packageJsonPath,
-                exitOnInstall: true
+            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
             });
-            if (depsResult.installed) return;
             const browser = (0, paths.YN)(startOptions.browser || 'chrome', startOptions.chromiumBinary, startOptions.geckoBinary || startOptions.firefoxBinary);
             const { manifestDir, packageJsonDir } = (0, paths.fu)(projectStructure);
             const commandConfig = await (0, config_loader.eY)(packageJsonDir, 'start');