flu-cli 2.0.5 → 2.1.0

package/lib/utils/index_updater.js

@@ -3,67 +3,66 @@
  * 自动更新目录的 index.dart 导出文件
  */
 
-import { existsSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { logger } from './logger.js';
+import { existsSync, readFileSync, writeFileSync } from 'fs'
+import { join } from 'path'
+import { logger } from './logger.js'
 
 /**
  * 更新 index.dart 文件
  * @param {string} dirPath - 目录路径
  * @param {string} fileName - 要添加的文件名
  */
-export function updateIndexFile (dirPath, fileName) {
+export function updateIndexFile(dirPath, fileName) {
   try {
-    const indexPath = join(dirPath, 'index.dart');
+    const indexPath = join(dirPath, 'index.dart')
 
     // 如果 index.dart 不存在,不做处理
     if (!existsSync(indexPath)) {
-      return false;
+      return false
     }
 
     // 读取现有内容
-    let content = readFileSync(indexPath, 'utf8');
+    let content = readFileSync(indexPath, 'utf8')
 
     // 检查是否已经导出
-    const exportStatement = `export '${fileName}';`;
+    const exportStatement = `export '${fileName}';`
     if (content.includes(exportStatement)) {
-      return false; // 已经存在,不需要更新
+      return false // 已经存在,不需要更新
     }
 
     // 找到注释行后添加导出语句
-    const lines = content.split('\n');
-    let insertIndex = -1;
+    const lines = content.split('\n')
+    let insertIndex = -1
 
     // 找到第一个注释行之后的位置
     for (let i = 0; i < lines.length; i++) {
       if (lines[i].trim().startsWith('//')) {
-        insertIndex = i + 1;
-        break;
+        insertIndex = i + 1
+        break
       }
     }
 
     // 如果没找到注释,添加到末尾
     if (insertIndex === -1) {
-      insertIndex = lines.length;
+      insertIndex = lines.length
     }
 
     // 跳过空行
     while (insertIndex < lines.length && lines[insertIndex].trim() === '') {
-      insertIndex++;
+      insertIndex++
     }
 
     // 插入导出语句
-    lines.splice(insertIndex, 0, exportStatement);
+    lines.splice(insertIndex, 0, exportStatement)
 
     // 写回文件
-    content = lines.join('\n');
-    writeFileSync(indexPath, content, 'utf8');
-
-    logger.info(`已更新 index.dart: ${exportStatement}`);
-    return true;
+    content = lines.join('\n')
+    writeFileSync(indexPath, content, 'utf8')
 
+    logger.info(`已更新 index.dart: ${exportStatement}`)
+    return true
   } catch (error) {
-    logger.warn(`更新 index.dart 失败: ${error.message}`);
-    return false;
+    logger.warn(`更新 index.dart 失败: ${error.message}`)
+    return false
   }
 }

package/lib/utils/json-output.js

@@ -0,0 +1,59 @@
+export function isJsonMode(options) {
+  return options?.json === true
+}
+
+export function createNullLogger() {
+  return {
+    info() {},
+    success() {},
+    warn() {},
+    error() {},
+    title() {},
+    newLine() {},
+  }
+}
+
+export function buildJsonEnvelope(command, ok, diagnostics, data) {
+  return {
+    ok: ok === true,
+    command,
+    diagnostics: Array.isArray(diagnostics) ? diagnostics : [],
+    data: data ?? null,
+  }
+}
+
+export function printJsonEnvelope(envelope) {
+  console.log(JSON.stringify(envelope, null, 2))
+}
+
+export async function runMuted(action) {
+  const prevLog = console.log
+  const prevInfo = console.info
+  const prevWarn = console.warn
+  const prevError = console.error
+  const prevStdoutWrite = process.stdout.write
+  const prevStderrWrite = process.stderr.write
+
+  const mute = () => true
+  console.log = mute
+  console.info = mute
+  console.warn = mute
+  console.error = mute
+  process.stdout.write = mute
+  process.stderr.write = mute
+
+  try {
+    const res = await action()
+    return { ok: true, result: res }
+  } catch (e) {
+    const message = e?.message ? String(e.message) : String(e)
+    return { ok: false, error: message }
+  } finally {
+    console.log = prevLog
+    console.info = prevInfo
+    console.warn = prevWarn
+    console.error = prevError
+    process.stdout.write = prevStdoutWrite
+    process.stderr.write = prevStderrWrite
+  }
+}

package/lib/utils/logger.js

@@ -3,55 +3,55 @@
  * 统一的日志输出格式
  */
 
-import chalk from 'chalk';
+import chalk from 'chalk'
 
 export const logger = {
   /**
    * 成功信息
    */
-  success (message) {
-    console.log(chalk.green('✅ ' + message));
+  success(message) {
+    console.log(chalk.green('✅ ' + message))
   },
 
   /**
    * 错误信息
    */
-  error (message) {
-    console.log(chalk.red('❌ ' + message));
+  error(message) {
+    console.log(chalk.red('❌ ' + message))
   },
 
   /**
    * 警告信息
    */
-  warn (message) {
-    console.log(chalk.yellow('⚠️  ' + message));
+  warn(message) {
+    console.log(chalk.yellow('⚠️  ' + message))
   },
 
   /**
    * 信息
    */
-  info (message) {
-    console.log(chalk.blue('ℹ️  ' + message));
+  info(message) {
+    console.log(chalk.blue('ℹ️  ' + message))
   },
 
   /**
    * 标题
    */
-  title (message) {
-    console.log(chalk.bold.cyan('\n' + message + '\n'));
+  title(message) {
+    console.log(chalk.bold.cyan('\n' + message + '\n'))
   },
 
   /**
    * 分隔线
    */
-  divider () {
-    console.log(chalk.gray('─'.repeat(60)));
+  divider() {
+    console.log(chalk.gray('─'.repeat(60)))
   },
 
   /**
    * 空行
    */
-  newLine () {
-    console.log('');
-  }
-};
+  newLine() {
+    console.log('')
+  },
+}

package/lib/utils/project_detector.js

@@ -3,59 +3,59 @@
  * 职责：基于目录结构识别 lite/modular/clean 模板，并提供生成路径解析
  */
 
-import { existsSync } from 'fs';
-import { join } from 'path';
+import { existsSync } from 'fs'
+import { join } from 'path'
 
 /**
  * 检测项目模板类型
  * @param {string} projectDir - 项目目录
  * @returns {'lite'|'modular'|'clean'|null} 模板类型
  */
-export function detectProjectTemplate (projectDir = process.cwd()) {
+export function detectProjectTemplate(projectDir = process.cwd()) {
   try {
-    const libDir = join(projectDir, 'lib');
+    const libDir = join(projectDir, 'lib')
 
     if (!existsSync(libDir)) {
-      return null;
+      return null
     }
 
     // 检测 Clean 架构特征
     // Clean 架构有 features/xxx/data, features/xxx/domain, features/xxx/presentation
-    const featuresDir = join(libDir, 'features');
+    const featuresDir = join(libDir, 'features')
     if (existsSync(featuresDir)) {
       // 检查是否有 data/domain/presentation 三层结构
-      const coreDir = join(libDir, 'core');
-      const hasUsecases = existsSync(join(coreDir, 'usecases'));
-      const hasErrors = existsSync(join(coreDir, 'errors'));
+      const coreDir = join(libDir, 'core')
+      const hasUsecases = existsSync(join(coreDir, 'usecases'))
+      const hasErrors = existsSync(join(coreDir, 'errors'))
 
       if (hasUsecases && hasErrors) {
-        return 'clean';
+        return 'clean'
       }
 
       // 检测 Modular 架构特征
       // Modular 架构有 core/base, core/router, shared
-      const hasBase = existsSync(join(coreDir, 'base'));
-      const hasRouter = existsSync(join(coreDir, 'router'));
-      const sharedDir = existsSync(join(libDir, 'shared'));
+      const hasBase = existsSync(join(coreDir, 'base'))
+      const hasRouter = existsSync(join(coreDir, 'router'))
+      const sharedDir = existsSync(join(libDir, 'shared'))
 
       if (hasBase && hasRouter && sharedDir) {
-        return 'modular';
+        return 'modular'
       }
     }
 
     // 检测 Lite 架构特征
     // Lite 架构有 pages, viewmodels, widgets 等扁平目录
-    const pagesDir = join(libDir, 'pages');
-    const viewmodelsDir = join(libDir, 'viewmodels');
-    const widgetsDir = join(libDir, 'widgets');
+    const pagesDir = join(libDir, 'pages')
+    const viewmodelsDir = join(libDir, 'viewmodels')
+    const widgetsDir = join(libDir, 'widgets')
 
     if (existsSync(pagesDir) && existsSync(viewmodelsDir) && existsSync(widgetsDir)) {
-      return 'lite';
+      return 'lite'
     }
 
-    return null;
+    return null
   } catch (error) {
-    return null;
+    return null
   }
 }
 
@@ -65,21 +65,21 @@ export function detectProjectTemplate (projectDir = process.cwd()) {
  * @param {string} moduleName - 模块名称
  * @returns {string} 页面目录路径
  */
-export function getPagePath (projectDir, moduleName) {
-  const template = detectProjectTemplate(projectDir);
+export function getPagePath(projectDir, moduleName) {
+  const template = detectProjectTemplate(projectDir)
 
   switch (template) {
     case 'lite':
-      return join(projectDir, 'lib', 'pages');
+      return join(projectDir, 'lib', 'pages')
 
     case 'modular':
-      return join(projectDir, 'lib', 'features', moduleName, 'pages');
+      return join(projectDir, 'lib', 'features', moduleName, 'pages')
 
     case 'clean':
-      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'pages');
+      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'pages')
 
     default:
-      return join(projectDir, 'lib', 'pages');
+      return join(projectDir, 'lib', 'pages')
   }
 }
 
@@ -89,21 +89,21 @@ export function getPagePath (projectDir, moduleName) {
  * @param {string} moduleName - 模块名称
  * @returns {string} ViewModel 目录路径
  */
-export function getViewModelPath (projectDir, moduleName) {
-  const template = detectProjectTemplate(projectDir);
+export function getViewModelPath(projectDir, moduleName) {
+  const template = detectProjectTemplate(projectDir)
 
   switch (template) {
     case 'lite':
-      return join(projectDir, 'lib', 'viewmodels');
+      return join(projectDir, 'lib', 'viewmodels')
 
     case 'modular':
-      return join(projectDir, 'lib', 'features', moduleName, 'viewmodels');
+      return join(projectDir, 'lib', 'features', moduleName, 'viewmodels')
 
     case 'clean':
-      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'viewmodels');
+      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'viewmodels')
 
     default:
-      return join(projectDir, 'lib', 'viewmodels');
+      return join(projectDir, 'lib', 'viewmodels')
   }
 }
 
@@ -113,27 +113,27 @@ export function getViewModelPath (projectDir, moduleName) {
  * @param {string} moduleName - 模块名称（可选）
  * @returns {string} Widget 目录路径
  */
-export function getWidgetPath (projectDir, moduleName = null) {
-  const template = detectProjectTemplate(projectDir);
+export function getWidgetPath(projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir)
 
   switch (template) {
     case 'lite':
-      return join(projectDir, 'lib', 'widgets');
+      return join(projectDir, 'lib', 'widgets')
 
     case 'modular':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'widgets');
+        return join(projectDir, 'lib', 'features', moduleName, 'widgets')
       }
-      return join(projectDir, 'lib', 'shared', 'widgets');
+      return join(projectDir, 'lib', 'shared', 'widgets')
 
     case 'clean':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'widgets');
+        return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'widgets')
       }
-      return join(projectDir, 'lib', 'shared', 'widgets');
+      return join(projectDir, 'lib', 'shared', 'widgets')
 
     default:
-      return join(projectDir, 'lib', 'widgets');
+      return join(projectDir, 'lib', 'widgets')
   }
 }
 
@@ -143,27 +143,27 @@ export function getWidgetPath (projectDir, moduleName = null) {
  * @param {string} moduleName - 模块名称（可选）
  * @returns {string} Service 目录路径
  */
-export function getServicePath (projectDir, moduleName = null) {
-  const template = detectProjectTemplate(projectDir);
+export function getServicePath(projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir)
 
   switch (template) {
     case 'lite':
-      return join(projectDir, 'lib', 'services');
+      return join(projectDir, 'lib', 'services')
 
     case 'modular':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'services');
+        return join(projectDir, 'lib', 'features', moduleName, 'services')
       }
-      return join(projectDir, 'lib', 'shared', 'services');
+      return join(projectDir, 'lib', 'shared', 'services')
 
     case 'clean':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'data', 'datasources');
+        return join(projectDir, 'lib', 'features', moduleName, 'data', 'datasources')
       }
-      return join(projectDir, 'lib', 'core', 'network');
+      return join(projectDir, 'lib', 'core', 'network')
 
     default:
-      return join(projectDir, 'lib', 'services');
+      return join(projectDir, 'lib', 'services')
   }
 }
 
@@ -173,27 +173,27 @@ export function getServicePath (projectDir, moduleName = null) {
  * @param {string} moduleName - 模块名称（可选）
  * @returns {string} Model 目录路径
  */
-export function getModelPath (projectDir, moduleName = null) {
-  const template = detectProjectTemplate(projectDir);
+export function getModelPath(projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir)
 
   switch (template) {
     case 'lite':
-      return join(projectDir, 'lib', 'models');
+      return join(projectDir, 'lib', 'models')
 
     case 'modular':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'models');
+        return join(projectDir, 'lib', 'features', moduleName, 'models')
       }
-      return join(projectDir, 'lib', 'shared', 'models');
+      return join(projectDir, 'lib', 'shared', 'models')
 
     case 'clean':
       if (moduleName) {
-        return join(projectDir, 'lib', 'features', moduleName, 'data', 'models');
+        return join(projectDir, 'lib', 'features', moduleName, 'data', 'models')
       }
-      return join(projectDir, 'lib', 'shared', 'models');
+      return join(projectDir, 'lib', 'shared', 'models')
 
     default:
-      return join(projectDir, 'lib', 'models');
+      return join(projectDir, 'lib', 'models')
   }
 }
 
@@ -203,25 +203,25 @@ export function getModelPath (projectDir, moduleName = null) {
  * @param {string} toPath - 目标文件路径
  * @returns {string} 相对路径
  */
-export function getRelativeImportPath (fromPath, toPath) {
-  const fromParts = fromPath.split('/');
-  const toParts = toPath.split('/');
+export function getRelativeImportPath(fromPath, toPath) {
+  const fromParts = fromPath.split('/')
+  const toParts = toPath.split('/')
 
   // 找到共同的父目录
-  let commonIndex = 0;
+  let commonIndex = 0
   while (commonIndex < fromParts.length && commonIndex < toParts.length) {
     if (fromParts[commonIndex] !== toParts[commonIndex]) {
-      break;
+      break
     }
-    commonIndex++;
+    commonIndex++
   }
 
   // 计算需要返回的层级
-  const upLevels = fromParts.length - commonIndex - 1;
-  const upPath = '../'.repeat(upLevels);
+  const upLevels = fromParts.length - commonIndex - 1
+  const upPath = '../'.repeat(upLevels)
 
   // 计算目标路径
-  const targetPath = toParts.slice(commonIndex).join('/');
+  const targetPath = toParts.slice(commonIndex).join('/')
 
-  return upPath + targetPath;
+  return upPath + targetPath
 }

package/lib/utils/snippet_loader.js

@@ -1,32 +1,34 @@
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import JSON5 from 'json5';
+import { existsSync, readFileSync } from 'fs'
+import { join } from 'path'
+import JSON5 from 'json5'
 
 // 读取项目片段文件
-export function loadProjectSnippets (projectDir) {
+export function loadProjectSnippets(projectDir) {
   try {
-    const snippetsPath = join(projectDir, '.vscode', 'dart.code-snippets');
-    if (!existsSync(snippetsPath)) return {};
-    const raw = readFileSync(snippetsPath, 'utf8');
-    const json = JSON5.parse(raw);
-    return json || {};
+    const snippetsPath = join(projectDir, '.vscode', 'dart.code-snippets')
+    if (!existsSync(snippetsPath)) return {}
+    const raw = readFileSync(snippetsPath, 'utf8')
+    const json = JSON5.parse(raw)
+    return json || {}
   } catch (_) {
-    return {};
+    return {}
   }
 }
 
 // 渲染片段内容
-export function renderSnippet (bodyLines, variables) {
-  const body = Array.isArray(bodyLines) ? bodyLines.join('\n') : String(bodyLines || '');
+export function renderSnippet(bodyLines, variables) {
+  const body = Array.isArray(bodyLines) ? bodyLines.join('\n') : String(bodyLines || '')
   return body.replace(/\{\{(\w+)\}\}/g, (_, key) => {
-    return Object.prototype.hasOwnProperty.call(variables, key) ? String(variables[key]) : `{{${key}}}`;
-  });
+    return Object.prototype.hasOwnProperty.call(variables, key)
+      ? String(variables[key])
+      : `{{${key}}}`
+  })
 }
 
 // 简便方法：按 key 获取片段并渲染
-export function getSnippetContent (projectDir, key, variables) {
-  const map = loadProjectSnippets(projectDir);
-  const item = map[key];
-  if (!item || !item.body) return null;
-  return renderSnippet(item.body, variables);
+export function getSnippetContent(projectDir, key, variables) {
+  const map = loadProjectSnippets(projectDir)
+  const item = map[key]
+  if (!item || !item.body) return null
+  return renderSnippet(item.body, variables)
 }

package/lib/utils/string_helper.js

@@ -6,51 +6,51 @@
  * 转换为 PascalCase
  * home_page -> HomePage
  */
-export function toPascalCase (str) {
+export function toPascalCase(str) {
   return str
     .split(/[-_\s]+/)
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-    .join('');
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('')
 }
 
 /**
  * 转换为 snake_case
  * HomePage -> home_page
  */
-export function toSnakeCase (str) {
+export function toSnakeCase(str) {
   return str
     .replace(/([A-Z])/g, '_$1')
     .toLowerCase()
-    .replace(/^_/, '');
+    .replace(/^_/, '')
 }
 
 /**
  * 转换为 camelCase
  * home_page -> homePage
  */
-export function toCamelCase (str) {
-  const pascal = toPascalCase(str);
-  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+export function toCamelCase(str) {
+  const pascal = toPascalCase(str)
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1)
 }
 
 /**
  * 转换为 Title Case
  * home_page -> Home Page
  */
-export function toTitleCase (str) {
+export function toTitleCase(str) {
   return str
     .split(/[-_\s]+/)
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-    .join(' ');
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(' ')
 }
 
 /**
  * 转换为 kebab-case
  * HomePage -> home-page
  */
-export function toKebabCase (str) {
+export function toKebabCase(str) {
   return str
     .replace(/([A-Z])/g, '-$1')
     .toLowerCase()
-    .replace(/^-/, '');
+    .replace(/^-/, '')
 }