7 个平台 · 原生视图 · 一份逻辑→一份视图
一份视图
七个平台原生运行
Weft 是一门编译型 UI 语言。用 .weft 描述视图,用 JS/TS 写逻辑,编译成 DOM、微信小程序、SwiftUI、Jetpack Compose、WinUI 3 和 GTK 4 的原生代码。
$
WEFT_PLATFORM=ios,android,linux vite buildApp.weft
model Todo {
id: Int,
name: String,
done: Bool
}
model Model {
draft: String,
todos: Todo[]
}
event Draft(value: String)
event Add
event Toggle(id: Int)
component App(model: Model) {
Column(padding = 16, gap = 12) {
Row(gap = 8) {
Input(model.draft, onChange = Draft)
Button(onClick = Add) {
Text("Add")
}
}
for (todo in model.todos; key = todo.id) {
Row(gap = 8) {
Checkbox(todo.done, onChange = Toggle(todo.id))
Text(todo.name)
}
}
Text("${model.todos.length} todos", color = "#6b7280")
}
}index.ts
import { App } from "./App.weft";
import { run } from "@weft-ui/platform";
const app = new App({ draft: "", todos: [] });
let nextId = 1;
app.onDraft((model, { value }) => {
model.draft = value;
});
app.onAdd((model) => {
const name = model.draft.trim();
if (!name) return;
model.todos = [...model.todos, { id: nextId++, name, done: false }];
model.draft = "";
});
app.onToggle((model, { id }) => {
const todo = model.todos.find((t) => t.id === id);
if (todo) todo.done = !todo.done;
});
run(app);视图声明在 .weft 里,状态和业务逻辑留在 TypeScript。视图想改 model,只能发出事件。
平台
七个平台,一种写法
语言不变,后端换成每个平台自己的视图层。原生平台共享同一个嵌入 Hermes 的 C++ 内核。
webDOM
wechatWXML
iosiOS 17SwiftUI
macosmacOS 14SwiftUI
androidAPI 24Jetpack Compose
windows10 1809WinUI 3
linuxGTK 4.10GTK 4
视图协议
特性
编译期做完大部分工作
DSL 只描述视图,不是通用编程语言。剩下的交给编译器和宿主语言。
原生视图
每个平台的视图都编译成该平台的原生控件代码。不用 WebView,也不自绘,外观贴近各平台原生风格。
编译期依赖分析
类型检查、依赖分析和模板展开都在编译期完成。没有虚拟 DOM,运行时只做细粒度更新。
单向数据流
视图只能读 model、只能改组件私有的 state。修改 model 必须发出 event,交给逻辑层处理。
一份 JS/TS 逻辑
Web 和小程序用平台自带的引擎,其余平台嵌入 Hermes,发布时预编译成字节码。
统一平台 API
@weft-ui/platform 在每个平台签名一致:run、fetch、storage、platform。不支持的调用以 PlatformError 拒绝。
完整工具链
weft fmt、weft lsp、tree-sitter 语法和 Zed 扩展;TypeScript content mapper 让类型错误直接落在 .weft 源码上。
构建
一条命令,从源码到原生工程
- 01
描述视图
在 .weft 里声明 model、event 和组件。
App.weft - 02
编写逻辑
在 TypeScript 里处理事件、修改 model。
index.ts - 03
编译
Vite 插件调用 WASM 编译器,生成逻辑模块、布局和原生视图代码。
@weft-ui/vite - 04
出包
生成 apps/<platform>/ 原生工程,再调用宿主构建工具。
apps/<platform>/