feat: allow setting alias: false to disable default aliases

Author: aleclarson

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

@@ -137,15 +137,18 @@ export async function resolveConfig(
     defaults: userConfig.webExt ?? userConfig.runner,
   });
   // Make sure alias are absolute
-  const alias = Object.fromEntries(
-    Object.entries({
-      ...mergedConfig.alias,
-      '@': srcDir,
-      '~': srcDir,
-      '@@': root,
-      '~~': root,
-    }).map(([key, value]) => [key, path.resolve(root, value)]),
-  );
+  const alias =
+    mergedConfig.alias !== false
+      ? Object.fromEntries(
+          Object.entries({
+            ...mergedConfig.alias,
+            '@': srcDir,
+            '~': srcDir,
+            '@@': root,
+            '~~': root,
+          }).map(([key, value]) => [key, path.resolve(root, value)]),
+        )
+      : {};
 
   let devServerConfig: ResolvedConfig['dev']['server'];
   if (command === 'serve') {

packages/wxt/src/types.ts

@@ -312,12 +312,14 @@ export interface InlineConfig {
    *
    * The key is the import alias and the value is either a relative path to the root directory or an absolute path.
    *
+   * Set to `false` to disable aliases, including the default ones. This is useful if you want to handle aliases in your own plugin. Note that WXT modules can still add aliases.
+   *
    * @example
    * {
    *   "testing": "src/utils/testing.ts"
    * }
    */
-  alias?: Record<string, string>;
+  alias?: Record<string, string> | false;
   /**
    * Experimental settings - use with caution.
    */