La página de bienvenida
Página de bienvenida — la página propia de Aggrega en su propia pestaña del editor, que dice qué es Aggrega y luego enumera lo que la extensión necesita en este espacio de trabajo, marcando cada condición como Met o To do. Cada paso ofrece una forma de crear el elemento y una forma de señalar uno que ya tienes, explica la condición, y un paso que ya se cumple no te pregunta nada. Un paso marcado Met vuelve a To do si su condición deja de cumplirse. Un paso que ya se cumple se abre plegado, de modo que la página se abre en el trabajo que queda. Cada paso muestra también en qué estado se encuentra —la raíz del espacio de trabajo, el compilador, la Release, los registros—, más grande y con más peso que las indicaciones, precedido de Selected:, bajo el título cuando el paso está plegado y justo encima de los botones cuando está abierto, y lo dice con palabras donde aún no has elegido: None selected. donde hay algo que elegir, None available. donde no hay nada entre lo que elegir. Su pie incluye la casilla que decide si se abre al inicio, el mismo interruptor que contiene la pantalla de ajustes; debajo, las versiones de la extensión y del compilador que estás ejecutando, y por último si el language server se está ejecutando y qué versión informa. Un icono de casa en la barra de título del panel Commands la vuelve a abrir en cualquier momento. No ocupa espacio en la vista de Aggrega.
Welcome to Aggrega! se abre en su propia pestaña del editor. Explica qué es Aggrega y luego enumera lo que la extensión necesita en el espacio de trabajo que tienes abierto:
- Un espacio de trabajo que Aggrega reconoce — la detección descrita en Requisitos previos.
- Un compilador que este editor puede ejecutar — el binario
aggregaindicado enaggrega.server.binaryPath. - Una Release sobre la que actuar — la compilación, la vista previa y el grafo de topología actúan cada uno sobre una Release.
- Un registro desde el que resolver — la descarga de dependencias y la búsqueda en el catálogo publicado se resuelven contra los registros que indica tu configuración.
Cada paso explica para qué sirve la condición y cómo la alcanza el editor, de modo que la página es un lugar donde leer sobre el producto y no solo una lista de comprobación.

Cada paso ofrece más de un camino, y uno de ellos es siempre «Ya lo tengo». Puedes crear una configuración del espacio de trabajo o indicar al editor una carpeta que ya contiene una; usar el compilador de tu PATH, seleccionar una compilación que tengas en otro sitio o descargar una; redactar una Release o elegir una de las tuyas; inicializar el hub oficial, indicar tu propio registro o añadir uno a una configuración que ya tienes. Nada aquí es un callejón sin salida que te entrega un cuadro de diálogo de archivos y deja el paso aún pendiente.
Un paso que ya cumples aparece marcado y no te pregunta nada. La página lee lo que es cierto en lugar de hacer a todos las mismas preguntas, así que si creaste tu configuración desde la línea de comandos y luego abriste el editor, todos los pasos llegan ya marcados.
Cada paso se pliega, y la página se abre mostrando lo que todavía falta. Un indicador en la parte superior derecha de cada paso lo abre y lo cierra. Un paso cuya condición ya se cumple se abre plegado, y uno que no se cumple se abre con su explicación delante de ti; así, la lectura trata del trabajo que aún tienes y no del que ya has hecho. Un paso plegado conserva su título y todos sus botones, y solo oculta la explicación: una vez que sabes para qué sirve un paso, puedes seguir actuando sobre él sin volver a leerlo.
La disposición se decide cuando se crea la página y a partir de entonces es tuya. Un paso que pasa a cumplirse mientras lo estás leyendo actualiza su marca y sigue abierto —no se pliega bajo tu cursor—, y un indicador que pulsas se queda donde lo dejaste, por muchas veces que la página se actualice a su alrededor. Cerrar y volver a abrir la página vuelve a leer las condiciones y la reorganiza desde cero. Lo mismo ocurre con la página que se dibuja en lugar de una que tenías abierta cuando tu editor reinicia sus extensiones —como hace cuando se añade una carpeta a una ventana abierta en una sola carpeta—: la página que tenías se cierra y se dibuja una nueva en el mismo grupo de pestañas, esté o no configurada la página para abrirse al inicio, de modo que la ventana sigue conteniendo una sola página y esa página sigue al espacio de trabajo en el que estás.
Cada paso muestra también en qué estado se encuentra, para que la página responda a cuál y no solo a si: la raíz del espacio de trabajo, el compilador, la Release y los registros que declara la configuración. El valor se muestra más grande y con más peso que la explicación que lo rodea, porque un valor dibujado con el mismo peso que un muro de texto es uno que tienes que buscar. Un paso plegado lo muestra bajo el título, para que puedas confirmar tu selección sin desplegar nada; uno abierto lo muestra al pie de la explicación, justo encima de los botones, donde es lo último que se lee antes de actuar. Un valor elegido va precedido de Selected:, más pequeño y ligero que el propio valor, para que la etiqueta señale el valor en lugar de competir con él.

Donde aún no has elegido, el paso lo dice con palabras en lugar de dejar una línea en blanco, que parecería un fallo al dibujar la página, y distingue dos estados sobre los que el lector actúa de forma distinta. None selected. significa que hay algo que elegir y no has elegido nada. None available. significa que aquí no hay nada entre lo que elegir, así que pulsar «Ya tengo uno» del paso solo podría mostrarte una lista vacía, y lo que necesitas es su otro camino. Solo los dos pasos que ofrecen una lista pueden mostrar None available.: el espacio de trabajo y la Release. Un compilador se indica por su nombre y un registro se registra directamente, así que ninguno de esos dos pasos tiene una lista que pueda estar vacía. El paso de los registros conserva una tercera lectura, Not read yet., para cuando no se ha podido consultar al compilador: decirte que no has configurado ninguno cuando nada ha podido responder diría más de lo que la página sabe.
La marca de un paso sigue a su condición en ambos sentidos. Cada paso muestra su estado con palabras junto a la marca —Met o To do—, porque la marca en sí es un glifo, y un glifo solo deja su significado a la adivinación. Un paso muestra Met cuando su condición pasa a cumplirse y de nuevo To do si la condición deja de cumplirse más tarde: un compilador que deja de responder, una Release que se deselecciona. La página lee lo que es cierto cada vez que se actualiza en lugar de recordar lo que fue cierto en algún momento, así que nunca informa de algo que has perdido desde entonces. Donde una pérdida importa, también se informa donde ya estás mirando: la barra de estado indica un compilador que ha dejado de responder, y las filas Project folder, Aggrega workspace y Release en la parte superior del panel Commands indican la selección actual.
Es una pestaña normal del editor y no un cuadro de diálogo a propósito: cada paso te pide que señales algo de tu propio espacio de trabajo, y un cuadro de diálogo taparía los archivos que contienen las respuestas. Está en el área del editor en lugar de en la vista de Aggrega, así que no ocupa espacio en la barra lateral y puede decir qué es el producto, algo para lo que una columna estrecha no tiene sitio. Es la pestaña propia de Aggrega, que se abre y se cierra en sus propios términos, y no ofrece ningún camino a la página de bienvenida del propio editor.
La página incluye esa decisión al pie, centrada, y la Command Palette también la incluye. Ambas cambian el único ajuste aggrega.getStarted.show, que se escribe en tus propios ajustes y nunca en el repositorio, de modo que tu elección no llega a quien más lo abra. El control del pie es una casilla con el texto Show Aggrega welcome page on startup, marcada mientras la página se abre al inicio; así informa del ajuste tal como está en lugar de ofrecerte la acción que lo cambiaría. Desactívalo en la pantalla de ajustes y la casilla lo sigue; pulsa la casilla y la pantalla de ajustes la sigue. Es un solo interruptor en dos lugares y no dos interruptores. La casilla conserva el foco del teclado cuando se pulsa, así que la barra espaciadora la marca y la desmarca alternativamente.
Desactivarlo hace que la página deje de abrirse al inicio, no que quede fuera de alcance, y no es una puerta de un solo sentido: Aggrega: Get started en la Command Palette lo vuelve a activar y abre la página, y Aggrega: Stop opening the welcome page on startup es el camino propio de la paleta hacia el mismo ajuste.
El panel Commands ofrece un camino de vuelta a la página, junto al engranaje. Es el icono de la casa en la parte superior derecha, y su información sobre herramientas dice Open the welcome page; así, volver a la página es algo que encuentras mirando la vista de Aggrega y no algo que tienes que saber escribir. Abre la página y deja tu ajuste de inicio exactamente como lo dejaste: volver a mirar la página no lo reactiva. Eso lo hace el comando de la paleta, porque reactivarlo es una decisión y no un vistazo.
La página indica al pie lo que estás ejecutando. Allí hay dos lecturas de versión: Extension, qué compilación de esta extensión ha cargado tu editor, y Compiler, lo que el binario aggrega que ejecuta el language server dice de sí mismo. La lectura Extension se registra cuando se compila la extensión, a partir del estado de su código fuente en ese momento, con la misma forma que usa la compilación del propio compilador para su versión; así, una ventana de desarrollo, una copia instalada y una copia empaquetada a partir de un árbol modificado indican cada una cuál son:
- una etiqueta de versión sola, como
0.2.0, significa que la compilación es exactamente esa versión; - una etiqueta seguida de un recuento y un commit, como
0.2.0-3-g1a2b3c4, significa una compilación del commit1a2b3c4, tres commits después de esa versión; y un commit solo, como1a2b3c4, significa una compilación de ese commit cuando no lo precede ninguna versión; - un sufijo
-dirtyen cualquiera de ellos significa que la compilación se hizo a partir de una copia del código fuente con cambios que no se habían confirmado; devsignifica que la compilación se hizo donde no se pudo leer el historial del código fuente.
Ninguna de las dos lecturas está escrita en la página: ambas se leen cuando se dibuja la página, de modo que una compilación de desarrollo se identifica como tal en lugar de no mostrar nada, y reiniciar con otro compilador cambia la lectura. Donde no se puede obtener una lectura —la extensión se compiló sin registrar qué compilación es, no hay nada en ejecución a lo que preguntar o lo que se está ejecutando no respondió—, la etiqueta permanece e indica que no se informó de la versión, para que una lectura ausente nunca se confunda con una que no llegaste a ver.
La última línea de la página indica si el language server se está ejecutando y qué compilación es. Muestra Language server running, starting, not running o failed to start, con las mismas palabras que usan la barra de estado y las notificaciones; failed to start significa que el intento más reciente de iniciarlo falló y que desde entonces no se ha ejecutado ninguno. El canal de salida de Aggrega indica el motivo, y también lo hace la notificación que se muestra cuando falla el primer inicio o un reinicio. Mientras el servidor se ejecuta, la línea añade la versión de sí mismo que informó el servidor en ejecución cuando la extensión se conectó a él, escrita como la lectura Compiler escribe una versión. La lectura Compiler que hay encima es un hecho distinto: es lo que dice, cuando se le pregunta, el binario desde el que se inició el servidor, y ambas difieren cuando el archivo de esa ruta se reemplaza mientras el servidor iniciado desde él sigue ejecutándose, por eso la página muestra las dos. Un language server que no informa de su propia versión muestra allí version not reported, en lugar de tomar prestada la del binario. La línea y las dos lecturas que hay encima siguen al servidor cuando se inicia, se detiene, se reinicia o falla, sin necesidad de volver a abrir la página; los pasos conservan sus marcas durante un reinicio.