@jmruthers/pace-core 0.6.9 → 0.6.11

package/dist/PublicPageProvider-CIGSujI2.d.ts

@@ -1,4147 +0,0 @@
-import * as React$1 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-DXstZpNI.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';
-import * as SwitchPrimitive from '@radix-ui/react-switch';
-import * as TabsPrimitive from '@radix-ui/react-tabs';
-import { DayPickerProps, DateRange } from 'react-day-picker';
-import * as ToastPrimitives from '@radix-ui/react-toast';
-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 { N as NavigationMenuProps, a as NavigationItem } from './types-t9H8qKRw.js';
-import { User, SupabaseClient, createClient } from '@supabase/supabase-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';
-    /** Size of the button */
-    size?: 'default' | 'sm' | 'lg' | 'icon';
-    /** Whether to render as a different element using Radix Slot */
-    asChild?: boolean;
-}
-/**
- * Button Component
- * A flexible, accessible button component with multiple variants and sizes.
- *
- * @component
- * @example
- * ```tsx
- * // Basic button
- * <Button>Click me</Button>
- *
- * // Button with variant and size
- * <Button variant="destructive" size="lg">Delete</Button>
- *
- * // Button as child (composition)
- * <Button asChild>
- *   <Link href="/dashboard">Go to Dashboard</Link>
- * </Button>
- * ```
- */
-declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
-
-/**
- * @file Card Component Suite
- * @package @jmruthers/pace-core
- * @module Components
- * @since 0.1.0
- *
- * A flexible card component suite for displaying content with consistent styling.
- * Includes Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, CardActions, and HoverCard variants.
- * Uses semantic HTML elements for better accessibility and structure.
- *
- * Features:
- * - Semantic HTML structure (article, header, main, footer, etc.)
- * - Modular card structure (header, content, footer, actions, etc.)
- * - CardContent uses main element for primary content (accessible when nested)
- * - Consistent padding, border, and shadow
- * - Responsive and accessible
- * - HoverCard for popover-style cards
- * - Proper heading hierarchy and semantic elements
- *
- * @example
- * ```tsx
- * // Basic card with semantic HTML structure
- * <Card>
- *   <CardHeader>
- *     <CardTitle>Article Title</CardTitle>
- *     <CardDescription>Brief description of the article content</CardDescription>
- *   </CardHeader>
- *   <CardContent>
- *     <p>Main content goes here with proper semantic structure.</p>
- *     <p>Additional paragraphs and content.</p>
- *   </CardContent>
- *   <CardFooter>
- *     <CardActions>
- *       <Button>Primary Action</Button>
- *       <Button variant="outline">Secondary Action</Button>
- *     </CardActions>
- *   </CardFooter>
- * </Card>
- *
- * // Semantic HTML structure:
- * // - Card: <article> element for self-contained content
- * // - CardHeader: <header> element for card heading area
- * // - CardContent: <main> element for primary card content
- * // - CardFooter: <footer> element for card footer area
- * // - CardActions: <nav> element for action buttons
- *
- * // HoverCard usage with semantic structure
- * <HoverCard>
- *   <HoverCardTrigger>Hover me</HoverCardTrigger>
- *   <HoverCardContent>
- *     <p>Popover content with semantic elements</p>
- *   </HoverCardContent>
- * </HoverCard>
- * ```
- *
- * @accessibility
- * - Uses semantic HTML structure (article, header, main, footer, nav)
- * - Focusable and keyboard accessible
- * - Proper heading hierarchy for screen readers
- * - HoverCard supports mouse and keyboard interaction
- * - 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';
-    /** 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$1.ForwardRefExoticComponent<CardProps & React$1.RefAttributes<HTMLElement>>;
-declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
-declare const CardTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const CardDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const CardContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
-declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
-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
-     */
-    variant?: 'default' | 'destructive';
-    /**
-     * Input size
-     */
-    size?: 'sm' | 'md' | 'lg';
-    /**
-     * Error state for styling
-     */
-    error?: boolean;
-}
-/**
- * Input component
- * A flexible, accessible input component with multiple variants and sizes
- *
- * @param props - Input configuration and styling
- * @param ref - Forwarded ref to the input element
- * @returns JSX.Element - The rendered input element
- *
- * @example
- * ```tsx
- * // Basic input
- * <Input placeholder="Enter your name" />
- *
- * // Input with error state
- * <Input
- *   placeholder="Email"
- *   type="email"
- *   error={true}
- * />
- *
- * // Large input with destructive variant
- * <Input
- *   variant="destructive"
- *   size="lg"
- *   placeholder="Error input"
- * />
- * ```
- */
-declare function Input({ className, variant, size, error, type, ref, ...props }: InputProps & {
-    ref?: React$1.Ref<HTMLInputElement>;
-}): react_jsx_runtime.JSX.Element;
-declare namespace Input {
-    var displayName: string;
-}
-
-/**
- * @file AddressField Component Types
- * @package @jmruthers/pace-core
- * @module Components/AddressField
- * @since 0.1.0
- */
-
-/**
- * Props for AddressField component
- */
-interface AddressFieldProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'defaultValue' | 'size'> {
-    /** Google Places API key (required) */
-    apiKey: string;
-    /** Controlled input value */
-    value?: string;
-    /** Uncontrolled default value */
-    defaultValue?: string;
-    /** Callback when address is selected */
-    onChange?: (address: ParsedAddress | null) => void;
-    /** Callback when input value changes */
-    onInputChange?: (value: string) => void;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Error state styling */
-    error?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Input size */
-    size?: 'sm' | 'md' | 'lg';
-    /** Input variant */
-    variant?: 'default' | 'destructive';
-    /** Google Places API autocomplete options */
-    autocompleteOptions?: AutocompleteOptions;
-    /** Debounce delay in milliseconds */
-    debounceDelay?: number;
-    /** Enable caching (default: true) */
-    cacheEnabled?: boolean;
-    /** Cache TTL configuration */
-    cacheTTL?: {
-        /** Autocomplete cache TTL in seconds */
-        autocomplete?: number;
-        /** Place details cache TTL in seconds */
-        placeDetails?: number;
-    };
-}
-/**
- * Ref type for AddressField component
- */
-interface AddressFieldRef {
-    /** Focus the input */
-    focus: () => void;
-    /** Blur the input */
-    blur: () => void;
-    /** Get current input value */
-    getValue: () => string;
-    /** Clear the input and suggestions */
-    clear: () => void;
-}
-
-/**
- * @file AddressField Component
- * @package @jmruthers/pace-core
- * @module Components/AddressField
- * @since 0.1.0
- *
- * Address input field with Google Places API autocomplete.
- * Provides address suggestions, keyboard navigation, and accessibility.
- *
- * Features:
- * - Google Places API autocomplete integration
- * - Debounced input with caching
- * - Keyboard navigation (Arrow keys, Enter, Escape)
- * - Accessible ARIA attributes
- * - Semantic HTML (description list for suggestions)
- * - Loading and error states
- * - place_id storage for later retrieval
- *
- * @accessibility
- * - Uses semantic HTML: `<dl>`, `<dt>`, `<dd>` for address suggestions
- * - Proper ARIA attributes for combobox pattern
- * - Keyboard navigation support
- * - Screen reader friendly
- */
-
-/**
- * AddressField component
- *
- * A production-ready address input field with Google Places API autocomplete.
- * Returns structured address data including place_id for later retrieval.
- *
- * @param props - AddressField configuration
- * @param ref - Forwarded ref for imperative access
- * @returns JSX.Element - The rendered address field
- *
- * @example
- * ```tsx
- * <AddressField
- *   apiKey={apiKey}
- *   onChange={(address) => {
- *     // address includes place_id, full_address, lat, lng, etc.
- *     console.log(address.place_id);
- *   }}
- *   placeholder="Enter your address"
- * />
- * ```
- */
-declare const AddressField: React$1.ForwardRefExoticComponent<AddressFieldProps & React$1.RefAttributes<HTMLInputElement>>;
-
-/**
- * @file Label Component
- * @package @jmruthers/pace-core
- * @module Components/Label
- * @since 0.1.0
- *
- * An accessible label component built on top of Radix UI primitives.
- * Provides form labels with helper text, error states, and required indicators.
- *
- * Features:
- * - Proper label association with form controls
- * - Required field indicators
- * - Helper text support
- * - Error state display
- * - Customizable styling
- * - Screen reader friendly
- * - Keyboard accessible
- *
- * @example
- * ```tsx
- * // Basic label
- * <Label htmlFor="email">Email Address</Label>
- * <Input id="email" type="email" />
- *
- * // Label with required indicator
- * <Label htmlFor="name" required>
- *   Full Name
- * </Label>
- * <Input id="name" />
- *
- * // Label with helper text
- * <Label
- *   htmlFor="password"
- *   required
- *   helperText="Must be at least 8 characters"
- * >
- *   Password
- * </Label>
- * <Input id="password" type="password" />
- *
- * // Label with error state
- * <Label
- *   htmlFor="email"
- *   error="Please enter a valid email address"
- * >
- *   Email Address
- * </Label>
- * <Input id="email" type="email" />
- *
- * // Custom required indicator
- * <Label
- *   htmlFor="terms"
- *   required
- *   requiredIndicator="(required)"
- * >
- *   Accept Terms
- * </Label>
- * <Checkbox id="terms" />
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper label association with htmlFor
- * - Screen reader announcements for errors
- * - Required field indicators for screen readers
- * - Error messages with role="alert"
- * - High contrast support
- *
- * @dependencies
- * - @radix-ui/react-label - Core label functionality
- * - React 19+ - Hooks and refs
- * - Tailwind CSS - Styling
- */
-
-/**
- * Props for the Label component
- */
-interface LabelProps extends React$1.ComponentPropsWithoutRef<typeof LabelPrimitive.Root> {
-    /** Whether the field is required */
-    required?: boolean;
-    /** Custom required indicator (default: '*') */
-    requiredIndicator?: React$1.ReactNode;
-    /** Whether to hide the required indicator visually */
-    hideRequiredIndicator?: boolean;
-    /** Helper text to display below the label */
-    helperText?: string;
-    /** CSS classes for helper text styling */
-    helperTextClassName?: string;
-    /** Error message to display */
-    error?: string;
-    /** CSS classes for error message styling */
-    errorClassName?: string;
-}
-/**
- * Label component
- * An accessible label with helper text and error state support
- *
- * @param props - Label configuration and styling
- * @param ref - Forwarded ref to the label element
- * @returns JSX.Element - The rendered label with optional helper text and errors
- *
- * @example
- * ```tsx
- * <Label htmlFor="email" required helperText="We'll never share your email">
- *   Email Address
- * </Label>
- * ```
- */
-declare const Label: React$1.ForwardRefExoticComponent<LabelProps & React$1.RefAttributes<HTMLLabelElement>>;
-
-interface TextareaProps extends React$1.TextareaHTMLAttributes<HTMLTextAreaElement> {
-    /**
-     * Textarea variant style
-     */
-    variant?: 'default' | 'destructive';
-    /**
-     * Textarea size
-     */
-    size?: 'sm' | 'md' | 'lg';
-    /**
-     * Error state for styling
-     */
-    error?: boolean;
-}
-/**
- * Textarea component
- * A flexible, accessible textarea component with multiple variants and sizes.
- * Matches the Input component API and styling for consistency.
- *
- * @param props - Textarea configuration and styling
- * @param ref - Forwarded ref to the textarea element
- * @returns JSX.Element - The rendered textarea element
- *
- * @example
- * ```tsx
- * // Basic textarea
- * <Textarea placeholder="Enter your message..." />
- *
- * // Textarea with error state
- * <Textarea
- *   placeholder="Comments"
- *   error={true}
- * />
- *
- * // Large textarea with destructive variant
- * <Textarea
- *   variant="destructive"
- *   size="lg"
- *   placeholder="Error textarea"
- * />
- * ```
- */
-declare function Textarea({ className, variant, size, error, ref, ...props }: TextareaProps & {
-    ref?: React$1.Ref<HTMLTextAreaElement>;
-}): react_jsx_runtime.JSX.Element;
-declare namespace Textarea {
-    var displayName: string;
-}
-
-/**
- * @file Alert Component Suite
- * @package @jmruthers/pace-core
- * @module Components
- * @since 0.1.0
- *
- * A flexible and accessible alert component for displaying important messages.
- * Includes Alert, AlertTitle, and AlertDescription subcomponents.
- *
- * Features:
- * - Multiple visual variants (default, destructive, inline)
- * - Title and description support
- * - Semantic HTML: renders as `<p>` element with `role="alert"` (default) or custom role
- * - Keyboard and screen reader accessible
- * - Composable with icons and actions
- * - Inline variant for lightweight text formatting
- *
- * @example
- * ```tsx
- * // Basic alert (renders as <p role="alert"> with <h5> title and <p> description)
- * <Alert>
- *   <AlertTitle>Success</AlertTitle>
- *   <AlertDescription>Your changes have been saved.</AlertDescription>
- * </Alert>
- *
- * // Destructive alert with icon (renders as <p role="alert"> with <h5> title and <p> description)
- * <Alert variant="destructive">
- *   <ErrorIcon />
- *   <AlertTitle>Error</AlertTitle>
- *   <AlertDescription>Something went wrong.</AlertDescription>
- * </Alert>
- *
- * // Status message (renders as <p role="status"> for informational messages)
- * <Alert role="status" aria-live="polite">
- *   <AlertTitle>No data available</AlertTitle>
- *   <AlertDescription>Get started by adding your first entry.</AlertDescription>
- * </Alert>
- *
- * // 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>
- * </Alert>
- * ```
- *
- * @accessibility
- * - Uses semantic HTML: `<p>` element with `role="alert"` (default) for screen reader announcements
- * - Can be customized with `role="status"` for informational messages
- * - Title and description are semantically structured
- * - Supports keyboard navigation and focus
- */
-
-declare const Alert: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & {
-    variant?: "default" | "destructive" | "inline";
-    role?: string;
-} & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const AlertTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const AlertDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-
-/**
- * @file Avatar Component
- * @package @jmruthers/pace-core
- * @module Components
- * @since 0.1.0
- *
- * A simple and accessible avatar component for displaying user profile images or initials.
- * Supports three approaches for image display:
- * - File reference props (uses FileDisplay for Supabase storage)
- * - File ID (uses file reference lookup)
- * - Direct URL (simple img tag for public images)
- *
- * Features:
- * - Circular avatar display
- * - Image, fallback, and initials support
- * - Customizable size and style
- * - Keyboard and screen reader accessible
- * - Graceful fallback for missing images
- *
- * @example
- * ```tsx
- * // Avatar with direct URL
- * <Avatar
- *   src="/user.jpg"
- *   alt="User"
- *   fallback="AB"
- * />
- *
- * // Avatar with file reference props
- * <Avatar
- *   table_name="user_profiles"
- *   record_id={userId}
- *   organisation_id={orgId}
- *   category={FileCategory.PROFILE_PHOTOS}
- *   fallback="JD"
- * />
- *
- * // Avatar with file ID
- * <Avatar
- *   fileId={fileReferenceId}
- *   organisation_id={orgId}
- *   fallback="JD"
- * />
- *
- * // Avatar with fallback only
- * <Avatar fallback="JD" />
- * ```
- *
- * @accessibility
- * - Uses alt text for images
- * - Fallback content is accessible to screen readers
- * - Keyboard focusable and navigable
- */
-
-interface AvatarProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    table_name?: string;
-    record_id?: string;
-    organisation_id?: string;
-    category?: FileCategory;
-    fileId?: string;
-    src?: string;
-    alt?: string;
-    fallback: string;
-    className?: string;
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-}
-/**
- * Avatar component for displaying user profile images or initials
- */
-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;
-}
-/**
- * Badge Component
- * A small, non-interactive visual label for displaying concise information.
- *
- * @component
- * @example
- * ```tsx
- * // Default variant
- * <Badge>New</Badge>
- *
- * // Specific variant
- * <Badge variant="solid-main-normal">Active</Badge>
- *
- * // Outline variant
- * <Badge variant="outline-sec-muted">Pending</Badge>
- *
- * // Soft variant
- * <Badge variant="soft-acc-strong">Featured</Badge>
- * ```
- */
-declare function Badge({ className, variant, ref, ...props }: BadgeProps & {
-    ref?: React$1.Ref<HTMLSpanElement>;
-}): react_jsx_runtime.JSX.Element;
-declare namespace Badge {
-    var displayName: string;
-}
-
-/**
- * @file Checkbox Component
- * @package @jmruthers/pace-core
- * @module Components
- * @since 0.1.0
- *
- * An accessible checkbox component built on top of Radix UI's Checkbox primitive.
- * Provides a customizable checkbox input with proper keyboard and screen reader support.
- *
- * Features:
- * - Customizable styling via className
- * - Built-in focus and hover states
- * - Disabled state support
- * - Checked state indicator
- * - Full keyboard navigation
- * - Screen reader support
- *
- * @example
- * ```tsx
- * // Basic usage
- * <Checkbox />
- *
- * // With label
- * <>
- *   <Checkbox id="terms" />
- *   <label htmlFor="terms">Accept terms and conditions</label>
- * </>
- *
- * // Disabled state
- * <Checkbox disabled />
- *
- * // Controlled component
- * const [checked, setChecked] = React.useState(false);
- * <Checkbox
- *   checked={checked}
- *   onCheckedChange={setChecked}
- * />
- * ```
- *
- * @accessibility
- * - Uses Radix UI's accessible checkbox primitive
- * - Proper keyboard navigation (Space to toggle)
- * - Screen reader announcements for state changes
- * - Focus visible styles for keyboard users
- * - ARIA attributes handled automatically
- */
-
-declare const Checkbox: React$1.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
-
-/**
- * @file Switch Component
- * @package @jmruthers/pace-core
- * @module Components/Switch
- * @since 0.5.67
- *
- * A toggle switch component built on Radix UI primitives.
- * Provides an accessible, keyboard-navigable switch for boolean states.
- *
- * Features:
- * - WCAG 2.1 AA compliant
- * - Keyboard navigation (Space/Enter)
- * - Focus visible indicators
- * - Disabled state support
- * - Smooth animations
- * - Tailwind v4 compatible
- * - Theme-aware colors
- *
- * @example
- * ```tsx
- * import { Switch } from '@jmruthers/pace-core';
- *
- * function Example() {
- *   const [checked, setChecked] = React.useState(false);
- *
- *   return (
- *     <>
- *       <Switch
- *         checked={checked}
- *         onCheckedChange={setChecked}
- *         id="notifications"
- *       />
- *       <label htmlFor="notifications">
- *         Enable notifications
- *       </label>
- *     </>
- *   );
- * }
- * ```
- *
- * @example With Form
- * ```tsx
- * import { Switch, Label } from '@jmruthers/pace-core';
- *
- * function FormExample() {
- *   return (
- *     <>
- *       <Switch id="terms" />
- *       <Label htmlFor="terms">
- *         I agree to the terms and conditions
- *       </Label>
- *     </>
- *   );
- * }
- * ```
- *
- * @example Disabled State
- * ```tsx
- * <Switch disabled checked />
- * ```
- *
- * @accessibility
- * - Uses Radix UI's accessible switch primitive
- * - Proper keyboard navigation (Space to toggle)
- * - Screen reader announcements for state changes
- * - Focus visible styles for keyboard users
- * - ARIA attributes handled automatically
- */
-
-/**
- * Switch component props
- * Extends all props from Radix UI Switch.Root
- */
-interface SwitchProps extends React$1.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root> {
-    /**
-     * Additional CSS classes to apply to the switch
-     */
-    className?: string;
-}
-/**
- * Switch component
- *
- * A toggle switch for boolean states. Built on Radix UI for accessibility.
- *
- * @component
- * @example
- * ```tsx
- * <Switch checked={isEnabled} onCheckedChange={setIsEnabled} />
- * ```
- */
-declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.RefAttributes<HTMLButtonElement>>;
-
-/**
- * @file Progress Component
- * @package @jmruthers/pace-core
- * @module Components/Progress
- * @since 0.1.0
- *
- * An accessible progress bar component built on the native HTML `<progress>` element.
- * Provides smooth animations and proper ARIA attributes for screen readers.
- *
- * Features:
- * - Smooth progress animations
- * - Customizable value and max range
- * - Native accessibility support (role="progressbar" automatically applied)
- * - Customizable styling and appearance
- * - Responsive design
- * - Indeterminate state support
- *
- * @example
- * ```tsx
- * // Basic progress bar
- * <Progress value={50} />
- *
- * // Progress with custom max value
- * <Progress value={7} max={10} />
- *
- * // Progress with custom styling
- * <Progress
- *   value={75}
- *   className="h-4 bg-sec-200"
- * />
- *
- * // Animated progress (controlled)
- * const [progress, setProgress] = useState(0);
- *
- * useEffect(() => {
- *   const timer = setInterval(() => {
- *     setProgress(prev => prev >= 100 ? 0 : prev + 10);
- *   }, 1000);
- *   return () => clearInterval(timer);
- * }, []);
- *
- * <Progress value={progress} />
- *
- * // Indeterminate progress (no value)
- * <Progress />
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Native `<progress>` element provides role="progressbar" automatically
- * - Screen reader announcements for progress changes
- * - High contrast support
- *
- * @performance
- * - CSS transitions for smooth animations
- * - Efficient re-rendering
- * - Minimal DOM structure (native HTML element)
- *
- * @dependencies
- * - React 19+ - Hooks and refs
- * - Tailwind CSS - Styling
- */
-
-/**
- * Props for the Progress component
- */
-interface ProgressProps extends React$1.HTMLAttributes<HTMLProgressElement> {
-    /** Current progress value (0 to max). Omit for indeterminate state. */
-    value?: number;
-    /** Maximum progress value (default: 100) */
-    max?: number;
-}
-/**
- * Progress component
- * An accessible progress bar with smooth animations using native HTML `<progress>` element
- *
- * @param props - Progress configuration and styling
- * @param ref - Forwarded ref to the progress element
- * @returns JSX.Element - The rendered progress bar
- *
- * @example
- * ```tsx
- * <Progress value={75} max={100} />
- * ```
- */
-declare const Progress: React$1.ForwardRefExoticComponent<ProgressProps & React$1.RefAttributes<HTMLProgressElement>>;
-
-/**
- * Dialog size variants
- * @public
- */
-type DialogSize = 'sm' | 'md' | 'lg' | 'xl' | 'full' | 'auto';
-/**
- * Props for the Dialog root component
- * @public
- */
-interface DialogProps {
-    children: React$1.ReactNode;
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-}
-/**
- * Props for the DialogTrigger component
- * @public
- */
-interface DialogTriggerProps {
-    children: React$1.ReactNode;
-    asChild?: boolean;
-    className?: string;
-    onClick?: (e: React$1.MouseEvent) => void;
-}
-/**
- * Enhanced props for the DialogContent component with size variants and customization
- * Uses semantic HTML dialog element
- * @public
- */
-interface DialogContentProps extends React$1.HTMLAttributes<HTMLDialogElement> {
-    /** Dialog size variant */
-    size?: DialogSize;
-    /** Whether to show the close button */
-    showCloseButton?: boolean;
-    /** Whether to prevent closing on escape key */
-    preventCloseOnEscape?: boolean;
-    /** Whether to prevent closing on outside click */
-    preventCloseOnOutsideClick?: boolean;
-    /** Maximum height as percentage of viewport height (0-100) */
-    maxHeightPercent?: number;
-    /** Maximum width as percentage of viewport width (0-100) */
-    maxWidthPercent?: number;
-    /** Enable smart scrolling with sticky header/footer */
-    enableScrolling?: boolean;
-    /** Custom max height in CSS units (overrides maxHeightPercent) */
-    maxHeight?: string;
-    /** Custom max width in CSS units (overrides maxWidthPercent and size) */
-    maxWidth?: string;
-    /** Minimum height in CSS units */
-    minHeight?: string;
-    /** Minimum width in CSS units */
-    minWidth?: string;
-    /** Dialog title - sets native title attribute and aria-labelledby */
-    title?: string;
-    /** Dialog description - sets native aria-description attribute */
-    description?: string;
-    /** Whether to persist open state across tab switches */
-    persistOpenState?: boolean;
-}
-/**
- * Props for the DialogPortal component
- * @public
- */
-interface DialogPortalProps {
-    children: React$1.ReactNode;
-}
-/**
- * Props for the DialogHeader component (semantic header element)
- * @public
- */
-interface DialogHeaderProps extends React$1.HTMLAttributes<HTMLElement> {
-    /** Whether this header should be sticky when scrolling is enabled */
-    sticky?: boolean;
-}
-/**
- * Props for the DialogFooter component (semantic footer element)
- * @public
- */
-interface DialogFooterProps extends React$1.HTMLAttributes<HTMLElement> {
-    /** Whether this footer should be sticky when scrolling is enabled */
-    sticky?: boolean;
-}
-/**
- * Props for the DialogBody component (semantic main element)
- * @public
- */
-interface DialogBodyProps extends React$1.HTMLAttributes<HTMLElement> {
-    /** Custom max height for the scrollable area */
-    maxHeight?: string;
-    /** HTML content to render (will be sanitized for security) */
-    htmlContent?: string;
-    /** Whether to allow HTML content rendering (default: true) */
-    allowHtml?: boolean;
-    /** Whether to use strict HTML sanitization (default: true) */
-    strictSanitization?: boolean;
-    /** Whether to log HTML sanitization warnings to console (default: false) */
-    logWarnings?: boolean;
-}
-/**
- * Props for the DialogTitle component
- * @public
- */
-interface DialogTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
-    /** HTML content to render as title (will be sanitized for security) */
-    htmlContent?: string;
-    /** Whether to allow HTML content rendering (default: true) */
-    allowHtml?: boolean;
-}
-/**
- * Props for the DialogDescription component
- * @public
- */
-interface DialogDescriptionProps extends React$1.HTMLAttributes<HTMLParagraphElement> {
-    /** HTML content to render as description (will be sanitized for security) */
-    htmlContent?: string;
-    /** Whether to allow HTML content rendering (default: true) */
-    allowHtml?: boolean;
-}
-/**
- * Dialog root component
- * Provides context for dialog state management
- */
-declare const Dialog: React$1.NamedExoticComponent<DialogProps>;
-/**
- * DialogTrigger component
- * Opens the dialog when clicked
- */
-declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogTriggerProps & React$1.RefAttributes<HTMLElement>>;
-/**
- * DialogPortal component
- * Portals dialog content to document.body
- */
-declare const DialogPortal: React$1.FC<DialogPortalProps>;
-/**
- * DialogContent component
- * The main content container using semantic HTML <dialog> element with enhanced features
- *
- * @param props - Content configuration and styling
- * @param ref - Forwarded ref to the dialog element
- * @returns JSX.Element - The semantic dialog content with overlay and optional close button
- */
-declare const DialogContent: React$1.ForwardRefExoticComponent<DialogContentProps & React$1.RefAttributes<HTMLDialogElement>>;
-/**
- * Props for the DialogClose component
- * @public
- */
-interface DialogCloseProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
-}
-/**
- * Props for the DialogClose component
- * @public
- */
-interface DialogCloseProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
-    /** Whether to merge props with child element instead of rendering a button */
-    asChild?: boolean;
-}
-/**
- * DialogClose component
- * Button to close the dialog
- */
-declare const DialogClose: React$1.ForwardRefExoticComponent<DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
-/**
- * DialogHeader component
- * Semantic header container for dialog title and description with optional sticky behavior
- */
-declare const DialogHeader: {
-    ({ className, sticky, ...props }: DialogHeaderProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-/**
- * DialogBody component
- * Semantic main content area for dialog body content with scrollable functionality
- */
-declare const DialogBody: {
-    ({ className, maxHeight, style, htmlContent, allowHtml, strictSanitization, logWarnings, children, ...props }: DialogBodyProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-/**
- * DialogFooter component
- * Semantic footer container for dialog action buttons with optional sticky behavior
- */
-declare const DialogFooter: {
-    ({ className, sticky, ...props }: DialogFooterProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-/**
- * DialogTitle component
- * Title element with ARIA support
- */
-declare const DialogTitle: React$1.ForwardRefExoticComponent<DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
-/**
- * DialogDescription component
- * Description element with ARIA support
- */
-declare const DialogDescription: React$1.ForwardRefExoticComponent<DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
-
-/**
- * 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;
-    selectedText?: string;
-    open?: boolean;
-    defaultOpen?: boolean;
-    disabled?: boolean;
-    onValueChange?: (value: string) => void;
-    onOpenChange?: (open: boolean) => void;
-}
-/**
- * Props for the Select root component.
- */
-interface SelectProps extends Omit<React$1.HTMLAttributes<HTMLFieldSetElement>, "onChange" | "onKeyDown" | "onFocus" | "onBlur"> {
-    children: React$1.ReactNode;
-    className?: string;
-    direction?: SelectDirection;
-    showCheckmark?: boolean;
-}
-/**
- * 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;
-    searchable?: boolean;
-    searchPlaceholder?: string;
-    maxHeight?: string;
-    style?: React$1.CSSProperties;
-}
-/**
- * Props for the SelectItem component.
- */
-interface SelectItemProps {
-    value: string;
-    children: React$1.ReactNode;
-    disabled?: boolean;
-    className?: string;
-    onClick?: (e: React$1.MouseEvent) => void;
-    showCheckmark?: boolean;
-}
-
-/**
- * @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 fieldset element
- * @returns The rendered select component
- */
-declare const Select: React$1.ForwardRefExoticComponent<SelectProps & UseSelectStateProps & React$1.RefAttributes<HTMLFieldSetElement>>;
-/**
- * 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 using a nested list structure.
- *
- * @param props - Select group configuration
- * @param ref - Forwarded ref to the ul element
- * @returns The rendered select group
- */
-declare const SelectGroup: React$1.ForwardRefExoticComponent<{
-    children: React$1.ReactNode;
-    className?: string;
-} & React$1.RefAttributes<HTMLUListElement>>;
-/**
- * Select label component.
- * Provides a label for a group of select items.
- *
- * @param props - Select label configuration
- * @param ref - Forwarded ref to the li element
- * @returns The rendered select label
- */
-declare const SelectLabel: React$1.ForwardRefExoticComponent<{
-    children: React$1.ReactNode;
-    className?: string;
-} & React$1.RefAttributes<HTMLLIElement>>;
-/**
- * Select separator component.
- * Provides visual separation between groups of select items.
- *
- * @param props - Select separator configuration
- * @param ref - Forwarded ref to the hr element
- * @returns The rendered select separator
- */
-declare const SelectSeparator: React$1.ForwardRefExoticComponent<{
-    className?: string;
-} & React$1.RefAttributes<HTMLHRElement>>;
-
-/**
- * @file Tabs Component System
- * @package @jmruthers/pace-core
- * @module Components/Tabs
- * @since 0.5.141
- *
- * A comprehensive tabs component system built on top of Radix UI primitives.
- * Provides accessible tabbed interfaces with keyboard navigation and ARIA support.
- *
- * Features:
- * - Controlled and uncontrolled modes
- * - Keyboard navigation (arrow keys)
- * - Accessible ARIA attributes
- * - Customizable styling via className
- * - Support for icons in triggers
- * - Compound component pattern
- *
- * @example
- * ```tsx
- * // Basic tabs
- * <Tabs defaultValue="tab1">
- *   <TabsList>
- *     <TabsTrigger value="tab1">Tab 1</TabsTrigger>
- *     <TabsTrigger value="tab2">Tab 2</TabsTrigger>
- *   </TabsList>
- *   <TabsContent value="tab1">Content 1</TabsContent>
- *   <TabsContent value="tab2">Content 2</TabsContent>
- * </Tabs>
- *
- * // Controlled tabs
- * <Tabs value={activeTab} onValueChange={setActiveTab}>
- *   <TabsList>
- *     <TabsTrigger value="transport">
- *       <Plane size={16} /> Transport
- *     </TabsTrigger>
- *     <TabsTrigger value="accommodation">
- *       <Building size={16} /> Accommodation
- *     </TabsTrigger>
- *   </TabsList>
- *   <TabsContent value="transport">
- *     <TransportPlanningView />
- *   </TabsContent>
- *   <TabsContent value="accommodation">
- *     <AccommodationPlanningView />
- *   </TabsContent>
- * </Tabs>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Keyboard navigation (Arrow keys, Home, End)
- * - Screen reader support with proper ARIA attributes
- * - Focus management
- * - Tab panel association
- */
-
-interface TabsProps extends TabsPrimitive.TabsProps {
-}
-/**
- * Tabs root component
- * Provides the context for tab navigation and state management
- *
- * @component
- * @example
- * ```tsx
- * <Tabs defaultValue="tab1">
- *   <TabsList>...</TabsList>
- *   <TabsContent value="tab1">...</TabsContent>
- * </Tabs>
- * ```
- */
-declare const Tabs: React$1.ForwardRefExoticComponent<TabsProps & React$1.RefAttributes<HTMLDivElement>>;
-interface TabsListProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrimitive.List> {
-}
-/**
- * TabsList component
- * Container for tab triggers
- *
- * @component
- * @example
- * ```tsx
- * <TabsList>
- *   <TabsTrigger value="tab1">Tab 1</TabsTrigger>
- *   <TabsTrigger value="tab2">Tab 2</TabsTrigger>
- * </TabsList>
- * ```
- */
-declare const TabsList: React$1.ForwardRefExoticComponent<TabsListProps & React$1.RefAttributes<HTMLDivElement>>;
-interface TabsTriggerProps extends Omit<React$1.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
- * <TabsTrigger value="tab1">Tab 1</TabsTrigger>
- *
- * // With icon
- * <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$1.ForwardRefExoticComponent<TabsTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
-interface TabsContentProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrimitive.Content> {
-}
-/**
- * TabsContent component
- * Container for tab panel content
- *
- * @component
- * @example
- * ```tsx
- * <TabsContent value="tab1">
- *   <section>Content for tab 1</section>
- * </TabsContent>
- * ```
- */
-declare const TabsContent: React$1.ForwardRefExoticComponent<TabsContentProps & React$1.RefAttributes<HTMLDivElement>>;
-
-/**
- * @file Calendar Component
- * @package @jmruthers/pace-core
- * @module Components/Calendar
- * @since 0.5.141
- *
- * A date picker calendar component built on react-day-picker.
- * Provides accessible date selection with keyboard navigation and ARIA support.
- *
- * Features:
- * - Single, range, and multiple date selection modes
- * - Date disabling (past dates, weekends, etc.)
- * - Localization support (defaults to Australian locale with Monday as first day of week)
- * - Keyboard navigation
- * - Accessible date selection
- * - Customizable styling
- *
- * @example
- * ```tsx
- * // Single date selection
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- * />
- *
- * // Date range selection
- * <Calendar
- *   mode="range"
- *   selected={dateRange}
- *   onSelect={setDateRange}
- * />
- *
- * // Multiple date selection
- * <Calendar
- *   mode="multiple"
- *   selected={dates}
- *   onSelect={setDates}
- * />
- *
- * // With disabled dates
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- *   disabled={(date) => date < new Date()}
- * />
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Keyboard navigation (Arrow keys, Page Up/Down, Home, End)
- * - Screen reader support with proper ARIA attributes
- * - Focus management
- * - 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
-     */
-    className?: string;
-    /**
-     * Custom classNames for DayPicker sub-components
-     */
-    classNames?: DayPickerProps['classNames'];
-    /**
-     * Currently selected value; mirrors DayPicker's `selected` prop so callers
-     * can control the selection state.
-     */
-    selected?: Date | Date[] | DateRange | undefined;
-    /**
-     * Date selection handler. Signature depends on mode:
-     * - mode="single": (date: Date | undefined) => void
-     * - mode="range": (range: { from: Date; to?: Date } | undefined) => void
-     * - mode="multiple": (dates: Date[]) => void
-     */
-    onSelect?: ((date: Date | undefined) => void) | ((range: {
-        from: Date;
-        to?: Date;
-    } | undefined) => void) | ((dates: Date[]) => void);
-}
-/**
- * Calendar component
- * A flexible, accessible calendar component for date selection.
- * Built on react-day-picker with pace-core styling.
- *
- * Defaults to Australian locale (en-AU) with Monday as the first day of the week.
- * The locale can be overridden by passing a `locale` prop.
- *
- * Month navigation is automatically managed internally when `month` and `onMonthChange` props
- * are not provided. The displayed month will sync with the selected date when available,
- * or default to the current month. Navigation buttons (prev/next) work automatically.
- *
- * For controlled month state, pass `month` and `onMonthChange` props.
- *
- * @param props - Calendar configuration and styling
- * @param ref - Forwarded ref (not used directly, but maintained for API consistency)
- * @returns JSX.Element - The rendered calendar element
- *
- * @example
- * ```tsx
- * // Single date selection (uses default Australian locale)
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- * />
- *
- * // With disabled dates
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- *   disabled={(date) => date < new Date()}
- * />
- *
- * // Override locale (e.g., US locale with Sunday as first day)
- * import { enUS } from 'date-fns/locale';
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- *   locale={enUS}
- * />
- *
- * // Controlled month state (optional - month is auto-managed if not provided)
- * const [month, setMonth] = useState(new Date());
- * <Calendar
- *   mode="single"
- *   selected={date}
- *   onSelect={setDate}
- *   month={month}
- *   onMonthChange={setMonth}
- * />
- * ```
- */
-declare const Calendar: React$1.ForwardRefExoticComponent<CalendarProps & React$1.RefAttributes<HTMLTableElement>>;
-
-declare const ToastProvider: React$1.FC<ToastPrimitives.ToastProviderProps>;
-/**
- * ToastViewport component
- * Container for all toast notifications with customizable positioning
- *
- * @param props - Viewport configuration and styling
- * @param ref - Forwarded ref to the viewport element
- * @returns JSX.Element - The toast viewport container
- */
-declare const ToastViewport: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastViewportProps & React$1.RefAttributes<HTMLOListElement>, "ref"> & React$1.RefAttributes<HTMLOListElement>>;
-/**
- * Toast component
- * The main toast notification component with animations and interactions
- *
- * @param props - Toast configuration and content
- * @param ref - Forwarded ref to the toast element
- * @returns JSX.Element - The rendered toast notification
- *
- * @example
- * ```tsx
- * <Toast>
- *   <ToastTitle>Success!</ToastTitle>
- *   <ToastDescription>Your changes have been saved.</ToastDescription>
- *   <ToastClose />
- * </Toast>
- * ```
- */
-declare const Toast: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastProps & React$1.RefAttributes<HTMLLIElement>, "ref"> & React$1.RefAttributes<HTMLLIElement>>;
-/**
- * ToastAction component
- * Action button within a toast notification
- *
- * @param props - Action button configuration
- * @param ref - Forwarded ref to the action button
- * @returns JSX.Element - The action button element
- *
- * @example
- * ```tsx
- * <ToastAction altText="Undo changes">Undo</ToastAction>
- * ```
- */
-declare const ToastAction: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastActionProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
-/**
- * ToastClose component
- * Close button for dismissing toast notifications
- *
- * @param props - Close button configuration
- * @param ref - Forwarded ref to the close button
- * @returns JSX.Element - The close button with X icon
- *
- * @example
- * ```tsx
- * <ToastClose />
- * ```
- */
-declare const ToastClose: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastCloseProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
-/**
- * ToastTitle component
- * Title text for toast notifications
- *
- * @param props - Title configuration and styling
- * @param ref - Forwarded ref to the title element
- * @returns JSX.Element - The toast title
- *
- * @example
- * ```tsx
- * <ToastTitle>Success!</ToastTitle>
- * ```
- */
-declare const ToastTitle: React$1.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastTitleProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-/**
- * ToastDescription component
- * Description text for toast notifications
- *
- * @param props - Description configuration and styling
- * @param ref - Forwarded ref to the description element
- * @returns JSX.Element - The toast description
- *
- * @example
- * ```tsx
- * <ToastDescription>Your changes have been saved successfully.</ToastDescription>
- * ```
- */
-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> {
-}
-/**
- * Toaster component
- * Container component that renders actual toast notifications
- * Should be placed at the root of your application
- *
- * @returns JSX.Element - The toast provider with viewport and rendered toasts
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <ToastProvider>
- *       <YourApp />
- *       <Toaster />
- *     </ToastProvider>
- *   );
- * }
- * ```
- */
-declare function Toaster(): react_jsx_runtime.JSX.Element;
-
-/**
- * @file Tooltip Component System
- * @package @jmruthers/pace-core
- * @module Components/Tooltip
- * @since 0.1.0
- *
- * A comprehensive tooltip component system built on top of Radix UI primitives.
- * Provides accessible tooltips with customizable positioning and animations.
- *
- * Features:
- * - Multiple positioning options (top, bottom, left, right)
- * - Customizable delay duration
- * - Smooth animations and transitions
- * - Keyboard and mouse interaction
- * - Screen reader support
- * - Responsive design
- * - Customizable styling
- * - Focus management
- *
- * @example
- * ```tsx
- * // Basic tooltip
- * <Tooltip content="This is a helpful tooltip">
- *   <Button>Hover me</Button>
- * </Tooltip>
- *
- * // Tooltip with custom delay
- * <Tooltip content="Custom delay" delayDuration={500}>
- *   <IconButton icon={<Info />} />
- * </Tooltip>
- *
- * // Advanced tooltip with custom content
- * <TooltipProvider>
- *   <TooltipRoot>
- *     <TooltipTrigger asChild>
- *       <Button>Advanced Tooltip</Button>
- *     </TooltipTrigger>
- *     <TooltipContent side="top" className="bg-main-500 text-main-50">
- *       <section className="space-y-1">
- *         <p className="font-semibold">Advanced Tooltip</p>
- *         <p className="text-xs">With custom styling</p>
- *       </section>
- *     </TooltipContent>
- *   </TooltipRoot>
- * </TooltipProvider>
- *
- * // Tooltip on disabled element
- * <Tooltip content="This feature is coming soon">
- *   <Button disabled>Coming Soon</Button>
- * </Tooltip>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper ARIA attributes and roles
- * - Keyboard navigation support
- * - Screen reader announcements
- * - Focus management
- * - High contrast support
- * - Reduced motion support
- *
- * @performance
- * - Efficient positioning calculations
- * - Optimized animations
- * - Memory leak prevention
- * - Lazy rendering
- *
- * @dependencies
- * - @radix-ui/react-tooltip - Core tooltip functionality
- * - React 19+ - Hooks and refs
- * - Tailwind CSS - Styling and animations
- */
-
-declare const TooltipProvider: React$1.FC<TooltipPrimitive.TooltipProviderProps>;
-declare const TooltipRoot: React$1.FC<TooltipPrimitive.TooltipProps>;
-declare const TooltipTrigger: React$1.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
-/**
- * TooltipContent component
- * The content container for tooltip information
- *
- * @param props - Content configuration and styling
- * @param ref - Forwarded ref to the content element
- * @returns JSX.Element - The tooltip content container
- *
- * @example
- * ```tsx
- * <TooltipContent side="top" className="bg-main-500">
- *   Custom tooltip content
- * </TooltipContent>
- * ```
- */
-declare const TooltipContent: React$1.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-/**
- * Props for the simplified Tooltip component
- */
-interface TooltipProps {
-    /** The element that triggers the tooltip */
-    children: React$1.ReactNode;
-    /** The content to display in the tooltip */
-    content: React$1.ReactNode;
-    /** Delay before showing the tooltip (in milliseconds) */
-    delayDuration?: number;
-}
-/**
- * Tooltip component
- * A simplified tooltip component for easy usage
- *
- * @param props - Tooltip configuration
- * @param ref - Forwarded ref to the trigger element
- * @returns JSX.Element - The tooltip with trigger and content
- *
- * @example
- * ```tsx
- * <Tooltip content="This is a helpful tooltip">
- *   <Button>Hover me</Button>
- * </Tooltip>
- * ```
- */
-declare const Tooltip: React$1.ForwardRefExoticComponent<TooltipProps & React$1.RefAttributes<HTMLButtonElement>>;
-
-/**
- * Props for the Form component
- */
-interface FormProps<TFieldValues extends FieldValues = FieldValues> {
-    /**
-     * Form schema for validation
-     */
-    schema?: z.ZodType<TFieldValues>;
-    /**
-     * Default values for the form
-     */
-    defaultValues?: DefaultValues<TFieldValues>;
-    /**
-     * Handler called when form is submitted successfully
-     */
-    onSubmit: SubmitHandler<TFieldValues>;
-    /**
-     * Handler called when form submission has errors
-     */
-    onError?: SubmitErrorHandler<TFieldValues>;
-    /**
-     * Form mode for react-hook-form
-     * @default "onSubmit"
-     */
-    mode?: "onSubmit" | "onChange" | "onBlur" | "onTouched" | "all";
-    /**
-     * Children components or render function
-     */
-    children: React__default.ReactNode | ((methods: UseFormReturn<TFieldValues>) => React__default.ReactNode);
-    /**
-     * Class name for the form
-     */
-    className?: string;
-}
-/**
- * Form component with validation and React Hook Form integration
- *
- * @template TFieldValues - The type of form field values
- * @param props - Form configuration and handlers
- * @returns JSX.Element - The rendered form with FormProvider context
- *
- * @example
- * ```tsx
- * <Form
- *   schema={userSchema}
- *   defaultValues={{ name: "", email: "" }}
- *   onSubmit={handleSubmit}
- *   mode="onBlur"
- * >
- *   <FormField name="name" label="Name" />
- *   <FormField name="email" label="Email" />
- *   <Button type="submit">Submit</Button>
- * </Form>
- * ```
- */
-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<any>;
-    /**
-     * 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
- * @package @jmruthers/pace-core
- * @module Components/LoginForm
- * @since 0.1.0
- *
- * A comprehensive login form component with built-in validation, error handling,
- * and loading states for user authentication.
- *
- * Features:
- * - Email and password validation
- * - Loading states with disabled form
- * - Error handling and display
- * - Customizable branding and messaging
- * - Sign-up link integration
- * - Performance optimized with React.memo
- * - Accessibility compliant
- * - Responsive design
- * - Form validation
- * - Success and error callbacks
- *
- * @example
- * ```tsx
- * // Basic login form
- * <LoginForm
- *   onSignIn={async (data) => {
- *     await signIn(data.email, data.password);
- *   }}
- *   onSuccess={() => navigate('/dashboard')}
- *   onError={(error) => console.error('Login failed:', error)}
- * />
- *
- * // Login form with custom branding
- * <LoginForm
- *   appName="My Application"
- *   title="Welcome Back"
- *   subtitle="Please sign in to access your account"
- *   onSignIn={handleSignIn}
- *   onSuccess={handleSuccess}
- *   onError={handleError}
- * />
- *
- * // Login form with sign-up integration
- * <LoginForm
- *   appName="My App"
- *   showSignUp={true}
- *   onSignUp={() => navigate('/signup')}
- *   onSignIn={handleSignIn}
- *   isLoading={isAuthenticating}
- * />
- *
- * // Login form with custom error handling
- * <LoginForm
- *   onSignIn={async (data) => {
- *     try {
- *       const result = await authService.signIn(data);
- *       if (result.success) {
- *         onSuccess();
- *       } else {
- *         throw new Error(result.error);
- *       }
- *     } catch (error) {
- *       onError(error);
- *     }
- *   }}
- *   onSuccess={() => {
- *     toast.success('Successfully signed in!');
- *     navigate('/dashboard');
- *   }}
- *   onError={(error) => {
- *     toast.error(`Sign in failed: ${error.message}`);
- *   }}
- * />
- * ```
- *
- * @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
- *
- * @performance
- * - React.memo for efficient re-rendering
- * - useCallback for stable event handlers
- * - useMemo for computed values
- * - Minimal re-renders
- *
- * @dependencies
- * - React 19+ - Hooks and memo
- * - Button component
- * - Input component
- * - Label component
- * - Card components
- * - Alert component
- * - 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: {
-        email: string;
-        password: string;
-    }) => Promise<void>;
-    /** Callback invoked on successful sign-in */
-    onSuccess?: () => void;
-    /** Callback invoked if sign-in fails */
-    onError?: (error: Error) => void;
-    /** Show loading spinner and disable form while true */
-    isLoading?: boolean;
-    /** Application name for display in the form */
-    appName?: string;
-    /** Custom title for the form */
-    title?: string;
-    /** Custom subtitle for the form */
-    subtitle?: string;
-    /** Show a sign-up link or button */
-    showSignUp?: boolean;
-    /** Optional callback for sign-up button */
-    onSignUp?: () => void;
-    /** Additional CSS classes */
-    className?: string;
-}
-/**
- * LoginForm component that provides a ready-to-use authentication form for user sign-in.
- * It supports validation, loading state, error handling, and can be customized via props.
- * Now includes performance optimizations and onSignUp support.
- *
- * @param props - Login form configuration and handlers
- * @returns JSX.Element - The rendered login form
- *
- * @example
- * ```tsx
- * <LoginForm
- *   onSignIn={handleSignIn}
- *   onSuccess={() => navigate('/dashboard')}
- *   onError={(error) => toast.error(error.message)}
- *   isLoading={isAuthenticating}
- * />
- * ```
- */
-declare const LoginForm: React__default.NamedExoticComponent<LoginFormProps>;
-
-/**
- * @file Unified Navigation Menu Component
- * @package @jmruthers/pace-core
- * @module Navigation
- * @since 0.1.0
- *
- * A flexible navigation menu component that supports both dropdown and hierarchical modes.
- *
- * Features:
- * - Dropdown mode: Menu button that opens a dropdown list
- * - Hierarchical mode: Expandable tree navigation with nested items
- * - Icon support for navigation items
- * - Current page highlighting
- * - Keyboard navigation support
- * - Accessible design with proper ARIA attributes
- * - Click outside to close (dropdown mode)
- * - Recursive rendering for nested items (hierarchical mode)
- *
- * @example
- * Basic dropdown navigation (most common use case):
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- * import { useNavigate, useLocation } from 'react-router-dom';
- *
- * function AppNavigation() {
- *   const navigate = useNavigate();
- *   const location = useLocation();
- *
- *   const navItems = [
- *     { id: 'home', label: 'Home', href: '/', icon: 'Home' },
- *     { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
- *     { id: 'reports', label: 'Reports', href: '/reports', icon: 'FileText' },
- *     { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       currentPath={location.pathname}
- *       onNavigate={(item) => navigate(item.href)}
- *       buttonText="Main Menu"
- *       showIcons={true}
- *     />
- *   );
- * }
- *
- * @example
- * Hierarchical navigation with nested items:
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- *
- * function SidebarNavigation() {
- *   const hierarchicalItems = [
- *     {
- *       id: 'user-management',
- *       label: 'User Management',
- *       icon: 'Users',
- *       children: [
- *         { id: 'users-list', label: 'All Users', href: '/users' },
- *         { id: 'users-create', label: 'Create User', href: '/users/create' },
- *         { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
- *       ]
- *     },
- *     {
- *       id: 'reports',
- *       label: 'Reports',
- *       icon: 'BarChart',
- *       children: [
- *         { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
- *         { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
- *       ]
- *     },
- *     { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={hierarchicalItems}
- *       mode="hierarchical"
- *       currentPath={window.location.pathname}
- *       onNavigate={(item) => {
- *         if (item.href) {
- *           window.location.href = item.href;
- *         }
- *       }}
- *       className="w-64 bg-sec-50 p-4"
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Integration with React Router and authentication:
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- * import { useNavigate, useLocation } from 'react-router-dom';
- * import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
- *
- * function AuthenticatedNavigation() {
- *   const navigate = useNavigate();
- *   const location = useLocation();
- *   const { hasRole, hasPermission } = useUnifiedAuth();
- *
- *   // Build navigation items based on user permissions
- *   const navItems = [
- *     { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
- *     ...(hasPermission('meals:read') ? [
- *       { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
- *     ] : []),
- *     ...(hasRole('admin') ? [
- *       { id: 'admin', label: 'Admin Panel', href: '/admin', icon: 'Shield' }
- *     ] : []),
- *     { id: 'profile', label: 'Profile', href: '/profile', icon: 'User' }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       currentPath={location.pathname}
- *       onNavigate={(item) => navigate(item.href)}
- *       buttonText="Navigation"
- *       navigationLabel="Main application navigation"
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Custom navigation with external links and actions
- * import { NavigationMenu } from '@jmruthers/pace-core';
- *
- * function CustomNavigation() {
- *   const handleNavigation = (item) => {
- *     if (item.id === 'logout') {
- *       // Handle logout action
- *       handleLogout();
- *     } else if (item.href?.startsWith('http')) {
- *       // Handle external links
- *       window.open(item.href, '_blank');
- *     } else if (item.href) {
- *       // Handle internal navigation
- *       navigate(item.href);
- *     }
- *   };
- *
- *   const navItems = [
- *     { id: 'home', label: 'Home', href: '/', icon: 'Home' },
- *     { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
- *     { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       onNavigate={handleNavigation}
- *       buttonText="Menu"
- *       disabled={false}
- *     />
- *   );
- * }
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant navigation structure
- * - Proper ARIA attributes for screen readers
- * - Keyboard navigation with Enter, Space, and Escape keys
- * - Focus management for dropdown menus
- * - Semantic HTML structure with nav, menu, and menuitem roles
- * - Clear visual indicators for active/current page
- *
- * @performance
- * - Lightweight component with minimal re-renders
- * - Efficient click outside detection
- * - Optimized keyboard event handling
- * - Memory cleanup for event listeners
- *
- * @styling
- * - Uses Tailwind CSS for consistent styling
- * - Supports custom className for additional styling
- * - Responsive design considerations
- *
- * @dependencies
- * - React 19+ - Component framework and hooks
- * - Lucide React - Icon components
- * - Radix UI - Dropdown menu primitives
- * - React Router (optional) - For navigation handling
- * - Tailwind CSS - Styling system
- */
-
-/**
- * Unified NavigationMenu component that supports both dropdown and hierarchical navigation modes.
- *
- * A flexible navigation menu component with support for icons, current page highlighting,
- * keyboard navigation, and nested menu items.
- *
- * Features:
- * - Dropdown mode: Menu button that opens a dropdown list
- * - Hierarchical mode: Expandable tree navigation with nested items
- * - Icon support for navigation items
- * - Current page highlighting
- * - Keyboard navigation support (Enter, Space, Escape)
- * - Accessible design with proper ARIA attributes
- * - Click outside to close (dropdown mode)
- * - Recursive rendering for nested items (hierarchical mode)
- *
- * @example
- * Basic dropdown navigation (most common use case):
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- * import { useNavigate, useLocation } from 'react-router-dom';
- *
- * function AppNavigation() {
- *   const navigate = useNavigate();
- *   const location = useLocation();
- *
- *   const navItems = [
- *     { id: 'home', label: 'Home', href: '/', icon: 'Home' },
- *     { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
- *     { id: 'reports', label: 'Reports', href: '/reports', icon: 'FileText' },
- *     { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       currentPath={location.pathname}
- *       onNavigate={(item) => navigate(item.href)}
- *       buttonText="Main Menu"
- *       showIcons={true}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Hierarchical navigation with nested items:
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- *
- * function SidebarNavigation() {
- *   const hierarchicalItems = [
- *     {
- *       id: 'user-management',
- *       label: 'User Management',
- *       icon: 'Users',
- *       children: [
- *         { id: 'users-list', label: 'All Users', href: '/users' },
- *         { id: 'users-create', label: 'Create User', href: '/users/create' },
- *         { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
- *       ]
- *     },
- *     {
- *       id: 'reports',
- *       label: 'Reports',
- *       icon: 'BarChart',
- *       children: [
- *         { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
- *         { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
- *       ]
- *     },
- *     { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={hierarchicalItems}
- *       mode="hierarchical"
- *       currentPath={window.location.pathname}
- *       onNavigate={(item) => {
- *         if (item.href) {
- *           window.location.href = item.href;
- *         }
- *       }}
- *       className="w-64 bg-sec-50 p-4"
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Integration with React Router and authentication:
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- * import { useNavigate, useLocation } from 'react-router-dom';
- * import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
- *
- * function AuthenticatedNavigation() {
- *   const navigate = useNavigate();
- *   const location = useLocation();
- *   const { hasRole, hasPermission } = useUnifiedAuth();
- *
- *   // Build navigation items with permission requirements
- *   const navItems = [
- *     {
- *       id: 'dashboard',
- *       label: 'Dashboard',
- *       href: '/dashboard',
- *       icon: 'LayoutDashboard',
- *       permissions: ['dashboard:read']
- *     },
- *     {
- *       id: 'meals',
- *       label: 'Meals',
- *       href: '/meals',
- *       icon: 'UtensilsCrossed',
- *       permissions: ['meals:read']
- *     },
- *     {
- *       id: 'admin',
- *       label: 'Admin Panel',
- *       href: '/admin',
- *       icon: 'Shield',
- *       roles: ['admin', 'super_admin']
- *     },
- *     {
- *       id: 'profile',
- *       label: 'Profile',
- *       href: '/profile',
- *       icon: 'User'
- *     }
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       currentPath={location.pathname}
- *       onNavigate={(item) => navigate(item.href)}
- *       buttonText="Navigation"
- *       navigationLabel="Main application navigation"
- *       // Permission filtering is always enabled - no prop needed
- *       auditLog={true}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Custom navigation with external links and actions:
- * ```tsx
- * import { NavigationMenu } from '@jmruthers/pace-core';
- *
- * function CustomNavigation() {
- *   const handleNavigation = (item) => {
- *     if (item.id === 'logout') {
- *       // Handle logout action
- *       handleLogout();
- *     } else if (item.href?.startsWith('http')) {
- *       // Handle external links
- *       window.open(item.href, '_blank');
- *     } else if (item.href) {
- *       // Handle internal navigation
- *       navigate(item.href);
- *     }
- *   };
- *
- *   const navItems = [
- *     { id: 'home', label: 'Home', href: '/', icon: 'Home' },
- *     { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
- *     { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
- *   ];
- *
- *   return (
- *     <NavigationMenu
- *       items={navItems}
- *       mode="dropdown"
- *       onNavigate={handleNavigation}
- *       buttonText="Menu"
- *       disabled={false}
- *     />
- *   );
- * }
- * ```
- *
- * @param props - NavigationMenu component props including items, mode, navigation handlers, and styling options
- * @returns React element with navigation menu functionality
- *
- * @since 0.1.0
- */
-declare const NavigationMenu: React$1.ForwardRefExoticComponent<NavigationMenuProps & React$1.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 with onSuccess callback
- * <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) {
- *             return {};
- *           } else {
- *             return { error: { message: result.error } };
- *           }
- *         }}
- *         onSuccess={() => {
- *           setShowPasswordChange(false);
- *           toast.success('Password changed successfully');
- *         }}
- *       />
- *     </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 19+ - Hooks and state
- * - Button component
- * - Input component
- * - 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;
-    }>;
-    onSuccess?: () => void;
-    className?: string;
-}
-declare function PasswordChangeForm({ onSubmit, onSuccess, className }: PasswordChangeFormProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Props for the Header component
- */
-interface HeaderProps {
-    /** URL to the app logo image */
-    logoUrl?: string;
-    /** Alt text for the logo */
-    logoAlt?: string;
-    /** Custom logo component (overrides logoUrl) */
-    logo?: React__default.ReactNode;
-    /** Navigation items for the menu - uses NavigationItem interface */
-    navItems?: NavigationItem[];
-    /** Current user for the user menu */
-    user?: User | null;
-    /** Sign out handler for user menu */
-    onSignOut?: () => Promise<void>;
-    /** Password change handler for user menu */
-    onChangePassword?: (newPassword: string, confirmPassword: string) => Promise<{
-        error?: PasswordChangeFormError;
-    }>;
-    /** Additional actions to display (will be placed between event selector and user menu) */
-    actions?: React__default.ReactNode;
-    /** Custom user menu component (overrides default UserMenu) */
-    userMenu?: React__default.ReactNode;
-    /** Custom className */
-    className?: string;
-    /** 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 */
-    currentPath?: string;
-    /** Custom navigation handler */
-    onNavigate?: (item: NavigationItem) => void;
-    /** URL to navigate to when logo is clicked (e.g., '/dashboard') */
-    logoHref?: string;
-}
-/**
- * Header component for application layouts with comprehensive navigation, user management,
- * and customizable branding support.
- *
- * A flexible header component that supports various configurations including custom logos,
- * navigation menus, user authentication, event selection, and custom actions.
- *
- * **Logo Display:** When used via PaceAppLayout, the logo URL is automatically constructed
- * from the appName prop as `/${appName.toLowerCase()}_logo_wide.svg`. The appName should
- * come from an APP_NAME constant declared in your App.tsx file to ensure consistency across
- * authenticated and public pages.
- *
- * Features:
- * - Customizable logo (URL or custom component)
- * - Clickable logo that automatically routes to dashboard (configurable via logoHref)
- * - Navigation menu integration with highlighting
- * - User menu with authentication and password management
- * - Event selector for multi-tenant applications
- * - Custom actions support
- * - Responsive design with mobile considerations
- * - Accessibility compliant with proper ARIA attributes
- * - Backdrop blur effects for modern UI
- * - Flexible layout with configurable sections
- *
- * @example
- * Basic header with logo and navigation (logo routes to /dashboard when clicked):
- * ```tsx
- * import { Header } from '@jmruthers/pace-core';
- * import { useNavigate, useLocation } from 'react-router-dom';
- *
- * function AppHeader() {
- *   const navigate = useNavigate();
- *   const location = useLocation();
- *
- *   const navItems = [
- *     { id: 'dashboard', label: 'Dashboard', href: '/dashboard' },
- *     { id: 'meals', label: 'Meals', href: '/meals' },
- *     { id: 'settings', label: 'Settings', href: '/settings' }
- *   ];
- *
- *   return (
- *     <Header
- *       logoUrl="/company-logo.svg"
- *       logoAlt="My Company"
- *       logoHref="/dashboard"
- *       navItems={navItems}
- *       currentPath={location.pathname}
- *       onNavigate={(item) => navigate(item.href)}
- *       user={currentUser}
- *       onSignOut={handleSignOut}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Header with custom actions:
- * ```tsx
- * import { Header, Button } from '@jmruthers/pace-core';
- *
- * function HeaderWithActions() {
- *   const customActions = (
- *     <>
- *       <Button variant="outline" size="sm">Export</Button>
- *       <Button size="sm">New Item</Button>
- *     </>
- *   );
- *
- *   return (
- *     <Header
- *       logoUrl="/logo.svg"
- *       navItems={navigationItems}
- *       actions={customActions}
- *       user={currentUser}
- *       onSignOut={handleSignOut}
- *     />
- *   );
- * }
- * ```
- *
- * @example
- * Minimal header configuration:
- * ```tsx
- * function MinimalHeader() {
- *   return (
- *     <Header
- *       logoUrl="/simple-logo.svg"
- *       logoAlt="Simple App"
- *       showContextSelector={false}
- *       user={currentUser}
- *       onSignOut={handleSignOut}
- *     />
- *   );
- * }
- * ```
- *
- * @param props - Header configuration including logo, navigation, user settings, and custom content
- * @returns React element with complete header functionality
- *
- * @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, showContextSelector, showOrganisations, showEvents, showUserMenu, currentPath, onNavigate, logoHref }: HeaderProps): react_jsx_runtime.JSX.Element;
-
-/**
- * @file Footer Component
- * @package @jmruthers/pace-core
- * @module Components/Footer
- * @since 0.1.0
- *
- * A flexible footer component for application layouts with copyright information,
- * navigation links, and customizable content.
- *
- * Features:
- * - Copyright information with automatic year generation
- * - Customizable company name and branding
- * - Optional navigation links
- * - Logo display support
- * - Custom footer content via children
- * - Responsive design
- * - Accessibility compliant
- * - Flexible layout options
- * - Consistent styling with design system
- *
- * @example
- * ```tsx
- * // Basic footer with default copyright
- * <Footer />
- *
- * // Footer with custom company name and year
- * <Footer
- *   companyName="My Company Inc."
- *   year={2024}
- * />
- *
- * // Footer with navigation links
- * <Footer
- *   companyName="My Company"
- *   links={[
- *     { label: 'Privacy Policy', href: '/privacy' },
- *     { label: 'Terms of Service', href: '/terms' },
- *     { label: 'Contact', href: '/contact' }
- *   ]}
- * />
- *
- * // Footer with logo and custom copyright
- * <Footer
- *   logo="/logo.svg"
- *   copyright="© 2024 My Company. All rights reserved."
- * />
- *
- * // Footer with custom content
- * <Footer companyName="My Company">
- *   <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>
- *     </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>
- *     </section>
- *     <section>
- *       <h3 className="font-semibold mb-2">Follow Us</h3>
- *       <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>
- *       </nav>
- *     </section>
- *   </section>
- * </Footer>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper semantic HTML with role="contentinfo"
- * - Screen reader friendly navigation
- * - Keyboard navigation support
- * - High contrast support
- * - Clear link identification
- *
- * @dependencies
- * - React 19+ - Component framework
- * - Tailwind CSS - Styling
- */
-
-/**
- * Props for the Footer component.
- */
-interface FooterProps {
-    /**
-     * Company or organization name
-     */
-    companyName?: string;
-    /**
-     * Current year or custom year for copyright
-     * @default current year
-     */
-    year?: number;
-    /**
-     * Optional array of navigation links to display
-     */
-    links?: Array<{
-        label: string;
-        href: string;
-    }>;
-    /**
-     * Optional CSS class name
-     */
-    className?: string;
-    /**
-     * Logo image URL (from UI version)
-     */
-    logo?: string;
-    /**
-     * Copyright text (from UI version)
-     */
-    copyright?: string;
-    /**
-     * Footer content - children to render inside footer
-     */
-    children?: React__default.ReactNode;
-}
-declare const Footer: React__default.NamedExoticComponent<FooterProps>;
-
-/**
- * @file User Menu Component
- * @package @jmruthers/pace-core
- * @module Components/UserMenu
- * @since 0.1.0
- *
- * A comprehensive user menu component that displays user information and provides
- * access to user-specific actions like password changes and sign out.
- *
- * Features:
- * - User avatar and display name
- * - Dropdown menu with user actions
- * - Password change functionality
- * - Sign out capability
- * - Loading state component
- * - Responsive design
- * - Accessibility compliant
- * - Performance optimized with React.memo
- * - Integration with Supabase User
- * - Customizable styling
- *
- * @example
- * ```tsx
- * // Basic user menu
- * <UserMenu
- *   user={currentUser}
- *   onSignOut={async () => {
- *     await signOut();
- *     navigate('/login');
- *   }}
- *   onChangePassword={async (newPassword, confirmPassword) => {
- *     try {
- *       await updatePassword(newPassword);
- *       toast.success('Password updated successfully!');
- *       return {};
- *     } catch (error) {
- *       return { error: { message: error.message } };
- *     }
- *   }}
- * />
- *
- * // User menu without avatar
- * <UserMenu
- *   user={currentUser}
- *   showAvatar={false}
- *   onSignOut={handleSignOut}
- *   onChangePassword={handlePasswordChange}
- * />
- *
- * // User menu with loading state
- * {isLoading ? (
- *   <UserMenu.Loading />
- * ) : (
- *   <UserMenu
- *     user={user}
- *     onSignOut={handleSignOut}
- *     onChangePassword={handlePasswordChange}
- *   />
- * )}
- *
- * // User menu in header
- * <Header>
- *   <nav className="flex items-center gap-4">
- *     <Navigation />
- *     <UserMenu
- *       user={user}
- *       onSignOut={handleSignOut}
- *       onChangePassword={handlePasswordChange}
- *       className="ml-auto"
- *     />
- *   </nav>
- * </Header>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper ARIA labels and roles
- * - Keyboard navigation support
- * - Focus management
- * - Screen reader friendly
- * - High contrast support
- * - Loading state announcements
- * - Clear action identification
- *
- * @performance
- * - React.memo for efficient re-rendering
- * - useCallback for stable event handlers
- * - useMemo for computed values
- * - Minimal re-renders
- * - Optimized avatar rendering
- *
- * @dependencies
- * - React 19+ - Hooks and memo
- * - @supabase/supabase-js - User type
- * - lucide-react - Icons
- * - DropdownMenu components
- * - Dialog components
- * - PasswordChangeForm component
- * - Avatar component
- * - Button component
- * - Tailwind CSS - Styling
- */
-
-/**
- * Props for the UserMenu component.
- */
-interface UserMenuProps {
-    user: User | null;
-    onSignOut?: () => Promise<void>;
-    onChangePassword?: (newPassword: string, confirmPassword: string) => Promise<{
-        error?: PasswordChangeFormError;
-    }>;
-    className?: string;
-    showAvatar?: boolean;
-}
-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 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) */
-    customLogo?: React__default.ReactNode;
-    /** URL to navigate to when logo is clicked (defaults to '/dashboard') */
-    logoHref?: string;
-    /** Custom user menu component (overrides default user menu) */
-    customUserMenu?: React__default.ReactNode;
-    /** Custom className for the header */
-    headerClassName?: string;
-    /** Show/hide user menu */
-    showUserMenu?: boolean;
-    /** Enable layout-level permission enforcement */
-    enforcePermissions?: boolean;
-    /** Default permission to check for all routes (when enforcePermissions is true) */
-    defaultPermission?: Operation;
-    /** Route-specific permissions mapping */
-    routePermissions?: Record<string, Operation>;
-    /** Fallback component to show when user lacks permission */
-    permissionFallback?: React__default.ReactNode;
-    /** Custom permission page ID mapping */
-    pageIdMapping?: Record<string, string>;
-    /** Enable strict mode to prevent bypassing permission checks (default: true) */
-    strictMode?: boolean;
-    /** Enable page-level permission enforcement (default: false) */
-    enforcePagePermissions?: boolean;
-    /** Default page permission fallback component */
-    pagePermissionFallback?: React__default.ReactNode;
-    /** Enable audit logging for all permission checks (default: true) */
-    auditLog?: boolean;
-    /** Callback when page access is denied */
-    onPageAccessDenied?: (pageName: string, operation: string) => void;
-    /** Callback when strict mode violation occurs */
-    onStrictModeViolation?: (pageName: string, operation: string) => void;
-    /** Enable role-based routing (default: false) */
-    roleBasedRouting?: boolean;
-    /** Route configuration for role-based routing */
-    routeConfig?: Array<{
-        path: string;
-        component: React__default.ComponentType;
-        permissions: string[];
-        roles?: string[];
-        accessLevel?: string;
-        pageId?: string;
-        strictMode?: boolean;
-        meta?: {
-            title?: string;
-            description?: string;
-            requiresAuth?: boolean;
-            hidden?: boolean;
-        };
-    }>;
-    /** Fallback route for unauthorized access */
-    fallbackRoute?: string;
-    /** Callback when route access is denied */
-    onRouteAccessDenied?: (route: string, reason: string) => void;
-    /** Callback when route strict mode violation occurs */
-    onRouteStrictModeViolation?: (route: string, reason: string) => void;
-}
-/**
- * A consistent layout component for all PACE suite applications that provides a standard
- * structure with header, main content area, and footer.
- *
- * NEW: This component now includes layout-level permission enforcement to ensure
- * consuming apps can't forget to implement permission checks on individual pages.
- *
- * This component is designed to work with React Router's nested routing pattern using
- * Outlet to render child routes. It provides integrated authentication, navigation,
- * and user management functionality.
- *
- * **Super Admin Access:** When `enforcePermissions={true}`, PaceAppLayout automatically
- * checks if the user is a super admin before enforcing permissions. Super admins bypass
- * all permission checks and can access any route without violations. The component extracts
- * base page names from route paths (e.g., `/organisation/scouts-victoria` → `"organisation"`)
- * for permission checking, which can be overridden using `pageIdMapping`.
- *
- * **Important:** The appName prop should use an APP_NAME constant declared in your App.tsx
- * file. This ensures consistency with public pages (via PublicPageProvider) which should
- * also receive the same APP_NAME constant. The logo URL is automatically constructed as
- * `/${appName.toLowerCase()}_logo_wide.svg` from the public folder.
- *
- * Features:
- * - React Router v6 integration with nested routing
- * - Unified authentication integration
- * - Consistent header with navigation and user menu
- * - Flexible main content area with Outlet
- * - Footer with application branding
- * - User sign-out and password change functionality
- * - Responsive design and accessibility compliant
- * - Layout-level permission enforcement
- * - Permission-based navigation filtering
- * - Automatic page permission validation
- * - Super admin bypass (super admins automatically bypass all permission checks)
- *
- * @example
- * Basic React Router setup with permission enforcement (RECOMMENDED):
- * ```tsx
- * import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
- * import { UnifiedAuthProvider } from '@jmruthers/pace-core/providers';
- * import { PaceAppLayout, PaceLoginPage, PublicPageApp } from '@jmruthers/pace-core';
- *
- * const APP_NAME = 'CORE';
- *
- * function App() {
- *   return (
- *     <UnifiedAuthProvider supabaseClient={supabase} appName={APP_NAME}>
- *       <Router>
- *         <Routes>
- *           <Route path="/login" element={<PaceLoginPage appName={APP_NAME} />} />
- *           <Route path="/events/*" element={<PublicPageApp appName={APP_NAME} />} />
- *           <Route path="/" element={
- *             <PaceAppLayout
- *               appName={APP_NAME}
- *               enforcePermissions={true}
- *               defaultPermission="read"
- *             />
- *           }>
- *             <Route index element={<HomePage />} />
- *             <Route path="dashboard" element={<DashboardPage />} />
- *             <Route path="meals" element={<MealsPage />} />
- *           </Route>
- *         </Routes>
- *       </Router>
- *     </UnifiedAuthProvider>
- *   );
- * }
- * ```
- *
- *
- * @example
- * Custom navigation items with permission filtering (works independently of route enforcement):
- * ```tsx
- * import { NavigationItem } from '@jmruthers/pace-core';
- *
- * function App() {
- *   const customNavItems: NavigationItem[] = [
- *     { id: 'components', label: 'Components', href: '/components', icon: 'Component' },
- *     { id: 'styles', label: 'Styles', href: '/styles', icon: 'Palette' },
- *     { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
- *   ];
- *
- *   return (
- *     <Router>
- *       <Routes>
- *         <Route path="/" element={
- *           <PaceAppLayout
- *             appName="My Custom App"
- *             navItems={customNavItems}
- *             // Permission filtering is always enabled - no prop needed
- *             routePermissions={{
- *               '/components': 'read',
- *               '/styles': 'read',
- *               '/meals': 'read'
- *             }}
- *             // Optionally enable route-level enforcement (separate from navigation filtering)
- *             // enforcePermissions={true}
- *           />
- *         }>
- *           <Route path="components" element={<ComponentsPage />} />
- *           <Route path="styles" element={<StylesPage />} />
- *           <Route path="meals" element={<MealsPage />} />
- *         </Route>
- *       </Routes>
- *     </Router>
- *   );
- * }
- * ```
- *
- * @example
- * Route-specific permissions with custom page IDs:
- * ```tsx
- * function AdminApp() {
- *   return (
- *     <Router>
- *       <Routes>
- *         <Route path="/" element={
- *           <PaceAppLayout
- *             appName="Admin Panel"
- *             enforcePermissions={true}
- *             routePermissions={{
- *               '/dashboard': 'read',
- *               '/user-management': 'read',
- *               '/system-settings': 'update'
- *             }}
- *             pageIdMapping={{
- *               '/dashboard': 'dashboard',
- *               '/user-management': 'user-management',
- *               '/system-settings': 'system-admin'
- *             }}
- *             permissionFallback={<AccessDeniedPage />}
- *           />
- *         }>
- *           <Route path="dashboard" element={<DashboardPage />} />
- *           <Route path="user-management" element={<UserManagementPage />} />
- *           <Route path="system-settings" element={<SystemSettingsPage />} />
- *         </Route>
- *       </Routes>
- *     </Router>
- *   );
- * }
- * ```
- *
- * @param props - Layout configuration including app name for branding and permission settings
- * @returns React element with complete application layout structure and permission enforcement
- *
- * @since 0.1.0
- */
-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
- * @package @jmruthers/pace-core
- * @module Components/PaceLoginPage
- * @since 0.1.0
- *
- * A comprehensive login page component that provides a consistent authentication
- * experience for all PACE suite applications with role-based redirection and
- * enhanced error handling.
- *
- * Features:
- * - Consistent login page layout
- * - Unified authentication integration
- * - Role-based automatic redirection (admin users)
- * - Manual redirection for all successful logins
- * - Customizable app branding
- * - Configurable redirect paths
- * - Enhanced error handling and display
- * - Dual loading state management (auth + form)
- * - Navigation error recovery
- * - Responsive design
- * - Accessibility compliant
- * - Integration with LoginForm
- * - React Router navigation
- * - Centered layout design
- * - Error persistence and display
- *
- * @example
- * ```tsx
- * // Basic login page
- * <PaceLoginPage appName="My Application" />
- *
- * // Login page with custom redirect
- * <PaceLoginPage
- *   appName="Dashboard App"
- *   onSuccessRedirectPath="/dashboard"
- * />
- *
- * // Login page in router setup
- * <Router>
- *   <Routes>
- *     <Route path="/login" element={
- *       <PaceLoginPage
- *         appName="My App"
- *         onSuccessRedirectPath="/home"
- *       />
- *     } />
- *     <Route path="/home" element={<HomePage />} />
- *   </Routes>
- * </Router>
- *
- * // Login page with authentication provider
- * <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
- *   <Router>
- *     <Routes>
- *       <Route path="/login" element={
- *         <PaceLoginPage appName="My Application" />
- *       } />
- *       <Route path="/" element={<PaceAppLayout appName="My Application" />}>
- *         <Route index element={<HomePage />} />
- *       </Route>
- *     </Routes>
- *   </Router>
- * </UnifiedAuthProvider>
- *
- * // Login page with role-based access control
- * function App() {
- *   return (
- *     <UnifiedAuthProvider supabaseClient={supabase} appName="Admin Portal">
- *       <Router>
- *         <Routes>
- *           <Route path="/login" element={
- *             <PaceLoginPage
- *               appName="Admin Portal"
- *               onSuccessRedirectPath="/admin/dashboard"
- *             />
- *           } />
- *           <Route path="/admin/*" element={<AdminRoutes />} />
- *         </Routes>
- *       </Router>
- *     </UnifiedAuthProvider>
- *   );
- * }
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper semantic HTML structure
- * - Screen reader friendly
- * - Keyboard navigation support
- * - Focus management
- * - High contrast support
- * - Clear page hierarchy
- * - Accessible form elements
- * - Error announcements
- *
- * @routing
- * - React Router v6 integration
- * - Automatic navigation on success
- * - Role-based redirect logic (admin users)
- * - Configurable redirect paths
- * - Replace navigation for login flow
- * - Navigation error handling
- *
- * @authentication
- * - Integration with UnifiedAuthProvider
- * - Role detection via hasRole('admin')
- * - Loading state management
- * - Error state handling
- * - Session validation
- * - Automatic redirect prevention loops
- *
- * @dependencies
- * - React 19+ - Hooks and effects
- * - React Router v6 - Navigation
- * - UnifiedAuthProvider - Authentication
- * - LoginForm component
- * - Button component
- * - Input component
- * - Label component
- * - Tailwind CSS - Styling
- */
-
-/**
- * Props for the PaceLoginPage component.
- */
-interface PaceLoginPageProps {
-    /** The name of the application to be displayed on the login form. */
-    appName: string;
-    /** The path to redirect to upon successful login. Defaults to `/`. */
-    onSuccessRedirectPath?: string;
-    /** Whether to check app access using RBAC. Defaults to false. */
-    requireAppAccess?: boolean;
-}
-/**
- * A consistent, reusable login page for all PACE suite applications.
- * It handles the sign-in logic with role-based automatic redirection for admin users,
- * enhanced error handling, and dual loading state management.
- *
- * Recent enhancements:
- * - Role-based redirection: Admin users are automatically redirected
- * - RBAC-based app access control: Checks if user has permission to access the app
- * - Enhanced error handling with navigation error recovery
- * - Dual loading states: auth loading + form submission loading
- * - Error persistence: Auth errors are displayed below the form
- * - Navigation safety: Try-catch blocks prevent navigation errors
- *
- * @param props - Login page configuration including app name and redirect path
- * @returns JSX.Element - The rendered login page with enhanced functionality
- *
- * @example
- * ```tsx
- * <PaceLoginPage
- *   appName="My Application"
- *   onSuccessRedirectPath="/dashboard"
- * />
- * ```
- */
-declare const PaceLoginPage: React__default.FC<PaceLoginPageProps>;
-
-/**
- * Props for the ProtectedRoute component.
- */
-interface ProtectedRouteProps {
-    /**
-     * Whether an event is required for routes inside this component.
-     * When true, routes will only render if an event is selected or can be selected.
-     * When false, routes render regardless of event state.
-     * @default true
-     */
-    requireEvent?: boolean;
-    /**
-     * Custom component to render when no events are available.
-     * If not provided, a default message is shown.
-     */
-    noEventsFallback?: React__default.ReactNode;
-    /**
-     * Custom component to render while events are loading.
-     * If not provided, a default loading spinner is shown.
-     */
-    loadingFallback?: React__default.ReactNode;
-    /**
-     * Login redirect path when user is not authenticated.
-     * @default '/login'
-     */
-    loginPath?: string;
-}
-/**
- * ProtectedRoute component that handles authentication and optional event selection.
- *
- * This component solves the chicken-and-egg problem where apps check for `selectedEvent`
- * before rendering, which blocks the event selector (typically in the header) from being visible.
- *
- * Strategy:
- * 1. Check authentication first - redirect to login if not authenticated
- * 2. Allow rendering during event loading - prevents blocking UI
- * 3. If events exist but none selected - allow rendering so selector is visible
- * 4. If no events available - show error message
- * 5. Individual pages should handle "no selected event" state gracefully
- *
- * @param props - Configuration for route protection
- * @returns React element with route protection logic
- */
-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
- * @public
- */
-interface ErrorBoundaryState {
-    /** Whether an error has been caught */
-    hasError: boolean;
-    /** The error that was caught */
-    error?: Error;
-    /** Additional error information from React */
-    errorInfo?: React__default.ErrorInfo;
-    /** Unique identifier for the error */
-    errorId?: string;
-    /** Number of retry attempts made */
-    retryCount: number;
-}
-/**
- * Props interface for the ErrorBoundary component
- * @public
- */
-interface ErrorBoundaryProps {
-    /** Child components to wrap with error boundary */
-    children: ReactNode;
-    /** Name of the component for error reporting */
-    componentName?: string;
-    /** Custom fallback UI to display when error occurs */
-    fallback?: ReactNode;
-    /** Callback function called when an error is caught */
-    onError?: (error: Error, errorInfo: React__default.ErrorInfo, errorId: string) => void;
-    /** Maximum number of retry attempts */
-    maxRetries?: number;
-    /** Whether to enable retry functionality */
-    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
- * Catches JavaScript errors in child components and provides fallback UI
- *
- * @example
- * ```tsx
- * <ErrorBoundary
- *   componentName="MyComponent"
- *   maxRetries={3}
- *   onError={(error, errorInfo, errorId) => {
- *     console.log('Error caught:', errorId);
- *   }}
- * >
- *   <MyComponent />
- * </ErrorBoundary>
- * ```
- */
-declare class ErrorBoundary$1 extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    private retryTimeoutId;
-    constructor(props: ErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState>;
-    componentDidCatch(error: Error, errorInfo: React__default.ErrorInfo): void;
-    private reportError;
-    private handleRetry;
-    componentWillUnmount(): void;
-    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
- * @module Components/LoadingSpinner
- * @since 0.1.0
- *
- * A simple, accessible loading spinner component for indicating loading states.
- * Provides smooth animations with reduced motion support for accessibility.
- *
- * Features:
- * - Multiple size variants (sm, md, lg)
- * - Smooth CSS animations
- * - Reduced motion support for accessibility
- * - Screen reader friendly with proper ARIA attributes
- * - Customizable styling
- * - Lightweight and performant
- *
- * @example
- * ```tsx
- * // Basic loading spinner
- * <LoadingSpinner />
- *
- * // Different sizes
- * <LoadingSpinner size="sm" />
- * <LoadingSpinner size="md" />
- * <LoadingSpinner size="lg" />
- *
- * // With custom styling
- * <LoadingSpinner
- *   size="lg"
- *   className="text-main-500"
- * />
- *
- * // In a button
- * <Button disabled>
- *   <LoadingSpinner size="sm" className="mr-2" />
- *   Loading...
- * </Button>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper ARIA role="status"
- * - Screen reader announcement with "Loading..." text
- * - Reduced motion support for users with vestibular disorders
- * - High contrast support
- *
- * @performance
- * - CSS-only animations for optimal performance
- * - No JavaScript dependencies
- * - Minimal DOM structure
- * - Efficient rendering
- *
- * @dependencies
- * - React 19+ - Component framework
- * - Tailwind CSS - Styling and animations
- */
-
-/**
- * Props for the LoadingSpinner component
- */
-interface LoadingSpinnerProps {
-    /** Size variant of the spinner */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional CSS classes for styling */
-    className?: string;
-}
-/**
- * LoadingSpinner component
- * A simple, accessible loading spinner for indicating loading states
- *
- * @param props - Spinner configuration and styling
- * @returns JSX.Element - The rendered loading spinner
- *
- * @example
- * ```tsx
- * <LoadingSpinner size="lg" className="text-main-500" />
- * ```
- */
-declare const LoadingSpinner: React__default.FC<LoadingSpinnerProps>;
-
-/**
- * @file SessionRestorationLoader Component
- * @package @jmruthers/pace-core
- * @module Components/SessionRestorationLoader
- * @since 0.1.0
- *
- * 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 19+ - 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>;
-
-/**
- * Props for the ContextSelector component.
- */
-interface ContextSelectorProps {
-    /** Placeholder text for the dropdown */
-    placeholder?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** 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;
-    /** Compact display mode */
-    compact?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Show organisations section (default: true) */
-    showOrganisations?: boolean;
-    /** Show events section (default: true) */
-    showEvents?: boolean;
-}
-/**
- * ContextSelector component for selecting organisations or events
- *
- * 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.
- *
- * 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 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;
-    record_id: string;
-    organisation_id?: string | null;
-    userId?: string;
-    app_id?: string;
-    category: FileCategory;
-    folder: string;
-    pageContext: string;
-    event_id?: string;
-    accept?: string;
-    maxSize?: number;
-    multiple?: boolean;
-    disabled?: boolean;
-    isPublic?: boolean;
-    className?: string;
-    showPreview?: boolean;
-    showProgress?: boolean;
-    onUploadSuccess?: (result: FileUploadResult) => void;
-    onUploadError?: (error: string, file?: File) => void;
-    onProgress?: (progress: UploadProgress) => void;
-    children?: React__default.ReactNode;
-}
-declare function FileUpload({ supabase, table_name, record_id, organisation_id, userId, app_id, category, folder, pageContext, event_id, accept, maxSize, // 10MB default
-multiple, disabled, isPublic, className, showPreview, showProgress, onUploadSuccess, onUploadError, onProgress, children }: FileUploadProps): react_jsx_runtime.JSX.Element;
-
-interface FileDisplayProps {
-    table_name: string;
-    record_id: string;
-    /**
-     * Optional organisation ID. When not provided (undefined), the component will automatically
-     * search for files in both user-scoped (organisation_id = null) and organisation-scoped contexts.
-     * If both types of files exist, organisation-scoped files are preferred.
-     * When explicitly set to null, only user-scoped files are searched.
-     */
-    organisation_id?: string;
-    category?: FileCategory;
-    /** Display only a single file instead of all files. Uses first file (prefers images) from all files, without category filtering */
-    displayOnly?: boolean;
-    showDelete?: boolean;
-    className?: string;
-    /** Classes to apply to the first child element of <figure> (img, p, or other elements) */
-    imgClassName?: string;
-    children?: React__default.ReactNode;
-    /** Custom loading component to render during data fetching */
-    loadingComponent?: React__default.ComponentType;
-    /** Custom error component to render when an error occurs */
-    errorComponent?: React__default.ComponentType<{
-        error: Error | string | null;
-        retry?: () => void;
-    }>;
-    /** Whether to show fallback UI when no file is available or image fails to load */
-    showFallback?: boolean;
-    /** Custom function to generate fallback text from file name or other context */
-    generateFallbackText?: (fileName?: string) => string;
-    /** Explicit fallback text to display (overrides generateFallbackText) */
-    fallbackText?: string;
-    /** Source text to use for generating fallback text (overrides filename) */
-    fallbackSourceText?: string;
-    /** Size variant for fallback display (only applies when showFallback is true) */
-    fallbackSize?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-    /**
-     * Enable children rendering in displayOnly mode. When true, uses standard display path
-     * (with children support) even if showDelete is false. The delete button will only appear
-     * if showDelete is also true.
-     */
-    enableChildren?: boolean;
-    /** Whether to show metadata (filename, filesize, mimetype) in figcaption. Defaults to true. */
-    showMetadata?: boolean;
-}
-/**
- * Component for displaying file references with context-awareness
- *
- * This component is context-aware and automatically detects whether it's being used
- * in a public or authenticated context. It fetches and displays files from storage.
- *
- * The component automatically detects context and uses:
- * - PublicPageProvider context for public pages
- * - UnifiedAuthProvider context for authenticated pages
- *
- * @param props - File display configuration
- * @param props.displayOnly - Display only a single file instead of all files. Uses first file (prefers images) from all files, without category filtering. When true:
- *   - **Image files**: Renders a simplified image-only display without metadata or wrapper divs
- *   - **Non-image files** (PDFs, Word docs, Excel files, etc.): Renders as clickable links that open in a new tab with document icon, filename, and external link icon. Links include proper security attributes (`rel="noopener noreferrer"`) and accessibility features (ARIA labels, keyboard navigation, visible focus states)
- *   - If `showDelete={true}`, uses standard wrapper behavior instead of simplified display
- * @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;
-    uploadFile: (options: FileUploadOptions, file: File) => Promise<FileUploadResult | null>;
-    getFileReference: (table_name: string, record_id: string, organisation_id: string) => Promise<FileReference | null>;
-    getFileReferenceById: (id: string, organisation_id: string) => Promise<FileReference | null>;
-    getFileUrl: (table_name: string, record_id: string, organisation_id: string) => Promise<string | null>;
-    getSignedUrl: (table_name: string, record_id: string, organisation_id: string, expires_in?: number) => Promise<string | null>;
-    updateFileReference: (id: string, updates: Partial<FileReference>) => Promise<FileReference | null>;
-    deleteFileReference: (table_name: string, record_id: string, organisation_id: string, delete_file?: boolean) => Promise<boolean>;
-    listFileReferences: (table_name: string, record_id: string, organisation_id: string) => Promise<FileReference[]>;
-    getFilesByCategory: (table_name: string, record_id: string, category: FileCategory, organisation_id: string) => Promise<FileReference[]>;
-    getFileCount: (table_name: string, record_id: string, organisation_id: string) => Promise<number>;
-    clearError: () => void;
-};
-declare function useFileReferenceForRecord(supabase: SupabaseClient, table_name: string, record_id: string, organisation_id: string): {
-    isLoading: boolean;
-    error: string | null;
-    fileUrl: string | null;
-    fileReference: FileReference | null;
-    fileReferences: FileReference[];
-    fileCount: number;
-    loadFileReference: () => Promise<FileReference | null>;
-    loadFileUrl: () => Promise<string | null>;
-    loadFileReferences: () => Promise<FileReference[]>;
-    loadFileCount: () => Promise<number>;
-    deleteFile: (delete_file?: boolean) => Promise<boolean>;
-    updateFileReference: (id: string, updates: Partial<FileReference>) => Promise<FileReference | null>;
-    clearError: () => void;
-};
-/**
- * Hook for getting a file reference by ID
- */
-declare function useFileReferenceById(supabase: SupabaseClient, fileReferenceId: string | null, organisationId: string | null): {
-    isLoading: boolean;
-    error: string | null;
-    fileReference: FileReference | null;
-    fileUrl: string | null;
-    loadFileReference: () => Promise<FileReference | null>;
-    clearError: () => void;
-};
-/**
- * Convenience hook for getting files by category with automatic URL loading.
- *
- * This hook wraps useFileReference().getFilesByCategory and automatically:
- * - Loads file references filtered by category
- * - Generates URLs for all files (public URLs for public files, signed URLs for private files)
- * - Manages state for fileReferences and fileUrls
- * - Auto-refetches when table_name, record_id, category, or organisation_id changes
- *
- * Use this hook when you need files by category with their URLs ready to display.
- * For more control, use useFileReference() directly and manage URLs yourself.
- */
-declare function useFilesByCategory(supabase: SupabaseClient, table_name: string, record_id: string, category: FileCategory | null, organisation_id: string | null): {
-    isLoading: boolean;
-    error: string | null;
-    fileReferences: FileReference[];
-    fileUrls: Map<string, string>;
-    loadFiles: () => Promise<FileReference[]>;
-    clearError: () => void;
-};
-type UseFileReferenceOptions = {
-    table_name: string;
-    record_id: string;
-    organisation_id: string;
-};
-/**
- * Return value of the useFileReference hook.
- */
-type UseFileReferenceReturn = {
-    isLoading: boolean;
-    error: string | null;
-    uploadFile: (options: FileUploadOptions, file: File) => Promise<FileUploadResult | null>;
-    getFileReference: (table_name: string, record_id: string, organisation_id: string) => Promise<FileReference | null>;
-    getFileUrl: (table_name: string, record_id: string, organisation_id: string) => Promise<string | null>;
-    getSignedUrl: (table_name: string, record_id: string, organisation_id: string, expires_in?: number) => Promise<string | null>;
-    updateFileReference: (id: string, updates: Partial<FileReference>) => Promise<FileReference | null>;
-    deleteFileReference: (table_name: string, record_id: string, organisation_id: string, delete_file?: boolean) => Promise<boolean>;
-    listFileReferences: (table_name: string, record_id: string, organisation_id: string) => Promise<FileReference[]>;
-    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;
-    fileUrl: string | null;
-    fileReference: FileReference | null;
-    fileReferences: FileReference[];
-    fileCount: number;
-    loadFileReference: () => Promise<FileReference | null>;
-    loadFileUrl: () => Promise<string | null>;
-    loadFileReferences: () => Promise<FileReference[]>;
-    loadFileCount: () => Promise<number>;
-    deleteFile: (delete_file?: boolean) => Promise<boolean>;
-    updateFileReference: (id: string, updates: Partial<FileReference>) => Promise<FileReference | null>;
-    clearError: () => void;
-};
-
-/**
- * @file Table Component System
- * @package @jmruthers/pace-core
- * @module Components/Table
- * @since 0.1.0
- *
- * A comprehensive table component system for displaying tabular data.
- * Provides accessible table components with consistent styling and behavior.
- *
- * Features:
- * - Semantic HTML table structure
- * - Consistent styling and spacing
- * - Hover states and transitions
- * - Responsive design
- * - Accessibility compliant
- * - Customizable styling
- * - Checkbox support
- * - Caption support
- *
- * @example
- * ```tsx
- * // Basic table
- * <Table>
- *   <TableCaption>A list of your recent invoices.</TableCaption>
- *   <TableHeader>
- *     <TableRow>
- *       <TableHead>Invoice</TableHead>
- *       <TableHead>Status</TableHead>
- *       <TableHead>Method</TableHead>
- *       <TableHead>Amount</TableHead>
- *     </TableRow>
- *   </TableHeader>
- *   <TableBody>
- *     <TableRow>
- *       <TableCell>INV001</TableCell>
- *       <TableCell>Paid</TableCell>
- *       <TableCell>Credit Card</TableCell>
- *       <TableCell>$250.00</TableCell>
- *     </TableRow>
- *     <TableRow>
- *       <TableCell>INV002</TableCell>
- *       <TableCell>Pending</TableCell>
- *       <TableCell>PayPal</TableCell>
- *       <TableCell>$150.00</TableCell>
- *     </TableRow>
- *   </TableBody>
- *   <TableFooter>
- *     <TableRow>
- *       <TableCell colSpan={3}>Total</TableCell>
- *       <TableCell>$400.00</TableCell>
- *     </TableRow>
- *   </TableFooter>
- * </Table>
- *
- * // Table with checkboxes
- * <Table>
- *   <TableHeader>
- *     <TableRow>
- *       <TableHead className="w-12">
- *         <Checkbox />
- *       </TableHead>
- *       <TableHead>Name</TableHead>
- *       <TableHead>Email</TableHead>
- *     </TableRow>
- *   </TableHeader>
- *   <TableBody>
- *     <TableRow>
- *       <TableCell>
- *         <Checkbox />
- *       </TableCell>
- *       <TableCell>John Doe</TableCell>
- *       <TableCell>john@example.com</TableCell>
- *     </TableRow>
- *   </TableBody>
- * </Table>
- * ```
- *
- * @accessibility
- * - WCAG 2.1 AA compliant
- * - Proper table semantics
- * - Screen reader support
- * - Keyboard navigation
- * - Focus management
- * - High contrast support
- * - Caption for table description
- *
- * @dependencies
- * - React 19+ - Hooks and refs
- * - Tailwind CSS - Styling
- */
-
-/**
- * Table component
- * The main table container with semantic HTML structure
- *
- * @param props - Table configuration and styling
- * @param ref - Forwarded ref to the table element
- * @returns JSX.Element - The rendered table element
- *
- * @example
- * ```tsx
- * <Table>
- *   <TableHeader>...</TableHeader>
- *   <TableBody>...</TableBody>
- * </Table>
- * ```
- */
-declare const Table: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableElement> & React$1.RefAttributes<HTMLTableElement>>;
-declare const TableHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableSectionElement> & React$1.RefAttributes<HTMLTableSectionElement>>;
-declare const TableBody: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableSectionElement> & React$1.RefAttributes<HTMLTableSectionElement>>;
-declare const TableFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableSectionElement> & React$1.RefAttributes<HTMLTableSectionElement>>;
-declare const TableRow: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableRowElement> & React$1.RefAttributes<HTMLTableRowElement>>;
-declare const TableHead: React$1.ForwardRefExoticComponent<React$1.ThHTMLAttributes<HTMLTableCellElement> & React$1.RefAttributes<HTMLTableCellElement>>;
-declare const TableCell: React$1.ForwardRefExoticComponent<React$1.TdHTMLAttributes<HTMLTableCellElement> & React$1.RefAttributes<HTMLTableCellElement>>;
-declare const TableCaption: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableCaptionElement> & React$1.RefAttributes<HTMLTableCaptionElement>>;
-
-interface PublicPageLayoutProps {
-    /** The event code for this public page */
-    eventCode: string;
-    /** Child components to render */
-    children: ReactNode;
-    /** Optional event data - if not provided, will be fetched by parent component */
-    event?: Event | null;
-    /** Loading state - if true, shows loading spinner */
-    isLoading?: boolean;
-    /** Error state - if provided, shows error message */
-    error?: Error | null;
-    /** Function to retry loading event data */
-    refetch?: () => Promise<void> | void;
-    /** Whether to show the footer (default: true) */
-    showFooter?: boolean;
-    /** Custom error fallback component */
-    errorFallback?: React__default.ComponentType<{
-        error: Error;
-        retry: () => void;
-    }>;
-    /** Custom loading fallback component */
-    loadingFallback?: React__default.ComponentType;
-    /** Custom header component */
-    customHeader?: ReactNode;
-    /** Custom footer component */
-    customFooter?: ReactNode;
-    /** Whether to show event validation errors (default: true) */
-    showValidationErrors?: boolean;
-    /** Custom loading message */
-    loadingMessage?: string;
-}
-interface PublicPageHeaderProps {
-    /** The event data for this public page */
-    event?: Event;
-    /** The event code for this public page */
-    eventCode: string;
-    /** Optional page title */
-    title?: string;
-    /** Optional page description */
-    description?: string;
-    /** Whether to show the event logo (default: true) */
-    showEventLogo?: boolean;
-    /** Whether to show the app logo (default: true) */
-    showAppLogo?: boolean;
-    /** Custom CSS classes for the header */
-    className?: string;
-    /** Custom content to display in the header */
-    children?: ReactNode;
-    /** 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;
-/**
- * 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, errorFallback: ErrorFallback, loadingFallback: LoadingFallback, customHeader, customFooter, showValidationErrors, loadingMessage }: PublicPageLayoutProps): react_jsx_runtime.JSX.Element;
-
-interface PublicPageContextType {
-    isPublicPage: true;
-    supabase: ReturnType<typeof createClient<Database>> | null;
-    appName: string | null;
-    environment: {
-        supabaseUrl: string | null;
-        supabaseKey: string | null;
-    };
-}
-interface PublicPageProviderProps {
-    children: ReactNode;
-    /** Application name for logo display and branding. Should match the APP_NAME constant used in App.tsx */
-    appName?: string;
-}
-/**
- * Provider for public pages that completely isolates them from authentication context
- *
- * This provider:
- * - Does not initialize any authentication providers
- * - Provides environment variables for public data access
- * - Includes error boundary for graceful error handling
- * - Is completely separate from the main app context
- * - Provides appName for consistent logo display
- */
-declare function PublicPageProvider({ children, appName }: PublicPageProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access public page context
- *
- * @returns Public page context with environment variables
- */
-declare function usePublicPageContext(): PublicPageContextType;
-/**
- * Hook to check if we're in a public page context
- *
- * @returns True if we're in a public page context
- */
-declare function useIsPublicPage(): boolean;
-
-export { type DialogContentProps 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, DialogTrigger as O, Progress as P, DialogClose as Q, DialogContent as R, Switch as S, Textarea as T, DialogHeader as U, DialogBody as V, DialogFooter as W, DialogTitle as X, DialogDescription as Y, type DialogProps as Z, type DialogTriggerProps as _, type ButtonProps as a, FileUpload as a$, type DialogPortalProps as a0, type DialogCloseProps as a1, type DialogHeaderProps as a2, type DialogFooterProps as a3, type DialogBodyProps as a4, type DialogSize as a5, Select as a6, SelectGroup as a7, SelectValue as a8, SelectTrigger as a9, TooltipContent as aA, TooltipProvider as aB, TooltipRoot as aC, Form as aD, FormField as aE, type FormProps as aF, type FormFieldProps as aG, LoginForm as aH, type LoginFormProps as aI, Header as aJ, Footer as aK, type FooterProps as aL, ProtectedRoute as aM, type ProtectedRouteProps as aN, NavigationMenu as aO, ContextSelector as aP, type ContextSelectorProps as aQ, UserMenu as aR, ErrorBoundary as aS, ErrorBoundaryProvider as aT, type ErrorBoundaryProps as aU, type ErrorBoundaryState as aV, type ErrorBoundaryProviderProps as aW, type GlobalErrorHandler as aX, LoadingSpinner as aY, SessionRestorationLoader as aZ, type SessionRestorationLoaderProps as a_, SelectContent as aa, SelectLabel as ab, SelectItem as ac, SelectSeparator as ad, Tabs as ae, TabsList as af, TabsTrigger as ag, TabsContent as ah, type TabsProps as ai, type TabsListProps as aj, type TabsTriggerProps as ak, type TabsContentProps as al, Calendar as am, type CalendarProps as an, Toast as ao, Toaster as ap, ToastAction as aq, ToastProvider as ar, ToastViewport as as, ToastTitle as at, ToastDescription as au, ToastClose as av, type ToastActionElement as aw, type ToastProps as ax, Tooltip as ay, TooltipTrigger as az, CardHeader as b, type FileUploadProps as b0, FileDisplay as b1, type FileDisplayProps as b2, useFileReference as b3, useFileReferenceForRecord as b4, useFileReferenceById as b5, useFilesByCategory as b6, type UseFileReferenceOptions as b7, type UseFileReferenceReturn as b8, type UseFileReferenceForRecordReturn as b9, PublicPageLayout as ba, PublicPageHeader as bb, PublicPageFooter as bc, PublicPageProvider as bd, usePublicPageContext as be, useIsPublicPage as bf, type PublicPageLayoutProps as bg, type PublicPageHeaderProps as bh, type PublicPageFooterProps as bi, type PaceAppLayoutProps as bj, PaceAppLayout as bk, type PaceLoginPageProps as bl, PaceLoginPage as bm, type UserMenuProps as bn, PasswordChangeForm as bo, 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 };