@vef-framework/hooks 1.0.100 → 1.0.101

package/lib/use-computed-options.cjs

@@ -1,3 +1,71 @@
-/*! VefFramework version: 1.0.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./use-data-query.cjs"),a=require("./use-fallback-options.cjs"),i=require("./use-normalized-options.cjs"),s=require("./use-remote-filter.cjs");exports.useComputedOptions=function useComputedOptions({labelKey:o,valueKey:t,descriptionKey:l,childrenKey:r,disabledKey:n,defaultToFirst:p,filterable:u=!1,filterFromRemote:d=!1,keywordKey:c="keyword",valuesKey:y="ids",fallbackOptionsApi:b,fallbackOptionsApiParams:O,resolveFallbackOptions:f,isGrouped:m=!1,selectedOptionValues:K,apiParams:k,...F}){const[g,v]=s.useRemoteFilter(u&&d,k,c),{data:P,isLoading:j}=e.useDataQuery({apiParams:g,...F}),[q,A,L]=i.useNormalizedDataOptions(P??[],{labelKey:o,valueKey:t,descriptionKey:l,childrenKey:r,disabledKey:n,defaultToFirst:p},{isGrouped:m,parsePinyin:u&&!d,selectedOptionValues:K}),{data:h,isLoading:w}=a.useFallbackOptions(A,{fallbackOptionsApi:b??F.api,fallbackOptionsApiParams:O,valuesKey:y,resolveFallbackOptions:f});return{onFilterKeywordChange:v,isLoading:j,normalizedOptions:q,defaultOption:L,fallbackOptions:h,isFallbackOptionsLoading:w}};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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({
+  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.useRemoteFilter(filterable && filterFromRemote, apiParams, keywordKey);
+  const { data: options, isLoading } = useDataQuery.useDataQuery({
+    apiParams: mergedApiParams,
+    ...queryConfig
+  });
+  const [normalizedOptions, missingOptionValues, defaultOption] = useNormalizedOptions.useNormalizedDataOptions(
+    options ?? [],
+    {
+      labelKey,
+      valueKey,
+      descriptionKey,
+      childrenKey,
+      disabledKey,
+      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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),t=e.createContext(!1);const o=t.Provider;exports.DisabledContextProvider=o,exports.useContextDisabled=function useContextDisabled(){return e.useContext(t)};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, 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 useDataQuery({onFetched:r,...s}){const{useApiQuery:u,stubQueryApi:o,dataDictionaryApi:n}=e.useApiContext(),[l,c,p]=function useApi({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,...y}=d,h=t.useMemo((()=>D&&a.isFunction(r)?r(m):m),[D,m,r]);return{...y,isSuccess:D,data:h}};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, 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 useDeepCallback(t,s){const u=r.useDeepMemo((()=>s),s);return e.useCallback(t,u)};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),r=require("react");exports.useDeepMemo=function useDeepMemo(t,u){const n=r.useRef(),o=r.useRef(0);return void 0!==n.current&&function isEqual(r,t){return r.length===t.length&&r.every(((r,u)=>e.isDeepEqual(r,t[u])))}(u,n.current)||(o.current+=1),n.current=u,r.useMemo(t,[o.current])};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),r=require("react");exports.useDeepSelector=function useDeepSelector(t){const u=r.useRef();return r=>{const o=t(r);return e.isDeepEqual(u.current,o)?u.current:u.current=o}};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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,107 @@
-/*! VefFramework version: 1.0.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/core"),s=require("@vef-framework/shared"),a=require("ahooks"),r=require("react"),i=require("./use-shallow-memo.cjs");exports.useFallbackOptions=function useFallbackOptions(t,{fallbackOptionsApi:o,fallbackOptionsApiParams:u,valuesKey:l,resolveFallbackOptions:n}){const{useApiQuery:p,stubQueryApi:c,asyncFnQueryApi:k}=e.useApiContext(),[f,b,v]=function useApi(e,{fallbackOptionsApi:a,fallbackOptionsApiParams:t,valuesKey:o,resolveFallbackOptions:u},l,n){const p=r.useId();return i.useShallowMemo((()=>{if(e.length>0){if(s.isFunction(u))return[n,{key:p,args:[e],fn:u},{keepPreviousData:!0}];if(a){const s={...t,[o??"ids"]:e};return[a,s,{keepPreviousData:!0}]}}return[l,[],{keepPreviousData:!0,initialData:[]}]}),[u,a,l,p,e,n,t,o])}(t,{fallbackOptionsApi:o,fallbackOptionsApiParams:u,valuesKey:l,resolveFallbackOptions:n},c,k),O=p(f,b,v);return a.useUnmount((()=>{Object.is(f,c)&&c.removeQueries(b),Object.is(f,k)&&k.removeQueries(b)})),O};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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');
+const useShallowMemo = require('./use-shallow-memo.cjs');
+
+function useApi(missingOptionValues, {
+  fallbackOptionsApi,
+  fallbackOptionsApiParams,
+  valuesKey,
+  resolveFallbackOptions
+}, stubQueryApi, asyncFnQueryApi) {
+  const uniqueId = react.useId();
+  return useShallowMemo.useShallowMemo(() => {
+    if (missingOptionValues.length > 0) {
+      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.100, build time: 2025-03-07T13:52:51.849Z, 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 useGapSizeNormalizer(){const{paddingXS:i,paddingSM:a,padding:t,paddingMD:n,paddingLG:s}=r.useThemeTokens();return e.useCallback((e=>"tiny"===e?i:"small"===e?a:"medium"===e?t:"large"===e?n:"huge"===e?s:e),[i,a,t,n,s])};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./use-gap-size-normalizer.cjs");exports.useNormalizedGapSize=function useNormalizedGapSize(r){return e.useGapSizeNormalizer()(r)};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("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}}exports.normalizeMenuItem=normalizeMenuItem,exports.useNormalizedMenuItems=function useNormalizedMenuItems(t){return e.useMemo((()=>t.map(normalizeMenuItem)),[t])};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),i=require("react");exports.useNormalizedDataOptions=function useNormalizedDataOptions(r,{labelKey:t="label",valueKey:n="value",childrenKey:o="children",descriptionKey:s="description",disabledKey:l="disabled",defaultToFirst:a=!1},{isTree:d=!1,isGrouped:u=!1,parsePinyin:c=!1,selectedOptionValues:h=[]}={}){return i.useMemo((()=>{const i=new Set(h),p=!d&&u,normalizeOption=(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 of the option is required.");throw new e.VefError(-10002,`The value pointed by '${n}' of the option is required.`)}const h=r[o],f=r[s],y=r[l]??!1,b={...r,label:d,value:u,children:h,description:f,disabled:y};if(c){const{labelText:i,descriptionText:r}=b;(e.isString(d)||e.isString(i))&&(b.labelPinyin=e.parsePinyinFirstLetter(e.isString(d)?d:i).join("")),(e.isString(f)||e.isString(r))&&(b.descriptionPinyin=e.parsePinyinFirstLetter(e.isString(f)?f:r).join(""))}return a&&p||!i.has(u)||i.delete(u),e.isArray(b.children)&&(b.children=b.children.map((e=>normalizeOption(e)))),b},f=r.map((e=>normalizeOption(e,!0))),y=Array.from(i);if(!a)return[f,y];if(p){const i=f.find((i=>e.isArray(i.children)&&i.children.length>0));return[f,y,i?.children?.[0]]}return[f,y,f[0]]}),[o,a,s,l,u,d,t,r,c,n])};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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, {
+  labelKey = "label",
+  valueKey = "value",
+  childrenKey = "children",
+  descriptionKey = "description",
+  disabledKey = "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[labelKey];
+      if (shared.isNullish(label)) {
+        if (labelKey === "label") {
+          throw new shared.VefError(-10001, `The label value of the option is required.`);
+        }
+        throw new shared.VefError(-10001, `The label value pointed by '${labelKey}' of the option is required.`);
+      }
+      const value = option[valueKey];
+      if (shared.isNullish(value)) {
+        if (valueKey === "value") {
+          throw new shared.VefError(-10002, `The value of the option is required.`);
+        }
+        throw new shared.VefError(-10002, `The value pointed by '${valueKey}' of the option is required.`);
+      }
+      const children = option[childrenKey];
+      const description = option[descriptionKey];
+      const disabled = option[disabledKey] ?? 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 normalizedOptions = options.map((option) => normalizeOption(option, true));
+    const missingOptionValues = Array.from(selectedOptionValuesSet);
+    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]
+    ];
+  }, [
+    childrenKey,
+    defaultToFirst,
+    descriptionKey,
+    disabledKey,
+    isGrouped,
+    isTree,
+    labelKey,
+    options,
+    parsePinyin,
+    // selectedOptionValues,
+    valueKey
+  ]);
+}
+
+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.100, build time: 2025-03-07T13:52:51.849Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),i=require("react");exports.useOptionFilter=function useOptionFilter(t,n){return i.useMemo((()=>{if(t)return!n&&((i,t)=>(e.isString(t.label)&&t.label.includes(i)||e.isString(t.labelText)&&t.labelText.includes(i)||t.labelPinyin?.includes(i)||t.value.includes(i)||e.isString(t.description)&&t.description.includes(i)||e.isString(t.descriptionText)&&t.descriptionText.includes(i)||t.descriptionPinyin?.includes(i))??!1)}),[t,n])};
+/*! VefFramework version: 1.0.101, build time: 2025-03-07T14:07:14.523Z, 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 */