UUID Navigator для VS Code

Расширение для работы с UUID в SQL-файлах: подсветка, навигация и управление связями объектов.

📦 Установка

Магазин VS Code:
Найти "UUID Navigator" в Marketplace и установить.

Вручную (из .vsix):

code --install-extension uuid-navigator-1.9.1.vsix

🚀 Возможности

Основной функционал

Интеллектуальная подсветка UUID с настройкой цветов
Полноценное дерево классов:
- Иерархическое отображение классов/свойств/объектов
- Управление алиасами (ПКМ на класс → "Установить алиас")
- Автоматическая привязка объектов через class_id/алиасы/имена папок
Глубокая навигация:
- Переход к определению из дерева
- Поиск всех вхождений UUID (Ctrl+ЛКМ)
Контекстная информация:
- Подробные tooltip'ы при наведении
- Настраиваемый шаблон отображения

Дополнительные возможности

Автоматическое обновление кэша при изменении SQL-файлов
Поддержка работы с большими проектами (оптимизированный парсинг)
Гибкая настройка отображения информации

Сниппеты

Для перемещения по заглушкам используйте Tab

bmc-class - Добавление класса
bmc-prop - Добавление свойства
bmc-link - Добавление привязки свойства к классу
bmc-main-forms - Добавление формы просмотра, создания и редактирования
bmc-form - Добавление формы, с заданным названием
bmc-grid - Добавление грида
bmc-workflow - Добавление workflow

🛠 Настройки

Откройте Настройки → Расширения → UUID Navigator:

Настройка	По умолчанию	Описание
`highlightColor`	`#569CD6`	Цвет текста UUID
`backgroundColor`	`#64c8ff1a`	Фон UUID (HEX с прозрачностью)
`underline`	`true`	Подчеркивание UUID
`showNotifications`	`false`	Показывать уведомления при поиске
`showBlameOnHover`	`true`	Показывать информацию при наведении
`blameTemplate`	`['type', 'className', 'classUuid', 'classType','uuid', 'propertyName', 'description', 'dataType', 'goToButton']`	Шаблон отображения информации
`cursorPointer`	`true`	Курсор-указатель при наведеннии на uuid
`enableValidation`	`true`	Проверка синтаксиса
`validateJson`	`true`	Проверка синтаксиса json
`ignoreStatus`	`true`	Игнорирование класса `Статусы` при привязке объектов
`ignoreUuid`	`b2d437bc-af8e-4d75-ac25-70f481251233`	UUID класса `Статусы`
`autoLinking`	`true`	Автоматическая привязка специальных свойств ко всем справочным классам
`autoLinking`	`{name: string, uuid: string: classId: string \\| null}`	Перечень свойств для автоматической привязки

Пример настроек

{
  "uuidNavigator.highlightColor": "#C586C0",
  "uuidNavigator.backgroundColor": "#ff69b410",
  "uuidNavigator.underline": false,
  "uuidNavigator.blameTemplate": [
    "type",
    "className",
    "propertyName",
    "goToButton"
  ]
}

🎯 Как пользоваться

Основные команды

Автоподсветка UUID
UUID автоматически выделяются в SQL-файлах.
Навигация по UUID
Нажмите Ctrl+ЛКМ на UUID → откроется список всех его вхождений.
Дерево классов и свойств
Откройте боковую панель "UUID Explorer" для просмотра всех классов и свойств.
Информация при наведении
Наведите курсор на UUID, чтобы увидеть детальную информацию.
Сниппеты
Начните писать bmc... и vscode выдаст предложенные сниппеты

Все команды (Command Palette)

Команда	Назначение
`uuid-navigator.findUuids`	Подсветить UUID в текущем файле
`uuid-navigator.clearHighlights`	Очистить подсветку
`uuid-navigator.refreshBlameCache`	Обновить кэш метаданных
`uuid-navigator.showExplorer`	Показать панель навигации
`uuid-navigator.refreshExplorer`	Перезагрузить дерево классов
`uuid-navigator.insertUuid`	Вставить UUID в редактор
`uuid-navigator.focusTreeView`	Фокус на дерево навигации
`uuid-navigator.goToDefinition`	Перейти к определению
`uuid-navigator.validateCurrentFile`	Проверить текущий файл
`uuid-navigator.showValidatorLogs`	Показать логи валидации
`uuid-navigator.manageClassAliases`	Управление алиасами класса
`uuid-navigator.clearAllAliases`	Очистить все алиасы

Работа с деревом

Вставка UUID - кликните на элемент в дереве для вставки его UUID
Обновление данных - кнопка обновления или команда "Refresh Explorer"
Переход к определению - ПКМ по записи -> Go to definition
Установка alias - ПКМ по записи -> Mange class alias

🔨 Разработка

Клонируйте репозиторий:

git clone https://github.com/eXp3ct/uuid-navigator.git
cd uuid-navigator

Установите зависимости:

yarn install

Запустите в режиме разработки:
Нажмите F5 в VS Code

📜 Лицензия MIT