Builder API (Server)

TokUIBuilder is a chainable DSL generator for the backend (Node.js). Source: src/server/tokui-builder.js.

Basic usage

const TokUIBuilder = require('./src/server/tokui-builder');
const b = new TokUIBuilder();

b.card({ tt: 'Profile' })
  .h2('Alice')
  .p('A frontend engineer')
  .end();

console.log(b.toString());
// [card tt:Profile][h2 Alice][p A frontend engineer][/card]

Two outputs

Method	Use
toString()	One-shot full DSL string
toChunks()	Array of chunks for incremental SSE push

const chunks = b.reset().card({ tt: 'Card' }).p('Body').end().toChunks();
// → ['[card tt:Card]', '[p Body]', '[/card]']

Auto-close

toString() / toChunks() internally call _finalizeChunks() — unclosed containers are auto-completed; no manual endAll() needed.

Dual-behavior methods

These pick self-closing vs container based on args:

• thead() / inputTag() / quickReply() / agent()

Name avoidance

Grid rows/columns use row_layout() / col_layout() to avoid clashing with the table's row().

Internals

• Self-closing via _selfClosing(type, attrs): b.btn({ tx: 'OK', v: 'primary' }).
• Containers via _open(type, attrs) + end(): b.card({}).p('x').end().
• reset() clears state to reuse the instance.

Full example

const b = new TokUIBuilder();
b.card({ tt: 'Login' })
  .input({ l: 'Username', ph: 'Enter', req: true })
  .pwd({ l: 'Password', ph: 'Enter', req: true })
  .ft()
    .btn({ tx: 'Login', v: 'primary', sub: 'login' })
    .btn({ tx: 'Cancel', v: 'ghost' })
  .end()
  .end();

const dsl = b.toString();

Rendered result of the DSL above:

1[card tt:Login]

2 [input l:Username ph:Enter req]

3 [pwd l:Password ph:Enter req]

4 [ft]

5 [btn tx:Login v:primary sub:login]

6 [btn tx:Cancel v:ghost]

7 [/ft]

8[/card]

Loading TokUI…

TokUI DSL · code ↔ render