ranuts
Uma biblioteca de utilidades para o navegador e para o Node, publicada como pontos de entrada independentes e prontos para tree-shaking. Importe do subcaminho que tem o que você precisa e o resto nunca chega ao seu pacote. Tudo é TypeScript, e cada exportação é documentada a partir do código-fonte.
- npm:
ranuts· código:packages/ranuts
npm install ranutsimport { debounce } from 'ranuts/utils';Pontos de entrada
| Importação | Contém | Ambiente |
|---|---|---|
ranuts | O barril raiz: a superfície de utils e visual | navegador + node |
ranuts/utils | DOM/BOM, strings, objetos, números, cor, tempo, armazenamento, … | navegador + node* |
ranuts/node | Servidor HTTP, roteador, WebSocket, fs, streams, middleware | só node |
ranuts/visual | Motor de desenho 2D (Canvas / WebGL / WebGPU) | só navegador |
ranuts/i18n | Motor de tradução: dicionários planos, troca em tempo de execução | navegador + node |
ranuts/sw | Estratégias de cache e a metade do protocolo de pré-cache que fica no worker | service worker |
ranuts/vnode | DOM virtual no estilo do Snabbdom | navegador |
ranuts/stream | Análise de SSE, dobra de fluxos de modelos, orçamento de tokens | navegador + node |
ranuts/conversation | Registro de eventos → nós de conversa desenháveis | navegador + node |
* O ranuts/utils é largo: quase tudo nele é voltado ao navegador, mas os auxiliares puros rodam em qualquer lugar. Não importe ranuts/node em código de navegador. Ele puxa fs / http / child_process.
O que tem dentro
Funcional: debounce · throttle · once / singleFlight · QuestQueue · withTimeout / deferred · compose
Dados: cloneDeep · isEqual · merge · filterObj · formatar e analisar números · conversão e mistura de cor
Texto: md5 · truncate · detectLanguage · resolveLocale · segmentByRanges · paginate · escapeHtml
Navegador: armazenamento · IndexedDB · cliente de worker · ponte de postMessage · prefetch · detecção de dispositivo · desempenho · ZIP · gravação de áudio · voz para texto
IA e chat: stream · conversation · i18n
Desenho: motor 2D · DOM virtual · auxiliares de canvas · tween
Node: servidor HTTP e roteador · operações com arquivos · tipos MIME
Isto é uma seleção. A referência da API tem todas as exportações com assinatura e descrição, geradas do código-fonte para que não possam ficar desatualizadas.
Para onde ir depois
| Se você quer… | Leia |
|---|---|
| Descobrir se uma função existe, e qual a assinatura | Referência da API |
| Decidir entre duas utilidades parecidas | Escolher uma utilidade |
| Passear por categoria | Índice de utilidades |
| Desenhar a resposta de um modelo que chega em stream | stream → conversation |
| Construir interface por cima | ranui |
Os dois pacotes levam um CLAUDE.md dentro do tarball do npm: orientação para agentes de código, legível direto do node_modules e sem acesso à rede.