Reference the class when its name stands for the companion

Port #973's resolved-qualifier references: a class name used as its
companion object's receiver (`Bar.instance()`, `CompanionOwner.create()`)
now references the class (`Bar#`) instead of the companion
(`Bar#Companion#`). Naming the companion explicitly (`Bar.Companion`,
`Foo.Factory`) still references it.

Amp-Thread-ID: https://ampcode.com/threads/T-01a153c0-ec1f-774a-993c-bca3256017ce
Co-authored-by: Amp <amp@ampcode.com>

Author: christoph-sg

scip-kotlin-analysis/src/main/kotlin/org/scip_code/scip_java/kotlin_analysis/KotlinAnalysisIndexer.kt

@@ -12,6 +12,7 @@ import org.jetbrains.kotlin.analysis.api.analyze
 import org.jetbrains.kotlin.analysis.api.renderer.types.impl.KaTypeRendererForSource
 import org.jetbrains.kotlin.analysis.api.standalone.buildStandaloneAnalysisAPISession
 import org.jetbrains.kotlin.analysis.api.symbols.KaCallableSymbol
+import org.jetbrains.kotlin.analysis.api.symbols.KaClassKind
 import org.jetbrains.kotlin.analysis.api.symbols.KaClassSymbol
 import org.jetbrains.kotlin.analysis.api.symbols.KaConstructorSymbol
 import org.jetbrains.kotlin.analysis.api.symbols.KaFunctionSymbol
@@ -230,6 +231,20 @@ class KotlinAnalysisIndexer(
                 return
             }
 
+            // A class name standing for its companion object (`Bar.instance()`) references the
+            // class, like scip-kotlinc; `Bar.Companion` still references the companion.
+            if (
+                target is KaClassSymbol &&
+                    target.classKind == KaClassKind.COMPANION_OBJECT &&
+                    target.name?.asString() != referencedName
+            ) {
+                val containingClass = with(session) { target.containingSymbol }
+                if (containingClass != null) {
+                    addReference(cache.symbolForReference(session, containingClass), range)
+                    return
+                }
+            }
+
             addReference(cache.symbolForReference(session, target), range)
         }
 

scip-kotlin-analysis/src/test/kotlin/org/scip_code/scip_java/kotlin_analysis/KotlinAnalysisIndexerTest.kt

@@ -1652,7 +1652,7 @@ class KotlinAnalysisIndexerTest {
                 },
                 scipOccurrence {
                     role = REFERENCE
-                    symbol = "sample/Bar#Companion#"
+                    symbol = "sample/Bar#"
                     range {
                         startLine = 7
                         startCharacter = 12

scip-snapshots/expected/kotlin/common/scip-snapshots/cases/kotlin/common/src/main/kotlin/snapshots/CompanionOwner.kt

@@ -48,7 +48,7 @@
 //             signature_documentation
 //             > public final fun create(): Int
 //                ^^^ reference scip-java maven . . kotlin/Int#
-//                      ^^^^^^^^^^^^^^ reference scip-java maven . . snapshots/CompanionOwner#Companion#
+//                      ^^^^^^^^^^^^^^ reference scip-java maven . . snapshots/CompanionOwner#
 //                                     ^^^^^^ reference scip-java maven . . snapshots/CompanionOwner#Companion#create().
 //                                              ^^^^^^^^ reference scip-java maven . . kotlin/Any#hashCode().
 //                                                       ⌃ enclosing_range_end scip-java maven . . snapshots/CompanionOwner#create().