sourceref

type LegacySuffixError struct {
	Rewrite string
}

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

type ParseError struct {
	Line  int
	Token string
	Err   error
}

type Reference struct {
	ResolvedPath    string
	CrossRepoSuffix string
	Type            string
	// Fragment is the decoded address fragment, without its leading '#'. It is
	// deliberately opaque to this package: consumers such as spec lint decide
	// which resource-specific fragments they can resolve.
	Fragment string
	// Ref preserves a ?ref=<git-ref> pin (branch, tag, or commit) through
	// parsing and canonicalization. Parsers do not fetch it; an explicit local
	// resolver may require an exact checked-out revision before validating it.
	Ref string
}

type ScanResult struct {
	// FileRefs maps file path to list of references found in that file
	FileRefs map[string][]*Reference
	// ParseErrors records syntactically detected annotations that could not be
	// parsed. Listing mode remains backward-compatible; validation mode reports
	// these deterministic file/line diagnostics instead of silently dropping them.
	ParseErrors map[string][]ParseError
}

type SourceRef struct {
	FilePath    string
	LineNumber  int
	LineContent string
}