@jmruthers/pace-core 0.6.9 → 0.6.11

package/dist/usePublicPageContext-B91dGYW1.d.ts

@@ -0,0 +1,4367 @@
+import * as React$1 from 'react';
+import React__default, { ReactNode, Component, ErrorInfo } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { P as ParsedAddress, A as AutocompleteOptions } from './types-Dr8sNhER.js';
+import * as LabelPrimitive from '@radix-ui/react-label';
+import { F as FileCategory, j as FileUploadResult, U as UploadProgress, c as FileUploadOptions, a as FileReference } from './file-reference-DU1hcawx.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 { D as DataRecord, P as PerformanceConfig, S as ServerSideConfig, b as PaginationMode, C as ChunkingConfig, a as SearchIndexConfig, G as GetRowId } from './pagination-BW1mqywp.js';
+import { ColumnDef } from '@tanstack/react-table';
+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-BE2sEHKd.js';
+import { User, SupabaseClient, createClient } from '@supabase/supabase-js';
+import { O as Organisation, h as Event } from './event-BfCox3N2.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 `<div>` 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 <div 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 <div 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 <div 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: `<div>` 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<HTMLDivElement> & {
+    variant?: "default" | "destructive" | "inline";
+    role?: string;
+} & React$1.RefAttributes<HTMLDivElement>>;
+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 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<HTMLButtonElement>>;
+/**
+ * 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.
+ * Inline style exception (5-styling): viewport-based max/min dimensions from props are applied
+ * via the style prop; they cannot be expressed with static Tailwind and are merged with optional consumer style.
+ *
+ * @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> {
+    /** 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, 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;
+    /** Whether to show the chevron icon. Defaults to true. */
+    showChevron?: boolean;
+}
+/**
+ * Props for the SelectValue component.
+ */
+interface SelectValueProps {
+    placeholder?: string;
+    children?: React$1.ReactNode;
+    className?: string;
+}
+/**
+ * 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>>;
+
+/**
+ * @file DatePickerWithTimezone Component
+ * @package @jmruthers/pace-core
+ * @module Components/DatePickerWithTimezone
+ * @since 0.1.0
+ *
+ * Date picker component that displays timezone information alongside the calendar.
+ * Provides a calendar interface with timezone context for date selection.
+ *
+ * Features:
+ * - Calendar date selection with dropdown month/year navigation
+ * - Timezone display (shows "Local" when matches user timezone)
+ * - Optional "Done" button
+ * - Accessible date selection
+ * - Keyboard navigation support
+ * - Wide date range support (1900-2100) via dropdown selectors
+ *
+ * @example
+ * ```tsx
+ * import { DatePickerWithTimezone } from '@jmruthers/pace-core/components';
+ * import { useState } from 'react';
+ *
+ * function DateSelector() {
+ *   const [date, setDate] = useState<Date>();
+ *
+ *   return (
+ *     <DatePickerWithTimezone
+ *       selected={date}
+ *       onSelect={setDate}
+ *       timezone="America/New_York"
+ *       onDone={() => console.log('Date selected')}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @accessibility
+ * - WCAG 2.1 AA compliant
+ * - Keyboard navigation support
+ * - Screen reader friendly
+ * - Focus management
+ * - Proper ARIA attributes
+ */
+/**
+ * Props for the DatePickerWithTimezone component
+ */
+interface DatePickerWithTimezoneProps {
+    /**
+     * Currently selected date
+     */
+    selected?: Date;
+    /**
+     * Date selection handler
+     */
+    onSelect: (date: Date | undefined) => void;
+    /**
+     * Optional callback when "Done" button is clicked
+     */
+    onDone?: () => void;
+    /**
+     * Timezone to display (defaults to user's timezone)
+     */
+    timezone?: string;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+/**
+ * DatePickerWithTimezone component
+ * Date picker with timezone information display
+ *
+ * @param props - DatePickerWithTimezone configuration
+ * @returns JSX.Element - The rendered date picker with timezone
+ */
+declare function DatePickerWithTimezone({ selected, onSelect, onDone, timezone, className }: DatePickerWithTimezoneProps): react_jsx_runtime.JSX.Element;
+
+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>>;
+
+/**
+ * @file DataTable hierarchical type definitions
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Types
+ */
+
+/** Hierarchical configuration for DataTable */
+interface HierarchicalConfig {
+    /** Enable hierarchical functionality */
+    enabled: boolean;
+    /** Default expanded state - true = all expanded, false = all collapsed, array = specific IDs */
+    defaultExpanded?: boolean | string[];
+    /** Callback when expanded state changes */
+    onExpandedChange?: (expandedIds: string[]) => void;
+    /** Visual indentation for child rows (in pixels) */
+    indentSize?: number;
+    /** Custom styling for parent rows */
+    parentRowClassName?: string;
+    /** Custom styling for child rows */
+    childRowClassName?: string;
+}
+
+/**
+ * @file DataTable column type definitions
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Types
+ */
+
+/** Aggregate configuration */
+interface AggregateConfig {
+    field: string;
+    function: 'sum' | 'avg' | 'count' | 'min' | 'max';
+    label: string;
+}
+/**
+ * Enhanced column definition that extends TanStack's ColumnDef
+ */
+interface DataTableColumn<TData extends DataRecord = DataRecord> extends Omit<ColumnDef<TData>, 'id' | 'accessorKey'> {
+    /** Column identifier */
+    id?: string;
+    /** Accessor key for data */
+    accessorKey?: string;
+    /** Alternative accessor key used while editing */
+    editAccessorKey?: string;
+    /** Custom header label for the column */
+    header: string;
+    /** Whether this column should be searchable in global filter */
+    searchable?: boolean;
+    /** Enable sorting */
+    sortable?: boolean;
+    /** Enable column filter (inherits from ColumnDef) */
+    enableColumnFilter?: boolean;
+    /** Enable grouping (inherits from ColumnDef) */
+    enableGrouping?: boolean;
+    /** Enable hiding (inherits from ColumnDef) */
+    enableHiding?: boolean;
+    /** Aggregate configuration for this column */
+    aggregate?: AggregateConfig;
+    /** Enable virtual scrolling for this column */
+    virtualizable?: boolean;
+    /** Custom cell renderer with memoization */
+    memoizedCell?: React__default.ComponentType<{
+        row: TData;
+    }>;
+    /** Field type for editing (text, select, date, checkbox, etc.) */
+    fieldType?: 'text' | 'select' | 'date' | 'number' | 'boolean' | 'checkbox';
+    /** Options for select fields - can be simple items or grouped with labels and separators */
+    fieldOptions?: Array<{
+        value: string | number;
+        label: string;
+    } | {
+        type: 'group';
+        label: string;
+        items: Array<{
+            value: string | number;
+            label: string;
+        }>;
+    } | {
+        type: 'separator';
+    }>;
+    /** Enable keyboard search/filtering in select dropdowns within editable columns (default: true). */
+    selectSearchable?: boolean;
+    /** Enable creating new items in select dropdowns (default: false) */
+    creatable?: boolean;
+    /** Callback to create a new item when user types non-matching text in select dropdown */
+    onCreateNew?: (inputValue: string) => Promise<string | number> | string | number;
+    /** Maximum height for select dropdown content (default: "20rem") */
+    selectMaxHeight?: string;
+    /** Custom className for select content dropdown */
+    selectContentClassName?: string;
+    /** Custom style for select content dropdown */
+    selectContentStyle?: React__default.CSSProperties;
+    /** Hide spinner arrows on number input fields (default: true for DataTable) */
+    hideNumberSpinners?: boolean;
+    /** Filter type for column filtering (text, select, number, date) */
+    filterType?: 'text' | 'select' | 'number' | 'date';
+    /** Options for select filters (alternative to fieldOptions) */
+    filterSelectOptions?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    /** Whether this column is editable in edit mode (default: true) */
+    editable?: boolean;
+    /** Alternative CSV headers that should map to this column during import */
+    importAliases?: string[];
+    /** Custom renderer for parent rows */
+    renderForParent?: (row: TData) => React__default.ReactNode;
+    /** Custom renderer for child rows */
+    renderForChild?: (row: TData) => React__default.ReactNode;
+    /** Hide this column for parent rows */
+    hideForParent?: boolean;
+    /** Hide this column for child rows */
+    hideForChild?: boolean;
+    /**
+     * Aggregation function for grouped rows.
+     * If not provided, grouped rows will show empty/undefined for this column.
+     */
+    aggregateFn?: (rows: TData[], column: DataTableColumn<TData>) => unknown;
+    /** Optional: Custom cell renderer for aggregated values in grouped rows. */
+    aggregateCell?: (value: unknown, rows: TData[], column: DataTableColumn<TData>) => React__default.ReactNode;
+}
+
+/**
+ * @file DataTable feature configuration type definitions
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Types
+ */
+
+/**
+ * Unified feature configuration for DataTable
+ * All features are disabled by default and must be explicitly enabled
+ */
+interface DataTableFeatureFlags {
+    search: boolean;
+    pagination: boolean;
+    sorting: boolean;
+    filtering: boolean;
+    import: boolean;
+    export: boolean;
+    selection: boolean;
+    creation: boolean;
+    editing: boolean;
+    deletion: boolean;
+    deleteSelected: boolean;
+    grouping: boolean;
+    columnVisibility: boolean;
+    columnReordering: boolean;
+    hierarchical: boolean;
+}
+/**
+ * Consumer-facing feature configuration. All properties are optional and will be
+ * merged with defaultDataTableFeatures at runtime.
+ */
+type DataTableFeatureConfig = Partial<DataTableFeatureFlags>;
+/** Empty state configuration */
+interface EmptyStateConfig {
+    title?: string;
+    description?: string;
+    icon?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+
+/**
+ * @file DataTable action type definitions
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Types
+ */
+
+/** Boolean condition or predicate evaluated against a row */
+type ActionCondition<TData extends DataRecord> = boolean | ((row: TData) => boolean);
+/**
+ * Action definition for DataTable rows.
+ * Defines custom actions that can be performed on table rows.
+ */
+interface DataTableAction<TData extends DataRecord> {
+    /** Display label for the action */
+    label: string;
+    /** Icon component */
+    icon?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    /** Action handler */
+    onClick: (row: TData) => void;
+    /** Visual variant */
+    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
+    /** Whether action is disabled */
+    disabled?: ActionCondition<TData>;
+    /** Whether action is hidden (for RBAC) */
+    hidden?: boolean;
+    /** Explicit visibility override */
+    visible?: ActionCondition<TData>;
+    /** Test ID for testing */
+    testId?: string;
+    /** Whether this action should only show for parent rows (hierarchical mode) */
+    showForParent?: boolean;
+    /** Whether this action should only show for child rows (hierarchical mode) */
+    showForChild?: boolean;
+    /** Icon component for parent rows (overrides icon when showForParent is true) */
+    parentIcon?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    /** Icon component for child rows (overrides icon when showForChild is true) */
+    childIcon?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    /** Label for parent rows (overrides label when showForParent is true) */
+    parentLabel?: string;
+    /** Label for child rows (overrides label when showForChild is true) */
+    childLabel?: string;
+    /** Whether the action should be shown while the row is in edit mode */
+    showInEditMode?: boolean;
+    /** Whether the action should be hidden while the row is in view mode */
+    hideInViewMode?: boolean;
+    /** Whether the action should explicitly render while in view mode */
+    showInViewMode?: boolean;
+}
+/** Toolbar button definition */
+interface DataTableToolbarButton {
+    /** Display label */
+    label: string;
+    /** Icon component */
+    icon?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    /** Click handler */
+    onClick: () => void;
+    /** Visual variant */
+    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
+    /** Whether button is disabled */
+    disabled?: boolean;
+    /** Test ID for testing */
+    testId?: string;
+}
+
+/**
+ * RBAC configuration for DataTable - MANDATORY for all DataTables
+ */
+interface DataTableRBACConfig {
+    /** Page name for page-based permissions - will be resolved to page ID */
+    pageName?: string;
+    /** Page ID for page-based permissions - used directly if provided */
+    pageId?: string;
+}
+
+/**
+ * @file DataTable export type definitions
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Types
+ */
+
+/**
+ * Options provided to the onExport handler for custom export functionality
+ */
+interface ExportOptions<TData extends DataRecord> {
+    /** Filtered table rows with getValue() method for proper accessorFn evaluation */
+    tableRows: Array<{
+        original: TData;
+        getValue: (columnId: string) => unknown;
+        id: string;
+    }>;
+    /** All column definitions passed to the DataTable */
+    allColumns: DataTableColumn<TData>[];
+    /** Currently visible columns in the table */
+    visibleColumns: DataTableColumn<TData>[];
+    /** Mapping of column IDs to TanStack table column instances (for getValue() calls) */
+    columnIdToTableColumn: Map<string, unknown>;
+    /** Raw data array (unfiltered) */
+    data: TData[];
+    /** Default filename generated from table title */
+    filename: string;
+    /** TanStack table instance for advanced operations */
+    table: unknown;
+}
+
+/**
+ * @file Import Modal Persistence
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Components
+ *
+ * Module-level storage for ImportModal state so it survives remounts.
+ * Only the useImportModalState hook should read/write these.
+ *
+ * ImportSummary is the only contract for app-returned results: when onImport
+ * returns this shape, the modal uses it for the summary. Any other return
+ * shape is treated as chunk failed. See implementation-guides/data-tables.md
+ * "Import result contract" for consuming app guidance.
+ */
+interface ImportSummary {
+    successCount: number;
+    totalCount: number;
+    failedCount: number;
+    failedRows?: Array<{
+        row: number;
+        reason: string;
+    }>;
+}
+/** Return type for onImport: void/Promise<void> or ImportSummary/Promise<ImportSummary>. Async handlers may return Promise<void | ImportSummary>. */
+type ImportHandlerResult = void | Promise<void> | ImportSummary | Promise<ImportSummary> | Promise<void | ImportSummary>;
+
+/**
+ * Configuration interface for customizing ImportModal text content
+ * @public
+ */
+interface ImportModalConfig {
+    /** Custom title for the import modal */
+    title?: string;
+    /** Custom description text shown below the title */
+    description?: string;
+    /** Custom text shown in the file upload area when no file is selected */
+    uploadText?: string;
+    /** Custom text for the file selection button */
+    selectFileButtonText?: string;
+    /** Custom text for the import button */
+    importButtonText?: string;
+    /** Custom text for the import button when processing */
+    importButtonProcessingText?: string;
+    /** Custom text for the cancel button */
+    cancelButtonText?: string;
+    /** Custom text for the preview section header */
+    previewHeaderText?: string;
+    /** Custom text pattern for total rows display. Use {count} as placeholder for the actual count */
+    totalRowsText?: string;
+    /**
+     * When true, the entire file is sent to onImport in one chunk.
+     * Use for imports that do delete-then-insert per unit/entity so later chunks do not overwrite earlier ones.
+     */
+    singleChunk?: boolean;
+}
+
+/**
+ * Enhanced DataTable props with performance features
+ * @template TData - The type of data records in the table
+ */
+interface DataTableProps<TData extends DataRecord> {
+    /** Array of data records to display in the table */
+    data: TData[];
+    /** Column definitions for the table */
+    columns: DataTableColumn<TData>[];
+    /** RBAC configuration - REQUIRED for all DataTables */
+    rbac: DataTableRBACConfig;
+    /** Optional title displayed above the table */
+    title?: string;
+    /** Optional description displayed below the title */
+    description?: string;
+    /** Visual variant of the table */
+    variant?: 'default' | 'compact' | 'spacious';
+    /** Additional CSS classes for the table container */
+    className?: string;
+    /** Feature configuration - all features are disabled by default */
+    features?: DataTableFeatureConfig;
+    /** Hierarchical parent/child row configuration */
+    hierarchical?: HierarchicalConfig;
+    /** Performance optimization configuration */
+    performance?: PerformanceConfig;
+    /** Server-side data fetching configuration */
+    serverSide?: ServerSideConfig<TData>;
+    /** Override automatic pagination mode detection */
+    paginationMode?: PaginationMode;
+    /** Data chunking configuration for memory optimization */
+    chunking?: ChunkingConfig;
+    /** Search indexing configuration for fast search */
+    searchIndex?: SearchIndexConfig;
+    /** Virtual scrolling height */
+    virtualHeight?: number;
+    /** Initial page size for pagination */
+    initialPageSize?: number;
+    /** Initial grouping configuration - columns to group by on load */
+    defaultGrouping?: string[];
+    /** Initial sorting configuration - sort state to apply on load */
+    defaultSorting?: Array<{
+        id: string;
+        desc: boolean;
+    }>;
+    /** Enable enhanced pagination controls */
+    enhancedPagination?: boolean;
+    /** Custom loading component */
+    loadingComponent?: React__default.ComponentType;
+    /** Custom error component */
+    errorComponent?: React__default.ComponentType<{
+        error: Error;
+        retry: () => void;
+    }>;
+    /** Callback when a row is edited */
+    onEditRow?: (row: TData, data: Partial<TData>) => void;
+    /** Callback when a row is deleted */
+    onDeleteRow?: (row: TData) => void;
+    /** Callback when a new row is created */
+    onCreateRow?: (data: Partial<TData>) => void;
+    /** Callback when data is imported */
+    onImport?: (data: TData[]) => ImportHandlerResult;
+    /** Callback for custom export functionality */
+    onExport?: (options: ExportOptions<TData>) => void | Promise<void>;
+    /** Callback when row selection changes */
+    onRowSelectionChange?: (selection: Record<string, boolean>) => void;
+    /** Controlled selection state */
+    selection?: Record<string, boolean>;
+    /** Callback when bulk delete selected rows is triggered */
+    onDeleteSelected?: (selectedRows: Record<string, boolean>) => void;
+    /** Function to generate unique row IDs */
+    getRowId?: GetRowId<TData>;
+    /** Whether the table is in a loading state */
+    isLoading?: boolean;
+    /** Custom component to display when table is empty */
+    emptyState?: EmptyStateConfig | React__default.ReactElement;
+    /** Array of aggregation functions for grouped data */
+    aggregates?: AggregateConfig[];
+    /** Import modal configuration */
+    importModalConfig?: ImportModalConfig;
+    /** Called when the import modal is closed (e.g. to refetch table data). */
+    onImportModalClose?: () => void;
+    /** Custom row actions - use this for custom action buttons */
+    actions?: DataTableAction<TData>[];
+    /** Column order configuration - array of column IDs in desired order */
+    columnOrder?: string[];
+    /** Unique storage key for persisting table layout state across sessions */
+    storageKey?: string;
+    /** Callback when table layout changes (column order, visibility, etc.) */
+    onLayoutChange?: (layout: {
+        columnOrder: string[];
+        columnVisibility: Record<string, boolean>;
+    }) => void;
+}
+/**
+ * Enhanced DataTable with comprehensive performance optimizations
+ *
+ * This component automatically detects dataset size and applies appropriate performance optimizations:
+ * - < 1,000 records: Standard rendering with full feature support
+ * - 1,000+ records: Automatic virtual scrolling with intelligent memory management
+ * - 10,000+ records: Enhanced chunking and memory optimization
+ * - 100,000+ records: Advanced server-side processing with virtualization
+ *
+ * Features are configured through the unified `features` prop for maximum flexibility.
+ */
+/**
+ * Enhanced DataTable component with performance optimizations and comprehensive features.
+ *
+ * This is the main entry point for the DataTable component. It wraps DataTableCore
+ * and provides feature normalization and validation.
+ *
+ * @template TData - The type of data records in the table
+ * @param props - DataTable configuration including data, columns, features, and RBAC
+ * @returns The rendered DataTable component
+ *
+ * @example
+ * ```tsx
+ * <DataTable
+ *   data={users}
+ *   columns={userColumns}
+ *   rbac={{ pageId: 'user-management' }}
+ *   features={{
+ *     search: true,
+ *     pagination: true,
+ *     sorting: true
+ *   }}
+ * />
+ * ```
+ */
+/**
+ * Comprehensive, feature-rich data table component built on top of TanStack Table.
+ * Provides advanced data management capabilities with a clean, accessible interface.
+ *
+ * @template TData - The type of data records in the table
+ * @param props - DataTable configuration and props
+ * @returns The rendered DataTable component
+ */
+declare function DataTable<TData extends DataRecord>(props: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+
+/**
+ * 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;
+    /**
+     * 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
+ *
+ * Navigation menu with dropdown and hierarchical modes. Items are filtered by RBAC
+ * (permissions, roles, access level, page permission). See JSDoc on NavigationMenu below.
+ */
+
+/**
+ * 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"
+ *       auditLog={true}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Custom navigation with external links and actions:
+ * ```tsx
+ * import { NavigationMenu } from '@jmruthers/pace-core';
+ * import type { NavigationItem } from '@jmruthers/pace-core';
+ *
+ * function CustomNavigation() {
+ *   const handleNavigation = (item: NavigationItem) => {
+ *     if (item.id === 'logout') {
+ *       handleLogout();
+ *     } else if (item.href?.startsWith('http')) {
+ *       window.open(item.href, '_blank');
+ *     } else if (item.href) {
+ *       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' }
+ *   ];
+ *
+ *   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;
+    /** 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 context 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 - 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'). Defaults to '/' if not provided. */
+    logoHref?: string;
+}
+declare function Header({ logoUrl, logoAlt, 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 footer component for application layouts with copyright information.
+ *
+ * Features:
+ * - Copyright information with automatic year generation
+ * - Customizable company name and branding
+ * - Responsive design
+ * - Accessibility compliant
+ * - 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}
+ * />
+ * ```
+ *
+ * @accessibility
+ * - WCAG 2.1 AA compliant
+ * - Proper semantic HTML with role="contentinfo"
+ * - High contrast support
+ *
+ * @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;
+}
+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';
+/** Route config item for role-based routing. */
+interface PaceAppLayoutRouteConfigItem {
+    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;
+    };
+}
+/** Optional grouped permission options. When provided, overrides flat permission props. */
+interface PaceAppLayoutPermissionConfig {
+    enforcePermissions?: boolean;
+    defaultPermission?: Operation;
+    routePermissions?: Record<string, Operation>;
+    pageIdMapping?: Record<string, string>;
+    permissionFallback?: React__default.ReactNode;
+    strictMode?: boolean;
+    enforcePagePermissions?: boolean;
+    pagePermissionFallback?: React__default.ReactNode;
+    auditLog?: boolean;
+    onPageAccessDenied?: (pageName: string, operation: string) => void;
+    onStrictModeViolation?: (pageName: string, operation: string) => void;
+}
+/** Optional grouped routing options. When provided, overrides flat routing props. */
+interface PaceAppLayoutRoutingConfig {
+    roleBasedRouting?: boolean;
+    routeConfig?: PaceAppLayoutRouteConfigItem[];
+    fallbackRoute?: string;
+    onRouteAccessDenied?: (route: string, reason: string) => void;
+    onRouteStrictModeViolation?: (route: string, reason: string) => void;
+}
+/** Layout props for PaceAppLayout (ISP). */
+interface PaceAppLayoutPropsLayout {
+    appName: string;
+    navItems?: NavigationItem[];
+    showContextSelector?: boolean;
+    showOrganisations?: boolean;
+    showEvents?: boolean;
+    headerActions?: React__default.ReactNode;
+    logoHref?: string;
+    customUserMenu?: React__default.ReactNode;
+    headerClassName?: string;
+    showUserMenu?: boolean;
+}
+/** Permission props for PaceAppLayout (ISP). */
+interface PaceAppLayoutPropsPermission {
+    permissionConfig?: PaceAppLayoutPermissionConfig;
+    enforcePermissions?: boolean;
+    defaultPermission?: Operation;
+    routePermissions?: Record<string, Operation>;
+    permissionFallback?: React__default.ReactNode;
+    pageIdMapping?: Record<string, string>;
+    strictMode?: boolean;
+    enforcePagePermissions?: boolean;
+    pagePermissionFallback?: React__default.ReactNode;
+    auditLog?: boolean;
+    onPageAccessDenied?: (pageName: string, operation: string) => void;
+    onStrictModeViolation?: (pageName: string, operation: string) => void;
+}
+/** Routing props for PaceAppLayout (ISP). */
+interface PaceAppLayoutPropsRouting {
+    routingConfig?: PaceAppLayoutRoutingConfig;
+    roleBasedRouting?: boolean;
+    routeConfig?: PaceAppLayoutRouteConfigItem[];
+    fallbackRoute?: string;
+    onRouteAccessDenied?: (route: string, reason: string) => void;
+    onRouteStrictModeViolation?: (route: string, reason: string) => void;
+}
+/**
+ * Props for the PaceAppLayout component (ISP: composed from focused interfaces).
+ * Permission and routing options can be passed either as flat props or via permissionConfig / routingConfig.
+ */
+type PaceAppLayoutProps = PaceAppLayoutPropsLayout & PaceAppLayoutPropsPermission & PaceAppLayoutPropsRouting;
+/**
+ * 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, logoHref, customUserMenu, headerClassName, showUserMenu, permissionConfig, enforcePermissions: enforcePermissionsFlat, defaultPermission: defaultPermissionFlat, routePermissions: routePermissionsFlat, permissionFallback: permissionFallbackFlat, pageIdMapping: pageIdMappingFlat, strictMode: strictModeFlat, enforcePagePermissions: enforcePagePermissionsFlat, pagePermissionFallback: pagePermissionFallbackFlat, auditLog: _auditLogFlat, onPageAccessDenied: onPageAccessDeniedFlat, onStrictModeViolation: onStrictModeViolationFlat, routingConfig, roleBasedRouting: roleBasedRoutingFlat, routeConfig: routeConfigFlat, fallbackRoute: fallbackRouteFlat, onRouteAccessDenied: onRouteAccessDeniedFlat, onRouteStrictModeViolation: onRouteStrictModeViolationFlat, }: 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 | 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;
+
+/**
+ * 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;
+}
+
+/**
+ * @file Error Boundary Context Types
+ * @package @jmruthers/pace-core
+ * @module Components/ErrorBoundary
+ * @since 0.6.2
+ *
+ * Type definitions for ErrorBoundary context.
+ */
+
+/**
+ * Type definition for the global error handler function
+ * @public
+ */
+type GlobalErrorHandler = (error: Error, errorInfo: 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>;
+
+/**
+ * @file Context Selector Types
+ * @package @jmruthers/pace-core
+ * @module Components/ContextSelector
+ * @since 0.6.4
+ */
+
+/**
+ * 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;
+
+/** Storage/config props for FileUpload (ISP). */
+interface FileUploadPropsStorage {
+    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;
+}
+/** Validation props for FileUpload (ISP). */
+interface FileUploadPropsValidation {
+    accept?: string;
+    maxSize?: number;
+    multiple?: boolean;
+    disabled?: boolean;
+    isPublic?: boolean;
+}
+/** UI props for FileUpload (ISP). */
+interface FileUploadPropsUI {
+    className?: string;
+    showPreview?: boolean;
+    showProgress?: boolean;
+}
+/** Callback props for FileUpload (ISP). */
+interface FileUploadPropsCallbacks {
+    onUploadSuccess?: (result: FileUploadResult) => void;
+    onUploadError?: (error: string, file?: File) => void;
+    onProgress?: (progress: UploadProgress) => void;
+}
+/** Children prop for FileUpload (ISP). */
+interface FileUploadPropsChildren {
+    children?: React__default.ReactNode;
+}
+/**
+ * Props for the FileUpload component (ISP: composed from focused interfaces).
+ * Callers should pass the secure Supabase client (e.g. from useSecureSupabase()) when
+ * used in apps with RBAC. className is for instance-specific layout only (e.g. max-w-*).
+ */
+type FileUploadProps = FileUploadPropsStorage & FileUploadPropsValidation & FileUploadPropsUI & FileUploadPropsCallbacks & FileUploadPropsChildren;
+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;
+}
+/**
+ * File display component.
+ * Renders files from the file reference system with support for previews, downloads, and public/private access.
+ * Context-aware: uses PublicPageProvider for public pages and UnifiedAuthProvider for authenticated pages.
+ */
+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;
+};
+/** State slice of useFileReference return (ISP). */
+interface UseFileReferenceReturnState {
+    isLoading: boolean;
+    error: string | null;
+    clearError: () => void;
+}
+/** Upload slice of useFileReference return (ISP). */
+interface UseFileReferenceReturnUpload {
+    uploadFile: (options: FileUploadOptions, file: File) => Promise<FileUploadResult | null>;
+}
+/** Query slice of useFileReference return (ISP). */
+interface UseFileReferenceReturnQueries {
+    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>;
+    listFileReferences: (table_name: string, record_id: string, organisation_id: string) => Promise<FileReference[]>;
+    getFileCount: (table_name: string, record_id: string, organisation_id: string) => Promise<number>;
+}
+/** Mutation slice of useFileReference return (ISP). */
+interface UseFileReferenceReturnMutations {
+    updateFileReference: (id: string, updates: Partial<FileReference>) => Promise<FileReference | null>;
+    deleteFileReference: (table_name: string, record_id: string, organisation_id: string, delete_file?: boolean) => Promise<boolean>;
+}
+/** Return value of the useFileReference hook (ISP: composed from focused interfaces). */
+type UseFileReferenceReturn = UseFileReferenceReturnState & UseFileReferenceReturnUpload & UseFileReferenceReturnQueries & UseFileReferenceReturnMutations;
+/**
+ * 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;
+    /** Print page orientation for this page (default: 'portrait') */
+    printPageOrientation?: 'portrait' | 'landscape';
+}
+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: _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: _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, printPageOrientation }: PublicPageLayoutProps): react_jsx_runtime.JSX.Element;
+
+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;
+
+interface PublicPageContextType {
+    isPublicPage: true;
+    supabase: ReturnType<typeof createClient<Database>> | null;
+    appName: string | null;
+    environment: {
+        supabaseUrl: string | null;
+        supabaseKey: string | null;
+    };
+}
+
+/**
+ * @file usePublicPageContext Hook
+ * @package @jmruthers/pace-core
+ * @module Components/PublicLayout
+ * @since 1.0.0
+ *
+ * Hooks for accessing public page context.
+ */
+
+/**
+ * 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, type PublicPageLayoutProps 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, Tooltip as aA, TooltipTrigger as aB, TooltipContent as aC, TooltipProvider as aD, TooltipRoot as aE, DataTable as aF, type DataTableProps as aG, type DataTableColumn as aH, type DataTableAction as aI, type DataTableToolbarButton as aJ, type AggregateConfig as aK, type EmptyStateConfig as aL, Form as aM, FormField as aN, type FormProps as aO, type FormFieldProps as aP, LoginForm as aQ, type LoginFormProps as aR, Header as aS, Footer as aT, type FooterProps as aU, PublicPageLayout as aV, PublicPageHeader as aW, PublicPageFooter as aX, PublicPageProvider as aY, usePublicPageContext as aZ, useIsPublicPage 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, DatePickerWithTimezone as ao, type DatePickerWithTimezoneProps as ap, Toast as aq, Toaster as ar, ToastAction as as, ToastProvider as at, ToastViewport as au, ToastTitle as av, ToastDescription as aw, ToastClose as ax, type ToastActionElement as ay, type ToastProps as az, CardHeader as b, type PublicPageHeaderProps as b0, type PublicPageFooterProps as b1, ProtectedRoute as b2, type ProtectedRouteProps as b3, NavigationMenu as b4, ContextSelector as b5, type ContextSelectorProps as b6, UserMenu as b7, ErrorBoundary as b8, ErrorBoundaryProvider as b9, type PaceLoginPageProps as bA, PaceLoginPage as bB, type DataTableFeatureConfig as bC, type ExportOptions as bD, type ImportSummary as bE, type ImportHandlerResult as bF, type UserMenuProps as bG, PasswordChangeForm as bH, type ErrorBoundaryProps as ba, type ErrorBoundaryState as bb, type ErrorBoundaryProviderProps as bc, type GlobalErrorHandler as bd, LoadingSpinner as be, SessionRestorationLoader as bf, type SessionRestorationLoaderProps as bg, FileUpload as bh, type FileUploadProps as bi, FileDisplay as bj, type FileDisplayProps as bk, useFileReference as bl, useFileReferenceForRecord as bm, useFileReferenceById as bn, useFilesByCategory as bo, type UseFileReferenceOptions as bp, type UseFileReferenceReturn as bq, type UseFileReferenceForRecordReturn as br, type PaceAppLayoutRouteConfigItem as bs, type PaceAppLayoutPermissionConfig as bt, type PaceAppLayoutRoutingConfig as bu, type PaceAppLayoutPropsLayout as bv, type PaceAppLayoutPropsPermission as bw, type PaceAppLayoutPropsRouting as bx, type PaceAppLayoutProps as by, PaceAppLayout as bz, 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 };