Builder API（服务端）
TokUIBuilder 提供链式调用生成 DSL 字符串，供后端（Node.js）使用。源码：src/server/tokui-builder.js。
基本用法
js
const TokUIBuilder = require('./src/server/tokui-builder');
const b = new TokUIBuilder();
b.card({ tt: '用户信息' })
.h2('张三')
.p('一名前端工程师')
.end();
console.log(b.toString());
// [card tt:用户信息][h2 张三][p 一名前端工程师][/card]两种输出
| 方法 | 用途 |
|---|---|
toString() | 一次性输出完整 DSL 字符串 |
toChunks() | 输出分块数组，配合 SSE 逐块推送 |
js
// 流式：重置后生成分块
const chunks = b.reset().card({ tt: '卡片' }).p('内容').end().toChunks();
// → ['[card tt:卡片]', '[p 内容]', '[/card]']自动闭合
toString() / toChunks() 内部调用 _finalizeChunks()，未关闭的容器会自动补全，无需手动 endAll()。
表单动作与打印
按钮的内置动作直接作为 btn() 的属性透传，无需额外方法：
js
b.btn({ tx: '提交', form: 'loginForm', sub: 'onLogin', v: 'primary' }) // → [btn ... form:loginForm sub:onLogin v:primary]
b.btn({ tx: '重置', form: 'loginForm', reset: true }) // → [btn ... form:loginForm reset]
b.btn({ tx: '打印', print: 'invoice' }) // → [btn ... print:invoice]打印区是容器，用 printArea()：
js
b.printArea({ id: 'invoice', tt: '收款单' })
.stat({ tt: '应付金额', v: '12800', pre: '¥ ', trend: 'up' })
.end()
// → [print-area id:invoice tt:收款单][stat ...][/print-area]双行为方法
下列方法根据参数自动选择自闭合或容器模式：
thead()/inputTag()/quickReply()/agent()
命名避让
布局的栅格行/列用 row_layout() / col_layout()，以避让表格的 row()。两者支持栅格属性：row_layout() 的 gutter（列/行统一间距）与 gy（行间距）；col_layout() 的 span（列宽 1-12）、offset（左空列数 1-11，offset+span 钳制不超 12）与 rspan（行跨 1-12）。
高级网格用 grid(attrs) / cell(attrs)（均为容器，需 end() 闭合；含空格的属性值序列化时自动加双引号）：
js
b.grid({ cols: '200px 1fr 1fr', rows: '64px 1fr', gap: 12, areas: 'nav main main|nav aside aside' })
.cell({ area: 'nav' }).p('导航').end()
.cell({ area: 'main' }).p('主区').end()
.cell({ area: 'aside' }).p('侧栏').end()
.end();
// → [grid cols:"200px 1fr 1fr" rows:"64px 1fr" gap:12 areas:"nav main main|nav aside aside"][cell area:nav][p 导航][/cell][cell area:main][p 主区][/cell][cell area:aside][p 侧栏][/cell][/grid]grid 属性：cols/rows（轨道）、areas（模板区域）、gap/gx/gy（间距）、h/minh（高度）、v（dense/flush）；cell 属性：area、c（列跨 N 或 "1/3"）、r（行跨 N）、align/justify。详见布局组件 · 高级网格。
内部约定
- 自闭合标签用
_selfClosing(type, attrs)：如b.btn({ tx: '确定', v: 'primary' })。 - 容器用
_open(type, attrs)开标签 +end()闭标签：如b.card({}).p('x').end()。 reset()清空状态，复用同一实例。
完整示例
js
const b = new TokUIBuilder();
b.card({ tt: '登录' })
.input({ l: '用户名', ph: '请输入', req: true })
.pwd({ l: '密码', ph: '请输入', req: true })
.ft()
.btn({ tx: '登录', v: 'primary', sub: 'login' })
.btn({ tx: '取消', v: 'ghost' })
.end()
.end();
// 直接喂给前端渲染
const dsl = b.toString();上面 Builder 生成的 DSL 渲染效果：
1[card tt:登录]
2 [input l:用户名 ph:请输入 req]
3 [pwd l:密码 ph:请输入 req]
4 [ft]
5 [btn tx:登录 v:primary sub:login]
6 [btn tx:取消 v:ghost]
7 [/ft]
8[/card]
加载 TokUI…