Подання 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 для його оновлення; пошук, що нічого не знайшов за налаштованого такого реєстру, називає реєстри, у яких шукав, і ті, у яких не шукав; а якщо жоден налаштований реєстр узагалі не має індексу, пошук виводить власне повідомлення компілятора з назвою кроку, який слід виконати.