@bleedingdev/modern-js-app-tools 3.9.0-ultramodern.1 → 3.9.0-ultramodern.10

package/dist/types/index.d.ts

@@ -1,8 +1,8 @@
+import { type PolicyDefaultsOptions } from '@modern-js/app-tools-extensions/policy-defaults';
 import type { AppTools, CliPlugin } from './types/index.js';
 import { initAppContext } from './utils/initAppContext.js';
 export * from './defineConfig.js';
-export * from './presetUltramodern.js';
-export declare const appTools: () => CliPlugin<AppTools>;
+export declare const appTools: (options?: PolicyDefaultsOptions) => CliPlugin<AppTools>;
 export { build } from './commands/build.js';
 export { deploy } from './commands/deploy.js';
 export { dev } from './commands/dev.js';

package/dist/types/plugins/deploy/utils/generator.d.ts

@@ -6,7 +6,7 @@ export declare const serverAppContextTemplate: (appContext: AppToolsContext) =>
     apiDirectory: string;
     lambdaDirectory: string;
     metaName: string;
-    bffRuntimeFramework: "effect" | "hono";
+    bffRuntimeFramework: keyof import("@modern-js/plugin/server").BffRuntimeRegistry;
 };
 export type PluginItem = [string, Record<string, any> | undefined];
 export declare const genPluginImportsCode: (plugins: PluginItem[], isESM?: boolean) => string;

package/dist/types/server-plugin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The fork's default server policy (localised loaders, error responses,
+ * telemetry, module-federation CSS and asset headers, static serving).
+ *
+ * It is exposed from `@modern-js/app-tools` so a plain `appTools()` app can
+ * load it by a specifier it is guaranteed to be able to resolve: every app
+ * declares `@modern-js/app-tools`, but not necessarily
+ * `@modern-js/server-runtime-extensions`.
+ */
+export { default } from '@modern-js/server-runtime-extensions/server-plugin';

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

@@ -1,8 +1,6 @@
 import type { BuilderConfig } from '@modern-js/builder';
 import type { SSGConfig, SSGMultiEntryOptions } from '@modern-js/types';
 import type { UnwrapBuilderConfig } from '../utils.js';
-import type { PrecompressConfig } from './precompress.js';
-export type { PrecompressCodecOptions, PrecompressConfig } from './precompress.js';
 export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'output'> {
     /**
      * Enable SSG for self-controlled routing or conventional routing.
@@ -34,12 +32,5 @@ export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'ou
      * Specify the temporary directory for framework generated files.
      */
     tempDir?: string;
-    /**
-     * Generate precompressed static assets by using compression-webpack-plugin.
-     * `true` means enabling both gzip and brotli with default options.
-     * Disabled unless explicitly configured; `presetUltramodern` enables it.
-     * @default false
-     */
-    precompress?: boolean | PrecompressConfig;
 }
 export type { SSGConfig, SSGMultiEntryOptions, SSGRouteOptions, SSGSingleEntryOptions, } from '@modern-js/types';

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

@@ -7,4 +7,4 @@ export type { CLIPluginExtends, RuntimePluginConfig, ServerPluginConfig };
 export type AppUserConfig = AppToolsUserConfig;
 export type AppNormalizedConfig = AppToolsNormalizedConfig;
 export type AppToolsAPI = CLIPluginAPI<AppTools>;
-export type { AppToolsContext, AppToolsExtendAPI, AppToolsExtendContext, AppToolsExtendHooks, AppToolsHooks as AppToolsFeatureHooks, } from './plugin.js';
+export type { AfterBffCompileFn, AppToolsContext, AppToolsExtendAPI, AppToolsExtendContext, AppToolsExtendHooks, AppToolsHooks as AppToolsFeatureHooks, BeforeBffCompileFn, BffClientArtifact, BffClientArtifacts, BffCompilation, BffGeneratedEntries, BffGeneratedModule, BffGeneration, ModifyBffClientArtifactsFn, ModifyBffGeneratedEntriesFn, } from './plugin.js';

package/dist/types/types/plugin.d.ts

@@ -1,11 +1,59 @@
 import type { AppContext, AsyncHook, InternalContext, PluginHook, PluginHookTap, TransformFunction } from '@modern-js/plugin';
 import type { Hooks } from '@modern-js/plugin/cli';
-import type { Entrypoint, HtmlPartials, HtmlTemplates, NestedRouteForCli, PageRoute, RouteLegacy, ServerPlugin, ServerRoute } from '@modern-js/types';
+import type { BffRuntimeFramework } from '@modern-js/plugin/server';
+import type { Entrypoint, HtmlPartials, HtmlTemplates, HttpMethodDecider, NestedRouteForCli, PageRoute, RouteLegacy, ServerPlugin, ServerRoute } from '@modern-js/types';
 import type { EagerRouteComponentFilesByEntry } from '@modern-js/utils';
 import type { EnvironmentConfig } from '@rsbuild/core';
 import type { getHookRunners } from '../compat/hooks.js';
 import type { AppTools } from './index.js';
 import type { AppToolsNormalizedConfig, AppToolsUserConfig } from './config/index.js';
+export interface BffCompilation {
+    readonly appDirectory: string;
+    readonly apiDirectory: string;
+    readonly sourceDirectories: readonly string[];
+    readonly outputDirectories: readonly string[];
+    readonly distDirectory: string;
+    readonly tsconfigPath?: string;
+    readonly moduleType: AppToolsContext['moduleType'];
+}
+export interface BffGeneration {
+    readonly appDirectory: string;
+    readonly apiDirectory: string;
+    readonly lambdaDirectory: string;
+    readonly existLambda: boolean;
+    readonly apiFiles: readonly string[];
+    readonly relativeDistPath: string;
+    readonly prefix: string;
+    readonly port?: number;
+    readonly requestId: string;
+    readonly requestCreator?: string;
+    readonly httpMethodDecider?: HttpMethodDecider;
+}
+export interface BffClientArtifact {
+    /** Canonical relative source path under generation.apiDirectory. */
+    readonly sourcePath: string;
+    readonly code: string;
+    readonly declaration: string;
+}
+export interface BffClientArtifacts {
+    readonly generation: BffGeneration;
+    additionalArtifacts: BffClientArtifact[];
+}
+export interface BffGeneratedModule {
+    readonly code: string;
+    readonly declaration: string;
+}
+export interface BffGeneratedEntries {
+    readonly generation: BffGeneration;
+    plugin: BffGeneratedModule;
+    runtime: BffGeneratedModule | null;
+    /** Direct dependencies required by the emitted SDK modules. */
+    packageDependencies: Record<string, string>;
+}
+export type BeforeBffCompileFn = (context: BffCompilation) => void | Promise<void>;
+export type AfterBffCompileFn = (context: BffCompilation) => void | Promise<void>;
+export type ModifyBffClientArtifactsFn = TransformFunction<BffClientArtifacts>;
+export type ModifyBffGeneratedEntriesFn = TransformFunction<BffGeneratedEntries>;
 export type AfterPrepareFn = () => Promise<void> | void;
 export type CheckEntryPointFn = TransformFunction<{
     path: string;
@@ -64,6 +112,10 @@ export interface AppToolsExtendAPI {
     useHookRunners: () => ReturnType<typeof getHookRunners>;
 }
 export interface AppToolsExtendHooks extends Record<string, PluginHook<(...args: any[]) => any>> {
+    onBeforeBffCompile: AsyncHook<BeforeBffCompileFn>;
+    onAfterBffCompile: AsyncHook<AfterBffCompileFn>;
+    modifyBffClientArtifacts: AsyncHook<ModifyBffClientArtifactsFn>;
+    modifyBffGeneratedEntries: AsyncHook<ModifyBffGeneratedEntriesFn>;
     onAfterPrepare: AsyncHook<AfterPrepareFn>;
     deploy: AsyncHook<DeplpoyFn>;
     checkEntryPoint: AsyncHook<CheckEntryPointFn>;
@@ -88,6 +140,8 @@ export interface AppToolsExtendContext {
     runtimeConfigFile: string;
     serverPlugins: ServerPlugin[];
     moduleType: 'module' | 'commonjs';
+    /** Exact generated files excluded from server compilation. */
+    serverCompileExcludedFiles?: string[];
     /** Information for entry points */
     entrypoints: Entrypoint[];
     /** Selected entry points */
@@ -115,7 +169,7 @@ export interface AppToolsExtendContext {
      * Identification for bff runtime framework
      * @private
      */
-    bffRuntimeFramework?: 'hono' | 'effect';
+    bffRuntimeFramework?: BffRuntimeFramework;
     /**
      * Route component files collected from the FINAL file-system routes (after all
      * `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated by

package/dist/types/utils/initAppContext.d.ts

@@ -1,3 +1,4 @@
+import type { BffRuntimeFramework } from '@modern-js/plugin/server';
 export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFile, options, tempDir, }: {
     metaName: string;
     appDirectory: string;
@@ -7,7 +8,7 @@ export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFil
         apiDir?: string;
         distDir?: string;
         sharedDir?: string;
-        bffRuntimeFramework?: 'hono' | 'effect';
+        bffRuntimeFramework?: BffRuntimeFramework;
     };
     tempDir?: string;
 }) => {
@@ -27,5 +28,5 @@ export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFil
     apiOnly: boolean;
     internalDirAlias: string;
     internalSrcAlias: string;
-    bffRuntimeFramework: "effect" | "hono";
+    bffRuntimeFramework: keyof import("@modern-js/plugin/server").BffRuntimeRegistry;
 };

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
 
 UltraModern.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.

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-backend-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 backend request 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.

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.

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.

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

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`.

package/docs/apis/app/runtime/utility/css-in-js.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.
+
 # CSS-In-JS API
 
 Use Style Component to write CSS.

package/docs/apis/app/runtime/utility/head.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.
+
 # Head
 
 Used to add html elements (such as title, meta, script, etc.) to the `<head>` element, supports SSR.

package/docs/apis/app/runtime/utility/loadable.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.
+
 # loadable
 
 Used to create Loadable component

package/docs/community/blog/2022-0708-updates.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.
+
 # 2022 年 7 \~ 8 月更新内容
 
 > 发表于 2022.09.05

package/docs/community/blog/2022-0910-updates.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.
+
 # 2022 年 9 \~ 10 月更新内容
 
 > 发表于 2022.11.01

package/docs/community/blog/overview.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.
+
 # Overview
 
 Welcome to Modern.js blog!

package/docs/community/blog/v2-release-note.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.js v2 发布：支持 Rspack 构建
 
 > 发表于 2023.03.16

package/docs/community/blog/v3-release-note.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.js v3 Release: Focused on web framework, embracing ecosystem development
 
 > Published on 2025.02.06

package/docs/community/contributing-guide.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.
+
 # Contributing Guide
 
 Thanks for that you are interested in contributing to Modern.js. Before starting your contribution, please take a moment to read the following guidelines.

package/docs/community/releases.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.
+
 # Releases
 
 ## Changelog

package/docs/community/showcase.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.
+
 # Ecosystem
 
 UltraModern.js builds on a focused ecosystem of frameworks and tools. These projects provide the Effect, TanStack Router, build, documentation, and Module Federation foundations used by the fork.

package/docs/community/team.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.
+
 # Meet the Team
 
 The development of Modern.js is driven by ByteDance's Modern.js team and community contributors.

package/docs/configure/app/bff/cross-project.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.
+
 # bff.crossProject
 
 - **Type:** `boolean`

package/docs/configure/app/bff/effect.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.
+
 # bff.effect
 
 - **Type:**
@@ -43,21 +45,33 @@ Please refer to the [Enable BFF](/guides/advanced-features/bff/function.md#enabl
 
 :::caution Install the Effect peers yourself
 `effect` and `@effect/opentelemetry` are **optional exact peer dependencies** of
-`@modern-js/plugin-bff`, not dependencies. The plugin no longer bundles a copy —
-Effect 4 derives `Context` / `Service` keys per module instance, so a bundled copy
-would give your app a second Effect identity. Before setting
-`runtimeFramework: 'effect'` or importing `@modern-js/plugin-bff/effect`,
-`/effect-server`, `/effect-edge` or `/effect-client`, install the exact cohort:
+`@modern-js/bff-effect`. Install them in the application so its API modules and
+the framework use the same Effect instance. Before setting
+`runtimeFramework: 'effect'` or importing `@modern-js/bff-effect/effect`,
+`/effect-edge` or `/effect-client`, install the exact cohort:
 
 ```bash
 pnpm add effect@4.0.0-rc.112 @effect/opentelemetry@4.0.0-rc.112
 ```
 
 The pin is exact because UltraModern ships Effect as one lockstep cohort. Apps
-using only `runtimeFramework: 'hono'` or the `./data-platform` lane need neither
-package.
+using only native `runtimeFramework: 'hono'` or
+`@modern-js/bff-effect/data-platform` need neither package.
 :::
 
+Use `bffPlugin` from `@modern-js/plugin-bff-build-extensions` to register the
+Effect runtime. It composes the native BFF plugin. Install
+`@modern-js/bff-effect` and `@modern-js/plugin-bff-extensions` from the same
+framework cohort as application production dependencies, so the adapter remains
+available after development dependencies are removed. The build plugin can be a
+development dependency. See the [runtime configuration example](/guides/advanced-features/bff/frameworks.md).
+
+Native `@modern-js/plugin-bff/server` exports Hono APIs. For Node Effect APIs,
+import framework helpers such as `defineEffectBff` from
+`@modern-js/bff-effect/effect` and namespaces from the corresponding `effect/*`
+modules. Worker handlers and worker request context use
+`@modern-js/bff-effect/effect-edge`.
+
 Generated UltraModern workspaces use this runtime as the only generated HTTP API
 path. The API contract lives at `shared/api.ts`, the server runtime lives at
 `api/index.ts`, clients live under `src/api/*-client.ts`, and generated checks
@@ -169,7 +183,6 @@ export default defineConfig({
     endpoint: '/_data/batch',
     maxBatchSize: 16,
     maxBatchBytes: 64 * 1024,
-    flushIntervalMs: 8,
     maxConcurrency: 4,
     requestTimeoutMs: 10000,
     allowedMethods: ['GET'],
@@ -203,9 +216,9 @@ export default defineConfig({
 });
 ```
 
-`batch.flushIntervalMs` controls the client-side micro-batch window in the generated Effect client. `maxConcurrency` and `requestTimeoutMs` are applied by the server batch gateway when dispatching items.
+`maxConcurrency` and `requestTimeoutMs` control the server batch gateway. Native `HttpApiClient` calls send individual requests; they do not automatically batch requests.
 
-The generated `api.client.*` API only exists for loader-materialized `@api/index` imports. Directly importing the server entry (`api/index`) exposes the Effect BFF definition; its `client` property is a placeholder that fails on operation access.
+Import a shared `HttpApi` contract and pass it to `HttpApiClient.make` or `makeEffectHttpApiClient`. The client is fully type-inferred; `defineEffectBff` exposes server handlers and does not contain a client.
 
 ## Effect cohort
 
@@ -240,7 +253,7 @@ Strict Effect APIs should test the declared `HttpApi` contract, not a raw
 request handler. Edge-compatible tests can use the framework helper:
 
 ```ts
-import { createEffectBffTestHandler } from '@modern-js/plugin-bff/effect-edge';
+import { createEffectBffTestHandler } from '@modern-js/bff-effect/effect-edge';
 import apiModule from '../api/index';
 
 const testApi = await createEffectBffTestHandler({
@@ -255,12 +268,9 @@ If you manually compose an Effect web handler in a low-level proof, provide the
 platform services explicitly:
 
 ```ts
-import {
-  HttpApiBuilder,
-  HttpRouter,
-  HttpServer,
-  Layer,
-} from '@modern-js/plugin-bff/effect-server';
+import * as Layer from 'effect/Layer';
+import { HttpRouter, HttpServer } from 'effect/unstable/http';
+import { HttpApiBuilder } from 'effect/unstable/httpapi';
 
 const handler = HttpRouter.toWebHandler(
   HttpApiBuilder.layer(api).pipe(
@@ -280,13 +290,10 @@ current Effect v4 beta cohort, `HttpRouter.middleware(...)` returns a `Layer`
 directly:
 
 ```ts
-import {
-  Effect,
-  HttpApiBuilder,
-  HttpMiddleware,
-  HttpRouter,
-  Layer,
-} from '@modern-js/plugin-bff/effect-server';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import { HttpMiddleware, HttpRouter } from 'effect/unstable/http';
+import { HttpApiBuilder } from 'effect/unstable/httpapi';
 
 const corsLayer = HttpRouter.middleware(
   Effect.succeed(

package/docs/configure/app/bff/prefix.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.
+
 # bff.prefix
 
 - **Type:** `string`

package/docs/configure/app/bff/runtime-framework.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.
+
 # bff.runtimeFramework
 
 - **Type:** `'hono' | 'effect'`

package/docs/configure/app/builder-plugins.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.
+
 # builderPlugins
 
 - **Type:** `RsbuildPlugin[]`

package/docs/configure/app/dev/asset-prefix.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.
+
 # dev.assetPrefix
 
 - **Type:** `boolean | string | 'auto'`

package/docs/configure/app/dev/before-start-url.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.
+
 # dev.beforeStartUrl
 
 - **Type:** `() => Promise<void> | void`

package/docs/configure/app/dev/client.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.
+
 # dev.client
 
 - **Type:**

package/docs/configure/app/dev/hmr.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.
+
 # dev.hmr
 
 - **Type:** `boolean`

package/docs/configure/app/dev/host.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.
+
 # dev.host
 
 - **Type:** `string`