@vef-framework/starter 2.0.10 → 2.1.0

package/dist/types/components/pro-table/types.d.ts

@@ -4,6 +4,23 @@ import { Key } from '@vef-framework/shared';
 import { ReactNode } from 'react';
 import { SYMBOL_PAGINATION, SYMBOL_SORT } from '../../constants';
 import { OrderSpec } from '../../types';
+/**
+ * Configuration for column settings feature
+ */
+export interface ColumnSettingsConfig {
+    /**
+     * Storage key for persisting column settings to localStorage.
+     * If provided, settings will be saved with key: `__VEF_PRO_TABLE_COLUMN_SETTINGS__${storageKey}`
+     * If not provided, settings will not be persisted.
+     */
+    storageKey?: string;
+}
+/**
+ * Column settings prop type.
+ * - `false`: Disable column settings feature, hide settings icon
+ * - `ColumnSettingsConfig`: Enable column settings with optional persistence
+ */
+export type ColumnSettingsProp = false | ColumnSettingsConfig;
 /**
  * Imperative handle for ProTable component.
  * Exposed via ref to allow parent components to programmatically control the table.

package/dist/types/components/router-provider/context.d.ts

@@ -1,6 +1,7 @@
 import { AnyRouter, RegisteredRouter, RouterProps } from '@tanstack/react-router';
 import { MaybeNull } from '@vef-framework/shared';
 import { Provider } from 'react';
-export type UseRouterContext<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>> = () => NonNullable<RouterProps<TRouter, TDehydrated>["context"]>;
-export declare function useRouterContextHook(): MaybeNull<UseRouterContext<AnyRouter, Record<string, any>>>;
+export type RouterContext<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>> = NonNullable<RouterProps<TRouter, TDehydrated>["context"]>;
+export type UseRouterContext<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>> = () => RouterContext<TRouter, TDehydrated>;
+export declare function useRouterContextHook(): MaybeNull<UseRouterContext>;
 export declare const RouterContextHookProvider: Provider<MaybeNull<UseRouterContext<AnyRouter, Record<string, any>>>>;

package/dist/types/components/router-provider/index.d.ts

@@ -1,5 +1,5 @@
 import { AnyRouter, RegisteredRouter } from '@tanstack/react-router';
 import { RouterProviderProps } from './props';
-export declare function RouterProvider<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>>({ router }: RouterProviderProps<TRouter, TDehydrated>): import("@emotion/react/jsx-runtime").JSX.Element;
-export { RouterContextHookProvider, type UseRouterContext } from './context';
+export declare function RouterProvider<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>>({ router }: RouterProviderProps<TRouter, TDehydrated>): React.ReactNode;
+export { RouterContextHookProvider, type RouterContext, type UseRouterContext } from './context';
 export { type RouterProviderProps } from './props';

package/dist/types/components/theme-config-provider/index.d.ts

@@ -1,2 +1,2 @@
 import { PropsWithChildren } from 'react';
-export declare function ThemeConfigProvider({ children }: PropsWithChildren): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function ThemeConfigProvider({ children }: PropsWithChildren): React.JSX.Element;

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

@@ -1,12 +1,3 @@
-/**
- * The event type for reloading the page.
- */
 export declare const RELOAD_PAGE_EVENT = "__vef_reload_page_event";
-/**
- * The event type for access denied.
- */
 export declare const ACCESS_DENIED_EVENT = "__vef_access_denied_event";
-/**
- * The event type for unauthenticated.
- */
 export declare const UNAUTHENTICATED_EVENT = "__vef_unauthenticated_event";

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

@@ -1,24 +1,6 @@
-/**
- * The route path of the login page.
- */
 export declare const LOGIN_ROUTE_PATH = "/login";
-/**
- * The route id of the login page.
- */
 export declare const LOGIN_ROUTE_ID = "/_common/login";
-/**
- * The route path of the index page.
- */
 export declare const INDEX_ROUTE_PATH = "/";
-/**
- * The route id of the index page.
- */
 export declare const INDEX_ROUTE_ID = "/_layout";
-/**
- * The route path of the access denied page.
- */
 export declare const ACCESS_DENIED_ROUTE_PATH = "/access-denied";
-/**
- * The route id of the access denied page.
- */
 export declare const ACCESS_DENIED_ROUTE_ID = "/_common/access-denied";

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

@@ -1,8 +1,2 @@
-/**
- * The prefix of the storage key.
- */
 export declare const STORAGE_KEY_PREFIX_STORE = "__VEF_STORE__";
-/**
- * The suffix of the storage key.
- */
 export declare const STORAGE_KEY_SUFFIX_STORE = "__";

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

@@ -1,8 +1,2 @@
-/**
- * Global symbol for marking pagination metadata in request parameters.
- */
 export declare const SYMBOL_PAGINATION: unique symbol;
-/**
- * Global symbol for marking sort/order metadata in request parameters.
- */
 export declare const SYMBOL_SORT: unique symbol;

package/dist/types/helpers/app-version.d.ts

@@ -1,88 +1,19 @@
 import { ReactNode } from 'react';
-/**
- * Application changelog structure
- */
 export interface AppChangelog {
-    /**
-     * Version number
-     */
     version: string;
-    /**
-     * Release date
-     */
     date?: string;
-    /**
-     * Detailed description
-     */
     description?: string;
-    /**
-     * List of changes in this version
-     */
     changes?: string[];
 }
-/**
- * Configuration options for app version notification
- */
 export interface AppVersionNotificationOptions {
-    /**
-     * Whether to enable automatic update detection
-     *
-     * Recommended to set this to `import.meta.env.PROD` in your application,
-     * so it only runs in production builds.
-     *
-     * @default false
-     */
     enabled?: boolean;
-    /**
-     * Base path for all requests (e.g., "/app", "/static")
-     *
-     * This will be prepended to all URL requests for index.html and changelog.json
-     *
-     * @default "/"
-     */
     basePath?: string;
-    /**
-     * The interval (in seconds) to check for updates
-     *
-     * @default 60
-     */
     checkInterval?: number;
-    /**
-     * Custom notification title
-     */
     title?: ReactNode;
-    /**
-     * Custom notification description
-     */
     description?: ReactNode;
-    /**
-     * Custom confirm button text
-     */
     confirmText?: ReactNode;
-    /**
-     * Custom cancel button text
-     */
     cancelText?: ReactNode;
-    /**
-     * Callback when user confirms update
-     */
     onConfirm?: () => void;
-    /**
-     * Callback when user cancels update
-     */
     onCancel?: () => void;
 }
-/**
- * Setup automatic app version notification
- *
- * This function monitors for app version changes by comparing the current version
- * with the version in the deployed HTML file. When a new version is detected,
- * it shows a notification prompting the user to refresh the page.
- *
- * The version is obtained from the `<meta name="app-version">` tag in the HTML.
- * It uses semantic versioning comparison via the `compare-versions` library.
- *
- * @param options - Configuration options
- * @returns A cleanup function to stop version checking
- */
 export declare function setupAppVersionNotification(options?: AppVersionNotificationOptions): (() => void) | undefined;

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

@@ -1,24 +1,11 @@
 import { AnyRouter, RegisteredRouter } from '@tanstack/react-router';
 import { AppProps, UseRouterContext } from '../components';
-/**
- * Configuration options for creating an app instance
- */
-export interface AppOptions<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>> {
-    /**
-     * Whether to enable React's StrictMode for development checks
-     */
+export interface AppOptions<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>> {
     strictMode?: boolean;
-    /**
-     * Custom hook for accessing router context
-     */
     useRouterContext?: UseRouterContext<TRouter, TDehydrated>;
 }
-/**
- * Create the app
- *
- * @returns The app
- */
-export declare function createApp<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, any> = Record<string, any>>({ strictMode, useRouterContext }?: AppOptions<TRouter, TDehydrated>): {
-    render(props: AppProps): void;
-    unmount(): void;
-};
+export interface AppInstance {
+    render: (props: AppProps) => void;
+    unmount: () => void;
+}
+export declare function createApp<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>>({ strictMode, useRouterContext }?: AppOptions<TRouter, TDehydrated>): AppInstance;

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

@@ -1,7 +1,2 @@
 import { AnyRouter } from '@tanstack/react-router';
-/**
- * Handles the client logout process.
- *
- * @param router - The router instance.
- */
 export declare function handleClientLogout(router: AnyRouter): Promise<void>;

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

@@ -4,23 +4,7 @@ export declare const eventEmitter: EventEmitter<{
     __vef_access_denied_event: void;
     __vef_unauthenticated_event: void;
 }>;
-/**
- * Dispatch a custom event.
- *
- * @param type - The type of event to dispatch.
- */
-export declare function dispatchCustomEvent<T = any>(type: string, options?: CustomEventInit<T>): boolean;
-/**
- * Reload the page.
- *
- * @param key - The key of the page to reload.
- */
+export declare function dispatchCustomEvent<T = unknown>(type: string, options?: CustomEventInit<T>): boolean;
 export declare function reloadPage(key: string): void;
-/**
- * Emit the access denied event.
- */
 export declare function emitAccessDenied(): void;
-/**
- * Emit the unauthenticated event.
- */
 export declare function emitUnauthenticated(): void;

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

@@ -1,32 +1,12 @@
 import { PaginationParams } from '@vef-framework/core';
-import { MaybeUndefined } from '@vef-framework/shared';
+import { AnyObject, MaybeUndefined } from '@vef-framework/shared';
 import { OrderSpec } from '../types';
 import { SYMBOL_PAGINATION, SYMBOL_SORT } from '../constants';
-/**
- * A no-operation mutation function that immediately resolves with undefined.
- *
- * This is useful as a placeholder mutation function in scenarios where a mutation
- * is required by the type system but no actual operation should be performed.
- *
- * @template TResult - The expected result type of the mutation (defaults to unknown)
- * @template TArgs - The argument types accepted by the mutation function (defaults to unknown[])
- * @param _args - Arguments that are ignored (prefixed with _ to indicate intentional non-use)
- * @returns A promise that immediately resolves to undefined cast as TResult
- */
-export declare function noopMutationFn<TResult = unknown, TArgs extends any[] = unknown[]>(..._args: TArgs): Promise<TResult>;
+export declare function noopMutationFn<TResult = unknown, TArgs extends unknown[] = unknown[]>(..._args: TArgs): Promise<TResult>;
 export declare namespace noopMutationFn {
     var key: string;
 }
-/**
- * Extracts pagination and sort metadata from query parameters.
- *
- * Separates the special symbol-keyed fields (pagination and sort) from the rest
- * of the query parameters, making it easier to work with API requests.
- *
- * @param queryParams - The query parameters object containing pagination and sort symbols
- * @returns An object with three properties: params (remaining parameters), pagination, and sort
- */
-export declare function extractQueryParams<TParams extends Record<string | symbol, any>>(queryParams: TParams): {
+export declare function extractQueryParams<TParams extends AnyObject>(queryParams: TParams): {
     params: Omit<TParams, typeof SYMBOL_PAGINATION | typeof SYMBOL_SORT>;
     pagination: MaybeUndefined<PaginationParams>;
     sort: MaybeUndefined<OrderSpec[]>;

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

@@ -2,27 +2,9 @@ import { AnyRouteWithContext } from '@tanstack/react-router';
 import { RouterContext } from '../types';
 import { RouterCore } from '@tanstack/router-core';
 import { RouterHistory } from '@tanstack/history';
-/**
- * The options for creating a router.
- */
 export interface RouterOptions {
-    /**
-     * The history mode to use.
-     */
     history: "hash" | "browser";
-    /**
-     * The route tree to create the router from.
-     */
     routeTree: AnyRouteWithContext<RouterContext>;
-    /**
-     * The context to use for the router.
-     */
     context: RouterContext;
 }
-/**
- * Creates a router.
- *
- * @param options The options for creating the router.
- * @returns The created router.
- */
 export declare function createRouter({ history, routeTree, context }: RouterOptions): RouterCore<AnyRouteWithContext<RouterContext>, "never", true, RouterHistory, Record<string, any>>;

package/dist/types/hooks/use-route-full-path.d.ts

@@ -1,6 +1 @@
-/**
- * Get the full path of the current route.
- *
- * @returns The full path of the current route.
- */
 export declare function useRouteFullPath(): string;

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { createCrudKit, Crud, CrudPage, FlexCard, FormDrawer, FormModal, OperationButtonGroup, Page, ProSearch, ProTable, ProTableSubscriber, useViewportHeight, type CrudActionButtonGroupProps, type CrudBasicFormScene, type CrudBasicSceneFormValues, type CrudFormMutationFns, type CrudFormScene, type CrudOperationButtonGroupProps, type CrudPageProps, type CrudProps, type FlexCardProps, type FormDrawerProps, type FormModalProps, type LoginParams, type LoginResult, type OperationButtonGroupProps, type OperationColumnConfig, type PageProps, type PaginatedQueryParams, type ParamsWithPagination, type ParamsWithSort, type ProSearchProps, type ProTableProps, type ProTableRef, type ProTableState, type ProTableSubscriberProps, type QueryParams, type RowSelectionConfig } from './components';
+export { createCrudKit, Crud, CrudPage, FlexCard, FormDrawer, FormModal, OperationButtonGroup, Page, ProSearch, ProTable, ProTableSubscriber, useViewportHeight, type CrudActionButtonGroupProps, type CrudBasicFormScene, type CrudBasicSceneFormValues, type CrudFormMutationFns, type CrudFormScene, type CrudKit, type CrudOperationButtonGroupProps, type CrudPageProps, type CrudProps, type FlexCardProps, type FormDrawerProps, type FormModalProps, type LoginParams, type LoginResult, type OperationButtonGroupProps, type OperationColumnConfig, type PageProps, type PaginatedQueryParams, type ParamsWithPagination, type ParamsWithSort, type ProSearchProps, type ProTableProps, type ProTableRef, type ProTableState, type ProTableSubscriberProps, type QueryParams, type RowSelectionConfig } from './components';
 export * from './constants';
 export * from './helpers';
 export * from './routes';

package/dist/types/routes/access-denied.d.ts

@@ -1,10 +1,5 @@
 import { AnyRouter, ParsedLocation } from '@tanstack/react-router';
 import { AccessDenied } from '../components';
-/**
- * Creates the route options for the access denied page.
- *
- * @returns The options of the access denied route.
- */
 export declare function createAccessDeniedRouteOptions(): {
     readonly component: typeof AccessDenied;
     readonly beforeLoad: ({ location, context: { router } }: {

package/dist/types/routes/layout.d.ts

@@ -2,14 +2,10 @@ import { ParsedLocation } from '@tanstack/react-router';
 import { Awaitable, Except } from '@vef-framework/shared';
 import { LayoutProps, Error, NotFound } from '../components';
 import { UserInfo } from '../types';
-/**
- * Creates options for a route that renders the `Layout` component.
- *
- * @returns The options for the layout route.
- */
-export declare function createLayoutRouteOptions({ fetchUserInfo, ...layoutProps }: Except<LayoutProps, "children"> & {
+interface LayoutRouteOptions extends Except<LayoutProps, "children"> {
     fetchUserInfo: () => Awaitable<UserInfo>;
-}): {
+}
+export declare function createLayoutRouteOptions({ fetchUserInfo, ...layoutProps }: LayoutRouteOptions): {
     readonly beforeLoad: ({ location }: {
         location: ParsedLocation;
     }) => void;
@@ -23,3 +19,4 @@ export declare function createLayoutRouteOptions({ fetchUserInfo, ...layoutProps
     readonly staleTime: number;
     readonly shouldReload: false;
 };
+export {};

package/dist/types/routes/login.d.ts

@@ -1,10 +1,5 @@
 import { LoginProps } from '../components';
 import { z } from '@vef-framework/shared';
-/**
- * The options for the login route.
- *
- * @param props The props for the login component.
- */
 export declare function createLoginRouteOptions(props: LoginProps): {
     readonly validateSearch: z.ZodObject<{
         redirect: z.ZodCatch<z.ZodDefault<z.ZodOptional<z.ZodString>>>;

package/dist/types/routes/root.d.ts

@@ -1,11 +1,6 @@
 interface RootProps {
     appTitle: string;
 }
-/**
- * Create the root route.
- *
- * @returns The root route.
- */
 export declare function createRootRouteOptions({ appTitle }: RootProps): {
     readonly component: () => import("@emotion/react/jsx-runtime").JSX.Element;
     readonly ssr: false;

package/dist/types/src/components/access-denied/access-denied-icon.d.ts

@@ -0,0 +1,2 @@
+import { SVGProps } from 'react';
+export declare function AccessDeniedIcon(props: SVGProps<SVGSVGElement>): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/src/components/access-denied/index.d.ts

@@ -0,0 +1 @@
+export declare function AccessDenied(): React.ReactNode;

package/dist/types/src/components/app/index.d.ts

@@ -0,0 +1,4 @@
+import { AnyRouter, RegisteredRouter } from '@tanstack/react-router';
+import { AppProps } from './props';
+export declare function App<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>>({ apiClient, appContext, appVersionNotification, router }: AppProps<TRouter, TDehydrated>): React.ReactElement;
+export { type AppProps } from './props';

package/dist/types/src/components/app/props.d.ts

@@ -0,0 +1,8 @@
+import { AnyRouter, RegisteredRouter, RouterProps } from '@tanstack/react-router';
+import { ApiClient, AppContext } from '@vef-framework/core';
+import { AppVersionNotificationOptions } from '../../helpers/app-version.js';
+export interface AppProps<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>> extends Pick<RouterProps<TRouter, TDehydrated>, "router"> {
+    apiClient: ApiClient;
+    appContext: AppContext;
+    appVersionNotification?: AppVersionNotificationOptions;
+}

package/dist/types/src/components/base-layout/index.d.ts

@@ -0,0 +1,3 @@
+import { BaseLayoutProps } from './props';
+export declare function BaseLayout(props: BaseLayoutProps): React.JSX.Element;
+export { type BaseLayoutProps } from './props';

package/dist/types/src/components/base-layout/props.d.ts

@@ -0,0 +1,70 @@
+import { PropsWithChildren, ReactNode } from 'react';
+/**
+ * The props of the BaseLayout component.
+ */
+export interface BaseLayoutProps extends PropsWithChildren {
+    /**
+     * The class of the main content.
+     */
+    className?: string;
+    /**
+     * The header of the layout.
+     */
+    header?: ReactNode;
+    /**
+     * The height of the header.
+     */
+    headerHeight?: number;
+    /**
+     * The class of the header.
+     */
+    headerClassName?: string;
+    /**
+     * The tabs of the layout.
+     */
+    tabs?: ReactNode;
+    /**
+     * The height of the tabs.
+     */
+    tabsHeight?: number;
+    /**
+     * The class of the tabs.
+     */
+    tabsClassName?: string;
+    /**
+     * The footer of the layout.
+     */
+    footer?: ReactNode;
+    /**
+     * The height of the footer.
+     */
+    footerHeight?: number;
+    /**
+     * The class of the footer.
+     */
+    footerClassName?: string;
+    /**
+     * The sidebar of the layout.
+     */
+    sidebar?: ReactNode;
+    /**
+     * The sidebar collapsed state.
+     */
+    isSidebarCollapsed?: boolean;
+    /**
+     * The width of the sidebar.
+     */
+    sidebarWidth?: number;
+    /**
+     * The collapsed width of the sidebar.
+     */
+    sidebarCollapsedWidth?: number;
+    /**
+     * The class of the sidebar.
+     */
+    sidebarClassName?: string;
+    /**
+     * The main content maximum state.
+     */
+    isMainContentMaximum?: boolean;
+}

package/dist/types/src/components/base-layout/styles.d.ts

@@ -0,0 +1,8 @@
+import { SerializedStyles } from '@emotion/serialize';
+export declare const layout: SerializedStyles;
+export declare const header: SerializedStyles;
+export declare const tabs: SerializedStyles;
+export declare const sidebar: SerializedStyles;
+export declare const sidebarGap: SerializedStyles;
+export declare const main: SerializedStyles;
+export declare const footer: SerializedStyles;

package/dist/types/src/components/base-layout/use-base-layout.d.ts

@@ -0,0 +1,11 @@
+import { CSSProperties } from 'react';
+import { BaseLayoutProps } from './props';
+interface UseBaseLayoutResult {
+    isHeaderVisible: boolean;
+    isTabsVisible: boolean;
+    isSidebarVisible: boolean;
+    isFooterVisible: boolean;
+    cssVars: CSSProperties;
+}
+export declare function useBaseLayout({ header, headerHeight, tabs, tabsHeight, footer, footerHeight, sidebar, isSidebarCollapsed, sidebarWidth, sidebarCollapsedWidth, isMainContentMaximum }: BaseLayoutProps): UseBaseLayoutResult;
+export {};

package/dist/types/src/components/crud/components/action-button-group.d.ts

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework/shared';
+import { FC, ReactNode } from 'react';
+import { CrudState } from '../store';
+export interface ActionButtonGroupProps<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>> {
+    selector?: (state: NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>) => TSelected;
+    children: ((state: NoInfer<TSelected>) => ReactNode) | ReactNode;
+}
+export declare const ActionButtonGroup: (<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>>(props: ActionButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode) & Pick<FC, "displayName">;

package/dist/types/src/components/crud/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ActionButtonGroup, type ActionButtonGroupProps } from './action-button-group';
+export { Main } from './main';
+export { MutationHolder } from './mutation-holder';
+export { OperationButtonGroup, type OperationButtonGroupProps } from './operation-button-group';
+export { SceneForm } from './scene-form';
+export { Toolbar } from './toolbar';

package/dist/types/src/components/crud/components/main.d.ts

@@ -0,0 +1,6 @@
+import { AnyObject, Except } from '@vef-framework/shared';
+import { ReactNode } from 'react';
+import { CrudProps } from '../props';
+type MainProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject> = Except<CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>, "sceneDefaultFormValues" | "renderForm" | "defaultSearchValues" | "formMutationFns" | "beforeFormSubmit" | "afterFormSubmit" | "deleteMutationFn" | "deleteManyMutationFn" | "mutationMeta">;
+export declare const Main: <TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TFilter extends AnyObject>(props: MainProps<TRow, TSearchValues, TSceneFormValues, TFilter>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/mutation-holder.d.ts

@@ -0,0 +1,10 @@
+import { ApiResult, MutationFunction, MutationMeta } from '@vef-framework/core';
+import { AnyObject, MaybeUndefined } from '@vef-framework/shared';
+import { ReactNode } from 'react';
+interface MutationHolderProps<TRow extends AnyObject> {
+    mutationMeta?: (key: string) => MaybeUndefined<MutationMeta>;
+    deleteMutationFn?: MutationFunction<ApiResult<unknown>, TRow>;
+    deleteManyMutationFn?: MutationFunction<ApiResult<unknown>, TRow[]>;
+}
+export declare const MutationHolder: <TRow extends AnyObject>(props: MutationHolderProps<TRow>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/operation-button-group.d.ts

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework/shared';
+import { FC, ReactNode } from 'react';
+import { CrudState } from '../store';
+export interface OperationButtonGroupProps<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>> {
+    selector?: (state: NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>) => TSelected;
+    children: ((state: NoInfer<TSelected>) => ReactNode) | ReactNode;
+}
+export declare const OperationButtonGroup: (<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>>(props: OperationButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode) & Pick<FC, "displayName">;

package/dist/types/src/components/crud/components/scene-form.d.ts

@@ -0,0 +1,7 @@
+import { AnyObject } from '@vef-framework/shared';
+import { ReactNode } from 'react';
+import { BaseCrudProps } from '../props';
+interface SceneFormProps<TSceneFormValues extends AnyObject> extends Pick<BaseCrudProps<AnyObject, AnyObject, TSceneFormValues, AnyObject>, "renderForm" | "formMutationFns" | "formActionsRenderers" | "beforeFormSubmit" | "afterFormSubmit" | "mutationMeta"> {
+}
+export declare const SceneForm: <TSceneFormValues extends AnyObject>(props: SceneFormProps<TSceneFormValues>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/selection-indicator.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode, MemoExoticComponent } from 'react';
+interface SelectionIndicatorProps {
+    selectionSummary?: (selectedRows: unknown[]) => ReactNode;
+}
+export declare const SelectionIndicator: MemoExoticComponent<({ selectionSummary }: SelectionIndicatorProps) => import("@emotion/react/jsx-runtime").JSX.Element | null>;
+export {};

package/dist/types/src/components/crud/components/toolbar-actions.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+interface ToolbarActionsProps {
+    toolbarActions?: ReactNode;
+}
+export declare function ToolbarActions({ toolbarActions }: ToolbarActionsProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/src/components/crud/components/toolbar.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode, MemoExoticComponent } from 'react';
+interface ToolbarProps {
+    basicSearch?: ReactNode;
+    advancedSearch?: ReactNode;
+    toolbarActions?: ReactNode;
+}
+export declare const Toolbar: MemoExoticComponent<({ basicSearch, advancedSearch, toolbarActions }: ToolbarProps) => import("@emotion/react/jsx-runtime").JSX.Element>;
+export {};

package/dist/types/src/components/crud/event.d.ts

@@ -0,0 +1,3 @@
+import { EventEmitter } from '@vef-framework/shared';
+export type CrudEvents = {};
+export declare function createEventEmitter(): EventEmitter<CrudEvents>;

package/dist/types/src/components/crud/helpers.d.ts

@@ -0,0 +1,20 @@
+import { UseStore } from '@vef-framework/core';
+import { AnyObject } from '@vef-framework/shared';
+import { ReactNode } from 'react';
+import { ActionButtonGroupProps, OperationButtonGroupProps } from './components';
+import { CrudState } from './store';
+/**
+ * Type representing the return value of createCrudKit
+ */
+export interface CrudKit<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject> {
+    useCrudStore: UseStore<CrudState<TRow, TSearchValues, TSceneFormValues>>;
+    useSearchValues: () => TSearchValues;
+    useSelectedRows: () => TRow[];
+    OperationButtonGroup: <TSelected = NoInfer<CrudState<TRow, TSearchValues, TSceneFormValues>>>(props: OperationButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode;
+    ActionButtonGroup: <TSelected = NoInfer<CrudState<TRow, TSearchValues, TSceneFormValues>>>(props: ActionButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode;
+}
+/**
+ * Create a type-safe kit containing hooks and components for Crud with specific generic types.
+ * This helper function eliminates the need to repeatedly specify generic parameters when using Crud-related utilities.
+ */
+export declare function createCrudKit<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject>(): CrudKit<TRow, TSearchValues, TSceneFormValues>;