# `Alaja.Components.Header`
[🔗](https://github.com/Lorenzo-SF/alaja/blob/2.1.0/lib/alaja/components/header.ex#L1)

Static header component for terminal output.

Renders a centered title with optional subtitle and decorative lines.

## Usage

    iex> Alaja.Components.Header.print("My App", subtitle: "v1.0.0")
    iex> Alaja.Components.Header.render("My App", size: :large)

## Cell engine

As of v0.3.0, `render/2` returns an `Alaja.Buffer.t/0` (height 3 or 4
depending on subtitle presence).

# `color`

```elixir
@type color() :: {0..255, 0..255, 0..255} | nil
```

# `size`

```elixir
@type size() :: :small | :medium | :large
```

# `print`

```elixir
@spec print(
  String.t(),
  keyword()
) :: :ok
```

Prints a header directly to stdout.

# `render`

```elixir
@spec render(
  String.t(),
  keyword()
) :: Alaja.Buffer.t()
```

Renders a header to an `Alaja.Buffer.t/0`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*