Add cachedValueNames parameter to TransferringParametersBetweenClientAndServer diagnostic

[Copilot]

The TransferringParametersBetweenClientAndServer diagnostic flags all server method parameters passed by reference from client methods, even when intentionally used for caching values in client module variables. This creates false positives for common patterns like КэшированныеЗначения in 1C configurations.

Changes

Diagnostic Enhancement

• Added cachedValueNames configuration parameter accepting comma-separated parameter names
• Parameters matching configured names are ignored if a module-level variable with &НаКлиенте directive exists
• Case-insensitive matching to align with BSL language semantics

Implementation

• Traverses AST to locate module variables with compiler directives (RULE_moduleVar)
• Validates presence of AT_CLIENT compiler directive on matching variables
• Maintains existing diagnostic behavior when conditions not met

Documentation & Tests

• Bilingual parameter documentation with usage examples
• Test coverage for variable presence, absence, and incorrect directive scenarios

Example

Configuration:

{
  "TransferringParametersBetweenClientAndServer": {
    "cachedValueNames": "КэшированныеЗначения,КэшДанных"
  }
}

Code with module variable:

&НаКлиенте
Перем КэшированныеЗначения; // механизм кэширования

&НаКлиенте
Процедура ПриИзмененииРеквизита()
    ОбновитьКэш(КэшированныеЗначения);
КонецПроцедуры

&НаСервере
Процедура ОбновитьКэш(КэшированныеЗначения)  // No diagnostic
    КэшированныеЗначения = ПолучитьДанныеНаСервере();
КонецПроцедуры

Without the module variable declaration, the diagnostic fires normally.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[MOD] Кэшируемые значения на клиенте.</issue_title>
<issue_description>## Диагностика
TransferringParametersBetweenClientAndServer

Описание предлагаемых изменений

Предлагаю в диагностику добавить возможность указывать список имен параметров методов, которые можно игнорировать, например КэшированныеЗначения. Дополнительно надо проверять, что в модуле формы есть соответствующая переменная.

&НаКлиенте
Перем КэшированныеЗначения; // используется механизмом обработки изменения реквизитов ТЧ

Если переменная отсутствует, то диагностировать ошибку, по текущему алгоритму диагностики.

Результат

Снизится количество срабатываний диагностики на тех методах, где действительно надо получать данные переменной с сервера на клиент. Не надо будет экранировать методы с общепринятыми переменными, такой как КэшированныеЗначения (используется в типовых конфигурациях).

Сейчас, чтобы не экранировать такой метод, необходимо его размещать в клиент-серверном общем модуле, с дальнейшим вызовом серверного общего модуля.

Дополнительная информация

Comments on the Issue (you are @copilot in this section)

@nixel2007 Интересное предложение, спасибо! @nixel2007 @copilot попробуй реализовать. Для поиска переменной текущего модуля используй symbolTree

• Fixes [MOD] Кэшируемые значения на клиенте. #3577

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}