PStrelchenko · May 4, 2026 · Apr 18, 2026 · Apr 18, 2026 · Apr 18, 2026 · Apr 19, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,9 +2,15 @@
 
 ## [2.0.0]
 
+### Added
+
+- `suggestParameter` — a searchable string-backed parameter with optional `sealed` mode, inline options and `options.source` CSV support.
+- Support `==` and `!=` operators for string-backed parameters in boolean expressions such as `visibility` and `availability`.
+- Undo support for recipe execution actions.
+
 ### Changed
 
-- Rewrites runtime and UI of plugin to avoid Android Studio dependencies as much as possible.
+- Rewrite Geminio runtime, UI and execution pipeline to reduce Android Studio-specific dependencies as much as possible.
 
 ## [1.15.0]
 

diff --git a/docs/en/EXPRESSIONS.md b/docs/en/EXPRESSIONS.md
@@ -11,6 +11,8 @@ Examples of expressions for the `widgets` section:
 suggest: fragment_${className.classToResource().underscoreToCamelCase()}
 visibility: ${includeModule}
 availability: true
+# visibility: ${uiFramework} == compose
+# availability: ${uiFramework} != views
 ```
 
 The text inside `${}` is considered the «dynamic» part of the expression, which needs to be
@@ -28,9 +30,14 @@ Additional extension functions can be used for text parameters:
 - `layoutToFragment`;
 - `underscoreToCamelCase`.
 
-There are special values for boolean expressions - `true` / `false`
+Boolean expressions currently support:
 
-+ you can use only boolean-parameters inside ${} for them
+- `true` / `false`;
+- `${booleanParameter}`;
+- `${stringOrSuggestParameter} == value`;
+- `${stringOrSuggestParameter} != value`.
+
+Logical `&&` / `||` are not supported right now.
 
 Examples of expressions for the recipe section:
 
@@ -62,4 +69,4 @@ In the `recipe` section, we add several additional parameters for string values:
 
 ---
 
-[Return to MoC](../../README_EN.md)
+[Return to MoC](../../README_EN.md)
diff --git a/docs/en/RECIPE_CONTENT.md b/docs/en/RECIPE_CONTENT.md
@@ -67,6 +67,26 @@ widgets:
       help: Generate fragment Toothpick Module for easy instantiation
       default: true
 
+  - suggestParameter:
+      id: uiFramework
+      name: UI framework
+      help: Which UI stack should be generated
+      default: compose
+      sealed: true
+      options:
+        - value: compose
+          label: Compose
+        - value: views
+          label: Views
+
+  - suggestParameter:
+      id: targetModule
+      name: Target module
+      help: Module for integration
+      sealed: true
+      options:
+        source: options/modules.csv
+
   - stringParameter:
       id: moduleName
       name: Fragment Toothpick Module
@@ -79,6 +99,12 @@ widgets:
       visibility: ${includeModule}
       suggest: ${className.classToResource().underscoreToCamelCase()}Module
 
+  - stringParameter:
+      id: composePackage
+      name: Compose package
+      default: ru.hh.feature.compose
+      visibility: ${uiFramework} == compose
+
 globals:
   - stringParameter:
       id: reducerClassName
@@ -144,7 +170,7 @@ The recipe consists of 6 sections:
 - `optionalParams` — optional parameters;
 - `predefinedFeatures` - a set of predefined features in Geminio, which can add new widgets to the template, supplement
   the functionality.
-- `widgets` — description of template parameters; only string and boolean parameters are available for use;
+- `widgets` — description of template parameters; string, boolean and suggest parameters are available for use;
 - `globals` - description of invisible parameters for templates, some "global" variables.
 - `recipe` — a set of instructions that should be executed.
 

diff --git a/docs/en/recipe_content/WIDGETS.md b/docs/en/recipe_content/WIDGETS.md
@@ -1,7 +1,8 @@
 ### `widgets` section
 
-The `widget` section is a user's parameter list for your template. For now, we support only string and boolean
-parameters. Each parameter supports [expression](../EXPRESSIONS.md) evaluation.
+The `widget` section is a user's parameter list for your template. For now, we support string,
+boolean and searchable suggest parameters. Each parameter supports
+[expression](../EXPRESSIONS.md) evaluation.
 
 #### `stringParameter`
 
@@ -65,6 +66,51 @@ a module, some additional method, and so on). Will be converted to a checkbox on
 
 Has exactly the same parameters as `stringParameter`, but `booleanParameter` has no `suggest`.
 
+#### `suggestParameter`
+
+`suggestParameter` — description of a string-backed parameter rendered as a searchable completion field.
+
+Has the same base parameters as `stringParameter`, including `suggest`, `visibility` and `availability`,
+plus the following fields:
+
+- `sealed` — optional boolean flag. Defaults to `false`.
+  When `sealed: true`, the final value should match one of the declared options.
+- `options` — required source of suggested values. Can be declared in one of two forms:
+
+    * inline list:
+
+      ```yaml
+      options:
+        - value: compose
+          label: Compose
+        - value: views
+      ```
+
+    * external CSV file relative to `recipe.yaml`:
+
+      ```yaml
+      options:
+        source: options/ui_frameworks.csv
+      ```
+
+Inline options and CSV rows support:
+
+- `value` — the actual value exposed to expressions and FreeMarker templates;
+- `label` — optional text shown in the UI. If omitted, Geminio uses `value`. Labels should be
+  unique within one `suggestParameter`.
+
+CSV files are read as UTF-8 and support either `value` or `value,label` rows. The optional
+`value,label` header is ignored automatically.
+
+Additional notes:
+
+- `default` should match one of `options.value` only when `sealed: true`;
+- `suggest` is evaluated in terms of stored values, not labels;
+- for `sealed: true`, if `suggest` returns a value that is not present in `options`, Geminio does
+  not apply it. Instead, it keeps the current value when it is still valid; otherwise it uses
+  `default`, and if `default` is also missing or invalid, it falls back to the first option;
+- for `sealed: false`, any entered string is accepted, while `options` only power completion.
+
 ---
 
 [Back to `recipe.yaml` content](../RECIPE_CONTENT.md)
diff --git a/docs/ru/EXPRESSIONS.md b/docs/ru/EXPRESSIONS.md
@@ -11,6 +11,8 @@
 suggest: fragment_${className.classToResource().underscoreToCamelCase()}
 visibility: ${includeModule}
 availability: true
+# visibility: ${uiFramework} == compose
+# availability: ${uiFramework} != views
 ```
 
 Текст внутри `${}` считается за "динамическую" часть выражения, которую требуется вычислять в зависимости от содержания,
@@ -27,9 +29,14 @@ availability: true
 - `layoutToFragment`
 - `underscoreToCamelCase`
 
-Для булевских выражений есть специальные значения - `true` / `false`
+Для булевских выражений сейчас поддерживаются:
 
-+ для них возможно использование только boolean-параметров
+- `true` / `false`
+- `${booleanParameter}`
+- `${stringOrSuggestParameter} == value`
+- `${stringOrSuggestParameter} != value`
+
+Логические `&&` / `||` пока не поддерживаются.
 
 Примеры выражений для секции `recipe`:
 
@@ -64,4 +71,4 @@ availability: true
 
 ---
 
-[Обратно к содержанию](../../plugins/hh-geminio/README.md#Содержание)
+[Обратно к содержанию](../../README.md#Содержание)
diff --git a/docs/ru/RECIPE_CONTENT.md b/docs/ru/RECIPE_CONTENT.md
@@ -67,6 +67,26 @@ widgets:
       help: Generate fragment Toothpick Module for easy instantiation
       default: true
 
+  - suggestParameter:
+      id: uiFramework
+      name: UI framework
+      help: Which UI stack should be generated
+      default: compose
+      sealed: true
+      options:
+        - value: compose
+          label: Compose
+        - value: views
+          label: Views
+
+  - suggestParameter:
+      id: targetModule
+      name: Target module
+      help: Module for integration
+      sealed: true
+      options:
+        source: options/modules.csv
+
   - stringParameter:
       id: moduleName
       name: Fragment Toothpick Module
@@ -79,6 +99,12 @@ widgets:
       visibility: ${includeModule}
       suggest: ${className.classToResource().underscoreToCamelCase()}Module
 
+  - stringParameter:
+      id: composePackage
+      name: Compose package
+      default: ru.hh.feature.compose
+      visibility: ${uiFramework} == compose
+
 globals:
   - stringParameter:
       id: reducerClassName
@@ -143,7 +169,7 @@ recipe:
 - `requiredParams` - обязательные параметры для вашего шаблона
 - `optionalParams` - соответственно, необязательные параметры
 - `predefinedFeatures` - набор заранее предопределённых фич в Geminio, которые могут добавлять новые виджеты в шаблон, дополнять функционал.
-- `widgets` - описание параметров шаблона - для использования доступны строковые и булевские параметры
+- `widgets` - описание параметров шаблона - для использования доступны строковые, булевские и suggest-параметры
 - `globals` - описание невидимых параметров для шаблонов, некие "глобальные" переменные.
 - `recipe` - сам рецепт, набор инструкций, которые нужно выполнить
 

diff --git a/docs/ru/recipe_content/WIDGETS.md b/docs/ru/recipe_content/WIDGETS.md
@@ -1,7 +1,7 @@
 ### Секция `widgets`
 
 Секция виджетов - это список параметров вашего шаблона, которые зависят от пользователя.
-В данный момент поддерживаются строковые и булевские параметры.
+На данный момент секция поддерживает строковые, булевские и suggest-параметры с поиском.
 Параметры поддерживают вычисление [выражений](../EXPRESSIONS.md).
 
 #### `stringParameter`
@@ -67,6 +67,52 @@
 
 Имеет ровно такие же параметры, как и `stringParamter`, только у `booleanParameter` нет `suggest`.
 
+#### `suggestParameter`
+
+`suggestParameter` - описание строкового параметра, который на UI отображается как поле с поиском
+и completion-подсказками.
+
+Имеет те же базовые параметры, что и `stringParameter`, включая `suggest`, `visibility` и
+`availability`, а также следующие поля:
+
+- `sealed` - необязательный флаг. По умолчанию `false`.
+  При `sealed: true` итоговое значение должно совпадать с одним из объявленных option.
+- `options` - обязательный источник значений для подсказок. Можно задать в одном из двух видов:
+
+    * прямо в recipe:
+
+      ```yaml
+      options:
+        - value: compose
+          label: Compose
+        - value: views
+      ```
+
+    * через внешний CSV-файл относительно `recipe.yaml`:
+
+      ```yaml
+      options:
+        source: options/ui_frameworks.csv
+      ```
+
+И inline-значения, и строки CSV поддерживают:
+
+- `value` - фактическое значение, которое попадёт в выражения и FreeMarker-шаблоны
+- `label` - необязательный текст, который будет показан пользователю на UI. Если его не задать,
+  Geminio использует `value`. Значения `label` должны быть уникальными внутри одного `suggestParameter`
+
+CSV-файлы читаются как UTF-8 и поддерживают строки вида `value` или `value,label`. Необязательный
+заголовок `value,label` будет автоматически проигнорирован.
+
+Дополнительно:
+
+- `default` должен совпадать с одним из `options.value` только при `sealed: true`
+- `suggest` вычисляется в терминах сохраняемого значения, а не `label`
+- при `sealed: true`, если `suggest` вернул значение, которого нет в `options`, Geminio не будет
+  применять его. Вместо этого он оставит текущее значение, если оно всё ещё валидно; иначе
+  возьмёт `default`, а если и `default` отсутствует или невалиден - откатится к первому option
+- при `sealed: false` можно ввести любую строку, а `options` используются только для completion.
+
 ---
 
 [Обратно к устройству "рецептов"](../RECIPE_CONTENT.md)
diff --git a/src/main/kotlin/ru/hh/plugins/geminio/sdk/form/GeminioForm.kt b/src/main/kotlin/ru/hh/plugins/geminio/sdk/form/GeminioForm.kt
@@ -137,6 +137,44 @@ internal sealed class GeminioFormField {
         val defaultValue: Boolean? = null,
         val initialValueEvaluator: GeminioFormBooleanEvaluator? = null,
     ) : GeminioFormField()
+
+    /**
+     * Searchable completion field with optional closed-set validation.
+     */
+    data class SuggestField(
+        override val id: String,
+        override val name: String,
+        override val help: String?,
+        override val origin: GeminioFormFieldOrigin,
+        override val visibilityEvaluator: GeminioFormBooleanEvaluator? = null,
+        override val availabilityEvaluator: GeminioFormBooleanEvaluator? = null,
+        val defaultValue: String? = null,
+        val isSealed: Boolean = false,
+        val initialValueEvaluator: GeminioFormStringEvaluator? = null,
+        val suggestEvaluator: GeminioFormStringEvaluator? = null,
+        val options: List<GeminioFormSuggestOption>,
+    ) : GeminioFormField() {
+
+        init {
+            require(options.isNotEmpty()) {
+                "Suggest field '$id' should contain at least one option."
+            }
+        }
+
+        fun containsValue(value: String?): Boolean {
+            return value != null && options.any { option -> option.value == value }
+        }
+
+        fun findOption(textOrValue: String?): GeminioFormSuggestOption? {
+            return options.firstOrNull { option ->
+                option.value == textOrValue || option.label == textOrValue
+            }
+        }
+
+        fun resolveStoredValue(input: String?): String? {
+            return findOption(input)?.value ?: input
+        }
+    }
 }
 
 /**