# `ExRatatui.Event.Paste`
[🔗](https://github.com/mcass19/ex_ratatui/blob/v0.10.1/lib/ex_ratatui/event/paste.ex#L1)

A bracketed-paste event.

Emitted when the terminal is in bracketed-paste mode and a user pastes
content (typically via Ctrl+Shift+V, Cmd+V, or middle-click). The full
pasted payload arrives as one event rather than as a stream of
individual Key events, preserving newlines and protecting widgets from
accidentally interpreting pasted control characters as commands.

Bracketed paste is enabled automatically on the local terminal
(`ExRatatui.run/1`); apps consuming events from the byte-stream
Session, SSH, or distributed transports may not see Paste events
unless the input parser on that transport has been taught to decode
the `ESC[200~ ... ESC[201~` markers.

## Fields

  * `:content` — the pasted text, with line breaks preserved as
    `\n`. Control characters other than newline are passed through
    as-is; consumers may want to filter them depending on the target
    widget (single-line `TextInput` usually drops newlines; multi-line
    `Textarea` keeps them).

## Example

    case ExRatatui.poll_event(timeout) do
      %ExRatatui.Event.Paste{content: text} ->
        ExRatatui.textarea_insert_str(state.editor, text)

      %ExRatatui.Event.Key{code: "q"} ->
        :quit

      _ ->
        :continue
    end

# `t`

```elixir
@type t() :: %ExRatatui.Event.Paste{content: String.t()}
```

---

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