@vef-framework/hooks 1.0.62 → 1.0.64

package/es/index.js

@@ -1,3 +1,28 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, 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.64, build time: 2025-01-10T01:26:01.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 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.62, build time: 2025-01-09T07:31:10.207Z, 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.64, build time: 2025-01-10T01:26:01.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 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useAuthContext as r}from"@vef-framework/core";import{useMemo as e}from"react";function o(o){const{checkPermission:n}=r();return e((()=>o?.filter((r=>{const{permissions:e}=r;if(!e)return!0;return"any"===(r.checkMode??"any")?e.some((r=>n(r))):e.every((r=>n(r)))}))),[o,n])}export{o as useAuthorizedItems};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{defaultColorTypes as e,semanticColorTypes as r,capitalize as t}from"@vef-framework/shared";import{useMemo as o}from"react";import{useThemeTokens as n}from"./use-theme-tokens.js";function c(){const r=n();return o((()=>e.reduce(((e,t)=>(e.set(t,r[t]),e)),new Map)),[r])}function s(){const e=n();return o((()=>r.reduce(((r,o)=>(r.set(o,e[`color${t(o)}`]),r)),new Map)),[e])}function u(){const e=c(),r=s();return o((()=>new Map([...e,...r])),[e,r])}export{u as useColorTokens,c as useDefaultColorTokens,s as useSemanticColorTokens};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{isFunction as o,defaultMessageTitle as i}from"@vef-framework/shared";import{useMemo as n}from"react";function r(r,t){return n((()=>r.filter((i=>{const{show:n}=i;return o(n)?n(t):n??!0})).map((n=>{const{disabled:r,requireConfirmation:e,confirmationMode:a,confirmationTitle:m,confirmationContent:f,...c}=n,l={...c,disabled:o(r)?r(t):r??!1,requireConfirmation:o(e)?e(t):e??!1,confirmationMode:o(a)?a(t):a??"simple",confirmationTitle:o(m)?m(t):m??i,confirmationContent:o(f)?f(t):f??`确定要${c.label}吗？`};return l.requireConfirmation&&!l.confirmationMode&&(l.confirmationMode="simple"),l.requireConfirmation&&!l.confirmationTitle&&(l.confirmationTitle=i),l.requireConfirmation&&!l.confirmationContent&&(l.confirmationContent=`确定要${l.label}吗？`),l}))),[r,t])}export{r as useComputedActionButtons};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useDataQuery as e}from"./use-data-query.js";import{useFallbackOptions as i}from"./use-fallback-options.js";import{useNormalizedDataOptions as a}from"./use-normalized-options.js";import{useRemoteFilter as l}from"./use-remote-filter.js";function o({labelField:o,valueField:s,descriptionField:t,childrenField:d,disabledField:r,defaultToFirst:n,filterable:p=!1,filterFromRemote:u=!1,keywordKey:c="keyword",valuesKey:f="ids",fallbackOptionsApi:m,fallbackOptionsApiParams:F,resolveFallbackOptions:b,isGrouped:O=!1,selectedOptionValues:k,apiParams:y,...v}){const[g,P]=l(p&&u,y,c),{data:j,isLoading:A}=e({apiParams:g,...v}),[K,L,h]=a(j??[],{labelField:o,valueField:s,descriptionField:t,childrenField:d,disabledField:r,defaultToFirst:n},{isGrouped:O,parsePinyin:p&&!u,selectedOptionValues:k}),{data:w,isLoading:z}=i(L,{fallbackOptionsApi:m??v.api,fallbackOptionsApiParams:F,valuesKey:f,resolveFallbackOptions:b});return{onFilterKeywordChange:P,isLoading:A,normalizedOptions:K,defaultOption:h,fallbackOptions:w,isFallbackOptionsLoading:z}}export{o as useComputedOptions};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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({
+  labelField,
+  valueField,
+  descriptionField,
+  childrenField,
+  disabledField,
+  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 ?? [],
+    {
+      labelField,
+      valueField,
+      descriptionField,
+      childrenField,
+      disabledField,
+      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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{createContext as r,useContext as o}from"react";const t=r(!1);function n(){return o(t)}const c=t.Provider;export{c as DisabledContextProvider,n as useContextDisabled};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, 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 o({onFetched:o,...s}){const{useApiQuery:p,stubQueryApi:c,dataDictionaryApi:n}=e(),[u,m,l]=function({data:e,dataDictionaryKey:t,api:r,apiParams:o,apiEnabled:s,staleTime:p,keepPreviousData:c,placeholderData:n},u,m){return i((()=>a(e)?a(t)?a(r)?[u,[],{keepPreviousData:!0,initialData:[]}]:[r,o,{enabled:s??!0,staleTime:p,keepPreviousData:c,placeholderData:n}]:[m,{...o,key:t},{enabled:s??!0,staleTime:p,keepPreviousData:c,placeholderData:n}]:[u,e,{keepPreviousData:!0,initialData:e}]),[e,t,r,u,m,o,s,p,c,n])}(s,c,n),d=p(u,m,l);r((()=>{Object.is(u,c)&&c.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{o as useDataQuery};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useCallback as o}from"react";import{useDeepMemo as r}from"./use-deep-memo.js";function e(e,t){const m=r((()=>t),t);return o(e,m)}export{e as useDeepCallback};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{isDeepEqual as r}from"@vef-framework/shared";import{useRef as e,useMemo as t}from"react";function n(n,o){const c=e(),u=e(0);var f,m;return void 0!==c.current&&(f=o,m=c.current,f.length===m.length&&f.every(((e,t)=>r(e,m[t]))))||(u.current+=1),c.current=o,t(n,[u.current])}export{n as useDeepMemo};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{isDeepEqual as r}from"@vef-framework/shared";import{useRef as t}from"react";function e(e){const n=t();return t=>{const o=e(t);return r(n.current,o)?n.current:n.current=o}}export{e as useDeepSelector};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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,100 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, 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 i,useMemo as o}from"react";function s(s,{fallbackOptionsApi:t,fallbackOptionsApiParams:p,valuesKey:l,resolveFallbackOptions:n}){const{useApiQuery:u,stubQueryApi:c,asyncFnQueryApi:f}=e(),[k,m,v]=function(e,{fallbackOptionsApi:r,fallbackOptionsApiParams:s,valuesKey:t,resolveFallbackOptions:p},l,n){const u=i();return o((()=>{if(a(p))return[n,{key:u,args:[e],fn:p},{keepPreviousData:!0}];if(r){const a={...s,[t??"ids"]:e};return[r,a,{keepPreviousData:!0}]}return[l,[],{keepPreviousData:!0,initialData:[]}]}),[p,r,l,u,e,n,s,t])}(s,{fallbackOptionsApi:t,fallbackOptionsApiParams:p,valuesKey:l,resolveFallbackOptions:n},c,f),b=u(k,m,v);return r((()=>{Object.is(k,c)&&c.removeQueries(m),Object.is(k,f)&&f.removeQueries(m)})),b}export{s as useFallbackOptions};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+import { useApiContext } from '@vef-framework/core';
+import { isFunction } from '@vef-framework/shared';
+import { useUnmount } from 'ahooks';
+import { useId, useMemo } from 'react';
+
+function useApi(missingOptionValues, {
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  valuesKey,
+  resolveFallbackOptions
+}, stubQueryApi, asyncFnQueryApi) {
+  const uniqueId = useId();
+  return useMemo(() => {
+    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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useCallback as d}from"react";import{useThemeTokens as n}from"./use-theme-tokens.js";function e(){const{paddingXS:e,paddingSM:i,padding:t,paddingMD:r,paddingLG:a}=n();return d((d=>"tiny"===d?e:"small"===d?i:"medium"===d?t:"large"===d?r:"huge"===d?a:d),[e,i,t,r,a])}export{e as useGapSizeNormalizer};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useGapSizeNormalizer as r}from"./use-gap-size-normalizer.js";function e(e){return r()(e)}export{e as useNormalizedGapSize};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-import{useMemo as e}from"react";function l(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(l)}:"group"===e.type?{type:"group",key:e.key,label:e.label,children:e.children.map(l)}:{type:"divider",key:e.key}}function i(i){return e((()=>i.map(l)),[i])}export{l as normalizeMenuItem,i as useNormalizedMenuItems};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, 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 */