# `Selecto.SQL.Formatter`

Lightweight SQL formatting and highlighting helpers.

This module is intentionally conservative: it improves readability for generated
Selecto SQL without attempting to be a full SQL parser.

# `format`

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

Format SQL for readability.

Options:
- `:indent` string used for indentation (default: two spaces)
- `:where_multiline` boolean to split `AND`/`OR` conditions across lines (default: true)

# `highlight`

```elixir
@spec highlight(String.t(), :ansi | :markdown | nil) :: String.t()
```

Apply lightweight SQL highlighting.

Supported styles:
- `:ansi` - terminal ANSI colors
- `:markdown` - markdown emphasis for keywords

---

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