Código, Git y archivos

El panel de editor está construido sobre Monaco, el mismo editor que impulsa VS Code, con un árbol de archivos a la izquierda y una barra de pestañas en la parte superior. Haz clic en un archivo del árbol para abrirlo; las pestañas muestran un punto cuando hay cambios sin guardar.

• Pestañas de vista previa vs. fijadas: un solo clic abre un archivo en una pestaña temporal (en cursiva) de vista previa; haz doble clic para fijarla.
• Guardar con Cmd/CtrlS. Guardar un búfer sin título pide una ubicación. Activa Format on save en Settings para ordenar los archivos automáticamente.
• Vista previa de Markdown: los archivos .md y .mdx obtienen un interruptor de vista previa en la esquina superior derecha.

El control de versiones vive en dos lugares que comparten las mismas filas, el mismo cuadro de confirmación y las mismas acciones: la barra lateral y la página Source Control del cuaderno. Ambos muestran tu árbol de trabajo en secciones de filas Staged, Unstaged y Untracked, cada archivo etiquetado con una insignia de estado y sus propios contadores de líneas +N y −N. Haz clic en un archivo para abrir su diferencia; usa los botones de sección para preparar o desmarcar todo.

Debajo de las filas de archivos se asienta un dock fijo de Commits: una línea de tiempo de las confirmaciones recientes con chips de referencia para la rama, la etiqueta o el pull request que apunta a cada una. Una fila de commit se expande en línea a los archivos que tocó, y Show older commits pagina más atrás. El dock conserva su lugar por mucho que crezca la lista de archivos, así que el historial nunca queda fuera de alcance.

Bajo la cabecera, una franja de sincronización te dice qué queda pendiente entre este checkout y su remoto, y lleva el botón que lo resuelve: 3 commits to push con un Push, mi-rama is not on origin yet con un Publish branch, o 2 commits to pull con un Pull. Una rama que divergió en ambos sentidos nombra las dos mitades y ofrece Pull primero. Cuando no queda nada pendiente, la franja no aparece.

Un cuadro de confirmación se sitúa en la parte inferior. Escribe un mensaje y pulsa Cmd/CtrlEnter (o haz clic en Commit) una vez que algo esté preparado. Hacer solo commit está bien: en cuanto aterriza, aparece un botón Push now justo debajo del cuadro, así que nunca tienes que buscar cómo subir el commit. Amend last reemplaza el commit anterior en lugar de añadir uno y precarga su mensaje, y funciona sin nada preparado cuando lo único que quieres es reescribirlo.

En la cabecera, Pull solo aparece cuando hay algo de dónde traer cambios, Push cuenta lo que espera (Push 3) y se lee como Publish branch mientras la rama todavía no tiene upstream, y un chip de pull request o merge request puede aparecer junto a ellos cuando tu rama tiene uno abierto.

El panel de Git del lienzo conserva la disposición anterior de tres pestañas: Changes, Log y Branches, con la misma cabecera, franja de sincronización y cuadro de confirmación.

Dos de las pequeñas tareas que rodean a un commit se pueden delegar. Un botón Generate en el cuadro de confirmación redacta un mensaje a partir de lo que has preparado, y el formulario de nueva rama convierte una descripción en lenguaje llano (“fix the flaky upload retry”) en un nombre de rama con el estilo de tu repositorio.

Ambos se ejecutan solo cuando haces clic, nunca en segundo plano, y ambos dejan el resultado editable, así que es un primer borrador y no una decisión. La diferencia preparada se lee donde vive y solo vuelve el texto redactado.

El botón Commit es un botón dividido. Su menú encadena los pasos que casi siempre haces juntos y luego te devuelve la ejecución paso a paso, para que veas exactamente hasta dónde llegó:

• Commit & Push, que pasa a ser Commit & Publish branch cuando la rama todavía no tiene upstream.
• Commit, Push & Pull request, que ejecuta esos mismos dos pasos y luego crea la solicitud a través del CLI de tu forja. En un remoto de GitLab la entrada se lee como Commit, Push & Merge request.

La entrada se nombra con el vocabulario de tu propia forja. Donde Deska no puede actuar, sigue visible pero deshabilitada con el motivo al lado: no hay remoto, es una forja que Deska no maneja, o el CLI de la forja no está instalado. En GitLab la entrada indica que Deska no puede crear merge requests ahí. Hoy GitHub es la forja en la que Deska puede completar el flujo, mediante el CLI gh.

El panel File Explorer es un navegador de archivos, no un árbol del proyecto. Abre en la carpeta donde está tu worktree y desde ahí va a donde quieras: dentro de una carpeta, de vuelta hacia afuera, y por encima del proyecto, por todo el disco.

• Doble clic en una carpeta para abrirla. El nombre de la carpeta en la barra superior es un menú con todas las carpetas que están por encima, y la ruta de abajo te saca de una en una con un clic.
• Tres vistas. Iconos (con vista previa de las imágenes), una lista con columnas ordenables de Nombre, Fecha, Tamaño y Tipo, y columnas para recorrer varios niveles a la vez. Cada panel recuerda la suya.
• Lugares en el lateral. Inicio, Escritorio, Documentos, Descargas, Aplicaciones, tus proyectos abiertos y cualquier volumen montado. Clic derecho en una carpeta para añadirla a Favoritos.
• El teclado funciona. Las flechas mueven, Enter abre, Cmd/CtrlUp sube a la carpeta contenedora, Cmd/Ctrl[ y Cmd/Ctrl] son atrás y adelante, y al escribir salta al nombre.
• Sigue conociendo Git. Dentro de un repositorio, los nombres llevan las mismas letras de estado (modificado, sin seguimiento, eliminado, en conflicto) que usa el resto de Deska.
• Clic derecho para el menú completo: nuevo archivo o carpeta, renombrar, duplicar, copiar, pegar, eliminar, abrir en una terminal, abrir como proyecto, o mostrar en el gestor de archivos de tu sistema. Los archivos ocultos son un interruptor en las opciones de vista.

1. Abre un archivo desde el explorador de archivos y haz tus ediciones en el editor.
2. Guarda con Cmd/CtrlS.
3. En la barra lateral de control de versiones (o en la pestaña Changes del panel de Git), haz clic en el archivo para revisar la diferencia, y luego prepáralo.
4. Escribe un mensaje de confirmación (o genera uno) y pulsa Cmd/CtrlEnter.
5. Haz Push desde la cabecera de Git, o usa el botón dividido de Commit para confirmar, publicar y abrir el pull request en una sola ejecución.

Las diferencias son de solo lectura y lado a lado: el original a la izquierda, tu copia de trabajo a la derecha, las adiciones en verde y las eliminaciones en rojo. Para editar, abre el archivo de la forma normal en lugar de a través de la diferencia. Dónde aparece la diferencia depende de dónde hiciste clic:

• Desde el árbol de archivos dentro de un panel de editor, la diferencia se abre como otra pestaña en ese mismo editor, marcada como diferencia en la tira de pestañas. Tus demás pestañas se quedan exactamente donde estaban, y una ruta es o bien una pestaña normal o bien una pestaña de diferencia, nunca ambas.
• Desde el panel de Git, la barra lateral de control de versiones o un File Explorer independiente, la diferencia se abre como su propio editor acoplado en la zona central, titulado con el nombre del archivo más Staged Diff o Working Diff.

Desde las páginas Source Control y Explorer del cuaderno, la diferencia se abre como una parada dentro de esa misma página en lugar de un editor acoplado, así que la revisión se queda en el propio recorrido del cuaderno.