[AA] KtAnnotated: split hasAnnotation to two extensions

analysis/analysis-api/src/org/jetbrains/kotlin/analysis/api/annotations/KtAnnotated.kt

@@ -28,11 +28,18 @@ public val KtAnnotated.annotations: List<KtAnnotationApplication>
  *
  * @see [KtAnnotationsList.hasAnnotation]
  */
+public fun KtAnnotated.hasAnnotation(classId: ClassId): Boolean = annotationsList.hasAnnotation(classId)
+
+/**
+ * Checks if entity has annotation with specified [classId] and [useSiteTarget].
+ *
+ * @see [KtAnnotationsList.hasAnnotation]
+ */
 public fun KtAnnotated.hasAnnotation(
     classId: ClassId,
-    useSiteTarget: AnnotationUseSiteTarget? = null,
-    strictUseSite: Boolean = true,
-): Boolean = annotationsList.hasAnnotation(classId, useSiteTarget, strictUseSite)
+    useSiteTarget: AnnotationUseSiteTarget?,
+    acceptAnnotationsWithoutUseSite: Boolean = false,
+): Boolean = annotationsList.hasAnnotation(classId, useSiteTarget, acceptAnnotationsWithoutUseSite)
 
 /**
  * A list of annotations applied with specified [classId].

analysis/analysis-api/src/org/jetbrains/kotlin/analysis/api/annotations/KtAnnotationsList.kt

@@ -30,16 +30,29 @@ public abstract class KtAnnotationsList : KtLifetimeOwner {
      * The semantic is equivalent to
      * ```
      * annotationsList.hasAnnotation(classId) == annotationsList.annotations.any { it.classId == classId }
+     * ```
+     */
+    public abstract fun hasAnnotation(classId: ClassId): Boolean
+
+    /**
+     * Checks if entity contains annotation with specified [classId] and [useSiteTarget].
+     * If [useSiteTarget] is **null** [acceptAnnotationsWithoutUseSite] effectively unused.
      *
+     * The semantic is equivalent to
+     * ```
      * annotationsList.hasAnnotation(classId, useSiteTarget, strictUseSite) == annotationsList.annotations.any {
-     *      (it.useSiteTarget == useSiteTarget || !strictUseSite && it.useSiteTarget == null) && it.classId == classId
+     *      (it.useSiteTarget == useSiteTarget || acceptAnnotationsWithoutUseSite && it.useSiteTarget == null) && it.classId == classId
      * }
      * ```
+     *
+     * @param classId [ClassId] to search
+     * @param useSiteTarget specific [AnnotationUseSiteTarget]
+     * @param acceptAnnotationsWithoutUseSite add [ClassId] without specified [AnnotationUseSiteTarget] to search
      */
     public abstract fun hasAnnotation(
         classId: ClassId,
-        useSiteTarget: AnnotationUseSiteTarget? = null,
-        strictUseSite: Boolean = true,
+        useSiteTarget: AnnotationUseSiteTarget?,
+        acceptAnnotationsWithoutUseSite: Boolean = false,
     ): Boolean
 
     /**