@modern-js/app-tools 3.9.2 → 3.10.0

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/commands/build.mjs

@@ -57,9 +57,8 @@ const build = async (api, options)=>{
     logger.info('Starting production build...');
     if (!appContext.builder) throw new Error('Expect the Builder to have been initialized, But the appContext.builder received `undefined`');
     await appContext.builder.onAfterBuild(async ()=>copyEnvFiles(appContext.appDirectory, appContext.distDirectory));
-    const buildResult = await appContext.builder.build({
+    await appContext.builder.build({
         watch: options?.watch
     });
-    if (!options?.watch) await buildResult?.close();
 };
 export { build };

package/dist/esm-node/commands/deploy.mjs

@@ -1,11 +1,9 @@
 import "node:module";
 import { getServerPlugins } from "../utils/loadPlugins.mjs";
-import { build } from "./build.mjs";
 const deploy = async (api, options = {})=>{
     const hooks = api.getHooks();
     const { metaName } = api.getAppContext();
-    if (options.skipBuild) await getServerPlugins(api, metaName);
-    else await build(api);
+    await getServerPlugins(api, metaName);
     await hooks.onBeforeDeploy.call(options);
     await hooks.deploy.call();
     await hooks.onAfterDeploy.call(options);

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

@@ -20,6 +20,10 @@ const serverCommand = (program, api)=>{
 };
 const deployCommand = (program, api)=>{
     program.command('deploy').usage('[options]').option('-c --config <config>', i18n.t(localeKeys.command.shared.config)).option('-s --skip-build', i18n.t(localeKeys.command.shared.skipBuild)).description(i18n.t(localeKeys.command.deploy.describe)).action(async (options)=>{
+        if (!options.skipBuild) {
+            const { build } = await import("./build.mjs");
+            await build(api);
+        }
         const { deploy } = await import("./deploy.mjs");
         await deploy(api, options);
         process.exit(0);

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/index.mjs

@@ -77,18 +77,12 @@ const appTools = ()=>({
                     ].some((tag)=>getArgv().includes(tag));
                     if (isSkipBuild) return;
                 }
-                const { command: contextCommand } = api.getAppContext();
-                const shouldClean = [
+                if ([
                     'dev',
                     'start',
                     'build',
                     'deploy'
-                ].includes(command) || [
-                    'dev',
-                    'start',
-                    'build'
-                ].includes(contextCommand);
-                if (shouldClean) {
+                ].includes(command)) {
                     const resolvedConfig = api.getNormalizedConfig();
                     if (resolvedConfig.output.cleanDistPath) {
                         const appContext = api.getAppContext();
@@ -128,8 +122,6 @@ const appTools = ()=>({
     });
 const src = appTools;
 export { defineConfig } from "./defineConfig.mjs";
-export { build } from "./commands/build.mjs";
-export { deploy } from "./commands/deploy.mjs";
 export { dev } from "./commands/dev.mjs";
 export { serve } from "./commands/serve.mjs";
 export { closeServer } from "./utils/createServer.mjs";

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

@@ -24,7 +24,7 @@ const analyze = ()=>({
                 const resolvedConfig = api.getNormalizedConfig();
                 const hooks = api.getHooks();
                 try {
-                    if (checkIsBuildCommands(appContext.command)) fs.emptydirSync(appContext.internalDirectory);
+                    if (checkIsBuildCommands()) fs.emptydirSync(appContext.internalDirectory);
                 } catch  {}
                 const apiOnly = await isApiOnly(appContext.appDirectory, resolvedConfig.source?.entriesDir, appContext.apiDirectory);
                 const [{ getProdServerRoutes }] = await Promise.all([
@@ -118,7 +118,7 @@ const analyze = ()=>({
                     htmlTemplates
                 };
                 api.updateAppContext(appContext);
-                if (checkIsBuildCommands(appContext.command)) {
+                if (checkIsBuildCommands()) {
                     await hooks.generateEntryCode.call({
                         entrypoints
                     });

package/dist/esm-node/plugins/analyze/utils.mjs

@@ -53,7 +53,7 @@ const parseModule = async ({ source, filename })=>{
     return await parse(content);
 };
 const getServerCombinedModuleFile = (internalDirectory, entryName)=>path.join(internalDirectory, entryName, 'server-loader-combined.js');
-const checkIsBuildCommands = (contextCommand)=>{
+const checkIsBuildCommands = ()=>{
     const buildCommands = [
         'dev',
         'start',
@@ -63,8 +63,7 @@ const checkIsBuildCommands = (contextCommand)=>{
         'dev-worker'
     ];
     const command = getCommand();
-    if (buildCommands.includes(command)) return true;
-    return 'dev' === contextCommand || 'start' === contextCommand || 'build' === contextCommand || 'deploy' === contextCommand;
+    return buildCommands.includes(command);
 };
 const checkIsServeCommand = ()=>{
     const command = getCommand();

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

@@ -26,7 +26,7 @@ const initialize = ()=>({
             api.modifyResolvedConfig(async (resolved)=>{
                 let appContext = api.getAppContext();
                 const userConfig = api.getConfig();
-                const port = await getServerPort(resolved, appContext.command);
+                const port = await getServerPort(resolved);
                 appContext = {
                     ...appContext,
                     port,
@@ -46,7 +46,6 @@ const initialize = ()=>({
                     'html',
                     'output',
                     'tools',
-                    'testing',
                     'plugins',
                     'builderPlugins',
                     'deploy',
@@ -61,10 +60,9 @@ function stabilizeConfig(resolve, config, keys) {
         resolve[key] = config[key] || {};
     });
 }
-async function getServerPort(config, contextCommand) {
+async function getServerPort(config) {
     const prodPort = Number(process.env.PORT) || config.server.port || 8080;
-    const isProgrammaticDev = 'dev' === contextCommand || 'start' === contextCommand;
-    if (isDev() && (isDevCommand() || isProgrammaticDev)) return getPort(Number(process.env.PORT) || prodPort);
+    if (isDev() && isDevCommand()) return getPort(Number(process.env.PORT) || prodPort);
     return prodPort;
 }
 export default initialize;

package/dist/types/index.d.ts

@@ -3,12 +3,10 @@ import { initAppContext } from './utils/initAppContext.js';
 export * from './defineConfig.js';
 export declare const appTools: () => CliPlugin<AppTools>;
 export { defineConfig } from './defineConfig.js';
-export { build } from './commands/build.js';
-export { deploy } from './commands/deploy.js';
 export { dev } from './commands/dev.js';
 export { serve } from './commands/serve.js';
 export { closeServer } from './utils/createServer.js';
-export type { BuildOptions, DeployOptions, DevOptions } from './utils/types.js';
+export type { DeployOptions, DevOptions } from './utils/types.js';
 export { generateWatchFiles } from './utils/generateWatchFiles.js';
 export { resolveModernRsbuildConfig, type ResolveModernRsbuildConfigOptions, } from './rsbuild.js';
 export * from './types/index.js';

package/dist/types/plugins/analyze/utils.d.ts

@@ -5,6 +5,6 @@ export declare const parseModule: ({ source, filename, }: {
     filename: string;
 }) => Promise<readonly [imports: readonly import("es-module-lexer").ImportSpecifier[], exports: readonly import("es-module-lexer").ExportSpecifier[], facade: boolean, hasModuleSyntax: boolean]>;
 export declare const getServerCombinedModuleFile: (internalDirectory: string, entryName: string) => string;
-export declare const checkIsBuildCommands: (contextCommand?: string) => boolean;
+export declare const checkIsBuildCommands: () => boolean;
 export declare const checkIsServeCommand: () => boolean;
 export declare const isSubDirOrEqual: (parent: string, child: string) => boolean;

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(() => {

package/docs/apis/app/runtime/core/runtime-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.
+
 # 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.
@@ -16,7 +18,7 @@ import { RuntimeContext } from '@modern-js/runtime';
 
 export function App() {
   const runtimeContext = use(RuntimeContext); // You can also use useContext(RuntimeContext)
-  return <div>Hello World</div>
+  return <div>Hello World</div>;
 }
 ```
 
@@ -50,21 +52,21 @@ type TRuntimeContext = {
 ```ts
 type RequestContext = {
   request: {
-    params: Record<string, string>;      // Route parameters
-    pathname: string;                     // Pathname
-    query: Record<string, string>;        // Query parameters
-    headers: IncomingHttpHeaders;         // Request headers
-    host: string;                         // Hostname
-    url: string;                          // Full URL
-    referer?: string;                     // Referrer page
-    userAgent?: string;                   // User agent
-    cookie?: string;                      // Cookie string
-    cookieMap?: Record<string, string>;   // Cookie map object
+    params: Record<string, string>; // Route parameters
+    pathname: string; // Pathname
+    query: Record<string, string>; // Query parameters
+    headers: IncomingHttpHeaders; // Request headers
+    host: string; // Hostname
+    url: string; // Full URL
+    referer?: string; // Referrer page
+    userAgent?: string; // User agent
+    cookie?: string; // Cookie string
+    cookieMap?: Record<string, string>; // Cookie map object
   };
   response: {
-    setHeader: (key: string, value: string) => void;  // Set response header (server-side only)
-    status: (code: number) => void;                   // Set status code (server-side only)
-    locals: Record<string, any>;                      // Local data
+    setHeader: (key: string, value: string) => void; // Set response header (server-side only)
+    status: (code: number) => void; // Set status code (server-side only)
+    locals: Record<string, any>; // Local data
   };
 };
 ```
@@ -88,11 +90,11 @@ function App() {
 
   if (isBrowser === true) {
     // Browser-side execution logic
-    console.log('browser render')
+    console.log('browser render');
   } else {
     // Server-side execution logic
     // Note: Functions like logger need to be injected into context through Runtime plugins
-    console.log('server render')
+    console.log('server render');
   }
 }
 ```

package/docs/apis/app/runtime/router/router.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.
+
 # router
 
 :::info
@@ -131,8 +133,10 @@ export default ErrorBoundary;
 ```ts
 declare function Link(props: LinkProps): React.ReactElement;
 
-interface LinkProps
-  extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+interface LinkProps extends Omit<
+  React.AnchorHTMLAttributes<HTMLAnchorElement>,
+  'href'
+> {
   replace?: boolean;
   state?: any;
   to: To;
@@ -153,12 +157,13 @@ A `<Link>` is an element that lets the user navigate to another page by clicking
 ```ts
 declare function NavLink(props: NavLinkProps): React.ReactElement;
 
-interface NavLinkProps
-  extends Omit<LinkProps, 'className' | 'style' | 'children'> {
+interface NavLinkProps extends Omit<
+  LinkProps,
+  'className' | 'style' | 'children'
+> {
   caseSensitive?: boolean;
   children?:
-    | React.ReactNode
-    | ((props: { isActive: boolean }) => React.ReactNode);
+    React.ReactNode | ((props: { isActive: boolean }) => React.ReactNode);
   className?: string | ((props: { isActive: boolean }) => string | undefined);
   end?: boolean;
   style?:

package/docs/apis/app/runtime/ssr/no-ssr.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.
+
 # 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.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.
+
 # renderStreaming
 
 Used for `React v18` + `Streaming SSR` to render readable streams, used in conjunction with `createRequestHandler`.

package/docs/apis/app/runtime/ssr/renderString.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.
+
 # renderString
 
 Used for React String SSR to render strings, used in conjunction with `createRequestHandler`.

package/docs/apis/app/runtime/ssr/requestHandler.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.
+
 # createRequestHandler
 
 Used to customize the Server-Side Rendering entry to return the `requestHandler`.