warqadui 0.0.51 → 0.0.53

package/dist/index.d.mts

@@ -7,6 +7,7 @@ import { ColumnDef, SortingState, ColumnFiltersState, RowData } from '@tanstack/
 import * as z from 'zod';
 import * as react_to_print from 'react-to-print';
 import { UploadFile } from 'antd';
+import * as zustand from 'zustand';
 
 interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "danger" | "warning";
@@ -528,6 +529,34 @@ interface BrandingProps {
 }
 declare const Branding: React__default.FC<BrandingProps>;
 
+interface ProfileCardProps {
+    name: string;
+    role?: string;
+    image?: string;
+    details: Record<string, string | number | undefined | null>;
+    backUrl?: string;
+    className?: string;
+}
+declare const ProfileCard: React__default.FC<ProfileCardProps>;
+
+interface ProfileViewInfoItem {
+    label: string;
+    value: string | number | undefined | null;
+    copiable?: boolean;
+}
+interface ProfileViewProps {
+    name: string;
+    role?: string;
+    email?: string;
+    imgUrl?: string;
+    userId?: string;
+    info?: ProfileViewInfoItem[];
+    className?: string;
+    title?: string;
+    description?: string;
+}
+declare const ProfileView: React__default.FC<ProfileViewProps>;
+
 type LoginTheme = "tech" | "travel" | "healthcare";
 interface BaseLoginProps {
     form: UseFormReturn<LoginSchema>;
@@ -540,6 +569,7 @@ interface BaseLoginProps {
     footer?: React__default.ReactNode;
     brandName?: string;
     backUrl?: string;
+    isLoading?: boolean;
 }
 declare const ThemedLogin: React__default.FC<BaseLoginProps>;
 
@@ -564,6 +594,7 @@ interface UseLoginProps {
     title?: string;
     subtitle?: string;
     backUrl?: string;
+    isLoading?: boolean;
 }
 declare const useLogin: (props: UseLoginProps) => {
     form: UseFormReturn<{
@@ -576,6 +607,24 @@ declare const useLogin: (props: UseLoginProps) => {
     Login: React__default.FC<{}>;
 };
 
+interface ProfileDropdownItem {
+    label: string;
+    icon?: React__default.ReactNode;
+    onClick?: () => void | Promise<void>;
+    disabled?: boolean;
+    className?: string;
+}
+interface ProfileDropdownProps {
+    name: string;
+    image?: string;
+    items: ProfileDropdownItem[];
+    className?: string;
+    triggerMode?: "click" | "hover";
+    size?: "sm" | "md" | "lg";
+    role?: string;
+}
+declare const ProfileDropdown: React__default.FC<ProfileDropdownProps>;
+
 interface FetchProps {
     url: string;
     body?: Record<string, any>;
@@ -688,7 +737,7 @@ declare const useTransaction: ({ url, v, delay, params, dateFilter, }: {
     params?: Record<string, any>;
     dateFilter?: boolean;
 }) => {
-    TransactionViewComponent: ({ columns, data, error, pageRows, searchPlaceholder, selectable, filterables, verticalLines, index, rowPadding, className, title, description, onCreate, createTitle, ...rest }: {
+    TransactionViewComponent: ({ columns, data, error, pageRows, searchPlaceholder, selectable, filterables, verticalLines, index, rowPadding, className, title, description, showReload, onCreate, createTitle, ...rest }: {
         columns: DataTableColumn[];
         data: any[];
         error?: any;
@@ -702,6 +751,7 @@ declare const useTransaction: ({ url, v, delay, params, dateFilter, }: {
         className?: string;
         title?: string;
         description?: string;
+        showReload?: boolean;
         onCreate?: () => void;
         createTitle?: string;
     }) => react_jsx_runtime.JSX.Element;
@@ -823,4 +873,154 @@ declare const Views: {
     }>;
 };
 
-export { Badge, type BadgeProps, Branding, type BrandingProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryCard, type CategoryItem, ClassicSpin, CodeBlock, DashboardLayout, DataTable, type DataTableColumn, DateInput, type DateInputProps, type DeleteFunction, type FetchFunction, type FetchProps, Fields, InfoGrid, Input, type InputProps, LoadingBox, LoadingSpin, type LoginSchema, type LoginTheme, Modal, type ModalProps, type NavItem, type NavItems, type Option, OverlaySpin, PageA4, PageHeader, type PdfOptions, PhoneInput, type PhoneInputProps, type PostFunction, PostTable, type PostTableActions, type PostTableChangeParams, type PutFunction, SearchApi, SearchApiContent, SearchApiInput, SearchApiItem, type SearchApiProps, SearchApiTrigger, Select, SelectContent, SelectItem, type SelectProps, SelectTrigger, SimpleTable, type SimpleTableColumn, type StorageManager, type StoreConfig, Textarea, type TextareaProps, type ThemeConfig, ThemeProvider, ThemeToggle, ThemedLogin, type UseModalReturn, Views, type WarqadConfig, type WarqadConfigContextType, WarqadProvider, generatePdf, storage, useA4CategoryView, useA4StatementView, useAntdImageUpload, useApi, useLogin, useModal, useSearchApiContext, useSelectContext, useTheme, useTransaction, useWarqadConfig };
+/**
+ * Guard component that fetches the current user profile on every route change.
+ * It ensures the auth state is synchronized with the server.
+ */
+declare const Guard: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures the user is logged in to access child routes.
+ */
+declare const ProtectedRoute: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures the user is NOT logged in to access child routes (e.g. Login/Signup pages).
+ */
+declare const UnProtectedRoute: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures only users with 'admin' role can access child routes.
+ */
+declare const AdminProtectedRoute: () => react_jsx_runtime.JSX.Element;
+
+type Role = string;
+type AccountType = string;
+type AuthData = {
+    _id: string;
+    role: Role;
+    email: string;
+    phoneNumber: string;
+    isActive: boolean;
+    isEmailVerified: boolean;
+    isPhoneVerified: boolean;
+    permissions?: Record<string, boolean>;
+    homePath?: string;
+};
+type AccountData = {
+    _id: string;
+    name: string;
+    email: string;
+    phoneNumber: string;
+    type: AccountType;
+};
+type AuthState = {
+    auth: AuthData | null;
+    account: AccountData | null;
+    isLoggedIn: boolean;
+    isFetched: boolean;
+    setAuth: (auth: AuthData, account: AccountData) => void;
+    setIsLoggedIn: (isLoggedIn: boolean) => void;
+    setIsFetched: (isFetched: boolean) => void;
+    logout: () => void;
+    updateAuth: (data: Partial<AuthData>) => void;
+    updateAccount: (data: Partial<AccountData>) => void;
+    hasPermission: (key: string) => boolean;
+};
+declare const useAuthStore: zustand.UseBoundStore<zustand.StoreApi<AuthState>>;
+
+declare const useAuth: () => {
+    auth: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    } | null;
+    user: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    } | null;
+    account: {
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    } | null;
+    isLoggedIn: boolean;
+    isFetched: boolean;
+    role: string | undefined;
+    userId: string | undefined;
+    accountId: string | undefined;
+    userName: string | undefined;
+    userEmail: string | undefined;
+    permissions: Record<string, boolean>;
+    isAdmin: boolean;
+    isActive: boolean;
+    isVerified: boolean;
+    isEmailVerified: boolean;
+    isPhoneVerified: boolean;
+    logout: () => void;
+    setIsLoggedIn: (isLoggedIn: boolean) => void;
+    setIsFetched: (isFetched: boolean) => void;
+    setAuth: (auth: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }, account: {
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    }) => void;
+    login: (data: any) => void;
+    updateAuth: (data: Partial<{
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }>) => void;
+    updateUser: (data: Partial<{
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }>) => void;
+    updateAccount: (data: Partial<{
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    }>) => void;
+    hasPermission: (key: string) => boolean;
+    can: (key: string) => boolean;
+};
+
+export { type AccountType, AdminProtectedRoute, Badge, type BadgeProps, Branding, type BrandingProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryCard, type CategoryItem, ClassicSpin, CodeBlock, DashboardLayout, DataTable, type DataTableColumn, DateInput, type DateInputProps, type DeleteFunction, type FetchFunction, type FetchProps, Fields, Guard, InfoGrid, Input, type InputProps, LoadingBox, LoadingSpin, type LoginSchema, type LoginTheme, Modal, type ModalProps, type NavItem, type NavItems, type Option, OverlaySpin, PageA4, PageHeader, type PdfOptions, PhoneInput, type PhoneInputProps, type PostFunction, PostTable, type PostTableActions, type PostTableChangeParams, ProfileCard, type ProfileCardProps, ProfileDropdown, type ProfileDropdownItem, type ProfileDropdownProps, ProfileView, type ProfileViewInfoItem, type ProfileViewProps, ProtectedRoute, type PutFunction, type Role, SearchApi, SearchApiContent, SearchApiInput, SearchApiItem, type SearchApiProps, SearchApiTrigger, Select, SelectContent, SelectItem, type SelectProps, SelectTrigger, SimpleTable, type SimpleTableColumn, type StorageManager, type StoreConfig, Textarea, type TextareaProps, type ThemeConfig, ThemeProvider, ThemeToggle, ThemedLogin, UnProtectedRoute, type UseModalReturn, Views, type WarqadConfig, type WarqadConfigContextType, WarqadProvider, generatePdf, storage, useA4CategoryView, useA4StatementView, useAntdImageUpload, useApi, useAuth, useAuthStore, useLogin, useModal, useSearchApiContext, useSelectContext, useTheme, useTransaction, useWarqadConfig };

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { ColumnDef, SortingState, ColumnFiltersState, RowData } from '@tanstack/
 import * as z from 'zod';
 import * as react_to_print from 'react-to-print';
 import { UploadFile } from 'antd';
+import * as zustand from 'zustand';
 
 interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "danger" | "warning";
@@ -528,6 +529,34 @@ interface BrandingProps {
 }
 declare const Branding: React__default.FC<BrandingProps>;
 
+interface ProfileCardProps {
+    name: string;
+    role?: string;
+    image?: string;
+    details: Record<string, string | number | undefined | null>;
+    backUrl?: string;
+    className?: string;
+}
+declare const ProfileCard: React__default.FC<ProfileCardProps>;
+
+interface ProfileViewInfoItem {
+    label: string;
+    value: string | number | undefined | null;
+    copiable?: boolean;
+}
+interface ProfileViewProps {
+    name: string;
+    role?: string;
+    email?: string;
+    imgUrl?: string;
+    userId?: string;
+    info?: ProfileViewInfoItem[];
+    className?: string;
+    title?: string;
+    description?: string;
+}
+declare const ProfileView: React__default.FC<ProfileViewProps>;
+
 type LoginTheme = "tech" | "travel" | "healthcare";
 interface BaseLoginProps {
     form: UseFormReturn<LoginSchema>;
@@ -540,6 +569,7 @@ interface BaseLoginProps {
     footer?: React__default.ReactNode;
     brandName?: string;
     backUrl?: string;
+    isLoading?: boolean;
 }
 declare const ThemedLogin: React__default.FC<BaseLoginProps>;
 
@@ -564,6 +594,7 @@ interface UseLoginProps {
     title?: string;
     subtitle?: string;
     backUrl?: string;
+    isLoading?: boolean;
 }
 declare const useLogin: (props: UseLoginProps) => {
     form: UseFormReturn<{
@@ -576,6 +607,24 @@ declare const useLogin: (props: UseLoginProps) => {
     Login: React__default.FC<{}>;
 };
 
+interface ProfileDropdownItem {
+    label: string;
+    icon?: React__default.ReactNode;
+    onClick?: () => void | Promise<void>;
+    disabled?: boolean;
+    className?: string;
+}
+interface ProfileDropdownProps {
+    name: string;
+    image?: string;
+    items: ProfileDropdownItem[];
+    className?: string;
+    triggerMode?: "click" | "hover";
+    size?: "sm" | "md" | "lg";
+    role?: string;
+}
+declare const ProfileDropdown: React__default.FC<ProfileDropdownProps>;
+
 interface FetchProps {
     url: string;
     body?: Record<string, any>;
@@ -688,7 +737,7 @@ declare const useTransaction: ({ url, v, delay, params, dateFilter, }: {
     params?: Record<string, any>;
     dateFilter?: boolean;
 }) => {
-    TransactionViewComponent: ({ columns, data, error, pageRows, searchPlaceholder, selectable, filterables, verticalLines, index, rowPadding, className, title, description, onCreate, createTitle, ...rest }: {
+    TransactionViewComponent: ({ columns, data, error, pageRows, searchPlaceholder, selectable, filterables, verticalLines, index, rowPadding, className, title, description, showReload, onCreate, createTitle, ...rest }: {
         columns: DataTableColumn[];
         data: any[];
         error?: any;
@@ -702,6 +751,7 @@ declare const useTransaction: ({ url, v, delay, params, dateFilter, }: {
         className?: string;
         title?: string;
         description?: string;
+        showReload?: boolean;
         onCreate?: () => void;
         createTitle?: string;
     }) => react_jsx_runtime.JSX.Element;
@@ -823,4 +873,154 @@ declare const Views: {
     }>;
 };
 
-export { Badge, type BadgeProps, Branding, type BrandingProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryCard, type CategoryItem, ClassicSpin, CodeBlock, DashboardLayout, DataTable, type DataTableColumn, DateInput, type DateInputProps, type DeleteFunction, type FetchFunction, type FetchProps, Fields, InfoGrid, Input, type InputProps, LoadingBox, LoadingSpin, type LoginSchema, type LoginTheme, Modal, type ModalProps, type NavItem, type NavItems, type Option, OverlaySpin, PageA4, PageHeader, type PdfOptions, PhoneInput, type PhoneInputProps, type PostFunction, PostTable, type PostTableActions, type PostTableChangeParams, type PutFunction, SearchApi, SearchApiContent, SearchApiInput, SearchApiItem, type SearchApiProps, SearchApiTrigger, Select, SelectContent, SelectItem, type SelectProps, SelectTrigger, SimpleTable, type SimpleTableColumn, type StorageManager, type StoreConfig, Textarea, type TextareaProps, type ThemeConfig, ThemeProvider, ThemeToggle, ThemedLogin, type UseModalReturn, Views, type WarqadConfig, type WarqadConfigContextType, WarqadProvider, generatePdf, storage, useA4CategoryView, useA4StatementView, useAntdImageUpload, useApi, useLogin, useModal, useSearchApiContext, useSelectContext, useTheme, useTransaction, useWarqadConfig };
+/**
+ * Guard component that fetches the current user profile on every route change.
+ * It ensures the auth state is synchronized with the server.
+ */
+declare const Guard: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures the user is logged in to access child routes.
+ */
+declare const ProtectedRoute: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures the user is NOT logged in to access child routes (e.g. Login/Signup pages).
+ */
+declare const UnProtectedRoute: () => react_jsx_runtime.JSX.Element;
+/**
+ * Ensures only users with 'admin' role can access child routes.
+ */
+declare const AdminProtectedRoute: () => react_jsx_runtime.JSX.Element;
+
+type Role = string;
+type AccountType = string;
+type AuthData = {
+    _id: string;
+    role: Role;
+    email: string;
+    phoneNumber: string;
+    isActive: boolean;
+    isEmailVerified: boolean;
+    isPhoneVerified: boolean;
+    permissions?: Record<string, boolean>;
+    homePath?: string;
+};
+type AccountData = {
+    _id: string;
+    name: string;
+    email: string;
+    phoneNumber: string;
+    type: AccountType;
+};
+type AuthState = {
+    auth: AuthData | null;
+    account: AccountData | null;
+    isLoggedIn: boolean;
+    isFetched: boolean;
+    setAuth: (auth: AuthData, account: AccountData) => void;
+    setIsLoggedIn: (isLoggedIn: boolean) => void;
+    setIsFetched: (isFetched: boolean) => void;
+    logout: () => void;
+    updateAuth: (data: Partial<AuthData>) => void;
+    updateAccount: (data: Partial<AccountData>) => void;
+    hasPermission: (key: string) => boolean;
+};
+declare const useAuthStore: zustand.UseBoundStore<zustand.StoreApi<AuthState>>;
+
+declare const useAuth: () => {
+    auth: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    } | null;
+    user: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    } | null;
+    account: {
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    } | null;
+    isLoggedIn: boolean;
+    isFetched: boolean;
+    role: string | undefined;
+    userId: string | undefined;
+    accountId: string | undefined;
+    userName: string | undefined;
+    userEmail: string | undefined;
+    permissions: Record<string, boolean>;
+    isAdmin: boolean;
+    isActive: boolean;
+    isVerified: boolean;
+    isEmailVerified: boolean;
+    isPhoneVerified: boolean;
+    logout: () => void;
+    setIsLoggedIn: (isLoggedIn: boolean) => void;
+    setIsFetched: (isFetched: boolean) => void;
+    setAuth: (auth: {
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }, account: {
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    }) => void;
+    login: (data: any) => void;
+    updateAuth: (data: Partial<{
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }>) => void;
+    updateUser: (data: Partial<{
+        _id: string;
+        role: Role;
+        email: string;
+        phoneNumber: string;
+        isActive: boolean;
+        isEmailVerified: boolean;
+        isPhoneVerified: boolean;
+        permissions?: Record<string, boolean>;
+        homePath?: string;
+    }>) => void;
+    updateAccount: (data: Partial<{
+        _id: string;
+        name: string;
+        email: string;
+        phoneNumber: string;
+        type: AccountType;
+    }>) => void;
+    hasPermission: (key: string) => boolean;
+    can: (key: string) => boolean;
+};
+
+export { type AccountType, AdminProtectedRoute, Badge, type BadgeProps, Branding, type BrandingProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryCard, type CategoryItem, ClassicSpin, CodeBlock, DashboardLayout, DataTable, type DataTableColumn, DateInput, type DateInputProps, type DeleteFunction, type FetchFunction, type FetchProps, Fields, Guard, InfoGrid, Input, type InputProps, LoadingBox, LoadingSpin, type LoginSchema, type LoginTheme, Modal, type ModalProps, type NavItem, type NavItems, type Option, OverlaySpin, PageA4, PageHeader, type PdfOptions, PhoneInput, type PhoneInputProps, type PostFunction, PostTable, type PostTableActions, type PostTableChangeParams, ProfileCard, type ProfileCardProps, ProfileDropdown, type ProfileDropdownItem, type ProfileDropdownProps, ProfileView, type ProfileViewInfoItem, type ProfileViewProps, ProtectedRoute, type PutFunction, type Role, SearchApi, SearchApiContent, SearchApiInput, SearchApiItem, type SearchApiProps, SearchApiTrigger, Select, SelectContent, SelectItem, type SelectProps, SelectTrigger, SimpleTable, type SimpleTableColumn, type StorageManager, type StoreConfig, Textarea, type TextareaProps, type ThemeConfig, ThemeProvider, ThemeToggle, ThemedLogin, UnProtectedRoute, type UseModalReturn, Views, type WarqadConfig, type WarqadConfigContextType, WarqadProvider, generatePdf, storage, useA4CategoryView, useA4StatementView, useAntdImageUpload, useApi, useAuth, useAuthStore, useLogin, useModal, useSearchApiContext, useSelectContext, useTheme, useTransaction, useWarqadConfig };