@vef-framework/hooks 1.0.135 → 2.0.1

package/dist/cjs/use-deep-layout-effect/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-deep-compare/index.cjs');
+
+function useDeepLayoutEffect(effect, dependencies) {
+  return react.useLayoutEffect(effect, index.useDeepCompare(dependencies));
+}
+
+exports.useDeepLayoutEffect = useDeepLayoutEffect;

package/dist/cjs/use-deep-memo/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-deep-compare/index.cjs');
+
+function useDeepMemo(factory, dependencies) {
+  return react.useMemo(factory, index.useDeepCompare(dependencies));
+}
+
+exports.useDeepMemo = useDeepMemo;

package/dist/cjs/use-document-event/index.cjs

@@ -0,0 +1,22 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const index = require('../use-latest/index.cjs');
+const index$1 = require('../use-shallow-effect/index.cjs');
+
+function useDocumentEvent(type, listener, options) {
+  const listenerFn = index.useLatest(listener);
+  index$1.useShallowEffect(() => {
+    function handleEvent(event) {
+      listenerFn.current.call(this, event);
+    }
+    document.addEventListener(type, handleEvent, options);
+    return () => {
+      document.removeEventListener(type, handleEvent, options);
+    };
+  }, [type, options, listenerFn]);
+}
+
+exports.useDocumentEvent = useDocumentEvent;

package/dist/cjs/use-emitter-event/index.cjs

@@ -0,0 +1,22 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+require('@vef-framework/shared');
+const react = require('react');
+
+function useEmitterEvent(emitter, eventType, eventListener) {
+  const listenerFn = react.useEffectEvent(eventListener);
+  react.useEffect(
+    () => {
+      const handler = (...args) => {
+        listenerFn(...args);
+      };
+      return emitter.on(eventType, handler);
+    },
+    [emitter, eventType]
+  );
+}
+
+exports.useEmitterEvent = useEmitterEvent;

package/dist/cjs/use-has-fetching/index.cjs

@@ -0,0 +1,17 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+
+function useHasFetching(key, params) {
+  const count = core.useIsFetching({
+    queryKey: params ? [key, params] : [key],
+    exact: false,
+    type: "active"
+  });
+  return count > 0;
+}
+
+exports.useHasFetching = useHasFetching;

package/dist/cjs/use-has-mutating/index.cjs

@@ -0,0 +1,16 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+
+function useHasMutating(key) {
+  const count = core.useIsMutating({
+    mutationKey: [key],
+    exact: false
+  });
+  return count > 0;
+}
+
+exports.useHasMutating = useHasMutating;

package/dist/cjs/use-is-authorized/index.cjs

@@ -0,0 +1,18 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+const react = require('react');
+
+function useIsAuthorized(permTokens, checkMode) {
+  const { hasPermission = () => true } = core.useAppContext();
+  const isAuthorized = react.useMemo(
+    () => core.checkPermission(hasPermission, permTokens, checkMode),
+    [permTokens, checkMode, hasPermission]
+  );
+  return isAuthorized;
+}
+
+exports.useIsAuthorized = useIsAuthorized;

package/dist/cjs/use-latest/index.cjs

@@ -0,0 +1,14 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+
+function useLatest(value) {
+  const ref = react.useRef(value);
+  ref.current = value;
+  return ref;
+}
+
+exports.useLatest = useLatest;

package/dist/cjs/use-raf-state/index.cjs

@@ -0,0 +1,23 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+
+function useRafState(initialState) {
+  const frameId = react.useRef(0);
+  const [state, setState] = react.useState(initialState);
+  const setRafState = react.useCallback((state2) => {
+    cancelAnimationFrame(frameId.current);
+    frameId.current = requestAnimationFrame(() => {
+      setState(state2);
+    });
+  }, []);
+  react.useEffect(() => () => {
+    cancelAnimationFrame(frameId.current);
+  }, []);
+  return [state, setRafState];
+}
+
+exports.useRafState = useRafState;

package/dist/cjs/use-shallow-callback/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-shallow-compare/index.cjs');
+
+function useShallowCallback(callback, dependencies) {
+  return react.useCallback(callback, index.useShallowCompare(dependencies));
+}
+
+exports.useShallowCallback = useShallowCallback;

package/dist/cjs/use-shallow-compare/index.cjs

@@ -0,0 +1,36 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+function useShallowCompare(dependencies) {
+  const ref = react.useRef(void 0);
+  const signalRef = react.useRef(0);
+  if (!shallowCompare(ref.current, dependencies)) {
+    ref.current = dependencies;
+    signalRef.current += 1;
+  }
+  return [signalRef.current];
+}
+function shallowCompare(previous, current) {
+  if (!previous || !current) {
+    return false;
+  }
+  if (Object.is(previous, current)) {
+    return true;
+  }
+  if (previous.length !== current.length) {
+    return false;
+  }
+  for (const [index, element] of previous.entries()) {
+    if (!shared.isShallowEqual(element, current[index])) {
+      return false;
+    }
+  }
+  return true;
+}
+
+exports.useShallowCompare = useShallowCompare;

package/dist/cjs/use-shallow-effect/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-shallow-compare/index.cjs');
+
+function useShallowEffect(effect, dependencies) {
+  return react.useEffect(effect, index.useShallowCompare(dependencies));
+}
+
+exports.useShallowEffect = useShallowEffect;

package/dist/cjs/use-shallow-isomorphic-effect/index.cjs

@@ -0,0 +1,14 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+require('../lib.cjs');
+const index = require('../use-shallow-compare/index.cjs');
+const hooks = require('@mantine/hooks');
+
+function useShallowIsomorphicEffect(effect, dependencies) {
+  return hooks.useIsomorphicEffect(effect, index.useShallowCompare(dependencies));
+}
+
+exports.useShallowIsomorphicEffect = useShallowIsomorphicEffect;

package/dist/cjs/use-shallow-layout-effect/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-shallow-compare/index.cjs');
+
+function useShallowLayoutEffect(effect, dependencies) {
+  return react.useLayoutEffect(effect, index.useShallowCompare(dependencies));
+}
+
+exports.useShallowLayoutEffect = useShallowLayoutEffect;

package/dist/cjs/use-shallow-memo/index.cjs

@@ -0,0 +1,13 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const index = require('../use-shallow-compare/index.cjs');
+
+function useShallowMemo(factory, dependencies) {
+  return react.useMemo(factory, index.useShallowCompare(dependencies));
+}
+
+exports.useShallowMemo = useShallowMemo;

package/dist/cjs/use-singleton/index.cjs

@@ -0,0 +1,16 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+
+function useSingleton(initializer) {
+  const ref = react.useRef(null);
+  if (ref.current === null) {
+    ref.current = initializer();
+  }
+  return ref;
+}
+
+exports.useSingleton = useSingleton;

package/dist/es/index.js

@@ -0,0 +1,29 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+export { useColorScheme, useMediaQuery, useReducedMotion } from './lib.js';
+export { useAuthorizedItems } from './use-authorized-items/index.js';
+export { useBreakpoints } from './use-breakpoints/index.js';
+export { useCheckPermission } from './use-check-permission/index.js';
+export { useDataDictQuery } from './use-data-dict-query/index.js';
+export { useDataOptionsQuery } from './use-data-options/index.js';
+export { useDeepCallback } from './use-deep-callback/index.js';
+export { useDeepCompare } from './use-deep-compare/index.js';
+export { useDeepEffect } from './use-deep-effect/index.js';
+export { useDeepIsomorphicEffect } from './use-deep-isomorphic-effect/index.js';
+export { useDeepLayoutEffect } from './use-deep-layout-effect/index.js';
+export { useDeepMemo } from './use-deep-memo/index.js';
+export { useDocumentEvent } from './use-document-event/index.js';
+export { useEmitterEvent } from './use-emitter-event/index.js';
+export { useHasFetching } from './use-has-fetching/index.js';
+export { useHasMutating } from './use-has-mutating/index.js';
+export { useIsAuthorized } from './use-is-authorized/index.js';
+export { useLatest } from './use-latest/index.js';
+export { useRafState } from './use-raf-state/index.js';
+export { useShallowCallback } from './use-shallow-callback/index.js';
+export { useShallowCompare } from './use-shallow-compare/index.js';
+export { useShallowEffect } from './use-shallow-effect/index.js';
+export { useShallowIsomorphicEffect } from './use-shallow-isomorphic-effect/index.js';
+export { useShallowLayoutEffect } from './use-shallow-layout-effect/index.js';
+export { useShallowMemo } from './use-shallow-memo/index.js';
+export { useSingleton } from './use-singleton/index.js';
+export { assignRef, getHotkeyHandler, mergeRefs, useDebouncedCallback, useDebouncedState, useDebouncedValue, useDidUpdate, useDocumentTitle, useElementSize, useEventListener, useFocusTrap, useFullscreen, useIntersection, useInterval, useIsFirstRender, useIsomorphicEffect, useMergedRef, useMounted, useMutationObserver, usePrevious, useResizeObserver, useTimeout, useWindowEvent } from '@mantine/hooks';
+export { HotkeysProvider, useHotkeys, useHotkeysContext, useRecordHotkeys } from 'react-hotkeys-hook';

package/dist/es/lib.js

@@ -0,0 +1,35 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useMediaQuery as useMediaQuery$1, useColorScheme as useColorScheme$1, useReducedMotion as useReducedMotion$1 } from '@mantine/hooks';
+export { assignRef, getHotkeyHandler, mergeRefs, useDebouncedCallback, useDebouncedState, useDebouncedValue, useDidUpdate, useDocumentTitle, useElementSize, useEventListener, useFocusTrap, useFullscreen, useIntersection, useInterval, useIsFirstRender, useIsomorphicEffect, useMergedRef, useMounted, useMutationObserver, usePrevious, useResizeObserver, useTimeout, useWindowEvent } from '@mantine/hooks';
+export { HotkeysProvider, useHotkeys, useHotkeysContext, useRecordHotkeys } from 'react-hotkeys-hook';
+
+function useMediaQuery(query, initialValue, options) {
+  const { getInitialValueInEffect = false } = options ?? {};
+  return useMediaQuery$1(
+    query,
+    initialValue,
+    {
+      getInitialValueInEffect
+    }
+  );
+}
+function useColorScheme(initialValue, options) {
+  const { getInitialValueInEffect = false } = options ?? {};
+  return useColorScheme$1(
+    initialValue,
+    {
+      getInitialValueInEffect
+    }
+  );
+}
+function useReducedMotion(initialValue, options) {
+  const { getInitialValueInEffect = false } = options ?? {};
+  return useReducedMotion$1(
+    initialValue,
+    {
+      getInitialValueInEffect
+    }
+  );
+}
+
+export { useColorScheme, useMediaQuery, useReducedMotion };

package/dist/es/use-authorized-items/index.js

@@ -0,0 +1,16 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useAppContext, checkPermission } from '@vef-framework/core';
+import { useMemo } from 'react';
+
+function useAuthorizedItems(items) {
+  const { hasPermission = () => true } = useAppContext();
+  return useMemo(
+    () => items.filter((item) => {
+      const { permTokens, checkMode = "any" } = item;
+      return checkPermission(hasPermission, permTokens, checkMode);
+    }),
+    [items, hasPermission]
+  );
+}
+
+export { useAuthorizedItems };

package/dist/es/use-breakpoints/index.js

@@ -0,0 +1,70 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { isNumber } from '@vef-framework/shared';
+import { useMemo, useState, useEffect } from 'react';
+
+function createMediaQuery(value) {
+  return `(min-width: ${isNumber(value) ? `${value}px` : value})`;
+}
+function useBreakpoints(breakpoints, options = {}) {
+  const { initialBreakpoint, getInitialValueInEffect = false } = options;
+  const sortedBreakpoints = useMemo(
+    () => Object.entries(breakpoints).map(([name, value]) => {
+      return {
+        name,
+        value,
+        query: createMediaQuery(value),
+        order: isNumber(value) ? value : Number.parseInt(value)
+      };
+    }).toSorted((a, b) => a.order - b.order),
+    [breakpoints]
+  );
+  const [state, setState] = useState(() => {
+    if (globalThis.window === void 0 || getInitialValueInEffect) {
+      const initialEntry = sortedBreakpoints.find((bp) => bp.name === initialBreakpoint);
+      return {
+        current: initialBreakpoint,
+        value: initialEntry?.value,
+        matches: initialBreakpoint ? [initialBreakpoint] : []
+      };
+    }
+    const matchingBreakpoints = sortedBreakpoints.filter((bp) => globalThis.matchMedia(bp.query).matches);
+    const currentBreakpoint = matchingBreakpoints.at(-1);
+    return {
+      current: currentBreakpoint?.name,
+      value: currentBreakpoint?.value,
+      matches: matchingBreakpoints.map((bp) => bp.name)
+    };
+  });
+  useEffect(() => {
+    const mediaQueryLists = sortedBreakpoints.map((bp) => {
+      return {
+        name: bp.name,
+        value: bp.value,
+        mql: globalThis.matchMedia(bp.query)
+      };
+    });
+    const updateBreakpoint = () => {
+      const matchingBreakpoints = mediaQueryLists.filter((item) => item.mql.matches);
+      const currentBreakpoint = matchingBreakpoints.at(-1);
+      setState({
+        current: currentBreakpoint?.name,
+        value: currentBreakpoint?.value,
+        matches: matchingBreakpoints.map((mbp) => mbp.name)
+      });
+    };
+    if (getInitialValueInEffect) {
+      updateBreakpoint();
+    }
+    for (const item of mediaQueryLists) {
+      item.mql.addEventListener("change", updateBreakpoint);
+    }
+    return () => {
+      for (const item of mediaQueryLists) {
+        item.mql.removeEventListener("change", updateBreakpoint);
+      }
+    };
+  }, [getInitialValueInEffect, sortedBreakpoints]);
+  return state;
+}
+
+export { useBreakpoints };

package/dist/es/use-check-permission/index.js

@@ -0,0 +1,14 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useAppContext, checkPermission } from '@vef-framework/core';
+import { useCallback } from 'react';
+
+function useCheckPermission() {
+  const { hasPermission = () => true } = useAppContext();
+  const checkPermission$1 = useCallback(
+    (permTokens, checkMode) => checkPermission(hasPermission, permTokens, checkMode),
+    [hasPermission]
+  );
+  return checkPermission$1;
+}
+
+export { useCheckPermission };

package/dist/es/use-data-dict-query/index.js

@@ -0,0 +1,30 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useAppContext, useQuery, skipQueryToken } from '@vef-framework/core';
+import { isFunction, isEmpty } from '@vef-framework/shared';
+import { useEffectEvent, useEffect } from 'react';
+
+function useDataDictQuery({
+  dataDictKey,
+  onFetch,
+  ...options
+}) {
+  const { dataDictQueryFn } = useAppContext();
+  if (!isFunction(dataDictQueryFn)) {
+    throw new Error("Data dictionary query function is not provided in the app context.");
+  }
+  const result = useQuery({
+    ...options,
+    queryFn: isEmpty(dataDictKey) ? skipQueryToken : dataDictQueryFn,
+    queryKey: [dataDictQueryFn.key, dataDictKey],
+    staleTime: options?.staleTime ?? Infinity
+  });
+  const onFetchFn = useEffectEvent((data) => {
+    onFetch?.(data);
+  });
+  useEffect(() => {
+    result.promise.then(onFetchFn);
+  }, [result.promise]);
+  return result;
+}
+
+export { useDataDictQuery };

package/dist/es/use-data-options/index.js

@@ -0,0 +1,115 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useQuery, skipQueryToken } from '@vef-framework/core';
+import { isFunction, get, isNullish, withPinyin, isEmpty, isString } from '@vef-framework/shared';
+import { useMemo } from 'react';
+import { useDataDictQuery } from '../use-data-dict-query/index.js';
+
+function extractField(item, extractor, defaultKey) {
+  if (!extractor) {
+    return item[defaultKey];
+  }
+  if (isFunction(extractor)) {
+    return extractor(item);
+  }
+  return get(item, extractor);
+}
+function transformDataItem(item, options, withPinyin$1) {
+  const {
+    labelKey,
+    valueKey,
+    disabledKey,
+    descriptionKey,
+    childrenKey
+  } = options;
+  const label = extractField(item, labelKey, "label");
+  const value = extractField(item, valueKey, "value");
+  const disabled = extractField(item, disabledKey, "disabled");
+  const description = extractField(item, descriptionKey, "description");
+  const children = extractField(item, childrenKey, "children");
+  const option = {
+    ...item,
+    label,
+    value,
+    ...!isNullish(disabled) && { disabled },
+    ...!isNullish(description) && { description }
+  };
+  const optionWithPinyin = withPinyin$1 ? withPinyin(
+    option,
+    "label",
+    "description"
+  ) : option;
+  if (Array.isArray(children) && children.length > 0) {
+    optionWithPinyin.children = children.map((child) => transformDataItem(child, options, withPinyin$1));
+  }
+  return optionWithPinyin;
+}
+function transformData(data, options, withPinyin) {
+  if (!data || isEmpty(data)) {
+    return [];
+  }
+  if (withPinyin) {
+    return data.map((item) => transformDataItem(item, options, true));
+  }
+  return data.map((item) => transformDataItem(item, options, false));
+}
+function useDataOptionsQuery({
+  queryOptions,
+  dataDictKey,
+  labelKey,
+  valueKey,
+  disabledKey,
+  descriptionKey,
+  childrenKey,
+  withPinyin = false
+}) {
+  const isDataDictQuery = isString(dataDictKey) && dataDictKey.length > 0;
+  const queryResult = useQuery({
+    ...queryOptions,
+    queryFn: isDataDictQuery ? skipQueryToken : queryOptions?.queryFn
+  });
+  const dictQueryResult = useDataDictQuery({
+    dataDictKey
+  });
+  const mergedResult = isDataDictQuery ? dictQueryResult : queryResult;
+  const { data, ...result } = mergedResult;
+  const options = useMemo(
+    () => {
+      if (withPinyin) {
+        return transformData(
+          data,
+          {
+            labelKey,
+            valueKey,
+            disabledKey,
+            descriptionKey,
+            childrenKey
+          },
+          true
+        );
+      }
+      return transformData(
+        data,
+        {
+          labelKey,
+          valueKey,
+          disabledKey,
+          descriptionKey,
+          childrenKey
+        },
+        false
+      );
+    },
+    [
+      data,
+      labelKey,
+      valueKey,
+      disabledKey,
+      descriptionKey,
+      childrenKey,
+      withPinyin
+    ]
+  );
+  return { options, ...result };
+}
+
+export { useDataOptionsQuery };

package/dist/es/use-deep-callback/index.js

@@ -0,0 +1,9 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useCallback } from 'react';
+import { useDeepCompare } from '../use-deep-compare/index.js';
+
+function useDeepCallback(callback, dependencies) {
+  return useCallback(callback, useDeepCompare(dependencies));
+}
+
+export { useDeepCallback };

package/dist/es/use-deep-compare/index.js

@@ -0,0 +1,32 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { isDeepEqual } from '@vef-framework/shared';
+import { useRef } from 'react';
+
+function useDeepCompare(dependencies) {
+  const ref = useRef(void 0);
+  const signalRef = useRef(0);
+  if (!deepCompare(ref.current, dependencies)) {
+    ref.current = dependencies;
+    signalRef.current += 1;
+  }
+  return [signalRef.current];
+}
+function deepCompare(previous, current) {
+  if (!previous || !current) {
+    return false;
+  }
+  if (Object.is(previous, current)) {
+    return true;
+  }
+  if (previous.length !== current.length) {
+    return false;
+  }
+  for (const [index, element] of previous.entries()) {
+    if (!isDeepEqual(element, current[index])) {
+      return false;
+    }
+  }
+  return true;
+}
+
+export { useDeepCompare };

package/dist/es/use-deep-effect/index.js

@@ -0,0 +1,9 @@
+/*! @vef-framework/hooks v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:31.592Z */
+import { useEffect } from 'react';
+import { useDeepCompare } from '../use-deep-compare/index.js';
+
+function useDeepEffect(effect, dependencies) {
+  return useEffect(effect, useDeepCompare(dependencies));
+}
+
+export { useDeepEffect };