7 个平台 · 原生视图 · 一份逻辑→

一份视图
七个平台原生运行

Weft 是一门编译型 UI 语言。用 .weft 描述视图,用 JS/TS 写逻辑,编译成 DOM、微信小程序、SwiftUI、Jetpack Compose、WinUI 3 和 GTK 4 的原生代码。

$WEFT_PLATFORM=ios,android,linux vite build
App.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++ 内核。

web
DOM
浏览器 · Vite
wechat
WXML
小程序逻辑层 · 开发者工具
iosiOS 17
SwiftUI
Hermes · xcodebuild
macosmacOS 14
SwiftUI
Hermes · xcodebuild
androidAPI 24
Jetpack Compose
Hermes · Gradle
windows10 1809
WinUI 3
Hermes · dotnet build
linuxGTK 4.10
GTK 4
Hermes · CMake
视图协议
JS 逻辑层与各平台视图层之间的 ops 约定 →

特性

编译期做完大部分工作

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 源码上。

构建

一条命令,从源码到原生工程

  1. 01

    描述视图

    在 .weft 里声明 model、event 和组件。

    App.weft
  2. 02

    编写逻辑

    在 TypeScript 里处理事件、修改 model。

    index.ts
  3. 03

    编译

    Vite 插件调用 WASM 编译器,生成逻辑模块、布局和原生视图代码。

    @weft-ui/vite
  4. 04

    出包

    生成 apps/<platform>/ 原生工程,再调用宿主构建工具。

    apps/<platform>/

开始用 Weft 编织界面

从语法规范读起,或者直接看示例工程。