@lcap/nasl-unified-frontend-generator 3.8.3-beta.30 → 3.8.3-beta.33-optimize

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _lcap_nasl from '@lcap/nasl';
-import { App, Frontend, LogicItem, genMetaData, FrontendVariable, TypeAnnotation, DefaultValue, Logic, BindAttribute, BindDirective, BindEvent, View, ViewElement, ValidationRule, Identifier, Return, Variable, Param, BindStyle } from '@lcap/nasl';
+import { App, Frontend, LogicItem, genMetaData, FrontendVariable, TypeAnnotation, DefaultValue, Logic, BindAttribute, BindDirective, BindEvent, BusinessComponent, View, ViewElement, ValidationRule, Identifier, Return, Variable, Param, BaseNode, BindStyle } from '@lcap/nasl';
 import { Container } from 'inversify';
 import { format } from 'prettier/standalone';
 import pino from 'pino';
@@ -39,8 +39,10 @@ interface PlatformConfig {
     basePath: string;
     sysPrefixPath: string;
     frontendName: string;
+    isPreviewFe: boolean;
 }
 interface AppConfig {
+    id: string;
     project: string;
     domainName: string;
     extendedConfig?: any;
@@ -55,6 +57,11 @@ interface AppConfig {
     tenantType: string;
     tenantLevel: string;
     documentTitle: string;
+    basePath: string;
+    sysPrefixPath: string;
+    frontendName: string;
+    rootViewData: undefined;
+    appTimeZone: string | undefined;
 }
 interface I18nInfo {
     enabled: boolean;
@@ -65,7 +72,7 @@ interface I18nInfo {
 declare const metadataPlugin: {
     name: string;
     functions: {
-        makeBasePlatformConfig(app: Pick<App, 'name' | 'dnsAddr' | 'hasUserCenter' | 'hasAuth' | 'sysPrefixPath'>, frontend: Frontend, config: CommonAppConfig): BasePlatformConfig;
+        makeBasePlatformConfig(app: Pick<App, 'name' | 'dnsAddr' | 'hasUserCenter' | 'hasAuth' | 'sysPrefixPath' | 'id' | 'appTimeZone'>, frontend: Frontend, config: CommonAppConfig): BasePlatformConfig;
     };
 };
 
@@ -89,7 +96,8 @@ type LegacyMetaData = ReturnType<typeof genMetaData>;
  * @public
  */
 type NASLAppIR = {
-    views: ComponentIR[];
+    views: ViewComponentIR[];
+    bizComponents: BizComponentIR[];
     apis: LogicIR[];
     packages: Package[];
     baseCtx: StateContextIR;
@@ -112,10 +120,6 @@ type Package = {
     kind: 'standard' | 'extension';
     name: string;
     version: string;
-    /**
-     * TODO wudengke 根据实际情况确定Css
-     */
-    hasCss?: boolean;
 };
 type IdentifierString = string & {
     readonly __tag?: unique symbol;
@@ -242,10 +246,7 @@ type BindEventIR = {
      */
     handlerName: string;
 };
-/**
- * 组件声明
- */
-type ComponentIR = {
+type BaseComponentIR = {
     /**
      * 组件名
      */
@@ -258,16 +259,41 @@ type ComponentIR = {
      * 组件的元素调用
      */
     elements: ComponentInstanceIR[];
+};
+type SubComponentIR = BaseComponentIR & {
+    kind: 'sub-component';
+};
+/**
+ * 业务组件声明
+ */
+type BizComponentIR = BaseComponentIR & {
+    kind: 'biz-component';
     /**
-     * 子页面组件声明
+     * 对原始NASL View的引用
+     * @deprecated
      */
-    childComponents: ComponentIR[];
+    __raw: BusinessComponent;
+};
+/**
+ * 组件声明
+ */
+type ViewComponentIR = BaseComponentIR & {
+    kind: 'view';
     /**
      * 对原始NASL View的引用
      * @deprecated
      */
     __raw: View;
+    /**
+     * 子页面组件声明
+     * FIXME wudengke 换更好的名字。现在页面可以是组件，子页面、元素也可以是组件
+     */
+    childComponents: ViewComponentIR[];
 };
+/**
+ * 组件声明
+ */
+type GeneralComponentIR = BizComponentIR | ViewComponentIR;
 /**
  * 被引用的库组件
  */
@@ -276,6 +302,10 @@ type ReferencedLibComponent = {
     libraryName: string;
     tag: string;
 };
+type ReferencedSubComponentIR = {
+    kind: SubComponentIR['kind'];
+    tag: string;
+};
 /**
  * 被引用的组件
  *
@@ -283,16 +313,16 @@ type ReferencedLibComponent = {
  *
  * @public
  */
-type ReferencedComponent = ReferencedLibComponent | {
+type ReferencedComponent = ReferencedSubComponentIR | ReferencedLibComponent | {
     /**
-     * 组件类型
+     * 业务组件
      */
-    kind: 'view';
+    kind: BizComponentIR['kind'];
     /**
      * 组件标签名
      */
     tag: string;
-    component: ComponentIR;
+    libraryName: string;
 };
 /**
  * 对组件声明的调用
@@ -300,6 +330,10 @@ type ReferencedComponent = ReferencedLibComponent | {
  * @public
  */
 type ComponentInstanceIR = {
+    /**
+     * 元素名字
+     */
+    name: string;
     /**
      * 持有的对组件声明的引用
      */
@@ -320,7 +354,10 @@ type ComponentInstanceIR = {
      * 组件子元素的实例
      */
     children: ComponentInstanceIR[];
-    __raw: ViewElement;
+    /**
+     * @deprecated
+     */
+    __raw?: ViewElement;
     /**
      * 插槽配置
      */
@@ -328,6 +365,7 @@ type ComponentInstanceIR = {
         target: string | undefined;
         scope: string | undefined;
     };
+    kind: 'component-instance';
 };
 
 /**
@@ -344,7 +382,6 @@ type BaseStateIR = {
     identifier: IdentifierString;
     /**
      * 状态的类型
-     * TODO wudengke 去掉 null!
      */
     typeAnnotation: TypeAnnotationIR | null;
 };
@@ -353,6 +390,10 @@ type LocalLogicStateIR = BaseStateIR & {
     initialization: {
         kind: 'static';
         value: ExprIR;
+    } | {
+        kind: 'props';
+        defaultValue?: ExprIR;
+        __raw: ParamIR;
     } | {
         kind: 'url-param';
         defaultValue?: ExprIR;
@@ -371,13 +412,22 @@ type TreeStateIR = BaseStateIR & {
         kind: 'api-client';
     };
 };
-type LocalIndividualStateIR = BaseStateIR & {
+type LocalIndividualStateIRComponentRef = {
     kind: 'standalone';
     initialization: {
         kind: 'component-ref';
         componentName: ComponentName;
     };
 };
+type LocalVariableStateIR = {
+    kind: 'standalone';
+    initialization: {
+        kind: 'variable';
+        left: string;
+        right: string;
+    };
+};
+type LocalIndividualStateIR = BaseStateIR & (LocalIndividualStateIRComponentRef | LocalVariableStateIR);
 /**
  * 状态
  */
@@ -392,11 +442,20 @@ declare class StateActionIR {
      * @example handleClick
      */
     name: string;
-    kind: 'view-lifecycle' | 'standalone';
+    kind: 'standalone'
+    /**
+     * 页面级别的生命周期
+     */
+     | 'view-lifecycle'
+    /**
+     * 端级别的生命周期
+     */
+     | 'frontend-lifecycle';
     constructor(props: StateActionIR);
 }
+declare function isLocalIndividualStateIRComponentRef(ir: StateIR): ir is LocalIndividualStateIR & LocalIndividualStateIRComponentRef;
 
-type Other = Return | Variable | Param | DefaultValue;
+type Other = Return | Variable | Param | DefaultValue | BaseNode;
 type HasRuntimeSemantics = LogicItem | Logic | Other;
 type javaScriptCodeGenCallBackBag = {
     resolve?: (payload: {
@@ -409,20 +468,25 @@ type javaScriptCodeGenCallBackBag = {
     string | undefined;
     shouldInsertOptional?: boolean;
 };
-declare function getRuntimeStr(s: HasRuntimeSemantics, callbackBag?: javaScriptCodeGenCallBackBag): string;
 type IdentifierResolver = (id: Identifier) => string | undefined;
 type IdentifierNameResolver = (id: string) => string | undefined;
 declare const javaScriptCodeGenPlugin: {
     name: string;
     functions: {
         printSyntaxNode(expr: HasRuntimeSemantics, callbackBag?: Partial<javaScriptCodeGenCallBackBag>): string;
-        printParamIR(p: ParamIR): string;
     };
 };
+/**
+ * JavaScript 代码生成插件
+ *
+ * @public
+ */
+declare class JavaScriptCodegenPlugin implements JavaScriptDomain.JavaScriptCodegen {
+    printSyntaxNode(expr: HasRuntimeSemantics, callbackBag?: Partial<javaScriptCodeGenCallBackBag>): string;
+}
 
 interface StateManager {
     resolveIdentifier: IdentifierResolver;
-    resolveName: IdentifierNameResolver;
     resolveCalleeNamespace: IdentifierNameResolver;
 }
 interface SyntaxNodePrinter<SyntaxNode> {
@@ -442,6 +506,8 @@ declare class StateContextIR {
      * @returns
      */
     static fromParent(parentCtx: StateContextIR | null): StateContextIR;
+    setParent(parentCtx: StateContextIR | null): this;
+    static create(): StateContextIR;
     provide(state: StateIR): this;
     provideAction(action: StateActionIR): this;
     findStateByName(name: string): StateIR | undefined;
@@ -453,20 +519,134 @@ type DeepReadonly<T> = {
 };
 type FinalizedStateContextIR = DeepReadonly<StateContextIR>;
 declare function paramToIR(param: Param): ParamIR;
-declare function bindAttrToIR(b: BindAttribute | {
+declare function bindAttrToIR(b: BindAttribute | (Omit<BindAttribute, 'type' | 'name' | 'rules'> & {
+    type: undefined;
+    name: 'rules';
+    rules: ValidationRule[];
+}) | {
     type: 'component';
     component: ComponentInstanceIR;
     scopeVariable: string | undefined;
     name: string;
-}): BindAttributeIR;
+}): BindAttributeIR | undefined;
 declare function logicToLogicIR(logic: Logic): LogicIR;
+declare function inferChangeEventNameFromAttrName(attrName: string): string;
 declare function bindViewElementEventToIR(b: BindEvent): BindEventIR;
 declare function bindEventToAction(b: BindEventIR): StateActionIR;
 declare const ApiClientIdentifier = "apiClient";
 declare class NASLAppIRBuilderPlugin implements NASLDomain.IRBuilder {
+    private preProcessors?;
+    private postProcessors?;
+    constructor(preProcessors?: NASLDomain.IRPreProcesser[] | undefined, postProcessors?: NASLDomain.IRPostProcesser[] | undefined);
+    private selfBuildIR;
     buildIR(app: App, frontend: Frontend, config: CommonAppConfig): NASLAppIR;
 }
 
+type JSXNode = string;
+type JSXRepr = string;
+declare function styleStringToInlineObject(staticStyle: string): Record<string, unknown>;
+declare const jsxCodeGenPlugin: {
+    name: string;
+    functions: {
+        printTag(tagName: string): JSXRepr;
+    };
+};
+
+declare const defaultErrorMessageDict: Record<string, string | undefined>;
+
+type PrettierOptions = NonNullable<Parameters<typeof format>[1]>;
+declare const codeFormatPlugin: {
+    name: string;
+    functions: {
+        format(str: string, options?: PrettierOptions): Promise<string>;
+    };
+};
+
+type RouteIR = {
+    accumulativePath: string;
+    thisLevelPath: string;
+    elementMangledName?: string;
+    elementTemplate: ViewComponentIR;
+    children?: RouteIR[];
+    authConfig?: AuthConfig;
+    kind: 'normal';
+    lazy?: boolean;
+    meta: {
+        title: string;
+        crumb: string;
+    };
+} | {
+    accumulativePath: string;
+    thisLevelPath: string;
+    redirect: string;
+    kind: 'redirect';
+};
+type AuthConfig = unknown;
+declare const routesExtractionPlugin: {
+    name: string;
+    functions: {
+        extractRoute(components: ViewComponentIR[], routePrefix: string, options?: {
+            lazy?: boolean;
+        }): {
+            routes: RouteIR[];
+            authResourcePaths: string[];
+            baseResourcePaths: string[];
+        };
+    };
+};
+
+/**
+ * 微前端插件
+ */
+declare class MicroFrontendPlugin implements JavaScriptDomain.FrontendApplicationDomain.MicroFrontendManager {
+    produceScript(frontend: Frontend): string;
+}
+
+/**
+ * 生命周期钩子插件
+ */
+declare class LifeCycleHooksPlugin implements GeneratorInfrastructureDomain.CodeGenerationLifecycleHooks {
+    protected fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider;
+    constructor(fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider);
+    afterAllFilesGenerated(): void;
+}
+
+/**
+ * 文件系统插件
+ */
+declare class FileSystemPlugin implements GeneratorInfrastructureDomain.FileSystemProvider {
+    private vol;
+    read(path: string): string | undefined;
+    write(path: string, content: string): void;
+    remove(key: string): void;
+    toJSON(): Record<string, string | null>;
+}
+
+declare class ReactPresetPlugin implements Generator.NASLTranspiler {
+    private irBuilder;
+    private microFrontendManager;
+    private fileSystemProvider;
+    private reactCodeGenerator;
+    constructor(irBuilder: NASLDomain.IRBuilder, microFrontendManager: JavaScriptDomain.FrontendApplicationDomain.MicroFrontendManager, fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider, reactCodeGenerator: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactCodegen);
+    transpile(instruction: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        baseDir: string;
+    }): Promise<OrganizedFile[]>;
+    static install(container: Container): Container;
+}
+
+/**
+ * React Slot 插件
+ * @public
+ */
+declare class ReactSlotPlugin implements NASLDomain.IRPostProcesser {
+    postProcess(ir: NASLAppIR, config: CommonAppConfig): NASLAppIR;
+    static preprocessForSlots(c: ComponentInstanceIR): void;
+    static install(c: Container): Container;
+}
+
 type Folder = {
     name: string;
 };
@@ -543,7 +723,7 @@ type ReactHook = {
  * @param c
  * @returns
  */
-declare function getComponentName(c: ComponentIR): string;
+declare function getComponentName(c: GeneralComponentIR | ComponentInstanceIR): string;
 /**
  * React 逻辑片段输出为JSX时可以控制的选项
  */
@@ -558,14 +738,22 @@ declare const ReactChildrenPropName = "children";
 /**
  * React 逻辑片段构造时可用的选项
  */
-interface ReactFragmentOption extends Partial<Pick<ComponentInstanceIR, 'slot'>> {
+type ReactFragmentOption = Partial<Pick<ComponentInstanceIR, 'slot'>> & {
     /**
      * 混淆之后的名字
      *
      * 若不传此选项则不混淆名字
      */
     mangledName?: string;
-}
+} & ({
+    kind?: 'view';
+} | {
+    kind: 'biz-component';
+    /**
+     * 业务组件参数
+     */
+    params?: Param[];
+});
 /**
  * 文件片段
  *
@@ -622,6 +810,7 @@ declare class ReactFragment implements FileFragment {
      * 状态上下文
      */
     private ctx;
+    private reactCodegenPlugin;
     /**
      * 其他控制选项
      */
@@ -646,7 +835,7 @@ declare class ReactFragment implements FileFragment {
     /**
      * 状态上下文
      */
-    ctx: StateContextIR, 
+    ctx: StateContextIR, reactCodegenPlugin: ReactCodegenPlugin, 
     /**
      * 其他控制选项
      */
@@ -662,12 +851,14 @@ declare class ReactFragment implements FileFragment {
      * @returns 若没有指定混淆后的名字，则返回原名
      */
     getMangledName(): string;
+    isIdeSlot(): boolean;
     /**
      * 转换为JSX
      * @param option - 转JSX的选项
      * @returns JSX
      */
     toJsx(option?: ToJSXOption): JSXNode;
+    genUpdateParamsHooks(): void;
     /**
      * 转换为函数组件的变量声明
      * @returns 函数组件的变量声明
@@ -680,16 +871,29 @@ declare class ReactFragment implements FileFragment {
     /**
      * 从组件声明生成React逻辑片段
      * @param c - 组件声明
-     * @returns 生成的React逻辑片段
+     * @returns 生成的React逻辑片段。至少生成一个逻辑片段
+     */
+    static fromComponentIR(c: GeneralComponentIR, reactCodegen: ReactCodegenPlugin): ReactFragment;
+    /**
+     * 启发式地将大组件拆分为若干个小组件
+     * @param c
+     * @param reactCodegen
+     * @returns
      */
-    static fromComponentIR(c: ComponentIR): ReactFragment;
+    static fromComponentIRIntoHeuristicallySplitFragments(c: GeneralComponentIR, reactCodegen: ReactCodegenPlugin, options?: {
+        /**
+         * 拆分大小
+         */
+        sizeThreshold?: number;
+    }): {
+        main: ReactFragment;
+        subs: ReactFragment[];
+    };
     /**
      * 绑定事件
      * @param b - 绑定事件的IR
      */
-    bindEvent(b: BindEventIR, options?: {
-        handlerPrefix: string;
-    }): void;
+    bindEvent(b: BindEventIR): void;
     /**
      * 将属性存入当前片段的attrMap
      *
@@ -758,158 +962,58 @@ declare class ReactFileDescription {
 /**
  * 组件声明到文件路径的映射字典
  */
-type ComponentIRToPathDict = WeakMap<ComponentIR, string>;
-declare const reactCodeGenPlugin: {
-    name: string;
-    functions: {
-        genReactFragment(c: ComponentInstanceIR, ctx: StateContextIR): ReactFragment;
-        /**
-         * 根据组件声明信息和文件夹信息生成React组件
-         * @param c - 组件声明信息
-         * @param folder - 文件夹信息
-         * @returns 生成的多个React文件
-         */
-        genReactComponent(c: ComponentIR, folder?: FolderPath): ReactFileDescription[];
-        /**
-         * 递归生成React组件的文件
-         * @param c - 组件声明
-         * @param dict - 组件声明到文件路径的映射字典
-         * @param folder - 此文件所属的父文件夹
-         * @returns 生成的React文件描述列表
-         */
-        recursivelyGenReactComponent(c: ComponentIR, dict: ComponentIRToPathDict, folder?: FolderPath): ReactFileDescription[];
-        buildRoutes(views: ComponentIR[], componentIRToPathDict: ComponentIRToPathDict): ReactFileDescription;
-        /**
-         * 构建平台配置文件
-         * @param ir - NASL应用中间表示
-         * @returns 平台配置文件描述
-         */
-        buildPlatformConfig(ir: NASLAppIR): ReactFileDescription;
-        buildInit(ir: NASLAppIR): ReactFileDescription;
-        buildMasterCss(themeCSS: string, packages: NASLAppIR['packages']): Promise<ReactFileDescription>;
-        /**
-         * 构建前端全局变量文件
-         * @param variables - 全局变量表示的列表
-         * @param baseCtx - 状态上下文
-         * @returns React文件描述
-         */
-        buildGlobalFrontendVariableFile(variables: NASLAppIR['configs']['globalVariables'], baseCtx: StateContextIR): Promise<ReactFileDescription>;
-        buildLibraryHook(packages: NASLAppIR['packages']): ReactFileDescription;
-        /**
-         * 生成布局后的React源代码文件
-         * @param ir - NASL应用中间表示
-         * @param baseDir - 基目录
-         * @returns 组织后的文件列表
-         */
-        genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
-    };
-};
-
-type JSXNode = string;
-type JSXRepr = string;
-declare function styleStringToInlineObject(staticStyle: string): Record<string, unknown>;
-declare const jsxCodeGenPlugin: {
-    name: string;
-    functions: {
-        printJSX(c: ComponentIR, option?: ToJSXOption): JSXRepr;
-        printTag(tagName: string): JSXRepr;
-    };
-};
-
-declare const defaultErrorMessageDict: Record<string, string | undefined>;
-
-type PrettierOptions = NonNullable<Parameters<typeof format>[1]>;
-declare const codeFormatPlugin: {
-    name: string;
-    functions: {
-        format(str: string, options?: PrettierOptions): Promise<string>;
-    };
-};
-
-type RouteIR = {
-    accumulativePath: string;
-    thisLevelPath: string;
-    elementMangledName?: string;
-    elementTemplate: ComponentIR;
-    children?: RouteIR[];
-    authConfig?: AuthConfig;
-    kind: 'normal';
-    lazy?: boolean;
-    meta: {
-        title: string;
-        crumb: string;
-    };
-} | {
-    accumulativePath: string;
-    thisLevelPath: string;
-    redirect: string;
-    kind: 'redirect';
-};
-type AuthConfig = unknown;
-declare const routesExtractionPlugin: {
-    name: string;
-    functions: {
-        extractRoute(components: ComponentIR[], routePrefix: string, options?: {
-            lazy?: boolean;
-        }): {
-            routes: RouteIR[];
-            authResourcePaths: string[];
-            baseResourcePaths: string[];
-        };
-    };
-};
-
+type ComponentIRToPathDict = WeakMap<GeneralComponentIR, string>;
 /**
- * 微前端插件
+ * React 代码生成插件
  */
-declare class MicroFrontendPlugin implements JavaScriptDomain.FrontendApplicationDomain.MicroFrontendManager {
-    produceScript(frontend: Frontend): string;
-}
-
-/**
- * 生命周期钩子插件
- */
-declare class LifeCycleHooksPlugin implements GeneratorInfrastructureDomain.CodeGenerationLifecycleHooks {
-    protected fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider;
-    constructor(fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider);
-    afterAllFilesGenerated(): void;
-}
-
-/**
- * 文件系统插件
- */
-declare class FileSystemPlugin implements GeneratorInfrastructureDomain.FileSystemProvider {
-    private vol;
-    read(path: string): string | undefined;
-    write(path: string, content: string): void;
-    remove(key: string): void;
-    toJSON(): Record<string, string | null>;
-}
-
-declare class ReactPresetPlugin implements Generator.NASLTranspiler {
-    private irBuilder;
-    private microFrontendManager;
-    private fileSystemProvider;
-    constructor(irBuilder: NASLDomain.IRBuilder, microFrontendManager: JavaScriptDomain.FrontendApplicationDomain.MicroFrontendManager, fileSystemProvider: GeneratorInfrastructureDomain.FileSystemProvider);
-    transpile(instruction: {
-        app: App;
-        frontend: Frontend;
-        config: CommonAppConfig;
-        baseDir: string;
-    }): Promise<OrganizedFile[]>;
+declare class ReactCodegenPlugin implements JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactCodegen {
+    javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen;
+    reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager;
+    private projectOrganizer;
+    private reactHookProviders?;
+    constructor(javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen, reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager, projectOrganizer: GeneratorInfrastructureDomain.ProjectOrganizer, reactHookProviders?: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider[] | undefined);
+    genReactFragment(c: ComponentInstanceIR, ctx: StateContextIR): ReactFragment;
+    /**
+     * 根据组件声明信息和文件夹信息生成React组件
+     * @param c - 组件声明信息
+     * @param folder - 文件夹信息
+     * @returns 生成的多个React文件
+     */
+    genReactComponent(c: GeneralComponentIR, folder?: FolderPath): ReactFileDescription[];
+    /**
+     * 递归生成React组件的文件
+     * @param c - 组件声明
+     * @param dict - 组件声明到文件路径的映射字典
+     * @param folder - 此文件所属的父文件夹
+     * @returns 生成的React文件描述列表
+     */
+    recursivelyGenReactComponent(c: GeneralComponentIR, dict: ComponentIRToPathDict, folder?: FolderPath): ReactFileDescription[];
+    buildRoutes(views: ViewComponentIR[], componentIRToPathDict: ComponentIRToPathDict): ReactFileDescription;
+    /**
+     * 构建平台配置文件
+     * @param ir - NASL应用中间表示
+     * @returns 平台配置文件描述
+     */
+    buildPlatformConfig(ir: NASLAppIR): ReactFileDescription;
+    buildInit(ir: NASLAppIR): ReactFileDescription;
+    buildMasterCss(themeCSS: string, packages: NASLAppIR['packages']): Promise<ReactFileDescription>;
+    /**
+     * 构建前端全局变量文件
+     * @param variables - 全局变量表示的列表
+     * @param baseCtx - 状态上下文
+     * @returns React文件描述
+     */
+    buildGlobalFrontendVariableFile(variables: NASLAppIR['configs']['globalVariables'], baseCtx: StateContextIR): Promise<ReactFileDescription>;
+    buildLibraryHook(packages: NASLAppIR['packages']): ReactFileDescription;
+    /**
+     * 生成布局后的React源代码文件
+     * @param ir - NASL应用中间表示
+     * @param baseDir - 基目录
+     * @returns 组织后的文件列表
+     */
+    genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
 }
 
-/**
- * React Slot 插件
- * @public
- */
-declare const reactSlotPlugin: {
-    name: string;
-    functions: {
-        preprocessForSlots(c: ComponentInstanceIR): void;
-    };
-};
-
 declare const reactComponentLibHackPlugin: {
     name: string;
     functions: {
@@ -924,13 +1028,14 @@ declare const reactComponentLibHackPlugin: {
             name: string;
         } & {
             kind: 'expr';
-        }>(ctx: StateContextIR, b: T): (BindAttributeIR & {
+        }>(b: T): BindAttributeIR & {
             kind: 'expr';
-        }) | BindEventIR;
+        };
     };
 };
 
 declare const ReactRouterDefaultViewFolderName = "__views__";
+declare const ReactRouterDefaultBizComponentsFolderName = "__bizComponents__";
 declare const reactRouterPlugin: {
     name: string;
     functions: {
@@ -942,51 +1047,60 @@ declare const reactRouterPlugin: {
     };
 };
 
-interface ReactStateManager extends StateManager {
+type TempWithCtx = (ctx: StateContextIR) => StateManager;
+declare class ReactHookBuilder {
+    static emptyHook(): ReactHook;
+    static componentRefNameToHook(refName: string): ReactHook;
+    static variableToHook(left: string, right: string): ReactHook;
+    static componentRefsObjectToHook(refNameList: string[]): ReactHook;
+}
+/**
+ * React 原生状态管理器
+ */
+declare class ReactStateManagerVanillaPlugin implements JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager {
+    reactJavaScriptCodegen: JavaScriptDomain.JavaScriptCodegen;
+    constructor(reactJavaScriptCodegen: JavaScriptDomain.JavaScriptCodegen);
+    makeTreeStateHooks(ctx: StateContextIR): ReactHook[];
+    makeLocalLogicHooks(ctx: StateContextIR): ReactHook[];
+    actionToBody(ctx: StateContextIR, action: StateActionIR, getWithCtx?: () => TempWithCtx): string;
+    makeLocalIndividualHooks(ctx: StateContextIR, getWithCtx?: () => TempWithCtx): ReactHook[];
+    initializationToExpr(ctx: StateContextIR, init: LocalLogicStateIR['initialization']): string | undefined;
     produceHooks(ctx: StateContextIR): ReactHook[];
+    /**
+     * @deprecated 用依赖注入的方法做
+     */
+    withCtx(ctx: StateContextIR): StateManager;
+    __resolveIdentifier(ctx: StateContextIR, id: Identifier): string | undefined;
+    __resolveName(ctx: StateContextIR, name: string): string | undefined;
+    __hooksDefinitions(): ReactFileDescription;
 }
-declare const reactStateManagerMobxPlugin: {
-    name: string;
-    functions: {
-        /**
-         * 根据所消费的State的信息，产生支持消费的Hooks调用
-         */
-        produceHooks(ctx: StateContextIR): ReactHook[];
-        readonly storeName: string;
-        __resolveIdentifier(ctx: StateContextIR, id: Identifier): string | undefined;
-        __resolveName(ctx: StateContextIR, name: string): string | undefined;
-        /**
-         * @deprecated 用依赖注入的方法做
-         */
-        withCtx(ctx: StateContextIR): {
-            resolveIdentifier: (id: Identifier) => string | undefined;
-            resolveName: (name: string) => string | undefined;
-            resolveCalleeNamespace: (name: string) => string | undefined;
-        };
-        __hooksDefinitions(): ReactFileDescription;
-    };
-};
 
-type TempWithCtx = (ctx: StateContextIR) => StateManager;
-declare function makeTreeStateHooks(ctx: StateContextIR): ReactHook[];
-declare const reactStateManagerVanillaPlugin: {
-    name: string;
-    functions: {
-        makeLocalLogicHooks(ctx: StateContextIR): ReactHook[];
-        actionToBody(ctx: StateContextIR, action: StateActionIR, getWithCtx?: () => TempWithCtx): string;
-        makeLocalIndividualHooks(ctx: StateContextIR, getWithCtx?: () => TempWithCtx): ReactHook[];
-        makeTreeStateHooks: typeof makeTreeStateHooks;
-        initializationToExpr(ctx: StateContextIR, init: LocalLogicStateIR['initialization']): string | undefined;
-        produceHooks(ctx: StateContextIR): ReactHook[];
-        /**
-         * @deprecated 用依赖注入的方法做
-         */
-        withCtx(ctx: StateContextIR): StateManager;
-        __resolveIdentifier(ctx: StateContextIR, id: Identifier): string | undefined;
-        __resolveName(ctx: StateContextIR, name: string): string | undefined;
-        __hooksDefinitions(): ReactFileDescription;
+/**
+ * React 原生状态管理器
+ */
+declare class ReactStateManagerMobxPlugin implements JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider {
+    private reactStateManagerVanillaPlugin;
+    constructor(reactStateManagerVanillaPlugin: ReactStateManagerVanillaPlugin);
+    makeLocalLogicBundleHook(ctx: StateContextIR): ReactHook | undefined;
+    makePublicBusinessLogicHook(ctx: StateContextIR): ReactHook[];
+    /**
+     * 根据所消费的State的信息，产生支持消费的Hooks调用
+     */
+    produceHooks(ctx: StateContextIR): ReactHook[];
+    get storeName(): string;
+    __resolveIdentifier(ctx: StateContextIR, id: Identifier): string | undefined;
+    __resolveName(ctx: StateContextIR, name: string): string | undefined;
+    /**
+     * @deprecated 用依赖注入的方法做
+     */
+    withCtx(ctx: StateContextIR): {
+        resolveIdentifier: (id: Identifier) => string | undefined;
+        resolveName: (name: string) => string | undefined;
+        resolveCalleeNamespace: (name: string) => string | undefined;
     };
-};
+    genHookDefinition(): ReactFileDescription;
+    static install(container: Container): Container;
+}
 
 /**
  *
@@ -1074,7 +1188,7 @@ declare namespace GeneratorInfrastructureDomain {
  */
 declare namespace NASLDomain {
     /**
-     * IR构建器
+     * IR构建器，负责将app根据配置转换为初步的IR
      */
     interface IRBuilder {
         /**
@@ -1087,6 +1201,22 @@ declare namespace NASLDomain {
          */
         buildIR(app: App, frontend: Frontend, config: CommonAppConfig): NASLAppIR;
     }
+    /**
+     * IR前处理器，负责对IRBuilder的输入进行前处理
+     */
+    interface IRPreProcesser {
+        preProcess(app: App, frontend: Frontend, config: CommonAppConfig): {
+            app: App;
+            frontend: Frontend;
+            config: CommonAppConfig;
+        };
+    }
+    /**
+     * IR后处理器，负责对IRBuilder生产出的IR进行后处理
+     */
+    interface IRPostProcesser {
+        postProcess(ir: NASLAppIR, config: CommonAppConfig): NASLAppIR;
+    }
     /**
      * 元信息抽取接口
      */
@@ -1125,7 +1255,7 @@ declare namespace JavaScriptDomain {
          * @param c - 组件IR
          * @param option - 生成选项
          */
-        printJSX(c: ComponentIR, option?: ToJSXOption): string;
+        printJSX(c: GeneralComponentIR, option?: ToJSXOption): string;
         /**
          * 打印简单自闭合标签
          * @param tagName - 标签名
@@ -1165,7 +1295,7 @@ declare namespace JavaScriptDomain {
          *
          * 状态管理器，也就是状态管理上下文。主要负责提供Identifier和CalleeNamespace解析为JavaScript字符串的函数
          */
-        interface StateManager {
+        interface SymbolResolver {
             /**
              * Identifier 解析函数
              */
@@ -1175,10 +1305,29 @@ declare namespace JavaScriptDomain {
              */
             resolveCalleeNamespace: IdentifierNameResolver;
         }
+        interface StateManager {
+            /**
+             * @deprecated 更名
+             * @param ctx
+             */
+            withCtx(ctx: StateContextIR): SymbolResolver;
+        }
         /**
          * React框架领域
          */
         namespace ReactDomain {
+            interface ReactJavaScriptCodegenHandler {
+                /**
+                 * 从NASL表达式生成JavaScript代码
+                 * @param expr - NASL表达式语法节点
+                 * @param callbackBag - 回调函数包
+                 * @returns JavaScript代码 或者 无法生成
+                 */
+                printBaseNode(expr: BaseNode, callbackBag?: Partial<javaScriptCodeGenCallBackBag>): string | undefined;
+            }
+            interface ReactHookProvider {
+                genHookDefinition(): ReactFileDescription;
+            }
             /**
              * React状态管理接口
              */
@@ -1204,14 +1353,14 @@ declare namespace JavaScriptDomain {
                  * @param c - 组件声明
                  * @param folder
                  */
-                genReactComponent(c: ComponentIR, folder?: FolderPath): ReactFileDescription[];
+                genReactComponent(c: GeneralComponentIR, folder?: FolderPath): ReactFileDescription[];
                 /**
                  * 构建路由文件
                  * @param views - 组件声明表示
                  * @param componentIRToPathDict - 组件
                  * @returns 路由文件
                  */
-                buildRoutes(views: ComponentIR[], componentIRToPathDict: ComponentIRToPathDict): ReactFileDescription;
+                buildRoutes(views: GeneralComponentIR[], componentIRToPathDict: ComponentIRToPathDict): ReactFileDescription;
                 /**
                  * 构建主CSS入口文件
                  * @param packages - 包信息
@@ -1319,13 +1468,23 @@ declare function translateNASLToReactApp(
 app: App, frontend: Frontend, config: CommonAppConfig, baseDir: string | undefined, container: Container): Promise<OrganizedFile[]>;
 
 declare const ServiceMetaKind: {
+    /**
+     * @deprecated
+     */
     StateManager: symbol;
+    ReactStateManager: symbol;
+    ReactHookProvider: symbol;
     CodePrinter: symbol;
+    ReactJavaScriptCodePrinter: symbol;
+    BaseNodePrinter: symbol;
     ProjectOrganizer: symbol;
     MicroFrontendManager: symbol;
     FrontendCodeGenerator: symbol;
     IRBuilder: symbol;
+    IRPostProcesser: symbol;
+    IRPreProcesser: symbol;
     NASLTranspiler: symbol;
+    ReactCodegen: symbol;
     CodeGenerationLifecycleHooks: symbol;
     FileSystemProvider: symbol;
 };
@@ -1352,4 +1511,4 @@ declare function makePlugin<Functions extends {}>({ name, functions, }: NASLPlug
 declare function deserializeAppWhileKeepTypeAnnotation(appJSON: object): App;
 declare function serializeAppWithKeepTypeAnnotation(app: App): any;
 
-export { ApiClientIdentifier, type BasePlatformConfig, type BindAttributeIR, type BindDirectiveIR, type BindEventIR, type CommonAppConfig, type ComponentIR, type ComponentIRToPathDict, type ComponentInstanceIR, type Dict, type Expr, type ExprIR, type FileFragment, FileSystemPlugin, type FinalizedStateContextIR, Generator, GeneratorInfrastructureDomain, type HasRuntimeSemantics, type IdentifierNameResolver, type IdentifierResolver, type IdentifierString, type ImportIR, type ImportIRResolver, type InputFile, type JSXNode, JavaScriptDomain, type LegacyMetaData, LifeCycleHooksPlugin, type LocalIndividualStateIR, type LocalLogicStateIR, Logger, type LogicIR, MicroFrontendPlugin, type NASLAppIR, NASLAppIRBuilderPlugin, NASLDomain, type NASLPlugin, type OrganizedFile, type Package, type ParamIR, PlacedFile, type PlatformConfig, type PrettierOptions, ProjectOrganizerPlugin, type ProjectStructureConfig, ReactChildrenPropName, ReactFileDescription, ReactFragment, type ReactHook, ReactPresetPlugin, ReactRouterDefaultViewFolderName, type ReactStateManager, type ReferencedComponent, type ReferencedLibComponent, type RouteIR, ServiceMetaKind, StateActionIR, StateContextIR, type StateIR, type StateManager, type SyntaxNodePrinter, type ToJSXOption, type TreeStateIR, type TypeAnnotationIR, VirtualProject, bindAttrToIR, bindEventToAction, bindViewElementEventToIR, codeFormatPlugin, compileAsProject, compileNASLToReactDist, defaultErrorMessageDict, deserializeAppWhileKeepTypeAnnotation, getComponentName, getRuntimeStr, type javaScriptCodeGenCallBackBag, javaScriptCodeGenPlugin, jsxCodeGenPlugin, logicToLogicIR, makeDefaultContainer, makePlugin, metadataPlugin, paramToIR, reactCodeGenPlugin, reactComponentLibHackPlugin, reactRouterPlugin, reactSlotPlugin, reactStateManagerMobxPlugin, reactStateManagerVanillaPlugin, routesExtractionPlugin, serializeAppWithKeepTypeAnnotation, styleStringToInlineObject, translateNASLToReactApp };
+export { ApiClientIdentifier, type BaseComponentIR, type BasePlatformConfig, type BindAttributeIR, type BindDirectiveIR, type BindEventIR, type BizComponentIR, type CommonAppConfig, type ComponentIRToPathDict, type ComponentInstanceIR, type Dict, type Expr, type ExprIR, type FileFragment, FileSystemPlugin, type FinalizedStateContextIR, type GeneralComponentIR, Generator, GeneratorInfrastructureDomain, type HasRuntimeSemantics, type IdentifierNameResolver, type IdentifierResolver, type IdentifierString, type ImportIR, type ImportIRResolver, type InputFile, type JSXNode, JavaScriptCodegenPlugin, JavaScriptDomain, type LegacyMetaData, LifeCycleHooksPlugin, type LocalIndividualStateIR, type LocalIndividualStateIRComponentRef, type LocalLogicStateIR, type LocalVariableStateIR, Logger, type LogicIR, MicroFrontendPlugin, type NASLAppIR, NASLAppIRBuilderPlugin, NASLDomain, type NASLPlugin, type OrganizedFile, type Package, type ParamIR, PlacedFile, type PlatformConfig, type PrettierOptions, ProjectOrganizerPlugin, type ProjectStructureConfig, ReactChildrenPropName, ReactCodegenPlugin, ReactFileDescription, ReactFragment, type ReactHook, ReactHookBuilder, ReactPresetPlugin, ReactRouterDefaultBizComponentsFolderName, ReactRouterDefaultViewFolderName, ReactSlotPlugin, ReactStateManagerMobxPlugin, ReactStateManagerVanillaPlugin, type ReferencedComponent, type ReferencedLibComponent, type ReferencedSubComponentIR, type RouteIR, ServiceMetaKind, StateActionIR, StateContextIR, type StateIR, type StateManager, type SubComponentIR, type SyntaxNodePrinter, type ToJSXOption, type TreeStateIR, type TypeAnnotationIR, type ViewComponentIR, VirtualProject, bindAttrToIR, bindEventToAction, bindViewElementEventToIR, codeFormatPlugin, compileAsProject, compileNASLToReactDist, defaultErrorMessageDict, deserializeAppWhileKeepTypeAnnotation, getComponentName, inferChangeEventNameFromAttrName, isLocalIndividualStateIRComponentRef, type javaScriptCodeGenCallBackBag, javaScriptCodeGenPlugin, jsxCodeGenPlugin, logicToLogicIR, makeDefaultContainer, makePlugin, metadataPlugin, paramToIR, reactComponentLibHackPlugin, reactRouterPlugin, routesExtractionPlugin, serializeAppWithKeepTypeAnnotation, styleStringToInlineObject, translateNASLToReactApp };