Merge pull request #62 from skydoves/feature/plugin-project-scope

Change configuration scopes from to application to project

Author: skydoves

compose-stability-analyzer-idea/api/compose-stability-analyzer-idea.api

@@ -79,8 +79,24 @@ public final class com/skydoves/compose/stability/idea/quickfix/AddTraceRecompos
 	public fun isAvailable (Lcom/intellij/openapi/project/Project;Lcom/intellij/openapi/editor/Editor;Lcom/intellij/psi/PsiElement;)Z
 }
 
-public final class com/skydoves/compose/stability/idea/settings/StabilitySettingsConfigurable : com/intellij/openapi/options/BoundConfigurable {
+public final class com/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState : com/intellij/openapi/components/PersistentStateComponent {
+	public static final field Companion Lcom/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState$Companion;
 	public fun <init> ()V
+	public final fun getCustomStableTypesAsRegex ()Ljava/util/List;
+	public final fun getStabilityConfigurationPath ()Ljava/lang/String;
+	public fun getState ()Lcom/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState;
+	public synthetic fun getState ()Ljava/lang/Object;
+	public fun loadState (Lcom/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState;)V
+	public synthetic fun loadState (Ljava/lang/Object;)V
+	public final fun setStabilityConfigurationPath (Ljava/lang/String;)V
+}
+
+public final class com/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState$Companion {
+	public final fun getInstance (Lcom/intellij/openapi/project/Project;)Lcom/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState;
+}
+
+public final class com/skydoves/compose/stability/idea/settings/StabilitySettingsConfigurable : com/intellij/openapi/options/BoundConfigurable {
+	public fun <init> (Lcom/intellij/openapi/project/Project;)V
 	public fun apply ()V
 	public fun createPanel ()Lcom/intellij/openapi/ui/DialogPanel;
 	public fun isModified ()Z

compose-stability-analyzer-idea/src/main/kotlin/com/skydoves/compose/stability/idea/StabilityAnalyzer.kt

@@ -17,7 +17,9 @@
 
 package com.skydoves.compose.stability.idea
 
+import com.intellij.openapi.project.Project
 import com.skydoves.compose.stability.idea.k2.StabilityAnalyzerK2
+import com.skydoves.compose.stability.idea.settings.StabilityProjectSettingsState
 import com.skydoves.compose.stability.idea.settings.StabilitySettingsState
 import com.skydoves.compose.stability.runtime.ComposableStabilityInfo
 import com.skydoves.compose.stability.runtime.ParameterStability
@@ -72,9 +74,19 @@ internal object StabilityAnalyzer {
 
   /**
    * Get custom stable type patterns from configuration file.
+   * Uses project-level settings first, falls back to global settings.
    */
-  private val customStablePatterns: List<Regex>
-    get() = settings.getCustomStableTypesAsRegex()
+  private fun getCustomStablePatterns(project: Project?): List<Regex> {
+    if (project != null) {
+      val projectPatterns = StabilityProjectSettingsState.getInstance(
+        project,
+      ).getCustomStableTypesAsRegex()
+      if (projectPatterns.isNotEmpty()) {
+        return projectPatterns
+      }
+    }
+    return settings.getCustomStableTypesAsRegex()
+  }
 
   /**
    * Check if a fully qualified type name should be ignored based on user settings.
@@ -88,9 +100,9 @@ internal object StabilityAnalyzer {
   /**
    * Check if a fully qualified type name should be considered stable based on custom configuration.
    */
-  private fun isCustomStableType(fqName: String?): Boolean {
+  private fun isCustomStableType(fqName: String?, project: Project? = null): Boolean {
     if (fqName == null) return false
-    return customStablePatterns.any { pattern -> pattern.matches(fqName) }
+    return getCustomStablePatterns(project).any { pattern -> pattern.matches(fqName) }
   }
 
   /**
@@ -303,7 +315,7 @@ internal object StabilityAnalyzer {
             ParameterStability.STABLE,
             "Ignored by user settings: $fqName",
           )
-        } else if (isCustomStableType(fqName)) {
+        } else if (isCustomStableType(fqName, param.project)) {
           StabilityResult(
             ParameterStability.STABLE,
             "Custom stable type from configuration: $fqName",
@@ -414,7 +426,7 @@ internal object StabilityAnalyzer {
             }
 
             // Check if type is custom stable
-            if (isCustomStableType(fqName)) {
+            if (isCustomStableType(fqName, typeRef.project)) {
               return StabilityResult(
                 ParameterStability.STABLE,
                 "Custom stable type from configuration: $fqName",

compose-stability-analyzer-idea/src/main/kotlin/com/skydoves/compose/stability/idea/k2/KtStabilityInferencer.kt

@@ -15,8 +15,10 @@
  */
 package com.skydoves.compose.stability.idea.k2
 
+import com.intellij.openapi.project.Project
 import com.skydoves.compose.stability.idea.StabilityAnalysisConstants
 import com.skydoves.compose.stability.idea.StabilityConstants
+import com.skydoves.compose.stability.idea.settings.StabilityProjectSettingsState
 import com.skydoves.compose.stability.idea.settings.StabilitySettingsState
 import org.jetbrains.kotlin.analysis.api.KaSession
 import org.jetbrains.kotlin.analysis.api.symbols.KaClassKind
@@ -55,7 +57,7 @@ import org.jetbrains.kotlin.analysis.api.types.KaTypeNullability
  * 20. Regular classes - property analysis (returns STABLE/UNSTABLE if definitive)
  * 21. @StabilityInferred (RUNTIME - only for uncertain cases)
  */
-internal class KtStabilityInferencer {
+internal class KtStabilityInferencer(private val project: Project? = null) {
 
   private val settings: StabilitySettingsState
     get() = StabilitySettingsState.getInstance()
@@ -690,11 +692,19 @@ internal class KtStabilityInferencer {
 
   /**
    * Check if type is custom stable based on user configuration.
+   * Uses project-level settings first, falls back to global settings.
    */
   private fun isCustomStableType(fqName: String?): Boolean {
     if (fqName == null) return false
 
-    val customPatterns = settings.getCustomStableTypesAsRegex()
+    val customPatterns = if (project != null) {
+      val projectPatterns = StabilityProjectSettingsState.getInstance(
+        project,
+      ).getCustomStableTypesAsRegex()
+      if (projectPatterns.isNotEmpty()) projectPatterns else settings.getCustomStableTypesAsRegex()
+    } else {
+      settings.getCustomStableTypesAsRegex()
+    }
     return customPatterns.any { pattern -> pattern.matches(fqName) }
   }
 

compose-stability-analyzer-idea/src/main/kotlin/com/skydoves/compose/stability/idea/k2/StabilityAnalyzerK2.kt

@@ -72,7 +72,7 @@ internal object StabilityAnalyzerK2 {
   private fun analyzeWithK2Session(function: KtNamedFunction): ComposableStabilityInfo {
     // Get function symbol
     val functionSymbol = function.symbol
-    val inferencer = KtStabilityInferencer()
+    val inferencer = KtStabilityInferencer(function.project)
 
     // Analyze value parameters
     val parameters = functionSymbol.valueParameters.map { param ->

compose-stability-analyzer-idea/src/main/kotlin/com/skydoves/compose/stability/idea/settings/StabilityProjectSettingsState.kt

@@ -0,0 +1,92 @@
+/*
+ * Designed and developed by 2025 skydoves (Jaewoong Eum)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.skydoves.compose.stability.idea.settings
+
+import com.intellij.openapi.components.PersistentStateComponent
+import com.intellij.openapi.components.Service
+import com.intellij.openapi.components.State
+import com.intellij.openapi.components.Storage
+import com.intellij.openapi.components.StoragePathMacros
+import com.intellij.openapi.project.Project
+import com.intellij.util.xmlb.XmlSerializerUtil
+
+/**
+ * Project-level settings for Compose Stability Analyzer plugin.
+ * These settings are stored per-project in .idea/composeStabilityProject.xml
+ */
+@Service(Service.Level.PROJECT)
+@State(
+  name = "ComposeStabilityProjectSettings",
+  storages = [Storage(StoragePathMacros.WORKSPACE_FILE)],
+)
+public class StabilityProjectSettingsState :
+  PersistentStateComponent<StabilityProjectSettingsState> {
+
+  /**
+   * Path to external stability configuration file for this project.
+   * This file can define custom stable types and ignored patterns.
+   */
+  public var stabilityConfigurationPath: String = ""
+
+  public override fun getState(): StabilityProjectSettingsState = this
+
+  public override fun loadState(state: StabilityProjectSettingsState) {
+    XmlSerializerUtil.copyBean(state, this)
+  }
+
+  /**
+   * Get custom stable type patterns from configuration file.
+   */
+  public fun getCustomStableTypesAsRegex(): List<Regex> {
+    if (stabilityConfigurationPath.isEmpty()) {
+      return emptyList()
+    }
+
+    return try {
+      val file = java.io.File(stabilityConfigurationPath)
+      if (!file.exists() || !file.isFile) {
+        return emptyList()
+      }
+
+      val patterns = mutableListOf<String>()
+      file.readLines().forEach { line ->
+        val trimmed = line.trim()
+        if (trimmed.isNotEmpty() && !trimmed.startsWith("#")) {
+          patterns.add(trimmed)
+        }
+      }
+
+      patterns.mapNotNull { pattern ->
+        try {
+          pattern
+            .replace(".", "\\.")
+            .replace("*", ".*")
+            .toRegex()
+        } catch (e: Exception) {
+          null
+        }
+      }
+    } catch (e: Exception) {
+      emptyList()
+    }
+  }
+
+  public companion object {
+    public fun getInstance(project: Project): StabilityProjectSettingsState {
+      return project.getService(StabilityProjectSettingsState::class.java)
+    }
+  }
+}

compose-stability-analyzer-idea/src/main/kotlin/com/skydoves/compose/stability/idea/settings/StabilitySettingsConfigurable.kt

@@ -18,7 +18,7 @@ package com.skydoves.compose.stability.idea.settings
 import com.intellij.codeInsight.daemon.DaemonCodeAnalyzer
 import com.intellij.openapi.fileChooser.FileChooserDescriptorFactory
 import com.intellij.openapi.options.BoundConfigurable
-import com.intellij.openapi.project.ProjectManager
+import com.intellij.openapi.project.Project
 import com.intellij.openapi.ui.DialogPanel
 import com.intellij.ui.ColorPanel
 import com.intellij.ui.dsl.builder.AlignX
@@ -32,9 +32,13 @@ import java.awt.Color
  * Settings configurable for Compose Stability Analyzer plugin.
  * Appears in Settings → Tools → Compose Stability Analyzer
  */
-public class StabilitySettingsConfigurable : BoundConfigurable("Compose Stability Analyzer") {
+public class StabilitySettingsConfigurable(
+  private val project: Project,
+) : BoundConfigurable("Compose Stability Analyzer") {
 
   private val settings: StabilitySettingsState = StabilitySettingsState.getInstance()
+  private val projectSettings: StabilityProjectSettingsState =
+    StabilityProjectSettingsState.getInstance(project)
 
   // Gutter color panels
   private lateinit var stableGutterColorPanel: ColorPanel
@@ -149,23 +153,24 @@ public class StabilitySettingsConfigurable : BoundConfigurable("Compose Stabilit
         }
       }
 
-      group("External Configuration") {
+      group("Project Configuration") {
         row {
-          label("Stability configuration file:")
+          label("Stability configuration file (per-project):")
         }
 
         row {
           textFieldWithBrowseButton(
             fileChooserDescriptor = FileChooserDescriptorFactory.createSingleFileDescriptor(),
             fileChosen = { file -> file.path },
           )
-            .bindText(settings::stabilityConfigurationPath)
+            .bindText(projectSettings::stabilityConfigurationPath)
             .align(AlignX.FILL)
             .comment(
               """
-              Path to a file containing custom stable type patterns.
+              Path to a file containing custom stable type patterns for this project.
               Each line should be a package/type pattern (supports wildcards).
               Types matching these patterns will be treated as stable.
+              This setting is stored per-project.
 
               Example file content:
                 # Custom stable types
@@ -266,9 +271,7 @@ public class StabilitySettingsConfigurable : BoundConfigurable("Compose Stabilit
       settings.runtimeHintColorRGB = color.rgb
     }
 
-    // Restart code analysis in all open projects to apply new settings
-    ProjectManager.getInstance().openProjects.forEach { project ->
-      DaemonCodeAnalyzer.getInstance(project).restart()
-    }
+    // Restart code analysis in the current project to apply new settings
+    DaemonCodeAnalyzer.getInstance(project).restart()
   }
 }

compose-stability-analyzer-idea/src/main/resources/META-INF/plugin.xml

@@ -39,11 +39,15 @@
         <applicationService
                 serviceImplementation="com.skydoves.compose.stability.idea.settings.StabilitySettingsState"/>
 
-        <applicationConfigurable
+        <projectService
+                serviceImplementation="com.skydoves.compose.stability.idea.settings.StabilityProjectSettingsState"/>
+
+        <projectConfigurable
                 parentId="tools"
                 instance="com.skydoves.compose.stability.idea.settings.StabilitySettingsConfigurable"
                 id="com.skydoves.compose.stability.idea.settings.StabilitySettingsConfigurable"
-                displayName="Compose Stability Analyzer"/>
+                displayName="Compose Stability Analyzer"
+                nonDefaultProject="true"/>
 
         <!-- Documentation provider for hover tooltips -->
         <lang.documentationProvider

stability-compiler/api/stability-compiler.api

@@ -114,6 +114,7 @@ public final class com/skydoves/compose/stability/compiler/StabilityAnalyzerIrGe
 
 public final class com/skydoves/compose/stability/compiler/StabilityAnalyzerPluginRegistrar : org/jetbrains/kotlin/compiler/plugin/CompilerPluginRegistrar {
 	public fun <init> ()V
+	public final fun getPluginId ()Ljava/lang/String;
 	public fun getSupportsK2 ()Z
 	public fun registerExtensions (Lorg/jetbrains/kotlin/compiler/plugin/CompilerPluginRegistrar$ExtensionStorage;Lorg/jetbrains/kotlin/config/CompilerConfiguration;)V
 }

stability-compiler/src/main/kotlin/com/skydoves/compose/stability/compiler/StabilityAnalyzerPluginRegistrar.kt

@@ -26,6 +26,8 @@ public class StabilityAnalyzerPluginRegistrar : CompilerPluginRegistrar() {
 
   override val supportsK2: Boolean = true
 
+  public val pluginId: String = StabilityAnalyzerCommandLineProcessor.PLUGIN_ID
+
   override fun ExtensionStorage.registerExtensions(configuration: CompilerConfiguration) {
     val enabled = configuration.get(StabilityAnalyzerConfigurationKeys.KEY_ENABLED, true)