A página de boas-vindas
Página de boas-vindas — a página própria do Aggrega no seu próprio separador do editor, que diz o que é o Aggrega e depois lista aquilo de que a extensão precisa neste workspace, assinalando cada condição como Met ou To do. Cada passo oferece uma forma de criar o elemento e uma forma de apontar um já existente, explica a condição, e um passo já cumprido não pergunta nada. Um passo assinalado como Met volta a To do se a sua condição deixar de se verificar. Um passo já cumprido abre recolhido, pelo que a página abre no trabalho que falta. Cada passo mostra também o estado em que se encontra — a raiz do workspace, o compilador, a Release, os registries — apresentado maior e mais carregado do que as orientações, introduzido por Selected:, por baixo do título quando o passo está recolhido e imediatamente acima dos botões quando está aberto, e dizendo-o por palavras onde ainda não foi feita uma escolha — None selected. onde há algo para escolher, None available. onde não há absolutamente nada por onde escolher. O seu fundo contém a caixa de verificação que decide se abre no arranque, o mesmo interruptor que o ecrã de definições contém, por baixo as versões da extensão e do compilador em execução, e por último se o language server está em execução e que versão reporta. Um ícone de casa na barra de título do painel Commands volta a abri-la a qualquer momento. Não ocupa espaço na vista do Aggrega.
Welcome to Aggrega! abre-se no seu próprio separador do editor. Explica o que é o Aggrega e depois lista aquilo de que a extensão precisa no workspace aberto:
- Um workspace que o Aggrega reconhece — a deteção descrita em Pré-requisitos.
- Um compilador que este editor consegue executar — o binário
aggregaindicado emaggrega.server.binaryPath. - Uma Release sobre a qual agir — a compilação, a pré-visualização e o grafo de topologia agem cada um sobre uma Release.
- Um registry a partir do qual resolver — a obtenção de dependências e a pesquisa no catálogo publicado resolvem-se nos registries que a configuração indica.
Cada passo explica para que serve a condição e como o editor a cumpre, pelo que a página é um sítio onde ler sobre o produto e não apenas uma lista de verificação.

Cada passo oferece mais de um caminho, e um deles é sempre «Já tenho isto». É possível criar uma configuração de workspace ou apontar o editor para uma pasta que já contém uma; usar o compilador no PATH, selecionar uma compilação que se tem noutro local, ou transferir uma; rascunhar uma Release ou escolher uma das existentes; inicializar o hub oficial, indicar um registry próprio, ou adicionar um a uma configuração já existente. Nada aqui é um beco sem saída que entrega uma caixa de diálogo de ficheiros e deixa o passo ainda por fazer.
Um passo já cumprido aparece assinalado e não pergunta nada. A página lê o que é verdade em vez de fazer as mesmas perguntas a todos, pelo que, se a configuração foi criada a partir da linha de comandos e só depois se abriu o editor, todos os passos chegam já assinalados.
Cada passo recolhe-se, e a página abre a mostrar o que ainda falta. Uma seta no canto superior direito de cada passo abre-o e fecha-o. Um passo cuja condição já está cumprida abre recolhido, e um que não está abre com a explicação à vista — assim, a leitura incide sobre o trabalho que ainda falta e não sobre o que já foi feito. Um passo recolhido mantém o seu título e todos os seus botões, e oculta apenas a explicação: depois de se saber para que serve um passo, é possível agir sobre ele sem o voltar a ler.
A disposição é decidida quando a página é criada e, a partir daí, pertence ao utilizador. Um passo que fica cumprido enquanto está a ser lido atualiza a sua marca e permanece aberto — não se recolhe debaixo do cursor — e uma seta premida fica onde foi deixada, por muitas vezes que a página se atualize à sua volta. Fechar e reabrir a página volta a ler as condições e reorganiza-a de raiz. O mesmo acontece com a página desenhada no lugar de uma que estava aberta quando o editor reinicia as suas extensões — como faz quando se adiciona uma pasta a uma janela aberta numa única pasta: a página que estava aberta é fechada e é desenhada uma nova no mesmo grupo de separadores, quer a página esteja configurada para abrir no arranque quer não, pelo que a janela continua a conter uma página e essa página acompanha o workspace em que se está.
Cada passo mostra também o estado em que se encontra, para que a página responda a qual e não apenas a se: a raiz do workspace, o compilador, a Release e os registries que a configuração declara. O valor é apresentado maior e mais carregado do que a explicação à sua volta, porque um valor desenhado com o mesmo peso de uma parede de texto é um valor que é preciso procurar. Um passo recolhido mostra-o por baixo do título, para que seja possível confirmar a seleção sem expandir nada; um aberto mostra-o no fundo da explicação, imediatamente acima dos botões, onde é a última coisa lida antes de agir. Um valor escolhido é introduzido por Selected:, apresentado mais pequeno e mais leve do que o próprio valor, para que a etiqueta aponte para o valor em vez de competir com ele.

Onde ainda não foi feita uma escolha, o passo di-lo por palavras em vez de deixar uma linha em branco, que pareceria uma falha da página ao ser desenhada — e distingue dois estados perante os quais o leitor age de forma diferente. None selected. significa que há algo para escolher e nada foi escolhido. None available. significa que aqui não há absolutamente nada por onde escolher, pelo que premir «Já tenho um» do passo só poderia mostrar uma lista vazia, e o que se pretende é o seu outro caminho. Só os dois passos que oferecem uma lista podem apresentar None available. — o workspace e a Release. Um compilador é indicado pelo nome e um registry é registado diretamente, pelo que nenhum desses dois passos tem uma lista que possa estar vazia. O passo dos registries mantém uma terceira leitura, Not read yet., para quando não foi possível consultar o compilador: dizer que não foi configurado nenhum quando nada conseguiu responder diria mais do que a página sabe.
A marca de um passo acompanha a sua condição nos dois sentidos. Cada passo apresenta o seu estado por palavras ao lado da marca — Met ou To do — porque a marca em si é um glifo, e um glifo sozinho deixa o seu significado por adivinhar. Um passo apresenta Met quando a sua condição se torna verdadeira e de novo To do se a condição deixar mais tarde de se verificar — um compilador que deixa de responder, uma Release que é desselecionada. A página lê o que é verdade de cada vez que se atualiza em vez de se lembrar do que já foi verdade, pelo que nunca reporta algo que entretanto se perdeu. Onde uma perda importa, é também reportada onde já se está a olhar: a barra de estado mostra um compilador que deixou de responder, e as linhas Project folder, Aggrega workspace e Release no topo do painel Commands indicam a seleção atual.
É propositadamente um separador comum do editor e não uma caixa de diálogo: cada passo pede que se aponte algo no próprio workspace, e uma caixa de diálogo taparia os ficheiros que contêm as respostas. Encontra-se na área do editor e não na vista do Aggrega, pelo 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. É o separador próprio do Aggrega, alcançado e fechado nos seus próprios termos, e não oferece nenhum caminho para a página de boas-vindas do editor.
A página apresenta essa decisão no fundo, centrada, e a Command Palette também a apresenta. Ambas alteram a única definição, aggrega.getStarted.show, escrita nas definições pessoais do utilizador — nunca no repositório, para que a escolha não chegue a quem mais o abrir. O controlo no fundo é uma caixa de verificação com o texto Show Aggrega welcome page on startup, assinalada enquanto a página abre no arranque — assim, reporta a definição tal como está em vez de oferecer a ação que a alteraria. Desativando-a no ecrã de definições, a caixa acompanha; premindo a caixa, o ecrã de definições acompanha. É um único interruptor em dois locais e não dois interruptores. A caixa mantém o foco do teclado quando é premida, pelo que a tecla Espaço a assinala e desassinala alternadamente.
Desativá-la impede que a página abra no arranque sem a tornar inacessível, e não é uma porta de sentido único: Aggrega: Get started na Command Palette volta a ativá-la e abre a página, e Aggrega: Stop opening the welcome page on startup é o caminho da própria paleta para a mesma definição.
O painel Commands oferece um caminho de regresso à página, ao lado da roda dentada. É o ícone da casa no canto superior direito, e a sua dica diz Open the welcome page — assim, regressar à página é algo que se encontra olhando para a vista do Aggrega e não algo que é preciso saber escrever. Abre a página e deixa a definição de arranque exatamente onde foi deixada: voltar a olhar para a página não a reativa. Quem o faz é o comando da paleta, porque reativá-la é uma decisão e não um olhar.
A página indica, no fundo, o que está em execução. Aí encontram-se duas leituras de versão: Extension, a compilação desta extensão que o editor carregou, e Compiler, o que o binário aggrega executado pelo language server diz sobre si próprio. A leitura Extension é registada quando a extensão é compilada, a partir do estado do seu código-fonte nesse momento, na mesma forma que a compilação do compilador usa para a 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 a compilação é exatamente essa versão; - uma tag seguida de uma contagem e de um commit, como
0.2.0-3-g1a2b3c4, significa uma compilação do commit1a2b3c4, três commits depois dessa versão — e um commit sozinho, como1a2b3c4, significa uma compilação desse commit quando nenhuma versão o precede; - um sufixo
-dirtyem qualquer um destes significa que a compilação foi feita a partir de uma cópia do código-fonte com alterações que não tinham sido submetidas; devsignifica que a compilação foi feita onde o histórico do código-fonte não pôde ser lido.
Nenhuma das duas leituras está escrita na página — ambas são lidas quando a página é desenhada, pelo que uma compilação de desenvolvimento se identifica como tal em vez de não mostrar nada, e reiniciar com outro compilador altera a leitura. Onde não é possível obter uma leitura — a extensão foi compilada sem registar que compilação é, não há nada em execução a que perguntar, ou o que está em execução não respondeu — a etiqueta mantém-se e indica que a versão não foi reportada, para que uma leitura ausente nunca seja confundida com uma que passou despercebida.
A última linha da página indica se o language server está em execução, e que compilação é. Apresenta Language server running, starting, not running ou failed to start, com as mesmas palavras usadas pela barra de estado e pelas notificações; failed to start significa que a tentativa mais recente de o iniciar falhou e que nenhum foi executado desde então. O canal de saída do Aggrega indica o motivo, tal como a notificação emitida quando o primeiro arranque ou um reinício falha. Enquanto o servidor está em execução, a linha acrescenta a versão que o servidor em execução reportou sobre si próprio quando a extensão se ligou a ele, escrita da mesma forma que a leitura Compiler escreve uma versão. A leitura Compiler acima dela é um facto diferente: é o que o binário a partir do qual o servidor foi iniciado diz quando consultado, e as duas diferem quando o ficheiro nesse caminho é substituído enquanto o servidor iniciado a partir dele continua em execução, pelo que a página mostra ambas. Um language server que não reporta uma versão própria apresenta aí 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 arranca, para, reinicia ou falha, sem que a página seja reaberta; os passos mantêm as suas marcas durante um reinício.