@buoy-gg/redux 7.0.16 → 7.0.18

package/lib/commonjs/index.js

@@ -213,6 +213,7 @@ Object.defineProperty(exports, "withBuoyDevTools", {
     return _buoyReduxMiddleware.withBuoyDevTools;
   }
 });
+require("./redux/utils/snapshotProvider");
 var _devtoolsHook = require("./redux/utils/devtoolsHook");
 var _preset = require("./preset");
 var _buoyReduxMiddleware = require("./redux/utils/buoyReduxMiddleware");

package/lib/commonjs/redux/components/ReduxActionDetailContent.js

@@ -82,10 +82,11 @@ function ReduxActionDetailContent({
   actions,
   selectedIndex,
   onIndexChange,
-  disableInternalFooter = false
+  disableInternalFooter = false,
+  initialView = "action"
 }) {
-  // View state
-  const [activeView, setActiveView] = (0, _react.useState)("action");
+  // View state (initialView seeds it once; taps own it afterwards)
+  const [activeView, setActiveView] = (0, _react.useState)(initialView);
   const [diffMode, setDiffMode] = (0, _react.useState)("tree");
   const totalActions = actions.length;
   const actionColor = getActionColor(action.type);

package/lib/commonjs/redux/components/ReduxModal.js

@@ -49,7 +49,9 @@ function ReduxModal({
   onMinimize,
   enableSharedModalDimensions = false,
   inline = false,
-  onActionSelect
+  onActionSelect,
+  initialSelectedActionId,
+  initialDetailView
 }) {
   const isPro = (0, _license.useIsPro)();
   const [showProModal, setShowProModal] = (0, _react.useState)(false);
@@ -105,6 +107,19 @@ function ReduxModal({
     lastNotifiedSelectionRef.current = id;
     onActionSelect(selectedAction);
   }, [selectedAction, onActionSelect]);
+
+  // Deep link into an action's detail (see initialSelectedActionId). Applied
+  // at most once per id, so the list re-rendering — or the user pressing Back
+  // — never re-opens it.
+  const appliedInitialSelectionRef = (0, _react.useRef)(null);
+  (0, _react.useEffect)(() => {
+    if (!initialSelectedActionId) return;
+    if (appliedInitialSelectionRef.current === initialSelectedActionId) return;
+    const index = visibleActions.findIndex(a => a.id === initialSelectedActionId);
+    if (index < 0) return;
+    appliedInitialSelectionRef.current = initialSelectedActionId;
+    setSelectedActionIndex(index);
+  }, [initialSelectedActionId, visibleActions]);
   const [searchText, setSearchText] = (0, _react.useState)("");
   const [isSearchActive, setIsSearchActive] = (0, _react.useState)(false);
   const searchInputRef = (0, _react.useRef)(null);
@@ -307,7 +322,8 @@ function ReduxModal({
       actions: visibleActions,
       selectedIndex: selectedActionIndex,
       onIndexChange: handleIndexChange,
-      disableInternalFooter: true
+      disableInternalFooter: true,
+      initialView: initialDetailView
     }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [instrumentError && !isInstrumented && !_reduxActionStore.reduxActionStore.isCaptureSuppressed() && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.errorBanner,

package/lib/commonjs/redux/sync/reduxSyncAdapter.js

@@ -13,8 +13,17 @@ var _autoInstrument = require("../utils/autoInstrument");
  */
 const MAX_ACTION_DETAIL_BYTES = 8 * 1024 * 1024;
 
-/** Per-action budget for `payload`/`action` on the snapshot wire. */
+/** Per-action budget for `payload`/`action`/`meta.arg`/`error` on the snapshot wire. */
 const MAX_WIRE_PAYLOAD_BYTES = 16 * 1024;
+function toWireValue(value) {
+  if (value === undefined) return value;
+  try {
+    JSON.stringify(value);
+  } catch {
+    return _reduxActionStore.PAYLOAD_ON_DEVICE;
+  }
+  return (0, _reduxActionStore.jsonLongerThan)(value, MAX_WIRE_PAYLOAD_BYTES) ? _reduxActionStore.PAYLOAD_ON_DEVICE : value;
+}
 /** Top-level slice names of the state tree, for the compact (no-values) view. */
 function topLevelKeys(state) {
   return state && typeof state === "object" && !Array.isArray(state) ? Object.keys(state) : [];
@@ -72,12 +81,20 @@ const reduxSyncAdapter = exports.reduxSyncAdapter = {
     };
     // A dispatched payload can itself be huge (rehydration actions carry
     // whole state trees). The list view renders payloadPreview anyway —
-    // oversized payload/action values stay on-device behind markers.
-    if ((0, _reduxActionStore.jsonLongerThan)(wire.payload, MAX_WIRE_PAYLOAD_BYTES)) {
-      wire.payload = _reduxActionStore.PAYLOAD_ON_DEVICE;
-    }
-    if ((0, _reduxActionStore.jsonLongerThan)(wire.action, MAX_WIRE_PAYLOAD_BYTES)) {
-      wire.action = _reduxActionStore.PAYLOAD_ON_DEVICE;
+    // oversized / unserializable values stay on-device behind markers.
+    // `meta.arg` is a leftover: RTK copies the thunk argument there, and
+    // capping `action` still left the extracted copy on the wire.
+    wire.payload = toWireValue(wire.payload);
+    wire.action = toWireValue(wire.action);
+    wire.error = toWireValue(wire.error);
+    if (wire.meta) {
+      const arg = toWireValue(wire.meta.arg);
+      if (arg !== wire.meta.arg) {
+        wire.meta = {
+          ...wire.meta,
+          arg
+        };
+      }
     }
     return wire;
   }),
@@ -118,14 +135,31 @@ const reduxSyncAdapter = exports.reduxSyncAdapter = {
         __buoyTruncated: true,
         note: `Exceeds the ${MAX_ACTION_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
       };
-      const cap = value => (0, _reduxActionStore.jsonLongerThan)(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      const cap = value => {
+        try {
+          JSON.stringify(value);
+        } catch {
+          return cappedNote;
+        }
+        return (0, _reduxActionStore.jsonLongerThan)(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      };
+      const capMeta = meta => {
+        if (!meta) return meta;
+        const arg = cap(meta.arg);
+        return arg === meta.arg ? meta : {
+          ...meta,
+          arg
+        };
+      };
       return {
         found: true,
         id,
         prevState: cap(action.prevState),
         nextState: cap(action.nextState),
         payload: cap(action.payload),
-        action: cap(action.action)
+        action: cap(action.action),
+        meta: capMeta(action.meta),
+        error: cap(action.error)
       };
     },
     /**

package/lib/commonjs/redux/utils/reduxActionStore.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.STATE_RETENTION_LIMIT = exports.STATE_ON_DEVICE = exports.STATE_EVICTED = exports.PAYLOAD_ON_DEVICE = void 0;
 exports.isEvictedState = isEvictedState;
+exports.isPayloadOnDevice = isPayloadOnDevice;
 exports.jsonLongerThan = jsonLongerThan;
 exports.reduxActionStore = void 0;
 /**
@@ -52,6 +53,11 @@ const PAYLOAD_ON_DEVICE = exports.PAYLOAD_ON_DEVICE = Object.freeze({
   note: "Payload stays on the device — fetched on demand via getActionDetail."
 });
 
+/** True when a wire-form value is the payload-on-device sentinel. */
+function isPayloadOnDevice(value) {
+  return typeof value === "object" && value !== null && value.__buoyPayloadOnDevice === true;
+}
+
 /**
  * True when a value is one of the state sentinels (evicted or on-device) —
  * guards time travel and any consumer that needs a REAL tree.
@@ -399,11 +405,16 @@ class ReduxActionStore {
     }
     this.actions = actions.slice(0, this.maxActions).map(a => {
       const h = hydrated.get(a.id);
-      return h && isEvictedState(a.prevState) ? {
+      if (!h || !isEvictedState(a.prevState)) return a;
+      return {
         ...a,
         prevState: h.prevState,
-        nextState: h.nextState
-      } : a;
+        nextState: h.nextState,
+        payload: isPayloadOnDevice(a.payload) ? h.payload : a.payload,
+        action: isPayloadOnDevice(a.action) ? h.action : a.action,
+        meta: isPayloadOnDevice(a.meta?.arg) ? h.meta : a.meta,
+        error: isPayloadOnDevice(a.error) ? h.error : a.error
+      };
     });
     this.notifyListeners();
   }

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

@@ -0,0 +1,221 @@
+"use strict";
+
+var _sharedUi = require("@buoy-gg/shared-ui");
+var _dataViewer = require("@buoy-gg/shared-ui/dataViewer");
+var _activeStoreRegistry = require("./activeStoreRegistry");
+var _buoyReduxMiddleware = require("./buoyReduxMiddleware");
+/**
+ * Time Machine snapshot provider for Redux.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine.
+ *
+ * Restore rides the existing `@@buoy/JUMP_TO_STATE` full-state-replace action:
+ * - enhancer path: always handled (wrapReducer).
+ * - middleware path: handled ONLY when the app wrapped its root reducer in
+ *   `withBuoyDevTools()` — unverifiable statically, so restore verifies by
+ *   reference identity after dispatch (the wrapped reducer returns the payload
+ *   object itself).
+ * - patch path: never handled; restore is reported as unavailable up front.
+ */
+
+const ENABLE_HINT = "enable restore by using the Buoy enhancer or wrapping your root reducer in withBuoyDevTools()";
+function status() {
+  const {
+    mechanism,
+    hasStore,
+    diagnostic
+  } = (0, _activeStoreRegistry.getInstrumentationStatus)();
+  if (!hasStore) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: diagnostic === "no-react-redux" ? "react-redux not installed" : diagnostic === "no-provider" ? "No Redux <Provider> found" : "No Redux store instrumented"
+    };
+  }
+  if (mechanism === "patch") {
+    return {
+      canCapture: true,
+      canRestore: false,
+      detail: `Auto-instrumented store cannot be restored — ${ENABLE_HINT}`
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true,
+    detail: mechanism === "middleware" ? "Restore requires withBuoyDevTools(rootReducer) — verified at restore time" : undefined
+  };
+}
+async function capture() {
+  const store = (0, _activeStoreRegistry.getActiveStore)();
+  if (!store) {
+    return {
+      data: null,
+      warnings: ["no Redux store instrumented"]
+    };
+  }
+  return {
+    data: {
+      state: store.getState()
+    },
+    warnings: []
+  };
+}
+async function restore(data, options) {
+  const snapshot = data;
+  const store = (0, _activeStoreRegistry.getActiveStore)();
+  if (!store || snapshot === undefined || snapshot === null) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: store ? "empty redux snapshot" : "no Redux store instrumented"
+      }],
+      warnings: []
+    };
+  }
+  const {
+    mechanism
+  } = (0, _activeStoreRegistry.getInstrumentationStatus)();
+  if (mechanism === "patch") {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: `restore unavailable on auto-instrumented stores — ${ENABLE_HINT}`
+      }],
+      warnings: []
+    };
+  }
+  // Untouched slices keep their LIVE values inside the jump payload, so the
+  // full-state replace leaves them alone. A slice is untouched when it's
+  // explicitly excluded OR outside the includeKeys scope.
+  const excludedSet = new Set(options?.excludeKeys ?? []);
+  const includedSet = options?.includeKeys ? new Set(options.includeKeys) : null;
+  const excluded = Object.keys(snapshot.state ?? {}).filter(k => excludedSet.has(k) || includedSet && !includedSet.has(k));
+  let payload = snapshot.state;
+  if (excluded.length > 0) {
+    const live = store.getState();
+    const merged = {
+      ...snapshot.state
+    };
+    for (const slice of excluded) merged[slice] = live?.[slice];
+    payload = merged;
+  }
+  store.dispatch({
+    type: _buoyReduxMiddleware.BUOY_JUMP_TO_STATE,
+    payload
+  });
+  // The wrapped reducer returns the payload object itself, so reference
+  // identity proves the jump was actually handled (and not silently ignored
+  // by an unwrapped middleware-path reducer).
+  if (store.getState() === payload) {
+    const warnings = excluded.length > 0 ? [`${excluded.length} slice(s) excluded by you`] : [];
+    return {
+      ok: true,
+      applied: 1,
+      skipped: [],
+      warnings
+    };
+  }
+  return {
+    ok: false,
+    applied: 0,
+    skipped: [{
+      id: "redux",
+      reason: `store ignored the state jump — ${ENABLE_HINT}`
+    }],
+    warnings: []
+  };
+}
+const ITEM_RENDER_BYTE_LIMIT = 256 * 1024;
+
+/** Per-slice restore preview. `base` omitted = compare against the live store. */
+async function previewItems(target, base) {
+  const targetState = target?.state;
+  const liveMode = base === undefined;
+  const store = (0, _activeStoreRegistry.getActiveStore)();
+  const baseState = liveMode ? store?.getState() : base?.state;
+  const items = [];
+  const notes = [];
+
+  // Restore-capability gate — a diff restore can't apply must say so, not
+  // render as a green change.
+  let wontApplyReason;
+  if (liveMode) {
+    const {
+      mechanism,
+      hasStore
+    } = (0, _activeStoreRegistry.getInstrumentationStatus)();
+    if (!hasStore) wontApplyReason = "no Redux store instrumented";else if (mechanism === "patch") {
+      wontApplyReason = `auto-instrumented store cannot be restored — ${ENABLE_HINT}`;
+    }
+  }
+  const oldObj = baseState ?? {};
+  const newObj = targetState ?? {};
+  const keys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+  for (const key of keys) {
+    const inOld = Object.prototype.hasOwnProperty.call(oldObj, key);
+    const inNew = Object.prototype.hasOwnProperty.call(newObj, key);
+    let item;
+    if (!inNew) {
+      item = {
+        key,
+        label: key,
+        verdict: "removed",
+        oldValue: oldObj[key]
+      };
+    } else if (!inOld) {
+      item = {
+        key,
+        label: key,
+        verdict: "added",
+        newValue: newObj[key]
+      };
+    } else if ((0, _dataViewer.boundedDeepEqual)(oldObj[key], newObj[key])) {
+      item = {
+        key,
+        label: key,
+        verdict: "unchanged"
+      };
+    } else if ((0, _dataViewer.jsonLikelyLargerThan)(oldObj[key], ITEM_RENDER_BYTE_LIMIT) || (0, _dataViewer.jsonLikelyLargerThan)(newObj[key], ITEM_RENDER_BYTE_LIMIT)) {
+      item = {
+        key,
+        label: key,
+        verdict: "too-large",
+        reason: "slice too large to render a diff — restore still applies it"
+      };
+    } else {
+      item = {
+        key,
+        label: key,
+        verdict: "changed",
+        oldValue: oldObj[key],
+        newValue: newObj[key]
+      };
+    }
+    if (wontApplyReason && item.verdict !== "unchanged") {
+      item = {
+        ...item,
+        verdict: "wont-apply",
+        reason: wontApplyReason
+      };
+    }
+    items.push(item);
+  }
+  if (wontApplyReason) notes.push(`Redux restore unavailable: ${wontApplyReason}`);
+  return {
+    items,
+    notes
+  };
+}
+(0, _sharedUi.registerStateSnapshotProvider)({
+  id: "redux",
+  label: "Redux",
+  status,
+  capture,
+  restore,
+  previewItems
+});

package/lib/module/index.js

@@ -53,6 +53,9 @@
  * ```
  */
 
+// Side-effect: registers the Time Machine snapshot provider
+import "./redux/utils/snapshotProvider";
+
 // SIDE EFFECT (must stay first): claim the Redux DevTools global so stores
 // created after this module loads get the full-capture enhancer. Dev-only,
 // never overrides an existing claimant. See ./redux/utils/devtoolsHook.ts.

package/lib/module/redux/components/ReduxActionDetailContent.js

@@ -78,10 +78,11 @@ export function ReduxActionDetailContent({
   actions,
   selectedIndex,
   onIndexChange,
-  disableInternalFooter = false
+  disableInternalFooter = false,
+  initialView = "action"
 }) {
-  // View state
-  const [activeView, setActiveView] = useState("action");
+  // View state (initialView seeds it once; taps own it afterwards)
+  const [activeView, setActiveView] = useState(initialView);
   const [diffMode, setDiffMode] = useState("tree");
   const totalActions = actions.length;
   const actionColor = getActionColor(action.type);

package/lib/module/redux/components/ReduxModal.js

@@ -43,7 +43,9 @@ export function ReduxModal({
   onMinimize,
   enableSharedModalDimensions = false,
   inline = false,
-  onActionSelect
+  onActionSelect,
+  initialSelectedActionId,
+  initialDetailView
 }) {
   const isPro = useIsPro();
   const [showProModal, setShowProModal] = useState(false);
@@ -99,6 +101,19 @@ export function ReduxModal({
     lastNotifiedSelectionRef.current = id;
     onActionSelect(selectedAction);
   }, [selectedAction, onActionSelect]);
+
+  // Deep link into an action's detail (see initialSelectedActionId). Applied
+  // at most once per id, so the list re-rendering — or the user pressing Back
+  // — never re-opens it.
+  const appliedInitialSelectionRef = useRef(null);
+  useEffect(() => {
+    if (!initialSelectedActionId) return;
+    if (appliedInitialSelectionRef.current === initialSelectedActionId) return;
+    const index = visibleActions.findIndex(a => a.id === initialSelectedActionId);
+    if (index < 0) return;
+    appliedInitialSelectionRef.current = initialSelectedActionId;
+    setSelectedActionIndex(index);
+  }, [initialSelectedActionId, visibleActions]);
   const [searchText, setSearchText] = useState("");
   const [isSearchActive, setIsSearchActive] = useState(false);
   const searchInputRef = useRef(null);
@@ -301,7 +316,8 @@ export function ReduxModal({
       actions: visibleActions,
       selectedIndex: selectedActionIndex,
       onIndexChange: handleIndexChange,
-      disableInternalFooter: true
+      disableInternalFooter: true,
+      initialView: initialDetailView
     }) : /*#__PURE__*/_jsxs(_Fragment, {
       children: [instrumentError && !isInstrumented && !reduxActionStore.isCaptureSuppressed() && /*#__PURE__*/_jsxs(View, {
         style: styles.errorBanner,

package/lib/module/redux/sync/reduxSyncAdapter.js

@@ -10,8 +10,17 @@ import { getActiveStore, getInstrumentationStatus } from "../utils/autoInstrumen
  */
 const MAX_ACTION_DETAIL_BYTES = 8 * 1024 * 1024;
 
-/** Per-action budget for `payload`/`action` on the snapshot wire. */
+/** Per-action budget for `payload`/`action`/`meta.arg`/`error` on the snapshot wire. */
 const MAX_WIRE_PAYLOAD_BYTES = 16 * 1024;
+function toWireValue(value) {
+  if (value === undefined) return value;
+  try {
+    JSON.stringify(value);
+  } catch {
+    return PAYLOAD_ON_DEVICE;
+  }
+  return jsonLongerThan(value, MAX_WIRE_PAYLOAD_BYTES) ? PAYLOAD_ON_DEVICE : value;
+}
 /** Top-level slice names of the state tree, for the compact (no-values) view. */
 function topLevelKeys(state) {
   return state && typeof state === "object" && !Array.isArray(state) ? Object.keys(state) : [];
@@ -69,12 +78,20 @@ export const reduxSyncAdapter = {
     };
     // A dispatched payload can itself be huge (rehydration actions carry
     // whole state trees). The list view renders payloadPreview anyway —
-    // oversized payload/action values stay on-device behind markers.
-    if (jsonLongerThan(wire.payload, MAX_WIRE_PAYLOAD_BYTES)) {
-      wire.payload = PAYLOAD_ON_DEVICE;
-    }
-    if (jsonLongerThan(wire.action, MAX_WIRE_PAYLOAD_BYTES)) {
-      wire.action = PAYLOAD_ON_DEVICE;
+    // oversized / unserializable values stay on-device behind markers.
+    // `meta.arg` is a leftover: RTK copies the thunk argument there, and
+    // capping `action` still left the extracted copy on the wire.
+    wire.payload = toWireValue(wire.payload);
+    wire.action = toWireValue(wire.action);
+    wire.error = toWireValue(wire.error);
+    if (wire.meta) {
+      const arg = toWireValue(wire.meta.arg);
+      if (arg !== wire.meta.arg) {
+        wire.meta = {
+          ...wire.meta,
+          arg
+        };
+      }
     }
     return wire;
   }),
@@ -115,14 +132,31 @@ export const reduxSyncAdapter = {
         __buoyTruncated: true,
         note: `Exceeds the ${MAX_ACTION_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
       };
-      const cap = value => jsonLongerThan(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      const cap = value => {
+        try {
+          JSON.stringify(value);
+        } catch {
+          return cappedNote;
+        }
+        return jsonLongerThan(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      };
+      const capMeta = meta => {
+        if (!meta) return meta;
+        const arg = cap(meta.arg);
+        return arg === meta.arg ? meta : {
+          ...meta,
+          arg
+        };
+      };
       return {
         found: true,
         id,
         prevState: cap(action.prevState),
         nextState: cap(action.nextState),
         payload: cap(action.payload),
-        action: cap(action.action)
+        action: cap(action.action),
+        meta: capMeta(action.meta),
+        error: cap(action.error)
       };
     },
     /**

package/lib/module/redux/utils/reduxActionStore.js

@@ -45,6 +45,11 @@ export const PAYLOAD_ON_DEVICE = Object.freeze({
   note: "Payload stays on the device — fetched on demand via getActionDetail."
 });
 
+/** True when a wire-form value is the payload-on-device sentinel. */
+export function isPayloadOnDevice(value) {
+  return typeof value === "object" && value !== null && value.__buoyPayloadOnDevice === true;
+}
+
 /**
  * True when a value is one of the state sentinels (evicted or on-device) —
  * guards time travel and any consumer that needs a REAL tree.
@@ -392,11 +397,16 @@ class ReduxActionStore {
     }
     this.actions = actions.slice(0, this.maxActions).map(a => {
       const h = hydrated.get(a.id);
-      return h && isEvictedState(a.prevState) ? {
+      if (!h || !isEvictedState(a.prevState)) return a;
+      return {
         ...a,
         prevState: h.prevState,
-        nextState: h.nextState
-      } : a;
+        nextState: h.nextState,
+        payload: isPayloadOnDevice(a.payload) ? h.payload : a.payload,
+        action: isPayloadOnDevice(a.action) ? h.action : a.action,
+        meta: isPayloadOnDevice(a.meta?.arg) ? h.meta : a.meta,
+        error: isPayloadOnDevice(a.error) ? h.error : a.error
+      };
     });
     this.notifyListeners();
   }

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

@@ -0,0 +1,220 @@
+"use strict";
+
+/**
+ * Time Machine snapshot provider for Redux.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine.
+ *
+ * Restore rides the existing `@@buoy/JUMP_TO_STATE` full-state-replace action:
+ * - enhancer path: always handled (wrapReducer).
+ * - middleware path: handled ONLY when the app wrapped its root reducer in
+ *   `withBuoyDevTools()` — unverifiable statically, so restore verifies by
+ *   reference identity after dispatch (the wrapped reducer returns the payload
+ *   object itself).
+ * - patch path: never handled; restore is reported as unavailable up front.
+ */
+import { registerStateSnapshotProvider } from "@buoy-gg/shared-ui";
+import { boundedDeepEqual, jsonLikelyLargerThan } from "@buoy-gg/shared-ui/dataViewer";
+import { getActiveStore, getInstrumentationStatus } from "./activeStoreRegistry";
+import { BUOY_JUMP_TO_STATE } from "./buoyReduxMiddleware";
+const ENABLE_HINT = "enable restore by using the Buoy enhancer or wrapping your root reducer in withBuoyDevTools()";
+function status() {
+  const {
+    mechanism,
+    hasStore,
+    diagnostic
+  } = getInstrumentationStatus();
+  if (!hasStore) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: diagnostic === "no-react-redux" ? "react-redux not installed" : diagnostic === "no-provider" ? "No Redux <Provider> found" : "No Redux store instrumented"
+    };
+  }
+  if (mechanism === "patch") {
+    return {
+      canCapture: true,
+      canRestore: false,
+      detail: `Auto-instrumented store cannot be restored — ${ENABLE_HINT}`
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true,
+    detail: mechanism === "middleware" ? "Restore requires withBuoyDevTools(rootReducer) — verified at restore time" : undefined
+  };
+}
+async function capture() {
+  const store = getActiveStore();
+  if (!store) {
+    return {
+      data: null,
+      warnings: ["no Redux store instrumented"]
+    };
+  }
+  return {
+    data: {
+      state: store.getState()
+    },
+    warnings: []
+  };
+}
+async function restore(data, options) {
+  const snapshot = data;
+  const store = getActiveStore();
+  if (!store || snapshot === undefined || snapshot === null) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: store ? "empty redux snapshot" : "no Redux store instrumented"
+      }],
+      warnings: []
+    };
+  }
+  const {
+    mechanism
+  } = getInstrumentationStatus();
+  if (mechanism === "patch") {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: `restore unavailable on auto-instrumented stores — ${ENABLE_HINT}`
+      }],
+      warnings: []
+    };
+  }
+  // Untouched slices keep their LIVE values inside the jump payload, so the
+  // full-state replace leaves them alone. A slice is untouched when it's
+  // explicitly excluded OR outside the includeKeys scope.
+  const excludedSet = new Set(options?.excludeKeys ?? []);
+  const includedSet = options?.includeKeys ? new Set(options.includeKeys) : null;
+  const excluded = Object.keys(snapshot.state ?? {}).filter(k => excludedSet.has(k) || includedSet && !includedSet.has(k));
+  let payload = snapshot.state;
+  if (excluded.length > 0) {
+    const live = store.getState();
+    const merged = {
+      ...snapshot.state
+    };
+    for (const slice of excluded) merged[slice] = live?.[slice];
+    payload = merged;
+  }
+  store.dispatch({
+    type: BUOY_JUMP_TO_STATE,
+    payload
+  });
+  // The wrapped reducer returns the payload object itself, so reference
+  // identity proves the jump was actually handled (and not silently ignored
+  // by an unwrapped middleware-path reducer).
+  if (store.getState() === payload) {
+    const warnings = excluded.length > 0 ? [`${excluded.length} slice(s) excluded by you`] : [];
+    return {
+      ok: true,
+      applied: 1,
+      skipped: [],
+      warnings
+    };
+  }
+  return {
+    ok: false,
+    applied: 0,
+    skipped: [{
+      id: "redux",
+      reason: `store ignored the state jump — ${ENABLE_HINT}`
+    }],
+    warnings: []
+  };
+}
+const ITEM_RENDER_BYTE_LIMIT = 256 * 1024;
+
+/** Per-slice restore preview. `base` omitted = compare against the live store. */
+async function previewItems(target, base) {
+  const targetState = target?.state;
+  const liveMode = base === undefined;
+  const store = getActiveStore();
+  const baseState = liveMode ? store?.getState() : base?.state;
+  const items = [];
+  const notes = [];
+
+  // Restore-capability gate — a diff restore can't apply must say so, not
+  // render as a green change.
+  let wontApplyReason;
+  if (liveMode) {
+    const {
+      mechanism,
+      hasStore
+    } = getInstrumentationStatus();
+    if (!hasStore) wontApplyReason = "no Redux store instrumented";else if (mechanism === "patch") {
+      wontApplyReason = `auto-instrumented store cannot be restored — ${ENABLE_HINT}`;
+    }
+  }
+  const oldObj = baseState ?? {};
+  const newObj = targetState ?? {};
+  const keys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+  for (const key of keys) {
+    const inOld = Object.prototype.hasOwnProperty.call(oldObj, key);
+    const inNew = Object.prototype.hasOwnProperty.call(newObj, key);
+    let item;
+    if (!inNew) {
+      item = {
+        key,
+        label: key,
+        verdict: "removed",
+        oldValue: oldObj[key]
+      };
+    } else if (!inOld) {
+      item = {
+        key,
+        label: key,
+        verdict: "added",
+        newValue: newObj[key]
+      };
+    } else if (boundedDeepEqual(oldObj[key], newObj[key])) {
+      item = {
+        key,
+        label: key,
+        verdict: "unchanged"
+      };
+    } else if (jsonLikelyLargerThan(oldObj[key], ITEM_RENDER_BYTE_LIMIT) || jsonLikelyLargerThan(newObj[key], ITEM_RENDER_BYTE_LIMIT)) {
+      item = {
+        key,
+        label: key,
+        verdict: "too-large",
+        reason: "slice too large to render a diff — restore still applies it"
+      };
+    } else {
+      item = {
+        key,
+        label: key,
+        verdict: "changed",
+        oldValue: oldObj[key],
+        newValue: newObj[key]
+      };
+    }
+    if (wontApplyReason && item.verdict !== "unchanged") {
+      item = {
+        ...item,
+        verdict: "wont-apply",
+        reason: wontApplyReason
+      };
+    }
+    items.push(item);
+  }
+  if (wontApplyReason) notes.push(`Redux restore unavailable: ${wontApplyReason}`);
+  return {
+    items,
+    notes
+  };
+}
+registerStateSnapshotProvider({
+  id: "redux",
+  label: "Redux",
+  status,
+  capture,
+  restore,
+  previewItems
+});

package/lib/typescript/index.d.ts

@@ -50,6 +50,7 @@
  * });
  * ```
  */
+import "./redux/utils/snapshotProvider";
 import "./redux/utils/devtoolsHook";
 export { reduxToolPreset, createReduxTool } from "./preset";
 export { buoyReduxMiddleware, createBuoyReduxMiddleware, withBuoyDevTools, jumpToState, replayAction, BUOY_JUMP_TO_STATE, BUOY_REPLAY_ACTION, } from "./redux/utils/buoyReduxMiddleware";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAKH,OAAO,4BAA4B,CAAC;AAKpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAO9C,OAAO,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAK7E,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,gCAAgC,CAAC;AAKxC,OAAO,4BAA4B,CAAC;AAKpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAO9C,OAAO,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAK7E,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/lib/typescript/redux/components/ReduxActionDetailContent.d.ts

@@ -7,6 +7,7 @@
  * - DIFF: Compare prev vs next state
  */
 import type { ReduxAction } from "../types";
+import { type ReduxDetailViewMode } from "./ReduxDetailViewToggle";
 interface ReduxActionDetailContentProps {
     /** The selected action to display */
     action: ReduxAction;
@@ -18,8 +19,15 @@ interface ReduxActionDetailContentProps {
     onIndexChange: (index: number) => void;
     /** If true, do not render the internal footer */
     disableInternalFooter?: boolean;
+    /**
+     * Which of the three views the detail opens on (default "action"). Hosts
+     * that deep-link into a specific view — the docs live tour, and any future
+     * "show me the diff for this action" entry point — set it at mount; the
+     * user's own toggle taps take over from there.
+     */
+    initialView?: ReduxDetailViewMode;
 }
-export declare function ReduxActionDetailContent({ action, actions, selectedIndex, onIndexChange, disableInternalFooter, }: ReduxActionDetailContentProps): import("react").JSX.Element;
+export declare function ReduxActionDetailContent({ action, actions, selectedIndex, onIndexChange, disableInternalFooter, initialView, }: ReduxActionDetailContentProps): import("react").JSX.Element;
 /**
  * External footer component for modal use
  */

package/lib/typescript/redux/components/ReduxActionDetailContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReduxActionDetailContent.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxActionDetailContent.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAQ5C,UAAU,6BAA6B;IACrC,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAwDD,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,qBAA6B,GAC9B,EAAE,6BAA6B,+BA0M/B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,GACd,EAAE;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,sCAiBA"}
+{"version":3,"file":"ReduxActionDetailContent.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxActionDetailContent.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAIjC,UAAU,6BAA6B;IACrC,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAwDD,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,qBAA6B,EAC7B,WAAsB,GACvB,EAAE,6BAA6B,+BA0M/B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,GACd,EAAE;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,sCAiBA"}

package/lib/typescript/redux/components/ReduxModal.d.ts

@@ -4,6 +4,7 @@
  * This component auto-instruments the Redux store when it mounts,
  * providing zero-config action capture for the DevTools.
  */
+import type { ReduxDetailViewMode } from "./ReduxDetailViewToggle";
 import type { ReduxAction } from "../types";
 /** Free tier limit for action history */
 export declare const FREE_TIER_ACTION_LIMIT = 25;
@@ -26,8 +27,19 @@ interface ReduxModalProps {
      * on demand — wire-form snapshots carry markers instead of trees.
      */
     onActionSelect?: (action: ReduxAction) => void;
+    /**
+     * Open straight into this action's detail view, by action id. Applied once
+     * the id appears in the visible list (the list can arrive after mount when
+     * actions are mirrored in), then left alone — Back closes the detail and it
+     * stays closed. The counterpart to `onActionSelect`, for hosts that deep-link
+     * INTO an action (the docs live tour; a future MCP/desktop "show me this
+     * action" jump). Null/undefined means "don't touch the selection".
+     */
+    initialSelectedActionId?: string | null;
+    /** Which detail view that deep-link opens on. See ReduxActionDetailContent. */
+    initialDetailView?: ReduxDetailViewMode;
 }
-export declare function ReduxModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, onActionSelect, }: ReduxModalProps): import("react").JSX.Element | null;
+export declare function ReduxModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, onActionSelect, initialSelectedActionId, initialDetailView, }: ReduxModalProps): import("react").JSX.Element | null;
 /**
  * The same Redux tool as `ReduxModal`, rendered INLINE for hosts that place
  * tools in a panel rather than a modal. Exists so there is exactly one

package/lib/typescript/redux/components/ReduxModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReduxModal.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyCH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,UAAU,eAAe;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAgBD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,EACd,cAAc,GACf,EAAE,eAAe,sCAmbjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGpE"}
+{"version":3,"file":"ReduxModal.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyCH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,UAAU,eAAe;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAgBD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,EACd,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,EAAE,eAAe,sCAmcjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGpE"}

package/lib/typescript/redux/sync/reduxSyncAdapter.d.ts

@@ -1,3 +1,4 @@
+import type { ActionMeta } from "../types";
 /**
  * Sync adapter for the redux tool, consumed by @buoy-gg/external-sync's
  * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
@@ -38,7 +39,7 @@ export declare const reduxSyncAdapter: {
         category: import("../types").ActionCategory;
         sliceName: string | null;
         actionName: string;
-        meta?: import("../types").ActionMeta;
+        meta?: ActionMeta;
         error?: unknown;
         payloadPreview: string;
         diffSummary: string;
@@ -62,6 +63,8 @@ export declare const reduxSyncAdapter: {
             nextState?: undefined;
             payload?: undefined;
             action?: undefined;
+            meta?: undefined;
+            error?: undefined;
         } | {
             found: true;
             id: string;
@@ -71,6 +74,8 @@ export declare const reduxSyncAdapter: {
             nextState?: undefined;
             payload?: undefined;
             action?: undefined;
+            meta?: undefined;
+            error?: undefined;
         } | {
             found: true;
             id: string;
@@ -78,6 +83,8 @@ export declare const reduxSyncAdapter: {
             nextState: unknown;
             payload: unknown;
             action: unknown;
+            meta: ActionMeta | undefined;
+            error: unknown;
             reason?: undefined;
             evicted?: undefined;
         };

package/lib/typescript/redux/sync/reduxSyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reduxSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/redux/sync/reduxSyncAdapter.ts"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;IAE3B;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;0BAiBmB,MAAM,IAAI;;;QAK9B;;;;WAIG;kCACuB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8BjC;;;WAGG;2BACgB,OAAO;;oBA7FZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;YAwGxD,wEAAwE;;;;QAM5E,gEAAgE;2BAC7C,OAAO;;oBAhHZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;;;;CAyH/D,CAAC"}
+{"version":3,"file":"reduxSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/redux/sync/reduxSyncAdapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA4D3C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;IAE3B;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;0BAsBmB,MAAM,IAAI;;;QAK9B;;;;WAIG;kCACuB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA6CjC;;;WAGG;2BACgB,OAAO;;oBAjHZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;YA4HxD,wEAAwE;;;;QAM5E,gEAAgE;2BAC7C,OAAO;;oBApIZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;;;;CA6I/D,CAAC"}

package/lib/typescript/redux/utils/reduxActionStore.d.ts

@@ -39,6 +39,8 @@ export declare const PAYLOAD_ON_DEVICE: Readonly<{
     __buoyPayloadOnDevice: true;
     note: "Payload stays on the device — fetched on demand via getActionDetail.";
 }>;
+/** True when a wire-form value is the payload-on-device sentinel. */
+export declare function isPayloadOnDevice(value: unknown): boolean;
 /**
  * True when a value is one of the state sentinels (evicted or on-device) —
  * guards time travel and any consumer that needs a REAL tree.

package/lib/typescript/redux/utils/reduxActionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reduxActionStore.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/reduxActionStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAA8B,MAAM,UAAU,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAwDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA2BrE;AA8HD,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAoD;IACrE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAElC,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAyEP,UAAU,IAAI,WAAW,EAAE;IAI3B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD,YAAY,IAAI,IAAI;IAYpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAWzC;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAuB5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAW5D,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,IAAI,OAAO;IAIrB,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOjE,OAAO,CAAC,eAAe;IAKvB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQhC,QAAQ;;;;;;;IAuBR,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAmBjD,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAMnD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAKpD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAOlD;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWvC;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAkBlD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"reduxActionStore.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/reduxActionStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAA8B,MAAM,UAAU,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAwDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA2BrE;AA8HD,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAoD;IACrE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAElC,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAyEP,UAAU,IAAI,WAAW,EAAE;IAI3B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD,YAAY,IAAI,IAAI;IAYpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAWzC;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IA8B5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAW5D,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,IAAI,OAAO;IAIrB,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOjE,OAAO,CAAC,eAAe;IAKvB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQhC,QAAQ;;;;;;;IAuBR,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAmBjD,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAMnD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAKpD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAOlD;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWvC;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAkBlD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/redux",
-  "version": "7.0.16",
+  "version": "7.0.18",
   "description": "Redux DevTools inside your React Native app — action log, state diffs & time travel with zero store changes. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,12 +26,14 @@
   ],
   "sideEffects": [
     "**/devtoolsHook.js",
-    "**/devtoolsHook.ts"
+    "**/devtoolsHook.ts",
+    "**/snapshotProvider.js",
+    "**/snapshotProvider.ts"
   ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.16",
-    "@buoy-gg/floating-tools-core": "^7.0.16",
-    "@buoy-gg/license": "^7.0.16"
+    "@buoy-gg/shared-ui": "^7.0.18",
+    "@buoy-gg/license": "^7.0.18",
+    "@buoy-gg/floating-tools-core": "^7.0.18"
   },
   "peerDependencies": {
     "@reduxjs/toolkit": ">=1.9.0",