Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Comandos

O que um comando faz quando você o executa

Todo comando termina em algo que você pode ver. Nada é bem-sucedido em silêncio, porque um comando que não diz nada parece exatamente um que nunca foi executado.

  • Escolher uma Release muda os dois indicadores e não gera notificação. Você já vê o resultado, e uma notificação sobre isso só ensinaria você a dispensar notificações sem lê-las.
  • Validate e lint informam quantos problemas encontraram — inclusive quando não encontraram nenhum. Uma execução limpa diz isso, em vez de deixar o painel Problems intocado e você se perguntando se o comando foi executado.
  • Draft entity e inspect terminam com o documento aberto em uma aba. Show config termina com um painel em vez de um documento, porque o que ele relata é uma lista de configurações para ler de cima a baixo, e não um arquivo para guardar.
  • Uma operação longa mostra o progresso com um botão Cancel. Isso abrange tudo o que acessa um registro, renderiza ou resolve uma Release, percorre o catálogo ou executa um plugin sobre a sua entrada: validate, lint, build, preview build, o grafo de topologia, pull, inspect, push, sign, deprecate e import. Redigir um documento, relatar a configuração efetiva e manter os caches não são nenhum desses casos, então são executados sem ele. Além disso, a manutenção de cache não pode ser interrompida de forma alguma — o compilador não tem como parar uma no meio —, então ela é coberta pela confirmação prévia, e não por um botão que só poderia fazer o editor parar de esperar.
  • Pressionar Cancel para o compilador, não apenas a espera do editor. Pelo servidor de linguagem, a extensão envia o cancelamento da requisição que emitiu; por um subprocesso, ela encerra o processo. O cancelamento de uma compilação tem efeito nos limites de fase da própria compilação, então uma fase pesada já em andamento termina primeiro — e é por isso que a mensagem diz que a operação foi parada, e não que parou instantaneamente. Em ambos os casos o resultado é relatado como stopped, nunca como falha.
  • Uma operação de cache que remove algo pergunta antes e nomeia os caches que vai atingir. Esvaziar e podar afetam os caches próprios deste workspace e os caches de módulos compilados e de plugin-describe compartilhados por todos os projetos nesta máquina, então essas confirmações nomeiam ambos. Aparar afeta apenas o cache compartilhado de módulos compilados, então sua confirmação nomeia esse e diz que os caches próprios do workspace não são tocados. Depois, uma mensagem diz o que foi removido e, quando houver, quanto foi deixado no lugar porque outro processo o mantém aberto; recusar diz que nada foi removido.
  • Push, sign e deprecate dizem o que agora é verdade para os consumidores — que a versão que você publicou é o que outros que a baixam agora resolvem, que a assinatura está lá para ser verificada, que o marcador de descontinuação é o que os resolvedores agora veem. Cada um nomeia o registro que alcançou e se algo de fato saiu desta máquina, com base no que o compilador fez e não no que foi pedido, então uma publicação que não depositou nada nunca é relatada como uma que depositou.
  • Uma falha mostra a própria mensagem do compilador, com um botão ao lado, nunca um resumo reformulado no lugar dela. A mensagem do compilador geralmente nomeia o que executar ou o que corrigir, e o botão Show output leva você ao texto completo no canal de saída do Aggrega. Uma operação que executa o binário aggrega e é recusada nomeia o status com que o binário terminou e depois as palavras que ele escreveu ao recusar, sem alteração, e o canal de saída termina com a mesma frase, linha por linha. Uma inspeção recusada por causa do documento que declara a entidade oferece Open document em vez disso, porque é desse documento que a mensagem trata e o canal não contém nada além disso.

Os comandos

A Paleta de Comandos filtrada para os comandos do Aggrega.

  • Aggrega: Get started — traz de volta a página de boas-vindas depois que você a desativou, e a abre. Ele reativa aggrega.getStarted.show, de modo que desativar a página é uma escolha que você pode desfazer, e não uma porta que se tranca atrás de você. Marcar a caixa de seleção no rodapé da página reativa a mesma configuração e não abre nada: a página é aquela em que você está, então a caixa mantém o foco do teclado e a tecla Espaço a marca e desmarca alternadamente. O ícone de casa na barra de título do painel Commands é outra coisa: ele abre a página e não altera nenhuma configuração, de modo que dar uma olhada na página nunca é também uma decisão sobre a inicialização.

  • Aggrega: Stop opening the welcome page on startup — impede que a página de boas-vindas abra na inicialização, desativando aggrega.getStarted.show nas suas próprias configurações. Isso impede que ela apareça sem ser pedida, em vez de colocá-la fora de alcance: Aggrega: Get started a traz de volta. Desmarcar a caixa de seleção no rodapé da página executa este mesmo comando, de modo que a decisão pode ser tomada de onde a página está sendo lida, assim como da paleta.

  • Aggrega: Open settings — abre as preferências desta extensão. É também a engrenagem no canto superior direito do painel Commands. Abre a própria página de configurações do editor filtrada para esta extensão, de modo que há um lugar onde uma preferência fica e um lugar onde ela é gravada. Diferente de Show config, que relata o que o compilador resolveu para o workspace, e não como o seu editor está configurado.

  • Aggrega: Select Release… — escolhe a Release com que o editor trabalha. Tem efeito imediato, verifica de novo os arquivos abertos em relação a ela e faz o painel Catalog ler sua lista de novo; nada é reiniciado. Também acessível clicando no indicador de Release na barra de status. Veja Como selecionar uma Release.

  • Aggrega: Set the selected Release as this workspace’s default — registra a Release selecionada em .aggrega/active-release, para que uma sessão posterior comece nela. O servidor de linguagem grava o arquivo, e recusa, com as próprias palavras, onde .aggrega ou o marcador é um link que leva para fora do workspace Aggrega. Local ao seu checkout, e não altera a seleção atual.

  • Aggrega: Set authoring_release in .aggrega-config.yaml… — abre o arquivo de configuração para definir build.authoring_release, o padrão versionado que uma equipe compartilha. Tem precedência sobre o arquivo marcador. Um arquivo de configuração que o servidor de linguagem informa ser um link que leva para fora do workspace Aggrega não é aberto, e um erro diz por quê.

  • Aggrega: Select Compiler Version — escolhe a versão do compilador aggrega que esta máquina executa, entre as versões com que esta extensão funciona, após um aviso que você confirma; a nova versão substitui a anterior somente depois que o servidor de linguagem tiver iniciado com ela. Veja Como obter o compilador.

  • Aggrega: Start or restart the language server — inicia o servidor de linguagem onde nenhum está em execução e, onde há um, encerra-o e inicia um novo, zerando o contador de tentativas de reinicialização. Ele nunca fica fora da paleta de comandos: iniciar é o que ele faz, então ocultá-lo enquanto nada está em execução o ocultaria justamente na única situação que precisa dele. Também acessível clicando no indicador do servidor de linguagem na barra de status. Onde nenhuma pasta na janela é uma que o Aggrega reconhece, ele diz isso em vez de parecer não fazer nada.

  • Aggrega: Toggle the artifact-rendering stage while inspecting — alterna no lugar a configuração aggrega.server.buildOnInspect, de modo que a interface de configurações sempre concorde com ela, e oferece a reinicialização que a aplica — o servidor de linguagem lê a configuração ao iniciar. Também acessível pelo menu de ações rápidas da barra de status, que mostra se a configuração está ativada no momento. A etapa adiciona os avisos que aggrega build emite durante a renderização, e nenhuma das verificações em que um build é interrompido. Os achados chegam marcados com a camada que os emitiu, de modo que os avisos da etapa se agrupam separados da validação no painel Problems e são limpos independentemente dela. A reinicialização que aplica a mudança esvazia o painel Problems e verifica de novo os arquivos abertos, então, com a etapa desativada, seus avisos saem dele e, com ela ativada, voltam na próxima vez que o grafo for desenhado.

  • Aggrega: Validate active file / Build / Preview build / Lint — executam a operação correspondente do compilador por meio do servidor de linguagem. Build, preview build e pull atuam sobre a Release selecionada em vez de perguntar a cada vez. Build compila a Release selecionada com todas as verificações ativadas e grava os artefatos que gera em um diretório dist/ na sua pasta de projeto, de modo que eles chegam ao lado do trabalho que você escolheu abrir — ou, quando nenhuma pasta de projeto está escolhida ou a escolhida não está dentro do seu workspace do Aggrega, no diretório dist/ na raiz do workspace do Aggrega — e a linha final do build e sua notificação informam o diretório em que ele gravou. aggrega build executado em um terminal grava no diretório dist/ na raiz do workspace do Aggrega de onde quer que seja executado, então, com uma pasta de projeto abaixo dessa raiz, o editor e o terminal gravam em dois diretórios diferentes; preview build executa a mesma compilação e informa o que teria gravado, sem tocar no diretório de saída.

    No painel Commands, o botão Build tem ao lado uma seta, chamada Build options, que abre as opções que se aplicam ao próximo build — Auto pull resolve as dependências da Release selecionada no lockfile antes da renderização, e fica desativada a menos que você a ative, que é o padrão da própria linha de comando para a mesma escolha. Enquanto Build não pode ser executado, a seta fica onde está, esmaecida, e apontar para ela mostra o motivo pelo qual Build não pode ser executado; ela não abre nada até que Build possa ser executado. Cada opção tem ao lado uma caixa — vazia enquanto está desativada, marcada enquanto está ativada — para que você possa ler seu estado sem pressionar nada, e a frase que diz o que ativá-la faz aparece enquanto você aponta para a linha ou depois que a alcançou com as teclas de seta. Alternar uma opção não executa nada e deixa a lista aberta, para que você possa alternar outra; pressionar Build — ou a seta de novo — fecha a lista. As opções duram a sessão e não são gravadas em lugar nenhum, então fechar a janela as descarta, e elas pertencem somente ao Build: preview build informa o que um build gravaria sem gravar nada disso, e resolver dependências grava o lockfile, então ele não aceita nenhuma opção.

    Ambos colocam no painel Problems os resultados que têm uma posição no documento, marcados com a camada que os gerou — entre eles uma recusa que o compilador gera durante a renderização, registrada no documento que ela nomeia, como a Recipe cujo Workload ele recusou, com seu código curto abrindo a página que a explica, enquanto o build ou a prévia termina com as próprias palavras do compilador no canal de saída e em uma notificação — e gravam os avisos que não nomeiam nenhuma posição — um pin retirado, um pai que não pode ser resolvido — no canal de saída do Aggrega junto com a lista de artefatos. Fechar um arquivo tira seus próprios resultados do painel Problems e mantém o que um build, uma prévia ou um grafo encontrou nele: esses resultados dizem respeito à Release, e não ao arquivo que você tinha aberto, então permanecem até que o compilador pare de reportá-los. Um Build, uma Preview ou um grafo que o compilador recusa porque uma dependência não se resolve também coloca essa recusa no painel Problems — no documento que o compilador nomeia, ou na Release quando ele não nomeia nenhum — e ela permanece durante a abertura e o fechamento desse arquivo, até que o próximo Build, Preview ou grafo dessa Release seja respondido sem ela.

    Um build com Auto pull grava, antes deles, o que sua resolução de dependências fez: uma linha para cada referência que fixou, com a versão para a qual ela foi resolvida, seu tipo quando o compilador nomeia um e, quando o compilador o informa, de onde esta execução obteve a referência, na palavra que aggrega pull --detail imprime para ela — fetched-fresh, cache-reuse, local, in-binary ou external — e depois o resumo que aggrega pull imprime em um terminal, Pull complete: seguido do lockfile gravado, nomeado a partir da raiz do workspace, e das contagens do que a resolução registrou.

    Lint verifica as convenções de publicação e coloca cada resultado no painel Problems, de modo que clicar em um abre a entidade a que ele se refere. Cada um é marcado com o código curto que aggrega lint imprime para a regra que o produziu, e a marcação abre a página que explica esse código; uma regra que não tem código curto é marcada com o próprio nome. Um resultado localizado em um arquivo, mas não em uma linha, fica no topo desse arquivo em vez de em uma posição adivinhada, e cada resultado também é gravado no canal de saída do Aggrega, abaixo do documento a que se refere, como a linha que aggrega lint imprime para ele: sua gravidade, o código curto da regra, a identidade da própria regra e a redação da própria regra, inalterada. Quando sua configuração dá às suas Releases diretórios de catálogo próprios em workspace.releases, Lint verifica o catálogo uma vez para cada Release, sobre os diretórios que essa Release lê — Releases que leem os mesmos diretórios são verificadas juntas — e reporta cada verificação separadamente: o canal de saída a abre com a linha com que aggrega lint a abre, nomeando suas Releases e os diretórios lidos, e lista abaixo seus resultados; a notificação final informa o que cada verificação encontrou e em quantas entidades, para suas próprias Releases; e cada entrada de Problems termina nomeando as Releases cuja verificação a encontrou, de modo que um resultado em um diretório que duas verificações leem é listado uma vez para cada uma.

    Os quatro informam quantos resultados produziram, inclusive quando a resposta é nenhum, de modo que uma execução limpa se distingue de um comando que não foi executado; os quatro mostram o progresso com um botão Cancel enquanto trabalham.

  • Aggrega: Pull — executa o binário aggrega sobre a Release selecionada e transmite sua saída para o canal de saída do Aggrega. Ele resolve no cache as dependências de catálogo e de código-fonte que a Release declara e grava o lockfile por Release, registrando nesse lockfile as entradas externas que a renderização da Release consome, para que um build posterior as sirva a partir do armazenamento local. Ele acessa um registro, então mostra o progresso com um botão Cancel, e termina com uma mensagem dizendo o que fez. Um Build, uma Preview ou um grafo que você abre e que o compilador recusa porque a Release não tem lockfile termina em uma única notificação, Aggrega: <release> has no lockfile. seguida da própria frase do compilador, com um botão Pull: pressioná-lo executa este comando, com o binário com que a extensão está configurada, para a Release que o compilador nomeou — ou para a Release selecionada onde o compilador não nomeou nenhuma — e o canal de saída traz a frase do compilador na linha com que a operação termina. Um redesenho que você não pediu, como um grafo aberto redesenhado após salvar, gera o mesmo aviso no máximo com a frequência que as duas configurações aggrega.notifications permitem. Seja o que for que grave o lockfile da Release selecionada — este comando, um build com Auto pull ou aggrega pull digitado em um terminal —, os arquivos abertos são verificados de novo em relação a ele, e um aviso de que o lockfile divergiu sai sozinho do painel Problems assim que a gravação o resolve: um grafo aberto nessa Release é redesenhado, o que verifica o lockfile de novo, e onde nenhum grafo mostra essa Release — nenhum está aberto, ou o que está aberto ainda mostra uma Release que você selecionou antes —, a extensão pede o grafo dela uma vez sem desenhar nada. Somente o lockfile da Release selecionada é acompanhado dessa forma, e somente dentro das pastas que a janela tem abertas; um aviso sobre o lockfile de outra Release permanece até você mostrar o grafo dessa Release.

  • Aggrega: Draft entity… — você escolhe um tipo entre aqueles para os quais o compilador responde; então um documento inicial é solicitado ao servidor de linguagem e aberto em uma nova aba não salva. Os tipos são solicitados em vez de mantidos na extensão, então a escolha acompanha o compilador que você está executando: um tipo que ele ganhe é oferecido sem que esta extensão seja alterada. Você lê o nome que o seu documento terá, e o rascunho é solicitado pelo próprio token do compilador para esse tipo — e o prompt que depois pede um nome diz qual tipo está nomeando, nas mesmas palavras que você acabou de ler. Nada é gravado em disco: o rascunho é seu para editar, salvar ou descartar. Uma invocação que nomeia um tipo que o compilador não reconhece — um atalho de teclado ou um fluxo gravado pode trazer um — volta com a própria mensagem do compilador nomeando os tipos que ele reconhece. É também a segunda linha do painel Catalog, Draft entity.

  • Aggrega: Inspect… — você escolhe uma entidade que o workspace consegue ver e vê para o que ela é resolvida, aberta em uma nova aba. Uma inspeção é endereçada por nome, então uma entidade resolvida a partir de um diretório de catálogo configurado é oferecida aqui tanto quanto uma que o workspace declara. Ela é resolvida nos termos da Release selecionada, e as entidades oferecidas são as que o painel Catalog lista para essa Release: um nome que várias variantes declaram, uma por Release, é resolvido para a da Release selecionada, e um nome que essa Release não resolve é relatado como não resolvido, com o motivo do compilador, que nomeia a entrada dessa Release em workspace.releases. Sem nenhuma Release selecionada, ela é resolvida pelos diretórios de catálogo próprios do workspace. Onde um documento no workspace declara a entidade e o catálogo não resolveu nada a partir dele — o documento viola o schema do seu tipo, por exemplo, ou está fora de todo diretório de catálogo —, a notificação diz que a entidade não pode ser inspecionada por causa do documento que a declara, seguida da própria frase do compilador dizendo o que está errado, e seu botão Open document abre esse documento; o canal de saída do Aggrega traz a mesma frase. Uma inspeção recusada por qualquer outro motivo termina como qualquer operação que falhou. Ler quais entidades o workspace contém mostra o progresso e pode ser interrompido, assim como a resolução que vem em seguida. Quando o comando é pressionado no painel Commands, as entidades são oferecidas como um menu ao lado do botão; executado daqui, são oferecidas como uma lista em que você escolhe. A inspeção que uma linha do painel Catalog oferece é esta, e termina da mesma forma.

  • Aggrega: Import into Aggrega — veja Importar para o Aggrega.

  • Aggrega: Cache… — escolha uma operação de cache e execute-a por meio do servidor de linguagem. Quando acionado no painel Commands, as quatro são oferecidas como um menu ao lado do botão; executadas daqui, são oferecidas como uma lista para você escolher. Nenhum processo é iniciado, e cada resposta volta como um resultado estruturado que o painel exibe: status lista cada cache, o que ele contém e até que ponto cada um é compartilhado, e não remove nada; prune remove as entradas que nenhum lockfile referencia e nomeia o que manteve, junto com tudo o que não tinha base para recuperar e a operação que o faria; evict pede primeiro um limite de tamanho — uma quantidade de bytes como 5GiB ou 512MiB, ou um número de bytes, lido pelo mesmo analisador que a linha de comando usa — e reduz o cache compartilhado de módulos compilados até esse limite; clear esvazia todos os caches. As três que removem algo pedem confirmação primeiro, e cada confirmação nomeia os caches que essa operação realmente alcança: esvaziar alcança os caches próprios deste workspace para entidades, artefatos de origem e entradas externas e os caches de módulos compilados, de descrições de plugins, de pacotes de documentação e de plugins de CLI que todos os projetos desta máquina compartilham; podar alcança os mesmos caches do workspace e os caches compartilhados de módulos compilados, de descrições de plugins e de plugins de CLI; e reduzir alcança apenas o cache compartilhado de módulos compilados. Cada tamanho que essas operações informam é escrito no mesmo vocabulário em que esse limite é lido, de modo que um valor que você lê em um relatório de cache é um que você pode digitar diretamente no pedido do limite. Um limite que o compilador não consegue ler volta com a própria mensagem do compilador indicando como é um limite de tamanho. Caches esvaziados e reduzidos são preenchidos novamente no próximo build que precisar deles. O Windows se recusa a remover um arquivo que outro processo mantém aberto, e uma poda, uma redução ou um esvaziamento o deixa então no lugar e continua com o resto em vez de falhar: o canal de saída do Aggrega nomeia cada entrada que uma poda ou uma redução deixou, com sua classe, até que ponto é compartilhada e seu tamanho, e informa, sob cada cache alcançado por um esvaziamento, quantos arquivos deixou ali e o tamanho deles; a mensagem com que a operação termina diz quantos foram deixados no lugar, pede que você execute a operação novamente quando esse processo tiver terminado e indica o canal para saber quais. Onde nada foi deixado no lugar, o que acontece em toda execução em uma plataforma que remove um arquivo aberto, nenhuma das duas diz nada a respeito.

  • Aggrega: Push… / Sign… / Deprecate… — as operações que mudam o que outras pessoas resolvem. Push pergunta qual das entidades listadas no painel Catalog publicar — um menu ao lado do botão no painel Commands, uma lista para escolher quando executado daqui — e então a empacota e a publica em um registro configurado. Sign e deprecate pedem uma referência a um artefato já publicado, porque ambas alteram bytes publicados em vez do workspace: sign anexa uma assinatura, deprecate anexa um marcador de descontinuação assinado e pede a severidade — warning, error ou retracted — e o motivo que ele registra. As três passam pelo servidor de linguagem, as três mostram o progresso com um botão Cancel que encerra a publicação e não apenas a espera, e cada uma termina nomeando o que o compilador de fato fez: a referência e a versão para as quais a entidade foi resolvida e o digest para o qual essa versão agora aponta, o digest com o qual cada assinatura se compromete, ou o próprio digest do marcador. Uma publicação que encontrou os mesmos bytes já publicados diz isso, em vez de se apresentar como uma que depositou algo. Suas constatações e o relato completo vão para o canal de saída do Aggrega.

  • Aggrega: Show config — abre um painel que lista cada configuração declarada pelo esquema de configuração, gerado a partir desse esquema para que as configurações, seus nomes, seus valores padrão e o que elas aceitam tenham um único lugar e uma configuração nova apareça sem nenhuma mudança aqui. O painel abre como uma tabela com uma linha por configuração, abaixo de uma linha de cabeçalho para cada grupo da configuração — workspace, build, plugins, mcp, signing e os demais —, com as configurações de nível superior primeiro. Cada linha traz a configuração como você a escreveria no arquivo, seu nome por extenso, seu valor, o que a configuração aceita e de onde o valor veio. O nome é derivado da chave: uma sigla é escrita em maiúsculas e, onde os nomes de duas configurações seriam lidos da mesma forma, o grupo em que cada uma está é acrescentado, de modo que duas linhas nunca compartilhem um nome. A única coluna de valor diz o que se aplica agora: um valor definido em um arquivo ou no ambiente, ou um que não é o valor padrão declarado pelo esquema, é marcado com ●, e apontar para a marca diz por quê e qual é o valor padrão declarado — é assim que você encontra as configurações que alterou; uma configuração sem valor em vigor mostra none, e uma lista vazia mostra [].

    O complemento aditivo de uma lista — workspace.catalog_dirs_append ao lado de workspace.catalog_dirs, por exemplo — não tem linha própria: ele é nomeado sob o caminho da sua lista, e a linha da lista mostra o único valor e a única origem que o relatório do compilador atribui aos dois juntos, o que não diz quais entradas o complemento acrescentou. Uma configuração que pertence à máquina em vez de a um único projeto — um registry e sua política de confiança de assinaturas, o cache de módulos compilados, a lista de plugins que contribuem comandos — é marcada como Global na sua linha. A descrição da configuração fica atrás de um pequeno círculo marcado com i na última coluna, intitulada Description, o que mantém fora da linha a coisa mais longa que uma configuração carrega: clique nele ou passe o ponteiro sobre ele para ler a descrição, com qualquer código que ela cite exibido como código. O caminho de uma configuração só quebra depois de _ ou ., e um valor ou um caminho de arquivo só depois de /, . ou _ ou em um espaço, de modo que nada é cortado no meio de uma palavra.

    Ainda assim, a tabela é mais larga que um painel encaixado e rola lateralmente nele, e a chave da configuração continua visível enquanto isso, de modo que o valor até o qual você rola sempre tem ao lado a configuração a que pertence; a legenda acima da tabela quebra conforme a largura do painel. Cada cabeçalho de coluna com rótulo tem um canto de redimensionamento na borda direita: arraste-o para alargar ou estreitar essa coluna. Alargar uma coluna não alarga a tabela, então a coluna segue o ponteiro enquanto as outras colunas têm espaço a ceder e para quando todas estão na largura mínima; onde o painel é estreito demais para a tabela mesmo na largura mínima — encaixado na barra lateral, por exemplo —, cada coluna já está lá e os cantos não movem nada. Uma coluna para de estreitar no trecho mais largo que não pode quebrar — seu cabeçalho, uma palavra do nome de uma configuração, ou a parte de um caminho ou de um valor entre dois pontos onde pode quebrar — e a coluna da configuração mantém uma largura mínima própria; todo o resto em uma coluna estreitada quebra dentro dela em vez de invadir a seguinte. O painel não executa nenhum script, e daí decorrem três limites: uma largura que você define dura apenas até o painel ser desenhado de novo, então mudar para a outra forma, pressionar Show config novamente ou reabrir o painel desenha cada coluna do zero na largura que a tabela lhe dá; uma coluna não pode ser ajustada ao conteúdo sob demanda, com um clique duplo ou de outro modo; e o canto é alcançado com o ponteiro, não com o teclado.

    Um controle acima da tabela alterna para uma segunda forma que dá a cada configuração um bloco próprio, com sua descrição e seu alcance mostrados no lugar e a regra da marca Global enunciada no topo, e o painel reabre na forma que você usou por último. Cada configuração mostra o valor em vigor e, onde o compilador consegue dizer, de qual arquivo esse valor veio. O relatório do compilador atribui cada configuração, o complemento de uma lista na própria linha da sua lista; onde ele não nomeia uma configuração em lugar nenhum — um relatório que não pôde ser lido, por exemplo —, o painel diz isso em vez de sugerir uma origem que não tem: essa configuração é mostrada com seu valor padrão declarado, marcado como a declaração e não como uma leitura, e sem origem, e a caixa no topo do painel nomeia cada uma delas.

    Pressionar Show config com o painel aberto o traz para a frente e lê a configuração de novo. Onde a configuração não pode ser lida, o clique fecha o painel, esteja ele aberto ou não, e uma notificação diz por quê; onde o motivo é que o servidor de linguagem não está em execução, a notificação oferece Start, que executa Aggrega: Start or restart the language server. O painel relata; ele não escreve. Alterar uma configuração é editar o arquivo de configuração.

  • Aggrega: Show topology graph — abre o grafo de topologia da Release selecionada. Desenhá-lo compila essa Release até sua topologia, por isso mostra o progresso com um botão Cancel.

  • Aggrega: Attach a Feature to the connection at the cursor — anexa uma Feature a uma conexão a partir da entrada dela no seu documento. Ele está no menu de contexto do editor e na paleta de comandos, e apenas em um documento que o servidor de linguagem informa como um dos Aggregates ou das Releases do workspace. Ele pergunta ao servidor de linguagem dentro da entrada de qual conexão o cursor está, nos termos da Release selecionada, como os demais recursos do cursor: a entrada com que um componente traça uma conexão, sob o alias da conexão, ou a entrada que uma Release escreve para uma. Em uma entrada assim, ele abre o grafo de topologia na Release selecionada com essa conexão selecionada, e você anexa pela seção May attach dele como depois de clicar na aresta da conexão, exceto que a entrada é escrita no documento em que você executou o comando. Em qualquer outro lugar, ele não abre nada e diz por quê: o cursor não está dentro da entrada de uma conexão, uma Feature traçou a conexão, ou a entrada da Release é para uma conexão que o grafo compilado dela não contém. Sem Release selecionada, ele oferece selecionar uma, como faz Aggrega: Show topology graph, e uma recusa do servidor de linguagem é mostrada nas palavras dele. Alterações não salvas são enviadas primeiro ao servidor de linguagem, de modo que o cursor é lido em relação ao texto que você vê.

  • Aggrega: Search published catalog — abre a lista de filtros, restringe a busca por texto livre, tipo, rótulos, capacidade, socket de plugin ou um limite de resultados, depois a executa e copia uma referência encontrada. Cada faceta é editável em qualquer ordem e volta à lista, de modo que o filtro inteiro pode ser lido antes de ser executado. Enquanto a extensão estiver em execução na janela, a lista abre com o filtro que a última busca deixou, e Reset search filter, logo acima de Search, limpa todas as facetas sem buscar. Uma busca que não encontrou nada nomeia o filtro que executou e, onde um registro configurado ainda não tem índice, os registros em que buscou, depois aqueles em que não buscou e como construir o índice deles; essa é uma resposta diferente de um índice que não pôde ser lido de forma alguma — a segunda informa a própria mensagem do compilador e o texto completo vai para o canal de saída do Aggrega, junto com a linha de atualidade que nomeia cada registro consultado e quando seu índice foi atualizado pela última vez. É também a primeira linha do painel Catalog, Search catalog.

  • Aggrega: Refresh plugins — recarrega o painel Plugins.

  • Aggrega: Refresh registries — relê os registros configurados. Isso não contata nenhum registro, então repetir custa pouco.

  • Aggrega: Refresh workspace catalog — pergunta novamente ao servidor de linguagem quais entidades o workspace pode ver. Isso lê o workspace que o servidor já tem aberto e não contata nenhum registro, então repetir custa pouco. O painel pergunta novamente por conta própria quando o servidor de linguagem passa a poder responder, quando a Release selecionada muda, depois que um documento é criado, alterado ou excluído no disco e depois que o editor fecha um, então este comando serve para o que nenhum desses casos cobre, como uma alteração ainda em um buffer não salvo. Ele fica na barra de título do painel Catalog, onde é o único item: relê essa lista em vez de agir sobre o que a lista contém, por isso pertence ao painel e não ao workspace.