korusjs 🚀

A korusjs é uma biblioteca leve e robusta para TypeScript, projetada para lidar com valores nulos, opcionais e transformações de dados de forma segura.

Este projeto é a evolução da koruspy, minha biblioteca original escrita em Python, agora trazendo a mesma filosofia de segurança para o ecossistema JavaScript/TypeScript.

✨ Características

• Type Safety: Evite erros de null ou undefined em tempo de execução.
• Inspirada na koruspy: Mantém a lógica de tratamento de dados que criei na versão Python.
• Leve e Rápida: Sem dependências externas, perfeita para projetos de qualquer tamanho.
• Desenvolvida no Termux: Criada e testada inteiramente em ambiente mobile (Android).

📦 Instalação

npm install korusjs

🛠️ Como Usar

Usando o tipo Option O Option permite que você lide com valores que podem não existir sem quebrar o seu código.

import { OptionOf } from 'korusjs';

// Criando um valor seguro
const nome = OptionOf("Usuário").unwrapOr("Desconhecido");

// Lidando com valores nulos
const nulo = OptionOf(null).unwrapOr("Valor Padrão");
console.log(nulo); // "Valor Padrão"

// Conversão segura de tipos
const numero = OptionOf("42").toInt();
console.log(numero.isSome()); // true

Funções Úteis (println)

A biblioteca também inclui utilitários práticos para saída de dados:

import { println } from 'korusjs';

println("Korusjs está pronta!", true); 
// Imprime com quebra de linha

🧑‍💻 Sobre o Projeto

Olá! Eu tenho 12 anos e sou o criador da koruspy e agora da korusjs. Desenvolvi esta biblioteca para aprender mais sobre TypeScript e para facilitar o meu próprio fluxo de trabalho no Android usando o Termux. Este projeto não busca ser "ultra-profissional", mas sim funcional, educativo e seguro. Foi feito de um estudante para outros desenvolvedores que gostam de simplicidade. 📄 Licença Este projeto está sob a licença MIT.