@aardworx/wombat.dom

中文文档
0.25.8发布于 2026/11/07MITTypeScriptES Module近 30 天下载 2051

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

中文使用文档
文档目录8 节
  1. 安装
  2. 哈罗世界
  3. 你能从哪里经过
  4. 递增列表渲染
  5. 处置
  6. 场景路线图
  7. 状态
  8. 许可证

@aardworx/wombat.dom

适应 DOM + 3D 场景图 DSL 旺巴特语 类型脚本 堆栈。 JSX是表面,运行时间是直接DOM渲染器 @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 ——增量适应性计算.
  2. @aardworx/wombat.base ——数学/地理学原始.
  3. @aardworx/wombat.shader - TS -as -shader DSL. -对 -TS -as -shader DSL.
  4. @aardworx/wombat.rendering ——WebGPU渲染层.
  5. @aardworx/wombat.dom ——这种回波:适应性的DOM + 三维场景图-DSL.

安装

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

3D 场景层 :

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

在你身边 tsconfig.json数字 :

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

在维特:

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

哈罗世界

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(...) 永远不需要.

递增列表渲染

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

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

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

处置

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

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

场景路线图

这个 @aardworx/wombat.dom/scene 以里程碑形式运出子路径 。 状态 被跟踪到 TODO.md 财务报告和审定财务报表 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。 。 。 .

状态

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

许可证

麻省理工学院.

版本与发布记录

@aardworx/wombat.dom 共发布 89 个版本,首次发布于 2026/05/01;过去 12 个月发布了 89 个版本。

版本发布日期距今
0.25.8latest2026/11/07今天
0.25.72026/11/07今天
0.25.62026/11/07今天
0.25.52026/11/071 天前
0.25.42026/11/071 天前
0.25.32026/11/061 天前

关于 @aardworx/wombat.dom 的常见问题

@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 和提交记录判断。