# @aardworx/wombat\.dom 中文文档

规范地址：https://npmcn.com/package/%40aardworx/wombat.dom/

版本：0\.25\.8
npm 元数据更新时间：2026-11-07T08:34:50.095Z
中文译文更新时间：2026-11-07T04:17:26.476Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aardworx/wombat.dom
原文对照：https://npmcn.com/package/%40aardworx/wombat.dom/?lang=original
项目主页：https://github.com/krauthaufen/wombat.dom
源码仓库：https://github.com/krauthaufen/wombat.dom

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.7 MB，358 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：3 个
- peer 依赖：@aardworx/wombat\.base ^0\.6\.0，@aardworx/wombat\.shader ^0\.6\.7，@aardworx/wombat\.rendering \>=0\.23\.0
- 首次发布：2026-05-01T06:03:26.530Z
- 最新版本发布：2026-11-07T08:34:49.915Z
- 近 30 天下载量：2051（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：89（近 12 个月 89 个）

## 中文简介

适用于Wombat TypeScript堆栈的可适应 DOM + 3D场景图 DSL – direct-DOM JSX over @aardworx/wombat.可选择的WebGPU场景图扩展.

## 安装

```sh
npm install @aardworx/wombat.dom
```

也可以使用：`pnpm add @aardworx/wombat.dom`、`yarn add @aardworx/wombat.dom`、`bun add @aardworx/wombat.dom`

## README

# @aardworx/wombat.dom

适应 DOM + 3D 场景图 DSL [旺巴特语](https://github.com/krauthaufen/wombat.adaptive) 类型脚本 堆栈。 JSX是表面,运行时间是直接DOM渲染器 [`@aardworx/wombat.adaptive`](https://www.npmjs.com/package/@aardworx/wombat.adaptive), (中文(简体) ), 如此明晰的价值观, `aval<T>`, (中文(简体) ), `alist<T>`, (中文(简体) ), `amap<K, V>` 财务报告和审定财务报表 `aset<T>` 在所有联合来文X职位上均被接受。 只有部分 DOM,实际上依赖 变化的适应性输入 得到触摸, 和更新被分批到下一个动画框中.

3D 场景图作为单独的子路径发送 (单位:千美元)`@aardworx/wombat.dom/scene`)——你只支付WebGPU当您 导入它.

Aardvark 堆栈的 Wombat TypeScript 移植部分 :

1.  [`@aardworx/wombat.adaptive`](https://github.com/krauthaufen/wombat.adaptive) ——增量适应性计算.
2.  [`@aardworx/wombat.base`](https://github.com/krauthaufen/wombat.base) ——数学/地理学原始.
3.  [`@aardworx/wombat.shader`](https://github.com/krauthaufen/wombat.shader) - TS -as -shader DSL. -对 -TS -as -shader DSL.
4.  [`@aardworx/wombat.rendering`](https://github.com/krauthaufen/wombat.rendering) ——WebGPU渲染层.
5.  **`@aardworx/wombat.dom`** ——这种回波:适应性的DOM + 三维场景图-DSL.

## 安装

```bash
npm install @aardworx/wombat.adaptive @aardworx/wombat.dom
```

3D 场景层 :

```bash
npm install @aardworx/wombat.base @aardworx/wombat.shader @aardworx/wombat.rendering
```

在你身边 `tsconfig.json`数字 :

```jsonc
{
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "@aardworx/wombat.dom"
  }
}
```

在维特:

```ts
// vite.config.ts
export default defineConfig({
  esbuild: { jsx: "automatic", jsxImportSource: "@aardworx/wombat.dom" }
});
```

## 哈罗世界

```tsx
import { cval, transact } from "@aardworx/wombat.adaptive";
import { mount } from "@aardworx/wombat.dom";

const name = cval("world");

mount(document.getElementById("app")!, (
  <h1>hello, {name}</h1>
));

setTimeout(() => transact(() => name.value = "adaptive"), 1000);
```

## 你能从哪里经过

| JSX职位 | 平面 | `aval<T>` | `alist<T>` | `aset<T>` |
| --- | --- | --- | --- | --- |
| 属性/ 属性 | 对 | 是——值更新到位 | —— 说 | —— 说 |
| 活动听众(`onClick`(中文(简体) ) | 对 | 是( 最新替换上一个) | —— 说 | —— 说 |
| 文本孩子 | 对 | 是——文本节点更新到位 | —— 说 | —— 说 |
| 元素孩子 | 对 | 有 —— 有处理的树下交换 | —— 说 | —— 说 |
| 儿童名单 | 对 | 是(独生子女) | 是——增量插入/移动 | 是(在场景图中;为DOM计划) |

平面值设定一次,没有订阅费。 运行时间 检查 `instanceof` 反对抽象的基类 `@aardworx/wombat.adaptive`,将静态值包入 `AVal.constant(...)` 永远不需要.

## 递增列表渲染

```tsx
const items = clist<Item>([…]);

mount(root, (
  <ul>{items.map(it => <li>{it.name}</li>)}</ul>
));
```

每件物品都有一个DOM挂载. 添加项到 DOM 时 (插入一个) `<li>`);取出一件物品触摸过一次. 阿华 在一行中只更新该行.

## 处置

```ts
const handle = mount(root, <App/>);
// later:
handle.dispose();
```

`dispose()` 级联通过每个嵌入式绑定,不订阅所有 适应性阅读器, 并删除所有这个挂载在 DOM(英语:DOM).

## 场景路线图

这个 `@aardworx/wombat.dom/scene` 以里程碑形式运出子路径 。 状态 被跟踪到 [`TODO.md`](https://npmcn.com/package/%40aardworx/wombat.dom/TODO.md) 财务报告和审定财务报表 [`CLAUDE.md`](https://npmcn.com/package/%40aardworx/wombat.dom/CLAUDE.md)。 。 。 .

| 联合国 | 目标 | 状态 |
| --- | --- | --- |
| M1级 | 重命名 + 脚手架 | 已运出 |
| M2级 | `Sg` 核心: 有标记的会合场景节点、 曲面状态、 属性组成规则 | 已运出 |
| M3级 | 现场 ~ `RenderObject` 降低(使用量) `wombat.rendering`(中文(简体) ) | 已运出 |
| M4级 | `<RenderControl>` JSX部分内容 | 已运出 |
| M5型导弹 | 相机+取景/穿制服 | 已运出 |
| M6型导弹 | 自由飞行+轨道控制器 | 已运出 |
| M7型导弹 | 选取帧缓冲器+取取效果(模式A) | 已运出 |
| M8型导弹 | 选择读取 + `SceneEvent` 捕获/泡泡; 默认表面 + 原始( )`<Sg.Box/>`, (中文(简体) ), `Quad`, (中文(简体) ), `Sphere`, (中文(简体) ), `Cylinder`, (中文(简体) ), `Cone`(中文(简体) ) | 已运出 |
| M10型导弹 | 反应 BVH 采取 + 像素 + BVH 聚变 | 已运出 |

包让+在今天真正的GPU上取出, 与自动进取, FreeFly + 轨道控制器, SceneEvent 捕获/ bulble 外加焦点/ 键 路由,和对称的SDF文本AA. 剩余工作(重点标签导航) 和焦点环渲染, 通用矩阵类型 沉积属性, 缩放- 意识文本光环, 在乐队构建器中的 bezier3/ arc) 列于 [`TODO.md`](https://npmcn.com/package/%40aardworx/wombat.dom/TODO.md)。 。 。 .

## 状态

前1.0 (0.6.1) (中文(简体) ). DOM 一侧的稳定形状; 场景层 并选择,但可能仍然看到破旧的重命名。 没有SSR.

## 许可证

麻省理工学院.

## 常见问题

### @aardworx/wombat\.dom 是什么？

适用于Wombat TypeScript堆栈的可适应 DOM \+ 3D场景图 DSL – direct-DOM JSX over @aardworx/wombat\.可选择的WebGPU场景图扩展\.

### 如何安装 @aardworx/wombat\.dom？

在项目目录运行 npm install @aardworx/wombat\.dom，或使用 pnpm add / yarn add / bun add。

### @aardworx/wombat\.dom 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aardworx/wombat\.dom 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aardworx/wombat\.dom 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aardworx/wombat\.dom 可以商用吗？

@aardworx/wombat\.dom 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aardworx/wombat\.dom 的下载量有多少？

根据 npm 官方下载统计，@aardworx/wombat\.dom 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,051 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aardworx/wombat\.dom 还在维护吗？

最新版本 0\.25\.8 发布于 2026/11/07（今天）；至今共发布 89 个版本，其中过去 12 个月发布了 89 个；首次发布于 2026/05/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。