@modern-js/module-tools-docs 2.57.0 → 2.57.1

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @modern-js/module-tools-docs
 
+## 2.57.1
+
 ## 2.57.0
 
 ## 2.56.2

package/docs/en/api/config/build-config.mdx

@@ -878,6 +878,7 @@ For more information about JSX Transform, you can refer to the following links:
 
 - [React Blog - Introducing the New JSX Transform](https://legacy.reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html).
 - [esbuild - JSX](https://esbuild.github.io/api/#jsx).
+
 :::
 
 ## metafile
@@ -978,6 +979,34 @@ export default {
 
 Custom module resolution options
 
+### resolve.alias
+
+The basic usage is the same as [alias](#alias).
+
+The issue with [alias](#alias) is that we incorrectly handled Module IDs in a bundleless scenario:
+```js
+import { createElement } from "react";
+```
+When we configure alias: `{ react: 'react-native' }`, the result becomes:
+```js
+import { createElement } from "./react-native";
+```
+A Module ID is incorrectly processed as a relative path, which is not expected.
+
+We want to fix this issue, but it may break existing projects.
+
+Therefore, in **MAJOR_VERSION.58.0**, we provided `resolve.alias` to solve this problem. Additionally, `resolve.alias` removed the default value `{ "@": "./src"}` provided by [alias](#alias).
+
+If you need this feature, please use `resolve.alias`.
+
+In the next major version, `resolve.alias` will replace [alias](#alias).
+
+:::warning
+- Note that this configuration should not be mixed with [alias](#alias).
+- Ensure that this configuration specifies a relative path, such as `{ "@": "./src" }` rather than `{ "@": "src"}`.
+
+:::
+
 ### resolve.mainFields
 
 A list of fields in package.json to try when parsing the package entry point.

package/docs/zh/api/config/build-config.mdx

@@ -968,6 +968,33 @@ export default {
 
 自定义模块解析选项
 
+### resolve.alias
+
+基本用法和 [alias](#alias) 一致。
+
+[alias](#alias) 的问题在于我们在 bundleless 场景下错误的处理了 Module ID 的情况：
+```js
+import { createElement } from "react";
+```
+当我们配置了 `alias: { react: 'react-native' }` 后，结果会变成
+```js
+import { createElement } from "./react-native";
+```
+一个 Module ID 被错误的处理成了相对路径，显然这是不符合预期的。
+
+我们想要修复这个问题，但是这可能会破坏已有的项目，因此我们在 MAJOR_VERSION.58.0 版本提供了 `resolve.alias` 来解决这个问题。
+并且 `resolve.alias` 里移除了 [alias](#alias) 提供的默认值 `{ "@": "./src"}`
+
+如果你需要此功能，请使用 `resolve.alias`。
+
+在下一个大版本，`resolve.alias` 将会取代 `alias` 。
+
+:::warning
+- 注意此配置不要与 [alias](#alias) 混用。
+- 注意此配置必须标注一个相对路径，例如 `{ "@": "./src" }` 而非 `{ "@": "src"}`。
+
+:::
+
 ### resolve.mainFields
 
 package.json 中，在解析包的入口点时尝试的字段列表。
@@ -1595,4 +1622,6 @@ export default defineConfig({
     },
   },
 });
-```
+```import { aliases } from '../../../../../../toolkit/utils/dist/compiled/browserslist';
+import { createElement } from 'react';
+

package/package.json

@@ -9,14 +9,14 @@
     "directory": "packages/document/module-doc"
   },
   "license": "MIT",
-  "version": "2.57.0",
+  "version": "2.57.1",
   "main": "index.js",
   "devDependencies": {
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "rspress": "1.26.1",
     "@rspress/shared": "1.26.1",
-    "@modern-js/doc-plugin-auto-sidebar": "2.57.0"
+    "@modern-js/doc-plugin-auto-sidebar": "2.57.1"
   },
   "scripts": {
     "dev": "rspress dev",