…переменных

В описаниях переменных, заданных висячим (trailing) комментарием, не работали
два механизма, потому что такие комментарии начинаются не с начала строки.

Семантические токены (BslDocSemanticTokensSupplier): позиции элементов
(типы, имена параметров, ключевые слова) приходят от парсера в абсолютных
координатах файла, но к ним повторно прибавлялся отступ описания (charOffset).
Из-за двойного смещения подсветка типов «съезжала» вправо в любом описании,
которое не начинается со столбца 0 (висячие комментарии и комментарии, ставшие
описанием следующего метода). Теперь обработка строки ведётся в абсолютных
координатах без повторного прибавления отступа.

Document links (SeeReferenceDocumentLinkSupplier): ссылки «См.» из висячего
описания переменной хранятся в отдельном VariableDescription
(getTrailingDescription) и не попадают в getLinks() основного описания,
поэтому кликабельные ссылки не создавались. Теперь висячее описание
обходится явно.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_016DL8j9ZCc6WCiKeL4uMBFs

…писаниях

bsl-parser 0.37.0 отдаёт TYPE_NAME-элемент для типа переменной (нотация
«тип в начале»: первый токен до « - »). Благодаря исправлению координат в
BslDocSemanticTokensSupplier тип теперь корректно подсвечивается и в висячих
(trailing) комментариях, и в ведущих описаниях переменных.

Тесты:
- BslDocSemanticTokensSupplierTest: тип «Строка» в висячем комментарии
  переменной подсвечивается как Type на реальной позиции;
- SemanticTokensProviderTest.variableDescriptionComments: первый токен висячего
  описания теперь трактуется как тип (актуализированы ожидаемые токены).

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_016DL8j9ZCc6WCiKeL4uMBFs

…сли он резолвится

Тип переменной берётся из первого токена описания (нотация «тип в начале»),
поэтому любой свободный текст в висячем комментарии (// трейл, // счётчик ...)
парсер отдаёт TYPE_NAME-элементом. Чтобы не подсвечивать как тип произвольные
слова, BslDocSemanticTokensSupplier теперь проверяет резолв имени через
TypeService и красит элемент как Type только при успешном резолве.

Проверка применяется только к описаниям переменных (ведущим и висячим). Типы
параметров/возврата в описаниях методов задаются структурно и подсвечиваются
без проверки — иначе конфигурационные типы теряли бы подсветку без загруженных
метаданных.

Тесты:
- BslDocSemanticTokensSupplierTest: нерезолвящийся первый токен висячего
  комментария не подсвечивается как тип (остаётся комментарием);
- SemanticTokensProviderTest.variableDescriptionComments: возврат к одному
  токену-комментарию для «// трейл».

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_016DL8j9ZCc6WCiKeL4uMBFs

Добавлена проверка range у document link для типа в висячем комментарии
переменной (помимо target) — страхует корректность координат для trailing-описаний.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_016DL8j9ZCc6WCiKeL4uMBFs

…координат

Вместо восстановления текста типа по координатам элемента описания используются
семантические аксессоры bsl-parser, дающие идентичность типа для резолва:
MethodDescription.getParameters()/getReturnedValue(), VariableDescription.getTypes()
→ TypeDescription.name() (SIMPLE) и CollectionTypeDescription.collectionName()
(COLLECTION, т.к. name() отдаёт полную запись «Массив<Число>»).

Общая логика вынесена в утилиту DescriptionTypes (typesOf/resolveName). Убраны
дублирующиеся помощники извлечения текста по координатам (typeName в
BslDocSemanticTokensSupplier и elementText в TypeDefinitionDocumentLinkSupplier):
- подсветка типа переменной теперь решается по множеству резолвящихся
  диапазонов типов (element().range());
- document link на тип строится по name()/collectionName() и element().range().

Поведение не меняется — тесты подсветки и document link остаются зелёными.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_016DL8j9ZCc6WCiKeL4uMBFs