> Jazor 仍处于实验阶段，公共 API 与生成产物形态可能继续演进。
Jazor 是一套将受支持 C# 语义转换为确定性 ECMAScript 模块的强类型 .NET 工具链。它的核心不依赖 Vue、React 或其他 UI 框架：Roslyn 提供语义模型，`Jazor.Compiler` 将其降低为 ESTree，`Jazor.Emit` 负责物化浏览器产物。
Razor-to-Vue 是建立在该核心之上的一个应用方向。`Jazor.RazorVue` 绑定官方 Razor Source Generator 的最终输出，再将所有 C# 表达式和成员语义交给同一套 Jazor 编译器，最后组装 Vue render-function 模块。
## 最新更新
### 2026-08-24
- **包边界变更：** `Jazor` 现在保持框架无关，可用于普通 C# -> ECMAScript 类库。Vue authoring、Razor-to-Vue、Vue runtime 资源，以及 `ECMAScript.Vue`、`ECMAScript.VueContract`、`ECMAScript.Blazor` payload 由显式的 `Jazor.Vue` 提供。
- `ECMAScript.Blazor` 首批提供 Mouse/Keyboard/Focus 事件 getter 到原生 browser carrier 的 mapping；它随 `Jazor.Vue` 交付，不随 `Jazor` 安装，实际 runtime module/helper 仍由 `Jazor.CLR` 承载。
- RazorVue 浏览器导航现支持 `NavigationManager.RegisterLocationChangingHandler(...)`、`PreventNavigation()`，以及后续导航覆盖进行中 handler 时的取消语义。
- 浏览器 runtime 增加上述异步导航路径所需的 `ValueTask` 与 cancellation API 切片。
完整版本历史见 [CHANGELOG](CHANGELOG.md)。
## 致谢
Jazor 使用了 [Roslyn](https://github.com/dotnet/roslyn)、[Acornima](https://github.com/adams85/acornima)、[Netpack](https://github.com/FlorianRappl/netpack)、[DenoHost](https://github.com/thomas3577/DenoHost)、[WebRef](https://github.com/w3c/webref)，并参考了 [WootzJs](https://github.com/kswoll/WootzJs)、[h5](https://github.com/curiosity-ai/h5)、[SharpKit](https://github.com/SharpKit/SharpKit) 等早期 C# 到 JavaScript 项目。
## 核心模型
```mermaid
flowchart LR
subgraph Core["Jazor 核心平台：C# -> ECMAScript"]
CSharp["C# 模块"] --> Roslyn["Roslyn 语义模型"]
Roslyn --> Compiler["Jazor.Compiler"]
Bindings["CLR 与 ECMAScript 绑定"] --> Compiler
Compiler --> Ast["ESTree"] --> Emit["Jazor.Emit"]
Emit --> Artifacts[".mjs、源映射、manifest、bundle"]
end
subgraph Integrations["框架集成层"]
Razor["Razor 组件"] --> RazorSG["官方 Razor SG"] --> Compilation["最终 Compilation"]
Compilation --> RazorVue["Jazor.RazorVue"]
RazorVue -. 调用核心翻译钩子 .-> Compiler
RazorVue --> Emit
end
```
`Jazor.RazorVue` 是当前已实现的框架集成。未来的 `Jazor.React`、`Jazor.RazorReact` 等方向可以复用同一核心，但目前不是已支持的 API。
## 质量门槛
顶部徽标展示持续适用的验收门槛，而非会过期的单次构建结果。仓库通过可复现脚本验证以下最低要求：
- 核心编译器：至少 10,000 个通过的 `IOperation` 场景、98% 行覆盖率和 97% 分支覆盖率。
- 当前 Razor-to-Vue 集成：至少 4,000 个通过场景、90% 行覆盖率和 94% 分支覆盖率；该门槛会在集成完善后再提高。
- Vue 生态绑定：每个目标至少 90% 的已审计公共绑定契约覆盖率。
可在 `scripts/csharp/` 下运行 `verify-compiler-coverage.cs`、`verify-razorvue-coverage.cs` 或 `verify-vue-binding-coverage.cs` 复现相应门槛。当前范围与测试入口见[当前状态](docs/04-roadmap/current-status.md)。
## 包组成
| 包 | 职责 |
| --- | --- |
| `Jazor` | 框架无关的编译器、CLR 契约、分析器、emit 工具、MSBuild 与 ASP.NET Core 集成，可用于普通 ECMAScript 类库 |
| `Jazor.Vue` | Vue authoring、Razor-to-Vue opt-in、Vue runtime 资源，以及 `ECMAScript.Vue`、`ECMAScript.VueContract`、`ECMAScript.Blazor` payload |
| `ECMAScript.*` | 框架无关 ECMAScript 绑定、可选 Vue 生态绑定与 CSS-in-JS 类库 |
| `ECMAScript.VueDataUi` | `vue-data-ui` 的强类型 RazorVue 图表与按组件本地 ESM 物化 |
| `ECMAScript.VuIcons` | `vu-icons` 的强类型 RazorVue 图标，支持静态单图标与动态 catalog 路径 |
| `Jazor.Admin` | UI 库无关的管理壳库与 RazorVue 组件 |
`samples/JazorAdmin` 是消费 `Jazor.Admin` 的生产级管理参考应用，不属于该库的公共契约。
## 安装
在声明 ECMAScript 模块的每个项目中安装核心包：
```bash
dotnet add package Jazor --version 0.20.0
```
需要当前 Razor-to-Vue 集成的 Razor SDK 项目，必须显式添加 opt-in 包，并保持版本一致：
```xml
