KT-65152 [AA] Add extra test for package resolution

Make sure that, when ambiguous, both the package
and the callable/class/property are resolved from
KDoc reference.

Do a slight refactoring of `KDocReferenceResolver`

This behavior is also true for K1

analysis/analysis-api/testData/referenceResolve/kDoc/packages/packageVsTopLevelDeclarations.txt

@@ -0,0 +1,11 @@
+Caret 1 resolved to:
+0: (in foo) fun foo()
+1: (in foo) interface foo
+2: package foo
+
+Caret 2 resolved to:
+0: package foo
+
+Caret 3 resolved to:
+0: (in foo) fun foo()
+1: (in foo) interface foo