@modern-js/app-tools 3.9.3 → 3.10.0

package/dist/cjs/builder/shared/bundlerPlugins/HtmlAsyncChunkPlugin.js

@@ -35,9 +35,25 @@ class HtmlAsyncChunkPlugin {
     apply(compiler) {
         compiler.hooks.compilation.tap(this.name, (compilation)=>{
             const hooks = this.htmlPlugin.getCompilationHooks(compilation);
-            hooks.alterAssetTagGroups.tap(this.name, (assets)=>{
+            const runtimeInEntry = false === compiler.options.optimization.runtimeChunk;
+            const getEntryRuntimeUrls = (publicPath)=>new Set([
+                    ...compilation.entrypoints.values()
+                ].flatMap((entrypoint)=>[
+                        ...entrypoint.getRuntimeChunk().files
+                    ].flatMap((file)=>{
+                        const pathname = file.split('?', 1)[0];
+                        return [
+                            `${publicPath}${pathname}`,
+                            `${publicPath}${pathname.split('/').map(encodeURIComponent).join('/')}`
+                        ];
+                    })));
+            hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: -1
+            }, (assets)=>{
                 const headTags = [];
                 const bodyTags = [];
+                const entryRuntimeUrls = runtimeInEntry ? getEntryRuntimeUrls(assets.publicPath) : new Set();
                 const processScriptTag = (tag)=>{
                     const { attributes } = tag;
                     if (attributes && true === attributes.defer) {
@@ -45,7 +61,7 @@ class HtmlAsyncChunkPlugin {
                         delete attributes.defer;
                     }
                     const src = attributes?.src;
-                    const isRuntimeChunk = src && builder_namespaceObject.RUNTIME_CHUNK_REGEX.test(src);
+                    const isRuntimeChunk = 'string' == typeof src && (runtimeInEntry ? entryRuntimeUrls.has(src.split(/[?#]/, 1)[0]) : builder_namespaceObject.RUNTIME_CHUNK_REGEX.test(src));
                     return isRuntimeChunk ? bodyTags : headTags;
                 };
                 for (const tag of [
@@ -59,6 +75,42 @@ class HtmlAsyncChunkPlugin {
                     bodyTags
                 };
             });
+            if (runtimeInEntry) hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: 1
+            }, (assets)=>{
+                const entryRuntimeUrls = getEntryRuntimeUrls(assets.publicPath);
+                for (const tag of assets.bodyTags){
+                    const src = tag.attributes?.src;
+                    if ("script" !== tag.tagName || 'string' != typeof src || !entryRuntimeUrls.has(src.split(/[?#]/, 1)[0])) continue;
+                    const attributes = {
+                        rel: 'module' === tag.attributes.type ? 'modulepreload' : 'preload',
+                        href: src,
+                        ...'module' === tag.attributes.type ? {} : {
+                            as: "script"
+                        }
+                    };
+                    const resourceAttributes = [
+                        'crossorigin',
+                        'integrity',
+                        'referrerpolicy',
+                        'fetchpriority',
+                        'nonce'
+                    ];
+                    for (const key of resourceAttributes)if (void 0 !== tag.attributes[key]) attributes[key] = tag.attributes[key];
+                    if (!assets.headTags.some((existing)=>'link' === existing.tagName && [
+                            'rel',
+                            'href',
+                            'as',
+                            ...resourceAttributes
+                        ].every((key)=>existing.attributes?.[key] === attributes[key]))) assets.headTags.push({
+                        tagName: 'link',
+                        voidTag: true,
+                        attributes
+                    });
+                }
+                return assets;
+            });
         });
     }
     constructor(htmlPlugin){

package/dist/cjs/compat/hooks.js

@@ -51,11 +51,6 @@ function getHookRunners(context) {
             const result = await hooks?.appendEntryCode.call(params);
             return result;
         },
-        jestConfig: async (utils)=>{
-            const result = await hooks?.jestConfig.call(utils, (utils)=>utils);
-            return result;
-        },
-        afterTest: async ()=>hooks.afterTest.call(),
         config: async ()=>hooks.config.call(),
         resolvedConfig: (params)=>hooks.modifyResolvedConfig.call(params),
         htmlPartials: async (params)=>{

package/dist/cjs/compat/index.js

@@ -30,7 +30,6 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     compatPlugin: ()=>compatPlugin
 });
-const plugin_namespaceObject = require("@modern-js/plugin");
 const external_hooks_js_namespaceObject = require("./hooks.js");
 const compatPlugin = ()=>({
         name: '@modern-js/app-tools-compat',
@@ -47,10 +46,6 @@ const compatPlugin = ()=>({
                 useHookRunners: ()=>(0, external_hooks_js_namespaceObject.getHookRunners)(getInternalContext())
             };
         },
-        registryHooks: {
-            jestConfig: (0, plugin_namespaceObject.createAsyncHook)(),
-            afterTest: (0, plugin_namespaceObject.createAsyncHook)()
-        },
         setup: (api)=>{
             api.updateAppContext({
                 toolsType: 'app-tools'

package/dist/cjs/compat/utils.js

@@ -101,11 +101,6 @@ function transformHookParams(hookRunnerName, params) {
                     entrypoint: params[0].entrypoint
                 }
             };
-        case 'jestConfig':
-            return {
-                isMultiple: true,
-                params: params
-            };
         default:
             return {
                 isMultiple: false,

package/dist/cjs/plugins/initialize/index.js

@@ -77,7 +77,6 @@ const initialize = ()=>({
                     'html',
                     'output',
                     'tools',
-                    'testing',
                     'plugins',
                     'builderPlugins',
                     'deploy',

package/dist/esm/builder/shared/bundlerPlugins/HtmlAsyncChunkPlugin.mjs

@@ -3,9 +3,25 @@ class HtmlAsyncChunkPlugin {
     apply(compiler) {
         compiler.hooks.compilation.tap(this.name, (compilation)=>{
             const hooks = this.htmlPlugin.getCompilationHooks(compilation);
-            hooks.alterAssetTagGroups.tap(this.name, (assets)=>{
+            const runtimeInEntry = false === compiler.options.optimization.runtimeChunk;
+            const getEntryRuntimeUrls = (publicPath)=>new Set([
+                    ...compilation.entrypoints.values()
+                ].flatMap((entrypoint)=>[
+                        ...entrypoint.getRuntimeChunk().files
+                    ].flatMap((file)=>{
+                        const pathname = file.split('?', 1)[0];
+                        return [
+                            `${publicPath}${pathname}`,
+                            `${publicPath}${pathname.split('/').map(encodeURIComponent).join('/')}`
+                        ];
+                    })));
+            hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: -1
+            }, (assets)=>{
                 const headTags = [];
                 const bodyTags = [];
+                const entryRuntimeUrls = runtimeInEntry ? getEntryRuntimeUrls(assets.publicPath) : new Set();
                 const processScriptTag = (tag)=>{
                     const { attributes } = tag;
                     if (attributes && true === attributes.defer) {
@@ -13,7 +29,7 @@ class HtmlAsyncChunkPlugin {
                         delete attributes.defer;
                     }
                     const src = attributes?.src;
-                    const isRuntimeChunk = src && RUNTIME_CHUNK_REGEX.test(src);
+                    const isRuntimeChunk = 'string' == typeof src && (runtimeInEntry ? entryRuntimeUrls.has(src.split(/[?#]/, 1)[0]) : RUNTIME_CHUNK_REGEX.test(src));
                     return isRuntimeChunk ? bodyTags : headTags;
                 };
                 for (const tag of [
@@ -27,6 +43,42 @@ class HtmlAsyncChunkPlugin {
                     bodyTags
                 };
             });
+            if (runtimeInEntry) hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: 1
+            }, (assets)=>{
+                const entryRuntimeUrls = getEntryRuntimeUrls(assets.publicPath);
+                for (const tag of assets.bodyTags){
+                    const src = tag.attributes?.src;
+                    if ("script" !== tag.tagName || 'string' != typeof src || !entryRuntimeUrls.has(src.split(/[?#]/, 1)[0])) continue;
+                    const attributes = {
+                        rel: 'module' === tag.attributes.type ? 'modulepreload' : 'preload',
+                        href: src,
+                        ...'module' === tag.attributes.type ? {} : {
+                            as: "script"
+                        }
+                    };
+                    const resourceAttributes = [
+                        'crossorigin',
+                        'integrity',
+                        'referrerpolicy',
+                        'fetchpriority',
+                        'nonce'
+                    ];
+                    for (const key of resourceAttributes)if (void 0 !== tag.attributes[key]) attributes[key] = tag.attributes[key];
+                    if (!assets.headTags.some((existing)=>'link' === existing.tagName && [
+                            'rel',
+                            'href',
+                            'as',
+                            ...resourceAttributes
+                        ].every((key)=>existing.attributes?.[key] === attributes[key]))) assets.headTags.push({
+                        tagName: 'link',
+                        voidTag: true,
+                        attributes
+                    });
+                }
+                return assets;
+            });
         });
     }
     constructor(htmlPlugin){

package/dist/esm/compat/hooks.mjs

@@ -18,11 +18,6 @@ function getHookRunners(context) {
             const result = await hooks?.appendEntryCode.call(params);
             return result;
         },
-        jestConfig: async (utils)=>{
-            const result = await hooks?.jestConfig.call(utils, (utils)=>utils);
-            return result;
-        },
-        afterTest: async ()=>hooks.afterTest.call(),
         config: async ()=>hooks.config.call(),
         resolvedConfig: (params)=>hooks.modifyResolvedConfig.call(params),
         htmlPartials: async (params)=>{

package/dist/esm/compat/index.mjs

@@ -1,4 +1,3 @@
-import { createAsyncHook } from "@modern-js/plugin";
 import { getHookRunners } from "./hooks.mjs";
 const compatPlugin = ()=>({
         name: '@modern-js/app-tools-compat',
@@ -15,10 +14,6 @@ const compatPlugin = ()=>({
                 useHookRunners: ()=>getHookRunners(getInternalContext())
             };
         },
-        registryHooks: {
-            jestConfig: createAsyncHook(),
-            afterTest: createAsyncHook()
-        },
         setup: (api)=>{
             api.updateAppContext({
                 toolsType: 'app-tools'

package/dist/esm/compat/utils.mjs

@@ -67,11 +67,6 @@ function transformHookParams(hookRunnerName, params) {
                     entrypoint: params[0].entrypoint
                 }
             };
-        case 'jestConfig':
-            return {
-                isMultiple: true,
-                params: params
-            };
         default:
             return {
                 isMultiple: false,

package/dist/esm/plugins/initialize/index.mjs

@@ -45,7 +45,6 @@ const initialize = ()=>({
                     'html',
                     'output',
                     'tools',
-                    'testing',
                     'plugins',
                     'builderPlugins',
                     'deploy',

package/dist/esm-node/builder/shared/bundlerPlugins/HtmlAsyncChunkPlugin.mjs

@@ -4,9 +4,25 @@ class HtmlAsyncChunkPlugin {
     apply(compiler) {
         compiler.hooks.compilation.tap(this.name, (compilation)=>{
             const hooks = this.htmlPlugin.getCompilationHooks(compilation);
-            hooks.alterAssetTagGroups.tap(this.name, (assets)=>{
+            const runtimeInEntry = false === compiler.options.optimization.runtimeChunk;
+            const getEntryRuntimeUrls = (publicPath)=>new Set([
+                    ...compilation.entrypoints.values()
+                ].flatMap((entrypoint)=>[
+                        ...entrypoint.getRuntimeChunk().files
+                    ].flatMap((file)=>{
+                        const pathname = file.split('?', 1)[0];
+                        return [
+                            `${publicPath}${pathname}`,
+                            `${publicPath}${pathname.split('/').map(encodeURIComponent).join('/')}`
+                        ];
+                    })));
+            hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: -1
+            }, (assets)=>{
                 const headTags = [];
                 const bodyTags = [];
+                const entryRuntimeUrls = runtimeInEntry ? getEntryRuntimeUrls(assets.publicPath) : new Set();
                 const processScriptTag = (tag)=>{
                     const { attributes } = tag;
                     if (attributes && true === attributes.defer) {
@@ -14,7 +30,7 @@ class HtmlAsyncChunkPlugin {
                         delete attributes.defer;
                     }
                     const src = attributes?.src;
-                    const isRuntimeChunk = src && RUNTIME_CHUNK_REGEX.test(src);
+                    const isRuntimeChunk = 'string' == typeof src && (runtimeInEntry ? entryRuntimeUrls.has(src.split(/[?#]/, 1)[0]) : RUNTIME_CHUNK_REGEX.test(src));
                     return isRuntimeChunk ? bodyTags : headTags;
                 };
                 for (const tag of [
@@ -28,6 +44,42 @@ class HtmlAsyncChunkPlugin {
                     bodyTags
                 };
             });
+            if (runtimeInEntry) hooks.alterAssetTagGroups.tap({
+                name: this.name,
+                stage: 1
+            }, (assets)=>{
+                const entryRuntimeUrls = getEntryRuntimeUrls(assets.publicPath);
+                for (const tag of assets.bodyTags){
+                    const src = tag.attributes?.src;
+                    if ("script" !== tag.tagName || 'string' != typeof src || !entryRuntimeUrls.has(src.split(/[?#]/, 1)[0])) continue;
+                    const attributes = {
+                        rel: 'module' === tag.attributes.type ? 'modulepreload' : 'preload',
+                        href: src,
+                        ...'module' === tag.attributes.type ? {} : {
+                            as: "script"
+                        }
+                    };
+                    const resourceAttributes = [
+                        'crossorigin',
+                        'integrity',
+                        'referrerpolicy',
+                        'fetchpriority',
+                        'nonce'
+                    ];
+                    for (const key of resourceAttributes)if (void 0 !== tag.attributes[key]) attributes[key] = tag.attributes[key];
+                    if (!assets.headTags.some((existing)=>'link' === existing.tagName && [
+                            'rel',
+                            'href',
+                            'as',
+                            ...resourceAttributes
+                        ].every((key)=>existing.attributes?.[key] === attributes[key]))) assets.headTags.push({
+                        tagName: 'link',
+                        voidTag: true,
+                        attributes
+                    });
+                }
+                return assets;
+            });
         });
     }
     constructor(htmlPlugin){

package/dist/esm-node/compat/hooks.mjs

@@ -19,11 +19,6 @@ function getHookRunners(context) {
             const result = await hooks?.appendEntryCode.call(params);
             return result;
         },
-        jestConfig: async (utils)=>{
-            const result = await hooks?.jestConfig.call(utils, (utils)=>utils);
-            return result;
-        },
-        afterTest: async ()=>hooks.afterTest.call(),
         config: async ()=>hooks.config.call(),
         resolvedConfig: (params)=>hooks.modifyResolvedConfig.call(params),
         htmlPartials: async (params)=>{

package/dist/esm-node/compat/index.mjs

@@ -1,5 +1,4 @@
 import "node:module";
-import { createAsyncHook } from "@modern-js/plugin";
 import { getHookRunners } from "./hooks.mjs";
 const compatPlugin = ()=>({
         name: '@modern-js/app-tools-compat',
@@ -16,10 +15,6 @@ const compatPlugin = ()=>({
                 useHookRunners: ()=>getHookRunners(getInternalContext())
             };
         },
-        registryHooks: {
-            jestConfig: createAsyncHook(),
-            afterTest: createAsyncHook()
-        },
         setup: (api)=>{
             api.updateAppContext({
                 toolsType: 'app-tools'

package/dist/esm-node/compat/utils.mjs

@@ -68,11 +68,6 @@ function transformHookParams(hookRunnerName, params) {
                     entrypoint: params[0].entrypoint
                 }
             };
-        case 'jestConfig':
-            return {
-                isMultiple: true,
-                params: params
-            };
         default:
             return {
                 isMultiple: false,

package/dist/esm-node/plugins/initialize/index.mjs

@@ -46,7 +46,6 @@ const initialize = ()=>({
                     'html',
                     'output',
                     'tools',
-                    'testing',
                     'plugins',
                     'builderPlugins',
                     'deploy',

package/dist/types/types/config/index.d.ts

@@ -12,7 +12,6 @@ import type { PerformanceUserConfig } from './performance.js';
 import type { ResolveUserConfig } from './resolve.js';
 import type { SecurityUserConfig } from './security.js';
 import type { SourceUserConfig } from './source.js';
-import type { TestingUserConfig } from './testing.js';
 import type { ToolsUserConfig } from './tools.js';
 export * from './output.js';
 export interface AppToolsUserConfig {
@@ -32,7 +31,6 @@ export interface AppToolsUserConfig {
     html?: HtmlUserConfig;
     tools?: ToolsUserConfig;
     security?: SecurityUserConfig;
-    testing?: TestingUserConfig;
     builderPlugins?: RsbuildPlugins;
     performance?: PerformanceUserConfig;
     environments?: RsbuildConfig['environments'];

package/dist/types/types/config/tools.d.ts

@@ -1,15 +1,7 @@
 import type { BuilderConfig } from '@modern-js/builder';
-import type { JestConfig } from '@modern-js/types';
 import type { UnwrapBuilderConfig } from '../utils.js';
 type BuilderToolsConfig = UnwrapBuilderConfig<BuilderConfig, 'tools'>;
 export interface ToolsUserConfig extends Omit<BuilderToolsConfig, 'swc'> {
-    /**
-     * Used to custom Jest configurations.
-     * @requires `test` plugin.
-     * The configuration of `tools.jest` is provided by `test` plugin.
-     * Please use `yarn new` or `pnpm new` to enable the corresponding capability.
-     */
-    jest?: JestConfig | ((jestConfig: JestConfig) => JestConfig);
     /**
      * Used to custom SWC configurations.
      * @requires `swc` plugin.

package/docs/apis/app/commands.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Commands
 
 Modern.js has some built-in commands that can help you quickly start a development server, build production environment code, and more.

package/docs/apis/app/hooks/api/lambda.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # lambda/\*.ts
 
 After enabling BFF, the files under the `lambda/` directory will be registered as BFF routes according to conventions.

package/docs/apis/app/hooks/config/favicon.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.md) configuration option for generating the favicon icon on the page:

package/docs/apis/app/hooks/config/html.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # html/
 
 You can inject custom HTML fragments at different locations of the default internal HTML template through the `config/html` directory.

package/docs/apis/app/hooks/config/icon.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.md) configuration option for generating the Apple Touch Icon icon under the iOS system.

package/docs/apis/app/hooks/config/mock.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # mock/
 
 When there is a `config/mock/index.ts` or `config/mock/index.js` file in the

package/docs/apis/app/hooks/config/public.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # upload/
 
 Any static assets can be placed in the `upload/` directory.
@@ -26,9 +28,7 @@ In React components, you can add this prefix through [Environment Variables](/gu
 
 ```tsx
 export default () => {
-  return (
-    <img src={`${process.env.ASSET_PREFIX}/upload/banner.png`}></img>
-  );
+  return <img src={`${process.env.ASSET_PREFIX}/upload/banner.png`}></img>;
 };
 ```
 

package/docs/apis/app/hooks/modern-config.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # modern.config.ts
 
 The Modern.js configuration file. Through this file, you can personalize the configuration of various aspects of the current project.

package/docs/apis/app/hooks/server/server.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # modern.server.ts
 
 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.

package/docs/apis/app/hooks/shared.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # App.tsx
 
 The entry identifier when using [Self-controlled Routing](/guides/concept/entries.md#self-controlled-routing) in the application.

package/docs/apis/app/hooks/src/entry.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # entry.tsx
 
 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。

package/docs/apis/app/hooks/src/entry.server.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # modern.runtime.ts
 
 The Modern.js Runtime configuration file allows for personalized configuration of the Runtime capabilities for the current project.

package/docs/apis/app/hooks/src/routes.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # routes/
 
 The identifier for the entry point when the application uses [Conventional Routing](/guides/basic-features/routes/routes.md#conventional-routing).

package/docs/apis/app/hooks/src/server.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # \*.\[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-hono-context.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # useHonoContext
 
 Used to obtain Hono context in an integrated BFF function.

package/docs/apis/app/runtime/core/create-root.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # 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.
@@ -11,7 +13,9 @@ import { createRoot } from '@modern-js/runtime/react';
 ## Function Signature
 
 ```ts
-export function createRoot(UserApp?: React.ComponentType | null): React.ComponentType<any>;
+export function createRoot(
+  UserApp?: React.ComponentType | null,
+): React.ComponentType<any>;
 ```
 
 ### Parameters

package/docs/apis/app/runtime/core/render.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # render
 
 It is used to render project components.
@@ -13,7 +15,10 @@ render(<ModernRoot />);
 ## Function Signature
 
 ```ts
-export function render(App: React.ReactElement, id?: HTMLElement | string): Promise<any>;
+export function render(
+  App: React.ReactElement,
+  id?: HTMLElement | string,
+): Promise<any>;
 ```
 
 ### Parameters
@@ -30,7 +35,7 @@ import { render } from '@modern-js/runtime/browser';
 const ModernRoot = createRoot();
 
 async function beforeRender() {
-   // todo
+  // todo
 }
 
 beforeRender().then(() => {