# Links

Reference occurrences have one of five statuses: `resolved`, `unresolved`,
`ambiguous`, `circular`, or `deferred` for a project-wide second pass.

```php
use Alto\Rst\Reference\DefinitionKind;
use Alto\Rst\Reference\ReferenceStatus;
use Alto\Rst\Reference\ReferenceType;

foreach ($graph->references(ReferenceType::Hyperlink) as $reference) {
    if (ReferenceStatus::Resolved === $reference->status) {
        $definition = $reference->target;
    }
}

$targets = $graph->definitions(DefinitionKind::Hyperlink);
```

Name lookup collapses whitespace and folds ASCII case while preserving display
names. Explicit empty targets can attach to the semantic block that follows;
`anchorNode()` exposes that carrier for renderers.

`unresolved()` returns every occurrence not currently resolved. Project roles
may remain deferred until a `ProjectReferenceMap` is available. See
[Projects](https://altophp.com/rst/references/projects.md).