# valence v1.0.0 - API Reference

## Modules

- [Valence](Valence.md): Juízo de tipagem para Elixir: "qual o tipo desta expressão nesta posição" e
diagnóstico de protocolos não-exaustivos, com o tipo vindo de
`@spec`/`@type` e das superfícies tipadas de macro (`Valence.GenServer`,
`Valence.Schema`).
- [Valence.Aliases](Valence.Aliases.md): Leitura dos `alias` de topo do módulo e resolução de nomes.
- [Valence.CLI](Valence.CLI.md): Entrada de linha de comando do Valence (escript `valence`).
- [Valence.Checker](Valence.Checker.md): Checagem de projeto: indexa todas as fontes **uma vez** e roda
`Valence.check_with_index/2` em cada arquivo. Arquivos `.val` passam pelo
modo estrito (`Valence.Strict`): `@spec` obrigatória, corpo-vs-retorno e
exaustividade como diagnóstico.
- [Valence.Exhaustive](Valence.Exhaustive.md): Exaustividade de `case` sobre uniões tagueadas finitas.
- [Valence.Formatter](Valence.Formatter.md): Formatação de fontes `.val`/`.ex` reutilizando o formatter do Elixir, com
as opções do `.formatter.exs` do projeto (line_length, locals_without_parens
etc.).
- [Valence.GenServer](Valence.GenServer.md): Lado de runtime da superfície tipada de GenServer.
- [Valence.Infer](Valence.Infer.md): Inferência sensível a fluxo, com foco (`target`).
- [Valence.Json](Valence.Json.md): Codificador e decodificador JSON sem dependências externas.
- [Valence.Lsp](Valence.Lsp.md): Servidor LSP do Valence: JSON-RPC 2.0 sobre stdio com framing
Content-Length.
- [Valence.Pattern](Valence.Pattern.md): Casamento de padrão contra tipos.
- [Valence.Schema](Valence.Schema.md): Macro de schema estilo Ecto, mas tipada.
- [Valence.Span](Valence.Span.md): Mapa de posições do AST: para cada nó, um intervalo `[início, fim)` em
`{linha, coluna}`.
- [Valence.Strict](Valence.Strict.md): Modo estrito de tipagem: o arquivo precisa declarar o contrato e o corpo
precisa cumpri-lo.
- [Valence.Surfaces](Valence.Surfaces.md): Superfícies tipadas de macros.
- [Valence.Surfaces.Ecto](Valence.Surfaces.Ecto.md): Superfície de `use Ecto.Schema`.
- [Valence.Surfaces.LiveView](Valence.Surfaces.LiveView.md): Superfície de assigns de LiveView.
- [Valence.Surfaces.PubSub](Valence.Surfaces.PubSub.md): Registro estático de mensagens PubSub.
- [Valence.Type](Valence.Type.md): Representação interna de tipos.
- [Valence.Typespec](Valence.Typespec.md): Boundary gradual: extrai `@type`/`@spec` do AST (mesmo fonte que a IDE vê)
e converte tipos de typespec para `Valence.Type`.
- [Valence.Typespec.Beam](Valence.Typespec.Beam.md): Specs de módulos já compilados, lidas do `.beam` com `Code.Typespec`.
- [Valence.Val.Compiler](Valence.Val.Compiler.md): Compilação de um arquivo `.val`: Elixir estrito, sem sintaxe nova.

## Mix Tasks

- [mix compile.valence](Mix.Tasks.Compile.Valence.md): Compilador `:valence` para arquivos `.val` (Elixir estrito).
- [mix valence.check](Mix.Tasks.Valence.Check.md): Roda a checagem de tipos/exaustividade sobre os arquivos dados.
- [mix valence.lsp](Mix.Tasks.Valence.Lsp.md): Inicia o servidor LSP do Valence.
- [mix valence.type](Mix.Tasks.Valence.Type.md): Responde "qual o tipo desta expressão nesta posição".

