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

Boundary gradual: extrai `@type`/`@spec` do AST (mesmo fonte que a IDE vê)
e converte tipos de typespec para `Valence.Type`.

Nada de `Code.Typespec` sobre beam: aqui o tipo tem que existir antes de
compilar, e o source é a única fonte de verdade.

# `alias_name`

Nome do módulo a partir do alias do `defmodule` (`Accounts.User`).

# `imported_spec`

Spec de um módulo `import`ado (`import Ecto.Changeset` + `cast/3`).

Phoenix importa `Ecto.Changeset` inteiro; sem isso, toda validação de
changeset no projeto real cairia em `dynamic()`. Resolve com o módulo dono
da spec (`t()` continua `Ecto.Changeset.t()`).

# `index`

Indexa uma ou mais fontes: `%{modules: %{nome => %Module{}}, structs: %{}}`.

`structs` recebe os schemas declarados por macro (`use Valence.Schema` e
`use Ecto.Schema`), porque esses tipos não existem no source — a macro os
gera em tempo de compilação. O Ecto é lido estaticamente por
`Valence.Surfaces.Ecto`, com as associações resolvidas depois que todos os
módulos do índice são conhecidos (um schema pode referenciar outro arquivo).

# `module_name`

```elixir
@spec module_name(map(), String.t(), [atom()] | String.t()) :: String.t()
```

Nome completo de um módulo referenciado no código: resolve `alias` do módulo
atual (`Producer` → `MyApp.Producers.Producer`).

# `own_spec`

Como `spec/4`, mas só o `@spec` do source (definição local do módulo).

# `resolve`

Resolve um AST de typespec em `Valence.Type.t/0`.

# `spec`

Assinatura resolvida de `mod.name/arity`, ou `nil`.

Ordem de resolução: `@spec` do source → spec do `.beam` do módulo compilado
→ callbacks do behaviour que o módulo declara com `use` (é o que tipa
`MeuRepo.all/2` a partir de `Ecto.Repo`).

Se a spec declara mais parâmetros do que a chamada (argumento com default),
os extras são ignorados — heurística explícita, não precisão falsa.

# `type`

Tipo declarado `mod.name/arity` resolvido, ou `nil`.

---

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