[TrustedProjects] cleanup: introduce the public trusted projects API

The com.intellij.ide.trustedProjects.TrustedProjects utility object is open for public usage. Other stuff is internal or deprecated in favor of this API.

### Issues
  * IJPL-172505 Trusted Projects' API is marked as Experimental

(cherry picked from commit a0f082950faadad8c855cde5090419293aa3646c)
(cherry-pick approved by IJ-CR-159977)


(cherry picked from commit 1560d86bb1a22b1e77f84be0e276937f7dc071f2)

IJ-CR-159977

GitOrigin-RevId: 84a20c94b4bf42fc2d2b51c6aacfe66454bdf483

Author: HackerMadCat

platform/platform-impl/api-dump-unreviewed.txt

@@ -4137,6 +4137,14 @@ f:com.intellij.ide.troubleshooting.CompositeGeneralTroubleInfoCollector
 - com.intellij.troubleshooting.TroubleInfoCollector
 - <init>():V
 - collectInfo(com.intellij.openapi.project.Project):java.lang.String
+f:com.intellij.ide.trustedProjects.TrustedProjects
+- sf:INSTANCE:com.intellij.ide.trustedProjects.TrustedProjects
+- sf:isProjectTrusted(com.intellij.openapi.project.Project):Z
+- sf:isProjectTrusted(java.nio.file.Path):Z
+- sf:isProjectTrusted(java.nio.file.Path,com.intellij.openapi.project.Project):Z
+- sf:setProjectTrusted(com.intellij.openapi.project.Project,Z):V
+- sf:setProjectTrusted(java.nio.file.Path,com.intellij.openapi.project.Project,Z):V
+- sf:setProjectTrusted(java.nio.file.Path,Z):V
 f:com.intellij.ide.trustedProjects.TrustedProjectsDialog
 - sf:INSTANCE:com.intellij.ide.trustedProjects.TrustedProjectsDialog
 - f:confirmLoadingUntrustedProject(com.intellij.openapi.project.Project,java.lang.String,java.lang.String,java.lang.String,java.lang.String):Z

platform/platform-impl/src/com/intellij/ide/impl/TrustedPaths.kt

@@ -46,6 +46,7 @@ class TrustedPaths : TrustedProjectsStateStorage<TrustedPaths.State>(State()) {
     }
   }
 
+  @Deprecated("Use TrustedProjects.setProjectTrusted(Path, Boolean) instead")
   fun setProjectPathTrusted(path: Path, value: Boolean) {
     updateState {
       State(it.trustedPaths + (path.toString() to value))

platform/platform-impl/src/com/intellij/ide/impl/TrustedProjects.kt

@@ -8,7 +8,6 @@ import com.intellij.ide.IdeBundle
 import com.intellij.ide.trustedProjects.TrustedProjects
 import com.intellij.ide.trustedProjects.TrustedProjectsDialog
 import com.intellij.ide.trustedProjects.TrustedProjectsListener
-import com.intellij.ide.trustedProjects.TrustedProjectsLocator
 import com.intellij.openapi.actionSystem.ActionUpdateThread
 import com.intellij.openapi.actionSystem.AnActionEvent
 import com.intellij.openapi.application.ApplicationManager
@@ -45,20 +44,38 @@ enum class OpenUntrustedProjectChoice {
   CANCEL;
 }
 
+@Suppress("unused") // Used externally
+@Deprecated(
+  "Use TrustedProjects.isProjectTrusted instead",
+  ReplaceWith(
+    "TrustedProjects.isProjectTrusted(this)",
+    "com.intellij.ide.trustedProjects.TrustedProjects"
+  )
+)
 fun Project.isTrusted(): Boolean {
-  return TrustedProjects.isProjectTrusted(TrustedProjectsLocator.locateProject(this))
+  return TrustedProjects.isProjectTrusted(this)
 }
 
+@Suppress("unused") // Used externally
+@Deprecated(
+  "Use TrustedProjects.setProjectTrusted instead",
+  ReplaceWith(
+    "TrustedProjects.setProjectTrusted(this, isTrusted)",
+    "com.intellij.ide.trustedProjects.TrustedProjects"
+  )
+)
 fun Project.setTrusted(isTrusted: Boolean) {
-  TrustedProjects.setProjectTrusted(TrustedProjectsLocator.locateProject(this), isTrusted)
+  TrustedProjects.setProjectTrusted(this, isTrusted)
 }
 
 @Suppress("unused") // Used externally
+@Deprecated("Use TrustedProjects.isProjectTrusted instead")
 fun Project.getTrustedState(): ThreeState {
-  return TrustedProjects.getProjectTrustedState(TrustedProjectsLocator.locateProject(this))
+  return TrustedProjects.getProjectTrustedState(this)
 }
 
 @Suppress("unused") // Used externally
+@Deprecated("Use TrustedProjects.isTrustedCheckDisabled instead")
 fun isTrustedCheckDisabled(): Boolean {
   return TrustedProjects.isTrustedCheckDisabled()
 }

platform/platform-impl/src/com/intellij/ide/trustedProjects/TrustedProjects.kt

@@ -6,14 +6,65 @@ import com.intellij.ide.impl.TrustedPathsSettings
 import com.intellij.ide.impl.TrustedProjectsStatistics
 import com.intellij.ide.lightEdit.LightEdit
 import com.intellij.ide.trustedProjects.TrustedProjectsLocator.LocatedProject
-import com.intellij.openapi.application.ApplicationManager
+import com.intellij.openapi.project.Project
 import com.intellij.util.ThreeState
+import com.intellij.util.application
 import org.jetbrains.annotations.ApiStatus
+import java.nio.file.Path
 
-@ApiStatus.Internal
 object TrustedProjects {
-  fun isProjectTrusted(locatedProject: LocatedProject): Boolean = getProjectTrustedState(locatedProject) == ThreeState.YES
 
+  @JvmStatic
+  fun isProjectTrusted(project: Project): Boolean {
+    return isProjectTrusted(TrustedProjectsLocator.locateProject(project))
+  }
+
+  @JvmStatic
+  fun setProjectTrusted(project: Project, isTrusted: Boolean) {
+    setProjectTrusted(TrustedProjectsLocator.locateProject(project), isTrusted)
+  }
+
+  @ApiStatus.Internal
+  fun getProjectTrustedState(project: Project): ThreeState {
+    return getProjectTrustedState(TrustedProjectsLocator.locateProject(project))
+  }
+
+  @JvmStatic
+  fun isProjectTrusted(path: Path): Boolean {
+    return isProjectTrusted(path, project = null)
+  }
+
+  @JvmStatic
+  fun setProjectTrusted(path: Path, isTrusted: Boolean) {
+    setProjectTrusted(path, project = null, isTrusted)
+  }
+
+  @ApiStatus.Internal
+  fun getProjectTrustedState(path: Path): ThreeState {
+    return getProjectTrustedState(path, project = null)
+  }
+
+  @JvmStatic
+  fun isProjectTrusted(path: Path, project: Project?): Boolean {
+    return isProjectTrusted(TrustedProjectsLocator.locateProject(path, project))
+  }
+
+  @JvmStatic
+  fun setProjectTrusted(path: Path, project: Project?, isTrusted: Boolean) {
+    setProjectTrusted(TrustedProjectsLocator.locateProject(path, project), isTrusted)
+  }
+
+  @ApiStatus.Internal
+  fun getProjectTrustedState(path: Path, project: Project?): ThreeState {
+    return getProjectTrustedState(TrustedProjectsLocator.locateProject(path, project))
+  }
+
+  @ApiStatus.Internal
+  fun isProjectTrusted(locatedProject: LocatedProject): Boolean {
+    return getProjectTrustedState(locatedProject) == ThreeState.YES
+  }
+
+  @ApiStatus.Internal
   fun getProjectTrustedState(locatedProject: LocatedProject): ThreeState {
     val explicitTrustedState = TrustedPaths.getInstance().getProjectTrustedState(locatedProject)
     return when {
@@ -28,13 +79,14 @@ object TrustedProjects {
     }
   }
 
+  @ApiStatus.Internal
   fun setProjectTrusted(locatedProject: LocatedProject, isTrusted: Boolean) {
     val trustedPaths = TrustedPaths.getInstance()
     val oldState = trustedPaths.getProjectTrustedState(locatedProject)
     trustedPaths.setProjectTrustedState(locatedProject, isTrusted)
     val newState = trustedPaths.getProjectTrustedState(locatedProject)
     if (oldState != newState) {
-      val syncPublisher = ApplicationManager.getApplication().messageBus.syncPublisher(TrustedProjectsListener.TOPIC)
+      val syncPublisher = application.messageBus.syncPublisher(TrustedProjectsListener.TOPIC)
       when (isTrusted) {
         true -> syncPublisher.onProjectTrusted(locatedProject)
         else -> syncPublisher.onProjectUntrusted(locatedProject)
@@ -43,12 +95,18 @@ object TrustedProjects {
   }
 
   /**
-   * Checks that IDEA is loaded with safe environment. In this mode, trusted checks aren't needed at all.
+   * Checks that IDEA is loaded with a safe environment.
+   * In this mode, all projects are trusted automatically.
    */
+  @ApiStatus.Internal
   fun isTrustedCheckDisabled(): Boolean {
-    val app = ApplicationManager.getApplication()
-    return app.isUnitTestMode || app.isHeadlessEnvironment || java.lang.Boolean.getBoolean("idea.trust.all.projects")
+    return java.lang.Boolean.getBoolean("idea.trust.all.projects") ||
+           application.isUnitTestMode ||
+           application.isHeadlessEnvironment
   }
 
-  private fun isTrustedCheckDisabledForProduct(): Boolean = isTrustedCheckDisabled() || java.lang.Boolean.getBoolean("idea.trust.disabled")
+  private fun isTrustedCheckDisabledForProduct(): Boolean {
+    return java.lang.Boolean.getBoolean("idea.trust.disabled") ||
+           isTrustedCheckDisabled()
+  }
 }