extension-develop 4.1.11 → 4.1.13

package/dist/101.mjs

@@ -2,16 +2,16 @@ import { createRequire as __extjsCreateRequire } from "node:module"; const requi
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
 import dotenv from "dotenv";
-import pintor from "pintor";
 import { createHash } from "node:crypto";
 import { fetchExtensionFromStore } from "extension-from-store";
 import node_fs from "node:fs";
 import node_path from "node:path";
 import { getSpecialFoldersData } from "browser-extension-manifest-fields";
-import { humanWarn, browserRowValue, artifactNoun, prefix as messaging_prefix, card, humanLine, fmt, isDebug } from "./349.mjs";
-import { findNearestDenoConfigSync, validateDenoConfig, PROJECT_MANIFEST_FILENAMES, readProjectDependencies } from "./80.mjs";
+import pintor from "pintor";
+import { devtoolsEngineFor, managedDependencyConflict, resolveProjectStructureSync, getDirs, computePreviewOutputPath, eventsPath as session_paths_eventsPath, anotherDevSessionActive, previewingSourceFallback, asAbsolute, previewing, starting, debugPreviewOutput, ensureSessionArtifactsIgnoreFile, debugDirs, debugBrowser, readyContractPath, configLoadingError, normalizeBrowser, previewingCustomOutput, browserArtifactsDir, getProjectStructure, isUsingExperimentalConfig as messages_isUsingExperimentalConfig, getDistPath, configBrowserOrThrow } from "./77.mjs";
+import { humanWarn, isDebug, browserRowValue, artifactNoun, prefix as messaging_prefix, card, humanLine } from "./349.mjs";
+import { readProjectDependencies } from "./80.mjs";
 import { stripBom, parseJsonSafe } from "./23.mjs";
-import { readyContractPath, browserArtifactsDir, eventsPath as session_paths_eventsPath } from "./494.mjs";
 import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
 import { dirname as __rspack_dirname } from "node:path";
 var __rspack_import_meta_dirname__ = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));
@@ -59,377 +59,22 @@ function isGeckoBasedBrowser(browser) {
 function isWebkitBasedBrowser(browser) {
     return WEBKIT_BASED_BROWSERS.includes(browser) || String(browser).includes('webkit');
 }
-function getLoggingPrefix(type) {
-    return messaging_prefix(type);
-}
-function isPathLike(input) {
-    return input.includes('/') || input.includes('\\') || __rspack_external_node_path_c5b9b54f.isAbsolute(input);
-}
-function resolvedWorkspaceManifest(projectPath, manifestPath) {
-    const manifestDir = __rspack_external_node_path_c5b9b54f.dirname(manifestPath);
-    const packageDir = 'src' === __rspack_external_node_path_c5b9b54f.basename(manifestDir) ? __rspack_external_node_path_c5b9b54f.dirname(manifestDir) : manifestDir;
-    const display = __rspack_external_node_path_c5b9b54f.relative(projectPath, packageDir) || packageDir;
-    return `${getLoggingPrefix('info')} ${pintor.gray('Workspace root detected.')}\n${pintor.gray('PACKAGE')} ${pintor.underline(display)}`;
-}
-function remoteFetchTimedOut(target, ms) {
-    return `${getLoggingPrefix('error')} Timed out after ${Math.round(ms / 1000)} s fetching the remote file.\n${pintor.gray('URL')} ${pintor.underline(target)}\nCheck your network, or set ${pintor.blue('EXTENSION_FETCH_TIMEOUT_MS')} to allow more time.`;
-}
-function manifestInvalidJson(manifestPath, error) {
-    const detail = error instanceof Error ? error.message : String(error);
-    return `${getLoggingPrefix('error')} Couldn't parse manifest.json as JSON.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\n${pintor.gray('REASON')} ${pintor.red(detail)}\nFix the syntax error, then run the command again.`;
-}
-function notAnExtensionManifestError(manifestPath) {
-    return `${getLoggingPrefix('error')} manifest.json isn't a browser extension manifest.\nIt has no ${pintor.blue('manifest_version')} field, so it looks like a PWA web-app manifest.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\nPoint Extension.js at the directory that contains your extension manifest.`;
-}
-function manifestNotFoundError(manifestPath, candidates = []) {
-    const base = `${getLoggingPrefix('error')} Manifest file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestPath)}\nEnsure the path to your extension exists, then try again.`;
-    if (!candidates.length) return base;
-    const projectRoot = __rspack_external_node_path_c5b9b54f.dirname(manifestPath);
-    const hint = 1 === candidates.length ? "Did you mean to point at this workspace package?" : "Did you mean to point at one of these workspace packages?";
-    const suggestions = candidates.map((candidate)=>{
-        const dir = 'manifest.json' === __rspack_external_node_path_c5b9b54f.basename(candidate) ? __rspack_external_node_path_c5b9b54f.dirname(candidate) : candidate;
-        const normalized = 'src' === __rspack_external_node_path_c5b9b54f.basename(dir) ? __rspack_external_node_path_c5b9b54f.dirname(dir) : dir;
-        const display = __rspack_external_node_path_c5b9b54f.isAbsolute(normalized) ? __rspack_external_node_path_c5b9b54f.relative(projectRoot, normalized) || normalized : normalized;
-        return `  extension dev ${display}`;
-    }).join('\n');
-    return `${base}\n\n${pintor.gray(hint)}\n${pintor.blue(suggestions)}`;
-}
-function previewingSourceFallback(browser, distDir) {
-    return `${getLoggingPrefix('warn')} No production build found at ${distDir}, previewing the source manifest directory instead.\nRun \`extension build --browser ${String(browser)}\` first to preview the built output.`;
-}
-function previewing(browser, noBrowser) {
-    const suffix = noBrowser ? ' (no-browser mode)' : '';
-    return `${getLoggingPrefix('info')} Previewing on ${capitalizedBrowserName(browser)}${suffix}.`;
-}
-function starting(browser, noBrowser) {
-    const suffix = noBrowser ? ' (no-browser mode)' : '';
-    return `${getLoggingPrefix('info')} Starting on ${capitalizedBrowserName(browser)}${suffix}.`;
-}
-function extensionLoadRecovered() {
-    return `${getLoggingPrefix('success')} The browser accepted the extension.\nIt's running now.`;
-}
-function extensionLoadStillRefused(reason) {
-    return `${getLoggingPrefix('error')} The browser still refuses to load this extension.\n${pintor.gray('REASON')} ${pintor.red(reason)}`;
-}
-function browserLaunchFailed(browser, reason) {
-    return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} couldn't start, so the extension isn't running.\n${reason}\nThe dev server keeps watching, but nothing will load until this is fixed.`;
-}
-function authorInstallNotice(target) {
-    return `${messaging_prefix('debug')} install  target=${target}`;
-}
-function projectInstallFallbackToNpm(pmName) {
-    return `${getLoggingPrefix('warn')} Dependency install with ${pmName} failed.\nExtension.js retries once with npm so the build can continue.`;
-}
-function projectInstallScriptsDisabled(pmName) {
-    return `${getLoggingPrefix('info')} Installing the project dependencies with ${pmName}…\nLifecycle scripts are disabled for safety.\nSet ${pintor.blue('EXTENSION_ALLOW_INSTALL_SCRIPTS=true')} to run them.`;
-}
-function anotherDevSessionActive(browser, pid, runId) {
-    const run = runId ? `, run ${runId}` : '';
-    return `${getLoggingPrefix('warn')} Another dev session is already writing dist/${browser} (PID ${pid}${run}).\nBoth sessions rebuild the same output, so the last compile wins.\nStop the other session, or pass ${fmt.code('--instance-id')} to run them side by side.`;
-}
-function buildAssetsTree(stats) {
-    const statsJson = stats?.toJson?.({
-        all: false,
-        assets: true
-    });
-    const assets = statsJson?.assets || [];
-    return getAssetsTree(assets);
-}
-function buildComplete(browser, distDisplayPath, totalBytes) {
-    const noun = artifactNoun(String(browser));
-    const size = 'number' == typeof totalBytes && totalBytes > 0 ? ` (${getHumanSize(totalBytes)})` : '';
-    return `${getLoggingPrefix('success')} ${noun} built for production in ${pintor.underline(distDisplayPath)}${size}.`;
-}
-function buildShareHint() {
-    return `${getLoggingPrefix('info')} Send this build to someone for review: ` + pintor.underline('https://docs.extension.dev/share/unpublished-build-for-review?utm_source=cli-build');
-}
-function buildFailed(errorCount) {
-    const count = Math.max(1, Math.floor(errorCount || 1));
-    const noun = 1 === count ? 'error' : 'errors';
-    return `${getLoggingPrefix('error')} Build failed with ${count} ${noun}.`;
-}
-function stripModuleWarningWrapper(message) {
-    return message.replace(/^Module (?:Warning|Error) \(from [^)]*\):\s*/, '');
-}
-function getWarningMessage(warning) {
-    if (!warning) return '';
-    if ('string' == typeof warning) return stripModuleWarningWrapper(warning.trim());
-    const candidates = [
-        warning.message,
-        warning.details,
-        warning.reason,
-        warning.description
-    ];
-    for (const candidate of candidates)if ('string' == typeof candidate && candidate.trim()) return stripModuleWarningWrapper(candidate.trim());
-    return '';
-}
-function getWarningSource(warning) {
-    if (!warning || 'string' == typeof warning) return 'bundler';
-    const candidates = [
-        warning.name,
-        warning.moduleName,
-        warning.moduleIdentifier,
-        warning.originName,
-        warning.pluginName
-    ];
-    for (const candidate of candidates)if ('string' == typeof candidate && candidate.trim()) return candidate.trim();
-    return 'bundler';
-}
-function getWarningArtifact(warning) {
-    if (!warning || 'string' == typeof warning) return '';
-    const candidates = [
-        warning.file,
-        warning.chunkName,
-        warning.moduleName
-    ];
-    for (const candidate of candidates)if ('string' == typeof candidate && candidate.trim()) return candidate.trim();
-    return '';
-}
-function classifyWarning(message, source) {
-    const haystack = `${message} ${source}`.toLowerCase();
-    if (haystack.includes('performance') || haystack.includes('asset size') || haystack.includes('entrypoint size') || haystack.includes('exceeds the recommended size') || haystack.includes('hints')) return 'Performance';
-    if (haystack.includes('deprecat') || haystack.includes('[dep_') || haystack.includes('legacy')) return 'Deprecation';
-    if (haystack.includes('invalid') || haystack.includes('unknown option') || haystack.includes('configuration') || haystack.includes('schema')) return 'Configuration';
-    if (haystack.includes('manifest') || haystack.includes('browser') || haystack.includes('target')) return 'Compatibility';
-    if (haystack.includes('runtime') || haystack.includes('will fail') || haystack.includes('cannot resolve') || haystack.includes('service_worker')) return 'Runtime-risk';
-    return 'Warning';
-}
-function suggestedHintForWarning(category) {
-    if ('Performance' === category) return 'Inspect the largest startup bundles and split optional code paths.';
-    if ('Deprecation' === category) return 'Move to the supported API or plugin path before the next update.';
-    if ('Configuration' === category) return 'Review extension and bundler config keys, then remove or rename invalid options.';
-    if ('Compatibility' === category) return 'Verify browser target and manifest compatibility for this build.';
-    if ('Runtime-risk' === category) return 'Address this before release. It may fail or degrade at runtime.';
-    return 'Re-run with EXTENSION_VERBOSE=1 to inspect full warning details.';
-}
-function buildWarningsDetails(warnings) {
-    if (!Array.isArray(warnings) || 0 === warnings.length) return '';
-    const blocks = [];
-    warnings.forEach((warning, index)=>{
-        const message = getWarningMessage(warning);
-        const source = getWarningSource(warning);
-        const artifact = getWarningArtifact(warning);
-        const category = classifyWarning(message, source);
-        const hint = suggestedHintForWarning(category);
-        if (!message) return void blocks.push(`${getLoggingPrefix('warn')} Warning ${index + 1}: details were suppressed by tool output.\n${formatWarningLabelLine('Source', pintor.gray(source))}\n${formatWarningLabelLine('Hint', 'Re-run with EXTENSION_VERBOSE=1 to inspect full warning messages.')}`);
-        const performanceWarning = parsePerformanceWarning(warning, source, artifact);
-        if (performanceWarning) return void blocks.push(performanceWarning);
-        const oneLine = message.replace(/\s+/g, ' ').trim();
-        const artifactSuffix = artifact ? ` ${pintor.gray(`(${artifact})`)}` : '';
-        blocks.push(`${getLoggingPrefix('warn')} ${category}: ${oneLine}${artifactSuffix}\n${formatWarningLabelLine('Source', pintor.gray(source))}\n${formatWarningLabelLine('Hint', hint)}`);
-    });
-    return blocks.join('\n\n');
-}
-function fetchingProjectPath(owner, project) {
-    return fmt.block('Fetching project', [
-        [
-            'URL',
-            fmt.val(`https://github.com/${owner}/${project}`)
-        ]
-    ]);
-}
-function downloadingProjectPath(projectName) {
-    const formatted = isPathLike(projectName) ? pintor.underline(projectName) : projectName;
-    return `${getLoggingPrefix('info')} Downloading ${formatted}…`;
-}
-function creatingProjectPath(projectPath) {
-    return `${getLoggingPrefix('info')} Creating a new browser extension…\n${pintor.gray('PATH')} ${pintor.underline(projectPath)}`;
-}
-function downloadedProjectFolderNotFound(cwd, candidates) {
-    return `${getLoggingPrefix('error')} Downloaded project folder not found.\n${pintor.gray('PATH')} ${pintor.underline(cwd)}\n${pintor.gray('NOT FOUND')} ${pintor.underline(candidates.join(', '))}`;
-}
-function packagingSourceFiles(zipPath) {
-    return `${messaging_prefix('debug')} zip      pack=source gitignore=excluded path=${zipPath}`;
-}
-function zipArtifactReady(zipPath, sizeInBytes) {
-    return `${getLoggingPrefix('success')} Packaged ${pintor.underline(zipPath)} (${getHumanSize(sizeInBytes)}).`;
-}
-function packagingDistributionFiles(zipPath) {
-    return `${messaging_prefix('debug')} zip      pack=dist path=${zipPath}`;
-}
-function treeWithSourceAndDistFiles(browser, name, sourceZip, destZip) {
-    return `${messaging_prefix('debug')} zip      name=${name} browser=${String(browser)} source=${sourceZip} dist=${destZip}`;
-}
-function treeWithDistFilesBrowser(name, ext, browser, zipPath) {
-    return `${messaging_prefix('debug')} zip      name=${name}.${ext} browser=${String(browser)} dist=${zipPath}`;
-}
-function treeWithSourceFiles(name, ext, browser, zipPath) {
-    return `${messaging_prefix('debug')} zip      name=${name}-source.${ext} browser=${String(browser)} source=${zipPath}`;
-}
-function writingTypeDefinitions(manifest) {
-    return `${getLoggingPrefix('info')} Writing the type definitions for ${manifest.name || 'the extension'}…`;
-}
-function writingTypeDefinitionsError(error) {
-    return `${getLoggingPrefix('error')} Couldn't write the extension type definitions.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the file permissions, then try again.`;
-}
-function downloadingText(url) {
-    return fmt.block('Downloading extension', [
-        [
-            'URL',
-            fmt.val(url)
-        ]
-    ]);
-}
-function unpackagingExtension(zipFilePath) {
-    return `${getLoggingPrefix('info')} Unpackaging the browser extension…\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}`;
-}
-function unpackagedSuccessfully() {
-    return `${getLoggingPrefix('success')} Extension unpackaged.`;
-}
-function failedToDownloadOrExtractZIPFileError(error) {
-    return `${getLoggingPrefix('error')} Couldn't download or extract the ZIP file.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the URL and your network, then try again.`;
-}
-function invalidRemoteZip(url, contentType) {
-    return `${getLoggingPrefix('error')} The remote URL doesn't point to a ZIP archive.\n${pintor.gray('URL')} ${pintor.underline(url)}\n${pintor.gray('GOT')} ${pintor.underline(contentType || 'unknown')}\nUse a direct-download URL, or download the file and pass the local path.`;
-}
-function notAZipArchive(source, contentType) {
-    return `${getLoggingPrefix('error')} The downloaded content isn't a ZIP archive.\n${pintor.gray('SOURCE')} ${pintor.underline(source)}\n` + (contentType ? `${pintor.gray('GOT')} ${pintor.underline(contentType)}\n` : '') + `The URL likely requires authentication and returned an HTML login page instead of the file.\n` + `This happens with Slack, Google Drive, and Dropbox file pages.\n` + "Download the ZIP in the browser and pass the local path, or use a direct-download URL.";
-}
-function localZipNotFound(zipFilePath) {
-    return `${getLoggingPrefix('error')} ZIP file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(zipFilePath)}\nCheck the path, then try again.`;
-}
-function capitalizedBrowserName(browser) {
-    const b = String(browser || '');
-    const cap = b.charAt(0).toUpperCase() + b.slice(1);
-    return pintor.yellow(`${cap}`);
-}
-function getFileSize(fileSizeInBytes) {
-    return `${(fileSizeInBytes / 1024).toFixed(2)}KB`;
-}
-function getHumanSize(sizeInBytes) {
-    const bytes = Math.max(0, sizeInBytes || 0);
-    if (bytes < 1024) return `${bytes} B`;
-    if (bytes < 1048576) return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / 1048576).toFixed(1)} MB`;
-}
-function printTree(node, prefix = '') {
-    let output = '';
-    Object.keys(node).forEach((key, index, array)=>{
-        const isLast = index === array.length - 1;
-        const connector = isLast ? '└─' : '├─';
-        const child = node[key];
-        const childNode = child && 'object' == typeof child ? child : void 0;
-        const isLeaf = 'number' == typeof childNode?.size;
-        const sizeInKB = isLeaf ? ` (${getFileSize(childNode?.size ?? 0)})` : '';
-        output += `${pintor.gray(prefix)}${pintor.gray(connector)} ${key}${pintor.gray(sizeInKB)}\n`;
-        if (childNode && !isLeaf) output += printTree(childNode, `${prefix}${isLast ? '   ' : pintor.gray('│  ')}`);
-    });
-    return output;
-}
-function getAssetsTree(assets) {
-    const assetTree = {};
-    assets?.forEach((asset)=>{
-        if ('string' != typeof asset?.name) return;
-        const paths = asset.name.split('/');
-        let currentLevel = assetTree;
-        paths.forEach((part, index)=>{
-            if (!currentLevel[part]) currentLevel[part] = {};
-            if (index === paths.length - 1) currentLevel[part] = {
-                size: asset.size
-            };
-            else currentLevel = currentLevel[part];
-        });
-    });
-    if (0 === Object.keys(assetTree).length) return '';
-    return `.\n${printTree(assetTree)}`;
-}
-function formatWarningLabelLine(label, value) {
-    return `${pintor.gray('│')}  ${pintor.gray(`${label}:`)} ${value}`;
-}
-function parsePerformanceWarning(warning, source, _artifact) {
-    const normalized = getWarningBody(warning).replace(/\r/g, '');
-    const lower = normalized.toLowerCase();
-    const threshold = normalized.match(/\(([\d.]+\s(?:KiB|MiB|GiB|KB|MB|GB))\)/)?.[1] || '';
-    if (lower.includes('asset size limit')) return formatPerformanceWarningBlock({
-        title: 'asset size limit exceeded',
-        threshold,
-        impact: 'Large emitted files can increase package size and slow extension startup.',
-        source,
-        hint: 'Inspect the largest startup bundles and split optional code paths.'
-    });
-    if (lower.includes('entrypoint size limit')) return formatPerformanceWarningBlock({
-        title: 'entrypoint size limit exceeded',
-        threshold,
-        impact: 'Startup entrypoints are heavier than recommended.',
-        source,
-        hint: 'Keep startup entrypoints thin and defer non-critical code.'
-    });
-}
-function formatPerformanceWarningBlock(options) {
-    const lines = [
-        `${getLoggingPrefix('warn')} Performance: ${options.title}`
-    ];
-    if (options.threshold) lines.push(formatWarningLabelLine('Threshold', options.threshold));
-    lines.push(formatWarningLabelLine('Impact', options.impact));
-    lines.push(pintor.gray('│'));
-    lines.push(formatWarningLabelLine('Source', pintor.gray(options.source)));
-    lines.push(formatWarningLabelLine('Hint', options.hint));
-    return lines.join('\n');
-}
-function getWarningBody(warning) {
-    if (!warning) return '';
-    if ('string' == typeof warning) return warning;
-    return [
-        warning.message,
-        warning.details,
-        warning.reason,
-        warning.description
-    ].filter((value)=>'string' == typeof value && value.trim().length > 0).join('\n');
-}
-function isUsingExperimentalConfig(integration) {
-    return `${messaging_prefix('debug')} config   using=${String(integration)}`;
-}
-function debugDirs(manifestDir, packageJsonDir) {
-    return `${messaging_prefix('debug')} dirs     manifest=${manifestDir} pkg=${packageJsonDir}`;
-}
-function debugBrowser(browser, chromiumBinary, geckoBinary) {
-    return `${messaging_prefix('debug')} browser  target=${String(browser)} chromiumBinary=${String(chromiumBinary || 'auto')} geckoBinary=${String(geckoBinary || 'auto')}`;
-}
-function debugOutputPath(pathValue) {
-    return `${messaging_prefix('debug')} output   path=${pathValue}`;
-}
-function debugPreviewOutput(outputPath, distPath) {
-    return `${messaging_prefix('debug')} preview  output=${outputPath} dist=${distPath}`;
-}
-function debugContextPath(packageJsonDir) {
-    return `${messaging_prefix('debug')} context  path=${packageJsonDir}`;
-}
-function debugExtensionsToLoad(extensions) {
-    return `${messaging_prefix('debug')} extensions count=${extensions.length} paths=${extensions.join(',')}`;
-}
-function noCompanionExtensionsResolved() {
-    return `${getLoggingPrefix('warn')} No companion extensions resolved from the ${pintor.blue('extensions')} config.\nPoint each entry at an unpacked extension directory that contains a manifest.json, for example ./extensions/<name>/manifest.json.`;
-}
-function configLoadingError(configPath, error) {
-    return `${getLoggingPrefix('error')} Couldn't load ${pintor.blue('extension.config.js')}.\n${fmt.label('PATH')} ${fmt.val(configPath)}\n${pintor.red(fmt.truncate(error, 1200))}\nFix the config file, then run the command again.`;
-}
-function buildCommandFailed(error) {
-    const message = (()=>{
-        if (error instanceof Error && error.message) return error.message;
-        return String(error || 'Unknown error');
-    })();
-    if (message.includes(getLoggingPrefix('error'))) return message;
-    return `${getLoggingPrefix('error')} ${pintor.red(fmt.truncate(message, 1200))}`;
-}
-function devCommandFailed(error) {
-    const message = (()=>{
-        if (error instanceof Error && error.message) return error.message;
-        return String(error || 'Unknown error');
-    })();
-    return `${getLoggingPrefix('error')} Dev mode failed.\n${pintor.red(fmt.truncate(message, 1200))}`;
-}
-function managedDependencyConflict(duplicates, userPackageJsonPath) {
-    const list = duplicates.map((d)=>`- ${pintor.yellow(d)}`).join('\n');
-    return `${getLoggingPrefix('error')} Your project declares dependencies that Extension.js already manages, so the build was aborted.\n${pintor.red('Duplicate declarations can cause version conflicts and break the build.')}\n\n${pintor.gray('Remove these from your package.json:')}\n${list}\n\n${pintor.gray('PATH')} ${pintor.underline(userPackageJsonPath)}\nIf you need a different version, open an issue so we can consider bundling it safely.`;
-}
 const preloadedEnvKeys = new Set();
 function getPreloadedEnvKeys() {
     return preloadedEnvKeys;
 }
-function recordPreloadedKeys(filePath) {
-    try {
-        for (const key of Object.keys(dotenv.parse(__rspack_external_node_fs_5ea92f0c.readFileSync(filePath))))if (!(key in process.env)) preloadedEnvKeys.add(key);
-    } catch  {}
+const ENV_PRELOAD_ORDER = [
+    '.env.defaults',
+    '.env',
+    '.env.local',
+    '.env.development'
+];
+function applyEnvFile(filePath, shellOwned) {
+    const parsed = dotenv.parse(__rspack_external_node_fs_5ea92f0c.readFileSync(filePath));
+    for (const [key, value] of Object.entries(parsed))if (!shellOwned.has(key)) {
+        process.env[key] = value;
+        preloadedEnvKeys.add(key);
+    }
 }
 function loadCommonJsConfigWithStableDirname(absolutePath) {
     const code = __rspack_external_node_fs_5ea92f0c.readFileSync(absolutePath, 'utf-8');
@@ -455,51 +100,46 @@ function findNearestWorkspaceRoot(startDir) {
         current = parent;
     }
 }
-function preloadEnvFilesFromDir(envDir, options) {
+function preloadEnvFilesFromDir(envDir) {
     let loadedAny = false;
-    try {
-        const defaultsPath = __rspack_external_node_path_c5b9b54f.join(envDir, '.env.defaults');
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(defaultsPath)) {
-            recordPreloadedKeys(defaultsPath);
-            dotenv.config({
-                path: defaultsPath,
-                override: Boolean(options?.override),
-                quiet: true
-            });
+    const shellOwned = new Set(Object.keys(process.env).filter((key)=>!preloadedEnvKeys.has(key)));
+    for (const filename of ENV_PRELOAD_ORDER){
+        const filePath = __rspack_external_node_path_c5b9b54f.join(envDir, filename);
+        if (__rspack_external_node_fs_5ea92f0c.existsSync(filePath)) try {
+            applyEnvFile(filePath, shellOwned);
             loadedAny = true;
-        }
-        const envCandidates = [
-            '.env.development',
-            '.env.local',
-            '.env'
-        ];
-        for (const filename of envCandidates){
-            const filePath = __rspack_external_node_path_c5b9b54f.join(envDir, filename);
-            if (__rspack_external_node_fs_5ea92f0c.existsSync(filePath)) {
-                recordPreloadedKeys(filePath);
-                dotenv.config({
-                    path: filePath,
-                    override: Boolean(options?.override),
-                    quiet: true
-                });
-                loadedAny = true;
-                break;
-            }
-        }
-    } catch  {}
+        } catch  {}
+    }
     return {
         loadedAny,
         envDir
     };
 }
-function findConfigFile(projectPath) {
+function findConfigFileIn(dir) {
     const candidates = [
-        __rspack_external_node_path_c5b9b54f.join(projectPath, 'extension.config.js'),
-        __rspack_external_node_path_c5b9b54f.join(projectPath, 'extension.config.mjs'),
-        __rspack_external_node_path_c5b9b54f.join(projectPath, 'extension.config.cjs')
+        __rspack_external_node_path_c5b9b54f.join(dir, 'extension.config.js'),
+        __rspack_external_node_path_c5b9b54f.join(dir, 'extension.config.mjs'),
+        __rspack_external_node_path_c5b9b54f.join(dir, 'extension.config.cjs')
     ];
     return candidates.find((p)=>__rspack_external_node_fs_5ea92f0c.existsSync(p));
 }
+function resolveManifestDir(projectPath) {
+    try {
+        const structure = resolveProjectStructureSync(projectPath, {
+            quiet: true
+        });
+        return __rspack_external_node_path_c5b9b54f.dirname(structure.manifestPath);
+    } catch  {
+        return;
+    }
+}
+function findConfigFile(projectPath) {
+    const atRoot = findConfigFileIn(projectPath);
+    if (atRoot) return atRoot;
+    const manifestDir = resolveManifestDir(projectPath);
+    if (!manifestDir || __rspack_external_node_path_c5b9b54f.resolve(manifestDir) === __rspack_external_node_path_c5b9b54f.resolve(projectPath)) return;
+    return findConfigFileIn(manifestDir);
+}
 function preloadEnvFiles(projectDir) {
     const local = preloadEnvFilesFromDir(projectDir);
     if (local.loadedAny) return local;
@@ -602,7 +242,7 @@ async function loadConfigFileUncached(absolutePath) {
 async function loadCustomConfig(projectPath) {
     const configPath = findConfigFile(projectPath);
     if (configPath) {
-        if (await config_loader_isUsingExperimentalConfig(projectPath)) try {
+        if (await isUsingExperimentalConfig(projectPath)) try {
             const userConfig = await loadConfigFile(configPath);
             if (userConfig && 'function' == typeof userConfig.config) return userConfig.config;
             if (userConfig?.config && 'object' == typeof userConfig.config) {
@@ -621,27 +261,21 @@ async function loadCustomConfig(projectPath) {
     }
     return (config)=>config;
 }
-async function loadCommandConfig(projectPath, command) {
+async function loadProjectConfigDefaults(projectPath) {
     const configPath = findConfigFile(projectPath);
     if (configPath) {
-        if (await config_loader_isUsingExperimentalConfig(projectPath)) try {
+        if (await isUsingExperimentalConfig(projectPath)) try {
             const userConfig = await loadConfigFile(configPath);
-            const configExtras = userConfig;
-            const baseExtensions = configExtras && configExtras.extensions ? {
-                extensions: configExtras.extensions
-            } : {};
-            const baseTranspilePackages = configExtras && Array.isArray(configExtras.transpilePackages) ? {
-                transpilePackages: configExtras.transpilePackages
-            } : {};
-            const basePerfBudgets = configExtras && configExtras.perfBudgets && 'object' == typeof configExtras.perfBudgets ? {
-                perfBudgets: configExtras.perfBudgets
-            } : {};
-            const perCommand = userConfig?.commands?.[command] ? userConfig.commands[command] : {};
             return {
-                ...baseExtensions,
-                ...baseTranspilePackages,
-                ...basePerfBudgets,
-                ...perCommand
+                ...userConfig?.extensions ? {
+                    extensions: userConfig.extensions
+                } : {},
+                ...Array.isArray(userConfig?.transpilePackages) ? {
+                    transpilePackages: userConfig.transpilePackages
+                } : {},
+                ...userConfig?.perfBudgets && 'object' == typeof userConfig.perfBudgets ? {
+                    perfBudgets: userConfig.perfBudgets
+                } : {}
             };
         } catch (err) {
             const error = err;
@@ -651,10 +285,24 @@ async function loadCommandConfig(projectPath, command) {
     }
     return {};
 }
+async function loadCommandConfig(projectPath, command) {
+    const configPath = findConfigFile(projectPath);
+    if (configPath) {
+        if (await isUsingExperimentalConfig(projectPath)) try {
+            const userConfig = await loadConfigFile(configPath);
+            return userConfig?.commands?.[command] || {};
+        } catch (err) {
+            const error = err;
+            console.error(configLoadingError(configPath, error));
+            throw err;
+        }
+    }
+    return {};
+}
 async function loadBrowserConfig(projectPath, browser = 'chrome') {
     const configPath = findConfigFile(projectPath);
     if (configPath) {
-        if (await config_loader_isUsingExperimentalConfig(projectPath)) try {
+        if (await isUsingExperimentalConfig(projectPath)) try {
             const userConfig = await loadConfigFile(configPath);
             if (userConfig?.browser) {
                 const browsers = userConfig.browser;
@@ -688,142 +336,18 @@ async function loadBrowserConfig(projectPath, browser = 'chrome') {
     };
 }
 let userMessageDelivered = false;
-async function config_loader_isUsingExperimentalConfig(projectPath) {
+async function isUsingExperimentalConfig(projectPath) {
     const configPath = findConfigFile(projectPath);
     if (configPath) {
         if (!userMessageDelivered) {
-            if (isDebug()) console.log(isUsingExperimentalConfig('extension.config.js'));
+            if (isDebug()) console.log(messages_isUsingExperimentalConfig('extension.config.js'));
             userMessageDelivered = true;
         }
         return true;
     }
     return false;
 }
-var package_namespaceObject = /*#__PURE__*/ JSON.parse('{"rE":"4.1.11","El":{"@prefresh/core":"1.5.9","@prefresh/utils":"1.2.1","@rspack/core":"^2.1.1","@rspack/dev-server":"2.1.0","@rspack/plugin-preact-refresh":"2.0.1","@rspack/plugin-react-refresh":"2.0.2","@vue/compiler-sfc":"3.5.26","acorn":"^8.16.0","browser-extension-manifest-fields":"^2.3.1","case-sensitive-paths-webpack-plugin":"^2.4.0","content-security-policy-parser":"^0.6.0","dotenv":"^17.2.3","es-module-lexer":"^2.1.0","extension-from-store":"^0.2.5","fflate":"^0.8.3","go-git-it":"^5.1.5","ignore":"^7.0.5","less":"4.6.7","less-loader":"13.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"8.5.23","postcss-loader":"8.2.1","postcss-preset-env":"11.1.1","postcss-scss":"4.0.9","preact":"10.27.3","prefers-yarn":"2.0.1","react-refresh":"0.18.0","sass-loader":"17.0.0","schema-utils":"^4.3.3","svelte-loader":"3.2.4","tiny-glob":"^0.2.9","vue":"3.5.26","vue-loader":"17.4.2","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.20.1"}}');
-function asAbsolute(p) {
-    return __rspack_external_node_path_c5b9b54f.isAbsolute(p) ? p : __rspack_external_node_path_c5b9b54f.resolve(p);
-}
-function toPosixPath(p) {
-    return p.split(__rspack_external_node_path_c5b9b54f.sep).join('/');
-}
-function getDirs(struct) {
-    const manifestDir = asAbsolute(__rspack_external_node_path_c5b9b54f.dirname(struct.manifestPath));
-    const projectManifestPath = struct.packageJsonPath || struct.denoJsonPath;
-    const packageJsonDir = asAbsolute(projectManifestPath ? __rspack_external_node_path_c5b9b54f.dirname(projectManifestPath) : manifestDir);
-    return {
-        manifestDir,
-        packageJsonDir
-    };
-}
-function getNodeModulesDir(packageJsonDir) {
-    return asAbsolute(__rspack_external_node_path_c5b9b54f.join(packageJsonDir, 'node_modules'));
-}
-function needsInstall(packageJsonDir) {
-    const nm = getNodeModulesDir(packageJsonDir);
-    const hasManifest = PROJECT_MANIFEST_FILENAMES.some((filename)=>__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(packageJsonDir, filename)));
-    if (!hasManifest) return false;
-    try {
-        const deps = Object.keys(readProjectDependencies(packageJsonDir));
-        if (0 === deps.length) return false;
-        if (!__rspack_external_node_fs_5ea92f0c.existsSync(nm)) return true;
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(nm, '.pnpm'))) return false;
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(nm, '.modules.yaml'))) return false;
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(nm, '.deno'))) return false;
-        const hasInstalledDep = deps.some((dep)=>__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(nm, dep)));
-        return !hasInstalledDep;
-    } catch  {
-        return true;
-    }
-}
-function normalizeBrowser(browser, chromiumBinary, geckoBinary, safariBinary) {
-    const requested = String(browser || '');
-    if (chromiumBinary) {
-        if (!requested || 'chromium-based' === requested) return 'chromium-based';
-        if ('chromium' === requested) return 'chromium';
-        if ('edge' === requested) return 'edge';
-        if ('chrome' === requested) return 'chrome';
-    }
-    if (geckoBinary) {
-        if (!requested || 'gecko-based' === requested || 'firefox-based' === requested) return 'gecko-based';
-        if ('firefox' === requested) return 'firefox';
-    }
-    if (safariBinary) {
-        if (!requested || 'webkit-based' === requested) return 'webkit-based';
-        if ('safari' === requested) return 'safari';
-    }
-    switch(requested){
-        case 'chrome':
-            return 'chrome';
-        case 'edge':
-            return 'edge';
-        case 'chromium':
-            return 'chromium';
-        case 'brave':
-            return 'brave';
-        case 'opera':
-            return 'opera';
-        case 'vivaldi':
-            return 'vivaldi';
-        case 'yandex':
-            return 'yandex';
-        case 'chromium-based':
-            return 'chromium-based';
-        case 'firefox':
-            return 'firefox';
-        case 'waterfox':
-            return 'waterfox';
-        case 'librewolf':
-            return 'librewolf';
-        case 'gecko-based':
-        case 'firefox-based':
-            return 'gecko-based';
-        case 'safari':
-            return 'safari';
-        case 'webkit-based':
-            return 'webkit-based';
-        default:
-            return 'chrome';
-    }
-}
-function getDistPath(packageJsonDir, browser) {
-    return asAbsolute(__rspack_external_node_path_c5b9b54f.join(packageJsonDir, 'dist', browser));
-}
-function computePreviewOutputPath(struct, browser, explicitOutputPath) {
-    const { manifestDir, packageJsonDir } = getDirs(struct);
-    if (explicitOutputPath) return asAbsolute(explicitOutputPath);
-    if (struct.packageJsonPath || struct.denoJsonPath) {
-        const distDir = getDistPath(packageJsonDir, browser);
-        try {
-            if (__rspack_external_node_fs_5ea92f0c.existsSync(__rspack_external_node_path_c5b9b54f.join(distDir, 'manifest.json'))) return distDir;
-        } catch  {}
-    }
-    return manifestDir;
-}
-function devtoolsEngineFor(browser) {
-    switch(browser){
-        case 'chrome':
-            return 'chrome';
-        case 'edge':
-            return 'edge';
-        case 'chromium':
-        case 'chromium-based':
-        case 'brave':
-        case 'opera':
-        case 'vivaldi':
-        case 'yandex':
-            return 'chromium';
-        case 'firefox':
-        case 'gecko-based':
-        case 'waterfox':
-        case 'librewolf':
-            return 'firefox';
-        case 'safari':
-        case 'webkit-based':
-            return 'safari';
-        default:
-            return 'chrome';
-    }
-}
+var package_namespaceObject = /*#__PURE__*/ JSON.parse('{"rE":"4.1.13","El":{"@prefresh/core":"1.5.9","@prefresh/utils":"1.2.1","@rspack/core":"^2.1.1","@rspack/dev-server":"2.1.0","@rspack/plugin-preact-refresh":"2.0.1","@rspack/plugin-react-refresh":"2.0.2","@vue/compiler-sfc":"3.5.26","acorn":"^8.16.0","browser-extension-manifest-fields":"^2.3.1","case-sensitive-paths-webpack-plugin":"^2.4.0","content-security-policy-parser":"^0.6.0","dotenv":"^17.2.3","es-module-lexer":"^2.1.0","extension-from-store":"^0.2.5","fflate":"^0.8.3","go-git-it":"^5.1.5","ignore":"^7.0.5","less":"4.6.7","less-loader":"13.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"8.5.23","postcss-loader":"8.2.1","postcss-preset-env":"11.1.1","postcss-scss":"4.0.9","preact":"10.27.3","prefers-yarn":"2.0.1","react-refresh":"0.18.0","sass-loader":"17.0.0","schema-utils":"^4.3.3","svelte-loader":"3.2.4","tiny-glob":"^0.2.9","vue":"3.5.26","vue-loader":"17.4.2","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.20.1"}}');
 function sanitize(obj) {
     return Object.fromEntries(Object.entries(obj || {}).filter(([, value])=>void 0 !== value));
 }
@@ -912,315 +436,6 @@ function mergeOptionLayers(defaults, ...layers) {
     for (const layer of layers)result = mergeLayer(result, layer || {});
     return result;
 }
-async function findUpLocal(filename, options) {
-    const root = __rspack_external_node_path_c5b9b54f.parse(options.cwd).root;
-    let currentDir = options.cwd;
-    while(true){
-        const candidate = __rspack_external_node_path_c5b9b54f.join(currentDir, filename);
-        try {
-            const stat = await __rspack_external_node_fs_5ea92f0c.promises.stat(candidate);
-            if (stat.isFile()) return candidate;
-        } catch  {}
-        if (currentDir === root) return;
-        currentDir = __rspack_external_node_path_c5b9b54f.dirname(currentDir);
-    }
-}
-async function findNearestPackageJson(manifestPath) {
-    try {
-        const manifestDir = __rspack_external_node_path_c5b9b54f.dirname(manifestPath);
-        const packageJsonPath = await findUpLocal('package.json', {
-            cwd: manifestDir
-        });
-        return packageJsonPath || null;
-    } catch (error) {
-        console.warn('Failed to find package.json:', error);
-        return null;
-    }
-}
-function validatePackageJson(packageJsonPath) {
-    try {
-        if (!__rspack_external_node_fs_5ea92f0c.existsSync(packageJsonPath)) return false;
-        const content = __rspack_external_node_fs_5ea92f0c.readFileSync(packageJsonPath, 'utf-8');
-        JSON.parse(content);
-        return true;
-    } catch (error) {
-        console.warn('Invalid package.json at:', packageJsonPath, error);
-        return false;
-    }
-}
-const isUrl = (url)=>{
-    try {
-        new URL(url);
-        return true;
-    } catch (e) {
-        return false;
-    }
-};
-const REMOTE_FETCH_TIMEOUT_MS = (()=>{
-    const raw = parseInt(String(process.env.EXTENSION_FETCH_TIMEOUT_MS || ''), 10);
-    return Number.isFinite(raw) && raw > 0 ? raw : 60000;
-})();
-function withTimeout(task, ms, label) {
-    let timer;
-    const timeout = new Promise((_, reject)=>{
-        timer = setTimeout(()=>reject(new Error(remoteFetchTimedOut(label, ms))), ms);
-    });
-    return Promise.race([
-        task,
-        timeout
-    ]).finally(()=>{
-        if (timer) clearTimeout(timer);
-    });
-}
-async function importUrlSourceFromGithub(pathOrRemoteUrl, text) {
-    const cwd = process.cwd();
-    const url = new URL(pathOrRemoteUrl);
-    const segments = url.pathname.split('/').filter(Boolean);
-    const repoName = segments.length >= 2 ? segments[1] : segments[segments.length - 1];
-    const treeIndex = segments.indexOf('tree');
-    const expectedName = -1 !== treeIndex && segments.length > treeIndex + 2 ? segments[segments.length - 1] : repoName;
-    const expectedPath = __rspack_external_node_path_c5b9b54f.resolve(cwd, expectedName);
-    if (__rspack_external_node_fs_5ea92f0c.existsSync(expectedPath)) try {
-        const entries = __rspack_external_node_fs_5ea92f0c.readdirSync(expectedPath);
-        if (0 === entries.length) __rspack_external_node_fs_5ea92f0c.rmSync(expectedPath, {
-            recursive: true,
-            force: true
-        });
-        else {
-            const hasManifest = (dir)=>{
-                const stack = [
-                    dir
-                ];
-                while(stack.length){
-                    const current = stack.pop();
-                    const items = __rspack_external_node_fs_5ea92f0c.readdirSync(current, {
-                        withFileTypes: true
-                    });
-                    for (const it of items){
-                        if (it.isFile() && 'manifest.json' === it.name) return true;
-                        if (it.isDirectory() && 'node_modules' !== it.name && 'dist' !== it.name && !it.name.startsWith('.')) stack.push(__rspack_external_node_path_c5b9b54f.join(current, it.name));
-                    }
-                }
-                return false;
-            };
-            if (hasManifest(expectedPath)) return expectedPath;
-            __rspack_external_node_fs_5ea92f0c.rmSync(expectedPath, {
-                recursive: true,
-                force: true
-            });
-        }
-    } catch  {}
-    async function tryGitClone() {
-        const { default: goGitIt } = await import("go-git-it");
-        await withTimeout(goGitIt(pathOrRemoteUrl, cwd, text), REMOTE_FETCH_TIMEOUT_MS, pathOrRemoteUrl);
-    }
-    async function tryZipFallback() {
-        const branch = -1 !== treeIndex && segments.length > treeIndex + 1 ? segments[treeIndex + 1] : 'main';
-        const owner = segments[0];
-        const repo = segments[1];
-        const subdir = -1 !== treeIndex && segments.length > treeIndex + 2 ? segments.slice(treeIndex + 2).join('/') : '';
-        const zipUrl = `https://codeload.github.com/${owner}/${repo}/zip/refs/heads/${branch}`;
-        const extractedPath = await importUrlSourceFromZip(zipUrl);
-        const extractedDirs = __rspack_external_node_fs_5ea92f0c.readdirSync(extractedPath, {
-            withFileTypes: true
-        }).filter((d)=>d.isDirectory()).map((d)=>d.name);
-        const repoRootDir = extractedDirs.find((d)=>d.startsWith(`${repo}-${branch}`));
-        const repoRoot = repoRootDir ? __rspack_external_node_path_c5b9b54f.join(extractedPath, repoRootDir) : extractedPath;
-        return subdir ? __rspack_external_node_path_c5b9b54f.join(repoRoot, subdir) : repoRoot;
-    }
-    try {
-        await tryGitClone();
-    } catch  {
-        return await tryZipFallback();
-    }
-    const candidates = [];
-    if (-1 !== treeIndex && segments.length > treeIndex + 2) candidates.push(segments[segments.length - 1]);
-    candidates.push(repoName);
-    for (const name of candidates){
-        const p = __rspack_external_node_path_c5b9b54f.resolve(cwd, name);
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(p)) return p;
-    }
-    const dirs = __rspack_external_node_fs_5ea92f0c.readdirSync(cwd, {
-        withFileTypes: true
-    }).filter((d)=>d.isDirectory()).map((d)=>d.name);
-    for (const dir of dirs){
-        const manifestPath = __rspack_external_node_path_c5b9b54f.join(cwd, dir, 'manifest.json');
-        if (__rspack_external_node_fs_5ea92f0c.existsSync(manifestPath)) return __rspack_external_node_path_c5b9b54f.join(cwd, dir);
-    }
-    try {
-        const dirs = __rspack_external_node_fs_5ea92f0c.readdirSync(cwd, {
-            withFileTypes: true
-        }).filter((d)=>d.isDirectory()).map((d)=>d.name);
-        const ghRoot = dirs.find((d)=>/-main$|-master$/.test(d));
-        if (ghRoot) return __rspack_external_node_path_c5b9b54f.join(cwd, ghRoot);
-    } catch  {}
-    throw new Error(downloadedProjectFolderNotFound(cwd, candidates));
-}
-async function importUrlSourceFromZip(pathOrRemoteUrl) {
-    const cwd = process.cwd();
-    const { downloadAndExtractZip } = await import("./0~zip.mjs");
-    const extractedPath = await withTimeout(downloadAndExtractZip(pathOrRemoteUrl, cwd), REMOTE_FETCH_TIMEOUT_MS, pathOrRemoteUrl);
-    return extractedPath;
-}
-async function importLocalSourceFromZip(zipFilePath) {
-    const cwd = process.cwd();
-    const { extractLocalZip } = await import("./0~zip.mjs");
-    return await extractLocalZip(zipFilePath, cwd);
-}
-async function getProjectPath(pathOrRemoteUrl) {
-    if (!pathOrRemoteUrl) return process.cwd();
-    if (isUrl(pathOrRemoteUrl)) {
-        const url = new URL(pathOrRemoteUrl);
-        if (url.protocol.startsWith('http')) {
-            const pathname = url.pathname.toLowerCase();
-            if (pathname.endsWith('.zip')) return await importUrlSourceFromZip(pathOrRemoteUrl);
-            if ('https://github.com' !== url.origin) {
-                const urlSource = await importUrlSourceFromZip(pathOrRemoteUrl);
-                return urlSource;
-            }
-            const urlData = url.pathname.split('/');
-            const owner = urlData.slice(1, 3)[0];
-            const project = urlData.slice(1, 3)[1];
-            console.log(fetchingProjectPath(owner, project));
-            const projectName = __rspack_external_node_path_c5b9b54f.basename(url.pathname);
-            const urlSource = await importUrlSourceFromGithub(pathOrRemoteUrl, downloadingProjectPath(projectName));
-            console.log(creatingProjectPath(url.pathname));
-            return urlSource;
-        }
-    }
-    const resolvedPath = __rspack_external_node_path_c5b9b54f.resolve(process.cwd(), pathOrRemoteUrl);
-    if ('.zip' === __rspack_external_node_path_c5b9b54f.extname(resolvedPath).toLowerCase() && __rspack_external_node_fs_5ea92f0c.existsSync(resolvedPath) && __rspack_external_node_fs_5ea92f0c.statSync(resolvedPath).isFile()) return await importLocalSourceFromZip(resolvedPath);
-    return resolvedPath;
-}
-function collectManifestCandidates(rootDir, maxDepth) {
-    const SKIP_DIRS = new Set([
-        'node_modules',
-        'dist',
-        'build',
-        'out',
-        '.git',
-        '.turbo',
-        '.next',
-        'coverage',
-        '.cache',
-        '.vercel'
-    ]);
-    const results = [];
-    const walk = (dir, depth)=>{
-        if (depth > maxDepth || results.length >= 10) return;
-        let entries;
-        try {
-            entries = __rspack_external_node_fs_5ea92f0c.readdirSync(dir, {
-                withFileTypes: true
-            });
-        } catch  {
-            return;
-        }
-        for (const entry of entries){
-            if (entry.isFile() && 'manifest.json' === entry.name) {
-                results.push(__rspack_external_node_path_c5b9b54f.join(dir, entry.name));
-                continue;
-            }
-            if (entry.isDirectory() && !entry.name.startsWith('.') && !SKIP_DIRS.has(entry.name)) walk(__rspack_external_node_path_c5b9b54f.join(dir, entry.name), depth + 1);
-        }
-    };
-    walk(rootDir, 0);
-    return results;
-}
-async function getProjectStructure(pathOrRemoteUrl) {
-    const projectPath = await getProjectPath(pathOrRemoteUrl);
-    const isUnderDir = (baseDir, candidatePath)=>{
-        const rel = __rspack_external_node_path_c5b9b54f.relative(baseDir, candidatePath);
-        return Boolean(rel && !rel.startsWith('..') && !__rspack_external_node_path_c5b9b54f.isAbsolute(rel));
-    };
-    const packageJsonPathFromProject = await findNearestPackageJson(__rspack_external_node_path_c5b9b54f.join(projectPath, 'manifest.json'));
-    const denoJsonPathFromProject = findNearestDenoConfigSync(__rspack_external_node_path_c5b9b54f.join(projectPath, 'manifest.json'));
-    const packageJsonDirFromProject = packageJsonPathFromProject ? __rspack_external_node_path_c5b9b54f.dirname(packageJsonPathFromProject) : denoJsonPathFromProject ? __rspack_external_node_path_c5b9b54f.dirname(denoJsonPathFromProject) : void 0;
-    const rootManifestPath = __rspack_external_node_path_c5b9b54f.join(projectPath, 'manifest.json');
-    const srcManifestPath = __rspack_external_node_path_c5b9b54f.join(projectPath, 'src', 'manifest.json');
-    let manifestPath = __rspack_external_node_fs_5ea92f0c.existsSync(srcManifestPath) ? srcManifestPath : rootManifestPath;
-    if (!__rspack_external_node_fs_5ea92f0c.existsSync(manifestPath)) if (packageJsonDirFromProject) {
-        const absoluteCandidates = collectManifestCandidates(projectPath, 3);
-        const relativeCandidates = absoluteCandidates.map((candidate)=>__rspack_external_node_path_c5b9b54f.relative(projectPath, candidate) || candidate);
-        if (1 === absoluteCandidates.length) {
-            manifestPath = absoluteCandidates[0];
-            console.log(resolvedWorkspaceManifest(projectPath, manifestPath));
-        } else throw new Error(manifestNotFoundError(manifestPath, relativeCandidates));
-    } else {
-        const MAX_DEPTH = 5;
-        const findManifest = (dir, depth)=>{
-            if (depth > MAX_DEPTH) return null;
-            let files;
-            try {
-                files = __rspack_external_node_fs_5ea92f0c.readdirSync(dir, {
-                    withFileTypes: true
-                });
-            } catch  {
-                return null;
-            }
-            for (const file of files){
-                if (file.isFile() && 'manifest.json' === file.name) return __rspack_external_node_path_c5b9b54f.join(dir, file.name);
-                if (file.isDirectory() && !file.name.startsWith('.') && 'node_modules' !== file.name && 'dist' !== file.name && 'public' !== file.name) {
-                    const found = findManifest(__rspack_external_node_path_c5b9b54f.join(dir, file.name), depth + 1);
-                    if (found) return found;
-                }
-            }
-            return null;
-        };
-        const foundManifest = findManifest(projectPath, 0);
-        if (foundManifest) manifestPath = foundManifest;
-        else throw new Error(manifestNotFoundError(manifestPath));
-    }
-    const readManifestObject = (candidatePath)=>{
-        try {
-            const parsed = parseJsonSafe(__rspack_external_node_fs_5ea92f0c.readFileSync(candidatePath));
-            if (null === parsed || 'object' != typeof parsed || Array.isArray(parsed)) return;
-            return parsed;
-        } catch  {
-            return;
-        }
-    };
-    const isPwaManifest = (candidatePath)=>{
-        const parsed = readManifestObject(candidatePath);
-        if (!parsed || null != parsed.manifest_version) return false;
-        return Array.isArray(parsed.icons) || 'string' == typeof parsed.start_url || 'string' == typeof parsed.display || null != parsed.related_applications || null != parsed.prefer_related_applications;
-    };
-    if (__rspack_external_node_fs_5ea92f0c.existsSync(manifestPath) && isPwaManifest(manifestPath)) {
-        const alternatives = collectManifestCandidates(projectPath, 3).filter((candidate)=>__rspack_external_node_path_c5b9b54f.resolve(candidate) !== __rspack_external_node_path_c5b9b54f.resolve(manifestPath) && readManifestObject(candidate)?.manifest_version != null);
-        if (1 === alternatives.length) {
-            manifestPath = alternatives[0];
-            console.log(resolvedWorkspaceManifest(projectPath, manifestPath));
-        } else throw new Error(notAnExtensionManifestError(manifestPath));
-    }
-    const packageJsonPath = await findNearestPackageJson(manifestPath);
-    const packageJsonDir = packageJsonPath ? __rspack_external_node_path_c5b9b54f.dirname(packageJsonPath) : void 0;
-    const nearestDenoJsonPath = findNearestDenoConfigSync(manifestPath);
-    const denoJsonPath = nearestDenoJsonPath && validateDenoConfig(nearestDenoJsonPath) ? nearestDenoJsonPath : void 0;
-    const projectRootDir = packageJsonDir ?? (denoJsonPath ? __rspack_external_node_path_c5b9b54f.dirname(denoJsonPath) : void 0);
-    if (projectRootDir) {
-        const publicRoot = __rspack_external_node_path_c5b9b54f.join(projectRootDir, 'public');
-        if (isUnderDir(publicRoot, manifestPath)) {
-            const fallbackSrc = __rspack_external_node_path_c5b9b54f.join(projectRootDir, 'src', 'manifest.json');
-            const fallbackRoot = __rspack_external_node_path_c5b9b54f.join(projectRootDir, 'manifest.json');
-            if (__rspack_external_node_fs_5ea92f0c.existsSync(fallbackSrc)) manifestPath = fallbackSrc;
-            else if (__rspack_external_node_fs_5ea92f0c.existsSync(fallbackRoot)) manifestPath = fallbackRoot;
-            else throw new Error(manifestNotFoundError(fallbackRoot));
-        }
-    }
-    if (!packageJsonPath || !validatePackageJson(packageJsonPath)) return {
-        manifestPath,
-        ...denoJsonPath ? {
-            denoJsonPath
-        } : {}
-    };
-    return {
-        manifestPath,
-        packageJsonPath,
-        ...denoJsonPath ? {
-            denoJsonPath
-        } : {}
-    };
-}
 function isReferencedAsModuleSpecifier(configSource, dep) {
     const escaped = dep.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     const specifierRe = new RegExp(`['"\`]${escaped}(?:/[^'"\`]*)?['"\`]`);
@@ -1369,7 +584,7 @@ function readManifestProvenance(manifestPath) {
         return {};
     }
 }
-function plugin_playwright_ensureDirSync(dirPath) {
+function ensureDirSync(dirPath) {
     try {
         __rspack_external_node_fs_5ea92f0c.mkdirSync(dirPath, {
             recursive: true
@@ -1460,7 +675,7 @@ function createPlaywrightMetadataWriter(options) {
     };
     function writeReady(status, extra) {
         if (foreignLiveDevSession) return;
-        plugin_playwright_ensureDirSync(metadataDir);
+        ensureDirSync(metadataDir);
         let prev;
         try {
             if (__rspack_external_node_fs_5ea92f0c.existsSync(readyPath)) prev = JSON.parse(__rspack_external_node_fs_5ea92f0c.readFileSync(readyPath, 'utf-8'));
@@ -1517,7 +732,7 @@ function createPlaywrightMetadataWriter(options) {
     }
     function appendEvent(event) {
         if (foreignLiveDevSession) return;
-        plugin_playwright_ensureDirSync(metadataDir);
+        ensureDirSync(metadataDir);
         try {
             __rspack_external_node_fs_5ea92f0c.appendFileSync(eventsPath, `${JSON.stringify({
                 ...event,
@@ -1535,7 +750,7 @@ function createPlaywrightMetadataWriter(options) {
         },
         writeStarting () {
             if (foreignLiveDevSession) return;
-            plugin_playwright_ensureDirSync(metadataDir);
+            ensureDirSync(metadataDir);
             try {
                 __rspack_external_node_fs_5ea92f0c.writeFileSync(eventsPath, '', 'utf-8');
             } catch  {}
@@ -1715,7 +930,23 @@ function normalizeCompanionConfig(config) {
         paths: explicitPaths
     };
 }
-function resolve_config_isPathLike(value) {
+const BROWSER_COMPANION_FOLDERS = new Set([
+    'chrome',
+    'edge',
+    'firefox'
+]);
+function isBrowserNamedCompanionFolder(name) {
+    return BROWSER_COMPANION_FOLDERS.has(name.toLowerCase());
+}
+function companionFolderForBrowser(browser) {
+    if (browser && isGeckoBasedBrowser(String(browser))) return 'firefox';
+    if ('edge' === browser) return 'edge';
+    return 'chrome';
+}
+function companionFolderMatchesBrowser(name, browser) {
+    return name.toLowerCase() === companionFolderForBrowser(browser);
+}
+function isPathLike(value) {
     if (__rspack_external_node_path_c5b9b54f.isAbsolute(value)) return true;
     if (value.startsWith('./') || value.startsWith('../')) return true;
     return value.includes('/') || value.includes('\\');
@@ -1730,27 +961,46 @@ function getBrowserFolder(browser) {
     return 'chrome';
 }
 function parseChromeWebStoreId(url) {
-    if ('chromewebstore.google.com' !== url.hostname) return null;
+    const host = stripWww(url.hostname);
+    const legacy = 'chrome.google.com' === host && /^\/webstore(?:\/|$)/i.test(url.pathname);
+    if ('chromewebstore.google.com' !== host && !legacy) return null;
     const match = url.pathname.match(/\/([a-z]{32})(?:\/|$)/i);
     return match ? match[1] : null;
 }
 function parseEdgeAddonsId(url) {
-    if ('microsoftedge.microsoft.com' !== url.hostname) return null;
+    if ('microsoftedge.microsoft.com' !== stripWww(url.hostname)) return null;
     const match = url.pathname.match(/\/([a-z]{32})(?:\/|$)/i);
     return match ? match[1] : null;
 }
 function parseAmoSlug(url) {
-    if ('addons.mozilla.org' !== url.hostname) return null;
+    if ('addons.mozilla.org' !== stripWww(url.hostname)) return null;
     const match = url.pathname.match(/\/addon\/([^/]+)(?:\/|$)/i);
     return match ? match[1] : null;
 }
-function parseStoreUrl(raw) {
-    let url;
+const STORE_HOSTS = new Set([
+    'chromewebstore.google.com',
+    'chrome.google.com',
+    'microsoftedge.microsoft.com',
+    'addons.mozilla.org'
+]);
+function stripWww(hostname) {
+    return hostname.toLowerCase().replace(/^www\./, '');
+}
+function toWebUrl(raw) {
     try {
-        url = new URL(raw);
+        const url = new URL(raw);
+        if ('http:' === url.protocol || 'https:' === url.protocol) return url;
+        return null;
+    } catch  {}
+    const match = raw.match(/^([a-z0-9.-]+)(?:[/?#].*)?$/i);
+    if (!match || !STORE_HOSTS.has(stripWww(match[1]))) return null;
+    try {
+        return new URL(`https://${raw}`);
     } catch  {
         return null;
     }
+}
+function parseStoreUrl(url) {
     const chromeId = parseChromeWebStoreId(url);
     if (chromeId) return {
         browser: 'chrome',
@@ -1840,19 +1090,26 @@ async function resolveCompanionExtensionsConfig(opts) {
     const resolvedPaths = [];
     const localPaths = [];
     for (const entry of normalized.paths){
-        const parsedStore = parseStoreUrl(entry);
-        if (parsedStore) {
+        const url = toWebUrl(entry);
+        if (url) {
+            const parsedStore = parseStoreUrl(url);
+            if (!parsedStore) throw new Error(`Companion extension link is not a store link this resolver recognises: ${entry}\nSupported links: https://chromewebstore.google.com/detail/<name>/<id>, https://microsoftedge.microsoft.com/addons/detail/<name>/<id>, https://addons.mozilla.org/<locale>/firefox/addon/<slug>`);
             if (parsedStore.browser !== runtimeBrowser) continue;
             const resolvedPath = await resolveStoreExtensionToPath({
                 projectRoot,
-                storeUrl: entry,
+                storeUrl: url.href,
                 browser: parsedStore.browser,
                 id: parsedStore.id
             });
             resolvedPaths.push(resolvedPath);
             continue;
         }
-        if (resolve_config_isPathLike(entry)) localPaths.push(entry);
+        if (isPathLike(entry)) {
+            localPaths.push(entry);
+            continue;
+        }
+        if (/^[a-p]{32}$/i.test(entry)) throw new Error(`Companion extension entry looks like a store id, not a store link: ${entry}\nUse the full store link so the browser it belongs to is known, for example https://chromewebstore.google.com/detail/<name>/${entry}`);
+        throw new Error(`Companion extension entry is neither a store link nor a folder path: ${entry}\nGive a store link or a path under ./extensions`);
     }
     if (localPaths.length > 0) {
         const absLocalPaths = ensurePathsUnderExtensions(projectRoot, localPaths);
@@ -1871,6 +1128,15 @@ async function resolveCompanionExtensionsConfig(opts) {
 function serverRestartRequiredFromSpecialFolderMessageOnly(addingOrRemoving, folder, typeOfAsset) {
     return `${messaging_prefix('warn')} ${addingOrRemoving} ${pintor.yellow(typeOfAsset)} in ${pintor.underline(`${folder}/`)} changes the extension entrypoints.\nRestart the dev server to apply the change.`;
 }
+function displayPath(absolutePath) {
+    return absolutePath.replace(/\\/g, '/');
+}
+function publicMustBeAtProjectRoot(foundAt, expectedAt) {
+    return `The public folder sits in the legacy next-to-manifest location.\nGOT ${displayPath(foundAt)}\nEXPECTED ${displayPath(expectedAt)}\nStatic files ship from the extension root, so public/ is canonically placed at the project root.\nThe build uses it either way.\nMove the folder to the project root to silence this warning.`;
+}
+function publicFolderShadowed(usedAt, ignoredAt) {
+    return `Two public folders were found and only one is copied into the build.\nUSING ${displayPath(usedAt)}\nIGNORED ${displayPath(ignoredAt)}\npublic/ is canonically placed at the project root, and that copy wins.\nFiles that exist only in the ignored folder do not ship.\nMove or merge the ignored folder to silence this warning.`;
+}
 function specialFoldersSetupSummary(hasPublic, copyEnabled, ignoredCount) {
     return `${messaging_prefix('debug')} folders  setup public=${String(hasPublic)} copy=${String(copyEnabled)} ignored=${String(ignoredCount)}`;
 }
@@ -2233,14 +1499,14 @@ function withDarkMode(config) {
     };
 }
 const cjsRequire = createRequire(import.meta.url);
-function messages_getLoggingPrefix(type) {
+function getLoggingPrefix(type) {
     return messaging_prefix(type);
 }
 function messages_ready(mode, browser) {
     const noun = artifactNoun(browser);
     const state = pintor.green(`ready for ${mode}`);
     const watching = 'development' === mode ? ' Watching for file changes.' : '';
-    return `${messages_getLoggingPrefix('success')} ${noun} ${state}.${watching}`;
+    return `${getLoggingPrefix('success')} ${noun} ${state}.${watching}`;
 }
 function readJsonRecord(filePath) {
     try {
@@ -2311,37 +1577,46 @@ function shouldWarnPortConflict(requested, actual) {
     return Number.isFinite(requestedPort) && 0 !== requestedPort && requestedPort !== actual;
 }
 function portInUse(requestedPort, newPort) {
-    return `${messages_getLoggingPrefix('warn')} Port ${requestedPort} is in use.\nThe dev server listens on port ${newPort} instead.`;
+    return `${getLoggingPrefix('warn')} Port ${requestedPort} is in use.\nThe dev server listens on port ${newPort} instead.`;
 }
 function extensionJsRunnerError(error) {
-    return `${messages_getLoggingPrefix('error')} Extension.js couldn't start the runner.\n${pintor.red(String(error))}`;
+    return `${getLoggingPrefix('error')} Extension.js couldn't start the runner.\n${pintor.red(String(error))}`;
 }
 function autoExitModeEnabled(ms) {
-    return `${messages_getLoggingPrefix('info')} Auto-exit is enabled.\nThe process exits after ${ms} ms of idle time.`;
+    return `${getLoggingPrefix('info')} Auto-exit is enabled.\nThe process exits after ${ms} ms of idle time.`;
 }
 function autoExitTriggered(ms) {
-    return `${messages_getLoggingPrefix('info')} Auto-exit triggered after ${ms} ms.\nThe process cleans up and exits now.`;
+    return `${getLoggingPrefix('info')} Auto-exit triggered after ${ms} ms.\nThe process cleans up and exits now.`;
 }
 function autoExitForceKill(ms) {
-    return `${messages_getLoggingPrefix('warn')} The process didn't exit within ${ms} ms, so it exits forcibly now.`;
+    return `${getLoggingPrefix('warn')} The process didn't exit within ${ms} ms, so it exits forcibly now.`;
 }
 function devServerStartTimeout(ms) {
     return [
-        `${messages_getLoggingPrefix('warn')} The dev server didn't start within ${ms} ms.`,
+        `${getLoggingPrefix('warn')} The dev server didn't start within ${ms} ms.`,
         "The bundler may have hit an error before emitting the first build.",
         `If nothing else prints, set ${pintor.blue('EXTENSION_VERBOSE=1')} to see more logs.`
     ].join('\n');
 }
 function bundlerFatalError(error) {
     const text = error instanceof Error ? error.stack || error.message : String(error);
-    return `${messages_getLoggingPrefix('error')} The build failed to start.\n${pintor.red(text)}`;
+    return `${getLoggingPrefix('error')} The build failed to start.\n${pintor.red(text)}`;
+}
+function devServerRestarting(request) {
+    const what = 'icons' === request.reason ? 'a manifest icon' : 'html' === request.reason ? 'an HTML entrypoint' : 'json' === request.reason ? 'a manifest JSON entry' : "a manifest script entry";
+    const lines = [
+        `${getLoggingPrefix('info')} Restarting the dev server to pick up ${what} change…`
+    ];
+    if (request.pathBefore) lines.push(`${pintor.gray('BEFORE')} ${pintor.underline(request.pathBefore)}`);
+    if (request.pathAfter) lines.push(`${pintor.gray('AFTER')} ${pintor.underline(request.pathAfter)}`);
+    return lines.join('\n');
 }
 function bundlerRecompiling() {
-    return `${messages_getLoggingPrefix('info')} Recompiling due to file changes…`;
+    return `${getLoggingPrefix('info')} Recompiling due to file changes…`;
 }
 function noEntrypointsDetected(port) {
     return [
-        `${messages_getLoggingPrefix('warn')} The first compilation produced no entrypoints or assets.`,
+        `${getLoggingPrefix('warn')} The first compilation produced no entrypoints or assets.`,
         `The dev server is running on 127.0.0.1:${port}, but nothing is being built.`,
         "Possible causes:",
         "- Empty or missing entry configuration.",
@@ -2353,6 +1628,15 @@ function noEntrypointsDetected(port) {
 function spacerLine() {
     return ' ';
 }
+function runnerCleanupError(error) {
+    return `${messaging_prefix('error')} The dev server could not shut down cleanly: ${String(error?.message || error)}`;
+}
+function runnerUncaughtException(error) {
+    return `${messaging_prefix('error')} Uncaught exception in the dev server: ${String(error?.message || error)}`;
+}
+function runnerUnhandledRejection(reason) {
+    return `${messaging_prefix('error')} Unhandled rejection in the dev server: ${String(reason?.message || reason)}`;
+}
 function hasNewTabOverride(extensionDir) {
     const manifestPath = __rspack_external_node_path_c5b9b54f.join(extensionDir, 'manifest.json');
     if (!__rspack_external_node_fs_5ea92f0c.existsSync(manifestPath)) return false;
@@ -2428,7 +1712,7 @@ function computeExtensionsToLoad(baseDir, mode, browser, userExtensionOutputPath
     return dedupeByResolvedPath(list);
 }
 function resolveCompanionExtensionDirs(opts) {
-    const { projectRoot, config } = opts;
+    const { projectRoot, config, browser } = opts;
     const normalized = normalizeCompanionConfig(config);
     const explicitPaths = normalized.paths;
     const scanDir = normalized.dir;
@@ -2468,6 +1752,7 @@ function resolveCompanionExtensionDirs(opts) {
             for (const ent of entries){
                 if (!ent.isDirectory()) continue;
                 if (ent.name.startsWith('.')) continue;
+                if (browser && isBrowserNamedCompanionFolder(ent.name) && !companionFolderMatchesBrowser(ent.name, browser)) continue;
                 const browserDir = __rspack_external_node_path_c5b9b54f.join(absScan, ent.name);
                 scanOneLevel(browserDir);
             }
@@ -2495,16 +1780,17 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
     const { manifestDir, packageJsonDir } = getDirs(projectStructure);
     const userManifestPath = projectStructure.packageJsonPath || projectStructure.denoJsonPath;
     if (userManifestPath) assertNoManagedDependencyConflicts(userManifestPath, packageJsonDir);
-    const browser = normalizeBrowser(previewOptions.browser || 'chrome', previewOptions.chromiumBinary, previewOptions.geckoBinary || previewOptions.firefoxBinary);
+    const metadataCommand = 'start' === previewOptions.metadataCommand ? 'start' : 'preview';
+    const configBrowser = previewOptions.browser ? void 0 : configBrowserOrThrow((await loadCommandConfig(packageJsonDir, metadataCommand)).browser, metadataCommand);
+    const browser = normalizeBrowser(previewOptions.browser || configBrowser || 'chrome', previewOptions.chromiumBinary, previewOptions.geckoBinary || previewOptions.firefoxBinary);
     const outputPath = computePreviewOutputPath(projectStructure, browser, previewOptions.outputPath);
     const distPath = getDistPath(packageJsonDir, browser);
-    const metadataCommand = 'start' === previewOptions.metadataCommand ? 'start' : 'preview';
     const runningMessage = 'start' === metadataCommand ? starting : previewing;
     const metadata = createPlaywrightMetadataWriter({
         packageJsonDir,
         browser: String(browser),
         command: metadataCommand,
-        distPath,
+        distPath: outputPath,
         manifestPath: projectStructure.manifestPath,
         port: 'number' == typeof previewOptions.port ? previewOptions.port : 'string' == typeof previewOptions.port ? parseInt(previewOptions.port, 10) : null
     });
@@ -2515,11 +1801,13 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
         humanLine(debugBrowser(browser, previewOptions.chromiumBinary, previewOptions.geckoBinary || previewOptions.firefoxBinary));
         humanLine(debugPreviewOutput(outputPath, distPath));
     }
+    ensureSessionArtifactsIgnoreFile(packageJsonDir);
     const manifestAtOutput = __rspack_external_node_path_c5b9b54f.join(outputPath, 'manifest.json');
     if (!__rspack_external_node_fs_5ea92f0c.existsSync(manifestAtOutput)) {
         metadata.writeError('preview_manifest_missing', `Expected manifest at ${manifestAtOutput}`);
         throw new Error(`Preview is run-only and does not compile.\nExpected an unpacked extension at:\n  ${manifestAtOutput}\n\nRun \`extension build\` or \`extension dev\` first, or pass --output-path to an existing unpacked extension directory.`);
     }
+    const projectConfig = await loadProjectConfigDefaults(packageJsonDir);
     const commandConfig = await loadCommandConfig(packageJsonDir, metadataCommand);
     const browserConfig = await loadBrowserConfig(packageJsonDir, browser);
     if (previewOptions.noBrowser) {
@@ -2537,12 +1825,13 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
         return;
     }
     humanLine(runningMessage(browser));
-    if (!previewOptions.outputPath && __rspack_external_node_path_c5b9b54f.resolve(outputPath) !== __rspack_external_node_path_c5b9b54f.resolve(distPath)) humanLine(previewingSourceFallback(browser, distPath));
+    if (__rspack_external_node_path_c5b9b54f.resolve(outputPath) !== __rspack_external_node_path_c5b9b54f.resolve(distPath)) humanLine(previewOptions.outputPath ? previewingCustomOutput(browser, outputPath, distPath) : previewingSourceFallback(browser, distPath));
+    const safeProjectConfig = sanitize(projectConfig);
     const safeBrowserConfig = sanitize(browserConfig);
     const safeCommandConfig = sanitize(commandConfig);
     const safePreviewOptions = sanitize(previewOptions);
     const specialFoldersData = getSpecialFoldersDataForProjectRoot(packageJsonDir);
-    const mergedExtensionsConfig = safePreviewOptions.extensions ?? safeCommandConfig.extensions ?? safeBrowserConfig.extensions ?? specialFoldersData.extensions;
+    const mergedExtensionsConfig = safePreviewOptions.extensions ?? safeCommandConfig.extensions ?? safeBrowserConfig.extensions ?? safeProjectConfig.extensions ?? specialFoldersData.extensions;
     const resolvedExtensionsConfig = await resolveCompanionExtensionsConfig({
         projectRoot: packageJsonDir,
         browser,
@@ -2551,7 +1840,7 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
     const mergedGeckoBinary = safePreviewOptions.geckoBinary || safePreviewOptions.firefoxBinary || safeCommandConfig.geckoBinary || safeCommandConfig.firefoxBinary || safeBrowserConfig.geckoBinary || safeBrowserConfig.firefoxBinary;
     const mergedChromiumBinary = safePreviewOptions.chromiumBinary || safeCommandConfig.chromiumBinary || safeBrowserConfig.chromiumBinary;
     const merged = {
-        ...mergeOptionLayers(SERVE_COMMAND_DEFAULTS, safeBrowserConfig, safeCommandConfig, safePreviewOptions),
+        ...mergeOptionLayers(SERVE_COMMAND_DEFAULTS, safeProjectConfig, safeBrowserConfig, safeCommandConfig, safePreviewOptions),
         extensions: resolvedExtensionsConfig,
         chromiumBinary: mergedChromiumBinary,
         geckoBinary: mergedGeckoBinary
@@ -2564,7 +1853,8 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
     });
     const companionUnpackedExtensionDirs = resolveCompanionExtensionDirs({
         projectRoot: packageJsonDir,
-        config: merged.extensions
+        config: merged.extensions,
+        browser
     });
     const unpackedExtensionDirsToLoad = computeExtensionsToLoad(__rspack_external_node_path_c5b9b54f.resolve(__rspack_import_meta_dirname__, '..'), 'production', browser, outputPath, companionUnpackedExtensionDirs, projectStructure.manifestPath);
     metadata.setManagedExtensionDirs(unpackedExtensionDirsToLoad.filter((dir)=>__rspack_external_node_path_c5b9b54f.resolve(dir) !== __rspack_external_node_path_c5b9b54f.resolve(outputPath)));
@@ -2598,4 +1888,4 @@ async function extensionPreview(pathOrRemoteUrl, previewOptions, browserLauncher
     await browserLauncher(resolvedOpts);
     metadata.writeReady();
 }
-export { BUILD_COMMAND_DEFAULTS, CHROMIUM_FAMILY_ALIASES, DEV_COMMAND_DEFAULTS, GECKO_FAMILY_ALIASES, PlaywrightPlugin, START_BUILD_DEFAULTS, asAbsolute, assertNoManagedDependencyConflicts, authorInstallNotice, autoExitForceKill, autoExitModeEnabled, autoExitTriggered, browserLaunchFailed, browserRunnerDisabled, buildAssetsTree, buildCommandFailed, buildComplete, buildFailed, buildShareHint, buildWarningsDetails, bundlerFatalError, bundlerRecompiling, computeExtensionsToLoad, createPlaywrightMetadataWriter, debugBrowser, debugContextPath, debugDirs, debugExtensionsToLoad, debugOutputPath, devCommandFailed, devServerStartTimeout, downloadingText, extensionJsRunnerError, extensionLoadRecovered, extensionLoadStillRefused, extensionPreview, failedToDownloadOrExtractZIPFileError, getDirs, getDistPath, getPreloadedEnvKeys, getProjectStructure, getSessionRunId, getSpecialFoldersDataForCompiler, getSpecialFoldersDataForProjectRoot, invalidRemoteZip, isChromiumBasedBrowser, isGeckoBasedBrowser, isWebkitBasedBrowser, loadBrowserConfig, loadCommandConfig, loadCustomConfig, localZipNotFound, manifestInvalidJson, mergeOptionLayers, messages_ready, needsInstall, noCompanionExtensionsResolved, noEntrypointsDetected, normalizeBrowser, notAZipArchive, package_namespaceObject, packagingDistributionFiles, packagingSourceFiles, portInUse, projectInstallFallbackToNpm, projectInstallScriptsDisabled, resolveCompanionExtensionDirs, resolveCompanionExtensionsConfig, sanitize, serverRestartRequiredFromSpecialFolderMessageOnly, shouldWarnPortConflict, spacerLine, specialFolderChangeDetected, specialFoldersSetupSummary, stampReadyDistExtensionId, stampReadyKnownExtensionId, toPosixPath, treeWithDistFilesBrowser, treeWithSourceAndDistFiles, treeWithSourceFiles, unpackagedSuccessfully, unpackagingExtension, withDarkMode, writingTypeDefinitions, writingTypeDefinitionsError, zipArtifactReady };
+export { BUILD_COMMAND_DEFAULTS, CHROMIUM_FAMILY_ALIASES, DEV_COMMAND_DEFAULTS, GECKO_FAMILY_ALIASES, PlaywrightPlugin, START_BUILD_DEFAULTS, assertNoManagedDependencyConflicts, autoExitForceKill, autoExitModeEnabled, autoExitTriggered, browserRunnerDisabled, bundlerFatalError, bundlerRecompiling, computeExtensionsToLoad, createPlaywrightMetadataWriter, devServerRestarting, devServerStartTimeout, extensionJsRunnerError, extensionPreview, getPreloadedEnvKeys, getSessionRunId, getSpecialFoldersDataForCompiler, getSpecialFoldersDataForProjectRoot, isChromiumBasedBrowser, isGeckoBasedBrowser, isWebkitBasedBrowser, loadBrowserConfig, loadCommandConfig, loadCustomConfig, loadProjectConfigDefaults, mergeOptionLayers, messages_ready, noEntrypointsDetected, package_namespaceObject, portInUse, publicFolderShadowed, publicMustBeAtProjectRoot, resolveCompanionExtensionDirs, resolveCompanionExtensionsConfig, runnerCleanupError, runnerUncaughtException, runnerUnhandledRejection, sanitize, serverRestartRequiredFromSpecialFolderMessageOnly, shouldWarnPortConflict, spacerLine, specialFolderChangeDetected, specialFoldersSetupSummary, stampReadyDistExtensionId, stampReadyKnownExtensionId, withDarkMode };