← All 41 libraries

Model / Msg / Cmd / Program. The runtime everything else builds on. Includes the cursed cell-diff renderer ported from Bubble Tea v2 — meaningful SSH bandwidth savings for slow-changing UIs.

Install

composer require sugarcraft/candy-core

Quickstart

use SugarCraft\Core\{Cmd, KeyType, Model, Msg, Program, Subscriptions};
use SugarCraft\Core\Msg\KeyMsg;

final class Counter implements Model {
    public function __construct(public readonly int $count = 0) {}
    public function init(): ?\Closure { return null; }
    public function subscriptions(): ?Subscriptions { return null; }

    public function update(Msg $msg): array {
        if ($msg instanceof KeyMsg) {
            return match (true) {
                $msg->rune === 'q'              => [$this, Cmd::quit()],
                $msg->type === KeyType::Up      => [new self($this->count + 1), null],
                $msg->type === KeyType::Down    => [new self($this->count - 1), null],
                default                         => [$this, null],
            };
        }
        return [$this, null];
    }

    public function view(): string {
        return "count: $this->count\n(↑/↓ to change, q to quit)";
    }
}

(new Program(new Counter()))->run();

What's in the box

Source & demos

• Source on GitHub
• Full README
• Runnable examples
• Port of bubbletea (Go upstream)

Try the quickstart →

Demos.

VHS-recorded GIFs of every example shipped with the library. Regenerated automatically on every push that touches the source.