@vureact/compiler-core 1.3.0 → 1.4.0

package/lib/{chunk-CUCUXW56.esm.js → chunk-NF5BSPYE.esm.js}

@@ -1,5 +1,5 @@
 /**
- * @vureact/compiler-core v1.3.0
+ * @vureact/compiler-core v1.4.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -32,6 +32,16 @@ var PACKAGE_NAME = {
   runtime: "@vureact/runtime-core",
   router: "@vureact/router"
 };
+var RUNTIME_PACKAGES = {
+  router: {
+    name: PACKAGE_NAME.router,
+    version: "^1.0.0"
+  },
+  runtime: {
+    name: PACKAGE_NAME.runtime,
+    version: "^1.0.0"
+  }
+};
 var STYLE_MODULE_NAME = "$style";
 var MACRO_API_NAMES = {
   props: "defineProps",
@@ -418,8 +428,8 @@ function getBabelParseOptions(lang = "js", context = "script", filename) {
 function stringToExpr(input, lang, filename = "") {
   return parseExpression(input, getBabelParseOptions(lang, "expression", filename));
 }
-function atComponentOrHookRoot(path8, rootScope, inScriptFile = false) {
-  const { parentPath, scope } = path8;
+function atComponentOrHookRoot(path9, rootScope, inScriptFile = false) {
+  const { parentPath, scope } = path9;
   const parentBlock = scope.block;
   if (!parentPath) return !inScriptFile;
   if (parentBlock === rootScope) {
@@ -1650,9 +1660,9 @@ function resolveScriptMeta(result, ctx) {
   const scriptAST = result.script?.ast;
   if (!scriptAST) return;
   traverse(scriptAST, {
-    VariableDeclarator(path8) {
-      const { node } = path8;
-      if (!atComponentOrHookRoot(path8, scriptAST.program) || !t16.isIdentifier(node.id)) {
+    VariableDeclarator(path9) {
+      const { node } = path9;
+      if (!atComponentOrHookRoot(path9, scriptAST.program) || !t16.isIdentifier(node.id)) {
         return;
       }
       if (node.init && t16.isCallExpression(node.init) && t16.isIdentifier(node.init.callee)) {
@@ -1986,36 +1996,36 @@ function insertRequiredImports(ctx) {
   const processedModules = /* @__PURE__ */ new Set();
   let hasProcessedImports = false;
   recordImport(ctx, PACKAGE_NAME.react, REACT_API_MAP.memo);
-  function resolveRequiredImport(path8) {
-    const { node } = path8;
+  function resolveRequiredImport(path9) {
+    const { node } = path9;
     const moduleName = node.source.value.toLowerCase();
     const isVueLike = isVueEcosystemPackage(moduleName);
     mergeImports(node, ctx);
-    if (processedModules.has(moduleName) && !path8.removed) {
-      path8.remove();
+    if (processedModules.has(moduleName) && !path9.removed) {
+      path9.remove();
       return;
     }
     processedModules.add(moduleName);
     if (!hasProcessedImports) {
       const required = createRequiredImports(ctx);
       if (isVueLike) {
-        path8.replaceWithMultiple(required);
+        path9.replaceWithMultiple(required);
       } else if (moduleName === PACKAGE_NAME.react) {
-        path8.insertAfter(required);
+        path9.insertAfter(required);
       } else {
-        path8.insertBefore(required);
+        path9.insertBefore(required);
       }
       hasProcessedImports = true;
     }
-    if (isVueLike && !path8.removed) {
-      path8.remove();
+    if (isVueLike && !path9.removed) {
+      path9.remove();
       return;
     }
     replaceVueSuffix(ctx, node.source);
   }
-  function resolveStyleFileExt(path8) {
+  function resolveStyleFileExt(path9) {
     if (!ctx.preprocessStyles) return;
-    const { node } = path8;
+    const { node } = path9;
     if (!node || !node.source || !node.source.value) return;
     const importSource = node.source.value;
     if (typeof importSource !== "string") return;
@@ -2027,16 +2037,16 @@ function insertRequiredImports(ctx) {
   return {
     // 增加 Program.exit 兜底注入 required imports（处理无 ImportDeclaration 的 SFC）
     Program: {
-      exit(path8) {
+      exit(path9) {
         if (hasProcessedImports) return;
         const required = createRequiredImports(ctx);
-        path8.unshiftContainer("body", required);
+        path9.unshiftContainer("body", required);
         hasProcessedImports = true;
       }
     },
-    ImportDeclaration(path8) {
-      resolveRequiredImport(path8);
-      resolveStyleFileExt(path8);
+    ImportDeclaration(path9) {
+      resolveRequiredImport(path9);
+      resolveStyleFileExt(path9);
     }
   };
 }
@@ -2107,10 +2117,10 @@ import * as t20 from "@babel/types";
 
 // src/core/transform/sfc/script/shared/babel-utils.ts
 import * as t19 from "@babel/types";
-function findRootVariablePath(path8) {
-  const rootId = findRootIdentifier(path8.node);
+function findRootVariablePath(path9) {
+  const rootId = findRootIdentifier(path9.node);
   if (!rootId?.name) return null;
-  const binding = path8.scope.getBinding(rootId.name);
+  const binding = path9.scope.getBinding(rootId.name);
   if (!binding) return null;
   const rootPath = getVariableDeclaratorPath(binding.path);
   return rootPath;
@@ -2122,14 +2132,14 @@ function findRootIdentifier(node) {
   }
   return t19.isIdentifier(current) ? current : null;
 }
-function getVariableDeclaratorPath(path8) {
-  if (path8.isVariableDeclarator()) {
-    return path8;
+function getVariableDeclaratorPath(path9) {
+  if (path9.isVariableDeclarator()) {
+    return path9;
   }
-  return path8.findParent((p) => p.isVariableDeclarator());
+  return path9.findParent((p) => p.isVariableDeclarator());
 }
-function isVariableDeclTopLevel(path8) {
-  const variableDeclaratorPath = path8;
+function isVariableDeclTopLevel(path9) {
+  const variableDeclaratorPath = path9;
   const variableDeclarationPath = variableDeclaratorPath.parentPath;
   if (!variableDeclarationPath) {
     return false;
@@ -2143,61 +2153,61 @@ function isVariableDeclTopLevel(path8) {
   }
   return false;
 }
-function isRealVariableAccess(path8) {
-  return isIdentifierAccess(path8) && !isPropertyName(path8);
+function isRealVariableAccess(path9) {
+  return isIdentifierAccess(path9) && !isPropertyName(path9);
 }
-function isIdentifierAccess(path8) {
-  if (isIdentifierDeclaration(path8)) {
+function isIdentifierAccess(path9) {
+  if (isIdentifierDeclaration(path9)) {
     return false;
   }
-  const binding = path8.scope.getBinding(path8.node.name);
+  const binding = path9.scope.getBinding(path9.node.name);
   if (!binding) {
     return true;
   }
-  return binding.identifier !== path8.node;
+  return binding.identifier !== path9.node;
 }
-function isIdentifierDeclaration(path8) {
-  const parent = path8.parentPath;
+function isIdentifierDeclaration(path9) {
+  const parent = path9.parentPath;
   if (!parent) return false;
-  if (parent.isVariableDeclarator() && parent.node.id === path8.node) {
+  if (parent.isVariableDeclarator() && parent.node.id === path9.node) {
     return true;
   }
-  if (parent.isFunctionDeclaration() && parent.node.id === path8.node) {
+  if (parent.isFunctionDeclaration() && parent.node.id === path9.node) {
     return true;
   }
-  if (parent.isFunctionExpression() && parent.node.id === path8.node) {
+  if (parent.isFunctionExpression() && parent.node.id === path9.node) {
     return true;
   }
-  if (parent.isClassDeclaration() && parent.node.id === path8.node) {
+  if (parent.isClassDeclaration() && parent.node.id === path9.node) {
     return true;
   }
-  if (parent.isImportSpecifier() && parent.node.local === path8.node) {
+  if (parent.isImportSpecifier() && parent.node.local === path9.node) {
     return true;
   }
-  if (parent.isImportDefaultSpecifier() && parent.node.local === path8.node) {
+  if (parent.isImportDefaultSpecifier() && parent.node.local === path9.node) {
     return true;
   }
-  if (parent.isImportNamespaceSpecifier() && parent.node.local === path8.node) {
+  if (parent.isImportNamespaceSpecifier() && parent.node.local === path9.node) {
     return true;
   }
-  if (parent.isFunction() && parent.node.params.includes(path8.node)) {
+  if (parent.isFunction() && parent.node.params.includes(path9.node)) {
     return true;
   }
-  if (parent.isCatchClause() && parent.node.param === path8.node) {
+  if (parent.isCatchClause() && parent.node.param === path9.node) {
     return true;
   }
   return false;
 }
-function isPropertyName(path8) {
-  const parent = path8.parentPath;
+function isPropertyName(path9) {
+  const parent = path9.parentPath;
   if (!parent) return false;
-  if (parent.isObjectProperty() && parent.node.key === path8.node) {
+  if (parent.isObjectProperty() && parent.node.key === path9.node) {
     return true;
   }
-  if (parent.isClassProperty() && parent.node.key === path8.node) {
+  if (parent.isClassProperty() && parent.node.key === path9.node) {
     return true;
   }
-  if (parent.isMemberExpression() && parent.node.property === path8.node) {
+  if (parent.isMemberExpression() && parent.node.property === path9.node) {
     return true;
   }
   return false;
@@ -2308,26 +2318,26 @@ function resolveStaticHoisting(ctx) {
     return {};
   }
   return {
-    "ImportDeclaration|ExportDeclaration"(path8) {
-      if (t20.isImportDeclaration(path8.node)) {
-        scriptIR.imports.push(path8.node);
-      } else if (t20.isExportDeclaration(path8.node)) {
-        scriptIR.exports.push(path8.node);
+    "ImportDeclaration|ExportDeclaration"(path9) {
+      if (t20.isImportDeclaration(path9.node)) {
+        scriptIR.imports.push(path9.node);
+      } else if (t20.isExportDeclaration(path9.node)) {
+        scriptIR.exports.push(path9.node);
       }
-      path8.remove();
+      path9.remove();
     },
-    "TSInterfaceDeclaration|TSTypeAliasDeclaration|TSEnumDeclaration|TSModuleDeclaration|TSModuleDeclaration"(path8) {
-      if (t20.isProgram(path8.parent)) {
-        scriptIR.tsTypes.push(path8.node);
-        path8.remove();
+    "TSInterfaceDeclaration|TSTypeAliasDeclaration|TSEnumDeclaration|TSModuleDeclaration|TSModuleDeclaration"(path9) {
+      if (t20.isProgram(path9.parent)) {
+        scriptIR.tsTypes.push(path9.node);
+        path9.remove();
       }
     },
-    VariableDeclarator(path8) {
-      const { node } = path8;
-      if (!isVariableDeclTopLevel(path8) || !isSimpleLiteral(node.init) || getScriptNodeMeta(node)) {
+    VariableDeclarator(path9) {
+      const { node } = path9;
+      if (!isVariableDeclTopLevel(path9) || !isSimpleLiteral(node.init) || getScriptNodeMeta(node)) {
         return;
       }
-      const declarationPath = path8.findParent((p) => p.isVariableDeclaration());
+      const declarationPath = path9.findParent((p) => p.isVariableDeclaration());
       if (!declarationPath) return;
       scriptIR.statement.global.push(declarationPath.node);
       declarationPath.remove();
@@ -2344,14 +2354,14 @@ function collectLocalStatements(ctx, ast) {
 import * as t21 from "@babel/types";
 function resolveDefineAsyncComponent(ctx) {
   return {
-    CallExpression(path8) {
-      const { node } = path8;
+    CallExpression(path9) {
+      const { node } = path9;
       if (!isCalleeNamed(node, VUE_API_MAP.defineAsyncComponent)) {
         return;
       }
       const [arg] = node.arguments;
       checkIsUnsupported(ctx, arg);
-      pushToGlobalScope(path8, ctx);
+      pushToGlobalScope(path9, ctx);
       recordImport(ctx, PACKAGE_NAME.react, REACT_API_MAP.lazy);
     }
   };
@@ -2414,15 +2424,15 @@ function warnMultipleOptionsUsed(ctx, node) {
     }
   );
 }
-function pushToGlobalScope(path8, ctx) {
-  const { node } = path8;
+function pushToGlobalScope(path9, ctx) {
+  const { node } = path9;
   const callee = node.callee;
   callee.name = REACT_API_MAP.lazy;
   callee.loc.identifierName = REACT_API_MAP.lazy;
   if (node.typeParameters) {
     node.typeParameters = void 0;
   }
-  let declarationPath = path8.parentPath;
+  let declarationPath = path9.parentPath;
   while (declarationPath) {
     if (declarationPath.isVariableDeclaration()) {
       break;
@@ -2433,12 +2443,12 @@ function pushToGlobalScope(path8, ctx) {
   if (declarationPath?.isVariableDeclaration()) {
     fullNode = declarationPath.node;
     declarationPath.remove();
-  } else if (path8.parentPath.isVariableDeclarator()) {
-    fullNode = path8.parent;
-    path8.parentPath.remove();
+  } else if (path9.parentPath.isVariableDeclarator()) {
+    fullNode = path9.parent;
+    path9.parentPath.remove();
   } else {
-    fullNode = path8.node;
-    path8.remove();
+    fullNode = path9.node;
+    path9.remove();
   }
   const scriptIR = getScriptIR(ctx);
   scriptIR.statement.global.push(fullNode);
@@ -2469,15 +2479,15 @@ function createUseImperativeHandle(refId, init) {
 function resolveDefineExpose(ctx) {
   if (ctx.inputType !== "sfc") return {};
   return {
-    CallExpression(path8) {
-      const { node } = path8;
+    CallExpression(path9) {
+      const { node } = path9;
       const { filename, scriptData } = ctx;
       if (!isCalleeNamed(node, MACRO_API_NAMES.expose)) {
         return;
       }
       const [expose] = node.arguments;
       if (!expose) {
-        path8.remove();
+        path9.remove();
         return;
       }
       const adapter = ADAPTER_RULES.react[MACRO_API_NAMES.expose];
@@ -2494,7 +2504,7 @@ function resolveDefineExpose(ctx) {
       const { forwardRef } = scriptData;
       const newNode = createUseImperativeHandle(t23.identifier(forwardRef.refField), init);
       forwardRef.enabled = true;
-      path8.replaceWith(newNode);
+      path9.replaceWith(newNode);
     }
   };
 }
@@ -2503,8 +2513,8 @@ function resolveDefineExpose(ctx) {
 import * as t24 from "@babel/types";
 function resolveDefineOptions(ctx) {
   return {
-    CallExpression(path8) {
-      const { node } = path8;
+    CallExpression(path9) {
+      const { node } = path9;
       if (!isCalleeNamed(node, MACRO_API_NAMES.options)) {
         return;
       }
@@ -2516,7 +2526,7 @@ function resolveDefineOptions(ctx) {
           file: filename,
           loc: node?.loc
         });
-        path8.remove();
+        path9.remove();
         return;
       }
       if (!t24.isObjectExpression(options)) {
@@ -2533,7 +2543,7 @@ function resolveDefineOptions(ctx) {
           extractName(prop, ctx);
         }
       }
-      path8.remove();
+      path9.remove();
     }
   };
 }
@@ -2565,8 +2575,8 @@ function resolveEmitCalls(ctx) {
     return `on${capitalize(camelCase(normalized))}`;
   };
   return {
-    CallExpression(path8) {
-      const { node } = path8;
+    CallExpression(path9) {
+      const { node } = path9;
       const { filename, templateData, scriptData } = ctx;
       if (!t25.isIdentifier(node.callee)) return;
       const { name } = node.callee;
@@ -2577,7 +2587,7 @@ function resolveEmitCalls(ctx) {
           result = meta.source === MACRO_API_NAMES.emits;
         }
         if (!result) {
-          const binding = path8.scope.getBinding(name);
+          const binding = path9.scope.getBinding(name);
           if (binding) {
             const parent = binding.path.node;
             if (t25.isVariableDeclarator(parent) && t25.isCallExpression(parent.init) && t25.isIdentifier(parent.init.callee)) {
@@ -2596,7 +2606,7 @@ function resolveEmitCalls(ctx) {
           source: scriptData.source,
           loc: callee?.loc
         });
-        path8.remove();
+        path9.remove();
         return;
       }
       const propCall = t25.optionalCallExpression(
@@ -2609,7 +2619,7 @@ function resolveEmitCalls(ctx) {
         args,
         true
       );
-      path8.replaceWith(propCall);
+      path9.replaceWith(propCall);
     }
   };
 }
@@ -2647,9 +2657,9 @@ function cloneCallableParams(params) {
 // src/core/transform/sfc/script/syntax-processor/preprocess/resolve-props-interface/resolve-emits.ts
 function resolveEmitsTopLevelTypes(ctx) {
   return {
-    "TSInterfaceDeclaration|TSTypeAliasDeclaration"(path8) {
-      if (!t27.isProgram(path8.parent)) return;
-      const { node } = path8;
+    "TSInterfaceDeclaration|TSTypeAliasDeclaration"(path9) {
+      if (!t27.isProgram(path9.parent)) return;
+      const { node } = path9;
       if (t27.isTSInterfaceDeclaration(node)) {
         const typeLiteral = t27.tsTypeLiteral(node.body.body);
         if (!hasEmitsSignatureInType(typeLiteral)) return;
@@ -2714,8 +2724,8 @@ function resolveTopLevelEmitType(tsType) {
   }
   return tsType;
 }
-function resolveDefineEmitsIface(path8, ctx) {
-  const { node } = path8;
+function resolveDefineEmitsIface(path9, ctx) {
+  const { node } = path9;
   const [runtimeArg] = node.arguments;
   const tsParams = node.typeParameters?.params;
   if (tsParams?.length) {
@@ -3015,8 +3025,8 @@ function resolveTupleElementParam(element, index) {
 
 // src/core/transform/sfc/script/syntax-processor/preprocess/resolve-props-interface/resolve-props.ts
 import * as t28 from "@babel/types";
-function resolveDefinePropsIface(path8, ctx) {
-  const { node } = path8;
+function resolveDefinePropsIface(path9, ctx) {
+  const { node } = path9;
   const [runtimeArg] = node.arguments;
   const tsParams = node.typeParameters?.params;
   if (tsParams?.length) {
@@ -3162,9 +3172,9 @@ var SLOT_CHILDREN_NAME = "children";
 var SLOT_FN_PARAM_NAME = "props";
 function resolveSlotsTopLevelTypes(ctx) {
   return {
-    "TSInterfaceDeclaration|TSTypeAliasDeclaration"(path8) {
-      if (!t29.isProgram(path8.parent)) return;
-      const { node } = path8;
+    "TSInterfaceDeclaration|TSTypeAliasDeclaration"(path9) {
+      if (!t29.isProgram(path9.parent)) return;
+      const { node } = path9;
       if (t29.isTSInterfaceDeclaration(node)) {
         const typeLiteral = t29.tsTypeLiteral(node.body.body);
         if (!hasSlotsSignatureInType(typeLiteral)) return;
@@ -3186,8 +3196,8 @@ function resolveSlotsTopLevelTypes(ctx) {
     }
   };
 }
-function resolveDefineSlotsIface(path8, ctx) {
-  const { node } = path8;
+function resolveDefineSlotsIface(path9, ctx) {
+  const { node } = path9;
   const tsParams = node.typeParameters?.params;
   if (!tsParams?.length) return;
   const {
@@ -3378,8 +3388,8 @@ function resolvePropName2(key) {
 function resolvePropsIface(ctx) {
   const isTS = ctx.scriptData.lang.startsWith("ts");
   return {
-    CallExpression(path8) {
-      const { node, parentPath } = path8;
+    CallExpression(path9) {
+      const { node, parentPath } = path9;
       const name = node.callee.name;
       if (!isCalleeNamed(node, MACRO_API_NAMES.props) && !isCalleeNamed(node, MACRO_API_NAMES.emits) && !isCalleeNamed(node, MACRO_API_NAMES.slots)) {
         return;
@@ -3388,7 +3398,7 @@ function resolvePropsIface(ctx) {
         if (parentPath.isVariableDeclaration() || parentPath.isVariableDeclarator()) {
           parentPath.remove();
         } else {
-          path8.remove();
+          path9.remove();
         }
       };
       if (ctx.inputType !== "sfc") {
@@ -3402,11 +3412,11 @@ function resolvePropsIface(ctx) {
         propsTSIface.hasPropsInJsEnv = true;
       } else {
         if (name === MACRO_API_NAMES.props) {
-          resolveDefinePropsIface(path8, ctx);
+          resolveDefinePropsIface(path9, ctx);
         } else if (name === MACRO_API_NAMES.emits) {
-          resolveDefineEmitsIface(path8, ctx);
+          resolveDefineEmitsIface(path9, ctx);
         } else if (name === MACRO_API_NAMES.slots) {
-          resolveDefineSlotsIface(path8, ctx);
+          resolveDefineSlotsIface(path9, ctx);
         }
       }
       removePath();
@@ -3451,15 +3461,27 @@ function analyzeDeps(node, ctx, parentPath) {
   function addDependency(exp) {
     deps.set(getDependencyKey(exp), exp);
   }
+  const analyzeTargetPath = parentPath && parentPath.node === analyzeTarget ? parentPath : null;
+  if (analyzeTargetPath) {
+    if (t31.isMemberExpression(analyzeTarget) || t31.isOptionalMemberExpression(analyzeTarget)) {
+      const rootId = findRootIdentifier(analyzeTarget);
+      if (rootId) {
+        tryAddDependency(analyzeTargetPath, rootId.name, analyzeTargetPath.scope);
+        processedIdentifiers.add(rootId);
+      }
+    } else if (t31.isIdentifier(analyzeTarget)) {
+      tryAddDependency(analyzeTargetPath, analyzeTarget.name, analyzeTargetPath.scope);
+    }
+  }
   traverse2(
     analyzeTarget,
     {
       "MemberExpression|OptionalMemberExpression"(memberPath) {
-        const path8 = memberPath;
-        if (isNestedMemberObject(path8)) return;
-        const rootId = findRootIdentifier(path8.node);
+        const path9 = memberPath;
+        if (isNestedMemberObject(path9)) return;
+        const rootId = findRootIdentifier(path9.node);
         if (!rootId) return;
-        tryAddDependency(path8, rootId.name, path8.scope);
+        tryAddDependency(path9, rootId.name, path9.scope);
         processedIdentifiers.add(rootId);
       },
       Identifier(idPath) {
@@ -3491,16 +3513,19 @@ function analyzeDeps(node, ctx, parentPath) {
     }
     const sourcedExpression = traceBindingSource(binding, /* @__PURE__ */ new Set(), TRACE_MAX_DEPTH);
     if (sourcedExpression) {
-      addDependency(sourcedExpression);
+      const normalizedSource = normalizeSourcedDependency(sourcedExpression);
+      if (normalizedSource) {
+        addDependency(normalizedSource);
+      }
     }
   }
-  function normalizeDependencyExpr(path8, rootName) {
-    if (t31.isIdentifier(path8.node)) {
-      return t31.identifier(path8.node.name);
+  function normalizeDependencyExpr(path9, rootName) {
+    if (t31.isIdentifier(path9.node)) {
+      return t31.identifier(path9.node.name);
     }
-    if (t31.isMemberExpression(path8.node) || t31.isOptionalMemberExpression(path8.node)) {
-      const normalizedExp = normalizeMemberForCallSite(path8, path8.node);
-      const safeExp = t31.isMemberExpression(normalizedExp) || t31.isOptionalMemberExpression(normalizedExp) ? ensureOptionalForRefValue(normalizedExp) : normalizedExp;
+    if (t31.isMemberExpression(path9.node) || t31.isOptionalMemberExpression(path9.node)) {
+      const normalizedExp = normalizeMemberForCallSite(path9, path9.node);
+      const safeExp = t31.isMemberExpression(normalizedExp) || t31.isOptionalMemberExpression(normalizedExp) ? ensureOptionalForMemberChain(normalizedExp) : normalizedExp;
       if (isReactValidDependencyExpr(safeExp)) {
         return t31.cloneNode(safeExp, true);
       }
@@ -3508,6 +3533,21 @@ function analyzeDeps(node, ctx, parentPath) {
     }
     return null;
   }
+  function normalizeSourcedDependency(exp) {
+    if (t31.isIdentifier(exp)) {
+      return t31.identifier(exp.name);
+    }
+    if (t31.isMemberExpression(exp) || t31.isOptionalMemberExpression(exp)) {
+      const root = findRootIdentifier(exp);
+      if (!root) return null;
+      const safeExp = t31.isMemberExpression(exp) || t31.isOptionalMemberExpression(exp) ? ensureOptionalForMemberChain(exp) : exp;
+      if (isReactValidDependencyExpr(safeExp)) {
+        return t31.cloneNode(safeExp, true);
+      }
+      return t31.identifier(root.name);
+    }
+    return null;
+  }
   function isReactValidDependencyExpr(node2) {
     if (t31.isIdentifier(node2)) {
       return true;
@@ -3540,8 +3580,8 @@ function analyzeDeps(node, ctx, parentPath) {
     }
     return false;
   }
-  function normalizeMemberForCallSite(path8, node2) {
-    const parent = path8.parentPath;
+  function normalizeMemberForCallSite(path9, node2) {
+    const parent = path9.parentPath;
     const isDirectCallee = !!parent && (parent.isCallExpression() && parent.node.callee === node2 || parent.isOptionalCallExpression() && parent.node.callee === node2);
     if (!isDirectCallee) {
       return node2;
@@ -3551,8 +3591,8 @@ function analyzeDeps(node, ctx, parentPath) {
     }
     return node2.object;
   }
-  function ensureOptionalForRefValue(node2) {
-    if (!hasRefValueAccess(node2)) {
+  function ensureOptionalForMemberChain(node2) {
+    if (!hasTrailingMemberAccess(node2)) {
       return node2;
     }
     if (t31.isOptionalMemberExpression(node2) && node2.optional) {
@@ -3562,19 +3602,8 @@ function analyzeDeps(node, ctx, parentPath) {
     const property = t31.cloneNode(node2.property, true);
     return t31.optionalMemberExpression(object, property, node2.computed, true);
   }
-  function hasRefValueAccess(node2) {
-    let current = node2;
-    while (t31.isMemberExpression(current) || t31.isOptionalMemberExpression(current)) {
-      if (current.computed) {
-        if (t31.isStringLiteral(current.property) && current.property.value === "value") {
-          return true;
-        }
-      } else if (t31.isIdentifier(current.property) && current.property.name === "value") {
-        return true;
-      }
-      current = current.object;
-    }
-    return false;
+  function hasTrailingMemberAccess(node2) {
+    return t31.isMemberExpression(node2.object) || t31.isOptionalMemberExpression(node2.object);
   }
   function isEligibleBindingSource(binding) {
     if (binding.kind === "param") {
@@ -3582,16 +3611,13 @@ function analyzeDeps(node, ctx, parentPath) {
     }
     const bindingPath = binding.path;
     const declaratorPath = getVariableDeclaratorPath(bindingPath);
-    const isImportBinding = bindingPath.isImportSpecifier() || bindingPath.isImportDefaultSpecifier() || bindingPath.isImportNamespaceSpecifier();
     const isReactiveVarBinding = !!declaratorPath && isReactiveBinding(declaratorPath.node);
     const nodeInit = declaratorPath?.node.init;
     const isReactiveApiCallVarBinding = !!declaratorPath && t31.isCallExpression(nodeInit) && t31.isIdentifier(nodeInit.callee) && reactiveStateApis.has(nodeInit.callee.name);
     const isHookCallVarBinding = !!declaratorPath && t31.isCallExpression(nodeInit) && isHookLikeCallee(nodeInit.callee);
     const isFunctionBinding = bindingPath.isFunctionDeclaration() || !!declaratorPath && !!nodeInit && (t31.isArrowFunctionExpression(nodeInit) || t31.isFunctionExpression(nodeInit));
-    if (declaratorPath && nodeInit && (t31.isArrowFunctionExpression(nodeInit) || t31.isFunctionExpression(nodeInit))) {
-      markAsAnalyzed(nodeInit, false);
-    }
-    return isImportBinding || isReactiveVarBinding || isReactiveApiCallVarBinding || isHookCallVarBinding || isFunctionBinding;
+    const isReactiveFunctionBinding = isFunctionBinding && (isReactiveBinding(declaratorPath?.node) || isReactiveBinding(bindingPath.node));
+    return isReactiveVarBinding || isReactiveApiCallVarBinding || isHookCallVarBinding || isReactiveFunctionBinding;
   }
   function isHookLikeCallee(callee) {
     if (t31.isIdentifier(callee)) {
@@ -3687,11 +3713,11 @@ function getDependencyKey(exp) {
   }
   return exp.type;
 }
-function isNestedMemberObject(path8) {
-  const parent = path8.parentPath;
+function isNestedMemberObject(path9) {
+  const parent = path9.parentPath;
   if (!parent) return false;
   if (parent.isMemberExpression() || parent.isOptionalMemberExpression()) {
-    return parent.node.object === path8.node;
+    return parent.node.object === path9.node;
   }
   return false;
 }
@@ -3699,27 +3725,19 @@ function isReactiveBinding(node) {
   if (!node) return false;
   return !!getScriptNodeMeta(node)?.is_reactive;
 }
-function markAsAnalyzed(node, flag = true) {
-  const analyzed = getIsAnalyzed(node);
-  if (analyzed) return;
-  setScriptNodeMeta(node, { is_deps_analyzed: flag });
-}
-function getIsAnalyzed(node) {
-  return getScriptNodeMeta(node)?.is_deps_analyzed;
-}
 
 // src/core/transform/sfc/script/syntax-processor/process/resolve-analysis-only-adapter.ts
 function resolveAnalysisOnlyAdapter(ctx) {
   return {
-    "CallExpression|Identifier"(path8) {
-      const node = path8.node;
+    "CallExpression|Identifier"(path9) {
+      const node = path9.node;
       const apiName = getApiName(node);
       const adapter = ADAPTER_RULES.runtime[apiName];
       if (!adapter || adapter.type !== "analyzed-deps") {
         return;
       }
       if (t32.isCallExpression(node)) {
-        resolveCallNode(path8, adapter, ctx);
+        resolveCallNode(path9, adapter, ctx);
       } else {
         replaceIdName(node, adapter.target);
       }
@@ -3737,15 +3755,15 @@ function getApiName(node) {
   }
   return apiName;
 }
-function resolveCallNode(path8, adapter, ctx) {
-  const { node } = path8;
+function resolveCallNode(path9, adapter, ctx) {
+  const { node } = path9;
   const { arguments: args } = node;
   if (!args.length) return;
   const fn = args[0];
   if (!t32.isArrowFunctionExpression(fn) && !t32.isFunctionExpression(fn)) {
     return;
   }
-  const fnPath = path8.get("arguments")[0];
+  const fnPath = path9.get("arguments")[0];
   const deps = analyzeDeps(fn, ctx, fnPath);
   args.push(deps);
   replaceCallName(node, adapter.target);
@@ -3755,41 +3773,24 @@ function resolveCallNode(path8, adapter, ctx) {
 // src/core/transform/sfc/script/syntax-processor/process/resolve-arrow-deps.ts
 function resolveArrowFnDeps(ctx, ast) {
   return {
-    ArrowFunctionExpression(path8) {
-      const { node, parentPath } = path8;
-      if (isSkip(path8) || !atComponentOrHookRoot(parentPath, ast.program)) {
+    ArrowFunctionExpression(path9) {
+      const { node, parentPath } = path9;
+      if (isSkip(path9) || !atComponentOrHookRoot(parentPath, ast.program)) {
         return;
       }
-      const deps = analyzeDeps(node, ctx, path8);
+      const deps = analyzeDeps(node, ctx, path9);
       if (!deps.elements.length) return;
       const newNode = createUseCallback(node, deps);
-      const declaratorPath = getVariableDeclaratorPath(path8);
-      markAsAnalyzed(newNode.arguments[0]);
+      const declaratorPath = getVariableDeclaratorPath(path9);
       recordImport(ctx, PACKAGE_NAME.react, REACT_API_MAP.useCallback);
       setScriptNodeMeta(declaratorPath?.node, { is_reactive: true, reactive_type: "indirect" });
-      path8.replaceWith(newNode);
-    }
-  };
-}
-function resolveUnanalyzedArrow(ctx) {
-  return {
-    ArrowFunctionExpression(path8) {
-      const { node } = path8;
-      const analyzed = getIsAnalyzed(node);
-      if (typeof analyzed === "undefined" || analyzed) return;
-      const newNode = createUseCallback(node);
-      const declaratorPath = getVariableDeclaratorPath(path8);
-      if (declaratorPath?.node) {
-        setScriptNodeMeta(declaratorPath.node, { is_reactive: true, reactive_type: "indirect" });
-      }
-      markAsAnalyzed(newNode.arguments[0]);
-      path8.replaceWith(newNode);
+      path9.replaceWith(newNode);
     }
   };
 }
-function isSkip(path8) {
-  const { parentPath } = path8;
-  const isVariableDecl = () => getVariableDeclaratorPath(path8) !== null;
+function isSkip(path9) {
+  const { parentPath } = path9;
+  const isVariableDecl = () => getVariableDeclaratorPath(path9) !== null;
   const isReturnFunc = () => !isVariableDecl() && parentPath.isReturnStatement();
   const isCallback = () => {
     if (!parentPath) {
@@ -3798,12 +3799,12 @@ function isSkip(path8) {
     if (parentPath.isCallExpression()) {
       const callExpressionPath = parentPath;
       const args = callExpressionPath.node.arguments;
-      return args.some((arg) => arg === path8.node);
+      return args.some((arg) => arg === path9.node);
     }
     if (parentPath.isArrayExpression()) {
       const arrayExpressionPath = parentPath;
       const elements = arrayExpressionPath.node.elements;
-      return elements.some((element) => element === path8.node);
+      return elements.some((element) => element === path9.node);
     }
     return false;
   };
@@ -3827,13 +3828,13 @@ function isSkip(path8) {
 import * as t33 from "@babel/types";
 function resolveElementRef(ctx) {
   return {
-    CallExpression(path8) {
+    CallExpression(path9) {
       const {
         inputType,
         templateData: { refBindings }
       } = ctx;
       if (inputType !== "sfc") return;
-      const { node } = path8;
+      const { node } = path9;
       const isUseTemplateRef = isCalleeNamed(node, VUE_API_MAP.useTemplateRef);
       const isCompRefBindings = Object.keys(refBindings.componentRefs).length > 0 && isCalleeNamed(node, VUE_API_MAP.ref);
       const shouldProcess = isUseTemplateRef || isCompRefBindings;
@@ -3841,7 +3842,7 @@ function resolveElementRef(ctx) {
         return;
       }
       if (isCompRefBindings) {
-        const varDeclaratorPath = getVariableDeclaratorPath(path8)?.node;
+        const varDeclaratorPath = getVariableDeclaratorPath(path9)?.node;
         if (!t33.isIdentifier(varDeclaratorPath?.id)) {
           return;
         }
@@ -3850,22 +3851,22 @@ function resolveElementRef(ctx) {
         if (!compRef) return;
       }
       node.arguments[0] = t33.identifier("null");
-      resolveTypeParameters(ctx, path8);
+      resolveTypeParameters(ctx, path9);
       replaceCallName(node, REACT_API_MAP.useRef);
       recordImport(ctx, PACKAGE_NAME.react, REACT_API_MAP.useRef);
     },
-    MemberExpression(path8) {
-      resolveRefValueToCurrent(path8);
+    MemberExpression(path9) {
+      resolveRefValueToCurrent(path9);
     }
   };
 }
-function resolveTypeParameters(ctx, path8) {
+function resolveTypeParameters(ctx, path9) {
   const {
     templateData: { refBindings },
     scriptData
   } = ctx;
-  const { node } = path8;
-  const varDeclaratorNode = getVariableDeclaratorPath(path8)?.node;
+  const { node } = path9;
+  const varDeclaratorNode = getVariableDeclaratorPath(path9)?.node;
   if (!scriptData.lang.startsWith("ts") || !varDeclaratorNode) {
     return;
   }
@@ -3877,12 +3878,12 @@ function resolveTypeParameters(ctx, path8) {
     node.typeParameters = t33.tsTypeParameterInstantiation([t33.tsTypeReference(t33.identifier(type))]);
   }
 }
-function resolveRefValueToCurrent(path8) {
-  const { node } = path8;
+function resolveRefValueToCurrent(path9) {
+  const { node } = path9;
   if (node.computed || !t33.isIdentifier(node.property) || node.property.name !== "value") {
     return;
   }
-  const rootPath = findRootVariablePath(path8);
+  const rootPath = findRootVariablePath(path9);
   if (!rootPath?.node || !t33.isCallExpression(rootPath.node.init) || !isCalleeNamed(rootPath.node.init, REACT_API_MAP.useRef)) {
     return;
   }
@@ -3898,21 +3899,25 @@ import * as t34 from "@babel/types";
 function resolveExprMemo(ctx, ast) {
   const isScriptFile = ctx.inputType !== "sfc";
   return {
-    VariableDeclarator(path8) {
-      const { node } = path8;
+    VariableDeclarator(path9) {
+      const { node } = path9;
       const { init } = node;
-      if (!init) return;
       const shouldMemo = () => {
-        if (!atComponentOrHookRoot(path8, ast.program, isScriptFile)) {
+        if (!init) return false;
+        if (!atComponentOrHookRoot(path9, ast.program, isScriptFile)) {
           return false;
         }
+        if (!t34.isVariableDeclaration(path9.parent) || path9.parent.kind !== "const") {
+          return false;
+        }
+        if (t34.isFunction(init)) return false;
         if (t34.isCallExpression(init) && t34.isIdentifier(init.callee) && init.callee.name.startsWith("use")) {
           return false;
         }
         return true;
       };
       if (!shouldMemo()) return;
-      const initPath = path8.get("init");
+      const initPath = path9.get("init");
       if (!initPath.isExpression()) return;
       const deps = analyzeDeps(initPath.node, ctx, initPath);
       if (!deps.elements.length) return;
@@ -3928,8 +3933,8 @@ import * as t35 from "@babel/types";
 function resolveLintRules(ctx, ast) {
   const inScriptFile = ctx.inputType !== "sfc";
   return {
-    CallExpression(path8) {
-      const { node, parentPath } = path8;
+    CallExpression(path9) {
+      const { node, parentPath } = path9;
       if (!t35.isIdentifier(node.callee)) return;
       const { name: callName } = node.callee;
       const addLog = (t41) => {
@@ -3948,7 +3953,7 @@ function resolveLintRules(ctx, ast) {
           );
           return;
         }
-        if (!atComponentOrHookRoot(path8, ast.program)) {
+        if (!atComponentOrHookRoot(path9, ast.program)) {
           addLog(
             `The ${macro} must be defined at the top level of the component, not inside blocks or functions.`
           );
@@ -3964,7 +3969,7 @@ function resolveLintRules(ctx, ast) {
       };
       const lintHooks = () => {
         if (!callName.startsWith("use")) return;
-        if (!atComponentOrHookRoot(path8, ast.program, inScriptFile)) {
+        if (!atComponentOrHookRoot(path9, ast.program, inScriptFile)) {
           addLog(
             `The ${callName} hook must be called at the top level, not inside loops, conditions, or nested functions.`
           );
@@ -3982,8 +3987,8 @@ import * as t36 from "@babel/types";
 function resolveProvide(ctx) {
   if (ctx.inputType === "style") return {};
   return {
-    CallExpression(path8) {
-      const { node } = path8;
+    CallExpression(path9) {
+      const { node } = path9;
       const providerTarget = ADAPTER_RULES.runtime[VUE_API_MAP.provide]?.target;
       const isProvideCall = isCalleeNamed(node, VUE_API_MAP.provide) || providerTarget && isCalleeNamed(node, providerTarget);
       if (!isProvideCall) return;
@@ -3993,7 +3998,7 @@ function resolveProvide(ctx) {
       const adapter = ADAPTER_RULES.runtime[VUE_API_MAP.provide];
       assignProviderValue(target, key, value);
       recordImport(ctx, adapter.package, adapter.target);
-      path8.parentPath.remove();
+      path9.parentPath.remove();
     }
   };
 }
@@ -4035,8 +4040,8 @@ function assignProviderValue(target, key, value) {
 import * as t37 from "@babel/types";
 function resolveRenameAdapter(ctx) {
   return {
-    "CallExpression|Identifier"(path8) {
-      const node = path8.node;
+    "CallExpression|Identifier"(path9) {
+      const node = path9.node;
       const isCallNode = t37.isCallExpression(node);
       let apiName = "";
       if (t37.isIdentifier(node)) {
@@ -4052,7 +4057,7 @@ function resolveRenameAdapter(ctx) {
       }
       if (adapter.isTrackable) {
         const reactiveType = getReactiveType(apiName);
-        const declaratorPath = getVariableDeclaratorPath(path8);
+        const declaratorPath = getVariableDeclaratorPath(path9);
         setScriptNodeMeta(declaratorPath?.node, {
           is_reactive: true,
           reactive_type: reactiveType
@@ -4091,10 +4096,11 @@ function processVueSyntax2(ast, ctx) {
         // provide 需要在 rename 之前收集并移除原始调用，避免被重命名后失配
         resolveProvide,
         resolveRenameAdapter,
+        // fix：在分析函数前分析可优化为 useMemo 的顶层变量声明，
+        // 使得后续能够被函数依赖分析
+        resolveExprMemo,
         resolveArrowFnDeps,
-        resolveUnanalyzedArrow,
         resolveAnalysisOnlyAdapter,
-        resolveExprMemo,
         resolveLintRules
       ],
       excludeBabel: [resolveTemplateSlotIface, resolveCompIProps]
@@ -5460,12 +5466,12 @@ function transform(ast, ctx, options) {
 }
 
 // package.json
-var version = "1.3.0";
+var version = "1.4.0";
 var bin = {
   vureact: "./bin/vureact.js"
 };
 
-// src/compiler/shared/types.ts
+// src/compiler/shared/types/cache-types.ts
 var CacheKey = /* @__PURE__ */ ((CacheKey2) => {
   CacheKey2["SFC"] = "sfc";
   CacheKey2["SCRIPT"] = "script";
@@ -5507,10 +5513,146 @@ function simpleFormat(code) {
 }
 
 // src/compiler/shared/helper.ts
-import { execSync } from "child_process";
+import fs2 from "fs";
+import kleur4 from "kleur";
+import path3 from "path";
+
+// src/compiler/shared/file-lock-manager.ts
 import fs from "fs";
 import kleur3 from "kleur";
 import path2 from "path";
+import lockfile from "proper-lockfile";
+var FileLockManager = class _FileLockManager {
+  static instance;
+  /**
+   * 获取单例实例
+   */
+  static getInstance() {
+    if (!_FileLockManager.instance) {
+      _FileLockManager.instance = new _FileLockManager();
+    }
+    return _FileLockManager.instance;
+  }
+  /**
+   * 获取文件锁并更新文件内容
+   * @param filePath 文件路径
+   * @param updater 更新函数，接收当前内容，返回更新后的内容
+   * @param options 锁选项
+   */
+  async updateFile(filePath, updater, options = {}) {
+    return this.withLock(
+      filePath,
+      async () => {
+        let current = null;
+        try {
+          const content = await fs.promises.readFile(filePath, "utf-8");
+          if (content.trim()) {
+            try {
+              current = JSON.parse(content);
+            } catch {
+              current = content;
+            }
+          }
+        } catch (error) {
+          console.error(kleur3.red("\u2716"), `Failed to read file ${filePath}`);
+          console.error(error);
+        }
+        const updated = await updater(current);
+        const contentToWrite = typeof updated === "string" ? updated : JSON.stringify(updated, null, 2);
+        await this.writeFile(filePath, contentToWrite);
+        return updated;
+      },
+      options
+    );
+  }
+  /**
+   * 获取文件锁并执行操作
+   * @param filePath 文件路径
+   * @param operation 要执行的操作函数
+   * @param options 锁选项
+   */
+  async withLock(filePath, operation, options = {}) {
+    const {
+      stale = 1e4,
+      update = stale / 2,
+      retries = 5,
+      realpath = true,
+      lockfilePath
+    } = options;
+    await fs.promises.mkdir(path2.dirname(filePath), { recursive: true });
+    try {
+      await fs.promises.access(filePath);
+    } catch {
+      await this.writeFile(filePath, "");
+    }
+    const release = await lockfile.lock(filePath, {
+      stale,
+      update,
+      retries,
+      realpath,
+      lockfilePath
+    });
+    try {
+      return await operation();
+    } finally {
+      await release();
+    }
+  }
+  /**
+   * 检查文件是否被锁定
+   * @param filePath 文件路径
+   * @param options 锁选项
+   */
+  async isLocked(filePath, options = {}) {
+    const { stale = 1e4, realpath = true, lockfilePath } = options;
+    try {
+      return await lockfile.check(filePath, { stale, realpath, lockfilePath });
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * 尝试获取锁（非阻塞）
+   * @param filePath 文件路径
+   * @param options 锁选项
+   * @returns 如果成功获取锁，返回释放函数；否则返回 null
+   */
+  async tryLock(filePath, options = {}) {
+    const { stale = 1e4, update = stale / 2, realpath = true, lockfilePath } = options;
+    try {
+      const release = await lockfile.lock(filePath, {
+        stale,
+        update,
+        retries: 0,
+        // 不重试
+        realpath,
+        lockfilePath
+      });
+      return release;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 释放文件锁
+   * @param filePath 文件路径
+   * @param options 锁选项
+   */
+  async unlock(filePath, options = {}) {
+    const { realpath = true, lockfilePath } = options;
+    try {
+      await lockfile.unlock(filePath, { realpath, lockfilePath });
+    } catch {
+    }
+  }
+  async writeFile(filePath, content) {
+    await fs.promises.mkdir(path2.dirname(filePath), { recursive: true });
+    await fs.promises.writeFile(filePath, content, "utf-8");
+  }
+};
+var fileLock = FileLockManager.getInstance();
+
+// src/compiler/shared/helper.ts
 var Helper = class {
   compilerOpts;
   pathFilter;
@@ -5535,35 +5677,37 @@ var Helper = class {
    * 获取输入文件的路径
    */
   getInputPath() {
-    const { input } = this.compilerOpts;
-    return path2.resolve(this.getProjectRoot(), input || "src");
+    const { input = "src" } = this.compilerOpts;
+    return path3.resolve(this.getProjectRoot(), input);
   }
   /**
    * 检查 input 路径是否是单个文件
    */
   isSingleFile() {
     const inputPath = this.getInputPath();
-    return fs.existsSync(inputPath) && fs.statSync(inputPath).isFile();
+    return fs2.existsSync(inputPath) && fs2.statSync(inputPath).isFile();
   }
   /**
    * 获取输出文件的路径。如：'[root]/.vureact/dist/'
+   * @param addInput 会输出如：'[root]/.vureact/dist/[input]/'
    */
-  getOuputPath() {
-    return path2.resolve(this.getWorkspaceDir(), this.getOutDirName());
+  getOuputPath(addInput = false) {
+    const { input = "src" } = this.compilerOpts;
+    return path3.resolve(this.getWorkspaceDir(), this.getOutDirName(), addInput ? input : "");
   }
   getOutDirName() {
     const { output } = this.compilerOpts;
     return output?.outDir || this.outDir;
   }
   getWorkspaceDir() {
-    return path2.resolve(this.getProjectRoot(), this.workspaceDir);
+    return path3.resolve(this.getProjectRoot(), this.workspaceDir);
   }
   /**
    * 根据相对输出路径反推源文件路径
    */
   getSourcePath(outputPath) {
-    const relativePath2 = path2.relative(this.getOuputPath(), outputPath);
-    return path2.resolve(this.getProjectRoot(), relativePath2);
+    const relativePath2 = path3.relative(this.getOuputPath(), outputPath);
+    return path3.resolve(this.getProjectRoot(), relativePath2);
   }
   getIgnoreAssets() {
     const { output } = this.compilerOpts;
@@ -5581,7 +5725,9 @@ var Helper = class {
       "eslint.config.",
       "readme.",
       "vue.",
-      "vureact.config.js"
+      ".vue",
+      "vureact.config.js",
+      "vureact.config.ts"
     ]);
   }
   getIsCache() {
@@ -5591,19 +5737,19 @@ var Helper = class {
    * 返回原始目录下的 package.json 路径
    */
   getRootPkgPath() {
-    return path2.join(this.getProjectRoot(), "package.json");
+    return path3.join(this.getProjectRoot(), "package.json");
   }
   /**
    * 返回 output 的 package.json 路径
    */
   getOutputPkgPath() {
-    return path2.join(this.getOuputPath(), "package.json");
+    return path3.join(this.getOuputPath(), "package.json");
   }
   /**
    * 返回文件相对工作区的路径
    */
   relativePath(filePath) {
-    return path2.relative(this.getProjectRoot(), filePath);
+    return path3.relative(this.getProjectRoot(), filePath);
   }
   /**
    * 替换 .vue 文件名后缀为 .jsx/.tsx
@@ -5615,8 +5761,8 @@ var Helper = class {
     const relativePath2 = this.relativePath(filePath);
     let newRelativePath = relativePath2.replace(/\.vue$/i, ext);
     if (newRelativePath === relativePath2) {
-      const { name, dir } = path2.parse(relativePath2);
-      newRelativePath = path2.join(dir, `${name}${ext}`);
+      const { name, dir } = path3.parse(relativePath2);
+      newRelativePath = path3.join(dir, `${name}${ext}`);
     }
     return newRelativePath;
   }
@@ -5624,7 +5770,7 @@ var Helper = class {
    * 判断是否应该跳过不需要进行文件搜索的路径
    */
   shouldSkipPath(filePath) {
-    const baseName = path2.basename(filePath);
+    const baseName = path3.basename(filePath);
     const defaultExcludes = ["node_modules", "dist", "build", ".git", ".DS_Store"];
     if (defaultExcludes.includes(baseName)) {
       return true;
@@ -5640,7 +5786,7 @@ var Helper = class {
    */
   resolveOutputPath(filePath, extname) {
     const newRelativePath = extname ? this.replaceVueFileExt(filePath, `.${extname}`) : this.relativePath(filePath);
-    const outputPath = path2.resolve(this.getOuputPath(), newRelativePath);
+    const outputPath = path3.resolve(this.getOuputPath(), newRelativePath);
     return outputPath;
   }
   /**
@@ -5680,20 +5826,34 @@ var Helper = class {
     return a.fileSize === b.fileSize && a.mtime === b.mtime;
   }
   /**
-   * 统一的写文件方法，包含自动创建目录
+   * 统一的写文件方法，包含自动创建目录（带文件互斥锁可选）
+   * @param filePath - 要写入的文件路径
+   * @param content - 要写入的内容
+   * @param options - 可选配置项
+   * @param options.lock - 是否启用文件锁（默认false）
    */
-  async writeFileWithDir(filePath, content) {
-    await fs.promises.mkdir(path2.dirname(filePath), { recursive: true });
-    await fs.promises.writeFile(filePath, content, "utf-8");
+  async writeFileWithDir(filePath, content, options) {
+    if (options?.lock) {
+      await fileLock.updateFile(filePath, async () => content, options);
+    } else {
+      await fs2.promises.mkdir(path3.dirname(filePath), { recursive: true });
+      await fs2.promises.writeFile(filePath, content, "utf-8");
+    }
+  }
+  async rmFile(filePath) {
+    try {
+      await fs2.promises.rm(filePath, { recursive: true, force: true });
+    } catch {
+    }
   }
   async loadCache(key) {
     const cacheFile = this.getCachePath();
     const defaultData = this.createCacheData(key);
-    if (!fs.existsSync(cacheFile)) {
+    if (!fs2.existsSync(cacheFile)) {
       return defaultData;
     }
     try {
-      const content = await fs.promises.readFile(cacheFile, "utf-8");
+      const content = await fs2.promises.readFile(cacheFile, "utf-8");
       const data = JSON.parse(content);
       return {
         key,
@@ -5721,15 +5881,25 @@ var Helper = class {
    */
   getCachePath() {
     const filename = "_metadata";
-    return path2.resolve(this.getProjectRoot(), this.workspaceDir, "cache", `${filename}.json`);
+    return path3.resolve(this.getProjectRoot(), this.workspaceDir, "cache", `${filename}.json`);
   }
   async saveCache(data) {
     if (!this.getIsCache() || !data) {
       return;
     }
-    const { key, source, target } = data;
-    source[key] = target;
-    await this.writeFileWithDir(this.getCachePath(), JSON.stringify(source));
+    const getDefaultValue = () => ({
+      ["sfc" /* SFC */]: [],
+      ["script" /* SCRIPT */]: [],
+      ["style" /* STYLE */]: [],
+      ["copied" /* ASSET */]: []
+    });
+    const cachePath = this.getCachePath();
+    await fileLock.updateFile(cachePath, (currentData) => {
+      const { key, target } = data;
+      const mergedData = currentData || getDefaultValue();
+      mergedData[key] = target;
+      return mergedData;
+    });
   }
   genHash(content) {
     return genHashByXXH(content);
@@ -5741,18 +5911,18 @@ var Helper = class {
    */
   scanFiles(dir, filter) {
     const results = [];
-    if (!fs.existsSync(dir)) {
+    if (!fs2.existsSync(dir)) {
       return results;
     }
-    const stats = fs.statSync(dir);
+    const stats = fs2.statSync(dir);
     if (stats.isFile()) {
       return filter(dir) ? [dir] : [];
     }
-    const list = fs.readdirSync(dir);
+    const list = fs2.readdirSync(dir);
     for (const file of list) {
-      const fullPath = path2.resolve(dir, file);
+      const fullPath = path3.resolve(dir, file);
       if (this.shouldSkipPath(fullPath)) continue;
-      const stat = fs.statSync(fullPath);
+      const stat = fs2.statSync(fullPath);
       if (stat.isDirectory() && this.compilerOpts.recursive !== false) {
         results.push(...this.scanFiles(fullPath, filter));
       } else if (filter(fullPath)) {
@@ -5762,19 +5932,19 @@ var Helper = class {
     return results;
   }
   getAbsPath(filePath) {
-    return path2.isAbsolute(filePath) ? filePath : path2.resolve(this.getProjectRoot(), filePath);
+    return path3.isAbsolute(filePath) ? filePath : path3.resolve(this.getProjectRoot(), filePath);
   }
   async getFileMeta(filePath) {
-    const stats = await fs.promises.stat(filePath);
+    const stats = await fs2.promises.stat(filePath);
     return {
       fileSize: stats.size,
       mtime: stats.mtimeMs
     };
   }
   async removeOutputFile(filePath, resolveOutputPath) {
-    const path8 = resolveOutputPath ? this.resolveOutputPath(filePath) : filePath;
-    if (!fs.existsSync(path8)) return;
-    await fs.promises.unlink(path8);
+    const path9 = resolveOutputPath ? this.resolveOutputPath(filePath) : filePath;
+    if (!fs2.existsSync(path9)) return;
+    await fs2.promises.unlink(path9);
   }
   updateCache(targetFile, newData, cache) {
     const index = cache.target.findIndex((c) => c.file === targetFile);
@@ -5784,18 +5954,6 @@ var Helper = class {
       cache.target.push(newData);
     }
   }
-  resolveViteCreateApp() {
-    const { output } = this.compilerOpts;
-    const config = output?.bootstrapVite;
-    const template = typeof config === "object" ? config.template : "react-ts";
-    const outDirName = this.getOutDirName();
-    const cmd = `npm create vite@latest ${outDirName} -- --template ${template}`;
-    execSync(cmd, {
-      cwd: this.getWorkspaceDir(),
-      stdio: "ignore"
-      // 隐藏 create-vite 内部的输出日志，保持终端整洁
-    });
-  }
   /**
    * 获取需要排除编译的文件
    */
@@ -5823,15 +5981,15 @@ var Helper = class {
   }
   printCompileInfo(file, duration) {
     this.print(
-      kleur3.green("Compiled"),
-      kleur3.dim(normalizePath(this.relativePath(file))),
-      kleur3.gray(`(${duration})`)
+      kleur4.green("Compiled"),
+      kleur4.dim(normalizePath(this.relativePath(file))),
+      kleur4.gray(`(${duration})`)
     );
   }
   print(...message) {
     if (this.compilerOpts.watch) {
       const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-      console.info(kleur3.dim(time), kleur3.cyan(kleur3.bold("[vureact]")), ...message);
+      console.info(kleur4.dim(time), kleur4.cyan(kleur4.bold("[vureact]")), ...message);
       return;
     }
     console.info(...message);
@@ -5839,17 +5997,34 @@ var Helper = class {
   /**
    * 读取 package.json 文件内容，并处理成对象返回
    */
-  async resolvePackageFile(path8) {
+  async resolvePackageFile(path9) {
+    if (!fs2.existsSync(path9)) {
+      return {};
+    }
     try {
-      if (!fs.existsSync(path8)) {
+      const content = await fs2.promises.readFile(path9, "utf-8");
+      if (!content.trim()) {
         return {};
       }
-      return JSON.parse(await fs.promises.readFile(path8, "utf-8"));
+      return JSON.parse(content);
     } catch (error) {
-      console.error(error);
+      console.error(kleur4.red("\u274C"), `Failed to parse JSON file ${path9}:
+`, error);
       return {};
     }
   }
+  /**
+   * 获取目录到文件的相对路径
+   * @returns 结果路径不包含文件拓展名，并以诸如 ./ 开头
+   */
+  resolveRelativePath(from, to) {
+    let relativePath2 = path3.relative(from, to);
+    relativePath2 = relativePath2.substring(0, relativePath2.indexOf("."));
+    if (!relativePath2.startsWith(".")) {
+      relativePath2 = `./${relativePath2}`;
+    }
+    return normalizePath(relativePath2);
+  }
 };
 
 // src/core/parse/style-only.ts
@@ -5886,7 +6061,7 @@ function parseOnlyStyle(source, ctx, options) {
 }
 
 // src/compiler/context/adapter.ts
-import path3 from "path";
+import path4 from "path";
 
 // src/compiler/context/creator.ts
 function createCompilationCtx() {
@@ -5973,7 +6148,7 @@ var CompilationAdapter = class _CompilationAdapter {
     return ctx;
   }
   static detectInputType(filename) {
-    const ext = path3.extname(filename).toLowerCase();
+    const ext = path4.extname(filename).toLowerCase();
     switch (ext) {
       case ".vue":
         return "sfc";
@@ -5997,65 +6172,11 @@ var BaseCompiler = class extends Helper {
   version = version;
   options;
   createContext = CompilationAdapter.createContext;
-  /**
-   * 创建基础编译器实例
-   *
-   * @param options - 编译器配置选项，包括缓存设置、插件配置、样式预处理等，
-   * 所有选项都会传递给父类 {@link Helper} 进行初始化
-   *
-   * @see {@link CompilerOptions} 查看完整的配置选项说明
-   */
   constructor(options = {}) {
     super(options);
     this.options = options;
   }
-  /**
-   * 编译 Vue 源代码为 React 代码
-   *
-   * 该方法执行完整的编译流程，包括：
-   * 1. 上下文初始化：创建独立的编译上下文
-   * 2. 解析阶段：将 Vue 源代码解析为抽象语法树（AST）
-   * 3. 转换阶段：将 Vue AST 转换为 React 中间表示（IR）
-   * 4. 生成阶段：将 React IR 生成为目标代码
-   * 5. 插件执行：在各阶段执行注册的插件
-   * 6. 结果处理：整理编译结果并返回
-   *
-   * 编译过程使用 try-finally 确保上下文资源被正确清理，
-   * 即使编译过程中发生错误也不会导致资源泄漏。
-   *
-   * @param source - Vue 源代码字符串
-   * @param filename - 源文件名，用于生成文件ID和输出路径
-   * @returns {CompilationResult} 编译结果，包含生成的代码和文件信息
-   *
-   * @example
-   * ```typescript
-   * const vueCode = `
-   * <template>
-   *   <div class="container">{{ message }}</div>
-   * </template>
-   *
-   * <script setup lang="ts">
-   * import { ref } from 'vue;
-   * const message = ref('Hello Vue')
-   * </script>
-   *
-   * <style scoped>
-   * .container {
-   *   padding: 20px;
-   * }
-   * </style>
-   * `;
-   *
-   * const result = compiler.compile(vueCode, 'MyComponent.vue');
-   * console.log(result);
-   * ```
-   *
-   * @throws 不会直接抛出异常，错误通过日志系统记录
-   * @see {@link parse} 解析函数
-   * @see {@link transform} 转换函数
-   * @see {@link generate} 生成函数
-   * @see {@link executePlugins} 插件执行函数
-   */
+  /** 编译 Vue 源代码为 React 代码 */
   compile(source, filename) {
     const { plugins, preprocessStyles = true } = this.options;
     const fileId = this.genHash(filename);
@@ -6091,61 +6212,12 @@ var BaseCompiler = class extends Helper {
       ctx.clear();
     }
   }
-  /**
-   * 初始化 Babel 代码生成选项
-   *
-   * 合并用户自定义的生成选项与默认选项，确保代码生成的一致性和正确性。
-   * 默认配置优化了代码的可读性和性能：
-   * 1. 最小化 Unicode 转义：只转义必要的字符，保持代码可读性
-   * 2. 统一引号风格：使用单引号，符合 JavaScript 社区常见约定
-   * 3. 代码压缩：启用最小化，移除不必要的空白字符
-   *
-   * 如果用户提供了自定义选项，会与默认选项进行深度合并，
-   * 用户选项的优先级高于默认选项。
-   *
-   * @private
-   * @param filename - 可选的文件名，用于源码映射配置
-   * @returns {GeneratorOptions} 合并后的 Babel 生成选项
-   *
-   * @remarks
-   * - 源码映射支持：如果启用了 sourceMaps 且提供了文件名，会自动设置 sourceFileName
-   * - 选项合并策略：用户选项会覆盖默认选项，实现灵活的配置
-   * - 性能优化：默认启用 minified 以减少生成代码的体积
-   * - 编码安全：使用 jsesc 确保特殊字符的正确转义
-   *
-   * @example
-   * ```typescript
-   * // 默认选项
-   * const defaultOptions = {
-   *   jsescOption: { minimal: true, quotes: 'single' },
-   *   minified: true
-   * };
-   *
-   * // 用户自定义选项
-   * const userOptions = {
-   *   minified: false, // 覆盖默认值
-   *   sourceMaps: true // 新增选项
-   * };
-   *
-   * // 合并结果
-   * const merged = {
-   *   jsescOption: { minimal: true, quotes: 'single' },
-   *   minified: false, // 用户值
-   *   sourceMaps: true // 用户值
-   * };
-   * ```
-   *
-   * @see {@link GeneratorOptions} Babel 生成选项类型定义
-   */
   prepareGenerateOptions(filename) {
     const userOptions = this.options.generate || {};
     const mergedOptions = {
-      // 配置 jsesc 避免 Unicode 转义
       jsescOption: {
         minimal: true,
-        // 只转义必要的字符
         quotes: "single"
-        // 使用单引号
       },
       minified: true,
       ...userOptions
@@ -6155,36 +6227,6 @@ var BaseCompiler = class extends Helper {
     }
     return mergedOptions;
   }
-  /**
-   * 处理 SFC 和 Script 文件的编译结果
-   *
-   * 根据编译上下文中的输入类型（SFC 或 Script），整理并返回相应的编译结果。
-   * 对于 SFC 文件，返回包含 JSX 和 CSS 信息的完整结果；
-   * 对于 Script 文件，返回仅包含脚本信息的结果。
-   *
-   * 关键处理逻辑：
-   * 1. 构建基础结果：包含文件ID、路由信息和生成的代码
-   * 2. 确定输出路径：根据源文件路径和语言类型生成输出文件路径
-   * 3. 区分文件类型：
-   *    - SFC 文件：生成 .tsx 扩展名，包含样式信息
-   *    - Script 文件：保持原扩展名，不包含样式信息
-   * 4. 样式处理：提取样式文件路径、作用域ID和样式代码
-   *
-   * @private
-   * @param ir - React 中间表示（IR）描述符，包含转换后的组件信息
-   * @param gen - 代码生成结果，包含生成的代码和源码映射
-   * @param ctxData - 编译上下文数据，包含文件信息和编译状态
-   * @returns {CompilationResult} 整理后的编译结果
-   *
-   * @remarks
-   * - 文件扩展名处理：Vue SFC 文件会转换为 .tsx 或 .jsx 文件
-   * - 样式分离：SFC 中的样式会被提取到独立的 CSS 文件中
-   * - 路由检测：自动检测组件是否使用路由，用于依赖注入
-   * - 作用域样式：为 Scoped CSS 生成唯一的作用域ID
-   *
-   * @see {@link SFCCompilationResult} SFC 编译结果类型
-   * @see {@link ScriptCompilationResult} Script 编译结果类型
-   */
   resolveMainResult(ir, gen, ctxData) {
     const { fileId, filename, scriptData, styleData, inputType } = ctxData;
     const base = {
@@ -6199,7 +6241,6 @@ var BaseCompiler = class extends Helper {
         fileInfo: {
           jsx: {
             file: `${file}x`,
-            // 'xxx.ts' + 'x' => 'xxx.tsx'
             lang
           },
           css: {
@@ -6216,11 +6257,6 @@ var BaseCompiler = class extends Helper {
       ...base
     };
   }
-  /**
-   * 处理 Style 文件的编译结果
-   * @param data style 文件解析结果
-   * @param ctxData 上下文数据
-   */
   resolveStyleResult(data, ctxData) {
     const { fileId, filename } = ctxData;
     const { lang, content = "" } = data.style.source;
@@ -6253,13 +6289,12 @@ function formattDuration(n) {
 }
 
 // src/compiler/shared/file-compiler/index.ts
-import fs5 from "fs";
-import kleur6 from "kleur";
+import kleur8 from "kleur";
 import ora2 from "ora";
 
 // src/compiler/shared/file-compiler/asset-manager.ts
-import fs2 from "fs";
-import path4 from "path";
+import fs3 from "fs";
+import path5 from "path";
 var AssetManager = class {
   constructor(fileCompiler, cleanupManager) {
     this.fileCompiler = fileCompiler;
@@ -6267,19 +6302,21 @@ var AssetManager = class {
   }
   // 需要经过管线编译处理的文件类型
   pipelineFiles = [".js", ".ts", ".less", ".scss", ".sass"];
+  skippedCount = 0;
   /**
    * 运行资源文件处理管线
    */
   async runAssetPipeline() {
+    const { options } = this.fileCompiler;
     const rootPath = this.fileCompiler.getProjectRoot();
     const inputPath = this.fileCompiler.getInputPath();
     const exclusions = this.fileCompiler.getIgnoreAssets();
     const assetFiles = this.fileCompiler.scanFiles(rootPath, (p) => {
       if (this.fileCompiler.shouldSkipPath(p)) return false;
       const relativeToRoot = normalizePath(this.fileCompiler.relativePath(p));
-      const filename = path4.basename(p).toLowerCase();
-      const ext = path4.extname(p).toLowerCase();
-      if (!this.fileCompiler.options.output?.ignoreAssets) {
+      const filename = path5.basename(p).toLowerCase();
+      const ext = path5.extname(p).toLowerCase();
+      if (!options.output?.ignoreAssets) {
         const shouldExclude = Array.from(exclusions).some((pattern) => {
           if (pattern.endsWith(".")) {
             return filename.startsWith(pattern);
@@ -6289,34 +6326,28 @@ var AssetManager = class {
           }
           return relativeToRoot === pattern || filename === pattern;
         });
-        if (shouldExclude) {
-          return false;
-        }
+        if (shouldExclude) return false;
       } else if (exclusions.has(relativeToRoot) || exclusions.has(filename)) {
         return false;
       }
       if (ext === ".vue") return false;
-      const isInsideSrc = p.startsWith(inputPath + path4.sep);
+      const isInsideSrc = p.startsWith(inputPath + path5.sep);
       if (isInsideSrc && this.pipelineFiles.includes(ext)) {
         return false;
       }
       return true;
     });
     const absFiles = new Set(assetFiles.map((f) => this.fileCompiler.getAbsPath(f)));
-    const cache = await this.fileCompiler.loadCache("copied" /* ASSET */);
     await this.cleanupManager.cleanupOldOutput("copied" /* ASSET */, (u) => !absFiles.has(u.file));
-    await this.updateAssetCaches(assetFiles, cache);
-    return assetFiles.length;
-  }
-  /**
-   * 更新资源文件缓存
-   */
-  async updateAssetCaches(files, cache) {
-    for (const file of files) {
-      const meta = await this.processAsset(file, cache);
-      this.updateCache(file, meta, cache);
-    }
+    if (!assetFiles.length) return 0;
+    const cache = await this.fileCompiler.loadCache("copied" /* ASSET */);
+    const copied = await Promise.all(
+      assetFiles.map((file) => {
+        return this.processAsset(file, cache);
+      })
+    );
     await this.fileCompiler.saveCache(cache);
+    return copied.filter(Boolean).length;
   }
   /**
    * Process single asset file, compare with cache and decide whether to copy.
@@ -6330,11 +6361,16 @@ var AssetManager = class {
     const cache = (this.fileCompiler.getIsCache() ? existingCache : void 0) || await this.fileCompiler.loadCache("copied" /* ASSET */);
     const record = cache.target.find((f) => f.file === absPath);
     if (record && this.fileCompiler.compareFileMeta(record, fileMeta)) {
-      return fileMeta;
+      this.skippedCount++;
+      return;
     }
     const outputPath = this.fileCompiler.resolveOutputPath(absPath);
-    await fs2.promises.mkdir(path4.dirname(outputPath), { recursive: true });
-    await fs2.promises.copyFile(absPath, outputPath);
+    await fs3.promises.mkdir(path5.dirname(outputPath), { recursive: true });
+    await fs3.promises.copyFile(absPath, outputPath);
+    this.updateCache(absPath, fileMeta, cache);
+    if (this.fileCompiler.getIsCache() && !existingCache) {
+      await this.fileCompiler.saveCache(cache);
+    }
     return fileMeta;
   }
   /**
@@ -6349,6 +6385,18 @@ var AssetManager = class {
       cache.target.push(newData);
     }
   }
+  /**
+   * 获取跳过的文件数量
+   */
+  getSkippedCount() {
+    return this.skippedCount;
+  }
+  /**
+   * 重置跳过的文件数量
+   */
+  resetSkippedCount() {
+    this.skippedCount = 0;
+  }
 };
 
 // src/compiler/shared/file-compiler/cache-manager.ts
@@ -6356,12 +6404,12 @@ var CacheManager = class {
   constructor(fileCompiler) {
     this.fileCompiler = fileCompiler;
   }
+  pendingUpdates = /* @__PURE__ */ new Map();
   /**
-   * 增量更新缓存记录
+   * 批量更新缓存记录
    */
   async updateCacheIncrementally(unit, key) {
     if (!this.fileCompiler.getIsCache()) return;
-    const cache = await this.fileCompiler.loadCache(key);
     const meta = { ...unit };
     delete meta.source;
     if (key === "sfc" /* SFC */) {
@@ -6372,8 +6420,26 @@ var CacheManager = class {
     } else if (key === "style" /* STYLE */) {
       delete meta.output?.style.code;
     }
-    this.updateCache(unit.file, meta, cache);
+    if (!this.pendingUpdates.has(key)) {
+      this.pendingUpdates.set(key, []);
+    }
+    this.pendingUpdates.get(key).push({ unit, meta });
+  }
+  /**
+   * 批量保存缓存
+   */
+  async flushCache(key) {
+    if (!this.fileCompiler.getIsCache() || !this.pendingUpdates.has(key)) {
+      return;
+    }
+    const updates = this.pendingUpdates.get(key);
+    if (updates.length === 0) return;
+    const cache = await this.fileCompiler.loadCache(key);
+    for (const { unit, meta } of updates) {
+      this.updateCache(unit.file, meta, cache);
+    }
     await this.fileCompiler.saveCache(cache);
+    this.pendingUpdates.set(key, []);
   }
   /**
    * 更新缓存
@@ -6389,7 +6455,7 @@ var CacheManager = class {
 };
 
 // src/compiler/shared/file-compiler/cleanup-manager.ts
-import path5 from "path";
+import path6 from "path";
 var CleanupManager = class {
   constructor(fileCompiler) {
     this.fileCompiler = fileCompiler;
@@ -6404,7 +6470,7 @@ var CleanupManager = class {
       (u) => u.file === absPath || // 加 path.sep 是因为假如删除了 src/components 文件夹，
       // 为了防止误删名为 src/components-old 的文件夹，
       // 所以必须确保路径后跟着一个分隔符，确保精准匹配子目录内容。
-      u.file.startsWith(absPath + path5.sep)
+      u.file.startsWith(absPath + path6.sep)
     );
   }
   /**
@@ -6416,25 +6482,43 @@ var CleanupManager = class {
     const toRemove = cache.target.filter(filter);
     if (!toRemove.length) return;
     const removeFn = async (m) => {
-      if (key === "sfc" /* SFC */) {
-        const meta = m;
-        if (!meta?.output) return;
-        const { jsx, css } = meta.output;
-        await this.fileCompiler.removeOutputFile(jsx.file);
-        if (css?.file) {
-          await this.fileCompiler.removeOutputFile(css.file);
+      let meta;
+      switch (key) {
+        case "sfc" /* SFC */: {
+          meta = m;
+          const { jsx, css } = meta.output;
+          await this.fileCompiler.removeOutputFile(jsx.file);
+          if (css?.file) {
+            await this.fileCompiler.removeOutputFile(css.file);
+          }
+          break;
+        }
+        case "script" /* SCRIPT */: {
+          meta = m;
+          await this.fileCompiler.removeOutputFile(meta.output.script.file);
+          break;
+        }
+        case "style" /* STYLE */: {
+          meta = m;
+          await this.fileCompiler.removeOutputFile(meta.output.style.file);
+          break;
+        }
+        // 静态资产缓存直接删除对应文件
+        default: {
+          await this.fileCompiler.removeOutputFile(m.file, true);
+          break;
         }
-      } else if (key === "script" /* SCRIPT */ || key === "copied" /* ASSET */) {
-        await this.fileCompiler.removeOutputFile(m.file, true);
       }
     };
     await Promise.all(toRemove.map(removeFn));
+    const removedFiles = new Set(toRemove.map((m) => m.file));
+    cache.target = cache.target.filter((m) => !removedFiles.has(m.file));
     await this.fileCompiler.saveCache(cache);
   }
 };
 
 // src/compiler/shared/file-compiler/compilation-unit.ts
-import kleur4 from "kleur";
+import kleur5 from "kleur";
 var CompilationUnitProcessor = class {
   constructor(fileCompiler) {
     this.fileCompiler = fileCompiler;
@@ -6449,7 +6533,7 @@ var CompilationUnitProcessor = class {
       this.resolveResult(result, unit, key);
     } catch (err) {
       console.info(
-        kleur4.red(`\u2716`),
+        kleur5.red(`\u2716`),
         `Failed to compile ${this.fileCompiler.relativePath(unit.file)}
 `,
         err
@@ -6530,20 +6614,16 @@ var CompilationUnitProcessor = class {
 };
 
 // src/compiler/shared/file-compiler/file-processor.ts
-import fs3 from "fs";
-import path6 from "path";
+import fs4 from "fs";
+import kleur6 from "kleur";
+import path7 from "path";
 var FileProcessor = class {
   constructor(fileCompiler, compilationUnitProcessor, cacheManager) {
     this.fileCompiler = fileCompiler;
     this.compilationUnitProcessor = compilationUnitProcessor;
     this.cacheManager = cacheManager;
   }
-  pkgs = {
-    router: {
-      name: PACKAGE_NAME.router,
-      version: "^1.0.0"
-    }
-  };
+  skippedCount = 0;
   /**
    * Process a single Vue file (this method is called directly in CLI Watch mode)
    */
@@ -6570,10 +6650,13 @@ var FileProcessor = class {
     const { shouldCompile, hash } = await this.fileCompiler.checkCacheStatus(
       fileMeta,
       record,
-      () => fs3.promises.readFile(absPath, "utf-8")
+      () => fs4.promises.readFile(absPath, "utf-8")
     );
-    if (!shouldCompile) return;
-    const source = await fs3.promises.readFile(absPath, "utf-8");
+    if (!shouldCompile) {
+      this.skippedCount++;
+      return;
+    }
+    const source = await fs4.promises.readFile(absPath, "utf-8");
     if (!source.trim()) return;
     const initUnit = {
       ...fileMeta,
@@ -6589,46 +6672,108 @@ var FileProcessor = class {
       await this.compilationUnitProcessor.saveCompiledFiles(processed, key);
       if (key === "sfc" /* SFC */ || key === "script" /* SCRIPT */) {
         if (processed?.hasRoute) {
-          await this.injectVuReactRouteDep();
-          await this.copyRouteSetupNotes();
+          await this.addRouterToPackageJson();
+          await this.updateEntryWithRouterProvider();
         }
       }
       await this.cacheManager.updateCacheIncrementally(processed, key);
     }
     return processed;
   }
-  async injectVuReactRouteDep() {
-    const pkgPath = this.fileCompiler.getOutputPkgPath();
-    const pkg = await this.fileCompiler.resolvePackageFile(pkgPath);
-    const { router } = this.pkgs;
-    if (!pkg["dependencies"]) {
-      pkg["dependencies"] = {};
+  /**
+   * 对 package.json 注入路由依赖项
+   */
+  async addRouterToPackageJson() {
+    const { output } = this.fileCompiler.options;
+    if (output?.bootstrapVite === false) {
+      return;
+    }
+    const { router } = RUNTIME_PACKAGES;
+    const filePath = this.fileCompiler.getOutputPkgPath();
+    const packageJson = await this.fileCompiler.resolvePackageFile(filePath);
+    if (packageJson?.dependencies?.[router.name]) {
+      return;
     }
-    pkg["dependencies"][router.name] = router.version;
-    await fs3.promises.writeFile(pkgPath, JSON.stringify(pkg, null, 2), "utf-8");
+    if (!packageJson.dependencies) {
+      packageJson.dependencies = {};
+    }
+    packageJson.dependencies[router.name] = router.version;
+    const newData = JSON.stringify(packageJson, null, 2);
+    await this.fileCompiler.writeFileWithDir(filePath, newData, {
+      lock: true
+    });
   }
   /**
-   * 如果使用了路由，则拷贝路由配置说明文档到输出目录根部。
+   * 注入路由提供器到 React 应用的入口文件（如 main.tsx）
    */
-  async copyRouteSetupNotes() {
-    const outputDir = this.fileCompiler.getOuputPath();
-    const packageRoot = path6.resolve(getDirname(import.meta.url), "../");
-    const templateDir = path6.join(packageRoot, "templates");
-    if (!fs3.existsSync(templateDir)) {
+  async updateEntryWithRouterProvider() {
+    const { exclude, output, router } = this.fileCompiler.options;
+    const inputPath = this.fileCompiler.getInputPath();
+    const outputPath = this.fileCompiler.getOuputPath(true);
+    if (output?.bootstrapVite === false || router?.autoUpdateEntry === false || !router?.configFile) {
       return;
     }
-    const files = ["route-setup-notes.md", "route-setup-notes.zh.md"];
-    for (const file of files) {
-      const srcPath = path6.join(templateDir, file);
-      if (!fs3.existsSync(srcPath)) continue;
-      const destPath = path6.join(outputDir, file);
-      await fs3.promises.copyFile(srcPath, destPath);
+    const getMainFile = async (filename) => {
+      const filePath = path7.resolve(outputPath, filename);
+      try {
+        return { filePath, content: await fs4.promises.readFile(filePath, "utf-8") };
+      } catch {
+        return;
+      }
+    };
+    const fileData = await getMainFile("main.tsx") || await getMainFile("main.jsx");
+    if (!fileData) {
+      console.warn(
+        `${kleur6.yellow("\u26A0\uFE0F")}  React application entry file not found, please confirm the filename is main.tsx or main.jsx?`
+      );
+      return;
     }
+    const prepareRouterEntry = () => {
+      const importPath = this.fileCompiler.resolveRelativePath(inputPath, router.configFile);
+      let content = fileData.content;
+      if (exclude?.includes(router.configFile) || exclude?.includes(importPath)) {
+        return content;
+      }
+      const routerModule = "RouterInstance";
+      if (content.includes(routerModule) || content.includes(importPath)) {
+        return content;
+      }
+      const routerImport = `import ${routerModule} from '${importPath}'`;
+      if (content.includes("./App")) {
+        const appImportRegex = /import\s+(?:App|.*)\s+from\s+['"]\.\/App\.(?:tsx|jsx)['"]/;
+        content = content.replace(appImportRegex, routerImport);
+      } else {
+        const lastImportMatch = content.match(/import.*from.*\n/g);
+        if (lastImportMatch) {
+          const lastImport = lastImportMatch.pop();
+          content = content.replace(lastImport, `${lastImport}
+${routerImport}`);
+        } else {
+          content = `${routerImport}${content}`;
+        }
+      }
+      const providerTag = `<${routerModule}.RouterProvider />`;
+      fileData.content = content.replace(/<App\s*\/?>/g, providerTag);
+    };
+    prepareRouterEntry();
+    await this.fileCompiler.writeFileWithDir(fileData.filePath, fileData.content);
+  }
+  /**
+   * 获取跳过的文件数量
+   */
+  getSkippedCount() {
+    return this.skippedCount;
+  }
+  /**
+   * 重置跳过的文件数量
+   */
+  resetSkippedCount() {
+    this.skippedCount = 0;
   }
 };
 
 // src/compiler/shared/file-compiler/pipeline-manager.ts
-import path7 from "path";
+import path8 from "path";
 var PipelineManager = class {
   constructor(fileCompiler, fileProcessor) {
     this.fileCompiler = fileCompiler;
@@ -6663,7 +6808,7 @@ var PipelineManager = class {
     const scriptExtRegex = /\.(js|ts)$/i;
     const styleExtRegex = /\.(css|less|sass|scss)$/i;
     const files = this.fileCompiler.scanFiles(inputPath, (p) => {
-      const ext = path7.extname(p);
+      const ext = path8.extname(p);
       if (key === "sfc" /* SFC */) {
         return ext === ".vue";
       }
@@ -6675,28 +6820,21 @@ var PipelineManager = class {
       }
       return false;
     });
-    if (!files.length) return 0;
-    const cache = await this.fileCompiler.loadCache(key);
     const absFiles = new Set(files.map((f) => this.fileCompiler.getAbsPath(f)));
     await this.cleanupManager.cleanupOldOutput(key, (c) => !absFiles.has(c.file));
-    const results = await Promise.all(
-      files.map(async (f) => {
-        if (key === "sfc" /* SFC */) {
-          return this.fileProcessor.processFile(key, f, cache);
-        } else {
-          return this.fileProcessor.processFile(key, f, cache);
-        }
-      })
+    if (!files.length) return 0;
+    const cache = await this.fileCompiler.loadCache(key);
+    const compiled = await Promise.all(
+      files.map(async (f) => this.fileProcessor.processFile(key, f, cache))
     );
-    const compiledCount = results.filter(Boolean).length;
-    this.skippedCount += files.length - compiledCount;
-    return compiledCount;
+    await this.fileCompiler.flushCache(key);
+    return compiled.filter(Boolean).length;
   }
   /**
    * 获取跳过的文件数量
    */
   getSkippedCount() {
-    return this.skippedCount;
+    return this.skippedCount += this.fileProcessor.getSkippedCount();
   }
   /**
    * 重置跳过的文件数量
@@ -6707,9 +6845,9 @@ var PipelineManager = class {
 };
 
 // src/compiler/shared/file-compiler/vite-bootstrapper.ts
-import { execSync as execSync2 } from "child_process";
-import fs4 from "fs";
-import kleur5 from "kleur";
+import { execSync } from "child_process";
+import fs5 from "fs";
+import kleur7 from "kleur";
 import ora from "ora";
 var ViteBootstrapper = class {
   constructor(fileCompiler, options) {
@@ -6717,21 +6855,19 @@ var ViteBootstrapper = class {
     this.options = options;
   }
   spinner = ora();
-  pkgs = {
-    runtime: {
-      name: PACKAGE_NAME.runtime,
-      version: "^1.0.0"
-    }
+  defaultConfig = {
+    template: "react-ts",
+    viteVersion: "@latest"
   };
   /**
    * 检查是否需要初始化 Vite 环境
    */
   isSingleFile() {
     const inputPath = this.fileCompiler.getInputPath();
-    if (!fs4.existsSync(inputPath)) {
+    if (!fs5.existsSync(inputPath)) {
       return false;
     }
-    const stat = fs4.statSync(inputPath);
+    const stat = fs5.statSync(inputPath);
     return stat.isFile();
   }
   /**
@@ -6739,27 +6875,27 @@ var ViteBootstrapper = class {
    */
   async bootstrapIfNeeded() {
     const { bootstrapVite } = this.options.output || {};
+    const workspaceDir = this.fileCompiler.getWorkspaceDir();
+    await fs5.promises.mkdir(workspaceDir, { recursive: true });
     if (bootstrapVite === false) {
       return false;
     }
     if (this.isSingleFile()) {
-      console.info(kleur5.dim("Skipping Vite initialization for single file compilation"));
+      console.info("Skipping Vite initialization for single file compilation");
       return false;
     }
-    const workspaceDir = this.fileCompiler.getWorkspaceDir();
     const outputPkgPath = this.fileCompiler.getOutputPkgPath();
-    if (fs4.existsSync(outputPkgPath)) {
+    if (fs5.existsSync(outputPkgPath)) {
       return false;
     }
     this.spinner.start("Bootstrapping Vite React environment...");
-    await fs4.promises.mkdir(workspaceDir, { recursive: true });
     try {
-      this.resolveViteCreateApp();
+      await this.resolveViteCreateApp();
     } catch (err) {
       this.spinner.stop();
       console.error(
-        kleur5.red("\u2716"),
-        "Failed to bootstrap Vite environment. Please check npm/network\n",
+        kleur7.red("\u2716"),
+        "Failed to bootstrap Vite environment. Please check npm/network.",
         err
       );
       return false;
@@ -6779,7 +6915,7 @@ var ViteBootstrapper = class {
         ...vite
       };
       if (!isDev) {
-        const { runtime } = this.pkgs;
+        const { runtime } = RUNTIME_PACKAGES;
         deps[runtime.name] = runtime.version;
       }
       return deps;
@@ -6791,91 +6927,122 @@ var ViteBootstrapper = class {
     const newDevDeps = resolveDeps(rootPkg.devDependencies, vitePkg.devDependencies, true);
     vitePkg.dependencies = newDeps;
     vitePkg.devDependencies = newDevDeps;
-    await fs4.promises.writeFile(outputPkgPath, JSON.stringify(vitePkg, null, 2), "utf-8");
+    const newVitePkg = JSON.stringify(vitePkg, null, 2);
+    await this.fileCompiler.writeFileWithDir(outputPkgPath, newVitePkg);
     this.spinner.succeed("Standard Vite React environment initialized");
     return true;
   }
   /**
    * 执行 vite 创建命令
    */
-  resolveViteCreateApp() {
+  async resolveViteCreateApp() {
     const { output } = this.options;
-    const config = output?.bootstrapVite;
-    const template = typeof config === "object" ? config.template : "react-ts";
+    const { viteVersion, template: tmpl } = this.defaultConfig;
+    const bootstrapVite = output?.bootstrapVite;
     const outDirName = this.fileCompiler.getOutDirName();
-    const cmd = `npm create vite@latest ${outDirName} -- --template ${template}`;
-    execSync2(cmd, {
+    const configObject = typeof bootstrapVite === "object" ? bootstrapVite : null;
+    const viteVer = configObject?.vite || viteVersion;
+    const reactVer = configObject?.react;
+    const template = configObject?.template || tmpl;
+    const cmd = `npm create vite${viteVer} ${outDirName} -- --template ${template}`;
+    execSync(cmd, {
       cwd: this.fileCompiler.getWorkspaceDir(),
       stdio: "ignore"
       // 隐藏 create-vite 内部的输出日志，保持终端整洁
     });
+    if (reactVer) {
+      await this.resolveReactVersion(reactVer);
+    }
   }
-};
-
-// src/compiler/shared/file-compiler/index.ts
-var FileCompiler = class extends BaseCompiler {
-  skippedCount = 0;
-  spinner = ora2();
-  // 管理器实例
-  viteBootstrapper;
-  pipelineManager;
-  fileProcessor;
-  compilationUnitProcessor;
-  cacheManager;
-  assetManager;
-  cleanupManager;
   /**
-   * 创建文件系统编译器实例
-   *
-   * @param options - 编译器配置选项，继承自 BaseCompiler 的选项
-   *                 包括输入路径、输出配置、缓存设置、排除模式等
-   * @see {@link CompilerOptions} 查看完整的选项说明
+   * 处理 React 包版本
+   * @param ver 版本号
    */
-  constructor(options = {}) {
-    super(options);
-    this.initializeManagers();
+  async resolveReactVersion(ver) {
+    const outputPkgPath = this.fileCompiler.getOutputPkgPath();
+    const vitePkg = await this.fileCompiler.resolvePackageFile(outputPkgPath);
+    const typesVer = `^${ver.split(".")[0].replace(/@|\^/, "")}.0.0`;
+    vitePkg.dependencies.react = ver;
+    vitePkg.dependencies["react-dom"] = ver;
+    vitePkg.devDependencies["@types/react"] = typesVer;
+    vitePkg.devDependencies["@types/react-dom"] = typesVer;
+    await this.fileCompiler.writeFileWithDir(outputPkgPath, JSON.stringify(vitePkg, null, 2), {
+      lock: true
+    });
+  }
+};
+
+// src/compiler/shared/file-compiler/setup-manager.ts
+var SetupManager = class {
+  constructor(getCompiler) {
+    this.getCompiler = getCompiler;
+    this.setup();
   }
   /**
    * 初始化所有管理器实例
    *
-   * 按照依赖关系顺序创建各个管理器：
+   * !必须按照依赖关系顺序创建各个管理器：
    * 1. 基础管理器（无依赖）
    * 2. 依赖基础管理器的管理器
    * 3. 依赖其他管理器的管理器
-   *
-   * @private
    */
-  initializeManagers() {
-    this.cacheManager = new CacheManager(this);
-    this.cleanupManager = new CleanupManager(this);
-    this.compilationUnitProcessor = new CompilationUnitProcessor(this);
-    this.fileProcessor = new FileProcessor(this, this.compilationUnitProcessor, this.cacheManager);
-    this.viteBootstrapper = new ViteBootstrapper(this, this.options);
-    this.pipelineManager = new PipelineManager(this, this.fileProcessor);
-    this.assetManager = new AssetManager(this, this.cleanupManager);
+  setup() {
+    const fileCompiler = this.getCompiler();
+    this.setupBaseManager(fileCompiler);
+    this.setupManagedByBase(fileCompiler);
+    this.setupCompositeManager(fileCompiler);
   }
   /**
-   * 执行完整的编译流程
-   *
-   * 该方法执行以下步骤：
-   * 1. 环境初始化：清理旧输出（如果禁用缓存）并初始化 Vite 项目环境
-   * 2. Vue 文件编译：批量处理所有 .vue 文件
-   * 3. Script 文件编译：批量处理所有 .js/.ts 文件
-   * 4. 资源文件拷贝：处理剩余的非编译文件
-   * 5. 统计输出：显示编译结果和性能统计
-   *
-   * @async
-   * @throws {Error} 当编译过程中发生致命错误时抛出
-   * @returns {Promise<void>}
+   * 创建基础的管理器（无外部依赖）
+   */
+  setupBaseManager(fileCompiler) {
+    fileCompiler.manager = {};
+    const manager = fileCompiler.manager;
+    manager.cacheManager = new CacheManager(fileCompiler);
+    manager.cleanupManager = new CleanupManager(fileCompiler);
+  }
+  /**
+   * 创建依赖基础管理器的管理器
    */
+  setupManagedByBase(fileCompiler) {
+    const manager = fileCompiler.manager;
+    manager.fileProcessor = new FileProcessor(
+      fileCompiler,
+      new CompilationUnitProcessor(fileCompiler),
+      manager.cacheManager
+    );
+  }
+  /**
+   * 创建依赖其他管理器的管理器
+   */
+  setupCompositeManager(fileCompiler) {
+    const manager = fileCompiler.manager;
+    manager.viteBootstrapper = new ViteBootstrapper(fileCompiler, fileCompiler.options);
+    manager.pipelineManager = new PipelineManager(fileCompiler, manager.fileProcessor);
+    manager.assetManager = new AssetManager(fileCompiler, manager.cleanupManager);
+  }
+};
+
+// src/compiler/shared/file-compiler/index.ts
+var FileCompiler = class extends BaseCompiler {
+  manager;
+  spinner = ora2();
+  constructor(options = {}) {
+    super(options);
+    new SetupManager(() => this);
+  }
+  /** 执行完整的编译流程 */
   async execute() {
-    console.info("\n\n", kleur6.magenta(`${kleur6.bold("VUREACT")} v${this.version}`), "\n");
+    console.info("\n\n", kleur8.magenta(`${kleur8.bold("VUREACT")} v${this.version}`), "\n");
     const startTime = performance.now();
-    if (!this.getIsCache()) {
-      await fs5.promises.rm(this.getWorkspaceDir(), { recursive: true, force: true });
-    }
-    await this.viteBootstrapper.bootstrapIfNeeded();
+    const rmWorkspace = async () => {
+      await this.rmFile(this.getWorkspaceDir());
+    };
     try {
+      if (!this.getIsCache()) {
+        await rmWorkspace();
+      }
+      await this.manager.viteBootstrapper.bootstrapIfNeeded();
       const sfcCount = await this.runPipelineWithSpinner("sfc" /* SFC */);
       const scriptCount = await this.runPipelineWithSpinner("script" /* SCRIPT */);
       const styleCount = await this.runPipelineWithSpinner("style" /* STYLE */);
@@ -6886,35 +7053,71 @@ var FileCompiler = class extends BaseCompiler {
       this.showCompileStats(endTime, sfcCount, scriptCount, styleCount, assetCount);
     } catch (error) {
       const endTime = calcElapsedTime(startTime);
-      console.error(kleur6.red("\u2716"), `Build failed in ${endTime}`);
+      await rmWorkspace();
+      console.error(kleur8.red("\u2716"), `Build failed in ${endTime}`);
       console.error(error);
+    } finally {
+      this.resetSkippedCount();
     }
   }
-  /**
-   * 运行管线并显示加载动画
-   *
-   * @private
-   * @param text - 加载动画显示的文本
-   * @param pipelineFn - 要执行的管线函数
-   * @returns 返回的处理的文件数
-   */
+  /** 处理单个 Vue 单文件组件（SFC） */
+  async processSFC(filePath, existingCache) {
+    return this.manager.fileProcessor.processSFC(filePath, existingCache);
+  }
+  /** 处理单个 JavaScript/TypeScript 脚本文件 */
+  async processScript(filePath, existingCache) {
+    return this.manager.fileProcessor.processScript(filePath, existingCache);
+  }
+  /** 处理单个 CSS/LESS/SCSS 样式文件 */
+  async processStyle(filePath, existingCache) {
+    return this.manager.fileProcessor.processStyle(filePath, existingCache);
+  }
+  /** 处理单个文件（Vue 或 Script） */
+  async processFile(key, filePath, existingCache) {
+    if (key === "sfc" /* SFC */) {
+      return this.manager.fileProcessor.processFile(key, filePath, existingCache);
+    } else if (key === "script" /* SCRIPT */) {
+      return this.manager.fileProcessor.processFile(
+        key,
+        filePath,
+        existingCache
+      );
+    }
+    return this.manager.fileProcessor.processFile(
+      key,
+      filePath,
+      existingCache
+    );
+  }
+  /** 处理单个资源文件 */
+  async processAsset(filePath, existingCache) {
+    return this.manager.assetManager.processAsset(filePath, existingCache);
+  }
+  /** 批量保存缓存 */
+  async flushCache(key) {
+    await this.manager.cacheManager.flushCache(key);
+  }
+  /** 删除指定路径对应的输出文件和缓存 */
+  async removeOutputPath(targetPath, type) {
+    return await this.manager.cleanupManager.removeOutputPath(targetPath, type);
+  }
   async runPipelineWithSpinner(name) {
     const options = {
       ["sfc" /* SFC */]: {
         text: "Compiling Vue files...",
-        pipeline: () => this.pipelineManager.runSfcPipeline()
+        pipeline: () => this.manager.pipelineManager.runSfcPipeline()
       },
       ["script" /* SCRIPT */]: {
         text: "Compiling script files...",
-        pipeline: () => this.pipelineManager.runScriptPipeline()
+        pipeline: () => this.manager.pipelineManager.runScriptPipeline()
       },
       ["style" /* STYLE */]: {
         text: "Compiling style files...",
-        pipeline: () => this.pipelineManager.runStylePipeline()
+        pipeline: () => this.manager.pipelineManager.runStylePipeline()
       },
       ["copied" /* ASSET */]: {
         text: "Copying assets...",
-        pipeline: () => this.assetManager.runAssetPipeline()
+        pipeline: () => this.manager.assetManager.runAssetPipeline()
       }
     };
     const { text, pipeline } = options[name];
@@ -6927,166 +7130,36 @@ var FileCompiler = class extends BaseCompiler {
       this.spinner.stop();
     }
   }
-  /**
-   * 处理单个 Vue 单文件组件（SFC）
-   *
-   * 此方法主要用于 CLI 的 watch 模式，当检测到文件变更时调用。
-   * 支持增量编译，如果文件未变更则跳过编译。
-   *
-   * @async
-   * @param filePath - Vue 文件的绝对路径
-   * @param existingCache - 可选的预加载缓存对象，用于增量编译
-   * @returns {Promise<SFCUnit | undefined>} 编译单元对象，如果跳过编译则返回 undefined
-   * @see {@link FileProcessor.processSFC}
-   */
-  async processSFC(filePath, existingCache) {
-    return this.fileProcessor.processSFC(filePath, existingCache);
-  }
-  /**
-   * 处理单个 JavaScript/TypeScript 脚本文件
-   *
-   * 此方法主要用于 CLI 的 watch 模式，当检测到文件变更时调用。
-   * 支持增量编译，如果文件未变更则跳过编译。
-   *
-   * @async
-   * @param filePath - 脚本文件的绝对路径
-   * @param existingCache - 可选的预加载缓存对象，用于增量编译
-   * @returns {Promise<ScriptUnit | undefined>} 编译单元对象，如果跳过编译则返回 undefined
-   * @see {@link FileProcessor.processScript}
-   */
-  async processScript(filePath, existingCache) {
-    return this.fileProcessor.processScript(filePath, existingCache);
-  }
-  /**
-   * 处理单个 CSS/LESS/SCSS 样式文件
-   *
-   * 此方法主要用于 CLI 的 watch 模式，当检测到文件变更时调用。
-   * 支持增量编译，如果文件未变更则跳过编译。
-   *
-   * @async
-   * @param filePath - style 文件的绝对路径
-   * @param existingCache - 可选的预加载缓存对象，用于增量编译
-   * @returns {Promise<ScriptUnit | undefined>} 编译单元对象，如果跳过编译则返回 undefined
-   * @see {@link FileProcessor.processStyle}
-   */
-  async processStyle(filePath, existingCache) {
-    return this.fileProcessor.processStyle(filePath, existingCache);
-  }
-  /**
-   * 处理单个文件（Vue 或 Script）
-   *
-   * 通用的文件处理方法，根据 CacheKey 类型自动选择处理逻辑。
-   * 主要用于内部调用和统一的文件处理接口。
-   *
-   * @async
-   * @param key - 文件类型标识（SFC 或 SCRIPT）
-   * @param filePath - 文件的绝对路径
-   * @param existingCache - 可选的预加载缓存对象
-   * @returns {Promise<SFCUnit | ScriptUnit | undefined>} 编译单元对象
-   * @see {@link FileProcessor.processFile}
-   */
-  async processFile(key, filePath, existingCache) {
-    if (key === "sfc" /* SFC */) {
-      return this.fileProcessor.processFile(key, filePath, existingCache);
-    } else if (key === "script" /* SCRIPT */) {
-      return this.fileProcessor.processFile(key, filePath, existingCache);
-    }
-    return this.fileProcessor.processFile(
-      key,
-      filePath,
-      existingCache
-    );
-  }
-  /**
-   * 处理单个资源文件
-   *
-   * 比较文件与缓存，决定是否需要拷贝。
-   * 资源文件包括图片、字体、样式文件等非编译文件。
-   *
-   * @async
-   * @param filePath - 资源文件的绝对路径
-   * @param existingCache - 可选的预加载缓存对象
-   * @returns {Promise<FileCacheMeta>} 资源文件的缓存元数据
-   * @see {@link AssetManager.processAsset}
-   */
-  async processAsset(filePath, existingCache) {
-    return this.assetManager.processAsset(filePath, existingCache);
-  }
-  /**
-   * 删除指定路径对应的输出文件和缓存
-   *
-   * 当源文件被删除或重命名时，需要清理对应的输出文件。
-   * 主要用于 watch 模式下的文件删除处理。
-   *
-   * @async
-   * @param targetPath - 源代码的路径（文件或文件夹）
-   * @param type - 清理类型，指定是 SFC、SCRIPT 还是 ASSET
-   * @returns {Promise<void>}
-   * @see {@link CleanupManager.removeOutputPath}
-   */
-  async removeOutputPath(targetPath, type) {
-    return this.cleanupManager.removeOutputPath(targetPath, type);
-  }
-  /**
-   * 获取跳过的文件数量
-   *
-   * 在增量编译中，未变更的文件会被跳过。
-   * 此方法返回当前编译会话中跳过的文件数量。
-   *
-   * @returns {number} 跳过的文件数量
-   */
-  getSkippedCount() {
-    return this.skippedCount;
-  }
-  /**
-   * 重置跳过的文件数量
-   *
-   * 在每次新的编译会话开始时调用，重置计数器。
-   */
-  resetSkippedCount() {
-    this.skippedCount = 0;
-  }
-  /**
-   * 显示编译统计信息
-   *
-   * 在编译完成后调用，显示以下信息：
-   * 1. 编译耗时
-   * 2. 输出目录
-   * 3. 跳过的文件数量
-   * 4. 处理的文件分类统计
-   *
-   * @private
-   * @param endTime - 格式化后的编译耗时字符串
-   * @param sfcCount - 处理的 Vue 文件数量
-   * @param scriptCount - 处理的脚本文件数量
-   * @param assetCount - 处理的资源文件数量
-   */
   showCompileStats(endTime, sfcCount, scriptCount, styleCount, assetCount) {
-    const dir = normalizePath(this.relativePath(this.getOuputPath()));
     this.spinner.succeed(`Build completed in ${endTime}`);
-    console.info(` Output directory: ${kleur6.dim(dir)}`);
     console.info();
-    this.skippedCount += this.pipelineManager.getSkippedCount();
-    this.pipelineManager.resetSkippedCount();
-    if (this.skippedCount) {
-      console.info(kleur6.dim(`Skipped ${this.skippedCount} unchanged file(s)`));
-      this.resetSkippedCount();
-    }
     if (sfcCount || scriptCount || styleCount || assetCount) {
       const stats = [];
       if (sfcCount) stats.push(`${sfcCount} SFC(s)`);
       if (scriptCount) stats.push(`${scriptCount} script(s)`);
       if (styleCount) stats.push(`${styleCount} style(s)`);
       if (assetCount) stats.push(`${assetCount} asset(s)`);
-      console.info(kleur6.gray(`Processed ${stats.join(", ")}`));
+      this.spinner.succeed(`Processed: ${stats.join(", ")}`);
     }
+    const skippedCount = this.manager.pipelineManager.getSkippedCount() + this.manager.assetManager.getSkippedCount();
+    if (skippedCount) {
+      console.info(kleur8.gray(`\u21B7 Cached: ${kleur8.white(skippedCount)} unchanged file(s)`));
+      this.resetSkippedCount();
+    }
+    const dir = normalizePath(this.relativePath(this.getOuputPath()));
     console.info();
+    console.info(`\u{1F4E6} Output: ${dir}`);
+    console.info();
+  }
+  resetSkippedCount() {
+    this.manager.pipelineManager.resetSkippedCount();
+    this.manager.assetManager.resetSkippedCount();
   }
 };
 
 // src/compiler/shared/define-config.ts
-function defineConfig(options) {
-  return options;
+function defineConfig(config) {
+  return typeof config === "function" ? config() : config;
 }
 
 // src/compiler/index.ts