package mosaic
Build not yet checkedInstall
dune-project
Dependency
Authors
Maintainers
Sources
sha256=a92cbbcbe016fb19fb0a749222da0e459a9567aef3f4c7340d9bd6b71c53ed6f
sha512=6a7ab054605538bb31a2b73a1a6d093981a2704c9f0af5852221c05735290d74aca7c7282298c4d0f91e86a800e2ccd94b4918af883cd963449c758eb6b272b3
Description
Mosaic is a terminal UI framework implementing The Elm Architecture: state is a typed model, the UI is a pure function of the model, and side effects are explicit values. It provides composable widgets (text, input, select, table, tree, markdown, canvas, and more), CSS Flexbox and Grid layout via Toffee, and efficient rendering via Matrix.
README
Mosaic
Terminal user interfaces for OCaml.
This repository contains three packages that work together or independently:
Package | Description |
|---|---|
High-level UI framework with The Elm Architecture | |
Terminal toolkit: rendering, input, PTY, VTE | |
CSS layout engine (Flexbox, Grid, Block) ported from Taffy |
Mosaic provides a TEA runtime (model / update / view), built-in widgets, and CSS layout via Toffee. Editors, scrolling, selection, and focus are model values; semantic callbacks return messages that update accepts, transforms, or rejects. Selection follows application values across reordering. ~on_focus_request lets a pointer press propose focus before caret placement; raw event callbacks remain optional-message filters.
Matrix is the terminal layer: double-buffered rendering that diffs cell changes to emit minimal ANSI output, Kitty keyboard, SGR mouse, bracketed paste, focus reporting, and a virtual terminal emulator. Usable on its own for immediate-mode terminal apps.
Toffee is a pure OCaml port of Taffy. It computes Flexbox, Grid, and Block layout with no C stubs and no runtime dependencies.
Syntax highlighting is backend-neutral. See the tree-sitter recipe and the independent Tree-sitter bindings.
Getting started
Each package's README shows how to install it and write a first program, and its examples are listed with their run commands: Mosaic (examples), Matrix (examples), Toffee (examples).
License
ISC. See LICENSE.
Dev Dependencies (6)
Used by
None
Build status
Results of building mosaic with each compiler on check.ci.ocaml.org, run of against opam-repository 8d8d144. All results for this package.
Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.
This version is not in the latest run; the versions below are.
- good Package successfully built
- partial One of the dependencies failed to build
- bad Package failed to build
- n/a Package is not available in this environment
- internal Internal failure