bandlab
diff --git a/‎README.md‎
Lines changed: 21 additions & 6 deletions b/‎README.md‎
Lines changed: 21 additions & 6 deletions
diff --git a/‎build.gradle.kts‎
Lines changed: 12 additions & 0 deletions b/‎build.gradle.kts‎
Lines changed: 12 additions & 0 deletions
diff --git a/‎docs/images/localization-add-reference.png‎
30.4 KB b/‎docs/images/localization-add-reference.png‎
30.4 KB
diff --git a/‎docs/images/localization-edit-warning.png‎
53.9 KB b/‎docs/images/localization-edit-warning.png‎
53.9 KB
diff --git a/‎docs/images/localization-global-actions.png‎
18.3 KB b/‎docs/images/localization-global-actions.png‎
18.3 KB
diff --git a/‎docs/images/localization-strings-file.png‎
110 KB b/‎docs/images/localization-strings-file.png‎
110 KB
diff --git a/‎docs/images/localization-update-reference.png‎
27 KB b/‎docs/images/localization-update-reference.png‎
27 KB
diff --git a/‎gradle/libs.versions.toml‎
Lines changed: 6 additions & 0 deletions b/‎gradle/libs.versions.toml‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎libs/config.jar‎
43.4 KB b/‎libs/config.jar‎
43.4 KB
diff --git a/‎src/main/kotlin/com/bandlab/intellij/plugin/localizer/EditAllowedBranches.kt‎
Lines changed: 51 additions & 0 deletions b/‎src/main/kotlin/com/bandlab/intellij/plugin/localizer/EditAllowedBranches.kt‎
Lines changed: 51 additions & 0 deletions
@@ -124,14 +124,29 @@ The plugin helps invoke these tasks in your IDE's Run tab:
 
 ---
 
-## Update Localized Strings
-![update strings](https://i.imgur.com/l7BLO2N.png)
+## Localization Strings
 
-Update all localized strings for a given module from Tolgee. There are multiple entry points:
-1. Right-click on a module that contains string resources.
-2. Right-click (or Shift+Cmd+A) on a strings.xml, or strings-plurals.xml file.
+Add, update, and delete localization keys without hand-editing string resources — every action shells out to `./localizer/bandlab-localizer`, which owns merging, validation, and multi-locale output. Available whenever `bandlab-localizer-config.toml` resolves (no Gradle sync needed).
 
-The plugin helps invoke `./localizer/bandlab-localizer update-strings` in your IDE's termial tab.
+**Add a key that doesn't exist yet.** On an unresolved reference (`Strings.foo` / `R.string.foo`), Alt+Enter → **Localizer: Add string** pulls it from Tolgee into the right module's file.
+
+![Add string from a new reference](docs/images/localization-add-reference.png)
+
+**Update an existing key in place.** On a defined `Strings.foo` / `R.string.foo` reference, Alt+Enter → **Localizer: Update** re-fetches just that key — no full re-sync.
+
+![Update an existing reference](docs/images/localization-update-reference.png)
+
+**Work from the string file.** Open a managed `strings.xml` / `strings-plurals.xml`: a banner links to the actions, and Alt+Enter on a `<string>` offers **Update** / **Delete** for that one key.
+
+![Managed string file — banner and context actions](docs/images/localization-strings-file.png)
+
+**Run an action from anywhere.** Find Action (or the Localizer menu) → **Update / Add / Delete Strings**, choosing the target file.
+
+![Localizer global actions](docs/images/localization-global-actions.png)
+
+**Hand-editing is gated, not blocked.** Typing into a managed file prompts you to use the actions instead; choose *Edit on this branch* to proceed anyway (remembered per Git branch — e.g. a feature branch with un-finalized strings).
+
+![Edit-warning dialog](docs/images/localization-edit-warning.png)
 
 ---
 
 
@@ -54,6 +54,12 @@ dependencies {
         composeUI()
     }
 
+    // bandlab-localizer config model, vendored as a prebuilt jar (config 3.2.0 release artifact).
+    // file() deps carry no transitive metadata, so config's runtime deps are declared explicitly.
+    implementation(files("libs/config.jar"))
+    implementation(libs.ktoml.file)
+    implementation(libs.serialization.json)
+
     testImplementation(libs.junit)
     // Used in com.intellij.util.lang.UrlClassLoader
     // see: https://github.com/JetBrains/intellij-platform-gradle-plugin/issues/2127
@@ -148,6 +154,12 @@ kover {
 }
 
 tasks {
+    // Launches a headless IDE to prebuild the settings search index; collides with a running IDE
+    // ("only one instance of IDEA") and breaks local builds. Settings stay searchable without it.
+    buildSearchableOptions {
+        enabled = false
+    }
+
     register("patchReadme") {
         description = "Updates the IntelliJ IDEA badge in README.md to match targetPlatformVersion in gradle.properties"
         group = "documentation"
 
@@ -9,6 +9,10 @@ turbine = "1.2.1"
 coroutines = "1.10.2"
 # https://github.com/ota4j-team/opentest4j/releases
 opentest4j = "1.3.0"
+# Runtime deps of the vendored bandlab-localizer config.jar (libs/).
+# app.gildor ktoml fork — https://github.com/gildor/ktoml/releases
+ktoml = "0.8.1"
+serialization = "1.8.1"
 
 # plugins
 changelog = "2.5.0"
@@ -27,6 +31,8 @@ truth = { group = "com.google.truth", name = "truth", version.ref = "truth" }
 opentest4j = { group = "org.opentest4j", name = "opentest4j", version.ref = "opentest4j" }
 turbine = { group = "app.cash.turbine", name = "turbine", version.ref = "turbine" }
 coroutines-test = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-test", version.ref = "coroutines" }
+ktoml-file = { group = "app.gildor", name = "ktoml-file", version.ref = "ktoml" }
+serialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json", version.ref = "serialization" }
 
 [plugins]
 changelog = { id = "org.jetbrains.changelog", version.ref = "changelog" }
 
@@ -0,0 +1,51 @@
+package com.bandlab.intellij.plugin.localizer
+
+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.components.service
+import com.intellij.openapi.project.Project
+
+/**
+ * Persists the set of git branches on which the developer has explicitly chosen to allow direct
+ * edits to localizer-managed string files. Stored in the workspace file so the preference is local
+ * to this developer and not committed to VCS.
+ *
+ * When the current branch is in this set, [LocalizerEditWarningTypedHandler] silently permits edits
+ * without prompting.
+ */
+@Service(Service.Level.PROJECT)
+@State(
+    name = "BandLabLocalizerEditAllowedBranches",
+    storages = [Storage(StoragePathMacros.WORKSPACE_FILE)],
+)
+class EditAllowedBranches : PersistentStateComponent<EditAllowedBranches.State> {
+
+    class State {
+        // MutableList serializes reliably with the IntelliJ XML serializer; Set/LinkedHashSet can
+        // lose elements on round-trip. The contains/add contract is preserved via list operations.
+        var branches: MutableList<String> = mutableListOf()
+    }
+
+    private var state = State()
+
+    override fun getState(): State = state
+
+    override fun loadState(s: State) {
+        state = s
+    }
+
+    /** True when edits on [branch] should be allowed without a warning dialog. */
+    fun isAllowed(branch: String): Boolean = branch in state.branches
+
+    /** Marks [branch] as allowed; subsequent keystrokes in managed files will pass through silently. */
+    fun allow(branch: String) {
+        if (branch !in state.branches) state.branches.add(branch)
+    }
+
+    companion object {
+        fun getInstance(project: Project): EditAllowedBranches = project.service()
+    }
+}