FIR: allow to resolve some Java classes with @kotlin.Metadata

Namely, Java classes coming from sources, as well as any Java classes
annotated with `@kotlin.Metadata` without the "kind" (JVM name "k")
argument.

This is needed to fix the "unresolved reference" problem in kapt when
generated stubs are used as a dependency when generating stubs for
another module.

Note that there's still a K1/K2 difference in the
differentModulesWithKind.kt test, however it's not a part of the issue,
so K2 behavior there is not changed.

 #KT-79138 Fixed

(cherry picked from commit ca6a695)

Author: udalov

analysis/low-level-api-fir/tests-gen/org/jetbrains/kotlin/analysis/low/level/api/fir/diagnostic/compiler/based/LLPartialDiagnosticsFe10TestGenerated.java

@@ -71,7 +71,9 @@ abstract class FirJavaFacade(session: FirSession, private val classFinder: JavaC
     private val knownClassNamesInPackage = session.firCachesFactory.createCache(classFinder::knownClassNamesInPackage)
 
     fun findClass(classId: ClassId, knownContent: ByteArray? = null): JavaClass? =
-        classFinder.findClass(JavaClassFinder.Request(classId, knownContent))?.takeUnless(JavaClass::hasMetadataAnnotation)
+        classFinder.findClass(JavaClassFinder.Request(classId, knownContent))?.takeIf { klass ->
+            klass.isFromSource || !klass.hasMetadataAnnotation()
+        }
 
     fun hasPackage(fqName: FqName): Boolean =
         packageCache.getValue(fqName) != null

analysis/low-level-api-fir/tests/org/jetbrains/kotlin/analysis/low/level/api/fir/diagnostic/compiler/based/LLDiagnosticsFe10TestGenerated.java

@@ -5,6 +5,7 @@
 
 package org.jetbrains.kotlin.fir.java
 
+import com.intellij.util.asSafely
 import org.jetbrains.kotlin.builtins.StandardNames
 import org.jetbrains.kotlin.descriptors.ClassKind
 import org.jetbrains.kotlin.descriptors.Modality
@@ -58,7 +59,12 @@ val JavaClass.classKind: ClassKind
     }
 
 fun JavaClass.hasMetadataAnnotation(): Boolean =
-    annotations.any { it.isResolvedTo(JvmAnnotationNames.METADATA_FQ_NAME) }
+    annotations.any { annotation ->
+        // `@kotlin.Metadata` is recognized as an annotation that contains Kotlin metadata only if it has the "kind" argument.
+        annotation.isResolvedTo(JvmAnnotationNames.METADATA_FQ_NAME) && annotation.arguments.any { argument ->
+            argument.name?.asString() == JvmAnnotationNames.KIND_FIELD_NAME
+        }
+    }
 
 internal fun Any?.createConstantOrError(session: FirSession, expectedConeType: ConeKotlinType? = null): FirExpression {
     val value = if (this is Int && expectedConeType != null) {

analysis/low-level-api-fir/tests/org/jetbrains/kotlin/analysis/low/level/api/fir/diagnostic/compiler/based/LLReversedDiagnosticsFe10TestGenerated.java

@@ -0,0 +1,17 @@
+// FIR_IDENTICAL
+// RUN_PIPELINE_TILL: BACKEND
+// WITH_STDLIB
+// MODULE: lib
+// FILE: E.java
+import kotlin.Metadata;
+
+@Metadata()
+public enum E {
+    OK;
+}
+
+// MODULE: main(lib)
+// FILE: box.kt
+fun box(): String = E.OK.name
+
+/* GENERATED_FIR_TAGS: functionDeclaration */

compiler/fir/analysis-tests/tests-gen/org/jetbrains/kotlin/test/runners/FirLightTreeOldFrontendDiagnosticsWithLatestLanguageVersionTestGenerated.java

@@ -0,0 +1,17 @@
+// LATEST_LV_DIFFERENCE
+// RUN_PIPELINE_TILL: FRONTEND
+// WITH_STDLIB
+// MODULE: lib
+// FILE: E.java
+import kotlin.Metadata;
+
+@Metadata(k = 1)
+public enum E {
+    OK;
+}
+
+// MODULE: main(lib)
+// FILE: box.kt
+fun box(): String = <!UNRESOLVED_REFERENCE!>E<!>.OK.name
+
+/* GENERATED_FIR_TAGS: functionDeclaration */