Jazor.Vue 1.1.0

Jazor.Vue

定位：Razor SDK 项目显式启用 Razor-to-Vue 的 NuGet 包。

资源契约：RazorVue 生成的组件模块进入程序集内的 Jazor.Generated.ModuleCatalog；Vue runtime bridge 由本包 manifest 声明的 embedded carrier 提供，外部 binding runtime 由 npm/JSR package metadata 提供。

Jazor.Vue 安装消费官方 Razor Source Generator 最终 Roslyn Compilation 的 generator-driver hook。Razor 组件的 BuildRenderTree 操作会降低为 Vue render-function 模块，并生成供 Jazor.Emit 读取的 Jazor.Generated.ModuleCatalog；本包唯一的 buildTransitive/Jazor.Vue.targets 始终传递资源 manifest locator，并仅在当前项目直接声明 Jazor.Vue 时注册 RazorVue analyzer。

安装

<ItemGroup>
  <PackageReference Include="Jazor" Version="1.1.0" />
  <PackageReference Include="Jazor.Vue" Version="1.1.0" PrivateAssets="all" />
</ItemGroup>

该包是 opt-in，必须与 Jazor 一起引用。只引用 Jazor 不会安装 Razor hook、扫描 Razor 组件或生成 Vue 模块。Jazor.Vue 只携带合并后的 Jazor.RazorVue analyzer，避免重复装载共享 generator。

编写 RazorVue 组件的类库或应用必须在当前项目直接声明 Jazor 和 Jazor.Vue；组件模块属于 纯 Jazor carrier，生成后进入程序集内的 Jazor.Generated.ModuleCatalog。如果项目发布可复用 类库，工具引用通常使用 PrivateAssets="all"；只消费该类库的下游项目不会因传递引用获得 RazorVue analyzer、generator 或 Emit 资格。

Jazor/Jazor.Vue 的 analyzer、generator、build target 和 Emit 资格遵循“谁使用，谁直接引用”；它们不应因为中间类库引用而成为下游的隐式工具依赖。组件库的 ESM/CSS 等运行时资源通过 manifest 的显式依赖传播。跨项目的完整规则见类库产物与引用契约。

RazorVue analyzer 与 AngleSharp 位于 tools/net11.0/analyzers/，由当前项目直接声明 Jazor.Vue 时通过该包的 buildTransitive/Jazor.Vue.targets 条件注册；它们不放入 NuGet 自动导入的 analyzers/dotnet/cs，也不随组件库引用激活。

Blazor framework CLR mapping 由 Jazor.CLR.Generator 从真实 ASP.NET Core reference symbol 生成，再由 Jazor.CLR 唯一持有 module、mapping、helper；生成的 runtime JavaScript 进入 ECMAScript 的 manifest 与 src/ECMAScript/clr/** carrier，用户不需要复制映射源码或手工注册资源。当前 browser-interactive Support 覆盖 Mouse/Keyboard/Focus/Change，以及 Pointer/Wheel/Drag/Clipboard/Touch/Error/Progress 的 getter-only 原生事件投影；TouchList 在 CLR 属性访问时惰性转换为数组 carrier。七组扩展事件已由 Blazor EventHandlers reference metadata、official Razor SG/NodeApi、真实 BrowserSmoke 与 isolated Release package consumer 共同验证。统一 Release 包边界和基本 Razor/Vue 消费路径已由 SdkIntegrationTests.Build_LocalReleasePackage_CoreConsumer_ExcludesBlazorAndVuePackages 与 SdkIntegrationTests.Build_LocalReleasePackage_VueConsumer_IncludesRazorVueWithoutBlazorAssembly 分别验证；合成 EventArgs payload、CLR DataTransfer DTO 的 Files/Items 属性和完整 SSR/prerender identity 仍不支持/不声明。preview.8 的原生集合入口见下述 extension。

preview.8 增加原生 file/drop 切片：InputFileChangeEventArgs 的 CLR alias 保留 browser Event carrier，FileCount 投影原生 list length；本包的 ECMAScript.NativeFileEventExtensions 为现有 InputFileChangeEventArgs/DragEventArgs 增加 Files 属性，直接访问 FileList/FileRef 和 FormData。该 extension 位于 opt-in Vue 作者程序集，核心 ECMAScript/Jazor.CLR 不引入 ASP.NET Core 引用。官方 Razor SG、compiler 和 NodeApi 回归覆盖原生文件载荷、清空、多文件、multipart 和 Object URL 回收；IBrowserFile/CLR Stream 未进入此切片。写法见 Browser Interop。

preview.8 同时为 12 种 DOM 事件增加 NativeEvent 和缺失的原生属性，剪贴板可直接使用 ClipboardData，焦点/鼠标可使用 RelatedTarget。NativeBrowserPayloadExtensions 补齐 DataTransfer、DataTransferItem、TouchPoint、ElementReference 的强类型原生投影；DataTransferItem.Kind/Type 也已映射。原生 NativeFiles/NativeItems/NativeTouches 保留 browser collection，完整方法继续来自 WebIDL；既有 CLR 数组属性的边界保持。详细列表见原生事件扩展。

产物输出

JazorDir 默认是 $(MSBuildProjectDirectory)\jazor\ 的最终输出目录。MSBuild 只在最终 Exe/WinExe 构建后调用 Emit；它读取程序集 ModuleCatalog 与资源 manifest，完成校验后直接 物化到该目录，发布时由 SDK 将 dist/** 和可选 ssr/** 复制到 <publish>\jazor\；source map 默认不发布，需要时设置 JazorPublishSourceMaps=true。该集成不需要 EnableRazorHostOutputs、RazorCodeDocument、RazorCSharpDocument 或二次解析生成 C#； release 执行标准项目 package.json 中的构建脚本；默认脚本使用 Vite，也可以由应用替换。

相关文档

• Jazor.RazorVue
• 安装与配置
• Razor-to-Vue