primus-react-ui 1.0.9

package/dist/index.d.ts

@@ -0,0 +1,485 @@
+import React$1, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const AccountDashboard: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const KYCVerification: React$1.FC<{
+    userId: string;
+    apiUrl?: string;
+}>;
+
+declare const LoanCalculator: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const CreditScoreCard: React$1.FC<{
+    userId: string;
+    apiUrl?: string;
+}>;
+
+declare const QuoteComparison: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const AgentDirectory: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const FraudDetectionDashboard: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const PremiumCalculator: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const AICopilot: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const FileUploader: React$1.FC<{
+    apiUrl?: string;
+    onUploadComplete?: (file: any) => void;
+}>;
+
+declare const SecurityDashboard: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+type SocialProvider = 'google' | 'azure' | 'github' | 'apple' | 'microsoft' | 'facebook';
+interface PrimusLoginProps {
+    /** Callback when login is successful */
+    onLogin?: (credentials: {
+        username: string;
+        password: string;
+    }) => void;
+    /**
+     * Social login providers to display
+     * @example socialProviders={['google', 'azure']}
+     */
+    socialProviders?: SocialProvider[];
+    /** Callback when social provider is clicked */
+    onSocialLogin?: (provider: SocialProvider) => void;
+    /** OAuth endpoint base URL (default: /api/auth) */
+    authEndpoint?: string;
+    /** Show email/password form (default: true) */
+    showEmailLogin?: boolean;
+    /** App title displayed above form */
+    title?: string;
+    /** Subtitle/description text */
+    subtitle?: string;
+    /** Logo element or URL */
+    logo?: React.ReactNode | string;
+    /** Force specific theme */
+    theme?: 'light' | 'dark';
+}
+/**
+ * PrimusLogin - Complete Login Component
+ *
+ * A single component that handles all login methods. Enable features via props.
+ *
+ * @example
+ * ```tsx
+ * // Basic email/password only
+ * <PrimusLogin onLogin={(creds) => console.log(creds)} />
+ *
+ * // With social providers
+ * <PrimusLogin
+ *   socialProviders={['google', 'azure']}
+ *   onSocialLogin={(provider) => redirectToOAuth(provider)}
+ * />
+ *
+ * // Social only (no email form)
+ * <PrimusLogin
+ *   showEmailLogin={false}
+ *   socialProviders={['google', 'github', 'azure']}
+ * />
+ * ```
+ */
+declare function PrimusLogin({ onLogin, socialProviders, onSocialLogin, authEndpoint, showEmailLogin, title, subtitle, logo, theme: themeOverride, }: PrimusLoginProps): react_jsx_runtime.JSX.Element;
+declare const LoginPage: typeof PrimusLogin;
+
+declare const UserProfile: React$1.FC;
+
+interface PrimusUser {
+    id?: string;
+    name: string;
+    email: string;
+    roles?: string[];
+    claims?: Record<string, any>;
+}
+interface PrimusAuthContextType {
+    isAuthenticated: boolean;
+    user: PrimusUser | null;
+    login: (credentials: {
+        email: string;
+        password: string;
+    } | {
+        provider: 'auth0' | 'azure' | 'google' | 'github';
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    logout: () => Promise<void>;
+    token: string | null;
+    isLoading: boolean;
+}
+interface PrimusProviderProps {
+    children: React$1.ReactNode;
+    /** Base URL for authentication API (e.g., http://localhost:5221) */
+    authority: string;
+    clientId: string;
+    redirectUri?: string;
+    /** Called after successful login */
+    onLoginSuccess?: (user: PrimusUser, token: string) => void;
+    /** Called on login failure */
+    onLoginError?: (error: string) => void;
+}
+declare const PrimusProvider: React$1.FC<PrimusProviderProps>;
+declare const usePrimusAuth: () => PrimusAuthContextType;
+
+type PrimusTheme = 'light' | 'dark';
+interface ThemeColors {
+    bg: string;
+    bgSecondary: string;
+    bgTertiary: string;
+    bgHover: string;
+    border: string;
+    borderSecondary: string;
+    text: string;
+    textSecondary: string;
+    textMuted: string;
+    accent: string;
+    accentHover: string;
+    accentText: string;
+    badge: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+}
+declare const themeColors: Record<PrimusTheme, ThemeColors>;
+interface PrimusThemeContextValue {
+    theme: PrimusTheme;
+    colors: ThemeColors;
+    setTheme: (theme: PrimusTheme) => void;
+    toggleTheme: () => void;
+}
+interface PrimusThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: PrimusTheme;
+}
+/**
+ * PrimusThemeProvider - Global Theme Context for Primus UI Components
+ *
+ * Wrap your app with this provider to enable consistent theming across all Primus components.
+ *
+ * @example
+ * ```tsx
+ * <PrimusThemeProvider defaultTheme="dark">
+ *   <App />
+ * </PrimusThemeProvider>
+ * ```
+ */
+declare function PrimusThemeProvider({ children, defaultTheme }: PrimusThemeProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * usePrimusTheme - Hook to access the current Primus theme
+ *
+ * @example
+ * ```tsx
+ * const { theme, colors, toggleTheme } = usePrimusTheme();
+ * ```
+ */
+declare function usePrimusTheme(): PrimusThemeContextValue;
+/**
+ * PrimusThemeToggle - A button to toggle between light and dark themes
+ */
+declare function PrimusThemeToggle(): react_jsx_runtime.JSX.Element;
+
+declare const NotificationFeed: React$1.FC;
+
+interface PrimusNotificationCenterProps {
+    /** Override the theme from context (optional) */
+    theme?: PrimusTheme;
+    /** Custom API URL (optional) */
+    apiUrl?: string;
+}
+/**
+ * PrimusNotificationCenter - Enterprise Notification Component
+ *
+ * Features:
+ * - Automatic theme inheritance from PrimusThemeProvider
+ * - Bell icon with animated badge
+ * - Admin panel for sending notifications
+ * - Real-time polling (3 second intervals)
+ * - Type-specific icons and colors
+ *
+ * @example
+ * ```tsx
+ * // With theme provider (recommended)
+ * <PrimusThemeProvider defaultTheme="dark">
+ *   <PrimusNotificationCenter />
+ * </PrimusThemeProvider>
+ *
+ * // With manual override
+ * <PrimusNotificationCenter theme="light" />
+ * ```
+ */
+declare function PrimusNotificationCenter({ theme: themeOverride, apiUrl }: PrimusNotificationCenterProps): react_jsx_runtime.JSX.Element;
+declare const NotificationBell: typeof PrimusNotificationCenter;
+declare const PrimusNotifications: typeof PrimusNotificationCenter;
+
+interface Notification {
+    id: string;
+    title: string;
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+    timestamp: string;
+    read: boolean;
+}
+declare const useNotifications: (apiUrl?: string) => {
+    notifications: Notification[];
+    unreadCount: number;
+    loading: boolean;
+    markAsRead: (id: string) => void;
+    markAllAsRead: () => void;
+    refresh: () => Promise<void>;
+};
+
+interface PrimusNotification {
+    id: string;
+    title: string;
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+    timestamp: string;
+    read: boolean;
+}
+interface UseRealtimeNotificationsOptions {
+    apiUrl: string;
+    pollInterval?: number;
+    userId?: string;
+}
+/**
+ * Hook for managing real-time notifications from Primus Backend.
+ * Supports both polling and SignalR (when available).
+ */
+declare const useRealtimeNotifications: (options: UseRealtimeNotificationsOptions) => {
+    notifications: PrimusNotification[];
+    unreadCount: number;
+    loading: boolean;
+    error: string | null;
+    sendNotification: (title: string, message: string, type?: "info" | "success" | "warning" | "error") => Promise<boolean>;
+    markAsRead: (id: string) => Promise<void>;
+    markAllAsRead: () => Promise<void>;
+    deleteNotification: (id: string) => Promise<void>;
+    refresh: () => Promise<void>;
+};
+
+interface CheckoutFormProps {
+    amount: number;
+    currency?: string;
+    apiUrl?: string;
+    onSuccess?: (result: any) => void;
+    onError?: (error: string) => void;
+}
+declare const CheckoutForm: React$1.FC<CheckoutFormProps>;
+
+interface Document {
+    id: string;
+    name: string;
+    type: 'pdf' | 'image' | 'text';
+    url: string;
+    size?: string;
+    date?: string;
+}
+interface DocumentViewerProps {
+    document: Document;
+    onClose?: () => void;
+    onDownload?: () => void;
+}
+declare const DocumentViewer: React$1.FC<DocumentViewerProps>;
+
+interface CreditCardProps {
+    cardHolder: string;
+    last4: string;
+    expiry: string;
+    brand?: 'visa' | 'mastercard' | 'amex';
+    variant?: 'black' | 'blue' | 'gold' | 'platinum';
+}
+declare const CreditCardVisual: React$1.FC<CreditCardProps>;
+
+interface Transaction {
+    id: string;
+    description: string;
+    amount: number;
+    date: string;
+    type: 'credit' | 'debit';
+    category?: 'shopping' | 'transfer' | 'food' | 'other';
+    status?: 'pending' | 'completed' | 'failed';
+}
+interface TransactionHistoryProps {
+    transactions: Transaction[];
+    onTransactionClick?: (id: string) => void;
+}
+declare const TransactionHistory: React$1.FC<TransactionHistoryProps>;
+
+interface PolicyProps {
+    policyNumber: string;
+    type: string;
+    status: 'active' | 'expired' | 'pending';
+    coverageAmount: number;
+    nextPaymentDate: string;
+    premiumAmount: number;
+}
+declare const PolicyCard: React$1.FC<PolicyProps>;
+
+interface ClaimStep {
+    id: string;
+    label: string;
+    status: 'completed' | 'current' | 'upcoming';
+    date?: string;
+}
+interface ClaimStatusTrackerProps {
+    claimId: string;
+    steps: ClaimStep[];
+}
+declare const ClaimStatusTracker: React$1.FC<ClaimStatusTrackerProps>;
+
+interface FeatureFlag {
+    name: string;
+    enabled: boolean;
+    description: string;
+    rolloutPercentage?: number;
+}
+declare const FeatureFlagToggle: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+declare const LogViewer: React$1.FC<{
+    apiUrl?: string;
+}>;
+
+interface PrimusLayoutProps {
+    children: React$1.ReactNode;
+    sidebar?: React$1.ReactNode;
+    header?: React$1.ReactNode;
+    /** Dark mode */
+    darkMode?: boolean;
+}
+declare const PrimusLayout: React$1.FC<PrimusLayoutProps>;
+
+interface SidebarItem {
+    id: string;
+    label: string;
+    icon?: React$1.ReactNode;
+    href?: string;
+    onClick?: () => void;
+    active?: boolean;
+    badge?: string | number;
+}
+interface PrimusSidebarProps {
+    /** App logo or title */
+    logo?: React$1.ReactNode;
+    /** Navigation items */
+    items: SidebarItem[];
+    /** Footer content */
+    footer?: React$1.ReactNode;
+    /** Callback when item clicked */
+    onItemClick?: (item: SidebarItem) => void;
+    /** Currently active item id */
+    activeId?: string;
+}
+declare const PrimusSidebar: React$1.FC<PrimusSidebarProps>;
+
+interface PrimusHeaderProps {
+    /** Page title */
+    title?: string;
+    /** Breadcrumb items */
+    breadcrumbs?: {
+        label: string;
+        href?: string;
+    }[];
+    /** Right side actions */
+    actions?: React$1.ReactNode;
+    /** User info/avatar */
+    user?: {
+        name: string;
+        email?: string;
+        avatar?: string;
+    };
+    /** On user click */
+    onUserClick?: () => void;
+}
+declare const PrimusHeader: React$1.FC<PrimusHeaderProps>;
+
+interface Column<T> {
+    key: keyof T | string;
+    header: string;
+    render?: (value: any, row: T) => React$1.ReactNode;
+    sortable?: boolean;
+    width?: string;
+}
+interface PrimusDataTableProps<T> {
+    data: T[];
+    columns: Column<T>[];
+    /** Row key field */
+    rowKey: keyof T;
+    /** Loading state */
+    loading?: boolean;
+    /** Enable row selection */
+    selectable?: boolean;
+    /** Selected row keys */
+    selectedKeys?: (string | number)[];
+    /** On selection change */
+    onSelectionChange?: (keys: (string | number)[]) => void;
+    /** On row click */
+    onRowClick?: (row: T) => void;
+    /** Actions column renderer */
+    actions?: (row: T) => React$1.ReactNode;
+    /** Empty state message */
+    emptyMessage?: string;
+    /** Search placeholder */
+    searchPlaceholder?: string;
+    /** Enable search */
+    searchable?: boolean;
+}
+declare function PrimusDataTable<T extends Record<string, any>>({ data, columns, rowKey, loading, selectable, selectedKeys, onSelectionChange, onRowClick, actions, emptyMessage, searchPlaceholder, searchable, }: PrimusDataTableProps<T>): react_jsx_runtime.JSX.Element;
+
+interface PrimusModalProps {
+    open: boolean;
+    onClose: () => void;
+    title?: string;
+    children: React$1.ReactNode;
+    footer?: React$1.ReactNode;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+}
+declare const PrimusModal: React$1.FC<PrimusModalProps>;
+
+interface StatCardProps {
+    title: string;
+    value: string | number;
+    change?: {
+        value: number;
+        type: 'increase' | 'decrease' | 'neutral';
+    };
+    icon?: React$1.ReactNode;
+    description?: string;
+    trend?: number[];
+}
+declare const PrimusStatCard: React$1.FC<StatCardProps>;
+interface PrimusDashboardProps {
+    children: React$1.ReactNode;
+    title?: string;
+    subtitle?: string;
+    actions?: React$1.ReactNode;
+}
+declare const PrimusDashboard: React$1.FC<PrimusDashboardProps>;
+interface DashboardGridProps {
+    children: React$1.ReactNode;
+    columns?: 1 | 2 | 3 | 4;
+}
+declare const DashboardGrid: React$1.FC<DashboardGridProps>;
+
+export { AICopilot, AccountDashboard, AgentDirectory, CheckoutForm, type CheckoutFormProps, ClaimStatusTracker, type ClaimStatusTrackerProps, type ClaimStep, type Column, type CreditCardProps, CreditCardVisual, CreditScoreCard, DashboardGrid, type DashboardGridProps, type Document, DocumentViewer, type DocumentViewerProps, type FeatureFlag, FeatureFlagToggle, FileUploader, FraudDetectionDashboard, KYCVerification, LoanCalculator, LogViewer, LoginPage, type Notification, NotificationBell, NotificationFeed, PolicyCard, type PolicyProps, PremiumCalculator, PrimusDashboard, type PrimusDashboardProps, PrimusDataTable, type PrimusDataTableProps, PrimusHeader, type PrimusHeaderProps, PrimusLayout, type PrimusLayoutProps, PrimusLogin, type PrimusLoginProps, PrimusModal, type PrimusModalProps, type PrimusNotification, PrimusNotificationCenter, PrimusNotifications, PrimusProvider, type PrimusProviderProps, PrimusSidebar, type PrimusSidebarProps, PrimusStatCard, type PrimusTheme, PrimusThemeProvider, PrimusThemeToggle, QuoteComparison, SecurityDashboard, type SidebarItem, type SocialProvider, type StatCardProps, type Transaction, TransactionHistory, type TransactionHistoryProps, type UseRealtimeNotificationsOptions, UserProfile, themeColors, useNotifications, usePrimusAuth, usePrimusTheme, useRealtimeNotifications };