# `Minga.Core.Decorations.LineAnnotation`
[🔗](https://github.com/jsmestad/minga/blob/main/lib/minga/core/decorations/line_annotation.ex#L1)

A line annotation decoration: structured metadata attached to a buffer line.

Annotations display visual metadata alongside buffer content without
modifying the text. They come in three kinds:

- `:inline_pill` - colored pill badge (rounded rect background + text)
  rendered after line content. Used for tags, labels, status indicators.
- `:inline_text` - styled text (no background pill) rendered after line
  content. Used for git blame, inline hints, dimmed annotations.
- `:gutter_icon` - icon or symbol rendered in the gutter sign column.
  Used for bookmarks, breakpoints, markers.

Each frontend renders annotations according to its capabilities:
- **GUI (Swift/Metal):** pills as CoreText bitmaps with rounded rect
  backgrounds; inline text as styled runs; gutter icons natively.
- **TUI (Zig/libvaxis):** pills as space-padded text with terminal
  background color; inline text as dimmed text; gutter icons as
  characters in the sign column.

## Examples

    %LineAnnotation{
      id: make_ref(),
      line: 5,
      text: "work",
      kind: :inline_pill,
      fg: 0xFFFFFF,
      bg: 0x6366F1,
      group: :org_tags,
      priority: 0
    }

# `kind`

```elixir
@type kind() :: :inline_pill | :inline_text | :gutter_icon
```

The visual kind of annotation.

# `t`

```elixir
@type t() :: %Minga.Core.Decorations.LineAnnotation{
  bg: non_neg_integer(),
  fg: non_neg_integer(),
  group: term() | nil,
  id: reference(),
  kind: kind(),
  line: non_neg_integer(),
  priority: integer(),
  text: String.t()
}
```

---

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