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.kt

@@ -0,0 +1,13 @@
+package foo
+
+interface foo
+
+fun foo() {}
+
+/**
+ * [<caret_1>foo]
+ *
+ * [<caret_2>foo.foo]
+ * [foo.<caret_3>foo]
+ */
+fun usage() {}

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