react-globo-state 1.1.0 → 1.1.6

package/README.md

@@ -1,7 +1,5 @@
 # [React Globo State - gState.](https://npmjs.com/package/react-globo-state)
 
-A react state everywhere, easy and smart ... Only one!
-
 **React Globo State** by [Dario Passariello](https://dario.passariello.ca) (c)
 
 [![version](https://img.shields.io/npm/v/react-globo-state.svg)](https://npmjs.org/package/react-globo-state)
@@ -12,6 +10,36 @@ A react state everywhere, easy and smart ... Only one!
 ![ESLint](https://img.shields.io/badge/ESLint-gray?logo=eslint)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 
+## 🚀 Ultra-Optimized React State Engine
+
+A tiny, blazing-fast state container designed for modern React applications. Built for developers who demand **maximum performance**, **minimal re-renders**, and **predictable reactivity** without the overhead of traditional state managers.
+
+### ⚡ Why this package exists
+
+React's built-in state works well for small components, but as your app scales, you start battling unnecessary renders, complex memoization, and context bloat. This package delivers a **super-optimized state layer** that updates only what truly needs to update.
+
+### 🧠 Key Features
+
+- **Granular subscriptions** - Components re-render only when the specific data they use changes.
+- **Reduce useMEmo use** - Help you to architect a better structure of your application avoid tons of useMemo.
+- **Single container** - Only one container for entire state. No more lost states or unless data in memory.
+- **No more imports** - Only one imports and ready to work.
+- **Zero dependencies** - Lightweight and ideal for high-performance apps or micro-frontend.
+- **Immutable-friendly** - Works seamlessly with immutable patterns while staying fast.
+- **Concurrent-mode ready** - Designed for React and future-proofed for modern rendering.
+- **TypeScript first** - Fully typed API for safe, predictable state flows.
+
+### 🧩 Perfect for
+
+- High-frequency UI updates (dashboards, 3D apps, visualizers)
+- Enterprise-scale applications
+- Performance-critical components
+- Developers who want a simple API with extreme optimization
+
+### 🛠️ How it works
+
+The engine uses a **subscription-based reactive core** with micro-level diffing. Only the components that depend on changed values re-render. No proxies, no global invalidation, no magic just deterministic, high-performance state management.
+
 ## install
 
 ```bash
@@ -50,7 +78,11 @@ const App = () => {
     },[]
   )
 
-  return <div>{ JSON.stringify(gState.get("test")) }</div>
+  return <div>
+    {
+      gState.get("test").myNewReactState // result -> hello world!
+    }
+  </div>
 
 }
 

package/index.js

@@ -1 +1 @@
-import{useState as n}from"react";const e={};globalThis.globoState=()=>{const[r,u]=n(null);globalThis.gState={get:t=>{if(t&&t)return r?.[t]?r[t]:null},set:(t,l)=>{if(!(!t||!l))return e[t]=l,u({...e}),!0},remove:t=>{if(t)return delete e[t],u({...e}),!0},delete:t=>{if(t)return gState.remove(t),!0},deleteAll:()=>(u({}),!0),list:()=>r}};
+import{useState as n}from"react";const t={};Object.defineProperty(globalThis,"globoState",{value:()=>{const[r,l]=n(null);Object.defineProperty(globalThis,"gState",{value:{get:e=>{if(e)return r?.[e]?r[e]:null},set:(e,u)=>{if(!(!e||!u))return t[e]=u,l({...t}),!0},remove:e=>{if(e)return delete t[e],l({...t}),!0},delete:e=>{if(e)return gState.remove(e),!0},deleteAll:()=>(l({}),!0),list:()=>r},configurable:!0,enumerable:!1}),Object.freeze("gState")},configurable:!0,enumerable:!1});Object.freeze("globoState");

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "react-globo-state",
-  "version": "1.1.0",
+  "version": "1.1.6",
   "description": "A react state everywhere made easy",
   "keywords": [
+    "gState",
+    "front-end",
+    "back-end",
+    "framework",
+    "useState",
     "react",
     "state",
-    "render",
     "global",
     "dario",
     "passariello"