Raxol.Component (Raxol v2.0.1)

Foundation for building reusable, stateful terminal UI components.

Provides a React-like component system with lifecycle hooks, state management, and event handling. Components use props (immutable config) and state (mutable data).

Usage

defmodule Counter do
  use Raxol.Component

  @impl true
  def init(props), do: %{count: props[:initial] || 0}

  @impl true
  def render(state, _props) do
    "Count: #{state.count}

[+] Increment [-] Decrement"

  end

  @impl true
  def handle_event(:key_press, "+", state) do
    {:ok, %{state | count: state.count + 1}}
  end

  @impl true
  def handle_event(:key_press, "-", state) do
    {:ok, %{state | count: state.count - 1}}
  end

  @impl true
  def handle_event(_, _, state), do: {:ok, state}
end

Required callbacks: init/1, render/2. Optional: handle_event/3, update/2, mount/1, unmount/1, cleanup/1.