@lcap/nasl-unified-frontend-generator 4.1.0-beta.2 → 4.1.0-beta.20

package/dist/index.d.mts

@@ -28,6 +28,7 @@ interface CommonAppConfig {
     isExport?: boolean;
     needCompileViews?: string[];
     cacheChunksMapCode?: string;
+    feLoadDependenciesOnDemand?: boolean;
     /**
      * 插件用的配置项
      */
@@ -172,6 +173,10 @@ type Package = {
     name: string;
     version: string;
     hasCss?: boolean;
+    /**
+     * 是否被应用使用
+     */
+    used?: boolean;
 };
 type IdentifierString = string & {
     readonly __tag?: unique symbol;
@@ -582,7 +587,7 @@ declare function bindAttrToIR(b: BindAttribute | (Omit<BindAttribute, 'type' | '
     scopeVariable: string | undefined;
     name: string;
 }): BindAttributeIR | undefined;
-declare function logicToLogicIR(logic: Logic): LogicIR;
+declare function logicToLogicIR(logic: any): LogicIR;
 declare function inferChangeEventNameFromAttrName(attrName: string): string;
 declare function bindViewElementEventToIR(b: BindEvent): BindEventIR;
 declare function bindEventToAction(b: BindEventIR): StateActionIR;
@@ -691,16 +696,18 @@ declare class FileSystemPlugin implements GeneratorInfrastructureDomain.FileSyst
 
 type AnalyzerOptions = {
     asyncAnalysis?: boolean;
+    depAnalysis?: boolean;
 };
 type AnalyzerManager = {
     setOptions(options: AnalyzerOptions): void;
 };
-declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPreProcesser {
+declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPreProcesser, NASLDomain.IRPostProcesser {
     preProcess(app: App, frontend: Frontend, config: CommonAppConfig): {
         app: App;
         frontend: Frontend;
         config: CommonAppConfig;
     };
+    postProcess(ir: NASLAppIR, config: CommonAppConfig): NASLAppIR;
     private options;
     /**
      * 设置完整的分析选项
@@ -712,7 +719,7 @@ declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPre
      * @returns 分析选项
      */
     getOptions(): AnalyzerOptions;
-    static install(c: Container): void;
+    static install(c: Container): Container;
 }
 
 declare class NameManglerManagerPlugin implements NASLDomain.IRPreProcesser {
@@ -754,6 +761,7 @@ declare class ReactPresetPlugin implements Generator.NASLTranspiler {
         frontend: Frontend;
         config: CommonAppConfig;
         baseDir: string;
+        fs: GeneratorInfrastructureDomain.FileSystemProvider;
     }): Promise<OrganizedFile[]>;
     static install(container: Container): Container;
 }
@@ -793,6 +801,85 @@ type Folder = {
 };
 type FolderPath = [Folder] | [Folder, ...Folder[]];
 
+type CompilerConfigOptions = Partial<{
+    backendUrl: string;
+    publicPath: string;
+    aliasMapStr: string;
+}>;
+/**
+ * 前端打包器配置插件
+ * 将 backendUrl aliasMapStr publicPath 等动态信息保存到 FrontendBundlerConfigPlugin 插件中
+ */
+declare class FrontendBundlerConfigPlugin {
+    private compilerConfig;
+    setCompilerConfig(config: CompilerConfigOptions): void;
+    getCompilerConfig(): {
+        backendUrl: string;
+        publicPath: string;
+        aliasMapStr: string;
+    };
+    static install(c: Container): Container;
+}
+
+type FS$2 = GeneratorInfrastructureDomain.FileSystemProvider;
+declare class BundlerConfigDataPlugin {
+    private frontendBundlerConfigPlugin;
+    constructor(frontendBundlerConfigPlugin: FrontendBundlerConfigPlugin);
+    getBundlerConfigData(app: App, frontend: Frontend, config: CommonAppConfig, fs: FS$2, frameworkKind: 'vue3' | 'react' | 'vue2'): Promise<{
+        backendUrl: string;
+        publicPath: string;
+        aliasMapStr: string;
+        dependenciesStr: string | undefined;
+    }>;
+    static install(c: Container): Container;
+}
+
+type PerformanceOptions = Partial<{
+    lazy: boolean;
+    chunks: 'initial' | 'all' | 'async';
+}>;
+/**
+ * 前端制品调优插件
+ * 用于外部调用来设置前端页面打包器的性能优化参数，例如页面懒加载 lazy，以及分包策略 chunks 等
+ */
+declare class FrontendPerformancePlugin {
+    performanceOptions: {
+        lazy: boolean;
+        chunks: string;
+    };
+    setOptions(options: PerformanceOptions): void;
+    static install(c: Container): Container;
+}
+
+type FS$1 = GeneratorInfrastructureDomain.FileSystemProvider;
+declare class RspackConfigPlugin {
+    private bundlerConfigDataPlugin;
+    private frontendPerformancePlugin;
+    constructor(bundlerConfigDataPlugin: BundlerConfigDataPlugin, frontendPerformancePlugin: FrontendPerformancePlugin);
+    configBundlerConfig(instruction: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        fs: FS$1;
+        frameworkKind: 'vue3' | 'react' | 'vue2';
+    }): Promise<ReactFileDescription>;
+    /**
+     * 处理按需加载
+     * 注意：此功能仅在非dev环境下的vue3框架中可以启用。
+     * @param source 源代码
+     * @param options 选项
+     * @returns 处理后的代码
+     */
+    processLoadOnDemand(source: string, options: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        fs: FS$1;
+        frameworkKind: 'vue3' | 'react' | 'vue2';
+    }): Promise<string>;
+    static install(c: Container): Container;
+}
+
 /**
  * 各类React Hooks
  */
@@ -1123,8 +1210,9 @@ declare class ReactCodegenPlugin implements JavaScriptDomain.FrontendApplication
     frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance;
     private projectOrganizer;
     private entrypointManager;
+    private rspackConfigPlugin;
     private reactHookProviders?;
-    constructor(javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen, reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager, frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance, projectOrganizer: GeneratorInfrastructureDomain.ProjectOrganizer, entrypointManager: JavaScriptDomain.FrontendApplicationDomain.EntrypointManager, reactHookProviders?: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider[] | undefined);
+    constructor(javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen, reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager, frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance, projectOrganizer: GeneratorInfrastructureDomain.ProjectOrganizer, entrypointManager: JavaScriptDomain.FrontendApplicationDomain.EntrypointManager, rspackConfigPlugin: RspackConfigPlugin, reactHookProviders?: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider[] | undefined);
     genReactFragment(c: ComponentInstanceIR, ctx: StateContextIR): ReactFragment;
     /**
      * 根据组件声明信息和文件夹信息生成React组件
@@ -1165,7 +1253,13 @@ declare class ReactCodegenPlugin implements JavaScriptDomain.FrontendApplication
      * @param baseDir - 基目录
      * @returns 组织后的文件列表
      */
-    genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
+    genFiles(ir: NASLAppIR, instruction: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        baseDir: string;
+        fs: GeneratorInfrastructureDomain.FileSystemProvider;
+    }): Promise<OrganizedFile[]>;
 }
 
 declare const reactComponentLibHackPlugin: {
@@ -1262,17 +1356,6 @@ declare class ReactStateManagerMobxPlugin implements JavaScriptDomain.FrontendAp
     static install(container: Container): Container;
 }
 
-type PerformanceOptions = Partial<{
-    lazy: boolean;
-    chunks: 'initial' | 'all' | 'async';
-}>;
-
-type CompilerConfigOptions = Partial<{
-    backendUrl: string;
-    publicPath: string;
-    aliasMapStr: string;
-}>;
-
 /**
  *
  */
@@ -1291,6 +1374,7 @@ declare namespace Generator {
             frontend: Frontend;
             config: CommonAppConfig;
             baseDir: string;
+            fs: GeneratorInfrastructureDomain.FileSystemProvider;
         }): Promise<OrganizedFile[]>;
     }
 }
@@ -1599,7 +1683,13 @@ declare namespace JavaScriptDomain {
                  * @param ir - NASL应用IR
                  * @param baseDir - 项目根目录
                  */
-                genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
+                genFiles(ir: NASLAppIR, instruction: {
+                    app: App;
+                    frontend: Frontend;
+                    config: CommonAppConfig;
+                    baseDir: string;
+                    fs: GeneratorInfrastructureDomain.FileSystemProvider;
+                }): Promise<OrganizedFile[]>;
             }
             /**
              * React路由接口

package/dist/index.d.ts

@@ -28,6 +28,7 @@ interface CommonAppConfig {
     isExport?: boolean;
     needCompileViews?: string[];
     cacheChunksMapCode?: string;
+    feLoadDependenciesOnDemand?: boolean;
     /**
      * 插件用的配置项
      */
@@ -172,6 +173,10 @@ type Package = {
     name: string;
     version: string;
     hasCss?: boolean;
+    /**
+     * 是否被应用使用
+     */
+    used?: boolean;
 };
 type IdentifierString = string & {
     readonly __tag?: unique symbol;
@@ -582,7 +587,7 @@ declare function bindAttrToIR(b: BindAttribute | (Omit<BindAttribute, 'type' | '
     scopeVariable: string | undefined;
     name: string;
 }): BindAttributeIR | undefined;
-declare function logicToLogicIR(logic: Logic): LogicIR;
+declare function logicToLogicIR(logic: any): LogicIR;
 declare function inferChangeEventNameFromAttrName(attrName: string): string;
 declare function bindViewElementEventToIR(b: BindEvent): BindEventIR;
 declare function bindEventToAction(b: BindEventIR): StateActionIR;
@@ -691,16 +696,18 @@ declare class FileSystemPlugin implements GeneratorInfrastructureDomain.FileSyst
 
 type AnalyzerOptions = {
     asyncAnalysis?: boolean;
+    depAnalysis?: boolean;
 };
 type AnalyzerManager = {
     setOptions(options: AnalyzerOptions): void;
 };
-declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPreProcesser {
+declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPreProcesser, NASLDomain.IRPostProcesser {
     preProcess(app: App, frontend: Frontend, config: CommonAppConfig): {
         app: App;
         frontend: Frontend;
         config: CommonAppConfig;
     };
+    postProcess(ir: NASLAppIR, config: CommonAppConfig): NASLAppIR;
     private options;
     /**
      * 设置完整的分析选项
@@ -712,7 +719,7 @@ declare class AnalyzerManagerPlugin implements AnalyzerManager, NASLDomain.IRPre
      * @returns 分析选项
      */
     getOptions(): AnalyzerOptions;
-    static install(c: Container): void;
+    static install(c: Container): Container;
 }
 
 declare class NameManglerManagerPlugin implements NASLDomain.IRPreProcesser {
@@ -754,6 +761,7 @@ declare class ReactPresetPlugin implements Generator.NASLTranspiler {
         frontend: Frontend;
         config: CommonAppConfig;
         baseDir: string;
+        fs: GeneratorInfrastructureDomain.FileSystemProvider;
     }): Promise<OrganizedFile[]>;
     static install(container: Container): Container;
 }
@@ -793,6 +801,85 @@ type Folder = {
 };
 type FolderPath = [Folder] | [Folder, ...Folder[]];
 
+type CompilerConfigOptions = Partial<{
+    backendUrl: string;
+    publicPath: string;
+    aliasMapStr: string;
+}>;
+/**
+ * 前端打包器配置插件
+ * 将 backendUrl aliasMapStr publicPath 等动态信息保存到 FrontendBundlerConfigPlugin 插件中
+ */
+declare class FrontendBundlerConfigPlugin {
+    private compilerConfig;
+    setCompilerConfig(config: CompilerConfigOptions): void;
+    getCompilerConfig(): {
+        backendUrl: string;
+        publicPath: string;
+        aliasMapStr: string;
+    };
+    static install(c: Container): Container;
+}
+
+type FS$2 = GeneratorInfrastructureDomain.FileSystemProvider;
+declare class BundlerConfigDataPlugin {
+    private frontendBundlerConfigPlugin;
+    constructor(frontendBundlerConfigPlugin: FrontendBundlerConfigPlugin);
+    getBundlerConfigData(app: App, frontend: Frontend, config: CommonAppConfig, fs: FS$2, frameworkKind: 'vue3' | 'react' | 'vue2'): Promise<{
+        backendUrl: string;
+        publicPath: string;
+        aliasMapStr: string;
+        dependenciesStr: string | undefined;
+    }>;
+    static install(c: Container): Container;
+}
+
+type PerformanceOptions = Partial<{
+    lazy: boolean;
+    chunks: 'initial' | 'all' | 'async';
+}>;
+/**
+ * 前端制品调优插件
+ * 用于外部调用来设置前端页面打包器的性能优化参数，例如页面懒加载 lazy，以及分包策略 chunks 等
+ */
+declare class FrontendPerformancePlugin {
+    performanceOptions: {
+        lazy: boolean;
+        chunks: string;
+    };
+    setOptions(options: PerformanceOptions): void;
+    static install(c: Container): Container;
+}
+
+type FS$1 = GeneratorInfrastructureDomain.FileSystemProvider;
+declare class RspackConfigPlugin {
+    private bundlerConfigDataPlugin;
+    private frontendPerformancePlugin;
+    constructor(bundlerConfigDataPlugin: BundlerConfigDataPlugin, frontendPerformancePlugin: FrontendPerformancePlugin);
+    configBundlerConfig(instruction: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        fs: FS$1;
+        frameworkKind: 'vue3' | 'react' | 'vue2';
+    }): Promise<ReactFileDescription>;
+    /**
+     * 处理按需加载
+     * 注意：此功能仅在非dev环境下的vue3框架中可以启用。
+     * @param source 源代码
+     * @param options 选项
+     * @returns 处理后的代码
+     */
+    processLoadOnDemand(source: string, options: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        fs: FS$1;
+        frameworkKind: 'vue3' | 'react' | 'vue2';
+    }): Promise<string>;
+    static install(c: Container): Container;
+}
+
 /**
  * 各类React Hooks
  */
@@ -1123,8 +1210,9 @@ declare class ReactCodegenPlugin implements JavaScriptDomain.FrontendApplication
     frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance;
     private projectOrganizer;
     private entrypointManager;
+    private rspackConfigPlugin;
     private reactHookProviders?;
-    constructor(javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen, reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager, frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance, projectOrganizer: GeneratorInfrastructureDomain.ProjectOrganizer, entrypointManager: JavaScriptDomain.FrontendApplicationDomain.EntrypointManager, reactHookProviders?: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider[] | undefined);
+    constructor(javaScriptCodegen: JavaScriptDomain.JavaScriptCodegen, reactStateManager: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactStateManager, frontendPerformance: JavaScriptDomain.FrontendApplicationDomain.FrontendPerformance, projectOrganizer: GeneratorInfrastructureDomain.ProjectOrganizer, entrypointManager: JavaScriptDomain.FrontendApplicationDomain.EntrypointManager, rspackConfigPlugin: RspackConfigPlugin, reactHookProviders?: JavaScriptDomain.FrontendApplicationDomain.ReactDomain.ReactHookProvider[] | undefined);
     genReactFragment(c: ComponentInstanceIR, ctx: StateContextIR): ReactFragment;
     /**
      * 根据组件声明信息和文件夹信息生成React组件
@@ -1165,7 +1253,13 @@ declare class ReactCodegenPlugin implements JavaScriptDomain.FrontendApplication
      * @param baseDir - 基目录
      * @returns 组织后的文件列表
      */
-    genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
+    genFiles(ir: NASLAppIR, instruction: {
+        app: App;
+        frontend: Frontend;
+        config: CommonAppConfig;
+        baseDir: string;
+        fs: GeneratorInfrastructureDomain.FileSystemProvider;
+    }): Promise<OrganizedFile[]>;
 }
 
 declare const reactComponentLibHackPlugin: {
@@ -1262,17 +1356,6 @@ declare class ReactStateManagerMobxPlugin implements JavaScriptDomain.FrontendAp
     static install(container: Container): Container;
 }
 
-type PerformanceOptions = Partial<{
-    lazy: boolean;
-    chunks: 'initial' | 'all' | 'async';
-}>;
-
-type CompilerConfigOptions = Partial<{
-    backendUrl: string;
-    publicPath: string;
-    aliasMapStr: string;
-}>;
-
 /**
  *
  */
@@ -1291,6 +1374,7 @@ declare namespace Generator {
             frontend: Frontend;
             config: CommonAppConfig;
             baseDir: string;
+            fs: GeneratorInfrastructureDomain.FileSystemProvider;
         }): Promise<OrganizedFile[]>;
     }
 }
@@ -1599,7 +1683,13 @@ declare namespace JavaScriptDomain {
                  * @param ir - NASL应用IR
                  * @param baseDir - 项目根目录
                  */
-                genFiles(ir: NASLAppIR, baseDir: string): Promise<OrganizedFile[]>;
+                genFiles(ir: NASLAppIR, instruction: {
+                    app: App;
+                    frontend: Frontend;
+                    config: CommonAppConfig;
+                    baseDir: string;
+                    fs: GeneratorInfrastructureDomain.FileSystemProvider;
+                }): Promise<OrganizedFile[]>;
             }
             /**
              * React路由接口