Introduce deprecation of companion objects nested classes

Introdude deprecation as per KT-21515. Warning is reported on type
usage, that soon will became invisible. Quickfix by adding explicit
import is added.

Idea behind implementation is to mark scopes that are deprecated (see
ClassResolutionScopesSupport).

Then, during walk along hierarchy of scopes, look at deprecation status
of the scope that has provided this classifier.
Note that we also have to check if there are *some* non-deprecated
visibility paths (because we can see classifier by two paths, e.g. if
we've added explicit import) -- then this type reference shouldn't be
treated as deprecated.

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnClass.kt

@@ -0,0 +1,13 @@
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion {
+            fun foo() = 42
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = <caret>FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnClass.kt.after

@@ -0,0 +1,15 @@
+import Bar.Companion.FromBarCompanion
+
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion {
+            fun foo() = 42
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnClassWithCompanion.kt

@@ -0,0 +1,16 @@
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion {
+            fun foo() = 42
+
+            // We need it to cover another code-path
+            companion object { }
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = <caret>FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnClassWithCompanion.kt.after

@@ -0,0 +1,18 @@
+import Bar.Companion.FromBarCompanion
+
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion {
+            fun foo() = 42
+
+            // We need it to cover another code-path
+            companion object { }
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnObject.kt

@@ -0,0 +1,13 @@
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        object FromBarCompanion {
+            fun foo() = 42
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = <caret>FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/callableReferenceOnObject.kt.after

@@ -0,0 +1,15 @@
+import Bar.Companion.FromBarCompanion
+
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        object FromBarCompanion {
+            fun foo() = 42
+        }
+    }
+}
+
+class Foo : Bar() {
+    val a = FromBarCompanion::foo
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/constructor.kt

@@ -0,0 +1,11 @@
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion
+    }
+}
+
+class Foo : Bar() {
+    val a = <caret>FromBarCompanion()
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/constructor.kt.after

@@ -0,0 +1,13 @@
+import Bar.Companion.FromBarCompanion
+
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion
+    }
+}
+
+class Foo : Bar() {
+    val a = FromBarCompanion()
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/typeReference.kt

@@ -0,0 +1,11 @@
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion
+    }
+}
+
+class Foo : Bar() {
+    val a: <caret>FromBarCompanion? = null
+}

idea/testData/quickfix/createFromUsage/createClass/importDirective/kt21515/typeReference.kt.after

@@ -0,0 +1,13 @@
+import Bar.Companion.FromBarCompanion
+
+// "Add explicit import" "true"
+
+open class Bar {
+    companion object {
+        class FromBarCompanion
+    }
+}
+
+class Foo : Bar() {
+    val a: FromBarCompanion? = null
+}