Administrar el estado global en aplicaciones JavaScript, especialmente cuando necesita que sea accesible en contextos React y no React, puede ser un desafío. Las bibliotecas existentes a menudo implican una configuración pesada, una complejidad innecesaria y están estrechamente vinculadas con React. Pero ¿y si pudieras gestionar el estado con la elegancia y sencillez del plegado de papel? Ingrese Origami-State-Manager (OSM).

¿Qué es OSM?

Origami-State-Manager (OSM), pronunciado "impresionante", es una biblioteca liviana de administración de estados diseñada para ser simple, flexible y escalable. Inspirado en el arte japonés del origami, que transforma una hoja de papel normal en diseños complejos, OSM le permite gestionar el estado global de su aplicación con la misma elegancia. Al igual que el papel, es increíblemente liviano, lo que lo hace perfecto para aplicaciones donde la simplicidad y el rendimiento son importantes.

¿Por qué OSM?

El viaje hacia la construcción de OSM comenzó como la búsqueda de una solución que pudiera:

• Minimizar texto estándar: La gestión del estado debe ser sencilla y requerir la menor configuración posible.
• Sea versátil: Trabaje sin problemas en contextos React y no React.
• Manténgase liviano: Evite inflar su paquete con código innecesario.
• Manténgase flexible y escalable: Adáptese sin esfuerzo a las diferentes necesidades del proyecto mientras mantiene el rendimiento.

Si estás cansado de soluciones excesivamente diseñadas y quieres algo que simplemente funcione, OSM podría ser la herramienta "increíble" que necesitas.

Características clave

• Configuración mínima: Defina y administre rápidamente su estado global con una API limpia e intuitiva.
• Compatibilidad React y Non-React: Se puede acceder a los estados y actualizarlos tanto desde los componentes de React como desde las funciones simples de JavaScript.
• Ligero: Tan liviano como el papel, OSM mantiene tu aplicación rápida y responsiva.
• Opciones de persistencia: Haz que tus estados sean persistentes con una configuración simple.

Comenzando con OSM

¿Listo para agregar algo de OSM a tu aplicación? A continuación le indicamos cómo empezar:

1. Instalar la biblioteca:

npm install origami-state-manager

2. Crear una tienda:

Una tienda es el lugar donde viven todos los estados globales. Configurar uno es tan fácil como pasar los valores de estado iniciales a createStore:

// store.ts
import { createStore } from "origami-state-manager";

const initialValues = {
  origami: 0,
  osmness: 0,
};

export const store = createStore(initialValues);

También puedes hacer que la tienda sea persistente proporcionando un nombre de tienda:

export const store = createStore(initialValues, "myOSMness");

3. Estado de acceso y actualización:

Para los componentes de React, use el gancho useStateListener para acceder y actualizar el estado:

import { store } from "./store";
import { useStateListener } from "origami-state-manager";

function OrigamiComponent() {
  const origami = useStateListener("origami", store);

  return (
     store["origami"].value = new Date().getSeconds()}>
      Origami Count: {origami}
    
  );
}

4. Estado de acceso en funciones que no son de React:

También puedes trabajar fácilmente con el estado fuera de React:

// utils.js

function getProfile() {
  let profile = store["profile"].value;
  if (!profile) {
    store["profile"].value = {};
  }

  return store["profile"].value;
}

Casos de uso

OSM es perfecto para escenarios donde:

• Necesita una solución ligera para una gestión sencilla del estado global.
• Su proyecto involucra lógica React y no React que debe compartir el estado global.
• Quieres evitar la complejidad de bibliotecas más grandes como Redux o MobX.

Precaución: ¡Algunas sorpresas más adelante!

OSM aún se encuentra en sus primeras etapas y no se ha probado completamente en todos los entornos. Si bien es ideal para proyectos más pequeños y necesidades estatales sencillas, es recomendable tener cuidado al usarlo en escenarios complejos. Si encuentra algún problema, infórmelo para que la biblioteca pueda seguir mejorando.

Contribuyendo a OSM

¿Interesado en ayudar a que OSM sea aún más increíble? ¡Las contribuciones son bienvenidas! Consulte las pautas de contribución para comenzar.

Manténgase actualizado

El registro de cambios se actualiza periódicamente con todos los nuevos cambios y mejoras.

Pensamientos finales

Origami-State-Manager (OSM) tiene como objetivo proporcionar una solución simple pero poderosa para la gestión del estado global sin excesos. Al mantener la configuración mínima y el rendimiento alto, OSM le permite concentrarse en crear funciones en lugar de luchar con la complejidad del estado.

¡Pruébalo y experimenta un nuevo nivel de OSM-ness en tus proyectos!

Comience con OSM hoy: npm: origami-state-manager