TypeScript 客户端
本页回答：浏览器或 Node 应用需要哪个 Wow TypeScript 包，它又依赖什么？
Wow 仓库提供 Wow HTTP 契约的 TypeScript 端。这些包位于 typescript/，建立在通用 HTTP 客户端 Fetcher 之上；Fetcher 保留自己的仓库和文档。
包
| 包 | 用途 | 状态 |
|---|---|---|
@ahoo-wang/wow-client | 发送命令，读取快照与事件流，构造过滤、分页与聚合 | 已发布 |
@ahoo-wang/wow-generator | 从 Wow OpenAPI 文档生成类型化模型、命令客户端和查询客户端 | 已发布；命令为 wow-generator |
@ahoo-wang/wow-react | 在 React 组件中驱动 Wow 的单条、列表、分页、计数和流式查询 | 已发布 |
@ahoo-wang/wow-view-engine | 让用户在 Wow 数据上筛选、分组、出图并保存视图 | 尚未发布 |
前三个包来自 Fetcher 仓库，原名分别是 @ahoo-wang/fetcher-wow、@ahoo-wang/fetcher-generator 以及 @ahoo-wang/fetcher-react 中的 Wow Hook。项目还在用旧包名时，先看迁移指南。
依赖关系
依赖只有一个方向：Wow 的包依赖 Fetcher 的包，反过来不行。对其他包的依赖一律是 peer 依赖，由应用自己安装并决定版本。
| peer 依赖 | 范围 |
|---|---|
@ahoo-wang/fetcher、fetcher-decorator、fetcher-eventstream、fetcher-openapi | ^5.1 || ^6 |
@ahoo-wang/fetcher-react（wow-react 需要） | ^5.1.3 || ^6 |
react、react-dom（wow-react 需要） | ^19.3.0，不支持 React 18 |
@ahoo-wang/wow-client（其他 Wow 包需要） | 同一个小版本，~x.y.z |
版本
TypeScript 包与 Kotlin 模块共用一个版本号：例如 @ahoo-wang/wow-client 9.2.3 与 Wow 9.2.3 从同一个 tag 一起发布。选择与所调用 Wow 服务端相同的客户端版本，并同时升级各个 Wow 包。破坏性改动只在 x.Y.0 版本发布，并在发布说明的 “Breaking” 一节列出。
在 Wow 9.x 期间，客户端和生成器仍能连接 Wow 8.x 服务端：8.11 及以后用 FilterExpression，8.10 通过已弃用的 Condition API，它放在 @ahoo-wang/wow-client/legacy 子路径里。两者都在 v10 移除。
安装
pnpm add @ahoo-wang/fetcher @ahoo-wang/fetcher-decorator @ahoo-wang/fetcher-eventstream @ahoo-wang/wow-client
pnpm add -D @ahoo-wang/wow-generator @ahoo-wang/fetcher-openapi typescript使用 React Hook 时再加上 react、react-dom、@ahoo-wang/fetcher-react 和 @ahoo-wang/wow-react。wow-react 需要 React 19.3 或更高版本：它用 React Compiler 构建，会导入 React 18 没有的 react/compiler-runtime。各包的参考页给出了精确的安装命令。
按任务继续
| 任务 | 先读 | 再读 |
|---|---|---|
| 手写代码发送命令并读取状态 | 命令与查询 | wow-client 参考 |
| 从服务端 OpenAPI 文档生成客户端 | 生成客户端 | wow-generator 参考和 Wow 聚合发现 |
| 在 React 中展示查询结果 | wow-react 查询 Hook | 快照查询 |
| 评估可保存的数据视图 | 视图引擎 | wow-view-engine 参考 |
| 从 Fetcher 旧包名迁移 | 从 Fetcher 包迁移 | 各包的参考页 |
这些契约的服务端见命令、查询和 Open API。拦截器、取消、服务端推送事件等通用 Fetcher 主题仍在 fetcher.ahoo.me。
在 Storybook 中试用
Storybook 用内存夹具运行查询 Hook 和视图引擎，下面每个示例都不需要服务端。
| 示例 | 展示内容 |
|---|---|
| Wow 查询 Hook | 通过 wow-react 的 Hook 执行单条、列表、分页、计数和流式查询 |
| 视图引擎首页 | 用嵌入仪表盘搭成的宿主应用落地页 |
| 明细工作台 | 筛选、排序、列、分页和可保存的明细视图 |
| 分析工作台 | 分组、指标、图表和带合计行的表格 |
| 仪表盘 | 面板、整板筛选和跨仪表盘跳转 |