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

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
+});

package/lib/hooks/useStatuses/index.js

@@ -1,31 +1,57 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useStatuses = void 0;
-var _ahooks = require("ahooks");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _useAlternateStatuses = require("../useAlternateStatuses");
+var _useDepsKey = require("../useDepsKey");
 var _react = require("react");
-var _ArgumentTypes = require("../../enums/ArgumentTypes");
 var _Statuses = require("../../enums/Statuses");
-var useStatuses = exports.useStatuses = function useStatuses(context, argumentTypes) {
+// 遵循一个要求：参数不变，`statuses` 的计算结果不能变
+var useStatuses = exports.useStatuses = function useStatuses(fullArguments, context, isEntityRoot) {
+  var statuses = _Statuses.Statuses.None;
+  var _fullArguments = (0, _slicedToArray2["default"])(fullArguments, 4),
+    entity = _fullArguments[0],
+    usecase = _fullArguments[1],
+    deps = _fullArguments[3];
+  var isInitializer = typeof entity === 'function';
   var contextValue = (0, _react.useContext)(context);
-  return (0, _ahooks.useCreation)(function () {
-    var statuses = _Statuses.Statuses.None;
-    var _ref = contextValue || {},
-      store = _ref.store;
-    var hasEntity = (argumentTypes & _ArgumentTypes.ArgumentTypes.Entity) === _ArgumentTypes.ArgumentTypes.Entity;
-    if (hasEntity) {
-      statuses |= _Statuses.Statuses.EntityRootEnabled;
-    }
-    if (contextValue) {
-      statuses |= _Statuses.Statuses.ContextEnabled;
-    } else {
-      statuses |= _Statuses.Statuses.RootEnabled;
-    }
-    if (store) {
-      statuses |= _Statuses.Statuses.EntityEnabled;
-    }
-    return statuses;
-  }, [argumentTypes, contextValue]);
+  var isEntityContext = !isEntityRoot && contextValue !== null;
+  var _ref = isEntityContext ? contextValue : {
+      key: isEntityRoot ? _Statuses.Statuses.RootX : _Statuses.Statuses.RootY
+    },
+    key = _ref.key;
+  var depsKey = (0, _useDepsKey.useDepsKey)(deps);
+  var rootKey = (0, _useDepsKey.useDepsKey)([usecase, key]);
+  var reducersKey = (0, _useDepsKey.useDepsKey)([rootKey, depsKey]);
+  var rootStatuses = (0, _useAlternateStatuses.useAlternateStatuses)(rootKey, _Statuses.Statuses.RootX, _Statuses.Statuses.RootY);
+  var usecaseStatuses = (0, _useAlternateStatuses.useAlternateStatuses)(usecase, _Statuses.Statuses.UseCaseX, _Statuses.Statuses.UseCaseY);
+  var reducersStatuses = (0, _useAlternateStatuses.useAlternateStatuses)(reducersKey, _Statuses.Statuses.ReducersX, _Statuses.Statuses.ReducersY);
+  var depsStatuses = (0, _useAlternateStatuses.useAlternateStatuses)(depsKey, _Statuses.Statuses.DepsX, _Statuses.Statuses.DepsY);
+  var initialEntityStatuses = (0, _useAlternateStatuses.useAlternateStatuses)(isInitializer ? reducersKey : entity, _Statuses.Statuses.InitialEntityX, _Statuses.Statuses.InitialEntityY);
+  switch (true) {
+    case isEntityRoot:
+      // `entity` 参数，只有 `entity root` 模式才有
+      statuses |= initialEntityStatuses;
+      statuses |= _Statuses.Statuses.EntityRootRuntime;
+      break;
+    case isEntityContext:
+      statuses |= _Statuses.Statuses.EntityContextRuntime;
+      break;
+    default:
+      statuses |= _Statuses.Statuses.RootRuntime;
+      break;
+  }
+  // `root` 是肯定有的，要么自身为 `root`，要么上下文有 `root`
+  statuses |= rootStatuses;
+  // `usecase` 作为标识符参数，也是肯定有的
+  statuses |= usecaseStatuses;
+  // `reducers` 作为 `usecase` 的产物，也是肯定有的
+  statuses |= reducersStatuses;
+  // `deps` 虽然是可选参数，但是默认值是空数组 `[]`，所以也是肯定有的
+  statuses |= depsStatuses;
+  return statuses;
 };

package/lib/hooks/useStore/index.js

@@ -1,75 +1,46 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useStore = void 0;
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _useContextualItem = require("../useContextualItem");
-var _useEntityInitializing = require("../useEntityInitializing");
-var _useExec = require("../useExec");
+var _useEntityRootExec = require("../useEntityRootExec");
+var _useRootInitializing = require("../useRootInitializing");
+var _useRootReturn = require("../useRootReturn");
 var _usecases = require("@mic-rexjs/usecases");
-var _ahooks = require("ahooks");
 var _react = require("react");
 var _Statuses = require("../../enums/Statuses");
 var _runEntityInitializer = require("../../methods/runEntityInitializer");
 var useStore = exports.useStore = function useStore(entityArg, context, statuses) {
-  var deps = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : [];
-  var isFunction = typeof entityArg === 'function';
-  var isInitializing = (0, _useEntityInitializing.useEntityInitializing)(statuses);
   var createEntityListRef = (0, _react.useRef)([]);
+  var isInitializing = (0, _useRootInitializing.useRootInitializing)(statuses);
   var contextValue = (0, _react.useContext)(context);
   var _ref = contextValue || {},
     _ref$store = _ref.store,
     contextStore = _ref$store === void 0 ? null : _ref$store;
-  var entityRootEnabled = (statuses & _Statuses.Statuses.EntityRootEnabled) === _Statuses.Statuses.EntityRootEnabled;
-  var _useState = (0, _react.useState)(function () {
-      return new _usecases.EntityStore(void 0);
-    }),
-    _useState2 = (0, _slicedToArray2["default"])(_useState, 1),
-    store = _useState2[0];
-  var prevEntityArg = (0, _ahooks.usePrevious)(entityArg, function () {
-    return true;
+  var initialEntityKey = statuses & _Statuses.Statuses.InitialEntityKey;
+  var rootStore = (0, _useRootReturn.useRootReturn)(statuses, function () {
+    return new _usecases.EntityStore(void 0);
   });
-  /**
-   * 这里只有初始化和 `deps` 变化时，才会执行；
-   * 比如：`useUseCase(entityInitailizer, usecase, options, [key])`，
-   * 当首次调用 `entityInitailizer` 或 `key` 变化，才会触发以下事件
-   */
+  var store = rootStore || contextStore;
   var onRunInitializer = function onRunInitializer() {
+    if (!isInitializing) {
+      return;
+    }
     var createEntityList = createEntityListRef.current;
     createEntityListRef.current = (0, _runEntityInitializer.runEntityInitializer)(store, entityArg, createEntityList, isInitializing);
   };
-  var onSetEntity = function onSetEntity() {
-    if (isInitializing) {
-      store.initValue(entityArg);
+  (0, _useEntityRootExec.useEntityRootExec)(statuses, function () {
+    var isFunction = typeof entityArg === 'function';
+    if (isFunction) {
+      onRunInitializer();
       return;
     }
-    if (entityArg === prevEntityArg) {
+    if (isInitializing) {
+      store.initValue(entityArg);
       return;
     }
-    // 执行同步操作
     store.setValue(entityArg);
-  };
-  /**
-   * 这里仅仅是将非函数的 `entity` 同步；
-   *
-   * 比如 `useUseCase(entity, usecase)`，
-   * 当传入的 `entity` 变化时，执行一下同步操作。
-   */
-  (0, _useExec.useExec)(function () {
-    switch (true) {
-      case !entityRootEnabled:
-      case isFunction:
-        return;
-    }
-    onSetEntity();
-  });
-  return (0, _useContextualItem.useContextualItem)(contextStore, statuses, function () {
-    if (entityRootEnabled && isFunction) {
-      onRunInitializer();
-    }
-    return store;
-  }, deps);
+  }, [initialEntityKey]);
+  return store;
 };

package/lib/hooks/useThrottleUpdate/index.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useThrottleUpdate = void 0;
+var _ahooks = require("ahooks");
+var _react = require("react");
+var useThrottleUpdate = exports.useThrottleUpdate = function useThrottleUpdate() {
+  var update = (0, _ahooks.useUpdate)();
+  var prevUpdateKeyRef = (0, _react.useRef)(-1);
+  var prevUpdateTimeRef = (0, _react.useRef)(0);
+  var triggerUpdate = function triggerUpdate() {
+    prevUpdateTimeRef.current = Date.now();
+    update();
+  };
+  return (0, _ahooks.useMemoizedFn)(function () {
+    var wait = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+    if (wait === 0) {
+      triggerUpdate();
+      return;
+    }
+    var prevUpdateKey = prevUpdateKeyRef.current;
+    var prevUpdateTime = prevUpdateTimeRef.current;
+    var time = Date.now();
+    var delay = wait - (time - prevUpdateTime);
+    clearTimeout(prevUpdateKey);
+    if (delay <= 0) {
+      triggerUpdate();
+      return;
+    }
+    var key = setTimeout(function () {
+      triggerUpdate();
+    }, delay);
+    prevUpdateKeyRef.current = key;
+  });
+};

package/lib/hooks/useThrottleUpdate/types.js

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

package/lib/hooks/useUseCase/index.js

@@ -8,48 +8,45 @@ exports.useUseCase = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _useArgumentTypes = require("../useArgumentTypes");
-var _useConstantFn = require("../useConstantFn");
 var _useContext = require("../useContext");
+var _useContextValue = require("../useContextValue");
 var _useEntity = require("../useEntity");
 var _useFullArguments = require("../useFullArguments");
 var _useIsRenderingRef = require("../useIsRenderingRef");
 var _useProvider = require("../useProvider");
 var _useReducers = require("../useReducers");
+var _useReturn = require("../useReturn");
 var _useStatuses = require("../useStatuses");
 var _useStore = require("../useStore");
-var _ahooks = require("ahooks");
 var _Statuses = require("../../enums/Statuses");
-var _methodUseCase2 = require("../../usecases/methodUseCase");
+var _cacheCalls = require("../../methods/cacheCalls");
 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 useUseCase = exports.useUseCase = function useUseCase() {
-  var isRenderingRef = (0, _useIsRenderingRef.useIsRenderingRef)();
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
     args[_key] = arguments[_key];
   }
-  var argumentTypes = (0, _useArgumentTypes.useArgumentTypes)(args);
-  var fullArguments = (0, _useFullArguments.useFullArguments)(args, argumentTypes);
-  var _fullArguments = (0, _slicedToArray2["default"])(fullArguments, 4),
+  var arg2 = args[1];
+  var isEntityRoot = typeof arg2 === 'function';
+  var fullArguments = (0, _useFullArguments.useFullArguments)(args, isEntityRoot);
+  var _fullArguments = (0, _slicedToArray2["default"])(fullArguments, 3),
     unsafeEntity = _fullArguments[0],
-    unsafeUsecase = _fullArguments[1],
-    options = _fullArguments[2],
-    deps = _fullArguments[3];
-  var usecase = (0, _useConstantFn.useConstantFn)(unsafeUsecase);
-  var context = (0, _useContext.useContext)(usecase, argumentTypes);
-  var entityContext = context;
-  var statuses = (0, _useStatuses.useStatuses)(context, argumentTypes);
-  var store = (0, _useStore.useStore)(unsafeEntity, entityContext, statuses, deps);
-  var reducers = (0, _useReducers.useReducers)(usecase, context, store, statuses, options, deps);
-  var entity = (0, _useEntity.useEntity)(store, statuses, options);
-  var Provider = (0, _useProvider.useProvider)(statuses, context, store, reducers);
-  return (0, _ahooks.useCreation)(function () {
-    if ((statuses & _Statuses.Statuses.EntityEnabled) !== _Statuses.Statuses.EntityEnabled) {
+    usecase = _fullArguments[1],
+    options = _fullArguments[2];
+  var context = (0, _useContext.useContext)(usecase, isEntityRoot);
+  var statuses = (0, _useStatuses.useStatuses)(fullArguments, context, isEntityRoot);
+  var store = (0, _useStore.useStore)(unsafeEntity, context, statuses);
+  var reducers = (0, _useReducers.useReducers)(usecase, store, context, statuses, options);
+  var entity = (0, _useEntity.useEntity)(store, reducers, statuses, options);
+  var contextValue = (0, _useContextValue.useContextValue)(entity, store, reducers, statuses);
+  var Provider = (0, _useProvider.useProvider)(context, contextValue);
+  var isRenderingRef = (0, _useIsRenderingRef.useIsRenderingRef)();
+  return (0, _useReturn.useReturn)(function () {
+    var hasEntity = (statuses & _Statuses.Statuses.Entity) === _Statuses.Statuses.Entity;
+    if (!hasEntity) {
       return reducers;
     }
-    var _methodUseCase = (0, _methodUseCase2.methodUseCase)(),
-      cacheCalls = _methodUseCase.cacheCalls;
-    var cachedReducers = cacheCalls(reducers, {
+    var cachedReducers = (0, _cacheCalls.cacheCalls)(reducers, {
       onShouldCache: function onShouldCache() {
         return isRenderingRef.current;
       }
@@ -61,5 +58,5 @@ var useUseCase = exports.useUseCase = function useUseCase() {
     // 这里是为了让访问器 `getter` 的值保持唯一性，否则每次 `getter` 返回的对象都是新对象，无法用于 `deps`
     var newEntity = isObjectEntity ? _objectSpread({}, entity) : entity;
     return [newEntity, cachedReducers, Provider];
-  }, [statuses, entity, reducers, Provider, isRenderingRef]);
+  }, [entity, reducers, Provider, statuses]);
 };