extension-develop 4.0.26 → 4.0.27

package/README.md

@@ -175,7 +175,11 @@ Options accepted by each command. Values shown are typical types or enumerations
 - browser.chrome | .firefox | .edge | .chromium-based | .gecko-based: start flags, excluded flags, preferences, binaries, profile reuse (persistProfile), and per-browser `extensions`.
   - extensions: load-only companion extensions (unpacked dirs) loaded alongside your extension in dev/preview/start.
     - Example: { dir: "./extensions" } loads every "./extensions/\*" folder that contains a manifest.json.
-- Precedence when composing options: browser._ → commands._ → CLI flags. CLI flags always win over config defaults.
+- Precedence when composing options (one contract for every command): stock defaults → browser._ → commands._ → CLI flags.
+  - Scalars: an unset flag never clobbers config, and an explicit flag (including `false`) always wins.
+    - Example: `commands.dev.polyfill: false` turns the polyfill off for the team, and `--polyfill` turns it back on for one run.
+  - Lists (`browserFlags`, `excludeBrowserFlags`): concatenate across layers in order (browser, then command, then CLI) and dedupe.
+  - Objects (`preferences`): deep-merge, later layers win on key conflict.
 - Browser key aliases when resolving `browser.*` from `extension.config.*`:
   - When the runtime asks for `chromium`, `loadBrowserConfig` prefers `browser.chromium` and then falls back to `browser['chromium-based']`.
   - When the runtime asks for `chromium-based`, it prefers `browser['chromium-based']` and then `browser.chromium`.

package/dist/0~dev-server.mjs

@@ -7,11 +7,11 @@ import { RspackDevServer } from "@rspack/dev-server";
 import { merge } from "webpack-merge";
 import { WebSocket, WebSocketServer } from "ws";
 import { classifyReloadFromSources, attachLifecycleStream, readContentScriptCount, humanLine, buildSourceFeatureIndex, createChangedSourcesTracker, createLifecycleStream, dispatchReload } from "./839.mjs";
-import { autoExitForceKill, loadCommandConfig, sanitize, extensionJsRunnerError, portInUse, devServerStartTimeout, autoExitTriggered, asAbsolute, shouldWarnPortConflict, isGeckoBasedBrowser, createPlaywrightMetadataWriter, autoExitModeEnabled, getSessionRunId, loadCustomConfig, loadBrowserConfig, getDistPath, resolveCompanionExtensionsConfig, getSpecialFoldersDataForProjectRoot } from "./101.mjs";
+import { DEV_COMMAND_DEFAULTS, autoExitForceKill, loadCommandConfig, sanitize, extensionJsRunnerError, portInUse, devServerStartTimeout, autoExitTriggered, asAbsolute, mergeOptionLayers, shouldWarnPortConflict, isGeckoBasedBrowser, createPlaywrightMetadataWriter, autoExitModeEnabled, getSessionRunId, loadCustomConfig, loadBrowserConfig, getDistPath, resolveCompanionExtensionsConfig, getSpecialFoldersDataForProjectRoot } from "./101.mjs";
 import { CONTROL_WS_PATH, writePersistedControlPort, writeControlToken, clearControlToken, readPersistedControlPort } from "./887.mjs";
 import { hasProjectDependency, findNearestProjectManifestDirSync } from "./80.mjs";
 import { setupNoBrowserBannerOnFirstDone, webpackConfig, resolveConnectableHost, setupCompilerLifecycleHooks } from "./0~rspack-config.mjs";
-import { actionsPath, controlPortFilePath, logsPath, legacyControlPortFilePath, ensureSessionArtifactsIgnoreFile } from "./494.mjs";
+import { ensureSessionStateInProjectGitignore, logsPath, actionsPath, controlPortFilePath, legacyControlPortFilePath, ensureSessionArtifactsIgnoreFile } from "./494.mjs";
 import { isDebug } from "./349.mjs";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
@@ -1049,6 +1049,7 @@ async function dev_server_devServer(projectStructure, devOptions) {
     const primaryDistPath = getDistPath(asAbsolute(packageJsonDir), browserName);
     const bridgeLogsAbsPath = logsPath(packageJsonDir, browserName);
     ensureSessionArtifactsIgnoreFile(packageJsonDir);
+    ensureSessionStateInProjectGitignore(packageJsonDir);
     const bridgeLogsRelPath = __rspack_external_node_path_c5b9b54f.relative(packageJsonDir, bridgeLogsAbsPath);
     const sessionRunId = getSessionRunId(packageJsonDir, browserName);
     const bridgeLogFile = new LogsFileWriter({
@@ -1144,6 +1145,7 @@ async function dev_server_devServer(projectStructure, devOptions) {
     const safeBrowserConfig = sanitize(browserConfig);
     const safeCommandConfig = sanitize(commandConfig);
     const safeDevOptions = sanitize(devOptions);
+    const mergedDevOptions = mergeOptionLayers(DEV_COMMAND_DEFAULTS, safeBrowserConfig, safeCommandConfig, safeDevOptions);
     const specialFoldersData = getSpecialFoldersDataForProjectRoot(packageJsonDir);
     const mergedExtensionsConfig = safeDevOptions.extensions ?? safeCommandConfig.extensions ?? safeBrowserConfig.extensions ?? specialFoldersData.extensions;
     const resolvedExtensionsConfig = await resolveCompanionExtensionsConfig({
@@ -1152,9 +1154,7 @@ async function dev_server_devServer(projectStructure, devOptions) {
         config: mergedExtensionsConfig
     });
     const baseConfig = webpackConfig(projectStructure, {
-        ...safeBrowserConfig,
-        ...safeCommandConfig,
-        ...safeDevOptions,
+        ...mergedDevOptions,
         extensions: resolvedExtensionsConfig,
         browser: devOptions.browser,
         mode: 'development',