// Copyright 2017-2025 @polkadot/react-hooks authors & contributors // SPDX-License-Identifier: Apache-2.0 import { useMemo, useRef } from 'react'; import { stringify } from '@polkadot/util'; interface State { stringified: string; value: T; } // since we use these in tests, we are not using React.MutableRef> interface Ref { current: State | null; } /** * @internal * * Does a check between two values to determine if they are equivalent. For * non-array values it does a simple === compare, for arrays is checks the * lengths and the individual items. (This is limited to a depth) */ export function isDifferent (a: unknown, b: unknown, depth = -1): boolean { // increase the depth for arrays (we start at -1, so 0 is top-level) depth++; // check the actual value references for an exact match return a !== b // check if both are arrays with matching length ? depth < 2 && Array.isArray(a) && Array.isArray(b) && a.length === b.length // check for any differences inside the arrays (with depth) ? a.some((ai, i) => isDifferent(ai, b[i], depth)) // not equal and not an array : true // exact value match found : false; } /** * @internal * * Checks the supplied value against the previous state, returning either the * previous state (if we have a match) or a new object for future compares. **/ export function getMemoValue (ref: Ref, value: T): T { // check that either we have no previous or the value changed if (!ref.current || isDifferent(ref.current.value, value)) { const stringified = stringify({ value }); // no previous or the stringified result is different if (!ref.current || ref.current.stringified !== stringified) { ref.current = { stringified, value }; } } return ref.current.value; } // NOTE: Generic, cannot be used in named hook export function useMemoValue (value: T): T { const ref = useRef | null>(null); return useMemo( () => getMemoValue(ref, value), [ref, value] ); }