Skip to content

Component model ​

A plugin submits a renderer-neutral definition to a Blue service. Its render() returns a canonical BlueUiNode.

text
domain state / dsh projection
            │
     synchronous render()
            │
        BlueUiNode
            │
   core admission + compile
            │
       pi-tui component

The plugin owns domain state and its definition; the Blue registry owns the current registration; core owns compiled components, focus, layout, and width.

Rules:

  • render reads prepared state and performs no I/O;
  • nodes contain no Agent, Session, terminal width, or renderer object;
  • interaction uses onEvent(event, context); context carries AbortSignal and revision;
  • call the registration's refresh() after state changes;
  • Fiber unload removes definitions and invalidates late async output;
  • every visible component stays bounded at 20/40/80/120 columns.

See the UI node reference for fields.

Preview · v0.2.0-alpha.1