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

Superfície de `use Ecto.Schema`.

A macro não é executada: o checker lê a declaração `schema "tabela" do ... end`
e reconstrói estaticamente o struct nominal que ela geraria — `@primary_key`,
`field`, `belongs_to`, `has_one`, `has_many`, `timestamps`,
`@timestamps_opts` e `@foreign_key_type`.

Limites:

  * tipo de coluna desconhecido vira `dynamic()` (boundary explícito);
  * associação expande os campos do destino uma camada; ciclo cai para
    `Módulo.t()`, então nunca "explode";
  * `belongs_to`/`has_one` produzem `struct() | nil`, como o campo real — por
    isso acessar campo *através* de uma associação pode dar
    `String.t() | dynamic()` (o ramo `nil` não tem campo);
  * `many_to_many` e `through:` que sai do índice viram lista de `dynamic()`.

Não confundir com `Valence.Schema` (a macro própria do projeto): aqui só se
lê o que o código Ecto de verdade declarou.

# `declarations`

Declarações de campos Ecto dos módulos presentes nas fontes.

Retorna `[{módulo, {declarações, contexto}}]`; declarações ainda não estão
resolvidas em `Valence.Type` porque associações podem apontar para módulos
declarados em outro arquivo do mesmo índice.

# `resolve`

Resolve as declarações em `%{módulo => %{campo => Valence.Type.t()}}`.

---

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