state-jet 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,14 @@
+# ⚡ fast-state: Ultra-Lightweight Global State for React
+
+A zero-boilerplate, ultra-fast global state management library for React. No context, reducers, or providers—just simple reactive state.
+
+## 🚀 Why fast-state?
+- ✅ **No Context, No Providers** – Works outside React, reducing unnecessary re-renders.
+- ✅ **Automatic Re-Renders** – Only components using specific state values update.
+- ✅ **Super Lightweight** – Less than **1KB** minified!
+- ✅ **SSR & Next.js Support** – Works on both client and server.
+
+## 🛠 Installation
+```bash
+npm install state-jet
+```

package/dist/example/App.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = App;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const index_1 = require("../src/index");
+const middleware_1 = require("../src/middleware");
+const counter = (0, index_1.useStateGlobal)("counter", 0, { middleware: [middleware_1.loggerMiddleware] });
+function App() {
+    const { undo, redo } = counter;
+    const count = counter.useStore();
+    return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("button", { onClick: () => counter.set(count + 1), children: "+" }), (0, jsx_runtime_1.jsx)("button", { onClick: () => counter.set(count - 1), children: "-" }), (0, jsx_runtime_1.jsx)("button", { onClick: undo, children: "Undo" }), (0, jsx_runtime_1.jsx)("button", { onClick: redo, children: "Redo" }), (0, jsx_runtime_1.jsxs)("p", { children: ["Count: ", count] })] }));
+}

package/dist/src/crdt.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncCRDT = exports.mergeCRDT = void 0;
+const store_1 = require("./store");
+const mergeCRDT = (localState, remoteState) => {
+    return Object.assign(Object.assign(Object.assign({}, localState), remoteState), { lastUpdated: Date.now() });
+};
+exports.mergeCRDT = mergeCRDT;
+const syncCRDT = (key, remoteState) => {
+    const localState = (0, store_1.useStateGlobal)(key).useStore();
+    const merged = (0, exports.mergeCRDT)(localState, remoteState);
+    (0, store_1.useStateGlobal)(key).set(merged);
+};
+exports.syncCRDT = syncCRDT;

package/dist/src/derived.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivedState = void 0;
+const derivedState = (dependencies, computeFn) => {
+    const derived = { value: computeFn(...dependencies.map((d) => d.useStore())) };
+    dependencies.forEach(dep => dep.useStore().listeners.add(() => {
+        derived.value = computeFn(...dependencies.map(d => d.useStore()));
+    }));
+    return () => derived.value;
+};
+exports.derivedState = derivedState;

package/dist/src/encryption.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEncryptedState = exports.saveEncryptedState = exports.decrypt = exports.encrypt = void 0;
+const encrypt = (data) => btoa(JSON.stringify(data));
+exports.encrypt = encrypt;
+const decrypt = (data) => JSON.parse(atob(data));
+exports.decrypt = decrypt;
+const saveEncryptedState = (key, value) => {
+    localStorage.setItem(key, (0, exports.encrypt)(value));
+};
+exports.saveEncryptedState = saveEncryptedState;
+const loadEncryptedState = (key) => {
+    const data = localStorage.getItem(key);
+    return data ? (0, exports.decrypt)(data) : null;
+};
+exports.loadEncryptedState = loadEncryptedState;

package/dist/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncCRDT = exports.loadEncryptedState = exports.saveEncryptedState = exports.decrypt = exports.encrypt = exports.optimisticUpdate = exports.restoreState = exports.saveState = exports.useStateGlobal = void 0;
+var store_1 = require("./store");
+Object.defineProperty(exports, "useStateGlobal", { enumerable: true, get: function () { return store_1.useStateGlobal; } });
+var persistence_1 = require("./persistence");
+Object.defineProperty(exports, "saveState", { enumerable: true, get: function () { return persistence_1.saveState; } });
+Object.defineProperty(exports, "restoreState", { enumerable: true, get: function () { return persistence_1.restoreState; } });
+var optimistic_1 = require("./optimistic");
+Object.defineProperty(exports, "optimisticUpdate", { enumerable: true, get: function () { return optimistic_1.optimisticUpdate; } });
+var encryption_1 = require("./encryption");
+Object.defineProperty(exports, "encrypt", { enumerable: true, get: function () { return encryption_1.encrypt; } });
+Object.defineProperty(exports, "decrypt", { enumerable: true, get: function () { return encryption_1.decrypt; } });
+Object.defineProperty(exports, "saveEncryptedState", { enumerable: true, get: function () { return encryption_1.saveEncryptedState; } });
+Object.defineProperty(exports, "loadEncryptedState", { enumerable: true, get: function () { return encryption_1.loadEncryptedState; } });
+var crdt_1 = require("./crdt");
+Object.defineProperty(exports, "syncCRDT", { enumerable: true, get: function () { return crdt_1.syncCRDT; } });

package/dist/src/optimistic.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optimisticUpdate = void 0;
+const optimisticUpdate = (setState, apiCall, fallback) => {
+    const prevState = setState.useStore();
+    setState.set(apiCall(prevState));
+    apiCall()
+        .catch(() => setState.set(fallback ? fallback(prevState) : prevState));
+};
+exports.optimisticUpdate = optimisticUpdate;

package/dist/src/persistence.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoreState = exports.saveState = void 0;
+const saveState = (key, value, encrypt = false) => {
+    if (typeof window !== "undefined") {
+        let data = JSON.stringify(value);
+        if (encrypt)
+            data = btoa(data);
+        localStorage.setItem(key, data);
+    }
+};
+exports.saveState = saveState;
+const restoreState = (key) => {
+    if (typeof window !== "undefined") {
+        const data = localStorage.getItem(key);
+        return data ? JSON.parse(atob(data)) : undefined;
+    }
+};
+exports.restoreState = restoreState;

package/dist/{index.js → src/store.js}

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useStateGlobal = void 0;
 const react_1 = require("react");
 const immer_1 = require("immer");
+const persistence_1 = require("./persistence");
 const devtools_1 = require("./devtools");
 const store = new Map();
 const pendingUpdates = new Map();
@@ -10,13 +11,10 @@ const history = {};
 const useStateGlobal = (key, initialValue, options) => {
     if (!store.has(key)) {
         store.set(key, { value: initialValue, listeners: new Set() });
+        if (options === null || options === void 0 ? void 0 : options.persist)
+            (0, persistence_1.restoreState)(key);
     }
-    const state = (0, react_1.useMemo)(() => {
-        if (!store.has(key)) {
-            store.set(key, { value: initialValue, listeners: new Set() });
-        }
-        return store.get(key);
-    }, [key]);
+    const state = store.get(key);
     const undo = () => {
         var _a;
         if ((_a = history[key]) === null || _a === void 0 ? void 0 : _a.past.length) {
@@ -51,6 +49,8 @@ const useStateGlobal = (key, initialValue, options) => {
                 state.listeners.forEach((listener) => listener());
                 (0, devtools_1.notifyDevTools)(key, nextValue);
                 (0, devtools_1.measurePerformance)(key, () => { });
+                if (options === null || options === void 0 ? void 0 : options.persist)
+                    (0, persistence_1.saveState)(key, nextValue, options.encrypt);
             }
         });
         pendingUpdates.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "state-jet",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Ultra-lightweight global state management for React",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,23 +32,22 @@
     "test": "vitest",
     "clean": "rm -rf dist/*",
     "publish:npm": "npm publish --access public",
-    "lint": "eslint src --ext .ts,.tsx",
-    "prepare": "npm run clean && npm run build"
+    "lint": "eslint src --ext .ts,.tsx"
   },
   "devDependencies": {
+    "@types/react": "^19.0.3",
+    "@types/react-dom": "^19.0.2",
     "eslint": "^8.57.1",
     "immer": "^10.1.1",
     "react": "19.0.0",
     "react-dom": "19.0.0",
     "typescript": "^5.7.3",
-    "use-sync-external-store": "^1.4.0",
     "vitest": "^2.1.8"
   },
   "peerDependencies": {
     "@types/react": ">=18.0.0",
     "immer": ">=9.0.6",
-    "react": ">=18.0.0",
-    "use-sync-external-store": ">=1.2.0"
+    "react": ">=18.0.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -59,9 +58,6 @@
     },
     "react": {
       "optional": true
-    },
-    "use-sync-external-store": {
-      "optional": true
     }
   }
 }