Soporte de Lenguaje Umbral para Sublime Text

Paquete oficial de Sublime Text para el lenguaje de programación Umbral. Proporciona resaltado de sintaxis completo y soporte para el desarrollo con archivos .um.

✨ Características

🎨 Resaltado de Sintaxis Completo

• Comentarios: Líneas que comienzan con !!
• Strings: Soporte para comillas simples, dobles y triple comillas
  • 'texto literal' - String sin interpolación
  • "texto con &variable" - String con interpolación
  • '''texto multilínea con &interpolacion'''
• Palabras Clave de Control: i, ie, e, wh, r, th, n, out, equip, origin, as
• Control Condicional: sw: (switch), ca: (case), def: (default)
• Manejo de Errores: tr: (try), ct: (catch), tw: (throw), fy: (finally)
• Asincronismo: asy (async), awa (await)
• Declaradores: v:, c:, f:, fo:, fe:, cs:, pr:, pu:
• Modificadores OOP: ext: (extends), imp: (implements), in: (interface)
• Tipos de Datos: Int, Str, Flo, Bool, Void, Error, [], [][]
• Operadores: ->, +, -, *, /, %, ==, !=, <=, >=, <, >, &&, ||, !, =
• Operador Spread: &array para expandir arrays
• Números y Booleanos: 42, 3.14, true, false
• Funciones Built-in: tprint
• Propiedades: .length y otras propiedades de objetos
• Invocaciones: Resaltado de llamadas a funciones y métodos

📦 Reconocimiento de Archivos

Automáticamente reconoce archivos con extensión .um como código Umbral.

🚀 Instalación

Instalación Manual

1. Abre Sublime Text.
2. Ve al menú Preferences > Browse Packages....
3. En la carpeta que se abre, abre una terminal y clona este repositorio:

git clone https://github.com/hersac/umbral-sublime.git Umbral

1. Reinicia Sublime Text (opcional, generalmente detecta el cambio automáticamente).

📝 Ejemplo de Sintaxis

!! Comentario de una línea

!! Declaración de variables y constantes
v: contador = 0;
c: PI = 3.14159;

!! Funciones
f: sumar(a->Int, b->Int)->Int {
    r: (a + b);
}

!! Condicionales
i: (contador > 0) {
    tprint("Contador positivo");
} e: {
    tprint("Contador cero o negativo");
}

!! Bucles
wh: (contador < 10) {
    tprint("Contador: &contador");
    contador = contador + 1;
}

!! Clases
cs: Persona {
    pr: nombre->Str;
    pr: edad->Int;

    pu f: Persona(nombre->Str, edad->Int) {
        th.nombre = nombre;
        th.edad = edad;
    }

    pu f: presentarse()->Void {
        tprint("Hola, soy &th.nombre");
    }
}

!! Instanciar y usar
c: persona = n: Persona("Juan", 25);
persona.presentarse();

!! Arrays y Operador Spread
c: numeros = {1, 2, 3};
c: masNumeros = {&numeros, 4, 5, 6};

!! Strings con interpolación
v: nombre = "Umbral";
tprint("Lenguaje: &nombre");
v: literal = 'Sin interpolación &nombre';

🎯 Características del Lenguaje Umbral

• Variables: v: (mutables) y c: (constantes)
• Funciones: f: con tipos explícitos y retornos, fo: y fe: para funciones especiales
• Clases: cs: con propiedades (pr:) y métodos públicos (pu:)
• Condicionales: i: (if), ie: (else if), e: (else)
• Switch-Case: sw: (switch), ca: (case), def: (default)
• Manejo de Errores: tr: (try), ct: (catch), tw: (throw), fy: (finally)
• Asincronismo: asy (async), awa (await)
• Bucles: wh: (while)
• Arrays: {1, 2, 3} con tipos []Int, [][]Int
• Interpolación: &variable en strings y triple comillas
• Operador Spread: &array para expandir arrays
• Módulos: Sistema equip/origin para importar/exportar
• OOP Avanzado: ext: (extends), imp: (implements), in: (interface)
• Tipos Primitivos: Int, Str, Flo, Bool, Void, Error

📄 Licencia

Este proyecto está bajo la licencia especificada en el archivo LICENSE.

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama para tu feature (git checkout -b feature/nueva-caracteristica)
3. Commit tus cambios (git commit -m 'Agrega nueva característica')
4. Push a la rama (git push origin feature/nueva-caracteristica)
5. Abre un Pull Request

📞 Soporte

• Issues: GitHub Issues
• Documentación: Umbral Docs

Disfruta programando en Umbral! 🎉