@modern-js/main-doc 0.0.0-nightly-20240923170640 → 0.0.0-nightly-20240925070419

package/docs/en/apis/app/commands.mdx

@@ -153,28 +153,9 @@ The `--config` parameter needs to use a JSON string.
 pnpm does not support the use of JSON strings as parameter values currently. Use `npm new` to turn on.【[Relate Issue](https://github.com/pnpm/pnpm/issues/3876)】
 :::
 
-## modern serve
+import ServeCommand from "@site-docs-en/components/serve-command";
 
-The `modern serve` command is used to start a Modern.js project in the production environment. It can also be used to preview the artifacts built for the production environment locally. Please note that you need to execute the [`build`](/apis/app/commands#modern-build) command beforehand to generate the corresponding artifacts.
-
-```bash
-Usage: modern serve [options]
-
-Options:
-  -c --config <config>  specify the configuration file, which can be a relative or absolute path
-  -h, --help            show command help
-  --api-only            only run API service
-```
-
-By default, the project will run in `localhost:8080`, you can modify the server port number with `server.port`:
-
-```js
-export default defineConfig({
-  server: {
-    port: 8081,
-  },
-});
-```
+<ServeCommand />
 
 ## modern upgrade
 
@@ -252,4 +233,4 @@ Inspect config succeed, open following files to view the content:
 
 import DeployCommand from "@site-docs-en/components/deploy-command";
 
-<DeployCommand />
+<DeployCommand />

package/docs/en/apis/app/runtime/ssr/no-ssr-cache.mdx

@@ -0,0 +1,48 @@
+---
+title: NoSSRCache
+---
+# NoSSRCache
+
+With the NoSSRCache component, Modern.js does not cache the server-side rendering (SSR) results of the current page.
+
+:::note
+This component is currently only available if `ssr.mode` is `string`.
+:::
+
+## Usage
+
+```tsx
+import { NoSSRCache } from '@modern-js/runtime/ssr';
+
+export default () => {
+  return (
+    <div>
+      <NoSSRCache />
+      ...
+    </div>
+  );
+}
+```
+
+## Example
+
+In the following code, after using `useLoaderData` to fetch data, the current page is cached or not based on the data fetched. For this case, use `NoSSRCache`:
+
+```tsx
+import { useLoaderData } from '@modern-js/runtim/router';
+import { NoSSRCache } from '@modern-js/runtime/ssr';
+
+function User() {
+  const { data } = useLoaderData();
+  return (
+    <div>
+      { !data ? <NoSSRCache /> : null }
+      ...
+    </div>
+  );
+}
+```
+
+## Scene
+
+This can be used if you need to decide whether the current page needs to cache the server-side rendering (SSR) results based on the current page fetching the data (e.g., whether the request was successful or whether a field exists in the returned result).

package/docs/en/components/serve-command.mdx

@@ -0,0 +1,22 @@
+## modern serve
+
+The `modern serve` command is used to start a Modern.js project in the production environment. It can also be used to preview the artifacts built for the production environment locally. Please note that you need to execute the [`build`](/apis/app/commands#modern-build) command beforehand to generate the corresponding artifacts.
+
+```bash
+Usage: modern serve [options]
+
+Options:
+  -c --config <config>  specify the configuration file, which can be a relative or absolute path
+  -h, --help            show command help
+  --api-only            only run API service
+```
+
+By default, the project will run in `localhost:8080`, you can modify the server port number with `server.port`:
+
+```js
+export default defineConfig({
+  server: {
+    port: 8081,
+  },
+});
+```

package/docs/zh/apis/app/commands.mdx

@@ -153,28 +153,9 @@ pnpm 暂不支持使用 JSON 字符串作为参数值，可使用 `npm new` 开
 
 :::
 
-## modern serve
+import ServeCommand from "@site-docs/components/serve-command";
 
-`modern serve` 命令用于在生产环境下启动 Modern.js 工程, 也可以用于在本地预览生产环境构建的产物。注意你需要提前执行 [`build`](/apis/app/commands#modern-build) 命令构建出对应产物。
-
-```bash
-Usage: modern serve [options]
-
-Options:
-  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
-  -h, --help            显示命令帮助
-  --api-only            仅启动 API 接口服务
-```
-
-默认情况下，应用将会在 `localhost:8080` 启动，可以通过 `server.port` 修改 Server 端口号：
-
-```js
-export default defineConfig({
-  server: {
-    port: 8081,
-  },
-});
-```
+<ServeCommand />
 
 ## modern upgrade
 
@@ -252,4 +233,4 @@ Inspect config succeed, open following files to view the content:
 
 import DeployCommand from "@site-docs/components/deploy-command";
 
-<DeployCommand />
+<DeployCommand />

package/docs/zh/apis/app/runtime/ssr/no-ssr-cache.mdx

@@ -0,0 +1,48 @@
+---
+title: NoSSRCache
+---
+# NoSSRCache
+
+使用了 NoSSRCache 组件后，Modern.js 不会将当前页面的服务器端渲染（SSR）结果进行缓存。
+
+:::note
+该组件目前仅在 `ssr.mode` 为 `string` 的情况可以使用。
+:::
+
+## 使用姿势
+
+```tsx
+import { NoSSRCache } from '@modern-js/runtime/ssr';
+
+export default () => {
+  return (
+    <div>
+      <NoSSRCache />
+      ...
+    </div>
+  );
+}
+```
+
+## 示例
+
+下列代码中，使用 `useLoaderData` 获取数据后，根据请求数据的结果决定是否缓存当前页面的服务端渲染结果。针对这种情况可以使用 `NoSSRCache` 组件：
+
+```tsx
+import { useLoaderData } from '@modern-js/runtim/router';
+import { NoSSRCache } from '@modern-js/runtime/ssr';
+
+function User() {
+  const { data } = useLoaderData();
+  return (
+    <div>
+      { !data ? <NoSSRCache /> : null }
+      ...
+    </div>
+  );
+}
+```
+
+## 使用场景
+
+如果需要根据当前页面获取数据的情况（比如是否请求成功或者返回结果中是否存在某个字段），决定是否需要将当前页面的服务端渲染（SSR）结果进行缓存，则可以使用这种方式来解决。

package/docs/zh/components/serve-command.mdx

@@ -0,0 +1,22 @@
+## modern serve
+
+`modern serve` 命令用于在生产环境下启动 Modern.js 工程, 也可以用于在本地预览生产环境构建的产物。注意你需要提前执行 [`build`](/apis/app/commands#modern-build) 命令构建出对应产物。
+
+```bash
+Usage: modern serve [options]
+
+Options:
+  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
+  -h, --help            显示命令帮助
+  --api-only            仅启动 API 接口服务
+```
+
+默认情况下，应用将会在 `localhost:8080` 启动，可以通过 `server.port` 修改 Server 端口号：
+
+```js
+export default defineConfig({
+  server: {
+    port: 8081,
+  },
+});
+```

package/package.json

@@ -15,14 +15,14 @@
     "modern",
     "modern.js"
   ],
-  "version": "0.0.0-nightly-20240923170640",
+  "version": "0.0.0-nightly-20240925070419",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "0.0.0-nightly-20240923170640"
+    "@modern-js/sandpack-react": "0.0.0-nightly-20240925070419"
   },
   "devDependencies": {
     "@rspress/shared": "1.31.0",