@vef-framework/hooks 1.0.62 → 1.0.64

package/lib/use-computed-options.cjs

@@ -1,3 +1,71 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./use-data-query.cjs"),i=require("./use-fallback-options.cjs"),a=require("./use-normalized-options.cjs"),l=require("./use-remote-filter.cjs");exports.useComputedOptions=function({labelField:s,valueField:o,descriptionField:t,childrenField:r,disabledField:d,defaultToFirst:n,filterable:p=!1,filterFromRemote:u=!1,keywordKey:c="keyword",valuesKey:F="ids",fallbackOptionsApi:b,fallbackOptionsApiParams:O,resolveFallbackOptions:f,isGrouped:m=!1,selectedOptionValues:k,apiParams:y,...g}){const[v,P]=l.useRemoteFilter(p&&u,y,c),{data:j,isLoading:q}=e.useDataQuery({apiParams:v,...g}),[A,K,L]=a.useNormalizedDataOptions(j??[],{labelField:s,valueField:o,descriptionField:t,childrenField:r,disabledField:d,defaultToFirst:n},{isGrouped:m,parsePinyin:p&&!u,selectedOptionValues:k}),{data:h,isLoading:w}=i.useFallbackOptions(K,{fallbackOptionsApi:b??g.api,fallbackOptionsApiParams:O,valuesKey:F,resolveFallbackOptions:f});return{onFilterKeywordChange:P,isLoading:q,normalizedOptions:A,defaultOption:L,fallbackOptions:h,isFallbackOptionsLoading:w}};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const useDataQuery = require('./use-data-query.cjs');
+const useFallbackOptions = require('./use-fallback-options.cjs');
+const useNormalizedOptions = require('./use-normalized-options.cjs');
+const useRemoteFilter = require('./use-remote-filter.cjs');
+
+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.useRemoteFilter(filterable && filterFromRemote, apiParams, keywordKey);
+  const { data: options, isLoading } = useDataQuery.useDataQuery({
+    apiParams: mergedApiParams,
+    ...queryConfig
+  });
+  const [normalizedOptions, missingOptionValues, defaultOption] = useNormalizedOptions.useNormalizedDataOptions(
+    options ?? [],
+    {
+      labelField,
+      valueField,
+      descriptionField,
+      childrenField,
+      disabledField,
+      defaultToFirst
+    },
+    {
+      isGrouped,
+      parsePinyin: filterable && !filterFromRemote,
+      selectedOptionValues
+    }
+  );
+  const { data: fallbackOptions, isLoading: isFallbackOptionsLoading } = useFallbackOptions.useFallbackOptions(
+    missingOptionValues,
+    {
+      fallbackOptionsApi: fallbackOptionsApi ?? queryConfig.api,
+      fallbackOptionsApiParams,
+      valuesKey,
+      resolveFallbackOptions
+    }
+  );
+  return {
+    onFilterKeywordChange,
+    isLoading,
+    normalizedOptions,
+    defaultOption,
+    fallbackOptions,
+    isFallbackOptionsLoading
+  };
+}
+
+exports.useComputedOptions = 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/lib/use-context-disabled.cjs

@@ -1,3 +1,16 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),t=e.createContext(!1);const r=t.Provider;exports.DisabledContextProvider=r,exports.useContextDisabled=function(){return e.useContext(t)};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+
+const DisabledContext = react.createContext(false);
+function useContextDisabled() {
+  return react.useContext(DisabledContext);
+}
+const DisabledContextProvider = DisabledContext.Provider;
+
+exports.DisabledContextProvider = DisabledContextProvider;
+exports.useContextDisabled = 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/lib/use-data-query.cjs

@@ -1,3 +1,112 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/core"),a=require("@vef-framework/shared"),i=require("ahooks"),t=require("react");exports.useDataQuery=function({onFetched:r,...s}){const{useApiQuery:u,stubQueryApi:o,dataDictionaryApi:n}=e.useApiContext(),[l,c,p]=function({data:e,dataDictionaryKey:i,api:r,apiParams:s,apiEnabled:u,staleTime:o,keepPreviousData:n,placeholderData:l},c,p){return t.useMemo((()=>a.isNullish(e)?a.isNullish(i)?a.isNullish(r)?[c,[],{keepPreviousData:!0,initialData:[]}]:[r,s,{enabled:u??!0,staleTime:o,keepPreviousData:n,placeholderData:l}]:[p,{...s,key:i},{enabled:u??!0,staleTime:o,keepPreviousData:n,placeholderData:l}]:[c,e,{keepPreviousData:!0,initialData:e}]),[e,i,r,c,p,s,u,o,n,l])}(s,o,n),d=u(l,c,p);i.useUnmount((()=>{Object.is(l,o)&&o.removeQueries(c)}));const{isSuccess:D,data:m,...h}=d,k=t.useMemo((()=>D&&a.isFunction(r)?r(m):m),[D,m,r]);return{...h,isSuccess:D,data:k}};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+const shared = require('@vef-framework/shared');
+const ahooks = require('ahooks');
+const react = require('react');
+
+function useApi({
+  data,
+  dataDictionaryKey,
+  api,
+  apiParams,
+  apiEnabled,
+  staleTime,
+  keepPreviousData,
+  placeholderData
+}, stubQueryApi, dataDictionaryApi) {
+  return react.useMemo(() => {
+    if (!shared.isNullish(data)) {
+      return [
+        stubQueryApi,
+        data,
+        {
+          keepPreviousData: true,
+          initialData: data
+        }
+      ];
+    }
+    if (!shared.isNullish(dataDictionaryKey)) {
+      return [
+        dataDictionaryApi,
+        {
+          ...apiParams,
+          key: dataDictionaryKey
+        },
+        {
+          enabled: apiEnabled ?? true,
+          staleTime,
+          keepPreviousData,
+          placeholderData
+        }
+      ];
+    }
+    if (!shared.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
+  } = core.useApiContext();
+  const [api, args, options] = useApi(config, stubQueryApi, dataDictionaryQueryApi);
+  const result = useApiQuery(api, args, options);
+  ahooks.useUnmount(() => {
+    if (Object.is(api, stubQueryApi)) {
+      stubQueryApi.removeQueries(args);
+    }
+  });
+  const {
+    isSuccess,
+    data: rawData,
+    ...rest
+  } = result;
+  const data = react.useMemo(() => {
+    if (isSuccess && shared.isFunction(onFetched)) {
+      return onFetched(rawData);
+    }
+    return rawData;
+  }, [isSuccess, rawData, onFetched]);
+  return {
+    ...rest,
+    isSuccess,
+    data
+  };
+}
+
+exports.useDataQuery = 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/lib/use-deep-callback.cjs

@@ -1,3 +1,15 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),r=require("./use-deep-memo.cjs");exports.useDeepCallback=function(t,o){const s=r.useDeepMemo((()=>o),o);return e.useCallback(t,s)};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const useDeepMemo = require('./use-deep-memo.cjs');
+
+function useDeepCallback(callback, dependencies) {
+  const memoizedDependencies = useDeepMemo.useDeepMemo(() => dependencies, dependencies);
+  return react.useCallback(callback, memoizedDependencies);
+}
+
+exports.useDeepCallback = 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/lib/use-deep-memo.cjs

@@ -1,3 +1,23 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),r=require("react");exports.useDeepMemo=function(t,u){const n=r.useRef(),o=r.useRef(0);var s,c;return void 0!==n.current&&(s=u,c=n.current,s.length===c.length&&s.every(((r,t)=>e.isDeepEqual(r,c[t]))))||(o.current+=1),n.current=u,r.useMemo(t,[o.current])};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+function useDeepMemo(factory, dependencies) {
+  const lastDependencies = react.useRef();
+  const signal = react.useRef(0);
+  if (lastDependencies.current === void 0 || !isEqual(dependencies, lastDependencies.current)) {
+    signal.current += 1;
+  }
+  lastDependencies.current = dependencies;
+  return react.useMemo(factory, [signal.current]);
+}
+function isEqual(one, another) {
+  return one.length === another.length && one.every((value, index) => shared.isDeepEqual(value, another[index]));
+}
+
+exports.useDeepMemo = 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/lib/use-deep-selector.cjs

@@ -1,3 +1,18 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),r=require("react");exports.useDeepSelector=function(t){const u=r.useRef();return r=>{const n=t(r);return e.isDeepEqual(u.current,n)?u.current:u.current=n}};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+function useDeepSelector(selector) {
+  const prevSelectedState = react.useRef();
+  return (state) => {
+    const nextSelectedState = selector(state);
+    return shared.isDeepEqual(prevSelectedState.current, nextSelectedState) ? prevSelectedState.current : prevSelectedState.current = nextSelectedState;
+  };
+}
+
+exports.useDeepSelector = 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/lib/use-fallback-options.cjs

@@ -1,3 +1,104 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/core"),r=require("@vef-framework/shared"),a=require("ahooks"),s=require("react");exports.useFallbackOptions=function(i,{fallbackOptionsApi:t,fallbackOptionsApiParams:o,valuesKey:n,resolveFallbackOptions:u}){const{useApiQuery:l,stubQueryApi:p,asyncFnQueryApi:c}=e.useApiContext(),[k,f,b]=function(e,{fallbackOptionsApi:a,fallbackOptionsApiParams:i,valuesKey:t,resolveFallbackOptions:o},n,u){const l=s.useId();return s.useMemo((()=>{if(r.isFunction(o))return[u,{key:l,args:[e],fn:o},{keepPreviousData:!0}];if(a){const r={...i,[t??"ids"]:e};return[a,r,{keepPreviousData:!0}]}return[n,[],{keepPreviousData:!0,initialData:[]}]}),[o,a,n,l,e,u,i,t])}(i,{fallbackOptionsApi:t,fallbackOptionsApiParams:o,valuesKey:n,resolveFallbackOptions:u},p,c),v=l(k,f,b);return a.useUnmount((()=>{Object.is(k,p)&&p.removeQueries(f),Object.is(k,c)&&c.removeQueries(f)})),v};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+const shared = require('@vef-framework/shared');
+const ahooks = require('ahooks');
+const react = require('react');
+
+function useApi(missingOptionValues, {
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  valuesKey,
+  resolveFallbackOptions
+}, stubQueryApi, asyncFnQueryApi) {
+  const uniqueId = react.useId();
+  return react.useMemo(() => {
+    if (shared.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
+  } = core.useApiContext();
+  const [
+    api,
+    params,
+    options
+  ] = useApi(
+    missingOptionValues,
+    {
+      fallbackOptionsApi,
+      fallbackOptionsApiParams,
+      valuesKey,
+      resolveFallbackOptions
+    },
+    stubQueryApi,
+    asyncFnQueryApi
+  );
+  const result = useApiQuery(api, params, options);
+  ahooks.useUnmount(() => {
+    if (Object.is(api, stubQueryApi)) {
+      stubQueryApi.removeQueries(params);
+    }
+    if (Object.is(api, asyncFnQueryApi)) {
+      asyncFnQueryApi.removeQueries(params);
+    }
+  });
+  return result;
+}
+
+exports.useFallbackOptions = 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/lib/use-gap-size-normalizer.cjs

@@ -1,3 +1,40 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),r=require("./use-theme-tokens.cjs");exports.useGapSizeNormalizer=function(){const{paddingXS:t,paddingSM:i,padding:n,paddingMD:a,paddingLG:s}=r.useThemeTokens();return e.useCallback((e=>"tiny"===e?t:"small"===e?i:"medium"===e?n:"large"===e?a:"huge"===e?s:e),[t,i,n,a,s])};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('react');
+const useThemeTokens = require('./use-theme-tokens.cjs');
+
+function useGapSizeNormalizer() {
+  const {
+    paddingXS,
+    paddingSM,
+    padding,
+    paddingMD,
+    paddingLG
+  } = useThemeTokens.useThemeTokens();
+  return react.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
+  ]);
+}
+
+exports.useGapSizeNormalizer = 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/lib/use-normalized-gap-size.cjs

@@ -1,3 +1,14 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./use-gap-size-normalizer.cjs");exports.useNormalizedGapSize=function(r){return e.useGapSizeNormalizer()(r)};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const useGapSizeNormalizer = require('./use-gap-size-normalizer.cjs');
+
+function useNormalizedGapSize(gap) {
+  const normalize = useGapSizeNormalizer.useGapSizeNormalizer();
+  return normalize(gap);
+}
+
+exports.useNormalizedGapSize = 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/lib/use-normalized-menu-items.cjs

@@ -1,3 +1,50 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react");function t(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(t)}:"group"===e.type?{type:"group",key:e.key,label:e.label,children:e.children.map(t)}:{type:"divider",key:e.key}}exports.normalizeMenuItem=t,exports.useNormalizedMenuItems=function(l){return e.useMemo((()=>l.map(t)),[l])};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const react = require('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 react.useMemo(
+    () => items.map(normalizeMenuItem),
+    [items]
+  );
+}
+
+exports.normalizeMenuItem = normalizeMenuItem;
+exports.useNormalizedMenuItems = 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 */

package/lib/use-normalized-options.cjs

@@ -1,3 +1,106 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),i=require("react");exports.useNormalizedDataOptions=function(r,{labelField:t="label",valueField:n="value",childrenField:l="children",descriptionField:o="description",disabledField:s="disabled",defaultToFirst:a=!1},{isTree:d=!1,isGrouped:u=!1,parsePinyin:c=!1,selectedOptionValues:h=[]}={}){return i.useMemo((()=>{const i=new Set(h),f=!d&&u,p=(r,a=!1)=>{const d=r[t];if(e.isNullish(d)){if("label"===t)throw new e.VefError(-10001,"The label value of the option is required.");throw new e.VefError(-10001,`The label value pointed by '${t}' of the option is required.`)}const u=r[n];if(e.isNullish(u)){if("value"===n)throw new e.VefError(-10002,"The value value of the option is required.");throw new e.VefError(-10002,`The value value pointed by '${n}' of the option is required.`)}const h=r[l],b=r[o],v=r[s]??!1,y={...r,label:d,value:u,children:h,description:b,disabled:v};if(c){const{labelText:i,descriptionText:r}=y;(e.isString(d)||e.isString(i))&&(y.labelPinyin=e.parsePinyinFirstLetter(e.isString(d)?d:i).join("")),(e.isString(b)||e.isString(r))&&(y.descriptionPinyin=e.parsePinyinFirstLetter(e.isString(b)?b:r).join(""))}return a&&f||!i.has(u)||i.delete(u),e.isArray(y.children)&&(y.children=y.children.map((e=>p(e)))),y},b=Array.from(i),v=r.map((e=>p(e,!0)));if(!a)return[v,b];if(f){const i=v.find((i=>e.isArray(i.children)&&i.children.length>0));return[v,b,i?.children?.[0]]}return[v,b,v[0]]}),[l,a,o,s,u,d,t,r,c,h,n])};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+function useNormalizedDataOptions(options, {
+  labelField = "label",
+  valueField = "value",
+  childrenField = "children",
+  descriptionField = "description",
+  disabledField = "disabled",
+  defaultToFirst = false
+}, {
+  isTree = false,
+  isGrouped = false,
+  parsePinyin = false,
+  selectedOptionValues = []
+} = {}) {
+  return react.useMemo(() => {
+    const selectedOptionValuesSet = new Set(selectedOptionValues);
+    const isGroupedOptions = !isTree && isGrouped;
+    const normalizeOption = (option, isTopLevel = false) => {
+      const label = option[labelField];
+      if (shared.isNullish(label)) {
+        if (labelField === "label") {
+          throw new shared.VefError(-10001, `The label value of the option is required.`);
+        }
+        throw new shared.VefError(-10001, `The label value pointed by '${labelField}' of the option is required.`);
+      }
+      const value = option[valueField];
+      if (shared.isNullish(value)) {
+        if (valueField === "value") {
+          throw new shared.VefError(-10002, `The value value of the option is required.`);
+        }
+        throw new shared.VefError(-10002, `The value value pointed by '${valueField}' of the option is required.`);
+      }
+      const children = option[childrenField];
+      const description = option[descriptionField];
+      const disabled = option[disabledField] ?? false;
+      const normalizedOption = {
+        ...option,
+        label,
+        value,
+        children,
+        description,
+        disabled
+      };
+      if (parsePinyin) {
+        const { labelText, descriptionText } = normalizedOption;
+        if (shared.isString(label) || shared.isString(labelText)) {
+          normalizedOption.labelPinyin = shared.parsePinyinFirstLetter(
+            shared.isString(label) ? label : labelText
+          ).join("");
+        }
+        if (shared.isString(description) || shared.isString(descriptionText)) {
+          normalizedOption.descriptionPinyin = shared.parsePinyinFirstLetter(
+            shared.isString(description) ? description : descriptionText
+          ).join("");
+        }
+      }
+      if ((!isTopLevel || !isGroupedOptions) && selectedOptionValuesSet.has(value)) {
+        selectedOptionValuesSet.delete(value);
+      }
+      if (shared.isArray(normalizedOption.children)) {
+        normalizedOption.children = normalizedOption.children.map((option2) => normalizeOption(option2));
+      }
+      return normalizedOption;
+    };
+    const missingOptionValues = Array.from(selectedOptionValuesSet);
+    const normalizedOptions = options.map((option) => normalizeOption(option, true));
+    if (!defaultToFirst) {
+      return [normalizedOptions, missingOptionValues];
+    }
+    if (isGroupedOptions) {
+      const firstNonEmptyGroupOption = normalizedOptions.find((item) => shared.isArray(item.children) && item.children.length > 0);
+      return [
+        normalizedOptions,
+        missingOptionValues,
+        firstNonEmptyGroupOption?.children?.[0]
+      ];
+    }
+    return [
+      normalizedOptions,
+      missingOptionValues,
+      normalizedOptions[0]
+    ];
+  }, [
+    childrenField,
+    defaultToFirst,
+    descriptionField,
+    disabledField,
+    isGrouped,
+    isTree,
+    labelField,
+    options,
+    parsePinyin,
+    selectedOptionValues,
+    valueField
+  ]);
+}
+
+exports.useNormalizedDataOptions = useNormalizedDataOptions;
 /*! 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/lib/use-option-filter.cjs

@@ -1,3 +1,22 @@
-/*! VefFramework version: 1.0.62, build time: 2025-01-09T07:31:10.207Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),i=require("react");exports.useOptionFilter=function(n,r){return i.useMemo((()=>{if(n)return!r&&((i,n)=>(e.isString(n.label)&&n.label.includes(i)||e.isString(n.labelText)&&n.labelText.includes(i)||n.labelPinyin?.includes(i)||n.value.includes(i)||e.isString(n.description)&&n.description.includes(i)||e.isString(n.descriptionText)&&n.descriptionText.includes(i)||n.descriptionPinyin?.includes(i))??!1)}),[n,r])};
+/*! VefFramework version: 1.0.64, build time: 2025-01-10T01:26:01.309Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+function useOptionFilter(filterable, filterFromRemote) {
+  return react.useMemo(() => {
+    if (!filterable) {
+      return;
+    }
+    if (filterFromRemote) {
+      return false;
+    }
+    return (filterValue, option) => (shared.isString(option.label) && option.label.includes(filterValue) || shared.isString(option.labelText) && option.labelText.includes(filterValue) || option.labelPinyin?.includes(filterValue) || option.value.includes(filterValue) || shared.isString(option.description) && option.description.includes(filterValue) || shared.isString(option.descriptionText) && option.descriptionText.includes(filterValue) || option.descriptionPinyin?.includes(filterValue)) ?? false;
+  }, [filterable, filterFromRemote]);
+}
+
+exports.useOptionFilter = useOptionFilter;
 /*! 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 */