tcdona_unilib 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tcdona_unilib",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Unified dependency aggregation layer for shared libraries",
   "type": "module",
   "sideEffects": false,

package/staticMeta/idupdate.ts

@@ -2,60 +2,76 @@
  * 自动更新所有 fileInit() 调用的路径参数为正确的相对路径
  */
 
-import { fileURLToPath } from 'node:url';
-import { err, ok } from 'neverthrow';
-import type { EffContext } from './eff.js';
-import { Eff } from './eff.js';
-import type { Result } from 'neverthrow';
-import type { SgNode } from '@ast-grep/napi';
-import { fileInit } from './enum.api.js';
-import { extractArgumentValue, findFunctionCalls, hasImport, replaceRanges } from './ast.js';
-import { getRelativePath, parseFileAsync, readFileAsync, scanTypeScriptFilesAsync, writeFileAsync } from './ast.scan.js';
-
-type NonEmptyArray<T> = readonly [T, ...T[]];
+import { fileURLToPath } from "node:url"
+import { err, ok } from "neverthrow"
+import type { EffContext } from "./eff.js"
+import { Eff } from "./eff.js"
+import type { Result } from "neverthrow"
+import type { SgNode } from "@ast-grep/napi"
+import { fileInit } from "./enum.api.js"
+import {
+  extractArgumentValue,
+  findFunctionCalls,
+  hasImport,
+  replaceRanges,
+} from "./ast.js"
+import {
+  getRelativePath,
+  parseFileAsync,
+  readFileAsync,
+  scanTypeScriptFilesAsync,
+  writeFileAsync,
+} from "./ast.scan.js"
+
+type NonEmptyArray<T> = readonly [T, ...T[]]
 
 // ==================== 日志配置 ====================
 
-const fileId = fileInit('staticMeta/idupdate.ts');
+const fileId = fileInit("staticMeta/idupdate.ts")
 
 // ==================== 类型定义 ====================
 
-type UpdateError
-    = | { type: 'VALIDATION_FILENAME_FAILED'; message: string }
-        | { type: 'FILE_ERROR'; message: string; filePath: string };
+type UpdateError =
+  | { type: "VALIDATION_FILENAME_FAILED"; message: string }
+  | { type: "FILE_ERROR"; message: string; filePath: string }
 
 interface StaticMetaCallInfo {
-    startOffset: number;
-    endOffset: number;
-    currentValue: string | null;
+  startOffset: number
+  endOffset: number
+  currentValue: string | null
 }
 
 interface InvalidCall {
-    reason: 'NO_ARGUMENT' | 'VARIABLE_ARGUMENT' | 'TEMPLATE_STRING';
-    line: number;
-    text: string;
+  reason: "NO_ARGUMENT" | "VARIABLE_ARGUMENT" | "TEMPLATE_STRING"
+  line: number
+  text: string
 }
 
 // ==================== 初始化 ====================
 
-const __filename = fileURLToPath(import.meta.url);
+const __filename = fileURLToPath(import.meta.url)
 
 // ==================== 验证 ====================
 
-function validate(): { isErr: () => boolean; isOk: () => boolean; value?: void; error?: UpdateError } {
-    // 验证 staticMeta 功能
-    const currentFileAbsPath = fileURLToPath(import.meta.url);
-    const expectedRelativePath = getRelativePath(currentFileAbsPath);
-
-    const conf = fileId('validate1').conf;
-    if (conf.srcFile !== expectedRelativePath) {
-        return err({
-            type: 'VALIDATION_FILENAME_FAILED',
-            message: `__filename 不正确:\n  期望: ${expectedRelativePath}\n  实际: ${conf.srcFile}`,
-        });
-    }
-
-    return ok(undefined);
+function validate(): {
+  isErr: () => boolean
+  isOk: () => boolean
+  value?: void
+  error?: UpdateError
+} {
+  // 验证 staticMeta 功能
+  const currentFileAbsPath = fileURLToPath(import.meta.url)
+  const expectedRelativePath = getRelativePath(currentFileAbsPath)
+
+  const conf = fileId("validate1").conf
+  if (conf.srcFile !== expectedRelativePath) {
+    return err({
+      type: "VALIDATION_FILENAME_FAILED",
+      message: `__filename 不正确:\n  期望: ${expectedRelativePath}\n  实际: ${conf.srcFile}`,
+    })
+  }
+
+  return ok(undefined)
 }
 
 // ==================== 文件处理 ====================
@@ -64,120 +80,120 @@ function validate(): { isErr: () => boolean; isOk: () => boolean; value?: void;
  * 找出文件中所有 fileInit 调用（有效和无效）
  */
 function findFileInitCalls(
-    root: SgNode,
+  root: SgNode
 ): [StaticMetaCallInfo[], InvalidCall[]] {
-    const validCalls: StaticMetaCallInfo[] = [];
-    const invalidCalls: InvalidCall[] = [];
-
-    const allCalls = findFunctionCalls(root, 'fileInit');
-
-    for (const call of allCalls) {
-        const children = call.children();
-        if (children.length < 2) continue;
-
-        const args = children[1];
-
-        if (args?.kind() !== 'arguments') continue;
-
-        const value = extractArgumentValue(args);
-        const range = call.range();
-
-        if (value === null) {
-            const argText = args.text();
-            let reason: InvalidCall['reason'] = 'NO_ARGUMENT';
-
-            if (argText.includes('`')) {
-                reason = 'TEMPLATE_STRING';
-            } else if (
-                argText.length > 2
-                && !argText.includes('"')
-                && !argText.includes('\'')
-            ) {
-                reason = 'VARIABLE_ARGUMENT';
-            }
-
-            invalidCalls.push({
-                reason,
-                line: range.start.line,
-                text: call.text(),
-            });
-            continue;
-        }
-
-        validCalls.push({
-            startOffset: range.start.index,
-            endOffset: range.end.index,
-            currentValue: value,
-        });
+  const validCalls: StaticMetaCallInfo[] = []
+  const invalidCalls: InvalidCall[] = []
+
+  const allCalls = findFunctionCalls(root, "fileInit")
+
+  for (const call of allCalls) {
+    const children = call.children()
+    if (children.length < 2) continue
+
+    const args = children[1]
+
+    if (args?.kind() !== "arguments") continue
+
+    const value = extractArgumentValue(args)
+    const range = call.range()
+
+    if (value === null) {
+      const argText = args.text()
+      let reason: InvalidCall["reason"] = "NO_ARGUMENT"
+
+      if (argText.includes("`")) {
+        reason = "TEMPLATE_STRING"
+      } else if (
+        argText.length > 2 &&
+        !argText.includes('"') &&
+        !argText.includes("'")
+      ) {
+        reason = "VARIABLE_ARGUMENT"
+      }
+
+      invalidCalls.push({
+        reason,
+        line: range.start.line,
+        text: call.text(),
+      })
+      continue
     }
 
-    return [validCalls, invalidCalls];
+    validCalls.push({
+      startOffset: range.start.index,
+      endOffset: range.end.index,
+      currentValue: value,
+    })
+  }
+
+  return [validCalls, invalidCalls]
 }
 
 /**
  * 更新文件中所有 fileInit 调用的路径参数
  */
 async function updateStaticMeta(
-    filePath: string,
-    content: string,
-    root: SgNode,
-    dryRun: boolean,
-    signal: AbortSignal,
+  filePath: string,
+  content: string,
+  root: SgNode,
+  dryRun: boolean,
+  signal: AbortSignal
 ): Promise<{ isErr: boolean; error?: UpdateError; value?: boolean }> {
-    // 计算正确路径
-    const relativePath = getRelativePath(filePath);
-
-    // 检测导入 fileInit
-    if (!hasImport(root, 'fileInit')) {
-        return { isErr: false, value: false };
-    }
-
-    // 查找 fileInit 调用
-    const [validCalls, invalidCalls] = findFileInitCalls(root);
-
-    // 记录无效调用
-    if (invalidCalls.length > 0) {
-        fileId('invalidFileInitCalls').warn(
-            `⚠️  ${filePath} 包含无效的 fileInit 调用:`,
-        );
-        for (const invalid of invalidCalls) {
-            fileId('invalidFileInitDetail').warn(
-                `  L${invalid.line} [${invalid.reason}]: ${invalid.text}`,
-            );
-        }
-    }
-
-    // 如果没有有效调用则跳过
-    if (validCalls.length === 0) {
-        return { isErr: false, value: false };
+  // 计算正确路径
+  const relativePath = getRelativePath(filePath)
+
+  // 检测导入 fileInit
+  if (!hasImport(root, "fileInit")) {
+    return { isErr: false, value: false }
+  }
+
+  // 查找 fileInit 调用
+  const [validCalls, invalidCalls] = findFileInitCalls(root)
+
+  // 记录无效调用
+  if (invalidCalls.length > 0) {
+    fileId("invalidFileInitCalls").warn(
+      `⚠️  ${filePath} 包含无效的 fileInit 调用:`
+    )
+    for (const invalid of invalidCalls) {
+      fileId("invalidFileInitDetail").warn(
+        `  L${invalid.line} [${invalid.reason}]: ${invalid.text}`
+      )
     }
-
-    // 替换内容
-    const updatedContent = replaceRanges(
-        content,
-        validCalls.map((call) => ({
-            startIndex: call.startOffset,
-            endIndex: call.endOffset,
-            replacement: `fileInit('${relativePath}')`,
-        })),
-    );
-
-    // 写入文件
-    if (!dryRun) {
-        const writeResult = await writeFileAsync(filePath, updatedContent, signal);
-        if (writeResult.isErr()) {
-            return {
-                isErr: true,
-                error: {
-                    type: 'FILE_ERROR',
-                    message: `无法写入文件: ${writeResult.error.message}`,
-                    filePath,
-                },
-            };
-        }
+  }
+
+  // 如果没有有效调用则跳过
+  if (validCalls.length === 0) {
+    return { isErr: false, value: false }
+  }
+
+  // 替换内容
+  const updatedContent = replaceRanges(
+    content,
+    validCalls.map((call) => ({
+      startIndex: call.startOffset,
+      endIndex: call.endOffset,
+      replacement: `fileInit('${relativePath}')`,
+    }))
+  )
+
+  // 写入文件
+  if (!dryRun) {
+    const writeResult = await writeFileAsync(filePath, updatedContent, signal)
+    if (writeResult.isErr()) {
+      return {
+        isErr: true,
+        error: {
+          type: "FILE_ERROR",
+          message: `无法写入文件: ${writeResult.error.message}`,
+          filePath,
+        },
+      }
     }
+  }
 
-    return { isErr: false, value: true };
+  return { isErr: false, value: true }
 }
 
 // ==================== 更新文件执行器 ====================
@@ -186,39 +202,47 @@ async function updateStaticMeta(
  * 为单个文件创建更新任务 executor
  */
 function createUpdateExecutor(
-    file: string,
-    dryRun: boolean,
-): (ctx: EffContext) => Promise<Result<{ updated: boolean; file: string } | null, UpdateError>> {
-    return async ({ signal: innerSignal }: EffContext) => {
-        if (innerSignal.aborted) {
-            return err({ type: 'FILE_ERROR', message: '任务已取消', filePath: file });
-        }
-
-        const readResult = await readFileAsync(file, innerSignal);
-        if (readResult.isErr()) {
-            return err({
-                type: 'FILE_ERROR',
-                message: `无法读取文件: ${readResult.error.message}`,
-                filePath: file,
-            });
-        }
-
-        const parseResult = await parseFileAsync(file, innerSignal);
-        if (parseResult.isErr()) {
-            return err({
-                type: 'FILE_ERROR',
-                message: `AST 解析失败: ${parseResult.error.message}`,
-                filePath: file,
-            });
-        }
-
-        const updateResult = await updateStaticMeta(file, readResult.value, parseResult.value.root, dryRun, innerSignal);
-        if (updateResult.isErr) {
-            return err(updateResult.error!);
-        }
-
-        return ok(updateResult.value ? { updated: true, file } : null);
-    };
+  file: string,
+  dryRun: boolean
+): (
+  ctx: EffContext
+) => Promise<Result<{ updated: boolean; file: string } | null, UpdateError>> {
+  return async ({ signal: innerSignal }: EffContext) => {
+    if (innerSignal.aborted) {
+      return err({ type: "FILE_ERROR", message: "任务已取消", filePath: file })
+    }
+
+    const readResult = await readFileAsync(file, innerSignal)
+    if (readResult.isErr()) {
+      return err({
+        type: "FILE_ERROR",
+        message: `无法读取文件: ${readResult.error.message}`,
+        filePath: file,
+      })
+    }
+
+    const parseResult = await parseFileAsync(file, innerSignal)
+    if (parseResult.isErr()) {
+      return err({
+        type: "FILE_ERROR",
+        message: `AST 解析失败: ${parseResult.error.message}`,
+        filePath: file,
+      })
+    }
+
+    const updateResult = await updateStaticMeta(
+      file,
+      readResult.value,
+      parseResult.value.root,
+      dryRun,
+      innerSignal
+    )
+    if (updateResult.isErr) {
+      return err(updateResult.error!)
+    }
+
+    return ok(updateResult.value ? { updated: true, file } : null)
+  }
 }
 
 // ==================== 结果处理与汇总 ====================
@@ -227,108 +251,124 @@ function createUpdateExecutor(
  * 统计、分类并输出更新结果
  */
 function collectAndPrintResults(
-    results: Result<{ updated: boolean; file: string } | null, UpdateError>[],
-    files: string[],
-    dryRun: boolean,
+  results: Result<{ updated: boolean; file: string } | null, UpdateError>[],
+  files: string[],
+  dryRun: boolean
 ): { updatedFiles: string[]; errors: UpdateError[] } {
-    const updatedFiles: string[] = [];
-    const skippedFiles: string[] = [];
-    const errors: UpdateError[] = [];
-
-    for (let i = 0; i < results.length; i++) {
-        const result = results[i];
-        const file = files[i];
-
-        if (result.isErr()) {
-            errors.push(result.error);
-        } else if (result.value?.updated) {
-            updatedFiles.push(getRelativePath(result.value.file));
-            fileId('updateProgress').info(`  ✓ ${getRelativePath(result.value.file)}`);
-        } else {
-            skippedFiles.push(getRelativePath(file));
-        }
+  const updatedFiles: string[] = []
+  const skippedFiles: string[] = []
+  const errors: UpdateError[] = []
+
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i]
+    const file = files[i]
+
+    if (result.isErr()) {
+      errors.push(result.error)
+    } else if (result.value?.updated) {
+      updatedFiles.push(getRelativePath(result.value.file))
+      fileId("updateProgress").info(`  ✓ ${getRelativePath(result.value.file)}`)
+    } else {
+      skippedFiles.push(getRelativePath(file))
     }
+  }
+
+  // 打印汇总
+  fileId("summaryHeaderLine1").info(`\n${"=".repeat(60)}`)
+  fileId("summaryHeaderLine2").info("更新结果汇总")
+  fileId("summaryHeaderLine3").info(`${"=".repeat(60)}`)
+
+  if (updatedFiles.length > 0) {
+    fileId("updateSuccess").info(
+      `\n✅ ${dryRun ? "将更新" : "已更新"} ${updatedFiles.length} 个文件`
+    )
+  }
+
+  if (skippedFiles.length > 0) {
+    fileId("updateSkipped").info(
+      `⊘ 已跳过 ${skippedFiles.length} 个文件 (无 fileInit 调用)`
+    )
+  }
+
+  if (errors.length > 0) {
+    fileId("updateFailed").error(`\n❌ 更新失败 ${errors.length} 个文件:`)
+    for (const error of errors) {
+      const filePath = error.type === "FILE_ERROR" ? error.filePath : "(验证)"
+      const message = error.message
+      fileId("updateErrorPath").error(`   ${filePath}`)
+      fileId("updateErrorMessage").error(`     └─ ${message}`)
+    }
+  }
 
-    // 打印汇总
-    fileId('summaryHeaderLine1').info(`\n${'='.repeat(60)}`);
-    fileId('summaryHeaderLine2').info('更新结果汇总');
-    fileId('summaryHeaderLine3').info(`${'='.repeat(60)}`);
+  fileId("summaryFooter").info(`${"=".repeat(60)}\n`)
 
-    if (updatedFiles.length > 0) {
-        fileId('updateSuccess').info(
-            `\n✅ ${dryRun ? '将更新' : '已更新'} ${updatedFiles.length} 个文件`,
-        );
-    }
+  return { updatedFiles, errors }
+}
 
-    if (skippedFiles.length > 0) {
-        fileId('updateSkipped').info(
-            `⊘ 已跳过 ${skippedFiles.length} 个文件 (无 fileInit 调用)`,
-        );
-    }
+// ==================== 主函数 ====================
 
-    if (errors.length > 0) {
-        fileId('updateFailed').error(`\n❌ 更新失败 ${errors.length} 个文件:`);
-        for (const error of errors) {
-            const filePath = error.type === 'FILE_ERROR' ? error.filePath : '(验证)';
-            const message = error.message;
-            fileId('updateErrorPath').error(`   ${filePath}`);
-            fileId('updateErrorMessage').error(`     └─ ${message}`);
-        }
+const main = () => {
+  return Eff.root(async ({ signal }) => {
+    if (signal.aborted) return err(new Error("操作已取消"))
+
+    const args = process.argv.slice(2)
+    const dryRun = args.includes("--dry-run") || args.includes("-n")
+
+    // 验证 staticMeta 功能
+    // const validationResult = validate();
+    // if (validationResult.isErr?.()) {
+    //     fileId('validateFailed').error(
+    //         '验证失败:',
+    //         (validationResult as any).error.message,
+    //     );
+    // // 下面的这个 as any 会让类型推断中断，从而无法保证，return 后面的所有语句的推导正确性，再一次证明了 as any 要少用
+    //     return err((validationResult as any).error);
+    // }
+
+    // 扫描文件
+    const files = await scanTypeScriptFilesAsync(["**/staticMeta/idupdate.ts"])
+    fileId("updateStart").info(
+      `开始更新 fileInit... (共 ${files.length} 个文件)\n`
+    )
+
+    if (files.length === 0) {
+      return ok(undefined)
     }
 
-    fileId('summaryFooter').info(`${'='.repeat(60)}\n`);
+    // 创建并行更新任务
+    type UpdateResult = { updated: boolean; file: string } | null
+    const executors = files.map((file) =>
+      createUpdateExecutor(file, dryRun)
+    ) as unknown as NonEmptyArray<
+      (ctx: EffContext) => Promise<Result<UpdateResult, UpdateError>>
+    >
 
-    return { updatedFiles, errors };
-}
+    // 执行并行更新
+    const allResults = await Eff.allSettled(executors, signal)
+    const results = allResults.isOk() ? allResults.value : []
 
-// ==================== 主函数 ====================
+    // 统计结果并输出汇总
+    const { errors } = collectAndPrintResults(results, files, dryRun)
 
-const main = () => {
-    return Eff.root(async ({ signal }) => {
-        if (signal.aborted) return err(new Error('操作已取消'));
-
-        const args = process.argv.slice(2);
-        const dryRun = args.includes('--dry-run') || args.includes('-n');
-
-        // 验证 staticMeta 功能
-        const validationResult = validate();
-        if (validationResult.isErr?.()) {
-            fileId('validateFailed').error(
-                '验证失败:',
-                (validationResult as any).error.message,
-            );
-            return err((validationResult as any).error);
-        }
-
-        // 扫描文件
-        const files = await scanTypeScriptFilesAsync(['**/staticMeta/idupdate.ts']);
-        fileId('updateStart').info(`开始更新 fileInit... (共 ${files.length} 个文件)\n`);
-
-        if (files.length === 0) {
-            return ok(undefined);
-        }
-
-        // 创建并行更新任务
-        type UpdateResult = { updated: boolean; file: string } | null;
-        const executors = files.map((file) =>
-            createUpdateExecutor(file, dryRun),
-        ) as unknown as NonEmptyArray<(ctx: EffContext) => Promise<Result<UpdateResult, UpdateError>>>;
-
-        // 执行并行更新
-        const allResults = await Eff.allSettled(executors, signal);
-        const results = allResults.isOk() ? allResults.value : [];
-
-        // 统计结果并输出汇总
-        const { errors } = collectAndPrintResults(results, files, dryRun);
-
-        return errors.length > 0 ? err(errors[0]) : ok(undefined);
-    });
-};
+    if (errors.length > 0) {
+      const error = errors[0]
+      const message =
+        error.type === "FILE_ERROR"
+          ? `${error.message} (${error.filePath})`
+          : error.message
+      return err(new Error(message))
+    }
+
+    return ok(undefined)
+  })
+}
 
 main().match(
-    () => { /* success */ },
-    (err) => {
-        fileId('scriptFailed').error(`脚本执行失败: ${err.message ?? String(err)}`);
-        process.exit(1);
-    },
-);
+  () => {
+    /* success */
+  },
+  (err) => {
+    fileId("scriptFailed").error(`脚本执行失败: ${err.message ?? String(err)}`)
+    process.exit(1)
+  }
+)