@modern-js/module-tools-docs 2.47.1 → 2.48.0

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @modern-js/module-tools-docs
 
+## 2.48.0
+
 ## 2.47.1
 
 ## 2.47.0

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

@@ -67,12 +67,29 @@ export default {
 
 Contains configuration related to static assets.
 
-## asset.path
+## asset.name
 
-Static resource output path, will be based on [outDir](/api/config/build-config#outDir)
+Static resource output file name.
 
-- **Type**: `string`
-- **Default**: `assets`
+- **Type**: `string | ((assetPath) => name)`
+- **Default**: `[name].[hash].[ext]`
+
+When asset.name is a string, it will automatically replace [name], [ext], and [hash], respectively replaced by the file name, extension, and file hash.
+
+Also you can use asset.name as a function, and the return is output asset name. At this time, this function receives a parameter assetPath, which corresponds to the resource path.
+
+```js title="modern.config.ts"
+export default defineConfig({
+  buildConfig: {
+    asset: {
+      // no hash
+      name: [name].[ext],
+      // any logic
+      // name: (assetPath) => 'any.png',
+    },
+  },
+});
+```
 
 ## asset.limit
 
@@ -97,6 +114,13 @@ export default defineConfig({
 });
 ```
 
+## asset.path
+
+Static resource output path, will be based on [outDir](/api/config/build-config#outDir)
+
+- **Type**: `string`
+- **Default**: `assets`
+
 ## asset.publicPath
 
 The CDN prefix given to unlinked assets when bundling.
@@ -510,7 +534,7 @@ export default defineConfig({
 
 ## dts.tsconfigPath
 
-**deprecated**，use [tsconfig](#tsconfig) instead.
+**deprecated**,use [tsconfig](#tsconfig) instead.
 
 Specifies the path to the tsconfig file used to generate the type file.
 
@@ -1083,7 +1107,7 @@ Sets the format of the source code. By default, the source code will be treated
 ## splitting
 
 Whether to enable code splitting.
-Only support [format: 'esm'](#format-esm) and [format: 'cjs'](#format-cjs)，see [esbuild.splitting](https://esbuild.github.io/api/#splitting) learn more.
+Only support [format: 'esm'](#format-esm) and [format: 'cjs'](#format-cjs),see [esbuild.splitting](https://esbuild.github.io/api/#splitting) learn more.
 
 - **Type**: `boolean`
 - **Default**: `false`

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

@@ -67,12 +67,28 @@ export default defineConfig({
 
 包含静态资源相关的配置。
 
-## asset.path
+## asset.name
 
-静态资源输出路径，会基于 [outDir](/api/config/build-config#outDir) 进行输出。
+静态资源输出文件名。
 
-- 类型： `string`
-- 默认值： `assets`
+- 类型： `string | ((assetPath) => name)`
+- 默认值： `[name].[hash].[ext]`
+
+当 asset.name 为 string 类型时，会自动对 [name]、[ext]、[hash] 进行替换，分别替换为文件名、拓展名、文件 hash。
+如果想要更高的自由度，可以把 asset.name 作为方法使用，返回值即为文件名。此时，该方法接收一个参数 assetPath，对应资源路径。
+
+```js title="modern.config.ts"
+export default defineConfig({
+  buildConfig: {
+    asset: {
+      // no hash
+      name: [name].[ext],
+      // any logic
+      // name: (assetPath) => 'any.png',
+    },
+  },
+});
+```
 
 ## asset.limit
 
@@ -97,6 +113,13 @@ export default defineConfig({
 });
 ```
 
+## asset.path
+
+静态资源输出路径，会基于 [outDir](/api/config/build-config#outDir) 进行输出。
+
+- 类型： `string`
+- 默认值： `assets`
+
 ## asset.publicPath
 
 打包时给未内联资源的 CDN 前缀。

package/package.json

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