````markdown
# SubCodeX v0.0.4 
````
![NPM Version](https://img.shields.io/npm/v/subcodex?color=magenta&style=for-the-badge)
![License](https://img.shields.io/github/license/subcero/subcodex?style=for-the-badge)

**Un lenguaje de programación interpretado, diseñado desde cero para ser simple, intuitivo y completamente en español.**

SubCodeX es la herramienta perfecta para quienes dan sus primeros pasos en el mundo de la programación, así como para educadores que buscan una forma amigable de enseñar lógica y algoritmos. Inspirado en la simplicidad de Python y la flexibilidad de JavaScript, pero con una sintaxis natural en español.

## Características Principales

### Del Lenguaje
* **Sintaxis Natural**: Escribe código que se lee casi como el español normal.
* **Cero Complicaciones**: Olvídate de los puntos y comas, llaves complejas o tipos de datos estrictos.
* **Funcionalidades Clave**: Soporte para variables, constantes, condicionales (`si`/`sino`), bucles (`repetir`), funciones, listas y comentarios.
* **Orientado a Principiantes**: Diseñado para que la curva de aprendizaje sea lo más suave posible.

### Del CLI (Interfaz de Línea de Comandos)
* **Menú Interactivo**: Ejecuta `subcodex` sin argumentos para un menú guiado por flechas.
* **Modo Auto/Vigilancia**: El comando `auto` re-ejecuta tu código automáticamente cada vez que guardas cambios en el archivo.
* **Interfaz Atractiva**: Uso de colores, animaciones y spinners para una experiencia de usuario moderna y agradable.
* **Gestión de Archivos**: Crea archivos de ejemplo y ejecuta múltiples scripts a la vez.


## Instalación

Para instalar la herramienta de línea de comandos de SubCodeX globalmente en tu sistema, solo necesitas Node.js y ejecutar el siguiente comando:

```shell
npm install -g subcodex
```

##  Inicio Rápido

1.  Crea tu primer archivo, por ejemplo, `hola.subx`.

2.  Escribe tu primera línea de código SubCodeX:

    ```subcodex
    # mi primer programa
    decir "¡Hola, mundo desde SubCodeX!"
    ```

3.  Ejecútalo desde la terminal:

    ```shell
    subcodex run hola.subx
    ```

-----

## 💻 Uso del CLI

Una vez instalado, puedes usar el comando `subcodex` (o su alias `subx`).

  * **Menú Interactivo** (la forma más fácil de empezar):
    ```shell
    subcodex
    ```
  * **Ejecutar uno o más archivos**:
    ```shell
    subcodex run <archivo1.subx> [archivo2.subx...]
    ```
  * **Crear un archivo de ejemplo**:
    ```shell
    subcodex init [nombre_del_archivo]
    ```
  * **Modo de Desarrollo (Auto)**:
    ```shell
    subcodex auto <archivo.subx>
    ```
    Dentro de este modo, puedes usar los atajos: `r` (refrescar), `p` (pausar/reanudar), `q` (salir).


##  Guía de Sintaxis

### **Comentarios**

```subcodex
# Esto es un comentario. El intérprete lo ignora.
```

### **Variables y Constantes**

```subcodex
# Las variables pueden cambiar de valor.
variable puntos = 100
variable nombre = "Arturo"

# Las constantes no pueden ser reasignadas.
constante PI = 3.1416
```

### **Salida en Consola**

```subcodex
decir "Hola, " + nombre # Concatena texto y variables
decir "Tienes " + puntos + " puntos."
```

### **Condicionales**

```subcodex
si puntos > 50 entonces
  decir "¡Vas ganando!"
sino
  decir "Necesitas más puntos."
fin
```

### **Bucles**

```subcodex
repetir 3
  decir "¡Esto se repetirá 3 veces!"
fin
```

### **Funciones**

```subcodex
funcion saludar
  decir "¡Hola desde una función!"
  retornar "Saludo exitoso"
fin

# Para usarla:
variable resultado = llamar saludar
decir "El resultado de la función fue: " + resultado
```

### **Listas**

```subcodex
lista.nueva inventario
lista.agregar inventario "Espada"
lista.agregar inventario "Poción"
```

##  Contribuciones

Las contribuciones son bienvenidas. Si tienes ideas para mejorar SubCodeX, por favor abre un "Gmail" en el correo de "subceroplay@gmail.com" para discutirlo.

## 📜 Licencia

Distribuido bajo la Licencia MIT. Ver `LICENSE` para más información.

Creado con ❤️ por **Subcero**.

nota: (se aceptan ayudantes escribir al correo si quieres trabajar en el proyecto).