ranuts
Una biblioteca de utilidades para el navegador y para Node, publicada como puntos de entrada independientes y aptos para tree-shaking. Importa desde la subruta que contiene lo que necesitas y el resto nunca llega a tu paquete. Todo es TypeScript, y cada exportación está documentada desde el código fuente.
- npm:
ranuts· código:packages/ranuts
npm install ranutsimport { debounce } from 'ranuts/utils';Puntos de entrada
| Importación | Contiene | Entorno |
|---|---|---|
ranuts | El barril raíz: la superficie de utils y visual | navegador + node |
ranuts/utils | DOM/BOM, cadenas, objetos, números, color, tiempo, almacenamiento, … | navegador + node* |
ranuts/node | Servidor HTTP, enrutador, WebSocket, fs, streams, middleware | solo node |
ranuts/visual | Motor de dibujado 2D (Canvas / WebGL / WebGPU) | solo navegador |
ranuts/i18n | Motor de traducción: diccionarios planos, cambio en caliente | navegador + node |
ranuts/sw | Estrategias de caché y la mitad del protocolo de precaché que va en el worker | service worker |
ranuts/vnode | DOM virtual al estilo de Snabbdom | navegador |
ranuts/stream | Análisis de SSE, plegado de flujos de modelos, presupuesto de tokens | navegador + node |
ranuts/conversation | Registro de eventos → nodos de conversación dibujables | navegador + node |
* ranuts/utils es amplio: casi todo apunta al navegador, pero las ayudas puras corren en cualquier sitio. No importes ranuts/node en código de navegador. Arrastra fs / http / child_process.
Qué hay dentro
Funcional: debounce · throttle · once / singleFlight · QuestQueue · withTimeout / deferred · compose
Datos: cloneDeep · isEqual · merge · filterObj · dar formato a números y analizarlos · conversión y mezcla de color
Texto: md5 · truncate · detectLanguage · resolveLocale · segmentByRanges · paginate · escapeHtml
Navegador: almacenamiento · IndexedDB · cliente de worker · puente de postMessage · prefetch · detección de dispositivo · rendimiento · ZIP · grabación de audio · voz a texto
IA y chat: stream · conversation · i18n
Dibujado: motor 2D · DOM virtual · ayudas para canvas · tween
Node: servidor HTTP y enrutador · operaciones con archivos · tipos MIME
Esto es una selección. La referencia de la API tiene todas las exportaciones con su firma y su descripción, generadas desde el código para que no puedan quedarse atrás.
A dónde ir después
| Si quieres… | Lee |
|---|---|
| Averiguar si una función existe, y con qué firma | Referencia de la API |
| Decidir entre dos utilidades parecidas | Elegir una utilidad |
| Curiosear por categorías | Índice de utilidades |
| Dibujar la respuesta de un modelo que llega por streaming | stream → conversation |
| Construir interfaz encima | ranui |
Los dos paquetes incluyen un CLAUDE.md dentro del tarball de npm: orientación para agentes de código, legible directamente desde node_modules y sin acceso a la red.