GabrielSignorini

Um motor 3D que desenha com texto.

A CP437-Engine renderiza cenas com luz colorida, sombras e reflexos traçados, usando apenas caracteres de texto. Não há biblioteca de renderização: projeção, recorte, z-buffer e ray tracing analítico foram escritos à mão, e a última etapa roda na GPU, com WebGPU e um efeito de CRT. Ele começou como o synth-ascii-wallpaper, um papel de parede no estilo outrun desenhado inteiramente em ASCII.

Um kit de ferramentas para o TypeScript do dia a dia.

10import { clamp, toNumber, Random } from "@gabreusi/hyrax";2030clamp(5, 10, 0); // 5: bounds in either order40toNumber("abc"); // 0, never NaN5060const dm = new Random("hailtotheking");70dm.roll("1d20+5"); // attack: same every run80dm.roll("4d6kh3"); // ability score: best 3 of 490

O Hyrax é um kit de ferramentas para TypeScript sem nenhuma dependência em tempo de execução, e toda função dele segue duas regras. Ela aceita a entrada em todos os formatos em que essa entrada realmente chega e tipa cada formato com exatidão: o caso comum tem uma chamada curta, como clamp(v, max) ao lado de clamp(v, min, max), e o tipo de retorno lista todo valor que pode voltar, fallbacks incluídos. E ela tem uma resposta para toda entrada que os tipos permitem. Os limites funcionam em qualquer ordem, um intervalo vazio dá um resultado neutro onde outro código daria NaN, um alvo null não faz nada, e o código que precisa de navegador cai num fallback silencioso no servidor.

O Hyrax só lança erro em um caso: uma configuração que nenhum programa correto escreveria, como random.boolean(50) quando uma chance vai de 0 a 1. Dados ruins e a falta de um navegador acontecem em tempo de execução, e quem chama nem sempre consegue evitar. Uma configuração ruim é um bug, e esconder um bug é pior do que avisar. Nada roda na importação, e uma checagem de CI derruba o build se o núcleo algum dia usar window ou document. Uma semente gera os mesmos números em qualquer runtime e só os muda numa versão major. Todo exemplo da documentação tem os tipos verificados contra o pacote do npm, e os do núcleo também rodam, então uma resposta desatualizada derruba o build.

Projeto pessoal · 1.0.0-rc.1 no npm · MIT