wxt 0.20.21 → 0.20.22

package/dist/core/builders/vite/index.mjs

@@ -52,8 +52,10 @@ async function createViteBuilder(wxtConfig, hooks, getWxtDevServer) {
 		config.server.watch = { ignored: [`${wxtConfig.outBaseDir}/**`, `${wxtConfig.wxtDir}/**`] };
 		config.legacy ??= {};
 		config.legacy.skipWebSocketTokenCheck = true;
-		config.esbuild ??= {};
-		if (config.esbuild) config.esbuild.charset = "ascii";
+		if (isRolldownVersion(vite.version)) {} else {
+			config.esbuild ??= {};
+			if (config.esbuild) config.esbuild.charset = "ascii";
+		}
 		const server = getWxtDevServer?.();
 		config.plugins ??= [];
 		config.plugins.push(download(wxtConfig), devHtmlPrerender(wxtConfig, server), resolveVirtualModules(wxtConfig), devServerGlobals(wxtConfig, server), tsconfigPaths(wxtConfig), noopBackground(), globals(wxtConfig), defineImportMeta(), wxtPluginLoader(wxtConfig), resolveAppConfig(wxtConfig));
@@ -312,5 +314,8 @@ async function removeEmptyDirs(dir) {
 		await rmdir(dir);
 	} catch {}
 }
+function isRolldownVersion(version) {
+	return Number(version.split(".")[0]) >= 8;
+}
 //#endregion
 export { createViteBuilder };

package/dist/core/resolve-config.mjs

@@ -91,11 +91,16 @@ async function resolveConfig(inlineConfig, command) {
 		const host = mergedConfig.dev?.server?.host ?? mergedConfig.dev?.server?.hostname ?? "localhost";
 		let port = mergedConfig.dev?.server?.port;
 		const origin = mergedConfig.dev?.server?.origin ?? mergedConfig.dev?.server?.hostname ?? "localhost";
+		const strictPort = mergedConfig.dev?.server?.strictPort ?? false;
 		if (port == null || !isFinite(port)) port = await getPort({
 			host,
 			port: 3e3,
 			portRange: [3001, 3010]
 		});
+		else if (!strictPort) port = await getPort({
+			host,
+			port
+		});
 		const originWithProtocolAndPort = [
 			origin.match(/^https?:\/\//) ? "" : "http://",
 			origin,
@@ -105,6 +110,7 @@ async function resolveConfig(inlineConfig, command) {
 			host,
 			port,
 			origin: originWithProtocolAndPort,
+			strictPort,
 			watchDebounce: safeStringToNumber(process.env.WXT_WATCH_DEBOUNCE) ?? 800
 		};
 	}
@@ -142,6 +148,7 @@ async function resolveConfig(inlineConfig, command) {
 		userConfigMetadata: userConfigMetadata ?? {},
 		alias,
 		experimental: defu(mergedConfig.experimental, {}),
+		suppressWarnings: mergedConfig.suppressWarnings ?? {},
 		dev: {
 			server: devServerConfig,
 			reloadCommand

package/dist/core/utils/env.mjs

@@ -1,6 +1,6 @@
+import { expand } from "dotenv-expand";
 import { existsSync, readFileSync } from "node:fs";
 import { parseEnv } from "node:util";
-import { expand } from "dotenv-expand";
 //#region src/core/utils/env.ts
 /** Load environment files based on the current mode and browser. */
 function loadEnv(mode, browser) {
@@ -23,10 +23,7 @@ function loadEnv(mode, browser) {
 			return [];
 		}
 	}));
-	expand({
-		parsed,
-		processEnv: { ...process.env }
-	});
+	expand({ parsed });
 	return parsed;
 }
 //#endregion

package/dist/core/utils/manifest.mjs

@@ -55,6 +55,7 @@ async function generateManifest(allEntrypoints, buildOutput) {
 	}
 	manifest.version = version;
 	manifest.version_name = wxt.config.browser === "firefox" || versionName === version ? void 0 : versionName;
+	if (wxt.config.browser === "firefox" && !userManifest.browser_specific_settings?.gecko?.data_collection_permissions && !wxt.config.suppressWarnings?.firefoxDataCollection) wxt.logger.warn("Firefox requires `data_collection_permissions` for new extensions from November 3, 2025. Existing extensions are exempt for now.\nFor more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\nTo suppress this warning, set `suppressWarnings.firefoxDataCollection` to `true` in your wxt config.\n");
 	addEntrypoints(manifest, entrypoints, buildOutput);
 	if (wxt.config.browser === "firefox") addDiscoveredThemeIcons(manifest, buildOutput);
 	if (wxt.config.command === "serve") addDevModeCsp(manifest);

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig } from "./types.mjs";
+import { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig } from "./types.mjs";
 import { build } from "./core/build.mjs";
 import { clean } from "./core/clean.mjs";
 import { defineConfig } from "./core/define-config.mjs";
@@ -9,4 +9,4 @@ import { prepare } from "./core/prepare.mjs";
 import { zip } from "./core/zip.mjs";
 import { normalizePath } from "./core/utils/paths.mjs";
 import { version } from "./version.mjs";
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig, build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig, build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };

package/dist/types.d.mts

@@ -164,6 +164,25 @@ interface InlineConfig {
    * function that returns an object or promise.
    */
   manifest?: UserManifest | Promise<UserManifest> | UserManifestFn;
+  /**
+   * Suppress specific warnings during the build process.
+   *
+   * @example
+   *   ```ts
+   *   export default defineConfig({
+   *     suppressWarnings: {
+   *       firefoxDataCollection: true,
+   *     },
+   *   })
+   *   ```;
+   */
+  suppressWarnings?: {
+    /**
+     * Suppress warnings for:
+     * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent
+     */
+    firefoxDataCollection?: boolean;
+  };
   /**
    * Configure browser startup. Options set here can be overridden in a
    * `web-ext.config.ts` file.
@@ -389,6 +408,14 @@ interface InlineConfig {
        * @default 'http://localhost:3000'
        */
       origin?: string;
+      /**
+       * Whether the dev server should fail if the specified port is already in
+       * use. When `false` and a `port` is specified, the next available port
+       * will be used instead of throwing an error.
+       *
+       * @default false
+       */
+      strictPort?: boolean;
       /**
        * Hostname to run the dev server on.
        *
@@ -880,6 +907,29 @@ type PerBrowserMap<T> = {
  * `PerBrowserOption`, like `defaultIcon`.
  */
 type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = { [key in keyof Omit<T, TOmitted>]: T[key] extends PerBrowserOption<infer U> ? U : T[key] } & { [key in TOmitted]: T[key] };
+/**
+ * Firefox data collection permission types for personal data. See:
+ * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+ */
+type FirefoxDataCollectionType = 'locationInfo' | 'browsingActivity' | 'websiteContent' | 'websiteActivity' | 'searchTerms' | 'bookmarksInfo' | 'healthInfo' | 'contactInfo' | 'socialInfo' | (string & {});
+/**
+ * Firefox data collection permissions configuration. See:
+ * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+ */
+interface FirefoxDataCollectionPermissions {
+  /**
+   * Required data collection permissions. Users must opt in to use the
+   * extension. Can include personal data types or "none" to explicitly indicate
+   * no data collection.
+   */
+  required?: Array<FirefoxDataCollectionType | 'none'>;
+  /**
+   * Optional data collection permissions. Users can opt in after installation.
+   * Can include personal data types or "technicalAndInteraction" (which can
+   * only be optional).
+   */
+  optional?: Array<FirefoxDataCollectionType | 'technicalAndInteraction'>;
+}
 /**
  * Manifest customization available in the `wxt.config.ts` file. You cannot
  * configure entrypoints here, they are configured inline.
@@ -903,6 +953,11 @@ type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'a
       strict_min_version?: string;
       strict_max_version?: string;
       update_url?: string;
+      /**
+       * Firefox data collection permissions configuration. See:
+       * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+       */
+      data_collection_permissions?: FirefoxDataCollectionPermissions;
     };
     gecko_android?: {
       strict_min_version?: string;
@@ -1311,11 +1366,16 @@ interface ResolvedConfig$1 {
   /** Import aliases to absolute paths. */
   alias: Record<string, string>;
   experimental: {};
+  /** List of warning identifiers to suppress during the build process. */
+  suppressWarnings: {
+    firefoxDataCollection?: boolean;
+  };
   dev: {
     /** Only defined during dev command */server?: {
       host: string;
       port: number;
       origin: string;
+      strictPort: boolean;
       /**
        * The milliseconds to debounce when a file is saved before reloading. The
        * only way to set this option is to set the `WXT_WATCH_DEBOUNCE`
@@ -1536,4 +1596,4 @@ interface WxtDirFileEntry {
   tsReference?: boolean;
 }
 //#endregion
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };

package/dist/utils/inject-script.mjs

@@ -15,9 +15,10 @@ import { browser } from "wxt/browser";
 async function injectScript(path, options) {
 	const url = browser.runtime.getURL(path);
 	const script = document.createElement("script");
-	if (browser.runtime.getManifest().manifest_version === 2) script.text = await fetch(url).then((res) => res.text());
+	const isManifestV2 = browser.runtime.getManifest().manifest_version === 2;
+	if (isManifestV2) script.text = await fetch(url).then((res) => res.text());
 	else script.src = url;
-	const loadedPromise = makeLoadedPromise(script);
+	const loadedPromise = isManifestV2 ? void 0 : makeLoadedPromise(script);
 	await options?.modifyScript?.(script);
 	(document.head ?? document.documentElement).append(script);
 	if (!options?.keepInDom) script.remove();

package/dist/version.mjs

@@ -1,4 +1,4 @@
 //#region src/version.ts
-const version = "0.20.21";
+const version = "0.20.22";
 //#endregion
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.20.21",
+  "version": "0.20.22",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "scripts": {