Merge branch 'develop' into feature/fixes260116

Author: nixel2007

docs/diagnostics/QueryNestedFieldsByDot.md

@@ -9,23 +9,36 @@
 
 ## Примеры
 1. Базовое разыменование ссылочных полей в выборке (во временную таблицу или в результат запроса)
-`ЗаказКлиентаТовары.Ссылка.Организация КАК Организация`
+```bsl
+ЗаказКлиентаТовары.Ссылка.Организация КАК Организация
+```
 2. Разыменование ссылочных полей в соединениях таблиц
-`ВТ_РасчетыСКлиентами КАК ВТ_РасчетыСКлиентами
-     ЛЕВОЕ СОЕДИНЕНИЕ ВТ_ДанныеЗаказовКлиента КАК ВТ_ДанныеЗаказовКлиента
-     ПО ВТ_РасчетыСКлиентами.АналитикаУчетаПоПартнерам.Партнер = ВТ_ДанныеЗаказовКлиента.Партнер`
+```bsl
+ИЗ
+	ВТ_РасчетыСКлиентами КАК ВТ_РасчетыСКлиентами
+		ЛЕВОЕ СОЕДИНЕНИЕ ВТ_ДанныеЗаказовКлиента КАК ВТ_ДанныеЗаказовКлиента
+		ПО ВТ_РасчетыСКлиентами.АналитикаУчетаПоПартнерам.Партнер = ВТ_ДанныеЗаказовКлиента.Партнер
+```
 3. Разыменование ссылочных полей в виртуальных таблицах
-`РегистрНакопления.РасчетыСКлиентами.Обороты(
-			&НачалоПериода,
-				&КонецПериода,
-				,
-				(АналитикаУчетаПоПартнерам.Партнер) В ...`
+```bsl
+ИЗ
+	РегистрНакопления.РасчетыСКлиентами.Обороты(
+		&НачалоПериода,
+		&КонецПериода,
+		,
+		(АналитикаУчетаПоПартнерам.Партнер) В ...
+```
 4. Конструкция "ВЫРАЗИТЬ" с разыменованием получаемого поля
-`ВЫРАЗИТЬ(ВТ_ПланОтгрузок.ДокументПлан КАК Документ.ЗаказКлиента).Валюта.Наценка`
+```bsl
+ВЫРАЗИТЬ(ВТ_ПланОтгрузок.ДокументПлан КАК Документ.ЗаказКлиента).Валюта.Наценка
+```
 5. Разыменование ссылочных полей в секции "ГДЕ"
-`ГДЕ азКлиентаТовары.Ссылка.Дата МЕЖДУ &НачалоПериода И &КонецПериода`
+```bsl
+ГДЕ
+	ЗаказКлиентаТовары.Ссылка.Дата МЕЖДУ &НачалоПериода И &КонецПериода
+```
 
 <!-- В данном разделе приводятся примеры, на которые диагностика срабатывает, а также можно привести пример, как можно исправить ситуацию -->
 
 ## Источники
-Источник: [Разыменование ссылочных полей составного типа в языке запросов] (https://its.1c.ru/db/v8std/content/654/hdoc)
+[Разыменование ссылочных полей составного типа в языке запросов (#std654)](https://its.1c.ru/db/v8std/content/654/hdoc)

src/main/java/com/github/_1c_syntax/bsl/languageserver/context/ServerContext.java

@@ -173,6 +173,30 @@ public DocumentContext getDocument(URI uri) {
     }
   }
 
+  /**
+   * Получить документ по URI без захвата блокировки.
+   * <p>
+   * Этот метод предоставляет прямой доступ к хранилищу документов без синхронизации.
+   * Используйте его только в случаях, когда:
+   * <ul>
+   *   <li>блокировка уже захвачена вызывающим кодом;</li>
+   *   <li>операция только на чтение и допускается eventual consistency;</li>
+   *   <li>критична производительность и накладные расходы на блокировку недопустимы.</li>
+   * </ul>
+   * <p>
+   * <b>Внимание:</b> использование этого метода без внешней синхронизации может привести
+   * к состояниям гонки, если другой поток одновременно модифицирует документ или коллекцию.
+   *
+   * @param uri нормализованный URI документа
+   * @return Контекст документа или {@code null}, если документ не найден
+   * @see #getDocument(URI) безопасная версия с захватом блокировки
+   * @see #getDocumentLock(URI) получение блокировки для внешней синхронизации
+   */
+  @Nullable
+  public DocumentContext getDocumentNoLock(URI uri) {
+    return documents.get(uri);
+  }
+
   /**
    * Получить документ по URI с нормализацией.
    * <p>

src/main/java/com/github/_1c_syntax/bsl/languageserver/references/ReferenceIndex.java

@@ -314,7 +314,7 @@ private SourceDefinedSymbol getFromSymbol(SymbolOccurrence symbolOccurrence) {
     var uri = symbolOccurrence.location().uri();
     var position = symbolOccurrence.location().getStart();
 
-    return Optional.ofNullable(serverContext.getDocument(uri))
+    return Optional.ofNullable(serverContext.getDocumentNoLock(uri))
       .map(DocumentContext::getSymbolTree)
       .map(symbolTree -> symbolTree.getSymbolAtPosition(position))
       .orElseThrow();