@vef-framework/starter 2.0.11 → 2.1.0

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 { ApprovalFlowEditor, 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>;

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

@@ -0,0 +1,3 @@
+export { useQueryObserver } from './use-query-observer';
+export { useSearchValues } from './use-search-values';
+export { useSelectedRows } from './use-selected-rows';

package/dist/types/src/components/crud/hooks/use-query-observer.d.ts

@@ -0,0 +1,6 @@
+import { ProTableRef } from '../../pro-table';
+import { RefObject } from 'react';
+/**
+ * Hook to observe and sync ProTable query state with Crud store.
+ */
+export declare function useQueryObserver(): RefObject<ProTableRef | null>;

package/dist/types/src/components/crud/hooks/use-search-values.d.ts

@@ -0,0 +1,2 @@
+import { AnyObject } from '@vef-framework/shared';
+export declare function useSearchValues<TSearchValues extends AnyObject>(): NoInfer<TSearchValues>;

package/dist/types/src/components/crud/hooks/use-selected-rows.d.ts

@@ -0,0 +1,2 @@
+import { AnyObject } from '@vef-framework/shared';
+export declare function useSelectedRows<TRow extends AnyObject>(): NoInfer<TRow[]>;

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

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework/shared';
+import { CrudProps } from './props';
+export declare function Crud<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never>({ defaultSearchValues, advancedSearch, sceneDefaultFormValues, renderForm, formMutationFns, formActionsRenderers, beforeFormSubmit, afterFormSubmit, deleteMutationFn, deleteManyMutationFn, mutationMeta, rowSelection, ...bodyProps }: CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>): import("@emotion/react/jsx-runtime").JSX.Element;
+export type { ActionButtonGroupProps as CrudActionButtonGroupProps, OperationButtonGroupProps as CrudOperationButtonGroupProps } from './components';
+export { createCrudKit } from './helpers';
+export type { CrudKit } from './helpers';
+export type { CrudProps } from './props';
+export type * from './types';

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

@@ -0,0 +1,171 @@
+import { TableColumn } from '@vef-framework/components';
+import { ApiResult, MutationFunction, MutationMeta, PaginationResult, QueryFunction } from '@vef-framework/core';
+import { AnyObject, Awaitable, DeepKeys, EmptyObject, If, IsNever, Key, MaybeUndefined, PartialDeep } from '@vef-framework/shared';
+import { ReactNode } from 'react';
+import { ColumnSettingsProp, OperationColumnConfig, ProTableProps, RowSelectionConfig } from '../pro-table';
+import { CrudFormActionsRenderers, CrudFormMutationFns, CrudFormScene, PaginatedQueryParams, QueryParams } from './types';
+/**
+ * Base props for the Crud component.
+ *
+ * @template TRow - Table row model type
+ * @template TSearchValues - Search/filters form values type
+ * @template TSceneFormValues - A map of scene key to its form values type
+ * @template TParams - Additional query parameters type
+ */
+export interface BaseCrudProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject> {
+    /**
+     * Table size
+     */
+    tableSize?: ProTableProps<TRow, TParams>["size"];
+    /**
+     * Table column definitions
+     */
+    tableColumns: Array<TableColumn<NoInfer<TRow>>>;
+    /**
+     * Column settings configuration.
+     * - `false`: Disable column settings feature
+     * - `{ storageKey?: string }`: Enable with optional localStorage persistence
+     *
+     * @default {}
+     */
+    columnSettings?: ColumnSettingsProp;
+    /**
+     * Operation column configuration for per-row actions
+     */
+    operationColumn?: OperationColumnConfig<NoInfer<TRow>>;
+    /**
+     * Whether to show the sequence (row number) column. Default is true.
+     */
+    showSequenceColumn?: boolean;
+    /**
+     * Row key extractor: either a deep key of the row model or a function
+     */
+    rowKey?: DeepKeys<NoInfer<TRow>> | ((row: NoInfer<TRow>) => Key);
+    /**
+     * Enable virtual scrolling for the table to improve performance with large datasets
+     *
+     * @default false
+     */
+    virtual?: boolean;
+    /**
+     * Title to be displayed above the table
+     */
+    title?: ReactNode;
+    /**
+     * Summary to be displayed below the table
+     */
+    summary?: ReactNode;
+    /**
+     * Row selection configuration.
+     * - `true`: Enable row selection with default configuration
+     * - `RowSelectionConfig<TRow>`: Enable row selection with custom configuration
+     * - `undefined`: Disable row selection (default)
+     */
+    rowSelection?: RowSelectionConfig<NoInfer<TRow>> | true;
+    /**
+     * Default search values for initializing the search forms
+     */
+    defaultSearchValues?: Partial<NoInfer<TSearchValues>>;
+    /**
+     * Node to render as the basic (inline) search area
+     */
+    basicSearch?: ReactNode;
+    /**
+     * Node to render as the advanced search panel
+     */
+    advancedSearch?: ReactNode;
+    /**
+     * Default form values map for scenes
+     */
+    sceneDefaultFormValues?: PartialDeep<NoInfer<TSceneFormValues>>;
+    /**
+     * Render function to provide a form for the specified scene
+     */
+    renderForm?: (scene: CrudFormScene<NoInfer<TSceneFormValues>>) => ReactNode;
+    /**
+     * Optional hook before submitting the form. Can transform values.
+     */
+    beforeFormSubmit?: (scene: CrudFormScene<NoInfer<TSceneFormValues>>, formValues: TSceneFormValues[CrudFormScene<NoInfer<TSceneFormValues>>]) => Awaitable<TSceneFormValues[CrudFormScene<NoInfer<TSceneFormValues>>]>;
+    /**
+     * Optional hook after submitting the form. Can be used for side effects.
+     */
+    afterFormSubmit?: (scene: CrudFormScene<NoInfer<TSceneFormValues>>, formValues: TSceneFormValues[CrudFormScene<NoInfer<TSceneFormValues>>], result: unknown) => Awaitable<void>;
+    /**
+     * Mutation functions for submitting different scenes
+     */
+    formMutationFns?: CrudFormMutationFns<TSceneFormValues>;
+    /**
+     * Custom render functions for form actions in different scenes
+     * Allows customization of footer action buttons for each form scene
+     */
+    formActionsRenderers?: CrudFormActionsRenderers<NoInfer<TSceneFormValues>>;
+    /**
+     * Mutation function to delete a single row
+     */
+    deleteMutationFn?: MutationFunction<ApiResult<unknown>, NoInfer<TRow>>;
+    /**
+     * Mutation function to delete multiple rows
+     */
+    deleteManyMutationFn?: MutationFunction<ApiResult<unknown>, Array<NoInfer<TRow>>>;
+    /**
+     * Meta information provider for mutations
+     */
+    mutationMeta?: (mutationKey: string) => MaybeUndefined<MutationMeta>;
+    /**
+     * Actions displayed on the table toolbar area
+     */
+    toolbarActions?: ReactNode;
+    /**
+     * Function to determine whether the query should be enabled
+     */
+    queryEnabled?: (params?: NoInfer<TSearchValues> & If<IsNever<TParams>, EmptyObject, NoInfer<TParams>>) => boolean;
+    /**
+     * Additional query parameters that trigger re-fetching when changed.
+     * These are merged with search, pagination, and sort parameters in the query function.
+     */
+    queryParams?: NoInfer<TParams>;
+}
+/**
+ * Props for paginated Crud.
+ *
+ * When `isPaginated` is true or omitted, the data source is fetched with pagination parameters.
+ *
+ * @template TRow - Table row model type
+ * @template TSearchValues - Search/filters form values type
+ * @template TSceneFormValues - A map of scene key to its form values type
+ * @template TParams - Additional query parameters type
+ */
+export interface PaginatedCrudProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never> extends BaseCrudProps<TRow, TSearchValues, TSceneFormValues, TParams> {
+    /**
+     * Enable pagination mode. Default is true.
+     */
+    isPaginated?: true;
+    /**
+     * Query function for fetching paginated data
+     */
+    queryFn: QueryFunction<PaginationResult<TRow>, PaginatedQueryParams<TSearchValues, TParams>>;
+}
+/**
+ * Props for non-paginated Crud.
+ *
+ * When `isPaginated` is false, the entire dataset is returned without pagination.
+ *
+ * @template TRow - Table row model type
+ * @template TSearchValues - Search/filters form values type
+ * @template TSceneFormValues - A map of scene key to its form values type
+ * @template TParams - Additional query parameters type
+ */
+export interface NonPaginatedCrudProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never> extends BaseCrudProps<TRow, TSearchValues, TSceneFormValues, TParams> {
+    /**
+     * Disable pagination mode for this variant
+     */
+    isPaginated: false;
+    /**
+     * Query function for fetching the full list data
+     */
+    queryFn: QueryFunction<TRow[], QueryParams<TSearchValues, TParams>>;
+}
+/**
+ * Discriminated union of paginated and non-paginated Crud props
+ */
+export type CrudProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never> = PaginatedCrudProps<TRow, TSearchValues, TSceneFormValues, TParams> | NonPaginatedCrudProps<TRow, TSearchValues, TSceneFormValues, TParams>;