Console / Print
O Tyrus oferece duas formas equivalentes de escrever no terminal: o objeto console, e as funções ambientes print/printError/printWarn/printRaw/printCR, disponíveis sem nenhum import.
console.log
console.log escreve em stdout. Todo argumento precisa ser imprimível: primitivos (string, os tipos numéricos, boolean, char), expressões regulares, arrays e tuplas de valores imprimíveis, e interfaces/objetos, que imprimem como { campo: valor, ... }.
Múltiplos argumentos são unidos por um único espaço na mesma linha, com um \n final sempre incluído.
console.log("Server started on port", 8080);console.error
console.error escreve em stderr. Ela aceita os mesmos tipos de argumento que console.log, os une do mesmo jeito e acrescenta o mesmo \n final.
console.error("Connection refused");console.warn
console.warn escreve em stderr. Ela aceita os mesmos tipos de argumento que console.log, os une do mesmo jeito e acrescenta o mesmo \n final.
console.warn("Deprecated option: --legacy");Cor em warn e error
Em um terminal, console.warn colore a linha inteira de amarelo e console.error colore de vermelho, aberto antes do primeiro argumento e resetado depois do último, então os espaços entre argumentos também ficam coloridos:
console.warn("Deprecated option: --legacy"); // yellow color, in a terminal
console.error("Connection refused"); // red color, in a terminalMesma precedência do styleText
A decisão de colorir é tomada uma vez por processo a partir da detecção de terminal do próprio stderr. NO_COLOR (não-vazio) vence, depois FORCE_COLOR, senão detecção de TTY, a mesma precedência que styleText já documenta. console.log, print e printRaw nunca colorem.
print
print é uma função global ambiente, não precisa de import, do mesmo jeito que assert está sempre disponível. Ela se comporta exatamente como console.log: os mesmos tipos de argumento aceitos, os mesmos argumentos unidos por espaço, o mesmo \n final e o mesmo destino (stdout).
const year = 2026;
print("Year:", year); // Year: 2026print e console.log compartilham o mesmo caminho de código
print e console.log compilam para exatamente a mesma sequência de escritas. Nenhum dos dois é mais rápido que o outro, escolha o que ler melhor no ponto de chamada.
printError
printError é uma função global ambiente que se comporta exatamente como console.error: os mesmos tipos de argumento aceitos, os mesmos argumentos unidos por espaço, o mesmo \n final e o mesmo destino (stderr). Em um terminal, ela colore a linha inteira de vermelho, com a mesma precedência de cor que console.error usa.
printError("Connection refused");printError compartilha o caminho de console.error
printError compila para exatamente a mesma emissão que console.error. Use o que ler melhor no ponto de chamada.
printWarn
printWarn é uma função global ambiente que se comporta exatamente como console.warn: os mesmos tipos de argumento aceitos, os mesmos argumentos unidos por espaço, o mesmo \n final e o mesmo destino (stderr). Em um terminal, ela colore a linha inteira de amarelo, com a mesma precedência de cor que console.warn usa.
printWarn("Deprecated option: --legacy");printWarn compartilha o caminho de console.warn
printWarn compila para exatamente a mesma emissão que console.warn. Use o que ler melhor no ponto de chamada.
printRaw
printRaw é print sem o \n final. Chamadas consecutivas caem na mesma linha do terminal, o que é útil para indicadores de progresso ou para montar a saída aos poucos:
printRaw("Loading"); // Loading
printRaw("."); // Loading.
printRaw("."); // Loading..
printRaw(".\n"); // Loading...\nprintRaw dá flush explícito
print/console.log nunca precisam: eles sempre terminam em \n, e o line buffering do próprio SO já descarrega o buffer sozinho nisso. printRaw não termina em \n, então o tyrus dá flush explícito no stdout logo depois, sem isso, o texto poderia ficar parado no buffer, invisível, até algo mais acabar dando flush depois.
printCR
printCR é printRaw que também apaga o que a chamada anterior de printCR deixou na linha atual primeiro, útil pra barra de progresso, spinner ou qualquer saída que atualiza no lugar em vez de rolar:
printCR("=====>"); // =====>
printCR("=>"); // =>Sem estado, e seguro fora de um terminal
Apagar funciona escrevendo \r (volta pra coluna 0) seguido do escape ANSI "limpar até o fim da linha" (\x1B[K), depois o texto novo, sem nenhum controle em runtime de quanto media a linha anterior. Essa sequência de escape é pulada inteiramente quando o stdout não é um terminal de verdade (um pipe, um log de CI): ela não limparia nada ali, só corromperia o log com bytes de escape crus, então o printCR degrada pra escrever o texto puro, igual printRaw, nesse caso.
Nomes reservados
console, print, printError, printWarn, printRaw, printCR, assert, assertEqual e assertThrows são reservados. Eles lexam como identificadores comuns, não como keywords da linguagem, mas uma declaração que reuse um desses nomes, função, variável, tipo, parâmetro, catch binding, alias de import ou nome desestruturado, é rejeitada (E0003), exatamente como uma keyword reservada de verdade, tipo const ou throw. Isso garante que a mesma chamada sempre signifique a mesma coisa, em todo arquivo:
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