[Analysis API] add method for implicit companion object reference detection

Add a new method `isImplicitReferenceToCompanion` to determine
if the given reference is an implicit reference to a companion object.

The method is needed for the rename refactoring in IJ.

^KTIJ-25863

analysis/analysis-api/src/org/jetbrains/kotlin/analysis/api/components/KtReferenceResolveMixIn.kt

@@ -17,4 +17,25 @@ public interface KtReferenceResolveMixIn : KtAnalysisSessionMixIn {
     public fun KtReference.resolveToSymbol(): KtSymbol? = withValidityAssertion {
         return resolveToSymbols().singleOrNull()
     }
+
+    /**
+     * Checks if the reference is an implicit reference to a companion object via the containing class.
+     *
+     * Example:
+     * ```
+     * class A {
+     *    companion object {
+     *       fun foo() {}
+     *    }
+     * }
+     * ```
+     *
+     * For the case provided, inside the call `A.foo()`,
+     * the `A` is an implicit reference to the companion object, so `isImplicitReferenceToCompanion` returns `true`
+     *
+     * @return `true` if the reference is an implicit reference to a companion object, `false` otherwise.
+     */
+    public fun KtReference.isImplicitReferenceToCompanion(): Boolean = withValidityAssertion {
+        analysisSession.referenceResolveProvider.isImplicitReferenceToCompanion(this)
+    }
 }

analysis/analysis-api/src/org/jetbrains/kotlin/analysis/api/components/KtReferenceResolveProvider.kt

@@ -10,4 +10,6 @@ import org.jetbrains.kotlin.idea.references.KtReference
 
 public abstract class KtReferenceResolveProvider {
     public abstract fun resolveToSymbols(reference: KtReference): Collection<KtSymbol>
+
+    public abstract fun isImplicitReferenceToCompanion(reference: KtReference): Boolean
 }

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/classAccessWithExplicitReferenceToCompanion.kt

@@ -0,0 +1,9 @@
+class AA {
+    companion object {
+        fun x() = 10
+    }
+}
+fun main() {
+    A<caret>A.Companion.x()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/classAccessWithExplicitReferenceToCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/classAccessWithExplicitReferenceToNamedCompanion.kt

@@ -0,0 +1,9 @@
+class AA {
+    companion object BB {
+        fun x() = 10
+    }
+}
+fun main() {
+    A<caret>A.BB.x()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/classAccessWithExplicitReferenceToNamedCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/constructorCall.kt

@@ -0,0 +1,9 @@
+class AA {
+    companion object {
+        fun x() = 10
+    }
+}
+fun main() {
+    A<caret>A()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/constructorCall.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/constructorCallWithInvokeInCompanion.kt

@@ -0,0 +1,10 @@
+class AA {
+    companion object {
+        operator fun invoke() {}
+    }
+}
+
+fun main() {
+    A<caret>A()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/constructorCallWithInvokeInCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/explicitReferenceToCompanion.kt

@@ -0,0 +1,9 @@
+class AA {
+    companion object {
+        fun x() = 10
+    }
+}
+fun main() {
+    AA.Com<caret>panion.x()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/explicitReferenceToCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/explicitReferenceToNamedCompanion.kt

@@ -0,0 +1,9 @@
+class AA {
+    companion object BB {
+        fun x() = 10
+    }
+}
+fun main() {
+    AA.B<caret>B.x()
+}
+

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/explicitReferenceToNamedCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: false

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/impicitReferenceToCompanion.kt

@@ -0,0 +1,8 @@
+class AA {
+    companion object {
+        fun x() = 10
+    }
+}
+fun main() {
+    A<caret>A.x()
+}

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/impicitReferenceToCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: true

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/qualifierReferenceToClassWithCompanion.kt

@@ -0,0 +1,8 @@
+class AA {
+    companion object {
+        fun x() = 10
+    }
+}
+fun main() {
+    A<caret>A
+}

analysis/analysis-api/testData/components/referenceResolveProvider/isImplicitReferenceToCompanion/qualifierReferenceToClassWithCompanion.txt

@@ -0,0 +1 @@
+isImplicitCompanionReference: true