@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/blocks/auth-block/guards.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Route Guards
+ *
+ * Authentication and authorization guards for route protection.
+ * Works with any router (React Router, Next.js, TanStack Router).
+ *
+ * @module blocks/auth-block
+ */
+import { type ReactNode } from 'react';
+/**
+ * User role type - string or enum value.
+ */
+export type Role = string;
+/**
+ * Permission type - string identifier.
+ */
+export type Permission = string;
+/**
+ * User with roles and permissions for authorization.
+ */
+export 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.
+ */
+export 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.
+ */
+export interface UseAuth {
+    (): AuthState;
+}
+/**
+ * AuthGuard props.
+ */
+export 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function AuthGuard({ children, useAuth, loadingComponent, onUnauthenticated, unauthenticatedComponent, }: AuthGuardProps): ReactNode;
+/**
+ * GuestGuard props.
+ */
+export 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function GuestGuard({ children, useAuth, loadingComponent, onAuthenticated, authenticatedComponent, }: GuestGuardProps): ReactNode;
+/**
+ * RoleBasedGuard props.
+ */
+export 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.
+ */
+export 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>
+ *   );
+ * }
+ * ```
+ */
+export 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');
+ * ```
+ */
+export 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');
+ * ```
+ */
+export 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>
+ * );
+ * ```
+ */
+export declare function createConditionalRender(user: AuthUser | null | undefined): {
+    canRender: (options: {
+        roles?: Role[];
+        permissions?: Permission[];
+        roleMatchStrategy?: 'any' | 'all';
+    }) => boolean;
+};
+//# sourceMappingURL=guards.d.ts.map

package/dist/blocks/auth-block/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/blocks/auth-block/guards.tsx"],"names":[],"mappings":"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"}

package/dist/blocks/auth-block/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Auth Block
+ *
+ * Authentication-related form components: login, register, forgot password, etc.
+ * Also includes route guards for authentication and authorization.
+ *
+ * @module blocks/auth-block
+ */
+export { AuthBlock, LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, VerifyCodeForm, } from './auth-block.js';
+export type { LoginFormProps, LoginFormData, RegisterFormProps, RegisterFormData, ForgotPasswordFormProps, ForgotPasswordFormData, ResetPasswordFormProps, ResetPasswordFormData, VerifyCodeFormProps, VerifyCodeFormData, AuthBlockVariant, } from './types.js';
+export { AuthGuard, GuestGuard, RoleBasedGuard, hasRole, hasPermission, createConditionalRender } from './guards.js';
+export type { Role, Permission, AuthUser, AuthState, UseAuth, AuthGuardProps, GuestGuardProps, RoleBasedGuardProps, AccessDeniedReason, } from './guards.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/auth-block/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/auth-block/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAErH,YAAY,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/blocks/auth-block/types.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Auth Block Types
+ *
+ * Type definitions for authentication-related block components.
+ *
+ * @module blocks/auth-block
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+import type { BoxProps } from '@mui/material/Box';
+import type { ButtonProps } from '@mui/material/Button';
+import type { TextFieldProps } from '@mui/material/TextField';
+import type { z } from 'zod';
+/**
+ * Base props for all auth forms
+ */
+export 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<Theme>;
+    /** 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 field names
+ */
+export type LoginFormFields = 'email' | 'password';
+/**
+ * Login form data
+ */
+export interface LoginFormData {
+    email: string;
+    password: string;
+    rememberMe?: boolean;
+}
+/**
+ * Props for LoginForm component
+ */
+export 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
+ */
+export interface RegisterFormData {
+    email: string;
+    password: string;
+    confirmPassword: string;
+    firstName?: string;
+    lastName?: string;
+    acceptTerms?: boolean;
+}
+/**
+ * Props for RegisterForm component
+ */
+export 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
+ */
+export interface ForgotPasswordFormData {
+    email: string;
+}
+/**
+ * Props for ForgotPasswordForm component
+ */
+export 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
+ */
+export interface ResetPasswordFormData {
+    password: string;
+    confirmPassword: string;
+}
+/**
+ * Props for ResetPasswordForm component
+ */
+export 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
+ */
+export interface VerifyCodeFormData {
+    code: string;
+}
+/**
+ * Props for VerifyCodeForm component
+ */
+export 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
+ */
+export type AuthBlockVariant = 'login' | 'register' | 'forgot-password' | 'reset-password' | 'verify-code';
+/**
+ * Props for AuthBlock component (compound)
+ */
+export interface AuthBlockProps {
+    /** Block variant */
+    variant: AuthBlockVariant;
+    /** Header content (logo, title) */
+    header?: ReactNode;
+    /** Footer content (links, additional info) */
+    footer?: ReactNode;
+    /** Form props based on variant */
+    formProps: (LoginFormProps & {
+        variant: 'login';
+    }) | (RegisterFormProps & {
+        variant: 'register';
+    }) | (ForgotPasswordFormProps & {
+        variant: 'forgot-password';
+    }) | (ResetPasswordFormProps & {
+        variant: 'reset-password';
+    }) | (VerifyCodeFormProps & {
+        variant: 'verify-code';
+    });
+    /** Custom styling */
+    sx?: SxProps<Theme>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/blocks/auth-block/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/blocks/auth-block/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClE,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACV,oBAAoB;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5B,0BAA0B;QAC1B,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACpC,uBAAuB;QACvB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KACrC,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACzE,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,kCAAkC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC,CAAC;IACH,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACpC,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC5E,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,uBAAuB;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACvC,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAClF,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjE,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAC7C,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACjF,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChE,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAC5C,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC9E,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACzC,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE3G;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mCAAmC;IACnC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kCAAkC;IAClC,SAAS,EACL,CAAC,cAAc,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,GACvC,CAAC,iBAAiB,GAAG;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC,GAC7C,CAAC,uBAAuB,GAAG;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,CAAC,GAC1D,CAAC,sBAAsB,GAAG;QAAE,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC,GACxD,CAAC,mBAAmB,GAAG;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACvD,qBAAqB;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB"}

package/dist/blocks/dashboard-block/dashboard-block.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Dashboard Block Component
+ *
+ * Reusable dashboard widget/card block with header, content, and footer slots.
+ * Supports loading, error states, and collapsible behavior.
+ *
+ * @module blocks/dashboard-block
+ */
+import { type ReactNode } from 'react';
+import type { DashboardBlockProps, DashboardBlockContextValue, DashboardBlockHeaderProps, DashboardBlockContentProps, DashboardBlockFooterProps } from './types.js';
+/**
+ * Hook to access dashboard block context.
+ */
+export declare function useDashboardBlockContext(): DashboardBlockContextValue;
+/**
+ * Dashboard block header component.
+ */
+export declare function DashboardBlockHeader({ title, subtitle, icon, actions, sx }: DashboardBlockHeaderProps): ReactNode;
+/**
+ * Dashboard block content component.
+ */
+export declare function DashboardBlockContent({ children, disablePadding, sx }: DashboardBlockContentProps): ReactNode;
+/**
+ * Dashboard block footer component.
+ */
+export 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>
+ * ```
+ */
+export declare function DashboardBlock({ title, subtitle, icon, actions, children, footer, variant, size, loading, loadingConfig, error, errorConfig, empty, emptyConfig, labels, catchErrors, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapseChange, disablePadding, footerDivider, sx, slotProps, }: DashboardBlockProps): ReactNode;
+//# sourceMappingURL=dashboard-block.d.ts.map

package/dist/blocks/dashboard-block/dashboard-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-block.d.ts","sourceRoot":"","sources":["../../../src/blocks/dashboard-block/dashboard-block.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,SAAS,EAAmD,MAAM,OAAO,CAAC;AAYxF,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,0BAA0B,CAMrE;AAqCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,yBAAyB,GAAG,SAAS,CAmFjH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,cAAsB,EAAE,EAAE,EAAE,EAAE,0BAA0B,GAAG,SAAS,CAsBrH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,OAAc,EAAE,EAAE,EAAE,EAAE,yBAAyB,GAAG,SAAS,CAuB3G;AAmFD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,MAAM,EACN,OAAmB,EACnB,IAAe,EACf,OAAe,EACf,aAAa,EACb,KAAa,EACb,WAAW,EACX,KAAa,EACb,WAAW,EACX,MAAkB,EAClB,WAAkB,EAClB,WAAmB,EACnB,gBAAwB,EACxB,SAAS,EAAE,mBAAmB,EAC9B,gBAAgB,EAChB,cAAsB,EACtB,aAAoB,EACpB,EAAE,EACF,SAAS,GACV,EAAE,mBAAmB,GAAG,SAAS,CA4HjC"}

package/dist/blocks/dashboard-block/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dashboard Block
+ *
+ * Reusable dashboard widget/card block with header, content, and footer slots.
+ *
+ * @module blocks/dashboard-block
+ */
+export { DashboardBlock, DashboardBlockHeader, DashboardBlockContent, DashboardBlockFooter, useDashboardBlockContext, } from './dashboard-block.js';
+export { useDashboardBlock } from './use-dashboard-block.js';
+export type { UseDashboardBlockReturn, UseDashboardBlockOptions, DashboardBlockState, DashboardBlockActions, } from './use-dashboard-block.js';
+export type { DashboardBlockProps, DashboardBlockVariant, DashboardBlockSize, DashboardBlockHeaderProps, DashboardBlockContentProps, DashboardBlockFooterProps, DashboardBlockContextValue, LoadingConfig, ErrorConfig, EmptyConfig, DashboardBlockLabels, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/dashboard-block/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/dashboard-block/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,aAAa,EACb,WAAW,EACX,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC"}