flu-cli-core 1.0.4 → 1.1.0

package/dist/index.d.ts

@@ -25,6 +25,8 @@ declare const logger: ConsoleLogger;
 /**
  * 转换为 PascalCase
  * home_page -> HomePage
+ * homePage  -> HomePage（保留已有 camelCase 单词边界）
+ * refreshToken -> RefreshToken
  */
 declare function toPascalCase(str: string): string;
 /**
@@ -101,6 +103,232 @@ 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;
+
+/**
+ * 项目配置管理器
+ * 职责：读取和管理项目级别的 .flu-cli.json 配置文件
+ */
+/**
+ * 架构模式
+ * - `inherit` / `mixin`：旧值，保留向后兼容，不注入职责约定
+ * - `mvvm` / `bloc` / `clean` / `native`：v2 架构模式，可配合 contracts 注入 AI 规则
+ */
+type ArchitectureMode = 'inherit' | 'mixin' | 'mvvm' | 'bloc' | 'clean' | 'native';
+interface ArchitectureContracts {
+    /** Service 层禁止直接发 HTTP 请求给 ViewModel/Bloc（默认 false） */
+    forbidHttpInStateLayer?: boolean;
+    /** Service 层禁止返回 dynamic / Map<String,dynamic> 给状态层（默认 false） */
+    forbidDynamicReturn?: boolean;
+    /** 错误处理约定：result（Result<T>）/ exception（抛异常）/ either（Either/Failure） */
+    errorHandling?: 'result' | 'exception' | 'either';
+}
+interface ArchitectureConfig {
+    mode?: ArchitectureMode;
+    contracts?: ArchitectureContracts;
+}
+type StateManagement = 'provider' | 'riverpod' | 'bloc' | 'getx' | 'mobx' | 'none';
+type RouterPackage = 'go_router' | 'auto_route' | 'getx' | 'navigator' | 'none';
+type DiPackage = 'get_it' | 'injectable' | 'riverpod' | 'getx' | 'none';
+interface NetworkConfig {
+    package?: 'dio' | 'http' | string;
+    /** 响应包装类型，如 `BaseResponse<T>`；为空则不强制包装 */
+    responseWrapper?: string;
+}
+/** 顶层模型生成约定（区别于 generators.model 的生成器路径配置） */
+interface TopLevelModelConfig {
+    /** 模型生成方式：手写 / freezed / json_serializable */
+    strategy?: 'manual' | 'freezed' | 'json_serializable';
+    /** 是否需要 build_runner（strategy 为 freezed/json_serializable 时自动为 true） */
+    buildRunner?: boolean;
+    /** *.g.dart / *.freezed.dart 是否纳入版本库 */
+    commitGeneratedFiles?: boolean;
+}
+interface LintConfig {
+    /** minimal：仅 flutter_lints；strict：团队增强规则集 */
+    preset?: 'minimal' | 'strict';
+}
+interface UiStyleConfig {
+    /** 优先使用增量包裹风格（body = Wrapper(child: body)），而非直接嵌套 */
+    incrementalWrap?: boolean;
+    /** 单个 build 方法内最大嵌套层数（超出建议拆 Widget） */
+    maxNestingDepth?: number;
+}
+interface UiConfig {
+    style?: UiStyleConfig;
+}
+interface GeneratorSelectableOption$1 {
+    name: string;
+    import: string;
+}
+/**
+ * 生成器配置接口
+ */
+interface GeneratorConfig {
+    path?: string;
+    allowSubDir?: boolean;
+    defaultType?: 'stateful' | 'stateless';
+    fileSuffix?: string;
+    fileName?: string;
+    policy?: GeneratorFieldPolicy;
+    baseOptionDirs?: string[];
+    mixinOptionDirs?: string[];
+    baseOptions?: GeneratorSelectableOption$1[];
+    mixinOptions?: GeneratorSelectableOption$1[];
+    native?: boolean;
+    mixins?: string[];
+    mixinImports?: string[];
+    withBasePage?: boolean;
+    basePageClass?: string;
+    baseListPageClass?: string;
+    basePageImport?: string;
+    withViewModel?: boolean;
+    viewModelPath?: string;
+    withBaseViewModel?: boolean;
+    baseViewModelClass?: string;
+    baseListViewModelClass?: string;
+    baseViewModelImport?: string;
+    withBaseWidget?: boolean;
+    baseWidgetClass?: string;
+    baseWidgetImport?: string;
+    withBaseModel?: boolean;
+    baseModelClass?: string;
+    baseModelImport?: string;
+    template?: 'network' | 'simple' | 'auto' | string;
+    snippetKey?: string;
+    mockLevel?: 'global' | 'instance';
+    baseServiceClass?: string;
+    baseServiceImport?: string;
+    serviceConstructor?: 'const' | 'normal';
+}
+/**
+ * 项目配置接口（`.flu-cli.json` 的完整类型）
+ */
+interface ProjectConfig {
+    /**
+     * 项目最初使用的脚手架类型（lite / modular / clean 等），**仅作文档与元数据**。
+     * 不参与 generators 默认值的推断；生效约定以 `generators` 与磁盘上的完整配置为准。
+     */
+    template?: 'lite' | 'modular' | 'clean' | string;
+    architecture?: ArchitectureConfig;
+    packageName?: string;
+    /** 状态管理框架 */
+    stateManagement?: StateManagement;
+    /** 路由/导航方案 */
+    router?: RouterPackage;
+    /** 网络层约定 */
+    network?: NetworkConfig;
+    /** 依赖注入方案 */
+    di?: DiPackage;
+    /** 顶层模型生成约定（区别于 generators.model 路径配置） */
+    model?: TopLevelModelConfig;
+    /** Lint 级别 */
+    lint?: LintConfig;
+    /** UI 编码风格约定 */
+    ui?: UiConfig;
+    generators?: {
+        page?: GeneratorConfig;
+        viewModel?: GeneratorConfig;
+        widget?: GeneratorConfig;
+        model?: GeneratorConfig;
+        component?: GeneratorConfig;
+        service?: GeneratorConfig;
+        module?: {
+            path?: string;
+        };
+    };
+}
+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';
+/**
+ * 项目配置管理器
+ */
+declare class ProjectConfigManager {
+    private static CONFIG_FILE_NAME;
+    /**
+     * 加载项目配置
+     * @param projectDir 项目目录
+     * @returns 配置对象，如果不存在则返回 null
+     */
+    static loadConfig(projectDir: string): ProjectConfig | null;
+    /**
+     * 检查项目是否有配置文件
+     * @param projectDir 项目目录
+     * @returns 是否存在配置文件
+     */
+    static hasConfig(projectDir: string): boolean;
+    /**
+     * 解析运行时生效配置。
+     * 无 `.flu-cli.json` 时使用「custom」最小默认 generators，不再按目录结构套用 lite/modular/clean 全套预设；
+     * `template` 字段仅作元数据写入，不驱动合并基准。
+     */
+    static resolveEffectiveConfig(projectDir: string): ResolvedProjectConfig;
+    /**
+     * 获取指定生成器的配置
+     * @param projectDir 项目目录
+     * @param generatorType 生成器类型
+     * @returns 生成器配置，如果不存在则返回 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;
+
+interface GeneratorSelectableOptionsReport {
+    ok: boolean;
+    projectDir: string;
+    target: GeneratorConfigType;
+    diagnostics: string[];
+    scannedBaseDirs: string[];
+    scannedMixinDirs: string[];
+    bases: GeneratorSelectableOption$1[];
+    mixins: GeneratorSelectableOption$1[];
+}
+declare function listGeneratorSelectableOptions(projectDir: string, target: GeneratorConfigType): GeneratorSelectableOptionsReport;
+
 /**
  * 模板生成器
  * 负责生成各种类型的代码内容，供 Generator 和 Snippets 复用
@@ -117,11 +345,16 @@ declare class TemplateGenerator {
         coreImportPath?: string;
         baseClass?: string;
         extraImports?: string[];
+        mixins?: string[];
+        mixinImports?: string[];
     }): string;
     /**
      * 生成 Simple Stateful Page
      */
-    static generateSimpleStatefulPage(namePascal: string, nameTitle: string): string;
+    static generateSimpleStatefulPage(namePascal: string, nameTitle: string, options?: {
+        mixins?: string[];
+        mixinImports?: string[];
+    }): string;
     /**
      * 生成 Simple Stateless Page
      */
@@ -133,6 +366,25 @@ declare class TemplateGenerator {
         coreImportPath?: string;
         baseClass?: string;
         extraImports?: string[];
+        mixins?: string[];
+        mixinImports?: string[];
+    }): string;
+    static generateListViewModel(namePascal: string, modelName: string, options?: {
+        coreImportPath?: string;
+        modelImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+        mixins?: string[];
+        mixinImports?: string[];
+    }): string;
+    static generateListPageWithBase(namePascal: string, nameTitle: string, modelName: string, options?: {
+        vmImportPath?: string;
+        modelImportPath?: string;
+        coreImportPath?: string;
+        baseClass?: string;
+        extraImports?: string[];
+        mixins?: string[];
+        mixinImports?: string[];
     }): string;
     /**
      * 生成 Service
@@ -158,6 +410,8 @@ declare class TemplateGenerator {
      * 生成 Model
      */
     static generateModel(namePascal: string): string;
+    private static sortImports;
+    private static getImportSortKey;
 }
 
 /**
@@ -170,16 +424,175 @@ 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;
 declare function getNetworkDir(): string;
+declare function getHelpersDir(): string;
+declare function getCoreMixinsDir(): string;
+declare function getHelperExamplesDir(): string;
+declare function getStarterProjectDir(): string;
 
+type ProjectStructureType = 'lite' | 'modular' | 'clean' | 'native' | string;
+type StateManagerType = 'default' | 'provider' | 'getx' | 'bloc' | 'riverpod' | string;
+type FlutterSdkMode = 'system' | 'fvm' | 'custom';
+type CompositionProfile = 'base' | 'base_mixins' | 'pure_mixins' | 'pure';
+type ProjectArchitectureMode = 'mvvm' | 'native';
+type ProjectExampleId = 'networkGallery' | 'webviewBasic' | 'permissionBasic' | 'imagePickerBasic' | 'paymentShell' | string;
+interface GeneratorSelectableOption {
+    name: string;
+    import: string;
+}
+interface ProjectCompositionConfig {
+    /** 当前真实架构模式：MVVM 标准架构或原生 Flutter。 */
+    architectureMode: ProjectArchitectureMode;
+    /** 是否准备 mixin 候选目录；不代表默认注入 mixin。 */
+    enableMixinOptions: boolean;
+    profile: CompositionProfile;
+    pageMixins: GeneratorSelectableOption[];
+    viewModelMixins: GeneratorSelectableOption[];
+    serviceMixins: GeneratorSelectableOption[];
+}
+interface FlutterSdkConfig {
+    mode: FlutterSdkMode;
+    version?: string;
+    flutterBin?: string;
+}
+interface ProjectCoreConfig {
+    enabled: boolean;
+    modules: {
+        boot: boolean;
+        config: boolean;
+        base: boolean;
+        list: boolean;
+        router: boolean;
+        theme: boolean;
+        storage: boolean;
+        utils: boolean;
+        widgets: boolean;
+    };
+}
+interface NetworkCapabilityConfig {
+    enabled: boolean;
+    client: 'dio' | string;
+    monitor: boolean;
+    /** 旧 network.examples 兼容字段；正式协议已上移到顶层 examples。 */
+    examples: boolean;
+}
+interface StorageCapabilityConfig {
+    enabled: boolean;
+    package: 'shared_preferences' | string;
+}
+interface SerializationCapabilityConfig {
+    enabled: boolean;
+    strategy: 'manual' | 'json_serializable' | 'freezed' | string;
+    buildRunner: boolean;
+}
+interface AuthCapabilityConfig {
+    enabled: boolean;
+    mode: 'basic' | string;
+}
+interface ProjectCapabilitiesConfig {
+    network: NetworkCapabilityConfig;
+    storage: StorageCapabilityConfig;
+    serialization: SerializationCapabilityConfig;
+    auth: AuthCapabilityConfig;
+}
+interface ProjectHelpersConfig {
+    payment: boolean;
+    webview: boolean;
+    permission: boolean;
+    imagePicker: boolean;
+}
+interface ProjectPlatformConfig {
+    platforms: string[];
+    flutterCreatePlatforms: string[];
+    flutterSdk: FlutterSdkConfig;
+}
+interface ProjectStackConfig {
+    stateManagement: StateManagerType;
+    network: {
+        enabled: boolean;
+        client: 'dio' | 'http' | 'none' | string;
+    };
+    serialization: SerializationCapabilityConfig;
+    router: 'go_router' | 'auto_route' | 'getx' | 'navigator' | 'none' | string;
+    di: 'get_it' | 'injectable' | 'riverpod' | 'getx' | 'none' | string;
+    lint: 'strict' | 'minimal' | string;
+}
+interface ProjectCreateConfig {
+    version: 2;
+    projectName: string;
+    packageName?: string;
+    templateType: ProjectStructureType;
+    stateManager: StateManagerType;
+    architectureMode: ProjectArchitectureMode;
+    enableMixinOptions: boolean;
+    /**
+     * 创建期顶层示例协议。
+     * 只用于本次创建时决定示例目录、首页演示和示例路由，不写入 .flu-cli.json。
+     */
+    examples: ProjectExampleId[];
+    composition: ProjectCompositionConfig;
+    stack: ProjectStackConfig;
+    core: ProjectCoreConfig;
+    capabilities: ProjectCapabilitiesConfig;
+    helpers: ProjectHelpersConfig;
+    platform: ProjectPlatformConfig;
+    legacy: {
+        templateType?: string;
+        includeNetworkLayer?: unknown;
+        includeNetwork?: unknown;
+    };
+}
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends Array<unknown> ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+type ProjectCreateConfigInput = DeepPartial<ProjectCreateConfig>;
+interface NormalizeProjectCreateConfigOptions {
+    projectName?: string;
+    packageName?: string;
+    templateType?: string;
+    template?: string;
+    stateManager?: string;
+    architectureMode?: string;
+    enableMixinOptions?: boolean;
+    includeNetworkLayer?: unknown;
+    includeNetwork?: unknown;
+    examples?: ProjectExampleId[] | string;
+    platforms?: string[];
+    flutterSdk?: Partial<FlutterSdkConfig>;
+    composition?: DeepPartial<ProjectCompositionConfig>;
+    stack?: DeepPartial<ProjectStackConfig>;
+    projectCreate?: ProjectCreateConfigInput;
+    capabilities?: DeepPartial<ProjectCapabilitiesConfig>;
+    helpers?: Partial<ProjectHelpersConfig>;
+}
+declare function normalizeProjectCreateConfig(options?: NormalizeProjectCreateConfigOptions): ProjectCreateConfig;
+declare function normalizeTemplateType(templateType: string): ProjectStructureType;
+declare function normalizeNetworkEnabled(value: unknown): boolean;
+declare function normalizePlatforms(platforms?: string[]): string[];
+declare function normalizeFlutterCreatePlatform(platform: string): string;
+declare function normalizeFlutterCreatePlatforms(platforms: string[]): string[];
+declare function normalizeCompositionProfile(value: string): CompositionProfile;
+
+/**
+ * 复制默认 Core 模板。
+ * vNext 优先读取 projectConfig；旧 includeNetworkLayer/templateType 继续保留兼容。
+ */
 declare function copyCoreFiles(projectPath: string, options?: {
     includeNetworkLayer?: boolean;
     templateType?: 'lite' | 'modular' | 'clean';
     projectName?: string;
     stateManager?: string;
+    projectConfig?: ProjectCreateConfig;
 }): Promise<void>;
 declare function copyNetworkFiles(projectPath: string, options?: {
     targetDir?: string;
@@ -187,11 +600,33 @@ declare function copyNetworkFiles(projectPath: string, options?: {
 }): Promise<void>;
 declare function copyInfrastructure(projectPath: string, includeExamples?: boolean, includeNetworkLayer?: boolean, templateType?: 'lite' | 'modular' | 'clean'): Promise<void>;
 
+/**
+ * 复制 project helpers。
+ * helpers 不属于 Core，本函数只负责把启用的 helper 投影到 lib/helpers 下。
+ */
+declare function copyHelperFiles(projectPath: string, projectConfig: ProjectCreateConfig): Promise<void>;
+
+declare function copyCoreMixins(projectPath: string, options: {
+    projectConfig: ProjectCreateConfig;
+    renderData: Record<string, any>;
+}): Promise<void>;
+
+declare function copyStarterProjectScaffold(projectPath: string, projectConfig: ProjectCreateConfig, renderData: Record<string, any>): Promise<void>;
+
 declare function copyTemplate(templatePath: string, targetPath: string, options?: {
     excludes?: string[];
 }): Promise<boolean>;
 declare function copyCustomTemplate(templatePath: string, targetPath: string): Promise<boolean>;
 declare function ensurePubspecName(projectDir: string, projectName: string): Promise<void>;
+declare function ensurePubspecDescription(projectDir: string, description: string): Promise<void>;
+/**
+ * 清理 flutter create 写入的默认英文说明注释。
+ *
+ * 这些注释更适合作为 Flutter 官方脚手架提示，不适合作为最终交付给用户的
+ * Starter 工程内容。这里仅移除默认英文说明，不会删除我们后续可能新增的
+ * 简短中文注释或业务注释。
+ */
+declare function sanitizePubspecComments(projectDir: string): Promise<void>;
 declare function cleanupTemplateFiles(projectDir: string): Promise<void>;
 
 declare function injectNetworkExamples(projectPath: string, contextData?: any): Promise<void>;
@@ -264,6 +699,122 @@ declare function generateService(name: string, options?: any, customLogger?: any
  */
 declare function generateModule(name: string, options?: any, logger?: Logger): Promise<boolean>;
 
+/**
+ * flu-blueprint.yaml Schema 类型定义
+ *
+ * 描述"要生成什么结构"——与 .flu-cli.json 描述"怎么生成"相互独立。
+ */
+type BlueprintPageType = 'page' | 'list-page';
+interface BlueprintPage {
+    /** 页面名称，PascalCase 或 snake_case 均可，内部统一转换 */
+    name: string;
+    /** 页面类型：普通页面 / 列表页面（默认 page） */
+    type?: BlueprintPageType;
+    /** 是否生成配套 ViewModel（默认 true） */
+    withVM?: boolean;
+    /** list-page 专用：关联的 Model 名称（如 "Order"） */
+    model?: string;
+    /** 额外备注（仅供人阅读，不影响生成） */
+    note?: string;
+}
+type BlueprintHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface BlueprintEndpoint {
+    /** 接口名称，用于生成方法名（如 "fetchOrders"） */
+    name: string;
+    /** HTTP 方法（默认 GET） */
+    method?: BlueprintHttpMethod;
+    /** 接口路径（如 "/api/orders"） */
+    path?: string;
+    /** 接口响应的 JSON 示例对象，用于自动推断并生成 Model */
+    responseExample?: Record<string, unknown>;
+    /** 接口响应 data 字段内部的 JSON 示例（优先级高于 responseExample） */
+    dataExample?: Record<string, unknown>;
+    /** 额外备注 */
+    note?: string;
+}
+interface BlueprintFeature {
+    /** 功能模块名（snake_case 或 camelCase，内部统一转 snake_case） */
+    name: string;
+    /** 该模块下的页面列表 */
+    pages?: BlueprintPage[];
+    /** 需要生成的 Service 名称列表（如 ["OrderService", "UserService"]） */
+    services?: string[];
+    /** 需要生成的 Model 名称列表（如 ["OrderModel"]）—— 不含接口推断的 Model */
+    models?: string[];
+    /** 接口定义列表：endpoint → 自动生成 Service 方法 + Model */
+    endpoints?: BlueprintEndpoint[];
+    /** 额外备注 */
+    note?: string;
+}
+interface Blueprint {
+    /**
+     * Schema 版本，当前为 "1"
+     * 便于后续平滑升级，解析时可做版本迁移
+     */
+    version?: string;
+    /**
+     * 功能模块列表（模块模式）
+     * 若不填 features，则允许使用根级 pages/endpoints/services/models（简单 App 模式）
+     */
+    features?: BlueprintFeature[];
+    /**
+     * 简单 App 模式（不写 features）
+     * 将自动映射为隐式 feature：`name: "app"`
+     */
+    pages?: BlueprintPage[];
+    services?: string[];
+    models?: string[];
+    endpoints?: BlueprintEndpoint[];
+}
+interface BlueprintGenerateResult {
+    ok: boolean;
+    /** 生成的文件路径列表 */
+    generated: string[];
+    /** 跳过的文件（已存在） */
+    skipped: string[];
+    /** 每步的诊断消息 */
+    diagnostics: string[];
+}
+
+/**
+ * Blueprint 批量生成器
+ *
+ * 读取 flu-blueprint.yaml，按 features → pages / services / models / endpoints
+ * 顺序调用现有各单体 Generator，汇总生成结果。
+ *
+ * 所有基类 / Mixin / 路径约束来自 .flu-cli.json（generators 配置），
+ * Blueprint 只描述"要什么"，不重复配置"怎么写"。
+ */
+
+/**
+ * 从指定目录读取 flu-blueprint.yaml，批量生成所有节点。
+ *
+ * @param projectDir  Flutter 项目根目录（含 .flu-cli.json）
+ * @param blueprintPath  Blueprint 文件路径（默认 <projectDir>/flu-blueprint.yaml）
+ */
+declare function generateFromBlueprint(projectDir: string, blueprintPath?: string, logger?: Logger): Promise<BlueprintGenerateResult>;
+
+/**
+ * OpenAPI 3 → Blueprint 转换器
+ *
+ * 将 OpenAPI 3 规范（JSON 或 YAML 字符串/对象）解析为 flu-blueprint.yaml 结构。
+ *
+ * 映射规则：
+ *  - paths[path][method]  →  BlueprintEndpoint（按 tag 分组到 feature）
+ *  - components/schemas   →  dataExample（内联到 endpoint，供生成器推断 Model）
+ *  - tags                 →  feature.name（无 tag 归入 "common"）
+ *
+ * 原则：Blueprint 永远独立可用，本工具只是可选的"填充来源"。
+ */
+
+/**
+ * 将 OpenAPI 3 文档转换为 Blueprint 结构。
+ *
+ * @param input  OpenAPI 3 文档（JSON 字符串 / YAML 字符串 / 已解析对象）
+ * @returns      Blueprint 对象，可直接写入 flu-blueprint.yaml
+ */
+declare function parseOpenApiToBlueprint(input: string | object): Blueprint;
+
 /**
  * 升级项目中的 snippets 文件
  */
@@ -280,6 +831,70 @@ declare function upgradeSnippets(options?: {
  */
 declare function checkSnippetsVersion(projectDir?: string): 'up-to-date' | 'outdated' | 'missing';
 
+/**
+ * sync-rules 命令核心引擎（AI Skill 投影器）
+ *
+ * 职责：读取 .flu-cli.json，将架构约束投影为 AI 规则文件：
+ *   - .cursor/rules/flu-project.mdc  (Cursor AI)
+ *   - CLAUDE.md                       (Claude Code / Antigravity)
+ *   - AI_RULES.md                     (人机共读)
+ *   - .agent/skills/<包名>/SKILL.md   (通用 Agent Skill)
+ */
+
+declare function syncRules(projectDir?: string): Promise<boolean>;
+interface SyncRulesWriteOutput {
+    filePath: string;
+    changed: boolean;
+}
+interface SyncRulesReport {
+    ok: boolean;
+    projectDir: string;
+    blocked?: boolean;
+    error?: string;
+    source?: string;
+    template?: string;
+    diagnostics?: string[];
+    outputs?: SyncRulesWriteOutput[];
+}
+declare function syncRulesWithReport(projectDir?: string, options?: {
+    logger?: Logger;
+}): Promise<SyncRulesReport>;
+
+type InitAiBaseStarter = 'minimal' | 'lite' | 'modular' | 'clean' | 'native' | 'custom';
+declare function validateProjectId(projectId: string): string | null;
+declare function normalizeProjectIdToPackageName(projectId: string): string;
+declare function buildInitAiBaseConfig(starter: InitAiBaseStarter, packageName: string): ProjectConfig;
+declare function parseFluCliJsonFromPath(filePath: string): ProjectConfig | null;
+interface RunInitAiBaseOptions {
+    projectDir: string;
+    projectId: string;
+    /** 仅在项目根不存在 `.flu-cli.json` 时使用 */
+    starter: InitAiBaseStarter;
+    /** `starter === 'custom'` 时尝试从此路径导入；失败则兜底 minimal */
+    customImportPath?: string;
+}
+interface RunInitAiBaseResult {
+    ok: boolean;
+    diagnostics: string[];
+    packageName: string;
+    skillSlug: string;
+    createdNewConfig: boolean;
+    usedStarter: InitAiBaseStarter;
+    fellBackToMinimal: boolean;
+}
+declare function runInitAiBase(opts: RunInitAiBaseOptions): Promise<RunInitAiBaseResult>;
+interface RunInitAiBaseReport extends RunInitAiBaseResult {
+    syncRules?: SyncRulesReport;
+}
+declare function runInitAiBaseWithReport(opts: RunInitAiBaseOptions, options?: {
+    logger?: Logger;
+}): Promise<RunInitAiBaseReport>;
+
+/**
+ * 与 `sync_rules` 写入 `.agent/skills/<slug>/SKILL.md` 的目录名规则一致。
+ */
+declare function slugForAgentSkill(packageName: string): string;
+
 interface CustomTemplate {
     id: string;
     name: string;
@@ -296,6 +911,9 @@ interface ProjectPreset {
     templateType: string;
     stateManager: string;
     includeNetworkLayer: boolean;
+    /** 创建期顶层示例协议，允许 preset 复用，但不写入 .flu-cli.json。 */
+    examples?: string[];
+    networkMonitorEnabled?: boolean;
     platforms: string[];
     assetStrategy?: 'manual' | 'skip';
     triggerAssetWizard?: boolean;
@@ -352,12 +970,17 @@ interface ProjectOptions {
     packageName: string;
     outputDir: string;
     includeNetworkLayer?: boolean;
+    examples?: string[];
+    createProjectConfig?: boolean;
 }
 /**
  * ProjectGenerator (V6.0)
  * 采用 Task Pipeline 架构，极简核心，逻辑拆分至各原子 Task。
  */
 declare class ProjectGenerator {
+    lastError: string;
+    lastSdkBindingWarning: string;
+    lastBootstrapWarning: string;
     /**
      * 生成项目
      * @param {string} name 项目名称
@@ -365,91 +988,165 @@ declare class ProjectGenerator {
      * @param {Logger} logger 日志工具
      */
     generate(name: string, options?: any, logger?: Logger): Promise<boolean>;
+    private runAutomaticPubGetIfNeeded;
     /**
      * 检查项目目录是否存在
      */
     checkProjectExists(projectPath: string): boolean;
+    /**
+     * Native 项目在 flutter create 之后按 vNext 配置做后置增强。
+     *
+     * 与 lite 管线共用 HelperEnrich 等任务，不复制骨架模板、默认不注入 Core。
+     * 示例入口注入依赖 lib/core/router，纯 Native 无路由基座时会由任务自行跳过。
+     */
+    enrichNativeProjectAfterSkeleton(name: string, options: any, projectPath: string, logger?: Logger): Promise<boolean>;
+    private reapplyIosPodfilePermissionMacrosIfNeeded;
+    private generateNativeProject;
 }
 
 /**
- * 项目配置管理器
- * 职责：读取和管理项目级别的 .flu-cli.json 配置文件
+ * 任务执行上下文
  */
+interface TaskContext {
+    /** 项目根路径 */
+    projectPath: string;
+    /** 项目名称 */
+    projectName: string;
+    /** Dart package 名（合法标识符，用于 pubspec/package import） */
+    dartPackageName: string;
+    /** 模板类型 */
+    templateType: ProjectStructureType;
+    /** 是否包含网络层 */
+    includeNetworkLayer: boolean;
+    /** 状态管理框架 */
+    stateManager: StateManagerType;
+    /** vNext 统一项目创建配置 */
+    projectConfig: ProjectCreateConfig;
+    /** 用户选项 */
+    options: any;
+    /** 全局变量字典（用于模板替换） */
+    variables: Record<string, string>;
+    /** 日志记录器 */
+    logger: Logger;
+    /** 附加元数据 */
+    [key: string]: any;
+}
 /**
- * 生成器配置接口
+ * 项目生成任务接口
  */
-interface GeneratorConfig {
-    path?: string;
-    defaultType?: 'stateful' | 'stateless';
-    fileSuffix?: string;
-    fileName?: string;
-    withBasePage?: boolean;
-    basePageClass?: string;
-    basePageImport?: string;
-    withViewModel?: boolean;
-    viewModelPath?: string;
-    withBaseViewModel?: boolean;
-    baseViewModelClass?: string;
-    baseViewModelImport?: string;
-    withBaseWidget?: boolean;
-    baseWidgetClass?: string;
-    baseWidgetImport?: string;
-    withBaseModel?: boolean;
-    baseModelClass?: string;
-    baseModelImport?: string;
-    template?: 'network' | 'simple' | 'auto' | string;
-    snippetKey?: string;
-    mockLevel?: 'global' | 'instance';
+interface IProjectTask {
+    /** 任务名称 */
+    name: string;
+    /** 执行任务 */
+    run(context: TaskContext): Promise<void>;
 }
 /**
- * 项目配置接口
+ * 创建初始上下文
  */
-interface ProjectConfig {
-    template?: 'lite' | 'modular' | 'clean' | string;
-    packageName?: string;
-    generators?: {
-        page?: GeneratorConfig;
-        viewModel?: GeneratorConfig;
-        widget?: GeneratorConfig;
-        model?: GeneratorConfig;
-        component?: GeneratorConfig;
-        service?: GeneratorConfig;
-        module?: {
-            path?: string;
-        };
-    };
+declare function createDefaultContext(projectPath: string, projectName: string, options?: any, logger?: Logger): TaskContext;
+
+/**
+ * 变量落地任务
+ * 负责替换项目中的 {{projectName}}, {{packageName}} 等占位符
+ */
+declare class VariablesReplaceTask implements IProjectTask {
+    name: string;
+    run(context: TaskContext): Promise<void>;
 }
+
 /**
- * 项目配置管理器
+ * 项目清理与修复任务
+ * 负责环境兼容性修复、权限补丁及冗余文件清理
  */
-declare class ProjectConfigManager {
-    private static CONFIG_FILE_NAME;
+declare class CleanupTask implements IProjectTask {
+    name: string;
+    run(context: TaskContext): Promise<void>;
     /**
-     * 加载项目配置
-     * @param projectDir 项目目录
-     * @returns 配置对象，如果不存在则返回 null
+     * 启用 Dio / network capability 时，自动确保 Android 主 Manifest 具备联网权限。
      */
-    static loadConfig(projectDir: string): ProjectConfig | null;
+    private patchAndroidInternetPermission;
     /**
-     * 检查项目是否有配置文件
-     * @param projectDir 项目目录
-     * @returns 是否存在配置文件
+     * 自动修复 macOS 网络权限 (避免 SocketException)
      */
-    static hasConfig(projectDir: string): boolean;
+    private patchMacOSEntitlements;
     /**
-     * 获取指定生成器的配置
-     * @param projectDir 项目目录
-     * @param generatorType 生成器类型
-     * @returns 生成器配置，如果不存在则返回 null
+     * 修复默认测试文件中的导入路径。
+     *
+     * lite/modular/clean 使用 Starter 的 app.dart；native 只有 main.dart + MyApp。
      */
-    static getGeneratorConfig(projectDir: string, generatorType: 'page' | 'viewModel' | 'widget' | 'model' | 'component' | 'service'): GeneratorConfig | null;
+    private fixTestFile;
+    private buildNativeWidgetTest;
+    private buildStarterWidgetTest;
     /**
-     * 获取默认配置模板
-     * @param templateType 模板类型
-     * @returns 配置模板对象
+     * 修复残留的旧路径引用
      */
-    static getDefaultConfigTemplate(templateType: 'lite' | 'modular' | 'clean' | 'custom' | string): ProjectConfig;
+    private fixLegacyImports;
+    /**
+     * 将 index.dart 顶部的 `///` library doc 改为普通注释。
+     * Dart analyzer 会把没有 `library;` 指令的顶层文档注释判成 dangling library doc，
+     * 新项目首次打开时容易出现一串低价值 warning。
+     */
+    private normalizeIndexFileComments;
+    private downgradeTopLevelDocComments;
+    private removeEmptyDartFiles;
+    private removeBaseResidue;
+    private removeLegacyUserListResidue;
+    private removeNetworkGalleryResidue;
+    private getNetworkResidueTargets;
+    private getLegacyUserListTargets;
+}
+
+/**
+ * 项目配置任务
+ * 职责：初始化项目的 .flu-cli.json 配置文件，实现模板自描述
+ */
+declare class ProjectConfigTask implements IProjectTask {
+    name: string;
+    run(context: TaskContext): Promise<void>;
+}
+
+/**
+ * Starter Scaffold 任务。
+ * 负责写入项目级入口文件、说明文档、环境样板和 VSCode 调试配置。
+ */
+declare class StarterScaffoldTask implements IProjectTask {
+    name: string;
+    run(context: TaskContext): Promise<void>;
+}
+
+declare function buildProjectRenderData(context: TaskContext): Record<string, any>;
+
+/**
+ * Helper 依赖策略。
+ *
+ * 这里集中维护 helper 与 pubspec 依赖的关系，避免 HelperEnrichTask 里散落平台判断。
+ */
+type HelperName = keyof ProjectHelpersConfig;
+interface HelperDependencyPlan {
+    dependencies: string[];
+    devDependencies: string[];
+    warnings: string[];
+    platformProfile: 'standard' | 'harmony';
+}
+/**
+ * 计算 helper 需要注入的 pubspec 依赖。
+ *
+ * 包含 ohos 平台时仍保留普通 Flutter 依赖，保证 Android/iOS/Web 先可用；
+ * Harmony 原生插件源与版本只给提示，不在 CLI 中维护内置矩阵。
+ */
+declare function resolveHelperDependencyPlan(projectConfig: ProjectCreateConfig): HelperDependencyPlan;
+/**
+ * 将 schema 中的 imagePicker 映射到模板目录 image_picker。
+ */
+declare function getEnabledHelperTemplateDirs(projectConfig: ProjectCreateConfig): string[];
+
+interface CapabilityDependencyPlan {
+    dependencies: string[];
+    devDependencies: string[];
+    warnings: string[];
+    platformProfile: 'standard' | 'harmony';
 }
+declare function resolveCapabilityDependencyPlan(projectConfig: ProjectCreateConfig): CapabilityDependencyPlan;
 
 /**
  * 应用资源选择接口
@@ -475,7 +1172,7 @@ declare class AppAssetsManager {
      * @param assets 资源配置
      * @param logger 日志工具
      */
-    setupAppAssets(projectPath: string, assets: AppAssetConfig, logger: Logger): Promise<boolean>;
+    setupAppAssets(projectPath: string, assets: AppAssetConfig, logger: Logger, flutterSdk?: FlutterSdkConfig): Promise<boolean>;
     /**
      * 复制文件（当源路径与目标路径相同时跳过）
      */
@@ -540,6 +1237,7 @@ declare class TemplateManager {
      * @param isCustom 是否为自定义模板
      */
     getTemplatePath(templateName: string, isCustom?: boolean): string;
+    getBuiltinTemplateIds(): string[];
     /**
      * 准备模板（确保已缓存且为最新）
      *
@@ -549,6 +1247,20 @@ declare class TemplateManager {
      * 3. 内置模板 (lite/modular/clean)
      */
     prepareTemplate(templateId: string, logger?: Logger, forceUpdate?: boolean): Promise<string | undefined>;
+    refreshBuiltinTemplateCache(templateId: string, logger?: Logger): Promise<string | undefined>;
+    refreshAllBuiltinTemplateCaches(logger?: Logger): Promise<string[]>;
+    cleanBuiltinTemplateCache(logger?: Logger): Promise<number>;
+    private ensureBuiltinTemplateCached;
+    private isBuiltinCacheManagedTemplate;
+    private isBuiltinTemplateCacheStale;
+    private writeBuiltinTemplateMeta;
+    private computeDirectorySignature;
+    private resolveBundledBuiltinTemplatePath;
+    private getBundledTemplateRootCandidates;
+    private resolveInstalledCoreTemplatesRoot;
+    private resolveRuntimeEntryTemplatesRoot;
+    private getBuiltinCacheAliasPaths;
+    private removeLegacyBuiltinCacheAliases;
     /**
      * 通用 Git 仓库缓存逻辑
      */
@@ -585,6 +1297,27 @@ declare const t: (key: string, params?: Record<string, any>) => string;
  * Flutter 辅助工具
  * 职责：封装 flutter create/pub get/版本检测等命令调用
  */
+
+declare const HARMONY_FVM_SETUP_DOC_URL = "http://huozhiye.cn/flu-cli/";
+interface FlutterCreateResult {
+    success: boolean;
+    reason: 'ok' | 'unsupported_platform' | 'command_failed';
+    command: string;
+    unsupportedPlatforms: string[];
+    missingPlatforms: string[];
+    errorMessage?: string;
+}
+interface FlutterCreateExecutionPlan {
+    flutterCommand: string;
+    prepareCommands: string[];
+    optionalPrepareCommands: string[];
+    createCommand: string;
+    createCwd?: string;
+    command: string;
+    usesFvmWorkflow?: boolean;
+    fvmVersionFile?: string;
+    workspaceFvmSdkRoot?: string;
+}
 /**
  * 运行 flutter create 命令
  * @param {string} projectDir - 项目目录
@@ -601,13 +1334,40 @@ declare const t: (key: string, params?: Record<string, any>) => string;
  * @param {string[]} platforms - 目标平台 (ios, android, web, windows, macos, linux, ohos)
  * @returns {Promise<boolean>} 是否成功
  */
-declare function runFlutterCreate(projectDir: string, projectName: string, packageName: string, flutterTemplate?: string, platforms?: string[]): Promise<boolean>;
+declare function runFlutterCreate(projectDir: string, projectName: string, packageName: string, flutterTemplate?: string, platforms?: string[], flutterSdk?: FlutterSdkConfig): Promise<FlutterCreateResult>;
+/**
+ * 根据项目创建配置解析真正要调用的 Flutter 命令。
+ * 这里保留最小入口：system / fvm / custom flutterBin。
+ */
+/** system 模式：使用本机默认 Flutter，创建链路直接执行 flutter create。 */
+declare function isSystemFlutterSdk(flutterSdk?: FlutterSdkConfig): boolean;
+declare function resolveFlutterCommand(flutterSdk?: FlutterSdkConfig): string;
+/**
+ * VSCode Extension Host 不一定继承用户交互终端的 PATH。
+ * system 模式仍代表“使用本机默认 Flutter”，但执行时优先落到可验证的绝对 flutterBin，
+ * 避免插件创建链路在 `/bin/zsh -lc` 中找不到 `flutter`。
+ */
+declare function resolveSystemFlutterBin(): string | undefined;
+declare function resolveFlutterCreateExecutionPlan(projectDir: string, projectName: string, packageName: string, flutterTemplate?: string, platforms?: string[], flutterSdk?: FlutterSdkConfig): FlutterCreateExecutionPlan;
+declare function validateFvmVersionInput(flutterSdk?: FlutterSdkConfig): string | null;
+declare function parseFlutterCreateSupportedPlatforms(helpText: string): string[];
+declare function findMissingFlutterPlatformDirs(projectDir: string, platforms: string[]): string[];
+declare function bindProjectFlutterSdk(projectDir: string, flutterSdk?: FlutterSdkConfig): Promise<{
+    bound: boolean;
+    message?: string;
+    warning?: string;
+}>;
 /**
  * 运行 flutter pub get
  * @param {string} projectDir - 项目目录
  * @returns {Promise<boolean>} 是否成功
  */
-declare function runFlutterPubGet(projectDir: string): Promise<boolean>;
+declare function runFlutterPubGet(projectDir: string, flutterSdk?: FlutterSdkConfig, options?: {
+    timeoutMs?: number;
+}): Promise<boolean>;
+declare function resolveProjectFlutterCommand(_projectDir: string, flutterSdk?: FlutterSdkConfig): string;
+declare function resolveProjectFlutterCliCommand(projectDir: string, flutterSdk?: FlutterSdkConfig): string;
+declare function resolveProjectFlutterCliCommandForAutomation(projectDir: string, flutterSdk?: FlutterSdkConfig): string;
 /**
  * 检查 Flutter 是否安装
  * @returns {Promise<boolean>} 是否已安装
@@ -619,7 +1379,14 @@ declare function checkFlutterInstalled(): Promise<boolean>;
  */
 declare function getFlutterVersion(): Promise<string | null>;
 
-type BuildPlatform = 'android' | 'ios';
+/**
+ * 规范化 Dart package 名。
+ * 目录名可保留连字符，但 pubspec name、package: import、flutter create --project-name
+ * 都必须使用合法的 Dart package 标识符。
+ */
+declare function normalizeDartPackageName(projectName: string): string;
+
+type BuildPlatform = 'android' | 'ios' | 'harmony';
 declare class BuildManager {
     static build(platform: BuildPlatform, buildConfig: NonNullable<UploadConfig['build']>, projectDir?: string): Promise<BuildResult>;
 }
@@ -666,12 +1433,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 +1463,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, type AuthCapabilityConfig, BUILTIN_TEMPLATES, type Blueprint, type BlueprintEndpoint, type BlueprintFeature, type BlueprintGenerateResult, type BlueprintHttpMethod, type BlueprintPage, type BlueprintPageType, BuildManager, type CapabilityDependencyPlan, CleanupTask, type CompositionProfile, ConfigManager, ConsoleLogger, type CustomTemplate, type FluConfig, type FlutterCreateExecutionPlan, type FlutterCreateResult, type FlutterSdkConfig, type FlutterSdkMode, type GeneratorConfig, type GeneratorConfigType, type GeneratorFieldPolicy, type GeneratorPolicyMode, type GeneratorSelectableOption, type GeneratorSelectableOptionsReport, type GeneratorType, HARMONY_FVM_SETUP_DOC_URL, type HelperDependencyPlan, type HelperName, I18nManager, IOSBuilder, type InitAiBaseStarter, type Logger, type NetworkCapabilityConfig, type NormalizeProjectCreateConfigOptions, type ProjectCapabilitiesConfig, type ProjectCompositionConfig, type ProjectConfig, ProjectConfigManager, type ProjectConfigSource, ProjectConfigTask, ProjectContextService, type ProjectCoreConfig, type ProjectCreateConfig, ProjectGenerator, type ProjectHelpersConfig, type ProjectOptions, type ProjectPlatformConfig, type ProjectPreset, type ProjectStackConfig, type ProjectStructureType, type ProjectTemplate, type ResolvedProjectConfig, type RunInitAiBaseOptions, type RunInitAiBaseReport, type RunInitAiBaseResult, type SerializationCapabilityConfig, StarterScaffoldTask, type StateManagerType, type StorageCapabilityConfig, TemplateGenerator, TemplateManager, TemplatePresetService, type TemplateType, VariablesReplaceTask, bindProjectFlutterSdk, buildInitAiBaseConfig, buildProjectRenderData, calculateRelativeImport, checkFlutterInstalled, checkSnippetsVersion, cleanupTemplateFiles, copyCoreFiles, copyCoreMixins, copyCustomTemplate, copyHelperFiles, copyInfrastructure, copyNetworkFiles, copyStarterProjectScaffold, copyTemplate, createDefaultContext, detectProjectTemplate, ensurePubspecDescription, ensurePubspecName, findMissingFlutterPlatformDirs, fixAndroidPackageName, fixIosBundleIdentifier, generateComponent, generateFromBlueprint, generateIndexFile, generateModel, generateModule, generatePage, generateService, generateViewModel, generateWidget, getArchitectureMode, getCoreFilesDir, getCoreMixinsDir, getEnabledHelperTemplateDirs, getFlutterVersion, getGeneratorFieldPolicy, getHelperExamplesDir, getHelpersDir, getModelPath, getNetworkDir, getPagePath, getRelativeImportPath, getServicePath, getSnippetContent, getStarterProjectDir, getStateManager, getTemplatesRootDir, getViewModelPath, getWidgetPath, injectNetworkExamples, isCustomTemplateProject, isGeneratorFieldLocked, isSystemFlutterSdk, listGeneratorSelectableOptions, loadProjectSnippets, logger, mirrorNestedTargetDir, normalizeCompositionProfile, normalizeDartPackageName, normalizeFlutterCreatePlatform, normalizeFlutterCreatePlatforms, normalizeNetworkEnabled, normalizePlatforms, normalizeProjectCreateConfig, normalizeProjectIdToPackageName, normalizeTemplateType, parseFluCliJsonFromPath, parseFlutterCreateSupportedPlatforms, parseOpenApiToBlueprint, removeTemplateSuffix, renderSnippet, replaceVariables, resolveCapabilityDependencyPlan, resolveConfiguredImport, resolveFlutterCommand, resolveFlutterCreateExecutionPlan, resolveGeneratorBaseDir, resolveGeneratorTargetDir, resolveHelperDependencyPlan, resolveProjectFlutterCliCommand, resolveProjectFlutterCliCommandForAutomation, resolveProjectFlutterCommand, resolveSystemFlutterBin, runFlutterCreate, runFlutterPubGet, runInitAiBase, runInitAiBaseWithReport, sanitizePubspecComments, slugForAgentSkill, syncRules, syncRulesWithReport, t, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase, updateIndexFile, updateNestedIndexExports, upgradeSnippets, validateFvmVersionInput, validateProjectId };