Compilador del lenguaje PICTURE (PinkOS Interface Construction Terminology for UI Representation & Events) - Un lenguaje declarativo basado en indentación para construir interfaces de usuario para el sistema operativo experimental PinkOS.

Este proyecto implementa un compilador usando Flex y Bison que traduce código PICTURE a C para el runtime de PinkOS.

• Requirements
• Inicio Rápido
• Sintaxis PICTURE
• Configuration
• Commands
• CI/CD
• Recommended Extensions

• Docker v28.3.2

# Usando Docker (recomendado)
docker compose run --rm compiler bash src/main/bash/build.sh

# O localmente (requiere flex, bison, cmake, gcc)
bash src/main/bash/build.sh

El compilador lee desde stdin y escribe a stdout:

# Procesar un archivo .pic
./.build/Flex-Bison-Compiler < src/test/c/accept/10-nested-with-selection-order

# Guardar el resultado en un archivo
./.build/Flex-Bison-Compiler < mi_archivo.pic > salida.c

# Ver solo errores (redirigir stderr)
./.build/Flex-Bison-Compiler < mi_archivo.pic 2>/dev/null

# Crear un archivo PICTURE
cat > mi_ui.pic << 'EOF'
---
- titulo: "Mi Aplicación"
* identifier: main_screen
---

# ventana
	- background: white
	- width: 800
	- height: 600
	
	# label
		- text: titulo
		- font_size: l
		- color: blue
EOF

# Generar código C
./.build/Flex-Bison-Compiler < mi_ui.pic > mi_ui.c

---
- miVariable: "valor"
- colorFondo: blue
* selection_order: boton1, boton2, input1
* identifier: mi_pantalla
---

# contenedorPrincipal
	- background: white
	- width: 400
	- height: 300
	
	# boton1
		- text: "Click aquí"
		- color: colorFondo
		- on_press: handle_click

• --- delimita la sección de headers/metadata (donde van las variables globales y otras configuraciones)
• - nombre: valor define una variable (que funciona como reemplazo textual, similar a un #define en C)
• * selection_order: id1, id2, id3 define orden de navegación de los componentes, con tab se iterará el foco en ese orden
• * identifier: nombre define el nombre del módulo (genera nombre_main() como función principal e importa nombre.h como archivo con la lógica del programa)
• #id define un componente
• - propiedad: valor (tabulado) define propiedades del componente
• Indentación con tabs: define la jerarquía padre-hijo de componentes, el render ser hará jerárquicamente donde componentes hijos se dibujan sobre el padre en orden de arriba a abajo

Los siguientes valores se expanden automáticamente como macros:

Nota: el alineamiento vertical es siempre una distribución uniforme de los hijos, sin contar los que sobrescriban su posición con y_position

Set the following environment variables to control and configure the behaviour of the application:

Docker Compose can read the variables from an .env file too (see compose.yaml file).

Rises an ephemeral container, ready to start development:

docker compose run --rm compiler

Builds or rebuilds the entire compiler:

src/main/bash/build.sh

Compiles a program:

src/main/bash/run.sh <program>

where <program> is the path to the file that represents its entry-point.

Executes every available unit-test under src/test/c folder:

src/main/bash/test.sh

Logout, destroy the ephemeral containers and shutdowns the cluster:

exit
docker compose down

To trigger an automatic integration on every push or PR (Pull Request), you must activate GitHub Actions in the Settings tab. Use the following configuration:

• C/C++
• CMake Tools
• Yash