@modern-js/module-tools-docs 2.67.3 → 2.67.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @modern-js/module-tools-docs
 
+## 2.67.5
+
+## 2.67.4
+
 ## 2.67.3
 
 ## 2.67.2

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

@@ -339,6 +339,10 @@ export default {
 
 Reference for array settings: [copy-webpack-plugin patterns](https://github.com/webpack-contrib/copy-webpack-plugin#patterns)
 
+:::tip
+Refer to [Use the Copy Tools](/guide/advance/copy) for the complete usage of the `copy` option.
+:::
+
 ## copy.patterns
 
 - **Type**: `CopyPattern[]`
@@ -755,8 +759,7 @@ type HookList = {
   name: string;
   apply: (compiler: ICompiler) => void;
   applyAfterBuiltIn?: boolean;
-}
-
+};
 ```
 
 - **Default**: `[]`.
@@ -882,7 +885,6 @@ For more information about JSX Transform, you can refer to the following links:
 
 :::
 
-
 ## loader
 
 **Experimental**
@@ -895,7 +897,7 @@ export default defineConfig({
   buildConfig: {
     loader: {
       '.js': 'jsx',
-    }
+    },
   },
 });
 ```
@@ -1003,13 +1005,17 @@ Custom module resolution options
 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";
+import { createElement } from 'react';
 ```
+
 When we configure alias: `{ react: 'react-native' }`, the result becomes:
+
 ```js
-import { createElement } from "./react-native";
+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.
@@ -1021,6 +1027,7 @@ 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"}`.
 
@@ -1074,7 +1081,6 @@ export default defineConfig({
 });
 ```
 
-
 ### resolve.tsconfig
 
 Used to configure enhanced-resolve in [tsconfig-paths-webpack-plugin](https://www.npmjs.com/package/tsconfig-paths-webpack-plugin) to support resolution of alias in tsconfig.json and nested `@` alias conflicts.
@@ -1083,8 +1089,8 @@ Used to configure enhanced-resolve in [tsconfig-paths-webpack-plugin](https://ww
 
 ```ts
 type Tsconfig = {
-  configFile: string,
-  references?: string[] | undefined,
+  configFile: string;
+  references?: string[] | undefined;
 };
 ```
 
@@ -1097,13 +1103,12 @@ export default defineConfig({
     resolve: {
       tsConfig: {
         configFile: './tsconfig.json',
-      }
+      },
     },
   },
 });
 ```
 
-
 ## shims
 
 When building CommonJS/ESM artifacts, inject some polyfill code such as `__dirname` which can only be used in CommonJS.
@@ -1299,7 +1304,7 @@ export default {
 
 ## style.sass.implementation
 
-Configure the implementation library used by `Sass`, the built-in version used is `1.5.4` if not specified.
+Configure the implementation library used by `Sass`, the built-in version used is `1.54.4` if not specified.
 
 - **Type**: `string | object`
 - **Default**: `undefined`

package/docs/en/guide/advance/copy.md

@@ -32,7 +32,6 @@ export default defineConfig({
 });
 ```
 
-
 The `patterns.context` parameter is generally used in conjunction with `patterns.from`. By default, its value is the same as [`buildConfig.sourceDir`](/api/config/build-config#sourcedir). Therefore, we can specify the file `src/data.json` to be copied in the following way:
 
 > By default, `buildConfig.sourceDir` is set to `src`.
@@ -69,6 +68,25 @@ export default defineConfig({
 });
 ```
 
+Or to copy `./src/**/*.json` files:
+
+```ts
+import path from 'path';
+
+export default defineConfig({
+  buildConfig: {
+    copy: {
+      patterns: [
+        {
+          from: '**/*.json',
+          context: path.join(__dirname, './src'),
+        },
+      ],
+    },
+  },
+});
+```
+
 The `patterns.to` parameter is used to specify the output path for the copied files. By default, its value corresponds to [buildConfig.outDir](/api/config/build-config#outdir). Therefore, we can copy `src/index.html` to the `dist` directory as follows:
 
 ```ts

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

@@ -332,6 +332,10 @@ export default defineConfig({
 });
 ```
 
+:::tip
+参考 [使用 Copy 工具](/guide/advance/copy) 了解 `copy` 选项的完整用法。
+:::
+
 ## copy.patterns
 
 - 类型： `CopyPattern[]`
@@ -883,7 +887,7 @@ export default defineConfig({
   buildConfig: {
     loader: {
       '.js': 'jsx',
-    }
+    },
   },
 });
 ```
@@ -991,13 +995,17 @@ export default {
 基本用法和 [alias](#alias) 一致。
 
 [alias](#alias) 的问题在于我们在 bundleless 场景下错误的处理了 Module ID 的情况：
+
 ```js
-import { createElement } from "react";
+import { createElement } from 'react';
 ```
+
 当我们配置了 `alias: { react: 'react-native' }` 后，结果会变成
+
 ```js
-import { createElement } from "./react-native";
+import { createElement } from './react-native';
 ```
+
 一个 Module ID 被错误的处理成了相对路径，显然这是不符合预期的。
 
 我们想要修复这个问题，但是这可能会破坏已有的项目，因此我们在 MAJOR_VERSION.58.0 版本提供了 `resolve.alias` 来解决这个问题。
@@ -1008,6 +1016,7 @@ import { createElement } from "./react-native";
 在下一个大版本，`resolve.alias` 将会取代 `alias` 。
 
 :::warning
+
 - 注意此配置不要与 [alias](#alias) 混用。
 - 注意此配置必须标注一个相对路径，例如 `{ "@": "./src" }` 而非 `{ "@": "src"}`。
 
@@ -1069,8 +1078,8 @@ export default defineConfig({
 
 ```ts
 type Tsconfig = {
-  configFile: string,
-  references?: string[] | undefined,
+  configFile: string;
+  references?: string[] | undefined;
 };
 ```
 
@@ -1083,13 +1092,12 @@ export default defineConfig({
     resolve: {
       tsConfig: {
         configFile: './tsconfig.json',
-      }
+      },
     },
   },
 });
 ```
 
-
 ## shims
 
 在构建 cjs / esm 产物时注入一些垫片代码。
@@ -1291,7 +1299,7 @@ export default defineConfig({
 
 ## style.sass.implementation
 
-配置 `Sass` 使用的实现库，在不指定的情况下，使用的内置版本是 `1.5.4`。
+配置 `Sass` 使用的实现库，在不指定的情况下，使用的内置版本是 `1.54.4`。
 
 - 类型： `string | object`
 - 默认值： `undefined`
@@ -1669,6 +1677,4 @@ export default defineConfig({
     },
   },
 });
-```import { aliases } from '../../../../../../toolkit/utils/dist/compiled/browserslist';
-import { createElement } from 'react';
-
+```

package/docs/zh/guide/advance/copy.md

@@ -68,6 +68,25 @@ export default defineConfig({
 });
 ```
 
+或是拷贝 `./src/**/*.json` 文件：
+
+```ts
+import path from 'path';
+
+export default defineConfig({
+  buildConfig: {
+    copy: {
+      patterns: [
+        {
+          from: '**/*.json',
+          context: path.join(__dirname, './src'),
+        },
+      ],
+    },
+  },
+});
+```
+
 `patterns.to` 用于指定复制文件的输出路径，默认情况下它的值为 [`buildConfig.outDir`](/api/config/build-config#outdir)对应的值。因此我们按照如下方式将 `src/index.html` 复制到 `dist` 目录下：
 
 ```ts

package/package.json

@@ -9,7 +9,7 @@
     "directory": "packages/document/module-doc"
   },
   "license": "MIT",
-  "version": "2.67.3",
+  "version": "2.67.5",
   "main": "index.js",
   "devDependencies": {
     "@modern-js/doc-plugin-auto-sidebar": "2.58.1",