904ac451a4
Keep View, Component, Runtime, reactive, Context, Resource, Behavior, Action, and Data in one core package; add the Grid Host lowering path; remove bundled UI and Playground copies; and document the independent package graph.
2.6 KiB
2.6 KiB
ETAF
ETAF 是构建在独立 Ebox 布局与渲染引擎之上的小型文本应用框架。
完整的公共模型是：
Component(props, Scope) → View → Renderer → Ebox Node → Emacs buffer
所有可见结构都使用一种形式：
(name :property value ... child ...)
子节点中唯一的计算桥接是 expr :value；属性值则是普通 Elisp 表达式。
(etaf-view
(column
(text :face 'bold "Hello")
(text
:color "#687386"
(expr :value (if ready "Ready" "Waiting")))))
定义 Component：
(etaf-define-component status-label (&key label)
"Render a status label."
:view
(text :face 'bold (expr :value label)))
(etaf-mount
"*etaf-demo*"
(etaf-view (status-label :label "Connected")))
etaf-view 是唯一的公共 View 构造入口。结构 form 不使用 quote；quote 仍然是普通 Elisp 数据语法，例如 'bold。普通 Elisp 返回 View 时，必须在 expr 中显式使用 (etaf-view ...) 构造它。
文档
独立包
| 包 | 职责 |
|---|---|
etaf-ui |
官方 Component 目录：Button、Checkbox、Label、Panel 和 DataGrid。 |
etaf-sqlite |
具体 SQLite Data Source；Data Controller 仍属于 ETAF core。 |
etaf-playground |
ETAF 示例；只有请求官方目录示例时才加载 UI 包。 |
ebox-playground |
只使用 Ebox 的布局示例，与 ETAF 独立。 |
没有单独需要安装的 etaf-data：Data 是 ETAF 核心能力。也没有笼统的 etaf-adapters 包：其他数据库、服务、文件或 ORM 应使用明确名称的具体 Data Source 包实现同一契约。
加载与验证
开发时先把同级 Ebox 检出目录加入 load-path：
(add-to-list 'load-path "/path/to/github/emacs-box")
(add-to-list 'load-path "/path/to/github/etaf")
(require 'etaf)
运行完整本地门禁：
make check EMACS=/Applications/Emacs.app/Contents/MacOS/Emacs
核心门禁会编译实现、运行 core/Data/Resource 测试，并检查文档和 API 边界。还应在同级 etaf-ui、etaf-sqlite、etaf-playground 和 ebox-playground 仓库分别运行 make check；它们都不会被 core facade 自动加载。