@vef-framework/core 2.0.11 → 2.1.0

package/dist/es/store/index.js

@@ -1,11 +1,6 @@
-import { createPersistedStore as o, createStore as t } from "./bound.js";
-import { createComponentStore as m } from "./unbound.js";
-import { useDeep as f } from "./use-deep.js";
-import { useShallow as x } from "zustand/shallow";
-export {
-  m as createComponentStore,
-  o as createPersistedStore,
-  t as createStore,
-  f as useDeep,
-  x as useShallow
-};
+/*! @vef-framework/core v2.1.0 made by Venus | 2026-03-27T07:13:02.254Z */
+import "./bound.js";
+import "./unbound.js";
+import "./use-deep.js";
+import { useShallow as e } from "zustand/shallow";
+export { e as useShallow };

package/dist/es/store/unbound.js

@@ -1,51 +1,44 @@
-import { jsx as S } from "@emotion/react/jsx-runtime";
-import { isPlainObject as d, mergeWith as v } from "@vef-framework/shared";
-import { useIsomorphicLayoutEffect as x } from "motion/react";
-import { createContext as g, useRef as u, use as R } from "react";
-import { createStore as y, useStore as C } from "zustand";
-import { subscribeWithSelector as b } from "zustand/middleware";
-import { immer as w } from "zustand/middleware/immer";
-const a = /* @__PURE__ */ new Map();
-function M(i, m) {
-  const s = `${i}StoreContext`;
-  let r = a.get(s);
-  r || (r = g(null), r.displayName = s, a.set(s, r));
-  function l(e) {
-    const { children: o } = e, t = u(null), n = u(!1), c = u(void 0);
-    return c.current = e.initialState, (!t.current || !n.current) && (t.current = y()(
-      b(
-        w(m)
-      )
-    ), n.current = !0), x(() => {
-      d(c.current) && t.current && t.current.setState((h) => {
-        v(
-          h,
-          c.current,
-          !0
-        );
-      });
-    }, []), /* @__PURE__ */ S(r, { value: t.current, children: o });
-  }
-  function f() {
-    const e = R(r);
-    if (!e) {
-      const o = process.env.NODE_ENV === "development", t = `${i}Store is not found in the React context, please check if the store is wrapped in a ${i}StoreProvider`, n = o ? `
-
-Dev hint: If you're seeing this error after hot reload, it might be a React Fast Refresh issue. Try refreshing the page.` : "";
-      throw new Error(t + n);
-    }
-    return e;
-  }
-  function p(e) {
-    const o = f();
-    return C(o, e);
-  }
-  return {
-    StoreProvider: l,
-    useStoreApi: f,
-    useStore: p
-  };
+/*! @vef-framework/core v2.1.0 made by Venus | 2026-03-27T07:13:02.254Z */
+import { isPlainObject as e, mergeWith as t } from "@vef-framework/shared";
+import { createContext as n, use as r, useRef as i } from "react";
+import { jsx as a } from "@emotion/react/jsx-runtime";
+import { useIsomorphicLayoutEffect as o } from "motion/react";
+import { createStore as s, useStore as c } from "zustand";
+import { subscribeWithSelector as l } from "zustand/middleware";
+import { immer as u } from "zustand/middleware/immer";
+//#region src/store/unbound.tsx
+var d = /* @__PURE__ */ new Map();
+function f(f, p) {
+	let m = `${f}StoreContext`, h = d.get(m);
+	h || (h = n(null), h.displayName = m, d.set(m, h));
+	let g = h;
+	function _({ children: n, initialState: r }) {
+		let c = i(null), d = i(!1), f = i(r);
+		return f.current = r, (!c.current || !d.current) && (c.current = s()(l(u(p))), d.current = !0), o(() => {
+			!e(f.current) || !c.current || c.current.setState((e) => {
+				t(e, f.current, !0);
+			});
+		}, []), /* @__PURE__ */ a(g, {
+			value: c.current,
+			children: n
+		});
+	}
+	function v() {
+		let e = r(g);
+		if (!e) {
+			let e = `${f}Store is not found in the React context. Ensure the component is wrapped in ${f}StoreProvider.`;
+			throw Error(e + "");
+		}
+		return e;
+	}
+	function y(e) {
+		return c(v(), e);
+	}
+	return {
+		StoreProvider: _,
+		useStoreApi: v,
+		useStore: y
+	};
 }
-export {
-  M as createComponentStore
-};
+//#endregion
+export { f as createComponentStore };

package/dist/es/store/use-deep.js

@@ -1,12 +1,13 @@
-import { isDeepEqual as u } from "@vef-framework/shared";
-import { useRef as o } from "react";
-function f(t) {
-  const e = o(null);
-  return (n) => {
-    const r = t(n);
-    return u(e.current, r) ? e.current : e.current = r;
-  };
+/*! @vef-framework/core v2.1.0 made by Venus | 2026-03-27T07:13:02.254Z */
+import { isDeepEqual as e } from "@vef-framework/shared";
+import { useRef as t } from "react";
+//#region src/store/use-deep.ts
+function n(n) {
+	let r = t(null);
+	return (t) => {
+		let i = n(t);
+		return e(r.current, i) ? r.current : (r.current = i, i);
+	};
 }
-export {
-  f as useDeep
-};
+//#endregion
+export { n as useDeep };

package/dist/types/ai/index.d.ts

@@ -0,0 +1,6 @@
+export { DefaultChatTransport, TextStreamChatTransport, type ChatTransport } from 'ai';
+export type { DataUIPart, DynamicToolUIPart, FileUIPart, ReasoningUIPart, SourceDocumentUIPart, SourceUrlUIPart, StepStartUIPart, TextUIPart, ToolUIPart, UIMessage, UIMessageChunk, UIMessagePart } from 'ai';
+export type { UIToolInvocation, UITools } from 'ai';
+export { getToolName, getToolOrDynamicToolName } from 'ai';
+export { isDataUIPart, isFileUIPart, isReasoningUIPart, isTextUIPart, isToolOrDynamicToolUIPart, isToolUIPart } from 'ai';
+export { isDeepEqualData, parsePartialJson } from 'ai';

package/dist/types/api/client.d.ts

@@ -2,66 +2,46 @@ import { FetchQueryOptions, MutationOptions, QueryClient, QueryMeta } from '@tan
 import { Awaitable, Except, If, IsNever, IsOptional } from '@vef-framework/shared';
 import { HttpClient } from '../http';
 import { ApiClientOptions, MutationFunction, QueryFunction, QueryKey } from './types';
-import { QUERY_CLIENT } from './constants';
+import { HTTP_CLIENT, QUERY_CLIENT } from './constants';
 /**
- * The API client.
+ * API client that combines HttpClient and QueryClient for data fetching.
  */
 export declare class ApiClient {
     #private;
     /**
-     * The query client.
+     * Access the underlying QueryClient.
      */
     get [QUERY_CLIENT](): QueryClient;
     /**
-     * Creates a new API client.
-     *
-     * @param options - The options for the API client.
+     * Access the underlying HttpClient.
      */
+    get [HTTP_CLIENT](): Readonly<HttpClient>;
     constructor(options: ApiClientOptions);
     /**
-     * Creates a new query function.
-     *
-     * @param key - The key of the query function.
-     * @param factory - The factory function.
-     * @returns The query function.
+     * Create a proxied HttpClient that injects the current abort signal.
+     */
+    private createProxiedHttpClient;
+    /**
+     * Create a query function with automatic signal injection.
      */
     createQueryFn<TResult = unknown, TParams = never, TPageParam = never>(key: string, factory: (http: Readonly<HttpClient>) => (queryParams: TParams, pageParam: TPageParam, meta?: QueryMeta) => Awaitable<TResult>): QueryFunction<TResult, TParams, TPageParam>;
     /**
-     * Creates a new mutation function.
-     *
-     * @param key - The key of the mutation function.
-     * @param factory - The factory function.
-     * @returns The mutation function.
+     * Create a mutation function.
      */
     createMutationFn<TResult = unknown, TParams = never>(key: string, factory: (http: Readonly<HttpClient>) => (params: TParams) => Awaitable<TResult>): MutationFunction<TResult, TParams>;
     /**
-     * Fetches a query.
-     *
-     * @param options - The options for the query.
-     * @returns The result of the query.
+     * Fetch a query and return the result.
      */
     fetchQuery<TQueryFnData = unknown, TData = TQueryFnData, TParams = unknown, TPageParam = never>(options: Except<FetchQueryOptions<TQueryFnData, Error, TData, QueryKey<TParams>, TPageParam>, "queryHash" | "queryKeyHashFn">): Promise<TData>;
     /**
-     * Prefetches a query and stores the result in cache.
-     *
-     * @param options - The options for the query.
-     * @returns A promise that resolves when the prefetch is complete.
+     * Prefetch a query and store the result in cache.
      */
     prefetchQuery<TQueryFnData = unknown, TData = TQueryFnData, TParams = unknown, TPageParam = never>(options: Except<FetchQueryOptions<TQueryFnData, Error, TData, QueryKey<TParams>, TPageParam>, "queryHash" | "queryKeyHashFn">): Promise<void>;
     /**
-     * Executes a mutation outside of React components.
+     * Execute a mutation imperatively outside of React components.
      *
-     * This method allows you to execute mutations imperatively without using the `useMutation` hook.
      * Useful for scenarios like login flows, event handlers, or any code outside React components.
-     *
-     * @template TData - The type of data returned by the mutation
-     * @template TParams - The type of parameters passed to the mutation function
-     * @template TOnMutateResult - The type of result returned by onMutate callback
-     *
-     * @param options - The mutation options including mutationFn, onSuccess, onError, etc.
-     * @param variables - The variables to pass to the mutation function. Omit this argument when the mutation does not require parameters.
-     * @remarks This reuses TanStack Query's imperative mutation execution so lifecycle callbacks (onMutate, onSuccess, etc.) still fire.
-     * @returns A promise that resolves with the mutation result
+     * Lifecycle callbacks (onMutate, onSuccess, etc.) still fire.
      */
     executeMutation<TData = unknown, TParams = unknown, TOnMutateResult = unknown>({ mutationFn, params, ...options }: Except<MutationOptions<TData, Error, TParams, TOnMutateResult>, "mutationKey" | "mutationFn"> & {
         mutationFn: MutationFunction<TData, TParams>;

package/dist/types/api/constants.d.ts

@@ -1,8 +1,12 @@
 /**
- * The proxied methods.
+ * HTTP methods that should have the abort signal injected.
  */
-export declare const PROXIED_METHODS: string[];
+export declare const PROXIED_METHODS: Set<string>;
 /**
- * The symbol for the query client.
+ * Symbol for accessing the query client.
  */
 export declare const QUERY_CLIENT: unique symbol;
+/**
+ * Symbol for accessing the HTTP client.
+ */
+export declare const HTTP_CLIENT: unique symbol;

package/dist/types/api/index.d.ts

@@ -1,4 +1,4 @@
 export { ApiClient } from './client';
-export { QUERY_CLIENT } from './constants';
+export { HTTP_CLIENT, QUERY_CLIENT } from './constants';
 export { createApiClient } from './helpers';
 export type * from './types';

package/dist/types/auth/helpers.d.ts

@@ -1,11 +1,11 @@
 import { MaybeArray } from '@vef-framework/shared';
-import { PermissionCheckMode } from './types';
+import { PermissionCheckMode } from './types.js';
 /**
  * Check if the user is authorized to access the resource identified by the permission token.
  *
- * @param hasPermission - The function to check if the user has the permission to access the resource identified by the token.
- * @param permTokens - The permission tokens to check.
- * @param checkMode - The check mode to use.
- * @returns Whether the user is authorized to access the resource identified by the permission token.
+ * @param hasPermission - Function to check if the user has a specific permission token.
+ * @param permTokens - Single token or array of tokens to check. If nullish, returns true (no permission required).
+ * @param checkMode - "any" requires at least one token match, "all" requires all tokens to match.
+ * @returns True if the user has the required permission(s), false otherwise.
  */
 export declare function checkPermission(hasPermission: (token: string) => boolean, permTokens?: MaybeArray<string>, checkMode?: PermissionCheckMode): boolean;

package/dist/types/auth/index.d.ts

@@ -1,2 +1,2 @@
-export { checkPermission } from './helpers';
-export type * from './types';
+export { checkPermission } from './helpers.js';
+export type * from './types.js';

package/dist/types/common/index.d.ts

@@ -1 +1 @@
-export type * from './types';
+export type * from './types.js';

package/dist/types/common/types.d.ts

@@ -6,11 +6,13 @@ import { AnyObject, EmptyObject, Except, Key } from '@vef-framework/shared';
 export interface PaginationParams {
     /**
      * The page number, starting from 1
+     *
      * @default 1
      */
     page?: number;
     /**
      * The number of items per page
+     *
      * @default 15
      */
     size?: number;
@@ -48,6 +50,7 @@ export type DataOption<T = EmptyObject, M extends AnyObject = AnyObject> = T & {
     value: Key;
     /**
      * Whether the option is disabled
+     *
      * @default false
      */
     disabled?: boolean;

package/dist/types/context/api-client.d.ts

@@ -1,18 +1,17 @@
-import { MaybeNull, SetFieldType } from '@vef-framework/shared';
-import { ComponentProps, Context } from 'react';
+import { PropsWithChildren } from 'react';
 import { ApiClient } from '../api';
-declare const Context: Context<MaybeNull<ApiClient>>;
+interface ApiClientProviderProps extends PropsWithChildren {
+    value: ApiClient;
+}
 /**
- * The provider for the API client.
- *
- * @param props - The props for the provider.
- * @returns The provider for the API client.
+ * Provider for the API client context.
+ * Wraps children with both ApiClient context and React Query's QueryClientProvider.
  */
-export declare function ApiClientProvider({ value, children }: SetFieldType<ComponentProps<typeof Context.Provider>, "value", ApiClient>): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function ApiClientProvider({ value, children }: ApiClientProviderProps): React.JSX.Element;
 /**
- * The hook for the API client.
+ * Hook to access the API client from context.
  *
- * @returns The API client.
+ * @throws Error if used outside of ApiClientProvider.
  */
 export declare function useApiClient(): ApiClient;
 export {};

package/dist/types/context/app.d.ts

@@ -1,4 +1,12 @@
 import { AppContext } from './types';
-import { Provider } from 'react';
+import { Context, Provider } from 'react';
+declare const AppContext: Context<AppContext>;
+/**
+ * Provider for the VEF app context.
+ */
 export declare const AppContextProvider: Provider<AppContext>;
+/**
+ * Hook to access the VEF app context.
+ */
 export declare function useAppContext(): AppContext;
+export {};

package/dist/types/context/context-selector.d.ts

@@ -1,44 +1,32 @@
 import { ComponentType, PropsWithChildren } from 'react';
 /**
- * Props for the selector context provider component
+ * Props for the selector context provider component.
  */
 export interface SelectorContextProviderProps<TValue> extends PropsWithChildren {
-    /**
-     * The value to provide to child components
-     */
     value: TValue;
 }
 /**
- * Context hook interface with optional selector support
+ * Context hook interface with optional selector support.
  */
 export interface UseSelectorContext<in out TValue> {
     /**
-     * Use context without selector, returns the full value
+     * Returns the full context value.
      */
     <TStrictValue extends TValue = TValue>(): TStrictValue;
     /**
-     * Use context with selector, returns the selected portion of the value
+     * Returns the selected portion of the context value.
      */
     <TStrictValue extends TValue = TValue, TSelected = TStrictValue>(selector: (value: TStrictValue) => TSelected): NoInfer<TSelected>;
 }
 /**
- * Result of creating a selector context
+ * Result of creating a selector context.
  */
 export interface SelectorContextResult<TValue> {
-    /**
-     * Provider component to wrap child components
-     */
     Provider: ComponentType<SelectorContextProviderProps<TValue>>;
-    /**
-     * Hook to access context value with optional selector
-     */
     useContext: UseSelectorContext<TValue>;
 }
 /**
- * Creates a context with selector support
- * Allows consuming components to select specific parts of the context value for optimal re-rendering
- *
- * @param defaultValue - The default value for the context
- * @returns An object containing the Provider component and useContext hook
+ * Creates a context with selector support for optimal re-rendering.
+ * Consuming components can select specific parts of the context value.
  */
 export declare function createContextWithSelector<TValue>(defaultValue: TValue): SelectorContextResult<TValue>;

package/dist/types/context/disabled.d.ts

@@ -1,9 +1,9 @@
 import { Provider } from 'react';
 /**
- * A hook to get the disabled state.
+ * Hook to access the disabled state from context.
  */
 export declare function useDisabled(): boolean;
 /**
- * A provider to provide the disabled state.
+ * Provider for the disabled state context.
  */
 export declare const DisabledProvider: Provider<boolean>;

package/dist/types/context/index.d.ts

@@ -1,5 +1,6 @@
 export { ApiClientProvider, useApiClient } from './api-client';
 export { AppContextProvider, useAppContext } from './app';
-export { createContextWithSelector, type SelectorContextProviderProps, type SelectorContextResult, type UseSelectorContext } from './context-selector';
+export type { SelectorContextProviderProps, SelectorContextResult, UseSelectorContext } from './context-selector';
+export { createContextWithSelector } from './context-selector';
 export { DisabledProvider, useDisabled } from './disabled';
-export type * from './types';
+export type { AppContext } from './types';

package/dist/types/context/types.d.ts

@@ -11,7 +11,6 @@ export interface AppContext {
      * ```ts
      * const isAuthorized = hasPermission("user:query");
      * ```
-     *
      * @param token - The permission token.
      * @returns Whether the user has the permission to access the resource identified by the token.
      */

package/dist/types/dnd/index.d.ts

@@ -1,6 +1,8 @@
 export { AxisModifier, restrictShapeToBoundingRectangle, RestrictToHorizontalAxis, RestrictToVerticalAxis, SnapModifier } from '@dnd-kit/abstract/modifiers';
 export { RestrictToElement, RestrictToWindow } from '@dnd-kit/dom/modifiers';
 export { arrayMove as moveArrayItem, move as moveDragItem, arraySwap as swapArrayItem, swap as swapDragItem } from '@dnd-kit/helpers';
-export { DragDropProvider, DragOverlay, KeyboardSensor, PointerSensor, useDragDropMonitor, useDraggable, useDroppable, type DragDropEventHandlers, type DragDropEvents } from '@dnd-kit/react';
+export type { DragDropEventHandlers, DragDropEvents } from '@dnd-kit/react';
+export { DragDropProvider, DragOverlay, KeyboardSensor, PointerSensor, useDragDropMonitor, useDraggable, useDroppable } from '@dnd-kit/react';
 export { useSortable } from '@dnd-kit/react/sortable';
-export { DragDropContext, Draggable, Droppable, type DragDropContextProps, type DraggableChildrenFn, type DraggableId, type DraggableLocation, type DraggableProps, type DraggableProvided, type DraggableProvidedDraggableProps, type DraggableProvidedDragHandleProps, type DraggableRubric, type DraggableStateSnapshot, type DroppableId, type DroppableProps, type DroppableProvided, type DroppableProvidedProps, type DroppableStateSnapshot, type DropResult, type OnBeforeCaptureResponder, type OnBeforeDragStartResponder, type OnDragEndResponder, type OnDragStartResponder, type OnDragUpdateResponder } from '@hello-pangea/dnd';
+export type { DragDropContextProps, DraggableChildrenFn, DraggableId, DraggableLocation, DraggableProps, DraggableProvided, DraggableProvidedDraggableProps, DraggableProvidedDragHandleProps, DraggableRubric, DraggableStateSnapshot, DroppableId, DroppableProps, DroppableProvided, DroppableProvidedProps, DroppableStateSnapshot, DropResult, OnBeforeCaptureResponder, OnBeforeDragStartResponder, OnDragEndResponder, OnDragStartResponder, OnDragUpdateResponder } from '@hello-pangea/dnd';
+export { DragDropContext, Draggable, Droppable } from '@hello-pangea/dnd';

package/dist/types/http/client.d.ts

@@ -1,13 +1,5 @@
 import { AxiosProgressEvent } from 'axios';
 import { ApiResult, HttpClientOptions, RequestOptions } from './types';
-/**
- * The header name for the skip authentication.
- */
-export declare const skipAuthenticationHeader = "X-Skip-Authentication";
-/**
- * The header value for the skip authentication.
- */
-export declare const skipAuthenticationValue = "1";
 /**
  * The HTTP client.
  */
@@ -16,113 +8,93 @@ export declare class HttpClient {
     constructor(options: HttpClientOptions);
     private initInterceptors;
     /**
-     * Check if the code belongs to the target.
-     *
-     * @param code - The code.
-     * @param target - The target.
-     * @returns The result.
+     * Check if the code matches the target code(s).
      */
-    private isBelongsTo;
+    private matchesCode;
     /**
-     * Handle the request.
-     *
-     * @param config - The axios request config.
-     * @returns The axios request config.
+     * Handle the request interceptor.
      */
     private handleRequest;
     /**
-     * Handle the request error.
-     *
-     * @param error - The axios error.
+     * Handle the request error interceptor.
      */
     private handleRequestError;
     /**
-     * Handle the response.
-     *
-     * @param response - The axios response.
-     * @returns The axios response.
+     * Handle the response interceptor.
      */
     private handleResponse;
     /**
-     * Handle the response error.
-     *
-     * @param error - The axios error.
+     * Handle the response error interceptor.
      */
     private handleResponseError;
     /**
-     * Injects access token into request Authorization header.
-     *
-     * @param config - The axios request config.
+     * Handle 401 unauthorized response.
      */
-    private setAccessToken;
+    private handleUnauthorized;
     /**
-     * Replace the path parameters in the URL.
-     *
-     * @param config - The axios request config.
-     * @returns The axios request config.
+     * Log info message using configured handler or console.
+     */
+    private logInfo;
+    /**
+     * Log warning message using configured handler or console.
+     */
+    private logWarning;
+    /**
+     * Log error message using configured handler or console.
+     */
+    private logError;
+    /**
+     * Inject access token into request Authorization header.
+     */
+    private injectAccessToken;
+    /**
+     * Replace path parameters in the URL (e.g., /users/:id -> /users/123).
      */
     private replacePathParams;
     /**
-     * Try to refresh the token using the provided refresh callback.
+     * Ensure the token is refreshed. Can be called proactively by external code
+     * (e.g., fetch-based SSE) to refresh token before/after request.
      *
+     * @param triggerCallback - Whether to trigger onUnauthenticated callback on failure.
      * @returns True if token refresh succeeded, false otherwise.
      */
+    ensureTokenRefreshed(triggerCallback?: boolean): Promise<boolean>;
+    /**
+     * Try to refresh the token using the provided refresh callback.
+     */
     private tryRefreshToken;
     /**
-     * Retry the request.
-     *
-     * @param config - The axios request config.
-     * @returns The axios response.
+     * Retry the request with refreshed token.
      */
     private retryRequest;
     /**
-     * Get the resource.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * GET request.
      */
     get<R = unknown, P = unknown>(url: string, options?: RequestOptions & {
         params?: P;
     }): Promise<ApiResult<R>>;
     /**
-     * Post the resource.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * POST request.
      */
     post<R = unknown, D = unknown, P = unknown>(url: string, options?: RequestOptions & {
         data?: D;
         params?: P;
     }): Promise<ApiResult<R>>;
     /**
-     * Update the resource.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * PUT request.
      */
     put<R = unknown, D = unknown, P = unknown>(url: string, options?: RequestOptions & {
         data?: D;
         params?: P;
     }): Promise<ApiResult<R>>;
     /**
-     * Delete the resource.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * DELETE request.
      */
     delete<R = unknown, P = unknown>(url: string, options?: RequestOptions & {
         params?: P;
     }): Promise<ApiResult<R>>;
     /**
-     * Upload the file.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * Upload file via multipart/form-data.
      */
     upload<R = unknown, P = unknown>(url: string, options?: RequestOptions & {
         params?: P;
@@ -130,11 +102,7 @@ export declare class HttpClient {
         onProgress?: (event: AxiosProgressEvent) => void;
     }): Promise<ApiResult<R>>;
     /**
-     * Download the file.
-     *
-     * @param url - The url.
-     * @param options - The options for the request.
-     * @returns The response data.
+     * Download file as blob and trigger browser download.
      */
     download<P = unknown>(url: string, options?: RequestOptions & {
         params?: P;