@vef-framework-react/hooks 2.1.0

package/README

@@ -0,0 +1,15 @@
+# @vef-framework-react/hooks
+
+Hooks for using VEF framework.
+
+## Installation
+
+```bash
+pnpm add @vef-framework-react/hooks
+```
+
+## Usage
+
+```ts
+import { xxx } from "@vef-framework-react/hooks";
+```

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./lib.cjs`),t=require(`./use-authorized-items/index.cjs`),n=require(`./use-breakpoints/index.cjs`),r=require(`./use-check-permission/index.cjs`),i=require(`./use-data-dict-query/index.cjs`),a=require(`./use-data-options/index.cjs`),o=require(`./use-deep-compare/index.cjs`),s=require(`./use-deep-callback/index.cjs`),c=require(`./use-deep-effect/index.cjs`),l=require(`./use-deep-isomorphic-effect/index.cjs`),u=require(`./use-deep-layout-effect/index.cjs`),d=require(`./use-deep-memo/index.cjs`),f=require(`./use-latest/index.cjs`),p=require(`./use-document-event/index.cjs`),m=require(`./use-emitter-event/index.cjs`),h=require(`./use-has-fetching/index.cjs`),g=require(`./use-has-mutating/index.cjs`),_=require(`./use-is-authorized/index.cjs`),v=require(`./use-raf-state/index.cjs`),y=require(`./use-shallow-compare/index.cjs`),b=require(`./use-shallow-callback/index.cjs`),x=require(`./use-shallow-effect/index.cjs`),S=require(`./use-shallow-isomorphic-effect/index.cjs`),C=require(`./use-shallow-layout-effect/index.cjs`),w=require(`./use-shallow-memo/index.cjs`),T=require(`./use-singleton/index.cjs`),E=require(`./use-viewport-size/index.cjs`);let D=require(`@mantine/hooks`),O=require(`react-hotkeys-hook`),k=require(`@ai-sdk/react`);Object.defineProperty(exports,`HotkeysProvider`,{enumerable:!0,get:function(){return O.HotkeysProvider}}),Object.defineProperty(exports,`assignRef`,{enumerable:!0,get:function(){return D.assignRef}}),Object.defineProperty(exports,`getHotkeyHandler`,{enumerable:!0,get:function(){return D.getHotkeyHandler}}),Object.defineProperty(exports,`mergeRefs`,{enumerable:!0,get:function(){return D.mergeRefs}}),exports.useAuthorizedItems=t.useAuthorizedItems,exports.useBreakpoints=n.useBreakpoints,Object.defineProperty(exports,`useChat`,{enumerable:!0,get:function(){return k.useChat}}),exports.useCheckPermission=r.useCheckPermission,exports.useColorScheme=e.useColorScheme,Object.defineProperty(exports,`useCompletion`,{enumerable:!0,get:function(){return k.useCompletion}}),exports.useDataDictQuery=i.useDataDictQuery,exports.useDataOptionsQuery=a.useDataOptionsQuery,Object.defineProperty(exports,`useDebouncedCallback`,{enumerable:!0,get:function(){return D.useDebouncedCallback}}),Object.defineProperty(exports,`useDebouncedState`,{enumerable:!0,get:function(){return D.useDebouncedState}}),Object.defineProperty(exports,`useDebouncedValue`,{enumerable:!0,get:function(){return D.useDebouncedValue}}),exports.useDeepCallback=s.useDeepCallback,exports.useDeepCompare=o.useDeepCompare,exports.useDeepEffect=c.useDeepEffect,exports.useDeepIsomorphicEffect=l.useDeepIsomorphicEffect,exports.useDeepLayoutEffect=u.useDeepLayoutEffect,exports.useDeepMemo=d.useDeepMemo,Object.defineProperty(exports,`useDidUpdate`,{enumerable:!0,get:function(){return D.useDidUpdate}}),exports.useDocumentEvent=p.useDocumentEvent,Object.defineProperty(exports,`useDocumentTitle`,{enumerable:!0,get:function(){return D.useDocumentTitle}}),Object.defineProperty(exports,`useElementSize`,{enumerable:!0,get:function(){return D.useElementSize}}),exports.useEmitterEvent=m.useEmitterEvent,Object.defineProperty(exports,`useEventListener`,{enumerable:!0,get:function(){return D.useEventListener}}),Object.defineProperty(exports,`useFocusTrap`,{enumerable:!0,get:function(){return D.useFocusTrap}}),Object.defineProperty(exports,`useFullscreen`,{enumerable:!0,get:function(){return D.useFullscreen}}),exports.useHasFetching=h.useHasFetching,exports.useHasMutating=g.useHasMutating,Object.defineProperty(exports,`useHotkeys`,{enumerable:!0,get:function(){return O.useHotkeys}}),Object.defineProperty(exports,`useHotkeysContext`,{enumerable:!0,get:function(){return O.useHotkeysContext}}),Object.defineProperty(exports,`useIntersection`,{enumerable:!0,get:function(){return D.useIntersection}}),Object.defineProperty(exports,`useInterval`,{enumerable:!0,get:function(){return D.useInterval}}),exports.useIsAuthorized=_.useIsAuthorized,Object.defineProperty(exports,`useIsFirstRender`,{enumerable:!0,get:function(){return D.useIsFirstRender}}),Object.defineProperty(exports,`useIsomorphicEffect`,{enumerable:!0,get:function(){return D.useIsomorphicEffect}}),exports.useLatest=f.useLatest,exports.useMediaQuery=e.useMediaQuery,Object.defineProperty(exports,`useMergedRef`,{enumerable:!0,get:function(){return D.useMergedRef}}),Object.defineProperty(exports,`useMounted`,{enumerable:!0,get:function(){return D.useMounted}}),Object.defineProperty(exports,`useMutationObserver`,{enumerable:!0,get:function(){return D.useMutationObserver}}),Object.defineProperty(exports,`useObject`,{enumerable:!0,get:function(){return k.experimental_useObject}}),Object.defineProperty(exports,`usePrevious`,{enumerable:!0,get:function(){return D.usePrevious}}),exports.useRafState=v.useRafState,Object.defineProperty(exports,`useRecordHotkeys`,{enumerable:!0,get:function(){return O.useRecordHotkeys}}),exports.useReducedMotion=e.useReducedMotion,Object.defineProperty(exports,`useResizeObserver`,{enumerable:!0,get:function(){return D.useResizeObserver}}),exports.useShallowCallback=b.useShallowCallback,exports.useShallowCompare=y.useShallowCompare,exports.useShallowEffect=x.useShallowEffect,exports.useShallowIsomorphicEffect=S.useShallowIsomorphicEffect,exports.useShallowLayoutEffect=C.useShallowLayoutEffect,exports.useShallowMemo=w.useShallowMemo,exports.useSingleton=T.useSingleton,Object.defineProperty(exports,`useTimeout`,{enumerable:!0,get:function(){return D.useTimeout}}),exports.useViewportSize=E.useViewportSize,Object.defineProperty(exports,`useWindowEvent`,{enumerable:!0,get:function(){return D.useWindowEvent}});

package/dist/cjs/lib.cjs

@@ -0,0 +1 @@
+let e=require(`@mantine/hooks`);require(`@ai-sdk/react`),require(`react-hotkeys-hook`);var t={getInitialValueInEffect:!1};function n(n,r,i=t){return(0,e.useMediaQuery)(n,r,{getInitialValueInEffect:i.getInitialValueInEffect})}function r(n,r=t){return(0,e.useColorScheme)(n,{getInitialValueInEffect:r.getInitialValueInEffect})}function i(n,r=t){return(0,e.useReducedMotion)(n,{getInitialValueInEffect:r.getInitialValueInEffect})}exports.useColorScheme=r,exports.useMediaQuery=n,exports.useReducedMotion=i;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`);function t(t){let{hasPermission:n=()=>!0}=(0,e.useAppContext)();return t.filter(t=>{let{permTokens:r,checkMode:i=`any`}=t;return(0,e.checkPermission)(n,r,i)})}exports.useAuthorizedItems=t;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/shared`),t=require(`react`);function n(t){return`(min-width: ${(0,e.isNumber)(t)?`${t}px`:t})`}function r(r,i={}){let{initialBreakpoint:a,getInitialValueInEffect:o=!1}=i,s=(0,t.useMemo)(()=>Object.entries(r).map(([t,r])=>({name:t,value:r,query:n(r),order:(0,e.isNumber)(r)?r:Number.parseInt(r)})).toSorted((e,t)=>e.order-t.order),[r]),[c,l]=(0,t.useState)(()=>{if(globalThis.window===void 0||o)return{current:a,value:s.find(e=>e.name===a)?.value,matches:a?[a]:[]};let e=s.filter(e=>globalThis.matchMedia(e.query).matches),t=e.at(-1);return{current:t?.name,value:t?.value,matches:e.map(e=>e.name)}});return(0,t.useEffect)(()=>{let e=s.map(e=>({name:e.name,value:e.value,mql:globalThis.matchMedia(e.query)}));function t(){let t=e.filter(e=>e.mql.matches),n=t.at(-1);l({current:n?.name,value:n?.value,matches:t.map(e=>e.name)})}o&&t();for(let n of e)n.mql.addEventListener(`change`,t);return()=>{for(let n of e)n.mql.removeEventListener(`change`,t)}},[o,s]),c}exports.useBreakpoints=r;

package/dist/cjs/use-check-permission/index.cjs

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`);function t(){let{hasPermission:t=()=>!0}=(0,e.useAppContext)();return(n,r)=>(0,e.checkPermission)(t,n,r)}exports.useCheckPermission=t;

package/dist/cjs/use-data-dict-query/index.cjs

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`),t=require(`@vef-framework-react/shared`),n=require(`react`);function r({dataDictKey:r,onFetch:i,...a}){let{dataDictQueryFn:o}=(0,e.useAppContext)();if(!(0,t.isFunction)(o))throw Error(`Data dictionary query function is not provided in the app context.`);let s=(0,n.useRef)(i);s.current=i;let c=(0,e.useQuery)({...a,queryFn:(0,t.isEmpty)(r)?e.skipQueryToken:o,queryKey:[o.key,r],staleTime:a?.staleTime??1/0});return(0,n.useEffect)(()=>{s.current&&c.promise.then(s.current)},[c.promise]),c}exports.useDataDictQuery=r;

package/dist/cjs/use-data-options/index.cjs

@@ -0,0 +1 @@
+const e=require(`../use-data-dict-query/index.cjs`);let t=require(`@vef-framework-react/core`),n=require(`@vef-framework-react/shared`),r=require(`react`);function i(e,t,r){return t?(0,n.isFunction)(t)?t(e):(0,n.get)(e,t):e[r]}function a(e,t,r){let{labelKey:o,valueKey:s,disabledKey:c,descriptionKey:l,childrenKey:u}=t,d=i(e,o,`label`),f=i(e,s,`value`),p=i(e,c,`disabled`),m=i(e,l,`description`),h=i(e,u,`children`),g={...e,label:d,value:f,...!(0,n.isNullish)(p)&&{disabled:p},...!(0,n.isNullish)(m)&&{description:m}},_=r?(0,n.withPinyin)(g,`label`,`description`):g;return Array.isArray(h)&&h.length>0&&(_.children=h.map(e=>a(e,t,r))),_}function o(e,t,r){return!e||(0,n.isEmpty)(e)?[]:e.map(e=>a(e,t,r))}function s({queryOptions:i,dataDictKey:a,labelKey:s,valueKey:c,disabledKey:l,descriptionKey:u,childrenKey:d,withPinyin:f=!1}){let p=(0,n.isString)(a)&&a.length>0,m=(0,t.useQuery)({...i,queryFn:p?t.skipQueryToken:i?.queryFn}),h=e.useDataDictQuery({dataDictKey:a}),{data:g,..._}=p?h:m,v=(0,r.useMemo)(()=>({labelKey:s,valueKey:c,disabledKey:l,descriptionKey:u,childrenKey:d}),[s,c,l,u,d]);return{options:(0,r.useMemo)(()=>o(g,v,f),[g,v,f]),..._}}exports.useDataOptionsQuery=s;

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

@@ -0,0 +1 @@
+const e=require(`../use-deep-compare/index.cjs`);let t=require(`react`);function n(n,r){return(0,t.useCallback)(n,e.useDeepCompare(r))}exports.useDeepCallback=n;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/shared`),t=require(`react`);function n(e){let n=(0,t.useRef)(void 0),i=(0,t.useRef)(0);return r(n.current,e)||(n.current=e,i.current+=1),[i.current]}function r(t,n){if(t===void 0||n===void 0)return!1;if(Object.is(t,n))return!0;if(t.length!==n.length)return!1;for(let[r,i]of t.entries())if(!(0,e.isDeepEqual)(i,n[r]))return!1;return!0}exports.useDeepCompare=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-deep-compare/index.cjs`);let t=require(`react`);function n(n,r){(0,t.useEffect)(n,e.useDeepCompare(r))}exports.useDeepEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-deep-compare/index.cjs`);let t=require(`@mantine/hooks`);function n(n,r){(0,t.useIsomorphicEffect)(n,e.useDeepCompare(r))}exports.useDeepIsomorphicEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-deep-compare/index.cjs`);let t=require(`react`);function n(n,r){(0,t.useLayoutEffect)(n,e.useDeepCompare(r))}exports.useDeepLayoutEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-deep-compare/index.cjs`);let t=require(`react`);function n(n,r){return(0,t.useMemo)(n,e.useDeepCompare(r))}exports.useDeepMemo=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-latest/index.cjs`);let t=require(`react`);function n(n,r,i){let a=e.useLatest(r);(0,t.useEffect)(()=>{function e(e){a.current.call(this,e)}return document.addEventListener(n,e,i),()=>{document.removeEventListener(n,e,i)}},[n,i,a])}exports.useDocumentEvent=n;

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

@@ -0,0 +1 @@
+require(`@vef-framework-react/shared`);let e=require(`react`);function t(t,n,r){(0,e.useEffect)(()=>t.on(n,r),[t,n,r])}exports.useEmitterEvent=t;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`);function t(t,n){return(0,e.useIsFetching)({queryKey:n?[t,n]:[t],exact:!1,type:`active`})>0}exports.useHasFetching=t;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`);function t(t){return(0,e.useIsMutating)({mutationKey:[t],exact:!1})>0}exports.useHasMutating=t;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/core`);function t(t,n){let{hasPermission:r=()=>!0}=(0,e.useAppContext)();return(0,e.checkPermission)(r,t,n)}exports.useIsAuthorized=t;

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

@@ -0,0 +1 @@
+let e=require(`react`);function t(t){let n=(0,e.useRef)(t);return n.current=t,n}exports.useLatest=t;

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

@@ -0,0 +1 @@
+let e=require(`react`);function t(t){let n=(0,e.useRef)(0),[r,i]=(0,e.useState)(t),a=(0,e.useCallback)(e=>{cancelAnimationFrame(n.current),n.current=requestAnimationFrame(()=>{i(e)})},[]);return(0,e.useEffect)(()=>()=>{cancelAnimationFrame(n.current)},[]),[r,a]}exports.useRafState=t;

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

@@ -0,0 +1 @@
+const e=require(`../use-shallow-compare/index.cjs`);let t=require(`react`);function n(n,r){return(0,t.useCallback)(n,e.useShallowCompare(r))}exports.useShallowCallback=n;

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

@@ -0,0 +1 @@
+let e=require(`@vef-framework-react/shared`),t=require(`react`);function n(e){let n=(0,t.useRef)(void 0),i=(0,t.useRef)(0);return r(n.current,e)||(n.current=e,i.current+=1),[i.current]}function r(t,n){if(t===void 0||n===void 0)return!1;if(t===n)return!0;if(t.length!==n.length)return!1;for(let[r,i]of t.entries())if(!(0,e.isShallowEqual)(i,n[r]))return!1;return!0}exports.useShallowCompare=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-shallow-compare/index.cjs`);let t=require(`react`);function n(n,r){(0,t.useEffect)(n,e.useShallowCompare(r))}exports.useShallowEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-shallow-compare/index.cjs`);let t=require(`@mantine/hooks`);function n(n,r){(0,t.useIsomorphicEffect)(n,e.useShallowCompare(r))}exports.useShallowIsomorphicEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-shallow-compare/index.cjs`);let t=require(`react`);function n(n,r){(0,t.useLayoutEffect)(n,e.useShallowCompare(r))}exports.useShallowLayoutEffect=n;

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

@@ -0,0 +1 @@
+const e=require(`../use-shallow-compare/index.cjs`);let t=require(`react`);function n(n,r){return(0,t.useMemo)(n,e.useShallowCompare(r))}exports.useShallowMemo=n;

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

@@ -0,0 +1 @@
+let e=require(`react`);function t(t){let n=(0,e.useRef)(void 0);return n.current===void 0&&(n.current=t()),n}exports.useSingleton=t;

package/dist/cjs/use-viewport-size/index.cjs

@@ -0,0 +1 @@
+const e=require(`../use-raf-state/index.cjs`);let t=require(`@vef-framework-react/shared`),n=require(`react`),r=require(`@mantine/hooks`);var i={passive:!0};function a(){let a=!(0,t.isUndefined)(globalThis.window),[o,s]=e.useRafState(()=>({width:a?window.innerWidth:0,height:a?window.innerHeight:0}));return(0,n.useEffect)(()=>{function e(){(0,t.isUndefined)(globalThis.window)||s({width:window.innerWidth,height:window.innerHeight})}e()},[s]),(0,r.useWindowEvent)(`resize`,()=>{(0,t.isUndefined)(globalThis.window)||s({width:window.innerWidth,height:window.innerHeight})},i),(0,r.useWindowEvent)(`orientationchange`,()=>{(0,t.isUndefined)(globalThis.window)||s({width:window.innerWidth,height:window.innerHeight})},i),o}exports.useViewportSize=a;

package/dist/es/index.js

@@ -0,0 +1,29 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { HotkeysProvider as e, assignRef as t, getHotkeyHandler as n, mergeRefs as r, useChat as i, useColorScheme as a, useCompletion as o, useDebouncedCallback as s, useDebouncedState as c, useDebouncedValue as l, useDidUpdate as u, useDocumentTitle as d, useElementSize as f, useEventListener as p, useFocusTrap as m, useFullscreen as h, useHotkeys as g, useHotkeysContext as _, useIntersection as v, useInterval as y, useIsFirstRender as b, useIsomorphicEffect as x, useMediaQuery as S, useMergedRef as C, useMounted as w, useMutationObserver as T, useObject as E, usePrevious as D, useRecordHotkeys as O, useReducedMotion as k, useResizeObserver as A, useTimeout as j, useWindowEvent as M } from "./lib.js";
+import { useAuthorizedItems as N } from "./use-authorized-items/index.js";
+import { useBreakpoints as P } from "./use-breakpoints/index.js";
+import { useCheckPermission as F } from "./use-check-permission/index.js";
+import { useDataDictQuery as I } from "./use-data-dict-query/index.js";
+import { useDataOptionsQuery as L } from "./use-data-options/index.js";
+import { useDeepCompare as R } from "./use-deep-compare/index.js";
+import { useDeepCallback as z } from "./use-deep-callback/index.js";
+import { useDeepEffect as B } from "./use-deep-effect/index.js";
+import { useDeepIsomorphicEffect as V } from "./use-deep-isomorphic-effect/index.js";
+import { useDeepLayoutEffect as H } from "./use-deep-layout-effect/index.js";
+import { useDeepMemo as U } from "./use-deep-memo/index.js";
+import { useLatest as W } from "./use-latest/index.js";
+import { useDocumentEvent as G } from "./use-document-event/index.js";
+import { useEmitterEvent as K } from "./use-emitter-event/index.js";
+import { useHasFetching as q } from "./use-has-fetching/index.js";
+import { useHasMutating as J } from "./use-has-mutating/index.js";
+import { useIsAuthorized as Y } from "./use-is-authorized/index.js";
+import { useRafState as X } from "./use-raf-state/index.js";
+import { useShallowCompare as Z } from "./use-shallow-compare/index.js";
+import { useShallowCallback as Q } from "./use-shallow-callback/index.js";
+import { useShallowEffect as $ } from "./use-shallow-effect/index.js";
+import { useShallowIsomorphicEffect as ee } from "./use-shallow-isomorphic-effect/index.js";
+import { useShallowLayoutEffect as te } from "./use-shallow-layout-effect/index.js";
+import { useShallowMemo as ne } from "./use-shallow-memo/index.js";
+import { useSingleton as re } from "./use-singleton/index.js";
+import { useViewportSize as ie } from "./use-viewport-size/index.js";
+export { e as HotkeysProvider, t as assignRef, n as getHotkeyHandler, r as mergeRefs, N as useAuthorizedItems, P as useBreakpoints, i as useChat, F as useCheckPermission, a as useColorScheme, o as useCompletion, I as useDataDictQuery, L as useDataOptionsQuery, s as useDebouncedCallback, c as useDebouncedState, l as useDebouncedValue, z as useDeepCallback, R as useDeepCompare, B as useDeepEffect, V as useDeepIsomorphicEffect, H as useDeepLayoutEffect, U as useDeepMemo, u as useDidUpdate, G as useDocumentEvent, d as useDocumentTitle, f as useElementSize, K as useEmitterEvent, p as useEventListener, m as useFocusTrap, h as useFullscreen, q as useHasFetching, J as useHasMutating, g as useHotkeys, _ as useHotkeysContext, v as useIntersection, y as useInterval, Y as useIsAuthorized, b as useIsFirstRender, x as useIsomorphicEffect, W as useLatest, S as useMediaQuery, C as useMergedRef, w as useMounted, T as useMutationObserver, E as useObject, D as usePrevious, X as useRafState, O as useRecordHotkeys, k as useReducedMotion, A as useResizeObserver, Q as useShallowCallback, Z as useShallowCompare, $ as useShallowEffect, ee as useShallowIsomorphicEffect, te as useShallowLayoutEffect, ne as useShallowMemo, re as useSingleton, j as useTimeout, ie as useViewportSize, M as useWindowEvent };

package/dist/es/lib.js

@@ -0,0 +1,17 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { assignRef as e, getHotkeyHandler as t, mergeRefs as n, useColorScheme as r, useDebouncedCallback as i, useDebouncedState as a, useDebouncedValue as o, useDidUpdate as s, useDocumentTitle as c, useElementSize as l, useEventListener as u, useFocusTrap as d, useFullscreen as f, useIntersection as p, useInterval as m, useIsFirstRender as h, useIsomorphicEffect as g, useMediaQuery as _, useMergedRef as v, useMounted as y, useMutationObserver as b, usePrevious as x, useReducedMotion as S, useResizeObserver as C, useTimeout as w, useWindowEvent as T } from "@mantine/hooks";
+import { experimental_useObject as E, useChat as D, useCompletion as O } from "@ai-sdk/react";
+import { HotkeysProvider as k, useHotkeys as A, useHotkeysContext as j, useRecordHotkeys as M } from "react-hotkeys-hook";
+//#region src/lib.ts
+var N = { getInitialValueInEffect: !1 };
+function P(e, t, n = N) {
+	return _(e, t, { getInitialValueInEffect: n.getInitialValueInEffect });
+}
+function F(e, t = N) {
+	return r(e, { getInitialValueInEffect: t.getInitialValueInEffect });
+}
+function I(e, t = N) {
+	return S(e, { getInitialValueInEffect: t.getInitialValueInEffect });
+}
+//#endregion
+export { k as HotkeysProvider, e as assignRef, t as getHotkeyHandler, n as mergeRefs, D as useChat, F as useColorScheme, O as useCompletion, i as useDebouncedCallback, a as useDebouncedState, o as useDebouncedValue, s as useDidUpdate, c as useDocumentTitle, l as useElementSize, u as useEventListener, d as useFocusTrap, f as useFullscreen, A as useHotkeys, j as useHotkeysContext, p as useIntersection, m as useInterval, h as useIsFirstRender, g as useIsomorphicEffect, P as useMediaQuery, v as useMergedRef, y as useMounted, b as useMutationObserver, E as useObject, x as usePrevious, M as useRecordHotkeys, I as useReducedMotion, C as useResizeObserver, w as useTimeout, T as useWindowEvent };

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

@@ -0,0 +1,12 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
+//#region src/use-authorized-items/index.ts
+function n(n) {
+	let { hasPermission: r = () => !0 } = t();
+	return n.filter((t) => {
+		let { permTokens: n, checkMode: i = "any" } = t;
+		return e(r, n, i);
+	});
+}
+//#endregion
+export { n as useAuthorizedItems };

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

@@ -0,0 +1,49 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { isNumber as e } from "@vef-framework-react/shared";
+import { useEffect as t, useMemo as n, useState as r } from "react";
+//#region src/use-breakpoints/index.ts
+function i(t) {
+	return `(min-width: ${e(t) ? `${t}px` : t})`;
+}
+function a(a, o = {}) {
+	let { initialBreakpoint: s, getInitialValueInEffect: c = !1 } = o, l = n(() => Object.entries(a).map(([t, n]) => ({
+		name: t,
+		value: n,
+		query: i(n),
+		order: e(n) ? n : Number.parseInt(n)
+	})).toSorted((e, t) => e.order - t.order), [a]), [u, d] = r(() => {
+		if (globalThis.window === void 0 || c) return {
+			current: s,
+			value: l.find((e) => e.name === s)?.value,
+			matches: s ? [s] : []
+		};
+		let e = l.filter((e) => globalThis.matchMedia(e.query).matches), t = e.at(-1);
+		return {
+			current: t?.name,
+			value: t?.value,
+			matches: e.map((e) => e.name)
+		};
+	});
+	return t(() => {
+		let e = l.map((e) => ({
+			name: e.name,
+			value: e.value,
+			mql: globalThis.matchMedia(e.query)
+		}));
+		function t() {
+			let t = e.filter((e) => e.mql.matches), n = t.at(-1);
+			d({
+				current: n?.name,
+				value: n?.value,
+				matches: t.map((e) => e.name)
+			});
+		}
+		c && t();
+		for (let n of e) n.mql.addEventListener("change", t);
+		return () => {
+			for (let n of e) n.mql.removeEventListener("change", t);
+		};
+	}, [c, l]), u;
+}
+//#endregion
+export { a as useBreakpoints };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
+//#region src/use-check-permission/index.ts
+function n() {
+	let { hasPermission: n = () => !0 } = t();
+	return (t, r) => e(n, t, r);
+}
+//#endregion
+export { n as useCheckPermission };

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

@@ -0,0 +1,22 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { skipQueryToken as e, useAppContext as t, useQuery as n } from "@vef-framework-react/core";
+import { isEmpty as r, isFunction as i } from "@vef-framework-react/shared";
+import { useEffect as a, useRef as o } from "react";
+//#region src/use-data-dict-query/index.ts
+function s({ dataDictKey: s, onFetch: c, ...l }) {
+	let { dataDictQueryFn: u } = t();
+	if (!i(u)) throw Error("Data dictionary query function is not provided in the app context.");
+	let d = o(c);
+	d.current = c;
+	let f = n({
+		...l,
+		queryFn: r(s) ? e : u,
+		queryKey: [u.key, s],
+		staleTime: l?.staleTime ?? Infinity
+	});
+	return a(() => {
+		d.current && f.promise.then(d.current);
+	}, [f.promise]), f;
+}
+//#endregion
+export { s as useDataDictQuery };

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

@@ -0,0 +1,50 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useDataDictQuery as e } from "../use-data-dict-query/index.js";
+import { skipQueryToken as t, useQuery as n } from "@vef-framework-react/core";
+import { get as r, isEmpty as i, isFunction as a, isNullish as o, isString as s, withPinyin as c } from "@vef-framework-react/shared";
+import { useMemo as l } from "react";
+//#region src/use-data-options/index.ts
+function u(e, t, n) {
+	return t ? a(t) ? t(e) : r(e, t) : e[n];
+}
+function d(e, t, n) {
+	let { labelKey: r, valueKey: i, disabledKey: a, descriptionKey: s, childrenKey: l } = t, f = u(e, r, "label"), p = u(e, i, "value"), m = u(e, a, "disabled"), h = u(e, s, "description"), g = u(e, l, "children"), _ = {
+		...e,
+		label: f,
+		value: p,
+		...!o(m) && { disabled: m },
+		...!o(h) && { description: h }
+	}, v = n ? c(_, "label", "description") : _;
+	return Array.isArray(g) && g.length > 0 && (v.children = g.map((e) => d(e, t, n))), v;
+}
+function f(e, t, n) {
+	return !e || i(e) ? [] : e.map((e) => d(e, t, n));
+}
+function p({ queryOptions: r, dataDictKey: i, labelKey: a, valueKey: o, disabledKey: c, descriptionKey: u, childrenKey: d, withPinyin: p = !1 }) {
+	let m = s(i) && i.length > 0, h = n({
+		...r,
+		queryFn: m ? t : r?.queryFn
+	}), g = e({ dataDictKey: i }), { data: _, ...v } = m ? g : h, y = l(() => ({
+		labelKey: a,
+		valueKey: o,
+		disabledKey: c,
+		descriptionKey: u,
+		childrenKey: d
+	}), [
+		a,
+		o,
+		c,
+		u,
+		d
+	]);
+	return {
+		options: l(() => f(_, y, p), [
+			_,
+			y,
+			p
+		]),
+		...v
+	};
+}
+//#endregion
+export { p as useDataOptionsQuery };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useDeepCompare as e } from "../use-deep-compare/index.js";
+import { useCallback as t } from "react";
+//#region src/use-deep-callback/index.ts
+function n(n, r) {
+	return t(n, e(r));
+}
+//#endregion
+export { n as useDeepCallback };

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

@@ -0,0 +1,17 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { isDeepEqual as e } from "@vef-framework-react/shared";
+import { useRef as t } from "react";
+//#region src/use-deep-compare/index.ts
+function n(e) {
+	let n = t(void 0), i = t(0);
+	return r(n.current, e) || (n.current = e, i.current += 1), [i.current];
+}
+function r(t, n) {
+	if (t === void 0 || n === void 0) return !1;
+	if (Object.is(t, n)) return !0;
+	if (t.length !== n.length) return !1;
+	for (let [r, i] of t.entries()) if (!e(i, n[r])) return !1;
+	return !0;
+}
+//#endregion
+export { n as useDeepCompare };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useDeepCompare as e } from "../use-deep-compare/index.js";
+import { useEffect as t } from "react";
+//#region src/use-deep-effect/index.ts
+function n(n, r) {
+	t(n, e(r));
+}
+//#endregion
+export { n as useDeepEffect };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useIsomorphicEffect as e } from "../lib.js";
+import { useDeepCompare as t } from "../use-deep-compare/index.js";
+//#region src/use-deep-isomorphic-effect/index.ts
+function n(n, r) {
+	e(n, t(r));
+}
+//#endregion
+export { n as useDeepIsomorphicEffect };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useDeepCompare as e } from "../use-deep-compare/index.js";
+import { useLayoutEffect as t } from "react";
+//#region src/use-deep-layout-effect/index.ts
+function n(n, r) {
+	t(n, e(r));
+}
+//#endregion
+export { n as useDeepLayoutEffect };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useDeepCompare as e } from "../use-deep-compare/index.js";
+import { useMemo as t } from "react";
+//#region src/use-deep-memo/index.ts
+function n(n, r) {
+	return t(n, e(r));
+}
+//#endregion
+export { n as useDeepMemo };

package/dist/es/use-document-event/index.js

@@ -0,0 +1,21 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useLatest as e } from "../use-latest/index.js";
+import { useEffect as t } from "react";
+//#region src/use-document-event/index.ts
+function n(n, r, i) {
+	let a = e(r);
+	t(() => {
+		function e(e) {
+			a.current.call(this, e);
+		}
+		return document.addEventListener(n, e, i), () => {
+			document.removeEventListener(n, e, i);
+		};
+	}, [
+		n,
+		i,
+		a
+	]);
+}
+//#endregion
+export { n as useDocumentEvent };

package/dist/es/use-emitter-event/index.js

@@ -0,0 +1,13 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import "@vef-framework-react/shared";
+import { useEffect as e } from "react";
+//#region src/use-emitter-event/index.ts
+function t(t, n, r) {
+	e(() => t.on(n, r), [
+		t,
+		n,
+		r
+	]);
+}
+//#endregion
+export { t as useEmitterEvent };

package/dist/es/use-has-fetching/index.js

@@ -0,0 +1,12 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useIsFetching as e } from "@vef-framework-react/core";
+//#region src/use-has-fetching/index.ts
+function t(t, n) {
+	return e({
+		queryKey: n ? [t, n] : [t],
+		exact: !1,
+		type: "active"
+	}) > 0;
+}
+//#endregion
+export { t as useHasFetching };

package/dist/es/use-has-mutating/index.js

@@ -0,0 +1,11 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useIsMutating as e } from "@vef-framework-react/core";
+//#region src/use-has-mutating/index.ts
+function t(t) {
+	return e({
+		mutationKey: [t],
+		exact: !1
+	}) > 0;
+}
+//#endregion
+export { t as useHasMutating };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
+//#region src/use-is-authorized/index.ts
+function n(n, r) {
+	let { hasPermission: i = () => !0 } = t();
+	return e(i, n, r);
+}
+//#endregion
+export { n as useIsAuthorized };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useRef as e } from "react";
+//#region src/use-latest/index.ts
+function t(t) {
+	let n = e(t);
+	return n.current = t, n;
+}
+//#endregion
+export { t as useLatest };

package/dist/es/use-raf-state/index.js

@@ -0,0 +1,15 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/use-raf-state/index.ts
+function i(i) {
+	let a = n(0), [o, s] = r(i), c = e((e) => {
+		cancelAnimationFrame(a.current), a.current = requestAnimationFrame(() => {
+			s(e);
+		});
+	}, []);
+	return t(() => () => {
+		cancelAnimationFrame(a.current);
+	}, []), [o, c];
+}
+//#endregion
+export { i as useRafState };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useShallowCompare as e } from "../use-shallow-compare/index.js";
+import { useCallback as t } from "react";
+//#region src/use-shallow-callback/index.ts
+function n(n, r) {
+	return t(n, e(r));
+}
+//#endregion
+export { n as useShallowCallback };

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

@@ -0,0 +1,17 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { isShallowEqual as e } from "@vef-framework-react/shared";
+import { useRef as t } from "react";
+//#region src/use-shallow-compare/index.ts
+function n(e) {
+	let n = t(void 0), i = t(0);
+	return r(n.current, e) || (n.current = e, i.current += 1), [i.current];
+}
+function r(t, n) {
+	if (t === void 0 || n === void 0) return !1;
+	if (t === n) return !0;
+	if (t.length !== n.length) return !1;
+	for (let [r, i] of t.entries()) if (!e(i, n[r])) return !1;
+	return !0;
+}
+//#endregion
+export { n as useShallowCompare };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useShallowCompare as e } from "../use-shallow-compare/index.js";
+import { useEffect as t } from "react";
+//#region src/use-shallow-effect/index.ts
+function n(n, r) {
+	t(n, e(r));
+}
+//#endregion
+export { n as useShallowEffect };

package/dist/es/use-shallow-isomorphic-effect/index.js

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useIsomorphicEffect as e } from "../lib.js";
+import { useShallowCompare as t } from "../use-shallow-compare/index.js";
+//#region src/use-shallow-isomorphic-effect/index.ts
+function n(n, r) {
+	e(n, t(r));
+}
+//#endregion
+export { n as useShallowIsomorphicEffect };

package/dist/es/use-shallow-layout-effect/index.js

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useShallowCompare as e } from "../use-shallow-compare/index.js";
+import { useLayoutEffect as t } from "react";
+//#region src/use-shallow-layout-effect/index.ts
+function n(n, r) {
+	t(n, e(r));
+}
+//#endregion
+export { n as useShallowLayoutEffect };

package/dist/es/use-shallow-memo/index.js

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useShallowCompare as e } from "../use-shallow-compare/index.js";
+import { useMemo as t } from "react";
+//#region src/use-shallow-memo/index.ts
+function n(n, r) {
+	return t(n, e(r));
+}
+//#endregion
+export { n as useShallowMemo };

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

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useRef as e } from "react";
+//#region src/use-singleton/index.ts
+function t(t) {
+	let n = e(void 0);
+	return n.current === void 0 && (n.current = t()), n;
+}
+//#endregion
+export { t as useSingleton };

package/dist/es/use-viewport-size/index.js

@@ -0,0 +1,34 @@
+/*! @vef-framework-react/hooks v2.1.0 made by Venus | 2026-03-27T08:01:42.568Z */
+import { useWindowEvent as e } from "../lib.js";
+import { useRafState as t } from "../use-raf-state/index.js";
+import { isUndefined as n } from "@vef-framework-react/shared";
+import { useEffect as r } from "react";
+//#region src/use-viewport-size/index.ts
+var i = { passive: !0 };
+function a() {
+	let a = !n(globalThis.window), [o, s] = t(() => ({
+		width: a ? window.innerWidth : 0,
+		height: a ? window.innerHeight : 0
+	}));
+	return r(() => {
+		function e() {
+			n(globalThis.window) || s({
+				width: window.innerWidth,
+				height: window.innerHeight
+			});
+		}
+		e();
+	}, [s]), e("resize", () => {
+		n(globalThis.window) || s({
+			width: window.innerWidth,
+			height: window.innerHeight
+		});
+	}, i), e("orientationchange", () => {
+		n(globalThis.window) || s({
+			width: window.innerWidth,
+			height: window.innerHeight
+		});
+	}, i), o;
+}
+//#endregion
+export { a as useViewportSize };