// Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
package org.jetbrains.idea.devkit.inspections;

import com.intellij.codeInspection.AbstractBaseUastLocalInspectionTool;
import com.intellij.codeInspection.InspectionManager;
import com.intellij.codeInspection.ProblemsHolder;
import com.intellij.psi.PsiElement;
import com.intellij.psi.PsiElementVisitor;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.uast.UElement;

/**
 * Base class for UAST-based (source-level) DevKit inspections.
 * <p/>
 * Notice different CTORs depending on visitor usage.
 * <p/>
 * Override {@link #isAllowed} to add additional constraints (e.g., required class in scope via {@link DevKitInspectionUtil#isClassAvailable})
 * to skip running inspection completely whenever possible.
 *
 * @see DevKitInspectionUtil
 * @see DevKitJvmInspection
 */
public abstract class DevKitUastInspectionBase extends AbstractBaseUastLocalInspectionTool {

  /**
   * When overriding {@link #buildInternalVisitor} to create custom visitor.
   */
  protected DevKitUastInspectionBase() {
  }

  /**
   * When *NOT* overriding {@link #buildInternalVisitor} but using {@code checkClass|Method|Field}.
   */
  @SafeVarargs
  protected DevKitUastInspectionBase(Class<? extends UElement>... uElementsTypesHint) {
    super(uElementsTypesHint);
  }

  @Override
  public final @NotNull PsiElementVisitor buildVisitor(@NotNull ProblemsHolder holder, boolean isOnTheFly) {
    return isAllowed(holder) ? buildInternalVisitor(holder, isOnTheFly) : PsiElementVisitor.EMPTY_VISITOR;
  }

  protected boolean isAllowed(@NotNull ProblemsHolder holder) {
    return DevKitInspectionUtil.isAllowed(holder.getFile());
  }

  protected PsiElementVisitor buildInternalVisitor(@NotNull ProblemsHolder holder, boolean isOnTheFly) {
    return super.buildVisitor(holder, isOnTheFly);
  }

  @Override
  public final boolean isDumbAware() {
    return false;
  }

  protected static @NotNull ProblemsHolder createProblemsHolder(@NotNull UElement uElement,
                                                                @NotNull InspectionManager manager,
                                                                boolean isOnTheFly) {
    PsiElement sourcePsi = uElement.getSourcePsi();
    if (sourcePsi != null) {
      return new ProblemsHolder(manager, sourcePsi.getContainingFile(), isOnTheFly);
    }
    throw new IllegalStateException("Could not create problems holder");
  }
}
