@vef-framework-react/hooks 2.1.12 → 2.2.0

package/dist/cjs/index.cjs

@@ -1 +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-options/index.cjs`),a=require(`./use-deep-compare/index.cjs`),o=require(`./use-deep-callback/index.cjs`),s=require(`./use-deep-effect/index.cjs`),c=require(`./use-deep-isomorphic-effect/index.cjs`),l=require(`./use-deep-layout-effect/index.cjs`),u=require(`./use-deep-memo/index.cjs`),d=require(`./use-dictionary-query/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(`react-hotkeys-hook`),O=require(`@mantine/hooks`);Object.defineProperty(exports,`HotkeysProvider`,{enumerable:!0,get:function(){return D.HotkeysProvider}}),Object.defineProperty(exports,`assignRef`,{enumerable:!0,get:function(){return O.assignRef}}),Object.defineProperty(exports,`getHotkeyHandler`,{enumerable:!0,get:function(){return O.getHotkeyHandler}}),Object.defineProperty(exports,`mergeRefs`,{enumerable:!0,get:function(){return O.mergeRefs}}),exports.resolveDictKey=d.resolveDictKey,exports.useAuthorizedItems=t.useAuthorizedItems,exports.useBreakpoints=n.useBreakpoints,exports.useCheckPermission=r.useCheckPermission,exports.useColorScheme=e.useColorScheme,exports.useDataOptionsQuery=i.useDataOptionsQuery,Object.defineProperty(exports,`useDebouncedCallback`,{enumerable:!0,get:function(){return O.useDebouncedCallback}}),Object.defineProperty(exports,`useDebouncedState`,{enumerable:!0,get:function(){return O.useDebouncedState}}),Object.defineProperty(exports,`useDebouncedValue`,{enumerable:!0,get:function(){return O.useDebouncedValue}}),exports.useDeepCallback=o.useDeepCallback,exports.useDeepCompare=a.useDeepCompare,exports.useDeepEffect=s.useDeepEffect,exports.useDeepIsomorphicEffect=c.useDeepIsomorphicEffect,exports.useDeepLayoutEffect=l.useDeepLayoutEffect,exports.useDeepMemo=u.useDeepMemo,exports.useDictionaryQuery=d.useDictionaryQuery,Object.defineProperty(exports,`useDidUpdate`,{enumerable:!0,get:function(){return O.useDidUpdate}}),exports.useDocumentEvent=p.useDocumentEvent,Object.defineProperty(exports,`useDocumentTitle`,{enumerable:!0,get:function(){return O.useDocumentTitle}}),exports.useElementSize=e.useElementSize,exports.useEmitterEvent=m.useEmitterEvent,Object.defineProperty(exports,`useEventListener`,{enumerable:!0,get:function(){return O.useEventListener}}),Object.defineProperty(exports,`useFocusTrap`,{enumerable:!0,get:function(){return O.useFocusTrap}}),Object.defineProperty(exports,`useFullscreenDocument`,{enumerable:!0,get:function(){return O.useFullscreenDocument}}),exports.useHasFetching=h.useHasFetching,exports.useHasMutating=g.useHasMutating,Object.defineProperty(exports,`useHotkeys`,{enumerable:!0,get:function(){return D.useHotkeys}}),Object.defineProperty(exports,`useHotkeysContext`,{enumerable:!0,get:function(){return D.useHotkeysContext}}),Object.defineProperty(exports,`useIntersection`,{enumerable:!0,get:function(){return O.useIntersection}}),Object.defineProperty(exports,`useInterval`,{enumerable:!0,get:function(){return O.useInterval}}),exports.useIsAuthorized=_.useIsAuthorized,Object.defineProperty(exports,`useIsFirstRender`,{enumerable:!0,get:function(){return O.useIsFirstRender}}),Object.defineProperty(exports,`useIsomorphicEffect`,{enumerable:!0,get:function(){return O.useIsomorphicEffect}}),exports.useLatest=f.useLatest,exports.useMediaQuery=e.useMediaQuery,Object.defineProperty(exports,`useMergedRef`,{enumerable:!0,get:function(){return O.useMergedRef}}),Object.defineProperty(exports,`useMounted`,{enumerable:!0,get:function(){return O.useMounted}}),Object.defineProperty(exports,`useMutationObserverTarget`,{enumerable:!0,get:function(){return O.useMutationObserverTarget}}),Object.defineProperty(exports,`usePrevious`,{enumerable:!0,get:function(){return O.usePrevious}}),exports.useRafState=v.useRafState,Object.defineProperty(exports,`useRecordHotkeys`,{enumerable:!0,get:function(){return D.useRecordHotkeys}}),exports.useReducedMotion=e.useReducedMotion,Object.defineProperty(exports,`useResizeObserver`,{enumerable:!0,get:function(){return O.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 O.useTimeout}}),exports.useViewportSize=E.useViewportSize,Object.defineProperty(exports,`useWindowEvent`,{enumerable:!0,get:function(){return O.useWindowEvent}});
+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-options/index.cjs`),a=require(`./use-deep-compare/index.cjs`),o=require(`./use-deep-callback/index.cjs`),s=require(`./use-deep-effect/index.cjs`),c=require(`./use-deep-isomorphic-effect/index.cjs`),l=require(`./use-deep-layout-effect/index.cjs`),u=require(`./use-deep-memo/index.cjs`),d=require(`./use-dictionary-query/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-upload/index.cjs`),D=require(`./use-viewport-size/index.cjs`);let O=require(`react-hotkeys-hook`),k=require(`@mantine/hooks`);Object.defineProperty(exports,`HotkeysProvider`,{enumerable:!0,get:function(){return O.HotkeysProvider}}),Object.defineProperty(exports,`assignRef`,{enumerable:!0,get:function(){return k.assignRef}}),Object.defineProperty(exports,`getHotkeyHandler`,{enumerable:!0,get:function(){return k.getHotkeyHandler}}),Object.defineProperty(exports,`mergeRefs`,{enumerable:!0,get:function(){return k.mergeRefs}}),exports.resolveDictKey=d.resolveDictKey,exports.useAuthorizedItems=t.useAuthorizedItems,exports.useBreakpoints=n.useBreakpoints,exports.useCheckPermission=r.useCheckPermission,exports.useColorScheme=e.useColorScheme,exports.useDataOptionsQuery=i.useDataOptionsQuery,Object.defineProperty(exports,`useDebouncedCallback`,{enumerable:!0,get:function(){return k.useDebouncedCallback}}),Object.defineProperty(exports,`useDebouncedState`,{enumerable:!0,get:function(){return k.useDebouncedState}}),Object.defineProperty(exports,`useDebouncedValue`,{enumerable:!0,get:function(){return k.useDebouncedValue}}),exports.useDeepCallback=o.useDeepCallback,exports.useDeepCompare=a.useDeepCompare,exports.useDeepEffect=s.useDeepEffect,exports.useDeepIsomorphicEffect=c.useDeepIsomorphicEffect,exports.useDeepLayoutEffect=l.useDeepLayoutEffect,exports.useDeepMemo=u.useDeepMemo,exports.useDictionaryQuery=d.useDictionaryQuery,Object.defineProperty(exports,`useDidUpdate`,{enumerable:!0,get:function(){return k.useDidUpdate}}),exports.useDocumentEvent=p.useDocumentEvent,Object.defineProperty(exports,`useDocumentTitle`,{enumerable:!0,get:function(){return k.useDocumentTitle}}),exports.useElementSize=e.useElementSize,exports.useEmitterEvent=m.useEmitterEvent,Object.defineProperty(exports,`useEventListener`,{enumerable:!0,get:function(){return k.useEventListener}}),Object.defineProperty(exports,`useFocusTrap`,{enumerable:!0,get:function(){return k.useFocusTrap}}),Object.defineProperty(exports,`useFullscreenDocument`,{enumerable:!0,get:function(){return k.useFullscreenDocument}}),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 k.useIntersection}}),Object.defineProperty(exports,`useInterval`,{enumerable:!0,get:function(){return k.useInterval}}),exports.useIsAuthorized=_.useIsAuthorized,Object.defineProperty(exports,`useIsFirstRender`,{enumerable:!0,get:function(){return k.useIsFirstRender}}),Object.defineProperty(exports,`useIsomorphicEffect`,{enumerable:!0,get:function(){return k.useIsomorphicEffect}}),exports.useLatest=f.useLatest,exports.useMediaQuery=e.useMediaQuery,Object.defineProperty(exports,`useMergedRef`,{enumerable:!0,get:function(){return k.useMergedRef}}),Object.defineProperty(exports,`useMounted`,{enumerable:!0,get:function(){return k.useMounted}}),Object.defineProperty(exports,`useMutationObserverTarget`,{enumerable:!0,get:function(){return k.useMutationObserverTarget}}),Object.defineProperty(exports,`usePrevious`,{enumerable:!0,get:function(){return k.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 k.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 k.useTimeout}}),exports.useUpload=E.useUpload,exports.useViewportSize=D.useViewportSize,Object.defineProperty(exports,`useWindowEvent`,{enumerable:!0,get:function(){return k.useWindowEvent}});

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

@@ -0,0 +1 @@
+const e=require(`../use-latest/index.cjs`);let t=require(`@vef-framework-react/core`),n=require(`react`);var r=new Set([`initializing`,`uploading`,`completing`,`aborting`]);function i(){return typeof crypto<`u`&&crypto.subtle!==void 0?new t.PrefixFingerprinter:new t.WeakFingerprinter}function a(){return{status:`idle`,progress:{loaded:0,total:0,partsCompleted:0,partsTotal:0,percent:0},error:null,result:null}}function o(o={}){let s=(0,t.useApiClient)()[t.HTTP_CLIENT],c=e.useLatest(o),l=(0,n.useRef)(a()),u=(0,n.useRef)(new Set),d=(0,n.useRef)(null),f=(0,n.useRef)(0),p=(0,n.useRef)(null),m=(0,n.useCallback)(e=>(u.current.add(e),()=>{u.current.delete(e)}),[]),h=(0,n.useCallback)(()=>l.current,[]),g=(0,n.useCallback)(e=>{l.current={...l.current,...e};for(let e of u.current)e()},[]),_=(0,n.useCallback)(async(e,n)=>{let a=c.current,o=++f.current,l=()=>f.current!==o;p.current?.abort();let u=new AbortController;p.current=u;let m=e instanceof File&&a.persistence!==null,h=m?a.persistence??new t.LocalStoragePersistence:null,_=m?a.fingerprinter??i():null,v={http:s,apiPath:a.apiPath??t.STORAGE_API_PATH,resource:a.resource??t.STORAGE_RESOURCE,version:a.version??t.STORAGE_VERSION},y=m&&e instanceof File&&_?await _.fingerprint(e):null;if(l())throw new t.UploadAbortedError;let b=m&&h&&y?await(0,t.resolveResumePlan)({fingerprint:y,persistence:h,ctx:v,onResumeDetected:a.onResumeDetected,signal:u.signal}):void 0;if(l())throw new t.UploadAbortedError;let x=new t.Uploader(s,e,{...a,init:{...a.init,...n},onStatusChange:e=>{d.current===x&&(h&&y&&(e===`succeeded`||e===`aborted`)&&h.remove(y),g({status:e}),a.onStatusChange?.(e))},onProgress:e=>{d.current===x&&(g({progress:e}),a.onProgress?.(e))},onSessionOpened:e=>{d.current===x&&h&&y&&h.save({fingerprint:y,claimId:e.claimId,key:e.key,partSize:e.partSize,partCount:e.partCount,expiresAt:e.expiresAt,savedAt:Date.now()})}}),S=d.current;if(d.current=x,S&&r.has(S.status)&&await S.abort(),l())throw d.current===x&&(d.current=S),new t.UploadAbortedError;g({status:`idle`,progress:{loaded:0,total:e.size,partsCompleted:0,partsTotal:0,percent:0},error:null,result:null});try{let e=await x.start(b);return g({result:e}),a.onSuccess?.(e),e}catch(e){let t=e;throw b?.kind===`resume`&&h&&y&&d.current===x&&h.remove(y),d.current===x&&(g({error:t}),a.onError?.(t)),t}},[s,g,c]),v=(0,n.useCallback)(()=>{p.current?.abort();let{current:e}=d;e&&r.has(e.status)&&e.abort()},[]),y=(0,n.useCallback)(()=>{f.current++,p.current?.abort();let{current:e}=d;e&&r.has(e.status)&&e.abort(),d.current=null,g(a())},[g]);(0,n.useEffect)(()=>()=>{p.current?.abort();let{current:e}=d;e&&r.has(e.status)&&e.abort()},[]);let b=(0,n.useSyncExternalStore)(m,h,h);return(0,n.useMemo)(()=>({upload:_,abort:v,reset:y,status:b.status,progress:b.progress,error:b.error,result:b.result,isUploading:r.has(b.status)}),[_,v,y,b])}exports.useUpload=o;

package/dist/es/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { HotkeysProvider as e, assignRef as t, getHotkeyHandler as n, mergeRefs as r, useColorScheme as i, useDebouncedCallback as a, useDebouncedState as o, useDebouncedValue as s, useDidUpdate as c, useDocumentTitle as l, useElementSize as u, useEventListener as d, useFocusTrap as f, useFullscreenDocument as p, useHotkeys as m, useHotkeysContext as h, useIntersection as g, useInterval as _, useIsFirstRender as v, useIsomorphicEffect as y, useMediaQuery as b, useMergedRef as x, useMounted as S, useMutationObserverTarget as C, usePrevious as w, useRecordHotkeys as T, useReducedMotion as E, useResizeObserver as D, useTimeout as O, useWindowEvent as k } from "./lib.js";
 import { useAuthorizedItems as A } from "./use-authorized-items/index.js";
 import { useBreakpoints as j } from "./use-breakpoints/index.js";
@@ -25,5 +25,6 @@ import { useShallowIsomorphicEffect as Q } from "./use-shallow-isomorphic-effect
 import { useShallowLayoutEffect as $ } from "./use-shallow-layout-effect/index.js";
 import { useShallowMemo as ee } from "./use-shallow-memo/index.js";
 import { useSingleton as te } from "./use-singleton/index.js";
-import { useViewportSize as ne } from "./use-viewport-size/index.js";
-export { e as HotkeysProvider, t as assignRef, n as getHotkeyHandler, r as mergeRefs, B as resolveDictKey, A as useAuthorizedItems, j as useBreakpoints, M as useCheckPermission, i as useColorScheme, N as useDataOptionsQuery, a as useDebouncedCallback, o as useDebouncedState, s as useDebouncedValue, F as useDeepCallback, P as useDeepCompare, I as useDeepEffect, L as useDeepIsomorphicEffect, R as useDeepLayoutEffect, z as useDeepMemo, V as useDictionaryQuery, c as useDidUpdate, U as useDocumentEvent, l as useDocumentTitle, u as useElementSize, W as useEmitterEvent, d as useEventListener, f as useFocusTrap, p as useFullscreenDocument, G as useHasFetching, K as useHasMutating, m as useHotkeys, h as useHotkeysContext, g as useIntersection, _ as useInterval, q as useIsAuthorized, v as useIsFirstRender, y as useIsomorphicEffect, H as useLatest, b as useMediaQuery, x as useMergedRef, S as useMounted, C as useMutationObserverTarget, w as usePrevious, J as useRafState, T as useRecordHotkeys, E as useReducedMotion, D as useResizeObserver, X as useShallowCallback, Y as useShallowCompare, Z as useShallowEffect, Q as useShallowIsomorphicEffect, $ as useShallowLayoutEffect, ee as useShallowMemo, te as useSingleton, O as useTimeout, ne as useViewportSize, k as useWindowEvent };
+import { useUpload as ne } from "./use-upload/index.js";
+import { useViewportSize as re } from "./use-viewport-size/index.js";
+export { e as HotkeysProvider, t as assignRef, n as getHotkeyHandler, r as mergeRefs, B as resolveDictKey, A as useAuthorizedItems, j as useBreakpoints, M as useCheckPermission, i as useColorScheme, N as useDataOptionsQuery, a as useDebouncedCallback, o as useDebouncedState, s as useDebouncedValue, F as useDeepCallback, P as useDeepCompare, I as useDeepEffect, L as useDeepIsomorphicEffect, R as useDeepLayoutEffect, z as useDeepMemo, V as useDictionaryQuery, c as useDidUpdate, U as useDocumentEvent, l as useDocumentTitle, u as useElementSize, W as useEmitterEvent, d as useEventListener, f as useFocusTrap, p as useFullscreenDocument, G as useHasFetching, K as useHasMutating, m as useHotkeys, h as useHotkeysContext, g as useIntersection, _ as useInterval, q as useIsAuthorized, v as useIsFirstRender, y as useIsomorphicEffect, H as useLatest, b as useMediaQuery, x as useMergedRef, S as useMounted, C as useMutationObserverTarget, w as usePrevious, J as useRafState, T as useRecordHotkeys, E as useReducedMotion, D as useResizeObserver, X as useShallowCallback, Y as useShallowCompare, Z as useShallowEffect, Q as useShallowIsomorphicEffect, $ as useShallowLayoutEffect, ee as useShallowMemo, te as useSingleton, O as useTimeout, ne as useUpload, re as useViewportSize, k as useWindowEvent };

package/dist/es/lib.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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, useFullscreenDocument as f, useIntersection as p, useInterval as m, useIsFirstRender as h, useIsomorphicEffect as g, useMediaQuery as _, useMergedRef as v, useMounted as y, useMutationObserverTarget as b, usePrevious as x, useReducedMotion as S, useResizeObserver as C, useTimeout as w, useWindowEvent as T } from "@mantine/hooks";
 import { HotkeysProvider as E, useHotkeys as D, useHotkeysContext as O, useRecordHotkeys as k } from "react-hotkeys-hook";
 //#region src/lib.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
 //#region src/use-authorized-items/index.ts
 function n(n) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
 //#region src/use-check-permission/index.ts
 function n() {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useQuery as e } from "@vef-framework-react/core";
 import { get as t, isEmpty as n, isFunction as r, isNullish as i, withPinyin as a } from "@vef-framework-react/shared";
 import { useMemo as o } from "react";

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useDeepCompare as e } from "../use-deep-compare/index.js";
 import { useCallback as t } from "react";
 //#region src/use-deep-callback/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { isDeepEqual as e } from "@vef-framework-react/shared";
 import { useRef as t } from "react";
 //#region src/use-deep-compare/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useDeepCompare as e } from "../use-deep-compare/index.js";
 import { useEffect as t } from "react";
 //#region src/use-deep-effect/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useDeepCompare as e } from "../use-deep-compare/index.js";
 import { useLayoutEffect as t } from "react";
 //#region src/use-deep-layout-effect/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useDeepCompare as e } from "../use-deep-compare/index.js";
 import { useMemo as t } from "react";
 //#region src/use-deep-memo/index.ts

package/dist/es/use-dictionary-query/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { skipQueryToken as e, useAppContext as t, useQuery as n } from "@vef-framework-react/core";
 import { isFunction as r, isString as i } from "@vef-framework-react/shared";
 import { useCallback as a, useMemo as o } from "react";

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useLatest as e } from "../use-latest/index.js";
 import { useEffect as t } from "react";
 //#region src/use-document-event/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import "@vef-framework-react/shared";
 import { useEffect as e } from "react";
 //#region src/use-emitter-event/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useIsFetching as e } from "@vef-framework-react/core";
 //#region src/use-has-fetching/index.ts
 function t(t, n) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useIsMutating as e } from "@vef-framework-react/core";
 //#region src/use-has-mutating/index.ts
 function t(t) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { checkPermission as e, useAppContext as t } from "@vef-framework-react/core";
 //#region src/use-is-authorized/index.ts
 function n(n, r) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useRef as e } from "react";
 //#region src/use-latest/index.ts
 function t(t) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useShallowCompare as e } from "../use-shallow-compare/index.js";
 import { useCallback as t } from "react";
 //#region src/use-shallow-callback/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { isShallowEqual as e } from "@vef-framework-react/shared";
 import { useRef as t } from "react";
 //#region src/use-shallow-compare/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useShallowCompare as e } from "../use-shallow-compare/index.js";
 import { useEffect as t } from "react";
 //#region src/use-shallow-effect/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useShallowCompare as e } from "../use-shallow-compare/index.js";
 import { useLayoutEffect as t } from "react";
 //#region src/use-shallow-layout-effect/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useShallowCompare as e } from "../use-shallow-compare/index.js";
 import { useMemo as t } from "react";
 //#region src/use-shallow-memo/index.ts

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 import { useRef as e } from "react";
 //#region src/use-singleton/index.ts
 function t(t) {

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

@@ -0,0 +1,138 @@
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
+import { useLatest as e } from "../use-latest/index.js";
+import { HTTP_CLIENT as t, LocalStoragePersistence as n, PrefixFingerprinter as r, STORAGE_API_PATH as i, STORAGE_RESOURCE as a, STORAGE_VERSION as o, UploadAbortedError as s, Uploader as c, WeakFingerprinter as l, resolveResumePlan as u, useApiClient as d } from "@vef-framework-react/core";
+import { useCallback as f, useEffect as p, useMemo as m, useRef as h, useSyncExternalStore as g } from "react";
+//#region src/use-upload/index.ts
+var _ = new Set([
+	"initializing",
+	"uploading",
+	"completing",
+	"aborting"
+]);
+function v() {
+	return typeof crypto < "u" && crypto.subtle !== void 0 ? new r() : new l();
+}
+function y() {
+	return {
+		status: "idle",
+		progress: {
+			loaded: 0,
+			total: 0,
+			partsCompleted: 0,
+			partsTotal: 0,
+			percent: 0
+		},
+		error: null,
+		result: null
+	};
+}
+function b(r = {}) {
+	let l = d()[t], b = e(r), x = h(y()), S = h(/* @__PURE__ */ new Set()), C = h(null), w = h(0), T = h(null), E = f((e) => (S.current.add(e), () => {
+		S.current.delete(e);
+	}), []), D = f(() => x.current, []), O = f((e) => {
+		x.current = {
+			...x.current,
+			...e
+		};
+		for (let e of S.current) e();
+	}, []), k = f(async (e, t) => {
+		let r = b.current, d = ++w.current, f = () => w.current !== d;
+		T.current?.abort();
+		let p = new AbortController();
+		T.current = p;
+		let m = e instanceof File && r.persistence !== null, h = m ? r.persistence ?? new n() : null, g = m ? r.fingerprinter ?? v() : null, y = {
+			http: l,
+			apiPath: r.apiPath ?? i,
+			resource: r.resource ?? a,
+			version: r.version ?? o
+		}, x = m && e instanceof File && g ? await g.fingerprint(e) : null;
+		if (f()) throw new s();
+		let S = m && h && x ? await u({
+			fingerprint: x,
+			persistence: h,
+			ctx: y,
+			onResumeDetected: r.onResumeDetected,
+			signal: p.signal
+		}) : void 0;
+		if (f()) throw new s();
+		let E = new c(l, e, {
+			...r,
+			init: {
+				...r.init,
+				...t
+			},
+			onStatusChange: (e) => {
+				C.current === E && (h && x && (e === "succeeded" || e === "aborted") && h.remove(x), O({ status: e }), r.onStatusChange?.(e));
+			},
+			onProgress: (e) => {
+				C.current === E && (O({ progress: e }), r.onProgress?.(e));
+			},
+			onSessionOpened: (e) => {
+				C.current === E && h && x && h.save({
+					fingerprint: x,
+					claimId: e.claimId,
+					key: e.key,
+					partSize: e.partSize,
+					partCount: e.partCount,
+					expiresAt: e.expiresAt,
+					savedAt: Date.now()
+				});
+			}
+		}), D = C.current;
+		if (C.current = E, D && _.has(D.status) && await D.abort(), f()) throw C.current === E && (C.current = D), new s();
+		O({
+			status: "idle",
+			progress: {
+				loaded: 0,
+				total: e.size,
+				partsCompleted: 0,
+				partsTotal: 0,
+				percent: 0
+			},
+			error: null,
+			result: null
+		});
+		try {
+			let e = await E.start(S);
+			return O({ result: e }), r.onSuccess?.(e), e;
+		} catch (e) {
+			let t = e;
+			throw S?.kind === "resume" && h && x && C.current === E && h.remove(x), C.current === E && (O({ error: t }), r.onError?.(t)), t;
+		}
+	}, [
+		l,
+		O,
+		b
+	]), A = f(() => {
+		T.current?.abort();
+		let { current: e } = C;
+		e && _.has(e.status) && e.abort();
+	}, []), j = f(() => {
+		w.current++, T.current?.abort();
+		let { current: e } = C;
+		e && _.has(e.status) && e.abort(), C.current = null, O(y());
+	}, [O]);
+	p(() => () => {
+		T.current?.abort();
+		let { current: e } = C;
+		e && _.has(e.status) && e.abort();
+	}, []);
+	let M = g(E, D, D);
+	return m(() => ({
+		upload: k,
+		abort: A,
+		reset: j,
+		status: M.status,
+		progress: M.progress,
+		error: M.error,
+		result: M.result,
+		isUploading: _.has(M.status)
+	}), [
+		k,
+		A,
+		j,
+		M
+	]);
+}
+//#endregion
+export { b as useUpload };

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.12 made by Venus | 2026-05-07T08:00:45.325Z */
+/*! @vef-framework-react/hooks v2.2.0 made by Venus | 2026-05-18T05:49:14.786Z */
 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";

package/dist/types/index.d.ts

@@ -24,4 +24,5 @@ export { useShallowIsomorphicEffect } from './use-shallow-isomorphic-effect';
 export { useShallowLayoutEffect } from './use-shallow-layout-effect';
 export { useShallowMemo } from './use-shallow-memo';
 export { useSingleton } from './use-singleton';
+export { useUpload, type UseUploadOptions, type UseUploadResult } from './use-upload';
 export { useViewportSize } from './use-viewport-size';

package/dist/types/use-upload/index.d.ts

@@ -0,0 +1,98 @@
+import { FileFingerprinter, ResumablePersistence, ResumeDecisionHandler, UploaderOptions, UploadError, UploadInit, UploadProgress, UploadResult, UploadStatus } from '@vef-framework-react/core';
+/**
+ * Configuration accepted by `useUpload`. Mirrors the headless
+ * `UploaderOptions` minus the fields that React owns (`signal` is managed
+ * internally, `onProgress` / `onStatusChange` are forwarded). Adds the
+ * familiar `onSuccess` / `onError` lifecycle callbacks consumers expect.
+ */
+export interface UseUploadOptions extends Omit<UploaderOptions, "signal" | "onProgress" | "onStatusChange" | "onSessionOpened"> {
+    /**
+     * Fires on every aggregated progress tick.
+     */
+    onProgress?: (progress: UploadProgress) => void;
+    /**
+     * Fires on every Uploader status transition.
+     */
+    onStatusChange?: (status: UploadStatus) => void;
+    /**
+     * Fires once when the upload completes successfully.
+     */
+    onSuccess?: (result: UploadResult) => void;
+    /**
+     * Fires once on any terminal failure (including aborts).
+     */
+    onError?: (error: UploadError) => void;
+    /**
+     * Persistence layer for resumable-upload records. When omitted, a
+     * `LocalStoragePersistence` is used. Pass a custom implementation to
+     * route records into IndexedDB, a tenant-namespaced backend, or a
+     * server-side session store. Pass `null` to disable resume entirely.
+     */
+    persistence?: ResumablePersistence | null;
+    /**
+     * Fingerprinting strategy used to identify a file across sessions.
+     * Defaults to `PrefixFingerprinter` (SHA-256 of name + size +
+     * lastModified + first 4 MiB) when `crypto.subtle` is available, with
+     * `WeakFingerprinter` (name + size + lastModified only) as the
+     * fallback. Override to plug in a different policy (e.g. full-file
+     * SHA-256 inside a Web Worker).
+     */
+    fingerprinter?: FileFingerprinter;
+    /**
+     * Decision handler invoked when a resume candidate is found. Receives
+     * the persisted record and the live `list_parts` result so the UI can
+     * present a meaningful confirmation. The default — when omitted — is
+     * `"discard"`: resuming the wrong file is worse than re-uploading.
+     */
+    onResumeDetected?: ResumeDecisionHandler;
+}
+/**
+ * Reactive snapshot the hook exposes to its caller. The `error` and
+ * `result` fields are mutually exclusive: at most one is non-null in any
+ * terminal state.
+ */
+export interface UseUploadResult {
+    /**
+     * Start a new upload. Cancels any upload still in flight.
+     */
+    upload: (file: File | Blob, init?: UploadInit) => Promise<UploadResult>;
+    /**
+     * Cancel the in-flight upload, if any. No-op when idle / terminal.
+     */
+    abort: () => void;
+    /**
+     * Clear state and detach the current Uploader.
+     */
+    reset: () => void;
+    /**
+     * Current Uploader status. `"idle"` between resets.
+     */
+    status: UploadStatus;
+    /**
+     * Latest aggregated progress; zeroed between resets.
+     */
+    progress: UploadProgress;
+    /**
+     * Terminal error, when status is `"failed"`.
+     */
+    error: UploadError | null;
+    /**
+     * Terminal result, when status is `"succeeded"`.
+     */
+    result: UploadResult | null;
+    /**
+     * Convenience: status is one of initializing/uploading/completing/aborting.
+     */
+    isUploading: boolean;
+}
+/**
+ * Drive a single chunked upload through `vef-framework-go`'s `sys/storage`
+ * RPC. Returns a snapshot of upload state plus imperative `upload` / `abort`
+ * / `reset` handles. One in-flight upload at a time; calling `upload` again
+ * cancels the previous run.
+ *
+ * For batch uploads (multiple files in parallel) reach for the headless
+ * `Uploader` class from `@vef-framework-react/core` directly — this hook is
+ * a thin React adapter intentionally scoped to a single upload per consumer.
+ */
+export declare function useUpload(options?: UseUploadOptions): UseUploadResult;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework-react/hooks",
   "type": "module",
-  "version": "2.1.12",
+  "version": "2.2.0",
   "private": false,
   "description": "Hooks for VEF framework",
   "author": {
@@ -48,13 +48,13 @@
     "react": ">=19"
   },
   "dependencies": {
-    "@mantine/hooks": "^9.1.0",
-    "react-hotkeys-hook": "^5.2.4",
-    "@vef-framework-react/core": "2.1.12",
-    "@vef-framework-react/shared": "2.1.12"
+    "@mantine/hooks": "^9.2.1",
+    "react-hotkeys-hook": "^5.3.2",
+    "@vef-framework-react/shared": "2.2.0",
+    "@vef-framework-react/core": "2.2.0"
   },
   "devDependencies": {
-    "react": "^19.2.5"
+    "react": "^19.2.6"
   },
   "scripts": {
     "clean": "rimraf dist",