@bleedingdev/modern-js-app-tools 3.5.0-ultramodern.100 → 3.5.0-ultramodern.102

package/bin/modern-bundle-docs.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// The CLI body lives in the compiled ESM output; a CommonJS shim keeps the
+// shebang and stays executable on any Node without a loader.
+const path = require('path');
+import('../dist/esm-node/bundleDocs.mjs').then(m =>
+  m.runBundleDocsCli(path.resolve(__dirname, '..')),
+);

package/dist/cjs/bundleDocs.js

@@ -0,0 +1,114 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    bundleDocs: ()=>bundleDocs,
+    runBundleDocsCli: ()=>runBundleDocsCli
+});
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const DEFAULT_INDEX_FILE = 'llms.txt';
+const DEFAULT_EXCLUDED_DIRS = [
+    'zh'
+];
+function bundleDocs({ source, target, indexFile = DEFAULT_INDEX_FILE, excludedDirs = DEFAULT_EXCLUDED_DIRS }) {
+    if (!external_node_fs_default().existsSync(source)) {
+        console.warn(`[bundle-docs] docs build output not found: ${source}`);
+        console.warn('[bundle-docs] skipping the bundled docs — build the docs site first if you need them');
+        return 0;
+    }
+    external_node_fs_default().rmSync(target, {
+        recursive: true,
+        force: true
+    });
+    const isBundled = (rel)=>rel === indexFile || rel.endsWith('.md') && !excludedDirs.some((dir)=>rel.startsWith(`${dir}${external_node_path_default().sep}`));
+    let count = 0;
+    for (const entry of external_node_fs_default().readdirSync(source, {
+        recursive: true,
+        withFileTypes: true
+    })){
+        if (!entry.isFile()) continue;
+        const from = external_node_path_default().join(entry.parentPath ?? entry.path, entry.name);
+        const rel = external_node_path_default().relative(source, from);
+        if (!isBundled(rel)) continue;
+        const to = external_node_path_default().join(target, rel);
+        external_node_fs_default().mkdirSync(external_node_path_default().dirname(to), {
+            recursive: true
+        });
+        external_node_fs_default().copyFileSync(from, to);
+        count++;
+    }
+    if (0 === count) throw new Error(`[bundle-docs] no files copied from ${source}`);
+    return count;
+}
+function parseArgs(argv) {
+    const options = {};
+    for(let i = 0; i < argv.length; i += 2){
+        const key = argv[i]?.replace(/^--/, '');
+        const value = argv[i + 1];
+        if (key && value) options[key] = value;
+    }
+    return options;
+}
+function runBundleDocsCli(pkgRoot) {
+    const args = parseArgs(process.argv.slice(2));
+    const source = args.source ? external_node_path_default().resolve(process.cwd(), args.source) : external_node_path_default().resolve(pkgRoot, '../../document/doc_build');
+    const target = args.target ? external_node_path_default().resolve(process.cwd(), args.target) : external_node_path_default().resolve(pkgRoot, 'docs');
+    try {
+        const count = bundleDocs({
+            source,
+            target,
+            indexFile: args.index
+        });
+        if (count > 0) console.log(`[bundle-docs] bundled ${count} doc files into docs`);
+    } catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+exports.bundleDocs = __webpack_exports__.bundleDocs;
+exports.runBundleDocsCli = __webpack_exports__.runBundleDocsCli;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "bundleDocs",
+    "runBundleDocsCli"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/bundleDocs.mjs

@@ -0,0 +1,62 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+const DEFAULT_INDEX_FILE = 'llms.txt';
+const DEFAULT_EXCLUDED_DIRS = [
+    'zh'
+];
+function bundleDocs({ source, target, indexFile = DEFAULT_INDEX_FILE, excludedDirs = DEFAULT_EXCLUDED_DIRS }) {
+    if (!node_fs.existsSync(source)) {
+        console.warn(`[bundle-docs] docs build output not found: ${source}`);
+        console.warn('[bundle-docs] skipping the bundled docs — build the docs site first if you need them');
+        return 0;
+    }
+    node_fs.rmSync(target, {
+        recursive: true,
+        force: true
+    });
+    const isBundled = (rel)=>rel === indexFile || rel.endsWith('.md') && !excludedDirs.some((dir)=>rel.startsWith(`${dir}${node_path.sep}`));
+    let count = 0;
+    for (const entry of node_fs.readdirSync(source, {
+        recursive: true,
+        withFileTypes: true
+    })){
+        if (!entry.isFile()) continue;
+        const from = node_path.join(entry.parentPath ?? entry.path, entry.name);
+        const rel = node_path.relative(source, from);
+        if (!isBundled(rel)) continue;
+        const to = node_path.join(target, rel);
+        node_fs.mkdirSync(node_path.dirname(to), {
+            recursive: true
+        });
+        node_fs.copyFileSync(from, to);
+        count++;
+    }
+    if (0 === count) throw new Error(`[bundle-docs] no files copied from ${source}`);
+    return count;
+}
+function parseArgs(argv) {
+    const options = {};
+    for(let i = 0; i < argv.length; i += 2){
+        const key = argv[i]?.replace(/^--/, '');
+        const value = argv[i + 1];
+        if (key && value) options[key] = value;
+    }
+    return options;
+}
+function runBundleDocsCli(pkgRoot) {
+    const args = parseArgs(process.argv.slice(2));
+    const source = args.source ? node_path.resolve(process.cwd(), args.source) : node_path.resolve(pkgRoot, '../../document/doc_build');
+    const target = args.target ? node_path.resolve(process.cwd(), args.target) : node_path.resolve(pkgRoot, 'docs');
+    try {
+        const count = bundleDocs({
+            source,
+            target,
+            indexFile: args.index
+        });
+        if (count > 0) console.log(`[bundle-docs] bundled ${count} doc files into docs`);
+    } catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+export { bundleDocs, runBundleDocsCli };

package/dist/esm-node/bundleDocs.mjs

@@ -0,0 +1,63 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+const DEFAULT_INDEX_FILE = 'llms.txt';
+const DEFAULT_EXCLUDED_DIRS = [
+    'zh'
+];
+function bundleDocs({ source, target, indexFile = DEFAULT_INDEX_FILE, excludedDirs = DEFAULT_EXCLUDED_DIRS }) {
+    if (!node_fs.existsSync(source)) {
+        console.warn(`[bundle-docs] docs build output not found: ${source}`);
+        console.warn('[bundle-docs] skipping the bundled docs — build the docs site first if you need them');
+        return 0;
+    }
+    node_fs.rmSync(target, {
+        recursive: true,
+        force: true
+    });
+    const isBundled = (rel)=>rel === indexFile || rel.endsWith('.md') && !excludedDirs.some((dir)=>rel.startsWith(`${dir}${node_path.sep}`));
+    let count = 0;
+    for (const entry of node_fs.readdirSync(source, {
+        recursive: true,
+        withFileTypes: true
+    })){
+        if (!entry.isFile()) continue;
+        const from = node_path.join(entry.parentPath ?? entry.path, entry.name);
+        const rel = node_path.relative(source, from);
+        if (!isBundled(rel)) continue;
+        const to = node_path.join(target, rel);
+        node_fs.mkdirSync(node_path.dirname(to), {
+            recursive: true
+        });
+        node_fs.copyFileSync(from, to);
+        count++;
+    }
+    if (0 === count) throw new Error(`[bundle-docs] no files copied from ${source}`);
+    return count;
+}
+function parseArgs(argv) {
+    const options = {};
+    for(let i = 0; i < argv.length; i += 2){
+        const key = argv[i]?.replace(/^--/, '');
+        const value = argv[i + 1];
+        if (key && value) options[key] = value;
+    }
+    return options;
+}
+function runBundleDocsCli(pkgRoot) {
+    const args = parseArgs(process.argv.slice(2));
+    const source = args.source ? node_path.resolve(process.cwd(), args.source) : node_path.resolve(pkgRoot, '../../document/doc_build');
+    const target = args.target ? node_path.resolve(process.cwd(), args.target) : node_path.resolve(pkgRoot, 'docs');
+    try {
+        const count = bundleDocs({
+            source,
+            target,
+            indexFile: args.index
+        });
+        if (count > 0) console.log(`[bundle-docs] bundled ${count} doc files into docs`);
+    } catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+export { bundleDocs, runBundleDocsCli };

package/dist/types/bundleDocs.d.ts

@@ -0,0 +1,20 @@
+export interface BundleDocsOptions {
+    /** Docs site build output (e.g. `doc_build`). */
+    source: string;
+    /** Directory to write the bundle to. */
+    target: string;
+    /** Index file to ship alongside the pages. */
+    indexFile?: string;
+    /** Top-level directories to skip. */
+    excludedDirs?: string[];
+}
+/** @returns files copied, or 0 when the source is absent */
+export declare function bundleDocs({ source, target, indexFile, excludedDirs, }: BundleDocsOptions): number;
+/**
+ * `modern-bundle-docs --source <doc_build> --target <pkg>/docs`; both default
+ * to this repo's layout.
+ *
+ * @param pkgRoot supplied by the bin shim — the compiled module cannot know
+ * its own package root portably across output formats.
+ */
+export declare function runBundleDocsCli(pkgRoot: string): void;

package/docs/apis/app/{commands.mdx → commands.md}

@@ -1,7 +1,3 @@
----
-sidebar_position: 1
----
-
 # Commands
 
 UltraModern.js has some built-in commands that can help you quickly start a development server, build production environment code, and more.
@@ -69,7 +65,7 @@ modern dev --entry foo,bar
 
 ## modern build
 
-The `modern build` command will build production-ready artifacts in the `dist/` directory by default. You can specify the output directory by modifying the configuration [`output.distPath`](/configure/app/output/dist-path).
+The `modern build` command will build production-ready artifacts in the `dist/` directory by default. You can specify the output directory by modifying the configuration [`output.distPath`](/configure/app/output/dist-path.md).
 
 ```bash
 Usage: modern build [options]
@@ -134,9 +130,28 @@ The request body always includes `appName`, `reason`, and `phase`. It includes `
 modern runtime fallback-signal --app crm-shell --reason remote_load_failed --phase load --json
 ```
 
-import ServeCommand from '@site-docs-en/components/serve-command';
+## modern serve
+
+The `modern serve` command is used to start an UltraModern.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.md#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
+```
 
-<ServeCommand />
+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,
+  },
+});
+```
 
 ## modern inspect
 
@@ -200,6 +215,17 @@ Inspect config succeed, open following files to view the content:
   - Modern.js Config: /root/my-project/dist/modern.js.config.mjs
 ```
 
-import DeployCommand from '@site-docs-en/components/deploy-command';
+## modern deploy
+
+The `modern deploy` command is used to generate artifacts required for the deployment platform.
+
+```bash
+Usage: modern deploy [options]
+
+Options:
+  -c --config <config>  Specify configuration file path, either relative or absolute
+  -s --skip-build       Skip the build stage
+  -h, --help            Display command help
+```
 
-<DeployCommand />
+For more details, refer to [Deploy Application](/guides/basic-features/deploy.md).

package/docs/apis/app/hooks/api/{lambda.mdx → lambda.md}

@@ -1,8 +1,4 @@
----
-title: lambda/*.ts
-sidebar_position: 3
----
-# lambda/*.ts
+# lambda/\*.ts
 
 After enabling BFF, the files under the `lambda/` directory will be registered as BFF routes according to conventions.
 
@@ -10,4 +6,4 @@ After enabling BFF, the files under the `lambda/` directory will be registered a
 The files can be written in `js` or `ts` languages, but they must use `esm` syntax to export functions.
 :::
 
-For detailed information, refer to [BFF API Routes](/guides/advanced-features/bff/function.html#api-routes).
+For detailed information, refer to [BFF API Routes](/guides/advanced-features/bff/function.md#api-routes).

package/docs/apis/app/hooks/config/{favicon.mdx → favicon.md}

@@ -1,11 +1,6 @@
----
-title: favicon.*
-sidebar_position: 3
----
-
 # Favicon
 
-When there is a `favicon.*` file in the `config` directory at the root of the project, Modern.js will automatically set the file to the [html.favicon](/configure/app/html/favicon) configuration option for generating the favicon icon on the page:
+When there is a `favicon.*` file in the `config` directory at the root of the project, Modern.js will automatically set the file to the [html.favicon](/configure/app/html/favicon.md) configuration option for generating the favicon icon on the page:
 
 ```
 ./config

package/docs/apis/app/hooks/config/{html.mdx → html.md}

@@ -1,9 +1,5 @@
----
-title: html/
-sidebar_position: 1
----
 # html/
 
 You can inject custom HTML fragments at different locations of the default internal HTML template through the `config/html` directory.
 
-For specific usage, please refer to: [Custom HTML](/guides/basic-features/html).
+For specific usage, please refer to: [Custom HTML](/guides/basic-features/html.md).

package/docs/apis/app/hooks/config/{icon.mdx → icon.md}

@@ -1,11 +1,6 @@
----
-title: icon.*
-sidebar_position: 2
----
-
 # Apple Touch Icon
 
-When there is an `icon.*` file in the `config` directory at the root of the project, Modern.js will automatically set the file to the [html.appIcon](/configure/app/html/app-icon) configuration option for generating the Apple Touch Icon icon under the iOS system.
+When there is an `icon.*` file in the `config` directory at the root of the project, Modern.js will automatically set the file to the [html.appIcon](/configure/app/html/app-icon.md) configuration option for generating the Apple Touch Icon icon under the iOS system.
 
 ```
 ./config

package/docs/apis/app/hooks/config/{mock.mdx → mock.md}

@@ -1,10 +1,6 @@
----
-title: mock/
-sidebar_position: 5
----
 # mock/
 
 When there is a `config/mock/index.ts` or `config/mock/index.js` file in the
 project directory, Modern.js will automatically enable the Mock service during
-development. Use [`dev.mockDir`](/configure/app/dev/mock-dir) to customize
+development. Use [`dev.mockDir`](/configure/app/dev/mock-dir.md) to customize
 this directory.

package/docs/apis/app/hooks/config/{public.mdx → public.md}

@@ -1,7 +1,3 @@
----
-title: public/
-sidebar_position: 3
----
 # public/
 
 Any static assets can be placed in the `public/` directory, and the files will be deployed to the corresponding application domain by the server.

package/docs/apis/app/hooks/config/{upload.mdx → upload.md}

@@ -1,7 +1,3 @@
----
-title: upload/
-sidebar_position: 4
----
 # upload/
 
 Any static assets can be placed in the `upload/` directory.
@@ -26,7 +22,7 @@ If the file ends with `.min.js`, it will not be compressed.
 
 ## More Usage
 
-In React components, you can add this prefix through [Environment Variables](/guides/basic-features/env-vars.html#asset_prefix):
+In React components, you can add this prefix through [Environment Variables](/guides/basic-features/env-vars.md#asset_prefix):
 
 ```tsx
 export default () => {
@@ -36,13 +32,13 @@ export default () => {
 };
 ```
 
-In addition, whether it is in [Custom HTML](/guides/basic-features/html) or any HTML file under [`config/public/`](/apis/app/hooks/config/public), you can directly use HTML tags to reference resources in the `config/upload/` directory:
+In addition, whether it is in [Custom HTML](/guides/basic-features/html.md) or any HTML file under [`config/public/`](/apis/app/hooks/config/public.md), you can directly use HTML tags to reference resources in the `config/upload/` directory:
 
 ```html
 <script src="/upload/index.js"></script>
 ```
 
-If you set the [`dev.assetPrefix`](/configure/app/dev/asset-prefix) or [`output.assetPrefix`](/configure/app/output/asset-prefix) prefix, you can also use template syntax to add the prefix directly:
+If you set the [`dev.assetPrefix`](/configure/app/dev/asset-prefix.md) or [`output.assetPrefix`](/configure/app/output/asset-prefix.md) prefix, you can also use template syntax to add the prefix directly:
 
 ```html
 <script src="<%=assetPrefix %>/upload/index.js"></script>

package/docs/apis/app/hooks/{modern-config.mdx → modern-config.md}

@@ -1,9 +1,5 @@
----
-title: modern.config.ts
-sidebar_position: 8
----
 # modern.config.ts
 
 The Modern.js configuration file. Through this file, you can personalize the configuration of various aspects of the current project.
 
-To learn more about how to use the configuration, please refer to [Configuration Usage](/configure/app/usage).
+To learn more about how to use the configuration, please refer to [Configuration Usage](/configure/app/usage.md).

package/docs/apis/app/hooks/server/{server.mdx → server.md}

@@ -1,10 +1,5 @@
----
-title: modern.server.ts
-sidebar_position: 1
----
-
 # modern.server.ts
 
-This file extends the Modern.js Server. In this file, you can configure [Middleware](/guides/advanced-features/web-server.html#middleware), [RenderMiddleware](/guides/advanced-features/web-server.html#rendermiddleware), or [Plugin](/guides/advanced-features/web-server.html#plugin) for the Server that starts with the Modern.js project.
+This file extends the Modern.js Server. In this file, you can configure [Middleware](/guides/advanced-features/web-server.md#middleware), [RenderMiddleware](/guides/advanced-features/web-server.md#rendermiddleware), or [Plugin](/guides/advanced-features/web-server.md#plugin) for the Server that starts with the Modern.js project.
 
 You can intercept and handle requests and responses, perform authentication and role checks, preprocess requests, and handle exceptions, etc. You can also insert specific business logic into the built-in processing logic (including route matching, resource addressing, header injection, page rendering, and static web hosting).

package/docs/apis/app/hooks/{shared.mdx → shared.md}

@@ -1,7 +1,3 @@
----
-title: shared/
-sidebar_position: 5
----
 # shared/
 
 Shared source code directory. When there is common code in `api/`, `server/`, and `src/` in the project, you can put these codes in the `shared` directory instead of directly referencing them.

package/docs/apis/app/hooks/src/{app.mdx → app.md}

@@ -1,6 +1,6 @@
 # App.tsx
 
-The entry identifier when using [Self-controlled Routing](/guides/concept/entries.html#self-controlled-routing) in the application.
+The entry identifier when using [Self-controlled Routing](/guides/concept/entries.md#self-controlled-routing) in the application.
 
 `App.tsx` is not the actual application entry; Modern.js will automatically generate the real entry file, which is roughly as follows:
 
@@ -26,5 +26,5 @@ render(<ModernRoot />, 'root');
 When `createRoot` is executed, it will retrieve the registered Global App and generate the actual React component.
 
 :::note
-In scenarios with multiple entry points, each entry can have its own independent `App.tsx`. For more details, see [Entry Points](/guides/concept/entries).
+In scenarios with multiple entry points, each entry can have its own independent `App.tsx`. For more details, see [Entry Points](/guides/concept/entries.md).
 :::

package/docs/apis/app/hooks/src/{entry.mdx → entry.md}

@@ -1,11 +1,6 @@
----
-title: entry.ts
-sidebar_position: 4
----
-
 # entry.tsx
 
-Normally, the [`routes/`](/apis/app/hooks/src/routes.html) and [`App.tsx`](/apis/app/hooks/src/app) hook files can meet our needs. When we need to add custom behavior before component rendering or take full control of the Rspack packaging entry, we can create `entry.ts` file in the src or entry directory. Here are two cases for discussion。
+Normally, the [`routes/`](/apis/app/hooks/src/routes.md) and [`App.tsx`](/apis/app/hooks/src/app.md) hook files can meet our needs. When we need to add custom behavior before component rendering or take full control of the Rspack packaging entry, we can create `entry.ts` file in the src or entry directory. Here are two cases for discussion。
 
 ## Add custom behavior before Render
 

package/docs/apis/app/hooks/src/{entry.server.mdx → entry.server.md}

@@ -1,8 +1,3 @@
----
-title: entry.server.tsx
-sidebar_position: 5
----
-
 # entry.server.tsx
 
 When the project initiates `server.ssr`, Modern.js generates a default Server-Side entry. The sample code is as follows:

package/docs/apis/app/hooks/src/{modern.runtime.mdx → modern.runtime.md}

@@ -1,9 +1,5 @@
----
-title: modern.runtime.ts
-sidebar_position: 4
----
 # modern.runtime.ts
 
 The Modern.js Runtime configuration file allows for personalized configuration of the Runtime capabilities for the current project.
 
-For specific usage of the configuration, please refer to [Runtime Configuration](/configure/app/runtime/0-intro.html).
+For specific usage of the configuration, please refer to [Runtime Configuration](/configure/app/runtime/0-intro.md).

package/docs/apis/app/hooks/src/{routes.mdx → routes.md}

@@ -1,10 +1,6 @@
----
-title: routes/
-sidebar_position: 2
----
 # routes/
 
-The identifier for the entry point when the application uses [Conventional Routing](/guides/basic-features/routes/routes#conventional-routing).
+The identifier for the entry point when the application uses [Conventional Routing](/guides/basic-features/routes/routes.md#conventional-routing).
 
 Conventional routing uses `routes/` as the convention for the entry point and analyzes the files in the `src/routes` directory to obtain the client-side routing configuration.
 
@@ -52,9 +48,9 @@ If the directory name of the route file is named with `[]`, the generated route
 
 The `routes/[id]/page.tsx` file will be converted to the `/:id` route. Except for the `/blog` route that can be matched exactly, all other `/xxx` routes will be matched to this route.
 
-In the component, you can use [useParams](/apis/app/runtime/router/router#useparams) to obtain the corresponding named parameter.
+In the component, you can use [useParams](/apis/app/runtime/router/router.md#useparams) to obtain the corresponding named parameter.
 
-When using the [loader](/guides/basic-features/data/data-fetch#the-loader-function) function to obtain data, `params` will be passed as an input parameter to the `loader` function, and the corresponding parameter can be obtained through the attribute of `params`.
+When using the [loader](/guides/basic-features/data/data-fetch.md#the-loader-function) function to obtain data, `params` will be passed as an input parameter to the `loader` function, and the corresponding parameter can be obtained through the attribute of `params`.
 
 ## Layout Component
 

package/docs/apis/app/hooks/src/{server.mdx → server.md}

@@ -1,7 +1,3 @@
----
-title: '*.[server|node].tsx'
-sidebar_position: 8
----
-# *.[server|node].tsx
+# \*.\[server|node].tsx
 
 Used in the application project to place server-side code. When `*.tsx` and `*.[server|node].tsx` coexist, SSR will prefer to use the `*.[server|node].tsx` file instead of the `*.tsx` file when rendering on the server.

package/docs/apis/app/runtime/bff/{use-backend-context.mdx → use-backend-context.md}

@@ -1,6 +1,3 @@
----
-title: useHonoContext
----
 # useHonoContext
 
 Used to obtain backend request context in an integrated BFF function.

package/docs/apis/app/runtime/core/{create-root.mdx → create-root.md}

@@ -1,6 +1,3 @@
----
-title: createRoot
----
 # createRoot
 
 It is used to create the root component provided by Modern.js, which will automatically register Runtime plugins and complete the initialization of Runtime plugins.

package/docs/apis/app/runtime/core/{render.mdx → render.md}

@@ -1,6 +1,3 @@
----
-title: render
----
 # render
 
 It is used to render project components.
@@ -21,7 +18,7 @@ export function render(App: React.ReactElement, id?: HTMLElement | string): Prom
 
 ### Parameters
 
-- `App`：An instance of ReactElement created through [`createRoot`](./create-root).
+- `App`：An instance of ReactElement created through [`createRoot`](/apis/app/runtime/core/create-root.md).
 - `id`：The id of the DOM root element to be mounted, such as "root".
 
 ## Example

package/docs/apis/app/runtime/core/{runtime-context.mdx → runtime-context.md}

@@ -1,6 +1,3 @@
----
-title: RuntimeContext
----
 # RuntimeContext
 
 `RuntimeContext` is a React Context used to get Runtime context information in components. This Context can be accessed through React's `use` or `useContext` API.
@@ -157,4 +154,3 @@ export default function MyComponent() {
   return <div>{message}</div>;
 }
 ```
-

package/docs/apis/app/runtime/router/{router.mdx → router.md}

@@ -1,14 +1,9 @@
----
-title: router
-sidebar_position: 1
----
-
 # router
 
 :::info
 The router solution based on [react-router](https://reactrouter.com/).
 
-This page documents the React Router runtime export (`@modern-js/runtime/router`).  
+This page documents the React Router runtime export (`@modern-js/runtime/router`).\
 If your app uses TanStack Router (`--router tanstack`), use `@modern-js/plugin-tanstack/runtime` and refer to TanStack Router API docs.
 
 :::

package/docs/apis/app/runtime/ssr/{no-ssr.mdx → no-ssr.md}

@@ -1,6 +1,3 @@
----
-title: NoSSR
----
 # NoSSR
 
 The content wrapped by NoSSR will not be rendered at the server, nor will it be rendered during the client side hydrate. it will only be rendered immediately after the entire app is rendered.

package/docs/apis/app/runtime/ssr/{renderStreaming.mdx → renderStreaming.md}

@@ -1,7 +1,3 @@
----
-title: renderStreaming
----
-
 # renderStreaming
 
 Used for `React v18` + `Streaming SSR` to render readable streams, used in conjunction with `createRequestHandler`.