@mic-rexjs/usecases-react 3.6.3 → 3.7.0

package/dist/index.min.js

@@ -1,2 +1,2 @@
 /*! For license information please see index.min.js.LICENSE.txt */
-(()=>{var e={698(e,t){"use strict";var n=Symbol.for("react.transitional.element");Symbol.for("react.fragment"),t.jsx=function(e,t,r){var o=null;if(void 0!==r&&(o=""+r),void 0!==t.key&&(o=""+t.key),"key"in t)for(var u in r={},t)"key"!==u&&(r[u]=t[u]);else r=t;return t=r.ref,{$$typeof:n,type:e,key:o,ref:void 0!==t?t:null,props:r}}},848(e,t,n){"use strict";e.exports=n(698)}},t={};function n(r){var o=t[r];if(void 0!==o)return o.exports;var u=t[r]={exports:{}};return e[r](u,u.exports,n),u.exports}n.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return n.d(t,{a:t}),t},n.d=(e,t)=>{for(var r in t)n.o(t,r)&&!n.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var r={};(()=>{"use strict";function e(t){return e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},e(t)}function t(t,n,r){return(n=function(t){var n=function(t){if("object"!=e(t)||!t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var r=n.call(t,"string");if("object"!=e(r))return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(t)}(t);return"symbol"==e(n)?n:n+""}(n))in t?Object.defineProperty(t,n,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[n]=r,t}function o(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(-1!==t.indexOf(r))continue;n[r]=e[r]}return n}(e,t);if(Object.getOwnPropertySymbols){var u=Object.getOwnPropertySymbols(e);for(r=0;r<u.length;r++)n=u[r],-1===t.indexOf(n)&&{}.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}n.r(r),n.d(r,{UseCaseFragment:()=>N,lifecycleUseCase:()=>q,useProviders:()=>$,useUseCase:()=>L});var u=n(848);function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=Array(t);n<t;n++)r[n]=e[n];return r}function a(e,t){if(e){if("string"==typeof e)return i(e,t);var n={}.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(e,t):void 0}}function c(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,u,i,a=[],c=!0,f=!1;try{if(u=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;c=!1}else for(;!(c=(r=u.call(n)).done)&&(a.push(r.value),a.length!==t);c=!0);}catch(e){f=!0,o=e}finally{try{if(!c&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(f)throw o}}return a}}(e,t)||a(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}const f=React;var l,s=n.n(f),y=function(e){return c((0,f.useState)(e),1)[0]};!function(e){e[e.None=0]="None",e[e.Entity=2]="Entity"}(l||(l={}));var v=function(e){return c((0,f.useState)(function(){return e}),1)[0]};const b=ahooks,d=usecases;var p;!function(e){e[e.None=0]="None",e[e.RootEnabled=2]="RootEnabled",e[e.ContextEnabled=4]="ContextEnabled",e[e.EntityEnabled=8]="EntityEnabled",e[e.ContextRootEnabled=6]="ContextRootEnabled",e[e.EntityRootEnabled=14]="EntityRootEnabled"}(p||(p={}));var O=(0,d.createUseCase)(function(){var e=new Map,t=(0,f.createContext)(null);return function(){return{createContextValue:function(e,t,n){return(n&p.EntityEnabled)===p.EntityEnabled?{store:e,reducers:t,statuses:n}:{reducers:t,statuses:n}},getUseCaseContext:function(n){return e.has(n)?e.get(n).value:t},registerUseCase:function(n,r){if(e.has(n)){var o=e.get(n),u=o.value,i=o.times;return e.set(n,{value:u,times:i+1}),u}if((r&l.Entity)!==l.Entity)return t;var a=(0,f.createContext)(null);return e.set(n,{value:a,times:1}),a},unregisterUseCase:function(t,n){if((n&l.Entity)!==l.Entity)return!1;if(!e.has(t))return!1;var r=e.get(t),o=r.value,u=r.times;return 1===u?e.delete(t):e.set(t,{value:o,times:u-1}),!0}}}}),E=function(e,t){return y(function(){return e(t)})};function h(e){return function(e){if(Array.isArray(e))return i(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||a(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}var g=function(){var t=function(t){return"object"===e(t)&&null!==t},n=function(e,n){return!!t(e)&&Object.hasOwn(e,n)};return{hasField:n,isObject:t,isEqual:function(e,r,o){if(e===r)return!0;var u=t(e),i=t(r),a=u?Object.keys(e):[],c=i?Object.keys(r):[],f="function"==typeof o;if(!u&&!i)return!1;for(var l=!0,s=a.length,y=[].concat(h(a),h(c)),v=0,b=y.length;v<b;v++){var d=y[v],p=a.includes(d);if(!(v>=s&&p)){var O=n(e,d),E=n(r,d),g=O?e[d]:void 0,j=E?r[d]:void 0;if(!O||!E||g!==j){if(l=!1,!f)break;o(d,j,g)}}}return l},matchProperty:function(e,t,r,o){var u=!0,i=r,a=[{fieldPaths:[],newEntity:t,newValue:t,oldEntity:e,oldValue:e}];do{var f=a.shift(),l=f.oldValue,s=f.newValue,y=f.fieldPaths,v=c(i.match(/^([^.]+)\.(.+)$/)||[],3),b=v[1],d=void 0===b?i:b,p=v[2],O=void 0===p?"":p,E=n(l,d),g=n(s,d);if(E||g){var j=c(E?[l[d]]:[],1)[0],m=c(g?[s[d]]:[],1)[0],w={fieldPaths:[].concat(h(y),[d]),newEntity:t,newValue:m,oldEntity:e,oldValue:j};if(O){i=O,a.push(w);continue}if(m===j)continue;u=!1,null==o||o(w)}else if(!/^\d+^/.test(d))for(var P=Array.isArray(l)?l:[],C=Array.isArray(s)?s:[],S=P.length,x=C.length,R=Math.max(S,x),U=0;U<R;U++)a.push({fieldPaths:[].concat(h(y),["".concat(U)]),newEntity:t,newValue:C[U],oldEntity:e,oldValue:P[U]})}while(a.length>0);return u}}},j=function(e){var t=(0,f.useRef)(0),n=(0,b.usePrevious)(e),r=(0,E(g).isEqual)(e,n);return(0,b.useMemoizedFn)(function(){var e=t.current;if(r)return e;var n=e+1;return t.current=n,n})()},m=function(e){var t=j(arguments.length>1&&void 0!==arguments[1]?arguments[1]:[e]),n=(0,b.useMemoizedFn)(function(){return e()});return(0,b.useCreation)(function(){return n()},[t,n])},w=function(e){var t=(0,f.useRef)(!0),n=(e&p.EntityRootEnabled)===p.EntityRootEnabled;return m(function(){if(!n)return t.current=!0,!1;var e=t.current;return t.current=!1,e})},P=(0,d.createUseCase)(function(){var e=new Map,t=null;return function(){return{deleteLifecycleEvents:function(t){return e.delete(t)},setLifecycleEvents:function(e){t=e},getLifecycleEvents:function(t){return e.get(t)||{}},bindLifecycleEventsKey:function(n){if(null===t)return{};var r=t;return t=null,e.set(n,r),r}}}}),C=function(){var e=g().isEqual,t=function(t,n){var r,o=n||{},u=o.onShouldCache,i=void 0===u?function(){return!0}:u,a=o.onCompare,c=void 0===a?function(t,n){return e(t,n)}:a;return function(){for(var e=i(),n=arguments.length,o=new Array(n),u=0;u<n;u++)o[u]=arguments[u];if(r&&e){var a=r,f=a.parameters,l=a.returnValue;if(c(f,o))return l}var s=t.apply(void 0,o);return e&&(r={parameters:o,returnValue:s}),s}};return{cacheCall:t,cacheCalls:function(e,n){var r={};return Object.entries(e).forEach(function(e){var o=c(e,2),u=o[0],i=o[1];r[u]=t(i,n)}),r},captureCalls:function(e,t){var n={};return Object.keys(e).forEach(function(r){var o=e[r];n[r]="function"!=typeof o?o:function(){for(var e=arguments.length,n=new Array(e),o=0;o<e;o++)n[o]=arguments[o];return t(r,n)}}),n}}},S=function(e,t,n){var r=j(arguments.length>3&&void 0!==arguments[3]?arguments[3]:[]),o=(0,b.useLatest)(n),u=(0,b.useMemoizedFn)(function(){return(0,C().cacheCall)(o.current,{onCompare:function(){return!0}})}),i=(0,b.useCreation)(function(){return u()},[r,u]);return(0,b.useCreation)(function(){return(t&p.RootEnabled)!==p.RootEnabled&&e?e:i()},[t,e,i])};function x(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function R(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?x(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):x(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var U=["watch","onChange","options"];function A(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function D(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?A(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):A(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var M=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},t=(0,d.entityUseCase)(),n=e.onInit;return D(D({},t),{},{initEntity:function(e){return"function"!=typeof n?e:n(e)}})},V=function(e,t,n){var r=arguments.length>3&&void 0!==arguments[3]?arguments[3]:[],o="function"==typeof e,u=w(n),i=(0,f.useRef)([]),a=((0,f.useContext)(t)||{}).store,l=void 0===a?null:a,s=(n&p.EntityRootEnabled)===p.EntityRootEnabled,y=c((0,f.useState)(function(){return new d.EntityStore(void 0)}),1)[0],v=(0,b.usePrevious)(e,function(){return!0});return m(function(){switch(!0){case!s:case o:return}u?y.initValue(e):e!==v&&y.setValue(e)}),S(l,n,function(){return s&&o&&(t=i.current,i.current=function(e,t,n,r){var o=!1,u=0,i=[],a=g(),c=a.isObject,f=a.isEqual,l=function(t){return!r||o?t:e.initValue(t)},s=(0,d.createEntityReducers)(e,M,{onInit:function(e){return t(e)},onCreate:function(e,t){var r=u,o=c(t),a=o&&Array.isArray(t);if(u++,i[r]=e,!o||a)return(0,d.createEntity)(t,e);var l={},s=n[r];return f(s,e,function(t){var n=Object.getOwnPropertyDescriptor(e,t)||null;null!==n&&(l[t]=n)}),(0,d.createEntity)(t,Object.defineProperties({},l))},onGenerate:function(t,n){if(void 0===n)return[t,n];var r=(0,d.createEntity)(t,n);return e.setValue(r),[r,n]},onYield:function(e){return l(e)},onReturn:function(t){var n=l(t);return e.setValue(n),n}}).initEntity;return e.disableWatchers(),s(),e.enableWatchers(),o=!0,i}(y,e,t,u)),y;var t},r)};function k(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}var L=function(){for(var n,r=(n=(0,b.useLatest)(!0),(0,f.useEffect)(function(){n.current=!1}),n),u=arguments.length,i=new Array(u),a=0;a<u;a++)i[a]=arguments[a];var j=function(t){return y(function(){return"function"===e(c(t,2)[1])?l.Entity:l.None})}(i),x=function(e,t){var n=c(e,4),r=n[0],o=n[1],u=n[2],i=n[3];return(t&l.Entity)!==l.Entity?[null,r,o||{},u||[]]:[r,o,u||{},i||[]]}(i,j),A=c(x,4),D=A[0],M=A[1],L=A[2],F=A[3],I=v(M),_=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:l.None,n=y(function(){return(0,O().registerUseCase)(e,t)});return(0,b.useUnmount)(function(){(0,O().unregisterUseCase)(e,t)}),n}(I,j),z=_,N=function(e,t){var n=(0,f.useContext)(e);return(0,b.useCreation)(function(){var e=p.None,r=(n||{}).store;return(t&l.Entity)===l.Entity&&(e|=p.EntityRootEnabled),e|=n?p.ContextEnabled:p.RootEnabled,r&&(e|=p.EntityEnabled),e},[t,n])}(_,j),T=V(D,z,N,F),q=function(e,t,n,r,u){var i=arguments.length>5&&void 0!==arguments[5]?arguments[5]:[],a=(0,b.useLatest)(u),c=((0,f.useContext)(t)||{}).reducers,l=void 0===c?null:c,s=(r&p.EntityRootEnabled)===p.EntityRootEnabled;return S(l,r,function(){return function(){var t=(0,C().captureCalls)(u,function(e,t){var n,r,o;return null===(r=(o=a.current)[e])||void 0===r?void 0:(n=r).call.apply(n,[o].concat(h(t)))});if(!s)return e(t);var r=t,i=(r.watch,r.onChange,r.options),c=o(r,U);return(0,d.createEntityReducers)(n,e,R(R(R({},c),i),{},{onGenerate:function(e,t){return t}}))}()},i)}(I,_,T,N,L,F),$=function(e,t,n){var r=e.value,o=(0,b.useUpdate)(),u=w(t),i=(0,b.useLatest)(n),a=(0,f.useRef)(r),l=(t&p.EntityEnabled)===p.EntityEnabled,s=(t&p.EntityRootEnabled)===p.EntityRootEnabled,v=E(function(){return P()}),O=v.bindLifecycleEventsKey,h=v.getLifecycleEvents,j=v.deleteLifecycleEvents,C=y(function(){return(0,(0,d.utilsUseCase)().createKey)()}),S=(0,b.useMemoizedFn)(function(e,t){var n=i.current.watch;n&&function(e,t,n){for(var r,o=g().matchProperty,u=function(){var e=a[i],u=(r=c(e,2))[0],f=r[1];o(n,t,u,function(e){f(e)})},i=0,a=Object.entries(e);i<a.length;i++)u()}(n,e,t)}),x=(0,b.useMemoizedFn)(function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:r,t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:a.current;if(l&&a.current!==e){var n=h(C).onUpdate;a.current=e,S(e,t),null==n||n(e,t)}}),R=(0,b.useMemoizedFn)(function(e,t){var n=i.current.onChange,r=h(C).onChange;x(e,t),null==n||n(e,t),null==r||r(e,t),s&&o()});return m(function(){if(s){var e=O(C).onBind;u&&(null==e||e(r))}}),(0,b.useUnmount)(function(){if(s){var t=e.value,n=h(C).onUnbind;j(C),null==n||n(t)}}),m(function(){l&&e.watch(R)},[e,l,R]),(0,f.useEffect)(function(){return function(){e.unwatch(R)}},[e,l,R]),(0,b.useUpdateEffect)(function(){x()},[r,x]),r}(T,N,L),B=function(e,t,n,r){var o=n.value,u=(0,b.useCreation)(function(){return(0,O().createContextValue)(n,r,e)},[e,o,n,r]),i=(0,b.useLatest)(u);return v(function(e){var n=e.children,r=e.with,o=void 0===r?[]:r,u=t.Provider,a=i.current,c=Array.isArray(o)?o:[o];return s().createElement(u,{value:a},c.reduceRight(function(e,t){return s().createElement(t,{},e)},n))})}(N,_,T,q);return(0,b.useCreation)(function(){if((N&p.EntityEnabled)!==p.EntityEnabled)return q;var n=(0,C().cacheCalls)(q,{onShouldCache:function(){return r.current}}),o=null===$,u=Array.isArray($),i="object"!==e($)||o||u?$:function(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?k(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):k(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}({},$);return[i,n,B]},[N,$,q,B,r])},F=function(e){var t=e.usecase,n=e.watch,r=e.onMount,o=e.onUpdate,i=e.onChange,a=c(L(t,{watch:n,onChange:i}),1)[0],l=(0,b.useMemoizedFn)(function(){null==o||o(a)});return(0,b.useMount)(function(){null==r||r(a)}),(0,b.useUpdateEffect)(function(){l()},[a,l]),(0,u.jsx)(f.Fragment,{})};function I(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function _(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?I(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):I(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var z=["usecase"],N=function(e){var t=e.usecase,n=o(e,z),r=(0,L(O).getUseCaseContext)(t),i=(0,f.useContext)(r);return(0,u.jsx)(f.Fragment,{children:null===i?null:(0,u.jsx)(F,_({usecase:t},n))})};function T(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}var q=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=e.onBind,r=e.onUnbind,o=e.onChange,u=e.onUpdate,i=P().setLifecycleEvents,a=(0,d.entityUseCase)();return i({onBind:n,onUnbind:r,onChange:o,onUpdate:u}),function(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?T(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):T(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}({},a)},$=function(){for(var e=arguments.length,t=new Array(e),n=0;n<e;n++)t[n]=arguments[n];var r=j(t),o=(0,b.useLatest)(t);return(0,b.useCreation)(function(){return o.current},[r,o])}})();var o=usecases="undefined"==typeof usecases?{}:usecases;for(var u in r)o[u]=r[u];r.__esModule&&Object.defineProperty(o,"__esModule",{value:!0})})();
+(()=>{var e={698(e,t){"use strict";var n=Symbol.for("react.transitional.element");Symbol.for("react.fragment"),t.jsx=function(e,t,r){var o=null;if(void 0!==r&&(o=""+r),void 0!==t.key&&(o=""+t.key),"key"in t)for(var u in r={},t)"key"!==u&&(r[u]=t[u]);else r=t;return t=r.ref,{$$typeof:n,type:e,key:o,ref:void 0!==t?t:null,props:r}}},848(e,t,n){"use strict";e.exports=n(698)}},t={};function n(r){var o=t[r];if(void 0!==o)return o.exports;var u=t[r]={exports:{}};return e[r](u,u.exports,n),u.exports}n.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return n.d(t,{a:t}),t},n.d=(e,t)=>{for(var r in t)n.o(t,r)&&!n.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var r={};(()=>{"use strict";function e(t){return e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},e(t)}function t(t,n,r){return(n=function(t){var n=function(t){if("object"!=e(t)||!t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var r=n.call(t,"string");if("object"!=e(r))return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(t)}(t);return"symbol"==e(n)?n:n+""}(n))in t?Object.defineProperty(t,n,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[n]=r,t}function o(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(-1!==t.indexOf(r))continue;n[r]=e[r]}return n}(e,t);if(Object.getOwnPropertySymbols){var u=Object.getOwnPropertySymbols(e);for(r=0;r<u.length;r++)n=u[r],-1===t.indexOf(n)&&{}.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}n.r(r),n.d(r,{UseCaseFragment:()=>N,lifecycleUseCase:()=>q,useProviders:()=>$,useUseCase:()=>L});var u=n(848);function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=Array(t);n<t;n++)r[n]=e[n];return r}function a(e,t){if(e){if("string"==typeof e)return i(e,t);var n={}.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(e,t):void 0}}function c(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,u,i,a=[],c=!0,l=!1;try{if(u=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;c=!1}else for(;!(c=(r=u.call(n)).done)&&(a.push(r.value),a.length!==t);c=!0);}catch(e){l=!0,o=e}finally{try{if(!c&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(l)throw o}}return a}}(e,t)||a(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}const l=React;var f,s=n.n(l),y=function(e){return c((0,l.useState)(e),1)[0]};!function(e){e[e.None=0]="None",e[e.Entity=2]="Entity"}(f||(f={}));var v=function(e){return c((0,l.useState)(function(){return e}),1)[0]};const b=ahooks,d=usecases;var p;!function(e){e[e.None=0]="None",e[e.RootEnabled=2]="RootEnabled",e[e.ContextEnabled=4]="ContextEnabled",e[e.EntityEnabled=8]="EntityEnabled",e[e.ContextRootEnabled=6]="ContextRootEnabled",e[e.EntityRootEnabled=14]="EntityRootEnabled"}(p||(p={}));var O=(0,d.createUseCase)(function(){var e=new Map,t=(0,l.createContext)(null);return function(){return{createContextValue:function(e,t,n){return(n&p.EntityEnabled)===p.EntityEnabled?{store:e,reducers:t,statuses:n}:{reducers:t,statuses:n}},getUseCaseContext:function(n){return e.has(n)?e.get(n).value:t},registerUseCase:function(n,r){if(e.has(n)){var o=e.get(n),u=o.value,i=o.times;return e.set(n,{value:u,times:i+1}),u}if((r&f.Entity)!==f.Entity)return t;var a=(0,l.createContext)(null);return e.set(n,{value:a,times:1}),a},unregisterUseCase:function(t,n){if((n&f.Entity)!==f.Entity)return!1;if(!e.has(t))return!1;var r=e.get(t),o=r.value,u=r.times;return 1===u?e.delete(t):e.set(t,{value:o,times:u-1}),!0}}}}),E=function(e,t){return y(function(){return e(t)})};function h(e){return function(e){if(Array.isArray(e))return i(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||a(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}var g=function(){var t=function(t){return"object"===e(t)&&null!==t},n=function(e,n){return!!t(e)&&Object.hasOwn(e,n)};return{hasField:n,isObject:t,isEqual:function(e,r,o){if(e===r)return!0;var u=t(e),i=t(r),a=u?Object.keys(e):[],c=i?Object.keys(r):[],l="function"==typeof o;if(!u&&!i)return!1;for(var f=!0,s=a.length,y=[].concat(h(a),h(c)),v=0,b=y.length;v<b;v++){var d=y[v],p=a.includes(d);if(!(v>=s&&p)){var O=n(e,d),E=n(r,d),g=O?e[d]:void 0,j=E?r[d]:void 0;if(!O||!E||g!==j){if(f=!1,!l)break;o(d,j,g)}}}return f},matchProperty:function(e,t,r,o){var u=!0,i=r,a=[{fieldPaths:[],newEntity:t,newValue:t,oldEntity:e,oldValue:e}];do{var l=a.shift(),f=l.oldValue,s=l.newValue,y=l.fieldPaths,v=c(i.match(/^([^.]+)\.(.+)$/)||[],3),b=v[1],d=void 0===b?i:b,p=v[2],O=void 0===p?"":p,E=n(f,d),g=n(s,d);if(E||g){var j=c(E?[f[d]]:[],1)[0],m=c(g?[s[d]]:[],1)[0],w={fieldPaths:[].concat(h(y),[d]),newEntity:t,newValue:m,oldEntity:e,oldValue:j};if(O){i=O,a.push(w);continue}if(m===j)continue;u=!1,null==o||o(w)}else if(!/^\d+^/.test(d))for(var P=Array.isArray(f)?f:[],C=Array.isArray(s)?s:[],S=P.length,x=C.length,A=Math.max(S,x),R=0;R<A;R++)a.push({fieldPaths:[].concat(h(y),["".concat(R)]),newEntity:t,newValue:C[R],oldEntity:e,oldValue:P[R]})}while(a.length>0);return u}}},j=function(e){var t=(0,l.useRef)(0),n=(0,b.usePrevious)(e),r=(0,E(g).isEqual)(e,n);return(0,b.useMemoizedFn)(function(){var e=t.current;if(r)return e;var n=e+1;return t.current=n,n})()},m=function(e){var t=j(arguments.length>1&&void 0!==arguments[1]?arguments[1]:[e]),n=(0,b.useMemoizedFn)(function(){return e()});return(0,b.useCreation)(function(){return n()},[t,n])},w=function(e){var t=(0,l.useRef)(!0),n=(e&p.EntityRootEnabled)===p.EntityRootEnabled;return m(function(){if(!n)return t.current=!0,!1;var e=t.current;return t.current=!1,e})},P=(0,d.createUseCase)(function(){var e=new Map,t=null;return function(){return{deleteLifecycleEvents:function(t){return e.delete(t)},setLifecycleEvents:function(e){t=e},getLifecycleEvents:function(t){return e.get(t)||{}},bindLifecycleEventsKey:function(n){if(null===t)return{};var r=t;return t=null,e.set(n,r),r}}}}),C=function(){var e=g().isEqual,t=function(t,n){var r,o=n||{},u=o.onShouldCache,i=void 0===u?function(){return!0}:u,a=o.onCompare,c=void 0===a?function(t,n){return e(t,n)}:a;return function(){for(var e=i(),n=arguments.length,o=new Array(n),u=0;u<n;u++)o[u]=arguments[u];if(r&&e){var a=r,l=a.parameters,f=a.returnValue;if(c(l,o))return f}var s=t.apply(void 0,o);return e&&(r={parameters:o,returnValue:s}),s}};return{cacheCall:t,cacheCalls:function(e,n){var r={};return Object.entries(e).forEach(function(e){var o=c(e,2),u=o[0],i=o[1];r[u]=t(i,n)}),r},captureCalls:function(e,t){var n={};return Object.keys(e).forEach(function(r){var o=e[r];n[r]="function"!=typeof o?o:function(){for(var e=arguments.length,n=new Array(e),o=0;o<e;o++)n[o]=arguments[o];return t(r,n)}}),n}}},S=function(e,t,n){var r=j(arguments.length>3&&void 0!==arguments[3]?arguments[3]:[]),o=(0,b.useLatest)(n),u=(0,b.useMemoizedFn)(function(){return(0,C().cacheCall)(o.current,{onCompare:function(){return!0}})}),i=(0,b.useCreation)(function(){return u()},[r,u]);return(0,b.useCreation)(function(){return(t&p.RootEnabled)!==p.RootEnabled&&e?e:i()},[t,e,i])};function x(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function A(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?x(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):x(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var R=["watch","onChange","options"];function U(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function D(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?U(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):U(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var M=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},t=(0,d.entityUseCase)(),n=e.onInit;return D(D({},t),{},{initEntity:function(e){return"function"!=typeof n?e:n(e)}})},V=function(e,t,n){var r=arguments.length>3&&void 0!==arguments[3]?arguments[3]:[],o="function"==typeof e,u=w(n),i=(0,l.useRef)([]),a=((0,l.useContext)(t)||{}).store,f=void 0===a?null:a,s=(n&p.EntityRootEnabled)===p.EntityRootEnabled,y=c((0,l.useState)(function(){return new d.EntityStore(void 0)}),1)[0],v=(0,b.usePrevious)(e,function(){return!0});return m(function(){switch(!0){case!s:case o:return}u?y.initValue(e):e!==v&&y.setValue(e)}),S(f,n,function(){return s&&o&&(t=i.current,i.current=function(e,t,n,r){var o=!1,u=0,i=[],a=g(),c=a.isObject,l=a.isEqual,f=function(t){return!r||o?t:e.initValue(t)},s=(0,d.createEntityReducers)(e,M,{onInit:function(e){return t(e)},onCreate:function(e,t){var r=u,o=c(t),a=o&&Array.isArray(t);if(u++,i[r]=e,!o||a)return(0,d.createEntity)(t,e);var f={},s=n[r];return l(s,e,function(t){var n=Object.getOwnPropertyDescriptor(e,t)||null;null!==n&&(f[t]=n)}),(0,d.createEntity)(t,Object.defineProperties({},f))},onGenerate:function(t,n){if(void 0===n)return[t,n];var r=(0,d.createEntity)(t,n);return e.setValue(r),[r,n]},onYield:function(e){return f(e)},onReturn:function(t){var n=f(t);return e.setValue(n),n}}).initEntity;return e.disableWatchers(),s(),e.enableWatchers(),o=!0,i}(y,e,t,u)),y;var t},r)};function k(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}var L=function(){for(var n,r=(n=(0,b.useLatest)(!0),(0,l.useEffect)(function(){n.current=!1}),n),u=arguments.length,i=new Array(u),a=0;a<u;a++)i[a]=arguments[a];var j=function(t){return y(function(){return"function"===e(c(t,2)[1])?f.Entity:f.None})}(i),x=function(e,t){var n=c(e,4),r=n[0],o=n[1],u=n[2],i=n[3];return(t&f.Entity)!==f.Entity?[null,r,o||{},u||[]]:[r,o,u||{},i||[]]}(i,j),U=c(x,4),D=U[0],M=U[1],L=U[2],F=U[3],I=v(M),_=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:f.None,n=y(function(){return(0,O().registerUseCase)(e,t)});return(0,b.useUnmount)(function(){(0,O().unregisterUseCase)(e,t)}),n}(I,j),z=_,N=function(e,t){var n=(0,l.useContext)(e);return(0,b.useCreation)(function(){var e=p.None,r=(n||{}).store;return(t&f.Entity)===f.Entity&&(e|=p.EntityRootEnabled),e|=n?p.ContextEnabled:p.RootEnabled,r&&(e|=p.EntityEnabled),e},[t,n])}(_,j),T=V(D,z,N,F),q=function(e,t,n,r,u){var i=arguments.length>5&&void 0!==arguments[5]?arguments[5]:[],a=(0,b.useLatest)(u),c=((0,l.useContext)(t)||{}).reducers,f=void 0===c?null:c,s=(r&p.EntityRootEnabled)===p.EntityRootEnabled;return S(f,r,function(){return function(){var t=(0,C().captureCalls)(u,function(e,t){var n,r,o;return null===(r=(o=a.current)[e])||void 0===r?void 0:(n=r).call.apply(n,[o].concat(h(t)))});if(!s)return e(t);var r=t,i=(r.watch,r.onChange,r.options),c=o(r,R);return(0,d.createEntityReducers)(n,e,A(A(A({},c),i),{},{onGenerate:function(e,t){return t}}))}()},i)}(I,_,T,N,L,F),$=function(e,t,n){var r=e.value,o=(0,b.useUpdate)(),u=w(t),i=(0,b.useLatest)(n),a=(0,l.useRef)(r),f=(t&p.EntityEnabled)===p.EntityEnabled,s=(t&p.EntityRootEnabled)===p.EntityRootEnabled,v=E(function(){return P()}),O=v.bindLifecycleEventsKey,h=v.getLifecycleEvents,j=v.deleteLifecycleEvents,C=y(function(){return(0,(0,d.utilsUseCase)().createKey)()}),S=(0,b.useMemoizedFn)(function(e,t){var n=i.current.watch;n&&function(e,t,n){for(var r,o=g().matchProperty,u=function(){var e=a[i],u=(r=c(e,2))[0],l=r[1];o(n,t,u,function(e){l(e)})},i=0,a=Object.entries(e);i<a.length;i++)u()}(n,e,t)}),x=(0,b.useMemoizedFn)(function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:r,t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:a.current;if(f&&a.current!==e){var n=h(C),o=n.onUpdate,u=n.onAdopt,i=n.onDiscard;a.current=e,S(e,t),null==i||i(t),null==u||u(e,t),null==o||o(e,t)}}),A=(0,b.useMemoizedFn)(function(e,t){var n=i.current.onChange,r=h(C).onChange;x(e,t),null==n||n(e,t),null==r||r(e,t),s&&o()});return m(function(){if(s){var e=O(C),t=e.onBind,n=e.onAdopt;u&&(null==t||t(r),null==n||n(r))}}),(0,b.useUnmount)(function(){if(s){var t=e.value,n=h(C),r=n.onUnbind,o=n.onDiscard;j(C),null==r||r(t),null==o||o(t)}}),m(function(){f&&e.watch(A)},[e,f,A]),(0,l.useEffect)(function(){return function(){e.unwatch(A)}},[e,f,A]),(0,b.useUpdateEffect)(function(){x()},[r,x]),r}(T,N,L),B=function(e,t,n,r){var o=n.value,u=(0,b.useCreation)(function(){return(0,O().createContextValue)(n,r,e)},[e,o,n,r]),i=(0,b.useLatest)(u);return v(function(e){var n=e.children,r=e.with,o=void 0===r?[]:r,u=t.Provider,a=i.current,c=Array.isArray(o)?o:[o];return s().createElement(u,{value:a},c.reduceRight(function(e,t){return s().createElement(t,{},e)},n))})}(N,_,T,q);return(0,b.useCreation)(function(){if((N&p.EntityEnabled)!==p.EntityEnabled)return q;var n=(0,C().cacheCalls)(q,{onShouldCache:function(){return r.current}}),o=null===$,u=Array.isArray($),i="object"!==e($)||o||u?$:function(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?k(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):k(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}({},$);return[i,n,B]},[N,$,q,B,r])},F=function(e){var t=e.usecase,n=e.watch,r=e.onMount,o=e.onUpdate,i=e.onChange,a=c(L(t,{watch:n,onChange:i}),1)[0],f=(0,b.useMemoizedFn)(function(){null==o||o(a)});return(0,b.useMount)(function(){null==r||r(a)}),(0,b.useUpdateEffect)(function(){f()},[a,f]),(0,u.jsx)(l.Fragment,{})};function I(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function _(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?I(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):I(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}var z=["usecase"],N=function(e){var t=e.usecase,n=o(e,z),r=(0,L(O).getUseCaseContext)(t),i=(0,l.useContext)(r);return(0,u.jsx)(l.Fragment,{children:null===i?null:(0,u.jsx)(F,_({usecase:t},n))})};function T(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}var q=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=e.onAdopt,r=e.onDiscard,o=e.onBind,u=e.onUnbind,i=e.onChange,a=e.onUpdate,c=P().setLifecycleEvents,l=(0,d.entityUseCase)();return c({onAdopt:n,onDiscard:r,onBind:o,onUnbind:u,onChange:i,onUpdate:a}),function(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?T(Object(r),!0).forEach(function(n){t(e,n,r[n])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):T(Object(r)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))})}return e}({},l)},$=function(){for(var e=arguments.length,t=new Array(e),n=0;n<e;n++)t[n]=arguments[n];var r=j(t),o=(0,b.useLatest)(t);return(0,b.useCreation)(function(){return o.current},[r,o])}})();var o=usecases="undefined"==typeof usecases?{}:usecases;for(var u in r)o[u]=r[u];r.__esModule&&Object.defineProperty(o,"__esModule",{value:!0})})();

package/es/hooks/useEntity/index.js

@@ -45,9 +45,13 @@ export const useEntity = (store, statuses, options) => {
       return;
     }
     const _getLifecycleEvents = getLifecycleEvents(lifecycleKey),
-      onUpdate = _getLifecycleEvents.onUpdate;
+      onUpdate = _getLifecycleEvents.onUpdate,
+      onAdopt = _getLifecycleEvents.onAdopt,
+      onDiscard = _getLifecycleEvents.onDiscard;
     prevEntityRef.current = newEntity;
     onTriggerWatchers(newEntity, oldEntity);
+    onDiscard === null || onDiscard === void 0 || onDiscard(oldEntity);
+    onAdopt === null || onAdopt === void 0 || onAdopt(newEntity, oldEntity);
     onUpdate === null || onUpdate === void 0 || onUpdate(newEntity, oldEntity);
   });
   const onEntityChange = useMemoizedFn((newEntity, oldEntity) => {
@@ -68,11 +72,13 @@ export const useEntity = (store, statuses, options) => {
       return;
     }
     const _bindLifecycleEventsK = bindLifecycleEventsKey(lifecycleKey),
-      onBind = _bindLifecycleEventsK.onBind;
+      onBind = _bindLifecycleEventsK.onBind,
+      onAdopt = _bindLifecycleEventsK.onAdopt;
     if (!isInitializing) {
       return;
     }
     onBind === null || onBind === void 0 || onBind(entity);
+    onAdopt === null || onAdopt === void 0 || onAdopt(entity);
   });
   useUnmount(() => {
     if (!entityRootEnabled) {
@@ -81,9 +87,11 @@ export const useEntity = (store, statuses, options) => {
     // 要使用最新的 `entity`
     const currentEntity = store.value;
     const _getLifecycleEvents3 = getLifecycleEvents(lifecycleKey),
-      onUnbind = _getLifecycleEvents3.onUnbind;
+      onUnbind = _getLifecycleEvents3.onUnbind,
+      onDiscard = _getLifecycleEvents3.onDiscard;
     deleteLifecycleEvents(lifecycleKey);
     onUnbind === null || onUnbind === void 0 || onUnbind(currentEntity);
+    onDiscard === null || onDiscard === void 0 || onDiscard(currentEntity);
   });
   /**
    * 需要马上 `watch`，因为 `useEffect` 在子组件内优先执行，

package/es/hooks/useUseCase/index.test.js

@@ -2103,6 +2103,64 @@ describe('useUseCase', () => {
       expect(onUnbind).toHaveBeenCalledWith(100);
     });
   });
+  test('`onAdopt` event should be called when entity change', () => {
+    const onAdopt = jest.fn((newEntity, oldeEntity) => {
+      void newEntity;
+      void oldeEntity;
+    });
+    const testUseCase = () => {
+      const lifecycleReducers = lifecycleUseCase({
+        onAdopt
+      });
+      return {
+        ...lifecycleReducers
+      };
+    };
+    const _renderHook40 = renderHook(() => {
+        return useUseCase(5, testUseCase);
+      }),
+      result = _renderHook40.result;
+    const current = result.current;
+    const _current0 = _slicedToArray(current, 2),
+      setEntity = _current0[1].setEntity;
+    expect(onAdopt).toHaveBeenCalledTimes(1);
+    expect(onAdopt).toHaveBeenCalledWith(5);
+    act(() => {
+      setEntity(100);
+    });
+    expect(onAdopt).toHaveBeenCalledTimes(2);
+    expect(onAdopt).toHaveBeenCalledWith(100, 5);
+  });
+  test('`onDiscard` event should be called when component unmount', () => {
+    const onDiscard = jest.fn(entity => {
+      void entity;
+    });
+    const testUseCase = () => {
+      const lifecycleReducers = lifecycleUseCase({
+        onDiscard
+      });
+      return {
+        ...lifecycleReducers
+      };
+    };
+    const _renderHook41 = renderHook(() => {
+        return useUseCase(5, testUseCase);
+      }),
+      result = _renderHook41.result,
+      unmount = _renderHook41.unmount;
+    const current = result.current;
+    const _current1 = _slicedToArray(current, 2),
+      setEntity = _current1[1].setEntity;
+    expect(onDiscard).toHaveBeenCalledTimes(0);
+    act(() => {
+      setEntity(100);
+    });
+    expect(onDiscard).toHaveBeenCalledTimes(1);
+    expect(onDiscard).toHaveBeenCalledWith(5);
+    unmount();
+    expect(onDiscard).toHaveBeenCalledTimes(2);
+    expect(onDiscard).toHaveBeenCalledWith(100);
+  });
   describe('`useUseCase` should work the same as `useContextualCoreCollection`', () => {
     test('Provider should be returned in child component', () => {
       const onCore = jest.fn();
@@ -2663,38 +2721,38 @@ describe('useUseCase', () => {
   });
   describe('`useUseCase` should work the same as `useReducers`', () => {
     test('`entity` should equal `defaultFile`', () => {
-      const _renderHook40 = renderHook(() => {
+      const _renderHook42 = renderHook(() => {
           return useUseCase(mathUseCase);
         }),
-        result = _renderHook40.result;
+        result = _renderHook42.result;
       const reducers = result.current;
       expect(Array.isArray(reducers)).toBe(false);
     });
     test('returned reducer should work', () => {
-      const _renderHook41 = renderHook(() => {
+      const _renderHook43 = renderHook(() => {
           return useUseCase(mathUseCase);
         }),
-        result = _renderHook41.result;
+        result = _renderHook43.result;
       const reducers = result.current;
       const add = reducers.add;
       expect(add(1, 2)).toBe(3);
     });
     test('`usecase` should be called only once if deps has not provided', () => {
       const mockUseCase = jest.fn(mathUseCase);
-      const _renderHook42 = renderHook(() => {
+      const _renderHook44 = renderHook(() => {
           return useUseCase(mockUseCase);
         }),
-        rerender = _renderHook42.rerender;
+        rerender = _renderHook44.rerender;
       expect(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       expect(mockUseCase).toHaveBeenCalledTimes(1);
     });
     test('`usecase` should be called only once if deps has not changed', () => {
       const mockUseCase = jest.fn(mathUseCase);
-      const _renderHook43 = renderHook(() => {
+      const _renderHook45 = renderHook(() => {
           return useUseCase(mockUseCase, {}, [1, 'x']);
         }),
-        rerender = _renderHook43.rerender;
+        rerender = _renderHook45.rerender;
       expect(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       expect(mockUseCase).toHaveBeenCalledTimes(1);
@@ -2702,10 +2760,10 @@ describe('useUseCase', () => {
     test('`usecase` should be called if deps has changed', () => {
       let i = 0;
       const mockUseCase = jest.fn(mathUseCase);
-      const _renderHook44 = renderHook(() => {
+      const _renderHook46 = renderHook(() => {
           return useUseCase(mockUseCase, {}, [i++, 'x']);
         }),
-        rerender = _renderHook44.rerender;
+        rerender = _renderHook46.rerender;
       expect(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       expect(mockUseCase).toHaveBeenCalledTimes(2);
@@ -2789,12 +2847,12 @@ describe('useUseCase', () => {
       expect(subtractionReducer).toHaveReturnedWith(4);
     });
     test('`options.extraValue` should be added after call `add` method', () => {
-      const _renderHook45 = renderHook(() => {
+      const _renderHook47 = renderHook(() => {
           return useUseCase(mathUseCase, {
             extraValue: 5
           });
         }),
-        result = _renderHook45.result;
+        result = _renderHook47.result;
       const reducers = result.current;
       const add = reducers.add;
       expect(add(1, 2)).toBe(8);
@@ -2802,7 +2860,7 @@ describe('useUseCase', () => {
     test('when `options` has changed, it should not trigger update', () => {
       const onUpdate = jest.fn();
       const onDeepUpdate = jest.fn();
-      const _renderHook46 = renderHook(() => {
+      const _renderHook48 = renderHook(() => {
           const _useState7 = useState(0),
             _useState8 = _slicedToArray(_useState7, 2),
             extraValue = _useState8[0],
@@ -2818,7 +2876,7 @@ describe('useUseCase', () => {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook46.result;
+        result = _renderHook48.result;
       expect(onUpdate).toHaveBeenCalledTimes(0);
       expect(onDeepUpdate).toHaveBeenCalledTimes(0);
       act(() => {
@@ -2830,7 +2888,7 @@ describe('useUseCase', () => {
     test('when `deps` change, it should update reducers', () => {
       const onUpdate = jest.fn();
       const onDeepUpdate = jest.fn();
-      const _renderHook47 = renderHook(() => {
+      const _renderHook49 = renderHook(() => {
           const _useState9 = useState(0),
             _useState0 = _slicedToArray(_useState9, 2),
             extraValue = _useState0[0],
@@ -2846,7 +2904,7 @@ describe('useUseCase', () => {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook47.result;
+        result = _renderHook49.result;
       expect(onUpdate).toHaveBeenCalledTimes(0);
       expect(onDeepUpdate).toHaveBeenCalledTimes(0);
       act(() => {
@@ -2858,7 +2916,7 @@ describe('useUseCase', () => {
     test('empty `deps` should not update reducers', () => {
       const onUpdate = jest.fn();
       const onDeepUpdate = jest.fn();
-      const _renderHook48 = renderHook(() => {
+      const _renderHook50 = renderHook(() => {
           const _useState1 = useState(0),
             _useState10 = _slicedToArray(_useState1, 2),
             extraValue = _useState10[0],
@@ -2874,7 +2932,7 @@ describe('useUseCase', () => {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook48.result;
+        result = _renderHook50.result;
       expect(onUpdate).toHaveBeenCalledTimes(0);
       expect(onDeepUpdate).toHaveBeenCalledTimes(0);
       act(() => {

package/es/usecases/lifecycleEventUseCase/types.d.ts

@@ -10,6 +10,13 @@ export interface LifecycleEvents<T = unknown> {
      * `unmount` 的时候触发。
      */
     onUnbind(entity: T): void;
+    /**
+     * 使用新的 `entity` 的时候触发，包括：
+     *
+     * 1. `onBind` 的时候；
+     * 2. `onUpdate` 或 `onChange` 的时候。
+     */
+    onAdopt(newEntity: T, oldEntity?: T): void;
     /**
      * 非渲染阶段触发，随后会触发组件的更新：
      *
@@ -24,6 +31,13 @@ export interface LifecycleEvents<T = unknown> {
      * 2. 由 `useUseCase(entity, usecase)` 中的 `entity` 变化触发 - 渲染阶段。
      */
     onUpdate(newEntity: T, oldEntity: T): void;
+    /**
+     * 当 `entity` 被废弃时候调用，包括以下两种情况：
+     *
+     * 1. `onUpdate` 或 `onChange` 的时候；
+     * 2. `onUnbind` 的时候。
+     */
+    onDiscard(entity: T): void;
 }
 export interface CaptureLifecycleEventsCallback<T> {
     (): T;

package/es/usecases/lifecycleUseCase/index.js

@@ -2,7 +2,9 @@ import { lifecycleEventUseCase } from '../lifecycleEventUseCase';
 import { entityUseCase } from '@mic-rexjs/usecases';
 export const lifecycleUseCase = function () {
   let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  const onBind = options.onBind,
+  const onAdopt = options.onAdopt,
+    onDiscard = options.onDiscard,
+    onBind = options.onBind,
     onUnbind = options.onUnbind,
     onChange = options.onChange,
     onUpdate = options.onUpdate;
@@ -10,6 +12,8 @@ export const lifecycleUseCase = function () {
     setLifecycleEvents = _lifecycleEventUseCas.setLifecycleEvents;
   const entityReducers = entityUseCase();
   setLifecycleEvents({
+    onAdopt,
+    onDiscard,
     onBind,
     onUnbind,
     onChange,

package/lib/hooks/useEntity/index.js

@@ -51,9 +51,13 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, options)
       return;
     }
     var _getLifecycleEvents = getLifecycleEvents(lifecycleKey),
-      onUpdate = _getLifecycleEvents.onUpdate;
+      onUpdate = _getLifecycleEvents.onUpdate,
+      onAdopt = _getLifecycleEvents.onAdopt,
+      onDiscard = _getLifecycleEvents.onDiscard;
     prevEntityRef.current = newEntity;
     onTriggerWatchers(newEntity, oldEntity);
+    onDiscard === null || onDiscard === void 0 || onDiscard(oldEntity);
+    onAdopt === null || onAdopt === void 0 || onAdopt(newEntity, oldEntity);
     onUpdate === null || onUpdate === void 0 || onUpdate(newEntity, oldEntity);
   });
   var onEntityChange = (0, _ahooks.useMemoizedFn)(function (newEntity, oldEntity) {
@@ -74,11 +78,13 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, options)
       return;
     }
     var _bindLifecycleEventsK = bindLifecycleEventsKey(lifecycleKey),
-      onBind = _bindLifecycleEventsK.onBind;
+      onBind = _bindLifecycleEventsK.onBind,
+      onAdopt = _bindLifecycleEventsK.onAdopt;
     if (!isInitializing) {
       return;
     }
     onBind === null || onBind === void 0 || onBind(entity);
+    onAdopt === null || onAdopt === void 0 || onAdopt(entity);
   });
   (0, _ahooks.useUnmount)(function () {
     if (!entityRootEnabled) {
@@ -87,9 +93,11 @@ var useEntity = exports.useEntity = function useEntity(store, statuses, options)
     // 要使用最新的 `entity`
     var currentEntity = store.value;
     var _getLifecycleEvents3 = getLifecycleEvents(lifecycleKey),
-      onUnbind = _getLifecycleEvents3.onUnbind;
+      onUnbind = _getLifecycleEvents3.onUnbind,
+      onDiscard = _getLifecycleEvents3.onDiscard;
     deleteLifecycleEvents(lifecycleKey);
     onUnbind === null || onUnbind === void 0 || onUnbind(currentEntity);
+    onDiscard === null || onDiscard === void 0 || onDiscard(currentEntity);
   });
   /**
    * 需要马上 `watch`，因为 `useEffect` 在子组件内优先执行，

package/lib/hooks/useUseCase/index.test.js

@@ -2122,6 +2122,60 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
       (0, _globals.expect)(onUnbind).toHaveBeenCalledWith(100);
     });
   });
+  (0, _globals.test)('`onAdopt` event should be called when entity change', function () {
+    var onAdopt = _globals.jest.fn(function (newEntity, oldeEntity) {
+      void newEntity;
+      void oldeEntity;
+    });
+    var testUseCase = function testUseCase() {
+      var lifecycleReducers = (0, _lifecycleUseCase.lifecycleUseCase)({
+        onAdopt: onAdopt
+      });
+      return _objectSpread({}, lifecycleReducers);
+    };
+    var _renderHook40 = (0, _react.renderHook)(function () {
+        return (0, _.useUseCase)(5, testUseCase);
+      }),
+      result = _renderHook40.result;
+    var current = result.current;
+    var _current0 = (0, _slicedToArray2["default"])(current, 2),
+      setEntity = _current0[1].setEntity;
+    (0, _globals.expect)(onAdopt).toHaveBeenCalledTimes(1);
+    (0, _globals.expect)(onAdopt).toHaveBeenCalledWith(5);
+    (0, _react.act)(function () {
+      setEntity(100);
+    });
+    (0, _globals.expect)(onAdopt).toHaveBeenCalledTimes(2);
+    (0, _globals.expect)(onAdopt).toHaveBeenCalledWith(100, 5);
+  });
+  (0, _globals.test)('`onDiscard` event should be called when component unmount', function () {
+    var onDiscard = _globals.jest.fn(function (entity) {
+      void entity;
+    });
+    var testUseCase = function testUseCase() {
+      var lifecycleReducers = (0, _lifecycleUseCase.lifecycleUseCase)({
+        onDiscard: onDiscard
+      });
+      return _objectSpread({}, lifecycleReducers);
+    };
+    var _renderHook41 = (0, _react.renderHook)(function () {
+        return (0, _.useUseCase)(5, testUseCase);
+      }),
+      result = _renderHook41.result,
+      unmount = _renderHook41.unmount;
+    var current = result.current;
+    var _current1 = (0, _slicedToArray2["default"])(current, 2),
+      setEntity = _current1[1].setEntity;
+    (0, _globals.expect)(onDiscard).toHaveBeenCalledTimes(0);
+    (0, _react.act)(function () {
+      setEntity(100);
+    });
+    (0, _globals.expect)(onDiscard).toHaveBeenCalledTimes(1);
+    (0, _globals.expect)(onDiscard).toHaveBeenCalledWith(5);
+    unmount();
+    (0, _globals.expect)(onDiscard).toHaveBeenCalledTimes(2);
+    (0, _globals.expect)(onDiscard).toHaveBeenCalledWith(100);
+  });
   (0, _globals.describe)('`useUseCase` should work the same as `useContextualCoreCollection`', function () {
     (0, _globals.test)('Provider should be returned in child component', function () {
       var onCore = _globals.jest.fn();
@@ -2669,38 +2723,38 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
   });
   (0, _globals.describe)('`useUseCase` should work the same as `useReducers`', function () {
     (0, _globals.test)('`entity` should equal `defaultFile`', function () {
-      var _renderHook40 = (0, _react.renderHook)(function () {
+      var _renderHook42 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mathUseCase);
         }),
-        result = _renderHook40.result;
+        result = _renderHook42.result;
       var reducers = result.current;
       (0, _globals.expect)(Array.isArray(reducers)).toBe(false);
     });
     (0, _globals.test)('returned reducer should work', function () {
-      var _renderHook41 = (0, _react.renderHook)(function () {
+      var _renderHook43 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mathUseCase);
         }),
-        result = _renderHook41.result;
+        result = _renderHook43.result;
       var reducers = result.current;
       var add = reducers.add;
       (0, _globals.expect)(add(1, 2)).toBe(3);
     });
     (0, _globals.test)('`usecase` should be called only once if deps has not provided', function () {
       var mockUseCase = _globals.jest.fn(mathUseCase);
-      var _renderHook42 = (0, _react.renderHook)(function () {
+      var _renderHook44 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mockUseCase);
         }),
-        rerender = _renderHook42.rerender;
+        rerender = _renderHook44.rerender;
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(1);
     });
     (0, _globals.test)('`usecase` should be called only once if deps has not changed', function () {
       var mockUseCase = _globals.jest.fn(mathUseCase);
-      var _renderHook43 = (0, _react.renderHook)(function () {
+      var _renderHook45 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mockUseCase, {}, [1, 'x']);
         }),
-        rerender = _renderHook43.rerender;
+        rerender = _renderHook45.rerender;
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(1);
@@ -2708,10 +2762,10 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
     (0, _globals.test)('`usecase` should be called if deps has changed', function () {
       var i = 0;
       var mockUseCase = _globals.jest.fn(mathUseCase);
-      var _renderHook44 = (0, _react.renderHook)(function () {
+      var _renderHook46 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mockUseCase, {}, [i++, 'x']);
         }),
-        rerender = _renderHook44.rerender;
+        rerender = _renderHook46.rerender;
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(1);
       rerender();
       (0, _globals.expect)(mockUseCase).toHaveBeenCalledTimes(2);
@@ -2795,12 +2849,12 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
       (0, _globals.expect)(subtractionReducer).toHaveReturnedWith(4);
     });
     (0, _globals.test)('`options.extraValue` should be added after call `add` method', function () {
-      var _renderHook45 = (0, _react.renderHook)(function () {
+      var _renderHook47 = (0, _react.renderHook)(function () {
           return (0, _.useUseCase)(mathUseCase, {
             extraValue: 5
           });
         }),
-        result = _renderHook45.result;
+        result = _renderHook47.result;
       var reducers = result.current;
       var add = reducers.add;
       (0, _globals.expect)(add(1, 2)).toBe(8);
@@ -2808,7 +2862,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
     (0, _globals.test)('when `options` has changed, it should not trigger update', function () {
       var onUpdate = _globals.jest.fn();
       var onDeepUpdate = _globals.jest.fn();
-      var _renderHook46 = (0, _react.renderHook)(function () {
+      var _renderHook48 = (0, _react.renderHook)(function () {
           var _useState7 = (0, _react2.useState)(0),
             _useState8 = (0, _slicedToArray2["default"])(_useState7, 2),
             extraValue = _useState8[0],
@@ -2824,7 +2878,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook46.result;
+        result = _renderHook48.result;
       (0, _globals.expect)(onUpdate).toHaveBeenCalledTimes(0);
       (0, _globals.expect)(onDeepUpdate).toHaveBeenCalledTimes(0);
       (0, _react.act)(function () {
@@ -2836,7 +2890,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
     (0, _globals.test)('when `deps` change, it should update reducers', function () {
       var onUpdate = _globals.jest.fn();
       var onDeepUpdate = _globals.jest.fn();
-      var _renderHook47 = (0, _react.renderHook)(function () {
+      var _renderHook49 = (0, _react.renderHook)(function () {
           var _useState9 = (0, _react2.useState)(0),
             _useState0 = (0, _slicedToArray2["default"])(_useState9, 2),
             extraValue = _useState0[0],
@@ -2852,7 +2906,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook47.result;
+        result = _renderHook49.result;
       (0, _globals.expect)(onUpdate).toHaveBeenCalledTimes(0);
       (0, _globals.expect)(onDeepUpdate).toHaveBeenCalledTimes(0);
       (0, _react.act)(function () {
@@ -2864,7 +2918,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
     (0, _globals.test)('empty `deps` should not update reducers', function () {
       var onUpdate = _globals.jest.fn();
       var onDeepUpdate = _globals.jest.fn();
-      var _renderHook48 = (0, _react.renderHook)(function () {
+      var _renderHook50 = (0, _react.renderHook)(function () {
           var _useState1 = (0, _react2.useState)(0),
             _useState10 = (0, _slicedToArray2["default"])(_useState1, 2),
             extraValue = _useState10[0],
@@ -2880,7 +2934,7 @@ var useDeepCompareUpdate = function useDeepCompareUpdate(callback, deps) {
           }, [reducers]);
           return setExtraValue;
         }),
-        result = _renderHook48.result;
+        result = _renderHook50.result;
       (0, _globals.expect)(onUpdate).toHaveBeenCalledTimes(0);
       (0, _globals.expect)(onDeepUpdate).toHaveBeenCalledTimes(0);
       (0, _react.act)(function () {

package/lib/usecases/lifecycleUseCase/index.js

@@ -12,7 +12,9 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 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 lifecycleUseCase = exports.lifecycleUseCase = function lifecycleUseCase() {
   var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  var onBind = options.onBind,
+  var onAdopt = options.onAdopt,
+    onDiscard = options.onDiscard,
+    onBind = options.onBind,
     onUnbind = options.onUnbind,
     onChange = options.onChange,
     onUpdate = options.onUpdate;
@@ -20,6 +22,8 @@ var lifecycleUseCase = exports.lifecycleUseCase = function lifecycleUseCase() {
     setLifecycleEvents = _lifecycleEventUseCas.setLifecycleEvents;
   var entityReducers = (0, _usecases.entityUseCase)();
   setLifecycleEvents({
+    onAdopt: onAdopt,
+    onDiscard: onDiscard,
     onBind: onBind,
     onUnbind: onUnbind,
     onChange: onChange,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mic-rexjs/usecases-react",
-  "version": "3.6.3",
+  "version": "3.7.0",
   "description": "React-based solution for use usecases of Clean Architecture",
   "private": false,
   "sideEffects": false,