A página de boas-vindas
Página de boas-vindas — a página do próprio Aggrega em sua própria aba do editor, que diz o que é o Aggrega e depois lista o que a extensão precisa neste workspace, marcando cada condição como Met ou To do. Cada etapa oferece um modo de criar o item e um modo de apontar um que você já tem, explica a condição, e uma etapa já atendida não pergunta nada. Uma etapa marcada como Met volta para To do se sua condição deixar de valer. Uma etapa já atendida abre recolhida, de modo que a página abre no trabalho que resta. Cada etapa também mostra em que estado se encontra — a raiz do workspace, o compilador, a Release, os registries —, exibido maior e mais pesado do que as orientações, introduzido por Selected:, sob o título quando a etapa está recolhida e logo acima dos botões quando está aberta, e dizendo isso em palavras onde você ainda não escolheu — None selected. onde há algo para escolher, None available. onde não há absolutamente nada para escolher. Seu rodapé traz a caixa de seleção que decide se ela abre na inicialização, o mesmo interruptor que a tela de configurações contém, abaixo dela as versões da extensão e do compilador que você está executando, e por último se o language server está em execução e qual versão ele relata. Um ícone de casa na barra de título do painel Commands a abre novamente a qualquer momento. Ela não ocupa espaço na visualização do Aggrega.
Welcome to Aggrega! abre em sua própria aba do editor. Ela explica o que é o Aggrega e depois lista o que a extensão precisa no workspace que você tem aberto:
- Um workspace que o Aggrega reconhece — a descoberta descrita em Pré-requisitos.
- Um compilador que este editor pode executar — o binário
aggregaindicado emaggrega.server.binaryPath. - Uma Release sobre a qual agir — o build, a pré-visualização e o grafo de topologia agem cada um sobre uma Release.
- Um registry a partir do qual resolver — o pull de dependências e a busca no catálogo publicado resolvem nos registries que a sua configuração indica.
Cada etapa explica para que serve a condição e como o editor a atinge, de modo que a página é um lugar para ler sobre o produto e não apenas uma checklist.

Cada etapa oferece mais de um caminho, e um deles é sempre “Eu já tenho isso”. Você pode criar uma configuração de workspace ou apontar o editor para uma pasta que já contém uma; usar o compilador no seu PATH, selecionar um build que você tem em outro lugar ou baixar um; rascunhar uma Release ou escolher uma das suas; inicializar o hub oficial, indicar seu próprio registry ou adicionar um a uma configuração que você já tem. Nada aqui é um beco sem saída que entrega a você uma caixa de diálogo de arquivos e deixa a etapa ainda por fazer.
Uma etapa que você já cumpriu aparece marcada e não pergunta nada. A página lê o que é verdade em vez de fazer as mesmas perguntas a todos, então, se você criou sua configuração pela linha de comando e depois abriu o editor, todas as etapas já chegam marcadas.
Cada etapa se recolhe, e a página abre mostrando o que ainda falta. Uma seta no canto superior direito de cada etapa a abre e a fecha. Uma etapa cuja condição já foi atendida abre recolhida, e uma que não foi abre com a explicação diante de você — assim a leitura trata do trabalho que ainda falta, e não do que você já fez. Uma etapa recolhida mantém seu título e todos os seus botões, e oculta apenas a explicação: depois que você sabe para que serve uma etapa, ainda pode agir sobre ela sem lê-la novamente.
A disposição é decidida quando a página é criada e, a partir daí, é sua. Uma etapa que passa a ser atendida enquanto você a lê atualiza sua marca e permanece aberta — ela não se recolhe sob o seu cursor —, e uma seta que você pressiona fica onde você a deixou, não importa quantas vezes a página seja atualizada ao redor dela. Fechar e reabrir a página lê as condições novamente e a reorganiza do zero. O mesmo vale para a página desenhada no lugar de uma que você tinha aberta quando o seu editor reinicia suas extensões — como acontece quando uma pasta é adicionada a uma janela aberta em uma única pasta: a página que você tinha é fechada e uma nova é desenhada no mesmo grupo de abas, esteja a página configurada para abrir na inicialização ou não, de modo que a janela continua contendo uma página e essa página acompanha o workspace em que você está.
Cada etapa também mostra em que estado se encontra, para que a página responda qual e não apenas se: a raiz do workspace, o compilador, a Release e os registries que a configuração declara. O valor é exibido maior e mais pesado do que a explicação ao redor, porque um valor desenhado com o mesmo peso de uma parede de texto é um valor que você precisa procurar. Uma etapa recolhida o mostra sob o título, para que você possa confirmar sua seleção sem expandir nada; uma aberta o mostra no pé da explicação, logo acima dos botões, onde é a última coisa lida antes de agir. Um valor escolhido é introduzido por Selected:, exibido menor e mais leve do que o próprio valor, para que o rótulo aponte para o valor em vez de competir com ele.

Onde você ainda não escolheu, a etapa diz isso em palavras em vez de deixar uma linha em branco, que pareceria uma falha da página ao ser desenhada — e distingue dois estados sobre os quais o leitor age de modo diferente. None selected. significa que há algo para escolher e você não escolheu nada. None available. significa que aqui não há absolutamente nada para escolher, então pressionar “Eu já tenho um” da etapa só poderia mostrar uma lista vazia, e o que você quer é o outro caminho. Apenas as duas etapas que oferecem uma lista podem exibir None available. — o workspace e a Release. Um compilador é indicado pelo nome e um registry é registrado diretamente, então nenhuma dessas duas etapas tem uma lista que poderia estar vazia. A etapa dos registries mantém uma terceira leitura, Not read yet., para quando não foi possível consultar o compilador: dizer que você não configurou nenhum quando nada pôde responder diria mais do que a página sabe.
A marca de uma etapa acompanha sua condição nos dois sentidos. Cada etapa exibe seu estado em palavras ao lado da marca — Met ou To do —, porque a marca em si é um glifo, e um glifo sozinho deixa seu significado para ser adivinhado. Uma etapa exibe Met quando sua condição se torna verdadeira e To do novamente se a condição depois deixar de valer — um compilador que para de responder, uma Release que é desmarcada. A página lê o que é verdade a cada atualização em vez de lembrar o que já foi verdade, então nunca relata algo que você já perdeu. Onde uma perda importa, ela também é relatada onde você já está olhando: a barra de status mostra um compilador que parou de responder, e as linhas Project folder, Aggrega workspace e Release no topo do painel Commands indicam a seleção atual.
Ela é propositalmente uma aba comum do editor e não uma caixa de diálogo: cada etapa pede que você aponte algo no seu próprio workspace, e uma caixa de diálogo cobriria os arquivos que contêm as respostas. Ela fica na área do editor e não na visualização do Aggrega, de modo que não ocupa espaço na barra lateral e pode dizer o que é o produto — algo para o qual uma coluna estreita não tem espaço. É a aba do próprio Aggrega, acessada e fechada em seus próprios termos, e não oferece nenhum caminho para a página de boas-vindas do editor.
A página traz essa decisão no rodapé, centralizada, e a Command Palette também a traz. Ambas alteram a única configuração, aggrega.getStarted.show, gravada nas suas próprias configurações — nunca no repositório, para que a sua escolha não chegue a quem mais o abrir. O controle no rodapé é uma caixa de seleção com o texto Show Aggrega welcome page on startup, marcada enquanto a página abre na inicialização — assim ela informa a configuração como está em vez de oferecer a ação que a mudaria. Desative-a na tela de configurações e a caixa acompanha; pressione a caixa e a tela de configurações acompanha. É um único interruptor em dois lugares, e não dois interruptores. A caixa mantém o foco do teclado quando pressionada, então a tecla Espaço a marca e desmarca alternadamente.
Desativá-la impede que a página abra na inicialização, mas não a deixa fora de alcance, e não é uma porta de mão única: Aggrega: Get started na Command Palette a reativa e abre a página, e Aggrega: Stop opening the welcome page on startup é o caminho da própria paleta para a mesma configuração.
O painel Commands oferece um caminho de volta à página, ao lado da engrenagem. É o ícone de casa no canto superior direito, e sua dica diz Open the welcome page — assim, voltar à página é algo que você encontra olhando a visualização do Aggrega, e não algo que você precisa saber digitar. Ele abre a página e deixa sua configuração de inicialização exatamente onde você a deixou: olhar a página novamente não a reativa. Quem faz isso é o comando da paleta, porque reativá-la é uma decisão e não uma olhada.
A página informa, no rodapé, o que você está executando. Ali ficam duas leituras de versão: Extension, qual build desta extensão o seu editor carregou, e Compiler, o que o binário aggrega executado pelo language server diz sobre si mesmo. A leitura Extension é registrada quando a extensão é compilada, a partir do estado do seu código-fonte naquele momento, na mesma forma que o build do compilador usa para sua versão — assim, uma janela de desenvolvimento, uma cópia instalada e uma cópia empacotada a partir de uma árvore editada dizem, cada uma, qual são:
- uma tag de versão sozinha, como
0.2.0, significa que o build é exatamente essa versão; - uma tag seguida de uma contagem e de um commit, como
0.2.0-3-g1a2b3c4, significa um build do commit1a2b3c4, três commits depois dessa versão — e um commit sozinho, como1a2b3c4, significa um build desse commit quando nenhuma versão o precede; - um sufixo
-dirtyem qualquer um desses significa que o build foi feito a partir de uma cópia do código-fonte com alterações que não tinham sido commitadas; devsignifica que o build foi feito onde o histórico do código-fonte não pôde ser lido.
Nenhuma das duas leituras está gravada na página — ambas são lidas quando a página é desenhada, de modo que um build de desenvolvimento se identifica como tal em vez de não mostrar nada, e reiniciar com um compilador diferente muda a leitura. Onde uma leitura não pode ser obtida — a extensão foi compilada sem registrar qual build é, não há nada em execução para consultar ou o que está em execução não respondeu —, o rótulo permanece e informa que a versão não foi relatada, para que uma leitura ausente nunca seja confundida com uma que você deixou de notar.
A última linha da página informa se o language server está em execução e qual build ele é. Ela exibe Language server running, starting, not running ou failed to start, com as mesmas palavras usadas pela barra de status e pelas notificações; failed to start significa que a tentativa mais recente de iniciá-lo falhou e nenhuma foi executada desde então. O canal de saída do Aggrega informa o motivo, assim como a notificação emitida quando a primeira inicialização ou uma reinicialização falha. Enquanto o servidor está em execução, a linha acrescenta a versão que o servidor em execução relatou sobre si mesmo quando a extensão se conectou a ele, escrita da mesma forma que a leitura Compiler escreve uma versão. A leitura Compiler acima dela é um fato diferente: é o que o binário a partir do qual o servidor foi iniciado diz quando consultado, e as duas diferem quando o arquivo nesse caminho é substituído enquanto o servidor iniciado a partir dele continua em execução, por isso a página mostra ambas. Um language server que não relata uma versão própria exibe ali version not reported, em vez de tomar emprestada a do binário. A linha e as duas leituras acima dela acompanham o servidor à medida que ele inicia, para, reinicia ou falha, sem que a página seja reaberta; as etapas mantêm suas marcas durante uma reinicialização.