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

Mapa de posições do AST: para cada nó, um intervalo `[início, fim)` em
`{linha, coluna}`.

`início` é o mínimo entre a posição própria do nó e a dos filhos (o parser
aponta o `|>` para o operador, o campo de um acesso para o nome do campo,
etc.). `fim` é o máximo entre o `closing`/`end` do próprio nó, o fim dos
filhos, e o comprimento do próprio token.

Colunas são contadas em bytes a partir do início da linha: suficiente para
código ASCII, que é o escopo do spike.

# `t`

```elixir
@type t() :: %Valence.Span{
  depth: non_neg_integer(),
  finish: {pos_integer(), pos_integer()},
  node: term(),
  start: {pos_integer(), pos_integer()}
}
```

# `innermost`

```elixir
@spec innermost([t()], {pos_integer(), pos_integer()}) :: t() | nil
```

Nó mais interno que contém a posição, ou `nil`.

# `nodes`

```elixir
@spec nodes(term(), String.t()) :: [t()]
```

Lista de nós em pré-ordem (pai antes dos filhos, ordem de fonte).

# `own_start`

```elixir
@spec own_start(term()) :: {pos_integer(), pos_integer()} | nil
```

Posição própria do nó (a que o parser atribui), se houver.

# `parse`

```elixir
@spec parse(String.t()) :: {:ok, term()} | {:error, keyword(), String.t(), term()}
```

Como `parse!/1`, mas devolve `{:error, meta, mensagem, token}`.

# `parse!`

```elixir
@spec parse!(String.t()) :: term()
```

---

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