#MoonBit Easy Terminal UI Frame

#Highlights

#Quick start

moon add moonbitstack/moonetui

moon run --target native src/examples/gallery   # every widget and every style, live
moon run --target native src/examples/monitor   # a complete app: tabs, timers, a command line
moon run --target native src/examples/tui       # a styled app in a real terminal
moon run --target js src/examples/hello         # under Node
moon run --target native src/examples/uart      # whole frames of plain text, as a serial line gets them

fn main raise {
  let sheet = @design.Stylesheet::new()
  sheet.add(
    @design.Sel::new(name="Header"),
    @design.Styles::new(text=@style.Style::new(bold=true, fg=@style.cyan)),
  )
  sheet.add(@design.Sel::new(classes=["framed"]), @design.Styles::new(border=Round))
  sheet.add(
    @design.Sel::new(classes=["framed"], focus=true),
    @design.Styles::new(border=Heavy),
  )
  let list = @widget.ListView::new(["alpha", "beta", "gamma"])
  let field = @widget.Input::new(placeholder="pick one")
  let line = @layout.Box::new(extent=Cells(1))
  let tree = @app.column(0, [
    @app.leaf(1, @widget.Header::new("moonetui"), box=line, name="Header"),
    @app.leaf(2, list, classes=["framed"]),
    @app.leaf(3, field, box=line),
    @app.leaf(4, @widget.Footer::new([("tab", "next"), ("enter", "choose")]), box=line),
  ])
  let ui = @app.App::new(@native.NativeTty::new(), tree, sheet~)
  ui.start()
  @native.run(() => {
    let alive = ui.step()
    for report in ui.drain() {
      if report is Selected(index~, ..) {
        field.set(list.items()[index])
        ui.refresh()
      }
    }
    alive
  })
  ui.stop()
}

#The widget inventory

#Package map

#Standards

• Unicode: rendering is measured in terminal columns over a generated width table.
• ECMA-48 / ISO 6429: SGR (CSI … m) for attributes, CUP (CSI H) for addressing, ED and EL for erasing.
• UTF-8: the input decoder is incremental, so a code point split across two reads arrives whole.

#Tests

moon check --target all --deny-warn
moon build --target all
moon test  --target all
moon fmt && moon info --target all     # the diff must stay clean

#Licence