@buoy-gg/redux 7.0.29 → 7.0.31

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

@@ -15,6 +15,7 @@ var _reduxActionStore = require("../utils/reduxActionStore");
 var _useAutoInstrumentRedux = require("../hooks/useAutoInstrumentRedux");
 var _ReduxActionItem = require("./ReduxActionItem");
 var _ReduxActionDetailContent = require("./ReduxActionDetailContent");
+var _testIDs = require("../utils/testIDs");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Main Redux DevTools modal
@@ -29,20 +30,31 @@ var _jsxRuntime = require("react/jsx-runtime");
  * anonymous tier. Kept because it is part of the package's public exports.
  */
 const FREE_TIER_ACTION_LIMIT = exports.FREE_TIER_ACTION_LIMIT = _sharedUi.TIER_LIMITS["redux.actions"].free;
+/**
+ * Why this takes the query as well as the enabled flag: "nothing was captured"
+ * and "nothing matched what you typed" are different problems, and an empty
+ * list under a live search reads as a dead tool. Naming the query back is what
+ * makes the difference legible without clearing the field to find out.
+ */
 function EmptyState({
-  isEnabled
+  isEnabled,
+  query
 }) {
+  const isFiltered = query.length > 0;
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: styles.emptyState,
+    testID: `${_testIDs.REDUX_TEST_ID}-empty`,
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Zap, {
       size: 32,
       color: _sharedUi.night.color.textTertiary
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
       style: styles.emptyTitle,
-      children: "No Redux actions"
+      testID: `${_testIDs.REDUX_TEST_ID}-empty-title`,
+      children: isFiltered ? "No Matches" : "No Redux actions"
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
       style: styles.emptyText,
-      children: isEnabled ? "Actions will appear here as they are dispatched" : "Enable capture to start recording actions"
+      testID: `${_testIDs.REDUX_TEST_ID}-empty-text`,
+      children: isFiltered ? `No action type contains "${query}"` : isEnabled ? "Actions will appear here as they are dispatched" : "Enable capture to start recording actions"
     })]
   });
 }
@@ -85,14 +97,27 @@ function ReduxModal({
   const lockedActionCount = (0, _react.useMemo)(() => Math.max(0, filteredActions.length - actionLimit), [filteredActions.length, actionLimit]);
   const hasLockedActions = lockedActionCount > 0;
 
-  // Selection state - track index for navigation
-  const [selectedActionIndex, setSelectedActionIndex] = (0, _react.useState)(null);
-  const actionsRef = (0, _react.useRef)([]);
-
-  // Keep actions ref in sync (using visible actions for navigation)
-  actionsRef.current = visibleActions;
-
-  // Get selected action from index
+  // Selection state, held as an action ID rather than as a list position.
+  //
+  // This list grows at the HEAD: every dispatch prepends a row and pushes
+  // everything below it down one. An index therefore names a different action
+  // a moment after it is taken — so a detail page opened while the app was
+  // still dispatching silently became a detail page for some OTHER action,
+  // with no transition and nothing to say it had happened. A devtool that
+  // quietly swaps what it is showing you is worse than one that shows nothing.
+  //
+  // The index is still what the stepper and the diff's "previous action" are
+  // expressed in — both are genuinely about position — so it is derived here
+  // and re-derived whenever the list moves.
+  const [selectedActionId, setSelectedActionId] = (0, _react.useState)(null);
+  const selectedActionIndex = (0, _react.useMemo)(() => {
+    if (selectedActionId === null) return null;
+    const index = visibleActions.findIndex(a => a.id === selectedActionId);
+    // Below zero means the action is gone — cleared, or aged out past the tier
+    // cap. Falling back to the list is the honest outcome; the alternative is
+    // showing whatever moved into its place.
+    return index >= 0 ? index : null;
+  }, [selectedActionId, visibleActions]);
   const selectedAction = selectedActionIndex !== null ? visibleActions[selectedActionIndex] : null;
 
   // Notify the host on selection (keyed by action id so re-renders with the
@@ -116,7 +141,7 @@ function ReduxModal({
     const index = visibleActions.findIndex(a => a.id === initialSelectedActionId);
     if (index < 0) return;
     appliedInitialSelectionRef.current = initialSelectedActionId;
-    setSelectedActionIndex(index);
+    setSelectedActionId(initialSelectedActionId);
   }, [initialSelectedActionId, visibleActions]);
   const [searchText, setSearchText] = (0, _react.useState)("");
   const [isSearchActive, setIsSearchActive] = (0, _react.useState)(false);
@@ -132,19 +157,33 @@ function ReduxModal({
       searchText: text
     }));
   };
+
+  /** Drop the query AND put the header back — the ✕ means "stop filtering". */
+  const closeSearch = (0, _react.useCallback)(() => {
+    setSearchText("");
+    setFilter(prev => ({
+      ...prev,
+      searchText: ""
+    }));
+    setIsSearchActive(false);
+  }, [setFilter]);
   const handleActionPress = (0, _react.useCallback)(action => {
-    const index = actionsRef.current.findIndex(a => a.id === action.id);
-    setSelectedActionIndex(index >= 0 ? index : 0);
+    setSelectedActionId(action.id);
   }, []);
   const handleUpgradePress = (0, _react.useCallback)(() => {
     setShowProModal(true);
   }, []);
   const handleBack = (0, _react.useCallback)(() => {
-    setSelectedActionIndex(null);
+    setSelectedActionId(null);
   }, []);
+
+  // The stepper and the async timeline both navigate by POSITION; the
+  // selection is kept by identity, so the position is resolved to an id here,
+  // once, at the moment of the tap.
   const handleIndexChange = (0, _react.useCallback)(newIndex => {
-    setSelectedActionIndex(newIndex);
-  }, []);
+    const next = visibleActions[newIndex];
+    if (next) setSelectedActionId(next.id);
+  }, [visibleActions]);
   const handleCopyAll = async () => {
     if (!isPro) {
       setShowProModal(true);
@@ -166,14 +205,49 @@ function ReduxModal({
 
   // FlatList optimization
   const keyExtractor = (0, _react.useCallback)(item => item.id, []);
+
+  // An action row's handle carries an ordinal among rows of the SAME type, and
+  // an ordinal is a fact about the list rather than about the row — see
+  // ../utils/testIDs.ts for why a type alone cannot address a redux row.
+  const rowTestIDs = (0, _react.useMemo)(() => (0, _testIDs.buildActionRowTestIDs)(visibleActions), [visibleActions]);
+
+  // How many captured actions share each requestId, i.e. how far along each
+  // async operation is.
+  //
+  // Computed HERE rather than in the row, and passed down, because a row's
+  // async badge is a fact about OTHER rows. `pending` is captured and drawn
+  // while it is still alone in the world; `fulfilled` arrives a moment later
+  // and makes the earlier row's badge wrong. `ReduxActionItem` is memoized on
+  // its props and the action object it holds never changes identity, so
+  // nothing about that second arrival reached the first row — the pending half
+  // of every settled thunk permanently showed no flow badge, which is exactly
+  // backwards from what the badge is for.
+  //
+  // One pass over the store instead of a per-row scan: the previous shape was
+  // O(rows x actions) at 200 actions, on a list that re-renders on every
+  // dispatch.
+  const linkedCounts = (0, _react.useMemo)(() => {
+    const counts = new Map();
+    for (const action of _reduxActionStore.reduxActionStore.getActions()) {
+      const requestId = action.meta?.requestId;
+      if (!requestId) continue;
+      counts.set(requestId, (counts.get(requestId) ?? 0) + 1);
+    }
+    return counts;
+    // `filteredActions` takes a new identity whenever the store notifies, which
+    // is the only moment these counts can change.
+  }, [filteredActions]);
   const renderItem = (0, _react.useCallback)(({
     item
   }) => {
+    const requestId = item.meta?.requestId;
     return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ReduxActionItem.ReduxActionItem, {
       action: item,
-      onPress: handleActionPress
+      onPress: handleActionPress,
+      linkedCount: requestId ? linkedCounts.get(requestId) ?? 0 : 0,
+      testID: rowTestIDs.get(item.id)
     });
-  }, [handleActionPress]);
+  }, [handleActionPress, rowTestIDs, linkedCounts]);
   const renderHeaderContent = () => {
     // Detail view header - show action type
     if (selectedAction) {
@@ -182,7 +256,8 @@ function ReduxModal({
           onBack: handleBack
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.ModalHeader.Content, {
           title: selectedAction.type,
-          centered: true
+          centered: true,
+          testID: `${_testIDs.REDUX_TEST_ID}-detail-title`
         })]
       });
     }
@@ -195,27 +270,42 @@ function ReduxModal({
         title: "",
         children: isSearchActive ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
           style: styles.headerSearchContainer,
+          testID: `${_testIDs.REDUX_TEST_ID}-search`,
           children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Search, {
             size: 14,
             color: _sharedUi.night.color.textSecondary
           }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TextInput, {
             ref: searchInputRef,
+            testID: `${_testIDs.REDUX_TEST_ID}-search-field`,
             style: styles.headerSearchInput,
             placeholder: "Search action types...",
             placeholderTextColor: _sharedUi.night.color.textTertiary,
             value: searchText,
             onChangeText: handleSearch,
-            onSubmitEditing: () => setIsSearchActive(false),
-            onBlur: () => setIsSearchActive(false),
+            onSubmitEditing: () => searchInputRef.current?.blur()
+            // Stay open while the query still filters the list.
+            //
+            // Collapsing it on blur hid the reason rows were missing: the
+            // header went back to its chips — which count the WHOLE
+            // capture, not the filtered list — while the list stayed
+            // narrowed, so the tool showed "4 actions" above a single row
+            // and offered nothing to explain the gap. The only way back
+            // was to reopen a field the user had no reason to think was
+            // still armed.
+            ,
+            onBlur: () => {
+              if (searchText.length === 0) setIsSearchActive(false);
+            },
+            accessibilityLabel: "Search action types",
             autoCapitalize: "none",
             autoCorrect: false,
             returnKeyType: "search"
-          }), searchText.length > 0 && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-            onPress: () => {
-              handleSearch("");
-              setIsSearchActive(false);
-            },
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+            onPress: closeSearch,
             style: styles.headerSearchClear,
+            testID: `${_testIDs.REDUX_TEST_ID}-search-clear`,
+            accessibilityRole: "button",
+            accessibilityLabel: "Close search",
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.X, {
               size: 14,
               color: _sharedUi.night.color.textSecondary
@@ -229,6 +319,12 @@ function ReduxModal({
               ...prev,
               onlyWithChanges: false
             })),
+            testID: `${_testIDs.REDUX_TEST_ID}-chip-all`,
+            accessibilityRole: "button",
+            accessibilityLabel: `Show all actions, ${stats.totalActions} captured`,
+            accessibilityState: {
+              selected: !filter.onlyWithChanges
+            },
             children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
               style: styles.headerChipLabel,
               children: "ALL"
@@ -236,6 +332,7 @@ function ReduxModal({
               style: [styles.headerChipValue, {
                 color: _sharedUi.night.color.text
               }],
+              testID: `${_testIDs.REDUX_TEST_ID}-chip-all-value`,
               children: stats.totalActions
             })]
           }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
@@ -244,6 +341,12 @@ function ReduxModal({
               ...prev,
               onlyWithChanges: true
             })),
+            testID: `${_testIDs.REDUX_TEST_ID}-chip-changed`,
+            accessibilityRole: "button",
+            accessibilityLabel: `Show only actions that changed state, ${stats.actionsWithChanges} of them`,
+            accessibilityState: {
+              selected: !!filter.onlyWithChanges
+            },
             children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Zap, {
               size: 12,
               color: _sharedUi.macOSColors.semantic.warning
@@ -251,10 +354,13 @@ function ReduxModal({
               style: [styles.headerChipValue, {
                 color: _sharedUi.macOSColors.semantic.warning
               }],
+              testID: `${_testIDs.REDUX_TEST_ID}-chip-changed-value`,
               children: stats.actionsWithChanges
             })]
           }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
             style: styles.headerChip,
+            testID: `${_testIDs.REDUX_TEST_ID}-chip-types`,
+            accessibilityLabel: `${stats.uniqueActionTypes} distinct action types`,
             children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.CheckCircle, {
               size: 12,
               color: _sharedUi.macOSColors.semantic.success
@@ -262,22 +368,32 @@ function ReduxModal({
               style: [styles.headerChipValue, {
                 color: _sharedUi.macOSColors.semantic.success
               }],
+              testID: `${_testIDs.REDUX_TEST_ID}-chip-types-value`,
               children: stats.uniqueActionTypes
             })]
           })]
         })
       }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_sharedUi.ModalHeader.Actions, {
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+        children: [!isSearchActive && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
           onPress: () => setIsSearchActive(true),
-          style: styles.headerActionButton,
+          style: [styles.headerActionButton, searchText.length > 0 && styles.headerActionButtonActive],
+          testID: `${_testIDs.REDUX_TEST_ID}-search-open`,
+          accessibilityRole: "button",
+          accessibilityLabel: "Search action types",
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Search, {
             size: 14,
-            color: _sharedUi.night.color.textSecondary
+            color: searchText.length > 0 ? _sharedUi.night.color.accent : _sharedUi.night.color.textSecondary
           })
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
           onPress: handleCopyAll,
           style: [styles.headerActionButton, filteredActions.length === 0 && styles.headerActionButtonDisabled],
           disabled: filteredActions.length === 0,
+          testID: `${_testIDs.REDUX_TEST_ID}-copy`,
+          accessibilityRole: "button",
+          accessibilityLabel: "Copy all actions",
+          accessibilityState: {
+            disabled: filteredActions.length === 0
+          },
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Copy, {
             size: 14,
             color: filteredActions.length > 0 ? _sharedUi.night.color.textSecondary : _sharedUi.night.color.textTertiary
@@ -285,11 +401,18 @@ function ReduxModal({
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.PowerToggleButton, {
           isEnabled: isEnabled,
           onToggle: toggleCapture,
-          accessibilityLabel: "Toggle Redux action capture"
+          accessibilityLabel: "Toggle Redux action capture",
+          testID: `${_testIDs.REDUX_TEST_ID}-power`
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
           onPress: clearActions,
           style: [styles.headerActionButton, filteredActions.length === 0 && styles.headerActionButtonDisabled],
           disabled: filteredActions.length === 0,
+          testID: `${_testIDs.REDUX_TEST_ID}-clear`,
+          accessibilityRole: "button",
+          accessibilityLabel: "Clear actions",
+          accessibilityState: {
+            disabled: filteredActions.length === 0
+          },
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Trash2, {
             size: 14,
             color: filteredActions.length > 0 ? _sharedUi.night.color.textTertiary : _sharedUi.night.color.textTertiary
@@ -325,6 +448,7 @@ function ReduxModal({
     }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [instrumentError && !isInstrumented && !_reduxActionStore.reduxActionStore.isCaptureSuppressed() && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.errorBanner,
+        testID: `${_testIDs.REDUX_TEST_ID}-banner-error`,
         children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.AlertTriangle, {
           size: 14,
           color: _sharedUi.night.color.danger
@@ -334,6 +458,7 @@ function ReduxModal({
         })]
       }), !isEnabled && isInstrumented && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.disabledBanner,
+        testID: `${_testIDs.REDUX_TEST_ID}-banner-disabled`,
         children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Power, {
           size: 14,
           color: _sharedUi.night.color.warning
@@ -343,6 +468,7 @@ function ReduxModal({
         })]
       }), captureMechanism === "patch" && !_reduxActionStore.reduxActionStore.isCaptureSuppressed() && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.disabledBanner,
+        testID: `${_testIDs.REDUX_TEST_ID}-banner-patch`,
         children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.AlertTriangle, {
           size: 14,
           color: _sharedUi.night.color.warning
@@ -354,11 +480,15 @@ function ReduxModal({
         style: styles.lockedBanner,
         onPress: handleUpgradePress,
         activeOpacity: 0.8,
+        testID: `${_testIDs.REDUX_TEST_ID}-locked`,
+        accessibilityRole: "button",
+        accessibilityLabel: `${lockedActionCount} older ${lockedActionCount === 1 ? "action" : "actions"} locked. Upgrade to see them.`,
         children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Lock, {
           size: 14,
           color: _sharedUi.night.color.accent
         }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
           style: styles.lockedText,
+          testID: `${_testIDs.REDUX_TEST_ID}-locked-text`,
           children: [lockedActionCount, " older ", lockedActionCount === 1 ? "action" : "actions", " locked"]
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
           style: styles.upgradeBadge,
@@ -369,6 +499,7 @@ function ReduxModal({
         })]
       }), visibleActions.length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.FlatList, {
         ref: flatListRef,
+        testID: `${_testIDs.REDUX_TEST_ID}-list`,
         data: visibleActions,
         renderItem: renderItem,
         keyExtractor: keyExtractor,
@@ -380,7 +511,8 @@ function ReduxModal({
         windowSize: 5,
         updateCellsBatchingPeriod: 50
       }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(EmptyState, {
-        isEnabled: isEnabled
+        isEnabled: isEnabled,
+        query: searchText
       })]
     })
   });
@@ -526,6 +658,10 @@ const styles = _reactNative.StyleSheet.create({
   headerActionButtonDisabled: {
     opacity: 0.55
   },
+  headerActionButtonActive: {
+    backgroundColor: _sharedUi.night.color.accentSoft,
+    borderColor: _sharedUi.night.color.accentBorderStrong
+  },
   startButton: {
     backgroundColor: _sharedUi.macOSColors.semantic.successBackground,
     borderColor: _sharedUi.macOSColors.semantic.success + "40"

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

@@ -7,6 +7,8 @@ exports.ENHANCER_SYMBOL = void 0;
 exports.getActiveStore = getActiveStore;
 exports.getCaptureMechanism = getCaptureMechanism;
 exports.getInstrumentationStatus = getInstrumentationStatus;
+exports.isTimeTravelAvailable = isTimeTravelAvailable;
+exports.markTimeTravelReducer = markTimeTravelReducer;
 exports.registerActiveStore = registerActiveStore;
 exports.setReduxDiagnostic = setReduxDiagnostic;
 exports.unregisterActiveStore = unregisterActiveStore;
@@ -38,6 +40,7 @@ const ENHANCER_SYMBOL = exports.ENHANCER_SYMBOL = Symbol.for("@@buoy/enhancerIns
 let activeStore = null;
 let mechanism = null;
 let diagnostic = null;
+let timeTravelReducer = false;
 function registerActiveStore(store, mech) {
   activeStore = store;
   mechanism = mech;
@@ -56,6 +59,33 @@ function getCaptureMechanism() {
   return mechanism;
 }
 
+/**
+ * Record that a reducer able to serve `BUOY_JUMP_TO_STATE` is in the store.
+ *
+ * Called by the devtools-hook enhancer and by `withBuoyDevTools` — the only
+ * two things that wrap the root reducer. Capture and time travel are separate
+ * capabilities and they are wired separately: a store can be fully captured
+ * through `buoyReduxMiddleware` and still have no way to restore a state,
+ * because middleware sits ABOVE the reducer and cannot replace what it
+ * returns.
+ */
+function markTimeTravelReducer() {
+  timeTravelReducer = true;
+}
+
+/**
+ * Whether pressing JUMP can actually do anything.
+ *
+ * Worth a first-class answer rather than a try-and-see, because the failure is
+ * invisible: `jumpToState` dispatches into a store that simply does not
+ * recognise the action, the reducer returns the state it already had, and the
+ * screen does not move. From the outside that is indistinguishable from a
+ * devtool that is broken.
+ */
+function isTimeTravelAvailable() {
+  return timeTravelReducer && activeStore !== null;
+}
+
 /**
  * Recorded by the auto-instrument hook so non-React surfaces (sync adapter,
  * MCP) can report WHY there's no store instead of a generic failure.
@@ -68,6 +98,7 @@ function getInstrumentationStatus() {
     mechanism,
     capture: mechanism === "enhancer" || mechanism === "middleware" ? "full" : mechanism === "patch" ? "top-level-only" : "none",
     hasStore: activeStore !== null,
+    timeTravel: isTimeTravelAvailable(),
     diagnostic
   };
 }

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

@@ -13,9 +13,25 @@ Object.defineProperty(exports, "getInstrumentationStatus", {
 exports.instrumentStore = instrumentStore;
 exports.isAutoInstrumentActive = isAutoInstrumentActive;
 exports.isStoreInstrumented = isStoreInstrumented;
-exports.jumpToState = jumpToState;
+Object.defineProperty(exports, "isTimeTravelAvailable", {
+  enumerable: true,
+  get: function () {
+    return _buoyReduxMiddleware.isTimeTravelAvailable;
+  }
+});
+Object.defineProperty(exports, "jumpToState", {
+  enumerable: true,
+  get: function () {
+    return _buoyReduxMiddleware.jumpToState;
+  }
+});
 exports.registerReduxStore = registerReduxStore;
-exports.replayAction = replayAction;
+Object.defineProperty(exports, "replayAction", {
+  enumerable: true,
+  get: function () {
+    return _buoyReduxMiddleware.replayAction;
+  }
+});
 exports.uninstrumentStore = uninstrumentStore;
 var _reduxActionStore = require("./reduxActionStore");
 var _buoyReduxMiddleware = require("./buoyReduxMiddleware");
@@ -187,47 +203,14 @@ function registerReduxStore(store, options = {}) {
 // Time-Travel / Introspection
 // ============================================
 
-let warnedJumpUnsupported = false;
-
 /**
- * Jump to a specific state (time-travel).
+ * Time travel lives in buoyReduxMiddleware.ts and is re-exported here.
  *
- * Real on the enhancer path (reducer is wrapped from creation) and on the
- * middleware path when the app used `withBuoyDevTools`. On the bare patch
- * path there's no reducer wrapper, so the jump action is ignored — we detect
- * that and warn once instead of pretending it worked.
+ * It used to be reimplemented in this file, and the two copies drifted: this
+ * one learned to notice that a jump had been ignored, the one the modal's JUMP
+ * button actually calls never did. So the detection existed and no user could
+ * ever have seen it. One implementation, one behaviour.
  */
-function jumpToState(state) {
-  if ((0, _reduxActionStore.isEvictedState)(state)) {
-    console.warn("[BuoyRedux] Cannot jump - this action's state was evicted (raw state is retained for recent actions only)");
-    return;
-  }
-  const store = (0, _activeStoreRegistry.getActiveStore)();
-  if (!store) {
-    console.warn("[BuoyRedux] Cannot jump to state - no store instrumented");
-    return;
-  }
-  store.dispatch({
-    type: _buoyReduxMiddleware.BUOY_JUMP_TO_STATE,
-    payload: state
-  });
-  if (typeof __DEV__ !== "undefined" && __DEV__ && !warnedJumpUnsupported && store.getState() !== state) {
-    warnedJumpUnsupported = true;
-    console.warn("[BuoyRedux] Time-travel jump was ignored by the store. Wrap your root " + "reducer with withBuoyDevTools(), or ensure @buoy-gg/redux is imported " + "before your store is created (enhancer path) for real time travel.");
-  }
-}
-
-/**
- * Replay an action (dispatch it again)
- */
-function replayAction(action) {
-  const store = (0, _activeStoreRegistry.getActiveStore)();
-  if (store) {
-    store.dispatch(action);
-  } else {
-    console.warn("[BuoyRedux] Cannot replay action - no store instrumented");
-  }
-}
 
 /**
  * Get the currently active (instrumented) store.

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

@@ -6,6 +6,12 @@ Object.defineProperty(exports, "__esModule", {
 exports.buoyReduxMiddleware = exports.BUOY_REPLAY_ACTION = exports.BUOY_JUMP_TO_STATE = void 0;
 exports.createBuoyReduxMiddleware = createBuoyReduxMiddleware;
 exports.isMiddlewareActive = isMiddlewareActive;
+Object.defineProperty(exports, "isTimeTravelAvailable", {
+  enumerable: true,
+  get: function () {
+    return _activeStoreRegistry.isTimeTravelAvailable;
+  }
+});
 exports.jumpToState = jumpToState;
 exports.replayAction = replayAction;
 exports.withBuoyDevTools = withBuoyDevTools;
@@ -51,9 +57,18 @@ const BUOY_REPLAY_ACTION = exports.BUOY_REPLAY_ACTION = "@@buoy/REPLAY_ACTION";
 /**
  * Jump to a specific state (time-travel).
  *
- * Registry-backed, so it works on EVERY capture path (enhancer, middleware,
- * patch) — previously this only worked when the middleware was installed,
- * which silently broke the modal's Jump button on the zero-config path.
+ * Registry-backed, so it reaches the store on every capture path — but
+ * REACHING the store is not the same as being able to jump, and conflating the
+ * two is what made this fail invisibly. A jump is an action like any other: it
+ * only does something if a reducer handles it, and the only two things that
+ * install such a reducer are the devtools-hook enhancer and `withBuoyDevTools`.
+ * An app that captures through `buoyReduxMiddleware` alone dispatches the jump
+ * into a store that has never heard of it, gets its own state back, and shows
+ * a screen that does not move — with no error, because nothing went wrong.
+ *
+ * So the capability is checked up front and refused out loud. The UI asks the
+ * same question (`isTimeTravelAvailable`) and disables the button, which is the
+ * half a warning cannot do.
  */
 function jumpToState(state) {
   if ((0, _reduxActionStore.isEvictedState)(state)) {
@@ -61,16 +76,25 @@ function jumpToState(state) {
     return;
   }
   const store = (0, _activeStoreRegistry.getActiveStore)();
-  if (store) {
-    store.dispatch({
-      type: BUOY_JUMP_TO_STATE,
-      payload: state
-    });
-  } else {
+  if (!store) {
     console.warn("[BuoyRedux] Cannot jump to state - no store instrumented");
+    return;
   }
+  if (!(0, _activeStoreRegistry.isTimeTravelAvailable)()) {
+    console.warn("[BuoyRedux] Cannot jump to state - the root reducer cannot serve a " + "state jump. Capture and time travel are wired separately: either put " + "`import '@buoy-gg/redux';` first in your app entry (so Buoy is the " + "store enhancer), or wrap your root reducer with withBuoyDevTools().");
+    return;
+  }
+  store.dispatch({
+    type: BUOY_JUMP_TO_STATE,
+    payload: state
+  });
 }
 
+/**
+ * Whether the JUMP affordance can do anything in this app. Re-exported from
+ * the registry so hosts have one import for the whole time-travel surface.
+ */
+
 /**
  * Replay an action (dispatch it again)
  */
@@ -95,6 +119,9 @@ function replayAction(action) {
  * ```
  */
 function withBuoyDevTools(reducer) {
+  // The other half of the time-travel wiring (see jumpToState): this is one of
+  // exactly two places that can answer BUOY_JUMP_TO_STATE.
+  (0, _activeStoreRegistry.markTimeTravelReducer)();
   return (state, action) => {
     // Handle jump to state action
     if (action.type === BUOY_JUMP_TO_STATE) {

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

@@ -43,6 +43,10 @@ function composeFns(...funcs) {
 
 /** Wrap a reducer so BUOY_JUMP_TO_STATE performs a real state jump. */
 function wrapReducer(reducer) {
+  // Announce the capability, not just perform it: with nothing wrapped, a jump
+  // is dispatched, ignored, and silent — so the UI needs to know in advance
+  // whether the button it is drawing can keep its promise.
+  (0, _activeStoreRegistry.markTimeTravelReducer)();
   return (state, action) => {
     if (action && action.type === _buoyReduxMiddleware.BUOY_JUMP_TO_STATE) {
       return action.payload;