memorio 4.9.31 → 4.9.35

package/README.md

@@ -34,6 +34,7 @@ The global API is a **choice**, not an architectural requirement.
 
 - [Why memorio](#why-memorio)
 - [Global is optional](#global-is-optional)
+- [Before / After](#before--after)
 - [Which layer should I use](#which-layer-should-i-use)
 - [Install](#install)
 - [Quick start](#quick-start)
@@ -50,6 +51,7 @@ The global API is a **choice**, not an architectural requirement.
 - [When to use something else](#when-to-use-something-else)
 - [Design philosophy](#design-philosophy)
 - [A mental model](#a-mental-model)
+- [Recipes](#recipes)
 - [License](#license)
 
 ---
@@ -124,6 +126,30 @@ npm install sql.js            # sqlite engine
 
 **Zero production dependencies** in the core package. See [Security](#security).
 
+## Before / After
+
+```ts
+// Without memorio
+const [user, setUser] = useState(null)
+useEffect(() => {
+  const saved = localStorage.getItem('user')
+  if (saved) setUser(JSON.parse(saved))
+}, [])
+useEffect(() => {
+  localStorage.setItem('user', JSON.stringify(user))
+}, [user])
+```
+
+```ts
+// With memorio
+import 'memorio'
+store.set('user', { name: 'Sara' })   // persistent immediately, no boilerplate
+
+const user = store.get('user')
+```
+
+Same result, one reactive line instead of two effects and manual JSON serialization.
+
 ## Quick start
 
 ```ts
@@ -529,6 +555,29 @@ memorio is intentionally not everything.
 
 The important part is not that memorio has many layers — it's that **you do not have to use them all**.
 
+## Sneak Peek
+
+### Making a `state` slice persistent
+
+`state` is reactive but not persistent; `store` is persistent but not reactive. `persist()` bridges the two — it restores the value from `store` and then keeps the selected state path synchronized with it:
+
+```ts
+import 'memorio'
+
+state.user = { name: 'Sara' }
+
+const off = persist('state.user')   // restore from store, then persist changes
+
+// later, e.g. on component unmount
+off()
+```
+
+`persist()` uses the same path syntax as `observer()`.
+
+Nested paths such as `state.user.preferences.theme` are supported, provided the intermediate objects already exist in `state`.
+
+In environments without `localStorage` (Node/Deno/edge), `store` falls back to memory. `persist()` still works there, but persistence does not survive process or runtime restarts.
+
 ## License
 
 MIT © Dario Passariello

package/index.cjs

@@ -1889,6 +1889,7 @@ var schema = {
 };
 
 // functions/state/index.ts
+init_store();
 init_env();
 var TARGET = /* @__PURE__ */ Symbol("memorio.target");
 var wrapperCache = /* @__PURE__ */ new WeakMap();
@@ -1903,6 +1904,7 @@ var deepRaw = /* @__PURE__ */ __name((val, seen = null) => {
   if (ctor !== "Object" && ctor !== "Array") return val;
   const copy = Array.isArray(val) ? [] : {};
   for (const k of Reflect.ownKeys(val)) {
+    if (!Object.prototype.propertyIsEnumerable.call(val, k)) continue;
     copy[k] = deepRaw(val[k], seen);
   }
   return copy;
@@ -2125,6 +2127,39 @@ if (globalThis[STATE_INSTANCE_KEY]) {
     exports.internal.locked = false;
     message_default("State is now unlocked. Modifications are allowed.");
   };
+  exports.state.persist = (path) => {
+    if (typeof path !== "string" || !path.length) {
+      if (exports.DEV) console.warn('[memorio state] state.persist() requires a non-empty path string (e.g. "state.user")');
+      return () => {
+      };
+    }
+    const normalized = path.startsWith("state.") ? path : "state." + path;
+    const key = normalized.replace(/^state\./, "");
+    const segments = key.split(".");
+    const initial = exports.store.get(key);
+    if (initial !== void 0 && initial !== null) {
+      let acc = exports.state;
+      for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (i === segments.length - 1) {
+          acc[seg] = deepRaw(initial);
+        } else {
+          if (acc[seg] === void 0 || acc[seg] === null) acc[seg] = {};
+          acc = acc[seg];
+        }
+      }
+    }
+    const handler = /* @__PURE__ */ __name(() => {
+      let current = exports.state;
+      for (const seg of segments) {
+        current = current === void 0 || current === null ? void 0 : current[seg];
+      }
+      exports.store.set(key, deepRaw(current));
+    }, "handler");
+    const off = dispatch.listen(normalized, handler);
+    return typeof off === "function" ? off : () => {
+    };
+  };
   globalThis[STATE_INSTANCE_KEY] = exports.state;
 }
 
@@ -3303,7 +3338,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.31"};
+  version: "4.9.35"};
 
 // core/global.ts
 init_env();

package/index.js

@@ -1886,6 +1886,7 @@ var schema = {
 };
 
 // functions/state/index.ts
+init_store();
 init_env();
 var TARGET = /* @__PURE__ */ Symbol("memorio.target");
 var wrapperCache = /* @__PURE__ */ new WeakMap();
@@ -1900,6 +1901,7 @@ var deepRaw = /* @__PURE__ */ __name((val, seen = null) => {
   if (ctor !== "Object" && ctor !== "Array") return val;
   const copy = Array.isArray(val) ? [] : {};
   for (const k of Reflect.ownKeys(val)) {
+    if (!Object.prototype.propertyIsEnumerable.call(val, k)) continue;
     copy[k] = deepRaw(val[k], seen);
   }
   return copy;
@@ -2122,6 +2124,39 @@ if (globalThis[STATE_INSTANCE_KEY]) {
     internal_default.locked = false;
     message_default("State is now unlocked. Modifications are allowed.");
   };
+  state2.persist = (path2) => {
+    if (typeof path2 !== "string" || !path2.length) {
+      if (DEV) console.warn('[memorio state] state.persist() requires a non-empty path string (e.g. "state.user")');
+      return () => {
+      };
+    }
+    const normalized = path2.startsWith("state.") ? path2 : "state." + path2;
+    const key = normalized.replace(/^state\./, "");
+    const segments = key.split(".");
+    const initial = store.get(key);
+    if (initial !== void 0 && initial !== null) {
+      let acc = state2;
+      for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (i === segments.length - 1) {
+          acc[seg] = deepRaw(initial);
+        } else {
+          if (acc[seg] === void 0 || acc[seg] === null) acc[seg] = {};
+          acc = acc[seg];
+        }
+      }
+    }
+    const handler = /* @__PURE__ */ __name(() => {
+      let current = state2;
+      for (const seg of segments) {
+        current = current === void 0 || current === null ? void 0 : current[seg];
+      }
+      store.set(key, deepRaw(current));
+    }, "handler");
+    const off = dispatch.listen(normalized, handler);
+    return typeof off === "function" ? off : () => {
+    };
+  };
   globalThis[STATE_INSTANCE_KEY] = state2;
 }
 
@@ -3300,7 +3335,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.31"};
+  version: "4.9.35"};
 
 // core/global.ts
 init_env();