@jmruthers/pace-core 0.6.1 → 0.6.2

package/dist/{PublicPageProvider-ce4xlHYA.d.ts → PublicPageProvider-DC6kCaqf.d.ts}

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
-import React__default, { Component, ReactNode } from 'react';
+import React__default, { ReactNode, Component } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as ParsedAddress, A as AutocompleteOptions } from './types-CEpcvwwF.js';
+import { P as ParsedAddress, A as AutocompleteOptions } from './types-CkbwOr4Y.js';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import { F as FileCategory, e as FileUploadResult, U as UploadProgress, c as FileUploadOptions, a as FileReference } from './file-reference-BavO2eQj.js';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
@@ -14,9 +14,19 @@ import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 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 { P as Permission, A as AccessLevel } from './types-UU913iLA.js';
+import { P as Permission, A as AccessLevel } from './types-BeoeWV5I.js';
 import { E as Event, O as Organisation } from './event-CW5YB_2p.js';
 
+/**
+ * Button component props
+ * Extends standard HTML button attributes with button-specific styling and behavior options.
+ *
+ * @interface ButtonProps
+ */
+/**
+ * Props for the Button component.
+ * Extends standard button HTML attributes.
+ */
 interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
     /** Visual variant of the button */
     variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
@@ -109,6 +119,10 @@ declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.Re
  * - Screen reader friendly with semantic landmarks
  */
 
+/**
+ * Props for the Card component.
+ * Extends standard HTML attributes for semantic HTML elements.
+ */
 interface CardProps extends React$1.HTMLAttributes<HTMLElement> {
     /** Visual variant of the card */
     variant?: 'default' | 'outline' | 'ghost';
@@ -128,6 +142,10 @@ declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttribut
 declare const CardActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
 type CardActionsProps = React$1.HTMLAttributes<HTMLElement>;
 
+/**
+ * Props for the Input component.
+ * Extends standard input HTML attributes.
+ */
 interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'> {
     /**
      * Input variant style
@@ -464,22 +482,20 @@ declare namespace Textarea {
  *
  * @example
  * ```tsx
- * // Basic alert
+ * // Basic alert (renders as <aside> with <h5> title and <p> description)
  * <Alert>
  *   <AlertTitle>Success</AlertTitle>
  *   <AlertDescription>Your changes have been saved.</AlertDescription>
  * </Alert>
  *
- * // Destructive alert with icon
+ * // Destructive alert with icon (renders as <aside> with <h5> title and <p> description)
  * <Alert variant="destructive">
  *   <ErrorIcon />
- *   <div>
- *     <AlertTitle>Error</AlertTitle>
- *     <AlertDescription>Something went wrong.</AlertDescription>
- *   </div>
+ *   <AlertTitle>Error</AlertTitle>
+ *   <AlertDescription>Something went wrong.</AlertDescription>
  * </Alert>
  *
- * // Inline alert (renders as fragment with strong/span)
+ * // Inline alert (renders as React.Fragment with <strong> title and <span> description)
  * <Alert variant="inline">
  *   <AlertTitle>Note:</AlertTitle>
  *   <AlertDescription>This is an inline message.</AlertDescription>
@@ -570,7 +586,21 @@ interface AvatarProps extends React$1.HTMLAttributes<HTMLDivElement> {
  */
 declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Badge variant type
+ * Defines the visual style, color palette, and shade intensity of the badge.
+ * Format: {style}-{color}-{shade}
+ * - style: 'solid' | 'outline' | 'soft'
+ * - color: 'main' | 'sec' | 'acc'
+ * - shade: 'muted' | 'normal' | 'strong'
+ */
 type BadgeVariant = 'solid-main-muted' | 'solid-main-normal' | 'solid-main-strong' | 'solid-sec-muted' | 'solid-sec-normal' | 'solid-sec-strong' | 'solid-acc-muted' | 'solid-acc-normal' | 'solid-acc-strong' | 'outline-main-muted' | 'outline-main-normal' | 'outline-main-strong' | 'outline-sec-muted' | 'outline-sec-normal' | 'outline-sec-strong' | 'outline-acc-muted' | 'outline-acc-normal' | 'outline-acc-strong' | 'soft-main-muted' | 'soft-main-normal' | 'soft-main-strong' | 'soft-sec-muted' | 'soft-sec-normal' | 'soft-sec-strong' | 'soft-acc-muted' | 'soft-acc-normal' | 'soft-acc-strong';
+/**
+ * Badge component props
+ * Extends standard HTML span attributes with badge-specific styling options.
+ *
+ * @interface BadgeProps
+ */
 interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** Visual variant of the badge (style-color-shade) */
     variant?: BadgeVariant;
@@ -625,10 +655,10 @@ declare namespace Badge {
  * <Checkbox />
  *
  * // With label
- * <div className="flex items-center space-x-2">
+ * <>
  *   <Checkbox id="terms" />
  *   <label htmlFor="terms">Accept terms and conditions</label>
- * </div>
+ * </>
  *
  * // Disabled state
  * <Checkbox disabled />
@@ -677,7 +707,7 @@ declare const Checkbox: React$1.ForwardRefExoticComponent<Omit<CheckboxPrimitive
  *   const [checked, setChecked] = React.useState(false);
  *
  *   return (
- *     <div className="flex items-center gap-2">
+ *     <>
  *       <Switch
  *         checked={checked}
  *         onCheckedChange={setChecked}
@@ -686,7 +716,7 @@ declare const Checkbox: React$1.ForwardRefExoticComponent<Omit<CheckboxPrimitive
  *       <label htmlFor="notifications">
  *         Enable notifications
  *       </label>
- *     </div>
+ *     </>
  *   );
  * }
  * ```
@@ -697,12 +727,12 @@ declare const Checkbox: React$1.ForwardRefExoticComponent<Omit<CheckboxPrimitive
  *
  * function FormExample() {
  *   return (
- *     <div className="flex items-center gap-2">
+ *     <>
  *       <Switch id="terms" />
  *       <Label htmlFor="terms">
  *         I agree to the terms and conditions
  *       </Label>
- *     </div>
+ *     </>
  *   );
  * }
  * ```
@@ -1038,19 +1068,13 @@ declare const DialogTitle: React$1.ForwardRefExoticComponent<DialogTitleProps &
 declare const DialogDescription: React$1.ForwardRefExoticComponent<DialogDescriptionProps & React$1.RefAttributes<HTMLHeadingElement>>;
 
 /**
- * @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
+ * Direction for Select dropdown opening.
+ * Controls whether the dropdown opens upward or downward.
+ */
+type SelectDirection = "up" | "down";
+/**
+ * Props for the useSelectState hook.
  */
-
 interface UseSelectStateProps {
     value?: string;
     defaultValue?: string;
@@ -1061,19 +1085,31 @@ interface UseSelectStateProps {
     onValueChange?: (value: string) => void;
     onOpenChange?: (open: boolean) => void;
 }
-interface SelectProps extends Omit<React$1.HTMLAttributes<HTMLFormElement>, 'onChange' | 'onKeyDown' | 'onFocus' | 'onBlur'> {
+/**
+ * Props for the Select root component.
+ */
+interface SelectProps extends Omit<React$1.HTMLAttributes<HTMLFormElement>, "onChange" | "onKeyDown" | "onFocus" | "onBlur"> {
     children: React$1.ReactNode;
     className?: string;
-    direction?: 'up' | 'down';
+    direction?: SelectDirection;
 }
-interface SelectTriggerProps extends Omit<ButtonProps, 'onClick' | 'onKeyDown'> {
+/**
+ * Props for the SelectTrigger component.
+ */
+interface SelectTriggerProps extends Omit<ButtonProps, "onClick" | "onKeyDown"> {
     children: React$1.ReactNode;
     asChild?: boolean;
 }
+/**
+ * Props for the SelectValue component.
+ */
 interface SelectValueProps {
     placeholder?: string;
     children?: React$1.ReactNode;
 }
+/**
+ * Props for the SelectContent component.
+ */
 interface SelectContentProps {
     children: React$1.ReactNode;
     className?: string;
@@ -1082,6 +1118,9 @@ interface SelectContentProps {
     maxHeight?: string;
     style?: React$1.CSSProperties;
 }
+/**
+ * Props for the SelectItem component.
+ */
 interface SelectItemProps {
     value: string;
     children: React$1.ReactNode;
@@ -1089,19 +1128,98 @@ interface SelectItemProps {
     className?: string;
     onClick?: (e: React$1.MouseEvent) => 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
+ */
+
+/**
+ * Select component root.
+ * Provides select dropdown functionality with search, keyboard navigation, and accessibility.
+ *
+ * @param props - Select configuration
+ * @param ref - Forwarded ref to the form element
+ * @returns The rendered select component
+ */
 declare const Select: React$1.ForwardRefExoticComponent<SelectProps & UseSelectStateProps & React$1.RefAttributes<HTMLFormElement>>;
+/**
+ * Select trigger button component.
+ * Opens/closes the select dropdown and displays the selected value.
+ *
+ * @param props - Select trigger configuration
+ * @param ref - Forwarded ref to the button element
+ * @returns The rendered select trigger
+ */
 declare const SelectTrigger: React$1.ForwardRefExoticComponent<SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+/**
+ * Select value display component.
+ * Shows the selected value or placeholder text.
+ *
+ * @param props - Select value configuration
+ * @param ref - Forwarded ref to the span element
+ * @returns The rendered select value display
+ */
 declare const SelectValue: React$1.ForwardRefExoticComponent<SelectValueProps & React$1.RefAttributes<HTMLSpanElement>>;
+/**
+ * Select content/dropdown component.
+ * Contains the list of selectable options.
+ *
+ * @param props - Select content configuration
+ * @param ref - Forwarded ref to the list element
+ * @returns The rendered select content
+ */
 declare const SelectContent: React$1.ForwardRefExoticComponent<SelectContentProps & React$1.RefAttributes<HTMLUListElement>>;
+/**
+ * Select item component.
+ * Represents a single selectable option in the dropdown.
+ *
+ * @param props - Select item configuration
+ * @param ref - Forwarded ref to the list item element
+ * @returns The rendered select item
+ */
 declare const SelectItem: React$1.ForwardRefExoticComponent<SelectItemProps & React$1.RefAttributes<HTMLLIElement>>;
+/**
+ * Select group component.
+ * Groups related select items together.
+ *
+ * @param props - Select group configuration
+ * @param ref - Forwarded ref to the div element
+ * @returns The rendered select group
+ */
 declare const SelectGroup: React$1.ForwardRefExoticComponent<{
     children: React$1.ReactNode;
     className?: string;
 } & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Select label component.
+ * Provides a label for a group of select items.
+ *
+ * @param props - Select label configuration
+ * @param ref - Forwarded ref to the div element
+ * @returns The rendered select label
+ */
 declare const SelectLabel: React$1.ForwardRefExoticComponent<{
     children: React$1.ReactNode;
     className?: string;
 } & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Select separator component.
+ * Provides visual separation between groups of select items.
+ *
+ * @param props - Select separator configuration
+ * @param ref - Forwarded ref to the div element
+ * @returns The rendered select separator
+ */
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<{
     className?: string;
 } & React$1.RefAttributes<HTMLDivElement>>;
@@ -1229,7 +1347,7 @@ interface TabsContentProps extends React$1.ComponentPropsWithoutRef<typeof TabsP
  * @example
  * ```tsx
  * <TabsContent value="tab1">
- *   <div>Content for tab 1</div>
+ *   <section>Content for tab 1</section>
  * </TabsContent>
  * ```
  */
@@ -1292,6 +1410,10 @@ declare const TabsContent: React$1.ForwardRefExoticComponent<TabsContentProps &
  * - Date announcements
  */
 
+/**
+ * Props for the Calendar component.
+ * Extends DayPickerProps with pace-core specific customizations.
+ */
 interface CalendarProps extends Omit<DayPickerProps, 'className' | 'classNames' | 'styles' | 'onSelect'> {
     /**
      * Additional CSS classes to apply to the calendar table
@@ -1460,6 +1582,10 @@ declare const ToastTitle: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives
 declare const ToastDescription: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastDescriptionProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface ToastProps extends React$1.ComponentPropsWithoutRef<typeof ToastPrimitives.Root> {
 }
+/**
+ * Type for toast action elements.
+ * Represents a React element that can be used as a toast action button.
+ */
 interface ToastActionElement extends React$1.ReactElement<typeof ToastAction> {
 }
 /**
@@ -1521,10 +1647,10 @@ declare function Toaster(): react_jsx_runtime.JSX.Element;
  *       <Button>Advanced Tooltip</Button>
  *     </TooltipTrigger>
  *     <TooltipContent side="top" className="bg-main-500 text-main-50">
- *       <div className="space-y-1">
+ *       <section className="space-y-1">
  *         <p className="font-semibold">Advanced Tooltip</p>
  *         <p className="text-xs">With custom styling</p>
- *       </div>
+ *       </section>
  *     </TooltipContent>
  *   </TooltipRoot>
  * </TooltipProvider>
@@ -1887,6 +2013,10 @@ declare function FormField<TFieldValues extends FieldValues = FieldValues, TName
  * - Tailwind CSS - Styling
  */
 
+/**
+ * Props for the LoginForm component.
+ * Configures login form behavior, validation, and callbacks.
+ */
 interface LoginFormProps {
     /** Callback invoked when the form is submitted */
     onSignIn: (data: {
@@ -1932,6 +2062,57 @@ interface LoginFormProps {
  */
 declare const LoginForm: React__default.NamedExoticComponent<LoginFormProps>;
 
+/**
+ * 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$1.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;
+}
+
 /**
  * @file Unified Navigation Menu Component
  * @package @jmruthers/pace-core
@@ -2125,56 +2306,6 @@ declare const LoginForm: React__default.NamedExoticComponent<LoginFormProps>;
  * - 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$1.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.
  *
@@ -2466,14 +2597,23 @@ declare const NavigationMenu: React$1.ForwardRefExoticComponent<NavigationMenuPr
  * - Label component
  * - Tailwind CSS - Styling
  */
+/**
+ * Form values for password change.
+ */
 interface PasswordChangeFormValues {
     newPassword: string;
     confirmPassword: string;
 }
+/**
+ * Error structure for password change form.
+ */
 interface PasswordChangeFormError {
     message?: string;
     code?: string;
 }
+/**
+ * Props for the PasswordChangeForm component.
+ */
 interface PasswordChangeFormProps {
     onSubmit: (values: PasswordChangeFormValues) => Promise<{
         error?: PasswordChangeFormError;
@@ -2583,10 +2723,10 @@ interface HeaderProps {
  *
  * function HeaderWithActions() {
  *   const customActions = (
- *     <div className="flex items-center gap-2">
+ *     <>
  *       <Button variant="outline" size="sm">Export</Button>
  *       <Button size="sm">New Item</Button>
- *     </div>
+ *     </>
  *   );
  *
  *   return (
@@ -2622,6 +2762,13 @@ interface HeaderProps {
  *
  * @since 0.1.0
  */
+/**
+ * Header component for application layouts.
+ * Provides navigation, user menu, organisation/event selectors, and customizable branding.
+ *
+ * @param props - Header configuration
+ * @returns The rendered header
+ */
 declare function Header({ logoUrl, logoAlt, logo, navItems, user, onSignOut, onChangePassword, actions, userMenu, className, showEventSelector, showOrgSelector, showUserMenu, currentPath, onNavigate, logoHref }: HeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
@@ -2673,28 +2820,28 @@ declare function Header({ logoUrl, logoAlt, logo, navItems, user, onSignOut, onC
  *
  * // Footer with custom content
  * <Footer companyName="My Company">
- *   <div className="grid grid-cols-1 md:grid-cols-3 gap-8 mb-8">
- *     <div>
+ *   <section className="grid grid-cols-1 md:grid-cols-3 gap-8 mb-8">
+ *     <section>
  *       <h3 className="font-semibold mb-2">About Us</h3>
  *       <p className="text-sm text-muted-foreground">
  *         We provide innovative solutions for modern businesses.
  *       </p>
- *     </div>
- *     <div>
+ *     </section>
+ *     <section>
  *       <h3 className="font-semibold mb-2">Contact</h3>
  *       <p className="text-sm text-muted-foreground">
  *         Email: info@mycompany.com<br />
  *         Phone: (555) 123-4567
  *       </p>
- *     </div>
- *     <div>
+ *     </section>
+ *     <section>
  *       <h3 className="font-semibold mb-2">Follow Us</h3>
- *       <div className="flex gap-2">
+ *       <nav className="flex gap-2">
  *         <a href="#" className="text-muted-foreground hover:text-foreground">Twitter</a>
  *         <a href="#" className="text-muted-foreground hover:text-foreground">LinkedIn</a>
- *       </div>
- *     </div>
- *   </div>
+ *       </nav>
+ *     </section>
+ *   </section>
  * </Footer>
  * ```
  *
@@ -2711,6 +2858,9 @@ declare function Header({ logoUrl, logoAlt, logo, navItems, user, onSignOut, onC
  * - Tailwind CSS - Styling
  */
 
+/**
+ * Props for the Footer component.
+ */
 interface FooterProps {
     /**
      * Company or organization name
@@ -2809,7 +2959,7 @@ declare const Footer: React__default.NamedExoticComponent<FooterProps>;
  *
  * // User menu in header
  * <Header>
- *   <div className="flex items-center gap-4">
+ *   <nav className="flex items-center gap-4">
  *     <Navigation />
  *     <UserMenu
  *       user={user}
@@ -2817,7 +2967,7 @@ declare const Footer: React__default.NamedExoticComponent<FooterProps>;
  *       onChangePassword={handlePasswordChange}
  *       className="ml-auto"
  *     />
- *   </div>
+ *   </nav>
  * </Header>
  * ```
  *
@@ -2850,6 +3000,9 @@ declare const Footer: React__default.NamedExoticComponent<FooterProps>;
  * - Tailwind CSS - Styling
  */
 
+/**
+ * Props for the UserMenu component.
+ */
 interface UserMenuProps {
     user: User | null;
     onSignOut?: () => Promise<void>;
@@ -2862,6 +3015,10 @@ interface UserMenuProps {
 declare const UserMenu: React__default.NamedExoticComponent<UserMenuProps>;
 
 type Operation = 'read' | 'create' | 'update' | 'delete' | 'manage';
+/**
+ * Props for the PaceAppLayout component.
+ * Configures the application layout including navigation, header, and footer.
+ */
 interface PaceAppLayoutProps {
     /** The name of the application to be displayed in the header. */
     appName: string;
@@ -3203,6 +3360,9 @@ declare function PaceAppLayout({ appName, navItems, showEventSelector, showOrgSe
  * - Tailwind CSS - Styling
  */
 
+/**
+ * Props for the PaceLoginPage component.
+ */
 interface PaceLoginPageProps {
     /** The name of the application to be displayed on the login form. */
     appName: string;
@@ -3237,6 +3397,9 @@ interface PaceLoginPageProps {
  */
 declare const PaceLoginPage: React__default.FC<PaceLoginPageProps>;
 
+/**
+ * Props for the ProtectedRoute component.
+ */
 interface ProtectedRouteProps {
     /**
      * Whether an event is required for routes inside this component.
@@ -3245,13 +3408,6 @@ interface ProtectedRouteProps {
      * @default true
      */
     requireEvent?: boolean;
-    /**
-     * Whether super admins can bypass event requirement.
-     * Note: This feature requires additional RBAC setup. For simple bypass, set requireEvent={false} instead.
-     * @default false
-     * @deprecated Use requireEvent={false} for routes that don't need events
-     */
-    allowSuperAdminBypass?: boolean;
     /**
      * Custom component to render when no events are available.
      * If not provided, a default message is shown.
@@ -3284,7 +3440,7 @@ interface ProtectedRouteProps {
  * @param props - Configuration for route protection
  * @returns React element with route protection logic
  */
-declare function ProtectedRoute({ requireEvent, allowSuperAdminBypass, noEventsFallback, loadingFallback, loginPath }: ProtectedRouteProps): string | number | bigint | true | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element;
+declare function ProtectedRoute({ requireEvent, noEventsFallback, loadingFallback, loginPath }: ProtectedRouteProps): string | number | bigint | true | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element;
 
 /**
  * State interface for the ErrorBoundary component
@@ -3321,6 +3477,8 @@ interface ErrorBoundaryProps {
     enableRetry?: boolean;
     /** Whether to enable error reporting */
     enableReporting?: boolean;
+    /** Internal: Global error handler from context (not part of public API) */
+    _globalErrorHandler?: (error: Error, errorInfo: React__default.ErrorInfo, errorId: string, componentName: string) => void;
 }
 /**
  * ErrorBoundary component
@@ -3339,7 +3497,7 @@ interface ErrorBoundaryProps {
  * </ErrorBoundary>
  * ```
  */
-declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+declare class ErrorBoundary$1 extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
     private retryTimeoutId;
     constructor(props: ErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState>;
@@ -3350,6 +3508,65 @@ declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryS
     render(): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
 }
 
+/**
+ * Type definition for the global error handler function
+ * @public
+ */
+type GlobalErrorHandler = (error: Error, errorInfo: React__default.ErrorInfo, errorId: string, componentName: string) => void;
+/**
+ * Props for ErrorBoundaryProvider component
+ * @public
+ */
+interface ErrorBoundaryProviderProps {
+    /** Children to wrap with the provider */
+    children: ReactNode;
+    /** Global error handler that will be used by all ErrorBoundary instances unless overridden */
+    defaultErrorHandler?: GlobalErrorHandler;
+}
+/**
+ * Provider component for ErrorBoundary global error handler configuration
+ *
+ * Wrap your application with this provider to set a default error handler that will
+ * be used by all ErrorBoundary instances unless they provide their own onError prop.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundaryProvider
+ *   defaultErrorHandler={(error, errorInfo, errorId, componentName) => {
+ *     errorTracking.captureException(error, {
+ *       componentStack: errorInfo.componentStack,
+ *       errorBoundary: true,
+ *       errorId,
+ *       componentName,
+ *     });
+ *   }}
+ * >
+ *   <App />
+ * </ErrorBoundaryProvider>
+ * ```
+ *
+ * @public
+ */
+/**
+ * Error boundary provider component.
+ * Provides global error handling configuration to child ErrorBoundary components.
+ *
+ * @param props - Error boundary provider configuration
+ * @returns The error boundary provider
+ */
+declare function ErrorBoundaryProvider({ children, defaultErrorHandler, }: ErrorBoundaryProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @file Error Boundary exports
+ */
+
+/**
+ * ErrorBoundary component with automatic context support
+ * This wrapper automatically uses the global error handler from ErrorBoundaryProvider
+ * if no onError prop is provided.
+ */
+declare const ErrorBoundary: React__default.ForwardRefExoticComponent<Omit<ErrorBoundaryProps, "_globalErrorHandler"> & React__default.RefAttributes<ErrorBoundary$1>>;
+
 /**
  * @file LoadingSpinner Component
  * @package @jmruthers/pace-core
@@ -3476,6 +3693,9 @@ interface SessionRestorationLoaderProps {
 }
 declare const SessionRestorationLoader: React__default.FC<SessionRestorationLoaderProps>;
 
+/**
+ * Props for the EventSelector component.
+ */
 interface EventSelectorProps {
     /** Placeholder text for the dropdown */
     placeholder?: string;
@@ -3510,6 +3730,9 @@ interface EventSelectorProps {
  */
 declare function EventSelector({ placeholder, className, onEventChange, showNoEventsMessage, showRetryButton, showEventDetails, showNextEventIndicator }: EventSelectorProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Props for the OrganisationSelector component.
+ */
 interface OrganisationSelectorProps {
     /** Placeholder text for the dropdown */
     placeholder?: string;
@@ -3542,6 +3765,10 @@ interface OrganisationSelectorProps {
  */
 declare function OrganisationSelector({ placeholder, className, onOrganisationChange, showNoOrganisationsMessage, showRetryButton, showRole, compact, disabled }: OrganisationSelectorProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Props for the FileUpload component.
+ * Configures file upload behavior including storage location, validation, and callbacks.
+ */
 interface FileUploadProps {
     supabase: SupabaseClient;
     table_name: string;
@@ -3631,8 +3858,22 @@ interface FileDisplayProps {
  * @param props.category - Optional category filter. When specified, only displays files matching this category and uses single file display variant.
  * @returns React element with file display
  */
+/**
+ * File display component.
+ * Renders files from the file reference system with support for previews, downloads, and public/private access.
+ *
+ * @param props - File display configuration
+ * @returns The rendered file display
+ */
 declare function FileDisplay({ table_name, record_id, organisation_id, category, displayOnly, showDelete, className, imgClassName, children, loadingComponent, errorComponent, showFallback, generateFallbackText, fallbackText, fallbackSourceText, fallbackSize, enableChildren, showMetadata }: FileDisplayProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Hook for managing file references.
+ * Provides file upload, retrieval, and URL generation functionality.
+ *
+ * @param supabase - Supabase client instance
+ * @returns File reference service with upload, get, and URL methods
+ */
 declare function useFileReference(supabase: SupabaseClient): {
     isLoading: boolean;
     error: string | null;
@@ -3699,6 +3940,9 @@ type UseFileReferenceOptions = {
     record_id: string;
     organisation_id: string;
 };
+/**
+ * Return value of the useFileReference hook.
+ */
 type UseFileReferenceReturn = {
     isLoading: boolean;
     error: string | null;
@@ -3712,6 +3956,9 @@ type UseFileReferenceReturn = {
     getFileCount: (table_name: string, record_id: string, organisation_id: string) => Promise<number>;
     clearError: () => void;
 };
+/**
+ * Return value of the useFileReferenceForRecord hook.
+ */
 type UseFileReferenceForRecordReturn = {
     isLoading: boolean;
     error: string | null;
@@ -3859,8 +4106,6 @@ interface PublicPageLayoutProps {
     refetch?: () => Promise<void> | void;
     /** Whether to show the footer (default: true) */
     showFooter?: boolean;
-    /** @deprecated Custom CSS classes for the layout - no longer used as wrapper div was removed */
-    className?: string;
     /** Custom error fallback component */
     errorFallback?: React__default.ComponentType<{
         error: Error;
@@ -3932,7 +4177,7 @@ declare function PublicPageFooter({ event, companyName, year, links, className,
  * @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;
+declare function PublicPageLayout({ eventCode, children, event, isLoading, error, refetch, showFooter, errorFallback: ErrorFallback, loadingFallback: LoadingFallback, customHeader, customFooter, showValidationErrors, loadingMessage }: PublicPageLayoutProps): react_jsx_runtime.JSX.Element;
 
 interface PublicPageContextType {
     isPublicPage: true;
@@ -3972,4 +4217,4 @@ declare function usePublicPageContext(): PublicPageContextType;
  */
 declare function useIsPublicPage(): boolean;
 
-export { type DialogTriggerProps as $, AddressField as A, Button as B, Card as C, TableHeader as D, TableBody as E, TableCaption as F, TableCell as G, TableFooter as H, Input as I, TableHead as J, TableRow as K, Label as L, Dialog as M, DialogPortal as N, DialogOverlay as O, Progress as P, DialogTrigger as Q, DialogClose as R, Switch as S, Textarea as T, DialogContent as U, DialogHeader as V, DialogBody as W, DialogFooter as X, DialogTitle as Y, DialogDescription as Z, type DialogProps as _, type ButtonProps as a, EventSelector as a$, type DialogContentProps as a0, type DialogOverlayProps as a1, type DialogHeaderProps as a2, type DialogFooterProps as a3, type DialogTitleProps as a4, type DialogDescriptionProps as a5, type DialogSize as a6, Select as a7, SelectGroup as a8, SelectValue as a9, TooltipTrigger as aA, TooltipContent as aB, TooltipProvider as aC, TooltipRoot as aD, Form as aE, FormField as aF, type FormProps as aG, type FormFieldProps as aH, LoginForm as aI, type LoginFormProps as aJ, Header as aK, Footer as aL, type FooterProps as aM, ProtectedRoute as aN, type ProtectedRouteProps as aO, NavigationMenu as aP, type NavigationMenuProps as aQ, type NavigationItem as aR, OrganisationSelector as aS, type OrganisationSelectorProps as aT, UserMenu as aU, ErrorBoundary as aV, type ErrorBoundaryProps as aW, type ErrorBoundaryState as aX, LoadingSpinner as aY, SessionRestorationLoader as aZ, type SessionRestorationLoaderProps as a_, SelectTrigger as aa, SelectContent as ab, SelectLabel as ac, SelectItem as ad, SelectSeparator as ae, Tabs as af, TabsList as ag, TabsTrigger as ah, TabsContent as ai, type TabsProps as aj, type TabsListProps as ak, type TabsTriggerProps as al, type TabsContentProps as am, Calendar as an, type CalendarProps as ao, Toast as ap, Toaster as aq, ToastAction as ar, ToastProvider as as, ToastViewport as at, ToastTitle as au, ToastDescription as av, ToastClose as aw, type ToastActionElement as ax, type ToastProps as ay, Tooltip as az, CardHeader as b, FileUpload as b0, type FileUploadProps as b1, FileDisplay as b2, type FileDisplayProps as b3, useFileReference as b4, useFileReferenceForRecord as b5, useFileReferenceById as b6, useFilesByCategory as b7, type UseFileReferenceOptions as b8, type UseFileReferenceReturn as b9, type UseFileReferenceForRecordReturn as ba, PublicPageLayout as bb, PublicPageHeader as bc, PublicPageFooter as bd, PublicPageProvider as be, usePublicPageContext as bf, useIsPublicPage as bg, type PublicPageLayoutProps as bh, type PublicPageHeaderProps as bi, type PublicPageFooterProps as bj, type PaceAppLayoutProps as bk, PaceAppLayout as bl, type PaceLoginPageProps as bm, PaceLoginPage as bn, type NavigationMode as bo, type UserMenuProps as bp, PasswordChangeForm as bq, 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 AddressFieldProps as k, type AddressFieldRef as l, type LabelProps as m, type TextareaProps as n, Alert as o, AlertTitle as p, AlertDescription as q, Avatar as r, type AvatarProps as s, Badge as t, type BadgeProps as u, type BadgeVariant as v, Checkbox as w, type SwitchProps as x, type ProgressProps as y, Table as z };
+export { type DialogTriggerProps as $, AddressField as A, Button as B, Card as C, TableHeader as D, TableBody as E, TableCaption as F, TableCell as G, TableFooter as H, Input as I, TableHead as J, TableRow as K, Label as L, Dialog as M, DialogPortal as N, DialogOverlay as O, Progress as P, DialogTrigger as Q, DialogClose as R, Switch as S, Textarea as T, DialogContent as U, DialogHeader as V, DialogBody as W, DialogFooter as X, DialogTitle as Y, DialogDescription as Z, type DialogProps as _, type ButtonProps as a, LoadingSpinner as a$, type DialogContentProps as a0, type DialogOverlayProps as a1, type DialogHeaderProps as a2, type DialogFooterProps as a3, type DialogTitleProps as a4, type DialogDescriptionProps as a5, type DialogSize as a6, Select as a7, SelectGroup as a8, SelectValue as a9, TooltipTrigger as aA, TooltipContent as aB, TooltipProvider as aC, TooltipRoot as aD, Form as aE, FormField as aF, type FormProps as aG, type FormFieldProps as aH, LoginForm as aI, type LoginFormProps as aJ, Header as aK, Footer as aL, type FooterProps as aM, ProtectedRoute as aN, type ProtectedRouteProps as aO, NavigationMenu as aP, type NavigationMenuProps as aQ, type NavigationItem as aR, OrganisationSelector as aS, type OrganisationSelectorProps as aT, UserMenu as aU, ErrorBoundary as aV, ErrorBoundaryProvider as aW, type ErrorBoundaryProps as aX, type ErrorBoundaryState as aY, type ErrorBoundaryProviderProps as aZ, type GlobalErrorHandler as a_, SelectTrigger as aa, SelectContent as ab, SelectLabel as ac, SelectItem as ad, SelectSeparator as ae, Tabs as af, TabsList as ag, TabsTrigger as ah, TabsContent as ai, type TabsProps as aj, type TabsListProps as ak, type TabsTriggerProps as al, type TabsContentProps as am, Calendar as an, type CalendarProps as ao, Toast as ap, Toaster as aq, ToastAction as ar, ToastProvider as as, ToastViewport as at, ToastTitle as au, ToastDescription as av, ToastClose as aw, type ToastActionElement as ax, type ToastProps as ay, Tooltip as az, CardHeader as b, SessionRestorationLoader as b0, type SessionRestorationLoaderProps as b1, EventSelector as b2, FileUpload as b3, type FileUploadProps as b4, FileDisplay as b5, type FileDisplayProps as b6, useFileReference as b7, useFileReferenceForRecord as b8, useFileReferenceById as b9, useFilesByCategory as ba, type UseFileReferenceOptions as bb, type UseFileReferenceReturn as bc, type UseFileReferenceForRecordReturn as bd, PublicPageLayout as be, PublicPageHeader as bf, PublicPageFooter as bg, PublicPageProvider as bh, usePublicPageContext as bi, useIsPublicPage as bj, type PublicPageLayoutProps as bk, type PublicPageHeaderProps as bl, type PublicPageFooterProps as bm, type PaceAppLayoutProps as bn, PaceAppLayout as bo, type PaceLoginPageProps as bp, PaceLoginPage as bq, type NavigationMode as br, type UserMenuProps as bs, PasswordChangeForm as bt, 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 AddressFieldProps as k, type AddressFieldRef as l, type LabelProps as m, type TextareaProps as n, Alert as o, AlertTitle as p, AlertDescription as q, Avatar as r, type AvatarProps as s, Badge as t, type BadgeProps as u, type BadgeVariant as v, Checkbox as w, type SwitchProps as x, type ProgressProps as y, Table as z };