flu-cli-core 1.0.4 → 1.0.5

package/dist/index.d.cts

@@ -101,6 +101,31 @@ declare function loadProjectSnippets(projectDir: string): any;
 declare function renderSnippet(bodyLines: string[] | string, variables: Record<string, any>): string;
 declare function getSnippetContent(projectDir: string, key: string, variables: Record<string, any>): string | null;
 
+type GeneratorType = 'page' | 'viewModel' | 'widget' | 'component' | 'model' | 'service';
+interface ResolveGeneratorDirOptions {
+    projectRoot: string;
+    type: GeneratorType;
+    feature?: string | null;
+    name?: string;
+    clickedPath?: string | null;
+}
+interface MirrorDirOptions {
+    sourceBaseDir: string;
+    sourceTargetDir: string;
+    targetBaseDir: string;
+}
+interface ResolveImportOptions {
+    configuredImport?: string | null;
+    fromFile: string;
+    projectRoot: string;
+    fallbackImport?: string | null;
+}
+declare function resolveGeneratorBaseDir(options: ResolveGeneratorDirOptions): string;
+declare function resolveGeneratorTargetDir(options: ResolveGeneratorDirOptions): string;
+declare function mirrorNestedTargetDir(options: MirrorDirOptions): string;
+declare function resolveConfiguredImport(options: ResolveImportOptions): string | null;
+declare function calculateRelativeImport(fromFile: string, toFile: string): string;
+
 /**
  * 模板生成器
  * 负责生成各种类型的代码内容，供 Generator 和 Snippets 复用
@@ -134,6 +159,19 @@ declare class TemplateGenerator {
         baseClass?: string;
         extraImports?: string[];
     }): string;
+    static generateListViewModel(namePascal: string, modelName: string, options?: {
+        coreImportPath?: string;
+        modelImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+    }): string;
+    static generateListPageWithBase(namePascal: string, nameTitle: string, modelName: string, options?: {
+        vmImportPath?: string;
+        modelImportPath?: string;
+        coreImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+    }): string;
     /**
      * 生成 Service
      */
@@ -170,6 +208,13 @@ declare class TemplateGenerator {
  * @param {string} fileName - 要添加的文件名
  */
 declare function updateIndexFile(dirPath: string, fileName: string): boolean;
+/**
+ * 为嵌套目录级联更新 index.dart
+ * 例如:
+ * - pages/test/test_page.dart -> pages/test/index.dart export 'test_page.dart'
+ * - pages/index.dart -> export 'test/index.dart'
+ */
+declare function updateNestedIndexExports(rootDir: string, targetDir: string, fileName: string): boolean;
 
 declare function getTemplatesRootDir(): string;
 declare function getCoreFilesDir(): string;
@@ -352,6 +397,7 @@ interface ProjectOptions {
     packageName: string;
     outputDir: string;
     includeNetworkLayer?: boolean;
+    createProjectConfig?: boolean;
 }
 /**
  * ProjectGenerator (V6.0)
@@ -375,21 +421,29 @@ declare class ProjectGenerator {
  * 项目配置管理器
  * 职责：读取和管理项目级别的 .flu-cli.json 配置文件
  */
+type ArchitectureMode = 'inherit' | 'mixin';
+interface ArchitectureConfig {
+    mode?: ArchitectureMode;
+}
 /**
  * 生成器配置接口
  */
 interface GeneratorConfig {
     path?: string;
+    allowSubDir?: boolean;
     defaultType?: 'stateful' | 'stateless';
     fileSuffix?: string;
     fileName?: string;
+    policy?: GeneratorFieldPolicy;
     withBasePage?: boolean;
     basePageClass?: string;
+    baseListPageClass?: string;
     basePageImport?: string;
     withViewModel?: boolean;
     viewModelPath?: string;
     withBaseViewModel?: boolean;
     baseViewModelClass?: string;
+    baseListViewModelClass?: string;
     baseViewModelImport?: string;
     withBaseWidget?: boolean;
     baseWidgetClass?: string;
@@ -400,12 +454,18 @@ interface GeneratorConfig {
     template?: 'network' | 'simple' | 'auto' | string;
     snippetKey?: string;
     mockLevel?: 'global' | 'instance';
+    baseServiceClass?: string;
+    baseServiceImport?: string;
+    mixins?: string[];
+    mixinImports?: string[];
+    serviceConstructor?: 'const' | 'normal';
 }
 /**
  * 项目配置接口
  */
 interface ProjectConfig {
     template?: 'lite' | 'modular' | 'clean' | string;
+    architecture?: ArchitectureConfig;
     packageName?: string;
     generators?: {
         page?: GeneratorConfig;
@@ -419,6 +479,16 @@ interface ProjectConfig {
         };
     };
 }
+type ProjectConfigSource = 'disk' | 'inferred' | 'builtin';
+type GeneratorPolicyMode = 'locked' | 'default';
+type GeneratorFieldPolicy = Partial<Record<string, GeneratorPolicyMode>>;
+interface ResolvedProjectConfig {
+    source: ProjectConfigSource;
+    config: ProjectConfig;
+    diagnostics: string[];
+    hasDiskConfig: boolean;
+}
+type GeneratorConfigType = 'page' | 'viewModel' | 'widget' | 'model' | 'component' | 'service';
 /**
  * 项目配置管理器
  */
@@ -436,20 +506,33 @@ declare class ProjectConfigManager {
      * @returns 是否存在配置文件
      */
     static hasConfig(projectDir: string): boolean;
+    /**
+     * 解析运行时生效配置。
+     * 即使项目没有真实 .flu-cli.json，也会基于目录结构和内置默认值得到一份权威配置。
+     */
+    static resolveEffectiveConfig(projectDir: string): ResolvedProjectConfig;
     /**
      * 获取指定生成器的配置
      * @param projectDir 项目目录
      * @param generatorType 生成器类型
      * @returns 生成器配置，如果不存在则返回 null
      */
-    static getGeneratorConfig(projectDir: string, generatorType: 'page' | 'viewModel' | 'widget' | 'model' | 'component' | 'service'): GeneratorConfig | null;
+    static getGeneratorConfig(projectDir: string, generatorType: GeneratorConfigType): GeneratorConfig | null;
+    /**
+     * 仅根据目录结构推断模板类型。
+     */
+    static inferTemplateFromStructure(projectDir: string): 'lite' | 'modular' | 'clean' | null;
     /**
      * 获取默认配置模板
      * @param templateType 模板类型
      * @returns 配置模板对象
      */
     static getDefaultConfigTemplate(templateType: 'lite' | 'modular' | 'clean' | 'custom' | string): ProjectConfig;
+    private static readPackageName;
 }
+declare function getArchitectureMode(config?: ProjectConfig | null): ArchitectureMode;
+declare function getGeneratorFieldPolicy(config: ProjectConfig | null | undefined, generatorType: GeneratorConfigType, field: string): GeneratorPolicyMode | null;
+declare function isGeneratorFieldLocked(config: ProjectConfig | null | undefined, generatorType: GeneratorConfigType, field: string): boolean;
 
 /**
  * 应用资源选择接口
@@ -619,7 +702,7 @@ declare function checkFlutterInstalled(): Promise<boolean>;
  */
 declare function getFlutterVersion(): Promise<string | null>;
 
-type BuildPlatform = 'android' | 'ios';
+type BuildPlatform = 'android' | 'ios' | 'harmony';
 declare class BuildManager {
     static build(platform: BuildPlatform, buildConfig: NonNullable<UploadConfig['build']>, projectDir?: string): Promise<BuildResult>;
 }
@@ -666,12 +749,6 @@ declare class AndroidBuilder {
      * @param projectDir 项目目录
      */
     static build(config: NonNullable<UploadConfig['build']>['android'], projectDir?: string): Promise<BuildResult>;
-    /**
-     * 查找构建产物
-     * @param projectDir 项目目录
-     * @param type 类型 (apk/appbundle)
-     * @param flavor 风味
-     */
     private static findArtifact;
 }
 
@@ -702,4 +779,4 @@ declare function fixAndroidPackageName(projectDir: string, packageName: string,
  */
 declare function fixIosBundleIdentifier(projectDir: string, bundleId: string, logger?: Logger): Promise<void>;
 
-export { AndroidBuilder, type AppAssetConfig, AppAssetsManager, BUILTIN_TEMPLATES, BuildManager, ConfigManager, ConsoleLogger, type CustomTemplate, type FluConfig, type GeneratorConfig, I18nManager, IOSBuilder, type Logger, type ProjectConfig, ProjectConfigManager, ProjectContextService, ProjectGenerator, type ProjectOptions, type ProjectPreset, type ProjectTemplate, TemplateGenerator, TemplateManager, TemplatePresetService, type TemplateType, checkFlutterInstalled, checkSnippetsVersion, cleanupTemplateFiles, copyCoreFiles, copyCustomTemplate, copyInfrastructure, copyNetworkFiles, copyTemplate, detectProjectTemplate, ensurePubspecName, fixAndroidPackageName, fixIosBundleIdentifier, generateComponent, generateIndexFile, generateModel, generateModule, generatePage, generateService, generateViewModel, generateWidget, getCoreFilesDir, getFlutterVersion, getModelPath, getNetworkDir, getPagePath, getRelativeImportPath, getServicePath, getSnippetContent, getStateManager, getTemplatesRootDir, getViewModelPath, getWidgetPath, injectNetworkExamples, isCustomTemplateProject, loadProjectSnippets, logger, removeTemplateSuffix, renderSnippet, replaceVariables, runFlutterCreate, runFlutterPubGet, t, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, updateIndexFile, upgradeSnippets };
+export { AndroidBuilder, type AppAssetConfig, AppAssetsManager, type ArchitectureConfig, type ArchitectureMode, BUILTIN_TEMPLATES, BuildManager, ConfigManager, ConsoleLogger, type CustomTemplate, type FluConfig, type GeneratorConfig, type GeneratorConfigType, type GeneratorFieldPolicy, type GeneratorPolicyMode, type GeneratorType, I18nManager, IOSBuilder, type Logger, type ProjectConfig, ProjectConfigManager, type ProjectConfigSource, ProjectContextService, ProjectGenerator, type ProjectOptions, type ProjectPreset, type ProjectTemplate, type ResolvedProjectConfig, TemplateGenerator, TemplateManager, TemplatePresetService, type TemplateType, calculateRelativeImport, checkFlutterInstalled, checkSnippetsVersion, cleanupTemplateFiles, copyCoreFiles, copyCustomTemplate, copyInfrastructure, copyNetworkFiles, copyTemplate, detectProjectTemplate, ensurePubspecName, fixAndroidPackageName, fixIosBundleIdentifier, generateComponent, generateIndexFile, generateModel, generateModule, generatePage, generateService, generateViewModel, generateWidget, getArchitectureMode, getCoreFilesDir, getFlutterVersion, getGeneratorFieldPolicy, getModelPath, getNetworkDir, getPagePath, getRelativeImportPath, getServicePath, getSnippetContent, getStateManager, getTemplatesRootDir, getViewModelPath, getWidgetPath, injectNetworkExamples, isCustomTemplateProject, isGeneratorFieldLocked, loadProjectSnippets, logger, mirrorNestedTargetDir, removeTemplateSuffix, renderSnippet, replaceVariables, resolveConfiguredImport, resolveGeneratorBaseDir, resolveGeneratorTargetDir, runFlutterCreate, runFlutterPubGet, t, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, updateIndexFile, updateNestedIndexExports, upgradeSnippets };

package/dist/index.d.ts

@@ -101,6 +101,31 @@ declare function loadProjectSnippets(projectDir: string): any;
 declare function renderSnippet(bodyLines: string[] | string, variables: Record<string, any>): string;
 declare function getSnippetContent(projectDir: string, key: string, variables: Record<string, any>): string | null;
 
+type GeneratorType = 'page' | 'viewModel' | 'widget' | 'component' | 'model' | 'service';
+interface ResolveGeneratorDirOptions {
+    projectRoot: string;
+    type: GeneratorType;
+    feature?: string | null;
+    name?: string;
+    clickedPath?: string | null;
+}
+interface MirrorDirOptions {
+    sourceBaseDir: string;
+    sourceTargetDir: string;
+    targetBaseDir: string;
+}
+interface ResolveImportOptions {
+    configuredImport?: string | null;
+    fromFile: string;
+    projectRoot: string;
+    fallbackImport?: string | null;
+}
+declare function resolveGeneratorBaseDir(options: ResolveGeneratorDirOptions): string;
+declare function resolveGeneratorTargetDir(options: ResolveGeneratorDirOptions): string;
+declare function mirrorNestedTargetDir(options: MirrorDirOptions): string;
+declare function resolveConfiguredImport(options: ResolveImportOptions): string | null;
+declare function calculateRelativeImport(fromFile: string, toFile: string): string;
+
 /**
  * 模板生成器
  * 负责生成各种类型的代码内容，供 Generator 和 Snippets 复用
@@ -134,6 +159,19 @@ declare class TemplateGenerator {
         baseClass?: string;
         extraImports?: string[];
     }): string;
+    static generateListViewModel(namePascal: string, modelName: string, options?: {
+        coreImportPath?: string;
+        modelImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+    }): string;
+    static generateListPageWithBase(namePascal: string, nameTitle: string, modelName: string, options?: {
+        vmImportPath?: string;
+        modelImportPath?: string;
+        coreImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+    }): string;
     /**
      * 生成 Service
      */
@@ -170,6 +208,13 @@ declare class TemplateGenerator {
  * @param {string} fileName - 要添加的文件名
  */
 declare function updateIndexFile(dirPath: string, fileName: string): boolean;
+/**
+ * 为嵌套目录级联更新 index.dart
+ * 例如:
+ * - pages/test/test_page.dart -> pages/test/index.dart export 'test_page.dart'
+ * - pages/index.dart -> export 'test/index.dart'
+ */
+declare function updateNestedIndexExports(rootDir: string, targetDir: string, fileName: string): boolean;
 
 declare function getTemplatesRootDir(): string;
 declare function getCoreFilesDir(): string;
@@ -352,6 +397,7 @@ interface ProjectOptions {
     packageName: string;
     outputDir: string;
     includeNetworkLayer?: boolean;
+    createProjectConfig?: boolean;
 }
 /**
  * ProjectGenerator (V6.0)
@@ -375,21 +421,29 @@ declare class ProjectGenerator {
  * 项目配置管理器
  * 职责：读取和管理项目级别的 .flu-cli.json 配置文件
  */
+type ArchitectureMode = 'inherit' | 'mixin';
+interface ArchitectureConfig {
+    mode?: ArchitectureMode;
+}
 /**
  * 生成器配置接口
  */
 interface GeneratorConfig {
     path?: string;
+    allowSubDir?: boolean;
     defaultType?: 'stateful' | 'stateless';
     fileSuffix?: string;
     fileName?: string;
+    policy?: GeneratorFieldPolicy;
     withBasePage?: boolean;
     basePageClass?: string;
+    baseListPageClass?: string;
     basePageImport?: string;
     withViewModel?: boolean;
     viewModelPath?: string;
     withBaseViewModel?: boolean;
     baseViewModelClass?: string;
+    baseListViewModelClass?: string;
     baseViewModelImport?: string;
     withBaseWidget?: boolean;
     baseWidgetClass?: string;
@@ -400,12 +454,18 @@ interface GeneratorConfig {
     template?: 'network' | 'simple' | 'auto' | string;
     snippetKey?: string;
     mockLevel?: 'global' | 'instance';
+    baseServiceClass?: string;
+    baseServiceImport?: string;
+    mixins?: string[];
+    mixinImports?: string[];
+    serviceConstructor?: 'const' | 'normal';
 }
 /**
  * 项目配置接口
  */
 interface ProjectConfig {
     template?: 'lite' | 'modular' | 'clean' | string;
+    architecture?: ArchitectureConfig;
     packageName?: string;
     generators?: {
         page?: GeneratorConfig;
@@ -419,6 +479,16 @@ interface ProjectConfig {
         };
     };
 }
+type ProjectConfigSource = 'disk' | 'inferred' | 'builtin';
+type GeneratorPolicyMode = 'locked' | 'default';
+type GeneratorFieldPolicy = Partial<Record<string, GeneratorPolicyMode>>;
+interface ResolvedProjectConfig {
+    source: ProjectConfigSource;
+    config: ProjectConfig;
+    diagnostics: string[];
+    hasDiskConfig: boolean;
+}
+type GeneratorConfigType = 'page' | 'viewModel' | 'widget' | 'model' | 'component' | 'service';
 /**
  * 项目配置管理器
  */
@@ -436,20 +506,33 @@ declare class ProjectConfigManager {
      * @returns 是否存在配置文件
      */
     static hasConfig(projectDir: string): boolean;
+    /**
+     * 解析运行时生效配置。
+     * 即使项目没有真实 .flu-cli.json，也会基于目录结构和内置默认值得到一份权威配置。
+     */
+    static resolveEffectiveConfig(projectDir: string): ResolvedProjectConfig;
     /**
      * 获取指定生成器的配置
      * @param projectDir 项目目录
      * @param generatorType 生成器类型
      * @returns 生成器配置，如果不存在则返回 null
      */
-    static getGeneratorConfig(projectDir: string, generatorType: 'page' | 'viewModel' | 'widget' | 'model' | 'component' | 'service'): GeneratorConfig | null;
+    static getGeneratorConfig(projectDir: string, generatorType: GeneratorConfigType): GeneratorConfig | null;
+    /**
+     * 仅根据目录结构推断模板类型。
+     */
+    static inferTemplateFromStructure(projectDir: string): 'lite' | 'modular' | 'clean' | null;
     /**
      * 获取默认配置模板
      * @param templateType 模板类型
      * @returns 配置模板对象
      */
     static getDefaultConfigTemplate(templateType: 'lite' | 'modular' | 'clean' | 'custom' | string): ProjectConfig;
+    private static readPackageName;
 }
+declare function getArchitectureMode(config?: ProjectConfig | null): ArchitectureMode;
+declare function getGeneratorFieldPolicy(config: ProjectConfig | null | undefined, generatorType: GeneratorConfigType, field: string): GeneratorPolicyMode | null;
+declare function isGeneratorFieldLocked(config: ProjectConfig | null | undefined, generatorType: GeneratorConfigType, field: string): boolean;
 
 /**
  * 应用资源选择接口
@@ -619,7 +702,7 @@ declare function checkFlutterInstalled(): Promise<boolean>;
  */
 declare function getFlutterVersion(): Promise<string | null>;
 
-type BuildPlatform = 'android' | 'ios';
+type BuildPlatform = 'android' | 'ios' | 'harmony';
 declare class BuildManager {
     static build(platform: BuildPlatform, buildConfig: NonNullable<UploadConfig['build']>, projectDir?: string): Promise<BuildResult>;
 }
@@ -666,12 +749,6 @@ declare class AndroidBuilder {
      * @param projectDir 项目目录
      */
     static build(config: NonNullable<UploadConfig['build']>['android'], projectDir?: string): Promise<BuildResult>;
-    /**
-     * 查找构建产物
-     * @param projectDir 项目目录
-     * @param type 类型 (apk/appbundle)
-     * @param flavor 风味
-     */
     private static findArtifact;
 }
 
@@ -702,4 +779,4 @@ declare function fixAndroidPackageName(projectDir: string, packageName: string,
  */
 declare function fixIosBundleIdentifier(projectDir: string, bundleId: string, logger?: Logger): Promise<void>;
 
-export { AndroidBuilder, type AppAssetConfig, AppAssetsManager, BUILTIN_TEMPLATES, BuildManager, ConfigManager, ConsoleLogger, type CustomTemplate, type FluConfig, type GeneratorConfig, I18nManager, IOSBuilder, type Logger, type ProjectConfig, ProjectConfigManager, ProjectContextService, ProjectGenerator, type ProjectOptions, type ProjectPreset, type ProjectTemplate, TemplateGenerator, TemplateManager, TemplatePresetService, type TemplateType, checkFlutterInstalled, checkSnippetsVersion, cleanupTemplateFiles, copyCoreFiles, copyCustomTemplate, copyInfrastructure, copyNetworkFiles, copyTemplate, detectProjectTemplate, ensurePubspecName, fixAndroidPackageName, fixIosBundleIdentifier, generateComponent, generateIndexFile, generateModel, generateModule, generatePage, generateService, generateViewModel, generateWidget, getCoreFilesDir, getFlutterVersion, getModelPath, getNetworkDir, getPagePath, getRelativeImportPath, getServicePath, getSnippetContent, getStateManager, getTemplatesRootDir, getViewModelPath, getWidgetPath, injectNetworkExamples, isCustomTemplateProject, loadProjectSnippets, logger, removeTemplateSuffix, renderSnippet, replaceVariables, runFlutterCreate, runFlutterPubGet, t, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, updateIndexFile, upgradeSnippets };
+export { AndroidBuilder, type AppAssetConfig, AppAssetsManager, type ArchitectureConfig, type ArchitectureMode, BUILTIN_TEMPLATES, BuildManager, ConfigManager, ConsoleLogger, type CustomTemplate, type FluConfig, type GeneratorConfig, type GeneratorConfigType, type GeneratorFieldPolicy, type GeneratorPolicyMode, type GeneratorType, I18nManager, IOSBuilder, type Logger, type ProjectConfig, ProjectConfigManager, type ProjectConfigSource, ProjectContextService, ProjectGenerator, type ProjectOptions, type ProjectPreset, type ProjectTemplate, type ResolvedProjectConfig, TemplateGenerator, TemplateManager, TemplatePresetService, type TemplateType, calculateRelativeImport, checkFlutterInstalled, checkSnippetsVersion, cleanupTemplateFiles, copyCoreFiles, copyCustomTemplate, copyInfrastructure, copyNetworkFiles, copyTemplate, detectProjectTemplate, ensurePubspecName, fixAndroidPackageName, fixIosBundleIdentifier, generateComponent, generateIndexFile, generateModel, generateModule, generatePage, generateService, generateViewModel, generateWidget, getArchitectureMode, getCoreFilesDir, getFlutterVersion, getGeneratorFieldPolicy, getModelPath, getNetworkDir, getPagePath, getRelativeImportPath, getServicePath, getSnippetContent, getStateManager, getTemplatesRootDir, getViewModelPath, getWidgetPath, injectNetworkExamples, isCustomTemplateProject, isGeneratorFieldLocked, loadProjectSnippets, logger, mirrorNestedTargetDir, removeTemplateSuffix, renderSnippet, replaceVariables, resolveConfiguredImport, resolveGeneratorBaseDir, resolveGeneratorTargetDir, runFlutterCreate, runFlutterPubGet, t, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, updateIndexFile, updateNestedIndexExports, upgradeSnippets };