react-native-sortables/dist/module/integrations/reanimated/hooks/useStableCallbackValue.js

Powerful Sortable Components for Flexible Content Reordering in React Native

"use strict";

import { useCallback, useEffect } from 'react';
import { isWorkletFunction, runOnJS } from 'react-native-reanimated';
import useMutableValue from './useMutableValue';

// We cannot store a function as a SharedValue because reanimated will treat
// it as an animation and will try to execute the animation when assigned
// to the SharedValue. Since we want the function to be treated as a value,
// we wrap it in an object and store the object in the SharedValue.

const wrap = callback => {
  if (isWorkletFunction(callback)) {
    return {
      call: callback
    };
  }
  return {
    call: (...args) => {
      'worklet';

      runOnJS(callback)(...args);
    }
  };
};

/** Creates a stable worklet callback that can be called from the UI runtime
 * @param callback The JavaScript or worklet function to be called
 * @returns A worklet function that can be safely called from the UI thread
 * @default Behavior:
 * - If passed a regular JS function, calls it on the JS thread using runOnJS
 * - If passed a worklet function, calls it directly on the UI thread
 * @important The returned function maintains a stable reference and properly handles
 * thread execution based on the input callback type
 */
export default function useStableCallbackValue(callback) {
  const stableCallback = useMutableValue(null);
  useEffect(() => {
    if (callback) {
      stableCallback.value = wrap(callback);
    } else {
      stableCallback.value = null;
    }
  }, [callback, stableCallback]);
  return useCallback((...args) => {
    'worklet';

    stableCallback.value?.call(...args);
  }, [stableCallback]);
}
//# sourceMappingURL=useStableCallbackValue.js.map