fix: lang

Author: atrox39

.github/workflows/release.yml

@@ -53,13 +53,13 @@ jobs:
           TAG="${GITHUB_REF_NAME}"
           VERSION="${TAG#v}"
           TOML_VERSION="$(python3 - <<'PY'
-import re
-import pathlib
-txt = pathlib.Path('gleam.toml').read_text(encoding='utf-8')
-m = re.search(r'^version\\s*=\\s*\"([^\"]+)\"\\s*$', txt, re.M)
-print(m.group(1) if m else '')
-PY
-)"
+          import re
+          import pathlib
+          txt = pathlib.Path('gleam.toml').read_text(encoding='utf-8')
+          m = re.search(r'^version\\s*=\\s*\"([^\"]+)\"\\s*$', txt, re.M)
+          print(m.group(1) if m else '')
+          PY
+          )"
           echo "tag=$TAG version=$VERSION gleam.toml=$TOML_VERSION"
           test -n "$TOML_VERSION"
           test "$VERSION" = "$TOML_VERSION"

.gitignore

@@ -1,7 +1,7 @@
 # Gleam / Erlang build outputs
 build/
 
-# Native port binaries (se generan en CI o con `make port`)
+# Native port binaries (generated in CI or with `make port`)
 priv/minigui
 priv/minigui.exe
 priv/minigui_port
@@ -14,3 +14,4 @@ erl_crash.dump
 .DS_Store
 *.swp
 *.swo
+.vscode/

CHANGELOG.md

@@ -2,10 +2,9 @@
 
 ## v0.1.0
 
-- Instalación “sin toolchain”: descarga automática del port desde GitHub Releases, con cache por usuario.
-- Protocolo v1 con handshake (`HELLO`/`HELLO_ACK`) y `OK/ERR` por `request_id`.
+- Toolchain-free installation: automatic port download from GitHub Releases, with per-user cache.
+- v1 protocol with handshake (`HELLO`/`HELLO_ACK`) and `OK/ERR` per `request_id`.
 - Backends:
   - Windows: Win32 (Window + Label + TextBox + Button)
   - Linux: GTK3 (Window + Label + TextBox + Button)
-- API de Gleam basada en `Result` y comandos con ACK.
-
+- Gleam API based on `Result` and commands with ACK.

Makefile

@@ -15,13 +15,13 @@ port: $(PRIV_DIR)
 ifeq ($(UNAME_S),Linux)
 	$(CC) -O2 -Wall -Wextra -o $(PRIV_DIR)/$(PORT_NAME) $(C_SRC) $$(pkg-config --cflags --libs gtk+-3.0) -pthread
 else ifeq ($(UNAME_S),Darwin)
-	@echo "macOS: por ahora no hay backend nativo. Usa el modo headless (MINIGUI_HEADLESS=1) o implementa Cocoa."
+	@echo "macOS: there is no native backend yet. Use headless mode (MINIGUI_HEADLESS=1) or implement Cocoa."
 	$(CC) -O2 -Wall -Wextra -o $(PRIV_DIR)/$(PORT_NAME) $(C_SRC)
 else
-	@echo "Sistema no reconocido. Compila manualmente c_src/minigui_port.c para tu plataforma."
+	@echo "Unknown system. Compile c_src/minigui_port.c manually for your platform."
 endif
 
-	@# Compatibilidad con el nombre anterior durante desarrollo
+	@# Compatibility with the previous name during development
 	@if [ -f "$(PRIV_DIR)/minigui" ]; then cp -f "$(PRIV_DIR)/minigui" "$(PRIV_DIR)/minigui_port"; fi
 
 gleam:

README.md

@@ -1,114 +1,114 @@
 # minigui
 
-`minigui` es una biblioteca experimental para crear interfaces gráficas desde **Gleam (target Erlang)** usando un **port externo en C** (nativo).
+`minigui` is an experimental library for creating graphical user interfaces from **Gleam (Erlang target)** using a native **external C port**.
 
-## Estado / alcance
+## Status / scope
 
-- **Windows**: backend **Win32** (ventana + label + textbox + botón).
-- **Linux**: backend **GTK3** (ventana + label + textbox + botón).
-- **macOS**: por ahora solo **modo headless** (simulado).
+- **Windows**: **Win32** backend (window + label + textbox + button).
+- **Linux**: **GTK3** backend (window + label + textbox + button).
+- **macOS**: for now, **headless mode** only (simulated).
 
-> Nota: en Linux el binario `minigui` enlaza con GTK3, por lo que el sistema debe tener GTK3 disponible en runtime (en desktops es común; en servidores minimalistas puede requerir instalar paquetes).
+> Note: on Linux the `minigui` binary links against GTK3, so the system must have GTK3 available at runtime (common on desktops; on minimal servers you may need to install packages).
 
-El objetivo es mantener una API pequeña y estable en Gleam, y permitir backends nativos por plataforma.
+The goal is to keep a small, stable API in Gleam, while enabling native per-platform backends.
 
-## Releases / publicación
+## Releases / publishing
 
-Ver el checklist: [`RELEASING.md`](./RELEASING.md)
+See the checklist: [`RELEASING.md`](./RELEASING.md)
 
-## Instalación (Gleam Packages)
+## Installation (Gleam Packages)
 
 ```bash
 gleam add minigui
 ```
 
-### “Sin dependencias de build” (binario precompilado)
+### "Build-dependency-free" (precompiled binary)
 
-Para evitar que tus usuarios tengan que instalar un compilador C o headers (`libx11-dev`, etc.), `minigui` está pensado para usar un **ejecutable precompilado** como puente (un *port*) y descargarlo automáticamente a `priv/` en el primer uso.
+To avoid requiring your users to install a C compiler or headers (`libx11-dev`, etc.), `minigui` is designed to use a **precompiled executable** as a bridge (a *port*) and download it automatically into `priv/` on first use.
 
-Por defecto construye la URL así:
+By default it builds the URL like this:
 
 ```
 https://github.com/Aztekode/minigui/releases/download/v<version>/<asset>
 ```
 
-Donde `<version>` sale del `vsn` del paquete (ej. `0.1.0`) y `<asset>` depende del OS/arquitectura, por ejemplo:
+Where `<version>` comes from the package `vsn` (e.g. `0.1.0`) and `<asset>` depends on the OS/architecture, for example:
 
 - `minigui.exe` (Windows x64)
 - `minigui` (Linux x64)
 
-Puedes sobreescribir la base de descargas con:
+You can override the download base with:
 
 ```bash
 MINIGUI_RELEASE_BASE_URL="https://github.com/Aztekode/minigui/releases/download/v0.1.0"
 ```
 
-Si prefieres un enlace exacto tipo `.../minigui.exe`, puedes fijar la URL completa:
+If you prefer an exact link like `.../minigui.exe`, you can set the full URL:
 
 ```bash
 MINIGUI_PORT_URL="https://github.com/Aztekode/minigui/releases/download/v0.1.0/minigui.exe"
 ```
 
-Opciones de seguridad/cache:
+Security/cache options:
 
-- Por defecto, `minigui` **requiere** que exista `minigui(.exe).sha256` y valida el SHA256.
-- `MINIGUI_REQUIRE_SHA=0`: desactiva la validación (no recomendado).
-- El binario se cachea por usuario (Linux: `~/.cache/minigui/<version>/`, Windows: `%LOCALAPPDATA%\\minigui\\<version>\\`).
+- By default, `minigui` **requires** `minigui(.exe).sha256` to exist and validates the SHA256.
+- `MINIGUI_REQUIRE_SHA=0`: disables validation (not recommended).
+- The binary is cached per user (Linux: `~/.cache/minigui/<version>/`, Windows: `%LOCALAPPDATA%\\minigui\\<version>\\`).
 
-> Requisito de runtime: una instalación “completa” de Erlang/OTP que incluya las aplicaciones estándar `inets` + `ssl` (normalmente ya vienen con OTP; en algunas distros Linux pueden venir en paquetes separados).
+> Runtime requirement: a "full" Erlang/OTP installation that includes the standard `inets` + `ssl` applications (they usually ship with OTP; on some Linux distros they may be split into separate packages).
 
 ## Protocolo (v1)
 
-El port se abre con `open_port(..., [{packet, 2}, binary, ...])`.
+The port is opened with `open_port(..., [{packet, 2}, binary, ...])`.
 
 - Handshake:
   - `0x00` `HELLO` + `u16 version`
   - `0xF0` `HELLO_ACK` + `u16 version` + `u32 capabilities`
 
-- Comandos:
-  - `0x10` `CREATE_WINDOW` + `u32 request_id` + título UTF-8
-  - `0x11` `SET_LABEL` + `u32 request_id` + texto UTF-8
-  - `0x12` `SET_TEXT` + `u32 request_id` + texto UTF-8
-  - `0x13` `ADD_BUTTON` + `u32 request_id` + `u8 id` + etiqueta UTF-8
+- Commands:
+  - `0x10` `CREATE_WINDOW` + `u32 request_id` + UTF-8 title
+  - `0x11` `SET_LABEL` + `u32 request_id` + UTF-8 text
+  - `0x12` `SET_TEXT` + `u32 request_id` + UTF-8 text
+  - `0x13` `ADD_BUTTON` + `u32 request_id` + `u8 id` + UTF-8 label
   - `0x14` `RUN` + `u32 request_id`
   - `0x15` `QUIT` + `u32 request_id`
-- Respuestas:
+- Responses:
   - `0x70` `OK` + `u32 request_id`
-  - `0x71` `ERR` + `u32 request_id` + mensaje UTF-8
-- Eventos:
+  - `0x71` `ERR` + `u32 request_id` + UTF-8 message
+- Events:
   - `0x81` `BUTTON_CLICKED` + `u8 id`
   - `0x82` `CLOSED`
-  - `0x83` `LOG` + texto UTF-8
-  - `0x84` `TEXT_CHANGED` + texto UTF-8
+  - `0x83` `LOG` + UTF-8 text
+  - `0x84` `TEXT_CHANGED` + UTF-8 text
   - `0x85` `KEY_DOWN` + `u32 keycode`
-  - `0x86` `ERROR` + texto UTF-8
+  - `0x86` `ERROR` + UTF-8 text
 
-## Compilar (Linux)
+## Build (Linux)
 
-Requisitos: `gcc`, `make`, `pkg-config`, `libgtk-3-dev`, `Erlang/OTP`, `gleam`.
+Requirements: `gcc`, `make`, `pkg-config`, `libgtk-3-dev`, `Erlang/OTP`, `gleam`.
 
-> Probado con **Gleam v1.17.0**.
+> Tested with **Gleam v1.17.0**.
 
 ```bash
 make port
 gleam build
 make demo
 ```
 
-Si estás en un entorno sin servidor X (CI/headless), fuerza el modo simulado:
+If you're in an environment without an X server (CI/headless), force simulated mode:
 
 ```bash
 MINIGUI_HEADLESS=1 make demo
 ```
 
-## Compilar (Windows)
+## Build (Windows)
 
-1. Compila `c_src/minigui_port.c` a `priv/minigui_port.exe` (MSVC o mingw).
-2. Ejecuta el demo:
+1. Compile `c_src/minigui_port.c` to `priv/minigui_port.exe` (MSVC or mingw).
+2. Run the demo:
 
 ```powershell
 gleam build
 gleam run -m demo
 ```
 
-> Nota: el código Win32 está dentro de `#ifdef _WIN32`.
+> Note: the Win32 code is inside `#ifdef _WIN32`.

RELEASING.md

@@ -1,25 +1,25 @@
-# Publicación de minigui (checklist)
+# Releasing minigui (checklist)
 
-Este repositorio publica **dos cosas**:
+This repository publishes **two things**:
 
-1. **Paquete Gleam (Hex / Gleam Packages)**: código Gleam + Erlang helper.
-2. **Assets nativos (GitHub Releases)**: `minigui` (Linux x64) y `minigui.exe` (Windows x64) + `.sha256`.
+1. **Gleam package (Hex / Gleam Packages)**: Gleam code + Erlang helper.
+2. **Native assets (GitHub Releases)**: `minigui` (Linux x64) and `minigui.exe` (Windows x64) + `.sha256`.
 
-La librería descarga el port desde:
+The library downloads the port from:
 
 ```
 https://github.com/Aztekode/minigui/releases/download/v<VERSION>/<asset>
 ```
 
-Por lo tanto, **el tag de git SIEMPRE debe ser `vX.Y.Z`** y la versión del paquete debe ser **`X.Y.Z`**.
+Therefore, **the git tag MUST ALWAYS be `vX.Y.Z`** and the package version must be **`X.Y.Z`**.
 
 ---
 
-## 0) Preparación
+## 0) Preparation
 
-- Asegúrate de que `gleam.toml` tenga la versión final `X.Y.Z`.
-- Actualiza `CHANGELOG.md`.
-- (Opcional) corre el demo en headless:
+- Ensure `gleam.toml` has the final version `X.Y.Z`.
+- Update `CHANGELOG.md`.
+- (Optional) run the headless demo:
 
 ```bash
 make port
@@ -28,9 +28,9 @@ MINIGUI_HEADLESS=1 gleam run -m demo
 
 ---
 
-## 1) Crear tag y release (assets nativos)
+## 1) Create tag and release (native assets)
 
-1. Commit de la versión:
+1. Commit the version:
 
 ```bash
 git add -A
@@ -44,21 +44,20 @@ git tag vX.Y.Z
 git push origin main --tags
 ```
 
-3. GitHub Actions ejecutará el workflow `release.yml` y adjuntará:
+3. GitHub Actions will run the `release.yml` workflow and attach:
    - `minigui` + `minigui.sha256`
    - `minigui.exe` + `minigui.exe.sha256`
 
-> Nota: el workflow falla si el tag `vX.Y.Z` no coincide con la versión `X.Y.Z` en `gleam.toml`.
+> Note: the workflow fails if the `vX.Y.Z` tag does not match the `X.Y.Z` version in `gleam.toml`.
 
 ---
 
-## 2) Publicar el paquete en Hex / Gleam Packages
+## 2) Publish the package to Hex / Gleam Packages
 
-En la máquina donde tengas configuradas credenciales de Hex:
+On the machine where you have Hex credentials configured:
 
 ```bash
 gleam publish
 ```
 
-Si vas a usar CI para publicar, tendrás que configurar el token correspondiente (no se incluye en este repo).
-
+If you are going to use CI to publish, you will need to configure the corresponding token (not included in this repo).

c_src/minigui_port.c

@@ -1,23 +1,23 @@
-// minigui_port.c (protocolo v1)
-// Port externo para Erlang/Gleam usando {packet, 2}.
+// minigui_port.c (protocol v1)
+// External port for Erlang/Gleam using {packet, 2}.
 //
 // Handshake:
 //   HELLO      0x00 + u16 version
 //   HELLO_ACK  0xF0 + u16 version + u32 capabilities
 //
-// Comandos (todos incluyen request_id u32 big-endian):
+// Commands (all include request_id u32 big-endian):
 //   CREATE_WINDOW 0x10 + u32 req + title utf-8
 //   SET_LABEL     0x11 + u32 req + text utf-8
 //   SET_TEXT      0x12 + u32 req + text utf-8
 //   ADD_BUTTON    0x13 + u32 req + u8 id + label utf-8
 //   RUN           0x14 + u32 req
 //   QUIT          0x15 + u32 req
 //
-// Respuestas:
+// Responses:
 //   OK            0x70 + u32 req
 //   ERR           0x71 + u32 req + msg utf-8
 //
-// Eventos:
+// Events:
 //   BUTTON_CLICKED 0x81 + u8 id
 //   CLOSED         0x82
 //   LOG            0x83 + msg utf-8
@@ -42,7 +42,7 @@
 
 #define PROTOCOL_VERSION 1
 
-// ---------- salida thread-safe ----------
+// ---------- thread-safe output ----------
 #ifdef _WIN32
 static CRITICAL_SECTION g_out_lock;
 static void out_lock_init(void) { InitializeCriticalSection(&g_out_lock); }
@@ -148,7 +148,7 @@ static void send_key_down(uint32_t keycode) {
   send_packet(buf, (uint16_t)sizeof(buf));
 }
 
-// ---------- lectura ----------
+// ---------- read ----------
 static int read_exact(uint8_t* out, size_t len) {
   size_t got = 0;
   while (got < len) {
@@ -195,7 +195,7 @@ static int is_headless_forced(void) {
   return v && (strcmp(v, "1") == 0 || strcmp(v, "true") == 0 || strcmp(v, "TRUE") == 0);
 }
 
-// ---------- estado compartido ----------
+// ---------- shared state ----------
 typedef struct {
   char* title;
   char* label;
@@ -350,7 +350,7 @@ static void ui_start(gui_state_t* st) {
   if (st->ui_started) return;
   st->ui_started = 1;
   if (is_headless_forced()) {
-    send_log("minigui_port: modo headless (windows).");
+    send_log("minigui_port: headless mode (windows).");
     Sleep(300);
     send_text_changed(st->text ? st->text : "");
     Sleep(300);
@@ -407,7 +407,7 @@ static void* ui_thread_proc(void* param) {
   g_state = (gui_state_t*)param;
 
   if (is_headless_forced()) {
-    send_log("minigui_port: modo headless (linux).");
+    send_log("minigui_port: headless mode (linux).");
     struct timespec ts = {0, 300 * 1000 * 1000};
     nanosleep(&ts, NULL);
     send_text_changed(g_state->text ? g_state->text : "");
@@ -499,7 +499,7 @@ int main(void) {
 
     if (cmd == 0x00) { // HELLO
       if (len < 3) {
-        send_error_event("HELLO inválido");
+        send_error_event("invalid HELLO");
       } else {
         uint16_t ver = read_u16be(buf + 1);
         if (ver != PROTOCOL_VERSION) {
@@ -559,7 +559,7 @@ int main(void) {
       }
       case 0x13: { // ADD_BUTTON
         if (payload_len < 1) {
-          send_err(req, "ADD_BUTTON inválido");
+          send_err(req, "invalid ADD_BUTTON");
           break;
         }
         st.button_id = payload[0];
@@ -586,7 +586,7 @@ int main(void) {
         break;
       }
       default:
-        send_err(req, "comando desconocido");
+        send_err(req, "unknown command");
         break;
     }