reference

type AssetExistence interface {
	// AssetExists reports whether the given root-relative slash path exists as a
	// non-markdown asset: an existing non-markdown file or directory. Markdown
	// is excluded (tracked via the corpus, not as an asset).
	AssetExists(relPath string) bool
}

type Catalog interface {
	// HasDocument reports whether id is a known markdown document.
	HasDocument(id identity.DocumentID) bool
	// DocumentIDs returns all known markdown document identities. Order is not
	// relied upon; the resolver sorts candidates itself for determinism.
	DocumentIDs() []identity.DocumentID
	// HasHeading reports whether document id contains the given canonical slug
	// (ADR 0006). The slug must be in the exact dialect the parser produced.
	HasHeading(id identity.DocumentID, slug string) bool
	// LookupAlias returns the documents declaring the given front-matter alias,
	// sorted by DocumentID. Empty if unknown.
	LookupAlias(alias string) []identity.DocumentID
}

type LinkHealth int

type LinkType int

type RawReference struct {
	// Origin is the document the reference was found in.
	Origin identity.DocumentID
	// RawTarget is the link target text as written (e.g. "../other.md").
	RawTarget string
	// Fragment is the anchor portion without the leading '#', if any.
	Fragment string
	// Type is the syntactic classification of the link.
	Type LinkType
	// Line is the 1-based source line the reference appears on.
	Line int
	// AnchorText is the human-facing display text of the link as written: the
	// inline link/image label ([this](x)), the image alt text (![alt](x)), or a
	// wikilink alias ([[t|alias]], else the bare target). It is a pure-data string
	// the resolver ignores (ADR 0001 keys identity on the target, never the label);
	// it is carried through to the graph edge so the information-scent analysis can
	// score a link's label against its target's title (ADR 0016). Empty when the
	// link has no display text.
	AnchorText string
}

type Reference struct {
	RawReference
	Target ResolvedTarget
	Health LinkHealth
	// Candidates is populated only when Health is Ambiguous: the set of
	// documents the target matched, sorted by DocumentID for deterministic
	// reporting.
	Candidates []identity.DocumentID
}

type ResolutionPolicy int

type ResolvedTarget struct {
	// Kind tags which fields are meaningful.
	Kind TargetKind
	// DocumentID is set when Kind is TargetDocument, TargetSection or
	// TargetAsset. For TargetDirectory it is the directory's index document
	// (README.md / index.md) when one exists, else empty (ADR 0008).
	DocumentID identity.DocumentID
	// Anchor is the resolved section slug, set when Kind is TargetSection.
	Anchor string
	// Directory is the cleaned directory path, set only when Kind is
	// TargetDirectory (ADR 0008).
	Directory string
	// Children is the sorted set of markdown documents located DIRECTLY in the
	// directory (one level — no recursion), set only when Kind is
	// TargetDirectory. The index document, if any, is included. These are the
	// docs a directory link makes reachable under the default policy (ADR 0008).
	Children []identity.DocumentID
}

type Resolver struct {
	// contains filtered or unexported fields
}

type TargetKind int