Tampilan Aggrega
Grafik topologi terbuka di panelnya sendiri, yang dijelaskan dalam Grafik topologi, dan perintah yang dijalankan oleh tombol panel Commands dijelaskan dalam Perintah.
Tampilan Aggrega di bilah aktivitas — empat panel dalam urutan baca: Commands, Registries, Catalog, dan Plugins. Tiga lainnya mencantumkan apa yang dimuat oleh konfigurasi Anda dan ruang kerja, dan masing-masing dibuka dengan operasi yang bekerja pada apa yang dicantumkannya, sebagai baris berlabel di bagian atas daftarnya; setiap operasi lainnya adalah tombol berlabel di panel Commands, sehingga setiap operasi memiliki satu tempat untuk dicari. Operasi yang bekerja pada satu registri, entitas, atau plugin tertentu ada di baris tersebut.
Panel Commands diawali dengan tiga baris tunggal yang menyebutkan apa yang sedang ditangani editor — Project folder, lalu Aggrega workspace, lalu Release — yang masing-masing membuka pemilihnya sendiri. Baris tengah menampilkan namanya dalam bentuk singkat, sebagai Agg. worksp., agar nilai setiap baris mendapat lebih banyak lebar panel; hover-nya menyebutkan nama lengkapnya, sebagai Aggrega workspace, begitu pula setiap pesan tentangnya. Nilai-nilainya berada dalam satu kolom, setelah label terlebar dari ketiganya; di panel yang terlalu sempit untuk label itu, label dipotong dengan elipsis alih-alih mendorong panel ke samping, dan hover baris tetap menyebutkan baris yang mana. Urutannya demikian karena masing-masing berada di dalam baris di atasnya, dan susunan itulah cara hal tersebut ditunjukkan alih-alih dijelaskan. Baris tengah mempertahankan nama produk, disingkat atau tidak, karena “ruang kerja” saja sudah menyebut kumpulan folder yang dibuka di jendela Anda. Baris Aggrega workspace menyebutkan folder tempat server bahasa berlabuh, yang menjadi acuan perhitungan daftar Release; mengarahkan penunjuk ke atasnya menampilkan jalur lengkap dan, jika berbeda dari folder yang Anda buka, juga menyebutkan folder tersebut — sehingga Anda dapat mengetahui mengapa Releases yang ditawarkan adalah yang ditawarkan. Jika jendela Anda membuka tepat satu folder, hover baris Project folder menyatakan bahwa folder itu satu-satunya, alih-alih membiarkan Anda membuka daftar berisi satu entri, dan diakhiri dengan apa yang ditawarkan oleh klik pada baris di sana — membuka folder, atau menambahkan folder ke jendela — dan jika tidak ada Release yang dipilih dan belum ada yang membaca apa yang ditawarkan ruang kerja Aggrega ini, hover menyatakan hal itu alih-alih menebak. Jika suatu tingkat tidak berisi apa pun, hover menyebutkan cara keluar dari keadaan tersebut alih-alih menyuruh Anda memilih: tidak ada yang dipilih dan tidak ada yang bisa dipilih dibaca secara berbeda, karena hanya yang pertama merupakan keputusan yang menunggu Anda. Proyek yang tidak berisi ruang kerja Aggrega dijawab dengan membuka folder yang berisi satu ruang kerja atau dengan membuatnya; ruang kerja Aggrega yang tidak berisi Release, dengan bekerja di ruang kerja lain atau dengan menyusun draf Release.

Baris Aggrega workspace dan Release masing-masing memiliki + di sebelah kanan, di samping baris dan bukan di atasnya: menekan baris memilih di antara yang sudah ada, dan menekan + membuka jalan untuk membuat yang baru. + pada Release membuka alur penyusunan draf yang sama dengan Draft entity di bagian atas panel Catalog, dengan jenis yang sudah ditetapkan: alur ini hanya menanyakan nama, dan prompt-nya menyatakan bahwa ia sedang menamai sebuah Release. Baris Project folder tidak memilikinya — mewujudkan folder proyek adalah urusan editor Anda, bukan urusan Aggrega.
Jika ruang kerja Aggrega Anda bukan folder yang Anda buka — letaknya di atas folder itu, atau di dalamnya — baris Aggrega workspace memiliki satu kontrol tambahan, yang membuka ruang kerja itu sebagai folder proyek Anda. Kontrol ini ditawarkan, bukan dijalankan untuk Anda, dan namanya menyebutkan apa konsekuensinya sekaligus ke mana tujuannya: membuka folder akan memuat ulang jendela, sehingga server bahasa dan ekstensi ini sama-sama dimulai ulang dan apa pun yang belum disimpan di jendela ikut hilang. Jika folder yang Anda buka itu sendiri adalah ruang kerja Aggrega, tidak ada yang perlu dibuka, dan kontrol tersebut tidak ditampilkan.
Ketika sebuah jendela terbuka pada folder yang ruang kerja Aggrega-nya berada di luarnya — bukan folder itu dan bukan di dalamnya — editor juga menyatakannya dalam dialog yang Anda tutup sebelum melanjutkan: dialog itu diawali dengan Aggrega is using a workspace from outside the folder you opened. dan, di bawahnya, baris Aggrega workspace: dan baris Project folder: yang memberikan jalur lengkap masing-masing. Tombolnya adalah Open workspace (reloads the window), yang membuka ruang kerja Aggrega sebagai folder proyek Anda sama seperti kontrol pada baris itu sendiri; Continue here, yang menutup dialog dan tidak mengubah apa pun; dan Don’t show again for this folder. Menutup dialog dengan cara lain — dengan Escape, atau dengan kontrol tutupnya sendiri — sama dengan Continue here. Dialog muncul sekali untuk sebuah folder di setiap jendela, dan muncul lagi jika ruang kerja Aggrega tempat folder itu berada berubah; setelah Continue here, dialog tidak muncul sampai jendela dimuat ulang atau dibuka lagi, lalu muncul kembali. Don’t show again for this folder diingat untuk jendela itu dan dipulihkan ketika Anda membukanya kembali, sehingga dialog tidak muncul lagi untuk folder itu. Tidak satu pun dari ketiganya menghapus fakta itu sendiri: selama ruang kerja berada di luar folder Anda, baris Aggrega workspace memiliki tanda peringatan di sebelah kanan nilainya, dan mengarahkan penunjuk ke baris itu menampilkan judul yang sama dan dua jalur yang sama dengan yang ditampilkan dialog. Ruang kerja Aggrega di dalam folder yang Anda buka tidak berada di luarnya, sehingga tidak memunculkan dialog dan barisnya tidak memiliki tanda maupun judul seperti itu; mengarahkan penunjuk ke baris itu tetap menyebutkan folder yang Anda buka, dan kontrol yang membuka ruang kerja sebagai folder proyek Anda tetap ditampilkan.
Dialog digambar oleh sistem operasi Anda kecuali pengaturan window.dialogStyle editor bernilai custom, sehingga secara default dialog mengikuti tema desktop Anda, bukan tema editor, dan tidak ada ekstensi yang dapat mengubah tampilannya; dengan window.dialogStyle disetel ke custom, editor menggambarnya dengan temanya sendiri.
Mengklik baris Aggrega workspace membuka pilihan apa pun yang telah Anda lampirkan, termasuk ketika itu hanya satu ruang kerja atau tidak ada sama sekali: pemilih mencantumkan ruang kerja Aggrega yang dijangkau oleh Project folder Anda — dengan naik dari folder itu, dan dengan memeriksa semua yang ada di dalamnya — masing-masing dinamai dengan root-nya sendiri, dan, terakhir, cara untuk menjangkau folder yang sama sekali tidak dibuka di jendela Anda: Choose another folder Aggrega recognises…, atau Choose a folder Aggrega recognises… jika pemilih tidak memiliki ruang kerja untuk dicantumkan. Entri terakhir itu ada karena jangkauan dibatasi oleh apa yang dimuat jendela Anda: editor Anda hanya mencari di folder yang Anda buka, sehingga ruang kerja yang berada di tempat lain dapat dijangkau dengan menambahkan foldernya dan tidak dengan cara yang lebih singkat. Server bahasa dimulai segera setelah penelusuran ke atas menemukan tempat untuk memulai, tanpa menunggu pencarian itu selesai, sehingga sebuah jendela dapat terlampir dan baru sesaat kemudian melaporkan bahwa ruang kerja kedua dapat dijangkau — daftar di pemilih menyusul saat pencarian kembali. Ruang kerja Aggrega tempat jendela ini terakhir bekerja juga langsung diambil kembali, termasuk yang Anda pilih di dalam Project folder Anda, karena editor menanyakan penanda milik ruang kerja itu sendiri alih-alih menunggu pencarian; hanya setelah penandanya hilang, atau tidak lagi menandai ruang kerja yang dijangkau Project folder Anda, pilihan itu dibatalkan, dan Anda diberi tahu. Memilih entri lain memindahkan server bahasa ke sana dan menyatakannya, baik entri itu dijangkau dari folder yang sama dengan yang sedang digunakan maupun dari folder lain, dan memilih entri yang sudah digunakan tidak memulai ulang apa pun dan menyatakan di mana editor sudah bekerja: Aggrega: the editor already works in ⟨path⟩., dengan menyebut root ruang kerja secara lengkap. Satu ruang kerja Aggrega yang dijangkau dari dua folder terbuka sekaligus adalah satu entri dan dihitung sebagai satu: penemuan naik ke atas, sehingga root satu tingkat di atas menjawab untuk setiap folder di bawahnya, dan menanyakan folder mana yang memuat ruang kerja itu akan menjadi pertanyaan dengan dua jawaban yang benar.
Mengklik baris Project folder membuka pilihan yang sama jenisnya: folder yang terbuka di jendela Anda, masing-masing dinamai dengan jalurnya sendiri, dan, di bagian akhir, dua cara untuk mencapai folder yang tidak terbuka di jendela. Open folder… meminta folder melalui dialog folder editor Anda, yang tombolnya bertuliskan Open, dan membuka folder yang Anda pilih di jendela ini menggantikan apa pun yang sedang terbuka, seperti yang dilakukan Open Folder milik editor sendiri. Tindakan itu memuat ulang jendela, yang dinyatakan sebelumnya oleh deskripsi entri tersebut, dan jika editor tidak dapat membuka folder, Anda diberi tahu. Add folder to this window… bertanya dengan cara yang sama, dengan tombol bertuliskan Add, dan menambahkan folder yang Anda pilih ke jendela, setelah folder yang sudah terbuka, sebagai folder tempat editor bekerja: Anda memilihnya di baris ini, sehingga baris tersebut menamainya alih-alih bertanya lagi, dan ruang kerja Aggrega yang ditawarkan adalah yang dicapainya. Di jendela yang sudah terbuka pada berkas ruang kerja, folder tersebut bergabung di tempat, dan Anda diberi tahu bahwa editor kini bekerja dari folder itu. Folder yang sudah terbuka di jendela tidak ditambahkan lagi, dan Anda diberi tahu; jika editor menolak folder tersebut, Anda juga diberi tahu, dan editor tetap bekerja dari folder sebelumnya. Menutup salah satu dialog tanpa memilih tidak mengubah apa pun.
Menambahkan folder ke jendela yang berisi satu folder, atau tidak sama sekali, menjadikan jendela tersebut ruang kerja multi-root, yang dilakukan editor Anda dengan memulai ulang ekstensinya — termasuk ekstensi ini — atau, di jendela jarak jauh seperti dev container, dengan memuat ulang jendela. Jika halaman sambutan sedang terbuka saat ekstensi dimulai ulang, halaman itu digambar ulang di tempatnya, sehingga jendela tetap berisi satu halaman dan halaman tersebut menggambarkan jendela sebagaimana adanya sekarang. Baik Add folder to this window… maupun entri terakhir pemilih ruang kerja Aggrega berakhir dengan penambahan seperti itu, sehingga jika memilih salah satunya akan menyebabkan hal tersebut, deskripsinya menyatakannya sebelumnya. Ruang kerja itu baru bagi editor Anda dan dimulai tanpa apa yang diingat jendela yang Anda tinggalkan, kecuali satu jawaban yang diberikan oleh penambahan itu sendiri: folder yang ditambahkan melalui Add folder to this window… adalah Project folder di sana, dan ruang kerja Aggrega yang dipilih melalui entri terakhir pemilih ruang kerja Aggrega, atau melalui Use a folder that already has one di halaman sambutan, adalah ruang kerja Aggrega di sana. Release yang telah Anda pilih, dan folder yang dialognya Anda minta agar tidak ditampilkan lagi, tetap berada di jendela yang Anda tinggalkan.
Pilihan Anda diingat untuk jendela tersebut dan dipulihkan saat Anda membukanya kembali, dan pilihan itu menentukan apa yang ditawarkan baris di bawahnya — ruang kerja Aggrega yang ditawarkan adalah yang dicapai folder tersebut. Mencapai tidak sama dengan berisi: karena penemuan bergerak naik, ruang kerja yang dicapai sebuah folder sering kali adalah folder di atasnya, sehingga memilih subdirektori repositori Anda tetap menawarkan ruang kerja milik repositori itu sendiri. Dengan satu folder terbuka, tidak ada yang perlu dipilih dan baris itu hanya menamainya. Dengan beberapa folder dan tidak ada yang dipilih, baris itu menampilkan none selected, dan ruang kerja Aggrega yang ditawarkan adalah yang dicapai seluruh jendela. Jika hanya ada satu, atau jika salah satunya adalah yang terakhir digunakan jendela ini, server bahasa dimulai di sana; jika ada beberapa dan tidak satu pun diingat, server tidak dimulai sampai Anda memilih salah satunya, dan Choose Aggrega workspace… di bilah status serta sebuah notifikasi meminta Anda melakukannya. Server bahasa yang berhenti atau gagal dimulai dengan sendirinya tetap membiarkan baris Project folder menamai folder Anda — ruang kerja Anda tetap terpilih, dan indikator server bahasa-lah yang melaporkan keadaan server.
Di bawah baris-baris itu, operasi dikelompokkan menurut apa yang ingin Anda lakukan: Build (validate, lint, build, preview, graph), Dependencies (pull), Author (import, inspect), Publish (push, sign, deprecate), dan Configuration (show config, cache).
Di samping Commands terdapat panel Registries, diawali oleh Add registry dan Update index serta mencantumkan setiap registry yang dideklarasikan konfigurasi efektif; panel Catalog, diawali oleh Search catalog dan Draft entity serta mencantumkan entitas yang dapat dilihat ruang kerja; dan panel Plugins, diawali oleh Add plugin dan Generate entities serta mencantumkan plugin Wasm bawaan dan yang dikonfigurasi. Baris-baris pertama itu adalah bagian dari daftar panel itu sendiri: masing-masing berlabel dan memiliki ikonnya, sehingga terlihat tanpa menunjuk apa pun, menekannya menjalankan operasi, dan menciutkan panel ikut melipatnya bersama yang lain. Baris-baris itu selalu ada apa pun yang ditampilkan daftar di bawahnya — termasuk saat daftar menyatakan tidak ada yang dikonfigurasi, yang justru saat menambahkan yang pertama adalah tujuan Anda, dan saat daftar menyatakan tidak ada ruang kerja Aggrega yang tersedia. Jika suatu baris belum dapat dijalankan, baris itu tetap di tempatnya dan menyebutkan alasannya di samping namanya, dengan kata-kata yang digunakan panel Commands untuk keadaan yang sama, dan menekannya tidak menjalankan apa pun. Masing-masing dari ketiga panel itu juga memiliki tombol penyegaran di bilah judulnya, yang membaca ulang satu daftar itu, dan tidak ada yang lain — operasi di sana akan menjadi ikon tanpa label yang harus Anda arahkan kursor untuk menemukannya. Validate, build, preview build, dan lint melaporkan ke panel Problems; operasi yang berbasis baris perintah mengalirkan keluarannya ke kanal keluaran Aggrega.

Panel Commands
-
Satu tempat pengaturan, dicapai dari ikon roda gigi — panel Commands memiliki ikon roda gigi di kanan atas, yang membuka pengaturan editor itu sendiri yang dipersempit ke ekstensi ini. Tidak ada halaman pengaturan kedua milik ekstensi sendiri, sehingga setiap preferensi memiliki satu tempat berada dan satu tempat ditulis. Setiap preferensi adalah milik Anda, bukan milik proyek; lihat Pengaturan.
-
Dua bentuk untuk panel Commands —
aggrega.operations.layoutmemilih antarabuttons, nilai default, tempat setiap operasi menjadi tombol berlabel dalam satu alur berkesinambungan tanpa judul grup sama sekali, dansections, tempat setiap grup menjadi bagian yang Anda buka di bawah judulnya sendiri dan panel menampilkan sebanyak yang Anda biarkan terbuka. Kedua bentuk memuat grup yang sama dengan operasi yang sama, dalam urutan yang sama; pengaturan ini mengubah cara grup digambar, tidak pernah mengubah operasi mana yang ada. Dalam kedua bentuk, baris Project folder, Aggrega workspace, dan Release berada di atas setiap operasi, sehingga menutup suatu bagian tidak pernah menghilangkan fakta yang menyebutkan pada apa sebuah operasi akan diterapkan. Dalamsections, tanda sisipan di samping Build adalah baris tersendiri di bawahnya, bertuliskan Build options sebelum chevron-nya, sehingga tidak terbaca sebagai bagian yang perlu dibuka. Mengubah pengaturan menggambar ulang panel yang terbuka dan tidak memulai ulang apa pun. Panel Commands dibuka dengan porsi bilah samping yang lebih besar daripada tiga panel di sampingnya — di jendela setinggi 900 piksel, cukup untuk menampilkan seluruh alurnya pada lebar default bilah samping; sejak itu editor menyimpan tinggi panel untuk setiap ruang kerja, sehingga ruang kerja yang bilah sampingnya pernah ditata sebelumnya mempertahankan tinggi yang dimilikinya. -
Tombol yang menawarkan pilihan menampilkannya di sampingnya — operasi yang menanggapi penekanan dengan menanyakan yang mana atau entitas mana yang akan ditangani menampilkan pilihan itu sebagai menu di samping tombol yang Anda tekan, bukan dalam dialog yang memenuhi seluruh jendela: Cache… menawarkan empat operasi cache, dan Inspect serta Push menawarkan entitas yang dapat dilihat ruang kerja. Menu dibuka di bawah atau di atas tombol, di sisi mana pun panel memiliki ruang lebih banyak, dan tidak lebih tinggi dari ruang itu, sehingga tidak pernah melewati tepi panel — daftar yang lebih panjang dari ruang itu bergulir di dalamnya — dan namanya, yakni apa yang sedang dipilihnya, tetap di bagian atas saat Anda menggulir. Hal itu berlaku di mana pun panel berada, termasuk saat ditambatkan di bilah samping yang pendek. Menu dicapai dengan menekan tombol dan tidak pernah dengan Tab, sehingga panel tetap hanya memakan satu perhentian berapa pun menu yang dimuatnya. Di dalamnya, tombol panah berpindah di antara pilihan dan Enter mengambil pilihan yang sedang aktif; mengetik mempersempit daftar — kecocokannya adalah potongan dari nama pilihan atau dari baris di bawahnya, dan menu menyebutkan berapa yang tersisa — Backspace membatalkan apa yang Anda ketik, Escape menutup menu dan mengembalikan fokus ke tombol, dan menekan di tempat lain mana pun — di panel atau di mana pun di editor — menutupnya tanpa menjalankan apa pun. Operasi yang sama ada di indeks perintah editor, tempat tidak ada tombol untuk membuka menu di sampingnya, sehingga bila dipanggil dari sana masing-masing mengajukan pertanyaannya sebagai daftar yang Anda pilih.

-
Menu yang pilihannya harus diminta menyatakan bahwa ia sedang membaca — menu yang dibuka Inspect dan Push tidak berisi apa pun sampai server bahasa menjawab entitas apa saja yang dimuat ruang kerja, yaitu pembacaan yang menampilkan kemajuan dan dapat dihentikan. Keduanya dibuka dengan baris yang menyatakan sedang membaca dan terisi saat jawaban tiba, alih-alih dibuka kosong: daftar pilihan yang kosong terbaca sebagai tidak ada apa-apa, yang merupakan jawaban berbeda dari tunggu. Apa pun yang Anda ketik selama pembacaan berlangsung tetap berlaku setelah pilihan tiba. Bila tidak ada yang dapat ditawarkan — tidak ada entitas yang dapat disebut operasi itu — menu ditutup dan sebuah pesan menyatakannya, pesan yang sama dengan yang Anda dapatkan saat menjalankan operasi dari indeks perintah, alih-alih menu tanpa isi.
-
Memilih dan menyetujui tetap merupakan tindakan yang berbeda — menu adalah tempat Anda menyatakan yang mana, dan menu tidak pernah memuat konfirmasi. Tiga operasi cache yang menghapus sesuatu tetap menampilkan konfirmasi modal setelah Anda memilih, yang menyebutkan cache yang dijangkau operasi itu, dan pembuatan entitas Plugin tetap meminta konfirmasi sebelum menulis. Sebuah konfirmasi sepadan dengan interupsinya: melipatnya ke dalam daftar sebaris akan membuat satu klik yang tidak disengaja dapat mengosongkan cache. Pencarian katalog yang dipublikasikan mempertahankan daftar filternya, yang Anda kunjungi kembali setelah menyunting setiap faset, karena menu tidak cocok untuk sesuatu yang dimasuki ulang setelah setiap jawaban.
-
Apa yang memisahkan satu grup dari grup berikutnya, dalam setiap bentuk — dalam alur, tidak ada yang digambar di antara satu grup dan grup berikutnya: grup menentukan urutan tombol, dan urutan itulah satu-satunya yang membawa pengelompokan, sehingga panel tidak menghabiskan lebar untuk pemisah. Dalam bentuk bagian, grup Publish memiliki garis di atasnya, karena operasinya mengubah apa yang diterima setiap orang yang me-resolve katalog itu sementara sisanya bekerja di mesin ini — perbedaan jenis, yang layak ditandai sekali dan memiliki kotak grup untuk ditandai.
-
Panel yang sempit membungkus baris alih-alih memotong atau menggulir ke samping — alur memakai sebanyak mungkin baris yang dibutuhkan lebar, dan tidak ada pemisah baris yang tetap: lebarkan panel dan tombol-tombol tersusun ulang ke baris yang lebih sedikit. Label setiap tombol hanya nama operasinya, dengan penjelasan pada keterangan saat kursor diarahkan, sehingga satu baris memuat sebanyak mungkin operasi. Tidak ada yang disembunyikan di balik gerakan ke samping, dan tidak ada label yang dipotong.
-
Setiap operasi meminta apa yang dibutuhkannya sebelum berjalan — operasi yang diketahui panel tidak dapat dijalankan tetap di tempatnya, berwarna abu-abu, dan menyebutkan alasannya: mengarahkan kursor ke sana menyebutkan apa yang kurang, dan pembaca layar mengumumkannya sebagai tidak tersedia dengan alasan yang sama. Operasi itu tidak dihapus, karena dalam alur tombol, menghapus satu tombol menggeser tombol lain ke bawah penunjuk Anda, dan penekanan lalu mengenai sesuatu selain yang ada di sana sesaat sebelumnya — itulah juga sebabnya tanda sisipan di samping Build tetap di sampingnya selama Build tidak dapat berjalan, ikut berwarna abu-abu, memberikan alasan yang sama, dan tidak membuka apa pun. Dua kondisi membuat kontrol berwarna abu-abu: operasi yang bekerja pada Release membutuhkan satu Release yang dipilih, dan operasi yang menjalankan biner
aggregamembutuhkan folder ruang kerja yang berlabuh sebagai tempat berjalan. Operasi yang hanya membutuhkan server bahasa tidak berwarna abu-abu saat server mati — saat ditekan, operasi itu melaporkan pesan kompilator sendiri, dan bilah status adalah tempat keadaan itu disebutkan. Push, tanda tangan, dan penghentian masing-masing menanyakan subjeknya terlebih dahulu: push menawarkan entitas yang dicantumkan panel Catalog yang memiliki dokumen di ruang kerja, sedangkan tanda tangan dan penghentian meminta referensi ke artefak yang sudah ada di registry, karena itulah yang diubah oleh keduanya. Penghentian juga menanyakan tingkat keparahan dan alasan, yang diwajibkan kompilator dan tidak dapat ditanyakannya kepada Anda dari dalam editor. Pull berjalan terhadap Release yang dipilih alih-alih menanyakan subjek. Operasi di awal panel Registries, Catalog, dan Plugins bertanya dengan cara yang sama: menambahkan registry menanyakan host dan file konfigurasi mana yang akan ditulisi, menambahkan plugin mengajukan dua atau tiga pertanyaan yang dibutuhkan jenisnya, membuat entitas Plugin menanyakan apa yang dicakup dan di mana menulis, pencarian katalog yang dipublikasikan membuka daftar filter yang Anda susun sebelum berjalan, dan membuat draf entitas menanyakan jenis lalu nama. Masing-masing kecuali Draft entity membutuhkan folder ruang kerja yang berlabuh, sehingga tanpanya setiap baris seperti itu menyebutkannya di samping namanya dan menekannya tidak menjalankan apa pun — Anda diberi tahu sebelum menjawab apa pun, bukan sesudahnya. Draft entity hanya membutuhkan server bahasa, sehingga tidak pernah digambar sebagai tidak dapat dijalankan.
Panel Registri, Katalog, dan Plugins
-
Detail panel Registri — setiap baris menyebutkan host registri, aliasnya jika ada yang dikonfigurasi, registri mana yang menjadi default, apakah tanda tangan diwajibkan untuk artefak yang ditarik darinya, dan apakah kredensial untuk host tersebut ada. Membaca daftar tidak menghubungi registri apa pun: status kredensial hanya melaporkan keberadaan, sehingga menyatakan bahwa kredensial ada, bukan bahwa registri akan menerimanya.
Operasi yang bekerja pada seluruh himpunan adalah dua baris pertama panel — Tambah registri, dan Perbarui indeks, yang memperbarui indeks yang dapat dicari dari setiap registri yang dikonfigurasi — sedangkan operasi yang bekerja pada satu registri berada di baris registri tersebut: memperbarui indeks hanya untuk registri itu, menghapus kredensial yang tersimpan, dan menghapus registri. Bilah judul panel itu sendiri hanya memuat penyegaran.
Menambahkan registri dan menghapusnya masing-masing menanyakan file konfigurasi mana yang akan diubah, dengan menawarkan lebih dulu file global yang dipakai bersama oleh setiap proyek di mesin ini, karena di sanalah kedua operasi ini menulis kecuali Anda menentukan lain; pilihan lainnya adalah file konfigurasi milik proyek ini sendiri. Masing-masing dari keduanya diakhiri dengan menyebutkan file yang benar-benar diubah dan seberapa jauh jangkauan file tersebut, yang dibaca dari apa yang dilakukan kompiler, bukan dari apa yang diminta. Server bahasa membaca konfigurasinya saat dimulai, sehingga masing-masing dari keduanya diikuti oleh mulai ulang server bahasa, tanpa bertanya, dan panel serta langkah registri di halaman sambutan dibaca ulang setelah server kembali: registri yang Anda tambahkan tercantum, atau registri yang Anda hapus hilang, tanpa memuat ulang dan tanpa penyegaran. Setelah server yang dimulai ulang membaca perubahan, pesan penutup menambahkan bahwa perubahan kini berlaku; jika mulai ulang gagal, hal itu tidak ditambahkan, karena perubahan saat itu ada di file tetapi belum berlaku.
Menghapus registri dan menghapus kredensial masing-masing meminta konfirmasi terlebih dahulu, dan masing-masing menyebutkan jangkauan perubahan: konfirmasi untuk registri menyebutkan file yang Anda pilih, sehingga menghapus entri dari file global dijelaskan sebagai memengaruhi setiap proyek yang melakukan resolusi melaluinya dan menghapus entri dari file milik proyek ini sendiri sebagai tidak memengaruhi proyek lain, sedangkan kredensial dihapus dari penyimpanan kredensial bersama dan entri registri tetap di tempatnya. Menghapus kredensial tidak menawarkan pilihan file, karena penyimpanan kredensial dipakai bersama oleh setiap proyek di mesin dan tidak memiliki bentuk per proyek untuk ditulisi.
Membangun indeks menampilkan kemajuan dan dapat dihentikan, dan merupakan satu-satunya operasi di antara ini yang ditawarkan dengan tombol Batal. Menekannya mengakhiri penelusuran itu sendiri, bukan hanya penantian editor, dan pembangunan diakhiri dengan menyatakan bahwa ia dihentikan. Catatan setiap registri hanya ditulis setelah penelusurannya sendiri selesai, sehingga pembangunan yang dihentikan membiarkan registri yang penelusurannya sudah selesai tetap terindeks, dan registri yang sedang ditelusuri mempertahankan indeks yang dimilikinya sebelumnya tanpa perubahan — jadi ini adalah penghentian, bukan pembatalan perubahan. Pembangunan yang berjalan sampai akhir menyebutkan berapa banyak entitas yang diindeks dari berapa banyak registri serta direktori tempat indeks ditulis, yang menunjukkan bahwa penyegaran tidak mengubah apa pun yang digunakan proyek lain di mesin ini untuk resolusi, dan registri yang tidak dapat diindeks disebutkan beserta alasan dari kompiler itu sendiri: registri yang tidak dapat dijangkau dinyatakan tidak terjangkau — ⟨registri⟩ tidak dapat dijangkau: di depan alasan tersebut — dan registri yang merespons tetapi gagal dengan cara lain, seperti registri yang daftar repositorinya berulang, yang mengakhiri penelusuran registri itu alih-alih menelusurinya berputar lagi sementara registri lain tetap diindeks, dinyatakan tidak dapat diindeks; kalimat penutup menyebutkan kedua kelompok secara terpisah. Memperbarui indeks satu registri yang tidak dapat dijangkau berakhir dengan cara yang sama, menyebutnya sebagai tidak terjangkau.
Menambahkan registri juga menjangkau jaringan, karena mengambil kebijakan kepercayaan yang diiklankan registri, dan ditawarkan tanpa tombol Batal; dalam kedua kasus, operasi ini diakhiri dengan menyebutkan file yang ditulisnya. Registri yang tidak dapat dijangkau disebut tidak terjangkau dalam pesan penutup tersebut, di depan alasan dari kompiler itu sendiri, alih-alih dinyatakan tidak mengiklankan kebijakan — termasuk hub resmi, yang entrinya kemudian membawa baseline bawaannya. Jika registri selain hub resmi tidak mengiklankan kebijakan kepercayaan atau tidak dapat dijangkau — atau, saat ruang kerja offline, ditolak karena tidak ada kebijakan yang dapat diambil — pesan penutup diikuti oleh pertanyaan yang menawarkan untuk menyematkan kebijakan secara manual, dengan persis apa yang diterima
--identitydan--keypada baris perintah untuk kasus itu: identitas tanpa kunci, masing-masing ditulisidentity=issuerdan diketik satu per satu, file kunci publik yang dipilih dalam dialog file, keduanya, atau tidak keduanya. Apa yang Anda berikan didaftarkan lagi untuk host yang sama di file yang sama, dan pesan penutup itu menyebutkan jenis kebijakan yang kini dibawa entri tanpa mengulang identitas atau file; identitas yang formatnya salah, atau file kunci yang tidak dapat dibaca atau bukan kunci publik, berakhir dengan penolakan dari kompiler itu sendiri. Penolakan terhadap file yang bukan kunci publik menyebutkan apa yang diharapkan kompiler dan menghilangkan isi file, sehingga kunci privat yang terpilih secara tidak sengaja tidak muncul di notifikasi maupun di kanal output Aggrega. Menekan Escape pada salah satu prompt ini, atau memilih Tidak keduanya, tidak menyematkan apa pun, dan yang berlaku adalah apa yang ditinggalkan baris perintah saat tidak diberi kedua flag. Registri yang kebijakan iklannya telah disematkan, dan hub resmi dengan baseline bawaannya, tidak ditanya.Menghapus registri, menghapus kredensial, dan membaca daftar tidak menghubungi registri apa pun. Masuk ke registri tidak ditawarkan dari panel, karena perintahnya membaca kata sandi dari terminal dan tidak ada terminal di balik tombol — jalankan perintah itu dari terminal lalu tekan segarkan.
-
Detail panel Katalog — entitas yang dapat dilihat ruang kerja, dikelompokkan di bawah judul per jenis, dengan setiap baris menyebutkan entitas dan label yang dideklarasikannya, serta apiVersion dan deskripsinya di tooltip. Baris berasal dari dua tempat dan masing-masing menyebutkan asalnya. Entitas yang dideklarasikan oleh dokumen di ruang kerja membawa path dokumen itu di tooltip-nya, dan mengklik barisnya membuka file tersebut. Entitas yang diresolusi dari direktori katalog — direktori
catalog/di root ruang kerja, serta direktori yang dinamai konfigurasi Anda untuk Release yang dipilih di bawahworkspace.releasesatau, jika tidak ada yang dinamai untuknya atau tidak ada yang dipilih, untuk seluruh ruang kerja di bawahworkspace.catalog_dirs— ditandai berasal dari sana dan tidak membawa path: ruang kerja tidak memiliki file sendiri untuknya, sehingga baris menyebutkan asalnya alih-alih menawarkan klik yang tidak menuju ke mana pun.Daftar ini milik Release yang dipilih: dokumen di bawah direktori yang dinamai konfigurasi Anda hanya untuk Releases lain dikecualikan darinya, sehingga ketika setiap Release membaca varian satu entitas dari direktorinya sendiri, panel hanya mencantumkan varian Release yang dipilih. Tanpa Release yang dipilih, setiap dokumen di ruang kerja dicantumkan. Dokumen yang tidak mendeklarasikan
kind:ataumetadata.name:tidak dicantumkan, dan itulah yang menjaga panel tetap menjadi indeks entitas, bukan indeks file.Server bahasa tidak membaca entitas apa pun melalui tautan yang mengarah ke luar ruang kerja — tautan ke direktori di luarnya, atau tautan yang dinamai seperti file YAML yang mengarah ke file di luarnya — sehingga tidak ada entitas di balik tautan semacam itu yang dicantumkan, meskipun pohon file editor Anda menampilkannya. Satu-satunya pengecualian adalah Release yang disebutkan oleh konfigurasi ruang kerja Anda, sebagai
build.authoring_releaseatau sebagai kunci dariworkspace.releases, yang dibaca melalui tautannya dan dicantumkan di tempat tautan itu sendiri. Jika daftar menghilangkan tautan semacam itu, sebuah baris tersendiri setelah daftar menyatakannya: Entitas yang dicapai melalui tautan ini tidak dicantumkan, karena tautan ini mengarah ke luar ruang kerja Aggrega: diikuti oleh jalur tautan relatif terhadap ruang kerja — atau Entitas yang dicapai melalui tautan-tautan ini tidak dicantumkan, karena masing-masing mengarah ke luar ruang kerja Aggrega: untuk beberapa tautan, dengan menyebutkan tautan ke direktori terlebih dahulu, lalu tautan ke file. Mengarahkan penunjuk ke baris tersebut menampilkan kalimat lengkapnya, karena jalur yang panjang dipotong di dalam baris. Jika sebuah Release dipilih, tautan di dalam direktori katalog yang hanya dibaca oleh Releases lain tidak disebutkan, karena tidak ada apa pun di baliknya yang akan dicantumkan untuk Release tersebut.Daftar ini adalah jawaban dari server bahasa itu sendiri, sehingga menyebutkan entitas yang sama dengan yang dibaca kompiler — termasuk buffer editor yang belum disimpan, yang didahulukan daripada byte di disk — dan disajikan dalam urutan yang dikirim server alih-alih diurutkan ulang di sini. Panel membaca ulang daftar dengan sendirinya ketika server bahasa menjadi dapat menjawab, ketika Release yang dipilih berubah, ketika dokumen
.yamldi folder yang dibuka jendela dibuat, diubah, atau dihapus di disk — baik oleh editor, terminal, maupun checkout — dan ketika editor menutup dokumen YAML. Panel baru memintanya setelah server bahasa melepaskan apa yang disimpannya untuk file tersebut, sehingga file yang dihapus saat terbuka di editor keluar dari daftar alih-alih dilaporkan dari salinan terakhir yang dikirim editor, dokumen yang diganti namanya di buffer dan ditutup tanpa disimpan dicantumkan kembali sesuai keadaannya di disk, dan serangkaian perubahan dan penutupan semacam itu menjadi satu kali pembacaan. Editor menutup dokumen ketika melepaskannya, yang tidak dijanjikan terjadi tepat saat tab dokumen ditutup, sehingga baris yang diambil dari teks dokumen yang tabnya sudah ditutup dapat tetap ada sampai editor melakukannya. Panel tidak mengikuti ketikan Anda dengan sendirinya. Perubahan yang masih berada di buffer yang belum disimpan dikirim ke server bahasa setelah Anda berhenti sejenak mengetik di dokumen tersebut — setiap dokumen yang terbuka menunggu jedanya sendiri, sehingga mengetik di satu dokumen tidak pernah menahan dokumen lain — dan perubahan itu muncul saat daftar dibaca berikutnya setelah itu. Menekan tombol muat ulang panel membaca daftar untuk setiap dokumen yang terbuka sebagaimana dipegang editor pada saat Anda menekannya, seberapa pun singkatnya setelah ketukan tombol atau pembatalan terakhir Anda: perubahan yang belum dikirim langsung dikirim, dan daftar baru diminta setelah server bahasa menjawab setiap perubahan yang dikirim kepadanya hingga saat penekanan. Folder yang dihapus seluruhnya muncul saat daftar dibaca berikutnya, atau saat tombol muat ulang ditekan, karena editor dapat melaporkannya sebagai satu perubahan pada folder alih-alih satu perubahan pada setiap dokumen di dalamnya.Mencari di katalog yang diterbitkan adalah baris pertama panel ini, Search catalog: baris ini meminta filter dan menyalin referensi dari apa pun yang Anda pilih. Membuat draf entitas baru adalah baris keduanya, Draft entity: baris ini menanyakan jenisnya, sebagai daftar yang dapat Anda pilih, dan membuka dokumen awal di sebuah tab tanpa menulis apa pun ke disk. Bilah judul panel ini sendiri hanya memuat tombol muat ulang. Operasi yang bekerja pada satu entitas ada di baris entitas tersebut, dan sebuah baris hanya menawarkan operasi jika kompiler menerimanya untuk jenis baris tersebut. Jenis apa saja yang diterima setiap operasi adalah jawaban server bahasa itu sendiri, yang dibaca ulang bersama daftar setiap kali, sehingga baris-baris mengikuti kompiler yang Anda jalankan alih-alih daftar yang disimpan di ekstensi. Memeriksa hasil resolusi sebuah entitas adalah satu-satunya operasi yang dapat dijangkau tanpa membuka menu baris: operasi ini merujuk entitas berdasarkan namanya, yang dimiliki setiap baris, sehingga ditawarkan pada sebuah baris baik ruang kerja memuat dokumen untuknya maupun tidak, di mana pun kompiler me-resolve sebuah nama menjadi entitas dari jenis tersebut, dan operasi ini tidak mengubah apa pun.
Memvalidasi entitas, memeriksa konvensi penerbitannya, dan menerbitkannya masing-masing memerlukan jalur entitas, sehingga hanya ditawarkan pada baris yang entitasnya dideklarasikan oleh dokumen di ruang kerja ini; baris yang di-resolve dari direktori katalog yang dikonfigurasi tidak memiliki jalur di ruang kerja ini untuk diberikan kepada operasi tersebut, sehingga operasi itu tidak ditawarkan di sana alih-alih ditawarkan sebagai kontrol yang hanya dapat melaporkan argumen yang hilang. Dari ketiganya, pemeriksaan konvensi penerbitan ditawarkan pada setiap baris semacam itu. Validasi ditawarkan jika kompiler memeriksa dokumen jenis tersebut secara mandiri: sebuah Aggregate, misalnya, diperiksa bersama seluruh katalog jika berada di direktori katalog, dan bersama Release yang men-deploy-nya, sehingga barisnya tidak menawarkan validasi. Validasi memeriksa entitas dalam konteks Release yang dipilih, seperti yang dilakukan
aggrega validate <path> --release <Release>di terminal, sehingga apa yang dirujuk entitas — Component yang diimplementasikan oleh sebuah Recipe, pustaka yang disusun oleh skemanya — di-resolve melalui direktori katalog yang menjadi dasar build Release tersebut; tanpa Release yang dipilih, melalui direktori milik ruang kerja itu sendiri. Penerbitan ditawarkan jika dokumen jenis tersebut diterbitkan secara mandiri, yang mengecualikan Plugin, yang penerbitannya juga mengikat file executable-nya, serta Manifest atau Release, yang keduanya tidak diterbitkan. Jika server bahasa tidak menyebutkan operasi mana yang menerima jenis sebuah baris, baris-baris tetap dicantumkan dan baris dengan dokumen hanya menawarkan pemeriksaan konvensi; jika permintaan untuk jawaban tersebut gagal, alasannya ditulis ke saluran output Aggrega.Penerbitan meminta Anda mengonfirmasi terlebih dahulu dan menyebutkan sejauh mana perubahan menjangkau: entitas dibundel dan di-push di bawah versi yang dideklarasikannya sendiri, dan siapa pun yang menarik versi tersebut dari registry tersebut akan me-resolve apa yang diterbitkan. Penerbitan juga satu-satunya operasi di antara ini yang mengubah sesuatu di luar mesin ini; kedua pemeriksaan dan inspeksi tidak menulis apa pun dan tidak menerbitkan apa pun. Keempatnya menampilkan kemajuan dan dapat dihentikan.
-
Detail panel Plugins — setiap baris menyebutkan plugin, tipe dan versinya, serta kesiapannya jika plugin membawanya. Plugin yang tidak dapat di-resolve atau dideskripsikan oleh kompiler ditandai dan tetap memiliki barisnya sendiri, dengan pesan kompiler di tooltip, sehingga tidak pernah disangka sebagai plugin yang berfungsi. Tooltip juga menyebutkan kunci konfigurasi asal sebuah lampiran, kapabilitasnya, jenis masukannya, batasnya, dan ekspornya — hanya menampilkan apa yang benar-benar dilaporkan daftar.
Operasi yang bekerja pada seluruh himpunan adalah dua baris pertama panel — Add plugin, dan Generate entities, yang menulis entitas katalog Plugin — dan bilah judul panel itu sendiri hanya memuat tombol muat ulang. Menambahkan menanyakan tipe plugin, sebagai daftar yang dapat Anda pilih, lalu satu jawaban lagi yang diperlukan tipe tersebut: kapabilitas yang dilayani binding
provider, atau peran tempat lampirangovernancediikat, dan terakhir nama yang dicari di registry yang dikonfigurasi, yang harus di-resolve menjadi tepat satu plugin dari tipe tersebut; lampiran ditulis ke konfigurasi ruang kerja proyek ini. Menambahkan adalah satu-satunya operasi di sini yang menjangkau jaringan, karena mencari di registry, sehingga menampilkan kemajuan dan dapat dihentikan. Jika versi plugin yang telah diterbitkan ditarik, penambahan diakhiri dengan menyatakan hal itu alih-alih membiarkannya ditemukan sendiri: versi yang ditarik dan tidak dipilih, alasan yang dicatat untuk masing-masing, serta dari mana catatan penarikan dibaca dan kapan terakhir diperbarui, hanya menampilkan apa yang dilaporkan kompiler — dan jika catatan tersebut sama sekali tidak dapat dibaca, hal itulah yang dinyatakan, beserta alasan dari kompiler sendiri, yang merupakan jawaban berbeda dari tidak ada yang ditarik.Membuat entitas katalog menanyakan apakah akan mencakup setiap plugin bawaan kompiler atau satu artefak plugin di mesin ini, juga sebagai daftar yang dapat Anda pilih, lalu overlay tertulis yang akan digabungkan dan direktori tujuan penulisan, dan meminta konfirmasi sebelum menulis: setiap entitas ditulis pada jalur yang diturunkan dari tipe, nama, dan versi plugin-nya, sehingga entitas yang sudah ada di sana untuk plugin dan versi yang sama akan diganti.
Menghapus plugin ada di baris plugin tersebut. Operasi ini meminta Anda mengonfirmasi terlebih dahulu dan menyebutkan file konfigurasi mana yang ditulisnya, karena hal itu bergantung pada tipe plugin — plugin
clidihapus dari konfigurasi global yang digunakan bersama oleh setiap ruang kerja di mesin ini, setiap tipe lainnya dari konfigurasi milik proyek ini sendiri — dan operasi ini hanya bekerja pada teks konfigurasi, sehingga tidak ada hal lain di mesin ini yang dihapus. Penghapusan hanya ditawarkan untuk plugin terkonfigurasi yang dijawab oleh kompiler: plugin bawaan kompiler sama sekali bukan entri konfigurasi, dan lampiran yang tidak dapat di-resolve atau dideskripsikan oleh apa pun datang tanpa tipe, yang dibutuhkan penghapusan di samping referensi — sehingga pada baris-baris tersebut penghapusan tidak ditawarkan alih-alih ditawarkan sebagai kontrol yang hanya dapat melaporkan argumen yang hilang. Menambahkan pluginclitidak ditawarkan dari panel, karena pemasangannya mengonfirmasi kapabilitas yang dideklarasikannya di terminal dan tidak ada terminal di balik sebuah tombol — jalankan dari terminal lalu tekan muat ulang. Menyinkronkan catatan milik mesin dari entitas plugin juga tidak ditawarkan: operasi ini menerima file entitas dan artefak.wasmsebagai dua jalur, dan sebuah baris tidak menyebutkan keduanya. -
Pencarian katalog yang diterbitkan — cari entitas katalog di registry yang dikonfigurasi dan salin referensi untuk ditempelkan ke dalam Aggregate. Pencarian dipersempit dari satu daftar tempat setiap faset menampilkan nilainya saat ini: teks bebas yang dicocokkan dengan nama dan deskripsi, satu atau beberapa jenis entitas, pemilih label (kategori adalah label), satu atau beberapa kapabilitas plugin, soket plugin, dan batas jumlah hasil yang dikembalikan. Faset yang dibiarkan tidak mempersempit apa pun. Apa yang Anda atur tetap disimpan: pencarian berikutnya dibuka dengan filter yang ditinggalkan pencarian terakhir, baik pencarian itu dijalankan, tidak menemukan kecocokan, maupun ditutup setelah diedit, sehingga mempersempit lagi cukup satu pengeditan alih-alih memasukkan seluruh filter dari awal. Reset search filter, baris tepat di atas Search, mengembalikan setiap faset ke keadaan tidak mempersempit apa pun dan membawa Anda kembali ke daftar tanpa mencari; deskripsinya menyebut faset yang akan dihapusnya, atau menyatakan bahwa tidak ada yang diatur. Filter hanya disimpan selama ekstensi berjalan di jendela itu dan tidak disimpan di mana pun — filter tidak ada di pengaturan mana pun, sehingga jendela lain mencari dari filternya sendiri, dan memuat ulang jendela, atau apa pun yang memulai ulang ekstensi editor, dimulai dari filter kosong. Pencarian membaca indeks lokal yang ditulis oleh
aggrega registry update— Update index di panel Registries — dan tidak menghubungi jaringan, sehingga registry yang indeksnya belum dibangun tidak dicari. Saluran output menyatakan hal itu di baris milik registry itu sendiri, dengan Update index untuk membangun indeksnya, dan menyatakan bahwa sebuah indeks sudah usang di baris tersendiri, dengan Update index untuk menyegarkannya; pencarian yang tidak menemukan kecocokan sementara registry semacam itu dikonfigurasi menyebut registry yang dicarinya dan yang tidak; dan jika tidak ada registry yang dikonfigurasi yang memiliki indeks sama sekali, pencarian melaporkan pesan kompiler sendiri yang menyebut langkah yang harus dijalankan.