feat: add resolve doc & remove source.resolve

Author: keepview

packages/cli/builder/src/plugins/extensionPrefix.ts

@@ -68,14 +68,7 @@ export async function parseCommonConfig(
       ...outputConfig
     } = {},
     html: { outputStructure, appIcon, ...htmlConfig } = {},
-    source: {
-      alias,
-      globalVars,
-      resolveMainFields,
-      resolveExtensionPrefix,
-      transformImport,
-      ...sourceConfig
-    } = {},
+    source: { alias, globalVars, transformImport, ...sourceConfig } = {},
     dev = {},
     security: { checkSyntax, sri, ...securityConfig } = {},
     tools: {
@@ -234,18 +227,6 @@ export async function parseCommonConfig(
     );
   }
 
-  if (resolveMainFields) {
-    const { pluginMainFields } = await import('../plugins/mainFields');
-    rsbuildPlugins.push(pluginMainFields(resolveMainFields));
-  }
-
-  if (resolveExtensionPrefix) {
-    const { pluginExtensionPrefix } = await import(
-      '../plugins/extensionPrefix'
-    );
-    rsbuildPlugins.push(pluginExtensionPrefix(resolveExtensionPrefix));
-  }
-
   if (convertToRem) {
     const { pluginRem } = await import('@rsbuild/plugin-rem');
     rsbuildPlugins.push(

packages/cli/builder/src/plugins/mainFields.ts

@@ -153,15 +153,6 @@ export type BuilderExtraConfig = {
      * Define global variables. It can replace expressions like `process.env.FOO` in your code after compile.
      */
     globalVars?: ChainedGlobalVars;
-    /**
-     * This configuration will determine which field of `package.json` you use to import the `npm` module.
-     * Same as the [resolve.mainFields](https://webpack.js.org/configuration/resolve/#resolvemainfields) config of webpack.
-     */
-    resolveMainFields?: MainFields | Partial<Record<RsbuildTarget, MainFields>>;
-    /**
-     * Add a prefix to [resolve.extensions](https://webpack.js.org/configuration/resolve/#resolveextensions).
-     */
-    resolveExtensionPrefix?: string | Partial<Record<RsbuildTarget, string>>;
   };
   output?: {
     /**

packages/cli/builder/src/shared/parseCommonConfig.ts

@@ -0,0 +1,14 @@
+---
+title: aliasStrategy
+---
+
+# resolve.aliasStrategy
+
+- **Type:** `'prefer-tsconfig' | 'prefer-alias'`
+- **Default:** `'prefer-tsconfig'`
+
+Set the strategy for path alias resolution, to control the priority relationship between the paths option in `tsconfig.json` and the [resolve.alias](https://rsbuild.rs/config/resolve/alias) option of Rsbuild.
+
+import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';
+
+<RsbuildConfig configName="resolve.aliasStrategy" />

packages/cli/builder/src/types.ts

@@ -0,0 +1,13 @@
+---
+title: alias
+---
+
+# resolve.alias
+
+- **Type:** `string[]`
+
+Create aliases for module paths to simplify import paths or redirect module references.
+
+import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
+
+<RsbuildConfig configName="resolve.alias" />

packages/document/main-doc/docs/en/configure/app/resolve/alias-strategy.mdx

@@ -0,0 +1,14 @@
+---
+title: conditionNames
+---
+
+# resolve.conditionNames
+
+- **Type:** `string[]`
+- **Default:** Same as Rspack's `resolve.conditionNames`
+
+Specifies the condition names used to match entry points in the [exports](https://nodejs.org/api/packages.html#packages_exports) of a package.
+
+import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
+
+<RsbuildConfig configName="resolve.extensions" />

packages/document/main-doc/docs/en/configure/app/resolve/alias.mdx

@@ -0,0 +1,14 @@
+---
+title: extensions
+---
+
+# resolve.extensions
+
+- **Type:** `string[]`
+- **Default:** `['.ts', '.tsx', '.mjs', '.js', '.jsx', '.json']`
+
+Automatically resolve file extensions when importing modules. This means you can import files without explicitly writing their extensions.
+
+import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
+
+<RsbuildConfig configName="resolve.extensions" />