linkrender

type CheckResult struct {
	Status          links.LinkStatus
	TargetPermalink string
	HasFragment     bool
}

type LinkKind int

type PageLookup interface {
	LookupInLane(relPermalink, lang, version string) *engine.Page
}

type ParsedDest struct {
	Kind     LinkKind
	Path     string // cleaned path, .md/.mdx extension stripped
	Fragment string // without '#'
	Query    string // without '?'
	Raw      string // original href as written
}

type Renderer struct {
	CurrentPage *engine.Page
	PageIndex   *content.PageIndex
	URLResolver *engine.URLResolver
	LinkGraph   *links.LinkGraph

	// Collections is the per-build collection registry, used to detect when a
	// link target lives in an unversioned collection (cross-dimension resolution).
	Collections map[string]*engine.Collection
	// SiteRootEscapePrefix is the configured prefix (e.g. "site:") that routes a
	// link to the site root, bypassing collection/lane logic. Empty disables it.
	SiteRootEscapePrefix string

	PendingAnchors []links.PendingAnchorCheck
	// RecordedRefs buffers a per-render copy of every ref written to LinkGraph,
	// so the build layer can persist the page's resolution snapshot in the page
	// cache and replay it on cache hits.
	RecordedRefs []links.LinkRef
}

type ResolveContext struct {
	PageIndex   PageLookup
	URLResolver URLResolverFunc
	Collections map[string]*engine.Collection
}

type ResolveResult struct {
	URL             string // final resolved URL (empty if not found)
	TargetPermalink string // target page's Permalink (for anchor validation)
	Found           bool
}

type URLResolverFunc func(relPath, lang, version string) string