links

type AnchorLookup interface {
	HasHeading(permalink, headingID string) bool
}

type CoverageSummary struct {
	Lanes       []LaneSummary
	TotalLanes  int
	TotalPages  int
	TotalLinks  int
	TotalBroken int
	MissedLanes []DimKey // expected lanes with no links checked
}

type DimKey struct {
	Collection string
	Lang       string
	Version    string
}

type ExternalCheckConfig struct {
	Enabled     bool
	Concurrency int
	Timeout     time.Duration
	CachePath   string // absolute path to linkcache.json
	CacheTTL    time.Duration
	OnBroken    string   // "warn" | "error" | "ignore"
	Ignore      []string // URL glob patterns to skip
	Method      string   // "head-then-get" | "head" | "get"
}

type ExternalResult struct {
	URL        string    `json:"url"`
	StatusCode int       `json:"status_code"`
	OK         bool      `json:"ok"`
	Checked    time.Time `json:"checked"`
	Error      string    `json:"error,omitempty"`
}

type Finding struct {
	Type   FindingType
	Ref    LinkRef
	Policy string // "error" | "warn"
}

type FindingType int

type LaneSummary struct {
	Dim        DimKey
	Pages      int
	Links      int
	Broken     int
	External   int
	IsFallback bool // true if this lane only contains fallback pages
}

type LinkCheckConfig struct {
	OnBroken             string
	OnBrokenAnchor       string
	OnRelativeLinks      string
	OnLocalLinks         string
	SameSitePolicy       string
	ReportFormat         string
	Exclude              []string
	OnExternalBroken     string
	OnUnverifiedInternal string
}

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

type LinkKind int

type LinkRef struct {
	FromPage   *engine.Page
	FromFile   string
	Line, Col  int
	RawDest    string
	Dim        DimKey
	Kind       LinkKind
	Resolved   string
	TargetPage *engine.Page
	Fragment   string
	Status     LinkStatus
}

type LinkStatus int

type PendingAnchorCheck struct {
	SourceFile      string
	TargetPermalink string
	Fragment        string
	RawHref         string
	FromPage        *engine.Page
	TargetPage      *engine.Page
	Dim             DimKey
	Kind            LinkKind
	Resolved        string
	// Line/Col of the link in SourceFile (1-based); 0 when unknown.
	Line, Col int
}

type ReportInput struct {
	Graph    *LinkGraph
	Coverage CoverageSummary
	Config   LinkCheckConfig
	SiteURL  string
}

type ReportResult struct {
	HasErrors bool
	Output    string
	Findings  []Finding
	Summary   string
}