metadata-tree-visual-style

Instruction file imported from yellow-hammer/vscode-1c-platform-tools (.cursor/rules/metadata-tree-visual-style.mdc). Copyright stays with the author.

Визуальный стиль дерева метаданных

Базовый эталон

• Эталонная иерархия: Конфигурация -> Общее -> Подсистемы -> Подсистема1.
• Корневой узел Конфигурация должен иметь иконку в стиле 1С, без generic ThemeIcon.
• Узлы категорий (Общее, Подсистемы) должны иметь стабильные категорийные иконки без случайных подмен.
• Листовой узел Подсистема1 должен иметь объектную иконку подсистемы, не иконку папки.
• Визуальный акцент — на тексте и иконке; без лишних description, badge, суффиксов.
• Дерево должно оставаться компактным и визуально чистым.

Обязательные требования к реализации в коде

• Для ключевых узлов использовать SVG-иконки через metadataSvgIcon.
• Иконки листьев выбирать через metadataObjectTypeIcon (единая объектная семантика).
• ThemeIcon не использовать как основной стиль для метаданных 1С.
• Не менять порядок базовых групп метаданных ради визуальных экспериментов.
• Единый источник истины для иконок: только маппинг objectType -> svg.
• Для группы/подгруппы сначала определяется репрезентативный objectType (из её листьев или из id -> objectType), затем SVG берется из того же objectType -> svg.
• Прямой маппинг id -> svg не использовать (кроме технических узлов без объектного типа, например корня common).
• Перед любыми решениями по objectType (раскрытие, иконка, резолв XML-пути, проверка поддерживаемости в md-sparrow) обязательно прогонять единый слой нормализации типа (alias -> canonical).
• Не добавлять точечные алиасы в несколько мест сразу; добавлять alias только в один централизованный маппинг нормализации.

Матрица раскрытия узлов

• Подсистемы без вложенных подсистем показывать без значка раскрытия.
• Не раскрывать: CommonModule, SessionParameter, Role, CommonAttribute, EventSubscription, ScheduledJob, Bot, FunctionalOption, FunctionalOptionsParameter, DefinedType, CommonCommand, CommandGroup, CommonForm, CommonPicture, XDTOPackage, WebSocketClient, StyleItem, Style, Language, Constant, DocumentNumerator, Sequence.
• ExchangePlan раскрывать на: Реквизиты, Табличные части, Формы, Команды, Макеты.
• FilterCriterion раскрывать на: Формы, Команды.
• SettingsStorage раскрывать на: Формы, Макеты.
• WebService раскрывать на: Операции.
• HTTPService раскрывать на: Шаблоны URL.
• IntegrationService раскрывать на: Каналы.
• Enum раскрывать на: Значения.
• Для Enum секция Значения не может быть пустой в типовых данных.
• DocumentJournal раскрывать на: Графы, Формы, Команды, Макеты.
• Catalog, Document, Report, DataProcessor, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess раскрывать на: Реквизиты, Табличные части, Формы, Команды, Макеты.
• ChartOfAccounts раскрывать на: Реквизиты, Признаки учета, Признаки учета субконто, Табличные части, Формы, Команды, Макеты.
• InformationRegister, AccumulationRegister, AccountingRegister раскрывать на: Измерения, Ресурсы, Реквизиты, Формы, Команды, Макеты.
• CalculationRegister раскрывать на: Измерения, Ресурсы, Реквизиты, Перерасчеты, Формы, Команды, Макеты.
• Task раскрывать на: Реквизиты адресации, Реквизиты, Табличные части, Формы, Команды, Макеты.
• ExternalDataSource раскрывать на: Таблицы, Кубы, Функции.
• ExternalReport, ExternalDataProcessor раскрывать на: Реквизиты, Табличные части, Формы, Макеты (без секции Команды).
• Реализацию раскрытия выполнять только через md-sparrow (cf-md-object-structure-get и связанные команды).
• В vscode-1c-platform-tools не выполнять ручное чтение, парсинг и редактирование XML (включая дерево метаданных): все XML-операции делать через md-sparrow.
• Если md-sparrow временно не отдает часть структуры, допустимо показать секции по матрице пустыми, но без прямого XML fallback в расширении.

Обязательные требования к SVG-набору

• Все иконки набора должны быть монохромными с темовой заливкой:
  • resources/metadata-tree-icons/*.svg -> fill="#5F6368";
  • resources/metadata-tree-icons/dark/*.svg -> fill="#D3D6DB".
• Для tree view использовать единый отображаемый размер: width="16" и height="16".
• Запрещены встроенные CSS-стили (<style>, классы вида icon-vs-*) и произвольная многоцветность.
• Если используется пара light/dark, геометрия иконки должна оставаться идентичной; тема меняет только цвет.
• При добавлении новой иконки обязательно обновлять обе папки (resources/metadata-tree-icons и resources/metadata-tree-icons/dark) или осознанно использовать fallback на light.

Формат фиксации нового эталона

• Для каждого нового эталонного скрина добавлять отдельный блок ### Эталон N.
• В каждом блоке фиксировать только:
  • структура дерева;
  • визуальные акценты (иконки, выделение, плотность);
  • отличие от текущего дерева расширения;
  • список правок в коде/иконках (не более 3 пунктов).
• Формулировки должны быть техническими и нормативными, без диалогового стиля.