# `Valence.Lsp`
[🔗](https://github.com/freitaseric/valence-lang/blob/v1.0.0/lib/valence/lsp.ex#L1)

Servidor LSP do Valence: JSON-RPC 2.0 sobre stdio com framing
Content-Length.

O estado guarda os documentos abertos e um cache do índice do projeto. O
índice é reconstruído quando o cliente avisa que um documento mudou; a
raiz vem do initialize (rootUri/rootPath) ou do diretório atual.

O núcleo é handle/2, sem IO: recebe o estado e uma mensagem decodificada e
devolve o novo estado mais a lista de mensagens a enviar. Assim o
protocolo é testável sem abrir processos nem pipes; run/0 só faz o laço de
leitura e escrita em stdio.

Posições: o Valence.Span é 1-based e o LSP é 0-based com caractere em
unidades UTF-16. O tokenizer do Elixir conta coluna em code points (um
acento é uma coluna, o emoji é uma coluna), então a conversão UTF-16 <->
code point mora aqui, nas duas direções.

# `handle`

```elixir
@spec handle(Valence.Lsp.State.t(), term()) :: {Valence.Lsp.State.t(), [map()]}
```

Processa uma mensagem decodificada.

Devolve {novo_estado, respostas}. Mensagem que não é objeto, sem método ou
com params fora do formato é ignorada em vez de derrubar o servidor.

# `new_state`

```elixir
@spec new_state(String.t() | nil) :: Valence.Lsp.State.t()
```

Estado inicial; a raiz padrão é o diretório atual.

# `read_message`

```elixir
@spec read_message(term()) :: {:ok, map()} | :eof | {:error, term()}
```

Lê uma mensagem do dispositivo, com framing Content-Length.

Devolve {:ok, mapa}, :eof no fim do stream ou {:error, motivo} quando o
framing/JSON está quebrado. Não escreve nada e não levanta exceção.

# `run`

```elixir
@spec run() :: :ok
```

Roda o servidor em stdio até o cliente fechar o pipe ou mandar exit.

# `uri_to_path`

```elixir
@spec uri_to_path(String.t() | nil) :: String.t() | nil
```

Converte um URI file:// em caminho local, com percent-decode.

# `write_message`

```elixir
@spec write_message(term(), map()) :: :ok
```

Escreve uma mensagem no dispositivo, com framing Content-Length.

---

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