编译约定

本页是必读规范。若不遵守，编译结果可能不符合 React 规则。

若你希望采用 AI 工具辅助或接管本编译器的前后流程，将获得显著优势。

A. 文件与入口约定

1. 建议只把可控目录纳入 input 编译器选项
2. 强烈建议把 Vue 入口（如 src/main.ts）加入 exclude
3. 先在小目录验证，再扩大范围

B. Script 约定

1. 必须使用 <script setup>
2. 宏 API 与响应式 API 仅允许在 <script setup> 顶层使用
3. 响应式 API（如 ref、computed、watch 等） 与将被转换为 React hook 的 use* 调用，必须位于顶层，禁止在条件、循环、嵌套函数内调用

C. Template 约定

1. 仅使用已支持指令，未知指令会告警
2. v-else / v-else-if 必须紧邻前一个条件分支
3. Transition 子节点需要满足约束（单节点或可推导条件分支）

D. Style 约定

1. 仅支持首个 style 块，多 style 会告警
2. 不使用 cssVars

E. 路由约定

1. 通常情况下编译器会自动处理，必要时需做小幅手动接入改造
2. 参见 路由适配

声明

当前版本目标是可控工程，不承诺复杂旧项目一次性无改动迁移。