@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/blocks/index.d.ts

@@ -1,1239 +1,14 @@
-import { ReactNode, MouseEvent } from 'react';
-import { SxProps, Theme } from '@mui/material';
-import { SxProps as SxProps$1, Theme as Theme$1 } from '@mui/material/styles';
-import { BoxProps } from '@mui/material/Box';
-import { ButtonProps } from '@mui/material/Button';
-import { TextFieldProps } from '@mui/material/TextField';
-import { z } from 'zod';
-import { GridColDef, GridRowsProp, GridDensity, GridRowId, GridRowParams, GridRowSelectionModel, GridPaginationModel, GridSortModel, GridFilterModel, GridSlots, GridSlotProps, GridCallbackDetails } from '@mui/x-data-grid';
-
 /**
- * Dashboard Block Types
+ * Prism Blocks Module
  *
- * Type definitions for the dashboard block component.
+ * Pre-built UI blocks combining multiple components for common patterns.
  *
- * @module @omnitron-dev/prism/blocks/dashboard-block/types
+ * @module @omnitron-dev/prism/blocks
  */
-
-/**
- * Dashboard block variant types.
- */
-type DashboardBlockVariant = 'default' | 'outlined' | 'filled';
-/**
- * Dashboard block size presets.
- */
-type DashboardBlockSize = 'small' | 'medium' | 'large';
-/**
- * Loading state configuration.
- */
-interface LoadingConfig {
-    /** Show skeleton loading */
-    skeleton?: boolean;
-    /** Number of skeleton rows */
-    skeletonRows?: number;
-    /** Custom loading component */
-    loadingComponent?: ReactNode;
-}
-/**
- * Error state configuration.
- */
-interface ErrorConfig {
-    /** Error message */
-    message?: string;
-    /** Retry callback */
-    onRetry?: () => void;
-    /** Custom error component */
-    errorComponent?: ReactNode;
-}
-/**
- * Dashboard block header props.
- */
-interface DashboardBlockHeaderProps {
-    /** Block title */
-    title: string;
-    /** Optional subtitle */
-    subtitle?: string;
-    /** Icon element */
-    icon?: ReactNode;
-    /** Actions slot (buttons, menu, etc.) */
-    actions?: ReactNode;
-    /** MUI sx prop */
-    sx?: SxProps<Theme>;
-}
-/**
- * Dashboard block content props.
- */
-interface DashboardBlockContentProps {
-    /** Content children */
-    children?: ReactNode;
-    /** Disable default padding */
-    disablePadding?: boolean;
-    /** MUI sx prop */
-    sx?: SxProps<Theme>;
-}
-/**
- * Dashboard block footer props.
- */
-interface DashboardBlockFooterProps {
-    /** Footer content */
-    children?: ReactNode;
-    /** Show divider above footer */
-    divider?: boolean;
-    /** MUI sx prop */
-    sx?: SxProps<Theme>;
-}
-/**
- * Dashboard block props.
- */
-interface DashboardBlockProps {
-    /** Block title */
-    title?: string;
-    /** Optional subtitle */
-    subtitle?: string;
-    /** Icon element */
-    icon?: ReactNode;
-    /** Actions slot */
-    actions?: ReactNode;
-    /** Content children */
-    children?: ReactNode;
-    /** Footer content */
-    footer?: ReactNode;
-    /** Block variant */
-    variant?: DashboardBlockVariant;
-    /** Block size */
-    size?: DashboardBlockSize;
-    /** Loading state */
-    loading?: boolean;
-    /** Loading configuration */
-    loadingConfig?: LoadingConfig;
-    /** Error state */
-    error?: boolean;
-    /** Error configuration */
-    errorConfig?: ErrorConfig;
-    /** Collapsible block */
-    collapsible?: boolean;
-    /** Initial collapsed state */
-    defaultCollapsed?: boolean;
-    /** Controlled collapsed state */
-    collapsed?: boolean;
-    /** Collapse change handler */
-    onCollapseChange?: (collapsed: boolean) => void;
-    /** Disable default content padding */
-    disablePadding?: boolean;
-    /** Show footer divider */
-    footerDivider?: boolean;
-    /** MUI sx prop */
-    sx?: SxProps<Theme>;
-    /** Header slot props */
-    slotProps?: {
-        header?: Partial<DashboardBlockHeaderProps>;
-        content?: Partial<DashboardBlockContentProps>;
-        footer?: Partial<DashboardBlockFooterProps>;
-    };
-}
-/**
- * Dashboard block context value.
- */
-interface DashboardBlockContextValue {
-    /** Current collapsed state */
-    collapsed: boolean;
-    /** Toggle collapse */
-    toggleCollapse: () => void;
-    /** Set collapsed state */
-    setCollapsed: (collapsed: boolean) => void;
-    /** Current loading state */
-    loading: boolean;
-    /** Current error state */
-    error: boolean;
-    /** Block variant */
-    variant: DashboardBlockVariant;
-    /** Block size */
-    size: DashboardBlockSize;
-}
-
-/**
- * Dashboard Block Component
- *
- * Reusable dashboard widget/card block with header, content, and footer slots.
- * Supports loading, error states, and collapsible behavior.
- *
- * @module @omnitron-dev/prism/blocks/dashboard-block
- */
-
-/**
- * Hook to access dashboard block context.
- */
-declare function useDashboardBlockContext(): DashboardBlockContextValue;
-/**
- * Dashboard block header component.
- */
-declare function DashboardBlockHeader({ title, subtitle, icon, actions, sx }: DashboardBlockHeaderProps): ReactNode;
-/**
- * Dashboard block content component.
- */
-declare function DashboardBlockContent({ children, disablePadding, sx }: DashboardBlockContentProps): ReactNode;
-/**
- * Dashboard block footer component.
- */
-declare function DashboardBlockFooter({ children, divider, sx }: DashboardBlockFooterProps): ReactNode;
-/**
- * Dashboard Block - Reusable dashboard widget/card.
- *
- * Features:
- * - Header with title, subtitle, icon, and actions
- * - Content area with optional padding
- * - Footer slot with optional divider
- * - Loading and error states
- * - Collapsible behavior (controlled or uncontrolled)
- * - Three size presets (small, medium, large)
- * - Three variants (default, outlined, filled)
- *
- * @example
- * ```tsx
- * <DashboardBlock
- *   title="Revenue Overview"
- *   subtitle="Last 30 days"
- *   icon={<BarChartIcon />}
- *   actions={<IconButton><MoreIcon /></IconButton>}
- *   collapsible
- * >
- *   <RevenueChart />
- * </DashboardBlock>
- * ```
- */
-declare function DashboardBlock({ title, subtitle, icon, actions, children, footer, variant, size, loading, loadingConfig, error, errorConfig, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapseChange, disablePadding, footerDivider, sx, slotProps, }: DashboardBlockProps): ReactNode;
-
-/**
- * Dashboard Block Hook
- *
- * Hook for managing dashboard block state and behavior.
- *
- * @module @omnitron-dev/prism/blocks/dashboard-block/use-dashboard-block
- */
-
-/**
- * Dashboard block state.
- */
-interface DashboardBlockState {
-    /** Current collapsed state */
-    collapsed: boolean;
-    /** Current loading state */
-    loading: boolean;
-    /** Current error state */
-    error: boolean;
-    /** Error message */
-    errorMessage?: string;
-}
-/**
- * Dashboard block actions.
- */
-interface DashboardBlockActions {
-    /** Toggle collapse state */
-    toggleCollapse: () => void;
-    /** Set collapsed state */
-    setCollapsed: (collapsed: boolean) => void;
-    /** Expand block */
-    expand: () => void;
-    /** Collapse block */
-    collapse: () => void;
-    /** Set loading state */
-    setLoading: (loading: boolean) => void;
-    /** Set error state */
-    setError: (error: boolean, message?: string) => void;
-    /** Clear error state */
-    clearError: () => void;
-    /** Reset to initial state */
-    reset: () => void;
-}
-/**
- * Dashboard block hook return value.
- */
-interface UseDashboardBlockReturn {
-    /** Current state */
-    state: DashboardBlockState;
-    /** Actions to modify state */
-    actions: DashboardBlockActions;
-    /** Props to spread on DashboardBlock */
-    blockProps: Pick<DashboardBlockProps, 'collapsed' | 'onCollapseChange' | 'loading' | 'error' | 'errorConfig'>;
-}
-/**
- * Options for useDashboardBlock hook.
- */
-interface UseDashboardBlockOptions {
-    /** Initial collapsed state */
-    defaultCollapsed?: boolean;
-    /** Initial loading state */
-    defaultLoading?: boolean;
-    /** Retry callback for error state */
-    onRetry?: () => void;
-}
-/**
- * Hook for managing dashboard block state.
- *
- * Provides controlled state management for DashboardBlock component,
- * including collapse, loading, and error states.
- *
- * @example
- * ```tsx
- * function MyWidget() {
- *   const { state, actions, blockProps } = useDashboardBlock({
- *     defaultCollapsed: false,
- *     onRetry: () => fetchData(),
- *   });
- *
- *   useEffect(() => {
- *     actions.setLoading(true);
- *     fetchData()
- *       .then(() => actions.setLoading(false))
- *       .catch((err) => actions.setError(true, err.message));
- *   }, []);
- *
- *   return (
- *     <DashboardBlock title="My Widget" {...blockProps}>
- *       <Content />
- *     </DashboardBlock>
- *   );
- * }
- * ```
- */
-declare function useDashboardBlock(options?: UseDashboardBlockOptions): UseDashboardBlockReturn;
-
-/**
- * Auth Block Types
- *
- * Type definitions for authentication-related block components.
- *
- * @module @omnitron-dev/prism/blocks/auth-block
- */
-
-/**
- * Base props for all auth forms
- */
-interface AuthFormBaseProps {
-    /** Called when form is submitted successfully */
-    onSubmit: (data: Record<string, unknown>) => Promise<void> | void;
-    /** Form loading state */
-    loading?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Custom styling */
-    sx?: SxProps$1<Theme$1>;
-    /** Slot props for nested components */
-    slotProps?: {
-        /** Wrapper props */
-        wrapper?: Partial<BoxProps>;
-        /** Submit button props */
-        submitButton?: Partial<ButtonProps>;
-        /** Text field props */
-        textField?: Partial<TextFieldProps>;
-    };
-}
-/**
- * Login form data
- */
-interface LoginFormData {
-    email: string;
-    password: string;
-    rememberMe?: boolean;
-}
-/**
- * Props for LoginForm component
- */
-interface LoginFormProps extends Omit<AuthFormBaseProps, 'onSubmit'> {
-    /** Called when form is submitted */
-    onSubmit: (data: LoginFormData) => Promise<void> | void;
-    /** Show "Remember me" checkbox */
-    showRememberMe?: boolean;
-    /** Show "Forgot password" link */
-    showForgotPassword?: boolean;
-    /** Forgot password link handler */
-    onForgotPassword?: () => void;
-    /** Show social login buttons */
-    showSocialLogin?: boolean;
-    /** Social login options */
-    socialProviders?: Array<{
-        id: string;
-        name: string;
-        icon: ReactNode;
-        onClick: () => void;
-    }>;
-    /** Custom validation schema */
-    schema?: z.ZodSchema<LoginFormData>;
-    /** Labels customization */
-    labels?: {
-        email?: string;
-        password?: string;
-        rememberMe?: string;
-        forgotPassword?: string;
-        submit?: string;
-        socialDivider?: string;
-    };
-}
-/**
- * Register form data
- */
-interface RegisterFormData {
-    email: string;
-    password: string;
-    confirmPassword: string;
-    firstName?: string;
-    lastName?: string;
-    acceptTerms?: boolean;
-}
-/**
- * Props for RegisterForm component
- */
-interface RegisterFormProps extends Omit<AuthFormBaseProps, 'onSubmit'> {
-    /** Called when form is submitted */
-    onSubmit: (data: RegisterFormData) => Promise<void> | void;
-    /** Show name fields */
-    showNameFields?: boolean;
-    /** Require terms acceptance */
-    requireTerms?: boolean;
-    /** Terms link handler */
-    onTermsClick?: () => void;
-    /** Privacy policy link handler */
-    onPrivacyClick?: () => void;
-    /** Minimum password length */
-    minPasswordLength?: number;
-    /** Custom validation schema */
-    schema?: z.ZodSchema<RegisterFormData>;
-    /** Labels customization */
-    labels?: {
-        email?: string;
-        password?: string;
-        confirmPassword?: string;
-        firstName?: string;
-        lastName?: string;
-        acceptTerms?: string;
-        termsLink?: string;
-        privacyLink?: string;
-        submit?: string;
-    };
-}
-/**
- * Forgot password form data
- */
-interface ForgotPasswordFormData {
-    email: string;
-}
-/**
- * Props for ForgotPasswordForm component
- */
-interface ForgotPasswordFormProps extends Omit<AuthFormBaseProps, 'onSubmit'> {
-    /** Called when form is submitted */
-    onSubmit: (data: ForgotPasswordFormData) => Promise<void> | void;
-    /** Back to login handler */
-    onBackToLogin?: () => void;
-    /** Custom validation schema */
-    schema?: z.ZodSchema<ForgotPasswordFormData>;
-    /** Labels customization */
-    labels?: {
-        title?: string;
-        description?: string;
-        email?: string;
-        submit?: string;
-        backToLogin?: string;
-    };
-}
-/**
- * Reset password form data
- */
-interface ResetPasswordFormData {
-    password: string;
-    confirmPassword: string;
-}
-/**
- * Props for ResetPasswordForm component
- */
-interface ResetPasswordFormProps extends Omit<AuthFormBaseProps, 'onSubmit'> {
-    /** Called when form is submitted */
-    onSubmit: (data: ResetPasswordFormData) => Promise<void> | void;
-    /** Minimum password length */
-    minPasswordLength?: number;
-    /** Custom validation schema */
-    schema?: z.ZodSchema<ResetPasswordFormData>;
-    /** Labels customization */
-    labels?: {
-        title?: string;
-        description?: string;
-        password?: string;
-        confirmPassword?: string;
-        submit?: string;
-    };
-}
-/**
- * Verify code form data
- */
-interface VerifyCodeFormData {
-    code: string;
-}
-/**
- * Props for VerifyCodeForm component
- */
-interface VerifyCodeFormProps extends Omit<AuthFormBaseProps, 'onSubmit'> {
-    /** Called when form is submitted */
-    onSubmit: (data: VerifyCodeFormData) => Promise<void> | void;
-    /** Code length (default: 6) */
-    codeLength?: number;
-    /** Resend code handler */
-    onResendCode?: () => void;
-    /** Resend cooldown in seconds */
-    resendCooldown?: number;
-    /** Custom validation schema */
-    schema?: z.ZodSchema<VerifyCodeFormData>;
-    /** Labels customization */
-    labels?: {
-        title?: string;
-        description?: string;
-        resendCode?: string;
-        resendIn?: string;
-        submit?: string;
-    };
-}
-/**
- * Auth block variant
- */
-type AuthBlockVariant = 'login' | 'register' | 'forgot-password' | 'reset-password' | 'verify-code';
-
-/**
- * Auth Block Component
- *
- * Reusable authentication forms: login, register, forgot password, etc.
- * Integrates with React Hook Form and Zod for validation.
- *
- * @module @omnitron-dev/prism/blocks/auth-block
- */
-
-/**
- * Login form component with email/password authentication.
- *
- * @example
- * ```tsx
- * <LoginForm
- *   onSubmit={async (data) => {
- *     await signIn(data.email, data.password);
- *   }}
- *   showRememberMe
- *   showForgotPassword
- *   onForgotPassword={() => navigate('/forgot-password')}
- * />
- * ```
- */
-declare function LoginForm({ onSubmit, loading, disabled, showRememberMe, showForgotPassword, onForgotPassword, showSocialLogin, socialProviders, schema, labels, sx, slotProps, }: LoginFormProps): ReactNode;
-/**
- * Registration form component.
- *
- * @example
- * ```tsx
- * <RegisterForm
- *   onSubmit={async (data) => {
- *     await signUp(data);
- *   }}
- *   showNameFields
- *   requireTerms
- *   onTermsClick={() => window.open('/terms')}
- * />
- * ```
- */
-declare function RegisterForm({ onSubmit, loading, disabled, showNameFields, requireTerms, onTermsClick, onPrivacyClick, minPasswordLength, schema, labels, sx, slotProps, }: RegisterFormProps): ReactNode;
-/**
- * Forgot password form component.
- *
- * @example
- * ```tsx
- * <ForgotPasswordForm
- *   onSubmit={async (data) => {
- *     await sendPasswordResetEmail(data.email);
- *   }}
- *   onBackToLogin={() => navigate('/login')}
- * />
- * ```
- */
-declare function ForgotPasswordForm({ onSubmit, loading, disabled, onBackToLogin, schema, labels, sx, slotProps, }: ForgotPasswordFormProps): ReactNode;
-/**
- * Reset password form component.
- *
- * @example
- * ```tsx
- * <ResetPasswordForm
- *   onSubmit={async (data) => {
- *     await resetPassword(token, data.password);
- *   }}
- * />
- * ```
- */
-declare function ResetPasswordForm({ onSubmit, loading, disabled, minPasswordLength, schema, labels, sx, slotProps, }: ResetPasswordFormProps): ReactNode;
-/**
- * Verify code form component (OTP verification).
- *
- * @example
- * ```tsx
- * <VerifyCodeForm
- *   onSubmit={async (data) => {
- *     await verifyCode(data.code);
- *   }}
- *   onResendCode={async () => {
- *     await resendVerificationCode();
- *   }}
- *   resendCooldown={60}
- * />
- * ```
- */
-declare function VerifyCodeForm({ onSubmit, loading, disabled, codeLength, onResendCode, resendCooldown, schema, labels, sx, slotProps, }: VerifyCodeFormProps): ReactNode;
-/**
- * AuthBlock namespace for auth-related forms.
- */
-declare const AuthBlock: {
-    readonly Login: typeof LoginForm;
-    readonly Register: typeof RegisterForm;
-    readonly ForgotPassword: typeof ForgotPasswordForm;
-    readonly ResetPassword: typeof ResetPasswordForm;
-    readonly VerifyCode: typeof VerifyCodeForm;
-};
-
-/**
- * Route Guards
- *
- * Authentication and authorization guards for route protection.
- * Works with any router (React Router, Next.js, TanStack Router).
- *
- * @module @omnitron-dev/prism/blocks/auth-block
- */
-
-/**
- * User role type - string or enum value.
- */
-type Role = string;
-/**
- * Permission type - string identifier.
- */
-type Permission = string;
-/**
- * User with roles and permissions for authorization.
- */
-interface AuthUser {
-    /** User ID */
-    id: string | number;
-    /** User roles */
-    roles?: Role[];
-    /** User permissions (fine-grained) */
-    permissions?: Permission[];
-    /** Email verified status */
-    emailVerified?: boolean;
-    /** Any additional properties */
-    [key: string]: unknown;
-}
-/**
- * Auth state for guards.
- */
-interface AuthState {
-    /** Whether user is authenticated */
-    isAuthenticated: boolean;
-    /** Whether auth state is still loading */
-    isLoading: boolean;
-    /** Current user (if authenticated) */
-    user?: AuthUser | null;
-}
-/**
- * Props for useAuth hook.
- * Guards need this to check auth state.
- */
-interface UseAuth {
-    (): AuthState;
-}
-/**
- * AuthGuard props.
- */
-interface AuthGuardProps {
-    /** Children to render when authorized */
-    children: ReactNode;
-    /** Hook to get auth state */
-    useAuth: UseAuth;
-    /** Component to show while loading */
-    loadingComponent?: ReactNode;
-    /** Called when not authenticated (e.g., redirect to login) */
-    onUnauthenticated?: () => void;
-    /** Component to show when not authenticated (if no redirect) */
-    unauthenticatedComponent?: ReactNode;
-}
-/**
- * Guard that requires authentication.
- *
- * @example
- * ```tsx
- * import { AuthGuard } from '@omnitron-dev/prism/blocks';
- * import { useAuth } from '../hooks/use-auth';
- *
- * function ProtectedPage() {
- *   return (
- *     <AuthGuard
- *       useAuth={useAuth}
- *       onUnauthenticated={() => navigate('/login')}
- *       loadingComponent={<LoadingScreen />}
- *     >
- *       <DashboardContent />
- *     </AuthGuard>
- *   );
- * }
- * ```
- */
-declare function AuthGuard({ children, useAuth, loadingComponent, onUnauthenticated, unauthenticatedComponent, }: AuthGuardProps): ReactNode;
-/**
- * GuestGuard props.
- */
-interface GuestGuardProps {
-    /** Children to render when not authenticated */
-    children: ReactNode;
-    /** Hook to get auth state */
-    useAuth: UseAuth;
-    /** Component to show while loading */
-    loadingComponent?: ReactNode;
-    /** Called when authenticated (e.g., redirect to dashboard) */
-    onAuthenticated?: () => void;
-    /** Component to show when authenticated (if no redirect) */
-    authenticatedComponent?: ReactNode;
-}
-/**
- * Guard that requires NO authentication.
- * Use for login, register, forgot password pages.
- *
- * @example
- * ```tsx
- * import { GuestGuard } from '@omnitron-dev/prism/blocks';
- * import { useAuth } from '../hooks/use-auth';
- *
- * function LoginPage() {
- *   return (
- *     <GuestGuard
- *       useAuth={useAuth}
- *       onAuthenticated={() => navigate('/dashboard')}
- *       loadingComponent={<LoadingScreen />}
- *     >
- *       <LoginForm />
- *     </GuestGuard>
- *   );
- * }
- * ```
- */
-declare function GuestGuard({ children, useAuth, loadingComponent, onAuthenticated, authenticatedComponent, }: GuestGuardProps): ReactNode;
-/**
- * RoleBasedGuard props.
- */
-interface RoleBasedGuardProps {
-    /** Children to render when authorized */
-    children: ReactNode;
-    /** Hook to get auth state */
-    useAuth: UseAuth;
-    /** Required roles (user must have at least one) */
-    roles?: Role[];
-    /** Required permissions (user must have ALL) */
-    permissions?: Permission[];
-    /** Require email verification */
-    requireEmailVerified?: boolean;
-    /** Match strategy for roles: 'any' (default) or 'all' */
-    roleMatchStrategy?: 'any' | 'all';
-    /** Component to show while loading */
-    loadingComponent?: ReactNode;
-    /** Called when access denied */
-    onAccessDenied?: (reason: AccessDeniedReason) => void;
-    /** Component to show when access denied */
-    accessDeniedComponent?: ReactNode;
-}
-/**
- * Reason for access denial.
- */
-type AccessDeniedReason = 'not_authenticated' | 'missing_role' | 'missing_permission' | 'email_not_verified';
-/**
- * Guard for role/permission-based access control.
- *
- * @example
- * ```tsx
- * import { RoleBasedGuard } from '@omnitron-dev/prism/blocks';
- * import { useAuth } from '../hooks/use-auth';
- *
- * // Require admin role
- * function AdminPage() {
- *   return (
- *     <RoleBasedGuard
- *       useAuth={useAuth}
- *       roles={['admin']}
- *       onAccessDenied={() => navigate('/403')}
- *     >
- *       <AdminPanel />
- *     </RoleBasedGuard>
- *   );
- * }
- *
- * // Require specific permission
- * function EditUserPage() {
- *   return (
- *     <RoleBasedGuard
- *       useAuth={useAuth}
- *       permissions={['users:write']}
- *       accessDeniedComponent={<AccessDenied />}
- *     >
- *       <UserEditForm />
- *     </RoleBasedGuard>
- *   );
- * }
- *
- * // Require admin OR moderator role
- * function ModeratePage() {
- *   return (
- *     <RoleBasedGuard
- *       useAuth={useAuth}
- *       roles={['admin', 'moderator']}
- *       roleMatchStrategy="any"
- *     >
- *       <ModerateContent />
- *     </RoleBasedGuard>
- *   );
- * }
- *
- * // Require email verified
- * function VerifiedOnlyPage() {
- *   return (
- *     <RoleBasedGuard
- *       useAuth={useAuth}
- *       requireEmailVerified
- *       onAccessDenied={(reason) => {
- *         if (reason === 'email_not_verified') {
- *           navigate('/verify-email');
- *         }
- *       }}
- *     >
- *       <VerifiedContent />
- *     </RoleBasedGuard>
- *   );
- * }
- * ```
- */
-declare function RoleBasedGuard({ children, useAuth, roles, permissions, requireEmailVerified, roleMatchStrategy, loadingComponent, onAccessDenied, accessDeniedComponent, }: RoleBasedGuardProps): ReactNode;
-/**
- * Check if user has specific role(s).
- *
- * @example
- * ```tsx
- * const isAdmin = hasRole(user, 'admin');
- * const isModerator = hasRole(user, ['admin', 'moderator'], 'any');
- * const isSuperAdmin = hasRole(user, ['admin', 'superuser'], 'all');
- * ```
- */
-declare function hasRole(user: AuthUser | null | undefined, role: Role | Role[], strategy?: 'any' | 'all'): boolean;
-/**
- * Check if user has specific permission(s).
- *
- * @example
- * ```tsx
- * const canEdit = hasPermission(user, 'users:write');
- * const canManage = hasPermission(user, ['users:read', 'users:write'], 'all');
- * ```
- */
-declare function hasPermission(user: AuthUser | null | undefined, permission: Permission | Permission[], strategy?: 'any' | 'all'): boolean;
-/**
- * Create a conditional render helper based on roles/permissions.
- *
- * @example
- * ```tsx
- * const { canRender } = useConditionalRender(user);
- *
- * return (
- *   <div>
- *     {canRender({ roles: ['admin'] }) && <AdminPanel />}
- *     {canRender({ permissions: ['users:write'] }) && <EditButton />}
- *   </div>
- * );
- * ```
- */
-declare function createConditionalRender(user: AuthUser | null | undefined): {
-    canRender: (options: {
-        roles?: Role[];
-        permissions?: Permission[];
-        roleMatchStrategy?: "any" | "all";
-    }) => boolean;
-};
-
-/**
- * DataGrid Block Types
- *
- * Type definitions for the advanced data grid block component.
- *
- * @module @omnitron-dev/prism/blocks/data-grid-block/types
- */
-
-/**
- * Row action item configuration.
- */
-interface DataGridRowAction<R = Record<string, unknown>> {
-    /** Unique action key */
-    key: string;
-    /** Action label */
-    label: string;
-    /** Action icon */
-    icon?: ReactNode;
-    /** Color variant */
-    color?: 'inherit' | 'primary' | 'secondary' | 'success' | 'error' | 'info' | 'warning';
-    /** Disabled state or function */
-    disabled?: boolean | ((row: R) => boolean);
-    /** Hidden state or function */
-    hidden?: boolean | ((row: R) => boolean);
-    /** Divider after this action */
-    divider?: boolean;
-    /** Click handler */
-    onClick: (row: R, event: MouseEvent<HTMLElement>) => void;
-}
-/**
- * Quick filter configuration.
- */
-interface QuickFilterConfig {
-    /** Enable quick filter */
-    enabled?: boolean;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Debounce delay in ms */
-    debounceMs?: number;
-}
-/**
- * Export configuration.
- */
-interface ExportConfig {
-    /** Enable CSV export */
-    csv?: boolean;
-    /** Enable Excel export (requires premium) */
-    excel?: boolean;
-    /** Enable print */
-    print?: boolean;
-    /** Custom file name */
-    fileName?: string;
-}
-/**
- * Column visibility configuration.
- */
-interface ColumnVisibilityConfig {
-    /** Enable column visibility panel */
-    enabled?: boolean;
-    /** Default visibility model */
-    defaultModel?: Record<string, boolean>;
-}
-/**
- * Toolbar configuration.
- */
-interface DataGridToolbarConfig {
-    /** Show toolbar */
-    show?: boolean;
-    /** Quick filter config */
-    quickFilter?: QuickFilterConfig;
-    /** Export config */
-    export?: ExportConfig;
-    /** Column visibility config */
-    columnVisibility?: ColumnVisibilityConfig;
-    /** Density selector */
-    densitySelector?: boolean;
-    /** Custom toolbar actions */
-    actions?: ReactNode;
-    /** Custom toolbar content (left side) */
-    startContent?: ReactNode;
-    /** Custom toolbar content (right side) */
-    endContent?: ReactNode;
-}
-/**
- * Pagination configuration.
- */
-interface DataGridPaginationConfig {
-    /** Pagination mode */
-    mode?: 'client' | 'server';
-    /** Page size options */
-    pageSizeOptions?: number[];
-    /** Default page size */
-    defaultPageSize?: number;
-    /** Total row count (for server-side pagination) */
-    rowCount?: number;
-    /** Hide pagination */
-    hide?: boolean;
-}
-/**
- * Selection configuration.
- */
-interface DataGridSelectionConfig {
-    /** Enable row selection */
-    enabled?: boolean;
-    /** Selection mode */
-    mode?: 'single' | 'multiple';
-    /** Checkbox selection */
-    checkboxSelection?: boolean;
-    /** Keep non-existent rows selected */
-    keepNonExistentRowsSelected?: boolean;
-    /** Disable selection on click */
-    disableSelectionOnClick?: boolean;
-}
-/**
- * Empty state configuration.
- */
-interface DataGridEmptyConfig {
-    /** Empty state icon */
-    icon?: ReactNode;
-    /** Empty state title */
-    title?: string;
-    /** Empty state description */
-    description?: string;
-    /** Custom empty component */
-    component?: ReactNode;
-    /** Action button */
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-}
-/**
- * DataGridBlock props.
- */
-interface DataGridBlockProps<R extends Record<string, unknown> = Record<string, unknown>> {
-    /** Column definitions */
-    columns: GridColDef<R>[];
-    /** Row data */
-    rows: GridRowsProp<R>;
-    /** Loading state */
-    loading?: boolean;
-    /** Error state */
-    error?: boolean;
-    /** Error message */
-    errorMessage?: string;
-    /** Retry handler */
-    onRetry?: () => void;
-    /** Row actions */
-    rowActions?: DataGridRowAction<R>[];
-    /** Row actions column width */
-    rowActionsWidth?: number;
-    /** Toolbar configuration */
-    toolbar?: DataGridToolbarConfig;
-    /** Pagination configuration */
-    pagination?: DataGridPaginationConfig;
-    /** Selection configuration */
-    selection?: DataGridSelectionConfig;
-    /** Empty state configuration */
-    empty?: DataGridEmptyConfig;
-    /** Density */
-    density?: GridDensity;
-    /** Auto height */
-    autoHeight?: boolean;
-    /** Fixed height */
-    height?: number | string;
-    /** Hide footer */
-    hideFooter?: boolean;
-    /** Row height */
-    rowHeight?: number;
-    /** Get row id */
-    getRowId?: (row: R) => GridRowId;
-    /** Row click handler */
-    onRowClick?: (params: GridRowParams<R>) => void;
-    /** Row double click handler */
-    onRowDoubleClick?: (params: GridRowParams<R>) => void;
-    /** Selection change handler */
-    onSelectionChange?: (selection: GridRowSelectionModel) => void;
-    /** Pagination change handler */
-    onPaginationChange?: (model: GridPaginationModel) => void;
-    /** Sort change handler */
-    onSortChange?: (model: GridSortModel) => void;
-    /** Filter change handler */
-    onFilterChange?: (model: GridFilterModel) => void;
-    /** Controlled pagination model */
-    paginationModel?: GridPaginationModel;
-    /** Controlled sort model */
-    sortModel?: GridSortModel;
-    /** Controlled filter model */
-    filterModel?: GridFilterModel;
-    /** Controlled selection model */
-    selectionModel?: GridRowSelectionModel;
-    /** Column visibility model */
-    columnVisibilityModel?: Record<string, boolean>;
-    /** Column visibility change handler */
-    onColumnVisibilityChange?: (model: Record<string, boolean>) => void;
-    /** Custom slots */
-    slots?: Partial<GridSlots>;
-    /** Custom slot props */
-    slotProps?: GridSlotProps;
-    /** Disable column menu */
-    disableColumnMenu?: boolean;
-    /** Disable column filter */
-    disableColumnFilter?: boolean;
-    /** Disable column selector */
-    disableColumnSelector?: boolean;
-    /** Disable row selection on click */
-    disableRowSelectionOnClick?: boolean;
-    /** Disable virtualization */
-    disableVirtualization?: boolean;
-    /** MUI sx prop */
-    sx?: SxProps$1<Theme$1>;
-}
-/**
- * DataGridBlock context value.
- */
-interface DataGridBlockContextValue {
-    /** Current loading state */
-    loading: boolean;
-    /** Current error state */
-    error: boolean;
-    /** Current density */
-    density: GridDensity;
-    /** Set density */
-    setDensity: (density: GridDensity) => void;
-    /** Current row count */
-    rowCount: number;
-    /** Selected row count */
-    selectedCount: number;
-    /** Refresh data */
-    refresh?: () => void;
-}
-/**
- * useDataGridBlock options.
- */
-interface UseDataGridBlockOptions<R = Record<string, unknown>> {
-    /** Data fetcher function */
-    fetcher: (params: DataGridFetchParams) => Promise<DataGridFetchResult<R>>;
-    /** Initial page size */
-    initialPageSize?: number;
-    /** Initial sort model */
-    initialSortModel?: GridSortModel;
-    /** Initial filter model */
-    initialFilterModel?: GridFilterModel;
-    /** Auto fetch on mount */
-    autoFetch?: boolean;
-    /** Keep previous data while loading */
-    keepPreviousData?: boolean;
-}
-/**
- * Fetch parameters passed to the fetcher function.
- */
-interface DataGridFetchParams {
-    /** Current page (0-indexed) */
-    page: number;
-    /** Page size */
-    pageSize: number;
-    /** Sort model */
-    sortModel: GridSortModel;
-    /** Filter model */
-    filterModel: GridFilterModel;
-    /** Quick filter value */
-    quickFilterValue?: string;
-}
-/**
- * Fetch result from the fetcher function.
- */
-interface DataGridFetchResult<R = Record<string, unknown>> {
-    /** Row data */
-    rows: R[];
-    /** Total row count */
-    total: number;
-}
-/**
- * useDataGridBlock return value.
- */
-interface UseDataGridBlockReturn<R = Record<string, unknown>> {
-    /** Row data */
-    rows: R[];
-    /** Loading state */
-    loading: boolean;
-    /** Error state */
-    error: Error | null;
-    /** Total row count */
-    total: number;
-    /** Pagination model */
-    paginationModel: GridPaginationModel;
-    /** Sort model */
-    sortModel: GridSortModel;
-    /** Filter model */
-    filterModel: GridFilterModel;
-    /** Pagination change handler */
-    onPaginationChange: (model: GridPaginationModel, details: GridCallbackDetails) => void;
-    /** Sort change handler */
-    onSortChange: (model: GridSortModel, details: GridCallbackDetails) => void;
-    /** Filter change handler */
-    onFilterChange: (model: GridFilterModel, details: GridCallbackDetails) => void;
-    /** Refresh data */
-    refresh: () => void;
-    /** Reset to initial state */
-    reset: () => void;
-}
-
-/**
- * DataGrid Block Component
- *
- * Advanced data table block with toolbar, pagination, sorting, filtering,
- * row actions, and server-side data support.
- *
- * @module @omnitron-dev/prism/blocks/data-grid-block
- */
-
-/**
- * Hook to access data grid block context.
- */
-declare function useDataGridBlockContext(): DataGridBlockContextValue;
-/**
- * DataGridBlock - Advanced data table with common patterns.
- *
- * Features:
- * - Custom toolbar with search, filters, export, and column visibility
- * - Row actions column (inline or dropdown menu)
- * - Server-side pagination, sorting, and filtering support
- * - Custom empty state
- * - Loading and error states
- * - Selection handling
- * - Density customization
- *
- * @example
- * ```tsx
- * <DataGridBlock
- *   columns={[
- *     { field: 'name', headerName: 'Name', flex: 1 },
- *     { field: 'email', headerName: 'Email', flex: 1 },
- *     { field: 'status', headerName: 'Status', width: 120 },
- *   ]}
- *   rows={users}
- *   loading={isLoading}
- *   rowActions={[
- *     { key: 'edit', label: 'Edit', icon: <EditIcon />, onClick: handleEdit },
- *     { key: 'delete', label: 'Delete', icon: <DeleteIcon />, color: 'error', onClick: handleDelete },
- *   ]}
- *   toolbar={{
- *     quickFilter: { placeholder: 'Search users...' },
- *     export: { csv: true },
- *   }}
- *   pagination={{
- *     mode: 'server',
- *     rowCount: totalCount,
- *   }}
- *   onPaginationChange={handlePaginationChange}
- * />
- * ```
- */
-declare function DataGridBlock<R extends Record<string, unknown> = Record<string, unknown>>({ columns, rows, loading, error, errorMessage, onRetry, rowActions, rowActionsWidth, toolbar, pagination, selection, empty, density: defaultDensity, autoHeight, height, hideFooter, rowHeight, getRowId, onRowClick, onRowDoubleClick, onSelectionChange, onPaginationChange, onSortChange, onFilterChange, paginationModel: controlledPaginationModel, sortModel: controlledSortModel, filterModel: controlledFilterModel, selectionModel: controlledSelectionModel, columnVisibilityModel, onColumnVisibilityChange, slots, slotProps, disableColumnMenu, disableColumnFilter, disableColumnSelector, disableRowSelectionOnClick, disableVirtualization, sx, }: DataGridBlockProps<R>): ReactNode;
-/**
- * Hook for managing DataGridBlock with server-side data fetching.
- *
- * @example
- * ```tsx
- * const { rows, loading, error, total, paginationModel, onPaginationChange, refresh } =
- *   useDataGridBlock({
- *     fetcher: async ({ page, pageSize, sortModel, filterModel }) => {
- *       const response = await api.getUsers({ page, pageSize, sort: sortModel[0] });
- *       return { rows: response.data, total: response.total };
- *     },
- *   });
- *
- * return (
- *   <DataGridBlock
- *     columns={columns}
- *     rows={rows}
- *     loading={loading}
- *     error={!!error}
- *     pagination={{ mode: 'server', rowCount: total }}
- *     paginationModel={paginationModel}
- *     onPaginationChange={onPaginationChange}
- *   />
- * );
- * ```
- */
-declare function useDataGridBlock<R extends Record<string, unknown> = Record<string, unknown>>(options: UseDataGridBlockOptions<R>): UseDataGridBlockReturn<R>;
-
-export { type AccessDeniedReason, AuthBlock, type AuthBlockVariant, AuthGuard, type AuthGuardProps, type AuthState, type AuthUser, type ColumnVisibilityConfig, DashboardBlock, type DashboardBlockActions, DashboardBlockContent, type DashboardBlockContentProps, type DashboardBlockContextValue, DashboardBlockFooter, type DashboardBlockFooterProps, DashboardBlockHeader, type DashboardBlockHeaderProps, type DashboardBlockProps, type DashboardBlockSize, type DashboardBlockState, type DashboardBlockVariant, DataGridBlock, type DataGridBlockContextValue, type DataGridBlockProps, type DataGridEmptyConfig, type DataGridFetchParams, type DataGridFetchResult, type DataGridPaginationConfig, type DataGridRowAction, type DataGridSelectionConfig, type DataGridToolbarConfig, type ErrorConfig, type ExportConfig, ForgotPasswordForm, type ForgotPasswordFormData, type ForgotPasswordFormProps, GuestGuard, type GuestGuardProps, type LoadingConfig, LoginForm, type LoginFormData, type LoginFormProps, type Permission, type QuickFilterConfig, RegisterForm, type RegisterFormData, type RegisterFormProps, ResetPasswordForm, type ResetPasswordFormData, type ResetPasswordFormProps, type Role, RoleBasedGuard, type RoleBasedGuardProps, type UseAuth, type UseDashboardBlockOptions, type UseDashboardBlockReturn, type UseDataGridBlockOptions, type UseDataGridBlockReturn, VerifyCodeForm, type VerifyCodeFormData, type VerifyCodeFormProps, createConditionalRender, hasPermission, hasRole, useDashboardBlock, useDashboardBlockContext, useDataGridBlock, useDataGridBlockContext };
+export { DashboardBlock, DashboardBlockHeader, DashboardBlockContent, DashboardBlockFooter, useDashboardBlockContext, useDashboardBlock, } from './dashboard-block/index.js';
+export type { DashboardBlockProps, DashboardBlockVariant, DashboardBlockSize, DashboardBlockHeaderProps, DashboardBlockContentProps, DashboardBlockFooterProps, DashboardBlockContextValue, LoadingConfig, ErrorConfig, UseDashboardBlockReturn, UseDashboardBlockOptions, DashboardBlockState, DashboardBlockActions, } from './dashboard-block/index.js';
+export { AuthBlock, LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, VerifyCodeForm, AuthGuard, GuestGuard, RoleBasedGuard, hasRole, hasPermission, createConditionalRender, } from './auth-block/index.js';
+export type { LoginFormProps, LoginFormData, RegisterFormProps, RegisterFormData, ForgotPasswordFormProps, ForgotPasswordFormData, ResetPasswordFormProps, ResetPasswordFormData, VerifyCodeFormProps, VerifyCodeFormData, AuthBlockVariant, Role, Permission, AuthUser, AuthState, UseAuth, AuthGuardProps, GuestGuardProps, RoleBasedGuardProps, AccessDeniedReason, } from './auth-block/index.js';
+export { DataGridBlock, useDataGridBlock, useDataGridBlockContext } from './data-grid-block/index.js';
+export type { DataGridBlockProps, DataGridBlockContextValue, DataGridRowAction, DataGridToolbarConfig, DataGridPaginationConfig, DataGridSelectionConfig, DataGridEmptyConfig, QuickFilterConfig, ExportConfig, ColumnVisibilityConfig, UseDataGridBlockOptions, UseDataGridBlockReturn, DataGridFetchParams, DataGridFetchResult, } from './data-grid-block/index.js';
+//# sourceMappingURL=index.d.ts.map