Support reference tracking for common module methods

docs/en/features/ConfigurationFile.md

@@ -42,6 +42,8 @@ If there is no configuration file, an attempt will be made to find the ".bsl-lan
 | `traceLog`                                                     |          `String`          | To log all requests *(incoming and outgoing)* between **BSL Language Server** and **Language Client** from used editor/IDE, this parameter sets log file path. The path can set either absolute or relative *(from project root)*, by default the value is not set.<br/><br/>**WARNING**<br/><br/>* When starting **BSL Language Server** overwrites this file <br/>* Speed of interaction between client and server **DRAMATICALLY REDUCED**                                                                                                                          |
 | `configurationRoot`                                            |          `String`          | This parameter is intended to indicate the root directory the 1C configuration files are located in the project directory. It can be useful if there are several configuration directories in the same project directory or when the structure of the project directory is so complex. By default, the parameter is empty and `BSL Language Server` determines the location of the configuration root directory independently                                                                                                                                                                                                                                    |
 | `sendErrors`                                                   |          `String`          | Mode for sending error messages to BSL Language Server developers. More [Monitoring](Monitoring.md).Possible values:<br/>* `ask` - ask permission on every error *(set by default)*. <br/>* `send` - always send error messages.<br/>* `never` - never send error messages.                                                                                                                                                                                                                                                                      |
+| `references`                                                   |       `JSON-Object`        | Contains reference index settings                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| ⤷&nbsp;&nbsp;&nbsp;`commonModuleAccessors`                     |     `Array` `String`      | List of 'Module.Method' patterns for methods returning common module references (e.g. `CommonUse.CommonModule("ModuleName")`). Supports both format with module name (`CommonUse.CommonModule`) and local call (`CommonModule`). By default, includes standard BSL patterns: `ОбщийМодуль`, `CommonModule`, `ОбщегоНазначения.ОбщийМодуль`, `ОбщегоНазначенияКлиент.ОбщийМодуль`, `ОбщегоНазначенияСервер.ОбщийМодуль`, `ОбщегоНазначенияКлиентСервер.ОбщийМодуль`, `ОбщегоНазначенияПовтИсп.ОбщийМодуль` and their English equivalents.                                                                     |
 
 You can use the following JSON schema to make it easier to compile and edit a configuration file:
 

docs/features/ConfigurationFile.md

@@ -46,6 +46,8 @@ BSL Language Server предоставляет возможность измен
 | `traceLog`                                                     |          `Строка`          | Для логирования всех запросов *(входящих и исходящих)* между **BSL Language Server** и **Language Client** из используемого редактора/IDE, в этом параметре можно указать путь к файлу лога. Путь можно указывать как абсолютный, так и относительный *(от корня анализируемого проекта)*, по умолчанию значение не заполнено.<br/><br/>**ВНИМАНИЕ**<br/><br/>* При запуске **BSL Language Server** перезаписывает указанный файл<br/>* Скорость взаимодействия между клиентом и сервером **ЗНАЧИТЕЛЬНО ЗАМЕДЛЯЕТСЯ**                                                                                                                          |
 | `configurationRoot`                                            |          `Строка`          | Данный параметр предназначен для указания корневого каталога, в котором находятся файлы конфигурации 1С в каталоге проекта. Может быть полезен в случае нахождения нескольких каталогов конфигураций в одном каталоге проекта либо при сложной структуре каталога проекта. По умолчанию параметр не заполнен и `BSL Language Server` самостоятельно определяет расположение корневого каталога конфигурации                                                                                                                                                                                                                                    |
 | `sendErrors`                                                   |          `Строка`          | Режим отправки сообщений об ошибках разработчикам BSL Language Server. Подробнее - на странице [Мониторинг и отправка ошибок](Monitoring.md). Возможные значения:<br/>* `ask` - спрашивать разрешение при каждой ошибке *(установлен по умолчанию)*. <br/>* `send` - всегда отправлять сообщения об ошибках. <br/>* `never` - никогда не отправлять сообщения об ошибках.                                                                                                                                                                                                                                                                      |
+| `references`                                                   |       `JSON-Объект`        | Содержит настройки построения индекса ссылок                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| ⤷&nbsp;&nbsp;&nbsp;`commonModuleAccessors`                     |     `Массив` `Строка`      | Список паттернов "Модуль.Метод" для методов, возвращающих ссылку на общий модуль (например, `ОбщегоНазначения.ОбщийМодуль("ИмяМодуля")`). Поддерживается как формат с указанием модуля (`ОбщегоНазначения.ОбщийМодуль`), так и локальный вызов (`ОбщийМодуль`). По умолчанию включает стандартные варианты из БСП: `ОбщийМодуль`, `CommonModule`, `ОбщегоНазначения.ОбщийМодуль`, `ОбщегоНазначенияКлиент.ОбщийМодуль`, `ОбщегоНазначенияСервер.ОбщийМодуль`, `ОбщегоНазначенияКлиентСервер.ОбщийМодуль`, `ОбщегоНазначенияПовтИсп.ОбщийМодуль` и их английские эквиваленты.                                                                     |
 
 Для облегчения составления и редактирования конфигурационного файла можно использовать следующую JSON-схему:
 

src/main/java/com/github/_1c_syntax/bsl/languageserver/configuration/LanguageServerConfiguration.java

@@ -32,6 +32,7 @@
 import com.github._1c_syntax.bsl.languageserver.configuration.documentlink.DocumentLinkOptions;
 import com.github._1c_syntax.bsl.languageserver.configuration.formating.FormattingOptions;
 import com.github._1c_syntax.bsl.languageserver.configuration.inlayhints.InlayHintOptions;
+import com.github._1c_syntax.bsl.languageserver.configuration.references.ReferencesOptions;
 import com.github._1c_syntax.utils.Absolute;
 import org.jspecify.annotations.Nullable;
 import jakarta.annotation.PostConstruct;
@@ -97,6 +98,10 @@ public class LanguageServerConfiguration {
   @Setter(value = AccessLevel.NONE)
   private FormattingOptions formattingOptions = new FormattingOptions();
 
+  @JsonProperty("references")
+  @Setter(value = AccessLevel.NONE)
+  private ReferencesOptions referencesOptions = new ReferencesOptions();
+
   private String siteRoot = "https://1c-syntax.github.io/bsl-language-server";
   private boolean useDevSite;
 
@@ -211,5 +216,6 @@ private void copyPropertiesFrom(LanguageServerConfiguration configuration) {
     PropertyUtils.copyProperties(this.diagnosticsOptions, configuration.diagnosticsOptions);
     PropertyUtils.copyProperties(this.documentLinkOptions, configuration.documentLinkOptions);
     PropertyUtils.copyProperties(this.formattingOptions, configuration.formattingOptions);
+    PropertyUtils.copyProperties(this.referencesOptions, configuration.referencesOptions);
   }
 }

src/main/java/com/github/_1c_syntax/bsl/languageserver/configuration/references/ReferencesOptions.java

@@ -0,0 +1,74 @@
+/*
+ * This file is a part of BSL Language Server.
+ *
+ * Copyright (c) 2018-2025
+ * Alexey Sosnoviy <[email protected]>, Nikita Fedkin <[email protected]> and contributors
+ *
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ *
+ * BSL Language Server is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.0 of the License, or (at your option) any later version.
+ *
+ * BSL Language Server is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with BSL Language Server.
+ */
+package com.github._1c_syntax.bsl.languageserver.configuration.references;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Настройки для построения индекса ссылок.
+ * <p>
+ * Позволяет указать список модулей и методов, возвращающих ссылку на общий модуль
+ * (например, ОбщегоНазначения.ОбщийМодуль("ИмяМодуля")).
+ */
+@Data
+@AllArgsConstructor(onConstructor = @__({@JsonCreator(mode = JsonCreator.Mode.DISABLED)}))
+@NoArgsConstructor
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class ReferencesOptions {
+
+  /**
+   * Список паттернов "Модуль.Метод" для методов, возвращающих ссылку на общий модуль.
+   * <p>
+   * Формат: "ИмяМодуля.ИмяМетода", например:
+   * <ul>
+   *   <li>"ОбщегоНазначения.ОбщийМодуль"</li>
+   *   <li>"ОбщегоНазначенияКлиент.ОбщийМодуль"</li>
+   *   <li>"CommonUse.CommonModule"</li>
+   *   <li>"ОбщийМодуль" - для локального вызова без указания модуля</li>
+   * </ul>
+   * <p>
+   * По умолчанию включает стандартные варианты из БСП.
+   */
+  private List<String> commonModuleAccessors = new ArrayList<>(List.of(
+    // Локальный вызов
+    "ОбщийМодуль",
+    "CommonModule",
+    // Стандартные модули БСП
+    "ОбщегоНазначения.ОбщийМодуль",
+    "ОбщегоНазначенияКлиент.ОбщийМодуль",
+    "ОбщегоНазначенияСервер.ОбщийМодуль",
+    "ОбщегоНазначенияКлиентСервер.ОбщийМодуль",
+    "ОбщегоНазначенияПовтИсп.ОбщийМодуль",
+    // Английские варианты
+    "CommonUse.CommonModule",
+    "CommonUseClient.CommonModule",
+    "CommonUseServer.CommonModule",
+    "CommonUseClientServer.CommonModule"
+  ));
+}

src/main/java/com/github/_1c_syntax/bsl/languageserver/configuration/references/package-info.java

@@ -0,0 +1,28 @@
+/*
+ * This file is a part of BSL Language Server.
+ *
+ * Copyright (c) 2018-2025
+ * Alexey Sosnoviy <[email protected]>, Nikita Fedkin <[email protected]> and contributors
+ *
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ *
+ * BSL Language Server is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.0 of the License, or (at your option) any later version.
+ *
+ * BSL Language Server is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with BSL Language Server.
+ */
+/**
+ * Пакет содержит настройки для построения индекса ссылок.
+ */
+@NullMarked
+package com.github._1c_syntax.bsl.languageserver.configuration.references;
+
+import org.jspecify.annotations.NullMarked;