isthor 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# ⚡ Isthor
+
+**Isthor** is a minimalist, type-safe, and reactive state management library for React, powered by **Zod** and **JavaScript Proxies**.
+
+No Providers, no boilerplate, just pure reactivity.
+
+## ✨ Features
+
+- **Runtime Validation**: Your state is always valid, thanks to Zod.
+- **Invisible Reactivity**: Update state like a normal object; your UI reacts instantly.
+- **Zero Boilerplate**: No context providers or complex actions needed.
+- **Global & Decoupled**: Update state from anywhere, even outside React components.
+
+## 🚀 Installation
+
+```bash
+bun install isthor zod
+```
+
+## 🛠️ Usage
+
+### 1. Define your store
+
+Create a schema and initialize your store. It returns a tuple: the proxy object for updates and a hook for React components.
+
+```typescript
+// store.ts
+import isthor from "isthor";
+import { z } from "zod";
+
+const UserSchema = z.object({
+  name: z.string().min(2),
+  points: z.number(),
+});
+
+export const [user, useUser] = isthor(UserSchema, {
+  name: "Zaqueu",
+  points: 0,
+});
+```
+
+### 2. Consume and Update in React
+
+```typescript
+import { user, useUser } from "./store";
+
+export default function App() {
+  const state = useUser(); // Reactive hook
+
+  return (
+    <div>
+      <h1>{state.name}: {state.points}pts</h1>
+
+      {/* Update the object directly! */}
+      <button onClick={() => user.points++}>
+        Add Point
+      </button>
+
+      <input
+        onChange={(e) => (user.name = e.target.value)}
+        placeholder="Update name"
+      />
+    </div>
+  );
+}
+```
+
+## 🧠 How it works
+
+Isthor uses a Proxy to intercept property assignments. When you change a value, it:
+
+1. Validates the change against your Zod schema.
+2. Updates the internal storage.
+3. Notifies all subscribed hooks via a WeakMap-based observer system.
+
+## License
+
+MIT © Zaqueu Nilton

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export default function isthor<T extends z.ZodObject<any, any>>(schema: T, initialData?: z.infer<T>): readonly [z.core.output<T>, () => z.core.output<T>];

package/dist/index.js

@@ -0,0 +1,54 @@
+import { useState, useEffect } from "react";
+const listeners = new WeakMap();
+function notify(target) {
+    const subs = listeners.get(target);
+    if (subs) {
+        subs.forEach((callback) => callback());
+    }
+}
+function subscribe(target, callback) {
+    if (!listeners.has(target)) {
+        listeners.set(target, new Set());
+    }
+    listeners.get(target).add(callback);
+    return () => {
+        listeners.get(target)?.delete(callback);
+    };
+}
+export default function isthor(schema, initialData) {
+    let _storage = initialData ?? {};
+    const proxy = new Proxy(_storage, {
+        get(target, prop) {
+            return Reflect.get(target, prop);
+        },
+        set(target, prop, value) {
+            const key = prop;
+            try {
+                const fieldSchema = schema.shape[key];
+                if (fieldSchema) {
+                    fieldSchema.parse(value);
+                }
+            }
+            catch (error) {
+                console.error(`⚡ Isthor: Erro de validação na chave "${String(prop)}":`, error);
+                return false;
+            }
+            const success = Reflect.set(target, prop, value);
+            if (success) {
+                notify(proxy);
+            }
+            return success;
+        },
+    });
+    function useStore() {
+        const [, setTick] = useState(0);
+        useEffect(() => {
+            const unsub = subscribe(proxy, () => {
+                setTick((t) => t + 1);
+            });
+            return unsub;
+        }, []);
+        return proxy;
+    }
+    return [proxy, useStore];
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "isthor",
+  "version": "1.0.0",
+  "description": "Minimalist reactive state management powered by Zod and Proxies.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "react",
+    "state",
+    "management",
+    "zod",
+    "proxy",
+    "reactive"
+  ],
+  "author": "Zaqueu Nilton",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}