Módulos nativos
Los módulos nativos exponen funcionalidades de runtime mediante rutas de import estables tyrus:*. Sus API son concisas y sus implementaciones se enlazan en binarios nativos. Cada módulo forma parte de la distribución estándar, sin gestor de paquetes, sin npm install, sin runtime externo.
Módulos disponibles
| Módulo | Finalidad |
|---|---|
tyrus:algorithm | Estructuras de datos y algoritmos nativos para ordenación, búsqueda, grafos, árboles y colecciones. |
tyrus:archive | Crea, inspecciona y extrae de forma segura archivos ZIP, TAR y TAR.GZ. |
tyrus:cli | Helpers interactivos de prompt de terminal. |
tyrus:compress | Comprime y descomprime bytes con Gzip, Deflate, Deflate crudo y Brotli. |
tyrus:crypto | Primitivas criptográficas: digest, HMAC, AES-256-GCM, Argon2, JWT y aleatorio seguro. |
tyrus:db | Snapshots versionados de schema SQLite, comprobaciones de solo lectura y contrato de errores de la base. |
tyrus:encoding | Conversión explícita de UTF-8, UTF-16, hexadecimal, Base64, Base32 y radix. |
tyrus:fs | Lectura y escritura síncrona de archivos para programas nativos. |
tyrus:http | Servidor HTTP, rutas, respuesta, status y helpers orientados a API. |
tyrus:math | Constantes y funciones matemáticas. |
tyrus:memory | Ownership explícito, borrado seguro y consultas de layout en tiempo de compilación. |
tyrus:net | Parsing de direcciones, resolución de nombres con Result, comunicación TCP y UDP asíncrona y sondas condicionadas por capacidad. |
tyrus:os | Identificación multiplataforma del sistema operativo: plataforma, arquitectura, hostname, locale. |
tyrus:process | Subprocesos sin shell con streams estándar de bytes limitados. |
tyrus:simd | Suma vectorizada de arrays f32[] y f64[] del mismo tamaño, con errores recuperables en Result. |
tyrus:stream | Transporte progresivo limitado con capacidades separadas de lectura y escritura. |
tyrus:task | Gestión cooperativa de tareas async: cancelación y suspensión temporizada. |
tyrus:temporal | Instantes nativos, valores de calendario, duraciones y zonas horarias IANA. |
tyrus:test | Suites de prueba, aserciones, hooks y modificadores ejecutados por tyrus test. |
tyrus:utils | Helpers nativos de texto como estilo ANSI y banners FIGlet. |
Estilo de import
import { readFileSync } from "tyrus:fs";
import { HttpStatus } from "tyrus:http";
import { input } from "tyrus:cli";
import { styleText } from "tyrus:utils";
import { digest, hmac, cipher, jwt } from "tyrus:crypto";
import { cancel, sleep } from "tyrus:task";Los imports tyrus:* son resueltos por el compilador como módulos integrados.
Usando módulos juntos
Los módulos nativos componen de forma natural. Un proyecto CLI típico podría leer configuración del sistema de archivos, solicitar entrada y aplicar estilos:
import { writeFileSync, type FsError } from "tyrus:fs";
import { input, confirm } from "tyrus:cli";
import { styleText } from "tyrus:utils";
const main = (): void => {
const name: string = input({ message: "Project name?" });
const proceed: boolean = confirm({ message: `Create "${name}"?` });
if (proceed) {
match (writeFileSync(`${name}/main.tyr`, `print("hello from ${name}");`)) {
Ok() => print(styleText("green", `Created ${name}`));
Err(error) => printError(error.message);
}
}
};Frontera de runtime
Los módulos nativos deben documentar imports públicos, tipos de retorno, comportamiento de error y diagnósticos antes de tratarse como estables. Las APIs que imprimen UI chrome de terminal usan stderr para mantener stdout reservado a la salida normal del programa.
