@jmruthers/pace-core 0.5.181 → 0.5.183

package/dist/{EventLogo-B3V3otev.d.ts → index-Bl--n7-T.d.ts}

@@ -1,5 +1,6 @@
+import './UnifiedAuthProvider-F86d7dSi.js';
 import * as React from 'react';
-import React__default, { Component, ReactNode, ErrorInfo } from 'react';
+import React__default, { Component, ReactNode } from 'react';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
@@ -10,13 +11,16 @@ import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
 import { DayPickerProps } from 'react-day-picker';
 import * as ToastPrimitives from '@radix-ui/react-toast';
+import './useToast-C8gR5ir4.js';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
-import { FieldValues, DefaultValues, SubmitHandler, SubmitErrorHandler, UseFormReturn } from 'react-hook-form';
+import './DataTable-Bz8ffqyA.js';
+import './types-_x1f4QBF.js';
+import { FieldValues, DefaultValues, SubmitHandler, SubmitErrorHandler, UseFormReturn, FieldPath, ControllerRenderProps, ControllerFieldState, UseFormStateReturn } from 'react-hook-form';
 import { z } from 'zod';
 import { User, SupabaseClient, createClient } from '@supabase/supabase-js';
-import { E as Event } from './unified-DQ4VcT7H.js';
-import { O as Organisation } from './organisation-D6qRDtbF.js';
-import { F as FileCategory, e as FileUploadResult, U as UploadProgress, c as FileUploadOptions, a as FileReference } from './file-reference-C6Gkn77H.js';
+import { P as Permission, A as AccessLevel } from './types-UU913iLA.js';
+import { E as Event, O as Organisation } from './event-CW5YB_2p.js';
+import { b as FileCategory, e as FileUploadResult, U as UploadProgress, c as FileUploadOptions, F as FileReference } from './file-reference-D06mEEWW.js';
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /** Visual variant of the button */
@@ -115,6 +119,10 @@ interface CardProps extends React.HTMLAttributes<HTMLElement> {
     variant?: 'default' | 'outline' | 'ghost';
     /** Size of the card */
     size?: 'default' | 'sm' | 'lg';
+    /** Whether the card should appear as a clickable link with hover effects */
+    isLink?: boolean;
+    /** Path or URL to navigate to when the card is clicked */
+    link?: string;
 }
 declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLElement>>;
 declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
@@ -122,7 +130,7 @@ declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HT
 declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
 declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
 declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
-declare const CardActions: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const CardActions: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
 type CardActionsProps = React.HTMLAttributes<HTMLElement>;
 
 /**
@@ -289,7 +297,6 @@ declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttri
  *
  * @dependencies
  * - @radix-ui/react-label - Core label functionality
- * - class-variance-authority - Variant styling
  * - React 18+ - Hooks and refs
  * - Tailwind CSS - Styling
  */
@@ -466,7 +473,7 @@ declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.Re
 declare const Alert: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
     variant?: "default" | "destructive" | "inline";
 } & React.RefAttributes<HTMLDivElement>>;
-declare const AlertTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const AlertTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLHeadingElement>>;
 declare const AlertDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
 
 /**
@@ -1015,15 +1022,17 @@ declare const DialogTitle: React.ForwardRefExoticComponent<DialogTitleProps & Re
 declare const DialogDescription: React.ForwardRefExoticComponent<DialogDescriptionProps & React.RefAttributes<HTMLHeadingElement>>;
 
 /**
- * @file Select Hooks - Custom hooks for Select component state management
+ * @file Select Component - Refactored SOLID Implementation
  * @package @jmruthers/pace-core
- * @module Components/Select/Hooks
+ * @module Components/Select
  * @since 0.4.0
  *
- * Custom hooks for Select component following SOLID principles:
- * - Single Responsibility: Each hook handles one concern
+ * Refactored Select component following SOLID principles:
+ * - Single Responsibility: Each component has one clear purpose
  * - Open/Closed: Easy to extend without modification
- * - Dependency Inversion: Abstractions over concrete implementations
+ * - Liskov Substitution: Components can be substituted
+ * - Interface Segregation: Small, focused interfaces
+ * - Dependency Inversion: Depends on abstractions, not concretions
  */
 
 interface UseSelectStateProps {
@@ -1036,21 +1045,6 @@ interface UseSelectStateProps {
     onValueChange?: (value: string) => void;
     onOpenChange?: (open: boolean) => void;
 }
-
-/**
- * @file Select Component - Refactored SOLID Implementation
- * @package @jmruthers/pace-core
- * @module Components/Select
- * @since 0.4.0
- *
- * Refactored Select component following SOLID principles:
- * - Single Responsibility: Each component has one clear purpose
- * - Open/Closed: Easy to extend without modification
- * - Liskov Substitution: Components can be substituted
- * - Interface Segregation: Small, focused interfaces
- * - Dependency Inversion: Depends on abstractions, not concretions
- */
-
 interface SelectProps extends Omit<React.HTMLAttributes<HTMLFormElement>, 'onChange' | 'onKeyDown' | 'onFocus' | 'onBlur'> {
     children: React.ReactNode;
     className?: string;
@@ -1184,12 +1178,14 @@ interface TabsListProps extends React.ComponentPropsWithoutRef<typeof TabsPrimit
  * ```
  */
 declare const TabsList: React.ForwardRefExoticComponent<TabsListProps & React.RefAttributes<HTMLDivElement>>;
-interface TabsTriggerProps extends React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> {
+interface TabsTriggerProps extends Omit<React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>, 'asChild'>, Pick<ButtonProps, 'variant' | 'size'> {
 }
 /**
  * TabsTrigger component
  * Individual tab button that activates a tab panel
  *
+ * Uses Button component internally, allowing Button props (variant, size) to be passed through.
+ *
  * @component
  * @example
  * ```tsx
@@ -1199,6 +1195,11 @@ interface TabsTriggerProps extends React.ComponentPropsWithoutRef<typeof TabsPri
  * <TabsTrigger value="transport">
  *   <Plane size={16} /> Transport
  * </TabsTrigger>
+ *
+ * // With Button variant
+ * <TabsTrigger value="tab1" variant="outline" size="sm">
+ *   Tab 1
+ * </TabsTrigger>
  * ```
  */
 declare const TabsTrigger: React.ForwardRefExoticComponent<TabsTriggerProps & React.RefAttributes<HTMLButtonElement>>;
@@ -1599,6 +1600,133 @@ interface FormProps<TFieldValues extends FieldValues = FieldValues> {
  * ```
  */
 declare function Form<TFieldValues extends FieldValues = FieldValues>({ schema, defaultValues, onSubmit, onError, mode, children, className, }: FormProps<TFieldValues>): react_jsx_runtime.JSX.Element;
+/**
+ * Props for the FormField component
+ */
+interface FormFieldProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> {
+    /**
+     * Field name
+     */
+    name: TName;
+    /**
+     * Field label
+     */
+    label?: string;
+    /**
+     * Field type
+     */
+    type?: string;
+    /**
+     * Placeholder text
+     */
+    placeholder?: string;
+    /**
+     * Additional props for the input
+     */
+    inputProps?: React__default.InputHTMLAttributes<HTMLInputElement>;
+    /**
+     * Validation rules
+     */
+    validation?: {
+        required?: boolean;
+        pattern?: {
+            value: RegExp;
+            message: string;
+        };
+        minLength?: {
+            value: number;
+            message: string;
+        };
+        maxLength?: {
+            value: number;
+            message: string;
+        };
+    };
+    /**
+     * Custom render function
+     */
+    render?: (props: {
+        field: ControllerRenderProps<TFieldValues, TName>;
+        fieldState: ControllerFieldState;
+        formState: UseFormStateReturn<TFieldValues>;
+    }) => React__default.ReactElement;
+    /**
+     * Test ID
+     */
+    'data-testid'?: string;
+    /**
+     * Class name
+     */
+    className?: string;
+}
+/**
+ * FormField component for React Hook Form integration
+ *
+ * A flexible form field component that integrates with React Hook Form and provides
+ * built-in validation, error handling, and accessibility features.
+ *
+ * Features:
+ * - React Hook Form integration with Controller
+ * - Built-in validation with error display
+ * - Accessible labels and error messages
+ * - Custom render function support
+ * - TypeScript support with generic field paths
+ * - Consistent styling with error states
+ * - Test ID support for testing
+ * - Flexible input types and props
+ *
+ * @template TFieldValues - The type of form field values
+ * @template TName - The type of the field name (must be a valid field path)
+ * @param props - Form field configuration and validation
+ * @returns JSX.Element - The rendered form field with validation
+ *
+ * @example
+ * ```tsx
+ * // Basic text field
+ * <FormField
+ *   name="username"
+ *   label="Username"
+ *   placeholder="Enter your username"
+ *   validation={{ required: true }}
+ * />
+ *
+ * // Email field with custom validation
+ * <FormField
+ *   name="email"
+ *   label="Email Address"
+ *   type="email"
+ *   validation={{
+ *     required: true,
+ *     pattern: {
+ *       value: /^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$/i,
+ *       message: "Invalid email address"
+ *     }
+ *   }}
+ * />
+ *
+ * // Custom render function
+ * <FormField
+ *   name="avatar"
+ *   label="Profile Picture"
+ *   render={({ field }) => (
+ *     <input
+ *       {...field}
+ *       type="file"
+ *       accept="image/*"
+ *     />
+ *   )}
+ * />
+ * ```
+ *
+ * @accessibility
+ * - Proper label association with htmlFor
+ * - Error messages with role="alert"
+ * - Required field indicators
+ * - Focus management
+ * - Screen reader friendly error announcements
+ * - Keyboard navigation support
+ */
+declare function FormField<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ name, label, type, placeholder, inputProps, validation, render, 'data-testid': testId, className, }: FormFieldProps<TFieldValues, TName>): react_jsx_runtime.JSX.Element;
 
 /**
  * @file LoginForm Component
@@ -1745,85 +1873,6 @@ interface LoginFormProps {
  */
 declare const LoginForm: React__default.NamedExoticComponent<LoginFormProps>;
 
-/**
- * @file NavigationMenu Types
- * @package @jmruthers/pace-core
- * @module NavigationMenu
- * @since 0.1.0
- */
-/**
- * Navigation item configuration
- * Supports both flat and hierarchical navigation structures
- */
-interface NavigationItem {
-    /** Unique identifier for the navigation item */
-    id: string;
-    /** Display text for the navigation item */
-    label: string;
-    /** URL or path to navigate to (optional for parent items in hierarchical mode) */
-    href?: string;
-    /** Optional Lucide icon name for the navigation item */
-    icon?: string;
-    /** Child navigation items for hierarchical mode */
-    children?: NavigationItem[];
-    /** Whether this item is currently active (auto-detected if not provided) */
-    isActive?: boolean;
-    /** Permissions required for this navigation item */
-    permissions?: string[];
-    /** Roles that can access this navigation item */
-    roles?: string[];
-    /** Minimum access level required */
-    accessLevel?: string;
-    /** Page ID for permission checking */
-    pageId?: string;
-    /** Enable strict mode for this navigation item */
-    strictMode?: boolean;
-    /** Navigation item metadata */
-    meta?: {
-        title?: string;
-        description?: string;
-        hidden?: boolean;
-        order?: number;
-    };
-}
-/**
- * Navigation mode configuration
- */
-type NavigationMode = 'dropdown' | 'hierarchical';
-/**
- * NavigationMenu component props
- */
-interface NavigationMenuProps {
-    /** Array of navigation items to display */
-    items: NavigationItem[];
-    /** Navigation mode: 'dropdown' for menu button style, 'hierarchical' for expandable tree */
-    mode?: NavigationMode;
-    /** Current page path for highlighting active item */
-    currentPath?: string;
-    /** Optional callback when navigation item is clicked */
-    onNavigate?: (item: NavigationItem) => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Whether the menu is disabled (dropdown mode only) */
-    disabled?: boolean;
-    /** Custom button text for dropdown mode (defaults to "Menu") */
-    buttonText?: string;
-    /** Whether to show icons in the navigation (dropdown mode only) */
-    showIcons?: boolean;
-    /** Custom navigation label for screen readers */
-    navigationLabel?: string;
-    /** Enable strict mode to prevent bypassing navigation protection (default: true) */
-    strictMode?: boolean;
-    /** Enable audit logging for all navigation access attempts (default: true) */
-    auditLog?: boolean;
-    /** Callback when navigation access is denied */
-    onNavigationAccessDenied?: (itemId: string, reason: string) => void;
-    /** Callback when strict mode violation occurs */
-    onStrictModeViolation?: (itemId: string, reason: string) => void;
-    /** Enable automatic filtering of navigation items based on permissions */
-    filterByPermissions?: boolean;
-}
-
 /**
  * @file Unified Navigation Menu Component
  * @package @jmruthers/pace-core
@@ -2017,6 +2066,56 @@ interface NavigationMenuProps {
  * - Tailwind CSS - Styling system
  */
 
+/**
+ * Navigation mode type
+ */
+type NavigationMode = 'dropdown' | 'hierarchical';
+/**
+ * Navigation item metadata
+ */
+interface NavigationItemMeta {
+    hidden?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Navigation item interface
+ */
+interface NavigationItem {
+    id: string;
+    label: string;
+    href?: string;
+    icon?: string;
+    children?: NavigationItem[];
+    permissions?: (Permission | string)[];
+    roles?: string[];
+    accessLevel?: AccessLevel | string;
+    meta?: NavigationItemMeta;
+    pageId?: string;
+}
+/**
+ * Navigation menu component props
+ */
+interface NavigationMenuProps extends React.HTMLAttributes<HTMLDivElement> {
+    items: NavigationItem[];
+    mode?: NavigationMode;
+    currentPath?: string;
+    onNavigate?: (item: NavigationItem) => void;
+    className?: string;
+    disabled?: boolean;
+    buttonText?: string;
+    showIcons?: boolean;
+    navigationLabel?: string;
+    strictMode?: boolean;
+    auditLog?: boolean;
+    onNavigationAccessDenied?: (item: NavigationItem) => void;
+    onStrictModeViolation?: (item: NavigationItem, reason: string) => void;
+    /**
+     * If true, indicates that items have already been filtered by the parent component (e.g., PaceAppLayout).
+     * When true, NavigationMenu will skip expensive permission checks and trust the provided items.
+     * This significantly improves performance when items are pre-filtered.
+     */
+    itemsPreFiltered?: boolean;
+}
 /**
  * Unified NavigationMenu component that supports both dropdown and hierarchical navigation modes.
  *
@@ -2159,7 +2258,7 @@ interface NavigationMenuProps {
  *       onNavigate={(item) => navigate(item.href)}
  *       buttonText="Navigation"
  *       navigationLabel="Main application navigation"
- *       filterByPermissions={true}
+ *       // Permission filtering is always enabled - no prop needed
  *       auditLog={true}
  *     />
  *   );
@@ -2210,6 +2309,120 @@ interface NavigationMenuProps {
  */
 declare const NavigationMenu: React.ForwardRefExoticComponent<NavigationMenuProps & React.RefAttributes<HTMLDivElement>>;
 
+/**
+ * @file Password Change Form Component
+ * @package @jmruthers/pace-core
+ * @module Components/PasswordChange
+ * @since 0.1.0
+ *
+ * A secure password change form component with validation, confirmation matching,
+ * and proper error handling for updating user passwords.
+ *
+ * Features:
+ * - Password strength validation (minimum 8 characters)
+ * - Password confirmation matching
+ * - Loading states with disabled form
+ * - Error handling and display
+ * - Accessibility compliant
+ * - Responsive design
+ * - Form validation
+ * - Secure password input
+ * - Success and error callbacks
+ *
+ * @example
+ * ```tsx
+ * // Basic password change form
+ * <PasswordChangeForm
+ *   onSubmit={async (values) => {
+ *     try {
+ *       await updatePassword(values.newPassword);
+ *       toast.success('Password updated successfully!');
+ *       return {};
+ *     } catch (error) {
+ *       return { error: { message: error.message } };
+ *     }
+ *   }}
+ * />
+ *
+ * // Password change form with custom styling
+ * <PasswordChangeForm
+ *   className="max-w-md mx-auto p-6 bg-main-50 rounded-lg shadow-md"
+ *   onSubmit={async (values) => {
+ *     const result = await authService.changePassword(values.newPassword);
+ *     if (result.success) {
+ *       navigate('/profile');
+ *       return {};
+ *     } else {
+ *       return { error: { message: result.error } };
+ *     }
+ *   }}
+ * />
+ *
+ * // Password change form in a modal
+ * <Modal isOpen={showPasswordChange} onClose={() => setShowPasswordChange(false)}>
+ *   <ModalContent>
+ *     <ModalHeader>
+ *       <ModalTitle>Change Password</ModalTitle>
+ *     </ModalHeader>
+ *     <ModalBody>
+ *       <PasswordChangeForm
+ *         onSubmit={async (values) => {
+ *           const result = await changePassword(values.newPassword);
+ *           if (result.success) {
+ *             setShowPasswordChange(false);
+ *             toast.success('Password changed successfully');
+ *             return {};
+ *           } else {
+ *             return { error: { message: result.error } };
+ *           }
+ *         }}
+ *       />
+ *     </ModalBody>
+ *   </ModalContent>
+ * </Modal>
+ * ```
+ *
+ * @accessibility
+ * - WCAG 2.1 AA compliant
+ * - Proper form labels and associations
+ * - Screen reader friendly error messages
+ * - Keyboard navigation support
+ * - Focus management
+ * - High contrast support
+ * - Clear error identification
+ * - Role="alert" for error announcements
+ * - Password field security
+ *
+ * @security
+ * - Password strength validation
+ * - Secure password input fields
+ * - Confirmation matching
+ * - No password logging
+ * - Proper error handling
+ *
+ * @dependencies
+ * - React 18+ - Hooks and state
+ * - Button component
+ * - Input component
+ * - Label component
+ * - Tailwind CSS - Styling
+ */
+interface PasswordChangeFormValues {
+    newPassword: string;
+    confirmPassword: string;
+}
+interface PasswordChangeFormError {
+    message?: string;
+    code?: string;
+}
+interface PasswordChangeFormProps {
+    onSubmit: (values: PasswordChangeFormValues) => Promise<{
+        error?: PasswordChangeFormError;
+    }>;
+    className?: string;
+}
+declare function PasswordChangeForm({ onSubmit, className }: PasswordChangeFormProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Props for the Header component
  */
@@ -2228,7 +2441,7 @@ interface HeaderProps {
     onSignOut?: () => Promise<void>;
     /** Password change handler for user menu */
     onChangePassword?: (newPassword: string, confirmPassword: string) => Promise<{
-        error: any;
+        error?: PasswordChangeFormError;
     }>;
     /** Additional actions to display (will be placed between event selector and user menu) */
     actions?: React__default.ReactNode;
@@ -2580,7 +2793,7 @@ interface UserMenuProps {
     user: User | null;
     onSignOut?: () => Promise<void>;
     onChangePassword?: (newPassword: string, confirmPassword: string) => Promise<{
-        error: any;
+        error?: PasswordChangeFormError;
     }>;
     className?: string;
     showAvatar?: boolean;
@@ -2615,8 +2828,6 @@ interface PaceAppLayoutProps {
     routePermissions?: Record<string, Operation>;
     /** Fallback component to show when user lacks permission */
     permissionFallback?: React__default.ReactNode;
-    /** Enable permission-based navigation filtering */
-    filterNavigationByPermissions?: boolean;
     /** Custom permission page ID mapping */
     pageIdMapping?: Record<string, string>;
     /** Enable strict mode to prevent bypassing permission checks (default: true) */
@@ -2745,8 +2956,7 @@ interface PaceAppLayoutProps {
  *           <PaceAppLayout
  *             appName="My Custom App"
  *             navItems={customNavItems}
- *             // Navigation filtering works independently - no need for enforcePermissions
- *             filterNavigationByPermissions={true}
+ *             // Permission filtering is always enabled - no prop needed
  *             routePermissions={{
  *               '/components': 'read',
  *               '/styles': 'read',
@@ -2805,7 +3015,7 @@ interface PaceAppLayoutProps {
  *
  * @since 0.1.0
  */
-declare function PaceAppLayout({ appName, navItems, showEventSelector, headerActions, customLogo, logoHref, customUserMenu, headerClassName, showUserMenu, enforcePermissions, defaultPermission, routePermissions, permissionFallback, filterNavigationByPermissions, pageIdMapping, strictMode, enforcePagePermissions, pagePermissionFallback, auditLog, onPageAccessDenied, onStrictModeViolation, roleBasedRouting, routeConfig, fallbackRoute, onRouteAccessDenied, onRouteStrictModeViolation }: PaceAppLayoutProps): react_jsx_runtime.JSX.Element;
+declare function PaceAppLayout({ appName, navItems, showEventSelector, headerActions, customLogo, logoHref, customUserMenu, headerClassName, showUserMenu, enforcePermissions, defaultPermission, routePermissions, permissionFallback, pageIdMapping, strictMode, enforcePagePermissions, pagePermissionFallback, auditLog, onPageAccessDenied, onStrictModeViolation, roleBasedRouting, routeConfig, fallbackRoute, onRouteAccessDenied, onRouteStrictModeViolation }: PaceAppLayoutProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file PACE Login Page Component
@@ -3166,11 +3376,40 @@ declare const LoadingSpinner: React__default.FC<LoadingSpinnerProps>;
  *
  * Displays a consistent loading state while the authentication service
  * restores the Supabase session from persistent storage.
+ *
+ * Features:
+ * - Full-screen loading state
+ * - Accessible with proper ARIA attributes
+ * - Screen reader friendly
+ * - Customizable message
+ * - Uses LoadingSpinner component
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <SessionRestorationLoader />
+ *
+ * // With custom message
+ * <SessionRestorationLoader message="Restoring your session..." />
+ * ```
+ *
+ * @accessibility
+ * - WCAG 2.1 AA compliant
+ * - Proper ARIA role="status"
+ * - Screen reader announcement
+ * - High contrast support
+ *
+ * @dependencies
+ * - React 18+ - Component framework
+ * - LoadingSpinner - Spinner component
+ * - Tailwind CSS - Styling
  */
 
 interface SessionRestorationLoaderProps {
     /** Customise the status message displayed under the spinner */
     message?: string;
+    /** Additional CSS classes for styling */
+    className?: string;
 }
 declare const SessionRestorationLoader: React__default.FC<SessionRestorationLoaderProps>;
 
@@ -3550,37 +3789,6 @@ interface PublicPageLayoutProps {
     /** Custom loading message */
     loadingMessage?: string;
 }
-/**
- * Layout component for public pages that don't require authentication
- *
- * This component provides a consistent structure for public event pages
- * with event-specific branding, error handling, and loading states.
- *
- * Automatically applies event colors from the event's event_colours field
- * when an event is provided, ensuring consistent theming across public pages.
- *
- * @param props - Layout configuration and content
- * @returns React element with complete public page layout
- */
-declare function PublicPageLayout({ eventCode, children, event, isLoading, error, refetch, showFooter, className, errorFallback: ErrorFallback, loadingFallback: LoadingFallback, customHeader, customFooter, showValidationErrors, loadingMessage }: PublicPageLayoutProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook for accessing public page context
- * Provides access to event data and layout state within public pages
- *
- * @deprecated This hook is no longer needed as PublicPageLayout no longer
- * automatically fetches event data. Use usePublicRouteParams and usePublicEvent
- * directly in your components instead.
- */
-declare function usePublicPageContext$1(): {
-    eventCode: null;
-    eventId: null;
-    event: null;
-    isLoading: boolean;
-    error: null;
-    refetch: () => Promise<void>;
-    isPublicPage: boolean;
-};
-
 interface PublicPageHeaderProps {
     /** The event data for this public page */
     event?: Event;
@@ -3601,29 +3809,42 @@ interface PublicPageHeaderProps {
     /** Custom event logo component */
     customEventLogo?: ReactNode;
 }
+declare function PublicPageHeader({ event, eventCode, title, description, showEventLogo, showAppLogo, className, children, customEventLogo }: PublicPageHeaderProps): react_jsx_runtime.JSX.Element;
+interface PublicPageFooterProps {
+    /** The event data for this public page */
+    event: Event;
+    /** Company or organization name */
+    companyName?: string;
+    /** Current year or custom year for copyright */
+    year?: number;
+    /** Optional array of navigation links to display */
+    links?: Array<{
+        label: string;
+        href: string;
+    }>;
+    /** Optional CSS class name */
+    className?: string;
+    /** Logo image URL */
+    logo?: string;
+    /** Copyright text */
+    copyright?: string;
+    /** Footer content - children to render inside footer */
+    children?: React__default.ReactNode;
+}
+declare function PublicPageFooter({ event, companyName, year, links, className, logo, copyright, children }: PublicPageFooterProps): react_jsx_runtime.JSX.Element;
 /**
- * Header component for public pages with event-specific branding
- *
- * This component displays the app logo, event logo, and event information
- * in a clean, accessible layout suitable for public pages.
- *
- * The app logo is automatically generated from the appName using the pattern:
- * `/{appName.toLowerCase()}_logo_wide.svg` from the public folder.
+ * Layout component for public pages that don't require authentication
  *
- * **Important:** The appName is obtained from PublicPageProvider context, which should
- * receive the APP_NAME constant from your App.tsx file. This ensures consistency with
- * authenticated pages that use the same APP_NAME constant.
+ * This component provides a consistent structure for public event pages
+ * with event-specific branding, error handling, and loading states.
  *
- * **Event Logo Requirements:**
- * - Event logo files must be marked as `is_public = true` in the `file_references` table
- * - The RPC function `data_file_reference_by_category_list` must be accessible to the anonymous/public role
- * - Storage bucket must allow public read access for logo files
- * - If no public logo is available, a fallback UI with event initials will be displayed
+ * Automatically applies event colors from the event's event_colours field
+ * when an event is provided, ensuring consistent theming across public pages.
  *
- * @param props - Header configuration and content
- * @returns React element with public page header
+ * @param props - Layout configuration and content
+ * @returns React element with complete public page layout
  */
-declare function PublicPageHeader({ event, eventCode, title, description, showEventLogo, showAppLogo, className, children, customEventLogo }: PublicPageHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PublicPageLayout({ eventCode, children, event, isLoading, error, refetch, showFooter, className, errorFallback: ErrorFallback, loadingFallback: LoadingFallback, customHeader, customFooter, showValidationErrors, loadingMessage }: PublicPageLayoutProps): react_jsx_runtime.JSX.Element;
 
 interface PublicPageContextType {
     isPublicPage: true;
@@ -3663,235 +3884,4 @@ declare function usePublicPageContext(): PublicPageContextType;
  */
 declare function useIsPublicPage(): boolean;
 
-interface PublicPageFooterProps {
-    /** The event data for this public page */
-    event: Event;
-    /** Company or organization name */
-    companyName?: string;
-    /** Current year or custom year for copyright */
-    year?: number;
-    /** Optional array of navigation links to display */
-    links?: Array<{
-        label: string;
-        href: string;
-    }>;
-    /** Optional CSS class name */
-    className?: string;
-    /** Logo image URL */
-    logo?: string;
-    /** Copyright text */
-    copyright?: string;
-    /** Footer content - children to render inside footer */
-    children?: React__default.ReactNode;
-}
-/**
- * Footer component for public pages that matches the normal Footer exactly
- *
- * This component uses the same styling and structure as the main Footer component
- * to ensure consistency across the application.
- *
- * @param props - Footer configuration and content
- * @returns React element with public page footer
- */
-declare function PublicPageFooter({ event, companyName, year, links, className, logo, copyright, children }: PublicPageFooterProps): react_jsx_runtime.JSX.Element;
-
-/**
- * @file Public Page Context Checker
- * @package @jmruthers/pace-core
- * @module Components/PublicLayout
- * @since 1.0.0
- *
- * A simple component that immediately identifies if a public page
- * is being rendered inside authentication context.
- */
-interface PublicPageContextCheckerProps {
-    /** Whether to enable checking */
-    enabled?: boolean;
-    /** Custom label for this checker instance */
-    label?: string;
-}
-/**
- * Context checker component that immediately identifies authentication context issues
- *
- * This component will immediately log to console if authentication context
- * is being triggered in a public page.
- *
- * Only enabled in development mode when VITE_ENABLE_DEBUG_LOGS is 'true'
- */
-declare function PublicPageContextChecker({ enabled, label }: PublicPageContextCheckerProps): react_jsx_runtime.JSX.Element | null;
-
-interface PublicErrorBoundaryProps {
-    /** Child components to wrap */
-    children: ReactNode;
-    /** Custom error fallback component */
-    fallback?: React__default.ComponentType<PublicErrorBoundaryState>;
-    /** Custom CSS classes for error display */
-    className?: string;
-    /** Whether to show error details in development */
-    showErrorDetails?: boolean;
-    /** Custom error message */
-    customErrorMessage?: string;
-    /** Custom recovery action */
-    onRecover?: () => void;
-}
-interface PublicErrorBoundaryState {
-    /** Whether an error has occurred */
-    hasError: boolean;
-    /** The error that occurred */
-    error: Error | null;
-    /** Error information */
-    errorInfo: ErrorInfo | null;
-    /** Function to reset the error state */
-    resetError: () => void;
-}
-/**
- * Error boundary component for public pages
- *
- * This component catches JavaScript errors anywhere in the child component tree,
- * logs those errors, and displays a fallback UI instead of the component tree that crashed.
- *
- * @param props - Error boundary configuration
- * @returns React element with error boundary wrapper
- */
-declare class PublicErrorBoundary extends Component<PublicErrorBoundaryProps, PublicErrorBoundaryState> {
-    constructor(props: PublicErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): Partial<PublicErrorBoundaryState>;
-    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    resetError: () => void;
-    render(): string | number | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
-}
-/**
- * Hook for accessing error boundary state
- * Useful for components that need to know if they're inside an error boundary
- */
-declare function useErrorBoundary(): {
-    captureError: (error: Error) => void;
-    resetError: () => void;
-};
-/**
- * Default error fallback component
- */
-declare function DefaultPublicErrorFallback({ error, resetError }: PublicErrorBoundaryState): react_jsx_runtime.JSX.Element;
-
-/**
- * @file Public Loading Spinner Component
- * @package @jmruthers/pace-core
- * @module Components/PublicLayout
- * @since 1.0.0
- *
- * A loading spinner component specifically designed for public pages.
- * Provides consistent loading states with event-specific branding.
- *
- * Features:
- * - Consistent loading design
- * - Event-specific branding
- * - Multiple size options
- * - Accessibility compliant
- * - TypeScript support
- *
- * @example
- * ```tsx
- * import { PublicLoadingSpinner } from '@jmruthers/pace-core';
- *
- * function PublicEventPage() {
- *   if (isLoading) {
- *     return <PublicLoadingSpinner message="Loading event details..." />;
- *   }
- * }
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Screen reader friendly
- * - Proper ARIA labels
- * - High contrast support
- *
- * @dependencies
- * - React 18+ - Component framework
- * - Tailwind CSS - Styling
- */
-interface PublicLoadingSpinnerProps {
-    /** Loading message to display */
-    message?: string;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg' | 'xl';
-    /** Custom CSS classes */
-    className?: string;
-    /** Whether to show the app logo */
-    showLogo?: boolean;
-    /** Custom loading message */
-    customMessage?: string;
-    /** Whether to center the spinner */
-    centered?: boolean;
-}
-/**
- * Loading spinner component for public pages
- *
- * This component displays a consistent loading state with optional
- * branding and messaging for public pages.
- *
- * @param props - Spinner configuration and styling
- * @returns React element with loading spinner
- */
-declare function PublicLoadingSpinner({ message, size, className, showLogo, customMessage, centered }: PublicLoadingSpinnerProps): react_jsx_runtime.JSX.Element;
-/**
- * Full page loading spinner with event branding
- */
-declare function PublicLoadingSpinnerFullPage({ message, eventName, className }: Pick<PublicLoadingSpinnerProps, 'message' | 'className'> & {
-    eventName?: string;
-}): react_jsx_runtime.JSX.Element;
-/**
- * Skeleton loading component for content placeholders
- */
-declare function PublicLoadingSkeleton({ lines, className }: {
-    lines?: number;
-    className?: string;
-}): react_jsx_runtime.JSX.Element;
-
-interface EventLogoProps {
-    /** The event ID to fetch logo for */
-    eventId: string;
-    /** The event name for fallback text generation */
-    eventName: string;
-    /** The organisation ID for storage path */
-    organisationId: string;
-    /** Logo size variant */
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-    /** Custom CSS classes */
-    className?: string;
-    /** Whether to show fallback text when no logo is available */
-    showFallback?: boolean;
-    /** Custom fallback text generator */
-    generateFallbackText?: (eventName: string) => string;
-    /** Whether to validate image existence (deprecated - FileDisplay handles this) */
-    validateImage?: boolean;
-    /** Custom loading component */
-    loadingComponent?: React__default.ComponentType;
-    /** Custom error component */
-    errorComponent?: React__default.ComponentType<{
-        error: Error;
-    }>;
-}
-/**
- * Component for displaying event logos with fallback to initials
- *
- * This component is context-aware and automatically detects whether it's being used
- * in a public or authenticated context. It uses FileDisplay internally to fetch and
- * display event logos from storage, with automatic fallback to event initials if no
- * logo is available.
- *
- * @param props - Logo configuration and styling
- * @returns React element with event logo or fallback
- */
-declare function EventLogo({ eventId, eventName, organisationId, size, className, showFallback, generateFallbackText, validateImage, // Deprecated but kept for backward compatibility
-loadingComponent: LoadingComponent, errorComponent: ErrorComponent }: EventLogoProps): react_jsx_runtime.JSX.Element;
-/**
- * Compact event logo for small spaces
- */
-declare function EventLogoCompact(props: EventLogoProps): react_jsx_runtime.JSX.Element;
-/**
- * Large event logo for prominent display
- */
-declare function EventLogoLarge(props: EventLogoProps): react_jsx_runtime.JSX.Element;
-
-export { type DialogHeaderProps as $, Alert as A, Button as B, Card as C, TableCell as D, TableFooter as E, TableHead as F, TableRow as G, Dialog as H, Input as I, DialogPortal as J, DialogOverlay as K, Label as L, DialogTrigger as M, DialogClose as N, DialogContent as O, Progress as P, DialogHeader as Q, DialogBody as R, Switch as S, Textarea as T, DialogFooter as U, DialogTitle as V, DialogDescription as W, type DialogProps as X, type DialogTriggerProps as Y, type DialogContentProps as Z, type DialogOverlayProps as _, type ButtonProps as a, useFileReference as a$, type DialogFooterProps as a0, type DialogTitleProps as a1, type DialogDescriptionProps as a2, type DialogSize as a3, Select as a4, SelectGroup as a5, SelectValue as a6, SelectTrigger as a7, SelectContent as a8, SelectLabel as a9, TooltipRoot as aA, Form as aB, type FormProps as aC, LoginForm as aD, type LoginFormProps as aE, Header as aF, Footer as aG, type FooterProps as aH, ProtectedRoute as aI, type ProtectedRouteProps as aJ, NavigationMenu as aK, type NavigationMenuProps as aL, type NavigationItem as aM, OrganisationSelector as aN, type OrganisationSelectorProps as aO, UserMenu as aP, ErrorBoundary as aQ, type ErrorBoundaryProps as aR, type ErrorBoundaryState as aS, LoadingSpinner as aT, SessionRestorationLoader as aU, type SessionRestorationLoaderProps as aV, EventSelector as aW, FileUpload as aX, type FileUploadProps as aY, FileDisplay as aZ, type FileDisplayProps as a_, SelectItem as aa, SelectSeparator as ab, Tabs as ac, TabsList as ad, TabsTrigger as ae, TabsContent as af, type TabsProps as ag, type TabsListProps as ah, type TabsTriggerProps as ai, type TabsContentProps as aj, Calendar as ak, type CalendarProps as al, Toast as am, Toaster as an, ToastAction as ao, ToastProvider as ap, ToastViewport as aq, ToastTitle as ar, ToastDescription as as, ToastClose as at, type ToastActionElement as au, type ToastProps as av, Tooltip as aw, TooltipTrigger as ax, TooltipContent as ay, TooltipProvider as az, CardHeader as b, useFileReferenceForRecord as b0, useFileReferenceById as b1, useFilesByCategory as b2, type UseFileReferenceOptions as b3, type UseFileReferenceReturn as b4, type UseFileReferenceForRecordReturn as b5, PublicPageLayout as b6, usePublicPageContext$1 as b7, PublicPageHeader as b8, PublicPageProvider as b9, usePublicPageContext as ba, useIsPublicPage as bb, PublicPageFooter as bc, PublicPageContextChecker as bd, PublicErrorBoundary as be, useErrorBoundary as bf, DefaultPublicErrorFallback as bg, PublicLoadingSpinner as bh, PublicLoadingSpinnerFullPage as bi, PublicLoadingSkeleton as bj, EventLogo as bk, EventLogoCompact as bl, EventLogoLarge as bm, type EventLogoProps as bn, type PublicPageLayoutProps as bo, type PublicPageHeaderProps as bp, type PublicPageFooterProps as bq, type PublicErrorBoundaryProps as br, type PublicErrorBoundaryState as bs, type PublicLoadingSpinnerProps as bt, type PaceAppLayoutProps as bu, PaceAppLayout as bv, type PaceLoginPageProps as bw, PaceLoginPage as bx, type UserMenuProps as by, CardFooter as c, CardTitle as d, CardDescription as e, CardContent as f, CardActions as g, type CardProps as h, type CardActionsProps as i, type InputProps as j, type LabelProps as k, type TextareaProps as l, AlertTitle as m, AlertDescription as n, Avatar as o, AvatarImage as p, AvatarFallback as q, Badge as r, type BadgeProps as s, type BadgeVariant as t, Checkbox as u, type SwitchProps as v, Table as w, TableHeader as x, TableBody as y, TableCaption as z };
+export { type TabsProps as $, Alert as A, Button as B, Card as C, Dialog as D, DialogContent as E, DialogHeader as F, DialogBody as G, DialogFooter as H, Input as I, DialogTitle as J, DialogDescription as K, Label as L, Select as M, SelectGroup as N, SelectValue as O, Progress as P, SelectTrigger as Q, SelectContent as R, Switch as S, Textarea as T, SelectLabel as U, SelectItem as V, SelectSeparator as W, Tabs as X, TabsList as Y, TabsTrigger as Z, TabsContent as _, type ButtonProps as a, TableCell as a$, type TabsListProps as a0, type TabsTriggerProps as a1, type TabsContentProps as a2, Calendar as a3, type CalendarProps as a4, Toast as a5, Toaster as a6, ToastAction as a7, ToastProvider as a8, ToastViewport as a9, type PaceAppLayoutProps as aA, PaceLoginPage as aB, type PaceLoginPageProps as aC, ProtectedRoute as aD, type ProtectedRouteProps as aE, ErrorBoundary as aF, LoadingSpinner as aG, SessionRestorationLoader as aH, type SessionRestorationLoaderProps as aI, EventSelector as aJ, OrganisationSelector as aK, PasswordChangeForm as aL, FileUpload as aM, type FileUploadProps as aN, FileDisplay as aO, type FileDisplayProps as aP, useFileReference as aQ, useFileReferenceForRecord as aR, useFileReferenceById as aS, useFilesByCategory as aT, type UseFileReferenceOptions as aU, type UseFileReferenceReturn as aV, type UseFileReferenceForRecordReturn as aW, Table as aX, TableHeader as aY, TableBody as aZ, TableCaption as a_, ToastTitle as aa, ToastDescription as ab, ToastClose as ac, type ToastActionElement as ad, type ToastProps as ae, Tooltip as af, TooltipTrigger as ag, TooltipContent as ah, TooltipProvider as ai, TooltipRoot as aj, Form as ak, FormField as al, type FormProps as am, type FormFieldProps as an, LoginForm as ao, type LoginFormProps as ap, Header as aq, Footer as ar, type FooterProps as as, NavigationMenu as at, type NavigationMenuProps as au, type NavigationItem as av, type NavigationMode as aw, UserMenu as ax, type UserMenuProps as ay, PaceAppLayout as az, CardHeader as b, TableFooter as b0, TableHead as b1, TableRow as b2, PublicPageLayout as b3, PublicPageHeader as b4, PublicPageFooter as b5, PublicPageProvider as b6, usePublicPageContext as b7, useIsPublicPage as b8, type PublicPageLayoutProps as b9, type PublicPageHeaderProps as ba, type PublicPageFooterProps as bb, type CardActionsProps as bc, type DialogProps as bd, type DialogTriggerProps as be, type DialogContentProps as bf, type DialogOverlayProps as bg, type DialogHeaderProps as bh, type DialogFooterProps as bi, type DialogTitleProps as bj, type DialogDescriptionProps as bk, type DialogSize as bl, type OrganisationSelectorProps as bm, type ErrorBoundaryProps as bn, type ErrorBoundaryState as bo, CardFooter as c, CardTitle as d, CardDescription as e, CardContent as f, CardActions as g, type CardProps as h, type InputProps as i, type LabelProps as j, type TextareaProps as k, AlertTitle as l, AlertDescription as m, Avatar as n, AvatarImage as o, AvatarFallback as p, Badge as q, type BadgeProps as r, type BadgeVariant as s, Checkbox as t, type SwitchProps as u, type ProgressProps as v, DialogPortal as w, DialogOverlay as x, DialogTrigger as y, DialogClose as z };