[Analysis API] implement an API to get a substitution based on an inheritance relationship between classes

^KT-62090 fixed

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/chain.kt

@@ -0,0 +1,10 @@
+// WITH_STDLIB
+
+class A<caret_base>A : BB<Int, String>
+
+class BB<S, T> : CC<S, T, List<T>>
+
+class C<caret_super>C<X, Y, Z> {
+    fun foo(): kotlin.Triple<X, Y, Z>
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/chain.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {X = S, Y = T, Z = kotlin/collections/List<T>}> then <map substitutor: {S = kotlin/Int, T = kotlin/String}>
+Substituted callables:
+  foo(): Triple<Int, String, List<String>>

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/cycle.kt

@@ -0,0 +1,6 @@
+class A<caret_base>A : BB<Int, String>
+
+class BB<S, T> : CC<S, T, List<T>>
+
+class C<caret_super>CC<X, Y, Z> : AA
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/cycle.result.txt

@@ -0,0 +1 @@
+Substitutor: null

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directComplexSubstitution.kt

@@ -0,0 +1,8 @@
+// WITH_STDLIB
+
+class A<caret_base>A<T, S> : BB<List<T>, Map<S, Int>, S>
+
+class B<caret_super>B<Q, R, T>  {
+    fun foo(): kotlin.Triple<Q, R, T>
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directComplexSubstitution.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {Q = kotlin/collections/List<T>, R = kotlin/collections/Map<S, kotlin/Int>, T = S}>
+Substituted callables:
+  foo(): Triple<List<T>, Map<S, Int>, S>

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directType.kt

@@ -0,0 +1,8 @@
+// WITH_STDLIB
+
+class A<caret_base>A : BB<Int>
+
+class B<caret_super>B<S> {
+    fun foo(): List<S>
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directType.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {S = kotlin/Int}>
+Substituted callables:
+  foo(): List<Int>

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directTypeParam.kt

@@ -0,0 +1,6 @@
+class A<caret_base>A<T> : BB<T>
+
+class B<caret_super>B<S> {
+    fun foo(): S
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/directTypeParam.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {S = T}>
+Substituted callables:
+  foo(): T

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/errorInUpperBound.kt

@@ -0,0 +1,6 @@
+class A<caret_base>A : BB<Int>
+
+class B<caret_super>B<S : String> {
+    fun foo(): S
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/errorInUpperBound.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {S = kotlin/Int}>
+Substituted callables:
+  foo(): Int

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/extraTypeArgument.kt

@@ -0,0 +1,6 @@
+class A<caret_base>A : BB<Int, String>
+
+class B<caret_super>B<S> {
+    fun foo(): S
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/extraTypeArgument.result.txt

@@ -0,0 +1 @@
+Substitutor: null

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/missingTypeArgument.kt

@@ -0,0 +1,7 @@
+// WITH_STDLIB
+class A<caret_base>A : BB<Int, String>
+
+class B<caret_super>B<S, Q, U> {
+    fun foo(): Triple<S, Q, U>
+}
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/missingTypeArgument.result.txt

@@ -0,0 +1 @@
+Substitutor: null

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/multipleInheritance.kt

@@ -0,0 +1,7 @@
+class A<caret_base>A : BB<Int>, BB<String>
+
+class B<caret_super>B<S> {
+    fun foo(): Triple<S>
+}
+
+

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/multipleInheritance.result.txt

@@ -0,0 +1,3 @@
+Substitutor: <map substitutor: {S = kotlin/Int}>
+Substituted callables:
+  foo(): Triple<S>

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/self.kt

@@ -0,0 +1,7 @@
+// WITH_STDLIB
+
+class A<caret_base>A<caret_super>A : BB<Int, String>
+
+class BB<S, T> : CC<S, T, List<T>> {
+    fun foo(): Triple<S, T>
+}

analysis/analysis-api/testData/components/substitutorProvider/createInheritanceTypeSubstitutor/self.result.txt

@@ -0,0 +1 @@
+Substitutor: <empty substitutor>