@modern-js/main-doc 2.47.0 → 2.48.0

package/docs/en/configure/app/server/ssr.mdx

@@ -27,7 +27,7 @@ When the value type is `Object`, the following properties can be configured:
 
 - `mode`: `string = 'string'`, which defaults to using `renderToString` for rendering. Configure `stream` to enable streaming rendering.
 - `forceCSR`: `boolean = false`, which is off by default for forcing CSR rendering. Configure `true` to force CSR by adding `?csr=true` or adding `x-modern-ssr-fallback` header when accessing the page.
-- `inlineScript`: `boolean = true`, by default, SSR data is injected into HTML as inline scripts and assigned directly to global variables. Configure `false` to distribute JSON instead of assigning to global variables.
+- `inlineScript`: `boolean = true`, by default, SSR data is injected into HTML as inline scripts and assigned directly to global variables. Configure `false` to distribute JSON instead of assigning to global variables, this configuration doesn't work in Streaming SSR.
 - `disablePrerender`: `boolean = fasle`, To ensure compatibility with the old data request method (`useLoader`), by default, Modern.js performs pre-rendering of components.
   However, if developers want to reduce one rendering when there is no use of the useLoader API in your project, you can set the configuration `disablePrerender=true`.
 - `unsafeHeaders`: `string[] = []`, For safety reasons, Modern.js does not add excessive content to SSR_DATA. Developers can use this configuration to specify the headers that need to be injected.

package/docs/en/configure/app/tools/esbuild.mdx

@@ -7,18 +7,18 @@ sidebar_label: esbuild
 - **Type:** `Object`
 - **Default:** `undefined`
 
-## Introduction
+:::warning
+**The esbuild feature in the current document is no longer maintained**, we recommend using the Rspack + SWC solution, because Rspack + SWC provide better build performance, richer features, and better compatibility.
 
-import Esbuild from '@modern-js/builder-doc/docs/en/shared/esbuild.md';
+Please refer to [「Use Rspack」](/guides/advanced-features/rspack-start.html) for more information.
 
-<Esbuild />
+:::
 
-:::tip Recommend using SWC
-We recommend using SWC to transform and minify code rather than esbuild, because SWC supports more syntaxes, provides better code compression, and the compiled code has better compatibility.
+## Introduction
 
-Therefore, we recommend that you use SWC instead of esbuild, please refer to [tools.swc](/configure/app/tools/swc) for usage.
+import Esbuild from '@modern-js/builder-doc/docs/en/shared/esbuild.md';
 
-:::
+<Esbuild />
 
 ## Configuration
 

package/docs/zh/configure/app/server/ssr.mdx

@@ -27,7 +27,7 @@ export default defineConfig({
 
 - `mode`：`string = 'string'`，默认为使用 `renderToString` 渲染。配置为 `stream` 开启流式渲染。
 - `forceCSR`：`boolean = false`，默认关闭强制 CSR 渲染。配置为 `true` 后，在页面访问时添加 `?csr=true` 或添加请求头 `x-modern-ssr-fallback` 即可强制 CSR。
-- `inlineScript`：`boolean = true`，默认情况下，SSR 的数据会以内联脚本的方式注入到 HTML 中，并且直接赋值给全局变量。配置为 `false` 后，会下发 JSON，而不是赋值给全局变量。
+- `inlineScript`：`boolean = true`，默认情况下，SSR 的数据会以内联脚本的方式注入到 HTML 中，并且直接赋值给全局变量。配置为 `false` 后，会下发 JSON，而不是赋值给全局变量，Streaming SSR 下，该配置不会生效。
 - `disablePrerender`: `boolean = fasle`, 为了兼容旧数据请求方式 - `useLoader`, 默认情况下 Modern.js 会对组件进行一次预渲染即有两次渲染。
   开发者在保证项目中没有使用 useLoader Api 情况下, 可通过配置 `disablePrerender=true`来减少一次渲染。
 - `unsafeHeaders`: `string[] = []`, 为了安全考虑，Modern.js 不会往 SSR_DATA 添加过多的内容。开发者可以通过该配置，对需要注入的 headers 进行配置。

package/docs/zh/configure/app/tools/esbuild.mdx

@@ -7,18 +7,18 @@ sidebar_label: esbuild
 - **类型：** `Object`
 - **默认值：** `undefined`
 
-## 介绍
+:::warning
+**当前文档中的 esbuild 功能已停止迭代**，我们更推荐使用 Rspack + SWC 的方案，因为 Rspack + SWC 具备更好的构建性能、功能丰富度和产物兼容性。
 
-import Esbuild from '@modern-js/builder-doc/docs/zh/shared/esbuild.md';
+请参考[「使用 Rspack」](/guides/advanced-features/rspack-start.html)了解更多。
 
-<Esbuild />
+:::
 
-:::tip 推荐使用 SWC
-相较于 esbuild，我们更推荐使用 SWC 来编译和压缩代码，因为 SWC 支持更多的语法特性、拥有更好的代码压缩率，并且产物具备更好的兼容性。
+## 介绍
 
-因此，我们建议你使用 SWC 而不是 esbuild，用法请参考 [tools.swc](/configure/app/tools/swc)。
+import Esbuild from '@modern-js/builder-doc/docs/zh/shared/esbuild.md';
 
-:::
+<Esbuild />
 
 ## 配置项
 

package/package.json

@@ -15,17 +15,17 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.47.0",
+  "version": "2.48.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "2.47.0"
+    "@modern-js/sandpack-react": "2.48.0"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.47.0"
+    "@modern-js/builder-doc": "^2.48.0"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -35,12 +35,12 @@
     "ts-node": "^10.9.1",
     "typescript": "^5",
     "fs-extra": "^10",
-    "rspress": "1.11.2",
-    "@rspress/shared": "1.11.2",
+    "rspress": "1.12.3",
+    "@rspress/shared": "1.12.3",
     "@types/node": "^16",
     "@types/fs-extra": "9.0.13",
-    "@modern-js/builder-doc": "2.47.0",
-    "@modern-js/doc-plugin-auto-sidebar": "2.47.0"
+    "@modern-js/builder-doc": "2.48.0",
+    "@modern-js/doc-plugin-auto-sidebar": "2.48.0"
   },
   "scripts": {
     "dev": "rspress dev",