```markdown


SubCodeX v0.0.4


``
!NPM Version
!License

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

$3

* 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.

$3

* 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 [archivo2.subx...]
`
* Crear un archivo de ejemplo:
`shell
subcodex init [nombre_del_archivo]
`
* Modo de Desarrollo (Auto):
`shell
subcodex auto
`
Dentro de este modo, puedes usar los atajos: r (refrescar), p (pausar/reanudar), q (salir).




Guía de Sintaxis

$3

`subcodex


Esto es un comentario. El intérprete lo ignora.


`

$3

`subcodex


Las variables pueden cambiar de valor.

variable puntos = 100
variable nombre = "Arturo"

Las constantes no pueden ser reasignadas.

constante PI = 3.1416
`

$3

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

$3

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

$3

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

$3

`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
`

$3

`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).