@buoy-gg/zustand 7.0.15 → 7.0.17

package/lib/commonjs/index.js

@@ -93,6 +93,7 @@ Object.defineProperty(exports, "zustandToolPreset", {
     return _preset.zustandToolPreset;
   }
 });
+require("./zustand/utils/snapshotProvider");
 var _preset = require("./preset");
 var _buoyZustandMiddleware = require("./zustand/utils/buoyZustandMiddleware");
 var _useZustandStateChanges = require("./zustand/hooks/useZustandStateChanges");

package/lib/commonjs/zustand/utils/snapshotProvider.js

@@ -0,0 +1,171 @@
+"use strict";
+
+var _sharedUi = require("@buoy-gg/shared-ui");
+var _zustandStateStore = require("./zustandStateStore");
+/**
+ * Time Machine snapshot provider for Zustand.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine. Neither package imports the other.
+ *
+ * The Zustand-specific hazard: stores conventionally keep their action
+ * functions IN state (`increment: () => ...`). Functions don't survive
+ * serialization, and a full `setState(snapshot, true)` replace would wipe
+ * them, breaking every `useStore(s => s.increment)` call site. So capture
+ * strips functions (recording where they were), and restore re-grafts the
+ * LIVE store's functions onto the snapshot before replacing.
+ */
+
+const MAX_DEPTH = 8;
+function isPlainObjectLike(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/** Clone `value` without functions, recording their paths. */
+function stripFunctions(value, path, fnPaths, seen, depth) {
+  if (typeof value === "function") {
+    fnPaths.push(path);
+    return undefined;
+  }
+  if (typeof value !== "object" || value === null || depth >= MAX_DEPTH) {
+    return value;
+  }
+  if (seen.has(value)) return undefined; // cycle — drop the back-reference
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.map((item, i) => typeof item === "function" ? (fnPaths.push(`${path}[${i}]`), null) : stripFunctions(item, `${path}[${i}]`, fnPaths, seen, depth + 1));
+  }
+  if (!isPlainObjectLike(value)) return value; // Date/Map/Set/etc. — superjson handles
+  const out = {};
+  for (const [k, v] of Object.entries(value)) {
+    if (typeof v === "function") {
+      fnPaths.push(path ? `${path}.${k}` : k);
+      continue;
+    }
+    out[k] = stripFunctions(v, path ? `${path}.${k}` : k, fnPaths, seen, depth + 1);
+  }
+  return out;
+}
+
+/**
+ * Copy every function-valued property from the LIVE state onto the restored
+ * snapshot (creating containers as needed), so store actions keep working
+ * after a full replace.
+ */
+function graftFunctions(target, live, seen, depth) {
+  if (!isPlainObjectLike(live) || !isPlainObjectLike(target)) return;
+  if (depth >= MAX_DEPTH || seen.has(live)) return;
+  seen.add(live);
+  for (const [k, v] of Object.entries(live)) {
+    if (typeof v === "function") {
+      target[k] = v;
+    } else if (isPlainObjectLike(v)) {
+      if (!isPlainObjectLike(target[k])) {
+        // Branch missing from the snapshot — only recreate it if it holds
+        // functions somewhere; otherwise the snapshot's absence wins.
+        if (!containsFunction(v, new WeakSet(), depth + 1)) continue;
+        target[k] = {};
+      }
+      graftFunctions(target[k], v, seen, depth + 1);
+    }
+  }
+}
+function containsFunction(value, seen, depth) {
+  if (depth >= MAX_DEPTH || seen.has(value)) return false;
+  seen.add(value);
+  for (const v of Object.values(value)) {
+    if (typeof v === "function") return true;
+    if (isPlainObjectLike(v) && containsFunction(v, seen, depth + 1)) return true;
+  }
+  return false;
+}
+function status() {
+  const count = _zustandStateStore.zustandStateStore.getStores().length;
+  if (count === 0) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: "No Zustand stores registered — pass `zustandStores` to FloatingDevTools or add the buoyDevTools middleware"
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true
+  };
+}
+async function capture() {
+  const warnings = [];
+  const stores = {};
+  for (const info of _zustandStateStore.zustandStateStore.getStores()) {
+    const fnPaths = [];
+    let state;
+    try {
+      state = stripFunctions(info.api.getState(), "", fnPaths, new WeakSet(), 0);
+    } catch (e) {
+      warnings.push(`store "${info.name}": capture failed (${String(e)})`);
+      continue;
+    }
+    stores[info.name] = {
+      state,
+      fnPaths
+    };
+  }
+  return {
+    data: {
+      stores
+    },
+    warnings
+  };
+}
+async function restore(data) {
+  const snapshot = data;
+  const result = {
+    ok: true,
+    applied: 0,
+    skipped: [],
+    warnings: []
+  };
+  if (!snapshot?.stores) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [],
+      warnings: ["empty zustand snapshot"]
+    };
+  }
+  for (const [name, envelope] of Object.entries(snapshot.stores)) {
+    const info = _zustandStateStore.zustandStateStore.getStore(name);
+    if (!info) {
+      result.skipped.push({
+        id: name,
+        reason: "store not registered (renamed, or created after snapshot?)"
+      });
+      continue;
+    }
+    try {
+      const next = envelope.state;
+      graftFunctions(next, info.api.getState(), new WeakSet(), 0);
+      info.api.setState(next, true);
+      if (info.api.getState() === next) {
+        result.applied += 1;
+      } else {
+        result.warnings.push(`store "${name}": setState did not take effect`);
+        result.ok = false;
+      }
+    } catch (e) {
+      result.skipped.push({
+        id: name,
+        reason: String(e)
+      });
+      result.ok = false;
+    }
+  }
+  return result;
+}
+(0, _sharedUi.registerStateSnapshotProvider)({
+  id: "zustand",
+  label: "Zustand",
+  status,
+  capture,
+  restore
+});

package/lib/module/index.js

@@ -37,6 +37,9 @@
  * ```
  */
 
+// Side-effect: registers the Time Machine snapshot provider
+import "./zustand/utils/snapshotProvider";
+
 // =============================================================================
 // PRESET (Primary entry point for FloatingDevTools)
 // =============================================================================

package/lib/module/zustand/utils/snapshotProvider.js

@@ -0,0 +1,170 @@
+"use strict";
+
+/**
+ * Time Machine snapshot provider for Zustand.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine. Neither package imports the other.
+ *
+ * The Zustand-specific hazard: stores conventionally keep their action
+ * functions IN state (`increment: () => ...`). Functions don't survive
+ * serialization, and a full `setState(snapshot, true)` replace would wipe
+ * them, breaking every `useStore(s => s.increment)` call site. So capture
+ * strips functions (recording where they were), and restore re-grafts the
+ * LIVE store's functions onto the snapshot before replacing.
+ */
+import { registerStateSnapshotProvider } from "@buoy-gg/shared-ui";
+import { zustandStateStore } from "./zustandStateStore";
+const MAX_DEPTH = 8;
+function isPlainObjectLike(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/** Clone `value` without functions, recording their paths. */
+function stripFunctions(value, path, fnPaths, seen, depth) {
+  if (typeof value === "function") {
+    fnPaths.push(path);
+    return undefined;
+  }
+  if (typeof value !== "object" || value === null || depth >= MAX_DEPTH) {
+    return value;
+  }
+  if (seen.has(value)) return undefined; // cycle — drop the back-reference
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.map((item, i) => typeof item === "function" ? (fnPaths.push(`${path}[${i}]`), null) : stripFunctions(item, `${path}[${i}]`, fnPaths, seen, depth + 1));
+  }
+  if (!isPlainObjectLike(value)) return value; // Date/Map/Set/etc. — superjson handles
+  const out = {};
+  for (const [k, v] of Object.entries(value)) {
+    if (typeof v === "function") {
+      fnPaths.push(path ? `${path}.${k}` : k);
+      continue;
+    }
+    out[k] = stripFunctions(v, path ? `${path}.${k}` : k, fnPaths, seen, depth + 1);
+  }
+  return out;
+}
+
+/**
+ * Copy every function-valued property from the LIVE state onto the restored
+ * snapshot (creating containers as needed), so store actions keep working
+ * after a full replace.
+ */
+function graftFunctions(target, live, seen, depth) {
+  if (!isPlainObjectLike(live) || !isPlainObjectLike(target)) return;
+  if (depth >= MAX_DEPTH || seen.has(live)) return;
+  seen.add(live);
+  for (const [k, v] of Object.entries(live)) {
+    if (typeof v === "function") {
+      target[k] = v;
+    } else if (isPlainObjectLike(v)) {
+      if (!isPlainObjectLike(target[k])) {
+        // Branch missing from the snapshot — only recreate it if it holds
+        // functions somewhere; otherwise the snapshot's absence wins.
+        if (!containsFunction(v, new WeakSet(), depth + 1)) continue;
+        target[k] = {};
+      }
+      graftFunctions(target[k], v, seen, depth + 1);
+    }
+  }
+}
+function containsFunction(value, seen, depth) {
+  if (depth >= MAX_DEPTH || seen.has(value)) return false;
+  seen.add(value);
+  for (const v of Object.values(value)) {
+    if (typeof v === "function") return true;
+    if (isPlainObjectLike(v) && containsFunction(v, seen, depth + 1)) return true;
+  }
+  return false;
+}
+function status() {
+  const count = zustandStateStore.getStores().length;
+  if (count === 0) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: "No Zustand stores registered — pass `zustandStores` to FloatingDevTools or add the buoyDevTools middleware"
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true
+  };
+}
+async function capture() {
+  const warnings = [];
+  const stores = {};
+  for (const info of zustandStateStore.getStores()) {
+    const fnPaths = [];
+    let state;
+    try {
+      state = stripFunctions(info.api.getState(), "", fnPaths, new WeakSet(), 0);
+    } catch (e) {
+      warnings.push(`store "${info.name}": capture failed (${String(e)})`);
+      continue;
+    }
+    stores[info.name] = {
+      state,
+      fnPaths
+    };
+  }
+  return {
+    data: {
+      stores
+    },
+    warnings
+  };
+}
+async function restore(data) {
+  const snapshot = data;
+  const result = {
+    ok: true,
+    applied: 0,
+    skipped: [],
+    warnings: []
+  };
+  if (!snapshot?.stores) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [],
+      warnings: ["empty zustand snapshot"]
+    };
+  }
+  for (const [name, envelope] of Object.entries(snapshot.stores)) {
+    const info = zustandStateStore.getStore(name);
+    if (!info) {
+      result.skipped.push({
+        id: name,
+        reason: "store not registered (renamed, or created after snapshot?)"
+      });
+      continue;
+    }
+    try {
+      const next = envelope.state;
+      graftFunctions(next, info.api.getState(), new WeakSet(), 0);
+      info.api.setState(next, true);
+      if (info.api.getState() === next) {
+        result.applied += 1;
+      } else {
+        result.warnings.push(`store "${name}": setState did not take effect`);
+        result.ok = false;
+      }
+    } catch (e) {
+      result.skipped.push({
+        id: name,
+        reason: String(e)
+      });
+      result.ok = false;
+    }
+  }
+  return result;
+}
+registerStateSnapshotProvider({
+  id: "zustand",
+  label: "Zustand",
+  status,
+  capture,
+  restore
+});

package/lib/typescript/index.d.ts

@@ -34,6 +34,7 @@
  * );
  * ```
  */
+import "./zustand/utils/snapshotProvider";
 export { zustandToolPreset, createZustandTool } from "./preset";
 export { watchStores } from "./zustand/utils/buoyZustandMiddleware";
 export { buoyDevTools } from "./zustand/utils/buoyZustandMiddleware";

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAK5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,YAAY,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAO3F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAKnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAKzB,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,kCAAkC,CAAC;AAK1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAK5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,YAAY,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAO3F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAKnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAKzB,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/lib/typescript/zustand/utils/snapshotProvider.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotProvider.d.ts.map

package/lib/typescript/zustand/utils/snapshotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotProvider.d.ts","sourceRoot":"","sources":["../../../../src/zustand/utils/snapshotProvider.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/zustand",
-  "version": "7.0.15",
+  "version": "7.0.17",
   "description": "Zustand devtools inside your React Native app — state diffs, jump-to-state & one-tap store reset, no middleware. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -24,10 +24,13 @@
   "files": [
     "lib"
   ],
-  "sideEffects": false,
+  "sideEffects": [
+    "**/snapshotProvider.js",
+    "**/snapshotProvider.ts"
+  ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.15",
-    "@buoy-gg/license": "^7.0.15"
+    "@buoy-gg/shared-ui": "^7.0.17",
+    "@buoy-gg/license": "^7.0.17"
   },
   "peerDependencies": {
     "react": "*",