add suppressWarnings config option

Author: suveshmoza

packages/wxt/src/core/resolve-config.ts

@@ -226,6 +226,7 @@ export async function resolveConfig(
     userConfigMetadata: userConfigMetadata ?? {},
     alias,
     experimental: defu(mergedConfig.experimental, {}),
+    suppressWarnings: mergedConfig.suppressWarnings ?? {},
     dev: {
       server: devServerConfig,
       reloadCommand,

packages/wxt/src/core/utils/manifest.ts

@@ -121,11 +121,14 @@ export async function generateManifest(
   // Warn if building for Firefox without data_collection_permissions
   if (
     wxt.config.browser === 'firefox' &&
-    !userManifest.browser_specific_settings?.gecko?.data_collection_permissions
+    !userManifest.browser_specific_settings?.gecko
+      ?.data_collection_permissions &&
+    !wxt.config.suppressWarnings?.firefoxDataCollection
   ) {
     wxt.logger.warn(
-      'Firefox requires explicit data collection permissions. Consider adding `data_collection_permissions` to your manifest config.\n' +
-        'For more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\n',
+      'Firefox requires `data_collection_permissions` for new extensions from November 3, 2025. Existing extensions are exempt for now.\n' +
+        'For more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\n' +
+        'To suppress this warning, add `firefoxDataCollection: true` to `suppressWarnings` in your wxt config.\n',
     );
   }
 

packages/wxt/src/core/utils/testing/fake-objects.ts

@@ -305,6 +305,7 @@ export const fakeResolvedConfig = fakeObjectCreator<ResolvedConfig>(() => {
     hooks: {},
     vite: () => ({}),
     plugins: [],
+    suppressWarnings: {},
   };
 });
 

packages/wxt/src/types.ts

@@ -131,6 +131,22 @@ export interface InlineConfig {
    * object or promise.
    */
   manifest?: UserManifest | Promise<UserManifest> | UserManifestFn;
+  /**
+   * Suppress specific warnings during the build process.
+   *
+   * @example
+   * ```ts
+   * export default defineConfig({
+   *   suppressWarnings: {
+   *     firefoxDataCollection: true,
+   *   },
+   * })
+   * ```
+   */
+  suppressWarnings?: { firefoxDataCollection?: boolean } & Record<
+    string,
+    boolean
+  >;
   /**
    * Configure browser startup. Options set here can be overridden in a `web-ext.config.ts` file.
    */
@@ -462,7 +478,8 @@ export interface BuildStepOutput {
 }
 
 export interface WxtDevServer
-  extends Omit<WxtBuilderServer, 'listen' | 'close'>, ServerInfo {
+  extends Omit<WxtBuilderServer, 'listen' | 'close'>,
+    ServerInfo {
   /**
    * Stores the current build output of the server.
    */
@@ -566,7 +583,8 @@ export interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
   type?: PerBrowserOption<'module'>;
 }
 
-export interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
+export interface BaseContentScriptEntrypointOptions
+  extends BaseEntrypointOptions {
   matches?: PerBrowserOption<NonNullable<ManifestContentScript['matches']>>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
@@ -633,14 +651,16 @@ export interface BaseContentScriptEntrypointOptions extends BaseEntrypointOption
   registration?: PerBrowserOption<'manifest' | 'runtime'>;
 }
 
-export interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+export interface MainWorldContentScriptEntrypointOptions
+  extends BaseContentScriptEntrypointOptions {
   /**
    * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
    */
   world: 'MAIN';
 }
 
-export interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+export interface IsolatedWorldContentScriptEntrypointOptions
+  extends BaseContentScriptEntrypointOptions {
   /**
    * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
    * @default "ISOLATED"
@@ -776,7 +796,8 @@ export type EntrypointGroup = Entrypoint | Entrypoint[];
 
 export type OnContentScriptStopped = (cb: () => void) => void;
 
-export interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScriptEntrypointOptions {
+export interface IsolatedWorldContentScriptDefinition
+  extends IsolatedWorldContentScriptEntrypointOptions {
   /**
    * Main function executed when the content script is loaded.
    *
@@ -787,7 +808,8 @@ export interface IsolatedWorldContentScriptDefinition extends IsolatedWorldConte
   main(ctx: ContentScriptContext): any | Promise<any>;
 }
 
-export interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypointOptions {
+export interface MainWorldContentScriptDefinition
+  extends MainWorldContentScriptEntrypointOptions {
   /**
    * Main function executed when the content script is loaded.
    *
@@ -1393,6 +1415,13 @@ export interface ResolvedConfig {
    */
   alias: Record<string, string>;
   experimental: {};
+  /**
+   * List of warning identifiers to suppress during the build process.
+   */
+  suppressWarnings: { firefoxDataCollection?: boolean } & Record<
+    string,
+    boolean
+  >;
   dev: {
     /** Only defined during dev command */
     server?: {
@@ -1576,9 +1605,8 @@ export interface WxtModule<TOptions extends WxtModuleOptions> {
   setup?: WxtModuleSetup<TOptions>;
 }
 
-export interface WxtModuleWithMetadata<
-  TOptions extends WxtModuleOptions,
-> extends WxtModule<TOptions> {
+export interface WxtModuleWithMetadata<TOptions extends WxtModuleOptions>
+  extends WxtModule<TOptions> {
   type: 'local' | 'node_module';
   id: string;
 }