Представление Aggrega
Граф топологии открывается в отдельной панели, описанной в разделе Граф топологии, а команды, которые запускают кнопки панели Commands, описаны в разделе Команды.
Представление Aggrega на панели действий — четыре панели в порядке чтения: Commands, Registries, Catalog и Plugins. Остальные три перечисляют то, что содержат ваша конфигурация и рабочая область, и каждая начинается с операций, действующих на перечисленное в ней, в виде подписанных строк в начале списка; любая другая операция — это подписанная кнопка на панели Commands, так что у каждой операции есть одно место, где её искать. Операция, действующая на конкретный реестр, сущность или плагин, находится в его строке.
Панель Commands начинается с трёх однострочных строк, указывающих, с чем работает редактор, — Project folder, затем Aggrega workspace, затем Release, — и каждая открывает собственный список выбора. Средняя строка показывает своё название сокращённо, как Agg. worksp., чтобы значению каждой строки доставалось больше ширины панели; её всплывающая подсказка даёт название полностью, как Aggrega workspace, и так же поступает каждое сообщение о ней. Их значения стоят в одном столбце, после самой широкой из трёх меток; в панели, слишком узкой для этой метки, она обрезается многоточием, а не раздвигает панель в сторону, и подсказка строки по-прежнему говорит, какая это строка. Они стоят в таком порядке, потому что каждая находится внутри вышестоящей, и само расположение это показывает, а не объясняет. Средняя строка сохраняет название продукта, сокращённое или нет, потому что «рабочая область» сама по себе уже обозначает набор папок, открытых в вашем окне. Строка Aggrega workspace называет папку, к которой привязался языковой сервер и относительно которой вычисляется список сущностей Release; наведение на неё показывает полный путь и, если он отличается от открытой вами папки, называет и её — так вы можете выяснить, почему предлагаемые Releases именно такие. Если в вашем окне открыта ровно одна папка, подсказка строки Project folder сообщает, что она единственная, вместо того чтобы предоставить вам открыть список из одного элемента, и завершается тем, что там предлагает щелчок по строке, — открыть папку или добавить папку в окно, — а если не выбрана ни одна сущность Release и ещё ничто не прочитало, что предлагает эта рабочая область Aggrega, подсказка сообщает именно это, а не гадает. Если уровень ничего не содержит, подсказка называет способ выйти из этого состояния, а не предлагает выбрать: ничего не выбрано и нечего выбирать читаются по-разному, потому что лишь первое — решение, ожидающее вас. На проект без рабочей области Aggrega отвечают, открыв папку, которая её содержит, или создав новую; на рабочую область Aggrega без единой сущности Release — работая в другой или создав черновик сущности Release.

У строк Aggrega workspace и Release справа есть по +, рядом со строкой, а не на ней: нажатие на строку позволяет выбрать среди существующих, а нажатие на + открывает путь к созданию новой. + строки Release открывает тот же процесс создания черновика, что и Draft entity в начале панели Catalog, с уже заданным видом: он запрашивает только имя, а запрос сообщает, что задаёт имя сущности Release. У строки Project folder такого нет — создание папки проекта является делом вашего редактора, а не Aggrega.
Если ваша рабочая область Aggrega не совпадает с открытой вами папкой — находится выше этой папки или внутри неё, — у строки Aggrega workspace есть ещё один элемент управления, который открывает эту рабочую область как папку проекта. Он предлагается, а не выполняется за вас, и его название говорит, чего это стоит, а также куда ведёт: открытие папки перезагружает окно, поэтому языковой сервер и это расширение перезапускаются, а всё несохранённое в окне пропадает вместе с ними. Если открытая вами папка сама является рабочей областью Aggrega, открывать нечего, и элемент управления не отображается.
Когда окно открывается для папки, рабочая область Aggrega которой находится вне её — не является самой папкой и не находится внутри неё, — редактор также сообщает об этом в диалоговом окне, которое вы закрываете, прежде чем продолжить: оно начинается с Aggrega is using a workspace from outside the folder you opened., а под этим содержит строку Aggrega workspace: и строку Project folder: с полным путём к каждой. Его кнопки: Open workspace (reloads the window), которая открывает рабочую область Aggrega как папку проекта точно так же, как собственный элемент управления строки; Continue here, которая закрывает диалоговое окно и ничего не меняет; и Don’t show again for this folder. Закрытие диалогового окна любым другим способом — клавишей Escape или его собственным элементом закрытия — равнозначно Continue here. Диалоговое окно появляется один раз для папки в каждом окне и снова, если меняется рабочая область Aggrega, к которой относится эта папка; после Continue here оно не появляется, пока окно не будет перезагружено или открыто снова, а затем возвращается. Don’t show again for this folder запоминается для этого окна и восстанавливается, когда вы открываете его снова, поэтому диалоговое окно для этой папки не возвращается. Ни одна из трёх кнопок не отменяет сам факт: пока рабочая область находится вне вашей папки, у строки Aggrega workspace справа от значения стоит предупреждающий знак, а наведение на строку показывает тот же заголовок и те же два пути, что и диалоговое окно. Рабочая область Aggrega внутри открытой вами папки не находится вне её, поэтому не вызывает диалогового окна, и у её строки нет ни знака, ни такого заголовка; наведение на строку по-прежнему называет открытую вами папку, а элемент управления, открывающий рабочую область как папку проекта, по-прежнему отображается.
Диалоговое окно отрисовывает ваша операционная система, если только параметр редактора window.dialogStyle не имеет значения custom, поэтому по умолчанию оно следует теме вашего рабочего стола, а не редактора, и никакое расширение не может изменить его вид; если window.dialogStyle имеет значение custom, редактор отрисовывает его в собственной теме.
Щелчок по строке Aggrega workspace открывает выбор независимо от того, к чему вы подключены, даже если это одна рабочая область или ни одной: список выбора перечисляет рабочие области Aggrega, достижимые из папки Project folder, — поднимаясь от неё вверх и просматривая всё, что в ней находится, — каждую под именем её собственного корня, а последним — способ добраться до папки, которая в вашем окне вообще не открыта: Choose another folder Aggrega recognises… или Choose a folder Aggrega recognises…, если списку выбора нечего перечислить. Этот последний пункт есть потому, что достижимость ограничена тем, что содержит ваше окно: редактор ищет только в открытых вами папках, поэтому рабочая область, расположенная в другом месте, достижима добавлением её папки и ничем более коротким. Языковой сервер запускается, как только подъём вверх нашёл, откуда начать, не дожидаясь окончания этого поиска, поэтому окно может подключиться и лишь мгновением позже сообщить, что достижима вторая рабочая область, — список выбора догоняет, когда поиск возвращает результат. Рабочая область Aggrega, в которой это окно работало последней, тоже сразу берётся снова, включая выбранную внутри папки Project folder, потому что редактор опрашивает собственный маркер этой рабочей области, а не ждёт поиска; лишь когда маркер исчез или больше не отмечает рабочую область, достижимую из папки Project folder, выбор отбрасывается, и вам об этом сообщают. Выбор другого пункта переносит туда языковой сервер и сообщает об этом, достигнут ли он из той же папки, что и используемый, или из другой, а выбор уже используемого пункта ничего не перезапускает и сообщает, где редактор уже работает: Aggrega: the editor already works in ⟨path⟩., с полным путём к корню рабочей области. Одна рабочая область Aggrega, достижимая одновременно из двух открытых папок, — это один пункт, и считается она за один: обнаружение поднимается вверх, поэтому корень уровнем выше отвечает за каждую папку под ним, а вопрос о том, какая из этих папок содержит рабочую область, имел бы два верных ответа.
Щелчок по строке Project folder открывает такой же выбор: папки, открытые в окне, каждая названа собственным путём, и в конце два способа добраться до папки, которой в окне нет. Open folder… запрашивает папку через диалог выбора папок редактора, кнопка которого называется Open, и открывает выбранную папку в этом окне вместо того, что в нём открыто, так же, как это делает собственная команда Open Folder редактора. Это перезагружает окно, о чём описание пункта сообщает заранее, а если редактор не может открыть папку, вам об этом сообщают. Add folder to this window… запрашивает так же, с кнопкой Add, и добавляет выбранную папку в окно, после уже открытых, как папку, от которой работает редактор: вы выбрали её в этой строке, поэтому строка называет её, а не спрашивает вас снова, и предлагаемые рабочие пространства Aggrega — это те, которых она достигает. В окне, уже открытом на файле рабочего пространства, папка присоединяется к нему на месте, и вам сообщают, что редактор теперь работает от неё. Папка, уже открытая в окне, повторно не добавляется, и вам об этом сообщают; если редактор отклоняет папку, вам сообщают и об этом, а редактор продолжает работать от прежней папки. Закрытие любого из диалогов без выбора ничего не меняет.
Добавление папки в окно с одной папкой или без папок превращает окно в рабочее пространство с несколькими корнями, чего редактор добивается перезапуском своих расширений — включая это — или, в удалённом окне, например dev container, перезагрузкой окна. Если при перезапуске расширений была открыта страница приветствия, она перерисовывается на своём месте, так что в окне по-прежнему одна страница, и она отражает окно в его нынешнем виде. И Add folder to this window…, и последний пункт средства выбора рабочего пространства Aggrega завершаются таким добавлением, поэтому там, где выбор любого из них приведёт к этому, его описание сообщает об этом заранее. Это рабочее пространство ново для редактора и начинает без того, что помнило покинутое окно, за исключением единственного ответа, данного самим добавлением: папка, добавленная через Add folder to this window…, является там Project folder, а рабочее пространство Aggrega, выбранное через последний пункт средства выбора рабочего пространства Aggrega или через Use a folder that already has one на странице приветствия, является там рабочим пространством Aggrega. Выбранная вами сущность Release, а также папки, для которых вы попросили диалог больше не показываться, остаются с покинутым окном.
Ваш выбор запоминается для этого окна и восстанавливается при его повторном открытии, и он определяет, что предлагает строка ниже, — предлагаемые рабочие пространства Aggrega — это те, которых достигает эта папка. Достигать — не то же самое, что содержать: поскольку обнаружение идёт вверх, рабочее пространство, которого достигает папка, часто является папкой над ней, так что выбор подкаталога вашего репозитория всё равно предлагает рабочее пространство самого репозитория. Когда открыта одна папка, выбирать нечего, и строка просто называет её. Когда открыто несколько и ни одна не выбрана, строка показывает none selected, а предлагаемые рабочие пространства Aggrega — это те, которых достигает всё окно. Если такое одно или если одно из них — то, в котором это окно работало последним, языковой сервер запускается там; если их несколько и ни одно не запомнено, он не запускается, пока вы не выберете одно, а Choose Aggrega workspace… в строке состояния и уведомление просят вас это сделать. Языковой сервер, который сам останавливается или не может запуститься, оставляет строку Project folder с названием вашей папки — ваше рабочее пространство по-прежнему выбрано, а о состоянии сервера сообщает индикатор языкового сервера.
Под этими строками операции сгруппированы по тому, что вы пришли сделать: Build (validate, lint, build, preview, graph), Dependencies (pull), Author (import, inspect), Publish (push, sign, deprecate) и Configuration (show config, cache).
Рядом с Commands расположены панель Registries, которую открывают Add registry и Update index и которая перечисляет каждый реестр, объявленный действующей конфигурацией; панель Catalog, которую открывают Search catalog и Draft entity и которая перечисляет сущности, видимые рабочему пространству; и панель Plugins, которую открывают Add plugin и Generate entities и которая перечисляет встроенные и настроенные плагины Wasm. Эти первые строки являются частью собственного списка панели: у каждой есть подпись и значок, поэтому она видна без наведения на что-либо, нажатие запускает операцию, а сворачивание панели сворачивает её вместе с остальным. Они присутствуют, что бы ни показывал список под ними, — в том числе когда он сообщает, что ничего не настроено, то есть именно тогда, когда вы пришли добавить первый элемент, и когда он сообщает, что ни одно рабочее пространство Aggrega недоступно. Если какая-то строка ещё не может выполниться, она остаётся на месте и объясняет причину рядом со своим названием теми же словами, которыми панель Commands описывает то же состояние, а нажатие на неё ничего не запускает. Каждая из этих трёх панелей также имеет в строке заголовка кнопку обновления, которая перечитывает этот один список, и ничего больше — операция там была бы значком без подписи, который пришлось бы искать наведением. Validate, build, preview build и lint сообщают результаты на панель Problems; операции на основе командной строки передают свой вывод потоком в канал вывода Aggrega.

Панель Commands
-
Одно место настроек, открываемое шестерёнкой — в правом верхнем углу панели Commands есть шестерёнка, которая открывает собственные настройки редактора, отфильтрованные по этому расширению. Второй страницы настроек у самого расширения нет, поэтому у каждого параметра одно место, где он находится, и одно место, где он записан. Каждый параметр принадлежит вам, а не проекту; см. Настройки.
-
Два вида панели Commands —
aggrega.operations.layoutвыбирает междуbuttons, значением по умолчанию, где каждая операция — подписанная кнопка в одном непрерывном потоке совсем без заголовков групп, иsections, где каждая группа — раздел, который открывается под своим заголовком, и панель показывает столько, сколько вы держите открытым. Оба вида содержат одни и те же группы с одними и теми же операциями в одном и том же порядке; параметр меняет то, как рисуется группа, и никогда не меняет набор операций. В обоих видах строки Project folder, Aggrega workspace и Release стоят над всеми операциями, поэтому закрытие раздела никогда не убирает сведения о том, к чему применится операция. Вsectionsстрелка рядом с Build — отдельная строка под ним с надписью Build options перед шевроном, поэтому она не читается как раздел, который нужно открыть. Изменение параметра перерисовывает открытую панель и ничего не перезапускает. Панель Commands открывается с большей долей боковой панели, чем три панели рядом с ней, — в окне высотой 900 пикселей достаточной, чтобы показать весь её поток при ширине боковой панели по умолчанию; с этого момента редактор сохраняет высоты панелей для каждой рабочей области, поэтому рабочая область, боковая панель которой уже была расположена раньше, сохраняет прежние высоты. -
Кнопка, предлагающая выбор, показывает его рядом с собой — операция, которая в ответ на нажатие спрашивает, к какому элементу или какой сущности применяться, показывает этот выбор в меню рядом с нажатой кнопкой, а не в диалоге на всё окно: Cache… предлагает четыре операции с кешем, а Inspect и Push — сущности, видимые рабочей области. Меню открывается под кнопкой или над ней, с той стороны, где у панели больше места, и не выше этого места, поэтому никогда не выходит за край панели — список длиннее этого места прокручивается внутри меню, — а его название, то есть что выбирается, остаётся вверху при прокрутке. Так происходит, где бы ни находилась панель, в том числе если она закреплена в невысокой боковой панели. До меню можно добраться только нажатием кнопки и никогда — клавишей Tab, поэтому панель по-прежнему занимает одну остановку фокуса, сколько бы меню в ней ни было. Внутри меню клавиши со стрелками перемещают между вариантами, а Enter выбирает текущий; ввод сужает список — совпадением считается фрагмент названия варианта или строки под ним, и меню сообщает, сколько осталось, — Backspace отменяет введённое, Escape закрывает меню и возвращает фокус на кнопку, а нажатие в любом другом месте — на панели или где-либо ещё в редакторе — закрывает его, ничего не запуская. Те же операции есть в индексе команд редактора, где нет кнопки, рядом с которой могло бы открыться меню, поэтому при вызове оттуда каждая задаёт свой вопрос в виде списка для выбора.

-
Меню, варианты которого запрашиваются, сообщает, что идёт чтение — меню, которые открывают Inspect и Push, пусты, пока языковой сервер не ответит, какие сущности содержит рабочая область, а это чтение показывает ход выполнения и может быть остановлено. Оба открываются со строкой о том, что идёт чтение, и заполняются, когда приходит ответ, а не открываются пустыми: пустой список вариантов читается как ничего нет, а это иной ответ, чем подождите. Всё, что вы ввели, пока шло чтение, по-прежнему применяется, когда варианты приходят. Если предложить нечего — нет сущности, которую операция может назвать, — меню закрывается, и об этом говорит сообщение, то же, что вы получаете, запуская операцию из индекса команд, вместо пустого меню.
-
Выбор и согласие остаются разными действиями — меню — это место, где вы говорите, что именно, и оно никогда не содержит подтверждения. Три операции с кешем, которые что-то удаляют, по-прежнему показывают модальное подтверждение после вашего выбора, называя кеши, которые затрагивает операция, а генерация сущностей Plugin по-прежнему запрашивает подтверждение перед записью. Подтверждение оправдывает прерывание: если встроить его во встроенный список, случайный щелчок мог бы очистить кеш. Поиск по опубликованному каталогу сохраняет свой список фильтров, к которому вы возвращаетесь после редактирования каждого аспекта, потому что меню плохо подходит для того, во что входят заново после каждого ответа.
-
Что отделяет одну группу от другой в каждом виде — в потоке между группами ничего не рисуется: группы определяют порядок, в котором идут кнопки, и только порядок передаёт группировку, поэтому панель не тратит ширину на разделитель. В виде с разделами над группой Publish проведена линия, потому что её операции меняют то, что получает каждый, кто разрешает этот каталог, тогда как остальные действуют на этой машине, — это различие по сути, которое стоит отметить один раз и для отметки которого есть рамка группы.
-
Узкая панель переносит строки, а не обрезает и не прокручивает вбок — поток занимает столько строк, сколько требует ширина, и ни один перенос не закреплён: расширьте панель, и кнопки перераспределятся на меньшее число строк. Подпись каждой кнопки — только название операции, а пояснение — в подсказке при наведении, поэтому строка вмещает столько операций, сколько может. Ничего не скрыто за боковым жестом, и ни одна подпись не обрезана.
-
Каждая операция запрашивает необходимое до запуска — операция, которую панель считает невыполнимой, остаётся на месте, отображается серым и объясняет причину: при наведении называется, чего не хватает, а программа чтения с экрана объявляет её недоступной с той же причиной. Она не удаляется, потому что в потоке кнопок удаление одной сдвигает остальные под ваш указатель, и нажатие приходится не на то, что было там мгновение назад, — по этой же причине стрелка рядом с Build остаётся рядом с ним, пока Build не может выполниться, становится серой вместе с ним, сообщает ту же причину и ничего не открывает. Элемент управления становится серым при двух условиях: операциям, действующим на сущность Release, нужна выбранная сущность Release, а операциям, запускающим исполняемый файл
aggrega, нужна привязанная папка рабочей области для запуска. Операция, которой нужен только языковой сервер, не становится серой, когда сервер не работает, — при нажатии она сообщает собственное сообщение компилятора, а это состояние называет строка состояния. Отправка, подпись и пометка устаревшим сначала спрашивают свой объект: отправка предлагает сущности из списка панели Catalog, у которых есть документ в рабочей области, а подпись и пометка устаревшим запрашивают ссылку на артефакт, уже находящийся в реестре, потому что именно его эти две операции изменяют. Пометка устаревшим также запрашивает уровень серьёзности и причину, которые требует компилятор и которые он не может запросить у вас изнутри редактора. Получение выполняется для выбранной сущности Release, а не запрашивает объект. Операции в начале панелей Registries, Catalog и Plugins спрашивают так же: добавление реестра запрашивает хост и файл конфигурации, в который его записать, добавление плагина задаёт два или три вопроса, нужных для его типа, генерация сущностей Plugin спрашивает, что охватить и куда записать, поиск по опубликованному каталогу открывает список фильтров, который вы составляете перед запуском, а создание черновика сущности спрашивает вид, а затем имя. Каждой из них, кроме Draft entity, нужна привязанная папка рабочей области, поэтому без неё каждая такая строка сообщает об этом рядом со своим названием, и нажатие на неё ничего не запускает, — вы узнаёте это до того, как на что-либо ответите, а не после. Draft entity нужен только языковой сервер, поэтому он никогда не отображается как невыполнимый.
Панели реестров, каталога и Plugins
-
Подробности панели реестров — каждая строка указывает хост реестра, его псевдоним, если он настроен, какой реестр используется по умолчанию, требуются ли подписи для артефактов, получаемых из него, и есть ли учётные данные для этого хоста. Чтение списка не обращается ни к одному реестру: состояние учётных данных сообщает только об их наличии, поэтому оно говорит, что учётные данные существуют, а не что реестр их примет.
Операции, действующие на весь набор, — это первые две строки панели — Добавить реестр и Обновить индекс, которая обновляет индекс для поиска каждого настроенного реестра, — тогда как операции, действующие на один реестр, находятся в строке этого реестра: обновить индекс только для него, удалить сохранённые учётные данные и удалить реестр. Строка заголовка самой панели содержит только обновление.
Добавление реестра и его удаление спрашивают, какой файл конфигурации изменить, и первым предлагают глобальный файл, общий для всех проектов на этой машине, поскольку именно туда эти две операции записывают, если вы не укажете иное; другой вариант — собственный файл конфигурации этого проекта. Каждая из двух завершается указанием файла, который она фактически изменила, и того, насколько далеко распространяется действие этого файла, — по тому, что сделал компилятор, а не по тому, что было запрошено. Языковой сервер читает свою конфигурацию при запуске, поэтому за каждой из двух без запроса следует перезапуск языкового сервера, а панель и шаг реестров на странице приветствия читаются заново, как только он снова доступен: добавленный реестр появляется в списке, а удалённый исчезает, без перезагрузки и обновления. Как только перезапущенный сервер прочитал изменение, завершающее сообщение добавляет, что изменение теперь действует; если перезапуск не удался, оно этого не добавляет, поскольку тогда изменение есть в файле, но ещё не действует.
Удаление реестра и удаление учётных данных сначала запрашивают подтверждение, и каждое сообщает, на что влияет изменение: подтверждение для реестра называет выбранный вами файл, поэтому удаление записи из глобального файла описывается как затрагивающее каждый проект, выполняющий разрешение через него, а удаление записи из собственного файла этого проекта — как не затрагивающее ни один другой проект, тогда как учётные данные удаляются из общего хранилища учётных данных, а запись реестра остаётся на месте. Удаление учётных данных не предлагает выбора файла, поскольку хранилище учётных данных общее для всех проектов на машине и не имеет отдельной формы для проекта, в которую можно было бы записать.
Построение индекса показывает ход выполнения и может быть остановлено, и это единственная из этих операций, предлагаемая с кнопкой «Отмена». Её нажатие завершает сам обход, а не только ожидание редактора, и построение завершается сообщением о том, что оно было остановлено. Данные каждого реестра записываются только после завершения его собственного обхода, поэтому остановленное построение оставляет проиндексированными реестры, обход которых завершился, а реестр, который обходился, сохраняет прежний индекс без изменений — так что это остановка, а не отмена изменений. Построение, дошедшее до конца, называет, сколько сущностей проиндексировано из скольких реестров, и директорию, в которую записан индекс, — именно это показывает, что обновление не меняет ничего, через что выполняет разрешение другой проект на этой машине, — а реестр, который не удалось проиндексировать, называется вместе с собственной причиной компилятора: о реестре, к которому не удалось подключиться, сказано, что он недоступен, — Не удалось подключиться к ⟨реестр⟩: перед этой причиной, — а о реестре, который ответил, но завершился неудачей иначе, например о таком, чей список репозиториев повторялся, что завершает обход этого реестра вместо повторного прохождения по кругу, пока остальные реестры продолжают индексироваться, сказано, что его не удалось проиндексировать; заключительное предложение называет две группы раздельно. Обновление индекса одного недоступного реестра завершается так же, называя его недоступным.
Добавление реестра тоже обращается к сети, поскольку получает политику доверия, которую объявляет реестр, и предлагается без кнопки «Отмена»; в любом случае оно завершается указанием записанного файла. Реестр, к которому не удалось подключиться, в этом завершающем сообщении назван недоступным, перед собственной причиной компилятора, вместо утверждения, что он не объявляет никакой политики — включая официальный хаб, запись которого тогда содержит его встроенную базовую конфигурацию. Если реестр, отличный от официального хаба, не объявляет политику доверия или к нему не удалось подключиться — либо, когда рабочее пространство в автономном режиме, он отклонён, потому что ни одну политику не удалось получить, — за завершающим сообщением следует вопрос с предложением закрепить политику вручную, ровно с тем, что в этом случае принимают
--identityи--keyкомандной строки: бесключевые идентичности, каждая записывается какidentity=issuerи вводится по одной, файл открытого ключа, выбранный в диалоговом окне файлов, оба варианта или ни одного. Указанное вами повторно регистрируется для того же хоста в том же файле, и это завершающее сообщение говорит, какой тип политики теперь содержит запись, не повторяя идентичностей или файла; неправильно сформированная идентичность или файл ключа, который не удаётся прочитать или который не является открытым ключом, завершается собственным отказом компилятора. Отказ для файла, который не является открытым ключом, называет, что ожидал компилятор, и не приводит содержимого файла, так что выбранный по ошибке закрытый ключ не появляется ни в уведомлении, ни в канале вывода Aggrega. Нажатие Escape в любом из этих запросов или выбор варианта «Ни одного» ничего не закрепляет, и действует то, что оставляет командная строка, когда не задан ни один из двух флагов. Реестру, объявленная политика которого закреплена, и официальному хабу с его встроенной базовой конфигурацией этот вопрос не задаётся.Удаление реестра, удаление учётных данных и чтение списка не обращаются ни к одному реестру. Вход в реестр на панели не предлагается, поскольку команда считывает пароль из терминала, а за кнопкой терминала нет — выполните её в терминале и нажмите обновление.
-
Подробности панели каталога — сущности, видимые рабочему пространству, сгруппированные под заголовком для каждого вида; каждая строка называет сущность и объявленные ею метки, а её apiVersion и описание приведены во всплывающей подсказке. Строки поступают из двух мест, и каждая указывает, из какого. Сущность, объявленная документом в рабочем пространстве, содержит во всплывающей подсказке путь к этому документу, а щелчок по строке открывает этот файл. Сущность, разрешённая из директории каталога, — директории
catalog/в корне рабочего пространства и тех, которые ваша конфигурация называет для выбранной сущности Release вworkspace.releasesили, если для неё не названо ни одной либо ни одна не выбрана, для всего рабочего пространства вworkspace.catalog_dirs, — помечена как происходящая оттуда и не содержит пути: в рабочем пространстве нет собственного файла для неё, поэтому строка называет её происхождение вместо того, чтобы предлагать щелчок, который никуда не ведёт.Список относится к выбранной сущности Release: документ в директории, которую ваша конфигурация называет только для других сущностей Releases, в него не входит, поэтому, когда каждая сущность Release читает вариант одной сущности из собственной директории, панель показывает только вариант выбранной сущности Release. Если ни одна сущность Release не выбрана, показывается каждый документ рабочего пространства. Документ, который не объявляет
kind:илиmetadata.name:, не показывается, и именно это сохраняет панель индексом сущностей, а не файлов.Языковой сервер не читает ни одной сущности через ссылку, ведущую за пределы рабочего пространства, — ссылку на директорию вне его или ссылку с именем YAML-файла, ведущую к файлу вне его, — поэтому ни одна сущность за такой ссылкой не попадает в список, хотя дерево файлов вашего редактора её показывает. Единственное исключение — сущность Release, которую называет конфигурация вашего рабочего пространства как
build.authoring_releaseили как ключworkspace.releases: она читается через свою ссылку и показывается в списке на месте самой ссылки. Когда список пропускает такую ссылку, об этом сообщает отдельная строка после списка: Сущности, достижимые по этой ссылке, не показаны, так как она ведёт за пределы рабочего пространства Aggrega:, а за ней — путь ссылки относительно рабочего пространства, или Сущности, достижимые по этим ссылкам, не показаны, так как каждая из них ведёт за пределы рабочего пространства Aggrega: для нескольких, причём сначала названы ссылки на директории, а затем ссылки на файлы. При наведении указателя на строку появляется всё предложение, так как длинный путь в строке обрезается. Когда выбрана сущность Release, ссылка внутри директории каталога, которую читают только другие Releases, не называется, поскольку за ней в любом случае ничего не было бы показано для этой сущности Release.Список — это собственный ответ языкового сервера, поэтому он называет те же сущности, которые читает компилятор, — включая несохранённые буферы редактора, имеющие приоритет над байтами на диске, — и выводится в том порядке, в котором его отправил сервер, а не пересортировывается здесь. Панель сама перечитывает список, когда языковой сервер становится способен отвечать, когда меняется выбранная сущность Release, когда документ
.yamlв папке, открытой в окне, создаётся, изменяется или удаляется на диске — редактором, терминалом или checkout одинаково, — и когда редактор закрывает YAML-документ. Она запрашивает список только после того, как языковой сервер отбросил то, что хранил для этого файла, поэтому файл, удалённый, пока он был открыт в редакторе, исчезает из списка, а не показывается по копии, которую редактор отправил последней, документ, переименованный в буфере и закрытый без сохранения, снова показывается таким, каким он есть на диске, а серия таких изменений и закрытий — это одно чтение. Редактор закрывает документ, когда отпускает его, и не обещает делать это в момент закрытия вкладки документа, поэтому строка, полученная из текста документа, вкладка которого закрыта, может оставаться, пока редактор этого не сделает. Панель сама не следит за вашим вводом. Изменение, которое ещё находится в несохранённом буфере, отправляется языковому серверу, как только вы сделаете паузу во вводе в этом документе, — каждый открытый документ выжидает собственную паузу, поэтому ввод в одном никогда не задерживает другой, — и появляется при следующем чтении списка после этого. Нажатие кнопки обновления панели читает список для каждого открытого документа таким, каким его держит редактор в момент нажатия, как бы скоро это ни было после последнего нажатия клавиши или отмены: ещё не отправленное изменение отправляется сразу, а список запрашивается только после того, как языковой сервер ответил на каждое изменение, отправленное ему до нажатия. Папка, удалённая целиком, отражается при следующем чтении списка или при нажатии обновления, так как редактор может сообщить об этом как об одном изменении папки, а не об изменении каждого документа в ней.Поиск в опубликованном каталоге — это первая строка этой панели, Search catalog: он запрашивает фильтр и копирует ссылку на то, что вы выберете. Создание черновика новой сущности — это вторая строка, Draft entity: она запрашивает вид в виде списка для выбора и открывает начальный документ во вкладке, ничего не записывая на диск. Заголовок самой панели содержит только кнопку обновления. Операции, действующие на одну сущность, находятся в строке этой сущности, и строка предлагает операцию только там, где компилятор принимает её для вида этой строки. Какие виды принимает каждая операция — это собственный ответ языкового сервера, который каждый раз перечитывается вместе со списком, поэтому строки следуют за компилятором, который вы запускаете, а не за списком, хранящимся в расширении. Просмотр того, во что разрешается сущность, — единственная операция, доступная без открытия меню строки: она обращается к сущности по имени, которое есть в каждой строке, поэтому её предлагают в строке независимо от того, содержит ли рабочее пространство документ для неё, везде, где компилятор разрешает имя в сущность этого вида, и она ничего не меняет.
Валидация сущности, проверка её соглашений о публикации и её публикация требуют пути сущности, поэтому они предлагаются только в строке, сущность которой объявлена документом в этом рабочем пространстве; у строки, разрешённой из настроенной директории каталога, нет в этом рабочем пространстве пути, который можно было бы им передать, и в ней они не предлагаются, вместо того чтобы предлагаться как элементы управления, способные лишь сообщить об отсутствующем аргументе. Из этих трёх проверка соглашений о публикации предлагается в каждой такой строке. Валидация предлагается там, где компилятор проверяет документ этого вида самостоятельно: например, сущность Aggregate проверяется вместе со всем каталогом, когда она находится в директории каталога, и вместе с сущностью Release, которая её развёртывает, поэтому её строка не предлагает валидации. Валидация проверяет сущность в условиях выбранной сущности Release, как это делает
aggrega validate <path> --release <Release>в терминале, поэтому то, на что ссылается сущность, — сущность Component, которую реализует сущность Recipe, библиотека, которую компонует её схема, — разрешается через директории каталога, с которыми собирается эта сущность Release; если никакая сущность Release не выбрана — через директории самого рабочего пространства. Публикация предлагается там, где документ этого вида публикуется самостоятельно, что исключает сущность Plugin, публикация которой также привязывает её исполняемый файл, и сущности Manifest или Release, ни одна из которых не публикуется. Если языковой сервер не сообщает, какие операции принимают вид строки, строки всё равно показываются, а строка с документом предлагает только проверку соглашений; если запрос на этот ответ завершается ошибкой, его причина записывается в канал вывода Aggrega.Публикация сначала просит подтверждения и сообщает, куда распространяется изменение: сущность упаковывается и отправляется под своей собственной объявленной версией, и любой, кто получает эту версию из этого реестра, разрешает то, что опубликовано. Публикация также единственная из этих операций, которая меняет что-либо за пределами этой машины; две проверки и просмотр ничего не записывают и ничего не публикуют. Все четыре показывают ход выполнения и могут быть остановлены.
-
Подробности панели Plugins — каждая строка называет плагин, его тип и версию, а также его готовность, если плагин её сообщает. Плагин, который компилятор не смог разрешить или описать, помечается и сохраняет собственную строку с сообщением компилятора во всплывающей подсказке, поэтому его никогда не принимают за работающий. Подсказка также называет ключ конфигурации, из которого пришло прикрепление, его возможности, виды входных данных, его границу и его экспорты — показывая только то, о чём действительно сообщает список.
Операции, действующие на весь набор, — это первые две строки панели: Add plugin и Generate entities, которая записывает сущности каталога Plugin, — а заголовок самой панели содержит только кнопку обновления. Добавление спрашивает тип плагина в виде списка для выбора, затем ещё один ответ, который требуется этому типу: возможность, которую обслуживает привязка
provider, или роль, на которой привязано прикреплениеgovernance, и последним — имя для поиска в настроенном реестре, которое должно разрешаться ровно в один плагин этого типа; прикрепление записывается в конфигурацию рабочего пространства этого проекта. Добавление — единственная здесь операция, обращающаяся к сети, поскольку она ищет в реестре, поэтому она показывает ход выполнения и может быть остановлена. Если опубликованная версия плагина была отозвана, добавление завершается сообщением об этом, а не оставляет это на ваше обнаружение: отозванные и не выбранные версии, причина, записанная для каждой, а также откуда были прочитаны записи об отзыве и когда они последний раз обновлялись, — показывая только то, о чём сообщает компилятор; а если эти записи вообще не удалось прочитать, сообщается это, с собственной причиной компилятора, что является иным ответом, чем то, что ничего не отозвано.Генерация сущностей каталога спрашивает, охватить ли каждый плагин, встроенный в компилятор, или один артефакт плагина на этой машине, тоже в виде списка для выбора, затем — авторское наложение для слияния и директорию для записи, и перед записью просит подтверждения: каждая сущность записывается по пути, выведенному из типа, имени и версии её плагина, поэтому сущность, уже находящаяся там для того же плагина и версии, заменяется.
Удаление плагина находится в строке этого плагина. Оно сначала просит подтверждения и говорит, в какой файл конфигурации записывает, потому что это зависит от типа плагина: плагин
cliудаляется из глобальной конфигурации, общей для всех рабочих пространств на этой машине, любой другой тип — из собственной конфигурации этого проекта, — и оно работает только с текстом конфигурации, поэтому больше ничего на этой машине не удаляется. Удаление предлагается только для настроенного плагина, за который ответил компилятор: плагин, встроенный в компилятор, вообще не является записью конфигурации, а прикрепление, которое ничто не смогло разрешить или описать, приходит без типа, который удалению нужен наряду со ссылкой, — поэтому в таких строках оно не предлагается, вместо того чтобы предлагаться как элемент управления, способный лишь сообщить об отсутствующем аргументе. Добавление плагинаcliс панели не предлагается, потому что его установка подтверждает объявленные им возможности в терминале, а за кнопкой терминала нет, — запустите его в терминале и нажмите обновление. Синхронизация машинных записей сущности плагина тоже не предлагается: она принимает файл сущности и артефакт.wasmкак два пути, а строка не называет ни один из них. -
Поиск по опубликованному каталогу — поиск сущностей каталога в настроенных реестрах и копирование ссылки для вставки в Aggregate. Поиск сужается из единого списка, где каждый фасет показывает своё текущее значение: свободный текст, сопоставляемый с именем и описанием, один или несколько видов сущностей, селектор меток (категория — это метка), одна или несколько возможностей плагинов, сокет плагина и ограничение на количество возвращаемых результатов. Нетронутый фасет ничего не сужает. Заданное вами сохраняется: следующий поиск открывается с фильтром, оставленным предыдущим, — был ли тот выполнен, ничего не нашёл или был закрыт после правки, — поэтому повторное сужение — это одна правка, а не ввод всего фильтра заново. Reset search filter, строка прямо над Search, возвращает все фасеты в состояние, в котором они ничего не сужают, и возвращает вас к списку без поиска; её описание называет фасеты, которые она очистит, или сообщает, что ничего не задано. Фильтр хранится только пока расширение работает в этом окне и нигде не сохраняется — его нет ни в одной настройке, поэтому другое окно ищет со своим фильтром, а перезагрузка окна или что-либо ещё, что перезапускает расширения редактора, начинает с пустого фильтра. Поиск читает локальный индекс, записанный
aggrega registry update— Update index на панели Registries, — и не обращается к сети, поэтому реестр, индекс которого ещё не построен, не просматривается. Канал вывода сообщает об этом в собственной строке этого реестра с Update index для построения его индекса, а об устаревшем индексе — в отдельной строке с Update index для его обновления; поиск, ничего не нашедший при настроенном таком реестре, называет реестры, в которых он искал, и те, в которых не искал; а если ни у одного настроенного реестра вообще нет индекса, поиск выводит собственное сообщение компилятора с указанием шага, который нужно выполнить.