Skip to content

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óduloFinalidad
tyrus:algorithmEstructuras de datos y algoritmos nativos para ordenación, búsqueda, grafos, árboles y colecciones.
tyrus:archiveCrea, inspecciona y extrae de forma segura archivos ZIP, TAR y TAR.GZ.
tyrus:cliHelpers interactivos de prompt de terminal.
tyrus:compressComprime y descomprime bytes con Gzip, Deflate, Deflate crudo y Brotli.
tyrus:cryptoPrimitivas criptográficas: digest, HMAC, AES-256-GCM, Argon2, JWT y aleatorio seguro.
tyrus:dbSnapshots versionados de schema SQLite, comprobaciones de solo lectura y contrato de errores de la base.
tyrus:encodingConversión explícita de UTF-8, UTF-16, hexadecimal, Base64, Base32 y radix.
tyrus:fsLectura y escritura síncrona de archivos para programas nativos.
tyrus:httpServidor HTTP, rutas, respuesta, status y helpers orientados a API.
tyrus:mathConstantes y funciones matemáticas.
tyrus:memoryOwnership explícito, borrado seguro y consultas de layout en tiempo de compilación.
tyrus:netParsing de direcciones, resolución de nombres con Result, comunicación TCP y UDP asíncrona y sondas condicionadas por capacidad.
tyrus:osIdentificación multiplataforma del sistema operativo: plataforma, arquitectura, hostname, locale.
tyrus:processSubprocesos sin shell con streams estándar de bytes limitados.
tyrus:simdSuma vectorizada de arrays f32[] y f64[] del mismo tamaño, con errores recuperables en Result.
tyrus:streamTransporte progresivo limitado con capacidades separadas de lectura y escritura.
tyrus:taskGestión cooperativa de tareas async: cancelación y suspensión temporizada.
tyrus:temporalInstantes nativos, valores de calendario, duraciones y zonas horarias IANA.
tyrus:testSuites de prueba, aserciones, hooks y modificadores ejecutados por tyrus test.
tyrus:utilsHelpers nativos de texto como estilo ANSI y banners FIGlet.

Estilo de import ​

tyrus
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:

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