valtio

Valtio es una biblioteca de gestión de estado construida en torno a los proxies de JavaScript, utilizable con React y en JavaScript vanilla puro. Su idea central es simple: envuelve un objeto de estado con `proxy()` y se convierte en un proxy autoconsciente que puede mutarse como un objeto normal desde cualquier lugar del código. Capacidades clave descritas en el README: - **Estado proxy**: `proxy({ count: 0, text: 'hello' })` crea estado mutable; mutaciones como `++state.count` funcionan como con objetos ordinarios. - **Integración con React**: `useSnapshot(state)` devuelve una instantánea local para el renderizado. Los componentes solo se vuelven a renderizar cuando cambian las partes del estado a las que se accede, lo que el proyecto describe como optimizado para el renderizado. Una opción `sync: true` desactiva el agrupamiento para casos como entradas controladas. - **Suscripciones**: `subscribe` funciona sobre todo el estado o subobjetos, y `subscribeKey` se dirige a valores primitivos. Una utilidad `watch` se suscribe automáticamente según el uso. - **Soporte de Suspense**: Compatible con el hook `use` de React 19 para leer datos asíncronos contenidos en el estado, con el padre gestionando el fallback y los errores. - **Objetos no rastreados**: `ref` mantiene objetos grandes o especiales (como nodos DOM) dentro del estado sin aplicarles proxy. - **Uso en vanilla**: `valtio/vanilla` exporta `proxy`, `subscribe` y `snapshot` para su uso fuera de React. - **Utilidades**: `useProxy` ofrece un proxy superficial simplificado para principiantes; `proxySet` y `proxyMap` imitan el comportamiento nativo de Set y Map; las propiedades computadas pueden definirse con getters de objeto. - **Herramientas de desarrollo**: Integración con la extensión Redux DevTools para objetos simples y arrays. - **Compatibilidad**: Valtio v2 está dirigido a React 18 y superiores, depende solo de `react`, y funciona con renderizadores como react-dom, react-native y react-three-fiber, así como con Node.js y Next.js. El README también señala advertencias sobre el tipado en TypeScript en torno al tipo de instantánea de solo lectura, advierte sobre el comportamiento de `this` en métodos (recomendando funciones flecha), y apunta a un plugin de eslint además de recetas de la comunidad para organizar acciones, persistir el estado, usar contexto y dividir/componer el estado.