@vef-framework/hooks 1.0.97 → 1.0.99

package/es/index.js

@@ -1,3 +1,28 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import"./lib.js";export{useAuthorizedItems}from"./use-authorized-items.js";export{useColorTokens,useDefaultColorTokens,useSemanticColorTokens}from"./use-color-tokens.js";export{useComputedActionButtons}from"./use-computed-action-buttons.js";export{useComputedOptions}from"./use-computed-options.js";export{DisabledContextProvider,useContextDisabled}from"./use-context-disabled.js";export{useDataQuery}from"./use-data-query.js";export{useDeepCallback}from"./use-deep-callback.js";export{useDeepMemo}from"./use-deep-memo.js";export{useDeepSelector}from"./use-deep-selector.js";export{useFallbackOptions}from"./use-fallback-options.js";export{useGapSizeNormalizer}from"./use-gap-size-normalizer.js";export{useNormalizedGapSize}from"./use-normalized-gap-size.js";export{normalizeMenuItem,useNormalizedMenuItems}from"./use-normalized-menu-items.js";export{useNormalizedDataOptions}from"./use-normalized-options.js";export{useOptionFilter}from"./use-option-filter.js";export{useRemoteFilter}from"./use-remote-filter.js";export{useShallowCallback}from"./use-shallow-callback.js";export{useShallowMemo}from"./use-shallow-memo.js";export{useShallowSelector}from"./use-shallow-selector.js";export{useSingleton}from"./use-singleton.js";export{useThemeTokens}from"./use-theme-tokens.js";export{useTransientStore}from"./use-transient-store.js";export{useWindowSize}from"./use-window-size.js";export{useClickAway,useMeasure}from"@uidotdev/usehooks";export{useDeepCompareEffect as useDeepEffect,useDeepCompareLayoutEffect as useDeepLayoutEffect,useSize as useElementSize,useEventListener,useKeyPress,useMount,useUnmount,useUpdateEffect,useUpdateLayoutEffect,useUpdate as useUpdater}from"ahooks";
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import './lib.js';
+export { useAuthorizedItems } from './use-authorized-items.js';
+export { useColorTokens, useDefaultColorTokens, useSemanticColorTokens } from './use-color-tokens.js';
+export { useComputedActionButtons } from './use-computed-action-buttons.js';
+export { useComputedOptions } from './use-computed-options.js';
+export { DisabledContextProvider, useContextDisabled } from './use-context-disabled.js';
+export { useDataQuery } from './use-data-query.js';
+export { useDeepCallback } from './use-deep-callback.js';
+export { useDeepMemo } from './use-deep-memo.js';
+export { useDeepSelector } from './use-deep-selector.js';
+export { useFallbackOptions } from './use-fallback-options.js';
+export { useGapSizeNormalizer } from './use-gap-size-normalizer.js';
+export { useNormalizedGapSize } from './use-normalized-gap-size.js';
+export { normalizeMenuItem, useNormalizedMenuItems } from './use-normalized-menu-items.js';
+export { useNormalizedDataOptions } from './use-normalized-options.js';
+export { useOptionFilter } from './use-option-filter.js';
+export { useRemoteFilter } from './use-remote-filter.js';
+export { useShallowCallback } from './use-shallow-callback.js';
+export { useShallowMemo } from './use-shallow-memo.js';
+export { useShallowSelector } from './use-shallow-selector.js';
+export { useSingleton } from './use-singleton.js';
+export { useThemeTokens } from './use-theme-tokens.js';
+export { useTransientStore } from './use-transient-store.js';
+export { useWindowSize } from './use-window-size.js';
+export { useClickAway, useMeasure } from '@uidotdev/usehooks';
+export { useDeepCompareEffect as useDeepEffect, useDeepCompareLayoutEffect as useDeepLayoutEffect, useSize as useElementSize, useEventListener, useKeyPress, useMount, useUnmount, useUpdateEffect, useUpdateLayoutEffect, useUpdate as useUpdater } from 'ahooks';
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/lib.js

@@ -1,3 +1,4 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-export{useClickAway,useMeasure}from"@uidotdev/usehooks";export{useDeepCompareEffect as useDeepEffect,useDeepCompareLayoutEffect as useDeepLayoutEffect,useSize as useElementSize,useEventListener,useKeyPress,useMount,useUnmount,useUpdateEffect,useUpdateLayoutEffect,useUpdate as useUpdater}from"ahooks";
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+export { useClickAway, useMeasure } from '@uidotdev/usehooks';
+export { useDeepCompareEffect as useDeepEffect, useDeepCompareLayoutEffect as useDeepLayoutEffect, useSize as useElementSize, useEventListener, useKeyPress, useMount, useUnmount, useUpdateEffect, useUpdateLayoutEffect, useUpdate as useUpdater } from 'ahooks';
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-authorized-items.js

@@ -1,3 +1,24 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useAuthContext as e}from"@vef-framework/core";import{useMemo as r}from"react";function useAuthorizedItems(o){const{checkPermission:t}=e();return r((()=>o?.filter((e=>{const{permissions:r}=e;if(!r)return!0;return"any"===(e.checkMode??"any")?r.some((e=>t(e))):r.every((e=>t(e)))}))),[o,t])}export{useAuthorizedItems};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useAuthContext } from '@vef-framework/core';
+import { useMemo } from 'react';
+
+function useAuthorizedItems(items) {
+  const { checkPermission } = useAuthContext();
+  return useMemo(
+    () => items?.filter((item) => {
+      const { permissions } = item;
+      if (!permissions) {
+        return true;
+      }
+      const checkMode = item.checkMode ?? "any";
+      if (checkMode === "any") {
+        return permissions.some((permission) => checkPermission(permission));
+      }
+      return permissions.every((permission) => checkPermission(permission));
+    }),
+    [items, checkPermission]
+  );
+}
+
+export { useAuthorizedItems };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-color-tokens.js

@@ -1,3 +1,30 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{defaultColorTypes as e,semanticColorTypes as o,capitalize as r}from"@vef-framework/shared";import{useMemo as n}from"react";import{useThemeTokens as s}from"./use-theme-tokens.js";function useDefaultColorTokens(){const o=s();return n((()=>e.reduce(((e,r)=>(e.set(r,o[r]),e)),new Map)),[o])}function useSemanticColorTokens(){const e=s();return n((()=>o.reduce(((o,n)=>(o.set(n,e[`color${r(n)}`]),o)),new Map)),[e])}function useColorTokens(){const e=useDefaultColorTokens(),o=useSemanticColorTokens();return n((()=>new Map([...e,...o])),[e,o])}export{useColorTokens,useDefaultColorTokens,useSemanticColorTokens};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { defaultColorTypes, semanticColorTypes, capitalize } from '@vef-framework/shared';
+import { useMemo } from 'react';
+import { useThemeTokens } from './use-theme-tokens.js';
+
+function useDefaultColorTokens() {
+  const tokens = useThemeTokens();
+  return useMemo(() => defaultColorTypes.reduce(
+    (map, color) => {
+      map.set(color, tokens[color]);
+      return map;
+    },
+    /* @__PURE__ */ new Map()
+  ), [tokens]);
+}
+function useSemanticColorTokens() {
+  const tokens = useThemeTokens();
+  return useMemo(() => semanticColorTypes.reduce((map, color) => {
+    map.set(color, tokens[`color${capitalize(color)}`]);
+    return map;
+  }, /* @__PURE__ */ new Map()), [tokens]);
+}
+function useColorTokens() {
+  const defaultColorTokens = useDefaultColorTokens();
+  const semanticColorTokens = useSemanticColorTokens();
+  return useMemo(() => new Map([...defaultColorTokens, ...semanticColorTokens]), [defaultColorTokens, semanticColorTokens]);
+}
+
+export { useColorTokens, useDefaultColorTokens, useSemanticColorTokens };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-computed-action-buttons.js

@@ -1,3 +1,43 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{isFunction as o,defaultMessageTitle as i}from"@vef-framework/shared";import{useMemo as n}from"react";function useComputedActionButtons(t,r){return n((()=>t.filter((i=>{const{show:n}=i;return o(n)?n(r):n??!0})).map((n=>{const{disabled:t,requireConfirmation:e,confirmationMode:m,confirmationTitle:a,confirmationContent:f,...c}=n,u={...c,disabled:o(t)?t(r):t??!1,requireConfirmation:o(e)?e(r):e??!1,confirmationMode:o(m)?m(r):m??"simple",confirmationTitle:o(a)?a(r):a??i,confirmationContent:o(f)?f(r):f??`确定要${c.label}吗？`};return u.requireConfirmation&&!u.confirmationMode&&(u.confirmationMode="simple"),u.requireConfirmation&&!u.confirmationTitle&&(u.confirmationTitle=i),u.requireConfirmation&&!u.confirmationContent&&(u.confirmationContent=`确定要${u.label}吗？`),u}))),[t,r])}export{useComputedActionButtons};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { isFunction, defaultMessageTitle } from '@vef-framework/shared';
+import { useMemo } from 'react';
+
+function useComputedActionButtons(buttons, context) {
+  return useMemo(() => buttons.filter((button) => {
+    const { show } = button;
+    if (isFunction(show)) {
+      return show(context);
+    }
+    return show ?? true;
+  }).map((button) => {
+    const {
+      disabled,
+      requireConfirmation,
+      confirmationMode,
+      confirmationTitle,
+      confirmationContent,
+      ...rest
+    } = button;
+    const computedButton = {
+      ...rest,
+      disabled: isFunction(disabled) ? disabled(context) : disabled ?? false,
+      requireConfirmation: isFunction(requireConfirmation) ? requireConfirmation(context) : requireConfirmation ?? false,
+      confirmationMode: isFunction(confirmationMode) ? confirmationMode(context) : confirmationMode ?? "simple",
+      confirmationTitle: isFunction(confirmationTitle) ? confirmationTitle(context) : confirmationTitle ?? defaultMessageTitle,
+      confirmationContent: isFunction(confirmationContent) ? confirmationContent(context) : confirmationContent ?? `\u786E\u5B9A\u8981${rest.label}\u5417\uFF1F`
+    };
+    if (computedButton.requireConfirmation && !computedButton.confirmationMode) {
+      computedButton.confirmationMode = "simple";
+    }
+    if (computedButton.requireConfirmation && !computedButton.confirmationTitle) {
+      computedButton.confirmationTitle = defaultMessageTitle;
+    }
+    if (computedButton.requireConfirmation && !computedButton.confirmationContent) {
+      computedButton.confirmationContent = `\u786E\u5B9A\u8981${computedButton.label}\u5417\uFF1F`;
+    }
+    return computedButton;
+  }), [buttons, context]);
+}
+
+export { useComputedActionButtons };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-computed-options.js

@@ -1,3 +1,67 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useDataQuery as e}from"./use-data-query.js";import{useFallbackOptions as a}from"./use-fallback-options.js";import{useNormalizedDataOptions as i}from"./use-normalized-options.js";import{useRemoteFilter as o}from"./use-remote-filter.js";function useComputedOptions({labelKey:s,valueKey:l,descriptionKey:t,childrenKey:r,disabledKey:p,defaultToFirst:n,filterable:d=!1,filterFromRemote:u=!1,keywordKey:m="keyword",valuesKey:y="ids",fallbackOptionsApi:c,fallbackOptionsApiParams:f,resolveFallbackOptions:b,isGrouped:K=!1,selectedOptionValues:O,apiParams:k,...F}){const[v,g]=o(d&&u,k,m),{data:P,isLoading:j}=e({apiParams:v,...F}),[A,L,h]=i(P??[],{labelKey:s,valueKey:l,descriptionKey:t,childrenKey:r,disabledKey:p,defaultToFirst:n},{isGrouped:K,parsePinyin:d&&!u,selectedOptionValues:O}),{data:w,isLoading:C}=a(L,{fallbackOptionsApi:c??F.api,fallbackOptionsApiParams:f,valuesKey:y,resolveFallbackOptions:b});return{onFilterKeywordChange:g,isLoading:j,normalizedOptions:A,defaultOption:h,fallbackOptions:w,isFallbackOptionsLoading:C}}export{useComputedOptions};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useDataQuery } from './use-data-query.js';
+import { useFallbackOptions } from './use-fallback-options.js';
+import { useNormalizedDataOptions } from './use-normalized-options.js';
+import { useRemoteFilter } from './use-remote-filter.js';
+
+function useComputedOptions({
+  labelKey,
+  valueKey,
+  descriptionKey,
+  childrenKey,
+  disabledKey,
+  defaultToFirst,
+  filterable = false,
+  filterFromRemote = false,
+  keywordKey = "keyword",
+  valuesKey = "ids",
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  resolveFallbackOptions,
+  isGrouped = false,
+  selectedOptionValues,
+  apiParams,
+  ...queryConfig
+}) {
+  const [mergedApiParams, onFilterKeywordChange] = useRemoteFilter(filterable && filterFromRemote, apiParams, keywordKey);
+  const { data: options, isLoading } = useDataQuery({
+    apiParams: mergedApiParams,
+    ...queryConfig
+  });
+  const [normalizedOptions, missingOptionValues, defaultOption] = useNormalizedDataOptions(
+    options ?? [],
+    {
+      labelKey,
+      valueKey,
+      descriptionKey,
+      childrenKey,
+      disabledKey,
+      defaultToFirst
+    },
+    {
+      isGrouped,
+      parsePinyin: filterable && !filterFromRemote,
+      selectedOptionValues
+    }
+  );
+  const { data: fallbackOptions, isLoading: isFallbackOptionsLoading } = useFallbackOptions(
+    missingOptionValues,
+    {
+      fallbackOptionsApi: fallbackOptionsApi ?? queryConfig.api,
+      fallbackOptionsApiParams,
+      valuesKey,
+      resolveFallbackOptions
+    }
+  );
+  return {
+    onFilterKeywordChange,
+    isLoading,
+    normalizedOptions,
+    defaultOption,
+    fallbackOptions,
+    isFallbackOptionsLoading
+  };
+}
+
+export { useComputedOptions };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-context-disabled.js

@@ -1,3 +1,11 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{createContext as t,useContext as e}from"react";const o=t(!1);function useContextDisabled(){return e(o)}const r=o.Provider;export{r as DisabledContextProvider,useContextDisabled};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { createContext, useContext } from 'react';
+
+const DisabledContext = createContext(false);
+function useContextDisabled() {
+  return useContext(DisabledContext);
+}
+const DisabledContextProvider = DisabledContext.Provider;
+
+export { DisabledContextProvider, useContextDisabled };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-data-query.js

@@ -1,3 +1,108 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useApiContext as e}from"@vef-framework/core";import{isNullish as a,isFunction as t}from"@vef-framework/shared";import{useUnmount as r}from"ahooks";import{useMemo as i}from"react";function useDataQuery({onFetched:o,...s}){const{useApiQuery:u,stubQueryApi:p,dataDictionaryApi:c}=e(),[n,m,l]=function useApi({data:e,dataDictionaryKey:t,api:r,apiParams:o,apiEnabled:s,staleTime:u,keepPreviousData:p,placeholderData:c},n,m){return i((()=>a(e)?a(t)?a(r)?[n,[],{keepPreviousData:!0,initialData:[]}]:[r,o,{enabled:s??!0,staleTime:u,keepPreviousData:p,placeholderData:c}]:[m,{...o,key:t},{enabled:s??!0,staleTime:u,keepPreviousData:p,placeholderData:c}]:[n,e,{keepPreviousData:!0,initialData:e}]),[e,t,r,n,m,o,s,u,p,c])}(s,p,c),D=u(n,m,l);r((()=>{Object.is(n,p)&&p.removeQueries(m)}));const{isSuccess:d,data:f,...k}=D,v=i((()=>d&&t(o)?o(f):f),[d,f,o]);return{...k,isSuccess:d,data:v}}export{useDataQuery};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useApiContext } from '@vef-framework/core';
+import { isNullish, isFunction } from '@vef-framework/shared';
+import { useUnmount } from 'ahooks';
+import { useMemo } from 'react';
+
+function useApi({
+  data,
+  dataDictionaryKey,
+  api,
+  apiParams,
+  apiEnabled,
+  staleTime,
+  keepPreviousData,
+  placeholderData
+}, stubQueryApi, dataDictionaryApi) {
+  return useMemo(() => {
+    if (!isNullish(data)) {
+      return [
+        stubQueryApi,
+        data,
+        {
+          keepPreviousData: true,
+          initialData: data
+        }
+      ];
+    }
+    if (!isNullish(dataDictionaryKey)) {
+      return [
+        dataDictionaryApi,
+        {
+          ...apiParams,
+          key: dataDictionaryKey
+        },
+        {
+          enabled: apiEnabled ?? true,
+          staleTime,
+          keepPreviousData,
+          placeholderData
+        }
+      ];
+    }
+    if (!isNullish(api)) {
+      return [
+        api,
+        apiParams,
+        {
+          enabled: apiEnabled ?? true,
+          staleTime,
+          keepPreviousData,
+          placeholderData
+        }
+      ];
+    }
+    return [
+      stubQueryApi,
+      [],
+      {
+        keepPreviousData: true,
+        initialData: []
+      }
+    ];
+  }, [
+    data,
+    dataDictionaryKey,
+    api,
+    stubQueryApi,
+    dataDictionaryApi,
+    apiParams,
+    apiEnabled,
+    staleTime,
+    keepPreviousData,
+    placeholderData
+  ]);
+}
+function useDataQuery({ onFetched, ...config }) {
+  const {
+    useApiQuery,
+    stubQueryApi,
+    dataDictionaryApi: dataDictionaryQueryApi
+  } = useApiContext();
+  const [api, args, options] = useApi(config, stubQueryApi, dataDictionaryQueryApi);
+  const result = useApiQuery(api, args, options);
+  useUnmount(() => {
+    if (Object.is(api, stubQueryApi)) {
+      stubQueryApi.removeQueries(args);
+    }
+  });
+  const {
+    isSuccess,
+    data: rawData,
+    ...rest
+  } = result;
+  const data = useMemo(() => {
+    if (isSuccess && isFunction(onFetched)) {
+      return onFetched(rawData);
+    }
+    return rawData;
+  }, [isSuccess, rawData, onFetched]);
+  return {
+    ...rest,
+    isSuccess,
+    data
+  };
+}
+
+export { useDataQuery };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-deep-callback.js

@@ -1,3 +1,11 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useCallback as e}from"react";import{useDeepMemo as o}from"./use-deep-memo.js";function useDeepCallback(r,t){const m=o((()=>t),t);return e(r,m)}export{useDeepCallback};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useCallback } from 'react';
+import { useDeepMemo } from './use-deep-memo.js';
+
+function useDeepCallback(callback, dependencies) {
+  const memoizedDependencies = useDeepMemo(() => dependencies, dependencies);
+  return useCallback(callback, memoizedDependencies);
+}
+
+export { useDeepCallback };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-deep-memo.js

@@ -1,3 +1,19 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{isDeepEqual as e}from"@vef-framework/shared";import{useRef as r,useMemo as t}from"react";function useDeepMemo(n,o){const u=r(),c=r(0);return void 0!==u.current&&function isEqual(r,t){return r.length===t.length&&r.every(((r,n)=>e(r,t[n])))}(o,u.current)||(c.current+=1),u.current=o,t(n,[c.current])}export{useDeepMemo};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { isDeepEqual } from '@vef-framework/shared';
+import { useRef, useMemo } from 'react';
+
+function useDeepMemo(factory, dependencies) {
+  const lastDependencies = useRef();
+  const signal = useRef(0);
+  if (lastDependencies.current === void 0 || !isEqual(dependencies, lastDependencies.current)) {
+    signal.current += 1;
+  }
+  lastDependencies.current = dependencies;
+  return useMemo(factory, [signal.current]);
+}
+function isEqual(one, another) {
+  return one.length === another.length && one.every((value, index) => isDeepEqual(value, another[index]));
+}
+
+export { useDeepMemo };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-deep-selector.js

@@ -1,3 +1,14 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{isDeepEqual as r}from"@vef-framework/shared";import{useRef as e}from"react";function useDeepSelector(t){const o=e();return e=>{const c=t(e);return r(o.current,c)?o.current:o.current=c}}export{useDeepSelector};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { isDeepEqual } from '@vef-framework/shared';
+import { useRef } from 'react';
+
+function useDeepSelector(selector) {
+  const prevSelectedState = useRef();
+  return (state) => {
+    const nextSelectedState = selector(state);
+    return isDeepEqual(prevSelectedState.current, nextSelectedState) ? prevSelectedState.current : prevSelectedState.current = nextSelectedState;
+  };
+}
+
+export { useDeepSelector };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-fallback-options.js

@@ -1,3 +1,103 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useApiContext as e}from"@vef-framework/core";import{isFunction as a}from"@vef-framework/shared";import{useUnmount as r}from"ahooks";import{useId as s}from"react";import{useShallowMemo as i}from"./use-shallow-memo.js";function useFallbackOptions(o,{fallbackOptionsApi:t,fallbackOptionsApiParams:l,valuesKey:p,resolveFallbackOptions:n}){const{useApiQuery:u,stubQueryApi:c,asyncFnQueryApi:f}=e(),[m,k,b]=function useApi(e,{fallbackOptionsApi:r,fallbackOptionsApiParams:o,valuesKey:t,resolveFallbackOptions:l},p,n){const u=s();return i((()=>{if(e.length>0){if(a(l))return[n,{key:u,args:[e],fn:l},{keepPreviousData:!0}];if(r){const a={...o,[t??"ids"]:e};return[r,a,{keepPreviousData:!0}]}}return[p,[],{keepPreviousData:!0,initialData:[]}]}),[l,r,p,u,e,n,o,t])}(o,{fallbackOptionsApi:t,fallbackOptionsApiParams:l,valuesKey:p,resolveFallbackOptions:n},c,f),v=u(m,k,b);return r((()=>{Object.is(m,c)&&c.removeQueries(k),Object.is(m,f)&&f.removeQueries(k)})),v}export{useFallbackOptions};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useApiContext } from '@vef-framework/core';
+import { isFunction } from '@vef-framework/shared';
+import { useUnmount } from 'ahooks';
+import { useId } from 'react';
+import { useShallowMemo } from './use-shallow-memo.js';
+
+function useApi(missingOptionValues, {
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  valuesKey,
+  resolveFallbackOptions
+}, stubQueryApi, asyncFnQueryApi) {
+  const uniqueId = useId();
+  return useShallowMemo(() => {
+    if (missingOptionValues.length > 0) {
+      if (isFunction(resolveFallbackOptions)) {
+        const params = {
+          key: uniqueId,
+          args: [missingOptionValues],
+          fn: resolveFallbackOptions
+        };
+        return [
+          asyncFnQueryApi,
+          params,
+          {
+            keepPreviousData: true
+          }
+        ];
+      }
+      if (fallbackOptionsApi) {
+        const params = {
+          ...fallbackOptionsApiParams,
+          [valuesKey ?? "ids"]: missingOptionValues
+        };
+        return [
+          fallbackOptionsApi,
+          params,
+          {
+            keepPreviousData: true
+          }
+        ];
+      }
+    }
+    return [
+      stubQueryApi,
+      [],
+      {
+        keepPreviousData: true,
+        initialData: []
+      }
+    ];
+  }, [
+    resolveFallbackOptions,
+    fallbackOptionsApi,
+    stubQueryApi,
+    uniqueId,
+    missingOptionValues,
+    asyncFnQueryApi,
+    fallbackOptionsApiParams,
+    valuesKey
+  ]);
+}
+function useFallbackOptions(missingOptionValues, {
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  valuesKey,
+  resolveFallbackOptions
+}) {
+  const {
+    useApiQuery,
+    stubQueryApi,
+    asyncFnQueryApi
+  } = useApiContext();
+  const [
+    api,
+    params,
+    options
+  ] = useApi(
+    missingOptionValues,
+    {
+      fallbackOptionsApi,
+      fallbackOptionsApiParams,
+      valuesKey,
+      resolveFallbackOptions
+    },
+    stubQueryApi,
+    asyncFnQueryApi
+  );
+  const result = useApiQuery(api, params, options);
+  useUnmount(() => {
+    if (Object.is(api, stubQueryApi)) {
+      stubQueryApi.removeQueries(params);
+    }
+    if (Object.is(api, asyncFnQueryApi)) {
+      asyncFnQueryApi.removeQueries(params);
+    }
+  });
+  return result;
+}
+
+export { useFallbackOptions };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-gap-size-normalizer.js

@@ -1,3 +1,36 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useCallback as e}from"react";import{useThemeTokens as i}from"./use-theme-tokens.js";function useGapSizeNormalizer(){const{paddingXS:r,paddingSM:a,padding:d,paddingMD:n,paddingLG:m}=i();return e((e=>"tiny"===e?r:"small"===e?a:"medium"===e?d:"large"===e?n:"huge"===e?m:e),[r,a,d,n,m])}export{useGapSizeNormalizer};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useCallback } from 'react';
+import { useThemeTokens } from './use-theme-tokens.js';
+
+function useGapSizeNormalizer() {
+  const {
+    paddingXS,
+    paddingSM,
+    padding,
+    paddingMD,
+    paddingLG
+  } = useThemeTokens();
+  return useCallback((gap) => {
+    if (gap === "tiny") {
+      return paddingXS;
+    } else if (gap === "small") {
+      return paddingSM;
+    } else if (gap === "medium") {
+      return padding;
+    } else if (gap === "large") {
+      return paddingMD;
+    } else if (gap === "huge") {
+      return paddingLG;
+    }
+    return gap;
+  }, [
+    paddingXS,
+    paddingSM,
+    padding,
+    paddingMD,
+    paddingLG
+  ]);
+}
+
+export { useGapSizeNormalizer };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-normalized-gap-size.js

@@ -1,3 +1,10 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useGapSizeNormalizer as e}from"./use-gap-size-normalizer.js";function useNormalizedGapSize(r){return e()(r)}export{useNormalizedGapSize};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useGapSizeNormalizer } from './use-gap-size-normalizer.js';
+
+function useNormalizedGapSize(gap) {
+  const normalize = useGapSizeNormalizer();
+  return normalize(gap);
+}
+
+export { useNormalizedGapSize };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/es/use-normalized-menu-items.js

@@ -1,3 +1,45 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.309Z, made by Venus. */
-import{useMemo as e}from"react";function normalizeMenuItem(e){return"item"===e.type?{type:"item",key:e.key,label:e.label,disabled:e.disabled,icon:e.icon,extra:e.extra}:"submenu"===e.type?{type:"submenu",key:e.key,label:e.label,disabled:e.disabled,icon:e.icon,children:e.children.map(normalizeMenuItem)}:"group"===e.type?{type:"group",key:e.key,label:e.label,children:e.children.map(normalizeMenuItem)}:{type:"divider",key:e.key}}function useNormalizedMenuItems(n){return e((()=>n.map(normalizeMenuItem)),[n])}export{normalizeMenuItem,useNormalizedMenuItems};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.433Z, made by Venus. */
+import { useMemo } from 'react';
+
+function normalizeMenuItem(item) {
+  if (item.type === "item") {
+    return {
+      type: "item",
+      key: item.key,
+      label: item.label,
+      disabled: item.disabled,
+      icon: item.icon,
+      extra: item.extra
+    };
+  } else if (item.type === "submenu") {
+    return {
+      type: "submenu",
+      key: item.key,
+      label: item.label,
+      disabled: item.disabled,
+      icon: item.icon,
+      children: item.children.map(normalizeMenuItem)
+    };
+  } else if (item.type === "group") {
+    return {
+      type: "group",
+      key: item.key,
+      label: item.label,
+      children: item.children.map(normalizeMenuItem)
+    };
+  } else {
+    return {
+      type: "divider",
+      key: item.key
+    };
+  }
+}
+function useNormalizedMenuItems(items) {
+  return useMemo(
+    () => items.map(normalizeMenuItem),
+    [items]
+  );
+}
+
+export { normalizeMenuItem, useNormalizedMenuItems };
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */