@vef-framework-react/hooks 2.1.8 → 2.1.10

package/dist/cjs/use-dictionary-query/index.cjs

@@ -1 +1 @@
-let e=require(`@vef-framework-react/core`),t=require(`@vef-framework-react/shared`),n=require(`react`);function r(e){return(0,t.isString)(e)?e:e.key}function i(i){let{dictionaryQueryFn:a}=(0,e.useAppContext)();if(!(0,t.isFunction)(a))throw Error(`Dictionary query function is not provided in the app context.`);let o=(0,n.useMemo)(()=>[...new Set(Object.values(i).map(e=>r(e)))].toSorted(),[i]),s=(0,e.useQuery)({queryFn:o.length===0?e.skipQueryToken:a,queryKey:[a.key,o],staleTime:1/0}),c=(0,n.useMemo)(()=>Object.fromEntries(Object.entries(i).map(([e,t])=>[e,s.data?.[r(t)]??[]])),[i,s.data]),{data:l,isFetching:u,isSuccess:d}=s;return{data:c,isFetching:u,isSuccess:d}}exports.resolveDictKey=r,exports.useDictionaryQuery=i;
+let e=require(`@vef-framework-react/core`),t=require(`@vef-framework-react/shared`),n=require(`react`);function r(e){return(0,t.isString)(e)?e:e.key}function i(i,a){let{dictionaryQueryFn:o}=(0,e.useAppContext)();if(!(0,t.isFunction)(o))throw Error(`Dictionary query function is not provided in the app context.`);let{enabled:s,select:c}=a??{},l=(0,n.useMemo)(()=>[...new Set(Object.values(i).map(e=>r(e)))].toSorted(),[i]),u=(0,n.useCallback)(e=>{let t=Object.fromEntries(Object.entries(i).map(([t,n])=>[t,e[r(n)]??[]]));return c?c(t):t},[i,c]);return(0,e.useQuery)({queryFn:l.length===0?e.skipQueryToken:o,queryKey:[o.key,l],enabled:s,select:u,staleTime:1/0})}exports.resolveDictKey=r,exports.useDictionaryQuery=i;

package/dist/es/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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, useFullscreenDocument 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, useMutationObserverTarget 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";

package/dist/es/lib.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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 { 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";

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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,24 +1,25 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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 { useMemo as a } from "react";
+import { useCallback as a, useMemo as o } from "react";
 //#region src/use-dictionary-query/index.ts
-function o(e) {
+function s(e) {
 	return i(e) ? e : e.key;
 }
-function s(i) {
-	let { dictionaryQueryFn: s } = t();
-	if (!r(s)) throw Error("Dictionary query function is not provided in the app context.");
-	let c = a(() => [...new Set(Object.values(i).map((e) => o(e)))].toSorted(), [i]), l = n({
-		queryFn: c.length === 0 ? e : s,
-		queryKey: [s.key, c],
+function c(i, c) {
+	let { dictionaryQueryFn: l } = t();
+	if (!r(l)) throw Error("Dictionary query function is not provided in the app context.");
+	let { enabled: u, select: d } = c ?? {}, f = o(() => [...new Set(Object.values(i).map((e) => s(e)))].toSorted(), [i]), p = a((e) => {
+		let t = Object.fromEntries(Object.entries(i).map(([t, n]) => [t, e[s(n)] ?? []]));
+		return d ? d(t) : t;
+	}, [i, d]);
+	return n({
+		queryFn: f.length === 0 ? e : l,
+		queryKey: [l.key, f],
+		enabled: u,
+		select: p,
 		staleTime: Infinity
-	}), u = a(() => Object.fromEntries(Object.entries(i).map(([e, t]) => [e, l.data?.[o(t)] ?? []])), [i, l.data]), { data: d, isFetching: f, isSuccess: p } = l;
-	return {
-		data: u,
-		isFetching: f,
-		isSuccess: p
-	};
+	});
 }
 //#endregion
-export { o as resolveDictKey, s as useDictionaryQuery };
+export { s as resolveDictKey, c as useDictionaryQuery };

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 import { useRef as e } from "react";
 //#region src/use-singleton/index.ts
 function t(t) {

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

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/hooks v2.1.8 made by Venus | 2026-04-25T10:51:13.828Z */
+/*! @vef-framework-react/hooks v2.1.10 made by Venus | 2026-04-27T08:58:15.697Z */
 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

@@ -9,7 +9,7 @@ export { useDeepEffect } from './use-deep-effect';
 export { useDeepIsomorphicEffect } from './use-deep-isomorphic-effect';
 export { useDeepLayoutEffect } from './use-deep-layout-effect';
 export { useDeepMemo } from './use-deep-memo';
-export { resolveDictKey, useDictionaryQuery, type DictionaryAliasMap, type DictionaryKeyConfig, type DictionaryKeyValue, type UseDictionaryQueryResult } from './use-dictionary-query';
+export { resolveDictKey, useDictionaryQuery, type DictionaryAliasMap, type DictionaryKeyConfig, type DictionaryKeyValue, type DictionaryQueryData, type UseDictionaryQueryOptions } from './use-dictionary-query';
 export { useDocumentEvent } from './use-document-event';
 export { useEmitterEvent } from './use-emitter-event';
 export { useHasFetching } from './use-has-fetching';

package/dist/types/use-dictionary-query/index.d.ts

@@ -1,5 +1,4 @@
-import { DataOption } from '@vef-framework-react/core';
-import { Simplify } from '@vef-framework-react/shared';
+import { DataOption, UseQueryResult } from '@vef-framework-react/core';
 /**
  * Per-key configuration with dict key and optional overrides.
  */
@@ -22,15 +21,37 @@ export interface DictionaryAliasMap {
  * Extract the actual dict key from a string or config value.
  */
 export declare function resolveDictKey(value: DictionaryKeyValue): string;
-type DictionaryQueryData<T extends DictionaryAliasMap> = Record<Extract<keyof T, string>, DataOption[]>;
-export type UseDictionaryQueryResult<T extends DictionaryAliasMap> = Simplify<{
-    data: DictionaryQueryData<T>;
-    isFetching: boolean;
-    isSuccess: boolean;
-}>;
+export type DictionaryQueryData<T extends DictionaryAliasMap> = Record<Extract<keyof T, string>, DataOption[]>;
+/**
+ * Options for `useDictionaryQuery`.
+ */
+export interface UseDictionaryQueryOptions<T extends DictionaryAliasMap, TData = DictionaryQueryData<T>> {
+    /**
+     * Whether the query is enabled. Pass `false` to defer fetching, e.g.,
+     * while upstream parameters are not yet ready.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Transform the resolved dictionary map into a custom shape.
+     * Runs after alias resolution; its return value becomes `data`.
+     *
+     * The function is passed through to React Query's `select`, so its identity
+     * affects memoization: stabilize it with `useCallback` in the caller when
+     * the enclosing component re-renders frequently.
+     */
+    select?: (data: DictionaryQueryData<T>) => TData;
+}
 /**
  * Query data dictionaries and map them back to alias keys.
  * Uses the `dictionaryQueryFn` from app context.
+ *
+ * `data` follows React Query's native semantics: it is `undefined` until the
+ * query resolves successfully, so callers must guard against `undefined`.
+ *
+ * Callers own the reference stability of `keys` and `options.select`: hold
+ * them in module scope, `as const`, `useMemo`, or `useCallback` as needed to
+ * avoid invalidating React Query's `select` memoization on every render.
  */
-export declare function useDictionaryQuery<const T extends DictionaryAliasMap>(dictionaryKeys: T): UseDictionaryQueryResult<T>;
-export {};
+export declare function useDictionaryQuery<const T extends DictionaryAliasMap, TData = DictionaryQueryData<T>>(keys: T, options?: UseDictionaryQueryOptions<NoInfer<T>, TData>): UseQueryResult<TData>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework-react/hooks",
   "type": "module",
-  "version": "2.1.8",
+  "version": "2.1.10",
   "private": false,
   "description": "Hooks for VEF framework",
   "author": {
@@ -51,8 +51,8 @@
     "@ai-sdk/react": "3.0.170",
     "@mantine/hooks": "^9.1.0",
     "react-hotkeys-hook": "^5.2.4",
-    "@vef-framework-react/core": "2.1.8",
-    "@vef-framework-react/shared": "2.1.8"
+    "@vef-framework-react/core": "2.1.10",
+    "@vef-framework-react/shared": "2.1.10"
   },
   "devDependencies": {
     "react": "^19.2.5"