@bleedingdev/modern-js-app-tools 3.9.0-ultramodern.9 → 3.9.3-ultramodern.2

package/dist/types/index.d.ts

@@ -3,8 +3,6 @@ import type { AppTools, CliPlugin } from './types/index.js';
 import { initAppContext } from './utils/initAppContext.js';
 export * from './defineConfig.js';
 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';
 export { serve } from './commands/serve.js';
 export { defineConfig } from './defineConfig.js';
@@ -12,7 +10,7 @@ export { type ResolveModernRsbuildConfigOptions, resolveModernRsbuildConfig, } f
 export * from './types/index.js';
 export { closeServer } from './utils/createServer.js';
 export { generateWatchFiles } from './utils/generateWatchFiles.js';
-export type { BuildOptions, DeployOptions, DevOptions } from './utils/types.js';
+export type { DeployOptions, DevOptions } from './utils/types.js';
 export { initAppContext };
 export default appTools;
 export { mergeConfig } from '@modern-js/plugin/cli';

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

@@ -1,4 +1,5 @@
-import type { Entrypoint } from '@modern-js/types';
-import type { AppNormalizedConfig } from '../../types/index.js';
-import type { AppToolsContext, AppToolsHooks } from '../../types/plugin.js';
-export declare const getBundleEntry: (hooks: AppToolsHooks, appContext: AppToolsContext, config: AppNormalizedConfig) => Promise<Entrypoint[]>;
+import type { AppContext, CLIPluginExtends } from '@modern-js/plugin/cli';
+import type { Entrypoint } from '@modern-js/types/cli/base';
+import type { AppToolsNormalizedConfig } from '../../types/config/base.js';
+import type { AppToolsExtendHooksBase } from '../../types/plugin-base.js';
+export declare const getBundleEntry: (hooks: Pick<AppToolsExtendHooksBase<never>, 'checkEntryPoint'>, appContext: Pick<AppContext<CLIPluginExtends>, 'appDirectory' | 'packageName'>, config: Pick<AppToolsNormalizedConfig, 'source'>) => Promise<Entrypoint[]>;

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

@@ -1,7 +1,8 @@
-import type { Entrypoint } from '@modern-js/types';
-import type { AppNormalizedConfig } from '../../types/index.js';
-import type { AppToolsContext, AppToolsHooks } from '../../types/plugin.js';
+import type { AppContext, CLIPluginExtends } from '@modern-js/plugin/cli';
+import type { Entrypoint } from '@modern-js/types/cli/base';
+import type { AppToolsNormalizedConfig } from '../../types/config/base.js';
+import type { AppToolsExtendHooksBase } from '../../types/plugin-base.js';
 export type { Entrypoint };
 export declare const hasEntry: (dir: string) => string | false;
 export declare const hasServerEntry: (dir: string) => string | false;
-export declare const getFileSystemEntry: (hooks: AppToolsHooks, appContext: AppToolsContext, config: AppNormalizedConfig) => Promise<Entrypoint[]>;
+export declare const getFileSystemEntry: (hooks: Pick<AppToolsExtendHooksBase<never>, 'checkEntryPoint'>, appContext: Pick<AppContext<CLIPluginExtends>, 'appDirectory'>, config: Pick<AppToolsNormalizedConfig, 'source'>) => Promise<Entrypoint[]>;

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

@@ -3,8 +3,8 @@ export declare const replaceWithAlias: (base: string, filePath: string, alias: s
 export declare const parseModule: ({ source, filename, }: {
     source: string;
     filename: string;
-}) => Promise<readonly [imports: readonly import("es-module-lexer").ImportSpecifier[], exports: readonly import("es-module-lexer").ExportSpecifier[], facade: boolean, hasModuleSyntax: boolean]>;
+}) => Promise<readonly [imports: readonly import("es-module-lexer").Import[], exports: readonly import("es-module-lexer").Export[], 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/plugins/deploy/index.d.ts

@@ -1,6 +1,3 @@
-import type { AppTools, AppToolsNormalizedConfig, CliPlugin } from '../../types/index.js';
-import type { DeployTarget } from '../../types/config/deploy.js';
-export declare const getSupportedDeployTargets: () => DeployTarget[];
-export declare const resolveDeployTarget: (modernConfig: AppToolsNormalizedConfig, envDeployTarget?: string | undefined, detectedProvider?: import("std-env").ProviderName) => string;
+import type { AppTools, CliPlugin } from '../../types/index.js';
 export default _default;
 declare function _default(): CliPlugin<AppTools>;

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

@@ -13,4 +13,4 @@ export declare const getProjectUsage: (appDirectory: string, distDirectory: stri
 };
 export declare const getTemplatePath: (file: string) => string;
 export declare const readTemplate: (file: string) => Promise<string>;
-export declare const resolveESMDependency: (entry: string) => Promise<string | undefined>;
+export declare const resolveESMDependency: (entry: string, fromDirectory?: string) => Promise<string>;

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

@@ -1,4 +1,4 @@
-import type { InternalPlugins } from '@modern-js/types';
+import type { InternalPlugins } from '@modern-js/types/common';
 import { handleSetupResult } from '../compat/hooks.js';
 export interface RunOptions {
     cwd?: string;

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

@@ -0,0 +1,58 @@
+import type { CLIPlugin, CLIPluginExtends } from '@modern-js/plugin/cli';
+import type { BffUserConfig, ServerUserConfig } from '@modern-js/server-core/config-types';
+import type { NestedRoute, PageRoute } from '@modern-js/types/cli/base';
+import type { RsbuildConfig } from '@rsbuild/core';
+import type { AppToolsExtendAPIBase, AppToolsExtendContextBase, AppToolsExtendHooksBase } from '../plugin-base.js';
+import type { DeployUserConfig } from './deploy.js';
+import type { DevUserConfig } from './dev.js';
+import type { ExperimentsUserConfig } from './experiments.js';
+import type { HtmlUserConfig } from './html.js';
+import type { OutputUserConfig } from './output.js';
+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 type AppToolsBuilderPlugins = NonNullable<RsbuildConfig['plugins']>;
+export interface AppToolsUserConfigBase<Routes> {
+    resolve?: ResolveUserConfig;
+    server?: ServerUserConfig;
+    source?: SourceUserConfig;
+    output?: OutputUserConfig;
+    experiments?: ExperimentsUserConfig;
+    /**
+     * The configuration of `bff` is provided by `bff` plugin.
+     * Please use `yarn new` or `pnpm new` to enable the corresponding capability.
+     * @requires `bff` plugin
+     */
+    bff?: BffUserConfig;
+    dev?: DevUserConfig;
+    deploy?: DeployUserConfig;
+    html?: HtmlUserConfig;
+    tools?: ToolsUserConfig;
+    security?: SecurityUserConfig;
+    testing?: TestingUserConfig;
+    builderPlugins?: AppToolsBuilderPlugins;
+    performance?: PerformanceUserConfig;
+    environments?: RsbuildConfig['environments'];
+    splitChunks?: RsbuildConfig['splitChunks'];
+    plugins?: CliPlugin<AppToolsBase<Routes>>[];
+}
+interface SharedNormalizedConfig<RawConfig> {
+    cliOptions?: Record<string, any>;
+    _raw: RawConfig;
+}
+export type AppToolsNormalizedConfig<Config = AppToolsUserConfig> = Required<Config> & SharedNormalizedConfig<Config>;
+/** Renderer packages opt into JSX element typing through their owned type entry. */
+export interface CLIElementTypes {
+}
+export type CLIElement = CLIElementTypes[keyof CLIElementTypes];
+export type CLIFileSystemRoute<Element> = NestedRoute<string, Element> | PageRoute<Element>;
+export type AppToolsBase<Routes> = Required<CLIPluginExtends<AppToolsUserConfigBase<Routes>, AppToolsNormalizedConfig<AppToolsUserConfigBase<Routes>>, AppToolsExtendContextBase<AppToolsBase<Routes>>, AppToolsExtendAPIBase<AppToolsBase<Routes>, Routes>, AppToolsExtendHooksBase<Routes>>>;
+export type AppTools = AppToolsBase<CLIFileSystemRoute<CLIElement>>;
+export type AppToolsUserConfig = AppToolsUserConfigBase<CLIFileSystemRoute<CLIElement>>;
+export type AppUserConfig = AppToolsUserConfig;
+export type AppNormalizedConfig = AppToolsNormalizedConfig;
+export type CliPlugin<Extends extends CLIPluginExtends> = CLIPlugin<Extends>;

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

@@ -1,4 +1,4 @@
-import type { CloudflareWorkerArtifactConfig, CloudflareWorkerD1DatabaseConfig, CloudflareWorkerPublicAssetConfig, CloudflareWorkerSecurityConfig, CloudflareWorkerServiceBindingConfig, DeployTarget, JsonValue } from '@modern-js/app-tools-extensions/config';
+import type { CloudflareWorkerDeployConfig, DeployTarget } from '@modern-js/app-tools-extensions/config';
 export type { CloudflareWorkerArtifactConfig, CloudflareWorkerD1DatabaseConfig, CloudflareWorkerPublicAssetConfig, CloudflareWorkerSecurityConfig, CloudflareWorkerSecurityCorsConfig, CloudflareWorkerSecurityCspConfig, CloudflareWorkerSecurityCspMode, CloudflareWorkerSecurityNoindexConfig, CloudflareWorkerServiceBindingConfig, CloudflareWorkerServiceBindingFragmentConfig, DeployTarget, JsonValue, } from '@modern-js/app-tools-extensions/config';
 export interface MicroFrontend {
     /**
@@ -26,53 +26,5 @@ export interface DeployUserConfig {
      * @default false
      */
     microFrontend?: boolean | MicroFrontend;
-    worker?: {
-        name?: string;
-        /**
-         * Cloudflare Workers compatibility date for generated wrangler config.
-         * Use YYYY-MM-DD. Defaults to the date validated against the bundled
-         * Wrangler version used by UltraModern generated workspaces.
-         */
-        compatibilityDate?: string;
-        ssr?: boolean;
-        security?: CloudflareWorkerSecurityConfig;
-        /**
-         * Raw Wrangler-compatible config merged into `.output/wrangler.json`.
-         * Framework-owned worker invariants still win for `main`, the assets
-         * binding/directory/run mode, and required compatibility flags.
-         */
-        wrangler?: Record<string, JsonValue>;
-        /**
-         * Additional app-root files or directories to stage under `.output`.
-         * Use this for provider resources such as migrations or generated config.
-         */
-        artifacts?: CloudflareWorkerArtifactConfig[];
-        /**
-         * Additional app-root files or directories to serve as Cloudflare Worker
-         * Static Assets under `.output/public`. Use `to: '.'` to copy a
-         * source directory's contents into the public asset root.
-         */
-        publicAssets?: CloudflareWorkerPublicAssetConfig[];
-        /**
-         * First-class Cloudflare D1 bindings. Modern.js writes these to
-         * `wrangler.json` as `d1_databases` and stages configured migration
-         * directories into `.output`.
-         */
-        d1Databases?: CloudflareWorkerD1DatabaseConfig[];
-        /**
-         * First-class Cloudflare service bindings. Modern.js writes these to
-         * `wrangler.json` as `services`; when a binding also has `prefix`,
-         * the generated Worker dispatches matching requests through
-         * `env[binding].fetch(request)`.
-         */
-        services?: CloudflareWorkerServiceBindingConfig[];
-        /**
-         * Dist output paths that must not be copied into Cloudflare public assets.
-         * Entries are slash-normalized path prefixes relative to the app dist root.
-         * Top-level `api` and `shared` dist directories are excluded when matching
-         * source directories exist in the app root because they conventionally
-         * contain server-only implementation code.
-         */
-        publicAssetExcludes?: string[];
-    };
+    worker?: CloudflareWorkerDeployConfig;
 }

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

@@ -1,5 +1,5 @@
 import type { BuilderConfig } from '@modern-js/builder';
-import type { CorsOptions, SetupMiddlewares } from '@modern-js/server';
+import type { CorsOptions, SetupMiddlewares } from '@modern-js/server/config-types';
 import type { ServerConfig } from '@rsbuild/core';
 type BuilderDevConfig = NonNullable<BuilderConfig['dev']>;
 export type DevProxyOptions = string | Record<string, string>;

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

@@ -1,48 +1,24 @@
-import type { CLIPlugin, CLIPluginExtends } from '@modern-js/plugin';
-import type { BffUserConfig, ServerUserConfig } from '@modern-js/server-core';
-import type { RsbuildConfig } from '@rsbuild/core';
+import type { CLIPlugin, CLIPluginExtends } from '@modern-js/plugin/cli';
+import type { NestedRouteForCli, PageRoute } from '@modern-js/types/cli';
+import type { PluginSvgrOptions } from '@rsbuild/plugin-svgr';
+import type { ReactNode } from 'react';
 import type { AppToolsExtendAPI, AppToolsExtendContext, AppToolsExtendHooks } from '../plugin.js';
-import type { DeployUserConfig } from './deploy.js';
-import type { DevUserConfig } from './dev.js';
-import type { ExperimentsUserConfig } from './experiments.js';
-import type { HtmlUserConfig } from './html.js';
-import type { OutputUserConfig } from './output.js';
-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';
+import type { AppToolsUserConfigBase, AppToolsNormalizedConfig as BaseNormalizedConfig } from './base.js';
+declare module '@modern-js/builder/types' {
+    interface BuilderSvgOptions {
+        options: PluginSvgrOptions;
+    }
+}
+declare module './base' {
+    interface CLIElementTypes {
+        react: ReactNode;
+    }
+}
+export type { AppToolsBuilderPlugins } from './base.js';
 export * from './output.js';
-export type AppToolsBuilderPlugins = NonNullable<RsbuildConfig['plugins']>;
-export interface AppToolsUserConfig {
-    resolve?: ResolveUserConfig;
-    server?: ServerUserConfig;
-    source?: SourceUserConfig;
-    output?: OutputUserConfig;
-    experiments?: ExperimentsUserConfig;
-    /**
-     * The configuration of `bff` is provided by `bff` plugin.
-     * Please use `yarn new` or `pnpm new` to enable the corresponding capability.
-     * @requires `bff` plugin
-     */
-    bff?: BffUserConfig;
-    dev?: DevUserConfig;
-    deploy?: DeployUserConfig;
-    html?: HtmlUserConfig;
-    tools?: ToolsUserConfig;
-    security?: SecurityUserConfig;
-    testing?: TestingUserConfig;
-    builderPlugins?: AppToolsBuilderPlugins;
-    performance?: PerformanceUserConfig;
-    environments?: RsbuildConfig['environments'];
-    splitChunks?: RsbuildConfig['splitChunks'];
+export interface AppToolsUserConfig extends Omit<AppToolsUserConfigBase<NestedRouteForCli | PageRoute>, 'plugins'> {
     plugins?: CliPlugin<AppTools>[];
 }
-interface SharedNormalizedConfig<RawConfig> {
-    cliOptions?: Record<string, any>;
-    _raw: RawConfig;
-}
-export type AppToolsNormalizedConfig<Config = AppToolsUserConfig> = Required<Config> & SharedNormalizedConfig<Config>;
+export type AppToolsNormalizedConfig<Config = AppToolsUserConfig> = BaseNormalizedConfig<Config>;
 export type AppTools = Required<CLIPluginExtends<AppToolsUserConfig, AppToolsNormalizedConfig, AppToolsExtendContext, AppToolsExtendAPI, AppToolsExtendHooks>>;
 export type CliPlugin<Extends extends CLIPluginExtends> = CLIPlugin<Extends>;

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

@@ -1,5 +1,5 @@
 import type { BuilderConfig } from '@modern-js/builder';
-import type { SSGConfig, SSGMultiEntryOptions } from '@modern-js/types';
+import type { SSGConfig, SSGMultiEntryOptions } from '@modern-js/types/cli/base';
 import type { UnwrapBuilderConfig } from '../utils.js';
 export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'output'> {
     /**
@@ -33,4 +33,4 @@ export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'ou
      */
     tempDir?: string;
 }
-export type { SSGConfig, SSGMultiEntryOptions, SSGRouteOptions, SSGSingleEntryOptions, } from '@modern-js/types';
+export type { SSGConfig, SSGMultiEntryOptions, SSGRouteOptions, SSGSingleEntryOptions, } from '@modern-js/types/cli/base';

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

@@ -1,4 +1,4 @@
-import type { TestConfig } from '@modern-js/types';
+import type { TestConfig } from '@modern-js/types/cli/base';
 export interface TestingUserConfig {
     /**
      * Decide which transformer will be used to compile file

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

@@ -1,5 +1,5 @@
 import type { BuilderConfig } from '@modern-js/builder';
-import type { JestConfig } from '@modern-js/types';
+import type { JestConfig } from '@modern-js/types/cli/base';
 import type { UnwrapBuilderConfig } from '../utils.js';
 type BuilderToolsConfig = UnwrapBuilderConfig<BuilderConfig, 'tools'>;
 export interface ToolsUserConfig extends Omit<BuilderToolsConfig, 'swc'> {

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

@@ -0,0 +1,188 @@
+import type { ResolvedDeployTarget } from '@modern-js/app-tools-extensions/deploy-output/target';
+import type { AppContext, AsyncHook, CLIPluginExtends, InternalContext, PluginHook, PluginHookTap, TransformFunction } from '@modern-js/plugin/cli';
+import type { BffRuntimeFramework } from '@modern-js/plugin/server';
+import type { Entrypoint, HtmlPartials, HtmlTemplates, RouteLegacy } from '@modern-js/types/cli/base';
+import type { ServerPlugin } from '@modern-js/types/common';
+import type { HttpMethodDecider, ServerRoute } from '@modern-js/types/server';
+import type { EagerRouteComponentFilesByEntry } from '@modern-js/utils/route-component-files';
+import type { EnvironmentConfig } from '@rsbuild/core';
+export type AppToolsModuleType = 'module' | 'commonjs';
+export type AppToolsHookRunners = Record<string, any>;
+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: AppToolsModuleType;
+}
+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;
+    entry: false | string;
+}>;
+export type ModifyEntrypointsFn = TransformFunction<{
+    entrypoints: Entrypoint[];
+}>;
+export type ModifyBuilderEnvironmentsFn = TransformFunction<{
+    environments: Record<string, EnvironmentConfig>;
+}>;
+export type ModifyFileSystemRoutesFn<Routes> = TransformFunction<{
+    entrypoint: Entrypoint;
+    routes: RouteLegacy[] | Routes[];
+}>;
+export type DeplpoyFn = () => Promise<void> | void;
+export type GenerateEntryCodeFn = (params: {
+    entrypoints: Entrypoint[];
+}) => Promise<void> | void;
+export type BeforeGenerateRoutesFn = TransformFunction<{
+    entrypoint: Entrypoint;
+    code: string;
+}>;
+export type BeforePrintInstructionsFn = TransformFunction<{
+    instructions: string;
+}>;
+export type AddRuntimeExportsFn = () => Promise<void> | void;
+export interface AppToolsExtendAPIBase<Extends extends CLIPluginExtends, Routes> {
+    onAfterPrepare: PluginHookTap<AfterPrepareFn>;
+    deploy: PluginHookTap<DeplpoyFn>;
+    checkEntryPoint: PluginHookTap<CheckEntryPointFn>;
+    modifyEntrypoints: PluginHookTap<ModifyEntrypointsFn>;
+    modifyBuilderEnvironments: PluginHookTap<ModifyBuilderEnvironmentsFn>;
+    modifyFileSystemRoutes: PluginHookTap<ModifyFileSystemRoutesFn<Routes>>;
+    generateEntryCode: PluginHookTap<GenerateEntryCodeFn>;
+    onBeforeGenerateRoutes: PluginHookTap<BeforeGenerateRoutesFn>;
+    /**
+     * @deprecated
+     */
+    onBeforePrintInstructions: PluginHookTap<BeforePrintInstructionsFn>;
+    /**
+     * @deprecated use getAppContext instead
+     */
+    useAppContext: () => AppContext<Extends> & Extends['extendContext'];
+    /**
+     * @deprecated use getConfig instead
+     */
+    useConfigContext: () => Extends['config'];
+    /**
+     * @deprecated use getNormalizedConfig instead
+     */
+    useResolvedConfigContext: () => Extends['normalizedConfig'];
+    /**
+     * @deprecated use api.xx instead
+     */
+    useHookRunners: () => AppToolsHookRunners;
+}
+export interface AppToolsExtendHooksBase<Routes> 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>;
+    modifyEntrypoints: AsyncHook<ModifyEntrypointsFn>;
+    modifyBuilderEnvironments: AsyncHook<ModifyBuilderEnvironmentsFn>;
+    modifyFileSystemRoutes: AsyncHook<ModifyFileSystemRoutesFn<Routes>>;
+    generateEntryCode: AsyncHook<GenerateEntryCodeFn>;
+    onBeforeGenerateRoutes: AsyncHook<BeforeGenerateRoutesFn>;
+    /**
+     * @deprecated
+     */
+    onBeforePrintInstructions: AsyncHook<BeforePrintInstructionsFn>;
+}
+export interface AppToolsExtendContextBase<Extends extends CLIPluginExtends> {
+    metaName: string;
+    internalDirectory: string;
+    sharedDirectory: string;
+    internalDirAlias: string;
+    internalSrcAlias: string;
+    apiDirectory: string;
+    lambdaDirectory: string;
+    runtimeConfigFile: string;
+    serverPlugins: ServerPlugin[];
+    moduleType: AppToolsModuleType;
+    /** Exact generated files excluded from server compilation. */
+    serverCompileExcludedFiles?: string[];
+    /** Information for entry points */
+    entrypoints: Entrypoint[];
+    /** Selected entry points */
+    checkedEntries: string[];
+    /** Information for server routes */
+    serverRoutes: ServerRoute[];
+    /** Whether to use api only mode */
+    apiOnly: boolean;
+    deployTarget: ResolvedDeployTarget;
+    _internalContext: InternalContext<Extends>;
+    /**
+     * Information for HTML templates by entry
+     * @private
+     */
+    partialsByEntrypoint?: Record<string, HtmlPartials>;
+    /**
+     * Information for HTML templates
+     * @private
+     */
+    htmlTemplates: HtmlTemplates;
+    /**
+     * @deprecated compat old plugin, default is app tools
+     */
+    toolsType?: string;
+    /**
+     * Identification for bff runtime framework
+     * @private
+     */
+    bffRuntimeFramework?: BffRuntimeFramework;
+    /**
+     * Route component files collected from the FINAL file-system routes (after all
+     * `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated by
+     * the router plugin during route generation and consumed (currently by stream
+     * SSR lazy compilation) to force route component chunks eager.
+     *
+     * Published via the app context (`api.updateAppContext`) by the router plugin,
+     * then read fresh when assembling the builder options and threaded into
+     * `BuilderOptions.eagerRouteComponentFilesByEntry`; the SSR builder plugin
+     * reads it from those options (not from the context directly).
+     * @private
+     */
+    eagerRouteComponentFilesByEntry?: EagerRouteComponentFilesByEntry;
+}