> [!IMPORTANT]
> Jazor 仍处于实验阶段。公共 API、生成产物形态和工具链可能继续演进；编译器核心、`Jazor.Emit` 管线和 Razor SG 绑定边界是当前最稳定的基础。
Jazor 是一套使用 C# 和 Razor 构建 JavaScript 与 Vue 应用的 .NET 工具链。
核心包提供编译器、运行时契约、分析器、emit 工具和 MSBuild 集成。Razor-to-Vue 转换通过 `Jazor.Vue` 显式启用：官方 Razor 源生成器的输出会绑定为 Roslyn `IOperation`，并降低为 Vue render-function `.mjs` 产物。
实现由 `Jazor.Compiler`、`Jazor.CLR`、`Jazor.Analyzer`、`Jazor.Emit`、`Jazor.Common` 以及 ECMAScript / Vue 绑定程序集组成。
## 已验证的编译器基线
`Jazor.Compiler` 使用真实 Roslyn `IOperation` 操作图进行验证，并通过 Acornima ESTree 生成 JavaScript。当前可复验基线记录于 2026-08-05：
| 指标 | 验证结果 | 当前强制阈值 |
|------|----------|--------------|
| 编译器回归测试 | 10297 / 10297 通过 | 至少通过 10000 项 |
| 行覆盖率 | 16369 / 16545（98.94%） | 98% |
| 分支覆盖率 | 6324 / 6587（96.01%） | 96% |
在仓库根目录运行正式覆盖率门禁：
```bash
dotnet run --file scripts/csharp/verify-compiler-coverage.cs
```
该门禁会运行完整编译器测试套件，读取本次 TRX 与 Cobertura 报告；测试数量或覆盖率未达到阈值时以非零状态退出。96.01% 是已验证的 `v0.1.45` 发布基线，已达到当前 96% 分支门槛。当前范围和统计方法见[编译器状态](docs/03-%E5%AE%8C%E6%88%90/compiler/status.md)与[编译器测试指南](src/Jazor.CompilerTest/README.md)。
## RazorVue 验证基线
官方 Razor SG 输出会经过 Roslyn 绑定、直接 Vue render-function 生成、源映射、catalog 产物与 Deno.host 运行时场景验证。当前可复验基线为：
| 指标 | 验证结果 | 强制阈值 |
|------|----------|----------|
| RazorVue SG 场景 | 4484 / 4484 通过 | 至少通过 4000 项 |
| 行覆盖率 | 8147 / 8719（93.44%） | 90% |
| 分支覆盖率 | 3568 / 4265（83.66%） | 80% |
在仓库根目录运行 RazorVue 覆盖率门禁：
```bash
dotnet run --file scripts/csharp/verify-razorvue-coverage.cs
```
## 架构
- **语义降低**：Roslyn `IOperation` 被转换为 Acornima ESTree，并保持明确的支持边界与确定性输出。
- **Razor 集成**：`Jazor.Vue` 从 `GeneratorDriver.RunGeneratorsAndUpdateCompilation` 取得最终 `Compilation`，并绑定生成的 `BuildRenderTree` 操作。Razor DR/IR、宿主输出文档和生成 C# 的二次解析不属于生产边界。
- **产物契约**：Razor 组件生成 Vue render-function `.mjs` 模块；`Jazor.Emit` 负责物化模块、源映射、清单、运行时资产和生产包。
- **类型化绑定**：Vue 3 核心绑定随 `Jazor` 提供；Pinia、Vue Router、Vuetify 和其他生态绑定以独立包方式引用。
## 能力
- **语义级 C# 降低**：基于 Roslyn `IOperation`，而非语法字符串替换。
- **快速失败的宿主边界**：不支持的外部运行时语义会在实际降低使用点明确报错，不会静默生成近似 JavaScript。
- **白名单约束的 CLR API**：常用 CLR API 由 `Jazor.CLR` 与生成的白名单元数据映射；分析器可提前诊断大量不支持的用法。
- **ECMAScript 模块输出**：`[ECMAScriptModule]` 类生成具名导出的 `.mjs` 模块，并提供稳定的导入收集、源位置跟踪和源映射载体。
- **Razor-to-Vue 产物生成**：Razor 组件语义从官方 Razor SG 生成的 C# 出发，经 Roslyn 绑定和编译器持有的 `IOperation` 降低。
- **类型化 Vue 编写**：`ECMAScript.Vue3` 提供 Vue 3 `defineComponent`、`h`、响应式引用、生命周期、props、slots 和组件契约绑定。
- **面向宿主的构建支持**：MSBuild 为 ECMAScript 与 RazorVue 产物选择一种输出模式：不输出、`debug` 模块与清单，或通过 Deno / Netpack 工具链生成 `release` 生产包。
## 最新更新
### 2026-08-05
- 绑定扩展方法组作为 delegate 使用时现在保留 receiver，包括标识符 receiver；生成的 callback 不会丢失原始调用上下文。
- 复合赋值、无符号右移、隐式派生类构造函数、属性初始化、插值格式 intrinsic 与 host-bound member dispatch 现在均有聚焦的 Roslyn operation 回归，覆盖求值顺序和运行时形状契约。
- 白名单生成会在生成阶段拒绝不完整的 alias 声明，避免 catalog 出现没有可用 runtime 名称的条目。
- 公开名称与已声明或保留 module binding 冲突的 import 现在会分配稳定的生成别名；继承泛型静态成员仍会使用具体 runtime host。
- 插值 `dynamic` 值现在会和其他无稳定文本契约的运行时载体一样给出明确诊断，不再泄漏内部 cast 异常。
- Compiler 门禁已验证 10,297 个真实场景，行覆盖率 98.94%、分支覆盖率 96.01%，达到 10,000 / 98% / 96% 发布门槛。
完整历史见 [release notes](docs/releases/release-notes.md)。
## 安装
```bash
dotnet add package Jazor --version 0.1.46
```
`Jazor` 包包含核心运行时契约、`ECMAScript`、`ECMAScript.Vue3`、`ECMAScript.VueContract`、`Jazor.Compiler`、`Jazor.Analyzer`、ASP.NET Core 集成程序集、emit 工具和 MSBuild props/targets。Razor-to-Vue 生成由独立的 `Jazor.Vue` 包提供。
Razor SDK 项目需显式启用：
```xml
