add useClassImperativeHandle hook

Author: salvoravida

CHANGELOG.md

@@ -4,6 +4,7 @@ v. 0.4.0
 *  useClassEffect - fix ConcurrentMode 
 *  hooks stack counter - fix ConcurrentMode
 *  build optimization - removed babel slicedToArray 
+*  add useClassImperativeHandle hook
 
 v. 0.3.6
 -----------

dist/index.esm.js

@@ -408,9 +408,36 @@ useClassContext.create = function (name) {
   return createNamedHook(name, useClassContextKey);
 };
 
+function useClassImperativeHandle(ref, create, deps) {
+  invariant(typeof create === 'function', "Expected useImperativeHandle() second argument to be a function that creates a handle. Instead received: ".concat(create !== null ? _typeof(create) : 'null'));
+  invariant(deps === null || deps === undefined || Array.isArray(deps), 'Hook received a final argument that is not an array!');
+  var effectDeps = deps !== null && deps !== undefined ? deps.concat([ref]) : null; // eslint-disable-next-line consistent-return
+
+  useClassEffect(function () {
+    if (typeof ref === 'function') {
+      var refCallback = ref;
+      refCallback(create()); // eslint-disable-next-line func-names
+
+      return function () {
+        refCallback(null);
+      };
+    }
+
+    if (ref !== null && ref !== undefined) {
+      var refObject = ref;
+      invariant(refObject.hasOwnProperty('current'), "Expected useImperativeHandle() first argument to either be a ref callback or React.createRef() object. Instead received: an object with keys {".concat(Object.keys(refObject).join(', '), "}"));
+      refObject.current = create(); // eslint-disable-next-line func-names
+
+      return function () {
+        refObject.current = null;
+      };
+    }
+  }, effectDeps);
+}
+
 /**
  *  https://github.com/salvoravida/react-class-hooks
  */
 var useClassLayoutEffect = useClassEffect;
 
-export { refCallback, useClassCallback, useClassContext, useClassEffect, useClassLayoutEffect, useClassMemo, useClassReducer, useClassRef, useClassState };
+export { refCallback, useClassCallback, useClassContext, useClassEffect, useClassImperativeHandle, useClassLayoutEffect, useClassMemo, useClassReducer, useClassRef, useClassState };

dist/index.js

@@ -414,6 +414,33 @@ useClassContext.create = function (name) {
   return createNamedHook(name, useClassContextKey);
 };
 
+function useClassImperativeHandle(ref, create, deps) {
+  invariant(typeof create === 'function', "Expected useImperativeHandle() second argument to be a function that creates a handle. Instead received: ".concat(create !== null ? _typeof(create) : 'null'));
+  invariant(deps === null || deps === undefined || Array.isArray(deps), 'Hook received a final argument that is not an array!');
+  var effectDeps = deps !== null && deps !== undefined ? deps.concat([ref]) : null; // eslint-disable-next-line consistent-return
+
+  useClassEffect(function () {
+    if (typeof ref === 'function') {
+      var refCallback = ref;
+      refCallback(create()); // eslint-disable-next-line func-names
+
+      return function () {
+        refCallback(null);
+      };
+    }
+
+    if (ref !== null && ref !== undefined) {
+      var refObject = ref;
+      invariant(refObject.hasOwnProperty('current'), "Expected useImperativeHandle() first argument to either be a ref callback or React.createRef() object. Instead received: an object with keys {".concat(Object.keys(refObject).join(', '), "}"));
+      refObject.current = create(); // eslint-disable-next-line func-names
+
+      return function () {
+        refObject.current = null;
+      };
+    }
+  }, effectDeps);
+}
+
 /**
  *  https://github.com/salvoravida/react-class-hooks
  */
@@ -423,6 +450,7 @@ exports.refCallback = refCallback;
 exports.useClassCallback = useClassCallback;
 exports.useClassContext = useClassContext;
 exports.useClassEffect = useClassEffect;
+exports.useClassImperativeHandle = useClassImperativeHandle;
 exports.useClassLayoutEffect = useClassLayoutEffect;
 exports.useClassMemo = useClassMemo;
 exports.useClassReducer = useClassReducer;

package-lock.json

@@ -0,0 +1,43 @@
+import invariant from 'tiny-invariant';
+import { useClassEffect } from './useClassEffect';
+
+export function useClassImperativeHandle(ref, create, deps) {
+    invariant(
+        typeof create === 'function',
+        `Expected useImperativeHandle() second argument to be a function that creates a handle. Instead received: ${
+            create !== null ? typeof create : 'null'
+        }`,
+    );
+    invariant(
+        deps === null || deps === undefined || Array.isArray(deps),
+        'Hook received a final argument that is not an array!',
+    );
+
+    const effectDeps = deps !== null && deps !== undefined ? deps.concat([ref]) : null;
+
+    // eslint-disable-next-line consistent-return
+    useClassEffect(() => {
+        if (typeof ref === 'function') {
+            const refCallback = ref;
+            refCallback(create());
+            // eslint-disable-next-line func-names
+            return function () {
+                refCallback(null);
+            };
+        }
+        if (ref !== null && ref !== undefined) {
+            const refObject = ref;
+            invariant(
+                refObject.hasOwnProperty('current'),
+                `Expected useImperativeHandle() first argument to either be a ref callback or React.createRef() object. Instead received: an object with keys {${Object.keys(
+                    refObject,
+                ).join(', ')}}`,
+            );
+            refObject.current = create();
+            // eslint-disable-next-line func-names
+            return function () {
+                refObject.current = null;
+            };
+        }
+    }, effectDeps);
+}

src/core/useClassImperativeHandle.js

@@ -9,6 +9,7 @@ import { useClassCallback } from './core/useClassCallback';
 import { useClassReducer } from './core/useClassReducer';
 import { useClassRef, refCallback } from './core/useClassRef';
 import { useClassContext } from './core/useClassContext';
+import { useClassImperativeHandle } from './core/useClassImperativeHandle';
 
 const useClassLayoutEffect = useClassEffect;
 
@@ -22,4 +23,5 @@ export {
     useClassRef,
     refCallback,
     useClassContext,
+    useClassImperativeHandle,
 };