Console / Print
Tyrus ofrece dos formas equivalentes de escribir en la terminal: el objeto console, y las funciones ambiente print/printError/printWarn/printRaw/printCR, disponibles sin ningún import.
console.log
console.log escribe en stdout. Todo argumento debe ser imprimible: primitivos (string, los tipos numéricos, boolean, char), expresiones regulares, arrays y tuplas de valores imprimibles, e interfaces/objetos, que se imprimen como { campo: valor, ... }.
Varios argumentos se unen con un único espacio en la misma línea, con un \n final siempre incluido.
console.log("Server started on port", 8080);console.error
console.error escribe en stderr. Acepta los mismos tipos de argumento que console.log, los une del mismo modo y agrega el mismo \n final.
console.error("Connection refused");console.warn
console.warn escribe en stderr. Acepta los mismos tipos de argumento que console.log, los une del mismo modo y agrega el mismo \n final.
console.warn("Deprecated option: --legacy");Color en warn y error
En una terminal, console.warn colorea toda su línea de amarillo y console.error la colorea de rojo, abierto antes del primer argumento y reiniciado después del último, así que los espacios entre argumentos también quedan coloreados:
console.warn("Deprecated option: --legacy"); // yellow color, in a terminal
console.error("Connection refused"); // red color, in a terminalLa misma precedencia que styleText
La decisión de colorear se toma una vez por proceso a partir de la detección de terminal del propio stderr. NO_COLOR (no vacío) gana, luego FORCE_COLOR, si no detección de TTY, la misma precedencia que styleText ya documenta. console.log, print y printRaw nunca colorean.
print
print es una función global ambiente, no requiere import, igual que assert siempre está disponible. Se comporta exactamente igual que console.log: los mismos tipos de argumento aceptados, los mismos argumentos unidos por espacio, el mismo \n final y el mismo destino (stdout).
const year = 2026;
print("Year:", year); // Year: 2026print y console.log comparten el mismo camino de código
print y console.log compilan exactamente a la misma secuencia de escrituras. Ninguno es más rápido que el otro, elige el que se lea mejor en el punto de llamada.
printError
printError es una función global ambiente que se comporta exactamente igual que console.error: los mismos tipos de argumento aceptados, los mismos argumentos unidos por espacio, el mismo \n final y el mismo destino (stderr). En una terminal, colorea toda su línea de rojo, con la misma precedencia de color que usa console.error.
printError("Connection refused");printError comparte el camino de console.error
printError compila exactamente a la misma emisión que console.error. Usa el que se lea mejor en el punto de llamada.
printWarn
printWarn es una función global ambiente que se comporta exactamente igual que console.warn: los mismos tipos de argumento aceptados, los mismos argumentos unidos por espacio, el mismo \n final y el mismo destino (stderr). En una terminal, colorea toda su línea de amarillo, con la misma precedencia de color que usa console.warn.
printWarn("Deprecated option: --legacy");printWarn comparte el camino de console.warn
printWarn compila exactamente a la misma emisión que console.warn. Usa el que se lea mejor en el punto de llamada.
printRaw
printRaw es print sin el \n final. Llamadas consecutivas caen en la misma línea de la terminal, lo cual es útil para indicadores de progreso o para construir la salida poco a poco:
printRaw("Loading"); // Loading
printRaw("."); // Loading.
printRaw("."); // Loading..
printRaw(".\n"); // Loading...\nprintRaw hace flush explícito
print/console.log nunca lo necesitan: siempre terminan en \n, y el line buffering del propio SO ya descarga el buffer por su cuenta con eso. printRaw no termina en \n, así que tyrus hace flush explícito de stdout justo después, sin eso, el texto podría quedarse en el buffer, invisible, hasta que algo más terminara haciendo flush después.
printCR
printCR es printRaw que además borra lo que la llamada anterior a printCR dejó en la línea actual primero, útil para barras de progreso, spinners, o cualquier salida que se actualiza en el lugar en vez de desplazarse:
printCR("=====>"); // =====>
printCR("=>"); // =>Sin estado, y seguro fuera de una terminal
Borrar funciona escribiendo \r (vuelve a la columna 0) seguido del escape ANSI "limpiar hasta el final de línea" (\x1B[K), luego el texto nuevo, sin ningún control en runtime de cuánto medía la línea anterior. Esa secuencia de escape se omite por completo cuando stdout no es una terminal real (un pipe, un log de CI): no limpiaría nada ahí, solo corrompería el log con bytes de escape crudos, así que printCR degrada a escribir su texto sin más, como printRaw, en ese caso.
Nombres reservados
console, print, printError, printWarn, printRaw, printCR, assert, assertEqual y assertThrows son reservados. Lexan como identificadores comunes, no como keywords del lenguaje, pero una declaración que reutilice uno de estos nombres, función, variable, tipo, parámetro, catch binding, alias de import o nombre desestructurado, es rechazada (E0003), exactamente igual que una keyword reservada de verdad, como const o throw. Esto garantiza que la misma llamada siempre signifique lo mismo, en todo archivo:
error
function print(label: string): void {
console.log("custom:", label);
}error[E0003]: `print` is an ambient builtin in tyrus and cannot be redeclared
at /src/main.tyr:1:10
function print(label: string): void {
^^^^^
help: rename `print` to an identifier that does not collide with a builtin function