@jmruthers/pace-core 0.6.1 → 0.6.3

package/dist/{PublicPageProvider-ce4xlHYA.d.ts → PublicPageProvider-DEMpysFR.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 { E as Event, O as Organisation } from './event-CW5YB_2p.js';
+import { P as Permission, A as AccessLevel } from './types-BeoeWV5I.js';
+import { O as Organisation, E as Event } 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;
@@ -2508,10 +2648,12 @@ interface HeaderProps {
     userMenu?: React__default.ReactNode;
     /** Custom className */
     className?: string;
-    /** Show/hide event selector */
-    showEventSelector?: boolean;
-    /** Show/hide organisation selector */
-    showOrgSelector?: boolean;
+    /** Show/hide context selector (unified org/event selector) - default: true */
+    showContextSelector?: boolean;
+    /** Show organisations in context selector - default: true */
+    showOrganisations?: boolean;
+    /** Show events in context selector - default: true */
+    showEvents?: boolean;
     /** Show/hide user menu */
     showUserMenu?: boolean;
     /** Current path for navigation highlighting */
@@ -2583,10 +2725,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 (
@@ -2609,7 +2751,7 @@ interface HeaderProps {
  *     <Header
  *       logoUrl="/simple-logo.svg"
  *       logoAlt="Simple App"
- *       showEventSelector={false}
+ *       showContextSelector={false}
  *       user={currentUser}
  *       onSignOut={handleSignOut}
  *     />
@@ -2622,7 +2764,14 @@ interface HeaderProps {
  *
  * @since 0.1.0
  */
-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;
+/**
+ * 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, showContextSelector, showOrganisations, showEvents, showUserMenu, currentPath, onNavigate, logoHref }: HeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file Footer Component
@@ -2673,28 +2822,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 +2860,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 +2961,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 +2969,7 @@ declare const Footer: React__default.NamedExoticComponent<FooterProps>;
  *       onChangePassword={handlePasswordChange}
  *       className="ml-auto"
  *     />
- *   </div>
+ *   </nav>
  * </Header>
  * ```
  *
@@ -2850,6 +3002,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,15 +3017,21 @@ 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;
     /** Optional navigation items for the header menu. If not provided, uses default navigation. */
     navItems?: NavigationItem[];
-    /** Show/hide event selector in the header */
-    showEventSelector?: boolean;
-    /** Show/hide organisation selector in the header */
-    showOrgSelector?: boolean;
+    /** Show/hide unified context selector (shows all accessible orgs and events) - default: true */
+    showContextSelector?: boolean;
+    /** Show organisations in context selector - default: true */
+    showOrganisations?: boolean;
+    /** Show events in context selector - default: true */
+    showEvents?: boolean;
     /** Custom actions to display in the header (between event selector and user menu) */
     headerActions?: React__default.ReactNode;
     /** Custom logo component (overrides default logo) */
@@ -3078,7 +3239,7 @@ interface PaceAppLayoutProps {
  *
  * @since 0.1.0
  */
-declare function PaceAppLayout({ appName, navItems, showEventSelector, showOrgSelector, 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;
+declare function PaceAppLayout({ appName, navItems, showContextSelector, showOrganisations, showEvents, 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
@@ -3203,6 +3364,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 +3401,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 +3412,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 +3444,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 +3481,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 +3501,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 +3512,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,72 +3697,56 @@ interface SessionRestorationLoaderProps {
 }
 declare const SessionRestorationLoader: React__default.FC<SessionRestorationLoaderProps>;
 
-interface EventSelectorProps {
-    /** Placeholder text for the dropdown */
-    placeholder?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Callback fired when an event changes, providing full event object */
-    onEventChange?: (event: Event | null) => void;
-    /** Show friendly message when no events available */
-    showNoEventsMessage?: boolean;
-    /** Show retry button on errors */
-    showRetryButton?: boolean;
-    /** Show event details in dropdown */
-    showEventDetails?: boolean;
-    /** Show indicator for next/upcoming events */
-    showNextEventIndicator?: boolean;
-}
 /**
- * EventSelector component for selecting events with built-in access control
- *
- * This component provides secure event selection with:
- * - Database integration via rbac_event_app_roles table
- * - Auto-selection of next upcoming event by date
- * - Cross-device sync via Supabase user session metadata
- * - localStorage fallback for offline scenarios
- * - Comprehensive error handling and user feedback
- *
- * @component
- * @example
- * <UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
- *   <EventSelector onEventChange={(event) => console.log(event)} />
- * </UnifiedAuthProvider>
+ * Props for the ContextSelector component.
  */
-declare function EventSelector({ placeholder, className, onEventChange, showNoEventsMessage, showRetryButton, showEventDetails, showNextEventIndicator }: EventSelectorProps): react_jsx_runtime.JSX.Element | null;
-
-interface OrganisationSelectorProps {
+interface ContextSelectorProps {
     /** Placeholder text for the dropdown */
     placeholder?: string;
     /** Additional CSS classes */
     className?: string;
-    /** Callback fired when organisation changes, providing full organisation object */
-    onOrganisationChange?: (org: Organisation) => void;
-    /** Show friendly message when no organisations available */
-    showNoOrganisationsMessage?: boolean;
+    /** Callback fired when an organisation is selected */
+    onOrganisationSelect?: (org: Organisation) => void;
+    /** Callback fired when an event is selected */
+    onEventSelect?: (event: Event) => void;
+    /** Show friendly message when no items available */
+    showNoItemsMessage?: boolean;
     /** Show retry button on errors */
     showRetryButton?: boolean;
-    /** Show user's role in each organisation */
-    showRole?: boolean;
     /** Compact display mode */
     compact?: boolean;
     /** Disabled state */
     disabled?: boolean;
+    /** Show organisations section (default: true) */
+    showOrganisations?: boolean;
+    /** Show events section (default: true) */
+    showEvents?: boolean;
 }
 /**
- * OrganisationSelector component for secure organisation switching
+ * ContextSelector component for selecting organisations or events
  *
- * This component provides secure organisation selection with:
- * - User membership validation
- * - Role-based access display
- * - Security error handling
- * - Real-time organisation switching
- * - Accessible interface design
+ * This is the unified intelligent selector that shows all organisations and events
+ * a user can access. It automatically determines what to show based on the user's
+ * roles and permissions - no need to configure separate org/event selectors.
  *
- * Security: Only shows organisations the user has valid access to
+ * The selector intelligently shows:
+ * - All organisations the user has access to (via organisation roles)
+ * - All events the user has access to (via event-app roles or organisation membership)
+ * - Everything for super admins
+ *
+ * @component
+ * @example
+ * <ContextSelector
+ *   onOrganisationSelect={(org) => switchOrganisation(org)}
+ *   onEventSelect={(event) => setSelectedEvent(event)}
+ * />
  */
-declare function OrganisationSelector({ placeholder, className, onOrganisationChange, showNoOrganisationsMessage, showRetryButton, showRole, compact, disabled }: OrganisationSelectorProps): react_jsx_runtime.JSX.Element | null;
+declare function ContextSelector({ placeholder, className, onOrganisationSelect, onEventSelect, showNoItemsMessage, showRetryButton, compact, disabled, showOrganisations, showEvents }: ContextSelectorProps): 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 +3836,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 +3918,9 @@ type UseFileReferenceOptions = {
     record_id: string;
     organisation_id: string;
 };
+/**
+ * Return value of the useFileReference hook.
+ */
 type UseFileReferenceReturn = {
     isLoading: boolean;
     error: string | null;
@@ -3712,6 +3934,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 +4084,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 +4155,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 +4195,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, ContextSelector as aS, type ContextSelectorProps 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, FileUpload as b2, type FileUploadProps as b3, FileDisplay as b4, type FileDisplayProps as b5, useFileReference as b6, useFileReferenceForRecord as b7, useFileReferenceById as b8, useFilesByCategory as b9, type UseFileReferenceOptions as ba, type UseFileReferenceReturn as bb, type UseFileReferenceForRecordReturn as bc, PublicPageLayout as bd, PublicPageHeader as be, PublicPageFooter as bf, PublicPageProvider as bg, usePublicPageContext as bh, useIsPublicPage as bi, type PublicPageLayoutProps as bj, type PublicPageHeaderProps as bk, type PublicPageFooterProps as bl, type PaceAppLayoutProps as bm, PaceAppLayout as bn, type PaceLoginPageProps as bo, PaceLoginPage as bp, type NavigationMode as bq, type UserMenuProps as br, PasswordChangeForm as bs, 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 };