refactor(writeObject): Улучшена обработка мультиязычных пояснений в конвертере SubsystemDesignerWriteConverter

- Добавлен новый список предпочтительных локалей для выбора языковой записи в методе explanationToString.
- Обновлены комментарии для более точного описания логики обработки мультиязычных данных в формате Designer.

Author: johnnyshut

src/main/java/com/github/_1c_syntax/bsl/writer/designer/SubsystemDesignerWriteConverter.java

@@ -29,6 +29,7 @@
 import com.thoughtworks.xstream.io.HierarchicalStreamReader;
 import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
 
+import java.util.List;
 import java.util.Set;
 
 /**
@@ -47,6 +48,8 @@ public class SubsystemDesignerWriteConverter implements Converter {
   private static final String V8_CONTENT = "v8:content";
   private static final String FALSE = "false";
   private static final Set<String> ALLOW_EMPTY_NODES = Set.of("Comment", "Explanation", "Picture", "Content");
+  /** Preferred locale order for Explanation when Designer format only allows a single string. */
+  private static final List<String> EXPLANATION_LOCALE_ORDER = List.of("ru", "en");
 
   @Override
   public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
@@ -80,8 +83,9 @@ public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingC
 
   /**
    * Преобразует мультиязычное пояснение в одну строку для элемента Designer Explanation.
-   * В формате Designer элемент Explanation не поддерживает мультиязычность, поэтому выводится
-   * первая доступная языковая запись.
+   * В формате Designer элемент Explanation — одно строковое значение, мультиязычность не поддерживается.
+   * Используется подход (A): выбор по предпочтительному порядку локалей — сначала "ru", затем "en",
+   * затем первая доступная запись. Остальные переводы не выводятся.
    */
   private static String explanationToString(MultiLanguageString explanation) {
     if (explanation == null || explanation.isEmpty()) {
@@ -91,6 +95,16 @@ private static String explanationToString(MultiLanguageString explanation) {
     if (content == null || content.isEmpty()) {
       return "";
     }
+    for (var locale : EXPLANATION_LOCALE_ORDER) {
+      var value = content.stream()
+        .filter(e -> locale.equals(e.getLangKey()))
+        .findFirst()
+        .map(e -> e.getValue())
+        .orElse(null);
+      if (value != null && !value.isEmpty()) {
+        return value;
+      }
+    }
     return content.iterator().next().getValue();
   }