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.
Summary
Functions
Nome do módulo a partir do alias do defmodule (Accounts.User).
Spec de um módulo importado (import Ecto.Changeset + cast/3).
Indexa uma ou mais fontes: %{modules: %{nome => %Module{}}, structs: %{}}.
Nome completo de um módulo referenciado no código: resolve alias do módulo
atual (Producer → MyApp.Producers.Producer).
Como spec/4, mas só o @spec do source (definição local do módulo).
Resolve um AST de typespec em Valence.Type.t/0.
Assinatura resolvida de mod.name/arity, ou nil.
Tipo declarado mod.name/arity resolvido, ou nil.
Functions
Nome do módulo a partir do alias do defmodule (Accounts.User).
Spec de um módulo importado (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()).
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).
Nome completo de um módulo referenciado no código: resolve alias do módulo
atual (Producer → MyApp.Producers.Producer).
Como spec/4, mas só o @spec do source (definição local do módulo).
Resolve um AST de typespec em Valence.Type.t/0.
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.
Tipo declarado mod.name/arity resolvido, ou nil.