/**
 * External dependencies
 */
import { useRef } from '@wordpress/element';
import isShallowEqual from '@wordpress/is-shallow-equal';

/**
 * A custom hook that compares the provided value across renders and returns the
 * previous instance if shallow equality with previous instance exists.
 *
 * This is particularly useful when non-primitive types are used as
 * dependencies for react hooks.
 *
 * @param {mixed} value Value to keep the same if satisfies shallow equality.
 *
 * @return {mixed} The previous cached instance of the value if the current has
 *                 shallow equality with it.
 */
export const useShallowEqual = ( value ) => {
	const ref = useRef();
	if ( ! isShallowEqual( value, ref.current ) ) {
		ref.current = value;
	}
	return ref.current;
};
