x/tools/gopls: Add a gopls command for resolving targets to locations. #80874

type ResolveTargetParams struct {
    // TextDocument identifies the document context (e.g. CWD file or -pos file).
    TextDocument protocol.TextDocumentIdentifier `json:"textDocument"`

    // Target is the literal name or regex pattern (enclosed in slashes).
    Target string `json:"target"`

    // PkgScope optionally overrides the package search scope (from -pkg).
    PkgScope string `json:"pkgScope,omitempty"`

    // Range optionally restricts the search to a specific span within the file.
    Range *protocol.Range `json:"range,omitempty"`
}

type ResolveTargetResult struct {
    Matches []TargetMatch `json:"matches"`
}

type TargetMatch struct {
    Package  string            `json:"package,omitempty"` // Go package path
    Name     string            `json:"name"`              // Symbol name
    // Location is LSP protocol location because gopls.resolve_target
    // is an internal utility command to map the target symbol position to
    // LSP protocol locations.
    Location protocol.Location `json:"location"`
}