Provide a function for languages to influence reference resolution out of candidates

[oxisto]

This adds a new function Language.bestViableReferenceCandidate which takes the old implementation as a default behaviour.

[codecov]

Codecov Report

Attention: Patch coverage is 61.53846% with 5 lines in your changes missing coverage. Please review.

Project coverage is 77.03%. Comparing base (a2d326e) to head (621f3d3).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...n/de/fraunhofer/aisec/cpg/passes/SymbolResolver.kt	16.66%	4 Missing and 1 partial ⚠️

Additional details and impacted files

Files with missing lines	Coverage Δ
...tlin/de/fraunhofer/aisec/cpg/frontends/Language.kt	92.24% <100.00%> (+0.49%)	⬆️
...n/de/fraunhofer/aisec/cpg/passes/SymbolResolver.kt	86.62% <16.66%> (-1.34%)	⬇️

... and 2 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[konradweiss]

Now the default behavior changed from being singleOrNull in all cases to to one candidate if the list of candidates contains exactly one element and null otherwise. I hope this was the intention

[oxisto]

Now the default behavior changed from being singleOrNull in all cases to to one candidate if the list of candidates contains exactly one element and null otherwise. I hope this was the intention

The default behavior is unchanged, but a language can override it.