@mic-rexjs/usecases-react 4.0.0-beta.0 → 4.0.0-beta.3

package/lib/hooks/useEntity/index.js

@@ -1,40 +1,40 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useEntity = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _useConstant = require("../useConstant");
-var _useConstantReducers2 = require("../useConstantReducers");
-var _useEntityInitializing = require("../useEntityInitializing");
-var _useExec = require("../useExec");
-var _usecases = require("@mic-rexjs/usecases");
+var _useEntityReturn = require("../useEntityReturn");
+var _useEntityRootExec = require("../useEntityRootExec");
+var _useThrottleUpdate = require("../useThrottleUpdate");
 var _ahooks = require("ahooks");
 var _react = require("react");
 var _Statuses = require("../../enums/Statuses");
 var _triggerWatchers = require("../../methods/triggerWatchers");
 var _lifecycleEventUseCase = require("../../usecases/lifecycleEventUseCase");
-var useEntity = exports.useEntity = function useEntity(store, statuses, hookOptions) {
+var useEntity = exports.useEntity = function useEntity(store,
+// 强制传入 `reducers` 参数，目的是让该 `hook` 一定在 `useReducers` 之后执行
+reducers, statuses, options) {
   var entity = store.value;
-  var update = (0, _ahooks.useUpdate)();
-  var isInitializing = (0, _useEntityInitializing.useEntityInitializing)(statuses);
-  var hookOptionsRef = (0, _ahooks.useLatest)(hookOptions);
+  var update = (0, _useThrottleUpdate.useThrottleUpdate)();
+  var optionsRef = (0, _ahooks.useLatest)(options);
   var prevEntityRef = (0, _react.useRef)(entity);
-  var entityEnabled = (statuses & _Statuses.Statuses.EntityEnabled) === _Statuses.Statuses.EntityEnabled;
-  var entityRootEnabled = (statuses & _Statuses.Statuses.EntityRootEnabled) === _Statuses.Statuses.EntityRootEnabled;
-  var _useConstantReducers = (0, _useConstantReducers2.useConstantReducers)(function () {
-      return (0, _lifecycleEventUseCase.lifecycleEventUseCase)();
-    }),
-    bindLifecycleEventsKey = _useConstantReducers.bindLifecycleEventsKey,
-    getLifecycleEvents = _useConstantReducers.getLifecycleEvents,
-    deleteLifecycleEvents = _useConstantReducers.deleteLifecycleEvents;
+  var hasEntity = (statuses & _Statuses.Statuses.Entity) === _Statuses.Statuses.Entity;
+  var lifecycleReducers = (0, _useConstant.useConstant)(_lifecycleEventUseCase.lifecycleEventUseCase);
+  var createLifecycleKey = lifecycleReducers.createLifecycleKey,
+    bindLifecycleEventsKey = lifecycleReducers.bindLifecycleEventsKey,
+    getLifecycleEvents = lifecycleReducers.getLifecycleEvents,
+    deleteLifecycleEvents = lifecycleReducers.deleteLifecycleEvents;
   var lifecycleKey = (0, _useConstant.useConstant)(function () {
-    var _utilsUseCase = (0, _usecases.utilsUseCase)(),
-      createKey = _utilsUseCase.createKey;
-    return createKey();
+    return createLifecycleKey();
   });
   var onTriggerWatchers = (0, _ahooks.useMemoizedFn)(function (newEntity, oldEntity) {
-    var watch = hookOptionsRef.current.watch;
+    var watch = optionsRef.current.watch;
     if (!watch) {
       return;
     }
@@ -43,10 +43,10 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, hookOpti
   var onEntityUpdate = (0, _ahooks.useMemoizedFn)(function () {
     var newEntity = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : entity;
     var oldEntity = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : prevEntityRef.current;
-    if (!entityEnabled) {
+    var prevEntity = prevEntityRef.current;
+    if (!hasEntity) {
       return;
     }
-    var prevEntity = prevEntityRef.current;
     if (prevEntity === newEntity) {
       return;
     }
@@ -60,41 +60,69 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, hookOpti
     onAdopt === null || onAdopt === void 0 || onAdopt(newEntity, oldEntity);
     onUpdate === null || onUpdate === void 0 || onUpdate(newEntity, oldEntity);
   });
-  var onEntityChange = (0, _ahooks.useMemoizedFn)(function (newEntity, oldEntity) {
-    var currentHookOptions = hookOptionsRef.current;
-    var onChange1 = currentHookOptions.onChange;
-    var _getLifecycleEvents2 = getLifecycleEvents(lifecycleKey),
-      onChange2 = _getLifecycleEvents2.onChange;
-    onEntityUpdate(newEntity, oldEntity);
-    onChange1 === null || onChange1 === void 0 || onChange1(newEntity, oldEntity);
-    onChange2 === null || onChange2 === void 0 || onChange2(newEntity, oldEntity);
-    if (!entityRootEnabled) {
-      return;
-    }
-    update();
+  var onEntityLifecycleChange = (0, _ahooks.useMemoizedFn)(/*#__PURE__*/function () {
+    var _ref = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(newEntity, oldEntity) {
+      var _getLifecycleEvents2, onChange, result, _t;
+      return _regenerator["default"].wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            _getLifecycleEvents2 = getLifecycleEvents(lifecycleKey), onChange = _getLifecycleEvents2.onChange;
+            result = onChange === null || onChange === void 0 ? void 0 : onChange(newEntity, oldEntity);
+            if (!(result instanceof Promise)) {
+              _context.next = 2;
+              break;
+            }
+            _context.next = 1;
+            return result;
+          case 1:
+            result = _context.sent;
+          case 2:
+            _t = (0, _typeof2["default"])(result);
+            _context.next = _t === 'number' ? 3 : _t === 'undefined' ? 4 : 5;
+            break;
+          case 3:
+            update(result);
+            return _context.abrupt("return");
+          case 4:
+            update();
+            return _context.abrupt("return");
+          case 5:
+            if (!result) {
+              _context.next = 6;
+              break;
+            }
+            return _context.abrupt("return");
+          case 6:
+            update();
+          case 7:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    return function (_x, _x2) {
+      return _ref.apply(this, arguments);
+    };
+  }());
+  var onEntityOptionsChange = (0, _ahooks.useMemoizedFn)(function (newEntity, oldEntity) {
+    var currentOptions = optionsRef.current;
+    var onChange = currentOptions.onChange;
+    onChange === null || onChange === void 0 || onChange(newEntity, oldEntity);
   });
-  (0, _useExec.useExec)(function () {
-    if (!entityRootEnabled) {
-      return;
-    }
+  (0, _useEntityRootExec.useEntityRootExec)(statuses, function () {
     var _bindLifecycleEventsK = bindLifecycleEventsKey(lifecycleKey),
       onBind = _bindLifecycleEventsK.onBind,
       onAdopt = _bindLifecycleEventsK.onAdopt;
-    if (!isInitializing) {
-      return;
-    }
+    store.watch(onEntityLifecycleChange);
     onBind === null || onBind === void 0 || onBind(entity);
     onAdopt === null || onAdopt === void 0 || onAdopt(entity);
-  }, null, []);
-  (0, _ahooks.useUnmount)(function () {
-    if (!entityRootEnabled) {
-      return;
-    }
+  }, function () {
     // 要使用最新的 `entity`
     var currentEntity = store.value;
     var _getLifecycleEvents3 = getLifecycleEvents(lifecycleKey),
       onUnbind = _getLifecycleEvents3.onUnbind,
       onDiscard = _getLifecycleEvents3.onDiscard;
+    store.unwatch(onEntityLifecycleChange);
     deleteLifecycleEvents(lifecycleKey);
     onUnbind === null || onUnbind === void 0 || onUnbind(currentEntity);
     onDiscard === null || onDiscard === void 0 || onDiscard(currentEntity);
@@ -103,20 +131,21 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, hookOpti
    * 需要马上 `watch`，因为 `useEffect` 在子组件内优先执行，
    * 如果使用了 `setEntity` 则无法监控到变化
    */
-  (0, _useExec.useExec)(function () {
-    if (!entityEnabled) {
-      return;
-    }
-    store.watch(onEntityChange);
+  (0, _useEntityReturn.useEntityReturn)(statuses, function () {
+    store.watch(onEntityOptionsChange);
+    store.watch(onEntityUpdate);
   },
   /**
    * 在变化时候，组件更新前，使用 `unwatch`
    */
   function () {
-    store.unwatch(onEntityChange);
-  }, [store, entityEnabled, onEntityChange]);
+    store.unwatch(onEntityOptionsChange);
+    store.unwatch(onEntityUpdate);
+  }, [store]);
   (0, _ahooks.useUpdateEffect)(function () {
     onEntityUpdate();
   }, [entity, onEntityUpdate]);
+  // 强制传入 `reducers` 参数，目的是让该 `hook` 一定在 `useReducers` 之后执行
+  void reducers;
   return entity;
 };

package/lib/hooks/useEntityReturn/index.js

@@ -0,0 +1,22 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEntityReturn = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useIfReturn = require("../useIfReturn");
+var _Statuses = require("../../enums/Statuses");
+/**
+ * 只在 `RootCoreCollectionHook` 或 `ContextualCoreCollectionHook` 模式下才会执行相关回调
+ */
+var useEntityReturn = exports.useEntityReturn = function useEntityReturn(statuses, callback, arg3, arg4) {
+  var isDepsArgs = Array.isArray(arg3);
+  var _ref = isDepsArgs ? [null, arg3] : [arg3, arg4],
+    _ref2 = (0, _slicedToArray2["default"])(_ref, 2),
+    destructor = _ref2[0],
+    deps = _ref2[1];
+  var hasEntity = (statuses & _Statuses.Statuses.Entity) === _Statuses.Statuses.Entity;
+  return (0, _useIfReturn.useIfReturn)(hasEntity, callback, destructor || null, deps);
+};

package/lib/hooks/useEntityRootExec/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEntityRootExec = void 0;
+var _useEntityRootReturn = require("../useEntityRootReturn");
+/**
+ * 只在 `RootCoreCollectionHook` 模式下才会执行相关回调
+ */
+var useEntityRootExec = exports.useEntityRootExec = function useEntityRootExec() {
+  void _useEntityRootReturn.useEntityRootReturn.apply(void 0, arguments);
+};

package/lib/hooks/useEntityRootReturn/index.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEntityRootReturn = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useRootReturn = require("../useRootReturn");
+var _Statuses = require("../../enums/Statuses");
+/**
+ * 只在 `RootCoreCollectionHook` 模式下才会执行相关回调
+ */
+var useEntityRootReturn = exports.useEntityRootReturn = function useEntityRootReturn(statuses, callback, arg3, arg4) {
+  var isDepsArgs = Array.isArray(arg3);
+  var _ref = isDepsArgs ? [null, arg3] : [arg3, arg4],
+    _ref2 = (0, _slicedToArray2["default"])(_ref, 2),
+    destructor = _ref2[0],
+    deps = _ref2[1];
+  return (0, _useRootReturn.useRootReturn)(statuses, callback, destructor || null, _Statuses.Statuses.EntityRootRuntime, deps);
+};

package/lib/hooks/useEntityRootReturn/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/hooks/useExec/index.js

@@ -4,29 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useExec = void 0;
-var _useDepsKey = require("../useDepsKey");
-var _ahooks = require("ahooks");
-var _react = require("react");
-var useExec = exports.useExec = function useExec(callback, destructor) {
-  var deps = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [callback];
-  var depsKey = (0, _useDepsKey.useDepsKey)(deps);
-  var destructorRef = (0, _react.useRef)(null);
-  var onDestruct = function onDestruct() {
-    var _destructorRef$curren;
-    var isUnmount = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
-    (_destructorRef$curren = destructorRef.current) === null || _destructorRef$curren === void 0 || _destructorRef$curren.call(destructorRef, isUnmount);
-  };
-  var onExec = (0, _ahooks.useMemoizedFn)(function () {
-    onDestruct();
-    // `destructor` 一定是在执行回调的时候，同步绑定的，保持两个回调内的闭包变量一致
-    destructorRef.current = destructor || null;
-    return callback();
-  });
-  (0, _ahooks.useUnmount)(function () {
-    onDestruct(true);
-  });
-  return (0, _ahooks.useCreation)(function () {
-    void depsKey;
-    return onExec();
-  }, [depsKey, onExec]);
+var _useReturn = require("../useReturn");
+var useExec = exports.useExec = function useExec() {
+  void _useReturn.useReturn.apply(void 0, arguments);
 };

package/lib/hooks/useFullArguments/index.js

@@ -6,16 +6,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useFullArguments = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _ArgumentTypes = require("../../enums/ArgumentTypes");
-var useFullArguments = exports.useFullArguments = function useFullArguments(args, argumentTypes) {
+var useFullArguments = exports.useFullArguments = function useFullArguments(args, isEntityRoot) {
   var _args = (0, _slicedToArray2["default"])(args, 4),
     arg1 = _args[0],
     arg2 = _args[1],
     arg3 = _args[2],
     arg4 = _args[3];
-  var withoutEntity = (argumentTypes & _ArgumentTypes.ArgumentTypes.Entity) !== _ArgumentTypes.ArgumentTypes.Entity;
-  if (withoutEntity) {
-    return [null, arg1, arg2 || {}, arg3 || []];
+  if (isEntityRoot) {
+    return [arg1, arg2, arg3 || {}, arg4 || []];
   }
-  return [arg1, arg2, arg3 || {}, arg4 || []];
+  return [null, arg1, arg2 || {}, arg3 || []];
 };

package/lib/hooks/useIfExec/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIfExec = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useExec = require("../useExec");
+var useIfExec = exports.useIfExec = function useIfExec(value, callback, arg3, arg4) {
+  var hasDestructor = typeof arg3 === 'function' || arg3 === null;
+  var _ref = hasDestructor ? [arg3, arg4] : [null, arg3],
+    _ref2 = (0, _slicedToArray2["default"])(_ref, 2),
+    destructor = _ref2[0],
+    deps = _ref2[1];
+  return (0, _useExec.useExec)(function () {
+    if (!value) {
+      return;
+    }
+    callback();
+  }, function (isUnmount) {
+    if (!value) {
+      return;
+    }
+    destructor === null || destructor === void 0 || destructor(isUnmount);
+  }, deps);
+};

package/lib/hooks/useIfExec/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/hooks/useIfReturn/index.js

@@ -0,0 +1,29 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIfReturn = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useReturn = require("../useReturn");
+var useIfReturn = exports.useIfReturn = function useIfReturn(value, callback, arg3,
+// 默认：如果 `callback` 没有用 `useMemorizedFn`，就会每次都执行，否则只执行一次
+arg4) {
+  var isDepsArg3 = Array.isArray(arg3);
+  var _ref = isDepsArg3 ? [null, arg3] : [arg3, arg4],
+    _ref2 = (0, _slicedToArray2["default"])(_ref, 2),
+    destructor = _ref2[0],
+    deps = _ref2[1];
+  return (0, _useReturn.useReturn)(function () {
+    if (!value) {
+      return null;
+    }
+    return callback();
+  }, function (isUnmount) {
+    if (!value) {
+      return;
+    }
+    destructor === null || destructor === void 0 || destructor(isUnmount);
+  }, deps);
+};

package/lib/hooks/useIfReturn/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/hooks/useProvider/index.js

@@ -5,22 +5,24 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useProvider = void 0;
-var _useConstantFn = require("../useConstantFn");
+var _useConstant = require("../useConstant");
 var _ahooks = require("ahooks");
 var _react = _interopRequireDefault(require("react"));
 var useProvider = exports.useProvider = function useProvider(context, contextValue) {
   var contextValueRef = (0, _ahooks.useLatest)(contextValue);
-  return (0, _useConstantFn.useConstantFn)(function (_ref) {
-    var children = _ref.children,
-      _ref$with = _ref["with"],
-      withProviders = _ref$with === void 0 ? [] : _ref$with;
-    var ContextProvider = context.Provider;
-    var value = contextValueRef.current;
-    var providers = Array.isArray(withProviders) ? withProviders : [withProviders];
-    return _react["default"].createElement(ContextProvider, {
-      value: value
-    }, providers.reduceRight(function (currentChildren, withProvider) {
-      return _react["default"].createElement(withProvider, {}, currentChildren);
-    }, children));
+  return (0, _useConstant.useConstant)(function () {
+    return function (_ref) {
+      var children = _ref.children,
+        _ref$with = _ref["with"],
+        withProviders = _ref$with === void 0 ? [] : _ref$with;
+      var ContextProvider = context.Provider;
+      var value = contextValueRef.current;
+      var providers = Array.isArray(withProviders) ? withProviders : [withProviders];
+      return _react["default"].createElement(ContextProvider, {
+        value: value
+      }, providers.reduceRight(function (currentChildren, withProvider) {
+        return _react["default"].createElement(withProvider, {}, currentChildren);
+      }, children));
+    };
   });
 };

package/lib/hooks/useProviders/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useProviders = void 0;
 var _useDepsKey = require("../useDepsKey");
+var _useReturn = require("../useReturn");
 var _ahooks = require("ahooks");
 var useProviders = exports.useProviders = function useProviders() {
   for (var _len = arguments.length, providers = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -12,8 +13,7 @@ var useProviders = exports.useProviders = function useProviders() {
   }
   var depsKey = (0, _useDepsKey.useDepsKey)(providers);
   var providersRef = (0, _ahooks.useLatest)(providers);
-  return (0, _ahooks.useCreation)(function () {
-    void depsKey;
+  return (0, _useReturn.useReturn)(function () {
     return providersRef.current;
-  }, [depsKey, providersRef]);
+  }, [depsKey]);
 };

package/lib/hooks/useReducers/index.js

@@ -1,30 +1,70 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useReducers = void 0;
-var _useContextualItem = require("../useContextualItem");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _useReturn = require("../useReturn");
 var _usecases = require("@mic-rexjs/usecases");
+var _ahooks = require("ahooks");
 var _react = require("react");
 var _Statuses = require("../../enums/Statuses");
-var useReducers = exports.useReducers = function useReducers(usecase, store, context, statuses, usecaseOptions) {
-  var deps = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : [];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var _excluded = ["watch", "onChange"];
+var useReducers = exports.useReducers = function useReducers(usecase, store, context, statuses, options) {
   var contextValue = (0, _react.useContext)(context);
   var _ref = contextValue || {},
     _ref$reducers = _ref.reducers,
     contextReducers = _ref$reducers === void 0 ? null : _ref$reducers;
-  var entityEnabled = (statuses & _Statuses.Statuses.EntityEnabled) === _Statuses.Statuses.EntityEnabled;
-  var onCreate = function onCreate() {
-    if (!entityEnabled) {
-      return usecase(usecaseOptions);
+  var watch = options.watch,
+    onChange = options.onChange,
+    restOptions = (0, _objectWithoutProperties2["default"])(options, _excluded);
+  var _options$options = options.options,
+    initailOptions = _options$options === void 0 ? restOptions : _options$options;
+  var initailOptionsRef = (0, _ahooks.useLatest)(initailOptions);
+  var reducersKey = statuses & _Statuses.Statuses.ReducersKey;
+  var onOption = function onOption(key) {
+    return function () {
+      var currentInitailOptions = initailOptionsRef.current;
+      var currentValue = currentInitailOptions[key];
+      if (typeof currentValue !== 'function') {
+        return;
+      }
+      return currentValue.apply(void 0, arguments);
+    };
+  };
+  var onOptions = function onOptions() {
+    var newOptions = _objectSpread({}, initailOptions);
+    for (var _i = 0, _Object$keys = Object.keys(newOptions); _i < _Object$keys.length; _i++) {
+      var key = _Object$keys[_i];
+      var optionKey = key;
+      var value = newOptions[optionKey];
+      if (typeof value !== 'function') {
+        continue;
+      }
+      newOptions[optionKey] = onOption(optionKey);
     }
+    return newOptions;
+  };
+  return (0, _useReturn.useReturn)(function () {
+    var hasEntity = (statuses & _Statuses.Statuses.Entity) === _Statuses.Statuses.Entity;
+    var isEntityRootRuntime = (statuses & _Statuses.Statuses.EntityRootRuntime) === _Statuses.Statuses.EntityRootRuntime;
+    if (!hasEntity) {
+      return usecase(options);
+    }
+    if (!isEntityRootRuntime) {
+      return contextReducers;
+    }
+    var newOptions = onOptions();
     return (0, _usecases.createEntityReducers)(store, usecase, {
-      options: usecaseOptions,
+      options: newOptions,
       onGenerate: function onGenerate(newEntity, result) {
         return result;
       }
     });
-  };
-  return (0, _useContextualItem.useContextualItem)(contextReducers, statuses, onCreate, deps);
+  }, [reducersKey]);
 };

package/lib/hooks/useReturn/index.js

@@ -0,0 +1,40 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useReturn = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useDepsKey = require("../useDepsKey");
+var _ahooks = require("ahooks");
+var _react = require("react");
+var useReturn = exports.useReturn = function useReturn(callback) {
+  var arg2 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [callback];
+  var arg3 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [callback];
+  var hasDestructor = !Array.isArray(arg2);
+  var _ref = hasDestructor ? [arg2, arg3] : [null, arg2],
+    _ref2 = (0, _slicedToArray2["default"])(_ref, 2),
+    destructor = _ref2[0],
+    deps = _ref2[1];
+  var depsKey = (0, _useDepsKey.useDepsKey)(deps);
+  var destructorRef = (0, _react.useRef)(null);
+  var onDestruct = function onDestruct() {
+    var _destructorRef$curren;
+    var isUnmount = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+    (_destructorRef$curren = destructorRef.current) === null || _destructorRef$curren === void 0 || _destructorRef$curren.call(destructorRef, isUnmount);
+  };
+  var onCreate = (0, _ahooks.useMemoizedFn)(function () {
+    onDestruct();
+    // `destructor` 一定是在执行回调的时候，同步绑定的，保持两个回调内的闭包变量一致
+    destructorRef.current = destructor;
+    return callback();
+  });
+  (0, _ahooks.useUnmount)(function () {
+    onDestruct(true);
+  });
+  return (0, _ahooks.useCreation)(function () {
+    void depsKey;
+    return onCreate();
+  }, [depsKey, onCreate]);
+};

package/lib/hooks/useReturn/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/hooks/useRootInitializing/index.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRootInitializing = void 0;
+var _useReturn = require("../useReturn");
+var _react = require("react");
+var _Statuses = require("../../enums/Statuses");
+var useRootInitializing = exports.useRootInitializing = function useRootInitializing(statuses) {
+  var rootKey = statuses & _Statuses.Statuses.RootKey;
+  var isInitializingRef = (0, _react.useRef)(true);
+  return (0, _useReturn.useReturn)(function () {
+    var isInitializing = isInitializingRef.current;
+    isInitializingRef.current = false;
+    return isInitializing;
+  }, function () {
+    isInitializingRef.current = true;
+  }, [rootKey]);
+};

package/lib/hooks/useRootReturn/index.js

@@ -0,0 +1,30 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRootReturn = void 0;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _useIfReturn = require("../useIfReturn");
+var _Statuses = require("../../enums/Statuses");
+/**
+ * 只有 `ReducersHook` 或 `RootCoreCollectionHook` 模式下才执行相关回调
+ */
+var useRootReturn = exports.useRootReturn = function useRootReturn(statuses, callback, arg3, arg4, arg5) {
+  var isDepsArg3 = Array.isArray(arg3);
+  var isDepsArg4 = Array.isArray(arg4);
+  var isStatusesArg3 = typeof arg3 === 'number';
+  var isStatusesArg4 = typeof arg4 === 'number';
+  var destructor = !isDepsArg3 && !isStatusesArg3 ? arg3 : null;
+  var rootStatuses = isStatusesArg3 ? arg3 : isStatusesArg4 ? arg4 : _Statuses.Statuses.RootRuntime;
+  var deps = isDepsArg3 ? arg3 : isDepsArg4 ? arg4 : arg5 || [];
+  var rootKey = statuses & _Statuses.Statuses.RootKey;
+  var rootCalled = (statuses & rootStatuses) === rootStatuses;
+  var isEntityRootRuntime = (statuses & _Statuses.Statuses.EntityRootRuntime) === _Statuses.Statuses.EntityRootRuntime;
+  return (0, _useIfReturn.useIfReturn)(rootCalled, function () {
+    return callback(isEntityRootRuntime);
+  }, function () {
+    destructor === null || destructor === void 0 || destructor(isEntityRootRuntime);
+  }, [rootKey].concat((0, _toConsumableArray2["default"])(deps)));
+};

package/lib/hooks/useRootReturn/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});